@venizia/ignis-kernel 0.2.0-8 → 0.2.0

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

@@ -1,169 +1,43 @@
-import type { TAuthMode, TAuthStrategy } from '../../../base/auth/authenticate/common/constants.js';
-import type { IAuthorizationSpec } from '../../../base/auth/authorize/common/types.js';
-import type { TIdSchemaType } from '../../../base/models/common/types.js';
-import type { TAnyObjectSchema } from '../../../utilities/schema.utility.js';
+import type { TAuthMode, TAuthStrategy } from '../../auth/authenticate/common/constants/index.js';
+import type { IAuthorizationSpec } from '../../auth/authorize/common/types/index.js';
+import type { TIdSchemaType } from '../../models/common/index.js';
+import type { TAnyObjectSchema } from '../common/schema-builders.js';
 import { z } from '@hono/zod-openapi';
 import type { ICustomizableRoutes } from '../common/index.js';
-/** Creates conditional count response schema. */
-export declare const conditionalCountResponse: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodUnion<readonly [z.ZodObject<{
-    count: z.ZodDefault<z.ZodNumber>;
-    data: T;
-}, z.core.$strip>, T]>;
 /** Picks user-overridden response schema if present (and non-undefined), else the default. */
-type TResolvedResponseSchema<C, D extends z.ZodTypeAny> = C extends {
+type TResolvedResponseSchema<C, D extends z.ZodType> = C extends {
     response: {
-        schema: infer S extends z.ZodTypeAny;
+        schema: infer S extends z.ZodType;
     };
 } ? S : D;
-export declare const resolveCountConfig: <C extends ICustomizableRoutes["count"]>(opts: {
-    config: C;
-    isStrict: boolean;
-}) => {
-    request: {
-        query: TAnyObjectSchema | z.ZodObject<{
-            where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]> | z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
-        }, z.core.$strip>;
-        headers: TAnyObjectSchema | z.ZodObject<{
-            "x-request-id": z.ZodOptional<z.ZodString>;
-            "x-request-channel": z.ZodOptional<z.ZodString>;
-            "x-device-info": z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    response: {
-        description: string;
-        schema: TResolvedResponseSchema<C, z.ZodObject<{
-            count: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>;
-        headers: import("../index.js").TResponseHeaders;
-    };
-};
-export declare const resolveFindConfig: <C extends ICustomizableRoutes["find"], FindSchema extends TAnyObjectSchema>(opts: {
-    config: C;
-    selectSchema: FindSchema;
-}) => {
-    request: {
-        query: TAnyObjectSchema | z.ZodObject<{
-            filter: any;
-        }, z.core.$strip>;
-        headers: TAnyObjectSchema | z.ZodObject<{
-            "x-request-id": z.ZodOptional<z.ZodString>;
-            "x-request-channel": z.ZodOptional<z.ZodString>;
-            "x-device-info": z.ZodOptional<z.ZodString>;
-            "x-request-count": z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    response: {
-        description: string;
-        schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
-            count: z.ZodDefault<z.ZodNumber>;
-            data: z.ZodArray<FindSchema>;
-        }, z.core.$strip>, z.ZodArray<FindSchema>]>>;
-        headers: import("../index.js").TResponseHeaders;
-    };
-};
-export declare const resolveFindByIdConfig: <C extends ICustomizableRoutes["findById"], FindByIdSchema extends TAnyObjectSchema>(opts: {
-    idType: TIdSchemaType;
-    config: C;
-    selectSchema: FindByIdSchema;
-}) => {
-    request: {
-        params: z.ZodObject<{
-            id: z.ZodString;
-        }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
-            id: z.ZodCoercedNumber<unknown>;
-        }, z.core.$strip>;
-        query: TAnyObjectSchema | z.ZodObject<{
-            filter: any;
-        }, z.core.$strip>;
-        headers: TAnyObjectSchema | z.ZodObject<{
-            "x-request-id": z.ZodOptional<z.ZodString>;
-            "x-request-channel": z.ZodOptional<z.ZodString>;
-            "x-device-info": z.ZodOptional<z.ZodString>;
-            "x-request-count": z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    response: {
-        description: string;
-        schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
-            count: z.ZodDefault<z.ZodNumber>;
-            data: FindByIdSchema;
-        }, z.core.$strip>, FindByIdSchema]>>;
-        headers: import("../index.js").TResponseHeaders;
-    };
-};
-export declare const resolveFindOneConfig: <C extends ICustomizableRoutes["findOne"], FindOneSchema extends TAnyObjectSchema>(opts: {
-    config: C;
-    selectSchema: FindOneSchema;
-}) => {
-    request: {
-        query: TAnyObjectSchema | z.ZodObject<{
-            filter: any;
-        }, z.core.$strip>;
-        headers: TAnyObjectSchema | z.ZodObject<{
-            "x-request-id": z.ZodOptional<z.ZodString>;
-            "x-request-channel": z.ZodOptional<z.ZodString>;
-            "x-device-info": z.ZodOptional<z.ZodString>;
-            "x-request-count": z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    response: {
-        description: string;
-        schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
-            count: z.ZodDefault<z.ZodNumber>;
-            data: FindOneSchema;
-        }, z.core.$strip>, FindOneSchema]>>;
-        headers: import("../index.js").TResponseHeaders;
-    };
-};
-export declare const resolveCreateConfig: <C extends ICustomizableRoutes["create"], SelectSchema extends TAnyObjectSchema, CreateSchema extends TAnyObjectSchema>(opts: {
-    config: C;
-    selectSchema: SelectSchema;
-    createSchema: CreateSchema;
-}) => {
-    request: {
-        body: TAnyObjectSchema;
-        headers: TAnyObjectSchema | z.ZodObject<{
-            "x-request-id": z.ZodOptional<z.ZodString>;
-            "x-request-channel": z.ZodOptional<z.ZodString>;
-            "x-device-info": z.ZodOptional<z.ZodString>;
-            "x-request-count": z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    response: {
-        description: string;
-        schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
-            count: z.ZodDefault<z.ZodNumber>;
-            data: SelectSchema;
-        }, z.core.$strip>, SelectSchema]>>;
-        headers: import("../index.js").TResponseHeaders;
-    };
-};
-/** Generates complete route configurations for a CRUD controller. */
-export declare const defineControllerRouteConfigs: <Routes extends ICustomizableRoutes, SelectSchema extends TAnyObjectSchema, CreateSchema extends TAnyObjectSchema, UpdateSchema extends TAnyObjectSchema>(opts: {
-    isStrict: boolean;
-    idType: TIdSchemaType;
-    authenticate?: {
-        strategies?: TAuthStrategy[];
-        mode?: TAuthMode;
-    };
-    authorize?: IAuthorizationSpec | IAuthorizationSpec[];
-    schema: {
-        select: SelectSchema;
-        create: CreateSchema;
-        update: UpdateSchema;
-    };
-    routes?: Routes;
-}) => {
-    readonly COUNT: {
-        readonly method: "get";
-        readonly path: "/count";
-        readonly description: "Count records matching where condition";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
+/**
+ * Every method here is an unbound static, called from the exported aliases below without a
+ * receiver - a method must call another via `RouteConfigResolver.other(...)`, never
+ * `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`. */
+    private static idPathParamsSchema;
+    /**
+     * The default body of a write route: the entity schema without the keys the entity stamps, and on
+     * an update without `id` - the path or `where` names the rows. Zod strips a left-out key a client
+     * sends. With nothing to leave out the schema itself is the body, refinements and OpenAPI name kept.
+     */
+    private static toWriteBodySchema;
+    /** Picks the caller's per-route `request.params` override, else the entity's id path-param schema. */
+    private static resolveIdParams;
+    /** Creates conditional count response schema. */
+    static conditionalCountResponse<T extends z.ZodType>(dataSchema: T): z.ZodUnion<readonly [z.ZodObject<{
+        count: z.ZodDefault<z.ZodNumber>;
+        data: T;
+    }, z.core.$strip>, T]>;
+    /** Resolves a route's response schema - user override or default. Holds the one cast every `resolve*Config` needs: generic `C` is only known by its wider structural constraint, so it cannot be proven at the value level to collapse to `TResolvedResponseSchema`. */
+    private static resolveResponseSchema;
+    static resolveCountConfig<C extends ICustomizableRoutes['count']>(opts: {
+        config: C;
+        isStrict: boolean;
+    }): {
+        request: {
             query: TAnyObjectSchema | z.ZodObject<{
                 where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]> | z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
             }, z.core.$strip>;
@@ -173,61 +47,19 @@ export declare const defineControllerRouteConfigs: <Routes extends ICustomizable
                 "x-device-info": z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                        }, z.core.$strip>;
-                    };
-                };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                        }, z.core.$strip>;
-                    };
-                };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
-                    };
-                };
-                required: boolean | undefined;
-            };
+        response: {
+            description: string;
+            schema: TResolvedResponseSchema<C, z.ZodObject<{
+                count: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>;
+            headers: import("../index.js").TResponseHeaders;
         };
     };
