inviton-backduck 1.0.0

package/dist/index.js

@@ -0,0 +1,52 @@
+/**
+ * @server-runtime - Runtime-agnostic utilities for building web servers
+ *
+ * This package provides a unified API for building web servers that can run on
+ * both Node.js (with Express) and Bun natively. Write your server code once,
+ * and it will automatically adapt to the runtime environment.
+ *
+ * Key Features:
+ * - Universal Router: Define routes once, run anywhere
+ * - Controller-based routing with automatic REST mapping
+ * - Runtime detection and automatic adaptation
+ * - Type-safe request/response handling
+ * - Middleware support with chaining
+ * - Static file serving with compression
+ *
+ * @example
+ * ```typescript
+ * import { createRouter, createServer, Route, ControllerBase } from '@server-runtime';
+ *
+ * // Define a controller
+ * @Route('/products')
+ * class ProductController extends ControllerBase {
+ *   async getAll() { return products; }
+ *   async get(args: { id: number }) { return product; }
+ *   async post(args: CreateProductArgs) { return created; }
+ * }
+ *
+ * // Create router and register controllers
+ * const router = createRouter();
+ * router.registerController(ProductController);
+ *
+ * // Create and start server
+ * const server = createServer({
+ *   port: 3000,
+ *   apiRouters: { '/api': router }
+ * });
+ * await server.start();
+ * ```
+ */
+// API Documentation - Generate OpenAPI and HTML documentation from TypeScript controllers
+export * from './apidoc';
+// Decorators - Controller and route configuration
+export { ControllerGetMiddlewares, Middleware as MiddlewareDecorator, ParseRequestArgs, RequestSize, Route, } from './decorators';
+// Router - Route definition and controller registration
+export { ControllerBase, createRouter, WebRouter as UniversalRouter, WebRouter, } from './router';
+// Runtime detection - Detect current runtime environment
+export { IS_BUN, RUNTIME } from './runtime-detect';
+// Server - Server creation and configuration
+export { createServer, UniversalServer, } from './server';
+// Utils - Request parsing and helper utilities
+export { RuntimeUtils } from './utils';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,0FAA0F;AAC1F,cAAc,UAAU,CAAC;AAYzB,kDAAkD;AAClD,OAAO,EACN,wBAAwB,EACxB,UAAU,IAAI,mBAAmB,EACjC,gBAAgB,EAChB,WAAW,EACX,KAAK,GACL,MAAM,cAAc,CAAC;AAEtB,wDAAwD;AACxD,OAAO,EACN,cAAc,EACd,YAAY,EAGZ,SAAS,IAAI,eAAe,EAC5B,SAAS,GACT,MAAM,UAAU,CAAC;AAElB,yDAAyD;AACzD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEnD,6CAA6C;AAC7C,OAAO,EAEN,YAAY,EAGZ,eAAe,GAEf,MAAM,UAAU,CAAC;AAElB,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Universal Router - Runtime-agnostic router that builds to Express or Bun natively
+ */
+import type { Router as ExpressRouter } from 'express';
+import type { BunRouter } from './bun';
+import type { MiddlewareDefinition, RouteHandler, WebRequest, WebResponse } from './data-contracts';
+/**
+ * HTTP methods supported by the router
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/**
+ * Controller interface for automatic route binding
+ * Controllers implement standard REST methods that are automatically mapped to routes
+ */
+export interface IController {
+    /** Base route path for the controller */
+    $route?: string;
+    /** Authentication function that runs before route handlers */
+    $auth?: (req: WebRequest, res: WebResponse) => Promise<boolean>;
+    /** Request body size limit (Express only) */
+    $requestSize?: string;
+    /** Middleware functions to run before route handlers */
+    $middlewares?: MiddlewareDefinition[];
+    /** GET handler for listing resources (mapped to GET /) */
+    getAll?: <TRequest, TResponse>(args: TRequest, req?: WebRequest, res?: WebResponse) => Promise<TResponse>;
+    /** GET handler for fetching single resource (mapped to GET /:id) */
+    get?: <TRequest, TResponse>(args: TRequest, req?: WebRequest, res?: WebResponse) => Promise<TResponse>;
+    /** POST handler for creating resources (mapped to POST /) */
+    post?: <TRequest, TResponse>(args: TRequest, req?: WebRequest, res?: WebResponse) => Promise<TResponse>;
+    /** PATCH handler for partial updates (mapped to PATCH /:id) */
+    patch?: <TRequest, TResponse>(args: TRequest, req?: WebRequest, res?: WebResponse) => Promise<TResponse>;
+    /** PUT handler for full updates (mapped to PUT /:id) */
+    put?: <TRequest, TResponse>(args: TRequest, req?: WebRequest, res?: WebResponse) => Promise<TResponse>;
+    /** DELETE handler for removing resources (mapped to DELETE /:id) */
+    delete?: <TRequest, TResponse>(args: TRequest, req?: WebRequest, res?: WebResponse) => Promise<TResponse>;
+}
+/**
+ * Base class for controllers that provides automatic route binding
+ */
+export declare class ControllerBase implements IController {
+}
+export type { BunNativeRoutes, BunRouteDefinition } from './bun';
+export { BunRouter } from './bun';
+/**
+ * Universal Router - define routes once, build for Express or Bun
+ * Provides a runtime-agnostic API for defining HTTP routes and middleware
+ */
+export declare class WebRouter {
+    private routes;
+    private subRouters;
+    private globalMiddlewares;
+    /**
+     * Add global middleware or mount a sub-router
+     * @param middleware - Middleware function to apply to all routes
+     * @param path - Path prefix for mounting a sub-router
+     * @param router - Sub-router to mount at the given path
+     * @returns This router instance for chaining
+     */
+    use(middleware: MiddlewareDefinition): this;
+    use(path: string, router: WebRouter): this;
+    /**
+     * Register a GET route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    get(path: string, ...handlers: (RouteHandler | MiddlewareDefinition)[]): this;
+    /**
+     * Register a POST route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    post(path: string, ...handlers: (RouteHandler | MiddlewareDefinition)[]): this;
+    /**
+     * Register a PUT route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    put(path: string, ...handlers: (RouteHandler | MiddlewareDefinition)[]): this;
+    /**
+     * Register a PATCH route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    patch(path: string, ...handlers: (RouteHandler | MiddlewareDefinition)[]): this;
+    /**
+     * Register a DELETE route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    delete(path: string, ...handlers: (RouteHandler | MiddlewareDefinition)[]): this;
+    /**
+     * Register a GET route with a regex pattern
+     * Useful for complex pattern matching (e.g., SPA routes with locale prefixes)
+     * @param pattern - Regular expression for matching the URL path
+     * @param paramNames - Names for captured groups in the regex
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     * @example
+     * ```typescript
+     * router.getRegex(/^\/(en|sk|cs)\/products$/, ['locale'], (req, res) => {
+     *   const locale = req.params.locale; // 'en', 'sk', or 'cs'
+     * });
+     * ```
+     */
+    getRegex(pattern: RegExp, paramNames: string[], ...handlers: (RouteHandler | MiddlewareDefinition)[]): this;
+    private addRegexRoute;
+    /**
+     * Register a controller class with automatic route binding
+     * Maps controller methods (get, post, etc.) to HTTP routes automatically
+     * @param ControllerClass - Controller class to register
+     * @returns This router instance for chaining
+     * @example
+     * ```typescript
+     * @Route('/products')
+     * class ProductController extends ControllerBase {
+     *   async getAll() { return products; } // GET /products
+     *   async get(args: { id: number }) { return product; } // GET /products/:id
+     *   async post(args: CreateProductArgs) { return created; } // POST /products
+     * }
+     *
+     * router.registerController(ProductController);
+     * ```
+     */
+    registerController<TController extends ControllerBase>(ControllerClass: new () => TController): this;
+    private bindControllerMethod;
+    private addRoute;
+    /**
+     * Build router for current runtime (Express or Bun)
+     * Automatically detects runtime and builds appropriate router implementation
+     * @returns Promise that resolves to Express Router or Bun Router
+     */
+    build(): Promise<ExpressRouter | BunRouter>;
+    /**
+     * Build router for Express runtime
+     * @returns Promise that resolves to Express Router
+     */
+    buildExpress(): Promise<ExpressRouter>;
+    /**
+     * Build router for Bun runtime
+     * @param basePath - Optional base path prefix for all routes
+     * @returns Promise that resolves to Bun Router
+     */
+    buildBun(basePath?: string): Promise<BunRouter>;
+}
+/**
+ * Create a new WebRouter instance
+ * Factory function for creating runtime-agnostic routers
+ * @returns New WebRouter instance
+ * @example
+ * ```typescript
+ * const router = createRouter();
+ * router.get('/health', (req, res) => res.json({ status: 'ok' }));
+ * router.registerController(UserController);
+ * ```
+ */
+export declare const createRouter: () => WebRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

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

