@venizia/ignis-kernel 0.4.3 → 0.4.5

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

@@ -1,129 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModelMetadataMixin = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const constants_1 = require("../common/constants");
-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;
-            const entry = {
-                target: modelClass,
-                metadata,
-                schema: modelClass.schema,
-                relationsResolver,
-            };
-            this.modelRegistry.set(tableName, entry);
-            const { schema } = modelClass;
-            if (schema && typeof schema === 'object') {
-                const claimed = this.modelsBySchema.get(schema);
-                if (claimed && claimed.target !== modelClass) {
-                    this.modelsBySchema.delete(schema);
-                }
-                else {
-                    this.modelsBySchema.set(schema, entry);
-                }
-            }
-            // Also mirrored via Reflect so plain metadata lookups (getModelMetadata) still see it
-            this.setModelMetadata({ target, metadata });
-        }
-        getModelEntry(opts) {
-            return this.modelRegistry.get(opts.name);
-        }
-        getModelEntryBySchema(opts) {
-            return this.modelsBySchema.get(opts.schema);
-        }
-        getAllModels() {
-            return this.modelRegistry;
-        }
-        getModelAuthorizeSettings(opts) {
-            const entry = this.getModelEntry(opts);
-            return entry?.metadata?.settings?.authorize;
-        }
-        getAuthorizeModelPrincipals(opts) {
-            switch (opts.format) {
-                case constants_1.AuthorizeModelFormats.ARRAY: {
-                    return collectAuthorizePrincipals({ modelRegistry: this.modelRegistry }).map((item) => item.principal);
-                }
-                case constants_1.AuthorizeModelFormats.RECORD: {
-                    const record = {};
-                    const authorizePrincipals = collectAuthorizePrincipals({
-                        modelRegistry: this.modelRegistry,
-                    });
-                    for (const item of authorizePrincipals) {
-                        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 constants_1.AuthorizeModelFormats.ARRAY: {
-                    return collectAuthorizeEntries({ modelRegistry: this.modelRegistry });
-                }
-                case constants_1.AuthorizeModelFormats.RECORD: {
-                    const record = {};
-                    const authorizeEntries = collectAuthorizeEntries({ modelRegistry: this.modelRegistry });
-                    for (const item of authorizeEntries) {
-                        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

@@ -1 +0,0 @@
-{"version":3,"file":"model.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractEntity } from '@/base/models';\nimport type { TMixinTarget } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';\nimport { AuthorizeModelFormats, type TAuthorizeModelFormat } from '../common/constants';\nimport { MetadataKeys } from '../common/keys';\nimport type {\n  IModelAuthorizeSettings,\n  IModelMetadata,\n  IModelRegistryEntry,\n  TDecoratorModelTarget,\n  TModelClass,\n} from '../common/types';\n\n/** Registered models that declare an authorize setting, in registry order. */\nconst collectAuthorizeEntries = (opts: {\n  modelRegistry: Map<string, IModelRegistryEntry>;\n}): Array<{ name: string; authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }> => {\n  const result: Array<{\n    name: string;\n    authorize: IModelAuthorizeSettings;\n    entry: IModelRegistryEntry;\n  }> = [];\n\n  for (const [name, entry] of opts.modelRegistry) {\n    const authorize = entry.metadata.settings?.authorize;\n    if (!authorize) {\n      continue;\n    }\n\n    result.push({ name, authorize, entry });\n  }\n\n  return result;\n};\n\n/** Registered models that declare an authorize principal, in registry order. */\nconst collectAuthorizePrincipals = (opts: {\n  modelRegistry: Map<string, IModelRegistryEntry>;\n}): Array<{ name: string; principal: string }> => {\n  const result: Array<{ name: string; principal: string }> = [];\n\n  for (const [name, entry] of opts.modelRegistry) {\n    const principal = entry.metadata.settings?.authorize?.principal;\n    if (!principal) {\n      continue;\n    }\n\n    result.push({ name, principal });\n  }\n\n  return result;\n};\n\nexport const ModelMetadataMixin = <BaseClass extends TMixinTarget<_MetadataRegistry>>(\n  baseClass: BaseClass,\n) => {\n  return class extends baseClass {\n    modelRegistry: Map<string, IModelRegistryEntry>;\n    modelsBySchema: WeakMap<object, IModelRegistryEntry>;\n\n    setModelMetadata<Target extends object = object>(opts: {\n      target: Target;\n      metadata: IModelMetadata;\n    }): void {\n      const { target, metadata } = opts;\n      Reflect.defineMetadata(MetadataKeys.MODEL, metadata, target);\n    }\n\n    getModelMetadata<Target extends object = object>(opts: {\n      target: Target;\n    }): IModelMetadata | undefined {\n      const { target } = opts;\n      return Reflect.getMetadata(MetadataKeys.MODEL, target);\n    }\n\n    /** Registers a model (called by @model) - relations are stored as a resolver, not resolved immediately, so circular references between models resolve lazily in buildSchema(). */\n    registerModel<Model extends AbstractEntity = AbstractEntity>(opts: {\n      target: TDecoratorModelTarget<Model>;\n      metadata: IModelMetadata;\n    }) {\n      const { target, metadata } = opts;\n\n      // Decorator target is always a class constructor at runtime\n      const modelClass = target as TModelClass<Model>;\n\n      // 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.\n      const tableName =\n        [metadata.tableName, (modelClass as { TABLE_NAME?: string }).TABLE_NAME].find(Boolean) ??\n        modelClass.name;\n\n      // Resolver, not resolved value - executed lazily in buildSchema() once all models are loaded\n      const relationsResolver = modelClass.relations;\n\n      const entry: IModelRegistryEntry = {\n        target: modelClass,\n        metadata,\n        schema: modelClass.schema,\n        relationsResolver,\n      };\n      this.modelRegistry.set(tableName, entry);\n\n      const { schema } = modelClass;\n      if (schema && typeof schema === 'object') {\n        const claimed = this.modelsBySchema.get(schema);\n        if (claimed && claimed.target !== modelClass) {\n          this.modelsBySchema.delete(schema);\n        } else {\n          this.modelsBySchema.set(schema, entry);\n        }\n      }\n\n      // Also mirrored via Reflect so plain metadata lookups (getModelMetadata) still see it\n      this.setModelMetadata({ target, metadata });\n    }\n\n    getModelEntry(opts: { name: string }): IModelRegistryEntry | undefined {\n      return this.modelRegistry.get(opts.name);\n    }\n\n    getModelEntryBySchema(opts: { schema: object }): IModelRegistryEntry | undefined {\n      return this.modelsBySchema.get(opts.schema);\n    }\n\n    getAllModels(): Map<string, IModelRegistryEntry> {\n      return this.modelRegistry;\n    }\n\n    getModelAuthorizeSettings(opts: { name: string }): IModelAuthorizeSettings | undefined {\n      const entry = this.getModelEntry(opts);\n      return entry?.metadata?.settings?.authorize;\n    }\n\n    /** Authorization principals across all models that declare an authorize setting. */\n    getAuthorizeModelPrincipals(opts: { format: typeof AuthorizeModelFormats.ARRAY }): string[];\n    getAuthorizeModelPrincipals(opts: {\n      format: typeof AuthorizeModelFormats.RECORD;\n    }): Record<string, string>;\n    getAuthorizeModelPrincipals(opts: { format: TAuthorizeModelFormat }) {\n      switch (opts.format) {\n        case AuthorizeModelFormats.ARRAY: {\n          return collectAuthorizePrincipals({ modelRegistry: this.modelRegistry }).map(\n            (item) => item.principal,\n          );\n        }\n        case AuthorizeModelFormats.RECORD: {\n          const record: Record<string, string> = {};\n\n          const authorizePrincipals = collectAuthorizePrincipals({\n            modelRegistry: this.modelRegistry,\n          });\n          for (const item of authorizePrincipals) {\n            record[item.name] = item.principal;\n          }\n\n          return record;\n        }\n        default: {\n          throw getError({\n            message: `[getAuthorizeModelPrincipals] Invalid format | format: ${opts.format} | valid: array, record`,\n          });\n        }\n      }\n    }\n\n    getAuthorizeModelSettings(opts: { format: typeof AuthorizeModelFormats.ARRAY }): Array<{\n      name: string;\n      authorize: IModelAuthorizeSettings;\n      entry: IModelRegistryEntry;\n    }>;\n    getAuthorizeModelSettings(opts: {\n      format: typeof AuthorizeModelFormats.RECORD;\n    }): Record<string, { authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }>;\n    getAuthorizeModelSettings(opts: { format: TAuthorizeModelFormat }) {\n      switch (opts.format) {\n        case AuthorizeModelFormats.ARRAY: {\n          return collectAuthorizeEntries({ modelRegistry: this.modelRegistry });\n        }\n        case AuthorizeModelFormats.RECORD: {\n          const record: Record<\n            string,\n            { authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }\n          > = {};\n\n          const authorizeEntries = collectAuthorizeEntries({ modelRegistry: this.modelRegistry });\n          for (const item of authorizeEntries) {\n            record[item.name] = { authorize: item.authorize, entry: item.entry };\n          }\n\n          return record;\n        }\n        default: {\n          throw getError({\n            message: `[getAuthorizeModelSettings] Invalid format | format: ${opts.format} | valid: array, record`,\n          });\n        }\n      }\n    }\n  };\n};\n"]}

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

@@ -1,147 +0,0 @@
-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, IResolvedRepositoryMetadata, TRepositoryMetadata } 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[]): {
-        /** By repository class name, for the by-name API. Two classes may share a name; `repositoryBindingsByClass` cannot confuse them. */
-        repositoryBindings: Map<string, IRepositoryBinding<AbstractEntity>>;
-        /** By repository class: a minified build renames classes, and two chunks may give two of them one name. */
-        repositoryBindingsByClass: Map<Function, IRepositoryBinding<AbstractEntity>>;
-        /**
-         * The model classes each datasource owns, keyed by the datasource class - or by the string a
-         * repository named it with (`dataSource: 'PgDataSource'`), which only a class of that name
-         * can match. Never by class name alone: a minified build gives two datasources one name.
-         */
-        datasourceModels: Map<string | Function, 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: TRepositoryMetadata<Model, DataSource> & {
-                _resolved?: IResolvedRepositoryMetadata<Model, DataSource>;
-            };
-        }): void;
-        getRepositoryMetadata<Target extends object = object>(opts: {
-            target: Target;
-        }): (TRepositoryMetadata & {
-            _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;
-        /** By class, walking up to the nearest decorated parent; by name only for callers holding a name. */
-        getRepositoryBinding(opts: {
-            target: Function;
-        } | {
-            name: string;
-        }): IRepositoryBinding<AbstractEntity> | undefined;
-        /** A class finds what was registered under it, and under a string equal to its name. */
-        getDataSourceModelClasses(opts: {
-            dataSource: string | TClass<IDataSource>;
-        }): Set<TClass<AnyType>>;
-        /**
-         * 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;
-        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;
-        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

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

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

@@ -1,154 +0,0 @@
-"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)({ value: opts.repository });
-            this.repositoryBindings.set(repositoryClass.name, opts);
-            this.repositoryBindingsByClass.set(repositoryClass, opts);
-            const dataSourceRef = (0, common_1.resolveValue)({ value: opts.dataSource });
-            const modelClass = (0, common_1.resolveValue)({ value: opts.model });
-            if (!this.datasourceModels.has(dataSourceRef)) {
-                this.datasourceModels.set(dataSourceRef, new Set());
-            }
-            this.datasourceModels.get(dataSourceRef).add(modelClass);
-        }
-        /** By class, walking up to the nearest decorated parent; by name only for callers holding a name. */
-        getRepositoryBinding(opts) {
-            if ('name' in opts) {
-                return this.repositoryBindings.get(opts.name);
-            }
-            for (let current = opts.target; current && current !== Function.prototype; current = Object.getPrototypeOf(current)) {
-                const binding = this.repositoryBindingsByClass.get(current);
-                if (binding) {
-                    return binding;
-                }
-            }
-            return undefined;
-        }
-        /** A class finds what was registered under it, and under a string equal to its name. */
-        getDataSourceModelClasses(opts) {
-            const { dataSource } = opts;
-            if (typeof dataSource === 'string') {
-                return this.datasourceModels.get(dataSource) ?? new Set();
-            }
-            return new Set([
-                ...(this.datasourceModels.get(dataSource) ?? []),
-                ...(this.datasourceModels.get(dataSource.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)({ value: 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 modelClasses = this.getDataSourceModelClasses({ dataSource: opts.dataSource });
-            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) {
-            // 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.getDataSourceModelClasses({ dataSource: opts.dataSource }));
-        }
-        /** 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) {
-            return this.getDataSourceModelClasses({ dataSource: opts.dataSource }).size > 0;
-        }
-    };
-};
-exports.RepositoryMetadataMixin = RepositoryMetadataMixin;
-//# sourceMappingURL=repository.mixin.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"repository.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/repository.mixin.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDataSource } from '@/base/datasources';\nimport type { AbstractEntity } from '@/base/models';\nimport type { AnyType, TClass, TMixinTarget } from '@venizia/ignis-helpers/common';\nimport { resolveValue } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';\nimport { MetadataKeys } from '../common/keys';\nimport { RelationBuilderRegistry } from '../common/relation-builder';\nimport type {\n  IModelMetadata,\n  IModelRegistryEntry,\n  IRepositoryBinding,\n  IResolvedRepositoryMetadata,\n  TRepositoryMetadata,\n} from '../common/types';\n\nexport const RepositoryMetadataMixin = <\n  BaseClass extends TMixinTarget<\n    _MetadataRegistry & {\n      modelRegistry: Map<string, IModelRegistryEntry>;\n      getModelMetadata(opts: { target: object }): IModelMetadata | undefined;\n    }\n  >,\n>(\n  baseClass: BaseClass,\n) => {\n  return class extends baseClass {\n    /** By repository class name, for the by-name API. Two classes may share a name; `repositoryBindingsByClass` cannot confuse them. */\n    repositoryBindings: Map<string, IRepositoryBinding<AbstractEntity>>;\n\n    /** By repository class: a minified build renames classes, and two chunks may give two of them one name. */\n    repositoryBindingsByClass: Map<Function, IRepositoryBinding<AbstractEntity>>;\n\n    /**\n     * The model classes each datasource owns, keyed by the datasource class - or by the string a\n     * repository named it with (`dataSource: 'PgDataSource'`), which only a class of that name\n     * can match. Never by class name alone: a minified build gives two datasources one name.\n     */\n    datasourceModels: Map<string | Function, Set<TClass<AnyType>>>;\n\n    setRepositoryMetadata<\n      Target extends object = object,\n      Model extends AbstractEntity = AbstractEntity,\n      DataSource extends IDataSource = IDataSource,\n    >(opts: {\n      target: Target;\n      metadata: TRepositoryMetadata<Model, DataSource> & {\n        _resolved?: IResolvedRepositoryMetadata<Model, DataSource>;\n      };\n    }): void {\n      const { target, metadata } = opts;\n      Reflect.defineMetadata(MetadataKeys.REPOSITORY, metadata, target);\n    }\n\n    getRepositoryMetadata<Target extends object = object>(opts: {\n      target: Target;\n    }): (TRepositoryMetadata & { _resolved?: IResolvedRepositoryMetadata }) | undefined {\n      const { target } = opts;\n      return Reflect.getMetadata(MetadataKeys.REPOSITORY, target);\n    }\n\n    /** Registers a repository binding (called by @repository) linking a repository to its model + datasource. */\n    registerRepositoryBinding<\n      Model extends AbstractEntity = AbstractEntity,\n      DataSource extends IDataSource = IDataSource,\n    >(opts: IRepositoryBinding<Model, DataSource>) {\n      // Every member of the binding may be a resolver, the escape hatch for circular imports.\n      // Reading `.name` off the resolver keys the registry by the arrow's inferred name, and the\n      // datasource then silently discovers no schema.\n      const repositoryClass = resolveValue({ value: opts.repository });\n      this.repositoryBindings.set(repositoryClass.name, opts);\n      this.repositoryBindingsByClass.set(repositoryClass, opts);\n\n      const dataSourceRef = resolveValue({ value: opts.dataSource });\n      const modelClass = resolveValue({ value: opts.model });\n\n      if (!this.datasourceModels.has(dataSourceRef)) {\n        this.datasourceModels.set(dataSourceRef, new Set());\n      }\n\n      this.datasourceModels.get(dataSourceRef)!.add(modelClass);\n    }\n\n    /** By class, walking up to the nearest decorated parent; by name only for callers holding a name. */\n    getRepositoryBinding(\n      opts: { target: Function } | { name: string },\n    ): IRepositoryBinding<AbstractEntity> | undefined {\n      if ('name' in opts) {\n        return this.repositoryBindings.get(opts.name);\n      }\n\n      for (\n        let current: Function | null = opts.target;\n        current && current !== Function.prototype;\n        current = Object.getPrototypeOf(current)\n      ) {\n        const binding = this.repositoryBindingsByClass.get(current);\n        if (binding) {\n          return binding;\n        }\n      }\n\n      return undefined;\n    }\n\n    /** A class finds what was registered under it, and under a string equal to its name. */\n    getDataSourceModelClasses(opts: {\n      dataSource: string | TClass<IDataSource>;\n    }): Set<TClass<AnyType>> {\n      const { dataSource } = opts;\n\n      if (typeof dataSource === 'string') {\n        return this.datasourceModels.get(dataSource) ?? new Set();\n      }\n\n      return new Set([\n        ...(this.datasourceModels.get(dataSource) ?? []),\n        ...(this.datasourceModels.get(dataSource.name) ?? []),\n      ]);\n    }\n\n    /**\n     * Resolves and caches relations for a model entry - called lazily from buildSchema() so that\n     * every `@model` class is registered first, which avoids circular-dependency ordering issues.\n     * @internal\n     */\n    resolveModelRelations(modelMeta: IModelRegistryEntry): unknown {\n      if (modelMeta._builtRelations !== undefined) {\n        return modelMeta._builtRelations;\n      }\n\n      if (!modelMeta.relationsResolver) {\n        return undefined;\n      }\n\n      const relations = resolveValue({ value: modelMeta.relationsResolver });\n\n      if (!relations || !modelMeta.schema) {\n        return undefined;\n      }\n\n      const builder = RelationBuilderRegistry.resolve();\n\n      // Relations were declared but no connector installed a builder - silently dropping them\n      // would surface much later as an empty `with` clause.\n      if (!builder) {\n        throw getError({\n          message: `[RepositoryMetadataMixin][resolveModelRelations] Model declares relations but no relation builder is registered | Import the relational connector so it installs one`,\n        });\n      }\n\n      const builtRelations = builder({ source: modelMeta.schema, relations });\n\n      modelMeta._builtRelations = builtRelations?.relations;\n      return modelMeta._builtRelations;\n    }\n\n    /**\n     * Models registered for a datasource, relations resolved lazily. `schema`/`relations` stay\n     * `unknown` - the registry is shared across connectors, so each connector narrows at its call\n     * site.\n     */\n    getModels(opts: { dataSource: string | TClass<IDataSource> }): Array<{\n      tableName: string;\n      schema: unknown;\n      relations?: unknown;\n    }> {\n      const modelClasses = this.getDataSourceModelClasses({ dataSource: opts.dataSource });\n\n      const rs = Array.from(modelClasses)\n        .map((modelClass) => {\n          // Read straight off the class: a class -> name -> modelRegistry round-trip collapses two\n          // same-named models onto one entry, silently swapping schemas. `modelRegistry` stays\n          // name-keyed for the by-name APIs that need it.\n          const entry: IModelRegistryEntry = {\n            target: modelClass as AnyType,\n            metadata:\n              this.getModelMetadata({ target: modelClass }) ?? ({ settings: {} } as AnyType),\n            schema: (modelClass as AnyType).schema,\n            relationsResolver: (modelClass as AnyType).relations,\n          };\n\n          if (entry.schema === undefined) {\n            return null;\n          }\n\n          return {\n            tableName: this.resolveModelKey({ modelClass }),\n            schema: entry.schema,\n            relations: this.resolveModelRelations(entry),\n          };\n        })\n        .filter((item): item is NonNullable<typeof item> => {\n          return item !== undefined && item !== null;\n        });\n\n      return rs;\n    }\n\n    /**\n     * Like getModels but returns only resolved model classes - used by BaseSearchDataSource, which\n     * has no pgTable to resolve.\n     */\n    getModelClasses(opts: { dataSource: string | TClass<IDataSource> }): Array<TClass<unknown>> {\n      // Straight from the stored class refs: a name round-trip through the shared modelRegistry\n      // would hand back whichever same-named class registered last.\n      return Array.from(this.getDataSourceModelClasses({ dataSource: opts.dataSource }));\n    }\n\n    /** The key a model occupies in `modelRegistry` - its table name, or its class name when it has none. */\n    resolveModelKey(opts: { modelClass: TClass<AnyType> }): string {\n      const { modelClass } = opts;\n      const modelMetadata = this.getModelMetadata({ target: modelClass });\n\n      return (\n        [modelMetadata?.tableName, (modelClass as AnyType).TABLE_NAME].find(Boolean) ??\n        modelClass.name\n      );\n    }\n\n    /** Assembles table schemas + relations for a datasource's registered models. */\n    buildSchema(opts: { dataSource: string | TClass<IDataSource> }): {\n      schema: Record<string, unknown>;\n      relations: Record<string, unknown>;\n    } {\n      const { dataSource } = opts;\n      const models = this.getModels({ dataSource });\n\n      const rs: {\n        schema: Record<string, unknown>;\n        relations: Record<string, unknown>;\n      } = { schema: {}, relations: {} };\n\n      for (const model of models) {\n        if (model.schema) {\n          rs.schema[model.tableName] = model.schema;\n        }\n\n        if (model.relations) {\n          rs.relations[`${model.tableName}Relations`] = model.relations;\n        }\n      }\n\n      return rs;\n    }\n\n    hasModels(opts: { dataSource: string | TClass<IDataSource> }): boolean {\n      return this.getDataSourceModelClasses({ dataSource: opts.dataSource }).size > 0;\n    }\n  };\n};\n"]}