@vunexa/lixa 0.0.1-alpha.9 → 0.1.0

package/dist/lixa.js

@@ -1,244 +0,0 @@
-import { randomBytes } from "crypto";
-import { LocalStateCache } from "./dao/state-cache";
-import crypto from "crypto";
-/**
- * A flexible, provider-agnostic OAuth 2.0 and OpenID Connect (OIDC) client library.
- *
- * @remarks
- * Lixa simplifies multi-provider authentication flows and supports extensible session management.
- *
- * @example
- * ```typescript
- * const lixa = new Lixa({
- *   providers: {
- *     google: {
- *       clientId: 'your-client-id',
- *       clientSecret: 'your-client-secret',
- *       redirectUri: 'https://yourapp.com/auth/google/callback',
- *       scopes: ['openid', 'email', 'profile']
- *     }
- *   }
- * });
- * ```
- *
- * @public
- */
-class Lixa {
-    static CONFIGURED_PROVIDERS = new Map();
-    static LOCAL_STATE_CACHE = new LocalStateCache();
-    config;
-    stateDao;
-    /**
-     * Creates a new Lixa instance with the provided configuration.
-     *
-     * @param config - The configuration object containing provider settings and optional session strategy
-     */
-    constructor(config) {
-        this.config = config;
-        this.stateDao = config.stateDao || Lixa.LOCAL_STATE_CACHE;
-    }
-    /**
-     * Checks if a provider is both registered and configured for this instance.
-     * This is a type guard that narrows the provider type for use with getAuthUrl.
-     *
-     * @param provider - The provider name to check (case-insensitive)
-     * @returns True if the provider is registered and configured, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (lixa.isProviderConfigured(provider)) {
-     *   // TypeScript now knows provider is a valid ConfiguredProviderKey
-     *   const authUrl = lixa.getAuthUrl(provider, state);
-     * }
-     * ```
-     */
-    isProviderConfigured(provider) {
-        const providerType = provider.toLowerCase();
-        return Lixa.CONFIGURED_PROVIDERS.has(providerType) &&
-            this.config.providers.hasOwnProperty(providerType);
-    }
-    /**
-     * Registers custom OAuth providers for use with Lixa.
-     *
-     * @param providerMap - A map of provider names to IProvider implementations
-     *
-     * @example
-     * ```typescript
-     * class CustomProvider implements IProvider {
-     *   authorizationEndpoint = 'https://custom.com/oauth/authorize';
-     *   tokenEndpoint = 'https://custom.com/oauth/token';
-     *   userInfoEndpoint = 'https://custom.com/api/user';
-     * }
-     *
-     * Lixa.registerProvider({ custom: new CustomProvider() });
-     * ```
-     */
-    static registerProvider(providerMap) {
-        // This is a static method, so we can't access instance properties.
-        // Instead, we can modify the prototype to add the new provider.
-        Object.entries(providerMap).forEach(([key, providerImpl]) => {
-            Lixa.CONFIGURED_PROVIDERS.set(key, providerImpl);
-        });
-    }
-    /**
-     * Generates a cryptographically secure random state parameter for OAuth flows.
-     *
-     * @returns A 32-character hexadecimal string
-     *
-     * @remarks
-     * The state parameter is used to prevent CSRF attacks in OAuth flows.
-     */
-    static generateRandomState() {
-        return randomBytes(16).toString("hex");
-    }
-    /**
-     * Generates a cryptographically secure code verifier for PKCE flows.
-     *
-     * @returns A 64-character hexadecimal string
-     *
-     * @remarks
-     * The code verifier is used in PKCE (Proof Key for Code Exchange) to enhance security.
-     */
-    static generateCodeVerifier() {
-        return randomBytes(32).toString("hex");
-    }
-    static buildCodeChallenge(codeVerifier) {
-        const hash = crypto
-            .createHash("sha256")
-            .update(codeVerifier)
-            .digest("base64");
-        // Convert to base64url
-        return hash.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-    }
-    /**
-     * Generates the authorization URL for the specified provider.
-     *
-     * @param provider - The provider name (must be a configured provider key)
-     * @param state - The state parameter for CSRF protection
-     * @returns The complete authorization URL to redirect users to
-     *
-     * @throws Error when the provider is not configured
-     *
-     * @example
-     * ```typescript
-     * const state = Lixa.generateRandomState();
-     * const authUrl = lixa.getAuthUrl('google', state);
-     * res.redirect(authUrl);
-     * ```
-     */
-    getAuthUrl(provider, state) {
-        const providerType = String(provider).toLowerCase();
-        const providerConfig = this.findProviderByType(providerType);
-        const providerImpl = Lixa.CONFIGURED_PROVIDERS.get(providerType);
-        if (!providerConfig || !providerImpl) {
-            throw new Error(`Provider ${providerType} not configured`);
-        }
-        const codeVerifier = Lixa.generateCodeVerifier();
-        const codeChallenge = Lixa.buildCodeChallenge(codeVerifier);
-        // Cache the state paramaeter with TTL of 5 minutes (300 seconds)
-        // We dont care about value. we are onl interested in key existence
-        this.stateDao.saveState(state, {
-            createdAt: Date.now(),
-            provider: providerType,
-            codeVerifier,
-        }, 300 // 5 minutes in seconds
-        );
-        const params = new URLSearchParams({
-            client_id: providerConfig.clientId,
-            redirect_uri: providerConfig.redirectUri,
-            scope: providerConfig.scopes.join(" "),
-            state,
-            response_type: "code",
-            code_challenge: codeChallenge,
-            code_challenge_method: "S256",
-            ...providerConfig.extraConfig,
-        });
-        return `${providerImpl.authorizationEndpoint}?${params.toString()}`;
-    }
-    /**
-     * Handles the OAuth callback and creates a user session.
-     *
-     * @param provider - The provider name (must be a configured provider key)
-     * @param code - The authorization code from the provider
-     * @param state - The state parameter for validation
-     * @returns A Promise that resolves to a Session object
-     *
-     * @throws Error when code or state is missing/invalid, or provider is not configured
-     *
-     * @example
-     * ```typescript
-     * const session = await lixa.handleCallback({
-     *   provider: 'google',
-     *   code: req.query.code,
-     *   state: req.query.state
-     * });
-     * ```
-     */
-    async handleCallback({ provider, code, state, }) {
-        if (!code || code.trim() === "") {
-            throw new Error("Invalid or missing code in callback");
-        }
-        if (!state || state.trim() === "") {
-            throw new Error("Invalid or missing state in callback");
-        }
-        //Validate state here
-        const cachedState = await this.stateDao.getState(state);
-        if (!cachedState) {
-            throw new Error("Invalid or expired state");
-        }
-        // State is valid, remove it from cache to prevent reuse
-        await this.stateDao.deleteState(state);
-        //Get code verifier from cached state
-        const codeVerifier = cachedState.codeVerifier;
-        const providerType = String(provider).toLowerCase();
-        const providerConfig = this.findProviderByType(providerType);
-        const providerImpl = Lixa.CONFIGURED_PROVIDERS.get(providerType);
-        if (!providerConfig || !providerImpl) {
-            throw new Error(`Provider ${String(provider)} not configured`);
-        }
-        // Exchange code for tokens and fetch user info here.
-        const tokens = await this.exchangeCodeForToken(code, providerConfig, providerImpl, codeVerifier);
-        // For simplicity, we'll just return the tokens as the session.
-        // In a real implementation, you'd fetch user info and create a session.
-        const session = {
-            token: tokens.access_token,
-            raw: tokens, // Replace with actual user info
-        };
-        // If a session strategy is provided, use it to create a session.
-        if (this.config.sessionStrategy) {
-            return this.config.sessionStrategy.createSession(session.raw);
-        }
-        return session;
-    }
-    async exchangeCodeForToken(code, providerConfig, providerImpl, codeVerifier) {
-        // Build the request body
-        const body = {
-            client_id: providerConfig.clientId,
-            client_secret: providerConfig.clientSecret,
-            code,
-            redirect_uri: providerConfig.redirectUri,
-            grant_type: "authorization_code",
-        };
-        if (codeVerifier) {
-            body.code_verifier = codeVerifier;
-        }
-        const params = new URLSearchParams(body);
-        const response = await fetch(providerImpl.tokenEndpoint, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/x-www-form-urlencoded",
-                Accept: "application/json",
-            },
-            body: params.toString(),
-        });
-        if (!response.ok) {
-            throw new Error(`Token exchange failed: ${response.status} ${response.statusText}`);
-        }
-        return response.json();
-    }
-    findProviderByType(providerType) {
-        return this.config.providers[providerType];
-    }
-}
-export { Lixa };
-//# sourceMappingURL=lixa.js.map

