@vunexa/lixa 0.0.1-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [@vunexa/lixa]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+# @vunexa/lixa
+
+> Package is in very early stage and can have frequent breaking changes. DO NOT USE it for production
+
+[![npm version](https://img.shields.io/npm/v/@vunexa/lixa.svg)](https://www.npmjs.com/package/@vunexa/lixa)
+[![npm downloads](https://img.shields.io/npm/dm/@vunexa/lixa.svg)](https://www.npmjs.com/package/@vunexa/lixa)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A flexible, provider-agnostic OAuth 2.0 and OpenID Connect (OIDC) client library for backend applications.  
+@vunexa/lixa simplifies multi-provider authentication flows (e.g., Google, GitHub), supports extensible session management, and enables custom provider registration.
+
+---
+
+## Features
+
+- Multi-provider OAuth/OIDC support with unified API
+- Built-in support for popular providers like Google and GitHub
+- Custom provider registration with extensible provider interface
+- Extensible session management via pluggable strategies
+- PKCE (Proof Key for Code Exchange) support
+- TypeScript-first with strong typing and async/await support
+- 100% test coverage with comprehensive error handling
+
+---
+
+## Installation
+
+```bash
+npm install @vunexa/lixa
+# or
+yarn add @vunexa/lixa
+```
+
+## Quick Start
+
+### 1. Configure lixa with multiple providers
+
+```typescript
+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'],
+      extraConfig: {
+        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'],
+      extraConfig: {},
+    },
+  },
+
+  // Optional: custom session strategy
+  sessionStrategy: {
+    createSession: async (tokenData) => {
+      // Custom session creation logic
+      return {
+        token: 'custom-session-token',
+        raw: tokenData
+      };
+    }
+  },
+});
+```
+
+### 2. Redirect users to the provider's authorization URL
+
+```typescript
+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);
+});
+```
+
+### 3. Handle the provider callback and establish a session
+
+```typescript
+app.get("/auth/:provider/callback", async (req, res) => {
+  const { code, state } = req.query;
+  const provider = req.params.provider;
+
+  try {
+    // Validate state parameter
+    if (state !== req.session.oauthState) {
+      throw new Error('Invalid state parameter');
+    }
+
+    const session = await lixa.handleCallback({
+      provider,
+      code: code as string,
+      state: state as string,
+    });
+
+    // Session established
+    res.cookie("session_token", session.token, {
+      httpOnly: true,
+      secure: true,
+      sameSite: 'strict'
+    });
+    
+    res.redirect("/dashboard");
+  } catch (error) {
+    console.error("Authentication error:", error);
+    res.status(500).send("Authentication failed");
+  }
+});
+```
+
+## Advanced Usage
+
+### Custom Provider Registration
+
+You can register custom OAuth providers by implementing the `IProvider` interface:
+
+```typescript
+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';
+}
+
+// Register the custom provider
+Lixa.registerProvider({
+  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'],
+    }
+  }
+});
+```
+
+### Check Provider Registration
+
+```typescript
+// Check if a provider is registered
+if (Lixa.isProviderRegistered('google')) {
+  console.log('Google provider is available');
+}
+```
+
+## API Reference
+
+### `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
+
+### Types
+
+```typescript
+interface ProviderConfig {
+  clientId: string;
+  clientSecret: string;
+  redirectUri: string;
+  scopes: string[];
+  extraConfig?: Record<string, any>;
+}
+
+interface LixaConfig {
+  providers: Record<string, ProviderConfig>;
+  sessionStrategy?: SessionStrategy;
+}
+
+interface SessionStrategy {
+  createSession(userInfo: any): Promise<Session>;
+}
+
+interface Session {
+  token: string;
+  raw: any;
+}
+
+interface IProvider {
+  authorizationEndpoint: string;
+  tokenEndpoint: string;
+  userInfoEndpoint: string;
+}
+```
+
+## Built-in Providers
+
+- **Google** - OAuth 2.0 and OpenID Connect
+- **GitHub** - OAuth 2.0
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Build the library
+npm run build
+
+# Lint code
+npm run lint
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Lixa } from "./lixa";
+export { type ProviderConfig, type LixaConfig, type SessionStrategy, type Session, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,OAAO,GACb,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Lixa } from "./lixa";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}

package/dist/lixa.d.ts

@@ -0,0 +1,25 @@
+import { type LixaConfig, type Session } from "./types";
+import { IProvider } from "./providers";
+/**
+ * @public
+ */
+declare class Lixa {
+    private static CONFIGURED_PROVIDERS;
+    private config;
+    constructor(config: LixaConfig);
+    static isProviderRegistered(provider: string): boolean;
+    static registerProvider(providerMap: {
+        [key: string]: IProvider;
+    }): void;
+    generateRandomState(): string;
+    getAuthUrl(provider: string, state: string): string;
+    handleCallback({ provider, code, state, }: {
+        provider: string;
+        code: string;
+        state?: string;
+    }): Promise<Session>;
+    private exchangeCodeForToken;
+    private findProviderByType;
+}
+export { Lixa };
+//# sourceMappingURL=lixa.d.ts.map

package/dist/lixa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lixa.d.ts","sourceRoot":"","sources":["../src/lixa.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAuB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAkC,MAAM,aAAa,CAAC;AAGxE;;GAEG;AACH,cAAM,IAAI;IACR,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAqC;IACxE,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;WAUhB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;WAI/C,gBAAgB,CAAC,WAAW,EAAE;QAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;KAC1B,GAAG,IAAI;IAQD,mBAAmB,IAAI,MAAM;IAI7B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAqB7C,cAAc,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,KAAK,GACN,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC;YAuCN,oBAAoB;IAsClC,OAAO,CAAC,kBAAkB;CAG3B;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/lixa.js

@@ -0,0 +1,107 @@
+import { randomBytes } from "crypto";
+import { GithubProvider, GoogleProvider } from "./providers";
+import { GITHUB, GOOGLE } from "./utils/constants";
+/**
+ * @public
+ */
+class Lixa {
+    static CONFIGURED_PROVIDERS = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+        if (!Lixa.CONFIGURED_PROVIDERS.has(GITHUB)) {
+            Lixa.CONFIGURED_PROVIDERS.set(GITHUB, new GithubProvider());
+        }
+        if (!Lixa.CONFIGURED_PROVIDERS.has(GOOGLE)) {
+            Lixa.CONFIGURED_PROVIDERS.set(GOOGLE, new GoogleProvider());
+        }
+    }
+    static isProviderRegistered(provider) {
+        return Lixa.CONFIGURED_PROVIDERS.has(provider.toLowerCase());
+    }
+    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);
+        });
+    }
+    generateRandomState() {
+        return randomBytes(16).toString("hex");
+    }
+    getAuthUrl(provider, state) {
+        const providerType = 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 params = new URLSearchParams({
+            client_id: providerConfig.clientId,
+            redirect_uri: providerConfig.redirectUri,
+            scope: providerConfig.scopes.join(" "),
+            state,
+            response_type: "code",
+            ...providerConfig.extraConfig,
+        });
+        return `${providerImpl.authorizationEndpoint}?${params.toString()}`;
+    }
+    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");
+        }
+        //TODO: Validate state here
+        const providerConfig = this.findProviderByType(provider.toLowerCase());
+        const providerImpl = Lixa.CONFIGURED_PROVIDERS.get(provider);
+        if (!providerConfig || !providerImpl) {
+            throw new Error(`Provider ${provider} not configured`);
+        }
+        // Exchange code for tokens and fetch user info here.
+        const tokens = await this.exchangeCodeForToken(code, providerConfig, providerImpl);
+        // 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

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

