@venizia/ignis-kernel 0.2.0-4 → 0.2.0-41

package/dist/esm/base/metadata/routes/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAI1D,CAAC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAO1D,CAAC"}

package/dist/esm/base/metadata/routes/controller.js

@@ -1,6 +1,8 @@
-import { MetadataRegistry } from '../../../helpers/inversion/index.js';
+import { ArtifactTypes, MetadataRegistry } from '../../../helpers/inversion/index.js';
+import { injectable, pickRegistrationOptions } from '../injectable.js';
 export const controller = (metadata) => {
     return target => {
+        injectable({ type: ArtifactTypes.CONTROLLER, ...pickRegistrationOptions({ metadata }) })(target);
         MetadataRegistry.getInstance().setControllerMetadata({ target, metadata });
     };
 };

package/dist/esm/base/metadata/routes/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAA6B,EAAkB,EAAE;IAC1E,OAAO,MAAM,CAAC,EAAE;QACd,gBAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAEpE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAA6B,EAAkB,EAAE;IAC1E,OAAO,MAAM,CAAC,EAAE;QACd,UAAU,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,GAAG,uBAAuB,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CACtF,MAAM,CACP,CAAC;QACF,gBAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/base/metadata/routes/rpc.d.ts

@@ -1,4 +1,4 @@
-import type { IRpcMetadata } from '../../../helpers/inversion/common/types.js';
+import type { IRpcMetadata } from '../../../helpers/inversion/common/types/index.js';
 /** Generic RPC decorator. Registers RPC config in metadata registry. */
 export declare const rpc: <RpcRouteConfigType extends IRpcMetadata>(opts: {
     configs: RpcRouteConfigType;

package/dist/esm/base/middlewares/app-error/common/index.d.ts

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

package/dist/esm/base/middlewares/app-error/common/index.d.ts.map

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

package/dist/esm/base/middlewares/app-error/common/index.js

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

package/dist/esm/base/middlewares/app-error/common/index.js.map

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

package/dist/esm/base/middlewares/app-error/{types.d.ts → common/types.d.ts}

@@ -1,5 +1,5 @@
 import type { TConstValue } from '@venizia/ignis-helpers/common';
-import type { ApplicationErrorTypes } from './definition.js';
+import type { ApplicationErrorTypes } from '../definition.js';
 export interface IDatabaseError extends Error {
     code?: string;
     cause?: {

package/dist/esm/base/middlewares/app-error/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/base/middlewares/app-error/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC1E,qFAAqF;IACrF,IAAI,EAAE,qBAAqB,CAAC;CAC7B"}

package/dist/esm/base/middlewares/app-error/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/base/middlewares/app-error/common/types.ts"],"names":[],"mappings":""}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,54 @@
+import type { Binding } from '../../../helpers/inversion/index.js';
+import type { TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { IApplication, TArtifactIndexInput } from '../../applications/index.js';
+import type { BaseComponent } from '../../components/index.js';
+import type { BaseConfiguration } from '../../configurations/index.js';
+import type { IDataSource } from '../../datasources/index.js';
+import type { IRepository } from '../../repositories/index.js';
+import type { IService } from '../../services/index.js';
+/** Options of the registration itself, never of the artifact - what the artifact needs goes on its class. */
+export type TMixinOpts<Options extends object = {}> = {
+    binding?: {
+        namespace: string;
+        key: string;
+    };
+    /** Default true, matching `bind()`'s overwrite behavior; false makes a same-key re-registration throw. */
+    allowOverride?: boolean;
+    /** Options passed directly to `instance.configure(options)` during initialization. */
+    options?: Options;
+};
+export interface IConfigurationMixin {
+    configuration<Base extends BaseConfiguration<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
+    registerConfigurations(): ValueOrPromise<void>;
+}
+export interface IComponentMixin {
+    component<Base extends BaseComponent<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
+    registerComponents(): ValueOrPromise<void>;
+}
+export interface IServerConfigMixin {
+    staticConfigure(): ValueOrPromise<void>;
+    preConfigure(): ValueOrPromise<void>;
+    postConfigure(): ValueOrPromise<void>;
+    getApplicationVersion(): ValueOrPromise<string>;
+}
+export interface IControllerMixin {
+    controller<Base>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+    registerControllers(): ValueOrPromise<void>;
+}
+export interface IRepositoryMixin {
+    dataSource<Base extends IDataSource<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
+    repository<Base extends IRepository>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+}
+export interface IServiceMixin {
+    service<Base extends IService>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
+}
+export interface IArtifactRegistrationMixin {
+    registerArtifacts(index: TArtifactIndexInput): Promise<void>;
+}
+export interface IStaticServeMixin {
+    static(opts: {
+        restPath?: string;
+        folderPath: string;
+    }): IApplication;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/base/mixins/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/base/mixins/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,6GAA6G;AAC7G,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,MAAM,GAAG,EAAE,IAAI;IACpD,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,0GAA0G;IAC1G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,IAAI,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,MAAM,GAAG,EAAE,EAChF,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EACpB,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,sBAAsB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,IAAI,SAAS,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,MAAM,GAAG,EAAE,EACxE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EACpB,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,kBAAkB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,qBAAqB,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,mBAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,IAAI,SAAS,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,MAAM,GAAG,EAAE,EACvE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EACpB,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,IAAI,SAAS,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9F;AACD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,IAAI,SAAS,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;CACvE"}

package/dist/esm/base/mixins/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/mixins/common/types.ts"],"names":[],"mappings":""}

package/dist/esm/base/mixins/index.d.ts

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

package/dist/esm/base/mixins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/mixins/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/mixins/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/esm/base/mixins/index.js

@@ -1,2 +1,2 @@
-export * from './types.js';
+export * from './common/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/base/mixins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/mixins/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/mixins/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

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

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

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

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

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

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

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

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

package/dist/{cjs/base/models/common/types.d.ts → esm/base/models/common/schemas.d.ts}

@@ -1,4 +1,5 @@
 import { z } from '@hono/zod-openapi';
+import type { TIdSchemaType } from './types/index.js';
 /**
  * Local copy of `@venizia/ignis-helpers`'s error response schema - kept out of that package's
  * `/core` subpath on purpose (it would force `@hono/zod-openapi` on every non-REST consumer of the
@@ -17,12 +18,6 @@ export declare const ErrorSchema: z.ZodObject<{
     requestId: z.ZodOptional<z.ZodString>;
     details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
-export type NumberIdType = number;
-export type StringIdType = string;
-export type BigIntIdType = bigint;
-export type IdType = NumberIdType | StringIdType | BigIntIdType;
-/** Path-param id shape every entity family resolves to (`AbstractEntity.getIdType()`). */
-export type TIdSchemaType = 'number' | 'string';
 export declare const idParamsSchema: (opts?: {
     idType: TIdSchemaType;
 }) => z.ZodObject<{
@@ -99,10 +94,5 @@ export declare const jsonResponse: <ContentSchema extends z.ZodType, HeaderSchem
         required: boolean | undefined;
     };
 };
-type TSnakeToCamelCase<S extends string> = S extends `${infer T}_${infer U}` ? `${T}${Capitalize<TSnakeToCamelCase<U>>}` : S;
-type TCamelCaseKeys<T extends z.ZodRawShape> = {
-    [K in keyof T as K extends string ? TSnakeToCamelCase<K> : K]: T[K] extends z.ZodType<infer U> ? z.ZodType<U> : T[K];
-};
-export declare const snakeToCamel: <T extends z.ZodRawShape>(shape: T) => z.ZodPipe<z.ZodPipe<z.ZodObject<{ -readonly [P in keyof T]: T[P]; }, z.core.$strip>, z.ZodTransform<any, z.core.$InferObjectOutput<{ -readonly [P in keyof T]: T[P]; }, {}>>>, z.ZodObject<TCamelCaseKeys<T> extends infer T_1 ? { -readonly [P_1 in keyof T_1]: T_1[P_1]; } : never, z.core.$strip>>;
 export {};
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=schemas.d.ts.map

package/dist/esm/base/models/common/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE;;;;iBAkC9D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM;IACrD,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;CAMA,CAAC;AAEF,mCAAmC;AACnC,KAAK,aAAa,GAAG;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,4CAA4C;AAC5C,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEtD,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,gBAAgB,GAAG,SAAS,IAAI;IACpF,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAa,SAAS,CAAC,CAAC,OAAO,EAC/B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcrD,CAAC"}

package/dist/esm/base/models/common/{types.js → schemas.js}

@@ -1,6 +1,6 @@
 import { z } from '@hono/zod-openapi';
-import { getError, keysToCamel, toCamel } from '@venizia/ignis-helpers/core';
 import { HTTP } from '@venizia/ignis-helpers/common';
+import { getError } from '@venizia/ignis-helpers/core';
 /**
  * Local copy of `@venizia/ignis-helpers`'s error response schema - kept out of that package's
  * `/core` subpath on purpose (it would force `@hono/zod-openapi` on every non-REST consumer of the
@@ -90,13 +90,4 @@ export const jsonResponse = (opts) => {
         ['4xx | 5xx']: jsonContent({ description: 'Error Response', schema: ErrorSchema }),
     };
 };
-export const snakeToCamel = (shape) => {
-    const camelShape = Object.fromEntries(Object.entries(shape).map(([key, value]) => {
-        return [toCamel(key), value];
-    }));
-    return z
-        .object(shape)
-        .transform(data => keysToCamel(data))
-        .pipe(z.object(camelShape));
-};
-//# sourceMappingURL=types.js.map
+//# sourceMappingURL=schemas.js.map

package/dist/esm/base/models/common/schemas.js.map

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

package/dist/esm/base/models/common/types/id.d.ts

@@ -0,0 +1,24 @@
+export type NumberIdType = number;
+export type StringIdType = string;
+export type BigIntIdType = bigint;
+export type IdType = NumberIdType | StringIdType | BigIntIdType;
+declare const entityIdBrand: unique symbol;
+/**
+ * A string id a plain `string` cannot be assigned to, so passing a name, code or email where an id
+ * belongs is a compile error. Opt a column in with `.$type<TEntityId>()`.
+ *
+ * IT VALIDATES NOTHING. `toEntityId` is a cast with a non-empty check; the value is making the
+ * laundering VISIBLE at each boundary, not proving the string is a real id.
+ *
+ * The cost is not optional: Drizzle derives `$inferInsert` and `$inferSelect` from the same field,
+ * so a branded column rejects every literal - `create({ data: { merchantId: 'M1' } })`, seeds,
+ * fixtures, path params - until each converts. A union with `string` would restore those but makes
+ * a plain `string` assignable again, which erases the whole guarantee. Measured, not assumed.
+ */
+export type TEntityId = string & {
+    readonly [entityIdBrand]: never;
+};
+/** Path-param id shape every entity family resolves to (`AbstractEntity.getIdType()`). */
+export type TIdSchemaType = 'number' | 'string';
+export {};
+//# sourceMappingURL=id.d.ts.map

package/dist/esm/base/models/common/types/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEhE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAErE,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC"}

package/dist/esm/base/models/common/types/id.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=id.js.map

package/dist/esm/base/models/common/types/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":""}

package/dist/esm/base/models/common/types/index.d.ts

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

package/dist/esm/base/models/common/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC"}

package/dist/esm/base/models/common/types/index.js

@@ -0,0 +1,2 @@
+export * from './id.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/models/common/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC"}

package/dist/esm/base/models/common/utilities.d.ts

@@ -0,0 +1,13 @@
+import { z } from '@hono/zod-openapi';
+import type { TEntityId } from './types/index.js';
+/** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
+export declare const toEntityId: (opts: {
+    value: string;
+}) => TEntityId;
+type TSnakeToCamelCase<S extends string> = S extends `${infer T}_${infer U}` ? `${T}${Capitalize<TSnakeToCamelCase<U>>}` : S;
+type TCamelCaseKeys<T extends z.ZodRawShape> = {
+    [K in keyof T as K extends string ? TSnakeToCamelCase<K> : K]: T[K] extends z.ZodType<infer U> ? z.ZodType<U> : T[K];
+};
+export declare const snakeToCamel: <T extends z.ZodRawShape>(shape: T) => z.ZodPipe<z.ZodPipe<z.ZodObject<{ -readonly [P in keyof T]: T[P]; }, z.core.$strip>, z.ZodTransform<any, z.core.$InferObjectOutput<{ -readonly [P in keyof T]: T[P]; }, {}>>>, z.ZodObject<TCamelCaseKeys<T> extends infer T_1 ? { -readonly [P_1 in keyof T_1]: T_1[P_1]; } : never, z.core.$strip>>;
+export {};
+//# sourceMappingURL=utilities.d.ts.map

package/dist/esm/base/models/common/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,uHAAuH;AACvH,eAAO,MAAM,UAAU,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,SAMpD,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GACxE,GAAG,CAAC,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,GACzC,CAAC,CAAC;AAEN,KAAK,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,IAAI;KAC5C,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAC1F,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACZ,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,0SAW7D,CAAC"}

package/dist/esm/base/models/common/utilities.js

@@ -0,0 +1,19 @@
+import { z } from '@hono/zod-openapi';
+import { getError, keysToCamel, toCamel } from '@venizia/ignis-helpers/core';
+/** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
+export const toEntityId = (opts) => {
+    if (opts.value.length === 0) {
+        throw getError({ message: '[toEntityId] Refusing an empty string as an entity id' });
+    }
+    return opts.value;
+};
+export const snakeToCamel = (shape) => {
+    const camelShape = Object.fromEntries(Object.entries(shape).map(([key, value]) => {
+        return [toCamel(key), value];
+    }));
+    return z
+        .object(shape)
+        .transform(data => keysToCamel(data))
+        .pipe(z.object(camelShape));
+};
+//# sourceMappingURL=utilities.js.map

package/dist/esm/base/models/common/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAG7E,uHAAuH;AACvH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAa,EAAE;IAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,IAAI,CAAC,KAAkB,CAAC;AACjC,CAAC,CAAC;AAYF,MAAM,CAAC,MAAM,YAAY,GAAG,CAA0B,KAAQ,EAAE,EAAE;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACzC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC,CACkB,CAAC;IAEvB,OAAO,CAAC;SACL,MAAM,CAAC,KAAK,CAAC;SACb,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC"}

package/dist/esm/base/repositories/common/constants.d.ts

@@ -23,6 +23,32 @@ export declare class RepositoryOperationScopes {
 }
 /** Valid repository operation scope values. */
 export type TRepositoryOperationScope = TConstValue<typeof RepositoryOperationScopes>;
+/** What a row-scope filter (`@model` settings.scopeFilter) does when `resolve()` returns null/undefined. */
+export declare class ScopeFilterMissingBehaviors {
+    /** An unresolved scope matches ZERO rows - the safe reading of "caller's scope is unknown". */
+    static readonly DENY = "deny";
+    /** Explicit opt-out: no scope is applied. For migrations and background jobs, never inferred from a request. */
+    static readonly ALLOW = "allow";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(behavior: string): boolean;
+}
+/** Valid scope-filter missing-behavior values. */
+export type TScopeFilterMissingBehavior = TConstValue<typeof ScopeFilterMissingBehaviors>;
+/**
+ * The third `resolve()` state, beside a `where` and `deny`-by-default null/undefined: unrestricted
+ * for THIS call. `onMissing: 'allow'` cannot express it - `onMissing` lives on the model's static
+ * settings, so using it for a per-user bypass (an internal operator) would also unscope every
+ * ordinary user whose `resolve()` happens to return nothing.
+ */
+export declare class ScopeFilters {
+    /**
+     * Return from `resolve()` to apply NO scope for this request - a caller the application has
+     * decided sees everything. Deliberately a symbol: forgetting to return must land in deny, and no
+     * JSON body, query string, or header can ever produce this value. `Symbol.for` so two installed
+     * copies of this package agree on identity, same as `DATA_SOURCE_BRAND`.
+     */
+    static readonly UNRESTRICTED: unique symbol;
+}
 /** Machine-readable codes for repository-level failures, in the dotted namespace core already uses (`core.not_supported`, `core.search_engine.*`) - a client maps the code, never the message. */
 export declare class RepositoryErrorCodes {
     /** A verb the repository's `operationScope` does not permit (e.g. `create()` on a READ_ONLY one). */

package/dist/esm/base/repositories/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,uDAAuD;AACvD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,gGAAgG;AAChG,qBAAa,yBAAyB;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA+D;IAEzF,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,+CAA+C;AAC/C,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEtF,kMAAkM;AAClM,qBAAa,oBAAoB;IAC/B,qGAAqG;IACrG,MAAM,CAAC,QAAQ,CAAC,qBAAqB,SAElC;CACJ;AAED,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E,mEAAmE;AACnE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkC;IAE5D,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,yEAAyE;AACzE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAKvB;IAEH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C;AAED,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,uDAAuD;AACvD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,gGAAgG;AAChG,qBAAa,yBAAyB;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA+D;IAEzF,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,+CAA+C;AAC/C,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEtF,4GAA4G;AAC5G,qBAAa,2BAA2B;IACtC,+FAA+F;IAC/F,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,gHAAgH;IAChH,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAoC;IAE9D,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C;AAED,kDAAkD;AAClD,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE1F;;;;;GAKG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,YAAY,gBAAiE;CAC9F;AAED,kMAAkM;AAClM,qBAAa,oBAAoB;IAC/B,qGAAqG;IACrG,MAAM,CAAC,QAAQ,CAAC,qBAAqB,SAElC;CACJ;AAED,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E,mEAAmE;AACnE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkC;IAE5D,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,yEAAyE;AACzE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAKvB;IAEH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C;AAED,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC"}

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

@@ -23,6 +23,32 @@ export class RepositoryOperationScopes {
         return this.SCHEME_SET.has(orgType);
     }
 }
+/** What a row-scope filter (`@model` settings.scopeFilter) does when `resolve()` returns null/undefined. */
+export class ScopeFilterMissingBehaviors {
+    /** An unresolved scope matches ZERO rows - the safe reading of "caller's scope is unknown". */
+    static { this.DENY = 'deny'; }
+    /** Explicit opt-out: no scope is applied. For migrations and background jobs, never inferred from a request. */
+    static { this.ALLOW = 'allow'; }
+    static { this.SCHEME_SET = new Set([this.DENY, this.ALLOW]); }
+    static isValid(behavior) {
+        return this.SCHEME_SET.has(behavior);
+    }
+}
+/**
+ * The third `resolve()` state, beside a `where` and `deny`-by-default null/undefined: unrestricted
+ * for THIS call. `onMissing: 'allow'` cannot express it - `onMissing` lives on the model's static
+ * settings, so using it for a per-user bypass (an internal operator) would also unscope every
+ * ordinary user whose `resolve()` happens to return nothing.
+ */
+export class ScopeFilters {
+    /**
+     * Return from `resolve()` to apply NO scope for this request - a caller the application has
+     * decided sees everything. Deliberately a symbol: forgetting to return must land in deny, and no
+     * JSON body, query string, or header can ever produce this value. `Symbol.for` so two installed
+     * copies of this package agree on identity, same as `DATA_SOURCE_BRAND`.
+     */
+    static { this.UNRESTRICTED = Symbol.for('@venizia/ignis-kernel:scope-filter-unrestricted'); }
+}
 /** Machine-readable codes for repository-level failures, in the dotted namespace core already uses (`core.not_supported`, `core.search_engine.*`) - a client maps the code, never the message. */
 export class RepositoryErrorCodes {
     /** A verb the repository's `operationScope` does not permit (e.g. `create()` on a READ_ONLY one). */

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,gGAAgG;AAChG,MAAM,OAAO,yBAAyB;aACpB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzF,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAMH,kMAAkM;AAClM,MAAM,OAAO,oBAAoB;IAC/B,qGAAqG;aACrF,0BAAqB,GAAG,WAAW,CAAC,KAAK,CAAC;QACxD,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,uBAAuB,CAAC;KACvD,CAAC,CAAC;;AAML,mEAAmE;AACnE,MAAM,OAAO,aAAa;aACR,QAAG,GAAG,KAAK,CAAC;aACZ,SAAI,GAAG,MAAM,CAAC;aACd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5D,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAMH,yEAAyE;AACzE,MAAM,OAAO,aAAa;aACR,WAAM,GAAG,QAAQ,CAAC;aAClB,kBAAa,GAAG,eAAe,CAAC;aAChC,UAAK,GAAG,OAAO,CAAC;aAChB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,SAAS;KACf,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,gGAAgG;AAChG,MAAM,OAAO,yBAAyB;aACpB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzF,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAMH,4GAA4G;AAC5G,MAAM,OAAO,2BAA2B;IACtC,+FAA+F;aAC/E,SAAI,GAAG,MAAM,CAAC;IAC9B,gHAAgH;aAChG,UAAK,GAAG,OAAO,CAAC;aAChB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9D,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;;AAMH;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;OAKG;aACa,iBAAY,GAAG,MAAM,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;;AAG/F,kMAAkM;AAClM,MAAM,OAAO,oBAAoB;IAC/B,qGAAqG;aACrF,0BAAqB,GAAG,WAAW,CAAC,KAAK,CAAC;QACxD,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,uBAAuB,CAAC;KACvD,CAAC,CAAC;;AAML,mEAAmE;AACnE,MAAM,OAAO,aAAa;aACR,QAAG,GAAG,KAAK,CAAC;aACZ,SAAI,GAAG,MAAM,CAAC;aACd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5D,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAMH,yEAAyE;AACzE,MAAM,OAAO,aAAa;aACR,WAAM,GAAG,QAAQ,CAAC;aAClB,kBAAa,GAAG,eAAe,CAAC;aAChC,UAAK,GAAG,OAAO,CAAC;aAChB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,SAAS;KACf,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC"}

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

@@ -3,5 +3,5 @@ export * from '@venizia/ignis-filter';
 export * from './errors.js';
 export * from '../query-schemas/index.js';
 export * from './constants.js';
-export * from './types.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -3,5 +3,5 @@ export * from '@venizia/ignis-filter';
 export * from './errors.js';
 export * from '../query-schemas/index.js';
 export * from './constants.js';
-export * from './types.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/base/repositories/common/{types.d.ts → types/contracts.d.ts}

@@ -1,117 +1,9 @@
-import type { AbstractDataSource, ITransaction } from '../../../base/datasources/index.js';
-import type { AbstractEntity, IdType } from '../../../base/models/index.js';
-import { z } from '@hono/zod-openapi';
+import type { AbstractDataSource } from '../../../datasources/index.js';
+import type { AbstractEntity, IdType } from '../../../models/index.js';
 import type { TFilter, TWhere } from '@venizia/ignis-filter';
-import type { TLogLevel } from '@venizia/ignis-helpers/core';
-import type { AnyType, TNullable } from '@venizia/ignis-helpers/common';
-import type { IRetryBackoffOptions } from '@venizia/ignis-helpers/core';
-import type { Column, SQL } from 'drizzle-orm';
-import type { TLockStrength } from './constants.js';
-/** Update data supporting both regular fields and JSON path updates via dot notation. */
-export type TUpdateData<T = any> = Partial<T> & {
-    [jsonPath: string]: any;
-};
-/** Zod schema for count operation results. */
-export declare const CountSchema: z.ZodObject<{
-    count: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export type TCount = z.infer<typeof CountSchema>;
-/** Data range information for paginated queries. Follows HTTP Content-Range standard. */
-export type TDataRange = {
-    start: number;
-    end: number;
-    total: number;
-};
-/** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */
-export declare const buildDataRange: (opts: {
-    skip?: number;
-    offset?: number;
-    dataLength: number;
-    total: number;
-}) => TDataRange;
-/** Options for Drizzle ORM query building, used internally by FilterBuilder. */
-export type TDrizzleQueryOptions = Partial<{
-    limit: number;
-    offset: number;
-    orderBy: SQL[];
-    where: SQL;
-    with: Record<string, true | TDrizzleQueryOptions>;
-    columns: Record<string, boolean>;
-}>;
-/** Configuration for repository operation logging. */
-export type TRepositoryLogOptions = {
-    use: boolean;
-    level?: TLogLevel;
-};
-/** Configuration for row-level lock wait behavior. Mutually exclusive: use noWait OR skipLocked. */
-export type TLockConfig = {
-    noWait: true;
-    skipLocked?: undefined;
-} | {
-    noWait?: undefined;
-    skipLocked: true;
-} | {
-    noWait?: undefined;
-    skipLocked?: undefined;
-};
-/** Row-level locking options for read operations. */
-export type TLockOptions = {
-    strength: TLockStrength;
-    config?: TLockConfig;
-};
-/** Neutral transaction association - postgres narrows to its own `IDatabaseTransaction` (via `isDatabaseTransaction`) where it needs `.connector`. */
-export interface IWithTransaction {
-    transaction?: ITransaction;
-}
-/** Extended options for repository operations with transaction, logging, and default filter bypass. */
-export interface IExtraOptions extends IWithTransaction {
-    log?: TRepositoryLogOptions;
-    /** If true, bypass the default filter configured in model settings (e.g., soft delete). */
-    shouldSkipDefaultFilter?: boolean;
-    /** Row-level locking. Requires transaction. Incompatible with include/fields (Query API). */
-    lock?: TLockOptions;
-}
-/**
- * Read-after-write retry for read verbs behind a replicated pool. The read re-executes while
- * `until(result)` returns false; on exhaustion the last result is returned as-is.
- */
-export interface IReadRetryOptions<TResult> {
-    /** Default 3. */
-    maxAttempts?: number;
-    /** Total budget across attempts AND sleeps. Default: unlimited. */
-    maxTotalMs?: number;
-    /**
-     * Aborts between attempts and during backoff sleeps - pass the request signal so a cancelled
-     * request stops retrying.
-     */
-    signal?: AbortSignal;
-    /** Default: EXPONENTIAL from 50ms, capped at 500ms, EQUAL jitter - tuned for replica lag. */
-    backoff?: IRetryBackoffOptions;
-    /** Retry while false. Default per verb: findOne/findById non-null, find non-empty. */
-    until?: (result: TResult) => boolean;
-}
-/**
- * Intersected into READ verb signatures only - a write verb's options type has no `retry`, so an
- * inline `{ retry }` fails to compile and a pre-built object carrying it is inert.
- */
-export interface IWithReadRetry<TResult> {
-    retry?: IReadRetryOptions<TResult>;
-}
-/** The `shouldQueryRange: true` result envelope. */
-export type TDataWithRange<R> = {
-    data: Array<R>;
-    range: TDataRange;
-};
-/** Options for `find` returning a plain array - the retry predicate sees `Array<R>`. */
-export type TFindOptions<TOptions extends IExtraOptions, R> = TOptions & {
-    shouldQueryRange?: false;
-} & IWithReadRetry<Array<R>>;
-/** Options for `find` with the range envelope - the retry predicate sees `{ data, range }`. */
-export type TFindRangeOptions<TOptions extends IExtraOptions, R> = TOptions & {
-    shouldQueryRange: true;
-} & IWithReadRetry<TDataWithRange<R>>;
-/** Options for `findOne`/`findById` - the retry predicate sees `TNullable<R>`. */
-export type TFindOneOptions<TOptions extends IExtraOptions, R> = TOptions & IWithReadRetry<TNullable<R>>;
+import type { TNullable } from '@venizia/ignis-helpers/common';
+import type { IExtraOptions, TFindOneOptions, TFindOptions, TFindRangeOptions } from './options.js';
+import type { TCount, TDataWithRange } from './results.js';
 /**
  * Base repository interface shared by every engine - engine-specific accessors (postgres's
  * `getEntitySchema()`/`getConnector()`) stay on the connector's own repository tier.
@@ -313,19 +205,4 @@ export interface IPersistableRepository<TDataObject extends object = object, TPe
  */
 export interface ICrudRepository<TDataObject extends object = object, TPersistObject extends object = TDataObject, ExtraOptions extends IExtraOptions = IExtraOptions> extends IPersistableRepository<TDataObject, TPersistObject, ExtraOptions> {
 }
-/** Options passed to query operator handler functions. */
-export interface IQueryHandlerOptions<T = any> {
-    column: Column;
-    value: T;
-}
-/**
- * Operator-name to SQL-handler table a relational dialect translates with, so a second SQL engine
- * swaps the whole table without touching the walk that reaches it. `column` is wider than
- * `IQueryHandlerOptions` names it: the JSON-path branch hands handlers a raw `#>>` extraction
- * expression, not a `Column`.
- */
-export type TQueryOperatorHandlers = Record<string, (opts: {
-    column: AnyType;
-    value: AnyType;
-}) => SQL | undefined>;
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=contracts.d.ts.map