package/dist/router.js

@@ -0,0 +1,350 @@
+/**
+ * Universal Router - Runtime-agnostic router that builds to Express or Bun natively
+ */
+import { IS_BUN } from './runtime-detect';
+/**
+ * Base class for controllers that provides automatic route binding
+ */
+export class ControllerBase {
+}
+/**
+ * Parse query string args with type coercion
+ */
+const parseQueryArgs = (query) => {
+    const typedQuery = {};
+    for (const [key, rawValue,] of Object.entries(query)) {
+        if (typeof rawValue !== 'string') {
+            typedQuery[key] = rawValue;
+            continue;
+        }
+        if (rawValue.length > 100) {
+            typedQuery[key] = rawValue;
+            continue;
+        }
+        if (rawValue === 'true') {
+            typedQuery[key] = true;
+        }
+        else if (rawValue === 'false') {
+            typedQuery[key] = false;
+        }
+        else {
+            const num = Number(rawValue);
+            if (!Number.isNaN(num)) {
+                typedQuery[key] = num;
+            }
+            else {
+                typedQuery[key] = rawValue;
+            }
+        }
+    }
+    return typedQuery;
+};
+export { BunRouter } from './bun';
+/**
+ * Convert path pattern to regex
+ */
+const pathToRegex = (path) => {
+    const paramNames = [];
+    const regexStr = path
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/:(\w+)(\?)?/g, (_, name, optional) => {
+        paramNames.push(name);
+        return optional ? '([^/]*)?' : '([^/]+)';
+    })
+        .replace(/\*/g, '(.*)');
+    return {
+        regex: new RegExp(`^${regexStr}$`),
+        paramNames,
+    };
+};
+/**
+ * Universal Router - define routes once, build for Express or Bun
+ * Provides a runtime-agnostic API for defining HTTP routes and middleware
+ */
+export class WebRouter {
+    routes = [];
+    subRouters = [];
+    globalMiddlewares = [];
+    use(pathOrMiddleware, router) {
+        if (typeof pathOrMiddleware === 'function') {
+            this.globalMiddlewares.push(pathOrMiddleware);
+        }
+        else if (router) {
+            this.subRouters.push({ path: pathOrMiddleware, router });
+        }
+        return this;
+    }
+    /**
+     * Register a GET route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    get(path, ...handlers) {
+        return this.addRoute('GET', path, handlers);
+    }
+    /**
+     * Register a POST route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    post(path, ...handlers) {
+        return this.addRoute('POST', path, handlers);
+    }
+    /**
+     * Register a PUT route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    put(path, ...handlers) {
+        return this.addRoute('PUT', path, handlers);
+    }
+    /**
+     * Register a PATCH route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    patch(path, ...handlers) {
+        return this.addRoute('PATCH', path, handlers);
+    }
+    /**
+     * Register a DELETE route
+     * @param path - URL path (supports :param and * wildcards)
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     */
+    delete(path, ...handlers) {
+        return this.addRoute('DELETE', path, handlers);
+    }
+    /**
+     * Register a GET route with a regex pattern
+     * Useful for complex pattern matching (e.g., SPA routes with locale prefixes)
+     * @param pattern - Regular expression for matching the URL path
+     * @param paramNames - Names for captured groups in the regex
+     * @param handlers - Middleware and route handler functions
+     * @returns This router instance for chaining
+     * @example
+     * ```typescript
+     * router.getRegex(/^\/(en|sk|cs)\/products$/, ['locale'], (req, res) => {
+     *   const locale = req.params.locale; // 'en', 'sk', or 'cs'
+     * });
+     * ```
+     */
+    getRegex(pattern, paramNames, ...handlers) {
+        return this.addRegexRoute('GET', pattern, paramNames, handlers);
+    }
+    addRegexRoute(method, regex, paramNames, handlers) {
+        // Use a special path format for regex routes
+        const path = `__regex__${this.routes.length}`;
+        this.routes.push({ method, path, regex, paramNames, handlers });
+        return this;
+    }
+    /**
+     * Register a controller class with automatic route binding
+     * Maps controller methods (get, post, etc.) to HTTP routes automatically
+     * @param ControllerClass - Controller class to register
+     * @returns This router instance for chaining
+     * @example
+     * ```typescript
+     * @Route('/products')
+     * class ProductController extends ControllerBase {
+     *   async getAll() { return products; } // GET /products
+     *   async get(args: { id: number }) { return product; } // GET /products/:id
+     *   async post(args: CreateProductArgs) { return created; } // POST /products
+     * }
+     *
+     * router.registerController(ProductController);
+     * ```
+     */
+    registerController(ControllerClass) {
+        const controller = new ControllerClass();
+        let route = controller.$route || controller.constructor?.$route;
+        if (!route) {
+            route = ControllerClass.name.replace('Controller', '');
+            route = route.substring(0, 1).toLowerCase() + route.substring(1);
+        }
+        if (!route.startsWith('/')) {
+            route = `/${route}`;
+        }
+        this.bindControllerMethod('getAll', controller, route);
+        this.bindControllerMethod('get', controller, route);
+        this.bindControllerMethod('post', controller, route);
+        this.bindControllerMethod('patch', controller, route);
+        this.bindControllerMethod('put', controller, route);
+        this.bindControllerMethod('delete', controller, route);
+        return this;
+    }
+    bindControllerMethod(method, controller, route) {
+        if (!controller[method]) {
+            return;
+        }
+        // Get method-specific or controller-level auth
+        const auth = controller[`$auth-${method}`]
+            || (controller.constructor || {})[`$auth-${method}`]
+            || controller.$auth
+            || controller.constructor?.$auth;
+        // Get method-specific or default parse args
+        const customParseArgs = controller[`$parse-${method}`]
+            || (controller.constructor || {})[`$parse-${method}`];
+        // Get request size limit
+        const requestSize = controller.$requestSize
+            || controller.constructor?.$requestSize;
+        // Get controller middlewares (clone to avoid mutation)
+        const controllerMiddlewares = [
+            ...(controller.$middlewares
+                || controller.constructor?.$middlewares
+                || []),
+        ];
+        const isBodyMethod = method !== 'delete' && method !== 'get' && method !== 'getAll';
+        const hasGetAndGetAll = controller.get != null && controller.getAll != null;
+        // Build middleware chain (same order as RouteBinder)
+        const middlewares = [];
+        // 1. Auth middleware first (unshift in original = first in array)
+        if (auth) {
+            middlewares.push(async (req, res, next) => {
+                const authResult = await auth(req, res);
+                if (!authResult) {
+                    res.status(401).send('Unauthorized access');
+                    return;
+                }
+                next();
+            });
+        }
+        // 2. Controller middlewares
+        middlewares.push(...controllerMiddlewares);
+        // Main handler
+        const mainHandler = async (req, res, next) => {
+            try {
+                // Parse args
+                let args;
+                if (customParseArgs) {
+                    args = customParseArgs(req);
+                }
+                else if (isBodyMethod) {
+                    args = req.body;
+                }
+                else {
+                    args = parseQueryArgs(req.query);
+                }
+                // Handle get vs getAll routing
+                let actualMethod = method;
+                if ((method === 'get' || method === 'getAll') && hasGetAndGetAll) {
+                    actualMethod = args.id > 0 ? 'get' : 'getAll';
+                }
+                const result = await controller[actualMethod].call(controller, args, req, res, next);
+                res.json(result);
+            }
+            catch (error) {
+                // Only handle HTTP errors (httpCode > 299), rethrow others
+                if (error?.httpCode > 299) {
+                    const httpCode = error.httpCode ?? 500;
+                    const message = error.message ?? 'Unexpected error';
+                    const response = { success: false, message };
+                    // Include interception data (WorkflowInterceptionException)
+                    if (error.interception) {
+                        response.interception = {
+                            type: error.interception?.type,
+                            data: error.interception?.data,
+                        };
+                    }
+                    res.status(httpCode).json(response);
+                    return;
+                }
+                // Rethrow non-HTTP errors
+                throw error;
+            }
+        };
+        const httpMethod = method === 'getAll' ? 'GET' : method.toUpperCase();
+        // Store route with middlewares + main handler
+        // requestSize is used by Express router for body parsing
+        this.routes.push({
+            method: httpMethod,
+            path: route,
+            handlers: [
+                ...middlewares,
+                mainHandler,
+            ],
+            requestSize: isBodyMethod ? requestSize : undefined,
+        });
+    }
+    addRoute(method, path, handlers) {
+        this.routes.push({ method, path, handlers });
+        return this;
+    }
+    /**
+     * Build router for current runtime (Express or Bun)
+     * Automatically detects runtime and builds appropriate router implementation
+     * @returns Promise that resolves to Express Router or Bun Router
+     */
+    build() {
+        if (IS_BUN) {
+            return this.buildBun('');
+        }
+        return this.buildExpress();
+    }
+    /**
+     * Build router for Express runtime
+     * @returns Promise that resolves to Express Router
+     */
+    async buildExpress() {
+        const { buildExpressRouter } = await import('./express');
+        return buildExpressRouter(this.routes, this.subRouters.map(sr => ({ path: sr.path, buildExpress: () => sr.router.buildExpress() })));
+    }
+    /**
+     * Build router for Bun runtime
+     * @param basePath - Optional base path prefix for all routes
+     * @returns Promise that resolves to Bun Router
+     */
+    async buildBun(basePath = '') {
+        const { BunRouter: BunRouterImpl } = await import('./bun');
+        const bunRoutes = [];
+        // Collect sub-router routes
+        for (const { path, router: subRouter } of this.subRouters) {
+            const subBunRouter = await subRouter.buildBun(basePath + path);
+            bunRoutes.push(...subBunRouter.routes);
+        }
+        // Collect own routes
+        for (const route of this.routes) {
+            // Handle regex routes (path starts with __regex__)
+            if (route.path.startsWith('__regex__')) {
+                bunRoutes.push({
+                    method: route.method,
+                    path: route.path,
+                    regex: route.regex,
+                    paramNames: route.paramNames || [],
+                    handlers: route.handlers,
+                    globalMiddlewares: this.globalMiddlewares,
+                });
+            }
+            else {
+                const fullPath = basePath + route.path;
+                const { regex, paramNames } = pathToRegex(fullPath);
+                bunRoutes.push({
+                    method: route.method,
+                    path: fullPath,
+                    regex,
+                    paramNames,
+                    handlers: route.handlers,
+                    globalMiddlewares: this.globalMiddlewares,
+                });
+            }
+        }
+        return new BunRouterImpl(bunRoutes);
+    }
+}
+/**
+ * Create a new WebRouter instance
+ * Factory function for creating runtime-agnostic routers
+ * @returns New WebRouter instance
+ * @example
+ * ```typescript
+ * const router = createRouter();
+ * router.get('/health', (req, res) => res.json({ status: 'ok' }));
+ * router.registerController(UserController);
+ * ```
+ */
+export const createRouter = () => new WebRouter();
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAkC1C;;GAEG;AACH,MAAM,OAAO,cAAc;CAA2B;AAEtD;;GAEG;AACH,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAuB,EAAE;IAC1E,MAAM,UAAU,GAAwB,EAAE,CAAC;IAE3C,KAAK,MAAM,CACV,GAAG,EACH,QAAQ,EACR,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YAC3B,SAAS;QACV,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC3B,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YAC3B,SAAS;QACV,CAAC;QAED,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACzB,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;aAAM,CAAC;YACP,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACP,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YAC5B,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC,CAAC;AAqBF,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,IAAY,EAA2C,EAAE;IAC7E,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI;SACnB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,cAAc,EAAE,CACxB,CAAC,EACD,IAAI,EACJ,QAAQ,EACP,EAAE;QACH,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC,CAAC;SACD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEzB,OAAO;QACN,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC;QAClC,UAAU;KACV,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,SAAS;IACb,MAAM,GAAsB,EAAE,CAAC;IAC/B,UAAU,GAAqB,EAAE,CAAC;IAClC,iBAAiB,GAA2B,EAAE,CAAC;IAWvD,GAAG,CAAC,gBAA+C,EAAE,MAAkB;QACtE,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC5C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY,EAAE,GAAG,QAAiD;QACrE,OAAO,IAAI,CAAC,QAAQ,CACnB,KAAK,EACL,IAAI,EACJ,QAAQ,CACR,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,GAAG,QAAiD;QACtE,OAAO,IAAI,CAAC,QAAQ,CACnB,MAAM,EACN,IAAI,EACJ,QAAQ,CACR,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY,EAAE,GAAG,QAAiD;QACrE,OAAO,IAAI,CAAC,QAAQ,CACnB,KAAK,EACL,IAAI,EACJ,QAAQ,CACR,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAY,EAAE,GAAG,QAAiD;QACvE,OAAO,IAAI,CAAC,QAAQ,CACnB,OAAO,EACP,IAAI,EACJ,QAAQ,CACR,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAY,EAAE,GAAG,QAAiD;QACxE,OAAO,IAAI,CAAC,QAAQ,CACnB,QAAQ,EACR,IAAI,EACJ,QAAQ,CACR,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACP,OAAe,EACf,UAAoB,EACpB,GAAG,QAAiD;QAEpD,OAAO,IAAI,CAAC,aAAa,CACxB,KAAK,EACL,OAAO,EACP,UAAU,EACV,QAAQ,CACR,CAAC;IACH,CAAC;IAEO,aAAa,CACpB,MAAkB,EAClB,KAAa,EACb,UAAoB,EACpB,QAAiD;QAEjD,6CAA6C;QAC7C,MAAM,IAAI,GAAG,YAAY,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,kBAAkB,CAAqC,eAAsC;QAC5F,MAAM,UAAU,GAAgB,IAAI,eAAe,EAAS,CAAC;QAC7D,IAAI,KAAK,GAAW,UAAU,CAAC,MAAM,IAAK,UAAkB,CAAC,WAAW,EAAE,MAAM,CAAC;QAEjF,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACvD,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,oBAAoB,CACxB,QAAQ,EACR,UAAU,EACV,KAAK,CACL,CAAC;QACF,IAAI,CAAC,oBAAoB,CACxB,KAAK,EACL,UAAU,EACV,KAAK,CACL,CAAC;QACF,IAAI,CAAC,oBAAoB,CACxB,MAAM,EACN,UAAU,EACV,KAAK,CACL,CAAC;QACF,IAAI,CAAC,oBAAoB,CACxB,OAAO,EACP,UAAU,EACV,KAAK,CACL,CAAC;QACF,IAAI,CAAC,oBAAoB,CACxB,KAAK,EACL,UAAU,EACV,KAAK,CACL,CAAC;QACF,IAAI,CAAC,oBAAoB,CACxB,QAAQ,EACR,UAAU,EACV,KAAK,CACL,CAAC;QAEF,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,oBAAoB,CAC3B,MAA8D,EAC9D,UAAuB,EACvB,KAAa;QAEb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,OAAO;QACR,CAAC;QAED,+CAA+C;QAC/C,MAAM,IAAI,GAAI,UAAkB,CAAC,SAAS,MAAM,EAAE,CAAC;eAC/C,CAAE,UAAkB,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC;eAC1D,UAAU,CAAC,KAAK;eACf,UAAkB,CAAC,WAAW,EAAE,KAAK,CAAC;QAE3C,4CAA4C;QAC5C,MAAM,eAAe,GAAI,UAAkB,CAAC,UAAU,MAAM,EAAE,CAAC;eAC3D,CAAE,UAAkB,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;QAEhE,yBAAyB;QACzB,MAAM,WAAW,GAAuB,UAAU,CAAC,YAAY;eAC1D,UAAkB,CAAC,WAAW,EAAE,YAAY,CAAC;QAElD,uDAAuD;QACvD,MAAM,qBAAqB,GAA2B;YACrD,GAAG,CAAC,UAAU,CAAC,YAAY;mBACtB,UAAkB,CAAC,WAAW,EAAE,YAAY;mBAC7C,EAAE,CAAC;SACP,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,CAAC;QACpF,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,IAAI,IAAI,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC;QAE5E,qDAAqD;QACrD,MAAM,WAAW,GAA2B,EAAE,CAAC;QAE/C,kEAAkE;QAClE,IAAI,IAAI,EAAE,CAAC;YACV,WAAW,CAAC,IAAI,CAAC,KAAK,EACrB,GAAG,EACH,GAAG,EACH,IAAI,EACH,EAAE;gBACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACxC,IAAI,CAAC,UAAU,EAAE,CAAC;oBACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;oBAC5C,OAAO;gBACR,CAAC;gBAED,IAAI,EAAE,CAAC;YACR,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,CAAC;QAE3C,eAAe;QACf,MAAM,WAAW,GAAiB,KAAK,EACtC,GAAG,EACH,GAAG,EACH,IAAI,EACH,EAAE;YACH,IAAI,CAAC;gBACJ,aAAa;gBACb,IAAI,IAAS,CAAC;gBACd,IAAI,eAAe,EAAE,CAAC;oBACrB,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;qBAAM,IAAI,YAAY,EAAE,CAAC;oBACzB,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACP,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAClC,CAAC;gBAED,+BAA+B;gBAC/B,IAAI,YAAY,GAAG,MAAM,CAAC;gBAC1B,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC;oBAClE,YAAY,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC/C,CAAC;gBAED,MAAM,MAAM,GAAG,MAAO,UAAU,CAAC,YAAY,CAAS,CAAC,IAAI,CAC1D,UAAU,EACV,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,CACJ,CAAC;gBACF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACrB,2DAA2D;gBAC3D,IAAI,KAAK,EAAE,QAAQ,GAAG,GAAG,EAAE,CAAC;oBAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC;oBACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,kBAAkB,CAAC;oBAEpD,MAAM,QAAQ,GAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;oBAElD,4DAA4D;oBAC5D,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;wBACxB,QAAQ,CAAC,YAAY,GAAG;4BACvB,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI;4BAC9B,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI;yBAC9B,CAAC;oBACH,CAAC;oBAED,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACpC,OAAO;gBACR,CAAC;gBAED,0BAA0B;gBAC1B,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAgB,CAAC;QAEpF,8CAA8C;QAC9C,yDAAyD;QACzD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAChB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE;gBACT,GAAG,WAAW;gBACd,WAAW;aACX;YACD,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;SACnD,CAAC,CAAC;IACJ,CAAC;IAEO,QAAQ,CACf,MAAkB,EAClB,IAAY,EACZ,QAAiD;QAEjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK;QACJ,IAAI,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QACjB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACzD,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACtI,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,WAAmB,EAAE;QACnC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAyB,EAAE,CAAC;QAE3C,4BAA4B;QAC5B,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3D,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;YAC/D,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,qBAAqB;QACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,mDAAmD;YACnD,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxC,SAAS,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,KAAK,CAAC,KAAM;oBACnB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;oBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;iBACzC,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;gBACvC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAEpD,SAAS,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,IAAI,EAAE,QAAQ;oBACd,KAAK;oBACL,UAAU;oBACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;iBACzC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACD;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC"}

