feat: add server shutdown error handling

playground/pages/error.vue

@@ -1,9 +1,14 @@
 <script setup lang="ts">
+import {useLocalAuth} from "#imports";
 
+const auth = useLocalAuth();
 </script>
 
 <template>
-error
+  <div>
+    error
+    {{auth}}
+  </div>
 </template>
 
 <style scoped>

playground/pages/login.vue

@@ -12,9 +12,9 @@ function testAuth() {
 }
 
 definePageMeta({
-  // localAuth: {
-  //   unauthorizedOnly: true
-  // }
+  localAuth: {
+    unauthorizedOnly: true
+  }
 })
 </script>
 

src/module.ts

@@ -85,7 +85,9 @@ interface ModuleOptionsPages {
   * */
   defaultRedirect?: string;
   /* A page for catching a server shutdown when it is impossible to
-  * get session data due to a timeout. Default: '/error'
+  * get session data due to a timeout. Default: undefined
+  * Example #1: redirect to '/error'. value > '/error/
+  * Example #2: redirect is disabled. value > undefined
   * */
   serverIsDown?: string;
   /* Protecting all pages from guests. Default: false

src/runtime/composables/useLocalAuth.ts

@@ -62,6 +62,7 @@ async function getMe<T extends UseLocalAuthResponse = {}>(): Promise<T> {
     return meData;
   } catch (e: any) {
     if (e.statusCode) {
+      await signOut();
       throw new LocalAuthError(`getMe > [${e.statusCode}] > ${JSON.stringify(e.response._data)}`);
     } else {
       throw new LocalAuthError(`getMe > ${e.message}`);

src/runtime/helpers.ts

@@ -1,6 +1,11 @@
 import type {ModuleOptions} from "../module";
 import type {UseLocalAuthFetchConfig, UseLocalAuthResponse} from "./types";
-import {callWithNuxt, useNuxtApp, useRuntimeConfig} from "#app";
+import {
+  callWithNuxt,
+  useNuxtApp,
+  useRuntimeConfig,
+  navigateTo
+} from "#app";
 import useLocalAuthState from "./composables/useLocalAuthState";
 import useUtils from "./composables/useUtils";
 
@@ -24,14 +29,22 @@ export async function fetch<T extends UseLocalAuthResponse>(
     withToken: false,
     ..._config,
   }
-  const { state: { token, origin} } = await getContext();
+  const { options, state: { token, origin, meta} } = await getContext();
 
-  return await $fetch(
-    `${origin}/${trimStartWithSymbol(endpoint.path, '/')}`,
-    {
-      method: endpoint.method,
-      body: config.body,
-      headers: config.withToken ? { 'Authorization': token.value! } : {}
+  try {
+    return await $fetch(
+      `${origin}/${trimStartWithSymbol(endpoint.path, '/')}`,
+      {
+        method: endpoint.method,
+        body: config.body,
+        headers: config.withToken ? { 'Authorization': token.value! } : {}
+      }
+    );
+  } catch (e: any) {
+    if (!e.statusCode && options.pages.serverIsDown) {
+      meta.value.status = 'timeout';
+      navigateTo(options.pages.serverIsDown);
     }
-  );
+    throw Error(e);
+  }
 }

src/runtime/middleware/auth.ts

@@ -33,16 +33,19 @@ export default defineNuxtRouteMiddleware(async to => {
   if (metaAuth === false) return;
 
   const isAuthorized = meta.value.status === 'authorized';
+  const isTimeout = meta.value.status === 'timeout';
   const isUnauthorizedOnly = typeof metaAuth === 'object' ? metaAuth.unauthorizedOnly : false;
   const isAuthorizedOnly = typeof metaAuth === 'object' ? metaAuth.authorizedOnly : false;
 
+  if (isTimeout && options.pages.serverIsDown && to.path !== options.pages.serverIsDown) {
+    return navigateTo(`/${trimStartWithSymbol(options.pages.serverIsDown!, '/')}`);
+  }
   if (isAuthorized && to.path !== options.pages.defaultRedirect && isUnauthorizedOnly) {
     return navigateTo(`/${trimStartWithSymbol(options.pages.defaultRedirect!, '/')}`);
   }
   if (!isAuthorized && to.path !== options.pages.defaultRedirect && isAuthorizedOnly) {
     return navigateTo(`/${trimStartWithSymbol(options.pages.defaultRedirect!, '/')}`);
   }
-
   if (!isAuthorized && to.path !== options.pages.auth && !isUnauthorizedOnly) {
     return navigateTo(`/${trimStartWithSymbol(options.pages.auth!, '/')}`);
   }