canxjs 1.6.2 → 1.6.3

package/README.md

@@ -227,6 +227,29 @@ my-app/
 - [Middleware](http://docs-canxjs.netlify.app/docs/middleware)
 - [HotWire](http://docs-canxjs.netlify.app/docs/hotwire)
 
+## Optional Dependencies
+
+CanxJS is designed to be lightweight. Some features require additional packages:
+
+| Feature     | Required Package      | Install Command      |
+| ----------- | --------------------- | -------------------- |
+| PostgreSQL  | `pg`                  | `bun add pg`         |
+| S3 Storage  | Built-in (uses fetch) | -                    |
+| SMTP Email  | `nodemailer`          | `bun add nodemailer` |
+| Redis Cache | `ioredis`             | `bun add ioredis`    |
+
+## Official Packages
+
+Extend CanxJS with official packages:
+
+| Package                                                            | Description                                        | Install                    |
+| ------------------------------------------------------------------ | -------------------------------------------------- | -------------------------- |
+| [@canxjs/citadel](https://www.npmjs.com/package/@canxjs/citadel)   | API Token Authentication (like Laravel Sanctum)    | `bun add @canxjs/citadel`  |
+| [@canxjs/dominion](https://www.npmjs.com/package/@canxjs/dominion) | Role-Based Access Control (like Spatie Permission) | `bun add @canxjs/dominion` |
+| [@canxjs/blocks](https://www.npmjs.com/package/@canxjs/blocks)     | Modular Architecture (HMVC)                        | `bun add @canxjs/blocks`   |
+| [@canxjs/payment](https://www.npmjs.com/package/@canxjs/payment)   | Midtrans Payment Gateway                           | `bun add @canxjs/payment`  |
+| [@canxjs/echo](https://www.npmjs.com/package/@canxjs/echo)         | Real-time Event Broadcasting                       | `bun add @canxjs/echo`     |
+
 ## License
 
 MIT © CanxJS Team

package/dist/src/Application.d.ts

@@ -2,6 +2,7 @@
  * CanxJS - Main Application Class
  */
 import type { ServerConfig, MiddlewareHandler, CanxApplication, RouterInstance, Plugin } from './types';
+import { Server } from './core/Server';
 import { Router } from './core/Router';
 export declare class Canx implements CanxApplication {
     config: ServerConfig;
@@ -38,6 +39,10 @@ export declare class Canx implements CanxApplication {
      * Stop the server
      */
     close(): Promise<void>;
+    /**
+     * Get the internal server instance
+     */
+    getServer(): Server | null;
     /**
      * Get router for chaining
      */
@@ -71,5 +76,17 @@ export declare function createApp(config?: ServerConfig): Canx;
  * Helper for creating typed configuration objects
  */
 export declare function defineConfig<T extends Record<string, any>>(config: T): T;
+export { Canx as Application };
+/**
+ * Application Configuration for module-based bootstrap
+ */
+interface ApplicationConfig extends ServerConfig {
+    rootModule?: any;
+}
+/**
+ * Create a new CanxJS application instance with module support
+ * This is a NestJS-style factory function
+ */
+export declare function createApplication(config?: ApplicationConfig): Canx;
 export default Canx;
 //# sourceMappingURL=Application.d.ts.map

package/dist/src/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../src/Application.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAc,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpH,OAAO,EAAE,MAAM,EAAgB,MAAM,eAAe,CAAC;AAKrD,qBAAa,IAAK,YAAW,eAAe;IAC1C,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,GAAE,YAAiB;IAgBrC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAKxC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAKxD;;OAEG;IACH,UAAU,CAAC,eAAe,EAAE,UAAU,GAAG,GAAG,IAAI;IAoBhD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhF;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6ChD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAC5C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAC3C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAC9C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAE3C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAKlF;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAKvE;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;CAK3E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAExE;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../src/Application.ts"],"names":[],"mappings":"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"}

package/dist/src/Application.js

@@ -137,6 +137,12 @@ export class Canx {
             scheduler.stop();
         }
     }
+    /**
+     * Get the internal server instance
+     */
+    getServer() {
+        return this.server;
+    }
     /**
      * Get router for chaining
      */
@@ -184,4 +190,34 @@ export function createApp(config) {
 export function defineConfig(config) {
     return config;
 }
+// Alias for consistency with NestJS-style naming
+export { Canx as Application };
+/**
+ * Create a new CanxJS application instance with module support
+ * This is a NestJS-style factory function
+ */
+export function createApplication(config) {
+    const app = new Canx(config);
+    // If rootModule is provided, bootstrap it
+    if (config?.rootModule) {
+        const meta = Reflect.getMetadata('module:metadata', config.rootModule);
+        if (meta) {
+            // Register controllers from the module
+            if (meta.controllers) {
+                for (const ControllerClass of meta.controllers) {
+                    app.controller(ControllerClass);
+                }
+            }
+            // Register providers to container
+            if (meta.providers) {
+                for (const provider of meta.providers) {
+                    if (typeof provider === 'function') {
+                        container.bind(provider, provider);
+                    }
+                }
+            }
+        }
+    }
+    return app;
+}
 export default Canx;

package/dist/src/adapter/inertia/InertiaManager.d.ts

@@ -0,0 +1,31 @@
+export interface InertiaConfig {
+    rootView: string;
+    sharedProps: Record<string, any>;
+    version: string | (() => string | Promise<string>);
+}
+export declare class InertiaManager {
+    private static instance;
+    private sharedProps;
+    private rootView;
+    private versionData;
+    constructor();
+    static getInstance(): InertiaManager;
+    /**
+     * Set the root view (e.g. 'app' for app.blade.php / app.html)
+     */
+    setRootView(view: string): void;
+    getRootView(): string;
+    /**
+     * Share data globally for all requests
+     */
+    share(key: string, value: any): void;
+    share(data: Record<string, any>): void;
+    getShared(key?: string): any;
+    /**
+     * Set version
+     */
+    version(v: string | (() => string | Promise<string>)): void;
+    getVersion(): Promise<string | undefined>;
+}
+export declare const inertiaManager: InertiaManager;
+//# sourceMappingURL=InertiaManager.d.ts.map

package/dist/src/adapter/inertia/InertiaManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InertiaManager.d.ts","sourceRoot":"","sources":["../../../../src/adapter/inertia/InertiaManager.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAA0D;;WAU/D,WAAW,IAAI,cAAc;IAO3C;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM;IAIxB,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAStC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG;IAKnC;;OAEG;IACI,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAI9C,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAKzD;AAED,eAAO,MAAM,cAAc,gBAA+B,CAAC"}

package/dist/src/adapter/inertia/InertiaManager.js

@@ -0,0 +1,54 @@
+export class InertiaManager {
+    static instance;
+    sharedProps = {};
+    rootView = 'root'; // default view name
+    versionData = null;
+    // Per-request sharing storage (using a weak map or similar mechanism in real frameworks,
+    // but here we might rely on the middleware attaching an instance to the request)
+    // Actually, distinct requests need distinct shared props (e.g. flash messages, auth user).
+    // So `share()` should ideally be scoped.
+    // For global shared props (e.g. app name), we use this class.
+    constructor() { }
+    static getInstance() {
+        if (!InertiaManager.instance) {
+            InertiaManager.instance = new InertiaManager();
+        }
+        return InertiaManager.instance;
+    }
+    /**
+     * Set the root view (e.g. 'app' for app.blade.php / app.html)
+     */
+    setRootView(view) {
+        this.rootView = view;
+    }
+    getRootView() {
+        return this.rootView;
+    }
+    share(keyOrData, value) {
+        if (typeof keyOrData === 'string') {
+            this.sharedProps[keyOrData] = value;
+        }
+        else {
+            Object.assign(this.sharedProps, keyOrData);
+        }
+    }
+    getShared(key) {
+        if (key)
+            return this.sharedProps[key];
+        return this.sharedProps;
+    }
+    /**
+     * Set version
+     */
+    version(v) {
+        this.versionData = v;
+    }
+    async getVersion() {
+        if (!this.versionData)
+            return undefined;
+        if (typeof this.versionData === 'function')
+            return await this.versionData();
+        return this.versionData;
+    }
+}
+export const inertiaManager = InertiaManager.getInstance();

package/dist/src/adapter/inertia/InertiaMiddleware.d.ts

@@ -0,0 +1,3 @@
+import type { CanxRequest, CanxResponse, NextFunction } from '../../types';
+export declare function inertiaMiddleware(): (req: CanxRequest, res: CanxResponse, next: NextFunction) => Promise<void | Response>;
+//# sourceMappingURL=InertiaMiddleware.d.ts.map

package/dist/src/adapter/inertia/InertiaMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InertiaMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/adapter/inertia/InertiaMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3E,wBAAgB,iBAAiB,KACjB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,8BA8ItE"}

package/dist/src/adapter/inertia/InertiaMiddleware.js

@@ -0,0 +1,127 @@
+import { inertiaManager } from './InertiaManager';
+export function inertiaMiddleware() {
+    return async (req, res, next) => {
+        // 1. Check if Inertia Request
+        const isInertia = req.headers.get('x-inertia') === 'true';
+        // Attach an inertia context to the request for scoped sharing
+        const scopeProps = {};
+        // Helper to share data for THIS request only
+        req.inertiaShare = (key, value) => {
+            if (typeof key === 'string') {
+                scopeProps[key] = value;
+            }
+            else {
+                Object.assign(scopeProps, key);
+            }
+        };
+        // 2. Asset Versioning
+        if (isInertia && req.method === 'GET') {
+            const version = await inertiaManager.getVersion();
+            const headerVersion = req.headers.get('x-inertia-version');
+            if (version && headerVersion !== version) {
+                // Asset version mismatch -> Force full reload
+                res.status(409).header('X-Inertia-Location', req.raw.url);
+                return res.empty();
+            }
+        }
+        // 3. Setup Response Helper
+        // We override or attach `res.inertia` here
+        res.inertia = async (component, props = {}) => {
+            const version = await inertiaManager.getVersion();
+            const globalProps = inertiaManager.getShared();
+            // Merge props: Global -> Request Scope -> Controller Props
+            const allProps = { ...globalProps, ...scopeProps, ...props };
+            // Lazy Evaluation (Partial Reloads)
+            const partialData = req.headers.get('x-inertia-partial-data');
+            const partialComponent = req.headers.get('x-inertia-partial-component');
+            let finalProps = allProps;
+            if (isInertia && partialData && partialComponent === component) {
+                const only = partialData.split(',').map(s => s.trim());
+                const newProps = {};
+                for (const key of only) {
+                    if (key in allProps) {
+                        newProps[key] = allProps[key];
+                    }
+                }
+                finalProps = newProps;
+            }
+            // Resolve Lazy Props (functions)
+            for (const key in finalProps) {
+                if (typeof finalProps[key] === 'function') {
+                    try {
+                        finalProps[key] = await finalProps[key]();
+                    }
+                    catch (e) {
+                        console.error(`[Inertia] Error resolving prop ${key}:`, e);
+                        finalProps[key] = null;
+                    }
+                }
+            }
+            const page = {
+                component,
+                props: finalProps,
+                url: req.raw.url, // Original URL
+                version: version || '',
+            };
+            if (isInertia) {
+                // JSON Response
+                res.header('X-Inertia', 'true')
+                    .header('Content-Type', 'application/json')
+                    .header('Vary', 'Accept');
+                return res.json(page);
+            }
+            else {
+                // HTML Full Page Load
+                const rootView = inertiaManager.getRootView();
+                const encodedPage = JSON.stringify(page).replace(/"/g, '"');
+                // We need a way to render the root view with the app payload
+                // In Laravel/Blade: <div id="app" data-page="{{ json($page) }}"></div>
+                // Here, we'll try to use the view engine if available.
+                // Assumption: The user creates a view that prints `inertiaHead` and `inertiaBody`?
+                // Or simpler: We inject it into a template placeholder.
+                // Let's assume standard SSR/View usage.
+                // For now, we will construct a basic HTML shell if NO view engine is found, 
+                // OR render the view passing `page` string.
+                try {
+                    // Try to render the root view, passing 'page' variable
+                    // The root view should have: <div id="app" data-page='<%= page %>'></div>
+                    // or React-style.
+                    // Construct a default html if view is likely missing or simple usage
+                    const customView = await import('../../mvc/View').then(m => m.viewIfExists(rootView, { page: page }));
+                    if (customView) {
+                        return res.html(customView);
+                    }
+                    // Fallback default HTML
+                    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${component}</title>
+    <!-- Inertia Head -->
+</head>
+<body>
+    <div id="app" data-page="${encodedPage}"></div>
+    <!-- Scripts -->
+</body>
+</html>`;
+                    return res.html(html);
+                }
+                catch (e) {
+                    console.error('[Inertia] View render error:', e);
+                    return res.status(500).text('Inertia View Error');
+                }
+            }
+        };
+        // 4. Handle External Redirects (303 for PUT/PATCH/DELETE)
+        // Common inertia pattern: non-GET requests redirecting must use 303 to avoid method preservation
+        const originalRedirect = res.redirect;
+        res.redirect = (url, status) => {
+            if (isInertia && ['PUT', 'PATCH', 'DELETE'].includes(req.method)) {
+                status = 303;
+            }
+            return originalRedirect.call(res, url, status);
+        };
+        return next();
+    };
+}

package/dist/src/auth/OAuth.d.ts

@@ -1,64 +1,67 @@
 /**
- * CanxJS OAuth2 Provider
- * Social login integration for Google, GitHub, Facebook, Discord
+ * OAuth - Simple OAuth2 Social Login Helper
+ * For more advanced social login, use SocialManager from auth/social
  */
-import type { CanxRequest, CanxResponse, MiddlewareHandler } from '../types';
-export interface OAuthProvider {
-    name: string;
+interface OAuthProviderConfig {
     clientId: string;
     clientSecret: string;
     redirectUri: string;
-    scopes: string[];
-    authUrl: string;
-    tokenUrl: string;
-    userInfoUrl: string;
+    scopes?: string[];
 }
-export interface OAuthUser {
-    id: string;
-    email: string;
-    name: string;
-    avatar?: string;
-    provider: string;
-    accessToken: string;
-    refreshToken?: string;
-    raw: Record<string, unknown>;
-}
-export interface OAuthConfig {
-    providers: Record<string, Partial<OAuthProvider>>;
-    defaultScopes?: Record<string, string[]>;
+interface OAuthConfig {
+    providers: Record<string, OAuthProviderConfig>;
 }
 export declare class OAuth {
-    private providers;
+    private config;
     private stateStore;
     /**
      * Configure OAuth providers
      */
-    configure(config: OAuthConfig): void;
+    configure(config: OAuthConfig): this;
+    /**
+     * Add a provider
+     */
+    addProvider(name: string, config: OAuthProviderConfig): this;
+    /**
+     * Get provider config
+     */
+    private getProvider;
     /**
-     * Generate a secure state token
+     * Generate a random state string
      */
     private generateState;
     /**
-     * Get authorization URL for a provider
+     * Store state for validation
      */
-    getAuthUrl(providerName: string, additionalParams?: Record<string, string>): string;
+    private storeState;
     /**
-     * Handle OAuth callback and exchange code for tokens
+     * Validate state
      */
-    handleCallback(providerName: string, code: string, state: string): Promise<OAuthUser>;
+    validateState(state: string, provider: string): boolean;
     /**
-     * Normalize user data from different providers
+     * Get authorization URL for provider
      */
-    private normalizeUser;
+    getAuthUrl(provider: string, customState?: string): string;
     /**
-     * Redirect middleware for OAuth flow
+     * Exchange code for tokens
      */
-    redirect(providerName: string): MiddlewareHandler;
+    getToken(provider: string, code: string): Promise<{
+        accessToken: string;
+        refreshToken?: string;
+        expiresIn?: number;
+        tokenType: string;
+    }>;
     /**
-     * Callback middleware for OAuth flow
+     * Get user info from provider
      */
-    callback(providerName: string, onSuccess: (user: OAuthUser, req: CanxRequest, res: CanxResponse) => void | Promise<void>): MiddlewareHandler;
+    getUser(provider: string, accessToken: string): Promise<{
+        id: string;
+        email?: string;
+        name?: string;
+        avatar?: string;
+        raw: any;
+    }>;
 }
 export declare const oauth: OAuth;
-export declare function initOAuth(config: OAuthConfig): void;
+export {};
 //# sourceMappingURL=OAuth.d.ts.map

package/dist/src/auth/OAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OAuth.d.ts","sourceRoot":"","sources":["../../../src/auth/OAuth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAM7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C;AA4CD,qBAAa,KAAK;IAChB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,UAAU,CAAmE;IAErF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW;IAsB7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAyBnF;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAoD3F;;OAEG;IACH,OAAO,CAAC,aAAa;IAkErB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB;IAOjD;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,iBAAiB;CAiB7I;AAGD,eAAO,MAAM,KAAK,OAAc,CAAC;AAGjC,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,QAE5C"}
+{"version":3,"file":"OAuth.d.ts","sourceRoot":"","sources":["../../../src/auth/OAuth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAChD;AA6BD,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CACN;IAEZ;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKpC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAK5D;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IASvD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAwB1D;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAsCF;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,GAAG,CAAC;KACV,CAAC;CAwDH;AAGD,eAAO,MAAM,KAAK,OAAc,CAAC"}