@warlock.js/cascade 4.0.162 → 4.0.164

package/cjs/utils/once-connected.js

@@ -0,0 +1,251 @@
+'use strict';var dataSourceRegistry=require('../data-source/data-source-registry.js');/**
+ * Execute a callback once the driver is connected.
+ *
+ * If the driver is already connected, the callback is executed immediately.
+ * Otherwise, it waits for the "connected" event.
+ *
+ * **Use Case:**
+ * Useful for ensuring database-dependent operations only run after connection
+ * is established, especially in small to medium projects with a single data source.
+ *
+ * @param dataSourceOrNameOrCallback - Data source instance, name, or callback function
+ * @param callback - Function to execute once connected (optional if first param is callback)
+ *
+ * @example
+ * ```typescript
+ * // With default data source (just callback)
+ * await connectToDatabase({ database: "myapp" });
+ *
+ * onceConnected((ds) => {
+ *   console.log("Database is ready!");
+ *   console.log("Connected to:", ds.name);
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With data source name
+ * onceConnected("primary", (ds) => {
+ *   console.log("Primary database is ready!");
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With data source instance
+ * const dataSource = await connectToDatabase({ database: "myapp" });
+ *
+ * onceConnected(dataSource, (ds) => {
+ *   console.log("Database is ready!");
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With driver instance
+ * const driver = new MongoDbDriver(config);
+ * const dataSource = new DataSource({ name: "primary", driver });
+ *
+ * onceConnected(dataSource, () => {
+ *   // Start application server
+ *   app.listen(3000);
+ * });
+ *
+ * // Connect after setting up the callback
+ * await driver.connect();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Chaining operations
+ * onceConnected(async (ds) => {
+ *   // Seed database
+ *   await seedDatabase();
+ *
+ *   // Run migrations
+ *   await runMigrations();
+ *
+ *   console.log("Database ready!");
+ * });
+ * ```
+ */
+function onceConnected(dataSourceOrNameOrCallback, callback) {
+    // Determine if first parameter is a callback
+    let targetDataSource;
+    let actualCallback;
+    if (typeof dataSourceOrNameOrCallback === "function") {
+        // First param is callback, use default data source
+        actualCallback = dataSourceOrNameOrCallback;
+        targetDataSource = "default";
+    }
+    else {
+        // First param is data source name or instance
+        if (!callback) {
+            throw new Error("Callback is required when providing a data source name or instance.");
+        }
+        actualCallback = callback;
+        targetDataSource = dataSourceOrNameOrCallback;
+    }
+    // Try to get the data source if it's a string
+    let resolvedDataSource;
+    if (typeof targetDataSource === "string") {
+        try {
+            resolvedDataSource =
+                targetDataSource === "default"
+                    ? dataSourceRegistry.dataSourceRegistry.get()
+                    : dataSourceRegistry.dataSourceRegistry.get(targetDataSource);
+        }
+        catch {
+            // Data source not registered yet, will wait for event
+        }
+    }
+    else {
+        resolvedDataSource = targetDataSource;
+    }
+    // If data source is resolved and already connected, fire immediately
+    if (resolvedDataSource && resolvedDataSource.driver.isConnected) {
+        actualCallback(resolvedDataSource);
+        return;
+    }
+    // Otherwise, wait for the connected event
+    const listener = (ds) => {
+        const matches = typeof targetDataSource === "string"
+            ? targetDataSource === "default"
+                ? ds.isDefault
+                : ds.name === targetDataSource
+            : ds === targetDataSource;
+        if (matches) {
+            // Remove the listener once our condition is met
+            dataSourceRegistry.dataSourceRegistry.off("connected", listener);
+            actualCallback(ds);
+        }
+        // If it doesn't match, we do nothing and just wait for the next "connected" event targeting our DB
+    };
+    dataSourceRegistry.dataSourceRegistry.on("connected", listener);
+}
+/**
+ * Execute a callback once the driver is disconnected.
+ *
+ * If the driver is already disconnected, the callback is executed immediately.
+ * Otherwise, it waits for the "disconnected" event.
+ *
+ * **Use Case:**
+ * Useful for cleanup operations, graceful shutdown, or reconnection logic.
+ *
+ * @param dataSourceOrNameOrCallback - Data source instance, name, or callback function
+ * @param callback - Function to execute once disconnected (optional if first param is callback)
+ *
+ * @example
+ * ```typescript
+ * // With default data source (just callback)
+ * await connectToDatabase({ database: "myapp" });
+ *
+ * onceDisconnected((ds) => {
+ *   console.log("Database disconnected!");
+ *   console.log("Attempting reconnection...");
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With data source name
+ * onceDisconnected("primary", (ds) => {
+ *   console.log("Primary database disconnected!");
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With data source instance
+ * const dataSource = await connectToDatabase({ database: "myapp" });
+ *
+ * onceDisconnected(dataSource, (ds) => {
+ *   console.log("Database disconnected!");
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Graceful shutdown with default data source
+ * process.on("SIGTERM", async () => {
+ *   console.log("Shutting down...");
+ *
+ *   onceDisconnected(() => {
+ *     console.log("Database closed, exiting process");
+ *     process.exit(0);
+ *   });
+ *
+ *   const dataSource = DataSourceRegistry.getDefault();
+ *   await dataSource?.driver.disconnect();
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Cleanup resources on disconnect
+ * onceDisconnected(async (ds) => {
+ *   // Close file handles
+ *   await closeFileHandles();
+ *
+ *   // Clear caches
+ *   clearCaches();
+ *
+ *   console.log("Cleanup complete");
+ * });
+ * ```
+ */
+function onceDisconnected(dataSourceOrNameOrCallback, callback) {
+    // Determine if first parameter is a callback
+    let targetDataSource;
+    let actualCallback;
+    if (typeof dataSourceOrNameOrCallback === "function") {
+        // First param is callback, use default data source
+        actualCallback = dataSourceOrNameOrCallback;
+        targetDataSource = "default";
+    }
+    else {
+        // First param is data source name or instance
+        if (!callback) {
+            throw new Error("Callback is required when providing a data source name or instance.");
+        }
+        actualCallback = callback;
+        targetDataSource = dataSourceOrNameOrCallback;
+    }
+    // Try to get the data source if it's a string
+    let resolvedDataSource;
+    if (typeof targetDataSource === "string") {
+        try {
+            resolvedDataSource =
+                targetDataSource === "default"
+                    ? dataSourceRegistry.dataSourceRegistry.get()
+                    : dataSourceRegistry.dataSourceRegistry.get(targetDataSource);
+        }
+        catch {
+            // Data source not registered yet, will wait for event
+        }
+    }
+    else {
+        resolvedDataSource = targetDataSource;
+    }
+    // If data source is resolved and already disconnected, fire immediately
+    if (resolvedDataSource && !resolvedDataSource.driver.isConnected) {
+        actualCallback(resolvedDataSource);
+        return;
+    }
+    // Otherwise, wait for the disconnected event
+    const listener = (ds) => {
+        const matches = typeof targetDataSource === "string"
+            ? targetDataSource === "default"
+                ? ds.isDefault
+                : ds.name === targetDataSource
+            : ds === targetDataSource;
+        if (matches) {
+            actualCallback(ds);
+        }
+        else {
+            // Not the one we're looking for, keep listening
+            dataSourceRegistry.dataSourceRegistry.once("disconnected", listener);
+        }
+    };
+    dataSourceRegistry.dataSourceRegistry.once("disconnected", listener);
+}exports.onceConnected=onceConnected;exports.onceDisconnected=onceDisconnected;//# sourceMappingURL=once-connected.js.map

