@venizia/ignis-kernel 0.2.0-0

package/dist/esm/base/controllers/common/constants.js

@@ -0,0 +1,64 @@
+import { z } from '@hono/zod-openapi';
+import { HTTP } from '@venizia/ignis-helpers/common';
+/** Transport protocol constants for controllers. */
+export class ControllerTransports {
+    static { this.REST = 'rest'; }
+    static { this.GRPC = 'grpc'; }
+}
+/** Standard REST API path constants for CRUD controllers. */
+export class RestPaths {
+    static { this.ROOT = '/'; }
+    static { this.COUNT = '/count'; }
+    static { this.FIND_ONE = '/find-one'; }
+}
+export const trackableHeaders = z.object({
+    [HTTP.Headers.REQUEST_TRACING_ID]: z.string().optional().openapi({
+        description: 'Optional request ID',
+    }),
+    [HTTP.Headers.REQUEST_CHANNEL]: z
+        .string()
+        .optional()
+        .openapi({
+        description: 'Optional request channel',
+        examples: ['channel-1', 'web', 'spos'],
+    }),
+    [HTTP.Headers.REQUEST_DEVICE_INFO]: z
+        .string()
+        .optional()
+        .openapi({
+        description: 'Optional request device info',
+        examples: ['dev-1', 'device-abc', 'd-unique-id'],
+    }),
+});
+export const countableHeaders = z.object({
+    [HTTP.Headers.REQUEST_COUNT_DATA]: z
+        .string()
+        .optional()
+        .openapi({
+        description: 'Controls response format. When "true" (default): returns {count, data}. When "false": returns data only.',
+        examples: ['true', '1', 'false', '0'],
+    }),
+});
+export const defaultRequestHeaders = trackableHeaders.extend(countableHeaders.shape);
+export const commonResponseHeaders = {
+    [HTTP.Headers.REQUEST_TRACING_ID]: {
+        description: 'Echo of the request tracing ID',
+        schema: { type: 'string' },
+    },
+    [HTTP.Headers.RESPONSE_COUNT_DATA]: {
+        description: 'Number of records in response',
+        schema: { type: 'string', examples: ['1', '10', '100'] },
+    },
+    [HTTP.Headers.RESPONSE_FORMAT]: {
+        description: 'Response format indicator',
+        schema: { type: 'string', examples: ['array', 'object'] },
+    },
+};
+export const findResponseHeaders = {
+    ...commonResponseHeaders,
+    [HTTP.Headers.CONTENT_RANGE]: {
+        description: 'Content range for pagination (e.g., "records 0-24/100")',
+        schema: { type: 'string', examples: ['records 0-24/100', 'records 25-49/100'] },
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/esm/base/controllers/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAGrD,oDAAoD;AACpD,MAAM,OAAO,oBAAoB;aACf,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;;AAKhC,6DAA6D;AAC7D,MAAM,OAAO,SAAS;aACJ,SAAI,GAAG,GAAG,CAAC;aACX,UAAK,GAAG,QAAQ,CAAC;aACjB,aAAQ,GAAG,WAAW,CAAC;;AAGzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;QAC/D,WAAW,EAAE,qBAAqB;KACnC,CAAC;IACF,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;SAC9B,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EAAE,0BAA0B;QACvC,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC;KACvC,CAAC;IACJ,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;SAClC,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC;KACjD,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;SACjC,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EACT,0GAA0G;QAC5G,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC;KACtC,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE;QACjC,WAAW,EAAE,gCAAgC;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;IACD,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;QAClC,WAAW,EAAE,+BAA+B;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE;KACzD;IACD,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;QAC9B,WAAW,EAAE,2BAA2B;QACxC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;KAC1D;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,GAAG,qBAAqB;IACxB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QAC5B,WAAW,EAAE,yDAAyD;QACtE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EAAE;KAChF;CACF,CAAC"}

package/dist/esm/base/controllers/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/controllers/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/esm/base/controllers/common/index.js

@@ -0,0 +1,3 @@
+export * from './constants.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/controllers/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,174 @@
+import type { AbstractEntity } from '../../../base/models/index.js';
+import type { TAuthMode, TAuthStrategy } from '../../../base/auth/authenticate/common/constants.js';
+import type { IAuthorizationSpec } from '../../../base/auth/authorize/common/types.js';
+import type { TAnyObjectSchema } from '../../../utilities/schema.utility.js';
+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/esm/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/esm/base/controllers/common/types.js

@@ -0,0 +1,5 @@
+/** Casts middleware context to TContext (safe -- structurally identical to Context). */
+export const asTypedContext = (context) => {
+    return context;
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/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;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAgB,OAAgB,EAAuB,EAAE;IACrF,OAAO,OAA8B,CAAC;AACxC,CAAC,CAAC"}

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

@@ -0,0 +1,125 @@
+import type { AbstractEntity } from '../../../base/models/index.js';
+import type { AbstractRepository } from '../../../base/repositories/index.js';
+import type { TAnyObjectSchema } from '../../../utilities/schema.utility.js';
+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/index.js';
+/** 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("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 201>>;
+            updateById(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 200>>;
+            updateBy(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 400> | import("../index.js").TJsonResponse<unknown, 200>>;
+            deleteById(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 200>>;
+            deleteBy(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 400> | import("../index.js").TJsonResponse<unknown, 200>>;
+            count(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 200>>;
+            find(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 200>>;
+            findById(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 200>>;
+            findOne(opts: {
+                context: import("../index.js").TRouteContext<RouteEnv>;
+            }): Promise<import("../index.js").TJsonResponse<unknown, 200>>;
+            repository: AbstractRepository<TDataObject, TPersistObject, import("../../../base/repositories/index.js").IExtraOptions>;
+            normalizeCountData<ResponseSchema extends unknown, RequestContext extends import("../index.js").TRouteContext<RouteEnv> = import("../index.js").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("../index.js").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("../index.js").TRouteContext<RouteEnv>;
+                where?: object;
+            }): import("../index.js").TJsonResponse<unknown, 400> | undefined;
+            measure<R>(opts: {
+                scope: string;
+                args: unknown;
+                task: () => Promise<R>;
+            }): Promise<any>;
+            toHonoHandler<ResponseType = unknown>(opts: {
+                handler: import("../index.js").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("../index.js").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): import("../index.js").IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+            defineRoute<RouteConfig extends import("../index.js").IAuthRouteConfig, ResponseType = unknown>(opts: {
+                configs: RouteConfig;
+                handler: import("../index.js").TRouteHandler<ResponseType, RouteEnv>;
+                hook?: import("@hono/zod-openapi").Hook<any, RouteEnv, string, any> | undefined;
+            }): import("../index.js").IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+            defineJSXRoute<RouteConfig extends import("../index.js").IAuthRouteConfig, ResponseType = unknown>(opts: {
+                configs: RouteConfig;
+                handler: import("../index.js").TRouteHandler<ResponseType, RouteEnv>;
+                hook?: import("@hono/zod-openapi").Hook<any, RouteEnv, string, any> | undefined;
+            }): import("../index.js").IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
+            isConfigured: boolean;
+            router: import("@hono/zod-openapi").OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
+            path: string;
+            definitions: Record<string, import("../index.js").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("../index.js").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): {
+                restConfig: Omit<RouteConfig, "authenticate" | "authorize">;
+                security: {
+                    [x: string]: never[];
+                }[];
+                mws: import("hono").MiddlewareHandler<Env>[];
+            };
+            getRouteConfigs<RouteConfig extends import("../index.js").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("../index.js").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/esm/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/esm/base/controllers/factory/controller.js

@@ -0,0 +1,116 @@
+import { SchemaTypes } from '../../../base/models/common/constants.js';
+import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
+import { isClass } from '@venizia/ignis-inversion';
+import { PersistableCrudController } from './crud/index.js';
+import { defineControllerRouteConfigs } from './definition.js';
+/** Factory for generating typed CRUD controllers from entity definitions. */
+export class ControllerFactory extends 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 getError({
+                message: `[defineCrudController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,
+            });
+        }
+        const entityClass = isClass(entity) ? entity : entity();
+        const entityInstance = new entityClass();
+        const routeDefinitions = defineControllerRouteConfigs({
+            isStrict: isStrict.requestSchema ?? true,
+            idType: entityInstance.getIdType(),
+            authenticate,
+            authorize,
+            routes,
+            schema: {
+                select: entityInstance.getSchema({ type: SchemaTypes.SELECT }),
+                create: entityInstance.getSchema({ type: SchemaTypes.CREATE }),
+                update: entityInstance.getSchema({ type: SchemaTypes.UPDATE }),
+            },
+        });
+        const controllerClass = class extends 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;
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/esm/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/esm/base/controllers/factory/crud/abstract.d.ts

@@ -0,0 +1,47 @@
+import type { AbstractEntity } from '../../../../base/models/base.js';
+import type { AbstractRepository } from '../../../../base/repositories/index.js';
+import type { TAnyObjectSchema } from '../../../../utilities/schema.utility.js';
+import type { AnyType, TNullable } from '@venizia/ignis-helpers/common';
+import type { Env, Schema } from 'hono';
+import type { TEntityDataObject, TEntityPersistObject, TRouteContext } from '../../common/index.js';
+import { BaseRestController } from '../../rest/base.js';
+/** 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("../../index.js").TJsonResponse<unknown, 400> | undefined;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/esm/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"}