@civic/auth 0.7.0-beta.1 → 0.7.1-beta.1

package/dist/reactjs/core/GlobalAuthManager.js

@@ -0,0 +1,296 @@
+/**
+ * GlobalAuthManager - Singleton Authentication State Manager
+ *
+ * This module provides a global singleton that manages authentication state across a React application
+ * without requiring React Context providers or prop drilling. It acts as a centralized authentication
+ * manager that wraps the CivicAuth vanilla JavaScript library and provides a React-friendly interface.
+ *
+ * Key Features:
+ * - Singleton pattern ensures single auth instance across the entire app
+ * - Eliminates need for React Context providers and reduces bundle size
+ * - Manages authentication state (user, session, loading, errors)
+ * - Handles sign-in/sign-out flows with event-driven updates
+ * - Provides idempotent initialization (safe to call multiple times)
+ * - Supports multiple React hooks subscribing to the same auth state
+ * - Automatic session refresh and user data synchronization
+ *
+ * Usage:
+ * - Initialize once in your app with authentication configuration
+ * - Use React hooks (useCivicAuth, useAuth, etc.) to access auth state
+ * - The manager handles all underlying CivicAuth SDK interactions
+ * - State updates are automatically propagated to all subscribed components
+ *
+ * This design pattern is particularly useful for:
+ * - Large applications with many components needing auth state
+ * - Avoiding provider wrapper hell in React component trees
+ * - Ensuring consistent auth state across disconnected component hierarchies
+ * - Server-side rendering scenarios where providers might be problematic
+ */
+import { CivicAuth, AuthenticationEvents, AuthEvent, } from "../../vanillajs/index.js";
+/**
+ * Global singleton that manages CivicAuth instance for React hooks
+ * Eliminates the need for React providers
+ */
+class GlobalAuthManager {
+    static instance = null;
+    auth = null;
+    events = null;
+    config = null;
+    listeners = new Set();
+    callbacks = {};
+    initializationPromise = null;
+    state = {
+        user: null,
+        session: null,
+        isLoading: false,
+        authStatus: "unauthenticated",
+        error: null,
+        displayMode: undefined,
+    };
+    constructor() {
+        // Private constructor for singleton
+    }
+    static getInstance() {
+        if (!GlobalAuthManager.instance) {
+            GlobalAuthManager.instance = new GlobalAuthManager();
+        }
+        return GlobalAuthManager.instance;
+    }
+    /**
+     * Initialize auth with config (idempotent)
+     * Returns the same promise for concurrent calls with same config
+     */
+    async initialize(config) {
+        // If we have a promise and same config, return existing promise
+        if (this.initializationPromise &&
+            this.config &&
+            this.isSameConfig(config)) {
+            return this.initializationPromise;
+        }
+        // If different config, reset everything
+        if (this.config && !this.isSameConfig(config)) {
+            this.initializationPromise = null;
+            await this.cleanup();
+        }
+        // Create new initialization promise if needed
+        if (!this.initializationPromise) {
+            this.initializationPromise = this._doInitialize(config);
+        }
+        return this.initializationPromise;
+    }
+    /**
+     * Private method that does the actual initialization work
+     */
+    async _doInitialize(config) {
+        this.config = config;
+        this.callbacks = {
+            onSignIn: config.onSignIn,
+            onSignOut: config.onSignOut,
+        };
+        this.setState({ isLoading: true, error: null });
+        try {
+            this.events = new AuthenticationEvents();
+            this.setupEventListeners();
+            const authConfig = {
+                clientId: config.clientId,
+                oauthServerBaseUrl: config.config?.oauthServer,
+                scopes: config.scopes || [
+                    "openid",
+                    "profile",
+                    "email",
+                    "offline_access",
+                ],
+                displayMode: config.displayMode || "iframe",
+                iframeDisplayMode: config.iframeMode || "modal",
+                nonce: config.nonce,
+                authProcessTimeout: config.authProcessTimeout || 120000,
+                events: this.events,
+                logging: {
+                    enabled: true,
+                    level: "debug",
+                },
+            };
+            // Only add redirectUrl if provided
+            if (config.redirectUrl) {
+                authConfig.redirectUrl = config.redirectUrl;
+            }
+            // Only add logoutRedirectUrl if provided
+            if (config.logoutRedirectUrl) {
+                authConfig.logoutRedirectUrl = config.logoutRedirectUrl;
+            }
+            this.auth = await CivicAuth.create(authConfig);
+            // Check initial auth state
+            const isAuthenticated = await this.auth.isAuthenticated();
+            if (isAuthenticated) {
+                await this.refreshUserAndSession();
+                this.setState({ authStatus: "authenticated" });
+            }
+            else {
+                this.setState({ authStatus: "unauthenticated" });
+            }
+            this.setState({
+                isLoading: false,
+                displayMode: config.displayMode,
+            });
+        }
+        catch (error) {
+            // Reset promise on error so it can be retried
+            this.initializationPromise = null;
+            const authError = error instanceof Error
+                ? error
+                : new Error("Auth initialization failed");
+            this.setState({
+                error: authError,
+                authStatus: "error",
+                isLoading: false,
+            });
+            throw authError;
+        }
+    }
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Sign in
+     */
+    async signIn() {
+        if (!this.auth) {
+            throw new Error("Auth not initialized");
+        }
+        const { user } = await this.auth.startAuthentication();
+        await this.refreshUserAndSession();
+        // Ensure we have a user to return
+        if (!user) {
+            throw new Error("Authentication succeeded but no user was returned");
+        }
+        // Return the user object
+        return { user };
+    }
+    /**
+     * Sign out
+     */
+    async signOut() {
+        if (!this.auth) {
+            throw new Error("Auth not initialized");
+        }
+        await this.auth.logout();
+        this.setState({
+            user: null,
+            session: null,
+            authStatus: "unauthenticated",
+        });
+    }
+    /**
+     * Check if config is the same (for idempotent initialization)
+     */
+    isSameConfig(newConfig) {
+        if (!this.config)
+            return false;
+        return (this.config.clientId === newConfig.clientId &&
+            this.config.config?.oauthServer === newConfig.config?.oauthServer &&
+            this.config.displayMode === newConfig.displayMode &&
+            this.config.nonce === newConfig.nonce);
+    }
+    /**
+     * Setup event listeners for auth state changes
+     */
+    setupEventListeners() {
+        if (!this.events)
+            return;
+        this.events.on(AuthEvent.SIGN_IN_STARTED, () => {
+            this.setState({
+                isLoading: true,
+                authStatus: "authenticating",
+                error: null,
+            });
+        });
+        this.events.on(AuthEvent.SIGN_IN_COMPLETE, () => {
+            this.setState({
+                isLoading: false,
+                authStatus: "authenticated",
+                error: null,
+            });
+            this.refreshUserAndSession();
+            this.callbacks.onSignIn?.();
+        });
+        this.events.on(AuthEvent.SIGN_IN_ERROR, (event) => {
+            const errorDetail = event?.detail || "Authentication failed";
+            const authError = new Error(errorDetail);
+            this.setState({
+                isLoading: false,
+                authStatus: "error",
+                error: authError,
+            });
+            this.callbacks.onSignIn?.(authError);
+        });
+        this.events.on(AuthEvent.SIGN_OUT_STARTED, () => {
+            this.setState({
+                isLoading: true,
+                authStatus: "signing_out",
+                error: null,
+            });
+        });
+        this.events.on(AuthEvent.SIGN_OUT_COMPLETE, () => {
+            this.setState({
+                isLoading: false,
+                authStatus: "unauthenticated",
+                user: null,
+                session: null,
+                error: null,
+            });
+            this.callbacks.onSignOut?.();
+        });
+        this.events.on(AuthEvent.USER_SESSION_CHANGED, () => {
+            this.refreshUserAndSession();
+        });
+    }
+    /**
+     * Refresh user and session data
+     */
+    async refreshUserAndSession() {
+        if (!this.auth)
+            return;
+        try {
+            const [session, user] = await Promise.all([
+                this.auth.getCurrentSession(),
+                this.auth.getCurrentUser(),
+            ]);
+            this.setState({ session, user });
+        }
+        catch (error) {
+            const sessionError = error instanceof Error ? error : new Error("Failed to get session");
+            this.setState({ error: sessionError });
+        }
+    }
+    /**
+     * Update state and notify listeners
+     */
+    setState(updates) {
+        this.state = { ...this.state, ...updates };
+        this.listeners.forEach((listener) => listener(this.state));
+    }
+    /**
+     * Cleanup auth instance
+     */
+    async cleanup() {
+        if (this.auth) {
+            await this.auth.destroy();
+            this.auth = null;
+        }
+        this.events = null;
+        this.config = null;
+        this.initializationPromise = null; // Reset promise for clean re-initialization
+    }
+}
+export { GlobalAuthManager };
+//# sourceMappingURL=GlobalAuthManager.js.map