package/cjs/utils/once-connected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"once-connected.js","sources":["../../src/utils/once-connected.ts"],"sourcesContent":[null],"names":["dataSourceRegistry"],"mappings":"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"}

package/cjs/validation/database-seal-plugins.d.ts

@@ -0,0 +1,12 @@
+import { embedValidator } from "./plugins/embed-validator-plugin";
+/**
+ * This file registers database seal plugins as a side effect.
+ * Import this file to ensure the plugins are registered.
+ *
+ * @example
+ * ```ts
+ * import "./validation/database-seal-plugins";
+ * ```
+ */
+export type DatabaseSealPlugins = typeof embedValidator;
+//# sourceMappingURL=database-seal-plugins.d.ts.map

package/cjs/validation/database-seal-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-seal-plugins.d.ts","sourceRoot":"","sources":["../../src/validation/database-seal-plugins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIlE;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC"}

package/cjs/validation/database-seal-plugins.js

@@ -0,0 +1 @@
+'use strict';var seal=require('@warlock.js/seal'),embedValidatorPlugin=require('./plugins/embed-validator-plugin.js');seal.registerPlugin(embedValidatorPlugin.embedValidator);//# sourceMappingURL=database-seal-plugins.js.map

package/cjs/validation/database-seal-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-seal-plugins.js","sources":["../../src/validation/database-seal-plugins.ts"],"sourcesContent":[null],"names":["registerPlugin","embedValidator"],"mappings":"sHAGAA,mBAAc,CAACC,mCAAc,CAAC"}

