@orchestr-sh/orchestr 1.10.0 → 1.11.1

package/dist/Database/Ensemble/Relations/BelongsTo.d.mts

@@ -0,0 +1,96 @@
+import { EnsembleCollection } from "../EnsembleCollection.mjs";
+import { Relation } from "./Relation.mjs";
+import { EnsembleBuilder } from "../EnsembleBuilder.mjs";
+import { Ensemble } from "../Ensemble.mjs";
+
+//#region src/Database/Ensemble/Relations/BelongsTo.d.ts
+declare class BelongsTo<TRelated extends Ensemble, TParent extends Ensemble> extends Relation<TRelated, TParent> {
+  /**
+   * The foreign key of the parent model
+   */
+  protected foreignKey: string;
+  /**
+   * The associated key on the parent model
+   */
+  protected ownerKey: string;
+  /**
+   * The name of the relationship
+   */
+  protected relationName: string;
+  /**
+   * Create a new belongs to relationship instance
+   */
+  constructor(query: EnsembleBuilder<TRelated>, parent: TParent, foreignKey: string, ownerKey: string, relationName: 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;
+  /**
+   * Gather the keys from an array of related models
+   */
+  protected getEagerModelKeys(models: TParent[]): any[];
+  /**
+   * 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 owner key
+   */
+  protected buildDictionary(results: EnsembleCollection<TRelated>): Record<any, TRelated>;
+  /**
+   * Get the results of the relationship
+   */
+  getResults(): Promise<TRelated | null>;
+  /**
+   * Get the value of the model's foreign key
+   */
+  protected getForeignKeyValue(): any;
+  /**
+   * Get the foreign key for the relationship
+   */
+  getForeignKeyName(): string;
+  /**
+   * Get the owner key for the relationship
+   */
+  getOwnerKeyName(): string;
+  /**
+   * Get the name of the relationship
+   */
+  getRelationName(): string;
+  /**
+   * Associate the model instance to the given parent
+   */
+  associate(model: TRelated | null): TParent;
+  /**
+   * Dissociate previously associated model from the given parent
+   */
+  dissociate(): TParent;
+  /**
+   * Execute the query as a "select" statement
+   * Override base to return single model instead of array
+   */
+  get(): Promise<TRelated | null>;
+  /**
+   * Update the parent model on the relationship
+   */
+  update(attributes: Record<string, any>): Promise<number>;
+  /**
+   * Get the default foreign key name for the relationship
+   */
+  protected getDefaultForeignKeyName(): string;
+  /**
+   * Convert a string to snake case
+   */
+  protected snake(value: string): string;
+}
+//#endregion
+export { BelongsTo };
+//# sourceMappingURL=BelongsTo.d.mts.map

package/dist/Database/Ensemble/Relations/BelongsTo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BelongsTo.d.mts","names":[],"sources":["../../../../src/Database/Ensemble/Relations/BelongsTo.ts"],"mappings":";;;;;;cAWa,SAAA,kBAA2B,QAAA,kBAA0B,QAAA,UAAkB,QAAA,CAAS,QAAA,EAAU,OAAA;EAArC;;;EAAA,UAItD,UAAA;EAgBD;;;EAAA,UAXC,QAAA;EAkEW;;;EAAA,UA7DX,YAAA;EAwEwB;;;cAlEhC,KAAA,EAAO,eAAA,CAAgB,QAAA,GACvB,MAAA,EAAQ,OAAA,EACR,UAAA,UACA,QAAA,UACA,YAAA;EA+E4E;;;EAnE9E,cAAA,CAAA;EA8HiB;;;EAhHjB,mBAAA,CAAoB,MAAA,EAAQ,OAAA;EA6If;;;EAAA,UArIH,iBAAA,CAAkB,MAAA,EAAQ,OAAA;EA1DsD;;;EA2E1F,YAAA,CAAa,MAAA,EAAQ,OAAA,IAAW,QAAA,WAAmB,OAAA;EA3EH;;;EAsFhD,KAAA,CAAM,MAAA,EAAQ,OAAA,IAAW,OAAA,EAAS,kBAAA,CAAmB,QAAA,GAAW,QAAA,WAAmB,OAAA;EAtFkB;;;EAAA,UAuG3F,eAAA,CAAgB,OAAA,EAAS,kBAAA,CAAmB,QAAA,IAAY,MAAA,MAAY,QAAA;;;;EAiBxE,UAAA,CAAA,GAAc,OAAA,CAAQ,QAAA;EAnGlB;;;EAAA,UAiHA,kBAAA,CAAA;EA9GR;;;EAqHF,iBAAA,CAAA;EA3FoB;;;EAkGpB,eAAA,CAAA;EAzEA;;;EAgFA,eAAA,CAAA;EAhFmD;;;EAuFnD,SAAA,CAAU,KAAA,EAAO,QAAA,UAAkB,OAAA;EA5ED;;;EA6FlC,UAAA,CAAA,GAAc,OAAA;EA7FqE;;;;EAyG7E,GAAA,CAAA,GAAO,OAAA,CAAQ,QAAA;EAxF6C;;;EA+F5D,MAAA,CAAO,UAAA,EAAY,MAAA,gBAAsB,OAAA;EA9EnB;;;EAAA,UAqFlB,wBAAA,CAAA;EAlDV;;;EAAA,UAyDU,KAAA,CAAM,KAAA;AAAA"}

package/dist/Database/Ensemble/Relations/BelongsTo.mjs

@@ -0,0 +1,2 @@
+import{Relation as e,init_Relation as t}from"./Relation.mjs";t();var n=class extends e{foreignKey;ownerKey;relationName;constructor(e,t,n,r,i){super(e,t),this.foreignKey=n,this.ownerKey=r,this.relationName=i,this.initializeRelation()}addConstraints(){if(e.constraints){let e=this.getForeignKeyValue();e!=null&&this.query.where(this.ownerKey,`=`,e)}}addEagerConstraints(e){let t=this.getEagerModelKeys(e);this.query.whereIn(this.ownerKey,t)}getEagerModelKeys(e){let t=[];for(let n of e){let e=n.getAttribute(this.foreignKey);e!=null&&t.push(e)}return[...new Set(t)]}initRelation(e,t){for(let n of e)n.setRelation(t,null);return e}match(e,t,n){let r=this.buildDictionary(t);for(let t of e){let e=t.getAttribute(this.foreignKey);e!=null&&r[e]&&t.setRelation(n,r[e])}return e}buildDictionary(e){let t={};for(let n of e){let e=n.getAttribute(this.ownerKey);e!=null&&(t[e]=n)}return t}async getResults(){return this.getForeignKeyValue()?(this.ensureConstraints(),this.query.first()):null}getForeignKeyValue(){return this.parent.getAttribute(this.foreignKey)}getForeignKeyName(){return this.foreignKey}getOwnerKeyName(){return this.ownerKey}getRelationName(){return this.relationName}associate(e){let t=e?e.getAttribute(this.ownerKey):null;return this.parent.setAttribute(this.foreignKey,t),e?this.parent.setRelation(this.relationName,e):this.parent.unsetRelation(this.relationName),this.parent}dissociate(){return this.parent.setAttribute(this.foreignKey,null),this.parent.setRelation(this.relationName,null),this.parent}async get(){return this.getResults()}async update(e){return this.query.update(e)}getDefaultForeignKeyName(){return this.snake(this.relationName)+`_`+this.related.getKeyName()}snake(e){return e.replace(/([A-Z])/g,`_$1`).toLowerCase().replace(/^_/,``)}};export{n as BelongsTo};
+//# sourceMappingURL=BelongsTo.mjs.map

package/dist/Database/Ensemble/Relations/BelongsTo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BelongsTo.mjs","names":[],"sources":["../../../../src/Database/Ensemble/Relations/BelongsTo.ts"],"sourcesContent":["/**\n * BelongsTo Relationship\n *\n * Represents an inverse one-to-one or many relationship\n */\n\nimport { Ensemble } from '@/Database/Ensemble/Ensemble';\nimport { EnsembleBuilder } from '@/Database/Ensemble/EnsembleBuilder';\nimport { EnsembleCollection } from '@/Database/Ensemble/EnsembleCollection';\nimport { Relation } from './Relation';\n\nexport class BelongsTo<TRelated extends Ensemble, TParent extends Ensemble> extends Relation<TRelated, TParent> {\n  /**\n   * The foreign key of the parent model\n   */\n  protected foreignKey: string;\n\n  /**\n   * The associated key on the parent model\n   */\n  protected ownerKey: string;\n\n  /**\n   * The name of the relationship\n   */\n  protected relationName: string;\n\n  /**\n   * Create a new belongs to relationship instance\n   */\n  constructor(\n    query: EnsembleBuilder<TRelated>,\n    parent: TParent,\n    foreignKey: string,\n    ownerKey: string,\n    relationName: string\n  ) {\n    super(query, parent);\n    this.foreignKey = foreignKey;\n    this.ownerKey = ownerKey;\n    this.relationName = relationName;\n    this.initializeRelation();\n  }\n\n  /**\n   * Set the base constraints on the relation query\n   */\n  addConstraints(): void {\n    if (Relation['constraints']) {\n      const foreignKeyValue = this.getForeignKeyValue();\n\n      // Only add constraint if foreign key value exists\n      if (foreignKeyValue !== null && foreignKeyValue !== undefined) {\n        this.query.where(this.ownerKey, '=', foreignKeyValue);\n      }\n    }\n  }\n\n  /**\n   * Set the constraints for an eager load of the relation\n   */\n  addEagerConstraints(models: TParent[]): void {\n    const keys = this.getEagerModelKeys(models);\n    this.query.whereIn(this.ownerKey, keys);\n  }\n\n  /**\n   * Gather the keys from an array of related models\n   */\n  protected getEagerModelKeys(models: TParent[]): any[] {\n    const keys: any[] = [];\n\n    for (const model of models) {\n      const value = model.getAttribute(this.foreignKey);\n\n      if (value !== null && value !== undefined) {\n        keys.push(value);\n      }\n    }\n\n    return [...new Set(keys)];\n  }\n\n  /**\n   * Initialize the relation on a set of models\n   */\n  initRelation(models: TParent[], relation: string): TParent[] {\n    for (const model of models) {\n      model.setRelation(relation, null);\n    }\n\n    return models;\n  }\n\n  /**\n   * Match the eagerly loaded results to their parents\n   */\n  match(models: TParent[], results: EnsembleCollection<TRelated>, relation: string): TParent[] {\n    const dictionary = this.buildDictionary(results);\n\n    for (const model of models) {\n      const key = model.getAttribute(this.foreignKey);\n\n      if (key !== null && key !== undefined && dictionary[key]) {\n        model.setRelation(relation, dictionary[key]);\n      }\n    }\n\n    return models;\n  }\n\n  /**\n   * Build model dictionary keyed by the relation's owner key\n   */\n  protected buildDictionary(results: EnsembleCollection<TRelated>): Record<any, TRelated> {\n    const dictionary: Record<any, TRelated> = {};\n\n    for (const result of results) {\n      const key = result.getAttribute(this.ownerKey);\n\n      if (key !== null && key !== undefined) {\n        dictionary[key] = result;\n      }\n    }\n\n    return dictionary;\n  }\n\n  /**\n   * Get the results of the relationship\n   */\n  async getResults(): Promise<TRelated | null> {\n    const foreignKeyValue = this.getForeignKeyValue();\n\n    if (!foreignKeyValue) {\n      return null;\n    }\n\n    this.ensureConstraints();\n    return this.query.first();\n  }\n\n  /**\n   * Get the value of the model's foreign key\n   */\n  protected getForeignKeyValue(): any {\n    return this.parent.getAttribute(this.foreignKey);\n  }\n\n  /**\n   * Get the foreign key for the relationship\n   */\n  getForeignKeyName(): string {\n    return this.foreignKey;\n  }\n\n  /**\n   * Get the owner key for the relationship\n   */\n  getOwnerKeyName(): string {\n    return this.ownerKey;\n  }\n\n  /**\n   * Get the name of the relationship\n   */\n  getRelationName(): string {\n    return this.relationName;\n  }\n\n  /**\n   * Associate the model instance to the given parent\n   */\n  associate(model: TRelated | null): TParent {\n    const ownerKey = model ? model.getAttribute(this.ownerKey) : null;\n\n    this.parent.setAttribute(this.foreignKey, ownerKey);\n\n    if (model) {\n      this.parent.setRelation(this.relationName, model);\n    } else {\n      this.parent.unsetRelation(this.relationName);\n    }\n\n    return this.parent;\n  }\n\n  /**\n   * Dissociate previously associated model from the given parent\n   */\n  dissociate(): TParent {\n    this.parent.setAttribute(this.foreignKey, null);\n    this.parent.setRelation(this.relationName, null);\n\n    return this.parent;\n  }\n\n  /**\n   * Execute the query as a \"select\" statement\n   * Override base to return single model instead of array\n   */\n  // @ts-expect-error - BelongsTo returns single model, not array\n  async get(): Promise<TRelated | null> {\n    return this.getResults();\n  }\n\n  /**\n   * Update the parent model on the relationship\n   */\n  async update(attributes: Record<string, any>): Promise<number> {\n    return this.query.update(attributes);\n  }\n\n  /**\n   * Get the default foreign key name for the relationship\n   */\n  protected getDefaultForeignKeyName(): string {\n    return this.snake(this.relationName) + '_' + this.related.getKeyName();\n  }\n\n  /**\n   * Convert a string to snake case\n   */\n  protected snake(value: string): string {\n    return value\n      .replace(/([A-Z])/g, '_$1')\n      .toLowerCase()\n      .replace(/^_/, '');\n  }\n}\n"],"mappings":"gEASsC,CAEtC,IAAa,EAAb,cAAoF,CAA4B,CAI9G,WAKA,SAKA,aAKA,YACE,EACA,EACA,EACA,EACA,EACA,CACA,MAAM,EAAO,EAAO,CACpB,KAAK,WAAa,EAClB,KAAK,SAAW,EAChB,KAAK,aAAe,EACpB,KAAK,oBAAoB,CAM3B,gBAAuB,CACrB,GAAI,EAAS,YAAgB,CAC3B,IAAM,EAAkB,KAAK,oBAAoB,CAG7C,GAAoB,MACtB,KAAK,MAAM,MAAM,KAAK,SAAU,IAAK,EAAgB,EAQ3D,oBAAoB,EAAyB,CAC3C,IAAM,EAAO,KAAK,kBAAkB,EAAO,CAC3C,KAAK,MAAM,QAAQ,KAAK,SAAU,EAAK,CAMzC,kBAA4B,EAA0B,CACpD,IAAM,EAAc,EAAE,CAEtB,IAAK,IAAM,KAAS,EAAQ,CAC1B,IAAM,EAAQ,EAAM,aAAa,KAAK,WAAW,CAE7C,GAAU,MACZ,EAAK,KAAK,EAAM,CAIpB,MAAO,CAAC,GAAG,IAAI,IAAI,EAAK,CAAC,CAM3B,aAAa,EAAmB,EAA6B,CAC3D,IAAK,IAAM,KAAS,EAClB,EAAM,YAAY,EAAU,KAAK,CAGnC,OAAO,EAMT,MAAM,EAAmB,EAAuC,EAA6B,CAC3F,IAAM,EAAa,KAAK,gBAAgB,EAAQ,CAEhD,IAAK,IAAM,KAAS,EAAQ,CAC1B,IAAM,EAAM,EAAM,aAAa,KAAK,WAAW,CAE3C,GAAQ,MAA6B,EAAW,IAClD,EAAM,YAAY,EAAU,EAAW,GAAK,CAIhD,OAAO,EAMT,gBAA0B,EAA8D,CACtF,IAAM,EAAoC,EAAE,CAE5C,IAAK,IAAM,KAAU,EAAS,CAC5B,IAAM,EAAM,EAAO,aAAa,KAAK,SAAS,CAE1C,GAAQ,OACV,EAAW,GAAO,GAItB,OAAO,EAMT,MAAM,YAAuC,CAQ3C,OAPwB,KAAK,oBAAoB,EAMjD,KAAK,mBAAmB,CACjB,KAAK,MAAM,OAAO,EAJhB,KAUX,oBAAoC,CAClC,OAAO,KAAK,OAAO,aAAa,KAAK,WAAW,CAMlD,mBAA4B,CAC1B,OAAO,KAAK,WAMd,iBAA0B,CACxB,OAAO,KAAK,SAMd,iBAA0B,CACxB,OAAO,KAAK,aAMd,UAAU,EAAiC,CACzC,IAAM,EAAW,EAAQ,EAAM,aAAa,KAAK,SAAS,CAAG,KAU7D,OARA,KAAK,OAAO,aAAa,KAAK,WAAY,EAAS,CAE/C,EACF,KAAK,OAAO,YAAY,KAAK,aAAc,EAAM,CAEjD,KAAK,OAAO,cAAc,KAAK,aAAa,CAGvC,KAAK,OAMd,YAAsB,CAIpB,OAHA,KAAK,OAAO,aAAa,KAAK,WAAY,KAAK,CAC/C,KAAK,OAAO,YAAY,KAAK,aAAc,KAAK,CAEzC,KAAK,OAQd,MAAM,KAAgC,CACpC,OAAO,KAAK,YAAY,CAM1B,MAAM,OAAO,EAAkD,CAC7D,OAAO,KAAK,MAAM,OAAO,EAAW,CAMtC,0BAA6C,CAC3C,OAAO,KAAK,MAAM,KAAK,aAAa,CAAG,IAAM,KAAK,QAAQ,YAAY,CAMxE,MAAgB,EAAuB,CACrC,OAAO,EACJ,QAAQ,WAAY,MAAM,CAC1B,aAAa,CACb,QAAQ,KAAM,GAAG"}

package/dist/Database/Ensemble/Relations/BelongsToMany.cjs

@@ -0,0 +1 @@
+const e=require(`../../../_virtual/_rolldown/runtime.cjs`),t=require(`./Relation.cjs`),n=require(`../EnsembleCollection.cjs`);var r,i=e.__esmMin((()=>{n.init_EnsembleCollection(),t.init_Relation(),r=class extends t.Relation{table;foreignPivotKey;relatedPivotKey;parentKey;relatedKey;relationName;pivotColumns=[];pivotWheres=[];pivotValues=[];usingTimestamps=!1;using;pivotCreatedAt;pivotUpdatedAt;accessor=`pivot`;constructor(e,t,n,r,i,a,o,s){super(e,t),this.table=n,this.foreignPivotKey=r,this.relatedPivotKey=i,this.parentKey=a,this.relatedKey=o,this.relationName=s||``,this.initializeRelation()}addConstraints(){this.performJoin(),t.Relation.constraints&&this.addWhereConstraints()}performJoin(e){e||=this.query,e.join(this.table,`${this.getQualifiedRelatedKeyName()}`,`=`,`${this.getQualifiedRelatedPivotKeyName()}`)}addWhereConstraints(){let e=this.parent.getAttribute(this.parentKey);e!=null&&this.query.where(this.getQualifiedForeignPivotKeyName(),`=`,e)}addEagerConstraints(e){let t=this.getKeys(e,this.parentKey);this.query.whereIn(this.getQualifiedForeignPivotKeyName(),t)}initRelation(e,t){for(let r of e)r.setRelation(t,new n.EnsembleCollection);return e}match(e,t,r){let i=this.buildDictionary(t);for(let t of e){let e=t.getAttribute(this.parentKey);e!=null&&i[e]&&t.setRelation(r,new n.EnsembleCollection(i[e]))}return e}buildDictionary(e){let t={};for(let n of e){let e=this.migratePivotAttributes(n)[this.foreignPivotKey];e!=null&&(t[e]||(t[e]=[]),t[e].push(n))}return t}async getResults(){return this.parent.getAttribute(this.parentKey)?this.get():[]}async get(){this.ensureConstraints();let e=await this.query.addSelect(...this.shouldSelect()).get();return this.hydratePivotRelation(e),e}shouldSelect(e=[`*`]){return e.length===1&&e[0]===`*`&&(e=[`${this.related.getTable()}.*`]),[...e,...this.aliasedPivotColumns()]}aliasedPivotColumns(){return[...[this.foreignPivotKey,this.relatedPivotKey],...this.pivotColumns].map(e=>`${this.table}.${e} as pivot_${e}`)}hydratePivotRelation(e){for(let t of e){let e=this.migratePivotAttributes(t);t.setRelation(this.accessor,e)}}migratePivotAttributes(e){let t={},n=e.attributes||{};for(let[r,i]of Object.entries(n))if(r.startsWith(`pivot_`)){let n=r.substring(6);t[n]=i,delete e.attributes[r]}return t}getQualifiedForeignPivotKeyName(){return`${this.table}.${this.foreignPivotKey}`}getQualifiedRelatedPivotKeyName(){return`${this.table}.${this.relatedPivotKey}`}getQualifiedParentKeyName(){return`${this.parent.getTable()}.${this.parentKey}`}getQualifiedRelatedKeyName(){return`${this.related.getTable()}.${this.relatedKey}`}withPivot(...e){return this.pivotColumns=[...this.pivotColumns,...e],this}withTimestamps(e,t){return this.usingTimestamps=!0,this.pivotCreatedAt=e||`created_at`,this.pivotUpdatedAt=t||`updated_at`,this.withPivot(this.pivotCreatedAt,this.pivotUpdatedAt)}wherePivot(e,t,n){return arguments.length===2&&(n=t,t=`=`),this.pivotWheres.push({column:`${this.table}.${e}`,operator:t,value:n,boolean:`and`}),this.query.where(`${this.table}.${e}`,t,n)}wherePivotIn(e,t){return this.query.whereIn(`${this.table}.${e}`,t)}wherePivotNotIn(e,t){return this.query.whereNotIn(`${this.table}.${e}`,t)}wherePivotNull(e){return this.query.whereNull(`${this.table}.${e}`)}wherePivotNotNull(e){return this.query.whereNotNull(`${this.table}.${e}`)}orWherePivot(e,t,n){return arguments.length===2&&(n=t,t=`=`),this.query.orWhere(`${this.table}.${e}`,t,n)}async attach(e,t={}){let n=this.formatAttachRecords(this.parseIds(e),t);n.length!==0&&await this.parent.getConnection().table(this.table).insert(n)}async detach(e){let t=this.parent.getConnection().table(this.table).where(this.foreignPivotKey,`=`,this.parent.getAttribute(this.parentKey));if(e!==void 0){let n=this.parseIds(e);t=t.whereIn(this.relatedPivotKey,n)}return await t.delete()}async sync(e){let t={attached:[],detached:[],updated:[]},n=await this.getCurrentlyAttachedPivots(),r=this.formatRecordsList(this.parseIds(e)),i=n.filter(e=>!r.some(t=>t.id===e));return i.length>0&&(await this.detach(i),t.detached=i),t.attached=await this.attachNew(r,n),t.updated=await this.updateExisting(r,n),t}async syncWithoutDetaching(e){let t={attached:[],updated:[]},n=await this.getCurrentlyAttachedPivots(),r=this.formatRecordsList(this.parseIds(e));return t.attached=await this.attachNew(r,n),t.updated=await this.updateExisting(r,n),t}async toggle(e){let t={attached:[],detached:[]},n=this.parseIds(e),r=await this.getCurrentlyAttachedPivots(),i=n.filter(e=>r.includes(e)),a=n.filter(e=>!r.includes(e));return i.length>0&&(await this.detach(i),t.detached=i),a.length>0&&(await this.attach(a),t.attached=a),t}async updateExistingPivot(e,t){return this.usingTimestamps&&this.pivotUpdatedAt&&(t[this.pivotUpdatedAt]=new Date),await this.parent.getConnection().table(this.table).where(this.foreignPivotKey,`=`,this.parent.getAttribute(this.parentKey)).where(this.relatedPivotKey,`=`,e).update(t)}async getCurrentlyAttachedPivots(){return await this.parent.getConnection().table(this.table).where(this.foreignPivotKey,`=`,this.parent.getAttribute(this.parentKey)).pluck(this.relatedPivotKey)}async attachNew(e,t){let n=e.filter(e=>!t.includes(e.id));return n.length===0?[]:(await this.attach(n.map(e=>e.id),n[0]?.attributes||{}),n.map(e=>e.id))}async updateExisting(e,t){let n=[];for(let r of e)t.includes(r.id)&&Object.keys(r.attributes).length>0&&(await this.updateExistingPivot(r.id,r.attributes),n.push(r.id));return n}formatAttachRecords(e,t){let n=[],r=this.usingTimestamps;for(let i of e){let e={[this.foreignPivotKey]:this.parent.getAttribute(this.parentKey),[this.relatedPivotKey]:i,...t};if(r){let t=new Date;this.pivotCreatedAt&&(e[this.pivotCreatedAt]=t),this.pivotUpdatedAt&&(e[this.pivotUpdatedAt]=t)}n.push(e)}return n}formatRecordsList(e){return e.map(e=>{if(typeof e==`object`&&!Array.isArray(e)){let{id:t,...n}=e;return{id:t,attributes:n}}return{id:e,attributes:{}}})}parseIds(e){return e instanceof n.EnsembleCollection?e.modelKeys():Array.isArray(e)?e:typeof e==`object`&&e?Object.keys(e).map(t=>({id:isNaN(Number(t))?t:Number(t),...e[t]})):[e]}getPivotAccessor(){return this.accessor}as(e){return this.accessor=e,this}getTable(){return this.table}getForeignPivotKeyName(){return this.foreignPivotKey}getRelatedPivotKeyName(){return this.relatedPivotKey}getParentKeyName(){return this.parentKey}getRelatedKeyName(){return this.relatedKey}getRelationName(){return this.relationName}}}));i(),exports.BelongsToMany=r,Object.defineProperty(exports,`init_BelongsToMany`,{enumerable:!0,get:function(){return i}});

package/dist/Database/Ensemble/Relations/BelongsToMany.d.cts

@@ -0,0 +1,275 @@
+import { EnsembleCollection } from "../EnsembleCollection.cjs";
+import { Relation } from "./Relation.cjs";
+import { EnsembleBuilder } from "../EnsembleBuilder.cjs";
+import { Ensemble } from "../Ensemble.cjs";
+
+//#region src/Database/Ensemble/Relations/BelongsToMany.d.ts
+declare class BelongsToMany<TRelated extends Ensemble, TParent extends Ensemble> extends Relation<TRelated, TParent> {
+  /**
+   * The intermediate table for the relation
+   */
+  protected table: string;
+  /**
+   * The foreign key of the parent model
+   */
+  protected foreignPivotKey: string;
+  /**
+   * The associated key of the relation
+   */
+  protected relatedPivotKey: string;
+  /**
+   * The parent key of the relationship
+   */
+  protected parentKey: string;
+  /**
+   * The related key of the relationship
+   */
+  protected relatedKey: string;
+  /**
+   * The name of the relationship
+   */
+  protected relationName: string;
+  /**
+   * The pivot table columns to retrieve
+   */
+  protected pivotColumns: string[];
+  /**
+   * Any pivot table restrictions
+   */
+  protected pivotWheres: Array<{
+    column: string;
+    operator?: string;
+    value?: any;
+    boolean: string;
+  }>;
+  /**
+   * The pivot table values to attach
+   */
+  protected pivotValues: Record<string, any>[];
+  /**
+   * Whether we are using timestamps on the pivot table
+   */
+  protected usingTimestamps: boolean;
+  /**
+   * The custom pivot table model
+   */
+  protected using?: any;
+  /**
+   * The name of the "created at" column
+   */
+  protected pivotCreatedAt?: string;
+  /**
+   * The name of the "updated at" column
+   */
+  protected pivotUpdatedAt?: string;
+  /**
+   * The name of the accessor to use for the pivot relationship
+   */
+  protected accessor: string;
+  /**
+   * Create a new belongs to many relationship instance
+   */
+  constructor(query: EnsembleBuilder<TRelated>, parent: TParent, table: string, foreignPivotKey: string, relatedPivotKey: string, parentKey: string, relatedKey: string, relationName?: string);
+  /**
+   * Set the base constraints on the relation query
+   */
+  addConstraints(): void;
+  /**
+   * Set the join clause for the relation query
+   */
+  protected performJoin(query?: EnsembleBuilder<TRelated>): void;
+  /**
+   * Set the where clause for the relation query
+   */
+  protected addWhereConstraints(): 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[]>;
+  /**
+   * Execute the query and get the models
+   */
+  get(): Promise<TRelated[]>;
+  /**
+   * Get the select columns for the relation query
+   */
+  protected shouldSelect(columns?: string[]): string[];
+  /**
+   * Get the pivot columns for the relation
+   */
+  protected aliasedPivotColumns(): string[];
+  /**
+   * Hydrate the pivot relationship on the models
+   */
+  protected hydratePivotRelation(models: TRelated[]): void;
+  /**
+   * Migrate the pivot attributes from the model to a pivot model
+   */
+  protected migratePivotAttributes(model: TRelated): Record<string, any>;
+  /**
+   * Get the fully qualified foreign key for the relation
+   */
+  protected getQualifiedForeignPivotKeyName(): string;
+  /**
+   * Get the fully qualified "related key" for the relation
+   */
+  protected getQualifiedRelatedPivotKeyName(): string;
+  /**
+   * Get the fully qualified parent key name
+   */
+  protected getQualifiedParentKeyName(): string;
+  /**
+   * Get the fully qualified related key name
+   */
+  protected getQualifiedRelatedKeyName(): string;
+  /**
+   * Specify the pivot table columns to retrieve
+   */
+  withPivot(...columns: string[]): this;
+  /**
+   * Indicate that the pivot table has timestamps
+   */
+  withTimestamps(createdAt?: string, updatedAt?: string): this;
+  /**
+   * Set a where clause for the pivot table
+   */
+  wherePivot(column: string, operator?: any, value?: any): this;
+  /**
+   * Set a "where in" clause for the pivot table
+   */
+  wherePivotIn(column: string, values: any[]): this;
+  /**
+   * Set a "where not in" clause for the pivot table
+   */
+  wherePivotNotIn(column: string, values: any[]): this;
+  /**
+   * Set a "where null" clause for the pivot table
+   */
+  wherePivotNull(column: string): this;
+  /**
+   * Set a "where not null" clause for the pivot table
+   */
+  wherePivotNotNull(column: string): this;
+  /**
+   * Set an "or where" clause for the pivot table
+   */
+  orWherePivot(column: string, operator?: any, value?: any): this;
+  /**
+   * Attach models to the parent
+   */
+  attach(ids: any | any[], attributes?: Record<string, any>): Promise<void>;
+  /**
+   * Detach models from the parent
+   */
+  detach(ids?: any | any[]): Promise<number>;
+  /**
+   * Sync the intermediate tables with a list of IDs
+   */
+  sync(ids: any | any[] | Record<number | string, Record<string, any>>): Promise<{
+    attached: any[];
+    detached: any[];
+    updated: any[];
+  }>;
+  /**
+   * Sync without detaching
+   */
+  syncWithoutDetaching(ids: any | any[] | Record<number | string, Record<string, any>>): Promise<{
+    attached: any[];
+    updated: any[];
+  }>;
+  /**
+   * Toggle models from the parent
+   */
+  toggle(ids: any | any[]): Promise<{
+    attached: any[];
+    detached: any[];
+  }>;
+  /**
+   * Update an existing pivot record on the table
+   */
+  updateExistingPivot(id: any, attributes: Record<string, any>): Promise<number>;
+  /**
+   * Get the currently attached pivot IDs
+   */
+  protected getCurrentlyAttachedPivots(): Promise<any[]>;
+  /**
+   * Attach new records
+   */
+  protected attachNew(records: Array<{
+    id: any;
+    attributes: Record<string, any>;
+  }>, current: any[]): Promise<any[]>;
+  /**
+   * Update existing records
+   */
+  protected updateExisting(records: Array<{
+    id: any;
+    attributes: Record<string, any>;
+  }>, current: any[]): Promise<any[]>;
+  /**
+   * Format the records for attaching
+   */
+  protected formatAttachRecords(ids: any[], attributes: Record<string, any>): Record<string, any>[];
+  /**
+   * Format the sync records
+   */
+  protected formatRecordsList(ids: any[]): Array<{
+    id: any;
+    attributes: Record<string, any>;
+  }>;
+  /**
+   * Parse the IDs from the given value
+   */
+  protected parseIds(value: any): any[];
+  /**
+   * Get the name of the pivot accessor
+   */
+  getPivotAccessor(): string;
+  /**
+   * Set the name of the pivot accessor
+   */
+  as(accessor: string): this;
+  /**
+   * Get the pivot table name
+   */
+  getTable(): string;
+  /**
+   * Get the foreign pivot key name
+   */
+  getForeignPivotKeyName(): string;
+  /**
+   * Get the related pivot key name
+   */
+  getRelatedPivotKeyName(): string;
+  /**
+   * Get the parent key name
+   */
+  getParentKeyName(): string;
+  /**
+   * Get the related key name
+   */
+  getRelatedKeyName(): string;
+  /**
+   * Get the relationship name
+   */
+  getRelationName(): string;
+}
+//#endregion
+export { BelongsToMany };
+//# sourceMappingURL=BelongsToMany.d.cts.map

package/dist/Database/Ensemble/Relations/BelongsToMany.d.cts.map

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