@bunyad/orm 0.1.0-alpha.0 → 0.2.0-beta.1

package/dist/model.js

@@ -1,5 +1,5 @@
 import { DatabaseManager as Db, setDefaultConnection, connections, LengthAwarePaginator, CursorPaginator, Paginator, dateTimeForStorage, withoutQueryWriteHook, wrapSqlName, } from "@bunyad/database";
-import { Collection } from "@bunyad/common";
+import { Collection, LazyCollection } from "@bunyad/common";
 import { OrmCollection } from "./orm-collection.js";
 import { Attribute, castFromStorage, castToStorage, hashCastValue, isAlreadyHashed, enumFromStorage, enumToStorage, isAttribute, isCastType, isEnumCast, } from "./casts.js";
 import { bootIfNotBooted, fireModelEvent, hasAnyModelEventListeners, hasModelEventListeners, observeModel, registerModelEvent, withoutModelEvents, } from "./model-events.js";
@@ -355,7 +355,7 @@ export class Model {
     /** When false, `save()` skips `created_at` / `updated_at`. */
     static timestamps = true;
     /**
-     * Laravel `$casts` property — prefer `static casts()` when adding enums / Attribute.
+     * `$casts` property — prefer `static casts()` when adding enums / Attribute.
      * May be a plain object or a method returning the map.
      */
     static casts = {};
@@ -366,19 +366,19 @@ export class Model {
      */
     static relations = {};
     /**
-     * Laravel `$touches` — relation names whose related models get `touch()` after
+     * `$touches` — relation names whose related models get `touch()` after
      * this model is saved (or soft-deleted). Honor `withoutTouching`.
      */
     static touches = [];
-    /** Laravel `$hidden`. */
+    /** `$hidden`. */
     static hidden = [];
-    /** Laravel `$visible` allow-list (empty = all non-hidden). */
+    /** `$visible` allow-list (empty = all non-hidden). */
     static visible = [];
-    /** Laravel `$appends` — accessors included in `toArray()`. */
+    /** `$appends` — accessors included in `toArray()`. */
     static appends = [];
-    /** Laravel `$fillable`. */
+    /** `$fillable`. */
     static fillable = [];
-    /** Laravel `$guarded` — default guard all until fillable is set. */
+    /** `$guarded` — default guard all until fillable is set. */
     static guarded = ["*"];
     /** Set in constructor / hydrate — avoid empty `{}` alloc before assign. */
     #original;
@@ -395,7 +395,7 @@ export class Model {
     #visible = null;
     /** Per-instance connection override (`$model->setConnection()`). */
     #connection;
-    /** Laravel `$exists` — true after retrieve / successful insert. */
+    /** `$exists` — true after retrieve / successful insert. */
     get exists() {
         return this.#exists;
     }
@@ -444,7 +444,7 @@ export class Model {
         return out;
     }
     /**
-     * Laravel `getAttribute` — throws when `preventAccessingMissingAttributes` is on
+     * `getAttribute` — throws when `preventAccessingMissingAttributes` is on
      * and the key was not retrieved / does not exist (relations exempt).
      */
     getAttribute(key) {
@@ -478,18 +478,18 @@ export class Model {
         }
         return undefined;
     }
-    /** Laravel `isDirty`. */
+    /** `isDirty`. */
     isDirty(...attributes) {
         const dirty = this.getDirty();
         if (attributes.length === 0)
             return Object.keys(dirty).length > 0;
         return attributes.some((key) => Object.prototype.hasOwnProperty.call(dirty, key));
     }
-    /** Laravel `isClean`. */
+    /** `isClean`. */
     isClean(...attributes) {
         return !this.isDirty(...attributes);
     }
-    /** Laravel `getDirty`. */
+    /** `getDirty`. */
     getDirty() {
         const dirty = {};
         const original = this.#original ?? {};
@@ -505,11 +505,11 @@ export class Model {
             return { ...original };
         return original[key];
     }
-    /** Laravel `getChanges` — attributes changed by the last save. */
+    /** `getChanges` — attributes changed by the last save. */
     getChanges() {
         return this.#changes ? { ...this.#changes } : {};
     }
-    /** Laravel `wasChanged`. */
+    /** `wasChanged`. */
     wasChanged(...attributes) {
         const changes = this.#changes;
         if (!changes)
@@ -518,50 +518,50 @@ export class Model {
             return Object.keys(changes).length > 0;
         return attributes.some((key) => Object.prototype.hasOwnProperty.call(changes, key));
     }
-    /** Laravel `wasRecentlyCreated`. */
+    /** `wasRecentlyCreated`. */
     wasRecentlyCreated() {
         return this.#wasRecentlyCreated;
     }
-    /** Laravel `append`. */
+    /** `append`. */
     append(...attributes) {
         const current = this.getAppends();
         this.#appends = [...new Set([...current, ...attributes.flat()])];
         return this;
     }
-    /** Laravel `setAppends`. */
+    /** `setAppends`. */
     setAppends(attributes) {
         this.#appends = [...attributes];
         return this;
     }
-    /** Laravel `getAppends`. */
+    /** `getAppends`. */
     getAppends() {
         if (this.#appends)
             return [...this.#appends];
         return [...(this.constructor.appends ?? [])];
     }
-    /** Laravel `getHidden`. */
+    /** `getHidden`. */
     getHidden() {
         if (this.#hidden)
             return [...this.#hidden];
         return [...(this.constructor.hidden ?? [])];
     }
-    /** Laravel `getVisible`. */
+    /** `getVisible`. */
     getVisible() {
         if (this.#visible)
             return [...this.#visible];
         return [...(this.constructor.visible ?? [])];
     }
-    /** Laravel `setHidden`. */
+    /** `setHidden`. */
     setHidden(attributes) {
         this.#hidden = [...attributes];
         return this;
     }
-    /** Laravel `setVisible`. */
+    /** `setVisible`. */
     setVisible(attributes) {
         this.#visible = [...attributes];
         return this;
     }
-    /** Laravel `makeVisible` — show attributes for this instance. */
+    /** `makeVisible` — show attributes for this instance. */
     makeVisible(...attributes) {
         const attrs = attributes.flat();
         const hidden = new Set(this.getHidden());
@@ -574,7 +574,7 @@ export class Model {
         }
         return this;
     }
-    /** Laravel `makeHidden` — hide attributes for this instance. */
+    /** `makeHidden` — hide attributes for this instance. */
     makeHidden(...attributes) {
         const attrs = attributes.flat();
         this.#hidden = [...new Set([...this.getHidden(), ...attrs])];
@@ -586,7 +586,7 @@ export class Model {
         return this;
     }
     /**
-     * Run a callback without touching timestamps (Laravel `Model::withoutTimestamps`).
+     * Run a callback without touching timestamps (`Model::withoutTimestamps`).
      */
     static async withoutTimestamps(callback) {
         const previous = this.timestamps;
@@ -605,23 +605,23 @@ export class Model {
     static isIgnoringTouch() {
         return isIgnoringTouch(this);
     }
-    /** Laravel `Model::preventLazyLoading`. */
+    /** `Model::preventLazyLoading`. */
     static preventLazyLoading(prevent = true) {
         setPreventLazyLoading(prevent);
     }
-    /** Laravel `Model::preventSilentlyDiscardingAttributes`. */
+    /** `Model::preventSilentlyDiscardingAttributes`. */
     static preventSilentlyDiscardingAttributes(prevent = true) {
         setPreventSilentlyDiscardingAttributes(prevent);
     }
-    /** Laravel `Model::preventAccessingMissingAttributes`. */
+    /** `Model::preventAccessingMissingAttributes`. */
     static preventAccessingMissingAttributes(prevent = true) {
         setPreventAccessingMissingAttributes(prevent);
     }
-    /** Laravel `Model::shouldBeStrict` — enable/disable the strictness trio. */
+    /** `Model::shouldBeStrict` — enable/disable the strictness trio. */
     static shouldBeStrict(should = true) {
         setShouldBeStrict(should);
     }
-    /** Laravel `Model::addGlobalScope`. */
+    /** `Model::addGlobalScope`. */
     static addGlobalScope(nameOrScope, scope) {
         if (typeof nameOrScope === "function") {
             registerGlobalScope(this, nameOrScope.name || `scope_${Date.now()}`, nameOrScope);
@@ -631,28 +631,28 @@ export class Model {
             throw new Error("addGlobalScope requires a callback.");
         registerGlobalScope(this, nameOrScope, scope);
     }
-    /** Laravel `Model::addGlobalScope` removal helper. */
+    /** `Model::addGlobalScope` removal helper. */
     static removeGlobalScope(name) {
         unregisterGlobalScope(this, name);
     }
     /**
-     * Laravel `boot` — runs once per model class before first use.
+     * `boot` — runs once per model class before first use.
      * Prefer registering listeners in `booted()`.
      */
     static boot() { }
     /**
-     * Laravel `booted` — runs once after `boot`. Typical place for `static::created(...)`.
+     * `booted` — runs once after `boot`. Typical place for `static::created(...)`.
      */
     static booted() { }
     /** Ensure this model class has been booted. */
     static bootIfNotBooted() {
         bootIfNotBooted(this);
     }
-    /** Laravel `Model::observe`. */
+    /** `Model::observe`. */
     static observe(observer) {
         observeModel(this, observer);
     }
-    /** Laravel `Model::withoutEvents`. */
+    /** `Model::withoutEvents`. */
     static withoutEvents(callback) {
         return withoutModelEvents(this, callback);
     }
@@ -779,7 +779,7 @@ export class Model {
     static getConnection() {
         return resolveConnection(this.connection);
     }
-    /** Laravel `$model->setConnection($name)`. */
+    /** `$model->setConnection($name)`. */
     setConnection(connection) {
         this.#connection = connection;
         return this;
@@ -799,7 +799,7 @@ export class Model {
         return manager;
     }
     /**
-     * Laravel `Model::on($connection)` — same model, different named connection.
+     * `Model::on($connection)` — same model, different named connection.
      */
     static on(connection) {
         return this.newQuery({ connection });
@@ -814,21 +814,21 @@ export class Model {
         const query = new Ctor(this, options);
         return withLocalScopeProxy(query);
     }
-    /** Laravel `withoutGlobalScopes()`. */
+    /** `withoutGlobalScopes()`. */
     static withoutGlobalScopes(names) {
         return this.newQuery({
             withoutGlobalScopes: names ?? true,
         });
     }
-    /** Laravel `withoutGlobalScope($name)`. */
+    /** `withoutGlobalScope($name)`. */
     static withoutGlobalScope(name) {
         return this.newQuery({ withoutGlobalScopes: [name] });
     }
-    /** Laravel `Model::query()` — scoped `ModelQuery` (not a raw table builder). */
+    /** `Model::query()` — scoped `ModelQuery` (not a raw table builder). */
     static query(options) {
         return this.newQuery(options);
     }
-    /** Laravel `Model::find`. */
+    /** `Model::find`. */
     static find(id) {
         this.bootIfNotBooted();
         if (canFastFind(this)) {
@@ -839,12 +839,12 @@ export class Model {
             .where(this.primaryKey, id)
             .first();
     }
-    /** Laravel `getRouteKeyName()` — column used for implicit route binding. */
+    /** `getRouteKeyName()` — column used for implicit route binding. */
     static getRouteKeyName() {
         return this.primaryKey;
     }
     /**
-     * Laravel `resolveRouteBinding` — find by PK or custom `{param:column}` field.
+     * `resolveRouteBinding` — find by PK or custom `{param:column}` field.
      */
     static resolveRouteBinding(value, field) {
         const column = field ?? this.getRouteKeyName();
@@ -855,7 +855,7 @@ export class Model {
         return this.newQuery().where(column, value).first();
     }
     /**
-     * Laravel SoftDeletes `resolveSoftDeletableRouteBinding` — same as
+     * `resolveSoftDeletableRouteBinding` — same as
      * `resolveRouteBinding` but includes soft-deleted rows (`withTrashed()`).
      * Used by the router when the route opts in via `withTrashed()`.
      */
@@ -885,20 +885,20 @@ export class Model {
         model.#exists = true;
         return model;
     }
-    /** Laravel `Model::findOrFail`. */
+    /** `Model::findOrFail`. */
     static async findOrFail(id) {
         const model = await this.find(id);
         if (!model)
             throw new ModelNotFoundException();
         return model;
     }
-    /** Laravel `Model::all`. */
+    /** `Model::all`. */
     static async all() {
         this.bootIfNotBooted();
         return this.newQuery().get();
     }
     /**
-     * Laravel `Model::get` — same as `query().get()` / `all()`.
+     * `Model::get` — same as `query().get()` / `all()`.
      * Typed helper for autocomplete; Proxy also forwards other terminals.
      */
     static get() {
@@ -995,30 +995,30 @@ export class Model {
             return q.whereDate(column, opOrValue);
         return q.whereDate(column, String(opOrValue), value);
     }
-    /** Laravel `Model::whereNot(closure)`. */
+    /** `Model::whereNot(closure)`. */
     static whereNot(callback) {
         this.bootIfNotBooted();
         return this.newQuery().whereNot(callback);
     }
-    /** Laravel `Model::orWhereNot(closure)`. */
+    /** `Model::orWhereNot(closure)`. */
     static orWhereNot(callback) {
         this.bootIfNotBooted();
         return this.newQuery().orWhereNot(callback);
     }
-    /** Laravel `withTrashed()`. */
+    /** `withTrashed()`. */
     static withTrashed() {
         this.bootIfNotBooted();
         return this.newQuery({
             withTrashed: true,
         });
     }
-    /** Laravel `onlyTrashed()`. */
+    /** `onlyTrashed()`. */
     static onlyTrashed() {
         return this.newQuery({
             onlyTrashed: true,
         });
     }
-    /** Laravel `withoutTrashed()`. */
+    /** `withoutTrashed()`. */
     static withoutTrashed() {
         return this.newQuery({
             withTrashed: false,
@@ -1035,27 +1035,27 @@ export class Model {
             eagerLoad: normalizeWithRelations(relations),
         });
     }
-    /** Laravel `Model::whereHas`. */
+    /** `Model::whereHas`. */
     static whereHas(relation, callback) {
         this.bootIfNotBooted();
         return this.newQuery().whereHas(relation, callback);
     }
-    /** Laravel `Model::whereDoesntHave`. */
+    /** `Model::whereDoesntHave`. */
     static whereDoesntHave(relation, callback) {
         this.bootIfNotBooted();
         return this.newQuery().whereDoesntHave(relation, callback);
     }
-    /** Laravel `Model::orWhereHas`. */
+    /** `Model::orWhereHas`. */
     static orWhereHas(relation, callback) {
         this.bootIfNotBooted();
         return this.newQuery().orWhereHas(relation, callback);
     }
-    /** Laravel `Model::whereRelation`. */
+    /** `Model::whereRelation`. */
     static whereRelation(relation, column, opOrValue, value) {
         this.bootIfNotBooted();
         return this.newQuery().whereRelation(relation, column, opOrValue, value);
     }
-    /** Laravel `Model::orWhereRelation`. */
+    /** `Model::orWhereRelation`. */
     static orWhereRelation(relation, column, opOrValue, value) {
         this.bootIfNotBooted();
         return this.newQuery().orWhereRelation(relation, column, opOrValue, value);
@@ -1065,7 +1065,7 @@ export class Model {
         this.bootIfNotBooted();
         return this.newQuery().withCount(...relations);
     }
-    /** Laravel `Model::withSum`. */
+    /** `Model::withSum`. */
     static withSum(relation, column) {
         this.bootIfNotBooted();
         return this.newQuery().withSum(relation, column);
@@ -1110,40 +1110,56 @@ export class Model {
         this.bootIfNotBooted();
         return this.newQuery().whereKey(id);
     }
-    /** Laravel `Model::whereUuid`. */
+    /** `Model::whereUuid`. */
     static whereUuid(column, value) {
         this.bootIfNotBooted();
         return this.newQuery().whereUuid(column, value);
     }
-    /** Laravel `Model::whereUlid`. */
+    /** `Model::whereUlid`. */
     static whereUlid(column, value) {
         this.bootIfNotBooted();
         return this.newQuery().whereUlid(column, value);
     }
-    /** Laravel `Model::join`. */
+    /** `Model::join`. */
     static join(table, first, op, second) {
         this.bootIfNotBooted();
         return this.newQuery().join(table, first, op, second);
     }
-    /** Laravel `Model::leftJoin`. */
+    /** `Model::leftJoin`. */
     static leftJoin(table, first, op, second) {
         this.bootIfNotBooted();
         return this.newQuery().leftJoin(table, first, op, second);
     }
-    /** Laravel `Model::paginate`. */
+    /** `Model::paginate`. */
     static async paginate(perPage = 15, page, options = {}) {
         return this.newQuery().paginate(perPage, page, options);
     }
-    /** Laravel `Model::cursorPaginate`. */
+    /** `Model::cursorPaginate`. */
     static async cursorPaginate(perPage = 15, cursor = null, options = {}) {
         return this.newQuery().cursorPaginate(perPage, cursor, options);
     }
-    /** Laravel `Model::create` (respects `$fillable` / `$guarded`). */
+    /** `Model::cursor()`: stream models from a single query. */
+    static cursor(chunkSize) {
+        return this.newQuery().cursor(chunkSize);
+    }
+    /** `Model::lazy()`: chunked iteration, one query per chunk. */
+    static lazy(chunkSize) {
+        return this.newQuery().lazy(chunkSize);
+    }
+    /** `Model::lazyById()`: chunked iteration by primary key (safe while updating). */
+    static lazyById(chunkSize, column) {
+        return this.newQuery().lazyById(chunkSize, column);
+    }
+    /** `Model::lazyByIdDesc()`. */
+    static lazyByIdDesc(chunkSize, column) {
+        return this.newQuery().lazyByIdDesc(chunkSize, column);
+    }
+    /** `Model::create` (respects `$fillable` / `$guarded`). */
     static create(attributes) {
         this.bootIfNotBooted();
         return this.forceCreate(filterFillable(this, attributes));
     }
-    /** Laravel `Model::forceCreate` — insert every given attribute, ignoring `$fillable`. */
+    /** `Model::forceCreate` — insert every given attribute, ignoring `$fillable`. */
     static forceCreate(useAttrs) {
         this.bootIfNotBooted();
         // Assign raw attributes (skip get-casts) so mutators like Attribute.set can run on save.
@@ -1176,7 +1192,7 @@ export class Model {
         }
         return after(saved);
     }
-    /** Laravel `firstOrNew`. */
+    /** `firstOrNew`. */
     static async firstOrNew(attributes, values = {}) {
         let q = this.newQuery();
         for (const [column, value] of Object.entries(attributes)) {
@@ -1187,7 +1203,7 @@ export class Model {
             return existing;
         return new this({ ...attributes, ...values });
     }
-    /** Laravel `firstOrCreate`. */
+    /** `firstOrCreate`. */
     static async firstOrCreate(attributes, values = {}) {
         let q = this.newQuery();
         for (const [column, value] of Object.entries(attributes)) {
@@ -1198,7 +1214,7 @@ export class Model {
             return existing;
         return this.create({ ...attributes, ...values });
     }
-    /** Laravel `updateOrCreate`. */
+    /** `updateOrCreate`. */
     static async updateOrCreate(attributes, values = {}) {
         let q = this.newQuery();
         for (const [column, value] of Object.entries(attributes)) {
@@ -1220,21 +1236,21 @@ export class Model {
         return this.newQuery().insert(values);
     }
     /**
-     * Laravel `Model::upsert` — bulk insert-or-update on unique conflict.
+     * `Model::upsert` — bulk insert-or-update on unique conflict.
      * Delegates to `ModelQuery.upsert` (timestamps stamped when enabled).
      */
     static async upsert(values, uniqueBy, update = null) {
         this.bootIfNotBooted();
         return this.newQuery().upsert(values, uniqueBy, update);
     }
-    /** Laravel `$model->fill($attributes)`. */
+    /** `$model->fill($attributes)`. */
     fill(attributes) {
         const ctor = this.constructor;
         const finalAttrs = filterFillable(ctor, attributes);
         assignOwn(this, ctor.castAttributes(finalAttrs, "get"));
         return this;
     }
-    /** Laravel `$model->update($attributes)`. */
+    /** `$model->update($attributes)`. */
     async update(attributes) {
         this.fill(attributes);
         await this.save();
@@ -1441,16 +1457,16 @@ export class Model {
         }
         this.syncOriginal();
         await fireModelEvent(this, "saved");
-        // Laravel finishSave → touchOwners (Relation.touch honors withoutTouching on related).
+        // finishSave → touchOwners (Relation.touch honors withoutTouching on related).
         await this.touchOwners();
         return this;
     }
-    /** Laravel `$model->saveQuietly()`. */
+    /** `$model->saveQuietly()`. */
     async saveQuietly() {
         const ctor = this.constructor;
         return ctor.withoutEvents(() => this.save());
     }
-    /** Laravel `$model->refresh()`. */
+    /** `$model->refresh()`. */
     async refresh() {
         const ctor = this.constructor;
         const key = ctor.primaryKey;
@@ -1464,7 +1480,7 @@ export class Model {
         return this;
     }
     /**
-     * Laravel-style refresh under row lock (`lockForUpdate`).
+     * Refresh under row lock (`lockForUpdate`).
      * Reloads this instance from a locked select of the same primary key.
      */
     async refreshForUpdate() {
@@ -1482,7 +1498,7 @@ export class Model {
         }
         return this;
     }
-    /** Laravel `$model->fresh()`. */
+    /** `$model->fresh()`. */
     async fresh() {
         const ctor = this.constructor;
         const key = ctor.primaryKey;
@@ -1502,7 +1518,7 @@ export class Model {
             await eagerLoadModels([this], missing);
         return this;
     }
-    /** Laravel `$model->relationLoaded($key)`. */
+    /** `$model->relationLoaded($key)`. */
     relationLoaded(key) {
         return Object.prototype.hasOwnProperty.call(this, key);
     }
@@ -1526,14 +1542,14 @@ export class Model {
         }
     }
     /**
-     * Laravel `$model->touches($relation)` — whether `$touches` lists this relation.
+     * `$model->touches($relation)` — whether `$touches` lists this relation.
      */
     touches(relation) {
         const ctor = this.constructor;
         return (ctor.touches ?? []).includes(relation);
     }
     /**
-     * Laravel `$model->touchOwners()` — touch each relation in `$touches`.
+     * `$model->touchOwners()` — touch each relation in `$touches`.
      * Uses `relation.touch()` when available (BelongsTo / HasOne / HasMany);
      * otherwise loads the related model and calls `touch()` on it.
      */
@@ -1556,7 +1572,7 @@ export class Model {
         }
     }
     /**
-     * Laravel `$model->touch()` — bump `updated_at` (no-op while `withoutTouching`).
+     * `$model->touch()` — bump `updated_at` (no-op while `withoutTouching`).
      * Saving also runs `$touches` / `touchOwners()` for listed relations.
      */
     async touch() {
@@ -1574,7 +1590,7 @@ export class Model {
         return true;
     }
     /**
-     * Relation query builder (`$model->product()` in Laravel).
+     * Relation query builder (`$model->product()`).
      *
      * Define relations on `static relations` and declare the loaded property:
      * `declare product: Product | null` — then use `model.product` after `with('product')`,
@@ -1605,7 +1621,7 @@ export class Model {
         }
         throw new Error(`Call to undefined relationship [${name}] on model [${ctor.name ?? "Model"}].`);
     }
-    /** Laravel `$model->replicate()`. */
+    /** `$model->replicate()`. */
     replicate(except = []) {
         const ctor = this.constructor;
         ctor.bootIfNotBooted();
@@ -1618,7 +1634,7 @@ export class Model {
             attrs[k] = v;
         }
         const copy = new ctor(attrs);
-        // Fire sync-style; listeners may be async but replicate is sync in Laravel.
+        // Fire sync-style; listeners may be async but replicate is sync.
         void fireModelEvent(copy, "replicating");
         return copy;
     }
@@ -1633,7 +1649,7 @@ export class Model {
             await fireModelEvent(this, "trashed");
             return;
         }
-        // Laravel delete(): touchOwners before performDeleteOnModel.
+        // delete(): touchOwners before performDeleteOnModel.
         await this.touchOwners();
         await this.#performForceDelete();
         await fireModelEvent(this, "deleted");
@@ -1664,7 +1680,7 @@ export class Model {
         await fireModelEvent(this, "forceDeleted");
         await fireModelEvent(this, "deleted");
     }
-    /** Laravel `$model->deleteQuietly()`. */
+    /** `$model->deleteQuietly()`. */
     async deleteQuietly() {
         const ctor = this.constructor;
         await ctor.withoutEvents(() => this.delete());
@@ -1705,7 +1721,7 @@ export class Model {
         const value = this[col];
         return value != null && value !== "";
     }
-    /** Laravel `$model->toArray()`. */
+    /** `$model->toArray()`. */
     toArray() {
         const ctor = this.constructor;
         const hiddenList = this.getHidden();
@@ -1746,7 +1762,7 @@ export class Model {
         }
         return this[key];
     }
-    /** Laravel `$model->loadCount(...$relations)`. */
+    /** `$model->loadCount(...$relations)`. */
     async loadCount(...relations) {
         const names = relations.flat();
         if (names.length === 0)
@@ -1758,7 +1774,7 @@ export class Model {
         }
         return this;
     }
-    /** Laravel `$model->loadSum($relation, $column)`. */
+    /** `$model->loadSum($relation, $column)`. */
     async loadSum(relation, column) {
         const parsed = parseRelationAlias(relation);
         const value = await aggregateRelation(this, parsed.relation, "sum", column);
@@ -1783,7 +1799,7 @@ export class Model {
         this[parsed.alias ?? `${parsed.relation}_max_${column}`] = value;
         return this;
     }
-    /** Laravel `$model->loadExists(...$relations)`. */
+    /** `$model->loadExists(...$relations)`. */
     async loadExists(...relations) {
         for (const relation of relations.flat()) {
             const parsed = parseRelationAlias(relation);
@@ -1799,7 +1815,7 @@ export class Model {
     toJson() {
         return this.toJSON();
     }
-    /** Laravel `$model->increment($column, $amount)`. */
+    /** `$model->increment($column, $amount)`. */
     async increment(column, amount = 1) {
         const row = this;
         const current = Number(row[column] ?? 0);
@@ -1807,11 +1823,11 @@ export class Model {
         await this.save();
         return this;
     }
-    /** Laravel `$model->decrement($column, $amount)`. */
+    /** `$model->decrement($column, $amount)`. */
     async decrement(column, amount = 1) {
         return this.increment(column, -amount);
     }
-    /** Laravel `Model::destroy($ids)`. */
+    /** `Model::destroy($ids)`. */
     static async destroy(ids) {
         const list = Array.isArray(ids) ? ids : [ids];
         let n = 0;
@@ -1825,7 +1841,7 @@ export class Model {
         return n;
     }
     /**
-     * Laravel `Model::forceDestroy($ids)` — permanent delete by key(s).
+     * `Model::forceDestroy($ids)` — permanent delete by key(s).
      * Soft-delete models are found via `withTrashed()` so trashed rows are included.
      */
     static async forceDestroy(ids) {
@@ -1842,18 +1858,18 @@ export class Model {
         }
         return n;
     }
-    /** Laravel `$this->hasMany(Related::class)`. */
+    /** `$this->hasMany(Related::class)`. */
     hasMany(related, foreignKey, localKey) {
         const key = foreignKey ?? `${singular(this.constructor.table)}_id`;
         return new HasMany(this, related, key, localKey);
     }
-    /** Laravel `$this->hasOne(Related::class)`. */
+    /** `$this->hasOne(Related::class)`. */
     hasOne(related, foreignKey, localKey) {
         const key = foreignKey ?? `${singular(this.constructor.table)}_id`;
         return new HasOne(this, related, key, localKey);
     }
     /**
-     * Laravel `$this->hasManyThrough(Related::class, Through::class)`.
+     * `$this->hasManyThrough(Related::class, Through::class)`.
      * Parent → Through (firstKey) → Related (secondKey).
      */
     hasManyThrough(related, through, firstKey, secondKey, localKey, secondLocalKey) {
@@ -1861,18 +1877,18 @@ export class Model {
         return new HasManyThrough(this, related, through, firstKey ?? `${singular(parentCtor.table)}_id`, secondKey ?? `${singular(through.table)}_id`, localKey ?? parentCtor.primaryKey, secondLocalKey ?? through.primaryKey);
     }
     /**
-     * Laravel `$this->hasOneThrough(Related::class, Through::class)`.
+     * `$this->hasOneThrough(Related::class, Through::class)`.
      */
     hasOneThrough(related, through, firstKey, secondKey, localKey, secondLocalKey) {
         const parentCtor = this.constructor;
         return new HasOneThrough(this, related, through, firstKey ?? `${singular(parentCtor.table)}_id`, secondKey ?? `${singular(through.table)}_id`, localKey ?? parentCtor.primaryKey, secondLocalKey ?? through.primaryKey);
     }
-    /** Laravel `$this->belongsTo(Related::class)`. */
+    /** `$this->belongsTo(Related::class)`. */
     belongsTo(related, foreignKey, ownerKey) {
         const key = foreignKey ?? `${singular(related.table)}_id`;
         return new BelongsTo(this, related, key, ownerKey);
     }
-    /** Laravel `$this->belongsToMany(Related::class, pivot)`. */
+    /** `$this->belongsToMany(Related::class, pivot)`. */
     belongsToMany(related, table, foreignPivotKey, relatedPivotKey) {
         const parent = this.constructor;
         const pivot = table ??
@@ -1903,15 +1919,15 @@ export class Model {
             : [name, primaryMorph].filter((value, index, all) => all.indexOf(value) === index);
         return new MorphToMany(this, related, table, foreign, relatedKey, morphTypeColumn, morphTypes, options.pivotTenantKey, options.parentTenantKey ?? options.pivotTenantKey);
     }
-    /** Laravel `$this->morphMany(Related::class, name)`. */
+    /** `$this->morphMany(Related::class, name)`. */
     morphMany(related, name, type, id, localKey) {
         return new MorphMany(this, related, type ?? `${name}_type`, id ?? `${name}_id`, morphTypeFor(this.constructor), localKey);
     }
-    /** Laravel `$this->morphOne(Related::class, name)`. */
+    /** `$this->morphOne(Related::class, name)`. */
     morphOne(related, name, type, id, localKey) {
         return new MorphOne(this, related, type ?? `${name}_type`, id ?? `${name}_id`, morphTypeFor(this.constructor), localKey);
     }
-    /** Laravel `$this->morphTo($name)`. */
+    /** `$this->morphTo($name)`. */
     morphTo(name, type, id, ownerKey) {
         return new MorphTo(this, type ?? `${name}_type`, id ?? `${name}_id`, ownerKey);
     }