@spinajs/http 2.0.485 → 2.0.487

package/lib/mjs/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/mjs/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/mjs/route-builder.js

@@ -0,0 +1,216 @@
+import { isPromise, tryGetHash } from '@spinajs/util';
+import _ from 'lodash';
+import { DI } from '@spinajs/di';
+import { UnexpectedServerError } from '@spinajs/exceptions';
+import { Response, BasePolicy } from './interfaces.js';
+import { RouteRegistrationException } from './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`).
+ */
+export 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.
+ */
+export 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.
+ */
+export function resolveRoutePolicies(descriptor, route, container, cfg, log, controllerName, path) {
+    return Promise.all(descriptor.Policies.concat(route.Policies || []).map((m) => {
+        if (_.isString(m.Type)) {
+            const policyType = cfg.get(m.Type);
+            if (!policyType || !DI.checkType(BasePolicy, policyType)) {
+                throw new 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.
+ */
+export 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 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`.
+ */
+export 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`.
+ */
+export 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 (isPromise(result)) {
+                        result
+                            .then((r) => {
+                            if (r instanceof Response) {
+                                enabledMiddlewares.forEach((x) => x.onResponse(r, route, controller));
+                            }
+                            res.locals.response = r;
+                            next();
+                        })
+                            .catch((err) => {
+                            next(err);
+                        });
+                    }
+                    else {
+                        if (result instanceof 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).
+ */
+export 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 tryGetHash(argsCache, param.Type, () => 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 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/mjs/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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"}