@orchestr-sh/orchestr 1.10.0 → 1.11.0

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

@@ -0,0 +1,329 @@
+import { Connection } from "../Connection.mjs";
+import { DatabaseManager } from "../DatabaseManager.mjs";
+import { EnsembleBuilder } from "./EnsembleBuilder.mjs";
+import { HasRelationshipsMixin } from "./Concerns/HasRelationships.mjs";
+
+//#region src/Database/Ensemble/Ensemble.d.ts
+declare abstract class Ensemble extends HasRelationshipsMixin {
+  /**
+   * The connection resolver instance
+   */
+  protected static connectionResolver: DatabaseManager;
+  /**
+   * The table associated with the model
+   */
+  protected table?: string;
+  /**
+   * The primary key for the model
+   */
+  protected primaryKey: string;
+  /**
+   * Indicates if the IDs are auto-incrementing
+   */
+  protected incrementing: boolean;
+  /**
+   * The data type of the primary key
+   */
+  protected keyType: string;
+  /**
+   * The attributes that are mass assignable (instance property).
+   *
+   * Subclasses may also declare `static fillable: string[]` instead.
+   * Static properties are resolved at construction time so they are safe
+   * to use even when a subclass constructor has not yet run its own field
+   * initialisers.
+   */
+  protected fillable: string[];
+  /**
+   * The attributes that aren't mass assignable (instance property).
+   *
+   * Subclasses may also declare `static guarded: string[]` instead of
+   * (or in addition to) the instance property.
+   */
+  protected guarded: string[];
+  /**
+   * Static fillable list.  Subclasses that declare `static fillable` here
+   * will have those attributes made mass-assignable without needing a
+   * constructor override.
+   */
+  static fillable?: string[];
+  /**
+   * Static guarded list.  Subclasses that declare `static guarded` here
+   * will have those attributes protected from mass assignment without
+   * needing a constructor override.
+   */
+  static guarded?: string[];
+  /**
+   * The attributes that should be hidden for serialization
+   */
+  protected hidden: string[];
+  /**
+   * The attributes that should be visible for serialization
+   */
+  protected visible: string[];
+  /**
+   * The accessors to append to the model's array form
+   */
+  protected appends: string[];
+  /**
+   * The attributes that should be cast
+   */
+  protected casts: Record<string, string>;
+  /**
+   * Indicates if the model should be timestamped
+   */
+  protected timestamps: boolean;
+  /**
+   * The name of the "created at" column
+   */
+  protected static CREATED_AT: string;
+  /**
+   * The name of the "updated at" column
+   */
+  protected static UPDATED_AT: string;
+  /**
+   * The name of the "deleted at" column (for soft deletes)
+   */
+  protected static DELETED_AT: string;
+  /**
+   * The model's attributes
+   */
+  protected attributes: Record<string, any>;
+  /**
+   * The model's original attributes
+   */
+  protected original: Record<string, any>;
+  /**
+   * Indicates if the model exists in the database
+   */
+  exists: boolean;
+  /**
+   * Indicates if the model was inserted during this request
+   */
+  wasRecentlyCreated: boolean;
+  /**
+   * The connection name for the model
+   */
+  protected connection?: string;
+  /**
+   * Enable dynamic relationship access (user.posts instead of user.posts().get())
+   * Set to true to enable PHP-like __get behavior for relationships
+   */
+  protected dynamicRelations: boolean;
+  /**
+   * Create a new Eloquent model instance
+   */
+  constructor(attributes?: Record<string, any>, fromDatabase?: boolean);
+  /**
+   * Fill the model with an array of attributes
+   */
+  fill(attributes: Record<string, any>): this;
+  /**
+   * Set a given attribute on the model
+   */
+  setAttribute(key: string, value: any): this;
+  /**
+   * Set the array of model attributes (bypasses fillable/guarded)
+   * Used when hydrating from database
+   */
+  setRawAttributes(attributes: Record<string, any>): this;
+  /**
+   * Get an attribute from the model
+   */
+  getAttribute(key: string): any;
+  /**
+   * Determine if the given attribute may be mass assigned.
+   *
+   * Resolution order for `fillable` and `guarded`:
+   *   1. Static property on the concrete class (e.g. `static fillable = [...]`)
+   *      – safe because static properties exist before any constructor runs.
+   *   2. Instance property (`this.fillable` / `this.guarded`) – populated either
+   *      by Ensemble's own field initialiser or by a subclass constructor
+   *      workaround that calls `this.fill()` a second time after `super()`.
+   *
+   * If the concrete class defines `static fillable`, it takes full precedence
+   * over the instance property (matching Laravel's behaviour where a non-empty
+   * fillable list is the authoritative allow-list).
+   */
+  protected isFillable(key: string): boolean;
+  /**
+   * Determine if a get mutator exists for an attribute
+   */
+  protected hasGetMutator(key: string): boolean;
+  /**
+   * Determine if a set mutator exists for an attribute
+   */
+  protected hasSetMutator(key: string): boolean;
+  /**
+   * Determine if a cast is defined for an attribute
+   */
+  protected hasCast(key: string): boolean;
+  /**
+   * Cast an attribute to a native PHP type
+   */
+  protected castAttribute(key: string, value: any): any;
+  /**
+   * Convert the model to a plain object
+   */
+  toObject(): Record<string, any>;
+  /**
+   * Convert the model to JSON
+   */
+  toJSON(): Record<string, any>;
+  /**
+   * Determine if an attribute is visible
+   */
+  protected isVisible(key: string): boolean;
+  /**
+   * Get the table associated with the model
+   */
+  getTable(): string;
+  /**
+   * Get the primary key for the model
+   */
+  getKeyName(): string;
+  /**
+   * Get the value of the model's primary key
+   */
+  getKey(): any;
+  /**
+   * Set the connection resolver instance
+   */
+  static setConnectionResolver(resolver: DatabaseManager): void;
+  /**
+   * Get the database connection for the model
+   */
+  getConnection(): Connection;
+  /**
+   * Begin querying the model
+   */
+  static query<T extends Ensemble>(this: {
+    new (): T;
+  }): EnsembleBuilder<T>;
+  /**
+   * Get all of the models from the database
+   */
+  static all<T extends Ensemble>(this: {
+    new (): T;
+  }, columns?: string[]): Promise<T[]>;
+  /**
+   * Find a model by its primary key
+   */
+  static find<T extends Ensemble>(this: {
+    new (): T;
+  }, id: any, columns?: string[]): Promise<T | null>;
+  /**
+   * Find a model by its primary key or throw an exception
+   */
+  static findOrFail<T extends Ensemble>(this: {
+    new (): T;
+  }, id: any, columns?: string[]): Promise<T>;
+  /**
+   * Find multiple models by their primary keys
+   */
+  static findMany<T extends Ensemble>(this: {
+    new (): T;
+  }, ids: any[], columns?: string[]): Promise<T[]>;
+  /**
+   * Create a new instance and save it to the database
+   */
+  static create<T extends Ensemble>(this: {
+    new (attrs?: Record<string, any>): T;
+  }, attributes: Record<string, any>): Promise<T>;
+  /**
+   * Update or create a model matching the attributes
+   */
+  static updateOrCreate<T extends Ensemble>(this: {
+    new (): T;
+  }, attributes: Record<string, any>, values?: Record<string, any>): Promise<T>;
+  /**
+   * Save the model to the database
+   */
+  save(): Promise<boolean>;
+  /**
+   * Perform a model insert operation
+   */
+  protected performInsert(): Promise<boolean>;
+  /**
+   * Perform a model update operation
+   */
+  protected performUpdate(): Promise<boolean>;
+  /**
+   * Update the model's timestamps
+   */
+  protected updateTimestamps(): void;
+  /**
+   * Get the attributes that have been changed
+   */
+  getDirty(): Record<string, any>;
+  /**
+   * Determine if the given attribute has been changed
+   */
+  isDirty(attribute?: string): boolean;
+  /**
+   * Determine if the original value is equivalent to the current value
+   */
+  protected originalIsEquivalent(key: string, current: any): boolean;
+  /**
+   * Determine if the given attribute is a date or date castable
+   */
+  protected isDateAttribute(key: string): boolean;
+  /**
+   * Compare two dates
+   */
+  protected compareDates(current: any, original: any): boolean;
+  /**
+   * Get the attributes for insert
+   */
+  protected getAttributesForInsert(): Record<string, any>;
+  /**
+   * Sync the original attributes with the current
+   */
+  protected syncOriginal(): this;
+  /**
+   * Delete the model from the database
+   */
+  delete(): Promise<boolean>;
+  /**
+   * Reload the current model instance from the database
+   */
+  refresh(): Promise<this>;
+  /**
+   * Convert a string to studly case
+   */
+  protected studly(value: string): string;
+  /**
+   * Convert a string to snake case
+   */
+  protected snake(value: string): string;
+  /**
+   * Pluralize a string (simple implementation)
+   */
+  protected pluralize(value: string): string;
+  /**
+   * Create a new query instance for the model
+   */
+  newQuery(): EnsembleBuilder<any>;
+  /**
+   * Create a new instance of the given model
+   */
+  newInstance(attributes?: Record<string, any>, exists?: boolean): this;
+  /**
+   * Get the name of the "updated at" column
+   */
+  getUpdatedAtColumn(): string | null;
+  /**
+   * Get the name of the "created at" column
+   */
+  getCreatedAtColumn(): string | null;
+  /**
+   * Fire the given model event
+   *
+   * @param event - Event name (saving, saved, creating, created, etc.)
+   * @returns false if event is halting and a listener returned false, undefined otherwise
+   */
+  protected fireModelEvent(event: string): Promise<boolean | undefined>;
+}
+//#endregion
+export { Ensemble };
+//# sourceMappingURL=Ensemble.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Ensemble.d.mts","names":[],"sources":["../../../src/Database/Ensemble/Ensemble.ts"],"mappings":";;;;;;uBAuBsB,QAAA,SAAiB,qBAAA;EAqGf;;;EAAA,iBAjGL,kBAAA,EAAoB,eAAA;EA0KR;;;EAAA,UArKnB,KAAA;EAkYO;;;EAAA,UA7XP,UAAA;EAoY6C;;;EAAA,UA/X7C,YAAA;EAuY4E;;;EAAA,UAlY5E,OAAA;EA4YsF;;;;;;;;EAAA,UAlYtF,QAAA;EAmaoB;;;;;;EAAA,UA3ZpB,OAAA;EAwaQ;;;;;EAAA,OAjaX,QAAA;EAmc0B;;;;;EAAA,OA5b1B,OAAA;EAurBK;;;EAAA,UAlrBF,MAAA;EA7DgD;;;EAAA,UAkEhD,OAAA;EA9D2B;;;EAAA,UAmE3B,OAAA;EA/CA;;;EAAA,UAoDA,KAAA,EAAO,MAAA;EApBV;;;EAAA,UAyBG,UAAA;EALA;;;EAAA,iBAUO,UAAA;EAKA;;;EAAA,iBAAA,UAAA;EAeP;;;EAAA,iBAVO,UAAA;EAyBP;;;EAAA,UApBA,UAAA,EAAY,MAAA;EA+BV;;;EAAA,UA1BF,QAAA,EAAU,MAAA;EAwCf;;;EAnCE,MAAA;EA+DP;;;EA1DO,kBAAA;EAkEM;;;EAAA,UA7DH,UAAA;EAkIc;;;;EAAA,UA5Hd,gBAAA;EAiJA;;;cA5IE,UAAA,GAAY,MAAA,eAA0B,YAAA;EAmLtC;;;EArKZ,IAAA,CAAK,UAAA,EAAY,MAAA;EA2MG;;;EA/LpB,YAAA,CAAa,GAAA,UAAa,KAAA;EAsOnB;;;;EAtNP,gBAAA,CAAiB,UAAA,EAAY,MAAA;EAoOtB;;;EA5NP,YAAA,CAAa,GAAA;EA4NoB;;;;;;;;;;;;;;EAAA,UAxLvB,UAAA,CAAW,GAAA;EA0MiB;;;EAAA,UAzK5B,aAAA,CAAc,GAAA;EAyKgF;;;EAAA,UAlK9F,aAAA,CAAc,GAAA;EA4KoC;;;EAAA,UArKlD,OAAA,CAAQ,GAAA;EAqKoF;;;EAAA,UA9J5F,aAAA,CAAc,GAAA,UAAa,KAAA;EAyKL;;;EAlIhC,QAAA,CAAA,GAAY,MAAA;EAkI+D;;;EAnG3E,MAAA,CAAA,GAAU,MAAA;EA+GU;;;EAAA,UAxGV,SAAA,CAAU,GAAA;EAyGyB;;;EA9F7C,QAAA,CAAA;EAgGG;;;EAlFH,UAAA,CAAA;EA2FsC;;;EApFtC,MAAA,CAAA;EAsFE;;;EAAA,OA/EK,qBAAA,CAAsB,QAAA,EAAU,eAAA;EAiF5B;;;EA1EX,aAAA,CAAA,GAAiB,UAAA;EAyGgB;;;EAAA,OAlG1B,KAAA,WAAgB,QAAA,CAAA,CAAU,IAAA;IAAA,QAAgB,CAAA;EAAA,IAAM,eAAA,CAAgB,CAAA;EA0MvE;;;EAAA,OAlMa,GAAA,WAAc,QAAA,CAAA,CAAU,IAAA;IAAA,QAAgB,CAAA;EAAA,GAAK,OAAA,cAA4B,OAAA,CAAQ,CAAA;EAsOpE;;;EAAA,OA5Nb,IAAA,WAAe,QAAA,CAAA,CAAU,IAAA;IAAA,QAAgB,CAAA;EAAA,GAAK,EAAA,OAAS,OAAA,cAA4B,OAAA,CAAQ,CAAA;EAoP9F;;;EAAA,OA1OG,UAAA,WAAqB,QAAA,CAAA,CAAU,IAAA;IAAA,QAAgB,CAAA;EAAA,GAAK,EAAA,OAAS,OAAA,cAA4B,OAAA,CAAQ,CAAA;EAgS7F;;;EAAA,OArRJ,QAAA,WAAmB,QAAA,CAAA,CAAU,IAAA;IAAA,QAAgB,CAAA;EAAA,GAAK,GAAA,SAAY,OAAA,cAA4B,OAAA,CAAQ,CAAA;EAsTnG;;;EAAA,OA1SC,MAAA,WAAiB,QAAA,CAAA,CAC5B,IAAA;IAAA,KAAa,KAAA,GAAQ,MAAA,gBAAsB,CAAA;EAAA,GAC3C,UAAA,EAAY,MAAA,gBACX,OAAA,CAAQ,CAAA;EAoUX;;;EAAA,OA3Ta,cAAA,WAAyB,QAAA,CAAA,CACpC,IAAA;IAAA,QAAgB,CAAA;EAAA,GAChB,UAAA,EAAY,MAAA,eACZ,MAAA,GAAQ,MAAA,gBACP,OAAA,CAAQ,CAAA;;;;EAeL,IAAA,CAAA,GAAQ,OAAA;;;;YAgBE,aAAA,CAAA,GAAiB,OAAA;;;;YAqCjB,aAAA,CAAA,GAAiB,OAAA;;;;YAmCvB,gBAAA,CAAA;;;;EAiBV,QAAA,CAAA,GAAY,MAAA;;;;EAeZ,OAAA,CAAQ,SAAA;;;;YAWE,oBAAA,CAAqB,GAAA,UAAa,OAAA;;;;YAyBlC,eAAA,CAAgB,GAAA;;;;YAQhB,YAAA,CAAa,OAAA,OAAc,QAAA;;;;YAS3B,sBAAA,CAAA,GAA0B,MAAA;;;;YAO1B,YAAA,CAAA;;;;EAQJ,MAAA,CAAA,GAAU,OAAA;;;;EA0BV,OAAA,CAAA,GAAW,OAAA;;;;YAoBP,MAAA,CAAO,KAAA;;;;YAUP,KAAA,CAAM,KAAA;;;;YAUN,SAAA,CAAU,KAAA;;;;EAapB,QAAA,CAAA,GAAY,eAAA;;;;EAOZ,WAAA,CAAY,UAAA,GAAY,MAAA,eAA0B,MAAA;;;;EAelD,kBAAA,CAAA;;;;EAOA,kBAAA,CAAA;;;;;;;YAUgB,cAAA,CAAe,KAAA,WAAgB,OAAA;AAAA"}

