@modularizer/plat 0.1.0

package/dist/server/config/types.d.ts

@@ -0,0 +1,198 @@
+import { AuthMode, CacheController, RateLimitConfigs, RateLimitController, TokenLimitConfigs, TokenLimitController } from "../../types";
+import { Logger } from "./logger";
+import type { InMemoryCallSessionController } from "../call-sessions";
+import type { PLATServerProtocolPlugin } from "../protocol-plugin";
+export interface AuthHandler {
+    verify(mode: AuthMode, req: any, ctx: any): Promise<any> | any;
+}
+export type Serializer = (value: any) => any;
+export interface CORSOptions {
+    origin?: string | string[] | boolean | ((origin: string) => boolean);
+    credentials?: boolean;
+    methods?: string[];
+    headers?: string[];
+    exposedHeaders?: string[];
+    maxAge?: number;
+}
+export interface FileQueueOptions {
+    inbox: string;
+    outbox: string;
+    pollIntervalMs?: number;
+    archive?: string | false;
+}
+export interface PLATServerOptions {
+    /**
+     * How much error information to expose to clients
+     * - 'none': only { error: 'Internal server error' }
+     * - 'message': { error: 'Original error message' }
+     * - 'full': { error: message, stack, data, ... }
+     */
+    errorExposure?: 'none' | 'message' | 'full';
+    /**
+     * Custom serializers for non-standard types
+     * Applied after default Date/DateTime serialization
+     */
+    serializers?: Record<string, Serializer>;
+    /**
+     * CORS configuration
+     */
+    cors?: CORSOptions | boolean;
+    /**
+     * Default response headers
+     */
+    headers?: Record<string, string>;
+    /**
+     * Hook called for each incoming request
+     */
+    onRequest?: (req: any, res: any, path: string, method: string) => void | Promise<void>;
+    /**
+     * Hook called for each successful response
+     */
+    onResponse?: (req: any, res: any, statusCode: number, result: any) => void | Promise<void>;
+    /**
+     * Hook called when an error occurs
+     */
+    onError?: (req: any, res: any, error: Error, statusCode: number) => void | Promise<void>;
+    /**
+     * Hook to handle uncaught exceptions
+     * Return true to prevent default error response
+     */
+    handleError?: (req: any, res: any, error: Error) => boolean | Promise<boolean>;
+    /**
+     * Port to listen on
+     */
+    port?: number;
+    /**
+     * Host to listen on (default: 'localhost')
+     */
+    host?: string;
+    /**
+     * Protocol for logging (default: 'http')
+     */
+    protocol?: string;
+    /**
+     * RPC/WebSocket transport configuration
+     * - true: enable RPC websocket endpoint at /rpc
+     * - string: mount at specified path
+     * - false: disable
+     */
+    rpc?: boolean | string;
+    /**
+     * OpenAPI specification for Swagger/ReDoc docs
+     */
+    openapi?: any;
+    /**
+     * Enable automatic Swagger UI (default: true if openapi provided)
+     * - true: mount at /docs
+     * - string: mount at specified path (e.g. '/api-docs')
+     * - false: disable
+     */
+    swagger?: boolean | string;
+    /**
+     * Enable automatic ReDoc (default: true if openapi provided)
+     * - true: mount at /redoc
+     * - string: mount at specified path (e.g. '/api-redoc')
+     * - false: disable
+     */
+    redoc?: boolean | string;
+    /**
+     * URL path redirects, e.g. { '/': '/docs' }
+     */
+    redirects?: Record<string, string>;
+    /**
+     * Logger instance (defaults to console-based logger)
+     */
+    logger?: Logger;
+    /**
+     * Authentication handler for verifying auth modes
+     */
+    auth?: AuthHandler;
+    /**
+     * Default auth mode for all routes (can be overridden per-controller or per-route)
+     * Default: 'public' (no auth required)
+     */
+    defaultAuth?: AuthMode;
+    /**
+     * Rate limiting configuration
+     */
+    rateLimit?: {
+        controller?: RateLimitController;
+        configs?: RateLimitConfigs;
+        retryAfterHeaders?: boolean | {
+            delay?: boolean;
+            retryAt?: boolean;
+        };
+    };
+    /**
+     * Token limiting configuration
+     */
+    tokenLimit?: {
+        controller?: TokenLimitController;
+        configs?: TokenLimitConfigs;
+        retryAfterHeaders?: boolean | {
+            delay?: boolean;
+            retryAt?: boolean;
+        };
+        responseCostHeader?: boolean;
+    };
+    /**
+     * Caching configuration
+     */
+    cache?: {
+        controller?: CacheController;
+        cacheHeader?: boolean;
+    };
+    /**
+     * Custom route options validation
+     * Called for each route to validate any custom keys in RouteOpts
+     * Throw an error to reject invalid options
+     */
+    validateRouteOpts?: (opts: Record<string, any>, methodName: string, path: string) => void | Promise<void>;
+    /**
+     * Method prefix configuration
+     * Enforce specific method prefixes (get, list, create, etc.)
+     * - '*': Allow any prefix (default, recommended)
+     * - Array of strings: Only allow these prefixes (e.g., ['get', 'list', 'create'])
+     */
+    allowedMethodPrefixes?: '*' | string[];
+    /**
+     * Disallowed method prefixes
+     * Forbid specific method prefixes (e.g., 'fetch', 'search')
+     * Default: [] (none disallowed)
+     */
+    disAllowedMethodPrefixes?: string[];
+    /**
+     * Parameter name coercions/aliases
+     * Maps parameter names to their canonical forms
+     * - Key: alternative name (e.g., 'query')
+     * - Value: canonical name (e.g., 'q')
+     * Automatically filters out identity mappings (e.g., 'q' -> 'q')
+     * Default: { query: 'q', search: 'q', format: 'fmt' }
+     */
+    paramCoercions?: Record<string, string>;
+    /**
+     * Disallowed parameter names in handlers
+     * Throws error if a handler uses these parameter names
+     * Forces use of canonical names instead
+     * Default: [] (none disallowed)
+     * Example: ['search'] forces use of 'q' instead
+     */
+    disAllowedParams?: string[];
+    /**
+     * Deferred HTTP call sessions for long-running operations.
+     */
+    calls?: {
+        controller?: InMemoryCallSessionController;
+        path?: string;
+    };
+    /**
+     * Optional file-based request/response transport.
+     * Reads JSON requests from inbox and writes JSON responses to outbox.
+     */
+    fileQueue?: FileQueueOptions | false;
+    /**
+     * Extra protocol plugins. Built-in HTTP/WS/file behavior still works by default.
+     */
+    protocolPlugins?: PLATServerProtocolPlugin[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/config/types.d.ts.map

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

package/dist/server/config/types.js

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

package/dist/server/config/types.js.map

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

package/dist/server/core.d.ts

@@ -0,0 +1,42 @@
+import type { PLATServerResolvedOperation } from './transports';
+import { PLATOperationRegistry } from './operation-registry';
+interface PLATServerCoreOptions {
+    allowedMethodPrefixes?: '*' | string[];
+    disAllowedMethodPrefixes?: string[];
+    validateRouteOpts?: (opts: Record<string, any>, methodName: string, path: string) => void | Promise<void>;
+}
+interface PLATServerCoreStores {
+    routes: Array<{
+        method: string;
+        path: string;
+        methodName?: string;
+    }>;
+    tools: Map<string, any>;
+    operationRegistry: PLATOperationRegistry;
+    registeredMethodNames: Set<string>;
+    registeredControllerNames: Set<string>;
+}
+export interface RegisteredControllerOperation {
+    operation: PLATServerResolvedOperation;
+    route: {
+        method: string;
+        path: string;
+        methodName: string;
+    };
+    variants: Array<{
+        method: string;
+        path: string;
+    }>;
+}
+export declare class PLATServerCore {
+    private options;
+    private stores;
+    constructor(options: PLATServerCoreOptions, stores: PLATServerCoreStores);
+    registerControllers(...ControllerClasses: (new () => any)[]): RegisteredControllerOperation[];
+    private processPendingRoutes;
+    private collectRoutes;
+    private extractMethodPrefix;
+    private validateMethodName;
+}
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/server/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/server/core.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,UAAU,qBAAqB;IAC7B,qBAAqB,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAAA;IACtC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;IACnC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1G;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvB,iBAAiB,EAAE,qBAAqB,CAAA;IACxC,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,yBAAyB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,2BAA2B,CAAA;IACtC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3D,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAID,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBADN,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB;IAGtC,mBAAmB,CAAC,GAAG,iBAAiB,EAAE,CAAC,UAAU,GAAG,CAAC,EAAE,GAAG,6BAA6B,EAAE;IAsH7F,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,kBAAkB;CA+C3B"}

package/dist/server/core.js

@@ -0,0 +1,202 @@
+import { createToolDefinition } from './tools';
+import { generateRouteVariants } from './routing';
+import { ensureRouteMeta, getControllerMeta, pendingRoutes, ROUTE_METADATA_KEY } from '../spec';
+const RESERVED_METHOD_NAMES = ['tools', 'routes', 'endpoints', 'help', 'openapi'];
+export class PLATServerCore {
+    options;
+    stores;
+    constructor(options, stores) {
+        this.options = options;
+        this.stores = stores;
+    }
+    registerControllers(...ControllerClasses) {
+        const registered = [];
+        for (const ControllerClass of ControllerClasses) {
+            const meta = getControllerMeta(ControllerClass);
+            if (!meta) {
+                throw new Error(`${ControllerClass.name} is not decorated with @Controller`);
+            }
+            const instance = new ControllerClass();
+            const controllerTag = meta.tag || meta.basePath || ControllerClass.name;
+            const lowerControllerTag = controllerTag.toLowerCase();
+            if (RESERVED_METHOD_NAMES.includes(lowerControllerTag)) {
+                throw new Error(`Controller '${controllerTag}' uses a reserved plat system name. ` +
+                    `Reserved names: ${RESERVED_METHOD_NAMES.join(', ')}. ` +
+                    `Choose a different controller name/tag.`);
+            }
+            if (this.stores.registeredMethodNames.has(controllerTag)) {
+                throw new Error(`Controller '${controllerTag}' conflicts with an existing method name. ` +
+                    `Controller names and method names must not overlap. ` +
+                    `Rename either the controller or the method.`);
+            }
+            this.stores.registeredControllerNames.add(controllerTag);
+            this.processPendingRoutes(ControllerClass);
+            const freshMeta = getControllerMeta(ControllerClass);
+            const routes = this.collectRoutes(ControllerClass, freshMeta);
+            for (const [key, route] of routes.entries()) {
+                const methodName = String(key);
+                this.validateMethodName(methodName, ControllerClass.name);
+                if (this.stores.registeredControllerNames.has(methodName)) {
+                    throw new Error(`Method '${methodName}' in ${ControllerClass.name} conflicts with controller name '${methodName}'. ` +
+                        `Method names and controller names must not overlap. ` +
+                        `Rename either the method or the controller.`);
+                }
+                if (this.stores.registeredMethodNames.has(methodName)) {
+                    throw new Error(`Duplicate operationId: method "${methodName}" is defined in multiple controllers. ` +
+                        `In plat, method names must be globally unique across all controllers. ` +
+                        `Consider renaming one of these methods to have a unique name. ` +
+                        `Current controller: ${ControllerClass.name}`);
+                }
+                this.stores.registeredMethodNames.add(methodName);
+                const fullPath = '/' + methodName;
+                const routeMeta = freshMeta?.routes.get(key);
+                this.stores.tools.set(methodName, createToolDefinition({
+                    name: methodName,
+                    summary: routeMeta?.summary ?? routeMeta?.opts?.summary,
+                    description: routeMeta?.description ?? routeMeta?.opts?.description ?? `${route.method.toUpperCase()} ${fullPath}`,
+                    method: route.method,
+                    path: fullPath,
+                    controller: controllerTag,
+                    tags: [
+                        controllerTag,
+                        ...(Array.isArray(routeMeta?.opts?.tags) ? routeMeta?.opts?.tags : []),
+                    ].filter((value, index, arr) => Boolean(value) && arr.indexOf(value) === index),
+                    examples: Array.isArray(routeMeta?.opts?.examples) ? routeMeta?.opts?.examples : undefined,
+                    hidden: routeMeta?.opts?.hidden === true,
+                    safe: routeMeta?.opts?.safe ?? ['GET', 'HEAD'].includes(route.method.toUpperCase()),
+                    idempotent: routeMeta?.opts?.idempotent ?? ['GET', 'HEAD', 'PUT', 'DELETE'].includes(route.method.toUpperCase()),
+                    longRunning: routeMeta?.opts?.longRunning === true,
+                    input_schema: routeMeta?.inputSchema ? createToolDefinition(methodName, route.method, fullPath, '', routeMeta.inputSchema).input_schema : undefined,
+                    response_schema: routeMeta?.outputSchema ? createToolDefinition(methodName, route.method, fullPath, '', undefined, routeMeta.outputSchema).response_schema : undefined,
+                }));
+                const operation = {
+                    method: route.method.toUpperCase(),
+                    path: fullPath,
+                    methodName,
+                    boundMethod: instance[methodName].bind(instance),
+                    controllerTag,
+                    routeMeta,
+                    controllerMeta: freshMeta,
+                };
+                this.stores.operationRegistry.register(operation);
+                const routeRecord = {
+                    method: route.method.toUpperCase(),
+                    path: fullPath,
+                    methodName,
+                };
+                this.stores.routes.push(routeRecord);
+                registered.push({
+                    operation,
+                    route: routeRecord,
+                    variants: generateRouteVariants(methodName, route.method)
+                        .filter((variant) => !(variant.path === fullPath && variant.method === route.method.toUpperCase())),
+                });
+            }
+        }
+        return registered;
+    }
+    processPendingRoutes(ControllerClass) {
+        if (!pendingRoutes.has(ControllerClass))
+            return;
+        const routes = pendingRoutes.get(ControllerClass);
+        for (const route of routes) {
+            const routeMeta = ensureRouteMeta(ControllerClass, route.key);
+            routeMeta.method = route.method;
+            routeMeta.path = '/' + String(route.key);
+            routeMeta.auth = route.opts?.auth;
+            routeMeta.rateLimit = route.opts?.rateLimit;
+            routeMeta.tokenLimit = route.opts?.tokenLimit;
+            routeMeta.cache = route.opts?.cache;
+            routeMeta.summary = route.opts?.summary;
+            routeMeta.description = route.opts?.description;
+            if (route.opts) {
+                routeMeta.opts = route.opts;
+            }
+        }
+        pendingRoutes.delete(ControllerClass);
+    }
+    collectRoutes(ControllerClass, freshMeta) {
+        const routes = new Map();
+        for (const key of Object.getOwnPropertyNames(ControllerClass.prototype)) {
+            if (key === 'constructor')
+                continue;
+            const method = ControllerClass.prototype[key];
+            if (typeof method !== 'function')
+                continue;
+            const routeData = method[ROUTE_METADATA_KEY];
+            if (routeData) {
+                routes.set(key, { method: routeData.httpMethod });
+            }
+        }
+        if (freshMeta) {
+            for (const [key, routeMeta] of freshMeta.routes.entries()) {
+                if (!routeMeta.method)
+                    continue;
+                routes.set(key, { method: routeMeta.method });
+                if (this.options.validateRouteOpts && routeMeta.opts) {
+                    const result = this.options.validateRouteOpts(routeMeta.opts, String(key), routeMeta.path);
+                    if (result && typeof result === 'object' && 'then' in result) {
+                        // Keep behavior aligned with the current server host.
+                    }
+                }
+            }
+        }
+        return routes;
+    }
+    extractMethodPrefix(methodName) {
+        const standardPrefixes = ['create', 'update', 'delete', 'list', 'find', 'send', 'get', 'do'];
+        for (const prefix of standardPrefixes) {
+            if (methodName.startsWith(prefix) && methodName.length > prefix.length) {
+                const nextChar = methodName.charAt(prefix.length);
+                if (nextChar === nextChar.toUpperCase()) {
+                    return prefix;
+                }
+            }
+        }
+        for (let i = 1; i < methodName.length; i++) {
+            const char = methodName.charAt(i);
+            if (char === char.toUpperCase() && char !== char.toLowerCase()) {
+                return methodName.substring(0, i);
+            }
+        }
+        return methodName.length > 0 ? methodName : null;
+    }
+    validateMethodName(methodName, controllerName) {
+        if (!methodName || methodName.length === 0)
+            return;
+        const firstChar = methodName.charAt(0);
+        if (firstChar === firstChar.toUpperCase() && firstChar !== firstChar.toLowerCase()) {
+            throw new Error(`Method '${methodName}' in ${controllerName} violates plat naming convention: ` +
+                `method names must start with a lowercase letter. ` +
+                `Use '${firstChar.toLowerCase()}${methodName.slice(1)}' instead.`);
+        }
+        if (methodName.includes('_')) {
+            const camelCase = methodName.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+            throw new Error(`Method '${methodName}' in ${controllerName} violates plat naming convention: ` +
+                `underscores are not allowed. Use camelCase instead. ` +
+                `Use '${camelCase}' instead.`);
+        }
+        if (RESERVED_METHOD_NAMES.includes(methodName.toLowerCase())) {
+            throw new Error(`Method '${methodName}' in ${controllerName} uses a reserved plat system name. ` +
+                `Reserved names: ${RESERVED_METHOD_NAMES.join(', ')}. ` +
+                `Choose a different method name.`);
+        }
+        if (this.options.allowedMethodPrefixes && this.options.allowedMethodPrefixes !== '*') {
+            const prefix = this.extractMethodPrefix(methodName);
+            if (prefix && !this.options.allowedMethodPrefixes.includes(prefix)) {
+                throw new Error(`Method '${methodName}' in ${controllerName} uses disallowed prefix '${prefix}'. ` +
+                    `Allowed prefixes: ${this.options.allowedMethodPrefixes.join(', ')}. ` +
+                    `Rename the method to use an allowed prefix.`);
+            }
+        }
+        if (this.options.disAllowedMethodPrefixes && this.options.disAllowedMethodPrefixes.length > 0) {
+            const prefix = this.extractMethodPrefix(methodName);
+            if (prefix && this.options.disAllowedMethodPrefixes.includes(prefix)) {
+                throw new Error(`Method '${methodName}' in ${controllerName} uses disallowed prefix '${prefix}'. ` +
+                    `Disallowed prefixes: ${this.options.disAllowedMethodPrefixes.join(', ')}. ` +
+                    `Rename the method to use a different prefix.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/server/core.js.map

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

package/dist/server/env.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Environment variable configuration loader
+ * Uses dotenv to load variables from .env file
+ */
+export interface ServerEnvConfig {
+    port: number;
+    host: string;
+    protocol: string;
+    errorExposure: 'none' | 'message' | 'full';
+    jwtSecret?: string;
+    cors: boolean;
+    swagger: boolean;
+    redoc: boolean;
+    defaultAuth: string;
+    rateLimitMaxBalance: number;
+    rateLimitFillInterval: number;
+    rateLimitFillAmount: number;
+    rateLimitHeaders: boolean;
+    tokenLimitMaxBalance: number;
+    tokenLimitFillInterval: number;
+    tokenLimitFillAmount: number;
+    tokenCostHeader: boolean;
+    cacheHeader: boolean;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    nodeEnv: 'development' | 'production' | 'test';
+}
+/**
+ * Load and parse server configuration from environment variables
+ */
+export declare function loadServerConfig(): ServerEnvConfig;
+/**
+ * Get JWT configuration from environment
+ */
+export declare function getJwtConfig(): {
+    secret: string;
+    expiresIn: string;
+    refreshExpiresIn: string;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/server/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/server/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gBAAgB,EAAE,OAAO,CAAA;IACzB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC7C,OAAO,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAA;CAC/C;AAmBD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAuBlD;AAED;;GAEG;AACH,wBAAgB,YAAY;;;;EAW3B"}

package/dist/server/env.js

@@ -0,0 +1,66 @@
+/**
+ * Environment variable configuration loader
+ * Uses dotenv to load variables from .env file
+ */
+import dotenv from 'dotenv';
+// Load .env file
+dotenv.config();
+/**
+ * Parse boolean from environment variable
+ */
+function parseBoolean(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    return value.toLowerCase() === 'true' || value === '1' || value === 'yes';
+}
+/**
+ * Parse number from environment variable
+ */
+function parseNumber(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const num = parseInt(value, 10);
+    return isNaN(num) ? defaultValue : num;
+}
+/**
+ * Load and parse server configuration from environment variables
+ */
+export function loadServerConfig() {
+    return {
+        port: parseNumber(process.env.PLAT_SERVER_PORT, 3000),
+        host: process.env.PLAT_SERVER_HOST || 'localhost',
+        protocol: process.env.PLAT_PROTOCOL || 'http',
+        errorExposure: process.env.PLAT_ERROR_EXPOSURE || 'message',
+        jwtSecret: process.env.JWT_SECRET,
+        cors: process.env.PLAT_CORS ? parseBoolean(process.env.PLAT_CORS, true) : true,
+        swagger: process.env.PLAT_SWAGGER ? parseBoolean(process.env.PLAT_SWAGGER, true) : true,
+        redoc: process.env.PLAT_REDOC ? parseBoolean(process.env.PLAT_REDOC, true) : true,
+        defaultAuth: process.env.PLAT_DEFAULT_AUTH || 'public',
+        rateLimitMaxBalance: parseNumber(process.env.PLAT_RATE_LIMIT_MAX_BALANCE, 100),
+        rateLimitFillInterval: parseNumber(process.env.PLAT_RATE_LIMIT_FILL_INTERVAL, 1000),
+        rateLimitFillAmount: parseNumber(process.env.PLAT_RATE_LIMIT_FILL_AMOUNT, 10),
+        rateLimitHeaders: parseBoolean(process.env.PLAT_RATE_LIMIT_HEADERS, true),
+        tokenLimitMaxBalance: parseNumber(process.env.PLAT_TOKEN_LIMIT_MAX_BALANCE, 10000),
+        tokenLimitFillInterval: parseNumber(process.env.PLAT_TOKEN_LIMIT_FILL_INTERVAL, 1000),
+        tokenLimitFillAmount: parseNumber(process.env.PLAT_TOKEN_LIMIT_FILL_AMOUNT, 100),
+        tokenCostHeader: parseBoolean(process.env.PLAT_TOKEN_COST_HEADER, true),
+        cacheHeader: parseBoolean(process.env.PLAT_CACHE_HEADER, true),
+        logLevel: process.env.PLAT_LOG_LEVEL || 'info',
+        nodeEnv: process.env.NODE_ENV || 'development',
+    };
+}
+/**
+ * Get JWT configuration from environment
+ */
+export function getJwtConfig() {
+    const secret = process.env.JWT_SECRET;
+    if (!secret) {
+        throw new Error('JWT_SECRET environment variable is not set');
+    }
+    return {
+        secret,
+        expiresIn: process.env.JWT_EXPIRES_IN || '24h',
+        refreshExpiresIn: process.env.JWT_REFRESH_EXPIRES_IN || '7d',
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/server/env.js.map

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

package/dist/server/file-queue-protocol-plugin.d.ts

@@ -0,0 +1,7 @@
+import type { PLATServerProtocolPlugin } from './protocol-plugin';
+import type { FileQueueOptions } from './config/types';
+export interface FileQueueProtocolPluginOptions {
+    config: FileQueueOptions | false | undefined;
+}
+export declare function createFileQueueProtocolPlugin(options: FileQueueProtocolPluginOptions): PLATServerProtocolPlugin;
+//# sourceMappingURL=file-queue-protocol-plugin.d.ts.map

package/dist/server/file-queue-protocol-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-queue-protocol-plugin.d.ts","sourceRoot":"","sources":["../../src/server/file-queue-protocol-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAA8B,MAAM,mBAAmB,CAAA;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;CAC7C;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,8BAA8B,GAAG,wBAAwB,CA6K/G"}