package/dist/providers/IProvider.d.ts

@@ -0,0 +1,7 @@
+interface IProvider {
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    userInfoEndpoint: string;
+}
+export { IProvider };
+//# sourceMappingURL=IProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IProvider.ts"],"names":[],"mappings":"AAEA,UAAU,SAAS;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/providers/IProvider.js

@@ -0,0 +1,3 @@
+// Implement an extandable interface for authentication providers
+export {};
+//# sourceMappingURL=IProvider.js.map

package/dist/providers/IProvider.js.map

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

package/dist/providers/github.d.ts

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

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

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+export { IProvider } from "./IProvider";
+export { GithubProvider } from "./github";
+export { GoogleProvider } from "./google";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/providers/index.js

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

package/dist/providers/index.js.map

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

@@ -0,0 +1,31 @@
+/**
+ * @public
+ */
+export interface ProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    scopes: string[];
+    extraConfig?: Record<string, any>;
+}
+/**
+ * @public
+ */
+export interface LixaConfig {
+    providers: Record<string, ProviderConfig>;
+    sessionStrategy?: SessionStrategy;
+}
+/**
+ * @public
+ */
+export interface SessionStrategy {
+    createSession(userInfo: any): Promise<Session>;
+}
+/**
+ * @public
+ */
+export interface Session {
+    token: string;
+    raw: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,GAAG,CAAC;CACV"}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils/constants.d.ts

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

package/dist/utils/constants.d.ts.map

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

package/dist/utils/constants.js

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

package/dist/utils/constants.js.map

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

@@ -0,0 +1,63 @@
+declare interface IProvider {
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    userInfoEndpoint: string;
+}
+
+/**
+ * @public
+ */
+export declare class Lixa {
+    private static CONFIGURED_PROVIDERS;
+    private config;
+    constructor(config: LixaConfig);
+    static isProviderRegistered(provider: string): boolean;
+    static registerProvider(providerMap: {
+        [key: string]: IProvider;
+    }): void;
+    generateRandomState(): string;
+    getAuthUrl(provider: string, state: string): string;
+    handleCallback({ provider, code, state, }: {
+        provider: string;
+        code: string;
+        state?: string;
+    }): Promise<Session>;
+    private exchangeCodeForToken;
+    private findProviderByType;
+}
+
+/**
+ * @public
+ */
+export declare interface LixaConfig {
+    providers: Record<string, ProviderConfig>;
+    sessionStrategy?: SessionStrategy;
+}
+
+/**
+ * @public
+ */
+export declare interface ProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    scopes: string[];
+    extraConfig?: Record<string, any>;
+}
+
+/**
+ * @public
+ */
+export declare interface Session {
+    token: string;
+    raw: any;
+}
+
+/**
+ * @public
+ */
+export declare interface SessionStrategy {
+    createSession(userInfo: any): Promise<Session>;
+}
+
+export { }

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@vunexa/lixa",
+  "version": "0.0.1-alpha.3",
+  "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",
+    "oidc"
+  ],
+  "license": "MIT",
+  "author": "vamsi",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc && npm run test && api-extractor run --local",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "api-extractor": "api-extractor run --local --verbose",
+    "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"
+  },
+  "files": [
+    "dist",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "@microsoft/api-extractor": "^7.52.11",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^24.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.42.0",
+    "@typescript-eslint/parser": "^8.42.0",
+    "eslint": "^9.35.0",
+    "globals": "^16.3.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.9.2"
+  }
+}