package/dist/lixa.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lixa.js","sourceRoot":"","sources":["../src/lixa.ts"],"names":[],"mappings":"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"}

package/dist/providers/IProvider.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=IProvider.js.map

package/dist/providers/IProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IProvider.js","sourceRoot":"","sources":["../../src/providers/IProvider.ts"],"names":[],"mappings":""}

package/dist/providers/github.d.ts

@@ -1,9 +0,0 @@
-import { IProvider } from "./IProvider";
-declare class GithubProvider implements IProvider {
-    providerType: string;
-    authorizationEndpoint: string;
-    tokenEndpoint: string;
-    userInfoEndpoint: string;
-}
-export { GithubProvider };
-//# sourceMappingURL=github.d.ts.map

package/dist/providers/github.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/providers/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,cAAM,cAAe,YAAW,SAAS;IACvC,YAAY,SAAY;IACxB,qBAAqB,SAA8C;IACnE,aAAa,SAAiD;IAC9D,gBAAgB,SAAiC;CAClD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/providers/github.js

@@ -1,8 +0,0 @@
-class GithubProvider {
-    providerType = "GITHUB";
-    authorizationEndpoint = "https://github.com/login/oauth/authorize";
-    tokenEndpoint = "https://github.com/login/oauth/access_token";
-    userInfoEndpoint = "https://api.github.com/user";
-}
-export { GithubProvider };
-//# sourceMappingURL=github.js.map

