@venizia/ignis-kernel 0.4.7-0 → 0.4.7-1

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

@@ -1,13 +1,28 @@
+import type { IAuthorizationSpec } from '../../auth/authorize/common/types/index.js';
 import type { AbstractEntity } from '../../models/index.js';
 import type { AbstractRepository } from '../../repositories/index.js';
 import type { TAnyObjectSchema } from '../common/schema-builders.js';
-import type { AnyType, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { AnyType, TClass, 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 {
+    /** The generated routes that change data: the ones that must never be answered by a `read` permission. */
+    private static readonly WRITE_VERBS;
     constructor();
+    /**
+     * Injects `repositories.<repositoryName>` into constructor parameter 0 of a factory-generated
+     * controller, so a subclass needs no constructor. Recorded as metadata rather than a parameter
+     * decorator, which Bun drops in some configurations. A subclass that declares its own `@inject` at
+     * index 0 wins, and a sibling subclass keeps the factory's key.
+     */
+    static registerRepositoryInjection(opts: {
+        target: TClass<unknown>;
+        factoryName: string;
+        controllerName: string;
+        repositoryName: string;
+    }): void;
     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. */
@@ -206,5 +221,22 @@ export declare class ControllerFactory extends BaseHelper {
             getLogger(): import("@venizia/ignis-helpers/core").ILogger;
         };
     };
+    private static describeSpec;
+    /**
+     * 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.
+     */
+    static assertWriteVerbsDeclareAuthorize(opts: {
+        controllerName: string;
+        authorize: IAuthorizationSpec | IAuthorizationSpec[] | undefined;
+        routes: ICustomizableRoutes | undefined;
+        readonly: boolean | undefined;
+        enabledRoutes: Array<keyof ICustomizableRoutes> | undefined;
+    }): void;
 }
 //# sourceMappingURL=controller.d.ts.map

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

@@ -1 +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,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"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,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;AAGlF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACrF,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;IAC/C,0GAA0G;IAC1G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAMxB;;IAMX;;;;;OAKG;IACH,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE;QACvC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,IAAI;IAoBR,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAxDxC,CAAH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiJD,OAAO,CAAC,MAAM,CAAC,YAAY;IAK3B;;;;;;;;OAQG;IACH,MAAM,CAAC,gCAAgC,CAAC,IAAI,EAAE;QAC5C,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAAC;QACjE,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;QACxC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;QAC9B,aAAa,EAAE,KAAK,CAAC,MAAM,mBAAmB,CAAC,GAAG,SAAS,CAAC;KAC7D,GAAG,IAAI;CAgDT"}

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

@@ -1,15 +1,47 @@
+import { AuthorizationActions } from '../../auth/authorize/common/constants/index.js';
 import { SchemaTypes } from '../../models/common/constants.js';
+import { BindingNamespaces } from '../../../common/bindings.js';
+import { BindingKeys, MetadataRegistry } from '../../../helpers/inversion/index.js';
 import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
 import { isClass } from '@venizia/ignis-inversion';
 import { PersistableCrudController } from './crud/index.js';