-    readonly FIND: {
-        readonly method: "get";
-        readonly path: "/";
-        readonly description: "Find records with filter, pagination, sorting, and relations";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
+    static resolveFindConfig<C extends ICustomizableRoutes['find'], FindSchema extends TAnyObjectSchema>(opts: {
+        config: C;
+        selectSchema: FindSchema;
+    }): {
+        request: {
             query: TAnyObjectSchema | z.ZodObject<{
                 filter: any;
             }, z.core.$strip>;
@@ -238,63 +70,21 @@ export declare const defineControllerRouteConfigs: <Routes extends ICustomizable
                 "x-request-count": z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: z.ZodArray<SelectSchema>;
-                        }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
-                    };
-                };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: z.ZodArray<SelectSchema>;
-                        }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
-                    };
-                };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
-                    };
-                };
-                required: boolean | undefined;
-            };
+        response: {
+            description: string;
+            schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
+                count: z.ZodDefault<z.ZodNumber>;
+                data: z.ZodArray<FindSchema>;
+            }, z.core.$strip>, z.ZodArray<FindSchema>]>>;
+            headers: import("../index.js").TResponseHeaders;
         };
     };
-    readonly FIND_BY_ID: {
-        readonly method: "get";
-        readonly path: "/{id}";
-        readonly description: "Find single record by ID";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
+    static resolveFindByIdConfig<C extends ICustomizableRoutes['findById'], FindByIdSchema extends TAnyObjectSchema>(opts: {
+        idType: TIdSchemaType;
+        config: C;
+        selectSchema: FindByIdSchema;
+    }): {
+        request: {
             params: z.ZodObject<{
                 id: z.ZodString;
             }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
@@ -310,63 +100,20 @@ export declare const defineControllerRouteConfigs: <Routes extends ICustomizable
                 "x-request-count": z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
-                    };
-                };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
-                    };
-                };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
-                    };
-                };
-                required: boolean | undefined;
-            };
+        response: {
+            description: string;
+            schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
+                count: z.ZodDefault<z.ZodNumber>;
+                data: FindByIdSchema;
+            }, z.core.$strip>, FindByIdSchema]>>;
+            headers: import("../index.js").TResponseHeaders;
         };
     };
