@orchestr-sh/orchestr 1.10.0 → 1.11.1

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

@@ -0,0 +1,329 @@
+import { Connection } from "../Connection.cjs";
+import { DatabaseManager } from "../DatabaseManager.cjs";
+import { EnsembleBuilder } from "./EnsembleBuilder.cjs";
+import { HasRelationshipsMixin } from "./Concerns/HasRelationships.cjs";
+
+//#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.cts.map

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

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

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":"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"}

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