@venizia/ignis-kernel 0.2.0-0

package/dist/cjs/helpers/inversion/mixins/model.mixin.d.ts

@@ -0,0 +1,97 @@
+import type { AbstractEntity } from '../../../base/models';
+import type { TMixinTarget } from '@venizia/ignis-helpers/common';
+import type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';
+import type { IModelAuthorizeSettings, IModelMetadata, IModelRegistryEntry, TDecoratorModelTarget } from '../common/types';
+export declare const ModelMetadataMixin: <BaseClass extends TMixinTarget<_MetadataRegistry>>(baseClass: BaseClass) => {
+    new (...args: any[]): {
+        modelRegistry: Map<string, IModelRegistryEntry>;
+        setModelMetadata<Target extends object = object>(opts: {
+            target: Target;
+            metadata: IModelMetadata;
+        }): void;
+        getModelMetadata<Target extends object = object>(opts: {
+            target: Target;
+        }): IModelMetadata | undefined;
+        /** Registers a model (called by @model) - relations are stored as a resolver, not resolved immediately, so circular references between models resolve lazily in buildSchema(). */
+        registerModel<Model extends AbstractEntity = AbstractEntity<unknown>>(opts: {
+            target: TDecoratorModelTarget<Model>;
+            metadata: IModelMetadata;
+        }): void;
+        getModelEntry(opts: {
+            name: string;
+        }): IModelRegistryEntry | undefined;
+        getAllModels(): Map<string, IModelRegistryEntry>;
+        getModelAuthorizeSettings(opts: {
+            name: string;
+        }): IModelAuthorizeSettings | undefined;
+        /** Authorization principals across all models that declare an authorize setting. */
+        getAuthorizeModelPrincipals(opts: {
+            format: "array";
+        }): string[];
+        getAuthorizeModelPrincipals(opts: {
+            format: "record";
+        }): Record<string, string>;
+        getAuthorizeModelSettings(opts: {
+            format: "array";
+        }): Array<{
+            name: string;
+            authorize: IModelAuthorizeSettings;
+            entry: IModelRegistryEntry;
+        }>;
+        getAuthorizeModelSettings(opts: {
+            format: "record";
+        }): Record<string, {
+            authorize: IModelAuthorizeSettings;
+            entry: IModelRegistryEntry;
+        }>;
+        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;
+        scope: string;
+        identifier: string;
+    };
+} & BaseClass;
+//# sourceMappingURL=model.mixin.d.ts.map

package/dist/cjs/helpers/inversion/mixins/model.mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,iBAAiB,CAAC;AA0CzB,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAClF,WAAW,SAAS;;uBAGH,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;yBAE9B,MAAM,SAAS,MAAM,iBAAiB;YACrD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,cAAc,CAAC;SAC1B,GAAG,IAAI;yBAKS,MAAM,SAAS,MAAM,iBAAiB;YACrD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,cAAc,GAAG,SAAS;QAK9B,kLAAkL;sBACpK,KAAK,SAAS,cAAc;;sBAE9B,cAAc;;4BA0BN;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,mBAAmB,GAAG,SAAS;wBAItD,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;wCAIhB;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,uBAAuB,GAAG,SAAS;QAKtF,oFAAoF;0CAClD;YAAE,MAAM,EAAE,OAAO,CAAA;SAAE,GAAG,MAAM,EAAE;0CAC9B;YAAE,MAAM,EAAE,QAAQ,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;wCAyB/C;YAAE,MAAM,EAAE,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC;YAC1D,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,uBAAuB,CAAC;YACnC,KAAK,EAAE,mBAAmB,CAAC;SAC5B,CAAC;wCAC8B;YAC9B,MAAM,EAAE,QAAQ,CAAC;SAClB,GAAG,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,uBAAuB,CAAC;YAAC,KAAK,EAAE,mBAAmB,CAAA;SAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA0BzF,CAAC"}

