xypriss 9.11.13 → 9.12.0

package/dist/src/server/routing/modules/registry.d.ts

@@ -0,0 +1,29 @@
+import type { XyPrissRouter } from "../Router";
+import { RichRouteDefinition } from "./types";
+import { MiddlewareEntry } from "../../../types/XyPrissRouter.types";
+/** Minimal interface for router instance to avoid circular imports */
+export interface IRouterInternal {
+    getAllRoutes(): RichRouteDefinition[];
+    getRoutes(): RichRouteDefinition[];
+}
+/**
+ * Internal helper to add a rich route to a router instance.
+ */
+export declare function addRichRoute(router: XyPrissRouter, method: string, path: string, args: any[], internalState: {
+    routes: RichRouteDefinition[];
+    middleware: MiddlewareEntry[];
+    logger: any;
+    options: any;
+    featureResolver: ((flag: string) => boolean) | null;
+}): void;
+/**
+ * Internal helper to mount a sub-router.
+ */
+export declare function mountRouter(mountPath: string, subRouter: IRouterInternal, internalState: {
+    routes: RichRouteDefinition[];
+    middleware: MiddlewareEntry[];
+    logger: any;
+    options: any;
+    featureResolver: ((flag: string) => boolean) | null;
+}): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/server/routing/modules/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/server/routing/modules/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACH,mBAAmB,EAMtB,MAAM,SAAS,CAAC;AAuBjB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC5B,YAAY,IAAI,mBAAmB,EAAE,CAAC;IACtC,SAAS,IAAI,mBAAmB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EAAE,EACX,aAAa,EAAE;IACX,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC;IACb,eAAe,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CACvD,GACF,IAAI,CA6IN;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE;IACX,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC;IACb,eAAe,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CACvD,GACF,IAAI,CA4DN"}

package/dist/src/server/routing/modules/registry.js