package/dist/providers/github.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/providers/github.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc;IAClB,YAAY,GAAG,QAAQ,CAAC;IACxB,qBAAqB,GAAG,0CAA0C,CAAC;IACnE,aAAa,GAAG,6CAA6C,CAAC;IAC9D,gBAAgB,GAAG,6BAA6B,CAAC;CAClD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/providers/google.d.ts

@@ -1,9 +0,0 @@
-import { IProvider } from "./IProvider";
-declare class GoogleProvider implements IProvider {
-    providerType: string;
-    authorizationEndpoint: string;
-    tokenEndpoint: string;
-    userInfoEndpoint: string;
-}
-export { GoogleProvider };
-//# sourceMappingURL=google.d.ts.map

package/dist/providers/google.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,cAAM,cAAe,YAAW,SAAS;IACvC,YAAY,SAAY;IACxB,qBAAqB,SAAkD;IACvE,aAAa,SAAyC;IACtD,gBAAgB,SAAmD;CACpE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/providers/google.js

@@ -1,8 +0,0 @@
-class GoogleProvider {
-    providerType = "GOOGLE";
-    authorizationEndpoint = "https://accounts.google.com/o/oauth2/v2/auth";
-    tokenEndpoint = "https://oauth2.googleapis.com/token";
-    userInfoEndpoint = "https://www.googleapis.com/oauth2/v2/userinfo";
-}
-export { GoogleProvider };
-//# sourceMappingURL=google.js.map

