@holoyan/adonisjs-polymorphic 0.1.0

package/build/src/relations/morph_one/index.d.ts

@@ -0,0 +1,68 @@
+import type { MorphOneOptions } from '../../types.js';
+import { MorphOneQueryClient } from './query_client.js';
+/**
+ * MorphOne relation - the parent model has exactly one polymorphic child.
+ *
+ * Example: Post morphOne Image (imageable)
+ *   images table has: imageable_type = 'posts', imageable_id = post.id
+ */
+export declare class MorphOne {
+    readonly relationName: string;
+    readonly relatedModel: () => any;
+    private readonly options;
+    readonly model: any;
+    readonly type = "hasOne";
+    booted: boolean;
+    serializeAs: string | null;
+    /** @internal used by the query hook */
+    onQueryHook: ((query: any) => void) | undefined;
+    /** Attribute name for the morph type column on the related model */
+    morphTypeKey: string;
+    /** DB column name for the morph type on the related model */
+    morphTypeColumnName: string;
+    /** Attribute name for the morph id column on the related model */
+    morphIdKey: string;
+    /** DB column name for the morph id on the related model */
+    morphIdColumnName: string;
+    /** Attribute name of the local key on the parent model */
+    localKey: string;
+    /** DB column name of the local key on the parent model */
+    localKeyColumnName: string;
+    /** Value stored in the morph type column to identify this parent model */
+    morphValue: string;
+    constructor(relationName: string, relatedModel: () => any, options: MorphOneOptions, model: any);
+    clone(parent: any): MorphOne;
+    /**
+     * Boot the relation - validates that all required columns exist and
+     * resolves attribute names / column names.
+     */
+    boot(): void;
+    /**
+     * Sets the related model instance on the parent (used by the preloader).
+     */
+    setRelated(parent: any, related: any): void;
+    pushRelated(parent: any, related: any): void;
+    /**
+     * Matches and sets related models on each parent during eager loading.
+     * For morphOne there is at most one related row per parent.
+     */
+    setRelatedForMany(parents: any[], related: any[]): void;
+    /**
+     * Returns a query client that can be used from model.related('relation').
+     */
+    client(parent: any, client: any): MorphOneQueryClient;
+    /**
+     * Returns an eager-load query (used by the Lucid preloader).
+     */
+    eagerQuery(parent: any | any[], client: any): import("./query_builder.js").MorphOneQueryBuilder;
+    /**
+     * Returns a subquery builder (for whereHas / withCount).
+     */
+    subQuery(client: any): never;
+    /**
+     * Hydrates the related model / plain object with the morph FK values
+     * before persisting. Called by the query client's create/save methods.
+     */
+    hydrateForPersistance(parent: any, related: any): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/build/src/relations/morph_one/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/relations/morph_one/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGvD;;;;;GAKG;AACH,qBAAa,QAAQ;aAwBD,YAAY,EAAE,MAAM;aACpB,YAAY,EAAE,MAAM,GAAG;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO;aACR,KAAK,EAAE,GAAG;IA1B5B,QAAQ,CAAC,IAAI,YAAW;IACxB,MAAM,UAAQ;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAE1B,uCAAuC;IACvC,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAE/C,oEAAoE;IACpE,YAAY,EAAG,MAAM,CAAA;IACrB,6DAA6D;IAC7D,mBAAmB,EAAG,MAAM,CAAA;IAC5B,kEAAkE;IAClE,UAAU,EAAG,MAAM,CAAA;IACnB,2DAA2D;IAC3D,iBAAiB,EAAG,MAAM,CAAA;IAC1B,0DAA0D;IAC1D,QAAQ,EAAG,MAAM,CAAA;IACjB,0DAA0D;IAC1D,kBAAkB,EAAG,MAAM,CAAA;IAC3B,0EAA0E;IAC1E,UAAU,EAAG,MAAM,CAAA;gBAGD,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,EACtB,OAAO,EAAE,eAAe,EACzB,KAAK,EAAE,GAAG;IAO5B,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,QAAQ;IAI5B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAuDZ;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAK3C,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAK5C;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI;IAUvD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,mBAAmB;IAKrD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG;IAK3C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK;IAI5B;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;CAIvD"}

package/build/src/relations/morph_one/index.js

@@ -0,0 +1,147 @@
+import { MorphOneQueryClient } from './query_client.js';
+import { getRegistry } from '../morph_to/registry.js';
+/**
+ * MorphOne relation - the parent model has exactly one polymorphic child.
+ *
+ * Example: Post morphOne Image (imageable)
+ *   images table has: imageable_type = 'posts', imageable_id = post.id
+ */
+export class MorphOne {
+    relationName;
+    relatedModel;
+    options;
+    model;
+    type = 'hasOne';
+    booted = false;
+    serializeAs;
+    /** @internal used by the query hook */
+    onQueryHook;
+    /** Attribute name for the morph type column on the related model */
+    morphTypeKey;
+    /** DB column name for the morph type on the related model */
+    morphTypeColumnName;
+    /** Attribute name for the morph id column on the related model */
+    morphIdKey;
+    /** DB column name for the morph id on the related model */
+    morphIdColumnName;
+    /** Attribute name of the local key on the parent model */
+    localKey;
+    /** DB column name of the local key on the parent model */
+    localKeyColumnName;
+    /** Value stored in the morph type column to identify this parent model */
+    morphValue;
+    constructor(relationName, relatedModel, options, model) {
+        this.relationName = relationName;
+        this.relatedModel = relatedModel;
+        this.options = options;
+        this.model = model;
+        this.onQueryHook = options.onQuery;
+        this.serializeAs =
+            options.serializeAs === undefined ? relationName : options.serializeAs;
+    }
+    clone(parent) {
+        return new MorphOne(this.relationName, this.relatedModel, { ...this.options }, parent);
+    }
+    /**
+     * Boot the relation - validates that all required columns exist and
+     * resolves attribute names / column names.
+     */
+    boot() {
+        if (this.booted)
+            return;
+        const relatedModel = this.relatedModel();
+        const morphName = this.options.name;
+        // Derive camelCase attribute names from the morph name
+        const typeAttr = `${morphName}Type`; // e.g., 'imageableType'
+        const idAttr = `${morphName}Id`; // e.g., 'imageableId'
+        // Resolve column names from related model's @column() definitions
+        const typeColDef = relatedModel.$getColumn(typeAttr);
+        if (!typeColDef) {
+            throw new Error(`[MorphOne] "${typeAttr}" column not found on "${relatedModel.name}". ` +
+                `Add @column() declare ${typeAttr}: string`);
+        }
+        const idColDef = relatedModel.$getColumn(idAttr);
+        if (!idColDef) {
+            throw new Error(`[MorphOne] "${idAttr}" column not found on "${relatedModel.name}". ` +
+                `Add @column() declare ${idAttr}: number`);
+        }
+        this.morphTypeKey = typeAttr;
+        this.morphTypeColumnName = typeColDef.columnName;
+        this.morphIdKey = idAttr;
+        this.morphIdColumnName = idColDef.columnName;
+        // Resolve local key on parent model
+        const localKeyAttr = this.options.localKey ?? this.model.primaryKey;
+        const localColDef = this.model.$getColumn(localKeyAttr);
+        if (!localColDef) {
+            throw new Error(`[MorphOne] "${localKeyAttr}" column not found on "${this.model.name}".`);
+        }
+        this.localKey = localKeyAttr;
+        this.localKeyColumnName = localColDef.columnName;
+        // The value stored in the type column.
+        // Priority: explicit option → @MorphMap alias → model table name
+        if (this.options.morphValue) {
+            this.morphValue = this.options.morphValue;
+        }
+        else {
+            const registry = getRegistry();
+            const alias = registry?.hasTarget(this.model) ? registry.getAlias(this.model) : null;
+            this.morphValue = alias ?? this.model.table;
+        }
+        this.booted = true;
+    }
+    /**
+     * Sets the related model instance on the parent (used by the preloader).
+     */
+    setRelated(parent, related) {
+        if (related === undefined)
+            return;
+        parent.$setRelated(this.relationName, related);
+    }
+    pushRelated(parent, related) {
+        if (related === undefined)
+            return;
+        parent.$pushRelated(this.relationName, related);
+    }
+    /**
+     * Matches and sets related models on each parent during eager loading.
+     * For morphOne there is at most one related row per parent.
+     */
+    setRelatedForMany(parents, related) {
+        parents.forEach((parentModel) => {
+            const parentId = parentModel[this.localKey];
+            const match = related.find((r) => parentId !== undefined && r[this.morphIdKey] === parentId);
+            this.setRelated(parentModel, match ?? null);
+        });
+    }
+    /**
+     * Returns a query client that can be used from model.related('relation').
+     */
+    client(parent, client) {
+        if (!this.booted)
+            this.boot();
+        return new MorphOneQueryClient(this, parent, client);
+    }
+    /**
+     * Returns an eager-load query (used by the Lucid preloader).
+     */
+    eagerQuery(parent, client) {
+        if (!this.booted)
+            this.boot();
+        return MorphOneQueryClient.eagerQuery(client, this, parent);
+    }
+    /**
+     * Returns a subquery builder (for whereHas / withCount).
+     */
+    subQuery(client) {
+        return MorphOneQueryClient.subQuery(client, this);
+    }
+    /**
+     * Hydrates the related model / plain object with the morph FK values
+     * before persisting. Called by the query client's create/save methods.
+     */
+    hydrateForPersistance(parent, related) {
+        related[this.morphTypeKey] = this.morphValue;
+        related[this.morphIdKey] = parent[this.localKey];
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/src/relations/morph_one/index.js.map

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

package/build/src/relations/morph_one/query_builder.d.ts

@@ -0,0 +1,22 @@
+import { MorphBaseQueryBuilder } from '../shared/query_builder.js';
+import type { MorphOne } from './index.js';
+/**
+ * Query builder for morphOne relations.
+ * Scopes queries to WHERE morphType = value AND morphId = parentId LIMIT 1
+ */
+export declare class MorphOneQueryBuilder extends MorphBaseQueryBuilder {
+    private parent;
+    relation: MorphOne;
+    constructor(builder: any, client: any, parent: any, relation: MorphOne);
+    profilerData(): {
+        type: string;
+        model: any;
+        relatedModel: any;
+    };
+    getRelationKeys(): string[];
+    applyConstraints(): void;
+    clone(): MorphOneQueryBuilder;
+    paginate(): never;
+    getGroupLimitQuery(): never;
+}
+//# sourceMappingURL=query_builder.d.ts.map

package/build/src/relations/morph_one/query_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_builder.d.ts","sourceRoot":"","sources":["../../../../src/relations/morph_one/query_builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,qBAAqB;IAI3D,OAAO,CAAC,MAAM;IACP,QAAQ,EAAE,QAAQ;gBAHzB,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG,EACH,MAAM,EAAE,GAAG,EACZ,QAAQ,EAAE,QAAQ;IAa3B,YAAY;;;;;IAQZ,eAAe,IAAI,MAAM,EAAE;IAI3B,gBAAgB,IAAI,IAAI;IAwCxB,KAAK,IAAI,oBAAoB;IAa7B,QAAQ,IAAI,KAAK;IAMjB,kBAAkB,IAAI,KAAK;CAK5B"}

package/build/src/relations/morph_one/query_builder.js

@@ -0,0 +1,79 @@
+import { unique } from '@adonisjs/lucid/utils';
+import { MorphBaseQueryBuilder } from '../shared/query_builder.js';
+/**
+ * Query builder for morphOne relations.
+ * Scopes queries to WHERE morphType = value AND morphId = parentId LIMIT 1
+ */
+export class MorphOneQueryBuilder extends MorphBaseQueryBuilder {
+    parent;
+    relation;
+    constructor(builder, client, parent, relation) {
+        super(builder, relation.relatedModel(), client, (userFn) => {
+            return ($builder) => {
+                const subQuery = new MorphOneQueryBuilder($builder, this.client, this.parent, this.relation);
+                subQuery.isChildQuery = true;
+                subQuery.isRelatedPreloadQuery = this.isRelatedPreloadQuery;
+                userFn(subQuery);
+                subQuery.applyWhere();
+            };
+        });
+        this.parent = parent;
+        this.relation = relation;
+    }
+    profilerData() {
+        return {
+            type: this.relation.type,
+            model: this.relation.model.name,
+            relatedModel: this.relation.relatedModel().name,
+        };
+    }
+    getRelationKeys() {
+        return [this.relation.morphIdKey];
+    }
+    applyConstraints() {
+        if (this.appliedConstraints)
+            return;
+        this.appliedConstraints = true;
+        const queryAction = this.queryAction();
+        if (Array.isArray(this.parent)) {
+            // Eager loading: WHERE type = 'posts' AND id IN (1, 2, 3)
+            const ids = unique(this.parent.map((model) => {
+                const val = model[this.relation.localKey];
+                if (val === undefined) {
+                    throw new Error(`Cannot preload "${this.relation.relationName}", value of "${this.relation.model.name}.${this.relation.localKey}" is undefined`);
+                }
+                return val;
+            }));
+            this.wrapExisting()
+                .where(this.relation.morphTypeColumnName, this.relation.morphValue)
+                .whereIn(this.relation.morphIdColumnName, ids);
+        }
+        else {
+            // Single query: WHERE type = 'posts' AND id = 5 LIMIT 1
+            const id = this.parent[this.relation.localKey];
+            if (id === undefined) {
+                throw new Error(`Cannot ${queryAction} "${this.relation.relationName}", value of "${this.relation.model.name}.${this.relation.localKey}" is undefined`);
+            }
+            this.wrapExisting()
+                .where(this.relation.morphTypeColumnName, this.relation.morphValue)
+                .where(this.relation.morphIdColumnName, id);
+            if (!['update', 'delete'].includes(queryAction)) {
+                this.limit(1);
+            }
+        }
+    }
+    clone() {
+        const clonedQuery = new MorphOneQueryBuilder(this.knexQuery.clone(), this.client, this.parent, this.relation);
+        clonedQuery.appliedConstraints = this.appliedConstraints;
+        clonedQuery.isRelatedPreloadQuery = this.isRelatedPreloadQuery;
+        this.applyQueryFlags(clonedQuery);
+        return clonedQuery;
+    }
+    paginate() {
+        throw new Error(`Cannot paginate a morphOne relationship "(${this.relation.relationName})"`);
+    }
+    getGroupLimitQuery() {
+        throw new Error(`Cannot apply groupLimit on a morphOne relationship "(${this.relation.relationName})"`);
+    }
+}
+//# sourceMappingURL=query_builder.js.map

package/build/src/relations/morph_one/query_builder.js.map

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

package/build/src/relations/morph_one/query_client.d.ts

@@ -0,0 +1,41 @@
+import { MorphOneQueryBuilder } from './query_builder.js';
+import type { MorphOne } from './index.js';
+/**
+ * Query client for morphOne - provides read and write methods
+ * in scope of the relation.
+ */
+export declare class MorphOneQueryClient {
+    private relation;
+    private parent;
+    private client;
+    constructor(relation: MorphOne, parent: any, client: any);
+    /**
+     * Creates an eager-load query builder (used by the Lucid preloader).
+     */
+    static eagerQuery(client: any, relation: MorphOne, rows: any | any[]): MorphOneQueryBuilder;
+    /**
+     * Creates a subquery builder (used for whereHas / withCount).
+     */
+    static subQuery(_client: any, relation: MorphOne): never;
+    /**
+     * Returns a query builder scoped to this relation for ad-hoc queries.
+     */
+    query(): MorphOneQueryBuilder;
+    /**
+     * Saves an existing related model instance, hydrating the morph FK columns.
+     */
+    save(related: any): Promise<void>;
+    /**
+     * Creates a new related model instance, automatically setting morph FK columns.
+     */
+    create(values: Record<string, any>, options?: any): Promise<any>;
+    /**
+     * Finds the first matching related model or creates a new one.
+     */
+    firstOrCreate(search: Record<string, any>, savePayload?: Record<string, any>, options?: any): Promise<any>;
+    /**
+     * Updates the existing related model or creates a new one.
+     */
+    updateOrCreate(search: Record<string, any>, updatePayload: Record<string, any>, options?: any): Promise<any>;
+}
+//# sourceMappingURL=query_client.d.ts.map

package/build/src/relations/morph_one/query_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_client.d.ts","sourceRoot":"","sources":["../../../../src/relations/morph_one/query_client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;;GAGG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;gBAFN,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,GAAG;IAGrB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE;IAOpE;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK;IAMxD;;OAEG;IACH,KAAK,IAAI,oBAAoB;IAW7B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAUtE;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAAC,GAAG,CAAC;IAYf;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAAC,GAAG,CAAC;CAWhB"}

package/build/src/relations/morph_one/query_client.js

@@ -0,0 +1,94 @@
+import { managedTransaction } from '@adonisjs/lucid/utils';
+import { MorphOneQueryBuilder } from './query_builder.js';
+/**
+ * Query client for morphOne - provides read and write methods
+ * in scope of the relation.
+ */
+export class MorphOneQueryClient {
+    relation;
+    parent;
+    client;
+    constructor(relation, parent, client) {
+        this.relation = relation;
+        this.parent = parent;
+        this.client = client;
+    }
+    /**
+     * Creates an eager-load query builder (used by the Lucid preloader).
+     */
+    static eagerQuery(client, relation, rows) {
+        const query = new MorphOneQueryBuilder(client.knexQuery(), client, rows, relation);
+        query.isRelatedPreloadQuery = true;
+        if (typeof relation.onQueryHook === 'function')
+            relation.onQueryHook(query);
+        return query;
+    }
+    /**
+     * Creates a subquery builder (used for whereHas / withCount).
+     */
+    static subQuery(_client, relation) {
+        throw new Error(`morphOne: whereHas/withCount is not yet supported for polymorphic relations ("${relation.relationName}")`);
+    }
+    /**
+     * Returns a query builder scoped to this relation for ad-hoc queries.
+     */
+    query() {
+        const query = new MorphOneQueryBuilder(this.client.knexQuery(), this.client, this.parent, this.relation);
+        if (typeof this.relation.onQueryHook === 'function')
+            this.relation.onQueryHook(query);
+        return query;
+    }
+    /**
+     * Saves an existing related model instance, hydrating the morph FK columns.
+     */
+    async save(related) {
+        await managedTransaction(this.parent.$trx || this.client, async (trx) => {
+            this.parent.$trx = trx;
+            await this.parent.save();
+            this.relation.hydrateForPersistance(this.parent, related);
+            related.$trx = trx;
+            await related.save();
+        });
+    }
+    /**
+     * Creates a new related model instance, automatically setting morph FK columns.
+     */
+    async create(values, options) {
+        return managedTransaction(this.parent.$trx || this.client, async (trx) => {
+            this.parent.$trx = trx;
+            await this.parent.save();
+            const valuesToPersist = { ...values };
+            this.relation.hydrateForPersistance(this.parent, valuesToPersist);
+            return this.relation.relatedModel().create(valuesToPersist, { client: trx, ...options });
+        });
+    }
+    /**
+     * Finds the first matching related model or creates a new one.
+     */
+    async firstOrCreate(search, savePayload, options) {
+        return managedTransaction(this.parent.$trx || this.client, async (trx) => {
+            this.parent.$trx = trx;
+            await this.parent.save();
+            const valuesToPersist = { ...search };
+            this.relation.hydrateForPersistance(this.parent, valuesToPersist);
+            return this.relation
+                .relatedModel()
+                .firstOrCreate(valuesToPersist, savePayload, { client: trx, ...options });
+        });
+    }
+    /**
+     * Updates the existing related model or creates a new one.
+     */
+    async updateOrCreate(search, updatePayload, options) {
+        return managedTransaction(this.parent.$trx || this.client, async (trx) => {
+            this.parent.$trx = trx;
+            await this.parent.save();
+            const valuesToPersist = { ...search };
+            this.relation.hydrateForPersistance(this.parent, valuesToPersist);
+            return this.relation
+                .relatedModel()
+                .updateOrCreate(valuesToPersist, updatePayload, { client: trx, ...options });
+        });
+    }
+}
+//# sourceMappingURL=query_client.js.map

package/build/src/relations/morph_one/query_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_client.js","sourceRoot":"","sources":["../../../../src/relations/morph_one/query_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAGzD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAEpB;IACA;IACA;IAHV,YACU,QAAkB,EAClB,MAAW,EACX,MAAW;QAFX,aAAQ,GAAR,QAAQ,CAAU;QAClB,WAAM,GAAN,MAAM,CAAK;QACX,WAAM,GAAN,MAAM,CAAK;IAClB,CAAC;IAEJ;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAW,EAAE,QAAkB,EAAE,IAAiB;QAClE,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QAClF,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAA;QAClC,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,UAAU;YAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC3E,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAY,EAAE,QAAkB;QAC9C,MAAM,IAAI,KAAK,CACb,iFAAiF,QAAQ,CAAC,YAAY,IAAI,CAC3G,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,oBAAoB,CACpC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EACvB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,QAAQ,CACd,CAAA;QACD,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,KAAK,UAAU;YAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACrF,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAY;QACrB,MAAM,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;YAC3E,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAA;YACtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YACxB,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACzD,OAAO,CAAC,IAAI,GAAG,GAAG,CAAA;YAClB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B,EAAE,OAAa;QACrD,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;YAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAA;YACtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YACxB,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;YACrC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;YACjE,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QAC1F,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,MAA2B,EAC3B,WAAiC,EACjC,OAAa;QAEb,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;YAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAA;YACtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YACxB,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;YACrC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;YACjE,OAAO,IAAI,CAAC,QAAQ;iBACjB,YAAY,EAAE;iBACd,aAAa,CAAC,eAAe,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QAC7E,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,MAA2B,EAC3B,aAAkC,EAClC,OAAa;QAEb,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;YAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAA;YACtB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YACxB,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;YACrC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;YACjE,OAAO,IAAI,CAAC,QAAQ;iBACjB,YAAY,EAAE;iBACd,cAAc,CAAC,eAAe,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QAChF,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/build/src/relations/morph_to/eager_loader.d.ts

@@ -0,0 +1,29 @@
+import type { MorphTo } from './index.js';
+/**
+ * Handles eager loading for morphTo relations.
+ *
+ * Since different parent rows may belong to completely different model types
+ * (e.g., some comments belong to Post, others to Video), a single SQL query
+ * cannot cover all cases. This loader:
+ *   1. Groups parents by their morph type value
+ *   2. Runs one query per unique type against the correct table
+ *   3. Tags each result with __morphType and __morphPk in $extras
+ *      so setRelatedForMany() can match them back to their parents
+ */
+export declare class MorphToEagerLoader {
+    private client;
+    private relation;
+    private parents;
+    isRelatedPreloadQuery: boolean;
+    constructor(client: any, relation: MorphTo, parents: any[]);
+    debug(_flag: boolean): this;
+    sideload(_values: Record<string, any>): this;
+    selectRelationKeys(): this;
+    /**
+     * Executes all needed queries and returns a flat list of related model instances.
+     * Each instance gets __morphType and __morphPk stored in $extras so that
+     * MorphTo.setRelatedForMany() can match it back to the right parent.
+     */
+    exec(): Promise<any[]>;
+}
+//# sourceMappingURL=eager_loader.d.ts.map

package/build/src/relations/morph_to/eager_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager_loader.d.ts","sourceRoot":"","sources":["../../../../src/relations/morph_to/eager_loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IALjB,qBAAqB,UAAO;gBAGlB,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,GAAG,EAAE;IAKxB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5C,kBAAkB,IAAI,IAAI;IAI1B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CA8C7B"}

package/build/src/relations/morph_to/eager_loader.js

@@ -0,0 +1,78 @@
+/**
+ * Handles eager loading for morphTo relations.
+ *
+ * Since different parent rows may belong to completely different model types
+ * (e.g., some comments belong to Post, others to Video), a single SQL query
+ * cannot cover all cases. This loader:
+ *   1. Groups parents by their morph type value
+ *   2. Runs one query per unique type against the correct table
+ *   3. Tags each result with __morphType and __morphPk in $extras
+ *      so setRelatedForMany() can match them back to their parents
+ */
+export class MorphToEagerLoader {
+    client;
+    relation;
+    parents;
+    isRelatedPreloadQuery = true;
+    constructor(client, relation, parents) {
+        this.client = client;
+        this.relation = relation;
+        this.parents = parents;
+    }
+    // The preloader calls these on the object returned by eagerQuery().
+    // For MorphTo the underlying query is dynamic, so these are no-ops.
+    debug(_flag) {
+        return this;
+    }
+    sideload(_values) {
+        return this;
+    }
+    selectRelationKeys() {
+        return this;
+    }
+    /**
+     * Executes all needed queries and returns a flat list of related model instances.
+     * Each instance gets __morphType and __morphPk stored in $extras so that
+     * MorphTo.setRelatedForMany() can match it back to the right parent.
+     */
+    async exec() {
+        // Group parent rows by their morph type value
+        const groups = new Map();
+        for (const parent of this.parents) {
+            const morphType = parent[this.relation.morphTypeKey];
+            if (!morphType)
+                continue;
+            if (!groups.has(morphType))
+                groups.set(morphType, []);
+            groups.get(morphType).push(parent);
+        }
+        const allResults = [];
+        for (const [morphType, parentGroup] of groups) {
+            const modelFactory = this.relation.resolveModelFactory(morphType);
+            if (!modelFactory) {
+                // Unknown type - skip silently (will result in null on the parent)
+                continue;
+            }
+            const RelatedModel = modelFactory();
+            // Collect unique IDs for this type
+            const ids = [
+                ...new Set(parentGroup
+                    .map((p) => p[this.relation.morphIdKey])
+                    .filter((v) => v != null)),
+            ];
+            if (ids.length === 0)
+                continue;
+            const results = await RelatedModel.query({ client: this.client })
+                .whereIn(RelatedModel.primaryKey, ids)
+                .exec();
+            // Tag each result so we can match it back during setRelatedForMany
+            for (const result of results) {
+                result.$extras.__morphType = morphType;
+                result.$extras.__morphPk = result[RelatedModel.primaryKey];
+                allResults.push(result);
+            }
+        }
+        return allResults;
+    }
+}
+//# sourceMappingURL=eager_loader.js.map

package/build/src/relations/morph_to/eager_loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager_loader.js","sourceRoot":"","sources":["../../../../src/relations/morph_to/eager_loader.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAInB;IACA;IACA;IALV,qBAAqB,GAAG,IAAI,CAAA;IAE5B,YACU,MAAW,EACX,QAAiB,EACjB,OAAc;QAFd,WAAM,GAAN,MAAM,CAAK;QACX,aAAQ,GAAR,QAAQ,CAAS;QACjB,YAAO,GAAP,OAAO,CAAO;IACrB,CAAC;IAEJ,oEAAoE;IACpE,oEAAoE;IACpE,KAAK,CAAC,KAAc;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,OAA4B;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,8CAA8C;QAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAA;QACvC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;YACpD,IAAI,CAAC,SAAS;gBAAE,SAAQ;YACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;YACrD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACrC,CAAC;QAED,MAAM,UAAU,GAAU,EAAE,CAAA;QAE5B,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,EAAE,CAAC;YAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAA;YACjE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,mEAAmE;gBACnE,SAAQ;YACV,CAAC;YAED,MAAM,YAAY,GAAG,YAAY,EAAE,CAAA;YAEnC,mCAAmC;YACnC,MAAM,GAAG,GAAG;gBACV,GAAG,IAAI,GAAG,CACR,WAAW;qBACR,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;qBAC5C,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CACjC;aACF,CAAA;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAE9B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;iBAC9D,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC;iBACrC,IAAI,EAAE,CAAA;YAET,mEAAmE;YACnE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAA;gBACtC,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;gBAC1D,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAA;IACnB,CAAC;CACF"}