@vunexa/lixa 0.0.1-alpha.16 → 0.0.1-alpha.18

package/dist/providers-entry.cjs

@@ -1,27 +1,48 @@
 "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.cjs");
-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
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/providers-entry.ts
+var providers_entry_exports = {};
+__export(providers_entry_exports, {
+  GithubProvider: () => GithubProvider,
+  GoogleProvider: () => GoogleProvider
+});
+module.exports = __toCommonJS(providers_entry_exports);
+
+// src/providers/github.ts
+var GithubProvider = class {
+  providerType = "GITHUB";
+  authorizationEndpoint = "https://github.com/login/oauth/authorize";
+  tokenEndpoint = "https://github.com/login/oauth/access_token";
+  userInfoEndpoint = "https://api.github.com/user";
+};
+
+// src/providers/google.ts
+var GoogleProvider = class {
+  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";
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GithubProvider,
+  GoogleProvider
+});
+//# sourceMappingURL=providers-entry.cjs.map

package/dist/providers-entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers-entry.ts","../src/providers/github.ts","../src/providers/google.ts"],"sourcesContent":["/**\n * Built-in OAuth providers for Lixa\n * \n * @remarks\n * Import and register these providers before using them in your Lixa configuration.\n * \n * @example\n * ```typescript\n * import { Lixa } from '@vunexa/lixa';\n * import { GoogleProvider, GithubProvider } from '@vunexa/lixa/providers';\n * \n * // Register the providers you want to use\n * Lixa.registerProvider({\n *   google: new GoogleProvider(),\n *   github: new GithubProvider(),\n * });\n * ```\n * \n * @packageDocumentation\n */\n\nexport { GoogleProvider, GithubProvider, type IProvider } from \"./providers\";","import { IProvider } from \"./IProvider\";\n\n/**\n * GitHub OAuth provider implementation\n * @public\n */\nclass GithubProvider implements IProvider {\n  providerType = \"GITHUB\";\n  authorizationEndpoint = \"https://github.com/login/oauth/authorize\";\n  tokenEndpoint = \"https://github.com/login/oauth/access_token\";\n  userInfoEndpoint = \"https://api.github.com/user\";\n}\n\nexport { GithubProvider };\n","import { IProvider } from \"./IProvider\";\n\n/**\n * Google OAuth provider implementation\n * @public\n */\nclass GoogleProvider implements IProvider {\n  providerType = \"GOOGLE\";\n  authorizationEndpoint = \"https://accounts.google.com/o/oauth2/v2/auth\";\n  tokenEndpoint = \"https://oauth2.googleapis.com/token\";\n  userInfoEndpoint = \"https://www.googleapis.com/oauth2/v2/userinfo\";\n}\n\nexport { GoogleProvider };"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMA,IAAM,iBAAN,MAA0C;AAAA,EACxC,eAAe;AAAA,EACf,wBAAwB;AAAA,EACxB,gBAAgB;AAAA,EAChB,mBAAmB;AACrB;;;ACLA,IAAM,iBAAN,MAA0C;AAAA,EACxC,eAAe;AAAA,EACf,wBAAwB;AAAA,EACxB,gBAAgB;AAAA,EAChB,mBAAmB;AACrB;","names":[]}

package/dist/providers-entry.d.cts

@@ -0,0 +1,25 @@
+import { I as IProvider } from './IProvider-2tDwRAnH.cjs';
+
+/**
+ * GitHub OAuth provider implementation
+ * @public
+ */
+declare class GithubProvider implements IProvider {
+    providerType: string;
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    userInfoEndpoint: string;
+}
+
+/**
+ * Google OAuth provider implementation
+ * @public
+ */
+declare class GoogleProvider implements IProvider {
+    providerType: string;
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    userInfoEndpoint: string;
+}
+
+export { GithubProvider, GoogleProvider, IProvider };

package/dist/providers-entry.js

