@orchestr-sh/orchestr 1.5.9 → 1.5.11

package/dist/Database/Ensemble/Relations/MorphMap.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * MorphMap
+ *
+ * Global morph map for polymorphic relations
+ * Maps aliases to model classes for cleaner database storage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MorphMap = void 0;
+class MorphMap {
+    /**
+     * Map from alias to model class
+     */
+    static map = new Map();
+    /**
+     * Reverse map from model class to alias
+     */
+    static reverseMap = new Map();
+    /**
+     * Set the morph map
+     *
+     * @example
+     * MorphMap.set({
+     *   'post': Post,
+     *   'video': Video,
+     *   'comment': Comment
+     * });
+     */
+    static set(map) {
+        this.map.clear();
+        this.reverseMap.clear();
+        for (const [alias, modelClass] of Object.entries(map)) {
+            this.map.set(alias, modelClass);
+            this.reverseMap.set(modelClass, alias);
+        }
+    }
+    /**
+     * Get model class from alias
+     */
+    static getClass(alias) {
+        return this.map.get(alias);
+    }
+    /**
+     * Get alias from model class
+     * Returns the class name if no alias is defined
+     */
+    static getAlias(modelClass) {
+        return this.reverseMap.get(modelClass) || modelClass.name;
+    }
+    /**
+     * Get the morph type for a model instance
+     * This is what gets stored in the database {name}_type column
+     */
+    static getMorphedModel(instance) {
+        return this.getAlias(instance.constructor);
+    }
+    /**
+     * Clear the morph map
+     */
+    static clear() {
+        this.map.clear();
+        this.reverseMap.clear();
+    }
+    /**
+     * Check if an alias exists in the map
+     */
+    static has(alias) {
+        return this.map.has(alias);
+    }
+    /**
+     * Get all registered aliases
+     */
+    static aliases() {
+        return Array.from(this.map.keys());
+    }
+    /**
+     * Get all registered model classes
+     */
+    static classes() {
+        return Array.from(this.map.values());
+    }
+}
+exports.MorphMap = MorphMap;
+//# sourceMappingURL=MorphMap.js.map

package/dist/Database/Ensemble/Relations/MorphMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphMap.js","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/MorphMap.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,MAAa,QAAQ;IACnB;;OAEG;IACK,MAAM,CAAC,GAAG,GAAoC,IAAI,GAAG,EAAE,CAAC;IAEhE;;OAEG;IACK,MAAM,CAAC,UAAU,GAAoC,IAAI,GAAG,EAAE,CAAC;IAEvE;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,CAAC,GAAuC;QAChD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAExB,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,UAA8B;QAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,QAAkB;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAiC,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;;AAjFH,4BAkFC"}

package/dist/Database/Ensemble/Relations/MorphOne.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MorphOne Relationship
+ *
+ * Represents a polymorphic one-to-one relationship
+ * Example: Post has one Image (where Image belongs to many types)
+ */
+import { Ensemble } from '../Ensemble';
+import { EnsembleBuilder } from '../EnsembleBuilder';
+import { EnsembleCollection } from '../EnsembleCollection';
+import { Relation } from './Relation';
+export declare class MorphOne<TRelated extends Ensemble, TParent extends Ensemble> extends Relation<TRelated, TParent> {
+    /**
+     * The foreign key of the parent model (e.g., 'imageable_id')
+     */
+    protected foreignKey: string;
+    /**
+     * The morph type column (e.g., 'imageable_type')
+     */
+    protected morphType: string;
+    /**
+     * The local key of the parent model
+     */
+    protected localKey: string;
+    /**
+     * The morph class name or alias
+     */
+    protected morphClass: string;
+    /**
+     * Create a new morph one relationship instance
+     */
+    constructor(query: EnsembleBuilder<TRelated>, parent: TParent, name: string, type: string | null, id: string | null, localKey: string);
+    /**
+     * Set the base constraints on the relation query
+     */
+    addConstraints(): void;
+    /**
+     * Set the constraints for an eager load of the relation
+     */
+    addEagerConstraints(models: TParent[]): void;
+    /**
+     * Initialize the relation on a set of models
+     */
+    initRelation(models: TParent[], relation: string): TParent[];
+    /**
+     * Match the eagerly loaded results to their parents
+     */
+    match(models: TParent[], results: EnsembleCollection<TRelated>, relation: string): TParent[];
+    /**
+     * Build model dictionary keyed by the relation's foreign key
+     */
+    protected buildDictionary(results: EnsembleCollection<TRelated>): Record<any, TRelated[]>;
+    /**
+     * Get the results of the relationship
+     */
+    getResults(): Promise<TRelated | null>;
+    /**
+     * Get the key value of the parent's local key
+     */
+    protected getParentKey(): any;
+    /**
+     * Get the morph class for the parent
+     */
+    protected getMorphClass(): string;
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName(): string;
+    /**
+     * Get the morph type for the relationship
+     */
+    getMorphType(): string;
+    /**
+     * Get the local key for the relationship
+     */
+    getLocalKeyName(): string;
+    /**
+     * Make a new related instance
+     */
+    make(attributes?: Record<string, any>): TRelated;
+    /**
+     * Create a new instance of the related model
+     */
+    create(attributes?: Record<string, any>): Promise<TRelated>;
+    /**
+     * Save a model and set the foreign key and morph type
+     */
+    save(model: TRelated): Promise<TRelated>;
+    /**
+     * Update the parent model on the relationship
+     */
+    update(attributes: Record<string, any>): Promise<number>;
+}
+//# sourceMappingURL=MorphOne.d.ts.map

