@civic/auth 0.6.0 → 0.6.1-beta.2

package/dist/vanillajs/auth/CivicAuth.d.ts

@@ -1,87 +1,29 @@
-import type { AuthenticationEvents } from "./AuthenticationEvents.js";
-import { type StorageAdapter } from "../storage/StorageAdapter.js";
-import type { DisplayMode } from "../../types.js";
-import type { AuthResult } from "../types/index.js";
-/**
- * Error codes for CivicAuth errors
- */
-export declare enum CivicAuthErrorCode {
-    CONFIG_REQUIRED = "CONFIG_REQUIRED",
-    INIT_FAILED = "INIT_FAILED",
-    ENDPOINTS_NOT_INITIALIZED = "ENDPOINTS_NOT_INITIALIZED",
-    CONTAINER_NOT_FOUND = "CONTAINER_NOT_FOUND",
-    AUTH_PROCESS_TIMEOUT = "AUTH_PROCESS_TIMEOUT",
-    IFRAME_LOAD_ERROR = "IFRAME_LOAD_ERROR",
-    INVALID_MESSAGE = "INVALID_MESSAGE"
-}
-/**
- * Configuration options for the CivicAuth client
- */
-export interface CivicAuthClientConfig {
-    /** OAuth client ID */
-    clientId: string;
-    /** URL to redirect to after authentication */
-    redirectUrl: string;
-    /** Base URL of the OAuth server */
-    oauthServerBaseUrl: string;
-    /** Array of OAuth scopes to request */
-    scopes: string[];
-    /** HTML element or element ID where the auth iframe will be mounted */
-    targetContainerElement: HTMLElement | string;
-    /** Text signals for success and error states */
-    textSignals: {
-        /** Text to display on successful authentication */
-        success: string;
-        /** Optional text to display on authentication error */
-        error?: string;
-    };
-    /** Display mode for the authentication UI */
-    displayMode?: DisplayMode;
-    /**
-     * Timeout duration in milliseconds for the entire authentication process.
-     * If the authentication process takes longer than this duration, it will be cancelled
-     * and an error will be thrown.
-     */
-    authProcessTimeout?: number;
-    /** Event handlers for authentication events */
-    events?: AuthenticationEvents;
-    /** Custom ID for the auth iframe */
-    iframeId?: string;
-    /** Custom storage adapter for auth state */
-    storageAdapter?: StorageAdapter;
-    /** OAuth prompt parameter */
-    prompt?: string;
-    /** Initial state for OAuth flow */
-    initialState?: string;
-    /** Logging configuration */
-    logging?: LoggingConfig;
-}
-export interface LoggingConfig {
-    enabled: boolean;
-    namespace?: string;
-    level?: "debug" | "info" | "warn" | "error";
-}
+import type { AuthResult, Session } from "../types/index.js";
+import type { CivicAuthClientConfig } from "./types/AuthTypes.js";
 /**
  * CivicAuth client for handling OAuth authentication
+ *
+ * This is a refactored version that uses a modular architecture for better maintainability.
  */
 export declare class CivicAuth {
     private config;
-    private iframeElement?;
-    private observer?;
+    private storage;
+    private endpoints?;
+    private logger;
+    private sessionManager?;
+    private initialDisplayMode;
     private authPromise?;
     private authPromiseResolve?;
     private authPromiseReject?;
     private authProcessTimeoutHandle?;
-    private messageEventHandler?;
-    private storage;
-    private endpoints?;
-    private logger;
+    private popupFailureTimeoutHandle?;
+    private hasPopupFailed;
+    private messageHandler?;
+    private popupHandler?;
+    private iframeAuthHandler?;
     /**
-     * Private constructor for CivicAuth.
+     * Private constructor - initializes configuration and handlers.
      * Use {@link CivicAuth.create} to create a new instance.
-     * @param config - Configuration options for the auth client
-     * @throws {CivicAuthError} If required configuration is missing
-     * @private
      */
     private constructor();
     /**
@@ -96,9 +38,12 @@ export declare class CivicAuth {
      * ```typescript
      * const auth = await CivicAuth.create({
      *   clientId: "your-client-id",
-     *   redirectUrl: "https://your-app.com/callback",
-     *   oauthServerBaseUrl: "https://auth-server.com/",
-     *   scopes: ["openid", "profile"],
+     *   // redirectUrl is optional - defaults to current page (window.location.origin + window.location.pathname)
+     *   redirectUrl: "https://your-app.com/callback", // optional
+     *   // oauthServerBaseUrl is optional - defaults to "https://auth.civic.com/oauth/"
+     *   oauthServerBaseUrl: "https://auth-server.com/", // optional
+     *   // scopes is optional - defaults to ['openid', 'profile', 'email', 'offline_access']
+     *   scopes: ["openid", "profile"], // optional
      *   targetContainerElement: "auth-container",
      *   textSignals: {
      *     success: "Authentication successful!"
@@ -109,39 +54,113 @@ export declare class CivicAuth {
     static create(config: CivicAuthClientConfig): Promise<CivicAuth>;
     /**
      * Initializes the auth client and checks for callback handling
-     * @throws {CivicAuthError} If initialization fails
      */
     private init;
     /**
-     * Gets the container element for the auth iframe
-     * @returns The container element or null if not found
+     * Initialize all handlers with proper configuration
      */
-    private getContainerElement;
+    private initializeHandlers;
     /**
      * Builds the authentication URL with PKCE challenge
-     * @returns The complete authentication URL
-     * @throws {CivicAuthError} If endpoints are not initialized
      */
     private buildAuthUrl;
-    private handleIframeMessage;
-    private logIncomingMessage;
-    private isValidMessageSource;
-    private handleValidMessage;
-    private handleAuthSuccess;
-    private handleAuthError;
-    private setupSignalObserver;
-    private handleNewTabAuth;
-    private handleIframeAuth;
     /**
      * Starts the authentication process
      * @returns A promise that resolves with the authentication result
      * @throws {CivicAuthError} If authentication fails or times out
      */
     startAuthentication(): Promise<AuthResult>;
+    /**
+     * Handle authentication based on display mode
+     */
+    private handleAuthenticationByDisplayMode;
+    /**
+     * Handle popup error with redirect fallback
+     */
+    private handlePopupErrorWithFallback;
+    /**
+     * Setup authentication timeout
+     */
+    private setupAuthenticationTimeout;
+    /**
+     * Handle successful authentication
+     */
+    private handleAuthSuccess;
+    /**
+     * Handle authentication error
+     */
+    private handleAuthError;
+    /**
+     * Handle popup failure - simplified like React implementation
+     */
+    private handlePopupFailure;
+    /**
+     * Show popup failure message to user
+     */
+    private showPopupFailureMessage;
+    /**
+     * Setup popup failure timeout
+     */
+    private setupPopupFailureTimeout;
+    /**
+     * Gets the container element for the auth iframe
+     */
+    private getContainerElement;
+    /**
+     * Handle OAuth callback
+     */
+    private handleCallback;
     /**
      * Cleans up resources and event listeners
      */
     cleanup(): void;
-    private handleCallback;
+    /**
+     * Get the current session
+     */
+    getCurrentSession(): Promise<Session | null>;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Get the current user
+     */
+    getCurrentUser(): Promise<import("../../types.js").BaseUser | null>;
+    /**
+     * Clear the current session
+     */
+    clearSession(): Promise<void>;
+    /**
+     * Manually refresh tokens
+     */
+    refreshTokens(): Promise<void>;
+    /**
+     * Get token refresher state for debugging
+     */
+    getTokenRefresherState(): {
+        isInitialized: boolean;
+        isAuthenticated: boolean;
+        isAutoRefreshActive: boolean;
+    } | null;
+    /**
+     * Update the iframe display mode
+     * @param mode - The display mode to use for the iframe
+     */
+    setIframeDisplayMode(mode: "modal" | "embedded"): void;
+    /**
+     * Get the current iframe display mode
+     * @returns The current iframe display mode
+     */
+    getIframeDisplayMode(): "modal" | "embedded" | undefined;
+    /**
+     * Destroy the auth client and clean up all resources
+     */
+    destroy(): Promise<void>;
+    /**
+     * Handle logout
+     */
+    logout(): Promise<void>;
 }
