@venizia/ignis-kernel 0.2.0-3 → 0.2.0-31

package/dist/esm/helpers/inversion/common/constants.d.ts

@@ -0,0 +1,13 @@
+/** What a decorated class is to the application - the one fact the artifact generator and the registration methods both read. */
+export declare class ArtifactTypes {
+    static readonly CONFIGURATION = "configuration";
+    static readonly COMPONENT = "component";
+    static readonly CONTROLLER = "controller";
+    static readonly SERVICE = "service";
+    static readonly REPOSITORY = "repository";
+    static readonly DATASOURCE = "datasource";
+    static readonly MODEL = "model";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/helpers/inversion/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/constants.ts"],"names":[],"mappings":"AAAA,iIAAiI;AACjI,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAEhC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAQvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC"}

package/dist/esm/helpers/inversion/common/constants.js

@@ -0,0 +1,23 @@
+/** What a decorated class is to the application - the one fact the artifact generator and the registration methods both read. */
+export class ArtifactTypes {
+    static { this.CONFIGURATION = 'configuration'; }
+    static { this.COMPONENT = 'component'; }
+    static { this.CONTROLLER = 'controller'; }
+    static { this.SERVICE = 'service'; }
+    static { this.REPOSITORY = 'repository'; }
+    static { this.DATASOURCE = 'datasource'; }
+    static { this.MODEL = 'model'; }
+    static { this.SCHEME_SET = new Set([
+        this.CONFIGURATION,
+        this.COMPONENT,
+        this.CONTROLLER,
+        this.SERVICE,
+        this.REPOSITORY,
+        this.DATASOURCE,
+        this.MODEL,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+//# sourceMappingURL=constants.js.map

package/dist/esm/helpers/inversion/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/constants.ts"],"names":[],"mappings":"AAAA,iIAAiI;AACjI,MAAM,OAAO,aAAa;aACR,kBAAa,GAAG,eAAe,CAAC;aAChC,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,YAAY,CAAC;aAC1B,YAAO,GAAG,SAAS,CAAC;aACpB,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,YAAY,CAAC;aAC1B,UAAK,GAAG,OAAO,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,UAAU;QACf,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,UAAU;QACf,IAAI,CAAC,UAAU;QACf,IAAI,CAAC,KAAK;KACX,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC"}

package/dist/esm/helpers/inversion/common/index.d.ts

@@ -1,4 +1,5 @@
+export * from './constants.js';
 export * from './keys.js';
 export * from './relation-builder.js';
-export * from './types.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/helpers/inversion/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/esm/helpers/inversion/common/index.js

@@ -1,4 +1,5 @@
+export * from './constants.js';
 export * from './keys.js';
 export * from './relation-builder.js';
-export * from './types.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/helpers/inversion/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/esm/helpers/inversion/common/keys.d.ts

@@ -1,6 +1,7 @@
 export declare const MetadataKeys: {
     PROPERTIES: symbol;
     INJECT: symbol;
+    BINDING_KEY: symbol;
 } & {
     CONTROLLER: symbol;
     CONTROLLER_REST_ROUTE: symbol;
@@ -8,5 +9,7 @@ export declare const MetadataKeys: {
     MODEL: symbol;
     DATASOURCE: symbol;
     REPOSITORY: symbol;
+    ARTIFACT: symbol;
+    PROVIDES: symbol;
 };
 //# sourceMappingURL=keys.d.ts.map

package/dist/esm/helpers/inversion/common/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;CAQvB,CAAC"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAWvB,CAAC"}

package/dist/esm/helpers/inversion/common/keys.js

@@ -6,5 +6,7 @@ export const MetadataKeys = Object.assign({}, _MetadataKeys, {
     MODEL: Symbol.for('ignis:model'),
     DATASOURCE: Symbol.for('ignis:datasource'),
     REPOSITORY: Symbol.for('ignis:repository'),
+    ARTIFACT: Symbol.for('ignis:artifact'),
+    PROVIDES: Symbol.for('ignis:provides'),
 });
 //# sourceMappingURL=keys.js.map

package/dist/esm/helpers/inversion/common/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1C,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC;IAChE,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC;IAEhE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;CAC3C,CAAC,CAAC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/common/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1C,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC;IAChE,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC;IAEhE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAE1C,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;CACvC,CAAC,CAAC"}

package/dist/esm/helpers/inversion/common/types/artifact.d.ts

@@ -0,0 +1,34 @@
+import type { TClass, TConstValue, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { TBindingScope } from '@venizia/ignis-inversion';
+import { ArtifactTypes } from '../constants.js';
+/** Decorator target for any constructable class (includes Function for ClassDecorator). */
+export type TDecoratorTarget<T = unknown> = TClass<T> | Function;
+export type TArtifactType = TConstValue<typeof ArtifactTypes>;
+/** Decides at registration time whether the class is registered at all. Sync or async; runs before `preConfigure`, so it may read config and env, never another artifact's binding. */
+export type TArtifactCondition<ApplicationType = unknown> = (opts: {
+    application: ApplicationType;
+}) => ValueOrPromise<boolean>;
+/** Registration defaults a class carries for itself; an explicit `TMixinOpts` at the call site still wins. */
+export interface IArtifactRegistrationOptions<ApplicationType = unknown> {
+    binding?: {
+        namespace: string;
+        key: string;
+    };
+    allowOverride?: boolean;
+    scope?: TBindingScope;
+    /** Lower registers first within its kind. Default 0; ties keep index order. */
+    order?: number;
+    when?: TArtifactCondition<ApplicationType>;
+    /** Topological ordering for configurations: must run after these configuration classes. */
+    after?: ReadonlyArray<TClass<unknown>>;
+}
+export interface IArtifactMetadata<ApplicationType = unknown> extends IArtifactRegistrationOptions<ApplicationType> {
+    type: TArtifactType;
+}
+/** One `@provide` method: the key it binds, and the binding scope of the value (default SINGLETON). */
+export interface IProvideMetadata {
+    methodName: string | symbol;
+    key: string;
+    scope?: TBindingScope;
+}
+//# sourceMappingURL=artifact.d.ts.map

package/dist/esm/helpers/inversion/common/types/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,uLAAuL;AACvL,MAAM,MAAM,kBAAkB,CAAC,eAAe,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE;IACjE,WAAW,EAAE,eAAe,CAAC;CAC9B,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;AAE9B,8GAA8G;AAC9G,MAAM,WAAW,4BAA4B,CAAC,eAAe,GAAG,OAAO;IACrE,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC3C,2FAA2F;IAC3F,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB,CAChC,eAAe,GAAG,OAAO,CACzB,SAAQ,4BAA4B,CAAC,eAAe,CAAC;IACrD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,uGAAuG;AACvG,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/dist/esm/helpers/inversion/common/types/artifact.js

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

package/dist/esm/helpers/inversion/common/types/artifact.js.map

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

package/dist/esm/helpers/inversion/common/types/controller.d.ts

@@ -0,0 +1,33 @@
+import type { TAuthMode, TAuthStrategy } from '../../../../base/auth/authenticate/common/index.js';
+import type { IAuthorizationSpec } from '../../../../base/auth/authorize/common/types/index.js';
+import type { ControllerTransports } from '../../../../base/controllers/common/constants.js';
+import type { TGrpcMethod } from '@venizia/ignis-helpers/common';
+import type { IArtifactRegistrationOptions } from './artifact.js';
+interface IBaseControllerMetadata extends IArtifactRegistrationOptions {
+    path: string;
+    tags?: string[];
+    description?: string;
+}
+export interface IRestControllerMetadata extends IBaseControllerMetadata {
+    transport?: typeof ControllerTransports.REST;
+}
+export interface IGrpcControllerMetadata<ServiceType = unknown> extends IBaseControllerMetadata {
+    transport: typeof ControllerTransports.GRPC;
+    service: ServiceType;
+}
+export type TControllerMetadata = IRestControllerMetadata | IGrpcControllerMetadata;
+export interface IRpcMetadata {
+    /** Proto method name. */
+    name: string;
+    /** RPC method type (unary, server_streaming, etc.). */
+    method: TGrpcMethod;
+    /** Authentication config for this RPC method. */
+    authenticate?: {
+        strategies?: TAuthStrategy[];
+        mode?: TAuthMode;
+    };
+    /** Authorization spec(s) for this RPC method. */
+    authorize?: IAuthorizationSpec | IAuthorizationSpec[];
+}
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/dist/esm/helpers/inversion/common/types/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D,UAAU,uBAAwB,SAAQ,4BAA4B;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,SAAS,CAAC,EAAE,OAAO,oBAAoB,CAAC,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,uBAAuB,CAAC,WAAW,GAAG,OAAO,CAAE,SAAQ,uBAAuB;IAC7F,SAAS,EAAE,OAAO,oBAAoB,CAAC,IAAI,CAAC;IAC5C,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,GAAG,uBAAuB,CAAC;AAEpF,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,MAAM,EAAE,WAAW,CAAC;IAEpB,iDAAiD;IACjD,YAAY,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAElE,iDAAiD;IACjD,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;CACvD"}

package/dist/esm/helpers/inversion/common/types/controller.js

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

package/dist/esm/helpers/inversion/common/types/controller.js.map

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

package/dist/esm/helpers/inversion/common/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from './artifact.js';
+export * from './controller.js';
+export * from './injection.js';
+export * from './model.js';
+export * from './persistence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/helpers/inversion/common/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/esm/helpers/inversion/common/types/index.js

@@ -0,0 +1,6 @@
+export * from './artifact.js';
+export * from './controller.js';
+export * from './injection.js';
+export * from './model.js';
+export * from './persistence.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/helpers/inversion/common/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/esm/helpers/inversion/common/types/injection.d.ts

@@ -0,0 +1,6 @@
+import { type IInjectMetadata as _IInjectMetadata, type IPropertyMetadata as _IPropertyMetadata } from '@venizia/ignis-inversion';
+export interface IPropertyMetadata extends _IPropertyMetadata {
+}
+export interface IInjectMetadata extends _IInjectMetadata {
+}
+//# sourceMappingURL=injection.d.ts.map

package/dist/esm/helpers/inversion/common/types/injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/injection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,IAAI,gBAAgB,EACxC,KAAK,iBAAiB,IAAI,kBAAkB,EAC7C,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;CAAG;AAEhE,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;CAAG"}

package/dist/esm/helpers/inversion/common/types/injection.js

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

package/dist/esm/helpers/inversion/common/types/injection.js.map

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

package/dist/esm/helpers/inversion/common/types/model.d.ts

@@ -0,0 +1,82 @@
+import type { AbstractEntity } from '../../../../base/models/index.js';
+import type { ScopeFilters, TFilter, TScopeFilterMissingBehavior, TWhere } from '../../../../base/repositories/index.js';
+import type { TClass, TNullable, TValueOrResolver } from '@venizia/ignis-helpers/common';
+import type { IArtifactRegistrationOptions } from './artifact.js';
+export interface IModelAuthorizeSettings {
+    /** The authorization principal name (resource/subject) for this model. */
+    principal: string;
+    /** Extensible - consumers can add any extra authorization metadata. */
+    [extra: string | symbol]: any;
+}
+/**
+ * Row-scope resolver for `@model` settings.scopeFilter - resolved per query, so it can depend on
+ * the current request (tenant, org, membership). Framework-internal escape hatches aside, nothing
+ * short of removing this setting from the model turns scoping off.
+ */
+export interface IScopeFilterSettings {
+    /**
+     * Returns the scope `where`; `ScopeFilters.UNRESTRICTED` to apply no scope for THIS call (an
+     * internal operator, a caller the application has decided sees everything); or null/undefined
+     * when this caller's scope cannot be determined at all.
+     */
+    resolve: () => TNullable<TWhere> | typeof ScopeFilters.UNRESTRICTED;
+    /**
+     * What `applyScopeFilter` does when `resolve()` returns null/undefined - no request context, no
+     * tenant, a background job. Defaults to `deny`: an unresolved scope matches zero rows, never
+     * every row. `allow` is an explicit, reviewed opt-out for migrations and background jobs, declared
+     * per MODEL - it cannot express a per-USER bypass; use `ScopeFilters.UNRESTRICTED` for that.
+     */
+    onMissing?: TScopeFilterMissingBehavior;
+}
+export interface IModelSettings {
+    /** Properties excluded from all query results at SQL level. */
+    hiddenProperties?: string[];
+    /** Default filter auto-applied to all repository operations. Bypassable via shouldSkipDefaultFilter. */
+    defaultFilter?: TFilter;
+    /**
+     * Row scope: ANDed into every read and write whose scope is expressible as a filter clause, and
+     * NOT removable by `shouldSkipDefaultFilter`. Resolved per query, so it can depend on the current
+     * request. Ownership resolved per row or through a polymorphic reference is NOT expressible here -
+     * that check is still the application's to perform.
+     *
+     * Relational repositories only - a search-backed model (Typesense, Meilisearch) never reads
+     * this setting, so mirroring a scoped entity into a search index needs its own query-time scope.
+     */
+    scopeFilter?: IScopeFilterSettings;
+    /** Default row limit when a query omits `limit`. Must be a positive integer. Falls back to DEFAULT_LIMIT (10). */
+    defaultLimit?: number;
+    /**
+     * Largest `limit` a CALLER may ask for. Must be a positive integer. Falls back to
+     * DEFAULT_MAX_LIMIT (1000).
+     *
+     * Policy, not capacity - the engine's own ceiling sits far above it. The number is chosen so
+     * that reaching it means the caller is doing something unusual, and raising it is how a model
+     * says so deliberately.
+     */
+    maxLimit?: number;
+    /** Authorization settings for this model (principal name, etc.). */
+    authorize?: IModelAuthorizeSettings;
+}
+export interface IModelMetadata extends IArtifactRegistrationOptions {
+    type: 'entity' | 'view';
+    tableName?: string;
+    skipMigrate?: boolean;
+    settings?: IModelSettings;
+}
+export interface IEntityStatics {
+    schema?: unknown;
+    relations?: TValueOrResolver<Array<unknown>>;
+}
+export type TModelClass<Model extends AbstractEntity = AbstractEntity> = TClass<Model> & IEntityStatics;
+/** Decorator target for model classes (supports both strongly typed and ClassDecorator patterns). */
+export type TDecoratorModelTarget<Model extends AbstractEntity = AbstractEntity> = TModelClass<Model> | (Function & IEntityStatics);
+export interface IModelRegistryEntry<Model extends AbstractEntity = AbstractEntity> {
+    target: TValueOrResolver<TClass<Model>>;
+    metadata: IModelMetadata;
+    schema: unknown;
+    /** Lazy resolver to avoid circular deps. Resolved when DataSource builds schema. */
+    relationsResolver?: TValueOrResolver<Array<unknown>>;
+    /** Cache populated on first buildSchema() call. */
+    _builtRelations?: unknown;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/esm/helpers/inversion/common/types/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,2BAA2B,EAC3B,MAAM,EACP,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,EAAE,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,OAAO,YAAY,CAAC,YAAY,CAAC;IAEpE;;;;;OAKG;IACH,SAAS,CAAC,EAAE,2BAA2B,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,wGAAwG;IACxG,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAEnC,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oEAAoE;IACpE,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC;AAED,MAAM,WAAW,cAAe,SAAQ,4BAA4B;IAClE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,IAAI,MAAM,CAAC,KAAK,CAAC,GACpF,cAAc,CAAC;AAEjB,qGAAqG;AACrG,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,IAC7E,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,cAAc,CAAC,CAAC;AAEnD,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc;IAChF,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAEhB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAErD,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/esm/helpers/inversion/common/types/model.js

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

package/dist/esm/helpers/inversion/common/types/model.js.map

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

package/dist/esm/helpers/inversion/common/types/persistence.d.ts

@@ -0,0 +1,26 @@
+import type { IDataSource, TDataSourceDriverClass } from '../../../../base/datasources/index.js';
+import type { AbstractEntity } from '../../../../base/models/index.js';
+import type { IRepository, TRepositoryOperationScope } from '../../../../base/repositories/index.js';
+import type { TClass, TValueOrResolver } from '@venizia/ignis-helpers/common';
+import type { IArtifactRegistrationOptions, TDecoratorTarget } from './artifact.js';
+export interface IDataSourceMetadata extends IArtifactRegistrationOptions {
+    driver?: TDataSourceDriverClass;
+    autoDiscovery?: boolean;
+}
+export interface IRepositoryMetadata<Model extends AbstractEntity = AbstractEntity, DataSource extends IDataSource = IDataSource> extends IArtifactRegistrationOptions {
+    model: TValueOrResolver<TClass<Model>>;
+    dataSource: string | TValueOrResolver<TClass<DataSource>>;
+    operationScope?: TRepositoryOperationScope;
+}
+/** Resolved repository metadata after lazy evaluation. */
+export interface IResolvedRepositoryMetadata<Model extends AbstractEntity = AbstractEntity, DataSource extends IDataSource = IDataSource> {
+    model?: TClass<Model>;
+    dataSource?: string | TClass<DataSource>;
+    operationScope?: TRepositoryOperationScope;
+}
+export interface IRepositoryBinding<Model extends AbstractEntity = AbstractEntity, DataSource extends IDataSource = IDataSource> {
+    model: TValueOrResolver<TClass<Model>>;
+    repository: TValueOrResolver<TDecoratorTarget<IRepository>>;
+    dataSource: TValueOrResolver<string | TDecoratorTarget<DataSource>>;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/dist/esm/helpers/inversion/common/types/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,mBAAoB,SAAQ,4BAA4B;IACvE,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB,CAClC,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,CAC5C,SAAQ,4BAA4B;IACpC,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC5C;AAED,0DAA0D;AAC1D,MAAM,WAAW,2BAA2B,CAC1C,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW;IAE5C,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB,CACjC,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW;IAE5C,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,UAAU,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5D,UAAU,EAAE,gBAAgB,CAAC,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;CACrE"}

package/dist/esm/helpers/inversion/common/types/persistence.js

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

package/dist/esm/helpers/inversion/common/types/persistence.js.map

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

package/dist/esm/helpers/inversion/index.d.ts

@@ -1,4 +1,4 @@
-export { Binding, BindingKeys, BindingScopes, BindingValueTypes, isClass, isClassProvider, type IProvider, type TBindingKey, type TBindingScope, type TBindingValueType, type IBindingTag, } from '@venizia/ignis-inversion';
+export { Binding, BindingKeys, BindingScopes, BindingValueTypes, isClass, isClassProvider, resolveInjectTarget, type IProvider, type TBindingKey, type TBindingScope, type TBindingValueType, type IBindingTag, type TInjectTarget, } from '@venizia/ignis-inversion';
 export * from './common/index.js';
 export * from './container.js';
 export * from './registry.js';

package/dist/esm/helpers/inversion/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/helpers/inversion/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAC;AAElC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/helpers/inversion/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAC;AAElC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/esm/helpers/inversion/index.js

@@ -1,5 +1,5 @@
 // DI-specific symbols only available in inversion (not in helpers)
-export { Binding, BindingKeys, BindingScopes, BindingValueTypes, isClass, isClassProvider, } from '@venizia/ignis-inversion';
+export { Binding, BindingKeys, BindingScopes, BindingValueTypes, isClass, isClassProvider, resolveInjectTarget, } from '@venizia/ignis-inversion';
 export * from './common/index.js';
 export * from './container.js';
 export * from './registry.js';

package/dist/esm/helpers/inversion/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/inversion/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EACL,OAAO,EACP,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,eAAe,GAMhB,MAAM,0BAA0B,CAAC;AAElC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/inversion/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EACL,OAAO,EACP,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,mBAAmB,GAOpB,MAAM,0BAA0B,CAAC;AAElC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/esm/helpers/inversion/mixins/artifact.mixin.d.ts

@@ -0,0 +1,86 @@
+import type { TMixinTarget } from '@venizia/ignis-helpers/common';
+import type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';
+import type { IArtifactMetadata, IProvideMetadata } from '../common/types/index.js';
+export declare const ArtifactMetadataMixin: <BaseClass extends TMixinTarget<_MetadataRegistry>>(baseClass: BaseClass) => {
+    new (...args: any[]): {
+        /** Every class a stereotype decorated, in decoration order - which is import order, and is identical in a bundle. Discovery reads this; registration order still comes from `order` and the configuration sort. */
+        discoveredArtifacts: object[];
+        addDiscoveredArtifact<Target extends object = object>(opts: {
+            target: Target;
+        }): void;
+        getDiscoveredArtifacts(): ReadonlyArray<object>;
+        /** Tests only: the list is process-wide and a suite that decorates classes would leak into the next one. */
+        clearDiscoveredArtifacts(): void;
+        setArtifactMetadata<Target extends object = object, ApplicationType = unknown>(opts: {
+            target: Target;
+            metadata: IArtifactMetadata<ApplicationType>;
+        }): void;
+        getArtifactMetadata<Target extends object = object>(opts: {
+            target: Target;
+        }): IArtifactMetadata | undefined;
+        addProvideMetadata<Target extends object = object>(opts: {
+            target: Target;
+            metadata: IProvideMetadata;
+        }): void;
+        getProvideMetadata<Target extends object = object>(opts: {
+            target: Target;
+        }): IProvideMetadata[];
+        define: <Target extends object = object, Value = any>(opts: {
+            target: Target;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+            value: Value;
+        }) => void;
+        get: <Target extends object = object, Value_1 = any>(opts: {
+            target: Target;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+        }) => Value_1 | undefined;
+        has: <Target extends object = object>(opts: {
+            target: Target;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+        }) => boolean;
+        delete: <Target extends object = object>(opts: {
+            target: Target;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+        }) => boolean;
+        getKeys: <Target extends object = object>(opts: {
+            target: Target;
+        }) => import("@venizia/ignis-inversion").TBindingKey[];
+        getMethodNames: <T = any>(opts: {
+            target: import("@venizia/ignis-inversion").TClass<T>;
+        }) => string[];
+        clearMetadata: <T extends object = object>(opts: {
+            target: T;
+        }) => void;
+        setPropertyMetadata: <T extends object = object>(opts: {
+            target: T;
+            propertyName: string | symbol;
+            metadata: import("@venizia/ignis-inversion").IPropertyMetadata;
+        }) => void;
+        getPropertiesMetadata: <T extends object = object>(opts: {
+            target: T;
+        }) => Map<string | symbol, import("@venizia/ignis-inversion").IPropertyMetadata> | undefined;
+        getPropertyMetadata: <T extends object = object>(opts: {
+            target: T;
+            propertyName: string | symbol;
+        }) => import("@venizia/ignis-inversion").IPropertyMetadata | undefined;
+        setInjectMetadata: <T extends object = object>(opts: {
+            target: T;
+            index: number;
+            metadata: import("@venizia/ignis-inversion").IInjectMetadata;
+        }) => void;
+        getInjectMetadata: <T extends object = object>(opts: {
+            target: T;
+        }) => import("@venizia/ignis-inversion").IInjectMetadata[] | undefined;
+        setBindingKey: <T extends object = object>(opts: {
+            target: T;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+            isProvisional?: boolean;
+        }) => void;
+        getBindingKey: <T extends object = object>(opts: {
+            target: T;
+        }) => import("@venizia/ignis-inversion").TBindingKey | undefined;
+        scope: string;
+        identifier: string;
+    };
+} & BaseClass;
+//# sourceMappingURL=artifact.mixin.d.ts.map

package/dist/esm/helpers/inversion/mixins/artifact.mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/artifact.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,eAAO,MAAM,qBAAqB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACrF,WAAW,SAAS;;QAGlB,mNAAmN;6BAC9L,MAAM,EAAE;8BAEP,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI;kCAQ3D,aAAa,CAAC,MAAM,CAAC;QAI/C,4GAA4G;oCAChF,IAAI;4BAIZ,MAAM,SAAS,MAAM,WAAW,eAAe,kBAAkB;YACnF,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;SAC9C,GAAG,IAAI;4BAKY,MAAM,SAAS,MAAM,iBAAiB;YACxD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,iBAAiB,GAAG,SAAS;2BAId,MAAM,SAAS,MAAM,iBAAiB;YACvD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,gBAAgB,CAAC;SAC5B,GAAG,IAAI;2BAKW,MAAM,SAAS,MAAM,iBAAiB;YACvD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAFtB,CAAD;;;;;;;;aAMF,CAAC"}

package/dist/esm/helpers/inversion/mixins/artifact.mixin.js

@@ -0,0 +1,38 @@
+import { MetadataKeys } from '../common/keys.js';
+export const ArtifactMetadataMixin = (baseClass) => {
+    return class extends baseClass {
+        constructor() {
+            super(...arguments);
+            /** Every class a stereotype decorated, in decoration order - which is import order, and is identical in a bundle. Discovery reads this; registration order still comes from `order` and the configuration sort. */
+            this.discoveredArtifacts = [];
+        }
+        addDiscoveredArtifact(opts) {
+            if (this.discoveredArtifacts.includes(opts.target)) {
+                return;
+            }
+            this.discoveredArtifacts.push(opts.target);
+        }
+        getDiscoveredArtifacts() {
+            return [...this.discoveredArtifacts];
+        }
+        /** Tests only: the list is process-wide and a suite that decorates classes would leak into the next one. */
+        clearDiscoveredArtifacts() {
+            this.discoveredArtifacts = [];
+        }
+        setArtifactMetadata(opts) {
+            Reflect.defineMetadata(MetadataKeys.ARTIFACT, opts.metadata, opts.target);
+        }
+        // Own metadata only: a subclass of a decorated class is not itself an artifact.
+        getArtifactMetadata(opts) {
+            return Reflect.getOwnMetadata(MetadataKeys.ARTIFACT, opts.target);
+        }
+        addProvideMetadata(opts) {
+            const current = this.getProvideMetadata({ target: opts.target });
+            Reflect.defineMetadata(MetadataKeys.PROVIDES, [...current, opts.metadata], opts.target);
+        }
+        getProvideMetadata(opts) {
+            return Reflect.getOwnMetadata(MetadataKeys.PROVIDES, opts.target) ?? [];
+        }
+    };
+};
+//# sourceMappingURL=artifact.mixin.js.map

package/dist/esm/helpers/inversion/mixins/artifact.mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/artifact.mixin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,SAAoB,EACpB,EAAE;IACF,OAAO,KAAM,SAAQ,SAAS;QAAvB;;YACL,mNAAmN;YACnN,wBAAmB,GAAa,EAAE,CAAC;QA8CrC,CAAC;QA5CC,qBAAqB,CAAiC,IAAwB;YAC5E,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QAED,sBAAsB;YACpB,OAAO,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,4GAA4G;QAC5G,wBAAwB;YACtB,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAChC,CAAC;QAED,mBAAmB,CAA4D,IAG9E;YACC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QAED,gFAAgF;QAChF,mBAAmB,CAAiC,IAEnD;YACC,OAAO,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpE,CAAC;QAED,kBAAkB,CAAiC,IAGlD;YACC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1F,CAAC;QAED,kBAAkB,CAAiC,IAElD;YACC,OAAO,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1E,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/helpers/inversion/mixins/controllers/controller.d.ts

@@ -1,6 +1,6 @@
 import type { TMixinTarget } from '@venizia/ignis-helpers/common';
 import type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';
-import type { IGrpcControllerMetadata, IRestControllerMetadata, TControllerMetadata } from '../../common/types.js';
+import type { IGrpcControllerMetadata, IRestControllerMetadata, TControllerMetadata } from '../../common/types/index.js';
 export declare const ControllerMetadataMixin: <BaseClass extends TMixinTarget<_MetadataRegistry>>(baseClass: BaseClass) => {
     new (...args: any[]): {
         setControllerMetadata<Target extends object = object>(opts: {
@@ -62,6 +62,14 @@ export declare const ControllerMetadataMixin: <BaseClass extends TMixinTarget<_M
         getInjectMetadata: <T extends object = object>(opts: {
             target: T;
         }) => import("@venizia/ignis-inversion").IInjectMetadata[] | undefined;
+        setBindingKey: <T extends object = object>(opts: {
+            target: T;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+            isProvisional?: boolean;
+        }) => void;
+        getBindingKey: <T extends object = object>(opts: {
+            target: T;
+        }) => import("@venizia/ignis-inversion").TBindingKey | undefined;
         scope: string;
         identifier: string;
     };

package/dist/esm/helpers/inversion/mixins/controllers/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACvF,WAAW,SAAS;;8BAGI,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,mBAAmB,CAAC;SAC/B,GAAG,IAAI;8BAUc,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,mBAAmB,GAAG,SAAS;kCAKT,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;kCAQb,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAQ1C,CAAC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACvF,WAAW,SAAS;;8BAGI,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,mBAAmB,CAAC;SAC/B,GAAG,IAAI;8BAUc,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,mBAAmB,GAAG,SAAS;kCAKT,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;kCAQb,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBASqJ,CAAC;;;;;;;;aADhM,CAAC"}

package/dist/esm/helpers/inversion/mixins/controllers/grpc.d.ts

@@ -1,6 +1,6 @@
 import type { TMixinTarget } from '@venizia/ignis-helpers/common';
 import type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';
-import type { IRpcMetadata } from '../../common/types.js';
+import type { IRpcMetadata } from '../../common/types/index.js';
 export declare const GrpcControllerMetadataMixin: <BaseClass extends TMixinTarget<_MetadataRegistry>>(baseClass: BaseClass) => {
     new (...args: any[]): {
         addRpc<Target extends object = object>(opts: {
@@ -64,6 +64,14 @@ export declare const GrpcControllerMetadataMixin: <BaseClass extends TMixinTarge
         getInjectMetadata: <T extends object = object>(opts: {
             target: T;
         }) => import("@venizia/ignis-inversion").IInjectMetadata[] | undefined;
+        setBindingKey: <T extends object = object>(opts: {
+            target: T;
+            key: import("@venizia/ignis-inversion").TBindingKey;
+            isProvisional?: boolean;
+        }) => void;
+        getBindingKey: <T extends object = object>(opts: {
+            target: T;
+        }) => import("@venizia/ignis-inversion").TBindingKey | undefined;
         scope: string;
         identifier: string;
     };