@venizia/ignis-kernel 0.4.3 → 0.4.5

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

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE/E,mDAAmD;AACnD,MAAM,WAAW,kBAAkB,CACjC,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO,EACpB,QAAQ,GAAG,OAAO;IAElB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,CACvB,YAAY,GAAG,OAAO,EACtB,kBAAkB,SAAS,UAAU,GAAG,UAAU,IAChD,QAAQ,GAAG,aAAa,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAEvE,2LAA2L;AAC3L,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAErF,sEAAsE;AACtE,MAAM,MAAM,QAAQ,CAClB,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,cAAc,SAAS,MAAM,GAAG,MAAM,EACtC,YAAY,GAAG,OAAO,IACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG;IAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,CAAA;KAAE,CAAC;IACjG,IAAI,CAAC,WAAW,SAAS,oBAAoB,GAAG,GAAG,EACjD,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,GAAG,GAAG,GAAG,EAAE,YAAY,GAAG,OAAO,IAAI,QAAQ,CACtF,QAAQ,EACR,MAAM,kBAAkB,EACxB,YAAY,CACb,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,aAAa,CAAC,YAAY,GAAG,OAAO,EAAE,QAAQ,SAAS,GAAG,GAAG,GAAG,IAAI,CAC9E,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,KAC3C,cAAc,CAAC,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC"}

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

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=context.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/context.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport type { Context, Env, TypedResponse } from 'hono';\nimport type { ContentfulStatusCode, StatusCode } from 'hono/utils/http-status';\n\n/** Typed validation results for route handlers. */\nexport interface IValidRequestProps<\n  JsonType = unknown,\n  QueryType = unknown,\n  ParamType = unknown,\n  HeaderType = unknown,\n  CookieType = unknown,\n  FormType = unknown,\n> {\n  json?: JsonType;\n  query?: QueryType;\n  param?: ParamType;\n  header?: HeaderType;\n  cookie?: CookieType;\n  form?: FormType;\n}\n\nexport type TJsonResponse<\n  ResponseBody = unknown,\n  ResponseStatusCode extends StatusCode = StatusCode,\n> = Response & TypedResponse<ResponseBody, ResponseStatusCode, 'json'>;\n\n/** 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`. */\nexport type TCountResponse<TData = unknown> = TData | { count: number; data: TData };\n\n/** Lightweight typed context that bypasses RouteHandler inference. */\nexport type TContext<\n  RouteEnv extends Env = Env,\n  ValidTargetKey extends string = string,\n  ResponseBody = unknown,\n> = Omit<Context<RouteEnv>, 'req' | 'json'> & {\n  req: Omit<Context<RouteEnv>['req'], 'valid'> & { valid<T = unknown>(target: ValidTargetKey): T };\n  json<TStatusCode extends ContentfulStatusCode = 200>(\n    body: ResponseBody,\n    status?: TStatusCode,\n  ): TJsonResponse<ResponseBody, TStatusCode>;\n};\n\nexport type TRouteContext<RouteEnv extends Env = Env, ResponseBody = unknown> = TContext<\n  RouteEnv,\n  keyof IValidRequestProps,\n  ResponseBody\n>;\n\n/** Lightweight handler type using TTypedContext to avoid heavy RouteHandler inference. */\nexport type TRouteHandler<ResponseType = unknown, RouteEnv extends Env = Env> = (\n  context: TRouteContext<RouteEnv, ResponseType>,\n) => ValueOrPromise<Response | TypedResponse<ResponseType>>;\n"]}

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