package/dist/reactjs/core/GlobalAuthManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalAuthManager.js","sourceRoot":"","sources":["../../../src/reactjs/core/GlobalAuthManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * GlobalAuthManager - Singleton Authentication State Manager\n *\n * This module provides a global singleton that manages authentication state across a React application\n * without requiring React Context providers or prop drilling. It acts as a centralized authentication\n * manager that wraps the CivicAuth vanilla JavaScript library and provides a React-friendly interface.\n *\n * Key Features:\n * - Singleton pattern ensures single auth instance across the entire app\n * - Eliminates need for React Context providers and reduces bundle size\n * - Manages authentication state (user, session, loading, errors)\n * - Handles sign-in/sign-out flows with event-driven updates\n * - Provides idempotent initialization (safe to call multiple times)\n * - Supports multiple React hooks subscribing to the same auth state\n * - Automatic session refresh and user data synchronization\n *\n * Usage:\n * - Initialize once in your app with authentication configuration\n * - Use React hooks (useCivicAuth, useAuth, etc.) to access auth state\n * - The manager handles all underlying CivicAuth SDK interactions\n * - State updates are automatically propagated to all subscribed components\n *\n * This design pattern is particularly useful for:\n * - Large applications with many components needing auth state\n * - Avoiding provider wrapper hell in React component trees\n * - Ensuring consistent auth state across disconnected component hierarchies\n * - Server-side rendering scenarios where providers might be problematic\n */\n\nimport {\n  CivicAuth,\n  AuthenticationEvents,\n  AuthEvent,\n} from \"../../vanillajs/index.js\";\nimport type {\n  User,\n  Session,\n  CivicAuthClientConfig,\n} from \"../../vanillajs/index.js\";\nimport type { DisplayMode } from \"../../types.js\";\n\n// Event payload interfaces\ninterface SignInErrorEvent {\n  detail: string;\n}\n\nexport interface GlobalAuthConfig {\n  clientId: string;\n  redirectUrl?: string;\n  config?: {\n    oauthServer?: string;\n  };\n  displayMode?: DisplayMode;\n  iframeMode?: \"modal\" | \"embedded\";\n  nonce?: string;\n  logoutRedirectUrl?: string;\n  scopes?: string[];\n  authProcessTimeout?: number;\n  onSignIn?: (error?: Error) => void;\n  onSignOut?: () => void;\n}\n\nexport type AuthStatus =\n  | \"authenticated\"\n  | \"unauthenticated\"\n  | \"authenticating\"\n  | \"error\"\n  | \"signing_out\";\n\nexport interface GlobalAuthState {\n  user: User | null;\n  session: Session | null;\n  isLoading: boolean;\n  authStatus: AuthStatus;\n  error: Error | null;\n  displayMode?: DisplayMode;\n}\n\ntype StateListener = (state: GlobalAuthState) => void;\n\n/**\n * Global singleton that manages CivicAuth instance for React hooks\n * Eliminates the need for React providers\n */\nclass GlobalAuthManager {\n  private static instance: GlobalAuthManager | null = null;\n  private auth: CivicAuth | null = null;\n  private events: AuthenticationEvents | null = null;\n  private config: GlobalAuthConfig | null = null;\n  private listeners = new Set<StateListener>();\n  private callbacks: {\n    onSignIn?: (error?: Error) => void;\n    onSignOut?: () => void;\n  } = {};\n  private initializationPromise: Promise<void> | null = null;\n\n  private state: GlobalAuthState = {\n    user: null,\n    session: null,\n    isLoading: false,\n    authStatus: \"unauthenticated\",\n    error: null,\n    displayMode: undefined,\n  };\n\n  private constructor() {\n    // Private constructor for singleton\n  }\n\n  static getInstance(): GlobalAuthManager {\n    if (!GlobalAuthManager.instance) {\n      GlobalAuthManager.instance = new GlobalAuthManager();\n    }\n    return GlobalAuthManager.instance;\n  }\n\n  /**\n   * Initialize auth with config (idempotent)\n   * Returns the same promise for concurrent calls with same config\n   */\n  async initialize(config: GlobalAuthConfig): Promise<void> {\n    // If we have a promise and same config, return existing promise\n    if (\n      this.initializationPromise &&\n      this.config &&\n      this.isSameConfig(config)\n    ) {\n      return this.initializationPromise;\n    }\n\n    // If different config, reset everything\n    if (this.config && !this.isSameConfig(config)) {\n      this.initializationPromise = null;\n      await this.cleanup();\n    }\n\n    // Create new initialization promise if needed\n    if (!this.initializationPromise) {\n      this.initializationPromise = this._doInitialize(config);\n    }\n\n    return this.initializationPromise;\n  }\n\n  /**\n   * Private method that does the actual initialization work\n   */\n  private async _doInitialize(config: GlobalAuthConfig): Promise<void> {\n    this.config = config;\n    this.callbacks = {\n      onSignIn: config.onSignIn,\n      onSignOut: config.onSignOut,\n    };\n    this.setState({ isLoading: true, error: null });\n\n    try {\n      this.events = new AuthenticationEvents();\n      this.setupEventListeners();\n\n      const authConfig: CivicAuthClientConfig = {\n        clientId: config.clientId,\n        oauthServerBaseUrl: config.config?.oauthServer,\n        scopes: config.scopes || [\n          \"openid\",\n          \"profile\",\n          \"email\",\n          \"offline_access\",\n        ],\n        displayMode: config.displayMode || \"iframe\",\n        iframeDisplayMode: config.iframeMode || \"modal\",\n        nonce: config.nonce,\n        authProcessTimeout: config.authProcessTimeout || 120000,\n        events: this.events,\n        logging: {\n          enabled: true,\n          level: \"debug\" as const,\n        },\n      };\n\n      // Only add redirectUrl if provided\n      if (config.redirectUrl) {\n        authConfig.redirectUrl = config.redirectUrl;\n      }\n\n      // Only add logoutRedirectUrl if provided\n      if (config.logoutRedirectUrl) {\n        authConfig.logoutRedirectUrl = config.logoutRedirectUrl;\n      }\n\n      this.auth = await CivicAuth.create(authConfig);\n\n      // Check initial auth state\n      const isAuthenticated = await this.auth.isAuthenticated();\n      if (isAuthenticated) {\n        await this.refreshUserAndSession();\n        this.setState({ authStatus: \"authenticated\" });\n      } else {\n        this.setState({ authStatus: \"unauthenticated\" });\n      }\n\n      this.setState({\n        isLoading: false,\n        displayMode: config.displayMode,\n      });\n    } catch (error) {\n      // Reset promise on error so it can be retried\n      this.initializationPromise = null;\n\n      const authError =\n        error instanceof Error\n          ? error\n          : new Error(\"Auth initialization failed\");\n      this.setState({\n        error: authError,\n        authStatus: \"error\",\n        isLoading: false,\n      });\n      throw authError;\n    }\n  }\n\n  /**\n   * Subscribe to state changes\n   */\n  subscribe(listener: StateListener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Get current state\n   */\n  getState(): GlobalAuthState {\n    return { ...this.state };\n  }\n\n  /**\n   * Sign in\n   */\n  async signIn(): Promise<{ user: User }> {\n    if (!this.auth) {\n      throw new Error(\"Auth not initialized\");\n    }\n\n    const { user } = await this.auth.startAuthentication();\n    await this.refreshUserAndSession();\n\n    // Ensure we have a user to return\n    if (!user) {\n      throw new Error(\"Authentication succeeded but no user was returned\");\n    }\n\n    // Return the user object\n    return { user };\n  }\n\n  /**\n   * Sign out\n   */\n  async signOut(): Promise<void> {\n    if (!this.auth) {\n      throw new Error(\"Auth not initialized\");\n    }\n\n    await this.auth.logout();\n    this.setState({\n      user: null,\n      session: null,\n      authStatus: \"unauthenticated\",\n    });\n  }\n\n  /**\n   * Check if config is the same (for idempotent initialization)\n   */\n  private isSameConfig(newConfig: GlobalAuthConfig): boolean {\n    if (!this.config) return false;\n    return (\n      this.config.clientId === newConfig.clientId &&\n      this.config.config?.oauthServer === newConfig.config?.oauthServer &&\n      this.config.displayMode === newConfig.displayMode &&\n      this.config.nonce === newConfig.nonce\n    );\n  }\n\n  /**\n   * Setup event listeners for auth state changes\n   */\n  private setupEventListeners(): void {\n    if (!this.events) return;\n\n    this.events.on(AuthEvent.SIGN_IN_STARTED, () => {\n      this.setState({\n        isLoading: true,\n        authStatus: \"authenticating\",\n        error: null,\n      });\n    });\n\n    this.events.on(AuthEvent.SIGN_IN_COMPLETE, () => {\n      this.setState({\n        isLoading: false,\n        authStatus: \"authenticated\",\n        error: null,\n      });\n      this.refreshUserAndSession();\n      this.callbacks.onSignIn?.();\n    });\n\n    this.events.on(AuthEvent.SIGN_IN_ERROR, (event?: SignInErrorEvent) => {\n      const errorDetail = event?.detail || \"Authentication failed\";\n      const authError = new Error(errorDetail);\n      this.setState({\n        isLoading: false,\n        authStatus: \"error\",\n        error: authError,\n      });\n      this.callbacks.onSignIn?.(authError);\n    });\n\n    this.events.on(AuthEvent.SIGN_OUT_STARTED, () => {\n      this.setState({\n        isLoading: true,\n        authStatus: \"signing_out\",\n        error: null,\n      });\n    });\n\n    this.events.on(AuthEvent.SIGN_OUT_COMPLETE, () => {\n      this.setState({\n        isLoading: false,\n        authStatus: \"unauthenticated\",\n        user: null,\n        session: null,\n        error: null,\n      });\n      this.callbacks.onSignOut?.();\n    });\n\n    this.events.on(AuthEvent.USER_SESSION_CHANGED, () => {\n      this.refreshUserAndSession();\n    });\n  }\n\n  /**\n   * Refresh user and session data\n   */\n  private async refreshUserAndSession(): Promise<void> {\n    if (!this.auth) return;\n\n    try {\n      const [session, user] = await Promise.all([\n        this.auth.getCurrentSession(),\n        this.auth.getCurrentUser(),\n      ]);\n\n      this.setState({ session, user });\n    } catch (error) {\n      const sessionError =\n        error instanceof Error ? error : new Error(\"Failed to get session\");\n      this.setState({ error: sessionError });\n    }\n  }\n\n  /**\n   * Update state and notify listeners\n   */\n  private setState(updates: Partial<GlobalAuthState>): void {\n    this.state = { ...this.state, ...updates };\n    this.listeners.forEach((listener) => listener(this.state));\n  }\n\n  /**\n   * Cleanup auth instance\n   */\n  private async cleanup(): Promise<void> {\n    if (this.auth) {\n      await this.auth.destroy();\n      this.auth = null;\n    }\n    this.events = null;\n    this.config = null;\n    this.initializationPromise = null; // Reset promise for clean re-initialization\n  }\n}\n\nexport { GlobalAuthManager };\n"]}