package/dist/Database/Ensemble/Ensemble.mjs

@@ -0,0 +1,2 @@
+import{HasRelationshipsMixin as e}from"./Concerns/HasRelationships.mjs";import{EnsembleBuilder as t}from"./EnsembleBuilder.mjs";import{ModelRetrieved as n}from"./Events/ModelRetrieved.mjs";import{ModelCreating as r}from"./Events/ModelCreating.mjs";import{ModelCreated as i}from"./Events/ModelCreated.mjs";import{ModelUpdating as a}from"./Events/ModelUpdating.mjs";import{ModelUpdated as o}from"./Events/ModelUpdated.mjs";import{ModelSaving as s}from"./Events/ModelSaving.mjs";import{ModelSaved as c}from"./Events/ModelSaved.mjs";import{ModelDeleting as l}from"./Events/ModelDeleting.mjs";import{ModelDeleted as u}from"./Events/ModelDeleted.mjs";var d=class d extends e{static connectionResolver;table;primaryKey=`id`;incrementing=!0;keyType=`int`;fillable=[];guarded=[`*`];static fillable;static guarded;hidden=[];visible=[];appends=[];casts={};timestamps=!0;static CREATED_AT=`created_at`;static UPDATED_AT=`updated_at`;static DELETED_AT=`deleted_at`;attributes={};original={};exists=!1;wasRecentlyCreated=!1;connection;dynamicRelations=!1;constructor(e={},t=!1){super(),t?this.setRawAttributes(e):this.fill(e)}fill(e){for(let[t,n]of Object.entries(e))this.isFillable(t)&&this.setAttribute(t,n);return this}setAttribute(e,t){let n=`set${this.studly(e)}Attribute`;return typeof this[n]==`function`?(this[n](t),this):(this.attributes[e]=t,this)}setRawAttributes(e){return this.attributes=e,this}getAttribute(e){if(!e)return;let t=`get${this.studly(e)}Attribute`;if(typeof this[t]==`function`)return this[t]();let n=this.attributes[e];return this.hasCast(e)?this.castAttribute(e,n):n}isFillable(e){let t=this.constructor,n=(Object.prototype.hasOwnProperty.call(t,`fillable`)?t.fillable:void 0)??this.fillable;if(n.length>0)return n.includes(e);let r=(Object.prototype.hasOwnProperty.call(t,`guarded`)?t.guarded:void 0)??this.guarded;return r.length>0&&!r.includes(`*`)?!r.includes(e):r[0]!==`*`}hasGetMutator(e){return typeof this[`get${this.studly(e)}Attribute`]==`function`}hasSetMutator(e){return typeof this[`set${this.studly(e)}Attribute`]==`function`}hasCast(e){return e in this.casts}castAttribute(e,t){if(t===null)return t;switch(this.casts[e]){case`int`:case`integer`:return parseInt(t);case`real`:case`float`:case`double`:return parseFloat(t);case`string`:return String(t);case`bool`:case`boolean`:return!!t;case`object`:return typeof t==`string`?JSON.parse(t):t;case`array`:case`json`:return typeof t==`string`?JSON.parse(t):t;case`collection`:return typeof t==`string`?JSON.parse(t):t;case`date`:case`datetime`:case`timestamp`:return t instanceof Date?t:new Date(t);default:return t}}toObject(){let e={};for(let t of Object.keys(this.attributes))this.isVisible(t)&&(e[t]=this.getAttribute(t));for(let t of this.appends)e[t]=this.getAttribute(t);for(let[t,n]of Object.entries(this.relations))Array.isArray(n)?e[t]=n.map(e=>e.toObject()):n&&typeof n.toObject==`function`?e[t]=n.toObject():e[t]=n;return e}toJSON(){return this.toObject()}isVisible(e){return this.visible.length>0?this.visible.includes(e):!this.hidden.includes(e)}getTable(){if(this.table)return this.table;let e=this.constructor.name;return this.pluralize(this.snake(e))}getKeyName(){return this.primaryKey}getKey(){return this.getAttribute(this.getKeyName())}static setConnectionResolver(e){d.connectionResolver=e}getConnection(){return this.constructor.connectionResolver.connection(this.connection)}static query(){let e=new this;return new t(e.getConnection().getAdapter(),e)}static async all(e=[`*`]){return this.query().select(...e).get()}static async find(e,t=[`*`]){return this.query().select(...t).find(e)}static async findOrFail(e,t=[`*`]){let n=await this.find(e,t);if(!n)throw Error(`Ensemble not found with id: ${e}`);return n}static async findMany(e,t=[`*`]){let n=new this;return this.query().select(...t).whereIn(n.getKeyName(),e).get()}static async create(e){let t=new this(e);return await t.save(),t}static async updateOrCreate(e,t={}){let n=await this.query().where(e).first();return n?(n.fill(t),await n.save(),n):this.create({...e,...t})}async save(){return await this.fireModelEvent(`saving`)===!1?!1:this.exists?this.performUpdate():this.performInsert()}async performInsert(){if(await this.fireModelEvent(`creating`)===!1)return!1;let e=this.getAttributesForInsert();this.timestamps&&this.updateTimestamps();let t=this.getConnection(),n=this.getTable(),r=await t.table(n).insertGetId(e);return this.incrementing&&this.setAttribute(this.getKeyName(),r),this.exists=!0,this.wasRecentlyCreated=!0,this.syncOriginal(),await this.fireModelEvent(`created`),await this.fireModelEvent(`saved`),!0}async performUpdate(){let e=this.getDirty();if(Object.keys(e).length===0)return!0;if(await this.fireModelEvent(`updating`)===!1)return!1;this.timestamps&&this.updateTimestamps();let t=this.getConnection(),n=this.getTable();return await t.table(n).where(this.getKeyName(),`=`,this.getKey()).update(e),this.syncOriginal(),await this.fireModelEvent(`updated`),await this.fireModelEvent(`saved`),!0}updateTimestamps(){let e=new Date,t=this.constructor.UPDATED_AT;t&&!this.isDirty(t)&&this.setAttribute(t,e);let n=this.constructor.CREATED_AT;!this.exists&&n&&!this.isDirty(n)&&this.setAttribute(n,e)}getDirty(){let e={};for(let[t,n]of Object.entries(this.attributes))this.originalIsEquivalent(t,n)||(e[t]=n);return e}isDirty(e){return e?e in this.getDirty():Object.keys(this.getDirty()).length>0}originalIsEquivalent(e,t){if(!(e in this.original))return!1;let n=this.original[e];return t===n?!0:t===null?!1:this.isDateAttribute(e)?this.compareDates(t,n):String(t)===String(n)}isDateAttribute(e){let t=this.casts[e];return t===`date`||t===`datetime`||t===`timestamp`}compareDates(e,t){let n=e instanceof Date?e:new Date(e),r=t instanceof Date?t:new Date(t);return n.getTime()===r.getTime()}getAttributesForInsert(){return{...this.attributes}}syncOriginal(){return this.original={...this.attributes},this}async delete(){if(!this.exists||await this.fireModelEvent(`deleting`)===!1)return!1;let e=this.getConnection(),t=this.getTable();return await e.table(t).where(this.getKeyName(),`=`,this.getKey()).delete(),this.exists=!1,await this.fireModelEvent(`deleted`),!0}async refresh(){if(!this.exists)return this;let e=await this.constructor.find(this.getKey());if(!e)throw Error(`Ensemble not found`);return this.attributes=e.attributes,this.syncOriginal(),this}studly(e){return e.split(`_`).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(``)}snake(e){return e.replace(/([A-Z])/g,`_$1`).toLowerCase().replace(/^_/,``)}pluralize(e){return e.endsWith(`y`)?e.slice(0,-1)+`ies`:e.endsWith(`s`)?e+`es`:e+`s`}newQuery(){return this.constructor.query()}newInstance(e={},t=!1){let n=this.constructor,r=new n(e,t);return r.exists=t,t&&r.syncOriginal(),r}getUpdatedAtColumn(){return this.timestamps?this.constructor.UPDATED_AT:null}getCreatedAtColumn(){return this.timestamps?this.constructor.CREATED_AT:null}async fireModelEvent(e){let t;try{let{Dispatcher:e}=await import(`../../Events/Dispatcher.mjs`),{Facade:n}=await import(`../../Support/Facade.mjs`);try{t=n.getFacadeApplication()?.make?.(`events`)}catch{}}catch{return}if(!t||typeof t.dispatch!=`function`)return;let d={retrieved:n,creating:r,created:i,updating:a,updated:o,saving:s,saved:c,deleting:l,deleted:u}[e];if(!d)return;let f=new d(this);if([`creating`,`updating`,`saving`,`deleting`].includes(e)){if(await t.until?.(f)===!1)return!1}else await t.dispatch(f)}};export{d as Ensemble};
+//# sourceMappingURL=Ensemble.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Ensemble.mjs","names":[],"sources":["../../../src/Database/Ensemble/Ensemble.ts"],"sourcesContent":["/**\n * Ensemble Class\n *\n * Base class for Ensemble models with ActiveRecord pattern\n * In Orchestr, your data models are called Ensembles - groups that work in harmony\n */\n\nimport { Connection } from '@/Database/Connection';\nimport { DatabaseManager } from '@/Database/DatabaseManager';\nimport { HasRelationshipsMixin } from './Concerns/HasRelationships';\nimport { EnsembleBuilder } from './EnsembleBuilder';\nimport {\n  ModelRetrieved,\n  ModelCreating,\n  ModelCreated,\n  ModelUpdating,\n  ModelUpdated,\n  ModelSaving,\n  ModelSaved,\n  ModelDeleting,\n  ModelDeleted,\n} from './Events';\n\nexport abstract class Ensemble extends HasRelationshipsMixin {\n  /**\n   * The connection resolver instance\n   */\n  protected static connectionResolver: DatabaseManager;\n\n  /**\n   * The table associated with the model\n   */\n  protected table?: string;\n\n  /**\n   * The primary key for the model\n   */\n  protected primaryKey: string = 'id';\n\n  /**\n   * Indicates if the IDs are auto-incrementing\n   */\n  protected incrementing: boolean = true;\n\n  /**\n   * The data type of the primary key\n   */\n  protected keyType: string = 'int';\n\n  /**\n   * The attributes that are mass assignable (instance property).\n   *\n   * Subclasses may also declare `static fillable: string[]` instead.\n   * Static properties are resolved at construction time so they are safe\n   * to use even when a subclass constructor has not yet run its own field\n   * initialisers.\n   */\n  protected fillable: string[] = [];\n\n  /**\n   * The attributes that aren't mass assignable (instance property).\n   *\n   * Subclasses may also declare `static guarded: string[]` instead of\n   * (or in addition to) the instance property.\n   */\n  protected guarded: string[] = ['*'];\n\n  /**\n   * Static fillable list.  Subclasses that declare `static fillable` here\n   * will have those attributes made mass-assignable without needing a\n   * constructor override.\n   */\n  static fillable?: string[];\n\n  /**\n   * Static guarded list.  Subclasses that declare `static guarded` here\n   * will have those attributes protected from mass assignment without\n   * needing a constructor override.\n   */\n  static guarded?: string[];\n\n  /**\n   * The attributes that should be hidden for serialization\n   */\n  protected hidden: string[] = [];\n\n  /**\n   * The attributes that should be visible for serialization\n   */\n  protected visible: string[] = [];\n\n  /**\n   * The accessors to append to the model's array form\n   */\n  protected appends: string[] = [];\n\n  /**\n   * The attributes that should be cast\n   */\n  protected casts: Record<string, string> = {};\n\n  /**\n   * Indicates if the model should be timestamped\n   */\n  protected timestamps: boolean = true;\n\n  /**\n   * The name of the \"created at\" column\n   */\n  protected static CREATED_AT: string = 'created_at';\n\n  /**\n   * The name of the \"updated at\" column\n   */\n  protected static UPDATED_AT: string = 'updated_at';\n\n  /**\n   * The name of the \"deleted at\" column (for soft deletes)\n   */\n  protected static DELETED_AT: string = 'deleted_at';\n\n  /**\n   * The model's attributes\n   */\n  protected attributes: Record<string, any> = {};\n\n  /**\n   * The model's original attributes\n   */\n  protected original: Record<string, any> = {};\n\n  /**\n   * Indicates if the model exists in the database\n   */\n  public exists: boolean = false;\n\n  /**\n   * Indicates if the model was inserted during this request\n   */\n  public wasRecentlyCreated: boolean = false;\n\n  /**\n   * The connection name for the model\n   */\n  protected connection?: string;\n\n  /**\n   * Enable dynamic relationship access (user.posts instead of user.posts().get())\n   * Set to true to enable PHP-like __get behavior for relationships\n   */\n  protected dynamicRelations: boolean = false;\n\n  /**\n   * Create a new Eloquent model instance\n   */\n  constructor(attributes: Record<string, any> = {}, fromDatabase: boolean = false) {\n    super();\n    if (fromDatabase) {\n      // When hydrating from database, set all attributes directly\n      this.setRawAttributes(attributes);\n    } else {\n      // When creating manually, respect fillable/guarded\n      this.fill(attributes);\n    }\n  }\n\n  /**\n   * Fill the model with an array of attributes\n   */\n  fill(attributes: Record<string, any>): this {\n    for (const [key, value] of Object.entries(attributes)) {\n      if (this.isFillable(key)) {\n        this.setAttribute(key, value);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * Set a given attribute on the model\n   */\n  setAttribute(key: string, value: any): this {\n    // Check for mutator\n    const mutator = `set${this.studly(key)}Attribute`;\n    if (typeof (this as any)[mutator] === 'function') {\n      (this as any)[mutator](value);\n      return this;\n    }\n\n    this.attributes[key] = value;\n    return this;\n  }\n\n  /**\n   * Set the array of model attributes (bypasses fillable/guarded)\n   * Used when hydrating from database\n   */\n  setRawAttributes(attributes: Record<string, any>): this {\n    this.attributes = attributes;\n    return this;\n  }\n\n  /**\n   * Get an attribute from the model\n   */\n  getAttribute(key: string): any {\n    if (!key) {\n      return undefined;\n    }\n\n    // Check if we have an accessor\n    const accessor = `get${this.studly(key)}Attribute`;\n    if (typeof (this as any)[accessor] === 'function') {\n      return (this as any)[accessor]();\n    }\n\n    // Get the attribute value\n    const value = this.attributes[key];\n\n    // Cast the attribute if needed\n    if (this.hasCast(key)) {\n      return this.castAttribute(key, value);\n    }\n\n    return value;\n  }\n\n  /**\n   * Determine if the given attribute may be mass assigned.\n   *\n   * Resolution order for `fillable` and `guarded`:\n   *   1. Static property on the concrete class (e.g. `static fillable = [...]`)\n   *      – safe because static properties exist before any constructor runs.\n   *   2. Instance property (`this.fillable` / `this.guarded`) – populated either\n   *      by Ensemble's own field initialiser or by a subclass constructor\n   *      workaround that calls `this.fill()` a second time after `super()`.\n   *\n   * If the concrete class defines `static fillable`, it takes full precedence\n   * over the instance property (matching Laravel's behaviour where a non-empty\n   * fillable list is the authoritative allow-list).\n   */\n  protected isFillable(key: string): boolean {\n    const ctor = this.constructor as typeof Ensemble;\n\n    // Prefer static fillable if the subclass has defined one on itself\n    // (not inherited – check own property to avoid reading Ensemble's\n    //  `undefined` declaration as a truthy value).\n    const staticFillable: string[] | undefined = Object.prototype.hasOwnProperty.call(ctor, 'fillable')\n      ? ctor.fillable\n      : undefined;\n\n    const effectiveFillable: string[] = staticFillable ?? this.fillable;\n\n    if (effectiveFillable.length > 0) {\n      return effectiveFillable.includes(key);\n    }\n\n    // No fillable list – fall back to guarded logic.\n    const staticGuarded: string[] | undefined = Object.prototype.hasOwnProperty.call(ctor, 'guarded')\n      ? ctor.guarded\n      : undefined;\n\n    const effectiveGuarded: string[] = staticGuarded ?? this.guarded;\n\n    if (effectiveGuarded.length > 0 && !effectiveGuarded.includes('*')) {\n      return !effectiveGuarded.includes(key);\n    }\n\n    return effectiveGuarded[0] !== '*';\n  }\n\n  /**\n   * Determine if a get mutator exists for an attribute\n   */\n  protected hasGetMutator(key: string): boolean {\n    return typeof (this as any)[`get${this.studly(key)}Attribute`] === 'function';\n  }\n\n  /**\n   * Determine if a set mutator exists for an attribute\n   */\n  protected hasSetMutator(key: string): boolean {\n    return typeof (this as any)[`set${this.studly(key)}Attribute`] === 'function';\n  }\n\n  /**\n   * Determine if a cast is defined for an attribute\n   */\n  protected hasCast(key: string): boolean {\n    return key in this.casts;\n  }\n\n  /**\n   * Cast an attribute to a native PHP type\n   */\n  protected castAttribute(key: string, value: any): any {\n    if (value === null) {\n      return value;\n    }\n\n    const castType = this.casts[key];\n\n    switch (castType) {\n      case 'int':\n      case 'integer':\n        return parseInt(value);\n      case 'real':\n      case 'float':\n      case 'double':\n        return parseFloat(value);\n      case 'string':\n        return String(value);\n      case 'bool':\n      case 'boolean':\n        return Boolean(value);\n      case 'object':\n        return typeof value === 'string' ? JSON.parse(value) : value;\n      case 'array':\n      case 'json':\n        return typeof value === 'string' ? JSON.parse(value) : value;\n      case 'collection':\n        return typeof value === 'string' ? JSON.parse(value) : value;\n      case 'date':\n      case 'datetime':\n      case 'timestamp':\n        return value instanceof Date ? value : new Date(value);\n      default:\n        return value;\n    }\n  }\n\n  /**\n   * Convert the model to a plain object\n   */\n  toObject(): Record<string, any> {\n    const attributes: Record<string, any> = {};\n\n    for (const key of Object.keys(this.attributes)) {\n      if (this.isVisible(key)) {\n        attributes[key] = this.getAttribute(key);\n      }\n    }\n\n    // Add appended accessors\n    for (const key of this.appends) {\n      attributes[key] = this.getAttribute(key);\n    }\n\n    // Add loaded relationships\n    for (const [key, value] of Object.entries(this.relations)) {\n      if (Array.isArray(value)) {\n        attributes[key] = value.map((model) => model.toObject());\n      } else if (value && typeof value.toObject === 'function') {\n        attributes[key] = value.toObject();\n      } else {\n        attributes[key] = value;\n      }\n    }\n\n    return attributes;\n  }\n\n  /**\n   * Convert the model to JSON\n   */\n  toJSON(): Record<string, any> {\n    return this.toObject();\n  }\n\n  /**\n   * Determine if an attribute is visible\n   */\n  protected isVisible(key: string): boolean {\n    if (this.visible.length > 0) {\n      return this.visible.includes(key);\n    }\n\n    return !this.hidden.includes(key);\n  }\n\n  /**\n   * Get the table associated with the model\n   */\n  getTable(): string {\n    if (this.table) {\n      return this.table;\n    }\n\n    // Convert class name to snake_case plural\n    // e.g., User -> users, BlogPost -> blog_posts\n    const className = this.constructor.name;\n    return this.pluralize(this.snake(className));\n  }\n\n  /**\n   * Get the primary key for the model\n   */\n  getKeyName(): string {\n    return this.primaryKey;\n  }\n\n  /**\n   * Get the value of the model's primary key\n   */\n  getKey(): any {\n    return this.getAttribute(this.getKeyName());\n  }\n\n  /**\n   * Set the connection resolver instance\n   */\n  static setConnectionResolver(resolver: DatabaseManager): void {\n    (Ensemble as any).connectionResolver = resolver;\n  }\n\n  /**\n   * Get the database connection for the model\n   */\n  getConnection(): Connection {\n    return (this.constructor as typeof Ensemble).connectionResolver.connection(this.connection);\n  }\n\n  /**\n   * Begin querying the model\n   */\n  static query<T extends Ensemble>(this: { new (): T }): EnsembleBuilder<T> {\n    const instance = new this();\n    return new EnsembleBuilder<T>(instance.getConnection().getAdapter(), instance);\n  }\n\n  /**\n   * Get all of the models from the database\n   */\n  static async all<T extends Ensemble>(this: { new (): T }, columns: string[] = ['*']): Promise<T[]> {\n    return (this as any)\n      .query()\n      .select(...columns)\n      .get();\n  }\n\n  /**\n   * Find a model by its primary key\n   */\n  static async find<T extends Ensemble>(this: { new (): T }, id: any, columns: string[] = ['*']): Promise<T | null> {\n    return (this as any)\n      .query()\n      .select(...columns)\n      .find(id);\n  }\n\n  /**\n   * Find a model by its primary key or throw an exception\n   */\n  static async findOrFail<T extends Ensemble>(this: { new (): T }, id: any, columns: string[] = ['*']): Promise<T> {\n    const model = await (this as any).find(id, columns);\n    if (!model) {\n      throw new Error(`Ensemble not found with id: ${id}`);\n    }\n    return model;\n  }\n\n  /**\n   * Find multiple models by their primary keys\n   */\n  static async findMany<T extends Ensemble>(this: { new (): T }, ids: any[], columns: string[] = ['*']): Promise<T[]> {\n    const instance = new this();\n    return (this as any)\n      .query()\n      .select(...columns)\n      .whereIn(instance.getKeyName(), ids)\n      .get();\n  }\n\n  /**\n   * Create a new instance and save it to the database\n   */\n  static async create<T extends Ensemble>(\n    this: { new (attrs?: Record<string, any>): T },\n    attributes: Record<string, any>\n  ): Promise<T> {\n    const instance = new this(attributes);\n    await instance.save();\n    return instance;\n  }\n\n  /**\n   * Update or create a model matching the attributes\n   */\n  static async updateOrCreate<T extends Ensemble>(\n    this: { new (): T },\n    attributes: Record<string, any>,\n    values: Record<string, any> = {}\n  ): Promise<T> {\n    const instance = await (this as any).query().where(attributes).first();\n\n    if (instance) {\n      instance.fill(values);\n      await instance.save();\n      return instance;\n    }\n\n    return (this as any).create({ ...attributes, ...values });\n  }\n\n  /**\n   * Save the model to the database\n   */\n  async save(): Promise<boolean> {\n    // Fire saving event\n    if ((await this.fireModelEvent('saving')) === false) {\n      return false;\n    }\n\n    if (this.exists) {\n      return this.performUpdate();\n    }\n\n    return this.performInsert();\n  }\n\n  /**\n   * Perform a model insert operation\n   */\n  protected async performInsert(): Promise<boolean> {\n    // Fire creating event\n    if ((await this.fireModelEvent('creating')) === false) {\n      return false;\n    }\n\n    const attributes = this.getAttributesForInsert();\n\n    if (this.timestamps) {\n      this.updateTimestamps();\n    }\n\n    const connection = this.getConnection();\n    const table = this.getTable();\n\n    const id = await connection.table(table).insertGetId(attributes);\n\n    if (this.incrementing) {\n      this.setAttribute(this.getKeyName(), id);\n    }\n\n    this.exists = true;\n    this.wasRecentlyCreated = true;\n    this.syncOriginal();\n\n    // Fire created event\n    await this.fireModelEvent('created');\n\n    // Fire saved event\n    await this.fireModelEvent('saved');\n\n    return true;\n  }\n\n  /**\n   * Perform a model update operation\n   */\n  protected async performUpdate(): Promise<boolean> {\n    const dirty = this.getDirty();\n\n    if (Object.keys(dirty).length === 0) {\n      return true;\n    }\n\n    // Fire updating event\n    if ((await this.fireModelEvent('updating')) === false) {\n      return false;\n    }\n\n    if (this.timestamps) {\n      this.updateTimestamps();\n    }\n\n    const connection = this.getConnection();\n    const table = this.getTable();\n\n    await connection.table(table).where(this.getKeyName(), '=', this.getKey()).update(dirty);\n\n    this.syncOriginal();\n\n    // Fire updated event\n    await this.fireModelEvent('updated');\n\n    // Fire saved event\n    await this.fireModelEvent('saved');\n\n    return true;\n  }\n\n  /**\n   * Update the model's timestamps\n   */\n  protected updateTimestamps(): void {\n    const time = new Date();\n\n    const updatedAtColumn = (this.constructor as typeof Ensemble).UPDATED_AT;\n    if (updatedAtColumn && !this.isDirty(updatedAtColumn)) {\n      this.setAttribute(updatedAtColumn, time);\n    }\n\n    const createdAtColumn = (this.constructor as typeof Ensemble).CREATED_AT;\n    if (!this.exists && createdAtColumn && !this.isDirty(createdAtColumn)) {\n      this.setAttribute(createdAtColumn, time);\n    }\n  }\n\n  /**\n   * Get the attributes that have been changed\n   */\n  getDirty(): Record<string, any> {\n    const dirty: Record<string, any> = {};\n\n    for (const [key, value] of Object.entries(this.attributes)) {\n      if (!this.originalIsEquivalent(key, value)) {\n        dirty[key] = value;\n      }\n    }\n\n    return dirty;\n  }\n\n  /**\n   * Determine if the given attribute has been changed\n   */\n  isDirty(attribute?: string): boolean {\n    if (!attribute) {\n      return Object.keys(this.getDirty()).length > 0;\n    }\n\n    return attribute in this.getDirty();\n  }\n\n  /**\n   * Determine if the original value is equivalent to the current value\n   */\n  protected originalIsEquivalent(key: string, current: any): boolean {\n    if (!(key in this.original)) {\n      return false;\n    }\n\n    const original = this.original[key];\n\n    if (current === original) {\n      return true;\n    }\n\n    if (current === null) {\n      return false;\n    }\n\n    if (this.isDateAttribute(key)) {\n      return this.compareDates(current, original);\n    }\n\n    return String(current) === String(original);\n  }\n\n  /**\n   * Determine if the given attribute is a date or date castable\n   */\n  protected isDateAttribute(key: string): boolean {\n    const cast = this.casts[key];\n    return cast === 'date' || cast === 'datetime' || cast === 'timestamp';\n  }\n\n  /**\n   * Compare two dates\n   */\n  protected compareDates(current: any, original: any): boolean {\n    const currentDate = current instanceof Date ? current : new Date(current);\n    const originalDate = original instanceof Date ? original : new Date(original);\n    return currentDate.getTime() === originalDate.getTime();\n  }\n\n  /**\n   * Get the attributes for insert\n   */\n  protected getAttributesForInsert(): Record<string, any> {\n    return { ...this.attributes };\n  }\n\n  /**\n   * Sync the original attributes with the current\n   */\n  protected syncOriginal(): this {\n    this.original = { ...this.attributes };\n    return this;\n  }\n\n  /**\n   * Delete the model from the database\n   */\n  async delete(): Promise<boolean> {\n    if (!this.exists) {\n      return false;\n    }\n\n    // Fire deleting event\n    if ((await this.fireModelEvent('deleting')) === false) {\n      return false;\n    }\n\n    const connection = this.getConnection();\n    const table = this.getTable();\n\n    await connection.table(table).where(this.getKeyName(), '=', this.getKey()).delete();\n\n    this.exists = false;\n\n    // Fire deleted event\n    await this.fireModelEvent('deleted');\n\n    return true;\n  }\n\n  /**\n   * Reload the current model instance from the database\n   */\n  async refresh(): Promise<this> {\n    if (!this.exists) {\n      return this;\n    }\n\n    const fresh = await (this.constructor as any).find(this.getKey());\n\n    if (!fresh) {\n      throw new Error('Ensemble not found');\n    }\n\n    this.attributes = (fresh as any).attributes;\n    this.syncOriginal();\n\n    return this;\n  }\n\n  /**\n   * Convert a string to studly case\n   */\n  protected studly(value: string): string {\n    return value\n      .split('_')\n      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n      .join('');\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  /**\n   * Pluralize a string (simple implementation)\n   */\n  protected pluralize(value: string): string {\n    if (value.endsWith('y')) {\n      return value.slice(0, -1) + 'ies';\n    }\n    if (value.endsWith('s')) {\n      return value + 'es';\n    }\n    return value + 's';\n  }\n\n  /**\n   * Create a new query instance for the model\n   */\n  newQuery(): EnsembleBuilder<any> {\n    return (this.constructor as any).query();\n  }\n\n  /**\n   * Create a new instance of the given model\n   */\n  newInstance(attributes: Record<string, any> = {}, exists: boolean = false): this {\n    const ModelClass = this.constructor as new (attributes: Record<string, any>, fromDatabase: boolean) => this;\n    const instance = new ModelClass(attributes, exists);\n    instance.exists = exists;\n\n    if (exists) {\n      instance.syncOriginal();\n    }\n\n    return instance;\n  }\n\n  /**\n   * Get the name of the \"updated at\" column\n   */\n  getUpdatedAtColumn(): string | null {\n    return this.timestamps ? (this.constructor as typeof Ensemble).UPDATED_AT : null;\n  }\n\n  /**\n   * Get the name of the \"created at\" column\n   */\n  getCreatedAtColumn(): string | null {\n    return this.timestamps ? (this.constructor as typeof Ensemble).CREATED_AT : null;\n  }\n\n  /**\n   * Fire the given model event\n   *\n   * @param event - Event name (saving, saved, creating, created, etc.)\n   * @returns false if event is halting and a listener returned false, undefined otherwise\n   */\n  protected async fireModelEvent(event: string): Promise<boolean | undefined> {\n    // Try to get the event dispatcher\n    let dispatcher: any;\n    try {\n      // Import the Dispatcher and get from static resolver if available\n      const { Dispatcher } = await import('@/Events/Dispatcher');\n      const { Facade } = await import('@/Support/Facade');\n\n      try {\n        dispatcher = Facade.getFacadeApplication()?.make?.('events');\n      } catch {\n        // No dispatcher registered\n      }\n    } catch (error) {\n      // Event system not set up, skip firing events\n      return undefined;\n    }\n\n    if (!dispatcher || typeof dispatcher.dispatch !== 'function') {\n      return undefined;\n    }\n\n    // Map event names to event classes\n    const eventMap: Record<string, any> = {\n      retrieved: ModelRetrieved,\n      creating: ModelCreating,\n      created: ModelCreated,\n      updating: ModelUpdating,\n      updated: ModelUpdated,\n      saving: ModelSaving,\n      saved: ModelSaved,\n      deleting: ModelDeleting,\n      deleted: ModelDeleted,\n    };\n\n    const EventClass = eventMap[event];\n    if (!EventClass) {\n      return undefined;\n    }\n\n    const eventInstance = new EventClass(this);\n\n    // For halting events (creating, updating, saving, deleting), use until()\n    // which returns the first non-null result (false halts the operation)\n    if (['creating', 'updating', 'saving', 'deleting'].includes(event)) {\n      const result = await dispatcher.until?.(eventInstance);\n      // If any listener returns false, halt the operation\n      if (result === false) {\n        return false;\n      }\n    } else {\n      // For non-halting events, just dispatch normally\n      await dispatcher.dispatch(eventInstance);\n    }\n\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/Database/Ensemble/EnsembleBuilder.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../Query/Builder.cjs`),t=require(`./Relations/Relation.cjs`),n=require(`./EnsembleCollection.cjs`);n.init_EnsembleCollection();var r=class r extends e.Builder{model;eagerLoad={};constructor(e,t){super(e),this.model=t,this.from(t.getTable())}async find(e){return this.where(this.model.getKeyName(),`=`,e).first()}async get(){let e=await super.get(),t=this.hydrate(e);return Object.keys(this.eagerLoad).length>0&&await this.eagerLoadRelations(t),t}async first(){return(await this.limit(1).get())[0]||null}hydrate(e){return e.map(e=>this.newModelInstance(e,!0))}newModelInstance(e={},t=!1){let n=this.model.constructor,r=new n(e,t);return r.exists=t,r.syncOriginal(),t&&r.fireModelEvent?.(`retrieved`).catch(()=>{}),r}addSelect(...e){return this._columns.length===1&&this._columns[0]===`*`&&(this._columns=[]),this._columns.push(...e),this}with(e){if(typeof e==`string`)this.eagerLoad[e]=()=>{};else if(Array.isArray(e))for(let t of e)this.eagerLoad[t]=()=>{};else for(let[t,n]of Object.entries(e))this.eagerLoad[t]=n;return this}async eagerLoadRelations(e){for(let[t,n]of Object.entries(this.eagerLoad))e.length!==0&&(t.split(`.`).length>1?await this.eagerLoadNestedRelations(e,t,n):await this.eagerLoadRelation(e,t,n))}async eagerLoadRelation(e,t,r){let i=this.getRelation(e[0],t);i.addEagerConstraints(e),r(i),i.initRelation(e,t);let a=await i.getEager();i.match(e,new n.EnsembleCollection(a),t)}async eagerLoadNestedRelations(e,t,r){let i=t.split(`.`),a=i[0],o=i.slice(1).join(`.`);await this.eagerLoadRelation(e,a,()=>{});let s=[];for(let t of e){let e=t.getRelation(a);e&&(Array.isArray(e)||e instanceof n.EnsembleCollection?s.push(...e):s.push(e))}if(s.length>0&&s[0]){let e=s[0].newQuery();e.eagerLoad[o]=r,await e.eagerLoadRelations(s)}}getRelation(e,n){let r=e[n];if(typeof r!=`function`)throw Error(`Call to undefined relationship [${n}] on model [${e.constructor.name}]`);if(!(r.call(e)instanceof t.Relation))throw Error(`Relationship method [${n}] must return a Relation instance`);let i=t.Relation.constraints;t.Relation.constraints=!1;let a=r.call(e);return t.Relation.constraints=i,a}async create(e){let t=this.newModelInstance(e);return await t.save(),t}async update(e){return await super.update(e)}async delete(){return await super.delete()}async paginate(e=15,t=1){let n=await this.clone().count(),r=(t-1)*e;return{data:await this.clone().offset(r).limit(e).get(),total:n,perPage:e,currentPage:t,lastPage:Math.ceil(n/e),from:n>0?r+1:0,to:Math.min(r+e,n)}}async chunk(e,t){let n=1;for(;;){let r=await this.clone().offset((n-1)*e).limit(e).get();if(r.length===0||await t(r)===!1)break;n++}}clone(){let e=new r(this.adapter,this.model);return e._columns=[...this._columns],e._distinct=this._distinct,e._table=this._table,e._wheres=[...this._wheres],e._joins=[...this._joins],e._orders=[...this._orders],e._groups=[...this._groups],e._havings=[...this._havings],e._limit=this._limit,e._offset=this._offset,e._bindings=[...this._bindings],e.eagerLoad={...this.eagerLoad},e}};exports.EnsembleBuilder=r;

