@vunexa/lixa 0.0.1-alpha.9 → 0.1.1

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 { }