package/dist/reactjs/hooks/index.d.ts

@@ -1,3 +1,3 @@
-export { useUser } from "../../reactjs/hooks/useUser.js";
-export { useToken } from "../../shared/hooks/useToken.js";
+export { useUser, type UserContextType } from "./useUser.js";
+export { useToken, type TokenContextType } from "./useToken.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/reactjs/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/reactjs/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/reactjs/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/reactjs/hooks/index.js

@@ -1,3 +1,3 @@
-export { useUser } from "../../reactjs/hooks/useUser.js";
-export { useToken } from "../../shared/hooks/useToken.js";
+export { useUser } from "./useUser.js";
+export { useToken } from "./useToken.js";
 //# sourceMappingURL=index.js.map

package/dist/reactjs/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/reactjs/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC","sourcesContent":["export { useUser } from \"@/reactjs/hooks/useUser.js\";\nexport { useToken } from \"@/shared/hooks/useToken.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/reactjs/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAyB,MAAM,eAAe,CAAC","sourcesContent":["export { useUser, type UserContextType } from \"./useUser.js\";\nexport { useToken, type TokenContextType } from \"./useToken.js\";\n"]}

package/dist/reactjs/hooks/useToken.d.ts

@@ -0,0 +1,13 @@
+import type { ForwardedTokens } from "../../types.js";
+import type { GlobalAuthConfig } from "../core/GlobalAuthManager.js";
+export interface TokenContextType {
+    idToken?: string | null;
+    accessToken?: string | null;
+    refreshToken?: string | null;
+    forwardedTokens?: ForwardedTokens;
+    isLoading: boolean;
+    error: Error | null;
+}
+declare const useToken: (config?: GlobalAuthConfig) => TokenContextType;
+export { useToken };
+//# sourceMappingURL=useToken.d.ts.map