package/dist/cjs/helpers/inversion/mixins/model.mixin.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelMetadataMixin = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+const keys_1 = require("../common/keys");
+/** Registered models that declare an authorize setting, in registry order. */
+const collectAuthorizeEntries = (opts) => {
+    const result = [];
+    for (const [name, entry] of opts.modelRegistry) {
+        const authorize = entry.metadata.settings?.authorize;
+        if (!authorize) {
+            continue;
+        }
+        result.push({ name, authorize, entry });
+    }
+    return result;
+};
+/** Registered models that declare an authorize principal, in registry order. */
+const collectAuthorizePrincipals = (opts) => {
+    const result = [];
+    for (const [name, entry] of opts.modelRegistry) {
+        const principal = entry.metadata.settings?.authorize?.principal;
+        if (!principal) {
+            continue;
+        }
+        result.push({ name, principal });
+    }
+    return result;
+};
+const ModelMetadataMixin = (baseClass) => {
+    return class extends baseClass {
+        setModelMetadata(opts) {
+            const { target, metadata } = opts;
+            Reflect.defineMetadata(keys_1.MetadataKeys.MODEL, metadata, target);
+        }
+        getModelMetadata(opts) {
+            const { target } = opts;
+            return Reflect.getMetadata(keys_1.MetadataKeys.MODEL, target);
+        }
+        /** Registers a model (called by @model) - relations are stored as a resolver, not resolved immediately, so circular references between models resolve lazily in buildSchema(). */
+        registerModel(opts) {
+            const { target, metadata } = opts;
+            // Decorator target is always a class constructor at runtime
+            const modelClass = target;
+            // Table name precedence: explicit metadata > static TABLE_NAME > class name. TABLE_NAME is deliberately outside IEntityStatics (not part of the neutral contract) but still honored here via a local cast.
+            const tableName = [metadata.tableName, modelClass.TABLE_NAME].find(Boolean) ??
+                modelClass.name;
+            // Resolver, not resolved value - executed lazily in buildSchema() once all models are loaded
+            const relationsResolver = modelClass.relations;
+            this.modelRegistry.set(tableName, {
+                target: modelClass,
+                metadata,
+                schema: modelClass.schema,
+                relationsResolver,
+            });
+            // Also mirrored via Reflect so plain metadata lookups (getModelMetadata) still see it
+            this.setModelMetadata({ target, metadata });
+        }
+        getModelEntry(opts) {
+            return this.modelRegistry.get(opts.name);
+        }
+        getAllModels() {
+            return this.modelRegistry;
+        }
+        getModelAuthorizeSettings(opts) {
+            const entry = this.getModelEntry(opts);
+            return entry?.metadata?.settings?.authorize;
+        }
+        getAuthorizeModelPrincipals(opts) {
+            switch (opts.format) {
+                case 'array': {
+                    return collectAuthorizePrincipals({ modelRegistry: this.modelRegistry }).map(item => item.principal);
+                }
+                case 'record': {
+                    const record = {};
+                    for (const item of collectAuthorizePrincipals({ modelRegistry: this.modelRegistry })) {
+                        record[item.name] = item.principal;
+                    }
+                    return record;
+                }
+                default: {
+                    throw (0, core_1.getError)({
+                        message: `[getAuthorizeModelPrincipals] Invalid format | format: ${opts.format} | valid: array, record`,
+                    });
+                }
+            }
+        }
+        getAuthorizeModelSettings(opts) {
+            switch (opts.format) {
+                case 'array': {
+                    return collectAuthorizeEntries({ modelRegistry: this.modelRegistry });
+                }
+                case 'record': {
+                    const record = {};
+                    for (const item of collectAuthorizeEntries({ modelRegistry: this.modelRegistry })) {
+                        record[item.name] = { authorize: item.authorize, entry: item.entry };
+                    }
+                    return record;
+                }
+                default: {
+                    throw (0, core_1.getError)({
+                        message: `[getAuthorizeModelSettings] Invalid format | format: ${opts.format} | valid: array, record`,
+                    });
+                }
+            }
+        }
+    };
+};
+exports.ModelMetadataMixin = ModelMetadataMixin;
+//# sourceMappingURL=model.mixin.js.map

package/dist/cjs/helpers/inversion/mixins/model.mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"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"}

package/dist/cjs/helpers/inversion/mixins/repository.mixin.d.ts