package/dist/Database/Ensemble/EnsembleBuilder.d.cts

@@ -0,0 +1,96 @@
+import { DatabaseAdapter } from "../Contracts/DatabaseAdapter.cjs";
+import { Builder } from "../Query/Builder.cjs";
+import { Relation } from "./Relations/Relation.cjs";
+import { Ensemble } from "./Ensemble.cjs";
+
+//#region src/Database/Ensemble/EnsembleBuilder.d.ts
+declare class EnsembleBuilder<T extends Ensemble> extends Builder<T> {
+  /**
+   * The model being queried
+   */
+  protected model: T;
+  /**
+   * The relationships that should be eager loaded
+   */
+  protected eagerLoad: Record<string, (query: any) => void>;
+  constructor(adapter: DatabaseAdapter, model: T);
+  /**
+   * Find a model by its primary key
+   */
+  find(id: any): Promise<T | null>;
+  /**
+   * Execute the query and get all results
+   */
+  get(): Promise<T[]>;
+  /**
+   * Get the first record
+   */
+  first(): Promise<T | null>;
+  /**
+   * Create a collection of models from plain arrays
+   */
+  protected hydrate(items: any[]): T[];
+  /**
+   * Create a new instance of the model
+   */
+  protected newModelInstance(attributes?: Record<string, any>, exists?: boolean): T;
+  /**
+   * Add a select statement to the query
+   */
+  addSelect(...columns: string[]): this;
+  /**
+   * Set the relationships that should be eager loaded
+   */
+  with(relations: string | string[] | Record<string, (query: any) => void>): this;
+  /**
+   * Eager load the relationships for the models
+   */
+  protected eagerLoadRelations(models: T[]): Promise<void>;
+  /**
+   * Eagerly load the relationship on a set of models
+   */
+  protected eagerLoadRelation(models: T[], name: string, constraints: (query: any) => void): Promise<void>;
+  /**
+   * Eagerly load nested relationships
+   */
+  protected eagerLoadNestedRelations(models: T[], name: string, constraints: (query: any) => void): Promise<void>;
+  /**
+   * Get the relation instance for the given relation name
+   */
+  protected getRelation(model: T, name: string): Relation<any, any>;
+  /**
+   * Create a new model and store it in the database
+   */
+  create(attributes: Record<string, any>): Promise<T>;
+  /**
+   * Update records in the database
+   */
+  update(values: Record<string, any>): Promise<number>;
+  /**
+   * Delete records from the database
+   */
+  delete(): Promise<number>;
+  /**
+   * Get a paginated result
+   */
+  paginate(perPage?: number, page?: number): Promise<{
+    data: T[];
+    total: number;
+    perPage: number;
+    currentPage: number;
+    lastPage: number;
+    from: number;
+    to: number;
+  }>;
+  /**
+   * Chunk the results of the query
+   */
+  chunk(count: number, callback: (models: T[]) => Promise<boolean | void>): Promise<void>;
+  /**
+   * Clone the query builder
+   */
+  clone(): EnsembleBuilder<T>;
+}
+//#endregion
+export { EnsembleBuilder };
+//# sourceMappingURL=EnsembleBuilder.d.cts.map