package/dist/reactjs/hooks/useToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.d.ts","sourceRoot":"","sources":["../../../src/reactjs/hooks/useToken.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,QAAA,MAAM,QAAQ,YAAa,gBAAgB,KAAG,gBAuB7C,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/reactjs/hooks/useToken.js

@@ -0,0 +1,48 @@
+/**
+ * useToken Hook
+ *
+ * A backwards-compatible token hook that extracts token-related properties from useUser.
+ * This hook provides access to authentication tokens without user profile information.
+ *
+ * Use this hook when you:
+ * - Only need access to tokens (idToken, accessToken, refreshToken, forwardedTokens)
+ * - Want to maintain backwards compatibility with existing code
+ * - Don't need user profile information
+ *
+ * This hook supports the same authentication patterns as useUser with automatic fallback:
+ * 1. Provider-based (legacy): Uses CivicAuthProvider or CivicNextAuthProvider
+ * 2. Provider-free (modern): Direct configuration via useToken(config)
+ *
+ * Usage Examples:
+ *
+ * // With provider (existing approach)
+ * <CivicAuthProvider clientId="..." config={{ oauthServer: "..." }}>
+ *   const { accessToken, idToken, forwardedTokens } = useToken();
+ * </CivicAuthProvider>
+ *
+ * // Without provider (new approach) - direct configuration
+ * const { accessToken, idToken, refreshToken } = useToken({
+ *   clientId: "your-client-id",
+ *   config: { oauthServer: "https://auth.civic.com/oauth/" },
+ *   displayMode: "iframe",
+ *   scopes: ["openid", "profile", "email"]
+ * });
+ */
+"use client";
+import { useMemo } from "react";
+import { useUser } from "./useUser.js";
+const useToken = (config) => {
+    // Leverage the existing useUser hook which handles all the fallback logic
+    const { idToken, accessToken, refreshToken, forwardedTokens, isLoading, error, } = useUser(config);
+    // Return only token-related properties for backwards compatibility
+    return useMemo(() => ({
+        idToken,
+        accessToken,
+        refreshToken,
+        forwardedTokens,
+        isLoading,
+        error,
+    }), [idToken, accessToken, refreshToken, forwardedTokens, isLoading, error]);
+};
+export { useToken };
+//# sourceMappingURL=useToken.js.map

