@merkaly/nuxt 0.11.3 → 0.11.5

package/README.md

@@ -35,18 +35,11 @@ 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
+### Session lifetime
 
-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.
+The SPA keeps the session with **refresh tokens**: the client uses `useRefreshTokens` with `localStorage` cache and logs in with `audience` and `scope: openid profile email offline_access`. Before each API call the module asks Auth0 for the current access token, which is cached and renewed with the refresh token once it expires (2 hours for `https://api.merkaly.io`). When the refresh token is gone or expired, protected surfaces (`requiresAuth: true`) go back to login instead of calling the API without a token. Account linking (`linkWithConnection(connection)`) uses a separate Auth0 client, the account linking client (named `account.merkaly.io` in Auth0, no app behind it), with an in-memory cache, created only on the first call (no extra `checkSession` on page load). It opens a login popup for that connection and sends the popup's raw ID token to `POST /identities` as `{ idToken }`; the api verifies the token (signature, issuer, audience = the account linking client, expiry) and links the identity from its `sub` into the logged-in user. Requires an api with that contract (older clients that sent `{ provider, userId }` get `400`).
 
-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`).
+The Auth0 side (tenant, API, app settings, refresh token rotation and lifetimes, organizations, and the checklist for a new app) is documented in the auth.merkaly.io repo: [`docs/tenant-setup.md`](https://github.com/merkaly-io/auth.merkaly.io/blob/master/docs/tenant-setup.md).
 
 ## SEO: robots and sitemap
 

package/dist/module.json

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

package/dist/runtime/plugins/auth0.client.d.ts

@@ -1,6 +1,7 @@
+import { Auth0Client } from '@auth0/auth0-spa-js';
 declare const _default: import("#app").Plugin<{
-    auth0: import("@auth0/auth0-spa-js").Auth0Client;
+    auth0: Auth0Client;
 }> & import("#app").ObjectPlugin<{
-    auth0: import("@auth0/auth0-spa-js").Auth0Client;
+    auth0: Auth0Client;
 }>;
 export default _default;

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

@@ -1,4 +1,4 @@
-import { createAuth0Client } from "@auth0/auth0-spa-js";
+import { Auth0Client, createAuth0Client } from "@auth0/auth0-spa-js";
 import { defineNuxtPlugin, useRuntimeConfig, useNuxtApp, useState } from "#imports";
 import { navigateTo } from "#app";
 import { defu } from "defu";
@@ -47,6 +47,9 @@ export default defineNuxtPlugin(async ({ callHook, hook }) => {
         return auth0.loginWithRedirect({ appState: { target: location.pathname + location.search } });
       }
     }
+    if (!user.value && $config.merkaly.auth0.requiresAuth) {
+      return auth0.loginWithRedirect({ appState: { target: location.pathname + location.search } });
+    }
     return initTenantContext();
   };
   hook("merkaly:auth:retry", () => resolveIdentity().then(startSession));
@@ -68,27 +71,30 @@ export default defineNuxtPlugin(async ({ callHook, hook }) => {
       returnTo: URL.canParse($config.merkaly.auth0.logoutUrl) ? $config.merkaly.auth0.logoutUrl : location.origin.concat($config.merkaly.auth0.logoutUrl)
     }
   });
-  const callbackUrl = $config.merkaly.auth0.callbackUrl;
-  const redirectUri = URL.canParse(callbackUrl) ? callbackUrl : `${location.origin}${callbackUrl}`;
-  const linkingClient = await createAuth0Client({
+  let linkingClient;
+  const getLinkingClient = () => linkingClient ??= new Auth0Client({
+    authorizationParams: {
+      redirect_uri: URL.canParse($config.merkaly.auth0.callbackUrl) ? $config.merkaly.auth0.callbackUrl : location.origin.concat($config.merkaly.auth0.callbackUrl)
+    },
     cacheLocation: "memory",
     clientId: "AwD3uBHhLhFBbJhwSWXYFh9cZYidNc6L",
-    domain: $config.merkaly.auth0.domain,
-    authorizationParams: {
-      redirect_uri: redirectUri
-    }
+    // account.merkaly.io, the api checks this audience
+    domain: $config.merkaly.auth0.domain
   });
   auth0.linkWithConnection = async (connection) => {
-    await linkingClient.loginWithPopup({ authorizationParams: { connection } });
-    const claims = await linkingClient.getIdTokenClaims();
-    if (!claims?.sub) {
+    const client = getLinkingClient();
+    await client.loginWithPopup({ authorizationParams: { connection } });
+    const claims = await client.getIdTokenClaims();
+    if (!claims?.__raw) {
       throw new Error("Failed to get ID token for linking");
     }
-    const [provider, ...userIdParts] = claims.sub.split("|");
-    const userId = userIdParts.join("|");
-    const body = { provider, userId };
     const { $api } = useNuxtApp();
-    return await $api("/identities", { body, global: true, method: "POST" });
+    return await $api("/identities", {
+      // the api verifies it and derives the identity
+      body: { idToken: claims.__raw },
+      global: true,
+      method: "POST"
+    });
   };
   const isAuthCallback = window.location.pathname === callbackPath;
   if (isAuthCallback) {

package/package.json

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