@vunexa/lixa 0.0.1-alpha.12 → 0.0.1-alpha.14

package/README.md

@@ -36,25 +36,25 @@ yarn add @vunexa/lixa
 ### 1. Configure lixa with multiple providers
 
 ```typescript
-import { Lixa } from '@vunexa/lixa';
+import { Lixa } from "@vunexa/lixa";
 
 const lixa = new Lixa({
   providers: {
     google: {
       clientId: process.env.GOOGLE_CLIENT_ID!,
       clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
-      redirectUri: 'https://yourapp.com/auth/google/callback',
-      scopes: ['openid', 'email', 'profile'],
+      redirectUri: "https://yourapp.com/auth/google/callback",
+      scopes: ["openid", "email", "profile"],
       extraConfig: {
-        prompt: 'consent',
-        access_type: 'offline',
+        prompt: "consent",
+        access_type: "offline",
       },
     },
     github: {
       clientId: process.env.GITHUB_CLIENT_ID!,
       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
-      redirectUri: 'https://yourapp.com/auth/github/callback',
-      scopes: ['read:user', 'user:email'],
+      redirectUri: "https://yourapp.com/auth/github/callback",
+      scopes: ["read:user", "user:email"],
       extraConfig: {},
     },
   },
@@ -64,10 +64,10 @@ const lixa = new Lixa({
     createSession: async (tokenData) => {
       // Custom session creation logic
       return {
-        token: 'custom-session-token',
-        raw: tokenData
+        token: "custom-session-token",
+        raw: tokenData,
       };
-    }
+    },
   },
 });
 ```
