@warlock.js/cascade 4.0.162 → 4.0.163

package/esm/validation/rules/database-model-rule.d.ts

@@ -0,0 +1,7 @@
+import { type SchemaRule } from "@warlock.js/seal";
+import { ChildModel } from "./../../model/model";
+export declare const databaseModelRule: SchemaRule;
+export declare const databaseModelsRule: SchemaRule<{
+    model: ChildModel<any> | string;
+}>;
+//# sourceMappingURL=database-model-rule.d.ts.map

package/esm/validation/rules/database-model-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-model-rule.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/database-model-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAS,MAAM,qBAAqB,CAAC;AAGxD,eAAO,MAAM,iBAAiB,EAAE,UAW/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,UAAU,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;CAAE,CAiB9E,CAAC"}

package/esm/validation/rules/database-model-rule.js

@@ -0,0 +1,27 @@
+import {invalidRule,VALID_RULE}from'@warlock.js/seal';import {Model}from'../../model/model.js';import {getModelFromRegistry}from'../../model/register-model.js';const databaseModelRule = {
+    name: "databaseModule",
+    defaultErrorMessage: "The :input must be a valid :model model",
+    async validate(value, context) {
+        if (value instanceof Model === false) {
+            this.context.attributesList.model = this.context.options.model?.name;
+            return invalidRule(this, context);
+        }
+        return VALID_RULE;
+    },
+};
+const databaseModelsRule = {
+    name: "databaseModels",
+    defaultErrorMessage: "The :input must be a list of valid :model",
+    async validate(value, context) {
+        let { model } = this.context.options;
+        if (typeof model === "string") {
+            model = getModelFromRegistry(model);
+        }
+        this.context.attributesList.model = model.name;
+        if (!Array.isArray(value))
+            return invalidRule(this, context);
+        if (value.every((item) => item instanceof Model))
+            return VALID_RULE;
+        return invalidRule(this, context);
+    },
+};export{databaseModelRule,databaseModelsRule};//# sourceMappingURL=database-model-rule.js.map

package/esm/validation/rules/database-model-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-model-rule.js","sources":["../../../src/validation/rules/database-model-rule.ts"],"sourcesContent":[null],"names":[],"mappings":"gKAIa,MAAA,iBAAiB,GAAe;AAC3C,IAAA,IAAI,EAAE,gBAAgB;AACtB,IAAA,mBAAmB,EAAE,yCAAyC;AAC9D,IAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAA;AAC3B,QAAA,IAAI,KAAK,YAAY,KAAK,KAAK,KAAK,EAAE;AACpC,YAAA,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;AACrE,YAAA,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,SAAA;AAED,QAAA,OAAO,UAAU,CAAC;KACnB;EACD;AAEW,MAAA,kBAAkB,GAAoD;AACjF,IAAA,IAAI,EAAE,gBAAgB;AACtB,IAAA,mBAAmB,EAAE,2CAA2C;AAChE,IAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAA;QAC3B,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;AACrC,QAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,YAAA,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAE,CAAC;AACtC,SAAA;QAED,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;AAE/C,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,YAAA,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAE7D,QAAA,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAY,KAAK,CAAC;AAAE,YAAA,OAAO,UAAU,CAAC;AAEpE,QAAA,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;KACnC;"}

package/esm/validation/transformers/embed-model-transformer.d.ts

@@ -0,0 +1,3 @@
+import { type TransformerCallback } from "@warlock.js/seal";
+export declare const databaseModelTransformer: TransformerCallback;
+//# sourceMappingURL=embed-model-transformer.d.ts.map

package/esm/validation/transformers/embed-model-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-model-transformer.d.ts","sourceRoot":"","sources":["../../../src/validation/transformers/embed-model-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,eAAO,MAAM,wBAAwB,EAAE,mBAsBtC,CAAC"}

package/esm/validation/transformers/embed-model-transformer.js