package/dist/Database/Ensemble/Relations/MorphOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphOne.d.ts","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/MorphOne.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,qBAAa,QAAQ,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,SAAS,QAAQ,CAAE,SAAQ,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC5G;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7B;;OAEG;gBAED,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,EAAE,EAAE,MAAM,GAAG,IAAI,EACjB,QAAQ,EAAE,MAAM;IAYlB;;OAEG;IACH,cAAc,IAAI,IAAI;IAatB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAO5C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAQ5D;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAc5F;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC;IAiBzF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAS5C;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,GAAG;IAI7B;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM;IAIjC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,IAAI,CAAC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,QAAQ;IAIpD;;OAEG;IACG,MAAM,CAAC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYrE;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAS9C;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ/D"}

package/dist/Database/Ensemble/Relations/MorphOne.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * MorphOne Relationship
+ *
+ * Represents a polymorphic one-to-one relationship
+ * Example: Post has one Image (where Image belongs to many types)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MorphOne = void 0;
+const Relation_1 = require("./Relation");
+const MorphMap_1 = require("./MorphMap");
+class MorphOne extends Relation_1.Relation {
+    /**
+     * The foreign key of the parent model (e.g., 'imageable_id')
+     */
+    foreignKey;
+    /**
+     * The morph type column (e.g., 'imageable_type')
+     */
+    morphType;
+    /**
+     * The local key of the parent model
+     */
+    localKey;
+    /**
+     * The morph class name or alias
+     */
+    morphClass;
+    /**
+     * Create a new morph one relationship instance
+     */
+    constructor(query, parent, name, type, id, localKey) {
+        super(query, parent);
+        this.morphType = type || `${name}_type`;
+        this.foreignKey = id || `${name}_id`;
+        this.localKey = localKey;
+        this.morphClass = this.getMorphClass();
+        this.initializeRelation();
+    }
+    /**
+     * Set the base constraints on the relation query
+     */
+    addConstraints() {
+        if (Relation_1.Relation['constraints']) {
+            const parentKey = this.getParentKey();
+            // Only add constraints if parent key exists
+            if (parentKey !== null && parentKey !== undefined) {
+                this.query
+                    .where(this.foreignKey, '=', parentKey)
+                    .where(this.morphType, '=', this.morphClass);
+            }
+        }
+    }
+    /**
+     * Set the constraints for an eager load of the relation
+     */
+    addEagerConstraints(models) {
+        const keys = this.getKeys(models, this.localKey);
+        this.query
+            .whereIn(this.foreignKey, keys)
+            .where(this.morphType, '=', this.morphClass);
+    }
+    /**
+     * Initialize the relation on a set of models
+     */
+    initRelation(models, relation) {
+        for (const model of models) {
+            model.setRelation(relation, null);
+        }
+        return models;
+    }
+    /**
+     * Match the eagerly loaded results to their parents
+     */
+    match(models, results, relation) {
+        const dictionary = this.buildDictionary(results);
+        for (const model of models) {
+            const key = model.getAttribute(this.localKey);
+            if (key !== null && key !== undefined && dictionary[key]) {
+                model.setRelation(relation, dictionary[key][0]);
+            }
+        }
+        return models;
+    }
+    /**
+     * Build model dictionary keyed by the relation's foreign key
+     */
+    buildDictionary(results) {
+        const dictionary = {};
+        for (const result of results) {
+            const key = result.getAttribute(this.foreignKey);
+            if (key !== null && key !== undefined) {
+                if (!dictionary[key]) {
+                    dictionary[key] = [];
+                }
+                dictionary[key].push(result);
+            }
+        }
+        return dictionary;
+    }
+    /**
+     * Get the results of the relationship
+     */
+    async getResults() {
+        if (!this.getParentKey()) {
+            return null;
+        }
+        this.ensureConstraints();
+        return this.query.first();
+    }
+    /**
+     * Get the key value of the parent's local key
+     */
+    getParentKey() {
+        return this.parent.getAttribute(this.localKey);
+    }
+    /**
+     * Get the morph class for the parent
+     */
+    getMorphClass() {
+        return MorphMap_1.MorphMap.getMorphedModel(this.parent);
+    }
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName() {
+        return this.foreignKey;
+    }
+    /**
+     * Get the morph type for the relationship
+     */
+    getMorphType() {
+        return this.morphType;
+    }
+    /**
+     * Get the local key for the relationship
+     */
+    getLocalKeyName() {
+        return this.localKey;
+    }
+    /**
+     * Make a new related instance
+     */
+    make(attributes = {}) {
+        return this.related.newInstance(attributes);
+    }
+    /**
+     * Create a new instance of the related model
+     */
+    async create(attributes = {}) {
+        const instance = this.make(attributes);
+        // Set both the foreign key and morph type
+        instance.setAttribute(this.foreignKey, this.getParentKey());
+        instance.setAttribute(this.morphType, this.morphClass);
+        await instance.save();
+        return instance;
+    }
+    /**
+     * Save a model and set the foreign key and morph type
+     */
+    async save(model) {
+        model.setAttribute(this.foreignKey, this.getParentKey());
+        model.setAttribute(this.morphType, this.morphClass);
+        await model.save();
+        return model;
+    }
+    /**
+     * Update the parent model on the relationship
+     */
+    async update(attributes) {
+        const updatedAtColumn = this.related.getUpdatedAtColumn();
+        if (updatedAtColumn) {
+            attributes[updatedAtColumn] = new Date();
+        }
+        return this.query.update(attributes);
+    }
+}
+exports.MorphOne = MorphOne;
+//# sourceMappingURL=MorphOne.js.map