package/cjs/validation/database-writer-validation-error.d.ts

@@ -0,0 +1,97 @@
+import type { ValidationResult } from "@warlock.js/seal";
+/**
+ * Error thrown when model validation fails during database write operations.
+ *
+ * Contains detailed information about all validation errors,
+ * including field paths, error messages, and validation rules that failed.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const user = new User({ name: "", age: -5 });
+ *   await user.save();
+ * } catch (error) {
+ *   if (error instanceof DatabaseWriterValidationError) {
+ *     console.log(error.message); // "Validation failed"
+ *     console.log(error.errors);
+ *     // [
+ *     //   { path: "name", error: "name is required", rule: "required" },
+ *     //   { path: "age", error: "age must be at least 0", rule: "min" }
+ *     // ]
+ *   }
+ * }
+ * ```
+ */
+export declare class DatabaseWriterValidationError extends Error {
+    /**
+     * Array of validation errors from @warlock.js/seal.
+     *
+     * Each error contains:
+     * - `path`: Dot-notation path to the field (e.g., "address.city")
+     * - `error`: Human-readable error message
+     * - `rule`: The validation rule that failed (e.g., "required", "email")
+     * - Additional context depending on the rule
+     */
+    readonly errors: ValidationResult["errors"];
+    /**
+     * Create a new DatabaseWriterValidationError.
+     *
+     * @param message - Error message (typically "Validation failed")
+     * @param errors - Array of validation errors from seal
+     *
+     * @example
+     * ```typescript
+     * const error = new DatabaseWriterValidationError("Validation failed", [
+     *   { path: "email", error: "email must be valid", rule: "email" }
+     * ]);
+     * ```
+     */
+    constructor(message: string, errors: ValidationResult["errors"]);
+    /**
+     * Get a formatted string representation of all validation errors.
+     *
+     * Provides beautiful, colored terminal output with clear field-by-field breakdown.
+     *
+     * @returns Multi-line string with all errors, formatted for terminal
+     *
+     * @example
+     * ```typescript
+     * console.log(error.toString());
+     * // ❌ Validation Error: UserModel
+     * //
+     * //   Field: email
+     * //   Error: Email already exists
+     * //   Value: "john@example.com"
+     * ```
+     */
+    toString(): string;
+    /**
+     * Get validation errors for a specific field.
+     *
+     * @param fieldPath - Dot-notation path to the field
+     * @returns Array of errors for that field
+     *
+     * @example
+     * ```typescript
+     * const emailErrors = error.getFieldErrors("email");
+     * console.log(emailErrors);
+     * // [{ path: "email", error: "email must be valid", rule: "email" }]
+     * ```
+     */
+    getFieldErrors(fieldPath: string): ValidationResult["errors"];
+    /**
+     * Check if a specific field has validation errors.
+     *
+     * @param fieldPath - Dot-notation path to the field
+     * @returns True if the field has errors
+     *
+     * @example
+     * ```typescript
+     * if (error.hasFieldError("email")) {
+     *   console.log("Email is invalid");
+     * }
+     * ```
+     */
+    hasFieldError(fieldPath: string): boolean;
+}
+//# sourceMappingURL=database-writer-validation-error.d.ts.map

package/cjs/validation/database-writer-validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-writer-validation-error.d.ts","sourceRoot":"","sources":["../../src/validation/database-writer-validation-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD;;;;;;;;OAQG;IACH,SAAgB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEnD;;;;;;;;;;;;OAYG;gBACgB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IAyBtE;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,IAAI,MAAM;IAqDzB;;;;;;;;;;;;OAYG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAIpE;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGjD"}