package/dist/providers/google.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"google.js","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc;IAClB,YAAY,GAAG,QAAQ,CAAC;IACxB,qBAAqB,GAAG,8CAA8C,CAAC;IACvE,aAAa,GAAG,qCAAqC,CAAC;IACtD,gBAAgB,GAAG,+CAA+C,CAAC;CACpE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/providers/index.js

@@ -1,3 +0,0 @@
-export { GithubProvider } from "./github";
-export { GoogleProvider } from "./google";
-//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/constants.js

@@ -1,4 +0,0 @@
-const GOOGLE = "google";
-const GITHUB = "github";
-export { GOOGLE, GITHUB };
-//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}

package/index.d.ts

@@ -1,229 +0,0 @@
-/**
- * A flexible, provider-agnostic OAuth 2.0 and OpenID Connect (OIDC) client library for backend applications.
- *
- * @remarks
- * This package simplifies multi-provider authentication flows (e.g., Google, GitHub), supports extensible session management, and enables custom provider registration.
- *
- * @packageDocumentation
- */
-
-/**
- * Type representing the keys of configured providers
- */
-declare type ConfiguredProviderKey<T extends LixaConfig> = keyof T['providers'];
-
-/**
- * Interface for OAuth provider implementations.
- *
- * @remarks
- * Implement this interface to add support for custom OAuth providers.
- *
- * @public
- */
-export declare interface IProvider {
-    /** The OAuth authorization endpoint URL */
-    authorizationEndpoint: string;
-    /** The OAuth token exchange endpoint URL */
-    tokenEndpoint: string;
-    /** The user information endpoint URL */
-    userInfoEndpoint: string;
-}
-
-/**
- * A flexible, provider-agnostic OAuth 2.0 and OpenID Connect (OIDC) client library.
- *
- * @remarks
- * Lixa simplifies multi-provider authentication flows and supports extensible session management.
- *
- * @example
- * ```typescript
- * const lixa = new Lixa({
- *   providers: {
- *     google: {
- *       clientId: 'your-client-id',
- *       clientSecret: 'your-client-secret',
- *       redirectUri: 'https://yourapp.com/auth/google/callback',
- *       scopes: ['openid', 'email', 'profile']
- *     }
- *   }
- * });
- * ```
- *
- * @public
- */
-export declare class Lixa<TConfig extends LixaConfig = LixaConfig> {
-    private static CONFIGURED_PROVIDERS;
-    private static LOCAL_STATE_CACHE;
-    private config;
-    private stateDao;
-    /**
-     * Creates a new Lixa instance with the provided configuration.
-     *
-     * @param config - The configuration object containing provider settings and optional session strategy
-     */
-    constructor(config: TConfig);
-    /**
-     * Checks if a provider is both registered and configured for this instance.
-     * This is a type guard that narrows the provider type for use with getAuthUrl.
-     *
-     * @param provider - The provider name to check (case-insensitive)
-     * @returns True if the provider is registered and configured, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (lixa.isProviderConfigured(provider)) {
-     *   // TypeScript now knows provider is a valid ConfiguredProviderKey
-     *   const authUrl = lixa.getAuthUrl(provider, state);
-     * }
-     * ```
-     */
-    isProviderConfigured<T extends string>(provider: T): provider is T & ConfiguredProviderKey<TConfig>;
-    /**
-     * Registers custom OAuth providers for use with Lixa.
-     *
-     * @param providerMap - A map of provider names to IProvider implementations
-     *
-     * @example
-     * ```typescript
-     * class CustomProvider implements IProvider {
-     *   authorizationEndpoint = 'https://custom.com/oauth/authorize';
-     *   tokenEndpoint = 'https://custom.com/oauth/token';
-     *   userInfoEndpoint = 'https://custom.com/api/user';
-     * }
-     *
-     * Lixa.registerProvider({ custom: new CustomProvider() });
-     * ```
-     */
-    static registerProvider(providerMap: {
-        [key: string]: IProvider;
-    }): void;
-    /**
-     * Generates a cryptographically secure random state parameter for OAuth flows.
-     *
-     * @returns A 32-character hexadecimal string
-     *
-     * @remarks
-     * The state parameter is used to prevent CSRF attacks in OAuth flows.
-     */
-    static generateRandomState(): string;
-    /**
-     * Generates a cryptographically secure code verifier for PKCE flows.
-     *
-     * @returns A 64-character hexadecimal string
-     *
-     * @remarks
-     * The code verifier is used in PKCE (Proof Key for Code Exchange) to enhance security.
-     */
-    private static generateCodeVerifier;
-    private static buildCodeChallenge;
-    /**
-     * Generates the authorization URL for the specified provider.
-     *
-     * @param provider - The provider name (must be a configured provider key)
-     * @param state - The state parameter for CSRF protection
-     * @returns The complete authorization URL to redirect users to
-     *
-     * @throws Error when the provider is not configured
-     *
-     * @example
-     * ```typescript
-     * const state = Lixa.generateRandomState();
-     * const authUrl = lixa.getAuthUrl('google', state);
-     * res.redirect(authUrl);
-     * ```
-     */
-    getAuthUrl(provider: ConfiguredProviderKey<TConfig> | string, state: string): string;
-    /**
-     * Handles the OAuth callback and creates a user session.
-     *
-     * @param provider - The provider name (must be a configured provider key)
-     * @param code - The authorization code from the provider
-     * @param state - The state parameter for validation
-     * @returns A Promise that resolves to a Session object
-     *
-     * @throws Error when code or state is missing/invalid, or provider is not configured
-     *
-     * @example
-     * ```typescript
-     * const session = await lixa.handleCallback({
-     *   provider: 'google',
-     *   code: req.query.code,
-     *   state: req.query.state
-     * });
-     * ```
-     */
-    handleCallback({ provider, code, state, }: {
-        provider: ConfiguredProviderKey<TConfig> | string;
-        code: string;
-        state?: string;
-    }): Promise<Session>;
-    private exchangeCodeForToken;
-    private findProviderByType;
-}
-
-/**
- * Main configuration object for Lixa.
- *
- * @public
- */
-export declare interface LixaConfig {
-    /** Map of provider names to their configurations */
-    providers: Record<string, ProviderConfig>;
-    /** Optional custom session creation strategy */
-    sessionStrategy?: SessionStrategy;
-    /** Optional custom state storage implementation */
-    stateDao?: StateDao;
-}
-
-/**
- * Configuration for an OAuth provider.
- *
- * @public
- */
-export declare interface ProviderConfig {
-    /** The OAuth client ID provided by the provider */
-    clientId: string;
-    /** The OAuth client secret provided by the provider */
-    clientSecret: string;
-    /** The redirect URI registered with the provider */
-    redirectUri: string;
-    /** Array of OAuth scopes to request */
-    scopes: string[];
-    /** Additional provider-specific configuration parameters */
-    extraConfig?: Record<string, any>;
-}
-
-/**
- * Represents a user session after successful OAuth authentication.
- *
- * @public
- */
-export declare interface Session {
-    /** The session token (typically the access token) */
-    token: string;
-    /** Raw token data from the OAuth provider */
-    raw: any;
-}
-
-/**
- * Strategy interface for custom session creation.
- *
- * @public
- */
-export declare interface SessionStrategy {
-    /**
-     * Creates a session from OAuth token data.
-     *
-     * @param userInfo - The token data received from the OAuth provider
-     * @returns A Promise that resolves to a Session object
-     */
-    createSession(userInfo: any): Promise<Session>;
-}
-
-declare interface StateDao {
-    saveState(state: string, data: any, expiresInSeconds: number): Promise<void>;
-    getState(state: string): Promise<any | null>;
-    deleteState(state: string): Promise<void>;
-}
-
-export { }