package/dist/reactjs/hooks/useToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.js","sourceRoot":"","sources":["../../../src/reactjs/hooks/useToken.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,YAAY,CAAC;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAavC,MAAM,QAAQ,GAAG,CAAC,MAAyB,EAAoB,EAAE;IAC/D,0EAA0E;IAC1E,MAAM,EACJ,OAAO,EACP,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EACT,KAAK,GACN,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB,mEAAmE;IACnE,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,OAAO;QACP,WAAW;QACX,YAAY;QACZ,eAAe;QACf,SAAS;QACT,KAAK;KACN,CAAC,EACF,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,CAAC,CACxE,CAAC;AACJ,CAAC,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["/**\n * useToken Hook\n *\n * A backwards-compatible token hook that extracts token-related properties from useUser.\n * This hook provides access to authentication tokens without user profile information.\n *\n * Use this hook when you:\n * - Only need access to tokens (idToken, accessToken, refreshToken, forwardedTokens)\n * - Want to maintain backwards compatibility with existing code\n * - Don't need user profile information\n *\n * This hook supports the same authentication patterns as useUser with automatic fallback:\n * 1. Provider-based (legacy): Uses CivicAuthProvider or CivicNextAuthProvider\n * 2. Provider-free (modern): Direct configuration via useToken(config)\n *\n * Usage Examples:\n *\n * // With provider (existing approach)\n * <CivicAuthProvider clientId=\"...\" config={{ oauthServer: \"...\" }}>\n *   const { accessToken, idToken, forwardedTokens } = useToken();\n * </CivicAuthProvider>\n *\n * // Without provider (new approach) - direct configuration\n * const { accessToken, idToken, refreshToken } = useToken({\n *   clientId: \"your-client-id\",\n *   config: { oauthServer: \"https://auth.civic.com/oauth/\" },\n *   displayMode: \"iframe\",\n *   scopes: [\"openid\", \"profile\", \"email\"]\n * });\n */\n\"use client\";\nimport { useMemo } from \"react\";\nimport { useUser } from \"./useUser.js\";\nimport type { ForwardedTokens } from \"../../types.js\";\nimport type { GlobalAuthConfig } from \"../core/GlobalAuthManager.js\";\n\nexport interface TokenContextType {\n  idToken?: string | null;\n  accessToken?: string | null;\n  refreshToken?: string | null;\n  forwardedTokens?: ForwardedTokens;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nconst useToken = (config?: GlobalAuthConfig): TokenContextType => {\n  // Leverage the existing useUser hook which handles all the fallback logic\n  const {\n    idToken,\n    accessToken,\n    refreshToken,\n    forwardedTokens,\n    isLoading,\n    error,\n  } = useUser(config);\n\n  // Return only token-related properties for backwards compatibility\n  return useMemo(\n    () => ({\n      idToken,\n      accessToken,\n      refreshToken,\n      forwardedTokens,\n      isLoading,\n      error,\n    }),\n    [idToken, accessToken, refreshToken, forwardedTokens, isLoading, error],\n  );\n};\n\nexport { useToken };\n"]}