package/dist/Database/Ensemble/Relations/MorphOne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphOne.js","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/MorphOne.ts"],"names":[],"mappings":"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"}

package/dist/Database/Ensemble/Relations/MorphTo.d.ts

@@ -0,0 +1,98 @@
+/**
+ * MorphTo Relationship
+ *
+ * Represents a polymorphic inverse relationship
+ * Example: Comment belongs to Post or Video (commentable)
+ */
+import { Ensemble } from '../Ensemble';
+import { EnsembleBuilder } from '../EnsembleBuilder';
+import { EnsembleCollection } from '../EnsembleCollection';
+import { Relation } from './Relation';
+export declare class MorphTo<TParent extends Ensemble> extends Relation<Ensemble, TParent> {
+    /**
+     * The foreign key of the parent model (e.g., 'commentable_id')
+     */
+    protected foreignKey: string;
+    /**
+     * The morph type column (e.g., 'commentable_type')
+     */
+    protected morphType: string;
+    /**
+     * The owner key on the related model
+     */
+    protected ownerKey: string;
+    /**
+     * The name of the relationship
+     */
+    protected relationName: string;
+    /**
+     * Dictionary of models grouped by type
+     */
+    protected dictionary: Map<string, Map<any, Ensemble>>;
+    /**
+     * Models loaded by type
+     */
+    protected models: Map<string, Ensemble[]>;
+    /**
+     * Create a new morph to relationship instance
+     */
+    constructor(query: EnsembleBuilder<Ensemble>, parent: TParent, foreignKey: string, morphType: string, ownerKey: string, relationName: string);
+    /**
+     * Set the base constraints on the relation query
+     * MorphTo doesn't use base constraints - queries are built per type
+     */
+    addConstraints(): void;
+    /**
+     * Set the constraints for an eager load of the relation
+     */
+    addEagerConstraints(models: TParent[]): void;
+    /**
+     * Build dictionary of models grouped by morph type
+     */
+    protected buildDictionary(models: TParent[]): void;
+    /**
+     * Initialize the relation on a set of models
+     */
+    initRelation(models: TParent[], relation: string): TParent[];
+    /**
+     * Match the eagerly loaded results to their parents
+     */
+    match(models: TParent[], results: EnsembleCollection<Ensemble>, relation: string): TParent[];
+    /**
+     * Get the eager loading results
+     */
+    getEager(): Promise<Ensemble[]>;
+    /**
+     * Get the results of the relationship
+     */
+    getResults(): Promise<Ensemble | null>;
+    /**
+     * Associate the model instance to the parent model
+     */
+    associate(model: Ensemble | null): this;
+    /**
+     * Dissociate the model from the parent
+     */
+    dissociate(): this;
+    /**
+     * Get the foreign key value
+     */
+    protected getForeignKeyValue(): any;
+    /**
+     * Get the morph type value
+     */
+    protected getMorphTypeValue(): string | null;
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName(): string;
+    /**
+     * Get the morph type for the relationship
+     */
+    getMorphType(): string;
+    /**
+     * Get the owner key for the relationship
+     */
+    getOwnerKeyName(): string;
+}
+//# sourceMappingURL=MorphTo.d.ts.map