-    readonly FIND_ONE: {
-        readonly method: "get";
-        readonly path: "/find-one";
-        readonly description: "Find first record matching filter";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
+    static resolveFindOneConfig<C extends ICustomizableRoutes['findOne'], FindOneSchema extends TAnyObjectSchema>(opts: {
+        config: C;
+        selectSchema: FindOneSchema;
+    }): {
+        request: {
             query: TAnyObjectSchema | z.ZodObject<{
                 filter: any;
             }, z.core.$strip>;
@@ -377,416 +124,894 @@ export declare const defineControllerRouteConfigs: <Routes extends ICustomizable
                 "x-request-count": z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+        response: {
+            description: string;
+            schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
+                count: z.ZodDefault<z.ZodNumber>;
+                data: FindOneSchema;
+            }, z.core.$strip>, FindOneSchema]>>;
+            headers: import("../index.js").TResponseHeaders;
+        };
+    };
+    /** `serverStampedKeys` - what the entity reports from `getServerStampedKeys()`; the default body leaves them out. */
+    static resolveCreateConfig<C extends ICustomizableRoutes['create'], SelectSchema extends TAnyObjectSchema, CreateSchema extends TAnyObjectSchema>(opts: {
+        config: C;
+        selectSchema: SelectSchema;
+        createSchema: CreateSchema;
+        serverStampedKeys?: string[];
+    }): {
+        request: {
+            body: TAnyObjectSchema;
+            headers: TAnyObjectSchema | z.ZodObject<{
+                "x-request-id": z.ZodOptional<z.ZodString>;
+                "x-request-channel": z.ZodOptional<z.ZodString>;
+                "x-device-info": z.ZodOptional<z.ZodString>;
+                "x-request-count": z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        };
+        response: {
+            description: string;
+            schema: TResolvedResponseSchema<C, z.ZodUnion<readonly [z.ZodObject<{
+                count: z.ZodDefault<z.ZodNumber>;
+                data: SelectSchema;
+            }, z.core.$strip>, SelectSchema]>>;
+            headers: import("../index.js").TResponseHeaders;
+        };
+    };
+    private static resolveUpdateByIdConfig;
+    private static resolveUpdateByConfig;
+    private static resolveDeleteByIdConfig;
+    private static resolveDeleteByConfig;
+    /**
+     * Generates complete route configurations for a CRUD controller. `serverStampedKeys` - what the
+     * entity reports from `getServerStampedKeys()`; the default write bodies leave them out.
+     */
+    static defineControllerRouteConfigs<Routes extends ICustomizableRoutes, SelectSchema extends TAnyObjectSchema, CreateSchema extends TAnyObjectSchema, UpdateSchema extends TAnyObjectSchema>(opts: {
+        isStrict: boolean;
+        idType: TIdSchemaType;
+        authenticate?: {
+            strategies?: TAuthStrategy[];
+            mode?: TAuthMode;
+        };
+        authorize?: IAuthorizationSpec | IAuthorizationSpec[];
+        schema: {
+            select: SelectSchema;
+            create: CreateSchema;
+            update: UpdateSchema;
+        };
+        serverStampedKeys?: string[];
+        routes?: Routes;
+    }): {
+        readonly COUNT: {
+            readonly method: "get";
+            readonly path: "/count";
+            readonly description: "Count records matching where condition";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                query: TAnyObjectSchema | z.ZodObject<{
+                    where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]> | z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+                }, z.core.$strip>;
+                headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
         };
-    };
-    readonly CREATE: {
-        readonly method: "post";
-        readonly path: "/";
-        readonly description: "Create new record";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
-            readonly body: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: TAnyObjectSchema;
+        readonly FIND: {
+            readonly method: "get";
+            readonly path: "/";
+            readonly description: "Find records with filter, pagination, sorting, and relations";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                query: TAnyObjectSchema | z.ZodObject<{
+                    filter: any;
+                }, z.core.$strip>;
+                headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
+                };
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: z.ZodArray<SelectSchema>;
+                            }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: z.ZodArray<SelectSchema>;
+                            }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                        };
+                    };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
-            readonly headers: TAnyObjectSchema | z.ZodObject<{
-                "x-request-id": z.ZodOptional<z.ZodString>;
-                "x-request-channel": z.ZodOptional<z.ZodString>;
-                "x-device-info": z.ZodOptional<z.ZodString>;
-                "x-request-count": z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
         };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+        readonly FIND_BY_ID: {
+            readonly method: "get";
+            readonly path: "/{id}";
+            readonly description: "Find single record by ID";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                params: z.ZodObject<{
+                    id: z.ZodString;
+                }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
+                    id: z.ZodCoercedNumber<unknown>;
+                }, z.core.$strip>;
+                query: TAnyObjectSchema | z.ZodObject<{
+                    filter: any;
+                }, z.core.$strip>;
+                headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
                     };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