package/dist/Database/Ensemble/EnsembleBuilder.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsembleBuilder.d.cts","names":[],"sources":["../../../src/Database/Ensemble/EnsembleBuilder.ts"],"mappings":";;;;;;cAYa,eAAA,WAA0B,QAAA,UAAkB,OAAA,CAAa,CAAA;EAAA;;;EAAA,UAI1D,KAAA,EAAO,CAAA;EAO4B;;;EAAA,UAFnC,SAAA,EAAW,MAAA,UAAgB,KAAA;cAEzB,OAAA,EAAS,eAAA,EAAiB,KAAA,EAAO,CAAA;EA8BtB;;;EArBjB,IAAA,CAAK,EAAA,QAAU,OAAA,CAAQ,CAAA;EAoC8D;;;EA7BrF,GAAA,CAAA,GAAO,OAAA,CAAQ,CAAA;EAoGqB;;;EAtFpC,KAAA,CAAA,GAAS,OAAA,CAAQ,CAAA;EAmJM;;;EAAA,UA3InB,OAAA,CAAQ,KAAA,UAAe,CAAA;EAoKc;;;EAAA,UA7JrC,gBAAA,CAAiB,UAAA,GAAY,MAAA,eAA0B,MAAA,aAA0B,CAAA;EAwLnF;;;EAnKR,SAAA,CAAA,GAAa,OAAA;EAkMmE;;;EAvLhF,IAAA,CAAK,SAAA,sBAA+B,MAAA,UAAgB,KAAA;EAxFe;;;EAAA,UA2GnD,kBAAA,CAAmB,MAAA,EAAQ,CAAA,KAAM,OAAA;EA3GM;;;EAAA,UA+HvC,iBAAA,CAAkB,MAAA,EAAQ,CAAA,IAAK,IAAA,UAAc,WAAA,GAAc,KAAA,iBAAsB,OAAA;EAtHvF;;;EAAA,UA6IM,wBAAA,CACd,MAAA,EAAQ,CAAA,IACR,IAAA,UACA,WAAA,GAAc,KAAA,iBACb,OAAA;EA/IkB;;;EAAA,UAiLX,WAAA,CAAY,KAAA,EAAO,CAAA,EAAG,IAAA,WAAe,QAAA;EAxKzC;;;EAiMA,MAAA,CAAO,UAAA,EAAY,MAAA,gBAAsB,OAAA,CAAQ,CAAA;EA1LjD;;;EAmMA,MAAA,CAAO,MAAA,EAAQ,MAAA,gBAAsB,OAAA;EArL5B;;;EA4LT,MAAA,CAAA,GAAU,OAAA;EApLiB;;;EA2L3B,QAAA,CACJ,OAAA,WACA,IAAA,YACC,OAAA;IACD,IAAA,EAAM,CAAA;IACN,KAAA;IACA,OAAA;IACA,WAAA;IACA,QAAA;IACA,IAAA;IACA,EAAA;EAAA;EA3Ic;;;EAoKV,KAAA,CAAM,KAAA,UAAe,QAAA,GAAW,MAAA,EAAQ,CAAA,OAAQ,OAAA,mBAA0B,OAAA;EAhJhE;;;EAyKhB,KAAA,CAAA,GAAS,eAAA,CAAgB,CAAA;AAAA"}