@@ -0,0 +1,126 @@
+import type { IDataSource } from '../../../base/datasources';
+import type { AbstractEntity } from '../../../base/models';
+import type { AnyType, TClass, TMixinTarget } from '@venizia/ignis-helpers/common';
+import type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';
+import type { IModelMetadata, IModelRegistryEntry, IRepositoryBinding, IRepositoryMetadata, IResolvedRepositoryMetadata } from '../common/types';
+export declare const RepositoryMetadataMixin: <BaseClass extends TMixinTarget<_MetadataRegistry & {
+    modelRegistry: Map<string, IModelRegistryEntry>;
+    getModelMetadata(opts: {
+        target: object;
+    }): IModelMetadata | undefined;
+}>>(baseClass: BaseClass) => {
+    new (...args: any[]): {
+        repositoryBindings: Map<string, IRepositoryBinding<AbstractEntity>>;
+        /**
+         * The model classes a datasource owns, never their names: two classes may share a name and the
+         * name-keyed `modelRegistry` holds only one, so keying by name resolves the wrong class.
+         */
+        datasourceModels: Map<string, Set<TClass<AnyType>>>;
+        setRepositoryMetadata<Target extends object = object, Model extends AbstractEntity = AbstractEntity<unknown>, DataSource extends IDataSource = IDataSource<{}, import("../../../base/datasources").TAnyDataSourceSchema, {}>>(opts: {
+            target: Target;
+            metadata: IRepositoryMetadata<Model, DataSource>;
+        }): void;
+        getRepositoryMetadata<Target extends object = object>(opts: {
+            target: Target;
+        }): (IRepositoryMetadata & {
+            _resolved?: IResolvedRepositoryMetadata;
+        }) | undefined;
+        /** Registers a repository binding (called by @repository) linking a repository to its model + datasource. */
+        registerRepositoryBinding<Model_1 extends AbstractEntity = AbstractEntity<unknown>, DataSource_1 extends IDataSource = IDataSource<{}, import("../../../base/datasources").TAnyDataSourceSchema, {}>>(opts: IRepositoryBinding<Model_1, DataSource_1>): void;
+        getRepositoryBinding(opts: {
+            name: string;
+        }): IRepositoryBinding<AbstractEntity> | undefined;
+        /**
+         * Resolves and caches relations for a model entry - called lazily from buildSchema() so that
+         * every `@model` class is registered first, which avoids circular-dependency ordering issues.
+         * @internal
+         */
+        resolveModelRelations(modelMeta: IModelRegistryEntry): unknown;
+        /**
+         * Models registered for a datasource, relations resolved lazily. `schema`/`relations` stay
+         * `unknown` - the registry is shared across connectors, so each connector narrows at its call
+         * site.
+         */
+        getModels(opts: {
+            dataSource: string | TClass<IDataSource>;
+        }): Array<{
+            tableName: string;
+            schema: unknown;
+            relations?: unknown;
+        }>;
+        /**
+         * Like getModels but returns only resolved model classes - used by BaseSearchDataSource, which
+         * has no pgTable to resolve.
+         */
+        getModelClasses(opts: {
+            dataSource: string | TClass<IDataSource>;
+        }): Array<TClass<unknown>>;
+        /** The key a model occupies in `modelRegistry` - its table name, or its class name when it has none. */
+        resolveModelKey(opts: {
+            modelClass: TClass<AnyType>;
+        }): string;
+        /** Assembles table schemas + relations for a datasource's registered models. */
+        buildSchema(opts: {
+            dataSource: string | TClass<IDataSource>;
+        }): {
+            schema: Record<string, unknown>;
+            relations: Record<string, unknown>;
+        };
+        hasModels(opts: {
+            dataSource: string | TClass<IDataSource>;
+        }): boolean;
+        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;
+        scope: string;
+        identifier: string;
+        modelRegistry: Map<string, IModelRegistryEntry>;
+        getModelMetadata: (opts: {
+            target: object;
+        }) => IModelMetadata | undefined;
+    };
+} & BaseClass;
+//# sourceMappingURL=repository.mixin.d.ts.map