@@ -1,67 +0,0 @@
-import type { AbstractEntity } from '../../../models';
-import type { TAuthMode, TAuthStrategy } from '../../../auth/authenticate/common/constants';
-import type { IAuthorizationSpec } from '../../../auth/authorize/common/types';
-import type { IConfigurable, TClass, TResolver, ValueOrPromise } from '@venizia/ignis-helpers/common';
-import type { Hook, OpenAPIHono } from '@hono/zod-openapi';
-import type { Env, Schema } from 'hono';
-import type { TRouteHandler } from './context';
-import type { IAuthRouteConfig, IBindRouteOptions, ICustomizableRoutes, IDefineRouteOptions } from './route';
-/** 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;
-}
-/** 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;
-}
-//# sourceMappingURL=controller.d.ts.map

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

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

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

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=controller.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/controller.ts"],"names":[],"mappings":"","sourcesContent":["import type { AbstractEntity } from '@/base/models';\nimport type { TAuthMode, TAuthStrategy } from '@/base/auth/authenticate/common/constants';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport type {\n  IConfigurable,\n  TClass,\n  TResolver,\n  ValueOrPromise,\n} from '@venizia/ignis-helpers/common';\nimport type { Hook, OpenAPIHono } from '@hono/zod-openapi';\nimport type { Env, Schema } from 'hono';\nimport type { TRouteHandler } from './context';\nimport type {\n  IAuthRouteConfig,\n  IBindRouteOptions,\n  ICustomizableRoutes,\n  IDefineRouteOptions,\n} from './route';\n\n/** Base controller interface defining route registration and configuration contract. */\nexport interface IController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ConfigurableOptions extends object = {},\n> extends IConfigurable<ConfigurableOptions, OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {\n  router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;\n\n  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  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\n/** Configuration options for controller instantiation. */\nexport interface IControllerOptions {\n  scope: string;\n  /** Falls back to @controller decorator path if not provided. */\n  path?: string;\n  /** When true (default), /users and /users/ are different routes. */\n  isStrict?: boolean;\n}\n\n/** 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`. */\nexport type TEntityDataObject<TEntity> = TEntity extends { $inferData?: infer TData }\n  ? TData extends object\n    ? TData\n    : object\n  : object;\n\n/** Persist object inferred from an entity's engine-neutral `$inferPersist` phantom marker - same contract and `object` fallback as {@link TEntityDataObject}. */\nexport type TEntityPersistObject<TEntity> = TEntity extends { $inferPersist?: infer TPersist }\n  ? TPersist extends object\n    ? TPersist\n    : object\n  : object;\n\n/** Configuration options for creating a CRUD controller via ControllerFactory.defineCrudController. */\nexport interface ICrudControllerOptions<\n  TEntity extends AbstractEntity = AbstractEntity,\n  Routes extends ICustomizableRoutes = ICustomizableRoutes,\n> {\n  /** Entity class or resolver returning it - its schema drives the inferred DataObject/PersistObject types of the generated controller's `repository`. */\n  entity: TClass<TEntity> | TResolver<TClass<TEntity>>;\n\n  /** Repository binding configuration */\n  repository: {\n    name: string; // Repository binding name in the IoC container\n  };\n\n  controller: {\n    name: string;\n    basePath: string;\n    readonly?: boolean;\n\n    /** Whitelist of routes to register; overrides per-route `enabled` flags in `routes` when set. */\n    enabledRoutes?: Array<keyof ICustomizableRoutes>;\n\n    isStrict?: {\n      path?: boolean;\n      requestSchema?: boolean;\n    };\n  };\n\n  /** Authentication config applied to all routes (unless overridden per-route). */\n  authenticate?: { strategies?: TAuthStrategy[]; mode?: TAuthMode };\n\n  /** Authorization config applied to all routes (unless overridden per-route). */\n  authorize?: IAuthorizationSpec | IAuthorizationSpec[];\n\n  /** Per-route configuration combining schema and auth overrides. */\n  routes?: Routes;\n}\n"]}

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

@@ -1,4 +0,0 @@
-export * from './context';
-export * from './controller';
-export * from './route';
-//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,+CAA6B;AAC7B,0CAAwB","sourcesContent":["export * from './context';\nexport * from './controller';\nexport * from './route';\n"]}

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

@@ -1,86 +0,0 @@
-import type { TAuthMode, TAuthStrategy } from '../../../auth/authenticate/common/constants';
-import type { IAuthorizationSpec } from '../../../auth/authorize/common/types';
-import type { TAnyObjectSchema } from '../schema-builders';
-import type { createRoute, RouteConfig as HonoRouteConfig, OpenAPIHono, z } from '@hono/zod-openapi';
-import type { AnyType } from '@venizia/ignis-helpers/common';
-import type { Env, Schema } from 'hono';
-import type { TRouteHandler } from './context';
-/** 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[];
-}
-/** 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.ZodType;
-        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;
-}
-export {};
-//# sourceMappingURL=route.d.ts.map

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

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

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

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=route.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/route.ts"],"names":[],"mappings":"","sourcesContent":["import type { TAuthMode, TAuthStrategy } from '@/base/auth/authenticate/common/constants';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport type { TAnyObjectSchema } from '@/base/controllers/common/schema-builders';\nimport type {\n  createRoute,\n  RouteConfig as HonoRouteConfig,\n  OpenAPIHono,\n  z,\n} from '@hono/zod-openapi';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport type { Env, Schema } from 'hono';\nimport type { TRouteHandler } from './context';\n\n/** Registered route with its configuration and router instance. */\nexport interface IDefineRouteOptions<\n  RouteConfig extends HonoRouteConfig,\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n> {\n  configs: ReturnType<typeof createRoute<string, RouteConfig>>;\n  route: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;\n}\n\n/** Fluent binding for two-step route registration: bindRoute({ configs }).to({ handler }). */\nexport interface IBindRouteOptions<\n  RouteConfig extends HonoRouteConfig,\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n> {\n  configs: RouteConfig;\n  to: <ResponseType = unknown>(opts: {\n    handler: TRouteHandler<ResponseType, RouteEnv>;\n  }) => IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n}\n\n/** Route configuration extended with optional authenticate and authorize fields. */\nexport interface IAuthRouteConfig extends HonoRouteConfig {\n  authenticate?: { strategies?: TAuthStrategy[]; mode?: TAuthMode };\n  authorize?: IAuthorizationSpec | IAuthorizationSpec[];\n}\n\n/** Per-route authentication config: { skip: true } or { strategies, mode }. */\nexport type TRouteAuthenticateConfig =\n  | { skip: true }\n  | { skip?: false; strategies?: TAuthStrategy[]; mode?: TAuthMode };\n\n/** Per-route authorization config: { skip: true }, single spec, or array of specs. */\nexport type TRouteAuthorizeConfig = { skip: true } | IAuthorizationSpec | IAuthorizationSpec[];\n\n/** Per-route auth config. Endpoint config takes precedence over controller-level config. */\nexport type TRouteAuthConfig = {\n  authenticate?: TRouteAuthenticateConfig;\n  authorize?: TRouteAuthorizeConfig;\n};\n\n/** OpenAPI response header object */\nexport type TResponseHeaderObject = {\n  description?: string;\n  schema: { type: 'string'; examples?: string[] };\n};\n\n/** OpenAPI response headers format */\nexport type TResponseHeaders = Record<string, TResponseHeaderObject>;\n\n// Response body types derived from route definitions; a distributive conditional applies z.infer to each schema of the union separately.\ntype TInferDistributive<S> = S extends z.ZodType ? z.infer<S> : never;\nexport type TResponseBodyOf<R extends { responses: AnyType }> = TInferDistributive<\n  R['responses'][keyof R['responses']]['content']['application/json']['schema']\n>;\n\nexport type TCustomizableRouteConfig = TRouteAuthConfig & {\n  /** Whether this route is registered. Defaults to true. */\n  enabled?: boolean;\n  request?: {\n    params?: TAnyObjectSchema;\n    query?: TAnyObjectSchema;\n    body?: TAnyObjectSchema;\n    headers?: TAnyObjectSchema;\n  };\n  response?: {\n    schema?: z.ZodType;\n    headers?: TResponseHeaders;\n  };\n};\n\n/** Per-route configuration for CRUD controller endpoints (auth, request, response). */\nexport interface ICustomizableRoutes<\n  RouteConfig extends TCustomizableRouteConfig = TCustomizableRouteConfig,\n> {\n  count?: RouteConfig;\n  find?: RouteConfig;\n  findById?: RouteConfig;\n  findOne?: RouteConfig;\n  create?: RouteConfig;\n  updateById?: RouteConfig;\n  updateBy?: RouteConfig;\n  deleteById?: RouteConfig;\n  deleteBy?: RouteConfig;\n}\n"]}

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

@@ -1,5 +0,0 @@
-import type { TContext } from './common/types';
-import type { Env } from 'hono';
-/** Casts middleware context to TContext (safe -- structurally identical to Context). */
-export declare const asTypedContext: <E extends Env>(context: unknown) => TContext<E, string>;
-//# sourceMappingURL=context.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,wFAAwF;AACxF,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,GAAG,EAAE,SAAS,OAAO,KAAG,QAAQ,CAAC,CAAC,EAAE,MAAM,CAElF,CAAC"}

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

@@ -1,9 +0,0 @@
-"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=context.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/base/controllers/context.ts"],"names":[],"mappings":";;;AAGA,wFAAwF;AACjF,MAAM,cAAc,GAAG,CAAgB,OAAgB,EAAuB,EAAE;IACrF,OAAO,OAA8B,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB","sourcesContent":["import type { TContext } from './common/types';\nimport type { Env } from 'hono';\n\n/** Casts middleware context to TContext (safe -- structurally identical to Context). */\nexport const asTypedContext = <E extends Env>(context: unknown): TContext<E, string> => {\n  return context as TContext<E, string>;\n};\n"]}

package/dist/cjs/base/controllers/factory/authorize-guard.d.ts

@@ -1,19 +0,0 @@
-import type { IAuthorizationSpec } from '../../auth/authorize/common/types';
-import type { ICustomizableRoutes } from '../common';
-/**
- * Refuses a CRUD controller whose enabled write verb would inherit a controller-level `authorize`
- * that is only a `read` permission: the verb would then answer to anyone who may read.
- *
- * A write verb is fine when it declares its own `authorize` (a spec, an array, or `{ skip: true }`),
- * skips authentication, is not enabled, or the controller is `readonly`. Only the literal action
- * `read` is detected; a custom action name is the application's own vocabulary. An array counts when
- * every spec in it is `read`, since the specs of one route must all pass.
- */
-export declare const assertWriteVerbsDeclareAuthorize: (opts: {
-    controllerName: string;
-    authorize: IAuthorizationSpec | IAuthorizationSpec[] | undefined;
-    routes: ICustomizableRoutes | undefined;
-    readonly: boolean | undefined;
-    enabledRoutes: Array<keyof ICustomizableRoutes> | undefined;
-}) => void;
-//# sourceMappingURL=authorize-guard.d.ts.map

package/dist/cjs/base/controllers/factory/authorize-guard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"authorize-guard.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/authorize-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AASrD;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,GAAI,MAAM;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAAC;IACjE,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,aAAa,EAAE,KAAK,CAAC,MAAM,mBAAmB,CAAC,GAAG,SAAS,CAAC;CAC7D,KAAG,IA+CH,CAAC"}

