@venizia/ignis-kernel 0.2.0-0

package/dist/cjs/base/controllers/common/types.d.ts

@@ -0,0 +1,174 @@
+import type { AbstractEntity } from '../../../base/models';
+import type { TAuthMode, TAuthStrategy } from '../../../base/auth/authenticate/common/constants';
+import type { IAuthorizationSpec } from '../../../base/auth/authorize/common/types';
+import type { TAnyObjectSchema } from '../../../utilities/schema.utility';
+import type { RouteConfig as HonoRouteConfig } from '@hono/zod-openapi';
+import type { createRoute, Hook, OpenAPIHono, z } from '@hono/zod-openapi';
+import type { AnyType, IConfigurable, TClass, TResolver, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { TypedResponse } from 'hono';
+import type { Context, Env, Schema } from 'hono';
+import type { ContentfulStatusCode, StatusCode } from 'hono/utils/http-status';
+/** Typed validation results for route handlers. */
+export interface IValidRequestProps<JsonType = unknown, QueryType = unknown, ParamType = unknown, HeaderType = unknown, CookieType = unknown, FormType = unknown> {
+    json?: JsonType;
+    query?: QueryType;
+    param?: ParamType;
+    header?: HeaderType;
+    cookie?: CookieType;
+    form?: FormType;
+}
+export type TJsonResponse<ResponseBody = unknown, ResponseStatusCode extends StatusCode = StatusCode> = Response & TypedResponse<ResponseBody, ResponseStatusCode, 'json'>;
+/** Polymorphic response body for endpoints honoring the `x-request-count-data` header - the count-wrapped `{ count, data }` or the raw payload; pass the unwrapped payload type as `T`. */
+export type TCountResponse<TData = unknown> = TData | {
+    count: number;
+    data: TData;
+};
+/** Lightweight typed context that bypasses RouteHandler inference. */
+export type TContext<RouteEnv extends Env = Env, ValidTargetKey extends string = string, ResponseBody = unknown> = Omit<Context<RouteEnv>, 'req' | 'json'> & {
+    req: Omit<Context<RouteEnv>['req'], 'valid'> & {
+        valid<T = unknown>(target: ValidTargetKey): T;
+    };
+    json<TStatusCode extends ContentfulStatusCode = 200>(body: ResponseBody, status?: TStatusCode): TJsonResponse<ResponseBody, TStatusCode>;
+};
+export type TRouteContext<RouteEnv extends Env = Env, ResponseBody = unknown> = TContext<RouteEnv, keyof IValidRequestProps, ResponseBody>;
+/** Casts middleware context to TContext (safe -- structurally identical to Context). */
+export declare const asTypedContext: <E extends Env>(context: unknown) => TContext<E, string>;
+/** Lightweight handler type using TTypedContext to avoid heavy RouteHandler inference. */
+export type TRouteHandler<ResponseType = unknown, RouteEnv extends Env = Env> = (context: TRouteContext<RouteEnv, ResponseType>) => ValueOrPromise<Response | TypedResponse<ResponseType>>;
+/** Registered route with its configuration and router instance. */
+export interface IDefineRouteOptions<RouteConfig extends HonoRouteConfig, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/'> {
+    configs: ReturnType<typeof createRoute<string, RouteConfig>>;
+    route: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+}
+/** Fluent binding for two-step route registration: bindRoute({ configs }).to({ handler }). */
+export interface IBindRouteOptions<RouteConfig extends HonoRouteConfig, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/'> {
+    configs: RouteConfig;
+    to: <ResponseType = unknown>(opts: {
+        handler: TRouteHandler<ResponseType, RouteEnv>;
+    }) => IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+}
+/** Route configuration extended with optional authenticate and authorize fields. */
+export interface IAuthRouteConfig extends HonoRouteConfig {
+    authenticate?: {
+        strategies?: TAuthStrategy[];
+        mode?: TAuthMode;
+    };
+    authorize?: IAuthorizationSpec | IAuthorizationSpec[];
+}
+/** Base controller interface defining route registration and configuration contract. */
+export interface IController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}> extends IConfigurable<ConfigurableOptions, OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {
+    router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+    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>;
+}
+/** Configuration options for controller instantiation. */
+export interface IControllerOptions {
+    scope: string;
+    /** Falls back to @controller decorator path if not provided. */
+    path?: string;
+    /** When true (default), /users and /users/ are different routes. */
+    isStrict?: boolean;
+}
+/** Per-route authentication config: { skip: true } or { strategies, mode }. */
+export type TRouteAuthenticateConfig = {
+    skip: true;
+} | {
+    skip?: false;
+    strategies?: TAuthStrategy[];
+    mode?: TAuthMode;
+};
+/** Per-route authorization config: { skip: true }, single spec, or array of specs. */
+export type TRouteAuthorizeConfig = {
+    skip: true;
+} | IAuthorizationSpec | IAuthorizationSpec[];
+/** Per-route auth config. Endpoint config takes precedence over controller-level config. */
+export type TRouteAuthConfig = {
+    authenticate?: TRouteAuthenticateConfig;
+    authorize?: TRouteAuthorizeConfig;
+};
+/** OpenAPI response header object */
+export type TResponseHeaderObject = {
+    description?: string;
+    schema: {
+        type: 'string';
+        examples?: string[];
+    };
+};
+/** OpenAPI response headers format */
+export type TResponseHeaders = Record<string, TResponseHeaderObject>;
+type TInferDistributive<S> = S extends z.ZodType ? z.infer<S> : never;
+export type TResponseBodyOf<R extends {
+    responses: AnyType;
+}> = TInferDistributive<R['responses'][keyof R['responses']]['content']['application/json']['schema']>;
+export type TCustomizableRouteConfig = TRouteAuthConfig & {
+    /** Whether this route is registered. Defaults to true. */
+    enabled?: boolean;
+    request?: {
+        params?: TAnyObjectSchema;
+        query?: TAnyObjectSchema;
+        body?: TAnyObjectSchema;
+        headers?: TAnyObjectSchema;
+    };
+    response?: {
+        schema?: z.ZodTypeAny;
+        headers?: TResponseHeaders;
+    };
+};
+/** Per-route configuration for CRUD controller endpoints (auth, request, response). */
+export interface ICustomizableRoutes<RouteConfig extends TCustomizableRouteConfig = TCustomizableRouteConfig> {
+    count?: RouteConfig;
+    find?: RouteConfig;
+    findById?: RouteConfig;
+    findOne?: RouteConfig;
+    create?: RouteConfig;
+    updateById?: RouteConfig;
+    updateBy?: RouteConfig;
+    deleteById?: RouteConfig;
+    deleteBy?: RouteConfig;
+}
+/** Read object inferred from an entity's engine-neutral `$inferData` phantom marker - each family fills it with its own type, so the base layer needs no connector import; falls back to `object`. */
+export type TEntityDataObject<TEntity> = TEntity extends {
+    $inferData?: infer TData;
+} ? TData extends object ? TData : object : object;
+/** Persist object inferred from an entity's engine-neutral `$inferPersist` phantom marker - same contract and `object` fallback as {@link TEntityDataObject}. */
+export type TEntityPersistObject<TEntity> = TEntity extends {
+    $inferPersist?: infer TPersist;
+} ? TPersist extends object ? TPersist : object : object;
+/** Configuration options for creating a CRUD controller via ControllerFactory.defineCrudController. */
+export interface ICrudControllerOptions<TEntity extends AbstractEntity = AbstractEntity, Routes extends ICustomizableRoutes = ICustomizableRoutes> {
+    /** Entity class or resolver returning it - its schema drives the inferred DataObject/PersistObject types of the generated controller's `repository`. */
+    entity: TClass<TEntity> | TResolver<TClass<TEntity>>;
+    /** Repository binding configuration */
+    repository: {
+        name: string;
+    };
+    controller: {
+        name: string;
+        basePath: string;
+        readonly?: boolean;
+        /** Whitelist of routes to register; overrides per-route `enabled` flags in `routes` when set. */
+        enabledRoutes?: Array<keyof ICustomizableRoutes>;
+        isStrict?: {
+            path?: boolean;
+            requestSchema?: boolean;
+        };
+    };
+    /** Authentication config applied to all routes (unless overridden per-route). */
+    authenticate?: {
+        strategies?: TAuthStrategy[];
+        mode?: TAuthMode;
+    };
+    /** Authorization config applied to all routes (unless overridden per-route). */
+    authorize?: IAuthorizationSpec | IAuthorizationSpec[];
+    /** Per-route configuration combining schema and auth overrides. */
+    routes?: Routes;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/base/controllers/common/types.d.ts.map

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

package/dist/cjs/base/controllers/common/types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asTypedContext = void 0;
+/** Casts middleware context to TContext (safe -- structurally identical to Context). */
+const asTypedContext = (context) => {
+    return context;
+};
+exports.asTypedContext = asTypedContext;
+//# sourceMappingURL=types.js.map

package/dist/cjs/base/controllers/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/types.ts"],"names":[],"mappings":";;;AA6DA,wFAAwF;AACjF,MAAM,cAAc,GAAG,CAAgB,OAAgB,EAAuB,EAAE;IACrF,OAAO,OAA8B,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB"}

package/dist/cjs/base/controllers/factory/controller.d.ts

@@ -0,0 +1,125 @@
+import type { AbstractEntity } from '../../../base/models';
+import type { AbstractRepository } from '../../../base/repositories';
+import type { TAnyObjectSchema } from '../../../utilities/schema.utility';
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { Env, Schema } from 'hono';
+import type { ICrudControllerOptions, ICustomizableRoutes, TEntityDataObject, TEntityPersistObject } from '../common';
+/** Factory for generating typed CRUD controllers from entity definitions. */
+export declare class ControllerFactory extends BaseHelper {
+    constructor();
+    static defineCrudController<TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>, Routes extends ICustomizableRoutes = ICustomizableRoutes, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, TDataObject extends object = TEntityDataObject<TEntity>, TPersistObject extends object = TEntityPersistObject<TEntity>>(defOpts: ICrudControllerOptions<TEntity, Routes>): {
+        new (repository: AbstractRepository<TDataObject, TPersistObject>): {
+            /** Registers each CRUD route whose handler tier supplies it, honoring enabledRoutes/readonly. */
+            binding(): ValueOrPromise<void>;
+            create(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 201>>;
+            updateById(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
+            updateBy(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 400> | import("../common").TJsonResponse<unknown, 200>>;
+            deleteById(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
+            deleteBy(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 400> | import("../common").TJsonResponse<unknown, 200>>;
+            count(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
+            find(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
+            findById(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
+            findOne(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
+            repository: AbstractRepository<TDataObject, TPersistObject, import("../../../base/repositories").IExtraOptions>;
+            normalizeCountData<ResponseSchema extends unknown, RequestContext extends import("../common").TRouteContext<RouteEnv> = import("../common").TRouteContext<RouteEnv>, ResponseData extends {
+                count: number;
+                data?: import("@venizia/ignis-helpers/common").TNullable<ResponseSchema>;
+            } = {
+                count: number;
+                data?: import("@venizia/ignis-helpers/common").TNullable<ResponseSchema>;
+            }>(opts: {
+                context: RequestContext;
+                responseData: ResponseData;
+            }): ResponseData | import("@venizia/ignis-helpers/common").TNullable<ResponseSchema>;
+            respond<R>(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+                format: "object" | "array";
+                responseData: {
+                    count: number;
+                    data?: import("@venizia/ignis-helpers/common").TNullable<R>;
+                };
+            }): import("@venizia/ignis-helpers/common").TNullable<R> | {
+                count: number;
+                data?: import("@venizia/ignis-helpers/common").TNullable<R>;
+            };
+            bulkWhereError(opts: {
+                context: import("../common").TRouteContext<RouteEnv>;
+                where?: object;
+            }): import("../common").TJsonResponse<unknown, 400> | undefined;
+            measure<R>(opts: {
+                scope: string;
+                args: unknown;
+                task: () => Promise<R>;
+            }): Promise<any>;
+            toHonoHandler<ResponseType = unknown>(opts: {
+                handler: import("../common").TRouteHandler<ResponseType, RouteEnv>;
+            }): import("hono").Handler<RouteEnv, string, import("hono").Input, (Response | Promise<Response>) | (import("@hono/zod-openapi").RouteConfigToTypedResponse<import("@hono/zod-openapi").RouteConfig> | Promise<import("@hono/zod-openapi").RouteConfigToTypedResponse<import("@hono/zod-openapi").RouteConfig>>)>;
+            bindRoute<RouteConfig extends import("../common").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): import("../common").IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+            defineRoute<RouteConfig extends import("../common").IAuthRouteConfig, ResponseType = unknown>(opts: {
+                configs: RouteConfig;
+                handler: import("../common").TRouteHandler<ResponseType, RouteEnv>;
+                hook?: import("@hono/zod-openapi").Hook<any, RouteEnv, string, any> | undefined;
+            }): import("../common").IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+            defineJSXRoute<RouteConfig extends import("../common").IAuthRouteConfig, ResponseType = unknown>(opts: {
+                configs: RouteConfig;
+                handler: import("../common").TRouteHandler<ResponseType, RouteEnv>;
+                hook?: import("@hono/zod-openapi").Hook<any, RouteEnv, string, any> | undefined;
+            }): import("../common").IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+            isConfigured: boolean;
+            router: import("@hono/zod-openapi").OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+            path: string;
+            definitions: Record<string, import("../common").IAuthRouteConfig>;
+            getRouter(): import("@hono/zod-openapi").OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+            registerRoutesFromRegistry(opts?: {
+                paths? /** Registers each CRUD route whose handler tier supplies it, honoring enabledRoutes/readonly. */: "static" | "param" | "all";
+            }): void;
+            configure(opts?: ConfigurableOptions | undefined): Promise<import("@hono/zod-openapi").OpenAPIHono<RouteEnv, RouteSchema, BasePath>>;
+            buildRouteMiddlewares<RouteConfig extends import("../common").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): {
+                restConfig: Omit<RouteConfig, "authenticate" | "authorize">;
+                security: {
+                    [x: string]: never[];
+                }[];
+                mws: import("hono").MiddlewareHandler<Env>[];
+            };
+            getRouteConfigs<RouteConfig extends import("../common").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): RouteConfig & {
+                getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${/*elided*/ any}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : T : never : never;
+            };
+            getJSXRouteConfigs<RouteConfig extends import("../common").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): RouteConfig & {
+                getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${Tail extends `${infer Head}/{${infer Param}}${infer Tail}` ? `${Head}/:${Param}${/*elided*/ any}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : Tail}` : T : never : never;
+            };
+            scope: string;
+            identifier: string;
+            logger: import("@venizia/ignis-helpers/core").ILogger;
+            getIdentifier(): string;
+            getLogger(): import("@venizia/ignis-helpers/core").ILogger;
+        };
+    };
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/cjs/base/controllers/factory/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,WAAW,CAAC;AAInB,6EAA6E;AAC7E,qBAAa,iBAAkB,SAAQ,UAAU;;IAK/C,MAAM,CAAC,oBAAoB,CACzB,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,MAAM,SAAS,mBAAmB,GAAG,mBAAmB,EACxD,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,GAAG,iBAAiB,CAAC,OAAO,CAAC,EACvD,cAAc,SAAS,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,EAC7D,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC;yBAuCtB,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC;YAUvE,iGAAiG;uBAC7E,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAAxC,CADH,CAAG,iGAAiG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFtG"}

package/dist/cjs/base/controllers/factory/controller.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControllerFactory = void 0;
+const constants_1 = require("../../../base/models/common/constants");
+const core_1 = require("@venizia/ignis-helpers/core");
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
+const crud_1 = require("./crud");
+const definition_1 = require("./definition");
+/** Factory for generating typed CRUD controllers from entity definitions. */
+class ControllerFactory extends core_1.BaseHelper {
+    constructor() {
+        super({ scope: ControllerFactory.name });
+    }
+    static defineCrudController(defOpts) {
+        const { controller, entity, authenticate, authorize, routes } = defOpts;
+        const { name, basePath = 'unknown_path', isStrict = { path: true, requestSchema: true }, } = controller;
+        if (!basePath || basePath === 'unknown_path') {
+            throw (0, core_1.getError)({
+                message: `[defineCrudController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,
+            });
+        }
+        const entityClass = (0, ignis_inversion_1.isClass)(entity) ? entity : entity();
+        const entityInstance = new entityClass();
+        const routeDefinitions = (0, definition_1.defineControllerRouteConfigs)({
+            isStrict: isStrict.requestSchema ?? true,
+            idType: entityInstance.getIdType(),
+            authenticate,
+            authorize,
+            routes,
+            schema: {
+                select: entityInstance.getSchema({ type: constants_1.SchemaTypes.SELECT }),
+                create: entityInstance.getSchema({ type: constants_1.SchemaTypes.CREATE }),
+                update: entityInstance.getSchema({ type: constants_1.SchemaTypes.UPDATE }),
+            },
+        });
+        const controllerClass = class extends crud_1.PersistableCrudController {
+            constructor(repository) {
+                super({
+                    scope: name,
+                    path: basePath,
+                    isStrict: isStrict.path ?? true,
+                    repository,
+                    definitions: routeDefinitions,
+                });
+            }
+            /** Registers each CRUD route whose handler tier supplies it, honoring enabledRoutes/readonly. */
+            binding() {
+                const isEnabled = (routeKey) => {
+                    if (controller.enabledRoutes) {
+                        return controller.enabledRoutes.includes(routeKey);
+                    }
+                    return routes?.[routeKey]?.enabled !== false;
+                };
+                // Read routes - always registered (unless explicitly disabled)
+                if (isEnabled('count')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.COUNT,
+                        handler: async (context) => this.count({ context }),
+                    });
+                }
+                if (isEnabled('find')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.FIND,
+                        handler: async (context) => this.find({ context }),
+                    });
+                }
+                if (isEnabled('findOne')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.FIND_ONE,
+                        handler: async (context) => this.findOne({ context }),
+                    });
+                }
+                if (isEnabled('findById')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.FIND_BY_ID,
+                        handler: async (context) => this.findById({ context }),
+                    });
+                }
+                // Write routes - skipped when readonly
+                if (controller.readonly) {
+                    return;
+                }
+                if (isEnabled('create')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.CREATE,
+                        handler: async (context) => this.create({ context }),
+                    });
+                }
+                if (isEnabled('updateById')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.UPDATE_BY_ID,
+                        handler: async (context) => this.updateById({ context }),
+                    });
+                }
+                if (isEnabled('updateBy')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.UPDATE_BY,
+                        handler: async (context) => this.updateBy({ context }),
+                    });
+                }
+                if (isEnabled('deleteById')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.DELETE_BY_ID,
+                        handler: async (context) => this.deleteById({ context }),
+                    });
+                }
+                if (isEnabled('deleteBy')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.DELETE_BY,
+                        handler: async (context) => this.deleteBy({ context }),
+                    });
+                }
+            }
+        };
+        Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });
+        return controllerClass;
+    }
+}
+exports.ControllerFactory = ControllerFactory;
+//# sourceMappingURL=controller.js.map

package/dist/cjs/base/controllers/factory/controller.js.map

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

package/dist/cjs/base/controllers/factory/crud/abstract.d.ts

@@ -0,0 +1,47 @@
+import type { AbstractEntity } from '../../../../base/models/base';
+import type { AbstractRepository } from '../../../../base/repositories';
+import type { TAnyObjectSchema } from '../../../../utilities/schema.utility';
+import type { AnyType, TNullable } from '@venizia/ignis-helpers/common';
+import type { Env, Schema } from 'hono';
+import type { TEntityDataObject, TEntityPersistObject, TRouteContext } from '../../common';
+import { BaseRestController } from '../../rest/base';
+/** Base tier of a generated CRUD controller - repository handle plus shared response helpers; read and write verbs are layered on by ReadableCrudController / PersistableCrudController. */
+export declare abstract class AbstractCrudController<TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, TDataObject extends object = TEntityDataObject<TEntity>, TPersistObject extends object = TEntityPersistObject<TEntity>> extends BaseRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
+    repository: AbstractRepository<TDataObject, TPersistObject>;
+    constructor(opts: {
+        scope: string;
+        path: string;
+        isStrict?: boolean;
+        repository: AbstractRepository<TDataObject, TPersistObject>;
+        definitions: AnyType;
+    });
+    /** Returns the full `{ count, data }` envelope or just `data`, per the x-request-count header. */
+    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;
+        responseData: ResponseData;
+    }): TNullable<ResponseSchema> | ResponseData;
+    /** Sets the response-format header, then normalizes count/data per the request-count header. */
+    respond<R>(opts: {
+        context: TRouteContext<RouteEnv>;
+        format: 'object' | 'array';
+        responseData: {
+            count: number;
+            data?: TNullable<R>;
+        };
+    }): TNullable<R> | {
+        count: number;
+        data?: TNullable<R>;
+    };
+    /** 400 when a bulk operation is missing its `where` filter; undefined when it is present. */
+    bulkWhereError(opts: {
+        context: TRouteContext<RouteEnv>;
+        where?: object;
+    }): import("../../common").TJsonResponse<unknown, 400> | undefined;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/cjs/base/controllers/factory/crud/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../../src/base/controllers/factory/crud/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,4LAA4L;AAC5L,8BAAsB,sBAAsB,CAC1C,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,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,GAAG,iBAAiB,CAAC,OAAO,CAAC,EACvD,cAAc,SAAS,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAC7D,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAChF,UAAU,EAAE,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBAEhD,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAC5D,WAAW,EAAE,OAAO,CAAC;KACtB;IAMD,kGAAkG;IAClG,kBAAkB,CAChB,cAAc,SAAS,OAAO,EAC9B,cAAc,SAAS,aAAa,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,EACxE,YAAY,SAAS;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;KAClC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAA;KAAE,EACvD,IAAI,EAAE;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE;IAc/D,gGAAgG;IAChG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE;QACf,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;QAC3B,YAAY,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;SAAE,CAAC;KACtD;eApBc,MAAM;;;IA4BrB,6FAA6F;IAC7F,cAAc,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAU1E"}

package/dist/cjs/base/controllers/factory/crud/abstract.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractCrudController = void 0;
+const common_1 = require("@venizia/ignis-helpers/common");
+const core_1 = require("@venizia/ignis-helpers/core");
+const base_1 = require("../../rest/base");
+/** Base tier of a generated CRUD controller - repository handle plus shared response helpers; read and write verbs are layered on by ReadableCrudController / PersistableCrudController. */
+class AbstractCrudController extends base_1.BaseRestController {
+    constructor(opts) {
+        super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });
+        this.repository = opts.repository;
+        this.definitions = opts.definitions;
+    }
+    /** Returns the full `{ count, data }` envelope or just `data`, per the x-request-count header. */
+    normalizeCountData(opts) {
+        const { context, responseData } = 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, responseData.count.toString());
+        if (useCountData) {
+            return responseData;
+        }
+        return responseData.data;
+    }
+    /** Sets the response-format header, then normalizes count/data per the request-count header. */
+    respond(opts) {
+        opts.context.header(common_1.HTTP.Headers.RESPONSE_FORMAT, opts.format);
+        return this.normalizeCountData({
+            context: opts.context,
+            responseData: opts.responseData,
+        });
+    }
+    /** 400 when a bulk operation is missing its `where` filter; undefined when it is present. */
+    bulkWhereError(opts) {
+        const { context, where } = opts;
+        if (!where || Object.keys(where).length === 0) {
+            return context.json({ message: 'where filter is required for bulk operations' }, common_1.HTTP.ResultCodes.RS_4.BadRequest);
+        }
+        return undefined;
+    }
+}
+exports.AbstractCrudController = AbstractCrudController;
+//# sourceMappingURL=abstract.js.map

package/dist/cjs/base/controllers/factory/crud/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/factory/crud/abstract.ts"],"names":[],"mappings":";;;AAIA,0DAAqD;AACrD,sDAAwD;AAGxD,0CAAqD;AAErD,4LAA4L;AAC5L,MAAsB,sBAQpB,SAAQ,yBAAwE;IAGhF,YAAY,IAMX;QACC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED,kGAAkG;IAClG,kBAAkB,CAOhB,IAA6D;QAC7D,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC;QACvF,MAAM,YAAY,GAAG,IAAA,gBAAS,EAAC,gBAAgB,CAAC,CAAC;QAEjD,OAAO,CAAC,MAAM,CAAC,aAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhF,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,OAAO,YAAY,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,gGAAgG;IAChG,OAAO,CAAI,IAIV;QACC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAI,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,kBAAkB,CAAI;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;IAED,6FAA6F;IAC7F,cAAc,CAAC,IAA0D;QACvE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC,IAAI,CACjB,EAAE,OAAO,EAAE,8CAA8C,EAAE,EAC3D,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CACjC,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AArED,wDAqEC"}

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

@@ -0,0 +1,4 @@
+export * from './abstract';
+export * from './persistable';
+export * from './readable';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/base/controllers/factory/crud/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,20 @@
+"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("./abstract"), exports);
+__exportStar(require("./persistable"), exports);
+__exportStar(require("./readable"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/factory/crud/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,6CAA2B"}