@meistrari/auth-nuxt 1.0.0-beta.1 → 1.0.0

package/README.md

@@ -14,12 +14,12 @@ Add the module to your `nuxt.config.ts`:
 
 ```typescript
 export default defineNuxtConfig({
-  modules: ['@meistrari/auth-nuxt'],
-  telaAuth: {
-    apiUrl: 'https://your-auth-api.com',
-    jwtCookieName: 'tela-jwt', // Optional: custom JWT cookie name
-    skipServerMiddleware: false, // Optional: skip automatic server middleware
-  }
+    modules: ['@meistrari/auth-nuxt'],
+    telaAuth: {
+        apiUrl: 'https://your-auth-api.com',
+        jwtCookieName: 'tela-jwt', // Optional: custom JWT cookie name
+        skipServerMiddleware: false, // Optional: skip automatic server middleware
+    }
 })
 ```
 
@@ -90,28 +90,28 @@ await signOut(() => {
 **Email and Password:**
 ```typescript
 await signInWithEmailAndPassword({
-  email: 'user@example.com',
-  password: 'secure-password',
-  callbackURL: '/dashboard',
-  errorCallbackURL: '/login?error=true'
+    email: 'user@example.com',
+    password: 'secure-password',
+    callbackURL: '/dashboard',
+    errorCallbackURL: '/login?error=true'
 })
 ```
 
 **Social Authentication:**
 ```typescript
 await signInWithSocialProvider({
-  provider: 'google', // or 'microsoft'
-  callbackURL: '/dashboard',
-  errorCallbackURL: '/login?error=true'
+    provider: 'google', // or 'microsoft'
+    callbackURL: '/dashboard',
+    errorCallbackURL: '/login?error=true'
 })
 ```
 
 **SAML SSO:**
 ```typescript
 await signInWithSaml({
-  email: 'user@example.com',
-  callbackURL: '/dashboard',
-  errorCallbackURL: '/login?error=true'
+    email: 'user@example.com',
+    callbackURL: '/dashboard',
+    errorCallbackURL: '/login?error=true'
 })
 ```
 
@@ -181,19 +181,19 @@ await inviteUserToOrganization({
 **Update Organization:**
 ```typescript
 await updateOrganization({
-  name: 'New Organization Name',
-  logo: 'https://example.com/logo.png',
-  settings: { /* custom settings */ }
+    name: 'New Organization Name',
+    logo: 'https://example.com/logo.png',
+    settings: { /* custom settings */ }
 })
 ```
 
 **Invite Member:**
 ```typescript
 await inviteUserToOrganization({
-  userEmail: 'user@example.com',
-  role: 'admin', // or 'member', 'reviewer'
-  teamId: 'team-id', // optional
-  resend: false // optional: resend if invitation exists
+    userEmail: 'user@example.com',
+    role: 'admin', // or 'member', 'reviewer'
+    teamId: 'team-id', // optional
+    resend: false // optional: resend if invitation exists
 })
 ```
 
@@ -201,7 +201,7 @@ await inviteUserToOrganization({
 ```typescript
 // Create team
 const team = await createTeam({
-  name: 'Development Team'
+    name: 'Development Team'
 })
 
 // Add member to team
@@ -263,20 +263,20 @@ The SDK automatically sets up server-side authentication context for API routes.
 ```typescript
 // server/api/protected.ts
 export default defineEventHandler(async (event) => {
-  // Authentication context is automatically available
-  const { user, workspace } = event.context.auth
-
-  if (!user) {
-    throw createError({
-      statusCode: 401,
-      statusMessage: 'Unauthorized'
-    })
-  }
-
-  return {
-    message: `Hello, ${user.email}!`,
-    userId: user.id
-  }
+    // Authentication context is automatically available
+    const { user, workspace } = event.context.auth
+
+    if (!user) {
+        throw createError({
+            statusCode: 401,
+            statusMessage: 'Unauthorized'
+        })
+    }
+
+    return {
+        message: `Hello, ${user.email}!`,
+        userId: user.id
+    }
 })
 ```
 
@@ -289,13 +289,13 @@ Create custom server middleware using the provided helper:
 import { meistrariAuthMiddleware } from '@meistrari/auth-nuxt/server/middleware/auth'
 
 export default meistrariAuthMiddleware(async (event) => {
-  // event.context.auth contains user and workspace
-  const { user, workspace } = event.context.auth
+    // event.context.auth contains user and workspace
+    const { user, workspace } = event.context.auth
 
-  // Your custom logic here
-  if (user) {
-    console.log(`Authenticated user: ${user.email}`)
-  }
+    // Your custom logic here
+    if (user) {
+        console.log(`Authenticated user: ${user.email}`)
+    }
 })
 ```
 
@@ -305,23 +305,23 @@ The SDK exports comprehensive TypeScript types from the core package:
 
 ```typescript
 import type {
-  User,
-  Session,
-  Organization,
-  FullOrganization,
-  Member,
-  Invitation,
-  Team,
-  TeamMember,
-  ApiKey,
-  CreateApiKeyPayload,
-  UpdateApiKeyPayload,
-  CreateTeamPayload,
-  UpdateTeamPayload,
-  InviteUserToOrganizationOptions,
-  RemoveUserFromOrganizationOptions,
-  UpdateMemberRoleOptions,
-  UpdateOrganizationPayload
+    User,
+    Session,
+    Organization,
+    FullOrganization,
+    Member,
+    Invitation,
+    Team,
+    TeamMember,
+    ApiKey,
+    CreateApiKeyPayload,
+    UpdateApiKeyPayload,
+    CreateTeamPayload,
+    UpdateTeamPayload,
+    InviteUserToOrganizationOptions,
+    RemoveUserFromOrganizationOptions,
+    UpdateMemberRoleOptions,
+    UpdateOrganizationPayload
 } from '@meistrari/auth-nuxt/core'
 ```
 
@@ -361,7 +361,7 @@ import { isTokenExpired, validateToken, extractTokenPayload } from '@meistrari/a
 
 // Check if token is expired
 if (isTokenExpired(jwtToken)) {
-  // Token needs refresh
+    // Token needs refresh
 }
 
 // Validate token against JWKS endpoint
@@ -393,15 +393,16 @@ The SDK handles common authentication errors automatically:
 import { APIError } from '@meistrari/auth-nuxt/core'
 
 try {
-  await signInWithEmailAndPassword({
-    email: 'user@example.com',
-    password: 'wrong-password',
-    callbackURL: '/dashboard'
-  })
-} catch (error) {
-  if (error instanceof APIError) {
-    console.error('Authentication failed:', error.message, error.status)
-  }
+    await signInWithEmailAndPassword({
+        email: 'user@example.com',
+        password: 'wrong-password',
+        callbackURL: '/dashboard'
+    })
+}
+catch (error) {
+    if (error instanceof APIError) {
+        console.error('Authentication failed:', error.message, error.status)
+    }
 }
 ```
 

package/dist/module.json

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

package/dist/runtime/composables/api-key.d.ts

@@ -1,13 +1,40 @@
-import type { CreateApiKeyPayload, UpdateApiKeyPayload } from '@meistrari/auth-core';
+import { createNuxtAuthClient } from '../shared.js';
+type AuthClient = ReturnType<typeof createNuxtAuthClient>;
+type ApiKeyClient = AuthClient['apiKey'];
+export interface UseTelaApiKey {
+    /**
+     * Creates a new API key.
+     * @param payload - API key configuration
+     * @returns The created API key with the secret (only shown once)
+     */
+    createApiKey: ApiKeyClient['createApiKey'];
+    /**
+     * Updates an existing API key.
+     * @param payload - Fields to update
+     * @returns The updated API key
+     */
+    updateApiKey: ApiKeyClient['updateApiKey'];
+    /**
+     * Deletes an existing API key.
+     * @param id - The ID of the API key to delete
+     */
+    deleteApiKey: ApiKeyClient['deleteApiKey'];
+    /**
+     * Lists all API keys of the current user.
+     * @returns A list of API keys
+     */
+    listApiKeys: ApiKeyClient['listApiKeys'];
+    /**
+     * Retrieves an existing API key.
+     * @param id - The ID of the API key to retrieve
+     * @returns The API key
+     */
+    getApiKey: ApiKeyClient['getApiKey'];
+}
 /**
  * Composable for managing API keys.
  *
  * @returns An object containing API key management functions.
  */
-export declare function useTelaApiKey(): {
-    createApiKey: (payload: CreateApiKeyPayload) => Promise<any>;
-    updateApiKey: (payload: UpdateApiKeyPayload) => Promise<any>;
-    deleteApiKey: (id: string) => Promise<any>;
-    listApiKeys: () => Promise<any>;
-    getApiKey: (id: string) => Promise<any>;
-};
+export declare function useTelaApiKey(): UseTelaApiKey;
+export {};

package/dist/runtime/composables/organization.d.ts

@@ -1,28 +1,115 @@
-import type { CreateTeamPayload, InviteUserToOrganizationOptions, ListMembersOptions, RemoveUserFromOrganizationOptions, UpdateMemberRoleOptions, UpdateOrganizationPayload, UpdateTeamPayload } from '@meistrari/auth-core';
-/**
- * Composable for managing organizations and their members, invitations, and teams.
- *
- * @returns An object containing organization management functions and the active organization and member states.
- */
-export declare function useTelaOrganization(): {
-    activeOrganization: import("vue").Ref<any, any>;
-    activeMember: import("vue").Ref<any, any>;
-    getActiveOrganization: () => Promise<any>;
-    listOrganizations: () => Promise<any>;
+import type { Ref } from 'vue';
+import type { CreateTeamPayload, FullOrganization, Invitation, InviteUserToOrganizationOptions, ListMembersOptions, Member, RemoveUserFromOrganizationOptions, Team, TeamMember, UpdateMemberRoleOptions, UpdateOrganizationPayload, UpdateTeamPayload } from '@meistrari/auth-core';
+import { type FullOrganizationWithRelations } from './state.js';
+export interface UseTelaOrganizationReturn {
+    /** Reactive reference to the active organization with members, invitations, and teams. */
+    activeOrganization: Ref<FullOrganizationWithRelations | null>;
+    /** Reactive reference to the current user's membership in the active organization. */
+    activeMember: Ref<Member | null>;
+    /**
+     * Retrieves the active organization for the current user session and updates the active organization state.
+     * @returns The active organization with members, invitations, and teams
+     */
+    getActiveOrganization: () => Promise<FullOrganizationWithRelations | undefined>;
+    /**
+     * Lists all organizations for the current user session.
+     * @returns A list of organizations
+     */
+    listOrganizations: () => Promise<FullOrganization[]>;
+    /**
+     * Sets the active organization for the current user session and updates the active organization state.
+     * @param id - The ID of the organization to set as active
+     */
     setActiveOrganization: (id: string) => Promise<void>;
-    updateOrganization: (payload: UpdateOrganizationPayload) => Promise<any>;
-    listMembers: (options?: ListMembersOptions) => Promise<any>;
-    getActiveMember: () => Promise<any>;
-    inviteUserToOrganization: (options: InviteUserToOrganizationOptions) => Promise<any>;
+    /**
+     * Updates the active organization for the current user session and updates the active organization state.
+     * @param payload - The organization fields to update
+     * @returns The updated organization
+     */
+    updateOrganization: (payload: UpdateOrganizationPayload) => Promise<FullOrganization>;
+    /**
+     * Lists the members of the active organization.
+     * @param options - Pagination options
+     * @returns A list of members
+     */
+    listMembers: (options?: ListMembersOptions) => Promise<Member[]>;
+    /**
+     * Retrieves the active member of the current user session.
+     * @returns The active member
+     */
+    getActiveMember: () => Promise<Member>;
+    /**
+     * Invites a user to the active organization.
+     * @param options - Invitation configuration
+     * @returns The invitation
+     */
+    inviteUserToOrganization: (options: InviteUserToOrganizationOptions) => Promise<Invitation>;
+    /**
+     * Accepts an organization invitation and updates the active organization state.
+     * @param id - The invitation ID to accept
+     */
     acceptInvitation: (id: string) => Promise<void>;
+    /**
+     * Cancels a pending organization invitation and updates the active organization state.
+     * @param id - The invitation ID to cancel
+     */
     cancelInvitation: (id: string) => Promise<void>;
+    /**
+     * Removes a user from the active organization.
+     * @param options - User identifier (either memberId or userEmail must be provided)
+     */
     removeUserFromOrganization: (options: RemoveUserFromOrganizationOptions) => Promise<void>;
+    /**
+     * Updates the role of an organization member.
+     * @param options - Role update configuration
+     */
     updateMemberRole: (options: UpdateMemberRoleOptions) => Promise<void>;
-    createTeam: (payload: CreateTeamPayload) => Promise<any>;
-    updateTeam: (id: string, payload: UpdateTeamPayload) => Promise<any>;
+    /**
+     * Creates a new team within the active organization.
+     * @param payload - Team configuration
+     * @returns The created team
+     */
+    createTeam: (payload: CreateTeamPayload) => Promise<Team>;
+    /**
+     * Updates an existing team's details.
+     * @param id - The team ID to update
+     * @param payload - Team fields to update
+     * @returns The updated team
+     */
+    updateTeam: (id: string, payload: UpdateTeamPayload) => Promise<Team>;
+    /**
+     * Deletes a team from the active organization.
+     * @param id - The team ID to delete
+     */
     deleteTeam: (id: string) => Promise<void>;
-    listTeams: () => Promise<any>;
-    listTeamMembers: (id: string) => Promise<any>;
-    addTeamMember: (teamId: string, userId: string) => Promise<any>;
+    /**
+     * Lists all teams in the active organization.
+     * @returns An array of teams
+     */
+    listTeams: () => Promise<Team[]>;
+    /**
+     * Lists all members of a specific team.
+     * @param id - The team ID
+     * @returns An array of team members
+     */
+    listTeamMembers: (id: string) => Promise<TeamMember[]>;
+    /**
+     * Adds a user to a team.
+     * @param teamId - The team ID
+     * @param userId - The user ID to add
+     * @returns The added team member
+     */
+    addTeamMember: (teamId: string, userId: string) => Promise<TeamMember>;
+    /**
+     * Removes a user from a team.
+     * @param teamId - The team ID
+     * @param userId - The user ID to remove
+     */
     removeTeamMember: (teamId: string, userId: string) => Promise<void>;
-};
+}
+/**
+ * Composable for managing organizations and their members, invitations, and teams.
+ *
+ * @returns An object containing organization management functions and the active organization and member states.
+ */
+export declare function useTelaOrganization(): UseTelaOrganizationReturn;

package/dist/runtime/composables/session.d.ts

@@ -1,18 +1,63 @@
-import { type SignInWithEmailAndPasswordOptions, type SignInWithSamlOptions, type SocialSignInOptions } from '@meistrari/auth-core';
+import type { Session, SignInWithEmailAndPasswordOptions, SignInWithSamlOptions, SocialSignInOptions, User } from '@meistrari/auth-core';
+import type { Ref } from 'vue';
+export interface UseTelaSessionReturn {
+    /** Reactive reference to the current user. Null if not authenticated. */
+    user: Ref<User | null>;
+    /** Reactive reference to the current session. Null if not authenticated. */
+    session: Ref<Session | null>;
+    /**
+     * Retrieves the current user session.
+     * @returns The current user session
+     */
+    getSession: () => Promise<{
+        user: User;
+        session: Session;
+    } | null>;
+    /**
+     * Retrieves a valid JWT token.
+     * @returns The JWT token, or null if not authenticated
+     */
+    getToken: () => Promise<string | null>;
+    /**
+     * Authenticates a user with email and password credentials.
+     * @param options - Email/password sign-in configuration
+     */
+    signInWithEmailAndPassword: (options: SignInWithEmailAndPasswordOptions) => Promise<void>;
+    /**
+     * Initiates social authentication flow with Google or Microsoft.
+     * @param options - Social sign-in configuration
+     * @throws {InvalidSocialProvider} When the provider is not 'google' or 'microsoft'
+     * @throws {InvalidCallbackURL} When callback URLs are malformed
+     */
+    signInWithSocialProvider: (options: SocialSignInOptions) => Promise<void>;
+    /**
+     * Initiates SAML-based Single Sign-On authentication flow.
+     * @param options - SAML sign-in configuration
+     * @throws {EmailRequired} When email is not provided
+     * @throws {InvalidCallbackURL} When callback URLs are malformed
+     */
+    signInWithSaml: (options: SignInWithSamlOptions) => Promise<void>;
+    /**
+     * Signs out the currently authenticated user.
+     * @param callback - Optional callback function to execute after signing out
+     */
+    signOut: (callback?: (() => void) | (() => Promise<void>)) => Promise<void>;
+    /**
+     * Initiates a password reset request by sending a reset email.
+     * @param email - Email address of the user requesting password reset
+     * @param callbackURL - URL where the user will be redirected to complete the reset
+     */
+    requestPasswordReset: (email: string, callbackURL: string) => Promise<void>;
+    /**
+     * Completes the password reset process with a reset token and new password.
+     * @param token - The password reset token from the email
+     * @param password - The new password to set
+     */
+    resetPassword: (token: string, password: string) => Promise<void>;
+}
 /**
  * Composable for managing user sessions and authentication.
  *
  * @returns An object containing session management functions and the user and session states.
  */
-export declare function useTelaSession(): {
-    user: import("vue").Ref<any, any>;
-    session: import("vue").Ref<any, any>;
-    getSession: () => Promise<any>;
-    getToken: () => Promise<any>;
-    signInWithEmailAndPassword: ({ email, password, callbackURL, errorCallbackURL, }: SignInWithEmailAndPasswordOptions) => Promise<void>;
-    signInWithSocialProvider: ({ provider, callbackURL, errorCallbackURL, }: SocialSignInOptions) => Promise<void>;
-    signInWithSaml: ({ email, callbackURL, errorCallbackURL, }: SignInWithSamlOptions) => Promise<void>;
-    signOut: (callback?: (() => void) | (() => Promise<void>)) => Promise<void>;
-    requestPasswordReset: (email: string, callbackURL: string) => Promise<void>;
-    resetPassword: (token: string, password: string) => Promise<void>;
-};
+export declare function useTelaSession(): UseTelaSessionReturn;

package/dist/runtime/composables/session.js

@@ -1,7 +1,7 @@
 import { useCookie, useRuntimeConfig } from "#app";
 import { APIError } from "@meistrari/auth-core";
 import { createNuxtAuthClient } from "../shared.js";
-import { useSessionState, useOrganizationState } from "./state.js";
+import { useOrganizationState, useSessionState } from "./state.js";
 export function useTelaSession() {
   const { user, session } = useSessionState();
   const { jwtCookieName, apiUrl } = useRuntimeConfig().public.telaAuth;

package/dist/runtime/server/types/h3.d.ts

@@ -2,21 +2,21 @@ import type { JWTTokenPayload } from '@meistrari/auth-core'
 import type { H3Event, H3EventContext } from 'h3'
 
 declare module 'h3' {
-  interface H3EventContext {
-    auth?: {
-      user: { email: string } & JWTTokenPayload['user'] | null
-      workspace: JWTTokenPayload['workspace'] | null
+    interface H3EventContext {
+        auth?: {
+            user: { email: string } & JWTTokenPayload['user'] | null
+            workspace: JWTTokenPayload['workspace'] | null
+        }
     }
-  }
 }
 
 export interface AuthenticatedH3EventContext extends H3EventContext {
-  auth: {
-    user: { email: string } & JWTTokenPayload['user'] | null
-    workspace: JWTTokenPayload['workspace'] | null
-  }
+    auth: {
+        user: { email: string } & JWTTokenPayload['user'] | null
+        workspace: JWTTokenPayload['workspace'] | null
+    }
 }
 
 export interface AuthenticatedH3Event extends H3Event {
-  context: AuthenticatedH3EventContext
-}
+    context: AuthenticatedH3EventContext
+}

package/dist/runtime/shared.js

@@ -1,5 +1,5 @@
 import { AuthClient } from "@meistrari/auth-core";
-import { version } from "../../package.json";
+const version = "__PACKAGE_VERSION__";
 export function createNuxtAuthClient(apiUrl, getAuthToken) {
   const serviceName = typeof process !== "undefined" ? process.env.SERVICE_NAME : "";
   const userAgent = `auth-sdk:nuxt:${version}${serviceName ? `@${serviceName}` : ""}`;

package/package.json

@@ -1,54 +1,54 @@
 {
-    "name": "@meistrari/auth-nuxt",
-    "version": "1.0.0-beta.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": "1.0.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.3.0"
-    },
-    "peerDependencies": {
-        "nuxt": "^3.0.0 || ^4.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.4.0"
+  },
+  "peerDependencies": {
+    "nuxt": "^3.0.0 || ^4.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"
+  }
 }