-import { assertWriteVerbsDeclareAuthorize } from './authorize-guard.js';
-import { defineControllerRouteConfigs } from './definition.js';
-import { registerFactoryRepositoryInjection } from './repository-injection.js';
+import { RouteConfigResolver } from './definition.js';
 /** Factory for generating typed CRUD controllers from entity definitions. */
 export class ControllerFactory extends BaseHelper {
+    /** The generated routes that change data: the ones that must never be answered by a `read` permission. */
+    static { this.WRITE_VERBS = [
+        'create',
+        'updateById',
+        'updateBy',
+        'deleteById',
+        'deleteBy',
+    ]; }
     constructor() {
         super({ scope: ControllerFactory.name });
     }
+    /**
+     * Injects `repositories.<repositoryName>` into constructor parameter 0 of a factory-generated
+     * controller, so a subclass needs no constructor. Recorded as metadata rather than a parameter
+     * decorator, which Bun drops in some configurations. A subclass that declares its own `@inject` at
+     * index 0 wins, and a sibling subclass keeps the factory's key.
+     */
+    static registerRepositoryInjection(opts) {
+        const { target, factoryName, controllerName, repositoryName } = opts;
+        if (!repositoryName) {
+            throw getError({
+                message: `[${factoryName}] Invalid repository name | controller: ${controllerName} | repository.name must name the repository binding`,
+            });
+        }
+        MetadataRegistry.getInstance().setInjectMetadata({
+            target,
+            index: 0,
+            metadata: {
+                key: BindingKeys.build({ namespace: BindingNamespaces.REPOSITORY, key: repositoryName }),
+                index: 0,
+                isOptional: false,
+            },
+        });
+    }
     static defineCrudController(defOpts) {
         const { controller, entity, authenticate, authorize, routes } = defOpts;
         const { name, basePath = 'unknown_path', isStrict = { path: true, requestSchema: true }, } = controller;
@@ -18,7 +50,7 @@ export class ControllerFactory extends BaseHelper {
                 message: `[defineCrudController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,
             });
         }
-        assertWriteVerbsDeclareAuthorize({
+        ControllerFactory.assertWriteVerbsDeclareAuthorize({
             controllerName: name,
             authorize,
             routes,
@@ -27,7 +59,7 @@ export class ControllerFactory extends BaseHelper {
         });
         const entityClass = isClass(entity) ? entity : entity();
         const entityInstance = new entityClass();
-        const routeDefinitions = defineControllerRouteConfigs({
+        const routeDefinitions = RouteConfigResolver.defineControllerRouteConfigs({
             isStrict: isStrict.requestSchema ?? true,
             idType: entityInstance.getIdType(),
             authenticate,
@@ -121,7 +153,7 @@ export class ControllerFactory extends BaseHelper {
             }
         };
         Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });
-        registerFactoryRepositoryInjection({
+        ControllerFactory.registerRepositoryInjection({
             target: controllerClass,
             factoryName: 'defineCrudController',
             controllerName: name,
@@ -129,5 +161,57 @@ export class ControllerFactory extends BaseHelper {
         });
         return controllerClass;
     }
+    static describeSpec(opts) {
+        const { spec } = opts;
+        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.
+     */
+    static 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 === AuthorizationActions.READ);
+        if (!isReadOnlyPermission) {
+            return;
+        }
+        const offending = ControllerFactory.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((spec) => ControllerFactory.describeSpec({ spec })).join(', ');
+        const verbs = offending.map((verb) => `${controllerName}.${verb}`).join(', ');
+        const hasBulkVerb = offending.some((verb) => verb === 'updateBy' || verb === 'deleteBy');
+        throw 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(' | '),
+        });
+    }
 }
 //# sourceMappingURL=controller.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractEntity } from '@/base/models';\nimport { SchemaTypes } from '@/base/models/common/constants';\nimport type { AbstractRepository } from '@/base/repositories';\nimport type { TAnyObjectSchema } from '@/base/controllers/common/schema-builders';\nimport type { AnyType, ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { isClass } from '@venizia/ignis-inversion';\nimport type { Env, Schema } from 'hono';\nimport type {\n  ICrudControllerOptions,\n  ICustomizableRoutes,\n  TEntityDataObject,\n  TEntityPersistObject,\n} from '../common';\nimport { PersistableCrudController } from './crud';\nimport { assertWriteVerbsDeclareAuthorize } from './authorize-guard';\nimport { defineControllerRouteConfigs } from './definition';\nimport { registerFactoryRepositoryInjection } from './repository-injection';\n\n/** Factory for generating typed CRUD controllers from entity definitions. */\nexport class ControllerFactory extends BaseHelper {\n  constructor() {\n    super({ scope: ControllerFactory.name });\n  }\n\n  static defineCrudController<\n    TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>,\n    Routes extends ICustomizableRoutes = ICustomizableRoutes,\n    RouteEnv extends Env = Env,\n    RouteSchema extends Schema = {},\n    BasePath extends string = '/',\n    ConfigurableOptions extends object = {},\n    TDataObject extends object = TEntityDataObject<TEntity>,\n    TPersistObject extends object = TEntityPersistObject<TEntity>,\n  >(defOpts: ICrudControllerOptions<TEntity, Routes>) {\n    const { controller, entity, authenticate, authorize, routes } = defOpts;\n\n    const {\n      name,\n      basePath = 'unknown_path',\n      isStrict = { path: true, requestSchema: true },\n    } = controller;\n    if (!basePath || basePath === 'unknown_path') {\n      throw getError({\n        message: `[defineCrudController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,\n      });\n    }\n\n    assertWriteVerbsDeclareAuthorize({\n      controllerName: name,\n      authorize,\n      routes,\n      readonly: controller.readonly,\n      enabledRoutes: controller.enabledRoutes,\n    });\n\n    const entityClass = isClass(entity) ? entity : entity();\n    const entityInstance = new entityClass();\n\n    const routeDefinitions = defineControllerRouteConfigs({\n      isStrict: isStrict.requestSchema ?? true,\n      idType: entityInstance.getIdType(),\n      authenticate,\n      authorize,\n      routes,\n      schema: {\n        select: entityInstance.getSchema({ type: SchemaTypes.SELECT }),\n        create: entityInstance.getSchema({ type: SchemaTypes.CREATE }),\n        update: entityInstance.getSchema({ type: SchemaTypes.UPDATE }),\n      },\n      serverStampedKeys: entityInstance.getServerStampedKeys(),\n    });\n\n    const controllerClass = class extends PersistableCrudController<\n      TEntity,\n      RouteEnv,\n      RouteSchema,\n      BasePath,\n      ConfigurableOptions,\n      TDataObject,\n      TPersistObject\n    > {\n      // Any extra options: a repository whose options narrow `IExtraOptions` (a typed transaction) must fit.\n      constructor(repository: AbstractRepository<TDataObject, TPersistObject, AnyType>) {\n        super({\n          scope: name,\n          path: basePath,\n          isStrict: isStrict.path ?? true,\n          repository,\n          definitions: routeDefinitions,\n        });\n      }\n\n      /** Registers each CRUD route whose handler tier supplies it, honoring enabledRoutes/readonly. */\n      override binding(): ValueOrPromise<void> {\n        const isEnabled = (routeKey: keyof ICustomizableRoutes) => {\n          if (controller.enabledRoutes) {\n            return controller.enabledRoutes.includes(routeKey);\n          }\n          return routes?.[routeKey]?.enabled !== false;\n        };\n\n        // Read routes - always registered (unless explicitly disabled)\n        if (isEnabled('count')) {\n          this.defineRoute({\n            configs: routeDefinitions.COUNT,\n            handler: async (context) => this.count({ context }),\n          });\n        }\n\n        if (isEnabled('find')) {\n          this.defineRoute({\n            configs: routeDefinitions.FIND,\n            handler: async (context) => this.find({ context }),\n          });\n        }\n\n        if (isEnabled('findOne')) {\n          this.defineRoute({\n            configs: routeDefinitions.FIND_ONE,\n            handler: async (context) => this.findOne({ context }),\n          });\n        }\n\n        if (isEnabled('findById')) {\n          this.defineRoute({\n            configs: routeDefinitions.FIND_BY_ID,\n            handler: async (context) => this.findById({ context }),\n          });\n        }\n\n        // Write routes - skipped when readonly\n        if (controller.readonly) {\n          return;\n        }\n\n        if (isEnabled('create')) {\n          this.defineRoute({\n            configs: routeDefinitions.CREATE,\n            handler: async (context) => this.create({ context }),\n          });\n        }\n\n        if (isEnabled('updateById')) {\n          this.defineRoute({\n            configs: routeDefinitions.UPDATE_BY_ID,\n            handler: async (context) => this.updateById({ context }),\n          });\n        }\n\n        if (isEnabled('updateBy')) {\n          this.defineRoute({\n            configs: routeDefinitions.UPDATE_BY,\n            handler: async (context) => this.updateBy({ context }),\n          });\n        }\n\n        if (isEnabled('deleteById')) {\n          this.defineRoute({\n            configs: routeDefinitions.DELETE_BY_ID,\n            handler: async (context) => this.deleteById({ context }),\n          });\n        }\n\n        if (isEnabled('deleteBy')) {\n          this.defineRoute({\n            configs: routeDefinitions.DELETE_BY,\n            handler: async (context) => this.deleteBy({ context }),\n          });\n        }\n      }\n    };\n\n    Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });\n    registerFactoryRepositoryInjection({\n      target: controllerClass,\n      factoryName: 'defineCrudController',\n      controllerName: name,\n      repositoryName: defOpts.repository.name,\n    });\n    return controllerClass;\n  }\n}\n"]}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { AuthorizationActions } from '@/base/auth/authorize/common/constants';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport type { AbstractEntity } from '@/base/models';\nimport { SchemaTypes } from '@/base/models/common/constants';\nimport type { AbstractRepository } from '@/base/repositories';\nimport type { TAnyObjectSchema } from '@/base/controllers/common/schema-builders';\nimport { BindingNamespaces } from '@/common/bindings';\nimport { BindingKeys, MetadataRegistry } from '@/helpers/inversion';\nimport type { AnyType, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { isClass } from '@venizia/ignis-inversion';\nimport type { Env, Schema } from 'hono';\nimport type {\n  ICrudControllerOptions,\n  ICustomizableRoutes,\n  TEntityDataObject,\n  TEntityPersistObject,\n} from '../common';\nimport { PersistableCrudController } from './crud';\nimport { RouteConfigResolver } from './definition';\n\n/** Factory for generating typed CRUD controllers from entity definitions. */\nexport class ControllerFactory extends BaseHelper {\n  /** The generated routes that change data: the ones that must never be answered by a `read` permission. */\n  private static readonly WRITE_VERBS = [\n    'create',\n    'updateById',\n    'updateBy',\n    'deleteById',\n    'deleteBy',\n  ] as const;\n\n  constructor() {\n    super({ scope: ControllerFactory.name });\n  }\n\n  /**\n   * Injects `repositories.<repositoryName>` into constructor parameter 0 of a factory-generated\n   * controller, so a subclass needs no constructor. Recorded as metadata rather than a parameter\n   * decorator, which Bun drops in some configurations. A subclass that declares its own `@inject` at\n   * index 0 wins, and a sibling subclass keeps the factory's key.\n   */\n  static registerRepositoryInjection(opts: {\n    target: TClass<unknown>;\n    factoryName: string;\n    controllerName: string;\n    repositoryName: string;\n  }): void {\n    const { target, factoryName, controllerName, repositoryName } = opts;\n\n    if (!repositoryName) {\n      throw getError({\n        message: `[${factoryName}] Invalid repository name | controller: ${controllerName} | repository.name must name the repository binding`,\n      });\n    }\n\n    MetadataRegistry.getInstance().setInjectMetadata({\n      target,\n      index: 0,\n      metadata: {\n        key: BindingKeys.build({ namespace: BindingNamespaces.REPOSITORY, key: repositoryName }),\n        index: 0,\n        isOptional: false,\n      },\n    });\n  }\n\n  static defineCrudController<\n    TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>,\n    Routes extends ICustomizableRoutes = ICustomizableRoutes,\n    RouteEnv extends Env = Env,\n    RouteSchema extends Schema = {},\n    BasePath extends string = '/',\n    ConfigurableOptions extends object = {},\n    TDataObject extends object = TEntityDataObject<TEntity>,\n    TPersistObject extends object = TEntityPersistObject<TEntity>,\n  >(defOpts: ICrudControllerOptions<TEntity, Routes>) {\n    const { controller, entity, authenticate, authorize, routes } = defOpts;\n\n    const {\n      name,\n      basePath = 'unknown_path',\n      isStrict = { path: true, requestSchema: true },\n    } = controller;\n    if (!basePath || basePath === 'unknown_path') {\n      throw getError({\n        message: `[defineCrudController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,\n      });\n    }\n\n    ControllerFactory.assertWriteVerbsDeclareAuthorize({\n      controllerName: name,\n      authorize,\n      routes,\n      readonly: controller.readonly,\n      enabledRoutes: controller.enabledRoutes,\n    });\n\n    const entityClass = isClass(entity) ? entity : entity();\n    const entityInstance = new entityClass();\n\n    const routeDefinitions = RouteConfigResolver.defineControllerRouteConfigs({\n      isStrict: isStrict.requestSchema ?? true,\n      idType: entityInstance.getIdType(),\n      authenticate,\n      authorize,\n      routes,\n      schema: {\n        select: entityInstance.getSchema({ type: SchemaTypes.SELECT }),\n        create: entityInstance.getSchema({ type: SchemaTypes.CREATE }),\n        update: entityInstance.getSchema({ type: SchemaTypes.UPDATE }),\n      },\n      serverStampedKeys: entityInstance.getServerStampedKeys(),\n    });\n\n    const controllerClass = class extends PersistableCrudController<\n      TEntity,\n      RouteEnv,\n      RouteSchema,\n      BasePath,\n      ConfigurableOptions,\n      TDataObject,\n      TPersistObject\n    > {\n      // Any extra options: a repository whose options narrow `IExtraOptions` (a typed transaction) must fit.\n      constructor(repository: AbstractRepository<TDataObject, TPersistObject, AnyType>) {\n        super({\n          scope: name,\n          path: basePath,\n          isStrict: isStrict.path ?? true,\n          repository,\n          definitions: routeDefinitions,\n        });\n      }\n\n      /** Registers each CRUD route whose handler tier supplies it, honoring enabledRoutes/readonly. */\n      override binding(): ValueOrPromise<void> {\n        const isEnabled = (routeKey: keyof ICustomizableRoutes) => {\n          if (controller.enabledRoutes) {\n            return controller.enabledRoutes.includes(routeKey);\n          }\n          return routes?.[routeKey]?.enabled !== false;\n        };\n\n        // Read routes - always registered (unless explicitly disabled)\n        if (isEnabled('count')) {\n          this.defineRoute({\n            configs: routeDefinitions.COUNT,\n            handler: async (context) => this.count({ context }),\n          });\n        }\n\n        if (isEnabled('find')) {\n          this.defineRoute({\n            configs: routeDefinitions.FIND,\n            handler: async (context) => this.find({ context }),\n          });\n        }\n\n        if (isEnabled('findOne')) {\n          this.defineRoute({\n            configs: routeDefinitions.FIND_ONE,\n            handler: async (context) => this.findOne({ context }),\n          });\n        }\n\n        if (isEnabled('findById')) {\n          this.defineRoute({\n            configs: routeDefinitions.FIND_BY_ID,\n            handler: async (context) => this.findById({ context }),\n          });\n        }\n\n        // Write routes - skipped when readonly\n        if (controller.readonly) {\n          return;\n        }\n\n        if (isEnabled('create')) {\n          this.defineRoute({\n            configs: routeDefinitions.CREATE,\n            handler: async (context) => this.create({ context }),\n          });\n        }\n\n        if (isEnabled('updateById')) {\n          this.defineRoute({\n            configs: routeDefinitions.UPDATE_BY_ID,\n            handler: async (context) => this.updateById({ context }),\n          });\n        }\n\n        if (isEnabled('updateBy')) {\n          this.defineRoute({\n            configs: routeDefinitions.UPDATE_BY,\n            handler: async (context) => this.updateBy({ context }),\n          });\n        }\n\n        if (isEnabled('deleteById')) {\n          this.defineRoute({\n            configs: routeDefinitions.DELETE_BY_ID,\n            handler: async (context) => this.deleteById({ context }),\n          });\n        }\n\n        if (isEnabled('deleteBy')) {\n          this.defineRoute({\n            configs: routeDefinitions.DELETE_BY,\n            handler: async (context) => this.deleteBy({ context }),\n          });\n        }\n      }\n    };\n\n    Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });\n    ControllerFactory.registerRepositoryInjection({\n      target: controllerClass,\n      factoryName: 'defineCrudController',\n      controllerName: name,\n      repositoryName: defOpts.repository.name,\n    });\n    return controllerClass;\n  }\n\n  private static describeSpec(opts: { spec: IAuthorizationSpec }): string {\n    const { spec } = opts;\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   */\n  static 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 = ControllerFactory.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((spec) => ControllerFactory.describeSpec({ spec })).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}\n"]}

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

@@ -16,7 +16,7 @@ type TResolvedResponseSchema<C, D extends z.ZodType> = C extends {
  * `this.other(...)`, or `this` is `undefined` at the call site.
  */
 export declare class RouteConfigResolver {
-    /** Path params always reach the validator as strings, so a number-typed id must be coerced before `z.number()` sees it - `idParamsSchema` alone rejects `/accounts/7`. */
+    /** Path params always reach the validator as strings, so a number-typed id must be coerced before `z.number()` sees it - `OpenApiSchemas.idParams` alone rejects `/accounts/7`. */
     private static idPathParamsSchema;
     /**
      * The default body of a write route: the entity schema without the keys the entity stamps, and on
@@ -1138,12 +1138,5 @@ export declare class RouteConfigResolver {
         };
     };
 }
-export declare const conditionalCountResponse: typeof RouteConfigResolver.conditionalCountResponse;
-export declare const resolveCountConfig: typeof RouteConfigResolver.resolveCountConfig;
-export declare const resolveFindConfig: typeof RouteConfigResolver.resolveFindConfig;
-export declare const resolveFindByIdConfig: typeof RouteConfigResolver.resolveFindByIdConfig;
-export declare const resolveFindOneConfig: typeof RouteConfigResolver.resolveFindOneConfig;
-export declare const resolveCreateConfig: typeof RouteConfigResolver.resolveCreateConfig;
-export declare const defineControllerRouteConfigs: typeof RouteConfigResolver.defineControllerRouteConfigs;
 export {};
 //# sourceMappingURL=definition.d.ts.map

package/dist/esm/base/controllers/factory/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AASrD,8FAA8F;AAC9F,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS;IAC/D,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;KACnC,CAAC;CACH,GACG,CAAC,GACD,CAAC,CAAC;AAEN;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,0KAA0K;IAC1K,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAejC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA+BhC,sGAAsG;IACtG,OAAO,CAAC,MAAM,CAAC,eAAe;IAO9B,iDAAiD;IACjD,MAAM,CAAC,wBAAwB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;;;;IAWlE,wQAAwQ;IACxQ,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAQpC,MAAM,CAAC,kBAAkB,CAAC,CAAC,SAAS,mBAAmB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;QACtE,MAAM,EAAE,CAAC,CAAC;QACV,QAAQ,EAAE,OAAO,CAAC;KACnB;;;;;;;;;;;;;;;;;;;IAuBD,MAAM,CAAC,iBAAiB,CACtB,CAAC,SAAS,mBAAmB,CAAC,MAAM,CAAC,EACrC,UAAU,SAAS,gBAAgB,EACnC,IAAI,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,YAAY,EAAE,UAAU,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkB/C,MAAM,CAAC,qBAAqB,CAC1B,CAAC,SAAS,mBAAmB,CAAC,UAAU,CAAC,EACzC,cAAc,SAAS,gBAAgB,EACvC,IAAI,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,YAAY,EAAE,cAAc,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqB1E,MAAM,CAAC,oBAAoB,CACzB,CAAC,SAAS,mBAAmB,CAAC,SAAS,CAAC,EACxC,aAAa,SAAS,gBAAgB,EACtC,IAAI,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,YAAY,EAAE,aAAa,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBlD,qHAAqH;IACrH,MAAM,CAAC,mBAAmB,CACxB,CAAC,SAAS,mBAAmB,CAAC,QAAQ,CAAC,EACvC,YAAY,SAAS,gBAAgB,EACrC,YAAY,SAAS,gBAAgB,EACrC,IAAI,EAAE;QACN,MAAM,EAAE,CAAC,CAAC;QACV,YAAY,EAAE,YAAY,CAAC;QAC3B,YAAY,EAAE,YAAY,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B;;;;;;;;;;;;;;;;;;;IAuBD,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAiCtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA2CpC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAmBtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA2BpC;;;OAGG;IACH,MAAM,CAAC,4BAA4B,CACjC,MAAM,SAAS,mBAAmB,EAClC,YAAY,SAAS,gBAAgB,EACrC,YAAY,SAAS,gBAAgB,EACrC,YAAY,SAAS,gBAAgB,EACrC,IAAI,EAAE;QACN,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,aAAa,CAAC;QACtB,YAAY,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,SAAS,CAAA;SAAE,CAAC;QAClE,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;QACtD,MAAM,EAAE;YAAE,MAAM,EAAE,YAAY,CAAC;YAAC,MAAM,EAAE,YAAY,CAAC;YAAC,MAAM,EAAE,YAAY,CAAA;SAAE,CAAC;QAC7E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;;;;;;6BAe2C,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjC,aAAa,EAAE;uBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsN9E;AAED,eAAO,MAAM,wBAAwB,qDAA+C,CAAC;AACrF,eAAO,MAAM,kBAAkB,+CAAyC,CAAC;AACzE,eAAO,MAAM,iBAAiB,8CAAwC,CAAC;AACvE,eAAO,MAAM,qBAAqB,kDAA4C,CAAC;AAC/E,eAAO,MAAM,oBAAoB,iDAA2C,CAAC;AAC7E,eAAO,MAAM,mBAAmB,gDAA0C,CAAC;AAC3E,eAAO,MAAM,4BAA4B,yDAAmD,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/factory/definition.ts"],"names":[],"mappings":"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"}

package/dist/esm/base/controllers/factory/definition.js

@@ -1,4 +1,4 @@
-import { idParamsSchema, jsonContent, jsonResponse } from '../../models/common/index.js';
+import { OpenApiResponses, OpenApiSchemas } from '../../models/common/index.js';
 import { CountSchema } from '../../repositories/common/index.js';
 import { FilterQuerySchema, WhereSchema } from '../../repositories/query-schemas/index.js';
 import { z } from '@hono/zod-openapi';
@@ -11,11 +11,11 @@ import { commonResponseHeaders, defaultRequestHeaders, findResponseHeaders, Rest
  * `this.other(...)`, or `this` is `undefined` at the call site.
  */
 export class RouteConfigResolver {
-    /** Path params always reach the validator as strings, so a number-typed id must be coerced before `z.number()` sees it - `idParamsSchema` alone rejects `/accounts/7`. */
+    /** Path params always reach the validator as strings, so a number-typed id must be coerced before `z.number()` sees it - `OpenApiSchemas.idParams` alone rejects `/accounts/7`. */
     static idPathParamsSchema(opts) {
         const { idType } = opts;
         if (idType !== 'number') {
-            return idParamsSchema({ idType });
+            return OpenApiSchemas.idParams({ idType });
         }
         return z.object({
             id: z.coerce.number().openapi({
@@ -42,7 +42,7 @@ export class RouteConfigResolver {
         }
         if (!isObjectSchema || schema.def.checks?.length) {
             throw getError({
-                message: `[defineControllerRouteConfigs] Cannot build the default ${route} body | keys to leave out: ${omittedKeys.join(', ')} | The schema is refined or transformed, so zod cannot remove them | Pass routes.${route}.request.body`,
+                message: `[RouteConfigResolver.defineControllerRouteConfigs] Cannot build the default ${route} body | keys to leave out: ${omittedKeys.join(', ')} | The schema is refined or transformed, so zod cannot remove them | Pass routes.${route}.request.body`,
             });
         }
         const mask = {};
@@ -346,7 +346,7 @@ export class RouteConfigResolver {
                 authenticate: resolveRouteAuth('count'),
                 authorize: resolveRouteAuthorize('count'),
                 request: count.request,
-                responses: jsonResponse(count.response),
+                responses: OpenApiResponses.jsonResponse(count.response),
             },
             FIND: {
                 method: HTTP.Methods.GET,
@@ -355,7 +355,7 @@ export class RouteConfigResolver {
                 authenticate: resolveRouteAuth('find'),
                 authorize: resolveRouteAuthorize('find'),
                 request: find.request,
-                responses: jsonResponse(find.response),
+                responses: OpenApiResponses.jsonResponse(find.response),
             },
             FIND_BY_ID: {
                 method: HTTP.Methods.GET,
@@ -364,7 +364,7 @@ export class RouteConfigResolver {
                 authenticate: resolveRouteAuth('findById'),
                 authorize: resolveRouteAuthorize('findById'),
                 request: findById.request,
-                responses: jsonResponse(findById.response),
+                responses: OpenApiResponses.jsonResponse(findById.response),
             },
             FIND_ONE: {
                 method: HTTP.Methods.GET,
@@ -373,7 +373,7 @@ export class RouteConfigResolver {
                 authenticate: resolveRouteAuth('findOne'),
                 authorize: resolveRouteAuthorize('findOne'),
                 request: findOne.request,
-                responses: jsonResponse(findOne.response),
+                responses: OpenApiResponses.jsonResponse(findOne.response),
             },
             CREATE: {
                 method: HTTP.Methods.POST,
@@ -382,13 +382,13 @@ export class RouteConfigResolver {
                 authenticate: resolveRouteAuth('create'),
                 authorize: resolveRouteAuthorize('create'),
                 request: {
-                    body: jsonContent({
+                    body: OpenApiResponses.jsonContent({
                         description: 'Record data (required fields must be provided)',
                         schema: create.request.body,
                     }),
                     headers: create.request.headers,
                 },
-                responses: jsonResponse(create.response),
+                responses: OpenApiResponses.jsonResponse(create.response),
             },
             UPDATE_BY_ID: {
                 method: HTTP.Methods.PATCH,
@@ -398,13 +398,13 @@ export class RouteConfigResolver {
                 authorize: resolveRouteAuthorize('updateById'),
                 request: {
                     params: updateById.request.params,
-                    body: jsonContent({
+                    body: OpenApiResponses.jsonContent({
                         description: 'Partial data (only changed fields)',
                         schema: updateById.request.body,
                     }),
                     headers: updateById.request.headers,
                 },
-                responses: jsonResponse(updateById.response),
+                responses: OpenApiResponses.jsonResponse(updateById.response),
             },
             UPDATE_BY: {
                 method: HTTP.Methods.PATCH,
@@ -414,13 +414,13 @@ export class RouteConfigResolver {
                 authorize: resolveRouteAuthorize('updateBy'),
                 request: {
                     query: updateBy.request.query,
-                    body: jsonContent({
+                    body: OpenApiResponses.jsonContent({
                         description: 'Partial data to apply to all matches',
                         schema: updateBy.request.body,
                     }),
                     headers: updateBy.request.headers,
                 },
-                responses: jsonResponse(updateBy.response),
+                responses: OpenApiResponses.jsonResponse(updateBy.response),
             },
             DELETE_BY_ID: {
                 method: HTTP.Methods.DELETE,
@@ -429,7 +429,7 @@ export class RouteConfigResolver {
                 authenticate: resolveRouteAuth('deleteById'),
                 authorize: resolveRouteAuthorize('deleteById'),
                 request: deleteById.request,
-                responses: jsonResponse(deleteById.response),
+                responses: OpenApiResponses.jsonResponse(deleteById.response),
             },
             DELETE_BY: {
                 method: HTTP.Methods.DELETE,
@@ -441,7 +441,7 @@ export class RouteConfigResolver {
                     query: deleteBy.request.query,
                     ...(deleteBy.request.body
                         ? {
-                            body: jsonContent({
+                            body: OpenApiResponses.jsonContent({
                                 description: 'Where condition, when it does not fit in the query',
                                 schema: deleteBy.request.body,
                                 required: false,
@@ -450,17 +450,10 @@ export class RouteConfigResolver {
                         : {}),
                     headers: deleteBy.request.headers,
                 },
-                responses: jsonResponse(deleteBy.response),
+                responses: OpenApiResponses.jsonResponse(deleteBy.response),
             },
         };
         return rs;
     }
 }
-export const conditionalCountResponse = RouteConfigResolver.conditionalCountResponse;
-export const resolveCountConfig = RouteConfigResolver.resolveCountConfig;
-export const resolveFindConfig = RouteConfigResolver.resolveFindConfig;
-export const resolveFindByIdConfig = RouteConfigResolver.resolveFindByIdConfig;
-export const resolveFindOneConfig = RouteConfigResolver.resolveFindOneConfig;
-export const resolveCreateConfig = RouteConfigResolver.resolveCreateConfig;
-export const defineControllerRouteConfigs = RouteConfigResolver.defineControllerRouteConfigs;
 //# sourceMappingURL=definition.js.map