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

package/dist/model-query.js

@@ -147,7 +147,7 @@ export class ModelQuery {
         this.#asRows = true;
         return this;
     }
-    /** Laravel `withoutGlobalScopes`. */
+    /** `withoutGlobalScopes`. */
     withoutGlobalScopes(names) {
         if (!names)
             this.#withoutGlobalScopes = true;
@@ -161,30 +161,30 @@ export class ModelQuery {
         }
         return this;
     }
-    /** Laravel `withoutGlobalScope`. */
+    /** `withoutGlobalScope`. */
     withoutGlobalScope(name) {
         return this.withoutGlobalScopes([name]);
     }
-    /** Laravel `withTrashed()`. */
+    /** `withTrashed()`. */
     withTrashed() {
         this.#withTrashed = true;
         this.#onlyTrashed = false;
         return this;
     }
-    /** Laravel `onlyTrashed()`. */
+    /** `onlyTrashed()`. */
     onlyTrashed() {
         this.#onlyTrashed = true;
         this.#withTrashed = false;
         return this;
     }
-    /** Laravel `withoutTrashed()`. */
+    /** `withoutTrashed()`. */
     withoutTrashed() {
         this.#withTrashed = false;
         this.#onlyTrashed = false;
         return this;
     }
     /**
-     * Laravel `Builder::withAttributes` — pending attrs for `create()`, and
+     * `Builder::withAttributes` — pending attrs for `create()`, and
      * matching `where` conditions when `asConditions` is true (default).
      */
     withAttributes(attributes, valueOrAsConditions, asConditions = true) {
@@ -209,7 +209,7 @@ export class ModelQuery {
         }
         return this;
     }
-    /** Laravel `withCasts` — merge query-time casts for hydration. */
+    /** `withCasts` — merge query-time casts for hydration. */
     withCasts(casts) {
         this.#casts = mqMutObj(this.#casts);
         Object.assign(this.#casts, casts);
@@ -219,15 +219,15 @@ export class ModelQuery {
         }
         return this;
     }
-    /** Laravel `has`. */
+    /** `has`. */
     has(relation) {
         return this.whereHas(relation);
     }
-    /** Laravel `doesntHave`. */
+    /** `doesntHave`. */
     doesntHave(relation) {
         return this.whereDoesntHave(relation);
     }
-    /** Laravel `whereHas`. */
+    /** `whereHas`. */
     whereHas(relation, callback) {
         this.#simple = false;
         // BelongsTo AND: expand to INNER JOIN once (same SQL as join()), avoid re-resolve per get().
@@ -240,23 +240,23 @@ export class ModelQuery {
         }
         return this.#pushHasConstraint(relation, false, false, callback, meta);
     }
-    /** Laravel `orWhereHas`. */
+    /** `orWhereHas`. */
     orWhereHas(relation, callback) {
         this.#simple = false;
         return this.#pushHasConstraint(relation, false, true, callback);
     }
-    /** Laravel `whereDoesntHave`. */
+    /** `whereDoesntHave`. */
     whereDoesntHave(relation, callback) {
         this.#simple = false;
         return this.#pushHasConstraint(relation, true, false, callback);
     }
-    /** Laravel `orWhereDoesntHave`. */
+    /** `orWhereDoesntHave`. */
     orWhereDoesntHave(relation, callback) {
         this.#simple = false;
         return this.#pushHasConstraint(relation, true, true, callback);
     }
     /**
-     * Laravel `whereRelation($relation, $column, $operator = null, $value = null)`.
+     * `whereRelation($relation, $column, $operator = null, $value = null)`.
      * Convenience wrapper around `whereHas` with a column constraint.
      */
     whereRelation(relation, column, opOrValue, value) {
@@ -291,7 +291,7 @@ export class ModelQuery {
                 q.where(column, String(opOrValue), value);
         });
     }
-    /** Laravel `orWhereRelation`. */
+    /** `orWhereRelation`. */
     orWhereRelation(relation, column, opOrValue, value) {
         this.#simple = false;
         const meta = resolveRelation(this.model, relation);
@@ -312,22 +312,22 @@ export class ModelQuery {
                 q.where(column, String(opOrValue), value);
         });
     }