package/cjs/validation/database-writer-validation-error.js

@@ -0,0 +1,160 @@
+'use strict';var copper=require('@mongez/copper');/**
+ * Error thrown when model validation fails during database write operations.
+ *
+ * Contains detailed information about all validation errors,
+ * including field paths, error messages, and validation rules that failed.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const user = new User({ name: "", age: -5 });
+ *   await user.save();
+ * } catch (error) {
+ *   if (error instanceof DatabaseWriterValidationError) {
+ *     console.log(error.message); // "Validation failed"
+ *     console.log(error.errors);
+ *     // [
+ *     //   { path: "name", error: "name is required", rule: "required" },
+ *     //   { path: "age", error: "age must be at least 0", rule: "min" }
+ *     // ]
+ *   }
+ * }
+ * ```
+ */
+class DatabaseWriterValidationError extends Error {
+    /**
+     * Array of validation errors from @warlock.js/seal.
+     *
+     * Each error contains:
+     * - `path`: Dot-notation path to the field (e.g., "address.city")
+     * - `error`: Human-readable error message
+     * - `rule`: The validation rule that failed (e.g., "required", "email")
+     * - Additional context depending on the rule
+     */
+    errors;
+    /**
+     * Create a new DatabaseWriterValidationError.
+     *
+     * @param message - Error message (typically "Validation failed")
+     * @param errors - Array of validation errors from seal
+     *
+     * @example
+     * ```typescript
+     * const error = new DatabaseWriterValidationError("Validation failed", [
+     *   { path: "email", error: "email must be valid", rule: "email" }
+     * ]);
+     * ```
+     */
+    constructor(message, errors) {
+        super(message);
+        this.name = "DatabaseWriterValidationError";
+        this.errors = errors;
+        // Maintain proper stack trace for where error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DatabaseWriterValidationError);
+        }
+        // Override Node.js inspect to use our formatted output
+        Object.defineProperty(this, "inspect", {
+            value: () => this.toString(),
+            enumerable: false,
+        });
+    }
+    /**
+     * Custom inspect method for Node.js console output.
+     * This makes console.log and error logging use our beautiful format.
+     */
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return this.toString();
+    }
+    /**
+     * Get a formatted string representation of all validation errors.
+     *
+     * Provides beautiful, colored terminal output with clear field-by-field breakdown.
+     *
+     * @returns Multi-line string with all errors, formatted for terminal
+     *
+     * @example
+     * ```typescript
+     * console.log(error.toString());
+     * // ❌ Validation Error: UserModel
+     * //
+     * //   Field: email
+     * //   Error: Email already exists
+     * //   Value: "john@example.com"
+     * ```
+     */
+    toString() {
+        // Extract model name from message (e.g., "[UserModel Model]")
+        const modelMatch = this.message.match(/\[(\w+)\s+Model\]/);
+        const modelName = modelMatch ? modelMatch[1] : "Model";
+        const operation = this.message.includes("Insert") ? "Insert" : "Update";
+        // Build header
+        const lines = [];
+        lines.push("");
+        lines.push(copper.colors.red(`❌ Validation Error: ${modelName} (${operation})`));
+        lines.push("");
+        // Group errors by field for better readability
+        const errorsByField = new Map();
+        for (const err of this.errors) {
+            const fieldName = err.input || "unknown";
+            if (!errorsByField.has(fieldName)) {
+                errorsByField.set(fieldName, []);
+            }
+            errorsByField.get(fieldName).push({
+                error: err.error,
+                type: err.type,
+                value: err.value,
+            });
+        }
+        // Format each field's errors
+        for (const [fieldName, fieldErrors] of errorsByField) {
+            lines.push(copper.colors.yellow(`  Field: ${fieldName}`));
+            for (const fieldError of fieldErrors) {
+                lines.push(copper.colors.white(`  Error: ${fieldError.error}`));
+                if (fieldError.value !== undefined) {
+                    const valueStr = typeof fieldError.value === "string"
+                        ? `"${fieldError.value}"`
+                        : JSON.stringify(fieldError.value);
+                    lines.push(copper.colors.gray(`  Value: ${valueStr}`));
+                }
+                if (fieldError.type) {
+                    lines.push(copper.colors.cyan(`  Type:  ${fieldError.type}`));
+                }
+            }
+            lines.push(""); // Blank line between fields
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Get validation errors for a specific field.
+     *
+     * @param fieldPath - Dot-notation path to the field
+     * @returns Array of errors for that field
+     *
+     * @example
+     * ```typescript
+     * const emailErrors = error.getFieldErrors("email");
+     * console.log(emailErrors);
+     * // [{ path: "email", error: "email must be valid", rule: "email" }]
+     * ```
+     */
+    getFieldErrors(fieldPath) {
+        return this.errors.filter((err) => err.input === fieldPath);
+    }
+    /**
+     * Check if a specific field has validation errors.
+     *
+     * @param fieldPath - Dot-notation path to the field
+     * @returns True if the field has errors
+     *
+     * @example
+     * ```typescript
+     * if (error.hasFieldError("email")) {
+     *   console.log("Email is invalid");
+     * }
+     * ```
+     */
+    hasFieldError(fieldPath) {
+        return this.errors.some((err) => err.input === fieldPath);
+    }
+}exports.DatabaseWriterValidationError=DatabaseWriterValidationError;//# sourceMappingURL=database-writer-validation-error.js.map

package/cjs/validation/database-writer-validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-writer-validation-error.js","sources":["../../src/validation/database-writer-validation-error.ts"],"sourcesContent":[null],"names":["colors"],"mappings":"kDAGA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACG,MAAO,6BAA8B,SAAQ,KAAK,CAAA;AACtD;;;;;;;;AAQG;AACa,IAAA,MAAM,CAA6B;AAEnD;;;;;;;;;;;;AAYG;IACH,WAAmB,CAAA,OAAe,EAAE,MAAkC,EAAA;QACpE,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;AAC5C,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;;QAGrB,IAAI,KAAK,CAAC,iBAAiB,EAAE;AAC3B,YAAA,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;AAC9D,SAAA;;AAGD,QAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE;AACrC,YAAA,KAAK,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE;AAC5B,YAAA,UAAU,EAAE,KAAK;AAClB,SAAA,CAAC,CAAC;KACJ;AAED;;;AAGG;AACH,IAAA,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,GAAA;AACxC,QAAA,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;KACxB;AAED;;;;;;;;;;;;;;;;AAgBG;IACI,QAAQ,GAAA;;QAEb,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAC3D,QAAA,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AACvD,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAAC;;QAGxE,MAAM,KAAK,GAAa,EAAE,CAAC;AAC3B,QAAA,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACf,QAAA,KAAK,CAAC,IAAI,CAACA,aAAM,CAAC,GAAG,CAAC,CAAuB,oBAAA,EAAA,SAAS,CAAK,EAAA,EAAA,SAAS,CAAG,CAAA,CAAA,CAAC,CAAC,CAAC;AAC1E,QAAA,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;AAGf,QAAA,MAAM,aAAa,GAAG,IAAI,GAAG,EAAgE,CAAC;AAE9F,QAAA,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE;AAC7B,YAAA,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC;AACzC,YAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AACjC,gBAAA,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAClC,aAAA;AACD,YAAA,aAAa,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC;gBACjC,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAG,GAAW,CAAC,KAAK;AAC1B,aAAA,CAAC,CAAC;AACJ,SAAA;;QAGD,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,aAAa,EAAE;AACpD,YAAA,KAAK,CAAC,IAAI,CAACA,aAAM,CAAC,MAAM,CAAC,CAAA,SAAA,EAAY,SAAS,CAAA,CAAE,CAAC,CAAC,CAAC;AAEnD,YAAA,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE;AACpC,gBAAA,KAAK,CAAC,IAAI,CAACA,aAAM,CAAC,KAAK,CAAC,CAAY,SAAA,EAAA,UAAU,CAAC,KAAK,CAAE,CAAA,CAAC,CAAC,CAAC;AAEzD,gBAAA,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE;AAClC,oBAAA,MAAM,QAAQ,GACZ,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ;AAClC,0BAAE,CAAA,CAAA,EAAI,UAAU,CAAC,KAAK,CAAG,CAAA,CAAA;0BACvB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACvC,oBAAA,KAAK,CAAC,IAAI,CAACA,aAAM,CAAC,IAAI,CAAC,CAAA,SAAA,EAAY,QAAQ,CAAA,CAAE,CAAC,CAAC,CAAC;AACjD,iBAAA;gBAED,IAAI,UAAU,CAAC,IAAI,EAAE;AACnB,oBAAA,KAAK,CAAC,IAAI,CAACA,aAAM,CAAC,IAAI,CAAC,CAAY,SAAA,EAAA,UAAU,CAAC,IAAI,CAAE,CAAA,CAAC,CAAC,CAAC;AACxD,iBAAA;AACF,aAAA;AAED,YAAA,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChB,SAAA;AAED,QAAA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACzB;AAED;;;;;;;;;;;;AAYG;AACI,IAAA,cAAc,CAAC,SAAiB,EAAA;AACrC,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;KAC7D;AAED;;;;;;;;;;;;AAYG;AACI,IAAA,aAAa,CAAC,SAAiB,EAAA;AACpC,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;KAC3D;AACF"}

package/cjs/validation/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./database-writer-validation-error";
+import "./database-seal-plugins";
+//# sourceMappingURL=index.d.ts.map

package/cjs/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,OAAO,yBAAyB,CAAC"}

package/cjs/validation/mutators/embed-mutator.d.ts

@@ -0,0 +1,9 @@
+import type { Mutator } from "@warlock.js/seal";
+import { ChildModel } from "../../model/model";
+type DatabaseModelMutatorOptions = {
+    model: ChildModel<any> | string;
+};
+export declare const databaseModelMutator: Mutator<DatabaseModelMutatorOptions>;
+export declare const databaseModelsMutator: Mutator<DatabaseModelMutatorOptions>;
+export {};
+//# sourceMappingURL=embed-mutator.d.ts.map

package/cjs/validation/mutators/embed-mutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-mutator.d.ts","sourceRoot":"","sources":["../../../src/validation/mutators/embed-mutator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAS,MAAM,mBAAmB,CAAC;AAGtD,KAAK,2BAA2B,GAAG;IACjC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,2BAA2B,CAuBrE,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,2BAA2B,CAsBtE,CAAC"}

package/cjs/validation/mutators/embed-mutator.js

@@ -0,0 +1,33 @@
+'use strict';var model=require('../../model/model.js'),registerModel=require('../../model/register-model.js');const databaseModelMutator = async (value, context) => {
+    let { model: ModelClass } = context?.options || {};
+    if (typeof ModelClass === "string") {
+        ModelClass = registerModel.getModelFromRegistry(ModelClass);
+    }
+    if (!ModelClass) {
+        throw new Error(`Model ${ModelClass} not found in registry`);
+    }
+    if (value instanceof model.Model)
+        return value;
+    if (typeof value === "object" && value?.id) {
+        value = Number(value.id);
+    }
+    if (typeof value !== "number")
+        return value;
+    return await ModelClass.find(value);
+};
+const databaseModelsMutator = async (value, context) => {
+    if (!Array.isArray(value))
+        return value;
+    let { model: ModelClass } = context?.options || {};
+    if (typeof ModelClass === "string") {
+        ModelClass = registerModel.getModelFromRegistry(ModelClass);
+    }
+    if (!ModelClass) {
+        throw new Error(`Model ${ModelClass} not found in registry`);
+    }
+    // first, if all values are list of models, then return them.
+    if (value.every((item) => item instanceof model.Model))
+        return value;
+    const ids = value.map((item) => item?.id || item).filter((item) => item !== undefined);
+    return await ModelClass.query().whereIn("id", ids).get();
+};exports.databaseModelMutator=databaseModelMutator;exports.databaseModelsMutator=databaseModelsMutator;//# sourceMappingURL=embed-mutator.js.map

package/cjs/validation/mutators/embed-mutator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-mutator.js","sources":["../../../src/validation/mutators/embed-mutator.ts"],"sourcesContent":[null],"names":["getModelFromRegistry","Model"],"mappings":"8GAQa,MAAA,oBAAoB,GAAyC,OACxE,KAAK,EACL,OAAO,KACL;IACF,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;AAEnD,IAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAClC,QAAA,UAAU,GAAGA,kCAAoB,CAAC,UAAU,CAAE,CAAC;AAChD,KAAA;IAED,IAAI,CAAC,UAAU,EAAE;AACf,QAAA,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,CAAA,sBAAA,CAAwB,CAAC,CAAC;AAC9D,KAAA;IAED,IAAI,KAAK,YAAYC,WAAK;AAAE,QAAA,OAAO,KAAK,CAAC;IAEzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,EAAE,EAAE;AAC1C,QAAA,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC1B,KAAA;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAE,QAAA,OAAO,KAAK,CAAC;AAE5C,IAAA,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtC,EAAE;AAEW,MAAA,qBAAqB,GAAyC,OACzE,KAAK,EACL,OAAO,KACL;AACF,IAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC;IAExC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;AAEnD,IAAA,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;AAClC,QAAA,UAAU,GAAGD,kCAAoB,CAAC,UAAU,CAAE,CAAC;AAChD,KAAA;IAED,IAAI,CAAC,UAAU,EAAE;AACf,QAAA,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,CAAA,sBAAA,CAAwB,CAAC,CAAC;AAC9D,KAAA;;AAGD,IAAA,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAYC,WAAK,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC;AAE/D,IAAA,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,KAAK,SAAS,CAAC,CAAC;AAEvF,IAAA,OAAO,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;AAC3D"}

package/cjs/validation/plugins/embed-validator-plugin.d.ts

@@ -0,0 +1,24 @@
+/**
+ * File Validator Plugin
+ *
+ * Adds file validation to Seal v factory
+ */
+import type { SealPlugin } from "@warlock.js/seal";
+import type { ChildModel } from "../../model/model";
+import { EmbedModelValidator } from "../validators/embed-validator";
+type EmbedOptions = {
+    errorMessage?: string;
+    embed?: string | string[];
+};
+declare module "@warlock.js/seal" {
+    interface ValidatorV {
+        embed(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;
+        embedMany(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;
+    }
+}
+/**
+ * File validation plugin for Seal
+ */
+export declare const embedValidator: SealPlugin;
+export {};
+//# sourceMappingURL=embed-validator-plugin.d.ts.map

package/cjs/validation/plugins/embed-validator-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-validator-plugin.d.ts","sourceRoot":"","sources":["../../../src/validation/plugins/embed-validator-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,KAAK,YAAY,GAAG;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAU,UAAU;QAClB,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,mBAAmB,CAAC;QACpF,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,mBAAmB,CAAC;KACzF;CACF;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAY5B,CAAC"}

package/cjs/validation/plugins/embed-validator-plugin.js

@@ -0,0 +1,18 @@
+'use strict';var seal=require('@warlock.js/seal'),embedValidator$1=require('../validators/embed-validator.js');/**
+ * File Validator Plugin
+ *
+ * Adds file validation to Seal v factory
+ */
+/**
+ * File validation plugin for Seal
+ */
+const embedValidator = {
+    name: "embed",
+    version: "1.0.0",
+    description: "Adds file upload validation (v.file())",
+    install() {
+        // Inject file() method into v factory
+        seal.v.embed = (model, options) => new embedValidator$1.EmbedModelValidator().model(model).embed(options?.embed);
+        seal.v.embedMany = (model, options) => new embedValidator$1.EmbedModelValidator().models(model).embed(options?.embed);
+    },
+};exports.embedValidator=embedValidator;//# sourceMappingURL=embed-validator-plugin.js.map

package/cjs/validation/plugins/embed-validator-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-validator-plugin.js","sources":["../../../src/validation/plugins/embed-validator-plugin.ts"],"sourcesContent":[null],"names":["v","EmbedModelValidator"],"mappings":"+GAAA;;;;AAIG;AAmBH;;AAEG;AACU,MAAA,cAAc,GAAe;AACxC,IAAA,IAAI,EAAE,OAAO;AACb,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,WAAW,EAAE,wCAAwC;IAErD,OAAO,GAAA;;QAELA,MAAC,CAAC,KAAK,GAAG,CAAC,KAA+B,EAAE,OAAsB,KAChE,IAAIC,oCAAmB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/DD,MAAC,CAAC,SAAS,GAAG,CAAC,KAA+B,EAAE,OAAsB,KACpE,IAAIC,oCAAmB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;KACjE;"}