@venizia/ignis-kernel 0.4.3 → 0.4.5

package/dist/cjs/base/controllers/factory/repository-injection.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerFactoryRepositoryInjection = void 0;
-const bindings_1 = require("../../../common/bindings");
-const inversion_1 = require("../../../helpers/inversion");
-const core_1 = require("@venizia/ignis-helpers/core");
-/**
- * Injects `repositories.<repositoryName>` into constructor parameter 0 of a factory-generated
- * controller, so a subclass needs no constructor. Recorded as metadata rather than a parameter
- * decorator, which Bun drops in some configurations. A subclass that declares its own `@inject` at
- * index 0 wins, and a sibling subclass keeps the factory's key.
- */
-const registerFactoryRepositoryInjection = (opts) => {
-    const { target, factoryName, controllerName, repositoryName } = opts;
-    if (!repositoryName) {
-        throw (0, core_1.getError)({
-            message: `[${factoryName}] Invalid repository name | controller: ${controllerName} | repository.name must name the repository binding`,
-        });
-    }
-    inversion_1.MetadataRegistry.getInstance().setInjectMetadata({
-        target,
-        index: 0,
-        metadata: {
-            key: inversion_1.BindingKeys.build({ namespace: bindings_1.BindingNamespaces.REPOSITORY, key: repositoryName }),
-            index: 0,
-            isOptional: false,
-        },
-    });
-};
-exports.registerFactoryRepositoryInjection = registerFactoryRepositoryInjection;
-//# sourceMappingURL=repository-injection.js.map

package/dist/cjs/base/controllers/factory/repository-injection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"repository-injection.js","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/repository-injection.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AACtD,mDAAoE;AAEpE,sDAAuD;AAEvD;;;;;GAKG;AACI,MAAM,kCAAkC,GAAG,CAAC,IAKlD,EAAQ,EAAE;IACT,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAErE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,IAAI,WAAW,2CAA2C,cAAc,qDAAqD;SACvI,CAAC,CAAC;IACL,CAAC;IAED,4BAAgB,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC;QAC/C,MAAM;QACN,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE;YACR,GAAG,EAAE,uBAAW,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,4BAAiB,CAAC,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;YACxF,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,KAAK;SAClB;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AAvBW,QAAA,kCAAkC,sCAuB7C","sourcesContent":["import { BindingNamespaces } from '@/common/bindings';\nimport { BindingKeys, MetadataRegistry } from '@/helpers/inversion';\nimport type { TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\n\n/**\n * Injects `repositories.<repositoryName>` into constructor parameter 0 of a factory-generated\n * controller, so a subclass needs no constructor. Recorded as metadata rather than a parameter\n * decorator, which Bun drops in some configurations. A subclass that declares its own `@inject` at\n * index 0 wins, and a sibling subclass keeps the factory's key.\n */\nexport const registerFactoryRepositoryInjection = (opts: {\n  target: TClass<unknown>;\n  factoryName: string;\n  controllerName: string;\n  repositoryName: string;\n}): void => {\n  const { target, factoryName, controllerName, repositoryName } = opts;\n\n  if (!repositoryName) {\n    throw getError({\n      message: `[${factoryName}] Invalid repository name | controller: ${controllerName} | repository.name must name the repository binding`,\n    });\n  }\n\n  MetadataRegistry.getInstance().setInjectMetadata({\n    target,\n    index: 0,\n    metadata: {\n      key: BindingKeys.build({ namespace: BindingNamespaces.REPOSITORY, key: repositoryName }),\n      index: 0,\n      isOptional: false,\n    },\n  });\n};\n"]}

package/dist/cjs/base/controllers/index.d.ts

@@ -1,5 +0,0 @@
-export * from './common';
-export * from './context';
-export * from './factory';
-export * from './rest';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/base/controllers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/cjs/base/controllers/index.js