package/dist/reactjs/hooks/useUser.d.ts

@@ -1,4 +1,22 @@
-import { type UserContextType } from "../../shared/providers/UserProvider.js";
-declare const useUser: <T extends Record<string, unknown> = Record<string, never>>() => UserContextType<T>;
+import type { User, ForwardedTokens } from "../../types.js";
+import type { AuthStatus } from "../../types.js";
+import type { DisplayMode } from "../../types.js";
+import { type GlobalAuthConfig } from "../core/GlobalAuthManager.js";
+export interface UserContextType<T extends Record<string, unknown> = Record<string, never>> {
+    user: User<T> | null;
+    idToken?: string | null;
+    accessToken?: string | null;
+    refreshToken?: string | null;
+    forwardedTokens?: ForwardedTokens;
+    isLoading: boolean;
+    authStatus: AuthStatus;
+    error: Error | null;
+    signIn: () => Promise<{
+        user: User<T>;
+    }>;
+    signOut: () => Promise<void>;
+    displayMode?: DisplayMode;
+}
+declare const useUser: <T extends Record<string, unknown> = Record<string, never>>(config?: GlobalAuthConfig) => UserContextType<T>;
 export { useUser };
 //# sourceMappingURL=useUser.d.ts.map

package/dist/reactjs/hooks/useUser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUser.d.ts","sourceRoot":"","sources":["../../../src/reactjs/hooks/useUser.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAE5C,QAAA,MAAM,OAAO,GACX,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,+BAC9B,eAAe,CAAC,CAAC,CAQrB,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"useUser.d.ts","sourceRoot":"","sources":["../../../src/reactjs/hooks/useUser.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEzD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,QAAA,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,mCACvC,gBAAgB,KACxB,eAAe,CAAC,CAAC,CA2InB,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/reactjs/hooks/useUser.js

@@ -1,12 +1,168 @@
+/**
+ * useUser Hook
+ *
+ * A comprehensive user session hook that provides full user data including profile information,
+ * authentication tokens, and authentication state. Supports generic typing for custom user data.
+ *
+ * Use this hook when you:
+ * - Need access to user profile information (user object)
+ * - Need authentication tokens (JWT, access, refresh tokens)
+ * - Are working with custom user data types
+ * - Need comprehensive user session data
+ * - Want backward compatibility with legacy UserContext
+ *
+ * This hook supports two authentication patterns with automatic fallback:
+ * 1. Provider-based (legacy): Uses CivicAuthProvider or CivicNextAuthProvider
+ * 2. Provider-free (modern): Direct configuration via useUser(config)
+ *
+ * Usage Examples:
+ *
+ * // With provider (existing approach - NextJS/React providers)
+ * <CivicAuthProvider clientId="..." config={{ oauthServer: "..." }}>
+ *   const { user, isLoading, signIn } = useUser();
+ * </CivicAuthProvider>
+ *
+ * // Without provider (new approach) - direct configuration
+ * const { user, authStatus, signOut } = useUser({
+ *   clientId: "your-client-id",
+ *   config: { oauthServer: "https://auth.civic.com/oauth/" },
+ *   displayMode: "iframe", // or "redirect", "popup", etc.
+ *   scopes: ["openid", "profile", "email"],
+ *   onSignIn: (error) => console.log("Sign in completed", error),
+ *   onSignOut: () => console.log("Sign out completed")
+ * });
+ *
+ * // Generic typing for custom user data
+ * interface CustomUser { customField: string; }
+ * const { user } = useUser<CustomUser>(); // user will be User<CustomUser> | null
+ */
 "use client";
-import { useContext } from "react";
-import { UserContext, } from "../../shared/providers/UserProvider.js";
-const useUser = () => {
-    const context = useContext(UserContext);
-    if (!context) {
-        throw new Error("useUser must be used within a UserProvider");
+import { useContext, useState, useEffect, useCallback, useMemo } from "react";
+import { UserContext } from "../../shared/providers/UserProvider.js";
+import { GlobalAuthManager, } from "../core/GlobalAuthManager.js";
+import { extractTokensFromSession } from "../../vanillajs/utils/auth-utils.js";
+const useUser = (config) => {
+    // Always call context hooks unconditionally (rules of hooks)
+    const sharedContext = useContext(UserContext);
+    // State for global manager approach
+    const [globalState, setGlobalState] = useState(null);
+    // Determine which approach to use
+    const hasProviderContext = sharedContext;
+    const shouldUseGlobal = !hasProviderContext;
+    // Initialize global manager if no provider context
+    useEffect(() => {
+        if (!shouldUseGlobal)
+            return;
+        const manager = GlobalAuthManager.getInstance();
+        // If config is provided, initialize with it
+        if (config) {
+            const initializeAuth = async () => {
+                try {
+                    await manager.initialize(config);
+                }
+                catch (error) {
+                    console.error("Failed to initialize auth:", error);
+                }
+            };
+            initializeAuth();
+        }
+        // Subscribe to state changes
+        const unsubscribe = manager.subscribe((newState) => {
+            setGlobalState(newState);
+        });
+        // Get current state
+        setGlobalState(manager.getState());
+        return unsubscribe;
+    }, [shouldUseGlobal, config]);
+    // Global manager sign in/out functions
+    const globalSignIn = useCallback(async () => {
+        const manager = GlobalAuthManager.getInstance();
+        await manager.signIn();
+        // Get the user after sign in
+        const state = manager.getState();
+        if (!state.user) {
+            throw new Error("Authentication succeeded but no user was returned");
+        }
+        return { user: state.user };
+    }, []);
+    const globalSignOut = useCallback(async () => {
+        const manager = GlobalAuthManager.getInstance();
+        await manager.signOut();
+    }, []);
+    // Extract tokens from global state
+    const globalTokens = useMemo(() => {
+        return extractTokensFromSession(globalState?.session || null);
+    }, [globalState?.session]);
+    // Create wrapper functions for different signIn signatures
+    const wrapSharedSignIn = useCallback(async () => {
+        if (sharedContext) {
+            await sharedContext.signIn(); // This returns void
+            // Get user from context after sign in
+            if (sharedContext.user) {
+                return { user: sharedContext.user };
+            }
+            // We don't return a user yet in nextjs until the next refactor
+            return { user: null };
+        }
+        throw new Error("Shared context not available");
+    }, [sharedContext]);
+    // ========================================================================
+    // FALLBACK PRIORITY SYSTEM - Two authentication context approaches
+    // ========================================================================
+    // 1. DEPRECATED UserContext (ACTIVE - Used by NextJS)
+    // Framework-agnostic shared context from UserProvider
+    // Location: shared/providers/UserProvider.tsx
+    // Usage: NextJS example uses CivicNextAuthProvider → UserProvider → UserContext
+    if (sharedContext) {
+        return {
+            user: sharedContext.user,
+            idToken: sharedContext.idToken,
+            accessToken: sharedContext.accessToken,
+            refreshToken: undefined, // Not available in shared context
+            forwardedTokens: sharedContext.forwardedTokens,
+            isLoading: sharedContext.isLoading,
+            authStatus: sharedContext.authStatus,
+            error: sharedContext.error,
+            signIn: wrapSharedSignIn,
+            signOut: sharedContext.signOut,
+            displayMode: sharedContext.displayMode,
+        };
     }
-    return context;
+    // 2. GlobalAuthManager (MODERN - Provider-free approach)
+    // Singleton-based state management, eliminates need for React providers
+    // Location: reactjs/core/GlobalAuthManager.ts
+    // Usage: React example uses CivicAuthProvider → GlobalAuthManager internally
+    // Can also be used directly: useUser({ clientId: "...", config: {...} })
+    if (globalState) {
+        return {
+            user: globalState.user,
+            idToken: globalTokens.idToken,
+            accessToken: globalTokens.accessToken,
+            refreshToken: globalTokens.refreshToken,
+            forwardedTokens: globalTokens.forwardedTokens,
+            isLoading: globalState.isLoading,
+            authStatus: globalState.authStatus,
+            error: globalState.error,
+            signIn: globalSignIn,
+            signOut: globalSignOut,
+            displayMode: globalState.displayMode,
+        };
+    }
+    // If no context and no global state, provide default loading state
+    // This happens when CivicAuthProvider is present but GlobalAuthManager hasn't initialized yet
+    return {
+        user: null,
+        idToken: null,
+        accessToken: null,
+        refreshToken: null,
+        forwardedTokens: undefined,
+        isLoading: true,
+        authStatus: "unauthenticated",
+        error: null,
+        signIn: globalSignIn,
+        signOut: globalSignOut,
+        displayMode: config?.displayMode,
+    };
 };
 export { useUser };
 //# sourceMappingURL=useUser.js.map