@orchestr-sh/orchestr 1.0.1 → 1.1.0

package/dist/Database/Ensemble/Concerns/HasTimestamps.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HasTimestamps Concern
+ *
+ * Provides timestamp handling functionality for models
+ */
+export interface HasTimestamps {
+    /**
+     * Indicates if the model should be timestamped
+     */
+    timestamps: boolean;
+    /**
+     * Update the model's timestamps
+     */
+    updateTimestamps(): void;
+    /**
+     * Set the value of the "created at" attribute
+     */
+    setCreatedAt(value: Date): void;
+    /**
+     * Set the value of the "updated at" attribute
+     */
+    setUpdatedAt(value: Date): void;
+    /**
+     * Get the name of the "created at" column
+     */
+    getCreatedAtColumn(): string;
+    /**
+     * Get the name of the "updated at" column
+     */
+    getUpdatedAtColumn(): string;
+    /**
+     * Determine if the model uses timestamps
+     */
+    usesTimestamps(): boolean;
+}
+/**
+ * Default timestamp column names
+ */
+export declare const CREATED_AT = "created_at";
+export declare const UPDATED_AT = "updated_at";
+//# sourceMappingURL=HasTimestamps.d.ts.map

package/dist/Database/Ensemble/Concerns/HasTimestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasTimestamps.d.ts","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Concerns/HasTimestamps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,gBAAgB,IAAI,IAAI,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,UAAU,eAAe,CAAC"}

package/dist/Database/Ensemble/Concerns/HasTimestamps.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * HasTimestamps Concern
+ *
+ * Provides timestamp handling functionality for models
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPDATED_AT = exports.CREATED_AT = void 0;
+/**
+ * Default timestamp column names
+ */
+exports.CREATED_AT = 'created_at';
+exports.UPDATED_AT = 'updated_at';
+//# sourceMappingURL=HasTimestamps.js.map

package/dist/Database/Ensemble/Concerns/HasTimestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasTimestamps.js","sourceRoot":"","sources":["../../../../src/Database/Ensemble/Concerns/HasTimestamps.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuCH;;GAEG;AACU,QAAA,UAAU,GAAG,YAAY,CAAC;AAC1B,QAAA,UAAU,GAAG,YAAY,CAAC"}

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

@@ -0,0 +1,266 @@
+/**
+ * Ensemble Class
+ *
+ * Base class for Ensemble models with ActiveRecord pattern
+ * In Orchestr, your data models are called Ensembles - groups that work in harmony
+ */
+import { DatabaseManager } from '../DatabaseManager';
+import { Connection } from '../Connection';
+import { EnsembleBuilder } from './EnsembleBuilder';
+export declare abstract class Ensemble {
+    /**
+     * 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
+     */
+    protected fillable: string[];
+    /**
+     * The attributes that aren't mass assignable
+     */
+    protected 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;
+    /**
+     * Create a new Eloquent model instance
+     */
+    constructor(attributes?: Record<string, any>);
+    /**
+     * 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;
+    /**
+     * Get an attribute from the model
+     */
+    getAttribute(key: string): any;
+    /**
+     * Determine if the given attribute may be mass assigned
+     */
+    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;
+}
+//# sourceMappingURL=Ensemble.d.ts.map

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

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