package/dist/Database/Ensemble/EnsembleBuilder.d.mts

@@ -0,0 +1,96 @@
+import { DatabaseAdapter } from "../Contracts/DatabaseAdapter.mjs";
+import { Builder } from "../Query/Builder.mjs";
+import { Relation } from "./Relations/Relation.mjs";
+import { Ensemble } from "./Ensemble.mjs";
+
+//#region src/Database/Ensemble/EnsembleBuilder.d.ts
+declare class EnsembleBuilder<T extends Ensemble> extends Builder<T> {
+  /**
+   * The model being queried
+   */
+  protected model: T;
+  /**
+   * The relationships that should be eager loaded
+   */
+  protected eagerLoad: Record<string, (query: any) => void>;
+  constructor(adapter: DatabaseAdapter, model: T);
+  /**
+   * Find a model by its primary key
+   */
+  find(id: any): Promise<T | null>;
+  /**
+   * Execute the query and get all results
+   */
+  get(): Promise<T[]>;
+  /**
+   * Get the first record
+   */
+  first(): Promise<T | null>;
+  /**
+   * Create a collection of models from plain arrays
+   */
+  protected hydrate(items: any[]): T[];
+  /**
+   * Create a new instance of the model
+   */
+  protected newModelInstance(attributes?: Record<string, any>, exists?: boolean): T;
+  /**
+   * Add a select statement to the query
+   */
+  addSelect(...columns: string[]): this;
+  /**
+   * Set the relationships that should be eager loaded
+   */
+  with(relations: string | string[] | Record<string, (query: any) => void>): this;
+  /**
+   * Eager load the relationships for the models
+   */
+  protected eagerLoadRelations(models: T[]): Promise<void>;
+  /**
+   * Eagerly load the relationship on a set of models
+   */
+  protected eagerLoadRelation(models: T[], name: string, constraints: (query: any) => void): Promise<void>;
+  /**
+   * Eagerly load nested relationships
+   */
+  protected eagerLoadNestedRelations(models: T[], name: string, constraints: (query: any) => void): Promise<void>;
+  /**
+   * Get the relation instance for the given relation name
+   */
+  protected getRelation(model: T, name: string): Relation<any, any>;
+  /**
+   * Create a new model and store it in the database
+   */
+  create(attributes: Record<string, any>): Promise<T>;
+  /**
+   * Update records in the database
+   */
+  update(values: Record<string, any>): Promise<number>;
+  /**
+   * Delete records from the database
+   */
+  delete(): Promise<number>;
+  /**
+   * Get a paginated result
+   */
+  paginate(perPage?: number, page?: number): Promise<{
+    data: T[];
+    total: number;
+    perPage: number;
+    currentPage: number;
+    lastPage: number;
+    from: number;
+    to: number;
+  }>;
+  /**
+   * Chunk the results of the query
+   */
+  chunk(count: number, callback: (models: T[]) => Promise<boolean | void>): Promise<void>;
+  /**
+   * Clone the query builder
+   */
+  clone(): EnsembleBuilder<T>;
+}
+//#endregion
+export { EnsembleBuilder };
+//# sourceMappingURL=EnsembleBuilder.d.mts.map