@@ -0,0 +1,159 @@
+import { normalizePath, isValidPath, compileRoutePattern, joinPaths, } from "./path";
+import { resolveCondition, nextRouteId, createGuardMiddleware, } from "./helpers";
+import { createRateLimitMiddleware, createCacheMiddleware, wrapWithLifecycle, detectStatusCodes, } from "./middleware";
+/**
+ * Internal helper to add a rich route to a router instance.
+ */
+export function addRichRoute(router, method, path, args, internalState) {
+    if (!method || typeof method !== "string") {
+        throw new Error("HTTP method must be a non-empty string");
+    }
+    if (!path || typeof path !== "string") {
+        throw new Error("Route path must be a non-empty string");
+    }
+    if (!Array.isArray(args) || args.length === 0) {
+        throw new Error(`Route ${method} ${path} must have at least one handler`);
+    }
+    let richOptions;
+    let handlers;
+    if (args.length >= 1 &&
+        typeof args[0] === "object" &&
+        args[0] !== null &&
+        !Array.isArray(args[0]) &&
+        typeof args[0] !== "function") {
+        richOptions = args[0];
+        handlers = args.slice(1);
+    }
+    else {
+        handlers = args;
+    }
+    if (handlers.length === 0) {
+        throw new Error(`Route ${method} ${path} must have at least one handler function`);
+    }
+    const normalizedPath = normalizePath(path);
+    if (!isValidPath(normalizedPath)) {
+        throw new Error(`Invalid path format: ${path}`);
+    }
+    const active = resolveCondition(richOptions?.active, internalState.featureResolver);
+    const middleware = handlers.slice(0, -1);
+    const handler = handlers[handlers.length - 1];
+    if (typeof handler !== "function") {
+        throw new Error(`Final handler must be a function for route ${method} ${path}`);
+    }
+    // -- Guard Execution Injection --
+    const routeGuards = richOptions?.guards;
+    let guardMiddleware;
+    if (routeGuards) {
+        guardMiddleware = createGuardMiddleware(routeGuards, internalState.logger);
+    }
+    const { pattern, paramNames, paramConstraints } = compileRoutePattern(normalizedPath, internalState.options);
+    const inputMiddlewareEntries = middleware.map((m) => ({
+        handler: m,
+    }));
+    if (guardMiddleware) {
+        inputMiddlewareEntries.unshift({ handler: guardMiddleware });
+    }
+    // -- Rich Feature Injection (Rate Limit, Cache) --
+    if (richOptions?.rateLimit) {
+        inputMiddlewareEntries.unshift({
+            handler: createRateLimitMiddleware(richOptions.rateLimit),
+        });
+    }
+    if (richOptions?.cache) {
+        inputMiddlewareEntries.unshift({
+            handler: createCacheMiddleware(richOptions.cache),
+        });
+    }
+    let finalHandler = handler;
+    if (richOptions?.lifecycle) {
+        finalHandler = wrapWithLifecycle(handler, richOptions.lifecycle);
+    }
+    const combinedMiddleware = [
+        ...internalState.middleware,
+        ...inputMiddlewareEntries,
+    ];
+    const versionFromPath = normalizedPath.match(/^\/v(\d+(?:\.\d+)?)\//)?.[1];
+    const version = richOptions?.meta?.version ?? versionFromPath;
+    const route = {
+        id: nextRouteId(),
+        method: method.toUpperCase(),
+        path: normalizedPath,
+        originalPath: normalizedPath,
+        handler: finalHandler,
+        middleware: combinedMiddleware,
+        pattern,
+        paramNames,
+        paramConstraints,
+        guards: richOptions?.guards,
+        lifecycle: richOptions?.lifecycle,
+        rateLimit: richOptions?.rateLimit,
+        cache: richOptions?.cache,
+        meta: richOptions?.meta,
+        responses: richOptions?.meta?.responses ?? detectStatusCodes(handler),
+        priority: richOptions?.priority ?? 0,
+        active,
+        version,
+    };
+    const insertIndex = internalState.routes.findIndex((r) => r.priority < route.priority);
+    if (insertIndex === -1) {
+        internalState.routes.push(route);
+    }
+    else {
+        internalState.routes.splice(insertIndex, 0, route);
+    }
+    internalState.logger.debug("router", `Added route [${route.id}]: ${method} ${normalizedPath}` +
+        (version ? ` (v${version})` : "") +
+        (active ? "" : " [INACTIVE]"));
+}
+/**
+ * Internal helper to mount a sub-router.
+ */
+export function mountRouter(mountPath, subRouter, internalState) {
+    if (!subRouter || typeof subRouter.getAllRoutes !== "function") {
+        throw new Error("Invalid router instance provided");
+    }
+    const normalizedMountPath = normalizePath(mountPath);
+    subRouter.getAllRoutes().forEach((route) => {
+        try {
+            const fullPath = joinPaths(normalizedMountPath, route.originalPath);
+            const { pattern, paramNames, paramConstraints } = compileRoutePattern(fullPath, internalState.options);
+            const mountedMiddleware = route.middleware.map((entry) => {
+                if (entry.path) {
+                    return {
+                        path: joinPaths(normalizedMountPath, entry.path),
+                        handler: entry.handler,
+                    };
+                }
+                return {
+                    path: normalizedMountPath,
+                    handler: entry.handler,
+                };
+            });
+            const combinedMiddleware = [
+                ...internalState.middleware,
+                ...mountedMiddleware,
+            ];
+            const originalHandler = route.handler;
+            const mountedRoute = {
+                ...route,
+                path: fullPath,
+                originalPath: fullPath,
+                pattern,
+                paramNames,
+                paramConstraints,
+                middleware: combinedMiddleware,
+                handler: (req, res, next) => {
+                    const prevBaseUrl = req.baseUrl || "";
+                    req.baseUrl = joinPaths(prevBaseUrl, normalizedMountPath);
+                    return originalHandler(req, res, next);
+                },
+            };
+            internalState.routes.push(mountedRoute);
+        }
+        catch (error) {
+            internalState.logger.error("router", `Failed to mount route ${route.method} ${route.path}: ${error}`);
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/server/routing/modules/registry.js.map

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

package/dist/src/server/routing/modules/types.d.ts

@@ -0,0 +1,143 @@
+import { RouteHandler as IRouteHandler, MiddlewareFunction as IMiddlewareFunction, XyPrisRequest as IXyPrisRequest, XyPrisResponse as IXyPrisResponse } from "../../../types/httpServer.type";
+import { RouteDefinition } from "../../../types/XyPrissRouter.types";
+export type RouteHandler = IRouteHandler;
+export type MiddlewareFunction = IMiddlewareFunction;
+export type XyPrisRequest = IXyPrisRequest;
+export type XyPrisResponse = IXyPrisResponse;
+export type { XyPrisRequest as XRequest, XyPrisResponse as XResponse };
+/** Param type constraint descriptor */
+export type ParamType = "string" | "number" | "integer" | "boolean" | "uuid" | "alpha" | "alphanumeric" | `string(${number},${number})` | `number(${number},${number})` | `enum(${string})`;
+/** A declarative guard: returns true to allow, false/string to deny */
+export type RouteGuard = (req: XyPrisRequest, res: XyPrisResponse) => boolean | string | Promise<boolean | string>;
+/** Named built-in guards for common patterns */
+export interface BuiltInGuards {
+    authenticated?: boolean;
+    roles?: string[];
+    permissions?: string[];
+    /** Custom guard functions, evaluated after built-in ones */
+    custom?: RouteGuard[];
+}
+/** Per-route rate limit config */
+export interface RoutRateLimit {
+    /** Max requests allowed in window */
+    max: number;
+    /** Time window, e.g. "1m", "30s", "1h" */
+    window?: string;
+    /** Time window in milliseconds (optional, takes precedence over window) */
+    windowMs?: number;
+    /** Custom error message */
+    message?: string;
+    /** Key extractor — defaults to IP */
+    keyBy?: "ip" | "user" | ((req: XyPrisRequest) => string);
+}
+/** Declarative cache config */
+export type RouteCache = string | {
+    ttl: number;
+    vary?: string[];
+    key?: (req: XyPrisRequest) => string;
+    invalidateOn?: string[];
+};
+/** Lifecycle hooks scoped to a single route */
+export interface RouteLifecycle {
+    /** Called before the handler chain. Can modify req/res or abort. */
+    beforeEnter?: (req: XyPrisRequest, res: XyPrisResponse, next: () => void) => void | Promise<void>;
+    /** Called after a successful response. For metrics / logging. */
+    afterLeave?: (req: XyPrisRequest, res: XyPrisResponse, durationMs: number) => void | Promise<void>;
+    /** Route-level error handler */
+    onError?: (err: unknown, req: XyPrisRequest, res: XyPrisResponse, next: () => void) => void | Promise<void>;
+}
+/** Route metadata for docs / OpenAPI / registry */
+export interface RouteMeta {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    /** Semver or numeric API version */
+    version?: string;
+    /** Mark as deprecated with optional sunset date */
+    deprecated?: boolean | {
+        since?: string;
+        sunset?: string;
+        replacement?: string;
+    };
+    /** Mark as internal (excluded from public docs) */
+    internal?: boolean;
+    /** Explicitly defined responses for documentation */
+    responses?: Record<string, {
+        description: string;
+    }>;
+    /** Arbitrary key-value pairs for plugins */
+    [key: string]: unknown;
+}
+/** Condition deciding whether a route is active */
+export type RouteCondition = boolean | (() => boolean) | {
+    env?: string | string[];
+    feature?: string;
+};
+/** Full rich route options */
+export interface RichRouteOptions {
+    guards?: BuiltInGuards | RouteGuard[];
+    lifecycle?: RouteLifecycle;
+    rateLimit?: RoutRateLimit;
+    cache?: RouteCache;
+    meta?: RouteMeta;
+    /** Explicit priority (higher = matched first). Default: 0 */
+    priority?: number;
+    /** Whether this route is active. Default: true */
+    active?: RouteCondition;
+}
+/** Internal extended route definition */
+export interface RichRouteDefinition extends RouteDefinition {
+    guards?: BuiltInGuards | RouteGuard[];
+    lifecycle?: RouteLifecycle;
+    rateLimit?: RoutRateLimit;
+    cache?: RouteCache;
+    meta?: RouteMeta;
+    priority: number;
+    active: boolean;
+    /** Full original path string (before regex compile) */
+    originalPath: string;
+    /** Typed param constraints extracted from path */
+    paramConstraints: Record<string, ParamConstraint>;
+    /** API version extracted from meta or path */
+    version?: string;
+    /** Unique route ID for registry */
+    id: string;
+    /** Detected or explicitly defined responses */
+    responses?: Record<string, {
+        description: string;
+    }>;
+}
+export interface ParamConstraint {
+    name: string;
+    type: string;
+    options?: unknown;
+}
+/** Group config passed to router.group() */
+export interface RouteGroupOptions {
+    prefix?: string;
+    middleware?: MiddlewareFunction[];
+    guards?: BuiltInGuards | RouteGuard[];
+    meta?: Partial<RouteMeta>;
+    rateLimit?: RoutRateLimit;
+    /** API version prefix, e.g. "v1" → prepends /v1 */
+    version?: string;
+    active?: RouteCondition;
+}
+/** Registry entry type (for OpenAPI / docs) */
+export interface RouteRegistryEntry {
+    id: string;
+    method: string;
+    path: string;
+    version?: string;
+    meta?: RouteMeta;
+    hasGuards: boolean;
+    hasRateLimit: boolean;
+    hasCache: boolean;
+    paramNames?: string[];
+    paramConstraints: Record<string, ParamConstraint>;
+    /** Detected or explicitly defined responses */
+    responses?: Record<string, {
+        description: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/server/routing/modules/types.d.ts.map

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

package/dist/src/server/routing/modules/types.js

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

package/dist/src/server/routing/modules/types.js.map

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

package/dist/src/server/service/Reload/exec/ExecutableBuilder.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Executable Builder for TypeScript Executor
+ * Creates standalone executables for different platforms
+ */
+export interface BuildConfig {
+    outputDir?: string;
+    platforms?: ("win32" | "linux" | "darwin")[];
+    verbose?: boolean;
+    includeNodeModules?: boolean;
+    minify?: boolean;
+    bundler?: "pkg" | "nexe" | "webpack" | "esbuild";
+}
+export declare class ExecutableBuilder {
+    private config;
+    private projectRoot;
+    constructor(config?: BuildConfig);
+    /**
+     * Build executables for all specified platforms
+     */
+    buildAll(): Promise<void>;
+    /**
+     * Build executable for specific platform
+     */
+    buildForPlatform(platform: "win32" | "linux" | "darwin"): Promise<void>;
+    /**
+     * Create main executable script
+     */
+    private createMainScript;
+    /**
+     * Build with esbuild (fastest, recommended)
+     */
+    private buildWithEsbuild;
+    /**
+     * Build with pkg
+     */
+    private buildWithPkg;
+    /**
+     * Build with nexe
+     */
+    private buildWithNexe;
+    /**
+     * Build with webpack
+     */
+    private buildWithWebpack;
+    /**
+     * Get executable name for platform
+     */
+    private getExecutableName;
+    /**
+     * Get pkg target for platform
+     */
+    private getPkgTarget;
+    /**
+     * Get nexe target for platform
+     */
+    private getNexeTarget;
+    /**
+     * Create webpack configuration
+     */
+    private createWebpackConfig;
+    /**
+     * Ensure output directory exists
+     */
+    private ensureOutputDir;
+}
+export default ExecutableBuilder;
+//# sourceMappingURL=ExecutableBuilder.d.ts.map

package/dist/src/server/service/Reload/exec/ExecutableBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutableBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/server/service/Reload/exec/ExecutableBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACpD;AAED,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,WAAgB;IAcpC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtC;;OAEG;IACU,gBAAgB,CACzB,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GACvC,OAAO,CAAC,IAAI,CAAC;IAuChB;;OAEG;YACW,gBAAgB;IAoF9B;;OAEG;YACW,gBAAgB;IAiD9B;;OAEG;YACW,YAAY;IA0B1B;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,gBAAgB;IAwB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,eAAe;CAK1B;AAED,eAAe,iBAAiB,CAAC"}