package/dist/Database/Ensemble/Relations/MorphTo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphTo.d.ts","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/MorphTo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,qBAAa,OAAO,CAAC,OAAO,SAAS,QAAQ,CAAE,SAAQ,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAChF;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAa;IAElE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAa;IAEtD;;OAEG;gBAED,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM;IAUtB;;;OAGG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAK5C;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAoBlD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAQ5D;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAuB5F;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgCrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAsB5C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IAYvC;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,GAAG;IAInC;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B"}

package/dist/Database/Ensemble/Relations/MorphTo.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * MorphTo Relationship
+ *
+ * Represents a polymorphic inverse relationship
+ * Example: Comment belongs to Post or Video (commentable)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MorphTo = void 0;
+const Relation_1 = require("./Relation");
+const MorphMap_1 = require("./MorphMap");
+class MorphTo extends Relation_1.Relation {
+    /**
+     * The foreign key of the parent model (e.g., 'commentable_id')
+     */
+    foreignKey;
+    /**
+     * The morph type column (e.g., 'commentable_type')
+     */
+    morphType;
+    /**
+     * The owner key on the related model
+     */
+    ownerKey;
+    /**
+     * The name of the relationship
+     */
+    relationName;
+    /**
+     * Dictionary of models grouped by type
+     */
+    dictionary = new Map();
+    /**
+     * Models loaded by type
+     */
+    models = new Map();
+    /**
+     * Create a new morph to relationship instance
+     */
+    constructor(query, parent, foreignKey, morphType, ownerKey, relationName) {
+        super(query, parent);
+        this.foreignKey = foreignKey;
+        this.morphType = morphType;
+        this.ownerKey = ownerKey;
+        this.relationName = relationName;
+        // Don't call initializeRelation() - MorphTo doesn't add constraints in constructor
+    }
+    /**
+     * Set the base constraints on the relation query
+     * MorphTo doesn't use base constraints - queries are built per type
+     */
+    addConstraints() {
+        // MorphTo doesn't add constraints here
+        // Constraints are added dynamically based on type
+    }
+    /**
+     * Set the constraints for an eager load of the relation
+     */
+    addEagerConstraints(models) {
+        // Build dictionary grouped by type
+        this.buildDictionary(models);
+    }
+    /**
+     * Build dictionary of models grouped by morph type
+     */
+    buildDictionary(models) {
+        this.dictionary.clear();
+        for (const model of models) {
+            const type = model.getAttribute(this.morphType);
+            const id = model.getAttribute(this.foreignKey);
+            if (!type || (id === null || id === undefined)) {
+                continue;
+            }
+            if (!this.dictionary.has(type)) {
+                this.dictionary.set(type, new Map());
+            }
+            const typeDict = this.dictionary.get(type);
+            typeDict.set(id, null); // Placeholder, will be replaced in match
+        }
+    }
+    /**
+     * Initialize the relation on a set of models
+     */
+    initRelation(models, relation) {
+        for (const model of models) {
+            model.setRelation(relation, null);
+        }
+        return models;
+    }
+    /**
+     * Match the eagerly loaded results to their parents
+     */
+    match(models, results, relation) {
+        // Match each model with its related parent
+        for (const model of models) {
+            const type = model.getAttribute(this.morphType);
+            const id = model.getAttribute(this.foreignKey);
+            if (!type || (id === null || id === undefined)) {
+                model.setRelation(relation, null);
+                continue;
+            }
+            const typeDict = this.dictionary.get(type);
+            if (typeDict && typeDict.has(id)) {
+                const related = typeDict.get(id);
+                model.setRelation(relation, related || null);
+            }
+            else {
+                model.setRelation(relation, null);
+            }
+        }
+        return models;
+    }
+    /**
+     * Get the eager loading results
+     */
+    async getEager() {
+        const allResults = [];
+        for (const [type, ids] of this.dictionary.entries()) {
+            const modelClass = MorphMap_1.MorphMap.getClass(type);
+            if (!modelClass) {
+                console.warn(`MorphTo: Unknown morph type "${type}". Did you forget to register it in MorphMap?`);
+                continue;
+            }
+            const instance = new modelClass();
+            const models = await instance
+                .newQuery()
+                .whereIn(this.ownerKey, Array.from(ids.keys()))
+                .get();
+            // Store in dictionary for matching
+            for (const model of models) {
+                const key = model.getAttribute(this.ownerKey);
+                const typeDict = this.dictionary.get(type);
+                if (typeDict && typeDict.has(key)) {
+                    typeDict.set(key, model);
+                }
+            }
+            allResults.push(...models);
+        }
+        return allResults;
+    }
+    /**
+     * Get the results of the relationship
+     */
+    async getResults() {
+        const type = this.parent.getAttribute(this.morphType);
+        const id = this.parent.getAttribute(this.foreignKey);
+        if (!type || (id === null || id === undefined)) {
+            return null;
+        }
+        const modelClass = MorphMap_1.MorphMap.getClass(type);
+        if (!modelClass) {
+            console.warn(`MorphTo: Unknown morph type "${type}". Did you forget to register it in MorphMap?`);
+            return null;
+        }
+        const instance = new modelClass();
+        return instance
+            .newQuery()
+            .where(this.ownerKey, '=', id)
+            .first();
+    }
+    /**
+     * Associate the model instance to the parent model
+     */
+    associate(model) {
+        if (model === null) {
+            return this.dissociate();
+        }
+        this.parent.setAttribute(this.foreignKey, model.getAttribute(this.ownerKey));
+        this.parent.setAttribute(this.morphType, MorphMap_1.MorphMap.getMorphedModel(model));
+        this.parent.setRelation(this.relationName, model);
+        return this;
+    }
+    /**
+     * Dissociate the model from the parent
+     */
+    dissociate() {
+        this.parent.setAttribute(this.foreignKey, null);
+        this.parent.setAttribute(this.morphType, null);
+        this.parent.setRelation(this.relationName, null);
+        return this;
+    }
+    /**
+     * Get the foreign key value
+     */
+    getForeignKeyValue() {
+        return this.parent.getAttribute(this.foreignKey);
+    }
+    /**
+     * Get the morph type value
+     */
+    getMorphTypeValue() {
+        return this.parent.getAttribute(this.morphType);
+    }
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName() {
+        return this.foreignKey;
+    }
+    /**
+     * Get the morph type for the relationship
+     */
+    getMorphType() {
+        return this.morphType;
+    }
+    /**
+     * Get the owner key for the relationship
+     */
+    getOwnerKeyName() {
+        return this.ownerKey;
+    }
+}
+exports.MorphTo = MorphTo;
+//# sourceMappingURL=MorphTo.js.map