package/dist/cjs/base/controllers/factory/authorize-guard.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertWriteVerbsDeclareAuthorize = void 0;
-const constants_1 = require("../../auth/authorize/common/constants");
-const core_1 = require("@venizia/ignis-helpers/core");
-/** The generated routes that change data: the ones that must never be answered by a `read` permission. */
-const WRITE_VERBS = ['create', 'updateById', 'updateBy', 'deleteById', 'deleteBy'];
-const describeSpec = (spec) => {
-    return `{ action: ${String(spec.action)}, resource: ${String(spec.resource)} }`;
-};
-/**
- * Refuses a CRUD controller whose enabled write verb would inherit a controller-level `authorize`
- * that is only a `read` permission: the verb would then answer to anyone who may read.
- *
- * A write verb is fine when it declares its own `authorize` (a spec, an array, or `{ skip: true }`),
- * skips authentication, is not enabled, or the controller is `readonly`. Only the literal action
- * `read` is detected; a custom action name is the application's own vocabulary. An array counts when
- * every spec in it is `read`, since the specs of one route must all pass.
- */
-const assertWriteVerbsDeclareAuthorize = (opts) => {
-    const { controllerName, authorize, routes, readonly, enabledRoutes } = opts;
-    if (readonly || authorize == null) {
-        return;
-    }
-    const specs = Array.isArray(authorize) ? authorize : [authorize];
-    const isReadOnlyPermission = specs.length > 0 && specs.every((spec) => spec.action === constants_1.AuthorizationActions.READ);
-    if (!isReadOnlyPermission) {
-        return;
-    }
-    const offending = WRITE_VERBS.filter((verb) => {
-        const isEnabled = enabledRoutes
-            ? enabledRoutes.includes(verb)
-            : routes?.[verb]?.enabled !== false;
-        if (!isEnabled) {
-            return false;
-        }
-        const route = routes?.[verb];
-        return route?.authenticate?.skip !== true && route?.authorize == null;
-    });
-    if (offending.length === 0) {
-        return;
-    }
-    const inherited = specs.map(describeSpec).join(', ');
-    const verbs = offending.map((verb) => `${controllerName}.${verb}`).join(', ');
-    const hasBulkVerb = offending.some((verb) => verb === 'updateBy' || verb === 'deleteBy');
-    throw (0, core_1.getError)({
-        message: [
-            `[defineCrudController] Write routes would inherit a read-only authorize | controller: ${controllerName} | routes: ${verbs} | inherited: ${inherited}`,
-            'Anyone allowed to read could then create, update or delete.',
-            `Fix: declare routes.<verb>.authorize for each of them (a spec, an array or { skip: true }), or set controller.readonly, or leave them out of controller.enabledRoutes.`,
-            ...(hasBulkVerb
-                ? [
-                    'updateBy and deleteBy are bulk routes on the collection and are generated unless controller.enabledRoutes lists the routes you want, so dropping them there closes this too.',
-                ]
-                : []),
-        ].join(' | '),
-    });
-};
-exports.assertWriteVerbsDeclareAuthorize = assertWriteVerbsDeclareAuthorize;
-//# sourceMappingURL=authorize-guard.js.map