package/dist/runtime-detect.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Runtime detection utilities for Bun/Node.js dual runtime support
+ */
+/**
+ * Check if the current runtime is Bun
+ */
+export declare const isBunRuntime: () => boolean;
+/**
+ * Get the current runtime name
+ */
+export declare const getRuntime: () => "bun" | "node";
+/**
+ * Cached runtime detection result (computed once at module load)
+ */
+export declare const RUNTIME: "bun" | "node";
+/**
+ * Cached Bun runtime check (computed once at module load)
+ */
+export declare const IS_BUN: boolean;
+//# sourceMappingURL=runtime-detect.d.ts.map

package/dist/runtime-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-detect.d.ts","sourceRoot":"","sources":["../src/runtime-detect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,OAAyD,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,UAAU,QAAO,KAAK,GAAG,MAAyC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,OAAO,gBAAe,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,MAAM,SAAiB,CAAC"}

package/dist/runtime-detect.js

@@ -0,0 +1,20 @@
+/**
+ * Runtime detection utilities for Bun/Node.js dual runtime support
+ */
+/**
+ * Check if the current runtime is Bun
+ */
+export const isBunRuntime = () => typeof globalThis.Bun !== 'undefined';
+/**
+ * Get the current runtime name
+ */
+export const getRuntime = () => isBunRuntime() ? 'bun' : 'node';
+/**
+ * Cached runtime detection result (computed once at module load)
+ */
+export const RUNTIME = getRuntime();
+/**
+ * Cached Bun runtime check (computed once at module load)
+ */
+export const IS_BUN = isBunRuntime();
+//# sourceMappingURL=runtime-detect.js.map

package/dist/runtime-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-detect.js","sourceRoot":"","sources":["../src/runtime-detect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE,CAAC,OAAQ,UAAkB,CAAC,GAAG,KAAK,WAAW,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAmB,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}