@meistrari/auth-nuxt 2.0.1 → 2.1.0

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@meistrari/auth-nuxt",
   "configKey": "telaAuth",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, createResolver, addImports, addPlugin, extendPages, addComponent, addRouteMiddleware, addServerImportsDir, addServerHandler } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addImports, addPlugin, extendPages, addComponent, addServerImportsDir, addServerHandler } from '@nuxt/kit';
 
 const module$1 = defineNuxtModule({
   meta: {
@@ -39,12 +39,13 @@ const module$1 = defineNuxtModule({
       });
       addPlugin(resolver.resolve("./runtime/plugins/auth-guard"));
       addPlugin(resolver.resolve("./runtime/plugins/directives"));
-      addRouteMiddleware({
-        name: "tela-auth",
-        path: resolver.resolve("./runtime/middleware/require-auth"),
-        global: true
-      });
       addServerImportsDir(resolver.resolve("./runtime/server/utils"));
+      if (!options.skipServerMiddleware) {
+        addServerHandler({
+          route: "",
+          handler: resolver.resolve("./runtime/server/middleware/application-auth")
+        });
+      }
       return;
     }
     if (!options.skipServerMiddleware) {

package/dist/runtime/composables/application-auth.d.ts

@@ -36,6 +36,8 @@ export declare function useTelaApplicationAuth(): {
     login: () => Promise<void>;
     logout: () => Promise<void>;
     initSession: () => Promise<void>;
+    getAvailableOrganizations: () => Promise<import("@meistrari/auth-core").Organization[]>;
+    switchOrganization: (organizationId: string) => Promise<void>;
     user: import("vue").Ref<{
         id: string;
         createdAt: Date;

package/dist/runtime/composables/application-auth.js

@@ -1,7 +1,7 @@
 import { navigateTo, useCookie, useRoute, useRuntimeConfig } from "#app";
+import { AuthorizationFlowError, isTokenExpired, RefreshTokenExpiredError } from "@meistrari/auth-core";
 import { createNuxtAuthClient } from "../shared.js";
 import { useApplicationSessionState } from "./state.js";
-import { AuthorizationFlowError, isTokenExpired, RefreshTokenExpiredError } from "@meistrari/auth-core";
 const SEVEN_DAYS = 60 * 60 * 24 * 7;
 const FIFTEEN_MINUTES = 60 * 15;
 const ONE_MINUTE = 60 * 1e3;
@@ -162,10 +162,23 @@ export function useTelaApplicationAuth() {
       await refreshToken();
     }
   }
+  async function getAvailableOrganizations() {
+    const { organizations } = await authClient.application.listCandidateOrganizations(applicationId);
+    return organizations;
+  }
+  async function switchOrganization(organizationId) {
+    const { accessToken, refreshToken: refreshToken2, user, organization } = await authClient.application.switchOrganization(organizationId);
+    accessTokenCookie.value = accessToken;
+    refreshTokenCookie.value = refreshToken2;
+    state.user.value = user;
+    state.activeOrganization.value = mapOrganization(organization);
+  }
   return {
     ...state,
     login,
     logout,
-    initSession
+    initSession,
+    getAvailableOrganizations,
+    switchOrganization
   };
 }

package/dist/runtime/pages/callback.vue

@@ -1,11 +1,22 @@
 <script setup>
-import { navigateTo } from "#app";
+import { navigateTo, useRuntimeConfig } from "#app";
 import { onMounted } from "vue";
 import { useTelaApplicationAuth } from "../composables/application-auth";
 const { initSession } = useTelaApplicationAuth();
+const config = useRuntimeConfig();
+const authConfig = config.public.telaAuth;
+const loginPath = authConfig.application?.loginPath ?? "/login";
 onMounted(async () => {
-  await initSession();
-  navigateTo("/");
+  try {
+    await initSession();
+    navigateTo("/");
+  } catch (error) {
+    console.error("Session initialization failed:", error);
+    navigateTo({
+      path: loginPath,
+      query: { error: "session_failed" }
+    });
+  }
 });
 </script>
 

package/dist/runtime/plugins/auth-guard.d.ts

@@ -1,2 +1,22 @@
+/**
+ * Client-side authentication guard plugin
+ *
+ * This plugin provides UX-level route protection by checking JWT tokens client-side
+ * and redirecting users before they navigate to protected routes. This creates a smooth
+ * user experience by avoiding unnecessary page loads.
+ *
+ * SECURITY NOTE: This is NOT the primary security layer. The client-side JWT decoding
+ * is for UX purposes only. Actual cryptographic verification happens server-side in:
+ * - application-auth.ts: Server middleware that verifies JWTs for all /api routes
+ * - require-auth.ts: Server utility for protecting individual API route handlers
+ *
+ * An attacker could bypass this client-side check, but they cannot bypass the server-side
+ * verification which cryptographically validates the JWT signature using JWKS.
+ *
+ * This follows a defense-in-depth approach:
+ * 1. Client-side (this file): Fast UX-level routing decisions
+ * 2. Server middleware: Automatic JWT verification for all API routes
+ * 3. Route handlers: Explicit role checks in sensitive endpoints
+ */
 declare const _default: import("#app").Plugin<Record<string, unknown>> & import("#app").ObjectPlugin<Record<string, unknown>>;
 export default _default;

package/dist/runtime/plugins/directives.js

@@ -23,7 +23,7 @@ export default defineNuxtPlugin((nuxtApp) => {
       const isComment = el.nodeType === 8;
       if (shouldRender && isComment) {
         const originalElement = el.__vIfRoleElement;
-        if (originalElement) {
+        if (originalElement && originalElement.parentNode === null) {
           el.parentNode?.replaceChild(originalElement, el);
         }
       } else if (!shouldRender && !isComment) {
@@ -31,6 +31,11 @@ export default defineNuxtPlugin((nuxtApp) => {
         el.parentNode?.replaceChild(comment, el);
         comment.__vIfRoleElement = el;
       }
+    },
+    unmounted(el) {
+      if (el.nodeType === 8) {
+        delete el.__vIfRoleElement;
+      }
     }
   });
   nuxtApp.vueApp.directive("show-role", {

package/dist/runtime/server/middleware/application-auth.d.ts

@@ -0,0 +1,4 @@
+import type { AuthenticatedH3Event } from '../types/h3.js';
+export declare function meistrariApplicationAuthMiddleware(callback: (event: AuthenticatedH3Event) => void | Promise<void>): import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
+export default _default;

package/dist/runtime/server/middleware/application-auth.js

@@ -0,0 +1,49 @@
+import { useRuntimeConfig } from "#imports";
+import { defineEventHandler, getCookie } from "h3";
+import { createRemoteJWKSet, jwtVerify } from "jose";
+async function setApplicationAuthContext(event) {
+  event.context.auth = {
+    user: null,
+    workspace: null,
+    token: void 0
+  };
+  const token = getCookie(event, "tela-access-token");
+  if (!token) {
+    return;
+  }
+  const authConfig = useRuntimeConfig(event).public.telaAuth;
+  const { apiUrl, application } = authConfig;
+  const { applicationId } = application ?? {};
+  if (!applicationId || !apiUrl) {
+    return;
+  }
+  try {
+    const payload = await jwtVerify(
+      token,
+      createRemoteJWKSet(new URL("/api/auth/jwks", apiUrl)),
+      {
+        issuer: apiUrl,
+        audience: applicationId,
+        algorithms: ["RS256"]
+      }
+    ).then(({ payload: payload2 }) => payload2);
+    event.context.auth = {
+      user: { ...payload.user, email: payload.email },
+      workspace: payload.workspace,
+      token
+    };
+  } catch {
+  }
+}
+export function meistrariApplicationAuthMiddleware(callback) {
+  return defineEventHandler(async (event) => {
+    await setApplicationAuthContext(event);
+    await callback(event);
+  });
+}
+export default defineEventHandler(async (event) => {
+  if (!event.path.startsWith("/api")) {
+    return;
+  }
+  await setApplicationAuthContext(event);
+});

package/dist/runtime/server/utils/require-auth.d.ts

@@ -2,7 +2,14 @@ import type { EventHandlerRequest } from 'h3';
 import type { AuthenticatedH3Event } from '../types/h3.js';
 /**
  * Wraps an event handler to require authentication.
- * Throws 401 if no valid token is present.
+ * Throws 401 if no valid token is present, 403 if user lacks required role.
+ *
+ * This utility works in two modes:
+ * 1. If application-auth middleware has already verified the token, reuses that context
+ * 2. If middleware is skipped (skipServerMiddleware: true), performs JWT verification
+ *
+ * Use this when you need explicit role-based access control on specific API routes,
+ * or when you've disabled the global server middleware for performance reasons.
  *
  * @example
  * export default requireAuth(async (event) => {
@@ -12,7 +19,6 @@ import type { AuthenticatedH3Event } from '../types/h3.js';
  *
  * @example With roles
  * export default requireAuth(async (event) => {
- *   // TODO: Validate roles from token
  *   return { data: 'admin only' }
  * }, { roles: ['admin'] })
  */

package/dist/runtime/server/utils/require-auth.js

@@ -1,8 +1,19 @@
-import { useRuntimeConfig } from "#build/types/nitro-imports";
+import { useRuntimeConfig } from "nitropack/runtime";
 import { createError, defineEventHandler, getCookie } from "h3";
 import { createRemoteJWKSet, jwtVerify } from "jose";
 export function requireAuth(handler, options) {
   return defineEventHandler(async (event) => {
+    if (event.context.auth?.user && event.context.auth?.token) {
+      const user = event.context.auth.user;
+      if (options?.roles && !options.roles.includes(user.role ?? "")) {
+        throw createError({
+          statusCode: 403,
+          statusMessage: "Forbidden",
+          message: "User is not authorized to access this resource"
+        });
+      }
+      return handler(event);
+    }
     const token = getCookie(event, "tela-access-token");
     const authConfig = useRuntimeConfig(event).public.telaAuth;
     const { apiUrl, application } = authConfig;
@@ -28,23 +39,31 @@ export function requireAuth(handler, options) {
         message: "Authentication required"
       });
     }
-    const payload = await jwtVerify(token, createRemoteJWKSet(new URL("/.well-known/jwks.json", apiUrl)), {
-      issuer: apiUrl,
-      audience: applicationId,
-      algorithms: ["RS256"]
-    }).then(({ payload: payload2 }) => payload2);
-    const user = payload.user;
-    if (options?.roles && !options.roles.includes(user.role ?? "")) {
+    try {
+      const payload = await jwtVerify(token, createRemoteJWKSet(new URL("/api/auth/jwks", apiUrl)), {
+        issuer: apiUrl,
+        audience: applicationId,
+        algorithms: ["RS256"]
+      }).then(({ payload: payload2 }) => payload2);
+      const user = payload.user;
+      if (options?.roles && !options.roles.includes(user.role ?? "")) {
+        throw createError({
+          statusCode: 403,
+          statusMessage: "Forbidden",
+          message: "User is not authorized to access this resource"
+        });
+      }
+      event.context.auth = { user: { ...payload.user, email: payload.email }, workspace: payload.workspace, token };
+      return handler(event);
+    } catch (error) {
+      if (error && typeof error === "object" && "statusCode" in error) {
+        throw error;
+      }
       throw createError({
-        statusCode: 403,
-        statusMessage: "Forbidden",
-        message: "User is not authorized to access this resource"
+        statusCode: 401,
+        statusMessage: "Unauthorized",
+        message: "Invalid or expired token"
       });
     }
-    if (!event.context.auth) {
-      event.context.auth = { user: { ...payload.user, email: payload.email }, workspace: payload.workspace, token };
-    }
-    event.context.auth.token = token;
-    return handler(event);
   });
 }

package/package.json

@@ -1,56 +1,56 @@
 {
-    "name": "@meistrari/auth-nuxt",
-    "version": "2.0.1",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/types.d.mts",
-            "import": "./dist/module.mjs"
-        },
-        "./server/middleware/auth": {
-            "types": "./dist/runtime/server/middleware/auth.d.ts",
-            "import": "./dist/runtime/server/middleware/auth.js"
-        },
-        "./core": {
-            "types": "./dist/core.d.mts",
-            "import": "./dist/core.mjs"
-        }
+  "name": "@meistrari/auth-nuxt",
+  "version": "2.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
     },
-    "main": "./dist/module.mjs",
-    "typesVersions": {
-        "*": {
-            ".": [
-                "./dist/types.d.mts"
-            ]
-        }
+    "./server/middleware/auth": {
+      "types": "./dist/runtime/server/middleware/auth.d.ts",
+      "import": "./dist/runtime/server/middleware/auth.js"
     },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build"
-    },
-    "dependencies": {
-        "@meistrari/auth-core": "1.4.0",
-        "jose": "6.1.3"
-    },
-    "peerDependencies": {
-        "nuxt": "^3.0.0 || ^4.0.0",
-        "vue": "^3.0.0"
-    },
-    "devDependencies": {
-        "@nuxt/devtools": "2.6.3",
-        "@nuxt/eslint-config": "1.9.0",
-        "@nuxt/kit": "4.0.3",
-        "@nuxt/module-builder": "1.0.2",
-        "@nuxt/schema": "4.0.3",
-        "@nuxt/test-utils": "3.19.2",
-        "@types/node": "latest",
-        "changelogen": "0.6.2",
-        "nuxt": "4.0.3",
-        "typescript": "5.9.2",
-        "unbuild": "3.6.1",
-        "vitest": "3.2.4",
-        "vue-tsc": "3.0.6"
+    "./core": {
+      "types": "./dist/core.d.mts",
+      "import": "./dist/core.mjs"
+    }
+  },
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
     }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build"
+  },
+  "dependencies": {
+    "@meistrari/auth-core": "1.7.0",
+    "jose": "6.1.3"
+  },
+  "peerDependencies": {
+    "nuxt": "^3.0.0 || ^4.0.0",
+    "vue": "^3.0.0"
+  },
+  "devDependencies": {
+    "@nuxt/devtools": "2.6.3",
+    "@nuxt/eslint-config": "1.9.0",
+    "@nuxt/kit": "4.0.3",
+    "@nuxt/module-builder": "1.0.2",
+    "@nuxt/schema": "4.0.3",
+    "@nuxt/test-utils": "3.19.2",
+    "@types/node": "latest",
+    "changelogen": "0.6.2",
+    "nuxt": "4.0.3",
+    "typescript": "5.9.2",
+    "unbuild": "3.6.1",
+    "vitest": "3.2.4",
+    "vue-tsc": "3.0.6"
+  }
 }

package/dist/runtime/middleware/require-auth.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("#app").RouteMiddleware;
-export default _default;

package/dist/runtime/middleware/require-auth.js

@@ -1,42 +0,0 @@
-import { defineNuxtRouteMiddleware, navigateTo, useCookie, useRuntimeConfig } from "#app";
-import { createRemoteJWKSet, jwtVerify } from "jose";
-export default defineNuxtRouteMiddleware(async (to) => {
-  const authMeta = to.meta?.auth;
-  if (!authMeta || authMeta.required !== true) {
-    return;
-  }
-  const config = useRuntimeConfig();
-  const authConfig = config.public.telaAuth;
-  const { apiUrl, application } = authConfig;
-  const { applicationId, loginPath = "/login", unauthorizedPath = "/unauthorized" } = application ?? {};
-  const token = useCookie("tela-access-token");
-  if (!token.value) {
-    return navigateTo(loginPath);
-  }
-  if (!applicationId || !apiUrl) {
-    console.error("Application ID or API URL is not configured");
-    return;
-  }
-  try {
-    const { payload } = await jwtVerify(
-      token.value,
-      createRemoteJWKSet(new URL("/.well-known/jwks.json", apiUrl)),
-      {
-        issuer: apiUrl,
-        audience: applicationId,
-        algorithms: ["RS256"]
-      }
-    );
-    const tokenPayload = payload;
-    const user = tokenPayload.user;
-    if (authMeta.roles && authMeta.roles.length > 0) {
-      const userRole = user.role ?? "";
-      if (!authMeta.roles.includes(userRole)) {
-        return navigateTo(unauthorizedPath);
-      }
-    }
-  } catch (error) {
-    console.error("Token validation failed:", error);
-    return navigateTo(loginPath);
-  }
-});