package/dist/Database/Ensemble/EnsembleBuilder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsembleBuilder.d.mts","names":[],"sources":["../../../src/Database/Ensemble/EnsembleBuilder.ts"],"mappings":";;;;;;cAYa,eAAA,WAA0B,QAAA,UAAkB,OAAA,CAAa,CAAA;EAAA;;;EAAA,UAI1D,KAAA,EAAO,CAAA;EAO4B;;;EAAA,UAFnC,SAAA,EAAW,MAAA,UAAgB,KAAA;cAEzB,OAAA,EAAS,eAAA,EAAiB,KAAA,EAAO,CAAA;EA8BtB;;;EArBjB,IAAA,CAAK,EAAA,QAAU,OAAA,CAAQ,CAAA;EAoC8D;;;EA7BrF,GAAA,CAAA,GAAO,OAAA,CAAQ,CAAA;EAoGqB;;;EAtFpC,KAAA,CAAA,GAAS,OAAA,CAAQ,CAAA;EAmJM;;;EAAA,UA3InB,OAAA,CAAQ,KAAA,UAAe,CAAA;EAoKc;;;EAAA,UA7JrC,gBAAA,CAAiB,UAAA,GAAY,MAAA,eAA0B,MAAA,aAA0B,CAAA;EAwLnF;;;EAnKR,SAAA,CAAA,GAAa,OAAA;EAkMmE;;;EAvLhF,IAAA,CAAK,SAAA,sBAA+B,MAAA,UAAgB,KAAA;EAxFe;;;EAAA,UA2GnD,kBAAA,CAAmB,MAAA,EAAQ,CAAA,KAAM,OAAA;EA3GM;;;EAAA,UA+HvC,iBAAA,CAAkB,MAAA,EAAQ,CAAA,IAAK,IAAA,UAAc,WAAA,GAAc,KAAA,iBAAsB,OAAA;EAtHvF;;;EAAA,UA6IM,wBAAA,CACd,MAAA,EAAQ,CAAA,IACR,IAAA,UACA,WAAA,GAAc,KAAA,iBACb,OAAA;EA/IkB;;;EAAA,UAiLX,WAAA,CAAY,KAAA,EAAO,CAAA,EAAG,IAAA,WAAe,QAAA;EAxKzC;;;EAiMA,MAAA,CAAO,UAAA,EAAY,MAAA,gBAAsB,OAAA,CAAQ,CAAA;EA1LjD;;;EAmMA,MAAA,CAAO,MAAA,EAAQ,MAAA,gBAAsB,OAAA;EArL5B;;;EA4LT,MAAA,CAAA,GAAU,OAAA;EApLiB;;;EA2L3B,QAAA,CACJ,OAAA,WACA,IAAA,YACC,OAAA;IACD,IAAA,EAAM,CAAA;IACN,KAAA;IACA,OAAA;IACA,WAAA;IACA,QAAA;IACA,IAAA;IACA,EAAA;EAAA;EA3Ic;;;EAoKV,KAAA,CAAM,KAAA,UAAe,QAAA,GAAW,MAAA,EAAQ,CAAA,OAAQ,OAAA,mBAA0B,OAAA;EAhJhE;;;EAyKhB,KAAA,CAAA,GAAS,eAAA,CAAgB,CAAA;AAAA"}