package/dist/cjs/base/controllers/factory/authorize-guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"authorize-guard.js","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/authorize-guard.ts"],"names":[],"mappings":";;;AAAA,sEAA8E;AAE9E,sDAAuD;AAGvD,0GAA0G;AAC1G,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAE5F,MAAM,YAAY,GAAG,CAAC,IAAwB,EAAU,EAAE;IACxD,OAAO,aAAa,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;AAClF,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACI,MAAM,gCAAgC,GAAG,CAAC,IAMhD,EAAQ,EAAE;IACT,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAE5E,IAAI,QAAQ,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,oBAAoB,GACxB,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,gCAAoB,CAAC,IAAI,CAAC,CAAC;IAEvF,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,aAAa;YAC7B,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC;QACtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,EAAE,SAAS,IAAI,IAAI,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC;IAEzF,MAAM,IAAA,eAAQ,EAAC;QACb,OAAO,EAAE;YACP,yFAAyF,cAAc,cAAc,KAAK,iBAAiB,SAAS,EAAE;YACtJ,6DAA6D;YAC7D,wKAAwK;YACxK,GAAG,CAAC,WAAW;gBACb,CAAC,CAAC;oBACE,8KAA8K;iBAC/K;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,IAAI,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;AACL,CAAC,CAAC;AArDW,QAAA,gCAAgC,oCAqD3C","sourcesContent":["import { AuthorizationActions } from '@/base/auth/authorize/common/constants';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { ICustomizableRoutes } from '../common';\n\n/** The generated routes that change data: the ones that must never be answered by a `read` permission. */\nconst WRITE_VERBS = ['create', 'updateById', 'updateBy', 'deleteById', 'deleteBy'] as const;\n\nconst describeSpec = (spec: IAuthorizationSpec): string => {\n  return `{ action: ${String(spec.action)}, resource: ${String(spec.resource)} }`;\n};\n\n/**\n * Refuses a CRUD controller whose enabled write verb would inherit a controller-level `authorize`\n * that is only a `read` permission: the verb would then answer to anyone who may read.\n *\n * A write verb is fine when it declares its own `authorize` (a spec, an array, or `{ skip: true }`),\n * skips authentication, is not enabled, or the controller is `readonly`. Only the literal action\n * `read` is detected; a custom action name is the application's own vocabulary. An array counts when\n * every spec in it is `read`, since the specs of one route must all pass.\n */\nexport const assertWriteVerbsDeclareAuthorize = (opts: {\n  controllerName: string;\n  authorize: IAuthorizationSpec | IAuthorizationSpec[] | undefined;\n  routes: ICustomizableRoutes | undefined;\n  readonly: boolean | undefined;\n  enabledRoutes: Array<keyof ICustomizableRoutes> | undefined;\n}): void => {\n  const { controllerName, authorize, routes, readonly, enabledRoutes } = opts;\n\n  if (readonly || authorize == null) {\n    return;\n  }\n\n  const specs = Array.isArray(authorize) ? authorize : [authorize];\n  const isReadOnlyPermission =\n    specs.length > 0 && specs.every((spec) => spec.action === AuthorizationActions.READ);\n\n  if (!isReadOnlyPermission) {\n    return;\n  }\n\n  const offending = WRITE_VERBS.filter((verb) => {\n    const isEnabled = enabledRoutes\n      ? enabledRoutes.includes(verb)\n      : routes?.[verb]?.enabled !== false;\n    if (!isEnabled) {\n      return false;\n    }\n\n    const route = routes?.[verb];\n    return route?.authenticate?.skip !== true && route?.authorize == null;\n  });\n\n  if (offending.length === 0) {\n    return;\n  }\n\n  const inherited = specs.map(describeSpec).join(', ');\n  const verbs = offending.map((verb) => `${controllerName}.${verb}`).join(', ');\n  const hasBulkVerb = offending.some((verb) => verb === 'updateBy' || verb === 'deleteBy');\n\n  throw getError({\n    message: [\n      `[defineCrudController] Write routes would inherit a read-only authorize | controller: ${controllerName} | routes: ${verbs} | inherited: ${inherited}`,\n      'Anyone allowed to read could then create, update or delete.',\n      `Fix: declare routes.<verb>.authorize for each of them (a spec, an array or { skip: true }), or set controller.readonly, or leave them out of controller.enabledRoutes.`,\n      ...(hasBulkVerb\n        ? [\n            'updateBy and deleteBy are bulk routes on the collection and are generated unless controller.enabledRoutes lists the routes you want, so dropping them there closes this too.',\n          ]\n        : []),\n    ].join(' | '),\n  });\n};\n"]}

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