@@ -0,0 +1,18 @@
+import {Model}from'../../model/model.js';const databaseModelTransformer = (value, context) => {
+    const embed = context.options.embed ?? "embedData";
+    if (value instanceof Model === false && !Array.isArray(value)) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => {
+            if (typeof embed === "string") {
+                return item[embed];
+            }
+            return item.only(embed);
+        });
+    }
+    if (typeof embed === "string") {
+        return value[embed];
+    }
+    return value.only(embed);
+};export{databaseModelTransformer};//# sourceMappingURL=embed-model-transformer.js.map

package/esm/validation/transformers/embed-model-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-model-transformer.js","sources":["../../../src/validation/transformers/embed-model-transformer.ts"],"sourcesContent":[null],"names":[],"mappings":"+CAGa,wBAAwB,GAAwB,CAAC,KAAK,EAAE,OAAO,KAAI;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;AAEnD,IAAA,IAAI,KAAK,YAAY,KAAK,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AAC7D,QAAA,OAAO,KAAK,CAAC;AACd,KAAA;AAED,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACxB,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAI;AACxB,YAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,gBAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AACpB,aAAA;AAED,YAAA,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,SAAC,CAAC,CAAC;AACJ,KAAA;AAED,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,QAAA,OAAQ,KAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,KAAA;AAED,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B"}

package/esm/validation/validators/embed-validator.d.ts