package/dist/cjs/helpers/inversion/mixins/repository.mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/repository.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGnF,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,uBAAuB,GAClC,SAAS,SAAS,YAAY,CAC5B,iBAAiB,GAAG;IAClB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,GAAG,SAAS,CAAC;CACxE,CACF,EAED,WAAW,SAAS;;4BAGE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAEnE;;;WAGG;0BACe,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;8BAGjD,MAAM,SAAS,MAAM,WACrB,KAAK,SAAS,cAAc,4BAC5B,UAAU,SAAS,WAAW,iFACxB;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;SAAE,GAAG,IAAI;8BAK7D,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,CAAC,mBAAmB,GAAG;YAAE,SAAS,CAAC,EAAE,2BAA2B,CAAA;SAAE,CAAC,GAAG,SAAS;QAKnF,6GAA6G;kDAE7F,cAAc,iDACT,WAAW;mCAoBL;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,kBAAkB,CAAC,cAAc,CAAC,GAAG,SAAS;QAI5F;;;;WAIG;yCAC8B,mBAAmB,GAAG,OAAO;QA+B9D;;;;WAIG;wBACa;YAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;SAAE,GAAG,KAAK,CAAC;YACnE,SAAS,EAAE,MAAM,CAAC;YAClB,MAAM,EAAE,OAAO,CAAC;YAChB,SAAS,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC;QAmCF;;;WAGG;8BACmB;YAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;SAAE,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAS3F,wGAAwG;8BAClF;YAAE,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;SAAE,GAAG,MAAM;QAU9D,gFAAgF;0BAC9D;YAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;SAAE,GAAG;YAC/D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC;wBAsBe;YAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;SAAE,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA7LrD,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;iCACxB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,KAAG,cAAc,GAAG,SAAS;;aAkM3E,CAAC"}