@@ -1,210 +0,0 @@
-import type { AbstractEntity } from '../../models';
-import type { AbstractRepository } from '../../repositories';
-import type { TAnyObjectSchema } from '../common/schema-builders';
-import type { AnyType, 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, AnyType>): {
-            /** 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>>;
-            assertNonEmptyUpdate(opts: {
-                scope: string;
-                data: object;
-            }): void;
-            updateById(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
-            updateBy(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-            }): Promise<Response>;
-            deleteById(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-            }): Promise<import("../common").TJsonResponse<unknown, 200>>;
-            deleteBy(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-            }): Promise<Response>;
-            getBaseWhere(_opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-            }): Promise<import("../../repositories").TWhere<TDataObject> | undefined>;
-            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("../../repositories").IExtraOptions>;
-            bulkWhereError(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                where?: object;
-            }): import("../common").TJsonResponse<unknown, 400> | undefined;
-            resolveBulkWhere<WhereType extends object>(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                where?: {
-                    fromQuery?: WhereType | undefined;
-                    fromBody?: WhereType | undefined;
-                } | undefined;
-            }): {
-                where?: undefined;
-                error: Response;
-            } | {
-                where: WhereType;
-                error?: undefined;
-            };
-            measure<R>(opts: {
-                scope: string;
-                args: unknown;
-                task: () => Promise<R>;
-            }): Promise<any>;
-            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;
-                payload: ResponseData;
-            }): ResponseData | import("@venizia/ignis-helpers/common").TNullable<ResponseSchema>;
-            getRequestedExtras(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-            }): Array<import("..").IRequestedExtra>;
-            respond<R>(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                format: import("../common").TResponseFormat;
-                payload: {
-                    count: number;
-                    data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-                };
-                range?: import("../../repositories").TDataRange;
-                extra?: never;
-            }): R | {
-                count: number;
-                data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-            } | null | undefined;
-            respond<R, Extra extends Record<string, import("..").TResponseExtra>>(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                format: import("../common").TResponseFormat;
-                payload: {
-                    count: number;
-                    data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-                };
-                range?: import("../../repositories").TDataRange;
-                extra: Extra;
-            }): Promise<R | {
-                count: number;
-                data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-            } | {
-                count?: number;
-                data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-                extra: Partial<Record<keyof Extra, unknown>>;
-            } | null | undefined>;
-            respond<R>(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                format: import("../common").TResponseFormat;
-                payload: {
-                    count: number;
-                    data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-                };
-                range?: import("../../repositories").TDataRange;
-                extra?: Record<string, import("..").TResponseExtra>;
-            }): ValueOrPromise<R | {
-                count?: number;
-                data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-                extra?: Record<string, unknown>;
-            } | null | undefined>;
-            respondWithExtra<R>(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                payload: {
-                    count: number;
-                    data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-                };
-                extra: Record<string, import("..").TResponseExtra>;
-            }): Promise<R | {
-                count: number;
-                data?: import("@venizia/ignis-helpers/common").TNullable<R>;
-            } | {
-                count: number;
-                data: import("@venizia/ignis-helpers/common").TNullable<R>;
-                extra: Record<string, unknown>;
-            } | {
-                data: import("@venizia/ignis-helpers/common").TNullable<R>;
-                extra: Record<string, unknown>;
-                count?: undefined;
-            } | null | undefined>;
-            setListHeaders(opts: {
-                context: import("../common").TRouteContext<RouteEnv>;
-                count: number;
-            } & ({
-                range: import("../../repositories").TDataRange;
-            } | {
-                offset: number;
-                total: number;
-            })): void;
-            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?: import("../common").TRoutePathScope;
-            }): 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 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;
-            };
-            getJSXRouteConfigs<RouteConfig extends import("../common").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;
-            };
-            scope: string;
-            identifier: string;
-            get logger(): import("@venizia/ignis-helpers/core").ILogger;
-            set logger(value: 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

@@ -1 +0,0 @@
-{"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,2CAA2C,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC7E,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;AAMnB,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;yBAiDtB,kBAAkB,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,CAAC;YAUhF,iGAAiG;uBAC7E,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAXG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmGjD"}