+                    };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
         };
-    };
-    readonly UPDATE_BY_ID: {
-        readonly method: "patch";
-        readonly path: "/{id}";
-        readonly description: "Partial update record by ID";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
-            readonly params: z.ZodObject<{
-                id: z.ZodString;
-            }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
-                id: z.ZodCoercedNumber<unknown>;
-            }, z.core.$strip>;
-            readonly body: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: TAnyObjectSchema;
+        readonly FIND_ONE: {
+            readonly method: "get";
+            readonly path: "/find-one";
+            readonly description: "Find first record matching filter";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                query: TAnyObjectSchema | z.ZodObject<{
+                    filter: any;
+                }, z.core.$strip>;
+                headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
+                };
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
+                    };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
-            readonly headers: TAnyObjectSchema | z.ZodObject<{
-                "x-request-id": z.ZodOptional<z.ZodString>;
-                "x-request-channel": z.ZodOptional<z.ZodString>;
-                "x-device-info": z.ZodOptional<z.ZodString>;
-                "x-request-count": z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
         };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+        readonly CREATE: {
+            readonly method: "post";
+            readonly path: "/";
+            readonly description: "Create new record";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                readonly body: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: TAnyObjectSchema;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+                readonly headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
                     };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
+                    };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
         };
-    };
-    readonly UPDATE_BY: {
-        readonly method: "patch";
-        readonly path: "/";
-        readonly description: "Bulk update records matching where condition";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
-            readonly query: TAnyObjectSchema | z.ZodObject<{
-                where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>;
-            }, z.core.$strip>;
-            readonly body: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: TAnyObjectSchema;
+        readonly UPDATE_BY_ID: {
+            readonly method: "patch";
+            readonly path: "/{id}";
+            readonly description: "Partial update record by ID";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                readonly params: z.ZodObject<{
+                    id: z.ZodString;
+                }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
+                    id: z.ZodCoercedNumber<unknown>;
+                }, z.core.$strip>;
+                readonly body: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: TAnyObjectSchema;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
+                readonly headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
             };