package/dist/cjs/helpers/inversion/mixins/repository.mixin.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepositoryMetadataMixin = void 0;
+const common_1 = require("@venizia/ignis-helpers/common");
+const core_1 = require("@venizia/ignis-helpers/core");
+const keys_1 = require("../common/keys");
+const relation_builder_1 = require("../common/relation-builder");
+const RepositoryMetadataMixin = (baseClass) => {
+    return class extends baseClass {
+        setRepositoryMetadata(opts) {
+            const { target, metadata } = opts;
+            Reflect.defineMetadata(keys_1.MetadataKeys.REPOSITORY, metadata, target);
+        }
+        getRepositoryMetadata(opts) {
+            const { target } = opts;
+            return Reflect.getMetadata(keys_1.MetadataKeys.REPOSITORY, target);
+        }
+        /** Registers a repository binding (called by @repository) linking a repository to its model + datasource. */
+        registerRepositoryBinding(opts) {
+            // Every member of the binding may be a resolver, the escape hatch for circular imports.
+            // Reading `.name` off the resolver keys the registry by the arrow's inferred name, and the
+            // datasource then silently discovers no schema.
+            const repositoryClass = (0, common_1.resolveValue)(opts.repository);
+            this.repositoryBindings.set(repositoryClass.name, opts);
+            const dataSourceRef = (0, common_1.resolveValue)(opts.dataSource);
+            const dsKey = typeof dataSourceRef === 'string' ? dataSourceRef : dataSourceRef.name;
+            const modelClass = (0, common_1.resolveValue)(opts.model);
+            if (!this.datasourceModels.has(dsKey)) {
+                this.datasourceModels.set(dsKey, new Set());
+            }
+            this.datasourceModels.get(dsKey).add(modelClass);
+        }
+        getRepositoryBinding(opts) {
+            return this.repositoryBindings.get(opts.name);
+        }
+        /**
+         * Resolves and caches relations for a model entry - called lazily from buildSchema() so that
+         * every `@model` class is registered first, which avoids circular-dependency ordering issues.
+         * @internal
+         */
+        resolveModelRelations(modelMeta) {
+            if (modelMeta._builtRelations !== undefined) {
+                return modelMeta._builtRelations;
+            }
+            if (!modelMeta.relationsResolver) {
+                return undefined;
+            }
+            const relations = (0, common_1.resolveValue)(modelMeta.relationsResolver);
+            if (!relations || !modelMeta.schema) {
+                return undefined;
+            }
+            const builder = relation_builder_1.RelationBuilderRegistry.resolve();
+            // Relations were declared but no connector installed a builder - silently dropping them
+            // would surface much later as an empty `with` clause.
+            if (!builder) {
+                throw (0, core_1.getError)({
+                    message: `[RepositoryMetadataMixin][resolveModelRelations] Model declares relations but no relation builder is registered | Import the relational connector so it installs one`,
+                });
+            }
+            const builtRelations = builder({ source: modelMeta.schema, relations });
+            modelMeta._builtRelations = builtRelations?.relations;
+            return modelMeta._builtRelations;
+        }
+        /**
+         * Models registered for a datasource, relations resolved lazily. `schema`/`relations` stay
+         * `unknown` - the registry is shared across connectors, so each connector narrows at its call
+         * site.
+         */
+        getModels(opts) {
+            const { dataSource } = opts;
+            const dsKey = typeof dataSource === 'string' ? dataSource : dataSource.name;
+            const modelClasses = this.datasourceModels.get(dsKey) ?? new Set();
+            const rs = Array.from(modelClasses)
+                .map(modelClass => {
+                // Read straight off the class: a class -> name -> modelRegistry round-trip collapses two
+                // same-named models onto one entry, silently swapping schemas. `modelRegistry` stays
+                // name-keyed for the by-name APIs that need it.
+                const entry = {
+                    target: modelClass,
+                    metadata: this.getModelMetadata({ target: modelClass }) ?? { settings: {} },
+                    schema: modelClass.schema,
+                    relationsResolver: modelClass.relations,
+                };
+                if (entry.schema === undefined) {
+                    return null;
+                }
+                return {
+                    tableName: this.resolveModelKey({ modelClass }),
+                    schema: entry.schema,
+                    relations: this.resolveModelRelations(entry),
+                };
+            })
+                .filter((item) => {
+                return item !== undefined && item !== null;
+            });
+            return rs;
+        }
+        /**
+         * Like getModels but returns only resolved model classes - used by BaseSearchDataSource, which
+         * has no pgTable to resolve.
+         */
+        getModelClasses(opts) {
+            const { dataSource } = opts;
+            const dsKey = typeof dataSource === 'string' ? dataSource : dataSource.name;
+            // Straight from the stored class refs: a name round-trip through the shared modelRegistry
+            // would hand back whichever same-named class registered last.
+            return Array.from(this.datasourceModels.get(dsKey) ?? new Set());
+        }
+        /** The key a model occupies in `modelRegistry` - its table name, or its class name when it has none. */
+        resolveModelKey(opts) {
+            const { modelClass } = opts;
+            const modelMetadata = this.getModelMetadata({ target: modelClass });
+            return ([modelMetadata?.tableName, modelClass.TABLE_NAME].find(Boolean) ??
+                modelClass.name);
+        }
+        /** Assembles table schemas + relations for a datasource's registered models. */
+        buildSchema(opts) {
+            const { dataSource } = opts;
+            const models = this.getModels({ dataSource });
+            const rs = { schema: {}, relations: {} };
+            for (const model of models) {
+                if (model.schema) {
+                    rs.schema[model.tableName] = model.schema;
+                }
+                if (model.relations) {
+                    rs.relations[`${model.tableName}Relations`] = model.relations;
+                }
+            }
+            return rs;
+        }
+        hasModels(opts) {
+            const dsKey = typeof opts.dataSource === 'string' ? opts.dataSource : opts.dataSource.name;
+            const modelNames = this.datasourceModels.get(dsKey);
+            return modelNames !== undefined && modelNames.size > 0;
+        }
+    };
+};
+exports.RepositoryMetadataMixin = RepositoryMetadataMixin;
+//# sourceMappingURL=repository.mixin.js.map

package/dist/cjs/helpers/inversion/mixins/repository.mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/repository.mixin.ts"],"names":[],"mappings":"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"}