@merkaly/nuxt 0.10.2 → 0.10.4

package/README.md

@@ -35,6 +35,19 @@ On boot the module restores an existing session (user and token) and then runs t
 | store | optional | required | `merkaly:tenant` resolves the store from the host (public); a signed-in buyer is restored too; protected pages (account, checkout) ask for login. |
 | www | optional | not used | No hooks; anonymous or signed-in. |
 
+### Session lifetime and Auth0 setup for a new app
+
+The SPA keeps the session with **refresh tokens** (`useRefreshTokens`, cached in `localStorage`, login with `offline_access`). The access token for the API lasts **2 hours** (`token_lifetime_for_web` of `https://api.merkaly.io`); before each API call the module asks Auth0 for the current token, which is cached and renewed with the refresh token once it expires. When the refresh token is gone or expired, protected surfaces (`requiresAuth: true`) go back to login instead of calling the API without a token.
+
+Every new Nuxt app needs this in Auth0 (done for admin, dashboard, store and www on 2026-11-04):
+
+1. **Application** (type SPA): allowed callback (`/auth`), logout and web origin URLs for each environment.
+2. **Refresh Token Rotation: on**, **Refresh Token Expiration: on**, with idle lifetime `2592000` (30 days) and maximum lifetime `7776000` (90 days). Never non-rotating or non-expiring.
+3. **API `https://api.merkaly.io`**: "Allow Offline Access" stays **on**; without it Auth0 issues no refresh tokens and every session ends after 2 hours.
+4. **Organizations**: apps that work inside a store (admin) require an organization at login; staff-only apps are filtered by the "Enforce surface access" post-login Action (role `MK_*`).
+
+These settings can be read and changed through the Management API (`merkaly.us.auth0.com`, the canonical domain, never the custom `auth.merkaly.io`).
+
 ## SEO: robots and sitemap
 
 Every app gets `@nuxtjs/robots`. Apps are **private by default**: in production

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.14.0"
   },
-  "version": "0.10.2",
+  "version": "0.10.4",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -130,6 +130,8 @@ function configureI18n(nuxt, options) {
     });
   });
   return {
+    baseUrl: options.seo?.url || void 0,
+    // absolute hreflang and canonical links
     defaultLocale: options.i18n.defaultLocale,
     detectBrowserLanguage: { useCookie: true },
     restructureDir: ".",

package/dist/runtime/components/app.vue

@@ -1,7 +1,7 @@
 <script setup>
 import { useRoute } from "#app";
 import { computed } from "vue";
-import { useAuth, useTenant, watchOnce, addRouteMiddleware, useNuxtApp } from "#imports";
+import { useAuth, useTenant, watchOnce, addRouteMiddleware, useNuxtApp, useRuntimeConfig } from "#imports";
 import AuthMiddleware from "../middleware/auth";
 import { useNavigation } from "../composables/useNavigation";
 import AuthError from "./auth/AuthError.vue";
@@ -11,8 +11,10 @@ const $route = useRoute();
 const { clear, error, isLoading, logout, retry } = useAuth();
 const { fromServer } = useTenant();
 const { hook } = useNuxtApp();
+const { public: { merkaly } } = useRuntimeConfig();
 useColorMode({ attribute: "data-bs-theme" });
-const blocking = computed(() => isLoading.value && !fromServer.value);
+const waitsForAuth = merkaly.auth0.requiresAuth || merkaly.auth0.requiresTenant;
+const blocking = computed(() => waitsForAuth && isLoading.value && !fromServer.value);
 watchOnce(isLoading, () => AuthMiddleware($route, $route));
 const { defer, regenerate } = useNavigation();
 addRouteMiddleware("navigation", (to) => defer(to), { global: true });

package/dist/runtime/plugins/api.global.js

@@ -1,4 +1,4 @@
-import { defineNuxtPlugin, useRequestURL, useRuntimeConfig } from "#app";
+import { defineNuxtPlugin, useNuxtApp, useRequestURL, useRuntimeConfig } from "#app";
 import { useAuth, useTenant } from "#imports";
 const GLOBAL_API_HEADER = "x-merkaly-global";
 function serverBaseURL(api, global) {
@@ -10,8 +10,10 @@ export default defineNuxtPlugin(({ provide }) => {
   if (import.meta.server && import.meta.dev && new URL(useRuntimeConfig().public.merkaly.api.url).hostname.endsWith(".test")) {
     process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
   }
+  const nuxtApp = useNuxtApp();
   provide("api", async (url, options = {}) => {
     const { token } = useAuth();
+    if (import.meta.client && token.value) await nuxtApp.$auth0?.getTokenSilently();
     const { tenant } = useTenant();
     const { public: { merkaly } } = useRuntimeConfig();
     const requiresTenant = options.requiresTenant ?? merkaly.auth0.requiresTenant;

package/dist/runtime/plugins/auth0.client.js

@@ -43,6 +43,9 @@ export default defineNuxtPlugin(async ({ callHook, hook }) => {
     if (user.value && !token.value && tokenError) {
       user.value = void 0;
       await self0.logout({ openUrl: false });
+      if ($config.merkaly.auth0.requiresAuth) {
+        return auth0.loginWithRedirect({ appState: { target: location.pathname + location.search } });
+      }
     }
     return initTenantContext();
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@merkaly/nuxt",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/merkaly-io/nuxt.git"