-            readonly headers: TAnyObjectSchema | z.ZodObject<{
-                "x-request-id": z.ZodOptional<z.ZodString>;
-                "x-request-channel": z.ZodOptional<z.ZodString>;
-                "x-device-info": z.ZodOptional<z.ZodString>;
-                "x-request-count": z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
-        };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: z.ZodArray<SelectSchema>;
-                        }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: z.ZodArray<SelectSchema>;
-                        }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
                     };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
+                    };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
         };
-    };
-    readonly DELETE_BY_ID: {
-        readonly method: "delete";
-        readonly path: "/{id}";
-        readonly description: "Delete record by ID (irreversible)";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
-            params: z.ZodObject<{
-                id: z.ZodString;
-            }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
-                id: z.ZodCoercedNumber<unknown>;
-            }, z.core.$strip>;
-            headers: TAnyObjectSchema | z.ZodObject<{
-                "x-request-id": z.ZodOptional<z.ZodString>;
-                "x-request-channel": z.ZodOptional<z.ZodString>;
-                "x-device-info": z.ZodOptional<z.ZodString>;
-                "x-request-count": z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
-        };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+        readonly UPDATE_BY: {
+            readonly method: "patch";
+            readonly path: "/";
+            readonly description: "Bulk update records matching where condition";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                readonly query: TAnyObjectSchema | z.ZodObject<{
+                    where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+                }, z.core.$strip>;
+                readonly body: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: TAnyObjectSchema;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: SelectSchema;
-                        }, z.core.$strip>, SelectSchema]>;
+                readonly headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: z.ZodArray<SelectSchema>;
+                            }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: z.ZodArray<SelectSchema>;
+                            }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
         };