-    /** Laravel `orHas`. */
+    /** `orHas`. */
     orHas(relation) {
         return this.orWhereHas(relation);
     }
-    /** Laravel `orDoesntHave`. */
+    /** `orDoesntHave`. */
     orDoesntHave(relation) {
         return this.orWhereDoesntHave(relation);
     }
     /**
-     * Laravel `whereBelongsTo($model, $relationshipName = null)`.
+     * `whereBelongsTo($model, $relationshipName = null)`.
      * Constrains by the foreign key of a belongsTo relation.
      */
     whereBelongsTo(related, relationName) {
         return this.#belongsToConstraint(related, relationName, false);
     }
-    /** Laravel `orWhereBelongsTo`. */
+    /** `orWhereBelongsTo`. */
     orWhereBelongsTo(related, relationName) {
         return this.#belongsToConstraint(related, relationName, true);
     }
@@ -347,7 +347,7 @@ export class ModelQuery {
         return this;
     }
     /**
-     * Laravel `whereMorphedTo($relation, $model)`.
+     * `whereMorphedTo($relation, $model)`.
      */
     whereMorphedTo(relation, model) {
         return this.#morphToConstraint(relation, model, false, false);
@@ -400,7 +400,7 @@ export class ModelQuery {
         return this;
     }
     /**
-     * Laravel `whereMorphRelation($relation, $types, $column, …)` — simplified:
+     * `whereMorphRelation($relation, $types, $column, …)` — simplified:
      * `whereMorphRelation('commentable', TypeModel, column, op?, value?)`.
      */
     whereMorphRelation(relation, type, column, opOrValue, value) {
@@ -420,7 +420,7 @@ export class ModelQuery {
         });
     }
     /**
-     * Laravel `whereHasMorph($relation, $types, $callback?)`.
+     * `whereHasMorph($relation, $types, $callback?)`.
      * `$types` may be a single model class or an array.
      */
     whereHasMorph(relation, types, callback) {
@@ -466,14 +466,14 @@ export class ModelQuery {
         return this;
     }
     /**
-     * Laravel `withWhereHas($relation, $callback?)` — whereHas + eager with same constraint.
+     * `withWhereHas($relation, $callback?)` — whereHas + eager with same constraint.
      */
     withWhereHas(relation, callback) {
         this.whereHas(relation, callback);
         this.with(relation);
         return this;
     }
-    /** Laravel `whereAny` (forwarded to query builder). */
+    /** `whereAny` (forwarded to query builder). */
     whereAny(columns, opOrValue, value) {
         this.#simple = false;
         (this.#builderExtras = mqMut(this.#builderExtras)).push((q) => q.whereAny(columns, opOrValue, value));
@@ -504,29 +504,29 @@ export class ModelQuery {
         (this.#builderExtras = mqMut(this.#builderExtras)).push((q) => q.orWhereNone(columns, opOrValue, value));
         return this;
     }
-    /** Laravel `whereKey($id)` / `whereKey([$ids])`. */
+    /** `whereKey($id)` / `whereKey([$ids])`. */
     whereKey(id) {
         const key = this.model.primaryKey;
         if (Array.isArray(id))
             return this.whereIn(key, id);
         return this.where(key, id);
     }
-    /** Laravel `whereKeyNot`. */
+    /** `whereKeyNot`. */
     whereKeyNot(id) {
         const key = this.model.primaryKey;
         if (Array.isArray(id))
             return this.whereNotIn(key, id);
         return this.where(key, "!=", id);
     }
-    /** Laravel `whereUuid($column, $uuid)`. */
+    /** `whereUuid($column, $uuid)`. */
     whereUuid(column, value) {
         return this.where(column, value);
     }
-    /** Laravel `whereUlid($column, $ulid)`. */
+    /** `whereUlid($column, $ulid)`. */
     whereUlid(column, value) {
         return this.where(column, value);
     }
-    /** Laravel `whereNot(closure)` nested group. */
+    /** `whereNot(closure)` nested group. */
     whereNot(callback) {
         this.#simple = false;
         (this.#nestedGroups = mqMut(this.#nestedGroups)).push({ boolean: "and", not: true, callback });
@@ -544,18 +544,18 @@ export class ModelQuery {
             this.where(column, String(opOrValue), value);
         return this.first();
     }
-    /** Laravel `findMany`. */
+    /** `findMany`. */
     findMany(ids) {
         return this.whereIn(this.model.primaryKey, ids).#fetchModels();
     }
-    /** Laravel `findOr($id, $callback)`. */
+    /** `findOr($id, $callback)`. */
     async findOr(id, callback) {
         const model = await this.where(this.model.primaryKey, id).first();
         if (model)
             return model;
         return callback();
     }
-    /** Laravel `findOrNew`. */
+    /** `findOrNew`. */
     async findOrNew(id) {
         const model = await this.where(this.model.primaryKey, id).first();
         if (model)
@@ -564,19 +564,19 @@ export class ModelQuery {
         fresh[this.model.primaryKey] = id;
         return fresh;
     }
-    /** Laravel `firstOr($callback)`. */
+    /** `firstOr($callback)`. */
     async firstOr(callback) {
         const model = await this.first();
         if (model)
             return model;
         return callback();
     }
-    /** Laravel `valueOrFail`. */
+    /** `valueOrFail`. */
     async valueOrFail(column) {
         const model = await this.firstOrFail();
         return model[column];
     }
-    /** Laravel `soleValue`. */
+    /** `soleValue`. */
     async soleValue(column) {
         const model = await this.sole();
         return model[column];
@@ -620,7 +620,7 @@ export class ModelQuery {
         }
         return this;
     }
-    /** Laravel `withSum($relation, $column)`. */
+    /** `withSum($relation, $column)`. */
     withSum(relation, column) {
         const parsed = parseRelationAlias(relation);
         const base = parsed.relation;
@@ -669,7 +669,7 @@ export class ModelQuery {
         });
         return this;
     }
-    /** Laravel `withExists($relation)`. */
+    /** `withExists($relation)`. */
     withExists(...relations) {
         for (const raw of relations.flat()) {
             const parsed = parseRelationAlias(raw);
@@ -682,7 +682,7 @@ export class ModelQuery {
         }
         return this;
     }
-    /** Laravel `withAggregate($relation, $column, $function)`. */
+    /** `withAggregate($relation, $column, $function)`. */
     withAggregate(relation, column, fn) {
         const parsed = parseRelationAlias(relation);
         const base = parsed.relation;
@@ -695,19 +695,19 @@ export class ModelQuery {
         });
         return this;
     }
-    /** Laravel Eloquent `join` (hydrated models still from the base table). */
+    /** `join` (hydrated models still from the base table). */
     join(table, first, op, second) {
         this.#simple = false;
         (this.#joins = mqMut(this.#joins)).push({ type: "inner", table, first, op, second });
         return this;
     }
-    /** Laravel `leftJoin`. */
+    /** `leftJoin`. */
     leftJoin(table, first, op, second) {
         this.#simple = false;
         (this.#joins = mqMut(this.#joins)).push({ type: "left", table, first, op, second });
         return this;
     }
-    /** Laravel `rightJoin`. */
+    /** `rightJoin`. */
     rightJoin(table, first, op, second) {
         this.#simple = false;
         (this.#joins = mqMut(this.#joins)).push({ type: "right", table, first, op, second });
@@ -2592,7 +2592,7 @@ export class ModelQuery {
             return model;
         })();
     }
-    /** Laravel `firstOrFail`. */
+    /** `firstOrFail`. */
     async firstOrFail() {
         const model = await this.first();
         if (!model)
@@ -2862,7 +2862,7 @@ export class ModelQuery {
         }
         return models;
     }
-    /** Laravel `Builder::create` — insert on this query's connection. */
+    /** `Builder::create` — insert on this query's connection. */
     async create(attributes) {
         const merged = { ...this.#pendingAttributes, ...attributes };
         const useAttrs = filterFillable(this.model, merged);
@@ -2901,7 +2901,7 @@ export class ModelQuery {
         }
         return new Paginator(items, size, currentPage, options);
     }
-    /** Laravel `chunk($count, $callback)`. */
+    /** `chunk($count, $callback)`. */
     async chunk(count, callback) {
         let page = 1;
         for (;;) {
@@ -2922,7 +2922,7 @@ export class ModelQuery {
             page += 1;
         }
     }
-    /** Laravel `lazy($chunkSize)`. */
+    /** `lazy($chunkSize)`. */
     async *lazy(chunkSize = 1000) {
         let page = 1;
         const fireRetrieved = hasModelEventListeners(this.model, "retrieved");
@@ -2949,7 +2949,7 @@ export class ModelQuery {
             page += 1;
         }
     }
-    /** Laravel `chunkById`. */
+    /** `chunkById`. */
     async chunkById(count, callback, column) {
         return this.#chunkById(count, callback, column ?? this.model.primaryKey, "asc");
     }
@@ -2975,7 +2975,7 @@ export class ModelQuery {
                 return true;
         }
     }
-    /** Laravel `lazyById`. */
+    /** `lazyById`. */
     async *lazyById(chunkSize = 1000, column) {
         yield* this.#lazyById(chunkSize, column ?? this.model.primaryKey, "asc");
     }
@@ -3007,7 +3007,7 @@ export class ModelQuery {
     async decrement(column, amount = 1) {
         await this.#buildQuery().decrement(column, amount);
     }
-    /** Laravel `cursorPaginate`. */
+    /** `cursorPaginate`. */
     async cursorPaginate(perPage = 15, cursor = null, options = {}) {
         const page = await this.#buildQuery().cursorPaginate(perPage, cursor, options);
         const items = await this.#hydrateRows(page.items);
@@ -3016,7 +3016,7 @@ export class ModelQuery {
         }
         return new CursorPaginator(items, page.perPage, page.options);
     }
-    /** Laravel `Builder::count($columns = '*')` — honors `distinct()` for non-`*`. */
+    /** `Builder::count($columns = '*')` — honors `distinct()` for non-`*`. */
     async count(column = "*") {
         let countQ = this.#countQuery();
         if (this.#distinct) {
@@ -3124,8 +3124,8 @@ export class ModelQuery {
         return this.#baseTable().insert(finalRows);
     }
     /**
-     * Laravel `Builder::upsert` — insert or update on unique conflict.
-     * When the model uses timestamps, stamps `created_at`/`updated_at` like Eloquent
+     * `Builder::upsert` — insert or update on unique conflict.
+     * When the model uses timestamps, stamps `created_at`/`updated_at`
      * (row values win; `updated_at` is always included in the update column list).
      */
     async upsert(values, uniqueBy, update = null) {

package/dist/model-strictness.d.ts

@@ -1,6 +1,5 @@
 /**
- * Laravel Eloquent strictness + touching guards.
- * @see Illuminate\Database\Eloquent\Model::preventLazyLoading
+ * Model strictness + touching guards.
  * @see Model::preventSilentlyDiscardingAttributes
  * @see Model::preventAccessingMissingAttributes
  * @see Model::shouldBeStrict
@@ -29,7 +28,7 @@ export declare function shouldBeStrict(should?: boolean): void;
 export declare function resetModelStrictnessForTests(): void;
 export declare function isIgnoringTouch(modelClass?: object): boolean;
 /**
- * Run without touching parent timestamps (Laravel `Model::withoutTouching`).
+ * Run without touching parent timestamps (`Model::withoutTouching`).
  * Pass model classes to limit the ignore set; omit to ignore all models.
  */
 export declare function withoutTouching<T>(modelsOrCallback: object[] | (() => T | Promise<T>), callback?: () => T | Promise<T>): Promise<T>;

package/dist/model-strictness.js

@@ -1,6 +1,5 @@
 /**
- * Laravel Eloquent strictness + touching guards.
- * @see Illuminate\Database\Eloquent\Model::preventLazyLoading
+ * Model strictness + touching guards.
  * @see Model::preventSilentlyDiscardingAttributes
  * @see Model::preventAccessingMissingAttributes
  * @see Model::shouldBeStrict
@@ -83,7 +82,7 @@ export function isIgnoringTouch(modelClass) {
     return ignoringTouchModels.has(modelClass);
 }
 /**
- * Run without touching parent timestamps (Laravel `Model::withoutTouching`).
+ * Run without touching parent timestamps (`Model::withoutTouching`).
  * Pass model classes to limit the ignore set; omit to ignore all models.
  */
 export async function withoutTouching(modelsOrCallback, callback) {