@@ -1,22 +1,20 @@
-/**
- * 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
- */
-export { GoogleProvider, GithubProvider } from "./providers";
+// src/providers/github.ts
+var GithubProvider = class {
+  providerType = "GITHUB";
+  authorizationEndpoint = "https://github.com/login/oauth/authorize";
+  tokenEndpoint = "https://github.com/login/oauth/access_token";
+  userInfoEndpoint = "https://api.github.com/user";
+};
+
+// src/providers/google.ts
+var GoogleProvider = class {
+  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 {
+  GithubProvider,
+  GoogleProvider
+};
 //# sourceMappingURL=providers-entry.js.map

package/dist/providers-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers-entry.js","sourceRoot":"","sources":["../src/providers-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAC"}
+{"version":3,"sources":["../src/providers/github.ts","../src/providers/google.ts"],"sourcesContent":["import { IProvider } from \"./IProvider\";\n\n/**\n * GitHub OAuth provider implementation\n * @public\n */\nclass GithubProvider implements IProvider {\n  providerType = \"GITHUB\";\n  authorizationEndpoint = \"https://github.com/login/oauth/authorize\";\n  tokenEndpoint = \"https://github.com/login/oauth/access_token\";\n  userInfoEndpoint = \"https://api.github.com/user\";\n}\n\nexport { GithubProvider };\n","import { IProvider } from \"./IProvider\";\n\n/**\n * Google OAuth provider implementation\n * @public\n */\nclass GoogleProvider implements IProvider {\n  providerType = \"GOOGLE\";\n  authorizationEndpoint = \"https://accounts.google.com/o/oauth2/v2/auth\";\n  tokenEndpoint = \"https://oauth2.googleapis.com/token\";\n  userInfoEndpoint = \"https://www.googleapis.com/oauth2/v2/userinfo\";\n}\n\nexport { GoogleProvider };"],"mappings":";AAMA,IAAM,iBAAN,MAA0C;AAAA,EACxC,eAAe;AAAA,EACf,wBAAwB;AAAA,EACxB,gBAAgB;AAAA,EAChB,mBAAmB;AACrB;;;ACLA,IAAM,iBAAN,MAA0C;AAAA,EACxC,eAAe;AAAA,EACf,wBAAwB;AAAA,EACxB,gBAAgB;AAAA,EAChB,mBAAmB;AACrB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vunexa/lixa",
-  "version": "0.0.1-alpha.16",
+  "version": "0.0.1-alpha.18",
   "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",
@@ -9,8 +9,9 @@
   "license": "MIT",
   "author": "vamsi",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/export-types/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/export-types/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/export-types/index.d.ts",
@@ -23,11 +24,17 @@
       "require": "./dist/providers-entry.cjs"
     }
   },
+  "typesVersions": {
+    "*": {
+      "providers": [
+        "./dist/export-types/providers.d.ts"
+      ]
+    }
+  },
   "scripts": {
-    "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",
+    "build": "tsup && npm run test && npm run build:api-docs",
+    "build:api-docs": "tsc --emitDeclarationOnly && api-extractor run --local && api-extractor run --local --config api-extractor-providers.json",
+    "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",
@@ -36,9 +43,11 @@
     "test:coverage": "jest --coverage",
     "api-extractor": "api-extractor run --local --verbose",
     "docs:api": "npm run build && api-documenter markdown --input temp --output ./docs/api",
-    "publish:alpha": "npm run build && npm version prerelease --preid=alpha && npm publish --tag alpha",
-    "publish:beta": "npm run build && npm version prerelease --preid=beta && npm publish --tag beta",
-    "publish:stable": "npm run build && npm version patch && npm publish --tag latest"
+    "pub:alpha": "npm version prerelease --preid=alpha && npm publish --tag alpha",
+    "pub:beta": "npm version prerelease --preid=beta && npm publish --tag beta",
+    "pub:patch": "npm version patch && npm publish --tag latest",
+    "pub:minor": "npm version minor && npm publish --tag latest",
+    "pub:major": "npm version major && npm publish --tag latest"
   },
   "files": [
     "dist",
@@ -59,6 +68,7 @@
     "globals": "^16.3.0",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.2",
+    "tsup": "^8.5.0",
     "typescript": "^5.9.2"
   },
   "dependencies": {

package/dist/dao/session-cache.cjs

@@ -1,24 +0,0 @@
-"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.js

@@ -1,18 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-"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/state-cache.js

@@ -1,18 +0,0 @@
-import NodeCache from 'node-cache';
-class LocalStateCache {
-    cache;
-    constructor(defaultTtlSeconds = 600) {
-        this.cache = new NodeCache({ 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);
-    }
-}
-export { LocalStateCache };
-//# sourceMappingURL=state-cache.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"state-cache.js","sourceRoot":"","sources":["../../src/dao/state-cache.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC,MAAM,eAAe;IACX,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,SAAS,CAAC,KAAa,EAAE,IAAS,EAAE,gBAAwB;QAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/dao/types.cjs

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

package/dist/dao/types.js

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

package/dist/dao/types.js.map

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

package/dist/lixa.cjs

@@ -1,295 +0,0 @@
-"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.cjs");
-const crypto_2 = __importDefault(require("crypto"));
-const session_cache_1 = require("./dao/session-cache.cjs");
-const session_1 = require("./models/session.cjs");
-/**
- * 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