-    };
-    readonly DELETE_BY: {
-        readonly method: "delete";
-        readonly path: "/";
-        readonly description: "Bulk delete records matching where condition (irreversible)";
-        readonly authenticate: {
-            strategies?: TAuthStrategy[];
-            mode?: TAuthMode;
-        };
-        readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
-        readonly request: {
-            query: TAnyObjectSchema | z.ZodObject<{
-                where: z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>;
-            }, z.core.$strip>;
-            headers: TAnyObjectSchema | z.ZodObject<{
-                "x-request-id": z.ZodOptional<z.ZodString>;
-                "x-request-channel": z.ZodOptional<z.ZodString>;
-                "x-device-info": z.ZodOptional<z.ZodString>;
-                "x-request-count": z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
-        };
-        readonly responses: {
-            200: {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: z.ZodArray<SelectSchema>;
-                        }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+        readonly DELETE_BY_ID: {
+            readonly method: "delete";
+            readonly path: "/{id}";
+            readonly description: "Delete record by ID (irreversible)";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                params: z.ZodObject<{
+                    id: z.ZodString;
+                }, z.core.$strip> | TAnyObjectSchema | z.ZodObject<{
+                    id: z.ZodCoercedNumber<unknown>;
+                }, z.core.$strip>;
+                headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
-            } | {
-                headers: import("../index.js").TResponseHeaders;
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodUnion<readonly [z.ZodObject<{
-                            count: z.ZodDefault<z.ZodNumber>;
-                            data: z.ZodArray<SelectSchema>;
-                        }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: SelectSchema;
+                            }, z.core.$strip>, SelectSchema]>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
-            "4xx | 5xx": {
-                description: string;
-                content: {
-                    'application/json': {
-                        schema: z.ZodObject<{
-                            statusCode: z.ZodOptional<z.ZodNumber>;
-                            message: z.ZodString;
-                            normalized: z.ZodOptional<z.ZodObject<{
-                                text: z.ZodString;
-                                code: z.ZodString;
-                                args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                            }, z.core.$strip>>;
-                            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                            requestId: z.ZodOptional<z.ZodString>;
-                            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                        }, z.core.$strip>;
+        };
+        readonly DELETE_BY: {
+            readonly method: "delete";
+            readonly path: "/";
+            readonly description: "Bulk delete records matching where condition (irreversible)";
+            readonly authenticate: {
+                strategies?: TAuthStrategy[];
+                mode?: TAuthMode;
+            };
+            readonly authorize: IAuthorizationSpec<import("hono").Env, string, string> | IAuthorizationSpec<import("hono").Env, string, string>[] | undefined;
+            readonly request: {
+                readonly headers: TAnyObjectSchema | z.ZodObject<{
+                    "x-request-id": z.ZodOptional<z.ZodString>;
+                    "x-request-channel": z.ZodOptional<z.ZodString>;
+                    "x-device-info": z.ZodOptional<z.ZodString>;
+                    "x-request-count": z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                readonly body?: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: TAnyObjectSchema;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | undefined;
+                readonly query: TAnyObjectSchema | z.ZodObject<{
+                    where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+                }, z.core.$strip>;
+            };
+            readonly responses: {
+                '4XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                '5XX': {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodObject<{
+                                statusCode: z.ZodOptional<z.ZodNumber>;
+                                message: z.ZodString;
+                                normalized: z.ZodOptional<z.ZodObject<{
+                                    text: z.ZodString;
+                                    code: z.ZodString;
+                                    args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                                }, z.core.$strip>>;
+                                extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                                requestId: z.ZodOptional<z.ZodString>;
+                                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                            }, z.core.$strip>;
+                        };
+                    };
+                    required: boolean | undefined;
+                };
+                200: {
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: z.ZodArray<SelectSchema>;
+                            }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                        };
+                    };
+                    required: boolean | undefined;
+                } | {
+                    headers: import("../index.js").TResponseHeaders;
+                    description: string;
+                    content: {
+                        'application/json': {
+                            schema: z.ZodUnion<readonly [z.ZodObject<{
+                                count: z.ZodDefault<z.ZodNumber>;
+                                data: z.ZodArray<SelectSchema>;
+                            }, z.core.$strip>, z.ZodArray<SelectSchema>]>;
+                        };
                     };
+                    required: boolean | undefined;
                 };
-                required: boolean | undefined;
             };
         };
     };
-};
+}
+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