@@ -1,21 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./common"), exports);
-__exportStar(require("./context"), exports);
-__exportStar(require("./factory"), exports);
-__exportStar(require("./rest"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/base/controllers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/controllers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,4CAA0B;AAC1B,yCAAuB","sourcesContent":["export * from './common';\nexport * from './context';\nexport * from './factory';\nexport * from './rest';\n"]}

package/dist/cjs/base/controllers/rest/abstract.d.ts

@@ -1,58 +0,0 @@
-import { type TRoutePathScope } from '../common/constants';
-import type { Hook } from '@hono/zod-openapi';
-import { OpenAPIHono } from '@hono/zod-openapi';
-import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { Env, Schema } from 'hono';
-import type { IAuthRouteConfig, IBindRouteOptions, IController, IControllerOptions, IDefineRouteOptions, TRouteHandler } from '../common/types';
-/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */
-export declare abstract class AbstractRestController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>> extends BaseHelper implements IController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
-    isConfigured: boolean;
-    router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
-    path: string;
-    definitions: Definitions;
-    constructor(opts: IControllerOptions);
-    /** Returns the OpenAPIHono router instance for this controller. */
-    getRouter(): OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
-    /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */
-    registerRoutesFromRegistry(opts?: {
-        paths?: TRoutePathScope;
-    }): void;
-    /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */
-    configure(opts?: ConfigurableOptions): Promise<OpenAPIHono<RouteEnv, RouteSchema, BasePath>>;
-    /** @internal Builds auth + custom middlewares and security specs from route config. */
-    buildRouteMiddlewares<RouteConfig extends IAuthRouteConfig>(opts: {
-        configs: RouteConfig;
-    }): {
-        restConfig: Omit<RouteConfig, "authenticate" | "authorize">;
-        security: {
-            [x: string]: never[];
-        }[];
-        mws: import("hono").MiddlewareHandler<Env>[];
-    };
-    /** Processes route config, injecting auth middleware and OpenAPI security specs. */
-    getRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: {
-        configs: RouteConfig;
-    }): RouteConfig & {
-        getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${/*elided*/ any}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : T : never : never;
-    };
-    /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */
-    getJSXRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: {
-        configs: RouteConfig;
-    }): RouteConfig & {
-        getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${/*elided*/ any}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : Rest}` : T : never : never;
-    };
-    /** Override to register routes using bindRoute or defineRoute. */
-    abstract binding(): ValueOrPromise<void>;
-    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
-    abstract bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {
-        configs: RouteConfig;
-    }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-    /** Defines and registers a route with its handler in a single call. */
-    abstract defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
-        configs: RouteConfig;
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
-    }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-}
-//# sourceMappingURL=abstract.d.ts.map

package/dist/cjs/base/controllers/rest/abstract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":"AAQA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE5F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAOzB,kHAAkH;AAClH,8BAAsB,sBAAsB,CAC1C,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAEvF,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAE5E,YAAY,UAAS;IACrB,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;gBAEb,IAAI,EAAE,kBAAkB;IA2BpC,mEAAmE;IACnE,SAAS;IAIT,kJAAkJ;IAClJ,0BAA0B,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI;IAoCpE,0GAA0G;IACpG,SAAS,CACb,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAqBxD,uFAAuF;IACvF,qBAAqB,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;;;;;IAkD1F,oFAAoF;IACpF,eAAe,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;IAcpF,4EAA4E;IAC5E,kBAAkB,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;IAcvF,kEAAkE;IAClE,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAExC,uFAAuF;IACvF,QAAQ,CAAC,SAAS,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAC7D,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAEnE,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACvF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CACtE"}

package/dist/cjs/base/controllers/rest/abstract.js

@@ -1,159 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractRestController = void 0;
-const constants_1 = require("../../auth/authenticate/common/constants");
-const authenticate_middleware_1 = require("../../auth/authenticate/middlewares/authenticate.middleware");
-const authorize_middleware_1 = require("../../auth/authorize/middlewares/authorize.middleware");
-const form_body_middleware_1 = require("../../middlewares/form-body/form-body.middleware");
-const strategy_registry_1 = require("../../auth/authenticate/strategies/strategy-registry");
-const common_1 = require("../../metadata/routes/common");
-const registry_1 = require("../../../helpers/inversion/registry");
-const constants_2 = require("../common/constants");
-const html_response_1 = require("../common/html-response");
-const zod_openapi_1 = require("@hono/zod-openapi");
-const core_1 = require("@venizia/ignis-helpers/core");
-/** True for a route path carrying a path parameter, in either supported syntax: `/{id}` or `/:id`. */
-const hasPathParam = (opts) => {
-    return /\{[^}]+\}|:[^/]+/.test(opts.path);
-};
-/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */
-class AbstractRestController extends core_1.BaseHelper {
-    constructor(opts) {
-        super(opts);
-        this.isConfigured = false;
-        const { isStrict = true } = opts;
-        const decoratorMetadata = registry_1.MetadataRegistry.getInstance().getControllerMetadata({
-            target: new.target,
-        });
-        const resolvedPath = decoratorMetadata?.path ?? opts.path;
-        if (!resolvedPath) {
-            throw (0, core_1.getError)({
-                message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,
-            });
-        }
-        this.path = resolvedPath;
-        this.router = new zod_openapi_1.OpenAPIHono({
-            strict: isStrict,
-            defaultHook: (result, _context) => {
-                if (!result.success) {
-                    throw result.error;
-                }
-            },
-        });
-    }
-    /** Returns the OpenAPIHono router instance for this controller. */
-    getRouter() {
-        return this.router;
-    }
-    /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */
-    registerRoutesFromRegistry(opts) {
-        const { paths = constants_2.RoutePathScopes.ALL } = opts ?? {};
-        const logger = this.logger.for(this.registerRoutesFromRegistry.name);
-        common_1.DroppedRouteDecorators.report({ logger });
-        const routes = registry_1.MetadataRegistry.getInstance().getRoutes({
-            target: Object.getPrototypeOf(this),
-        });
-        if (!routes?.size) {
-            return;
-        }
-        const routeDefs = routes.entries();
-        for (const [methodName, routeConfigs] of routeDefs) {
-            if (paths !== constants_2.RoutePathScopes.ALL &&
-                hasPathParam({ path: routeConfigs.path }) !== (paths === constants_2.RoutePathScopes.PARAM)) {
-                continue;
-            }
-            // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.
-            const handler = this[methodName];
-            if (typeof handler !== 'function') {
-                logger.warn('Route method "%s" not found on controller', String(methodName));
-                continue;
-            }
-            this.bindRoute({ configs: routeConfigs }).to({
-                handler: handler.bind(this),
-            });
-        }
-    }
-    /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */
-    async configure(opts) {
-        if (this.isConfigured) {
-            return this.router;
-        }
-        const t = performance.now();
-        const logger = this.logger.for(this.configure.name);
-        const configureOptions = opts ?? {};
-        logger.info('START | Binding controller | Options: %j', configureOptions);
-        // Hono matches in registration order, so registration runs by SHAPE not source: every static path first, then binding()'s routes, then decorator param routes last (`/{id}` early would eat `/count`).
-        this.registerRoutesFromRegistry({ paths: constants_2.RoutePathScopes.STATIC });
-        await this.binding();
-        this.registerRoutesFromRegistry({ paths: constants_2.RoutePathScopes.PARAM });
-        this.isConfigured = true;
-        logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);
-        return this.router;
-    }
-    /** @internal Builds auth + custom middlewares and security specs from route config. */
-    buildRouteMiddlewares(opts) {
-        const { authenticate = {}, authorize, ...restConfig } = opts.configs;
-        const { strategies = [], mode = constants_1.AuthenticationModes.ANY } = authenticate;
-        // Boot-time and NON-fatal: names a misspelled strategy at error level instead of leaving it as
-        // a 401 nobody can explain. Deliberately not a throw - `defineAuthController` hard-codes `jwt`
-        // on four routes, and ANY mode tolerates a strategy that does not resolve, so failing here would
-        // stop applications booting that work today. `assertRegistered` is there for an application that
-        // does want the hard failure.
-        strategy_registry_1.AuthenticationStrategyRegistry.getInstance().reportUnregistered({
-            names: strategies,
-            scope: this.constructor.name,
-        });
-        const security = strategies.map((strategy) => ({ [strategy]: [] }));
-        const mws = [];
-        if (strategies.length > 0) {
-            mws.push((0, authenticate_middleware_1.authenticate)({ strategies, mode }));
-        }
-        // Inject authorize middleware AFTER authenticate
-        if (authorize) {
-            const specs = Array.isArray(authorize) ? authorize : [authorize];
-            for (const spec of specs) {
-                mws.push((0, authorize_middleware_1.authorize)({ spec }));
-            }
-        }
-        const configuredMiddleware = restConfig.middleware;
-        const extraMws = Array.isArray(configuredMiddleware)
-            ? configuredMiddleware
-            : [configuredMiddleware];
-        for (const mw of extraMws) {
-            if (!mw) {
-                continue;
-            }
-            mws.push(mw);
-        }
-        // Last: an application middleware and any size check run before the body is read.
-        if ((0, form_body_middleware_1.hasFormBody)({ content: restConfig.request?.body?.content })) {
-            mws.push(form_body_middleware_1.formBodyReader);
-        }
-        return { restConfig, security, mws };
-    }
-    /** Processes route config, injecting auth middleware and OpenAPI security specs. */
-    getRouteConfigs(opts) {
-        const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);
-        const { tags = [] } = restConfig;
-        // `restConfig` already omitted `authenticate`/`authorize` (this library's fields, not Hono's `createRoute` ones); reassembled with the injected middleware/tags/security it no longer structurally overlaps RouteConfig enough to assert directly.
-        return (0, zod_openapi_1.createRoute)(Object.assign({}, restConfig, {
-            middleware: mws,
-            tags: [...tags, this.scope],
-            security,
-        }));
-    }
-    /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */
-    getJSXRouteConfigs(opts) {
-        const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);
-        const { responses, tags = [] } = restConfig;
-        // Same reassembled-vs-RouteConfig boundary as getRouteConfigs above.
-        return (0, zod_openapi_1.createRoute)(Object.assign({}, restConfig, {
-            middleware: mws,
-            responses: Object.assign({}, (0, html_response_1.htmlResponse)({ description: 'HTML page' }), responses),
-            tags: [...tags, this.scope],
-            security,
-        }));
-    }
-}
-exports.AbstractRestController = AbstractRestController;
-//# sourceMappingURL=abstract.js.map

package/dist/cjs/base/controllers/rest/abstract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":";;;AAAA,yEAAgF;AAChF,0GAA8G;AAE9G,iGAAkG;AAClG,4FAAgG;AAChG,6FAAuG;AACvG,0DAAuE;AACvE,2DAAgE;AAChE,mEAA4F;AAC5F,2EAAuE;AAEvE,mDAA6D;AAE7D,sDAAmE;AAWnE,sGAAsG;AACtG,MAAM,YAAY,GAAG,CAAC,IAAsB,EAAW,EAAE;IACvD,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,kHAAkH;AAClH,MAAsB,sBAOpB,SAAQ,iBAAU;IAQlB,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,CAAC,CAAC;QANd,iBAAY,GAAG,KAAK,CAAC;QAOnB,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,iBAAiB,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC;YAC7E,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,iBAAiB,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAE1D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,+FAA+F;aAC5H,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAW,CAAkC;YAC7D,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;gBAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,MAAM,CAAC,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,kJAAkJ;IAClJ,0BAA0B,CAAC,IAAkC;QAC3D,MAAM,EAAE,KAAK,GAAG,2BAAe,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACrE,+BAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE1C,MAAM,MAAM,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC;YACtD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;YACnD,IACE,KAAK,KAAK,2BAAe,CAAC,GAAG;gBAC7B,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,2BAAe,CAAC,KAAK,CAAC,EAC/E,CAAC;gBACD,SAAS;YACX,CAAC;YAED,iKAAiK;YACjK,MAAM,OAAO,GAAI,IAAyC,CAAC,UAAU,CAAC,CAAC;YACvE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC7E,SAAS;YACX,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3C,OAAO,EAAG,OAA4C,CAAC,IAAI,CAAC,IAAI,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,SAAS,CACb,IAA0B;QAE1B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEpD,MAAM,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,gBAAgB,CAAC,CAAC;QAE1E,uMAAuM;QACvM,IAAI,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,2BAAe,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,2BAAe,CAAC,KAAK,EAAE,CAAC,CAAC;QAElE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,uFAAuF;IACvF,qBAAqB,CAAuC,IAA8B;QACxF,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACrE,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,IAAI,GAAG,+BAAmB,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;QAEzE,+FAA+F;QAC/F,+FAA+F;QAC/F,iGAAiG;QACjG,iGAAiG;QACjG,8BAA8B;QAC9B,kDAA8B,CAAC,WAAW,EAAE,CAAC,kBAAkB,CAAC;YAC9D,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;SAC7B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAwC,EAAE,CAAC;QAEpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,IAAA,sCAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,iDAAiD;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAyB,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACvF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,IAAA,gCAAW,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,MAAM,oBAAoB,GAAG,UAAU,CAAC,UAAU,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;YAClD,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAE3B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,SAAS;YACX,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;QAED,kFAAkF;QAClF,IAAI,IAAA,kCAAW,EAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,qCAAc,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;IAED,oFAAoF;IACpF,eAAe,CAAuC,IAA8B;QAClF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC;QAEjC,mPAAmP;QACnP,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAQ,CACV,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kBAAkB,CAAuC,IAA8B;QACrF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC;QAE5C,qEAAqE;QACrE,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAA,4BAAY,EAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC;YACnF,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAQ,CACV,CAAC;IACJ,CAAC;CAeF;AA3MD,wDA2MC","sourcesContent":["import { AuthenticationModes } from '@/base/auth/authenticate/common/constants';\nimport { authenticate as authenticateFn } from '@/base/auth/authenticate/middlewares/authenticate.middleware';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport { authorize as authorizeFn } from '@/base/auth/authorize/middlewares/authorize.middleware';\nimport { formBodyReader, hasFormBody } from '@/base/middlewares/form-body/form-body.middleware';\nimport { AuthenticationStrategyRegistry } from '@/base/auth/authenticate/strategies/strategy-registry';\nimport { DroppedRouteDecorators } from '@/base/metadata/routes/common';\nimport { MetadataRegistry } from '@/helpers/inversion/registry';\nimport { RoutePathScopes, type TRoutePathScope } from '@/base/controllers/common/constants';\nimport { htmlResponse } from '@/base/controllers/common/html-response';\nimport type { Hook } from '@hono/zod-openapi';\nimport { createRoute, OpenAPIHono } from '@hono/zod-openapi';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport type { Env, Schema } from 'hono';\nimport type {\n  IAuthRouteConfig,\n  IBindRouteOptions,\n  IController,\n  IControllerOptions,\n  IDefineRouteOptions,\n  TRouteHandler,\n} from '../common/types';\n\n/** True for a route path carrying a path parameter, in either supported syntax: `/{id}` or `/:id`. */\nconst hasPathParam = (opts: { path: string }): boolean => {\n  return /\\{[^}]+\\}|:[^/]+/.test(opts.path);\n};\n\n/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */\nexport abstract class AbstractRestController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ConfigurableOptions extends object = {},\n  Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>,\n>\n  extends BaseHelper\n  implements IController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions>\n{\n  isConfigured = false;\n  router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;\n  path: string;\n  definitions: Definitions;\n\n  constructor(opts: IControllerOptions) {\n    super(opts);\n    const { isStrict = true } = opts;\n\n    const decoratorMetadata = MetadataRegistry.getInstance().getControllerMetadata({\n      target: new.target,\n    });\n    const resolvedPath = decoratorMetadata?.path ?? opts.path;\n\n    if (!resolvedPath) {\n      throw getError({\n        message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,\n      });\n    }\n\n    this.path = resolvedPath;\n\n    this.router = new OpenAPIHono<RouteEnv, RouteSchema, BasePath>({\n      strict: isStrict,\n      defaultHook: (result, _context) => {\n        if (!result.success) {\n          throw result.error;\n        }\n      },\n    });\n  }\n\n  /** Returns the OpenAPIHono router instance for this controller. */\n  getRouter() {\n    return this.router;\n  }\n\n  /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */\n  registerRoutesFromRegistry(opts?: { paths?: TRoutePathScope }): void {\n    const { paths = RoutePathScopes.ALL } = opts ?? {};\n\n    const logger = this.logger.for(this.registerRoutesFromRegistry.name);\n    DroppedRouteDecorators.report({ logger });\n\n    const routes = MetadataRegistry.getInstance().getRoutes({\n      target: Object.getPrototypeOf(this),\n    });\n\n    if (!routes?.size) {\n      return;\n    }\n\n    const routeDefs = routes.entries();\n    for (const [methodName, routeConfigs] of routeDefs) {\n      if (\n        paths !== RoutePathScopes.ALL &&\n        hasPathParam({ path: routeConfigs.path }) !== (paths === RoutePathScopes.PARAM)\n      ) {\n        continue;\n      }\n\n      // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.\n      const handler = (this as Record<string | symbol, unknown>)[methodName];\n      if (typeof handler !== 'function') {\n        logger.warn('Route method \"%s\" not found on controller', String(methodName));\n        continue;\n      }\n\n      this.bindRoute({ configs: routeConfigs }).to({\n        handler: (handler as TRouteHandler<unknown, RouteEnv>).bind(this),\n      });\n    }\n  }\n\n  /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */\n  async configure(\n    opts?: ConfigurableOptions,\n  ): Promise<OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {\n    if (this.isConfigured) {\n      return this.router;\n    }\n\n    const t = performance.now();\n    const logger = this.logger.for(this.configure.name);\n\n    const configureOptions = opts ?? {};\n    logger.info('START | Binding controller | Options: %j', configureOptions);\n\n    // Hono matches in registration order, so registration runs by SHAPE not source: every static path first, then binding()'s routes, then decorator param routes last (`/{id}` early would eat `/count`).\n    this.registerRoutesFromRegistry({ paths: RoutePathScopes.STATIC });\n    await this.binding();\n    this.registerRoutesFromRegistry({ paths: RoutePathScopes.PARAM });\n\n    this.isConfigured = true;\n    logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);\n    return this.router;\n  }\n\n  /** @internal Builds auth + custom middlewares and security specs from route config. */\n  buildRouteMiddlewares<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { authenticate = {}, authorize, ...restConfig } = opts.configs;\n    const { strategies = [], mode = AuthenticationModes.ANY } = authenticate;\n\n    // Boot-time and NON-fatal: names a misspelled strategy at error level instead of leaving it as\n    // a 401 nobody can explain. Deliberately not a throw - `defineAuthController` hard-codes `jwt`\n    // on four routes, and ANY mode tolerates a strategy that does not resolve, so failing here would\n    // stop applications booting that work today. `assertRegistered` is there for an application that\n    // does want the hard failure.\n    AuthenticationStrategyRegistry.getInstance().reportUnregistered({\n      names: strategies,\n      scope: this.constructor.name,\n    });\n\n    const security = strategies.map((strategy: string) => ({ [strategy]: [] }));\n    const mws: ReturnType<typeof authenticateFn>[] = [];\n\n    if (strategies.length > 0) {\n      mws.push(authenticateFn({ strategies, mode }));\n    }\n\n    // Inject authorize middleware AFTER authenticate\n    if (authorize) {\n      const specs: IAuthorizationSpec[] = Array.isArray(authorize) ? authorize : [authorize];\n      for (const spec of specs) {\n        mws.push(authorizeFn({ spec }));\n      }\n    }\n\n    const configuredMiddleware = restConfig.middleware;\n    const extraMws = Array.isArray(configuredMiddleware)\n      ? configuredMiddleware\n      : [configuredMiddleware];\n\n    for (const mw of extraMws) {\n      if (!mw) {\n        continue;\n      }\n\n      mws.push(mw);\n    }\n\n    // Last: an application middleware and any size check run before the body is read.\n    if (hasFormBody({ content: restConfig.request?.body?.content })) {\n      mws.push(formBodyReader);\n    }\n\n    return { restConfig, security, mws };\n  }\n\n  /** Processes route config, injecting auth middleware and OpenAPI security specs. */\n  getRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);\n    const { tags = [] } = restConfig;\n\n    // `restConfig` already omitted `authenticate`/`authorize` (this library's fields, not Hono's `createRoute` ones); reassembled with the injected middleware/tags/security it no longer structurally overlaps RouteConfig enough to assert directly.\n    return createRoute<string, RouteConfig>(\n      Object.assign({}, restConfig, {\n        middleware: mws,\n        tags: [...tags, this.scope],\n        security,\n      }) as any,\n    );\n  }\n\n  /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */\n  getJSXRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);\n    const { responses, tags = [] } = restConfig;\n\n    // Same reassembled-vs-RouteConfig boundary as getRouteConfigs above.\n    return createRoute<string, RouteConfig>(\n      Object.assign({}, restConfig, {\n        middleware: mws,\n        responses: Object.assign({}, htmlResponse({ description: 'HTML page' }), responses),\n        tags: [...tags, this.scope],\n        security,\n      }) as any,\n    );\n  }\n  /** Override to register routes using bindRoute or defineRoute. */\n  abstract binding(): ValueOrPromise<void>;\n\n  /** Creates a fluent binding for registering a route (call .to() to attach handler). */\n  abstract bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {\n    configs: RouteConfig;\n  }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n\n  /** Defines and registers a route with its handler in a single call. */\n  abstract defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {\n    configs: RouteConfig;\n    handler: TRouteHandler<ResponseType, RouteEnv>;\n    hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;\n  }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n}\n"]}

package/dist/cjs/base/controllers/rest/base.d.ts

@@ -1,143 +0,0 @@
-import type { Hook, OpenAPIHono } from '@hono/zod-openapi';
-import type { TDataRange } from '../../repositories/common/types';
-import type { AnyType, TNullable, ValueOrPromise } from '@venizia/ignis-helpers/common';
-import type { Env, Schema } from 'hono';
-import type { TResponseFormat } from '../common/constants';
-import type { IAuthRouteConfig, IBindRouteOptions, IDefineRouteOptions, TRouteContext, TRouteHandler } from '../common/types';
-import { AbstractRestController } from './abstract';
-import type { IRequestedExtra, TResponseExtra } from './extras';
-/** `Content-Range` of a page: inclusive `end`, and `records * /<total>` (no space) when the page is empty. Exported so a route that writes the header itself uses the one formatter. */
-export declare const toContentRange: (opts: {
-    range: TDataRange;
-    count: number;
-}) => string;
-/** Recommended base class for REST controllers with concrete bindRoute and defineRoute implementations. */
-export declare abstract class BaseRestController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>> extends AbstractRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions, Definitions> {
-    /** Runs a handler task under performance measurement (fixed logger/level/description). */
-    measure<R>(opts: {
-        scope: string;
-        args: unknown;
-        task: () => Promise<R>;
-    }): Promise<any>;
-    /** Returns the full `{ count, data }` envelope, or just `data` when the client sent `x-request-count: false`; `X-Response-Count` is set either way. */
-    normalizeCountData<ResponseSchema extends AnyType, RequestContext extends TRouteContext<RouteEnv> = TRouteContext<RouteEnv>, ResponseData extends {
-        count: number;
-        data?: TNullable<ResponseSchema>;
-    } = {
-        count: number;
-        data?: TNullable<ResponseSchema>;
-    }>(opts: {
-        context: RequestContext;
-        payload: ResponseData;
-    }): TNullable<ResponseSchema> | ResponseData;
-    /** `x-request-extra`, parsed: `name`, `-name` (a default switched off) and `name(key,key)`. */
-    getRequestedExtras(opts: {
-        context: TRouteContext<RouteEnv>;
-    }): Array<IRequestedExtra>;
-    /**
-     * The one response call. Sets `X-Response-Format`, and with `range` (a list) also `Content-Range` -
-     * `payload.count` is the rows of THIS response, never the total - then normalizes count/data per
-     * the request-count header.
-     *
-     * `extra` offers figures beside the rows (see {@link TResponseExtra}): each runs when the client
-     * names it in `x-request-extra`, or always when it is a default. When any runs, the body is
-     * `{ data, extra }` (with `count` when it is requested); when none does, nothing is computed and the
-     * body is what it would be without `extra`. A name the route does not offer is a 400 listing the
-     * ones it does.
-     */
-    respond<R>(opts: {
-        context: TRouteContext<RouteEnv>;
-        format: TResponseFormat;
-        payload: {
-            count: number;
-            data?: TNullable<R>;
-        };
-        range?: TDataRange;
-        extra?: never;
-    }): R | {
-        count: number;
-        data?: TNullable<R>;
-    } | null | undefined;
-    respond<R, Extra extends Record<string, TResponseExtra>>(opts: {
-        context: TRouteContext<RouteEnv>;
-        format: TResponseFormat;
-        payload: {
-            count: number;
-            data?: TNullable<R>;
-        };
-        range?: TDataRange;
-        extra: Extra;
-    }): Promise<R | {
-        count: number;
-        data?: TNullable<R>;
-    } | {
-        count?: number;
-        data?: TNullable<R>;
-        extra: Partial<Record<keyof Extra, unknown>>;
-    } | null | undefined>;
-    respond<R>(opts: {
-        context: TRouteContext<RouteEnv>;
-        format: TResponseFormat;
-        payload: {
-            count: number;
-            data?: TNullable<R>;
-        };
-        range?: TDataRange;
-        extra?: Record<string, TResponseExtra>;
-    }): ValueOrPromise<R | {
-        count?: number;
-        data?: TNullable<R>;
-        extra?: Record<string, unknown>;
-    } | null | undefined>;
-    /** The `extra` half of `respond`: resolves what was asked against what is offered, runs it in parallel. */
-    respondWithExtra<R>(opts: {
-        context: TRouteContext<RouteEnv>;
-        payload: {
-            count: number;
-            data?: TNullable<R>;
-        };
-        extra: Record<string, TResponseExtra>;
-    }): Promise<R | {
-        count: number;
-        data?: TNullable<R>;
-    } | {
-        count: number;
-        data: TNullable<R>;
-        extra: Record<string, unknown>;
-    } | {
-        data: TNullable<R>;
-        extra: Record<string, unknown>;
-        count?: undefined;
-    } | null | undefined>;
-    /** The list headers without the body, for a list whose body is not a `{ count, data }` envelope: `Content-Range`, `X-Response-Count` = rows in THIS response, `X-Response-Format: array`. Pass a `range`, or `offset` + `total` for an engine that reports those (a search page): the range is derived with the same inclusive-end rule. */
-    setListHeaders(opts: {
-        context: TRouteContext<RouteEnv>;
-        count: number;
-    } & ({
-        range: TDataRange;
-    } | {
-        offset: number;
-        total: number;
-    })): void;
-    /** TRouteHandler's TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures) built on Hono's real Context, not a subtype of the RouteHandler `.openapi()` expects - genuinely different handler types bridged here. */
-    toHonoHandler<ResponseType = unknown>(opts: {
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-    }): Parameters<OpenAPIHono<RouteEnv>["openapi"]>[1];
-    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
-    bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {
-        configs: RouteConfig;
-    }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-    /** Defines and registers a route with its handler in a single call. */
-    defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
-        configs: RouteConfig;
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
-    }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-    /** Defines a JSX route that renders server-side HTML via c.html(). */
-    defineJSXRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
-        configs: RouteConfig;
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
-    }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-}
-//# sourceMappingURL=base.d.ts.map

package/dist/cjs/base/controllers/rest/base.d.ts.map

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

package/dist/cjs/base/controllers/rest/base.js

@@ -1,121 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseRestController = exports.toContentRange = void 0;
-const types_1 = require("../../repositories/common/types");
-const common_1 = require("@venizia/ignis-helpers/common");
-const core_1 = require("@venizia/ignis-helpers/core");
-const constants_1 = require("../common/constants");
-const abstract_1 = require("./abstract");
-const extras_1 = require("./extras");
-/** `Content-Range` of a page: inclusive `end`, and `records * /<total>` (no space) when the page is empty. Exported so a route that writes the header itself uses the one formatter. */
-const toContentRange = (opts) => {
-    const { range, count } = opts;
-    const { start, end, total } = range;
-    return count > 0 ? `records ${start}-${end}/${total}` : `records */${total}`;
-};
-exports.toContentRange = toContentRange;
-/** Recommended base class for REST controllers with concrete bindRoute and defineRoute implementations. */
-class BaseRestController extends abstract_1.AbstractRestController {
-    /** Runs a handler task under performance measurement (fixed logger/level/description). */
-    measure(opts) {
-        return (0, core_1.executeWithPerformanceMeasure)({
-            logger: this.logger,
-            level: 'debug',
-            scope: opts.scope,
-            description: `execute ${opts.scope}`,
-            args: opts.args,
-            task: opts.task,
-        });
-    }
-    /** Returns the full `{ count, data }` envelope, or just `data` when the client sent `x-request-count: false`; `X-Response-Count` is set either way. */
-    normalizeCountData(opts) {
-        const { context, payload } = opts;
-        const requestCountData = context.req.header(common_1.HTTP.Headers.REQUEST_COUNT_DATA) ?? 'true';
-        const useCountData = (0, core_1.toBoolean)(requestCountData);
-        context.header(common_1.HTTP.Headers.RESPONSE_COUNT_DATA, payload.count.toString());
-        if (useCountData) {
-            return payload;
-        }
-        return payload.data;
-    }
-    /** `x-request-extra`, parsed: `name`, `-name` (a default switched off) and `name(key,key)`. */
-    getRequestedExtras(opts) {
-        return extras_1.ResponseExtras.parse({ header: opts.context.req.header(common_1.HTTP.Headers.REQUEST_EXTRA) });
-    }
-    respond(opts) {
-        const { context, format, payload, range, extra } = opts;
-        if (range) {
-            context.header(common_1.HTTP.Headers.CONTENT_RANGE, (0, exports.toContentRange)({ range, count: payload.count }));
-        }
-        context.header(common_1.HTTP.Headers.RESPONSE_FORMAT, format);
-        if (!extra) {
-            return this.normalizeCountData({ context, payload });
-        }
-        return this.respondWithExtra({ context, payload, extra });
-    }
-    /** The `extra` half of `respond`: resolves what was asked against what is offered, runs it in parallel. */
-    async respondWithExtra(opts) {
-        const { context, payload, extra } = opts;
-        const plan = extras_1.ResponseExtras.resolve({
-            requested: this.getRequestedExtras({ context }),
-            offered: extra,
-        });
-        if (plan.size === 0) {
-            return this.normalizeCountData({ context, payload });
-        }
-        const computed = await extras_1.ResponseExtras.compute({ plan, offered: extra });
-        // Rows still counted in the header; the body is an object, since an array cannot carry extras.
-        // `x-response-extra` marks it, so a client unwraps `{ data, extra }` only when the server says so.
-        context.header(common_1.HTTP.Headers.RESPONSE_COUNT_DATA, payload.count.toString());
-        context.header(common_1.HTTP.Headers.RESPONSE_EXTRA, Object.keys(computed).join(','));
-        const useCountData = (0, core_1.toBoolean)(context.req.header(common_1.HTTP.Headers.REQUEST_COUNT_DATA) ?? 'true');
-        return useCountData
-            ? { count: payload.count, data: payload.data, extra: computed }
-            : { data: payload.data, extra: computed };
-    }
-    /** The list headers without the body, for a list whose body is not a `{ count, data }` envelope: `Content-Range`, `X-Response-Count` = rows in THIS response, `X-Response-Format: array`. Pass a `range`, or `offset` + `total` for an engine that reports those (a search page): the range is derived with the same inclusive-end rule. */
-    setListHeaders(opts) {
-        const { context, count } = opts;
-        const range = 'range' in opts
-            ? opts.range
-            : (0, types_1.buildDataRange)({ offset: opts.offset, dataLength: count, total: opts.total });
-        context.header(common_1.HTTP.Headers.CONTENT_RANGE, (0, exports.toContentRange)({ range, count }));
-        context.header(common_1.HTTP.Headers.RESPONSE_COUNT_DATA, count.toString());
-        context.header(common_1.HTTP.Headers.RESPONSE_FORMAT, constants_1.ResponseFormats.ARRAY);
-    }
-    /** TRouteHandler's TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures) built on Hono's real Context, not a subtype of the RouteHandler `.openapi()` expects - genuinely different handler types bridged here. */
-    toHonoHandler(opts) {
-        return opts.handler;
-    }
-    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
-    bindRoute(opts) {
-        const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
-        return {
-            configs: routeConfigs,
-            to: ({ handler }) => {
-                return {
-                    configs: routeConfigs,
-                    route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler })),
-                };
-            },
-        };
-    }
-    /** Defines and registers a route with its handler in a single call. */
-    defineRoute(opts) {
-        const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
-        return {
-            configs: routeConfigs,
-            route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler: opts.handler }), opts.hook),
-        };
-    }
-    /** Defines a JSX route that renders server-side HTML via c.html(). */
-    defineJSXRoute(opts) {
-        const routeConfigs = this.getJSXRouteConfigs({ configs: opts.configs });
-        return {
-            configs: routeConfigs,
-            route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler: opts.handler }), opts.hook),
-        };
-    }
-}
-exports.BaseRestController = BaseRestController;
-//# sourceMappingURL=base.js.map