@@ -78,10 +78,10 @@ const lixa = new Lixa({
 app.get("/login", (req, res) => {
   const provider = req.query.provider as string; // 'google' or 'github'
   const state = lixa.generateRandomState();
-  
+
   // Store state in session for validation
   req.session.oauthState = state;
-  
+
   const authUrl = lixa.getAuthUrl(provider.toUpperCase(), state);
   res.redirect(authUrl);
 });
@@ -97,7 +97,7 @@ app.get("/auth/:provider/callback", async (req, res) => {
   try {
     // Validate state parameter
     if (state !== req.session.oauthState) {
-      throw new Error('Invalid state parameter');
+      throw new Error("Invalid state parameter");
     }
 
     const session = await lixa.handleCallback({
@@ -110,9 +110,9 @@ app.get("/auth/:provider/callback", async (req, res) => {
     res.cookie("session_token", session.token, {
       httpOnly: true,
       secure: true,
-      sameSite: 'strict'
+      sameSite: "strict",
     });
-    
+
     res.redirect("/dashboard");
   } catch (error) {
     console.error("Authentication error:", error);
@@ -128,29 +128,29 @@ app.get("/auth/:provider/callback", async (req, res) => {
 You can register custom OAuth providers by implementing the `IProvider` interface:
 
 ```typescript
-import { Lixa, IProvider } from '@vunexa/lixa';
+import { Lixa, IProvider } from "@vunexa/lixa";
 
 class CustomProvider implements IProvider {
-  authorizationEndpoint = 'https://custom-provider.com/oauth/authorize';
-  tokenEndpoint = 'https://custom-provider.com/oauth/token';
-  userInfoEndpoint = 'https://custom-provider.com/api/user';
+  authorizationEndpoint = "https://custom-provider.com/oauth/authorize";
+  tokenEndpoint = "https://custom-provider.com/oauth/token";
+  userInfoEndpoint = "https://custom-provider.com/api/user";
 }
 
 // Register the custom provider
 Lixa.registerProvider({
-  custom: new CustomProvider()
+  custom: new CustomProvider(),
 });
 
 // Use it in your configuration
 const lixa = new Lixa({
   providers: {
     custom: {
-      clientId: 'your-client-id',
-      clientSecret: 'your-client-secret',
-      redirectUri: 'https://yourapp.com/auth/custom/callback',
-      scopes: ['read:user'],
-    }
-  }
+      clientId: "your-client-id",
+      clientSecret: "your-client-secret",
+      redirectUri: "https://yourapp.com/auth/custom/callback",
+      scopes: ["read:user"],
+    },
+  },
 });
 ```
 
@@ -158,8 +158,8 @@ const lixa = new Lixa({
 
 ```typescript
 // Check if a provider is registered
-if (Lixa.isProviderRegistered('google')) {
-  console.log('Google provider is available');
+if (Lixa.isProviderRegistered("google")) {
+  console.log("Google provider is available");
 }
 ```
 
@@ -168,13 +168,16 @@ if (Lixa.isProviderRegistered('google')) {
 ### `Lixa` Class
 
 #### Constructor
+
 - `new Lixa(config: LixaConfig)` - Creates a new Lixa instance
 
 #### Static Methods
+
 - `Lixa.registerProvider(providerMap: { [key: string]: IProvider })` - Register custom providers
 - `Lixa.isProviderRegistered(provider: string): boolean` - Check if a provider is registered
 
 #### Instance Methods
+
 - `generateRandomState(): string` - Generate a random state parameter for OAuth flow
 - `getAuthUrl(provider: string, state: string): string` - Get authorization URL for a provider
 - `handleCallback({ provider, code, state }): Promise<Session>` - Handle OAuth callback and create session

package/dist/dao/session-cache.cjs

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSessionCache = void 0;
+const node_cache_1 = __importDefault(require("node-cache"));
+class LocalSessionCache {
+    cache;
+    constructor(defaultTtlSeconds = 600) {
+        this.cache = new node_cache_1.default({ stdTTL: defaultTtlSeconds });
+    }
+    async saveSession(state, data, expiresInSeconds) {
+        this.cache.set(state, data, expiresInSeconds);
+    }
+    async getSession(state) {
+        return this.cache.get(state) || null;
+    }
+    async deleteSession(state) {
+        this.cache.del(state);
+    }
+}
+exports.LocalSessionCache = LocalSessionCache;
+//# sourceMappingURL=session-cache.js.map

package/dist/dao/session-cache.d.ts

@@ -0,0 +1,10 @@
+import { SessionDao } from "./types";
+declare class LocalSessionCache implements SessionDao {
+    private cache;
+    constructor(defaultTtlSeconds?: number);
+    saveSession(state: string, data: any, expiresInSeconds: number): Promise<void>;
+    getSession(state: string): Promise<any | null>;
+    deleteSession(state: string): Promise<void>;
+}
+export { LocalSessionCache };
+//# sourceMappingURL=session-cache.d.ts.map

package/dist/dao/session-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cache.d.ts","sourceRoot":"","sources":["../../src/dao/session-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,cAAM,iBAAkB,YAAW,UAAU;IAC3C,OAAO,CAAC,KAAK,CAAY;gBAEb,iBAAiB,GAAE,MAAY;IAIrC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAI9C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/dao/session-cache.js

@@ -0,0 +1,18 @@
+import NodeCache from 'node-cache';
+class LocalSessionCache {
+    cache;
+    constructor(defaultTtlSeconds = 600) {
+        this.cache = new NodeCache({ stdTTL: defaultTtlSeconds });
+    }
+    async saveSession(state, data, expiresInSeconds) {
+        this.cache.set(state, data, expiresInSeconds);
+    }
+    async getSession(state) {
+        return this.cache.get(state) || null;
+    }
+    async deleteSession(state) {
+        this.cache.del(state);
+    }
+}
+export { LocalSessionCache };
+//# sourceMappingURL=session-cache.js.map

package/dist/dao/session-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cache.js","sourceRoot":"","sources":["../../src/dao/session-cache.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC,MAAM,iBAAiB;IACb,KAAK,CAAY;IAEzB,YAAY,oBAA4B,GAAG;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,IAAS,EAAE,gBAAwB;QAClE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/dao/state-cache.cjs

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStateCache = void 0;
+const node_cache_1 = __importDefault(require("node-cache"));
+class LocalStateCache {
+    cache;
+    constructor(defaultTtlSeconds = 600) {
+        this.cache = new node_cache_1.default({ stdTTL: defaultTtlSeconds });
+    }
+    async saveState(state, data, expiresInSeconds) {
+        this.cache.set(state, data, expiresInSeconds);
+    }
+    async getState(state) {
+        return this.cache.get(state) || null;
+    }
+    async deleteState(state) {
+        this.cache.del(state);
+    }
+}
+exports.LocalStateCache = LocalStateCache;
+//# sourceMappingURL=state-cache.js.map

package/dist/dao/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/dao/types.d.ts

@@ -3,4 +3,9 @@ export interface StateDao {
     getState(state: string): Promise<any | null>;
     deleteState(state: string): Promise<void>;
 }
+export interface SessionDao {
+    saveSession(session: string, data: any, expiresInSeconds: number): Promise<void>;
+    getSession(session: string): Promise<any | null>;
+    deleteSession(session: string): Promise<void>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/dao/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dao/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dao/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C"}

package/dist/export-types/index.d.ts

@@ -12,6 +12,23 @@
  */
 declare type ConfiguredProviderKey<T extends LixaConfig<any>> = keyof T['providers'];
 
+/**
+ * Default session strategy that works with any OAuth provider.
+ * Extracts common token information and creates a standardized session.
+ *
+ * @public
+ */
+export declare class DefaultSessionStrategy implements SessionStrategy {
+    /**
+     * Creates a session from OAuth token data.
+     * Handles common OAuth token formats and extracts the access token.
+     *
+     * @param tokenData - The token data received from the OAuth provider
+     * @returns A Promise that resolves to a Session object
+     */
+    createSession(tokenData: any): Promise<Session>;
+}
+
 /**
  * Interface for OAuth provider implementations.
  *
@@ -62,8 +79,12 @@ export declare interface IProvider {
 export declare class Lixa<TConfig extends LixaConfig<any> = LixaConfig> {
     private static CONFIGURED_PROVIDERS;
     private static LOCAL_STATE_CACHE;
+    private static LOCAL_SESSION_CACHE;
+    private static DEFAULT_SESSION_STRATEGY;
     private config;
     private stateDao;
+    private sesionDao;
+    private sessionStrategy;
     /**
      * Creates a new Lixa instance with the provided configuration.
      *
@@ -160,13 +181,13 @@ export declare class Lixa<TConfig extends LixaConfig<any> = LixaConfig> {
      * @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
+     * @returns A Promise that resolves to the session ID
      *
      * @throws Error when code or state is missing/invalid, or provider is not configured
      *
      * @example
      * ```typescript
-     * const session = await lixa.handleCallback({
+     * const sessionId = await lixa.handleCallback({
      *   provider: 'google',
      *   code: req.query.code,
      *   state: req.query.state
@@ -177,7 +198,8 @@ export declare class Lixa<TConfig extends LixaConfig<any> = LixaConfig> {
         provider: ConfiguredProviderKey<TConfig> | string;
         code: string;
         state?: string;
-    }): Promise<Session>;
+    }): Promise<string>;
+    fetchSessionInfo(sessionId: string): Promise<Session | null>;
     private exchangeCodeForToken;
     private findProviderByType;
 }
@@ -195,6 +217,8 @@ export declare interface LixaConfig<TRegisteredProviders extends string = string
     sessionStrategy?: SessionStrategy;
     /** Optional custom state storage implementation */
     stateDao?: StateDao;
+    /** Optiona: custom session storage implementation */
+    sessionDao?: SessionDao;
 }
 
 /**
@@ -237,6 +261,12 @@ export declare interface Session {
     raw: any;
 }
 
+declare interface SessionDao {
+    saveSession(session: string, data: any, expiresInSeconds: number): Promise<void>;
+    getSession(session: string): Promise<any | null>;
+    deleteSession(session: string): Promise<void>;
+}
+
 /**
  * Strategy interface for custom session creation.
  *

package/dist/index.cjs

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultSessionStrategy = exports.Lixa = void 0;
+var lixa_1 = require("./lixa");
+Object.defineProperty(exports, "Lixa", { enumerable: true, get: function () { return lixa_1.Lixa; } });
+var session_1 = require("./models/session");
+Object.defineProperty(exports, "DefaultSessionStrategy", { enumerable: true, get: function () { return session_1.DefaultSessionStrategy; } });
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -7,6 +7,7 @@
  * @packageDocumentation
  */
 export { Lixa } from "./lixa";
-export { type ProviderConfig, type LixaConfig, type SessionStrategy, type Session, type SafeLixaConfig, } from "./types";
+export { type ProviderConfig, type LixaConfig, type SafeLixaConfig, } from "./types";
+export { type Session, type SessionStrategy, DefaultSessionStrategy } from "./models/session";
 export { type IProvider } from "./providers";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -7,4 +7,5 @@
  * @packageDocumentation
  */
 export { Lixa } from "./lixa";
+export { DefaultSessionStrategy } from "./models/session";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAM9B,OAAO,EAAsC,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lixa.cjs

@@ -0,0 +1,295 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Lixa = void 0;
+const crypto_1 = require("crypto");
+const state_cache_1 = require("./dao/state-cache");
+const crypto_2 = __importDefault(require("crypto"));
+const session_cache_1 = require("./dao/session-cache");
+const session_1 = require("./models/session");
+/**
+ * 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
+ * import { Lixa } from '@vunexa/lixa';
+ * import { GoogleProvider } from '@vunexa/lixa/providers';
+ *
+ * // Register providers before using them
+ * Lixa.registerProvider({ google: new GoogleProvider() });
+ *
+ * const config = Lixa.createConfig({
+ *   providers: {
+ *     google: {
+ *       clientId: 'your-client-id',
+ *       clientSecret: 'your-client-secret',
+ *       redirectUri: 'https://yourapp.com/auth/google/callback',
+ *       scopes: ['openid', 'email', 'profile']
+ *     }
+ *   }
+ * });
+ *
+ * const lixa = new Lixa(config);
+ * ```
+ *
+ * @public
+ */
+class Lixa {
+    static CONFIGURED_PROVIDERS = new Map();
+    static LOCAL_STATE_CACHE = new state_cache_1.LocalStateCache();
+    static LOCAL_SESSION_CACHE = new session_cache_1.LocalSessionCache();
+    static DEFAULT_SESSION_STRATEGY = new session_1.DefaultSessionStrategy();
+    config;
+    stateDao;
+    sesionDao;
+    sessionStrategy;
+    /**
+     * Creates a new Lixa instance with the provided configuration.
+     *
+     * @param config - The configuration object containing provider settings and optional session strategy
+     */
+    constructor(config) {
+        // Validate that all providers in config are registered
+        const configuredProviders = Object.keys(config.providers);
+        const registeredProviders = Lixa.getRegisteredProviders();
+        for (const provider of configuredProviders) {
+            if (!registeredProviders.includes(provider.toLowerCase())) {
+                throw new Error(`Provider '${provider}' is not registered. Please register it first using Lixa.registerProvider()`);
+            }
+        }
+        this.config = config;
+        this.stateDao = config.stateDao || Lixa.LOCAL_STATE_CACHE;
+        this.sesionDao = config.sessionDao || Lixa.LOCAL_SESSION_CACHE;
+        this.sessionStrategy = config.sessionStrategy || Lixa.DEFAULT_SESSION_STRATEGY;
+    }
+    /**
+     * 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) {
+        Object.entries(providerMap).forEach(([key, providerImpl]) => {
+            Lixa.CONFIGURED_PROVIDERS.set(key.toLowerCase(), providerImpl);
+        });
+    }
+    /**
+     * Gets the list of registered provider names.
+     *
+     * @returns Array of registered provider names
+     */
+    static getRegisteredProviders() {
+        return Array.from(Lixa.CONFIGURED_PROVIDERS.keys());
+    }
+    /**
+     * Creates a type-safe configuration that only allows registered providers.
+     *
+     * @param config - Configuration object with providers that must be registered
+     * @returns The same configuration object, but with type safety for registered providers
+     */
+    static createConfig(config) {
+        // Validate that all providers in config are registered
+        const configuredProviders = Object.keys(config.providers);
+        const registeredProviders = Lixa.getRegisteredProviders();
+        for (const provider of configuredProviders) {
+            if (!registeredProviders.includes(provider.toLowerCase())) {
+                throw new Error(`Provider '${provider}' is not registered. Please register it first using Lixa.registerProvider()`);
+            }
+        }
+        return config;
+    }
+    /**
+     * 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 (0, crypto_1.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 (0, crypto_1.randomBytes)(32).toString("hex");
+    }
+    static buildCodeChallenge(codeVerifier) {
+        const hash = crypto_2.default
+            .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 the session ID
+     *
+     * @throws Error when code or state is missing/invalid, or provider is not configured
+     *
+     * @example
+     * ```typescript
+     * const sessionId = 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);
+        const session = await this.sessionStrategy.createSession(tokens);
+        // Generate unique session ID
+        const sessionId = (0, crypto_1.randomBytes)(32).toString("hex");
+        // Store session with 24 hour TTL (86400 seconds)
+        await this.sesionDao.saveSession(sessionId, session, 86400);
+        return sessionId;
+    }
+    fetchSessionInfo(sessionId) {
+        return this.sesionDao.getSession(sessionId);
+    }
+    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];
+    }
+}
+exports.Lixa = Lixa;
+//# sourceMappingURL=lixa.js.map

package/dist/lixa.d.ts

@@ -1,5 +1,6 @@
-import { type LixaConfig, type ProviderConfig, type Session } from "./types";
+import { type LixaConfig, type ProviderConfig } from "./types";
 import { IProvider } from "./providers";
+import { type Session } from "./models/session";
 /**
  * Type representing the keys of configured providers
  */
@@ -37,8 +38,12 @@ type ConfiguredProviderKey<T extends LixaConfig<any>> = keyof T['providers'];
 declare class Lixa<TConfig extends LixaConfig<any> = LixaConfig> {
     private static CONFIGURED_PROVIDERS;
     private static LOCAL_STATE_CACHE;
+    private static LOCAL_SESSION_CACHE;
+    private static DEFAULT_SESSION_STRATEGY;
     private config;
     private stateDao;
+    private sesionDao;
+    private sessionStrategy;
     /**
      * Creates a new Lixa instance with the provided configuration.
      *
@@ -135,13 +140,13 @@ declare class Lixa<TConfig extends LixaConfig<any> = LixaConfig> {
      * @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
+     * @returns A Promise that resolves to the session ID
      *
      * @throws Error when code or state is missing/invalid, or provider is not configured
      *
      * @example
      * ```typescript
-     * const session = await lixa.handleCallback({
+     * const sessionId = await lixa.handleCallback({
      *   provider: 'google',
      *   code: req.query.code,
      *   state: req.query.state
@@ -152,7 +157,8 @@ declare class Lixa<TConfig extends LixaConfig<any> = LixaConfig> {
         provider: ConfiguredProviderKey<TConfig> | string;
         code: string;
         state?: string;
-    }): Promise<Session>;
+    }): Promise<string>;
+    fetchSessionInfo(sessionId: string): Promise<Session | null>;
     private exchangeCodeForToken;
     private findProviderByType;
 }

package/dist/lixa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lixa.d.ts","sourceRoot":"","sources":["../src/lixa.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC;;GAEG;AACH,KAAK,qBAAqB,CAAC,CAAC,SAAS,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,cAAM,IAAI,CAAC,OAAO,SAAS,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU;IACrD,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAqC;IACxE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAyB;IACzD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,QAAQ,CAAW;IAE3B;;;;OAIG;gBACS,MAAM,EAAE,OAAO;IAe3B;;;;;;;;;;;;;;OAcG;IACI,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC;IAM1G;;;;;;;;;;;;;;;OAeG;WACW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI;IAMzF;;;;OAIG;WACW,sBAAsB,IAAI,MAAM,EAAE;IAIhD;;;;;OAKG;WACW,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACjE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG;QAAE,SAAS,EAAE,CAAC,CAAA;KAAE,GACtD,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAc/B;;;;;;;OAOG;WACW,mBAAmB,IAAI,MAAM;IAI3C;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAUjC;;;;;;;;;;;;;;;OAeG;IACI,UAAU,CAAC,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAsC3F;;;;;;;;;;;;;;;;;;OAkBG;IACU,cAAc,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,KAAK,GACN,EAAE;QACD,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;QAClD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC;YAmDN,oBAAoB;IAsClC,OAAO,CAAC,kBAAkB;CAG3B;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"lixa.d.ts","sourceRoot":"","sources":["../src/lixa.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAKxC,OAAO,EAAE,KAAK,OAAO,EAAgD,MAAM,kBAAkB,CAAC;AAO9F;;GAEG;AACH,KAAK,qBAAqB,CAAC,CAAC,SAAS,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,cAAM,IAAI,CAAC,OAAO,SAAS,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU;IACrD,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAqC;IACxE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAyB;IACzD,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAA2B;IAC7D,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAgC;IACvE,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;;OAIG;gBACS,MAAM,EAAE,OAAO;IAiB3B;;;;;;;;;;;;;;OAcG;IACI,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC;IAM1G;;;;;;;;;;;;;;;OAeG;WACW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI;IAMzF;;;;OAIG;WACW,sBAAsB,IAAI,MAAM,EAAE;IAIhD;;;;;OAKG;WACW,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACjE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG;QAAE,SAAS,EAAE,CAAC,CAAA;KAAE,GACtD,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAc/B;;;;;;;OAOG;WACW,mBAAmB,IAAI,MAAM;IAI3C;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAUjC;;;;;;;;;;;;;;;OAeG;IACI,UAAU,CAAC,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAsC3F;;;;;;;;;;;;;;;;;;OAkBG;IACU,cAAc,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,KAAK,GACN,EAAE;QACD,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;QAClD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDZ,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YAIrD,oBAAoB;IAsClC,OAAO,CAAC,kBAAkB;CAG3B;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/lixa.js

@@ -1,6 +1,8 @@
 import { randomBytes } from "crypto";
 import { LocalStateCache } from "./dao/state-cache";
 import crypto from "crypto";
+import { LocalSessionCache } from "./dao/session-cache";
+import { DefaultSessionStrategy } from "./models/session";
 /**
  * A flexible, provider-agnostic OAuth 2.0 and OpenID Connect (OIDC) client library.
  *
@@ -34,8 +36,12 @@ import crypto from "crypto";
 class Lixa {
     static CONFIGURED_PROVIDERS = new Map();
     static LOCAL_STATE_CACHE = new LocalStateCache();
+    static LOCAL_SESSION_CACHE = new LocalSessionCache();
+    static DEFAULT_SESSION_STRATEGY = new DefaultSessionStrategy();
     config;
     stateDao;
+    sesionDao;
+    sessionStrategy;
     /**
      * Creates a new Lixa instance with the provided configuration.
      *
@@ -52,6 +58,8 @@ class Lixa {
         }
         this.config = config;
         this.stateDao = config.stateDao || Lixa.LOCAL_STATE_CACHE;
+        this.sesionDao = config.sessionDao || Lixa.LOCAL_SESSION_CACHE;
+        this.sessionStrategy = config.sessionStrategy || Lixa.DEFAULT_SESSION_STRATEGY;
     }
     /**
      * Checks if a provider is both registered and configured for this instance.
@@ -200,13 +208,13 @@ class Lixa {
      * @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
+     * @returns A Promise that resolves to the session ID
      *
      * @throws Error when code or state is missing/invalid, or provider is not configured
      *
      * @example
      * ```typescript
-     * const session = await lixa.handleCallback({
+     * const sessionId = await lixa.handleCallback({
      *   provider: 'google',
      *   code: req.query.code,
      *   state: req.query.state
@@ -237,17 +245,15 @@ class Lixa {
         }
         // 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;
+        const session = await this.sessionStrategy.createSession(tokens);
+        // Generate unique session ID
+        const sessionId = randomBytes(32).toString("hex");
+        // Store session with 24 hour TTL (86400 seconds)
+        await this.sesionDao.saveSession(sessionId, session, 86400);
+        return sessionId;
+    }
+    fetchSessionInfo(sessionId) {
+        return this.sesionDao.getSession(sessionId);
     }
     async exchangeCodeForToken(code, providerConfig, providerImpl, codeVerifier) {
         // Build the request body

package/dist/lixa.js.map

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

package/dist/models/session.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultSessionStrategy = void 0;
+/**
+ * Default session strategy that works with any OAuth provider.
+ * Extracts common token information and creates a standardized session.
+ *
+ * @public
+ */
+class DefaultSessionStrategy {
+    /**
+     * Creates a session from OAuth token data.
+     * Handles common OAuth token formats and extracts the access token.
+     *
+     * @param tokenData - The token data received from the OAuth provider
+     * @returns A Promise that resolves to a Session object
+     */
+    async createSession(tokenData) {
+        // Extract access token from various possible formats
+        const accessToken = tokenData.access_token ||
+            tokenData.accessToken ||
+            tokenData.token ||
+            tokenData;
+        if (!accessToken || typeof accessToken !== 'string') {
+            throw new Error('No valid access token found in OAuth response');
+        }
+        return {
+            token: accessToken,
+            raw: tokenData,
+        };
+    }
+}
+exports.DefaultSessionStrategy = DefaultSessionStrategy;
+//# sourceMappingURL=session.js.map

package/dist/models/session.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Represents a user session after successful OAuth authentication.
+ *
+ * @public
+ */
+export 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 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>;
+}
+/**
+ * Default session strategy that works with any OAuth provider.
+ * Extracts common token information and creates a standardized session.
+ *
+ * @public
+ */
+export declare class DefaultSessionStrategy implements SessionStrategy {
+    /**
+     * Creates a session from OAuth token data.
+     * Handles common OAuth token formats and extracts the access token.
+     *
+     * @param tokenData - The token data received from the OAuth provider
+     * @returns A Promise that resolves to a Session object
+     */
+    createSession(tokenData: any): Promise<Session>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/models/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/models/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;CAgBtD"}

package/dist/models/session.js

@@ -0,0 +1,30 @@
+/**
+ * Default session strategy that works with any OAuth provider.
+ * Extracts common token information and creates a standardized session.
+ *
+ * @public
+ */
+export class DefaultSessionStrategy {
+    /**
+     * Creates a session from OAuth token data.
+     * Handles common OAuth token formats and extracts the access token.
+     *
+     * @param tokenData - The token data received from the OAuth provider
+     * @returns A Promise that resolves to a Session object
+     */
+    async createSession(tokenData) {
+        // Extract access token from various possible formats
+        const accessToken = tokenData.access_token ||
+            tokenData.accessToken ||
+            tokenData.token ||
+            tokenData;
+        if (!accessToken || typeof accessToken !== 'string') {
+            throw new Error('No valid access token found in OAuth response');
+        }
+        return {
+            token: accessToken,
+            raw: tokenData,
+        };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/models/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/models/session.ts"],"names":[],"mappings":"AA2BA;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACjC;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,SAAc;QAChC,qDAAqD;QACrD,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY;YACvB,SAAS,CAAC,WAAW;YACrB,SAAS,CAAC,KAAK;YACf,SAAS,CAAC;QAE7B,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,GAAG,EAAE,SAAS;SACf,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/IProvider.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProvider.js.map

package/dist/providers/github.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubProvider = void 0;
+/**
+ * GitHub OAuth provider implementation
+ * @public
+ */
+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";
+}
+exports.GithubProvider = GithubProvider;
+//# sourceMappingURL=github.js.map

package/dist/providers/google.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleProvider = void 0;
+/**
+ * Google OAuth provider implementation
+ * @public
+ */
+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";
+}
+exports.GoogleProvider = GoogleProvider;
+//# sourceMappingURL=google.js.map

package/dist/providers/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleProvider = exports.GithubProvider = void 0;
+var github_1 = require("./github");
+Object.defineProperty(exports, "GithubProvider", { enumerable: true, get: function () { return github_1.GithubProvider; } });
+var google_1 = require("./google");
+Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return google_1.GoogleProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/providers-entry.cjs

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Built-in OAuth providers for Lixa
+ *
+ * @remarks
+ * Import and register these providers before using them in your Lixa configuration.
+ *
+ * @example
+ * ```typescript
+ * import { Lixa } from '@vunexa/lixa';
+ * import { GoogleProvider, GithubProvider } from '@vunexa/lixa/providers';
+ *
+ * // Register the providers you want to use
+ * Lixa.registerProvider({
+ *   google: new GoogleProvider(),
+ *   github: new GithubProvider(),
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubProvider = exports.GoogleProvider = void 0;
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return providers_1.GoogleProvider; } });
+Object.defineProperty(exports, "GithubProvider", { enumerable: true, get: function () { return providers_1.GithubProvider; } });
+//# sourceMappingURL=providers-entry.js.map

package/dist/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.d.ts

@@ -1,4 +1,6 @@
-import { StateDao } from "./dao/types";
+import { SessionDao, StateDao } from "./dao/types";
+import { SessionStrategy } from "./models/session";
+export { SessionStrategy };
 /**
  * Configuration for an OAuth provider.
  *
@@ -29,31 +31,8 @@ export interface LixaConfig<TRegisteredProviders extends string = string> {
     sessionStrategy?: SessionStrategy;
     /** Optional custom state storage implementation */
     stateDao?: StateDao;
-}
-/**
- * Strategy interface for custom session creation.
- *
- * @public
- */
-export 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>;
-}
-/**
- * Represents a user session after successful OAuth authentication.
- *
- * @public
- */
-export interface Session {
-    /** The session token (typically the access token) */
-    token: string;
-    /** Raw token data from the OAuth provider */
-    raw: any;
+    /** Optiona: custom session storage implementation */
+    sessionDao?: SessionDao;
 }
 /**
  * Helper type to create a configuration with only registered providers.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,oBAAoB,SAAS,MAAM,GAAG,MAAM;IACtE,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;IACxD,gDAAgD;IAChD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,UAAU,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG;IACtH,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,oBAAoB,SAAS,MAAM,GAAG,MAAM;IACtE,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;IACxD,gDAAgD;IAChD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,UAAU,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG;IACtH,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC"}

package/dist/utils/constants.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB = exports.GOOGLE = void 0;
+const GOOGLE = "google";
+exports.GOOGLE = GOOGLE;
+const GITHUB = "github";
+exports.GITHUB = GITHUB;
+//# sourceMappingURL=constants.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vunexa/lixa",
-  "version": "0.0.1-alpha.12",
+  "version": "0.0.1-alpha.14",
   "description": "Lixa is a flexible, provider-agnostic OAuth and OpenID Connect (OIDC) client library that simplifies multi-provider authentication flows. It supports seamless integration with providers like Google and GitHub, offers extensible session management, and enables dynamic provider resolution based on callback URLs.",
   "keywords": [
     "oauth",
@@ -14,16 +14,20 @@
   "exports": {
     ".": {
       "types": "./dist/export-types/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     },
     "./providers": {
       "types": "./dist/export-types/providers.d.ts",
-      "import": "./dist/providers-entry.js"
+      "import": "./dist/providers-entry.js",
+      "require": "./dist/providers-entry.cjs"
     }
   },
   "scripts": {
-    "build": "tsc && npm run test && api-extractor run --local && api-extractor run --local --config api-extractor-providers.json",
-    "clean": "rm -rf dist",
+    "build": "npm run build:esm && npm run build:cjs && npm run test && api-extractor run --local && api-extractor run --local --config api-extractor-providers.json",
+    "build:esm": "tsc",
+    "build:cjs": "tsc --module commonjs --outDir dist-cjs && node scripts/rename-cjs.cjs",
+    "clean": "rm -rf dist dist-cjs",
     "prepublishOnly": "npm run clean && npm run build",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",