package/dist/Database/Ensemble/EnsembleBuilder.mjs

@@ -0,0 +1,2 @@
+import{Builder as e}from"../Query/Builder.mjs";import{Relation as t}from"./Relations/Relation.mjs";import{EnsembleCollection as n,init_EnsembleCollection as r}from"./EnsembleCollection.mjs";r();var i=class r extends e{model;eagerLoad={};constructor(e,t){super(e),this.model=t,this.from(t.getTable())}async find(e){return this.where(this.model.getKeyName(),`=`,e).first()}async get(){let e=await super.get(),t=this.hydrate(e);return Object.keys(this.eagerLoad).length>0&&await this.eagerLoadRelations(t),t}async first(){return(await this.limit(1).get())[0]||null}hydrate(e){return e.map(e=>this.newModelInstance(e,!0))}newModelInstance(e={},t=!1){let n=this.model.constructor,r=new n(e,t);return r.exists=t,r.syncOriginal(),t&&r.fireModelEvent?.(`retrieved`).catch(()=>{}),r}addSelect(...e){return this._columns.length===1&&this._columns[0]===`*`&&(this._columns=[]),this._columns.push(...e),this}with(e){if(typeof e==`string`)this.eagerLoad[e]=()=>{};else if(Array.isArray(e))for(let t of e)this.eagerLoad[t]=()=>{};else for(let[t,n]of Object.entries(e))this.eagerLoad[t]=n;return this}async eagerLoadRelations(e){for(let[t,n]of Object.entries(this.eagerLoad))e.length!==0&&(t.split(`.`).length>1?await this.eagerLoadNestedRelations(e,t,n):await this.eagerLoadRelation(e,t,n))}async eagerLoadRelation(e,t,r){let i=this.getRelation(e[0],t);i.addEagerConstraints(e),r(i),i.initRelation(e,t);let a=await i.getEager();i.match(e,new n(a),t)}async eagerLoadNestedRelations(e,t,r){let i=t.split(`.`),a=i[0],o=i.slice(1).join(`.`);await this.eagerLoadRelation(e,a,()=>{});let s=[];for(let t of e){let e=t.getRelation(a);e&&(Array.isArray(e)||e instanceof n?s.push(...e):s.push(e))}if(s.length>0&&s[0]){let e=s[0].newQuery();e.eagerLoad[o]=r,await e.eagerLoadRelations(s)}}getRelation(e,n){let r=e[n];if(typeof r!=`function`)throw Error(`Call to undefined relationship [${n}] on model [${e.constructor.name}]`);if(!(r.call(e)instanceof t))throw Error(`Relationship method [${n}] must return a Relation instance`);let i=t.constraints;t.constraints=!1;let a=r.call(e);return t.constraints=i,a}async create(e){let t=this.newModelInstance(e);return await t.save(),t}async update(e){return await super.update(e)}async delete(){return await super.delete()}async paginate(e=15,t=1){let n=await this.clone().count(),r=(t-1)*e;return{data:await this.clone().offset(r).limit(e).get(),total:n,perPage:e,currentPage:t,lastPage:Math.ceil(n/e),from:n>0?r+1:0,to:Math.min(r+e,n)}}async chunk(e,t){let n=1;for(;;){let r=await this.clone().offset((n-1)*e).limit(e).get();if(r.length===0||await t(r)===!1)break;n++}}clone(){let e=new r(this.adapter,this.model);return e._columns=[...this._columns],e._distinct=this._distinct,e._table=this._table,e._wheres=[...this._wheres],e._joins=[...this._joins],e._orders=[...this._orders],e._groups=[...this._groups],e._havings=[...this._havings],e._limit=this._limit,e._offset=this._offset,e._bindings=[...this._bindings],e.eagerLoad={...this.eagerLoad},e}};export{i as EnsembleBuilder};
+//# sourceMappingURL=EnsembleBuilder.mjs.map