@spinajs/http 2.0.485 → 2.0.487

package/lib/cjs/middlewares/RequestId.js

@@ -29,6 +29,10 @@ let RequestId = class RequestId extends interfaces_js_1.ServerMiddleware {
     before() {
         return (req, res, next) => {
             req.storage.requestId = (0, uuid_1.v4)();
+            // Emitted here, not in after(): ServerMiddleware after() handlers never
+            // run for matched controller routes ( response is flushed inside the
+            // controllers router without calling next() ).
+            res.header('x-request-id', req.storage.requestId);
             // Continue an inbound W3C traceparent ( or start a new trace ) and seed
             // traceId / spanId onto req.storage so the ambient log context merges them
             // into every log line — trace ids are shared across services.

package/lib/cjs/middlewares/RequestId.js.map

@@ -1 +1 @@
-{"version":3,"file":"RequestId.js","sourceRoot":"","sources":["../../../src/middlewares/RequestId.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oDAAyE;AAEzE,+BAAoC;AACpC,oCAAyC;AACzC,sCAAiF;AAG1E,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,gCAAgB;IAC7C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,yEAAyE;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM;QACX,OAAO,CAAC,GAAa,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YAC1E,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;YAEjC,wEAAwE;YACxE,2EAA2E;YAC3E,8DAA8D;YAC9D,MAAM,EAAE,GAAkB,IAAA,qBAAe,EAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAuB,CAAC,CAAC;YAC5F,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;YACjC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;YAE/B,oEAAoE;YACpE,0EAA0E;YAC1E,yEAAyE;YACzE,2EAA2E;YAC3E,sDAAsD;YACtD,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,uBAAiB,EAAC,EAAE,CAAC,CAAC,CAAC;YAEjD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AAnCY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,SAAS,CAmCrB"}
+{"version":3,"file":"RequestId.js","sourceRoot":"","sources":["../../../src/middlewares/RequestId.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oDAAyE;AAEzE,+BAAoC;AACpC,oCAAyC;AACzC,sCAAiF;AAG1E,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,gCAAgB;IAC7C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,yEAAyE;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM;QACX,OAAO,CAAC,GAAa,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YAC1E,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;YAEjC,wEAAwE;YACxE,qEAAqE;YACrE,+CAA+C;YAC/C,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAElD,wEAAwE;YACxE,2EAA2E;YAC3E,8DAA8D;YAC9D,MAAM,EAAE,GAAkB,IAAA,qBAAe,EAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAuB,CAAC,CAAC;YAC5F,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;YACjC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;YAE/B,oEAAoE;YACpE,0EAA0E;YAC1E,yEAAyE;YACzE,2EAA2E;YAC3E,sDAAsD;YACtD,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,uBAAiB,EAAC,EAAE,CAAC,CAAC,CAAC;YAEjD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AAxCY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,SAAS,CAwCrB"}

package/lib/cjs/route-builder.d.ts

@@ -0,0 +1,61 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import Express from 'express';
+import { IContainer } from '@spinajs/di';
+import { Log } from '@spinajs/log';
+import { Configuration } from '@spinajs/configuration';
+import { Request as sRequest, IController, IControllerDescriptor, RouteMiddleware, IRoute, BasePolicy, IActionLocalStoregeContext } from './interfaces.js';
+/**
+ * Controller shape needed by the route wiring helpers: the IController
+ * surface plus indexed access to action methods. Structural on purpose —
+ * avoids importing BaseController and creating a module cycle.
+ */
+export type ControllerActionHost = IController & {
+    [action: string]: any;
+};
+/**
+ * Computes the final express path for a route: `/BasePath/Path`, falling back
+ * to the method name when the route has no explicit path, with optional
+ * global route prefix (`http.controllers.route.prefix`).
+ */
+export declare function buildRoutePath(basePath: string, route: IRoute, globalPrefix?: string): string;
+/**
+ * Resolves controller-wise + route-wise middleware descriptors into instances.
+ */
+export declare function resolveRouteMiddlewares(descriptor: IControllerDescriptor, route: IRoute, container: IContainer): Promise<RouteMiddleware[]>;
+/**
+ * Resolves controller-wise + route-wise policy descriptors into instances.
+ *
+ * String policy descriptors are configuration keys pointing at a policy type
+ * name. A key that does not resolve to a registered BasePolicy type throws
+ * {@link RouteRegistrationException} — a silently dropped policy would leave
+ * the route unprotected.
+ */
+export declare function resolveRoutePolicies(descriptor: IControllerDescriptor, route: IRoute, container: IContainer, cfg: Configuration, log: Log, controllerName: string, path: string): Promise<BasePolicy[]>;
+/**
+ * Express handler gating a route behind its policies.
+ *
+ * Executes all policies enabled for the route; if at least ONE policy resolves
+ * without error the route is allowed to execute. This allows multiple access
+ * paths to a resource, e.g. token access & session.
+ */
+export declare function createPolicyGate(policies: BasePolicy[], route: IRoute, controller: IController, log: Log): Express.RequestHandler;
+/**
+ * Wraps a middleware onBefore/onAfter action into an express handler that
+ * forwards both resolution and rejection to `next`.
+ */
+export declare function wrapMiddlewareAction(source: object, action: (req: Express.Request, res: Express.Response, route: IRoute, controller: IController) => Promise<void>, route: IRoute, controller: IController): Express.RequestHandler;
+/**
+ * Express handler invoking the controller action: extracts route arguments,
+ * runs the action inside the request-scoped AsyncLocalStorage context, lets
+ * middlewares inspect the produced Response and stores it in
+ * `res.locals.response` for the response pipeline. All sync and async errors
+ * are forwarded to `next`.
+ */
+export declare function createActionHandler(controller: ControllerActionHost, route: IRoute, enabledMiddlewares: RouteMiddleware[], storage: AsyncLocalStorage<IActionLocalStoregeContext>): Express.RequestHandler;
+/**
+ * Extracts route argument values for an action call. Route-arg handlers are
+ * resolved from DI by parameter type and executed in Priority order
+ * (higher first).
+ */
+export declare function extractRouteArgs(route: IRoute, req: sRequest, res: Express.Response, controllerName: string): Promise<any[]>;
+//# sourceMappingURL=route-builder.d.ts.map

package/lib/cjs/route-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-builder.d.ts","sourceRoot":"","sources":["../../src/route-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B,OAAO,EAAM,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAY,WAAW,EAAE,qBAAqB,EAAqB,eAAe,EAAE,MAAM,EAAyB,UAAU,EAAiB,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG9N;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG;IAAE,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAmB7F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAM3I;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,EAAE,CAAC,CAkBvB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAiDjI;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,EAC9G,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,cAAc,CAgBxB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,eAAe,EAAE,EACrC,OAAO,EAAE,iBAAiB,CAAC,0BAA0B,CAAC,GACrD,OAAO,CAAC,cAAc,CA2CxB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAkClI"}

package/lib/cjs/route-builder.js

@@ -0,0 +1,228 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRoutePath = buildRoutePath;
+exports.resolveRouteMiddlewares = resolveRouteMiddlewares;
+exports.resolveRoutePolicies = resolveRoutePolicies;
+exports.createPolicyGate = createPolicyGate;
+exports.wrapMiddlewareAction = wrapMiddlewareAction;
+exports.createActionHandler = createActionHandler;
+exports.extractRouteArgs = extractRouteArgs;
+const util_1 = require("@spinajs/util");
+const lodash_1 = __importDefault(require("lodash"));
+const di_1 = require("@spinajs/di");
+const exceptions_1 = require("@spinajs/exceptions");
+const interfaces_js_1 = require("./interfaces.js");
+const exceptions_js_1 = require("./exceptions.js");
+/**
+ * Computes the final express path for a route: `/BasePath/Path`, falling back
+ * to the method name when the route has no explicit path, with optional
+ * global route prefix (`http.controllers.route.prefix`).
+ */
+function buildRoutePath(basePath, route, globalPrefix) {
+    let path = '';
+    if (route.Path) {
+        if (route.Path === '/') {
+            path = `/${basePath}`;
+        }
+        else if (basePath === '/') {
+            path = `/${route.Path}`;
+        }
+        else {
+            path = `/${basePath}/${route.Path}`;
+        }
+    }
+    else {
+        path = `/${basePath}/${String(route.Method)}`;
+    }
+    if (globalPrefix) {
+        path = `/${globalPrefix}${path}`;
+    }
+    return path;
+}
+/**
+ * Resolves controller-wise + route-wise middleware descriptors into instances.
+ */
+function resolveRouteMiddlewares(descriptor, route, container) {
+    return Promise.all(descriptor.Middlewares.concat(route.Middlewares || []).map((m) => {
+        return container.resolve(m.Type, m.Options);
+    }));
+}
+/**
+ * Resolves controller-wise + route-wise policy descriptors into instances.
+ *
+ * String policy descriptors are configuration keys pointing at a policy type
+ * name. A key that does not resolve to a registered BasePolicy type throws
+ * {@link RouteRegistrationException} — a silently dropped policy would leave
+ * the route unprotected.
+ */
+function resolveRoutePolicies(descriptor, route, container, cfg, log, controllerName, path) {
+    return Promise.all(descriptor.Policies.concat(route.Policies || []).map((m) => {
+        if (lodash_1.default.isString(m.Type)) {
+            const policyType = cfg.get(m.Type);
+            if (!policyType || !di_1.DI.checkType(interfaces_js_1.BasePolicy, policyType)) {
+                throw new exceptions_js_1.RouteRegistrationException(`No policy named ${policyType ?? '<undefined>'} is registered for route ${controllerName}::${String(route.Method)} at path ${path} ( check your configuration at ${m.Type} )`);
+            }
+            log.trace(`Policy ${policyType} is used in controller ${controllerName}::${String(route.Method)} at path ${path}`);
+            return container.resolve(policyType, m.Options);
+        }
+        log.trace(`Policy ${m.Type.name} is used in controller ${controllerName}::${String(route.Method)} at path ${path}`);
+        return container.resolve(m.Type, m.Options);
+    }));
+}
+/**
+ * Express handler gating a route behind its policies.
+ *
+ * Executes all policies enabled for the route; if at least ONE policy resolves
+ * without error the route is allowed to execute. This allows multiple access
+ * paths to a resource, e.g. token access & session.
+ */
+function createPolicyGate(policies, route, controller, log) {
+    const routeName = `${controller.constructor.name}:${String(route.Method)} ${controller.BasePath}/${String(route.Path || route.Method)}`;
+    return (req, _res, next) => {
+        // Only policies enabled for this concrete route participate in the gate.
+        // A route whose policies are ALL disabled has no active authorization
+        // check, so it is allowed through — same semantics as having no policies
+        // at all. Computing this up front is what prevents the request from
+        // hanging: `Promise.allSettled([])` resolves to `[]`, which matches
+        // neither the fulfilled nor the rejected branch below, so `next` would
+        // never be called.
+        const enabledPolicies = policies.filter((p) => p.isEnabled(route, controller));
+        if (enabledPolicies.length === 0) {
+            next();
+            return;
+        }
+        Promise.allSettled(enabledPolicies.map((p) => {
+            return p
+                .execute(req, route, controller)
+                .then(() => {
+                log.trace(`Policy succeded for route ${routeName}, policy: ${p.constructor.name}`);
+            })
+                .catch((err) => {
+                log.trace(`Policy failed for route ${routeName} error ${err}, policy: ${p.constructor.name}`);
+                throw err;
+            });
+        }))
+            .then((results) => {
+            const fullfilled = results.find((r) => r.status === 'fulfilled');
+            if (fullfilled) {
+                log.trace(`Policy for route ${routeName} succeded, continue execution`);
+                next();
+                return;
+            }
+            // Every policy rejected — forward the first failure to the express
+            // error handler. Use next(err) directly (not `throw next(...)`,
+            // which would reject this .then() with `undefined` as an unhandled
+            // rejection while the error was already forwarded).
+            const failed = results.find((r) => r.status === 'rejected');
+            next(failed ? failed.reason : new exceptions_1.UnexpectedServerError('Policy evaluation produced no result'));
+        })
+            // Guard against unexpected throws in the settle/handler chain so the
+            // request can never stall without a response.
+            .catch((err) => next(err));
+    };
+}
+/**
+ * Wraps a middleware onBefore/onAfter action into an express handler that
+ * forwards both resolution and rejection to `next`.
+ */
+function wrapMiddlewareAction(source, action, route, controller) {
+    const wrapper = (req, res, next) => {
+        action(req, res, route, controller)
+            .then(() => {
+            next();
+        })
+            .catch((err) => {
+            next(err);
+        });
+    };
+    Object.defineProperty(wrapper, 'name', {
+        value: source.constructor.name,
+        writable: true,
+    });
+    return wrapper;
+}
+/**
+ * Express handler invoking the controller action: extracts route arguments,
+ * runs the action inside the request-scoped AsyncLocalStorage context, lets
+ * middlewares inspect the produced Response and stores it in
+ * `res.locals.response` for the response pipeline. All sync and async errors
+ * are forwarded to `next`.
+ */
+function createActionHandler(controller, route, enabledMiddlewares, storage) {
+    const actionHandler = async (req, res, next) => {
+        try {
+            await storage.run(req.storage, async () => {
+                const args = (await extractRouteArgs(route, req, res, controller.constructor.name)).concat([req, res, next]);
+                try {
+                    const result = controller[route.Method].call(controller, ...args);
+                    if ((0, util_1.isPromise)(result)) {
+                        result
+                            .then((r) => {
+                            if (r instanceof interfaces_js_1.Response) {
+                                enabledMiddlewares.forEach((x) => x.onResponse(r, route, controller));
+                            }
+                            res.locals.response = r;
+                            next();
+                        })
+                            .catch((err) => {
+                            next(err);
+                        });
+                    }
+                    else {
+                        if (result instanceof interfaces_js_1.Response) {
+                            enabledMiddlewares.forEach((x) => x.onResponse(result, route, controller));
+                        }
+                        res.locals.response = result;
+                        next();
+                    }
+                }
+                catch (err) {
+                    next(err);
+                }
+            });
+        }
+        catch (err) {
+            next(err);
+        }
+    };
+    Object.defineProperty(actionHandler, 'name', {
+        value: controller.constructor.name,
+        writable: true,
+    });
+    return actionHandler;
+}
+/**
+ * Extracts route argument values for an action call. Route-arg handlers are
+ * resolved from DI by parameter type and executed in Priority order
+ * (higher first).
+ */
+async function extractRouteArgs(route, req, res, controllerName) {
+    const callArgs = new Array(route.Parameters.size);
+    const argsCache = new Map();
+    let callData = {
+        Payload: {},
+    };
+    // Sort parameters by priority (higher priority first)
+    // Get all parameters as array, resolve their handlers to check priority, then sort
+    const paramsWithPriority = await Promise.all(Array.from(route.Parameters.values()).map(async (param) => {
+        const handler = await (0, util_1.tryGetHash)(argsCache, param.Type, () => di_1.DI.resolve(param.Type));
+        return { param, handler, priority: handler?.Priority ?? 0 };
+    }));
+    // Sort by priority descending (higher priority first)
+    const sortedParams = paramsWithPriority.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    for (const { param, handler: routeArgsHandler } of sortedParams) {
+        if (!routeArgsHandler) {
+            throw new exceptions_1.UnexpectedServerError(`Route parameter not registered for parameter: ${param.Name},
+            in method: ${String(route.Method)},
+            in controller: ${controllerName}. Check if you have registered it in DI container.`);
+        }
+        const { Args, CallData } = await routeArgsHandler.extract(callData, callArgs, param, req, res, route);
+        callData = CallData;
+        callArgs[param.Index] = Args;
+    }
+    return callArgs;
+}
+//# sourceMappingURL=route-builder.js.map

package/lib/cjs/route-builder.js.map

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

package/lib/mjs/base-controller.d.ts

@@ -0,0 +1,35 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import Express from 'express';
+import { AsyncService, IContainer } from '@spinajs/di';
+import { Log } from '@spinajs/log';
+import { DataValidator } from '@spinajs/validation';
+import { Configuration } from '@spinajs/configuration';
+import { IController, IControllerDescriptor, IActionLocalStoregeContext } from './interfaces.js';
+export declare abstract class BaseController extends AsyncService implements IController {
+    /**
+     * Array index getter
+     */
+    [action: string]: any;
+    protected _router: Express.Router;
+    protected _container: IContainer;
+    protected _validator: DataValidator;
+    protected _log: Log;
+    protected _actionLocalStorage: AsyncLocalStorage<IActionLocalStoregeContext>;
+    protected _cfg: Configuration;
+    /**
+     * Express router with middleware stack
+     */
+    get Router(): Express.Router;
+    /**
+     * Controller descriptor
+     */
+    get Descriptor(): IControllerDescriptor;
+    /**
+     * Base path for all controller routes eg. my/custom/path/
+     *
+     * It can be defined via `@BasePath` decorator, defaults to controller name without `Controller` part.
+     */
+    get BasePath(): string;
+    resolve(): Promise<void>;
+}
+//# sourceMappingURL=base-controller.d.ts.map

package/lib/mjs/base-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-controller.d.ts","sourceRoot":"","sources":["../../src/base-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAyB,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAU,GAAG,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAOjG,8BAAsB,cAAe,SAAQ,YAAa,YAAW,WAAW;IAC9E;;OAEG;IACH,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IAEtB,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC,MAAM,CAAC;IAGnC,SAAS,CAAC,UAAU,EAAG,UAAU,CAAC;IAGlC,SAAS,CAAC,UAAU,EAAG,aAAa,CAAC;IAGrC,SAAS,CAAC,IAAI,EAAG,GAAG,CAAC;IAGrB,SAAS,CAAC,mBAAmB,EAAG,iBAAiB,CAAC,0BAA0B,CAAC,CAAC;IAG9E,SAAS,CAAC,IAAI,EAAG,aAAa,CAAC;IAE/B;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAAC,MAAM,CAElC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,qBAAqB,CAE7C;IAED;;;;OAIG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAEY,OAAO;CAsCrB"}

package/lib/mjs/base-controller.js

@@ -0,0 +1,93 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { AsyncLocalStorage } from 'node:async_hooks';
+import Express from 'express';
+import { AsyncService, Autoinject, Container } from '@spinajs/di';
+import { Logger, Log } from '@spinajs/log';
+import { DataValidator } from '@spinajs/validation';
+import { Configuration } from '@spinajs/configuration';
+import { CONTROLLED_DESCRIPTOR_SYMBOL } from './decorators.js';
+import { RouteRegistrationException } from './exceptions.js';
+import { __handle_response__ } from './response.js';
+import { __handle_error__ } from './error.js';
+import { buildRoutePath, resolveRouteMiddlewares, resolveRoutePolicies, createPolicyGate, createActionHandler, wrapMiddlewareAction } from './route-builder.js';
+export class BaseController extends AsyncService {
+    /**
+     * Express router with middleware stack
+     */
+    get Router() {
+        return this._router;
+    }
+    /**
+     * Controller descriptor
+     */
+    get Descriptor() {
+        return Reflect.getMetadata(CONTROLLED_DESCRIPTOR_SYMBOL, this);
+    }
+    /**
+     * Base path for all controller routes eg. my/custom/path/
+     *
+     * It can be defined via `@BasePath` decorator, defaults to controller name without `Controller` part.
+     */
+    get BasePath() {
+        return this.Descriptor.BasePath ? this.Descriptor.BasePath : this.constructor.name.toLowerCase();
+    }
+    async resolve() {
+        await super.resolve();
+        if (!this.Descriptor) {
+            this._log.warn(`Controller ${this.constructor.name} does not have descriptor. If its abstract or base class ignore this message.`);
+            return;
+        }
+        this._router = Express.Router();
+        for (const [, route] of this.Descriptor.Routes) {
+            // Fail fast: an unknown route type means the route decorator never set a
+            // valid express method — mounting the rest of the controller while
+            // silently dropping this route would hide the bug.
+            if (route.InternalType === 'unknown') {
+                throw new RouteRegistrationException(`Unknown route type for ${this.constructor.name}::${String(route.Method)}`);
+            }
+            const path = buildRoutePath(this.BasePath, route, this._cfg.get('http.controllers.route.prefix'));
+            const middlewares = await resolveRouteMiddlewares(this.Descriptor, route, this._container);
+            const policies = await resolveRoutePolicies(this.Descriptor, route, this._container, this._cfg, this._log, this.constructor.name, path);
+            const enabledMiddlewares = middlewares.filter((m) => m.isEnabled(route, this));
+            this._log.trace(`Registering route ${route.Type.toUpperCase()} ${this.constructor.name}::${String(route.Method)} at ${path}`);
+            const handlers = [
+                createPolicyGate(policies, route, this, this._log),
+                ...enabledMiddlewares.map((m) => wrapMiddlewareAction(m, m.onBefore.bind(m), route, this)),
+                createActionHandler(this, route, enabledMiddlewares, this._actionLocalStorage),
+                ...enabledMiddlewares.map((m) => wrapMiddlewareAction(m, m.onAfter.bind(m), route, this)),
+                __handle_response__(),
+                __handle_error__(),
+            ];
+            this._router[route.InternalType](path, handlers);
+        }
+    }
+}
+__decorate([
+    Autoinject(Container),
+    __metadata("design:type", Object)
+], BaseController.prototype, "_container", void 0);
+__decorate([
+    Autoinject(),
+    __metadata("design:type", DataValidator)
+], BaseController.prototype, "_validator", void 0);
+__decorate([
+    Logger('http'),
+    __metadata("design:type", Log)
+], BaseController.prototype, "_log", void 0);
+__decorate([
+    Autoinject(),
+    __metadata("design:type", AsyncLocalStorage)
+], BaseController.prototype, "_actionLocalStorage", void 0);
+__decorate([
+    Autoinject(Configuration),
+    __metadata("design:type", Configuration)
+], BaseController.prototype, "_cfg", void 0);
+//# sourceMappingURL=base-controller.js.map

package/lib/mjs/base-controller.js.map

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

package/lib/mjs/cache.d.ts

@@ -1,7 +1,7 @@
 import ts from 'typescript';
 import { AsyncService, ClassInfo } from '@spinajs/di';
 import { fs as fFs, FileHasher } from '@spinajs/fs';
-import type { BaseController } from './controllers.js';
+import type { BaseController } from './base-controller.js';
 import { Log } from '@spinajs/log';
 export interface IParamDoc {
     name: string;
@@ -83,8 +83,18 @@ export declare class DefaultControllerCache extends AsyncService {
     protected CacheFS: fFs;
     protected Hasher: FileHasher;
     resolve(): Promise<void>;
-    /** Returns parameter-name map used for route argument binding. */
-    getCache(controller: ClassInfo<BaseController>): Promise<Record<string, string[]>>;
+    /**
+     * Returns parameter-name map used for route argument binding.
+     *
+     * Cache entries are keyed by source-file content hash, so a changed file
+     * naturally gets a fresh entry. `options.rebuild` forces regeneration and
+     * overwrite even when entries for the current hash already exist — used by
+     * the `http:controllers:cache` CLI command to refresh a pre-built cache
+     * (e.g. inside a docker image build).
+     */
+    getCache(controller: ClassInfo<BaseController>, options?: {
+        rebuild?: boolean;
+    }): Promise<Record<string, string[]>>;
     /** Whether `file` points at a real on-disk source we can parse. */
     private isResolvableSource;
     /**
@@ -160,4 +170,16 @@ export declare class DefaultControllerCache extends AsyncService {
      */
     private schemaFromNamedType;
 }
+/**
+ * Whether a ClassInfo `file` points at a real on-disk source. Bracketed
+ * sentinels (e.g. `<di>`, `<dynamic>`) are used by Controllers for entries
+ * that were never loaded from a file.
+ */
+export declare function isOnDiskSource(file: string | undefined): boolean;
+/**
+ * Pull parameter names from `Function.prototype.toString()` output. Modern V8
+ * preserves the literal signature so we can regex out `(a, b = 1, ...rest)`.
+ * Stripped of default values and TypeScript type annotations.
+ */
+export declare function parseFnParamNames(fn: Function): string[];
 //# sourceMappingURL=cache.d.ts.map

package/lib/mjs/cache.d.ts.map

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

package/lib/mjs/cache.js

@@ -51,8 +51,16 @@ let DefaultControllerCache = class DefaultControllerCache extends AsyncService {
         await super.resolve();
         this.Log.info(`Controller cache dir is: ${this.CacheFS.resolvePath('')}`);
     }
-    /** Returns parameter-name map used for route argument binding. */
-    async getCache(controller) {
+    /**
+     * Returns parameter-name map used for route argument binding.
+     *
+     * Cache entries are keyed by source-file content hash, so a changed file
+     * naturally gets a fresh entry. `options.rebuild` forces regeneration and
+     * overwrite even when entries for the current hash already exist — used by
+     * the `http:controllers:cache` CLI command to refresh a pre-built cache
+     * (e.g. inside a docker image build).
+     */
+    async getCache(controller, options) {
         // Sentinel values like `<di>` are set by Controllers.resolve() / add() for
         // controllers registered through DI rather than a file scan. There's no
         // on-disk source to parse, so fall back to a runtime extraction of
@@ -63,8 +71,9 @@ let DefaultControllerCache = class DefaultControllerCache extends AsyncService {
         const file = resolvePath(controller.file.replace('.js', '.d.ts'));
         const hash = await this.Hasher.hash(file);
         const docHash = `doc_${hash}`;
-        const paramExists = await this.CacheFS.exists(hash);
-        const docExists = await this.CacheFS.exists(docHash);
+        const rebuild = options?.rebuild === true;
+        const paramExists = !rebuild && (await this.CacheFS.exists(hash));
+        const docExists = !rebuild && (await this.CacheFS.exists(docHash));
         if (!paramExists || !docExists) {
             this.Log.info(`Generating controller cache for ${controller.name}`);
             const { parameters, documentation } = this.extractAll(file, controller.name);
@@ -78,11 +87,7 @@ let DefaultControllerCache = class DefaultControllerCache extends AsyncService {
     }
     /** Whether `file` points at a real on-disk source we can parse. */
     isResolvableSource(file) {
-        if (!file)
-            return false;
-        // Bracketed sentinels (e.g. `<di>`, `<dynamic>`) are used by Controllers
-        // for entries that were never loaded from a file.
-        return !(file.startsWith('<') && file.endsWith('>'));
+        return isOnDiskSource(file);
     }
     /**
      * Fallback: derive route method parameter names by parsing each method's
@@ -537,6 +542,16 @@ DefaultControllerCache = __decorate([
     Singleton()
 ], DefaultControllerCache);
 export { DefaultControllerCache };
+/**
+ * Whether a ClassInfo `file` points at a real on-disk source. Bracketed
+ * sentinels (e.g. `<di>`, `<dynamic>`) are used by Controllers for entries
+ * that were never loaded from a file.
+ */
+export function isOnDiskSource(file) {
+    if (!file)
+        return false;
+    return !(file.startsWith('<') && file.endsWith('>'));
+}
 /** Rightmost identifier of an entity name. */
 function entityNameRight(name) {
     return ts.isIdentifier(name) ? name.text : name.right.text;
@@ -546,7 +561,7 @@ function entityNameRight(name) {
  * preserves the literal signature so we can regex out `(a, b = 1, ...rest)`.
  * Stripped of default values and TypeScript type annotations.
  */
-function parseFnParamNames(fn) {
+export function parseFnParamNames(fn) {
     const src = Function.prototype.toString.call(fn);
     const match = src.match(/^[^(]*\(([\s\S]*?)\)/);
     if (!match)