@@ -0,0 +1,21 @@
+import { BaseValidator } from "@warlock.js/seal";
+import { type ChildModel } from "../../model/model";
+export declare class EmbedModelValidator extends BaseValidator {
+    /**
+     * Check if value is a string type
+     */
+    matchesType(value: any): boolean;
+    /**
+     * Mutate the value to be a model, also fail if the mutated value is not a valid model
+     */
+    model(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator;
+    /**
+     * Validate the value is a list of models
+     */
+    models(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator;
+    /**
+     * Determine how the data will be stored as an embedded document
+     */
+    embed(embed?: string | string[]): EmbedModelValidator;
+}
+//# sourceMappingURL=embed-validator.d.ts.map

package/esm/validation/validators/embed-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/embed-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK3D,qBAAa,mBAAoB,SAAQ,aAAa;IACpD;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAQvC;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAUzF;;OAEG;IACI,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAc1F;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,mBAAmB;CAK7D"}

package/esm/validation/validators/embed-validator.js

@@ -0,0 +1,43 @@
+import {BaseValidator,arrayRule}from'@warlock.js/seal';import {Model}from'../../model/model.js';import {databaseModelMutator,databaseModelsMutator}from'../mutators/embed-mutator.js';import {databaseModelRule,databaseModelsRule}from'../rules/database-model-rule.js';import {databaseModelTransformer}from'../transformers/embed-model-transformer.js';class EmbedModelValidator extends BaseValidator {
+    /**
+     * Check if value is a string type
+     */
+    matchesType(value) {
+        return (value instanceof Model ||
+            typeof value === "number" ||
+            (Array.isArray(value) && value.every((item) => item instanceof Model)));
+    }
+    /**
+     * Mutate the value to be a model, also fail if the mutated value is not a valid model
+     */
+    model(model, errorMessage) {
+        this.addMutator(databaseModelMutator, {
+            model,
+        });
+        return this.addRule(databaseModelRule, errorMessage, {
+            model,
+        });
+    }
+    /**
+     * Validate the value is a list of models
+     */
+    models(model, errorMessage) {
+        const instance = this.instance;
+        instance.addMutator(databaseModelsMutator, {
+            model,
+        });
+        instance.addMutableRule(arrayRule);
+        instance.addMutableRule(databaseModelsRule, errorMessage, {
+            model,
+        });
+        return instance;
+    }
+    /**
+     * Determine how the data will be stored as an embedded document
+     */
+    embed(embed) {
+        return this.addTransformer(databaseModelTransformer, {
+            embed,
+        });
+    }
+}export{EmbedModelValidator};//# sourceMappingURL=embed-validator.js.map

package/esm/validation/validators/embed-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-validator.js","sources":["../../../src/validation/validators/embed-validator.ts"],"sourcesContent":[null],"names":[],"mappings":"2VAMM,MAAO,mBAAoB,SAAQ,aAAa,CAAA;AACpD;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;QAC3B,QACE,KAAK,YAAY,KAAK;YACtB,OAAO,KAAK,KAAK,QAAQ;aACxB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAY,KAAK,CAAC,CAAC,EACtE;KACH;AAED;;AAEG;IACI,KAAK,CAAC,KAA+B,EAAE,YAAqB,EAAA;AACjE,QAAA,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE;YACpC,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,YAAY,EAAE;YACnD,KAAK;AACN,SAAA,CAAC,CAAC;KACJ;AAED;;AAEG;IACI,MAAM,CAAC,KAA+B,EAAE,YAAqB,EAAA;AAClE,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AAC/B,QAAA,QAAQ,CAAC,UAAU,CAAC,qBAAqB,EAAE;YACzC,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;AACnC,QAAA,QAAQ,CAAC,cAAc,CAAC,kBAAkB,EAAE,YAAY,EAAE;YACxD,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,OAAO,QAAQ,CAAC;KACjB;AAED;;AAEG;AACI,IAAA,KAAK,CAAC,KAAyB,EAAA;AACpC,QAAA,OAAO,IAAI,CAAC,cAAc,CAAC,wBAAwB,EAAE;YACnD,KAAK;AACN,SAAA,CAAC,CAAC;KACJ;AACF"}

package/esm/writer/database-writer.d.ts

@@ -0,0 +1,181 @@
+import type { WriterContract, WriterOptions, WriterResult } from "../contracts/database-writer.contract";
+import type { Model } from "../model/model";
+/**
+ * Database writer service that orchestrates model persistence.
+ *
+ * Handles the complete save pipeline:
+ * 1. Check for changes (skip if no changes and not new)
+ * 2. Emit `saving` event (for data enrichment)
+ * 3. Emit `validating` event
+ * 4. Validate and cast data via @warlock.js/seal schema
+ * 5. Emit `validated` event
+ * 6. Generate ID (for new NoSQL records)
+ * 7. Emit `creating`/`updating` events
+ * 8. Execute insert or update via driver
+ * 9. Merge returned data into model
+ * 10. Reset dirty tracker and update `isNew` flag
+ * 11. Emit `saved` and `created`/`updated` events
+ *
+ * @example
+ * ```typescript
+ * const user = new User({ name: "Alice", email: "alice@example.com" });
+ * const writer = new DatabaseWriter(user);
+ * await writer.save();
+ *
+ * console.log(user.get("id")); // 1 (auto-generated)
+ * console.log(user.get("_id")); // ObjectId("...")
+ *
+ * // Update existing record
+ * user.set("name", "Alice Smith");
+ * await writer.save();
+ * // Only updates the "name" field (partial update)
+ *
+ * // Silent save (no events)
+ * await writer.save({ skipEvents: true });
+ * ```
+ */
+export declare class DatabaseWriter implements WriterContract {
+    /** The model instance being persisted */
+    private readonly model;
+    /** Model constructor reference */
+    private readonly ctor;
+    /** Data source containing driver and ID generator */
+    private readonly dataSource;
+    /** Database driver for executing queries */
+    private readonly driver;
+    /** Table/collection name */
+    private readonly table;
+    /** Primary key field name */
+    private readonly primaryKey;
+    /** Validation schema (if defined) */
+    private readonly schema?;
+    /** Strict mode configuration */
+    private readonly strictMode;
+    /**
+     * Create a new writer instance for a model.
+     *
+     * @param model - The model instance to persist
+     *
+     * @example
+     * ```typescript
+     * const user = new User({ name: "Alice" });
+     * const writer = new DatabaseWriter(user);
+     * await writer.save();
+     * ```
+     */
+    constructor(model: Model);
+    /**
+     * Save the model instance to the database.
+     *
+     * @param options - Save options
+     * @returns Result with success status, document, and metadata
+     * @throws {ValidationError} If validation fails
+     */
+    save(options?: WriterOptions): Promise<WriterResult>;
+    /**
+     * Validate and cast model data using the schema.
+     *
+     * Updates the model's data in-place with validated/casted values.
+     *
+     * @param isInsert - Whether this is an insert operation
+     * @param options - Save options
+     * @throws {ValidationError} If validation fails
+     * @private
+     */
+    private validateAndCast;
+    /**
+     * Perform an insert operation.
+     *
+     * @param options - Save options
+     * @returns Insert result
+     * @private
+     */
+    private performInsert;
+    /**
+     * Perform an update operation.
+     *
+     * @param options - Save options
+     * @returns Update result
+     * @private
+     */
+    private performUpdate;
+    /**
+     * Generate ID for the model if auto-generation is enabled.
+     *
+     * @private
+     */
+    generateNextId(): Promise<void>;
+    /**
+     * Build update operations from the model's dirty tracker.
+     *
+     * Handles both modified fields ($set) and removed fields ($unset).
+     *
+     * @returns Update operations for the driver
+     * @private
+     *
+     * @example
+     * ```typescript
+     * // Model with changes
+     * user.set("name", "Alice");
+     * user.unset("tempField");
+     *
+     * const operations = this.buildUpdateOperations();
+     * // {
+     * //   $set: { name: "Alice" },
+     * //   $unset: { tempField: 1 }
+     * // }
+     * ```
+     */
+    private buildUpdateOperations;
+    /**
+     * Resolve the initial ID from model configuration.
+     *
+     * Priority:
+     * 1. Model.initialId (explicit value)
+     * 2. Model.randomInitialId (random or function)
+     * 3. Default: 1
+     *
+     * @returns The initial ID value
+     * @private
+     */
+    private resolveInitialId;
+    /**
+     * Resolve the increment value from model configuration.
+     *
+     * Priority:
+     * 1. Model.incrementIdBy (explicit value)
+     * 2. Model.randomIncrement (random or function)
+     * 3. Default: 1
+     *
+     * @returns The increment value
+     * @private
+     */
+    private resolveIncrementBy;
+    /**
+     * Generate a random integer between min and max (inclusive).
+     *
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @returns Random integer
+     * @private
+     */
+    private randomInt;
+    /**
+     * Trigger sync operations after successful save.
+     * Only syncs on updates (not creates) unless sync config specifies embedOnCreate.
+     *
+     * @param changedFields - Fields that were changed (for filtering)
+     * @private
+     */
+    /**
+     * Trigger sync operations after successful save.
+     *
+     * Emits a model.updated event that ModelSyncOperation listens to.
+     * The sync is handled by registered sync operations, not directly here.
+     *
+     * @param changedFields - Fields that were changed (for filtering)
+     * @private
+     */
+    private triggerSync;
+}
+//# sourceMappingURL=database-writer.d.ts.map

package/esm/writer/database-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-writer.d.ts","sourceRoot":"","sources":["../../src/writer/database-writer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAc,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAMxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IAEzC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB;IAE1C,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;;;;;;;;;;OAWG;gBACgB,KAAK,EAAE,KAAK;IAW/B;;;;;;OAMG;IACU,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0DrE;;;;;;;;;OASG;YACW,eAAe;IAgE7B;;;;;;OAMG;YACW,aAAa;IAyC3B;;;;;;OAMG;YACW,aAAa;IAsC3B;;;;OAIG;IACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;OAMG;IACH;;;;;;;;OAQG;YACW,WAAW;CAI1B"}