@orchestr-sh/orchestr 1.2.1 → 1.4.0

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

@@ -0,0 +1,100 @@
+/**
+ * HasMany Relationship
+ *
+ * Represents a one-to-many relationship
+ */
+import { Ensemble } from '../Ensemble';
+import { EnsembleBuilder } from '../EnsembleBuilder';
+import { EnsembleCollection } from '../EnsembleCollection';
+import { Relation } from './Relation';
+export declare class HasMany<TRelated extends Ensemble, TParent extends Ensemble> extends Relation<TRelated, TParent> {
+    /**
+     * The foreign key of the parent model
+     */
+    protected foreignKey: string;
+    /**
+     * The local key of the parent model
+     */
+    protected localKey: string;
+    /**
+     * Create a new has many relationship instance
+     */
+    constructor(query: EnsembleBuilder<TRelated>, parent: TParent, foreignKey: string, 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[]>;
+    /**
+     * Get the key value of the parent's local key
+     */
+    protected getParentKey(): any;
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName(): 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>;
+    /**
+     * Create an array of new instances of the related model
+     */
+    createMany(records: Record<string, any>[]): Promise<TRelated[]>;
+    /**
+     * Create a new instance and set the foreign key
+     */
+    save(model: TRelated): Promise<TRelated>;
+    /**
+     * Save multiple models with the foreign key set
+     */
+    saveMany(models: TRelated[]): Promise<TRelated[]>;
+    /**
+     * Find a related model by its primary key
+     */
+    find(id: any): Promise<TRelated | null>;
+    /**
+     * Find multiple related models by their primary keys
+     */
+    findMany(ids: any[]): Promise<TRelated[]>;
+    /**
+     * Find a related model by its primary key or throw an exception
+     */
+    findOrFail(id: any): Promise<TRelated>;
+    /**
+     * Get the first related model matching the attributes or create it
+     */
+    firstOrCreate(attributes: Record<string, any>, values?: Record<string, any>): Promise<TRelated>;
+    /**
+     * Update the parent model on the relationship
+     */
+    update(attributes: Record<string, any>): Promise<number>;
+}
+//# sourceMappingURL=HasMany.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HasMany.d.ts","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/HasMany.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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;AAEtC,qBAAa,OAAO,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,SAAS,QAAQ,CAAE,SAAQ,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3G;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE3B;;OAEG;gBAED,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;IAOlB;;OAEG;IACH,cAAc,IAAI,IAAI;IAUtB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAK5C;;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;IAiB5F;;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,EAAE,CAAC;IAQvC;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,GAAG;IAI7B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;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;IAarE;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUrE;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAW9C;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQvD;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI7C;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI/C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU5C;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBzG;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ/D"}

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

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * HasMany Relationship
+ *
+ * Represents a one-to-many relationship
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasMany = void 0;
+const EnsembleCollection_1 = require("../EnsembleCollection");
+const Relation_1 = require("./Relation");
+class HasMany extends Relation_1.Relation {
+    /**
+     * The foreign key of the parent model
+     */
+    foreignKey;
+    /**
+     * The local key of the parent model
+     */
+    localKey;
+    /**
+     * Create a new has many relationship instance
+     */
+    constructor(query, parent, foreignKey, localKey) {
+        super(query, parent);
+        this.foreignKey = foreignKey;
+        this.localKey = localKey;
+    }
+    /**
+     * Set the base constraints on the relation query
+     */
+    addConstraints() {
+        if (Relation_1.Relation['constraints']) {
+            this.query.where(this.foreignKey, '=', this.getParentKey());
+        }
+    }
+    /**
+     * 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);
+    }
+    /**
+     * Initialize the relation on a set of models
+     */
+    initRelation(models, relation) {
+        for (const model of models) {
+            model.setRelation(relation, new EnsembleCollection_1.EnsembleCollection());
+        }
+        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, new EnsembleCollection_1.EnsembleCollection(dictionary[key]));
+            }
+        }
+        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 [];
+        }
+        return this.query.get();
+    }
+    /**
+     * Get the key value of the parent's local key
+     */
+    getParentKey() {
+        return this.parent.getAttribute(this.localKey);
+    }
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName() {
+        return this.foreignKey;
+    }
+    /**
+     * 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);
+        instance.setAttribute(this.foreignKey, this.getParentKey());
+        await instance.save();
+        return instance;
+    }
+    /**
+     * Create an array of new instances of the related model
+     */
+    async createMany(records) {
+        const instances = [];
+        for (const record of records) {
+            instances.push(await this.create(record));
+        }
+        return instances;
+    }
+    /**
+     * Create a new instance and set the foreign key
+     */
+    async save(model) {
+        model.setAttribute(this.foreignKey, this.getParentKey());
+        await model.save();
+        return model;
+    }
+    /**
+     * Save multiple models with the foreign key set
+     */
+    async saveMany(models) {
+        for (const model of models) {
+            await this.save(model);
+        }
+        return models;
+    }
+    /**
+     * Find a related model by its primary key
+     */
+    async find(id) {
+        return this.query.where(this.related.getKeyName(), '=', id).first();
+    }
+    /**
+     * Find multiple related models by their primary keys
+     */
+    async findMany(ids) {
+        return this.query.whereIn(this.related.getKeyName(), ids).get();
+    }
+    /**
+     * Find a related model by its primary key or throw an exception
+     */
+    async findOrFail(id) {
+        const result = await this.find(id);
+        if (!result) {
+            throw new Error(`Model not found with id: ${id}`);
+        }
+        return result;
+    }
+    /**
+     * Get the first related model matching the attributes or create it
+     */
+    async firstOrCreate(attributes, values = {}) {
+        let query = this.query.clone();
+        // Apply each attribute as a where clause
+        for (const [key, value] of Object.entries(attributes)) {
+            query = query.where(key, '=', value);
+        }
+        const instance = await query.first();
+        if (instance) {
+            return instance;
+        }
+        return this.create({ ...attributes, ...values });
+    }
+    /**
+     * 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.HasMany = HasMany;
+//# sourceMappingURL=HasMany.js.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * HasOne Relationship
+ *
+ * Represents a one-to-one relationship
+ */
+import { Ensemble } from '../Ensemble';
+import { EnsembleBuilder } from '../EnsembleBuilder';
+import { EnsembleCollection } from '../EnsembleCollection';
+import { Relation } from './Relation';
+export declare class HasOne<TRelated extends Ensemble, TParent extends Ensemble> extends Relation<TRelated, TParent> {
+    /**
+     * The foreign key of the parent model
+     */
+    protected foreignKey: string;
+    /**
+     * The local key of the parent model
+     */
+    protected localKey: string;
+    /**
+     * Create a new has one relationship instance
+     */
+    constructor(query: EnsembleBuilder<TRelated>, parent: TParent, foreignKey: string, 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 foreign key for the relationship
+     */
+    getForeignKeyName(): 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>;
+    /**
+     * Create a new instance and set the foreign key
+     */
+    save(model: TRelated): Promise<TRelated>;
+    /**
+     * Update the parent model on the relationship
+     */
+    update(attributes: Record<string, any>): Promise<number>;
+}
+//# sourceMappingURL=HasOne.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HasOne.d.ts","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/HasOne.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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;AAEtC,qBAAa,MAAM,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,SAAS,QAAQ,CAAE,SAAQ,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC1G;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE3B;;OAEG;gBAED,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;IAOlB;;OAEG;IACH,cAAc,IAAI,IAAI;IAUtB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAK5C;;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;IAQ5C;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,GAAG;IAI7B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;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;IAarE;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAW9C;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ/D"}

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

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * HasOne Relationship
+ *
+ * Represents a one-to-one relationship
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasOne = void 0;
+const Relation_1 = require("./Relation");
+class HasOne extends Relation_1.Relation {
+    /**
+     * The foreign key of the parent model
+     */
+    foreignKey;
+    /**
+     * The local key of the parent model
+     */
+    localKey;
+    /**
+     * Create a new has one relationship instance
+     */
+    constructor(query, parent, foreignKey, localKey) {
+        super(query, parent);
+        this.foreignKey = foreignKey;
+        this.localKey = localKey;
+    }
+    /**
+     * Set the base constraints on the relation query
+     */
+    addConstraints() {
+        if (Relation_1.Relation['constraints']) {
+            this.query.where(this.foreignKey, '=', this.getParentKey());
+        }
+    }
+    /**
+     * 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);
+    }
+    /**
+     * 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;
+        }
+        return this.query.first();
+    }
+    /**
+     * Get the key value of the parent's local key
+     */
+    getParentKey() {
+        return this.parent.getAttribute(this.localKey);
+    }
+    /**
+     * Get the foreign key for the relationship
+     */
+    getForeignKeyName() {
+        return this.foreignKey;
+    }
+    /**
+     * 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);
+        instance.setAttribute(this.foreignKey, this.getParentKey());
+        await instance.save();
+        return instance;
+    }
+    /**
+     * Create a new instance and set the foreign key
+     */
+    async save(model) {
+        model.setAttribute(this.foreignKey, this.getParentKey());
+        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.HasOne = HasOne;
+//# sourceMappingURL=HasOne.js.map

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

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

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

@@ -0,0 +1,114 @@
+/**
+ * Relation Base Class
+ *
+ * Base class for all relationship types
+ */
+import { Ensemble } from '../Ensemble';
+import { EnsembleBuilder } from '../EnsembleBuilder';
+export declare abstract class Relation<TRelated extends Ensemble, TParent extends Ensemble = Ensemble> {
+    /**
+     * The Ensemble query builder instance
+     */
+    protected query: EnsembleBuilder<TRelated>;
+    /**
+     * The parent Ensemble instance
+     */
+    protected parent: TParent;
+    /**
+     * The related Ensemble instance
+     */
+    protected related: TRelated;
+    /**
+     * Indicates if the relation is adding constraints
+     */
+    protected static constraints: boolean;
+    /**
+     * Create a new relation instance
+     */
+    constructor(query: EnsembleBuilder<TRelated>, parent: TParent);
+    /**
+     * Set the base constraints on the relation query
+     */
+    abstract addConstraints(): void;
+    /**
+     * Set the constraints for an eager load of the relation
+     */
+    abstract addEagerConstraints(models: TParent[]): void;
+    /**
+     * Initialize the relation on a set of models
+     */
+    abstract initRelation(models: TParent[], relation: string): TParent[];
+    /**
+     * Match the eagerly loaded results to their parents
+     */
+    abstract match(models: TParent[], results: EnsembleCollection<TRelated>, relation: string): TParent[];
+    /**
+     * Get the results of the relationship
+     */
+    abstract getResults(): Promise<TRelated | TRelated[] | null>;
+    /**
+     * Execute the query as a "select" statement
+     */
+    get(): Promise<TRelated[]>;
+    /**
+     * Get the relationship for eager loading
+     */
+    getEager(): Promise<TRelated[]>;
+    /**
+     * Touch all of the related models for the relationship
+     */
+    touch(): Promise<void>;
+    /**
+     * Run a raw update against the base query
+     */
+    rawUpdate(attributes?: Record<string, any>): Promise<number>;
+    /**
+     * Get all of the primary keys for an array of models
+     */
+    protected getKeys(models: TParent[], key?: string): any[];
+    /**
+     * Get the underlying query for the relation
+     */
+    getQuery(): EnsembleBuilder<TRelated>;
+    /**
+     * Get the base query builder driving the Ensemble builder
+     */
+    getBaseQuery(): EnsembleBuilder<TRelated>;
+    /**
+     * Get the parent model of the relation
+     */
+    getParent(): TParent;
+    /**
+     * Get the related model of the relation
+     */
+    getRelated(): TRelated;
+    /**
+     * Get the name of the "created at" column
+     */
+    createdAt(): string;
+    /**
+     * Get the name of the "updated at" column
+     */
+    updatedAt(): string;
+    /**
+     * Get the fully qualified related table name
+     */
+    protected getRelatedTable(): string;
+    /**
+     * Get the fully qualified parent key name
+     */
+    protected getQualifiedParentKeyName(): string;
+    /**
+     * Get the fully qualified foreign key name
+     */
+    protected getQualifiedForeignKeyName(foreignKey: string): string;
+    /**
+     * Handle dynamic method calls to the relationship
+     */
+    __call(method: string, parameters: any[]): any;
+}
+/**
+ * Import EnsembleCollection - imported at bottom to avoid circular dependency
+ */
+import { EnsembleCollection } from '../EnsembleCollection';
+//# sourceMappingURL=Relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Relation.d.ts","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Relations/Relation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,8BAAsB,QAAQ,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,SAAS,QAAQ,GAAG,QAAQ;IAC3F;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,WAAW,UAAQ;IAEpC;;OAEG;gBACS,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO;IAQ7D;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,IAAI;IAE/B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAErD;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAErE;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAErG;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACG,SAAS,CAAC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAItE;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE;IAOzD;;OAEG;IACH,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC;IAIrC;;OAEG;IACH,YAAY;IAIZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,UAAU,IAAI,QAAQ;IAItB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,MAAM;IAInC;;OAEG;IACH,SAAS,CAAC,yBAAyB,IAAI,MAAM;IAI7C;;OAEG;IACH,SAAS,CAAC,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhE;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG;CAS/C;AAED;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}