+export type { CivicAuthClientConfig } from "./types/AuthTypes.js";
+export { CivicAuthErrorCode } from "./types/AuthTypes.js";
 //# sourceMappingURL=CivicAuth.d.ts.map

package/dist/vanillajs/auth/CivicAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CivicAuth.d.ts","sourceRoot":"","sources":["../../../src/vanillajs/auth/CivicAuth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CivicAuth.d.ts","sourceRoot":"","sources":["../../../src/vanillajs/auth/CivicAuth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAmB7D,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAW9B;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,kBAAkB,CAKT;IAGjB,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,kBAAkB,CAAC,CAA8B;IACzD,OAAO,CAAC,iBAAiB,CAAC,CAA2B;IACrD,OAAO,CAAC,wBAAwB,CAAC,CAAS;IAC1C,OAAO,CAAC,yBAAyB,CAAC,CAAS;IAC3C,OAAO,CAAC,cAAc,CAAkB;IAGxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAE9C;;;OAGG;IACH,OAAO;IAgCP;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACiB,MAAM,CACxB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,SAAS,CAAC;IAMrB;;OAEG;YACW,IAAI;IAmElB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;YACW,YAAY;IA4B1B;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC;IA8ChD;;OAEG;YACW,iCAAiC;IA6C/C;;OAEG;YACW,4BAA4B;IA6C1C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA2BlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiC1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6C/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAehC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;YACW,cAAc;IA6D5B;;OAEG;IACI,OAAO,IAAI,IAAI;IA6BtB;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIzD;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhD;;OAEG;IACU,cAAc;IAI3B;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAS1C;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3C;;OAEG;IACI,sBAAsB;;;;;IAI7B;;;OAGG;IACI,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI;IAK7D;;;OAGG;IACI,oBAAoB,IAAI,OAAO,GAAG,UAAU,GAAG,SAAS;IAI/D;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAuErC;AAGD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}