@warlock.js/cascade 4.0.157 → 4.0.158

package/cjs/drivers/sql/sql-types.d.ts

@@ -1,202 +0,0 @@
-/**
- * SQL Types and Definitions
- *
- * Shared type definitions used across SQL database drivers (PostgreSQL, MySQL, SQLite).
- * These types represent common SQL operations and their parameters.
- *
- * @module cascade/drivers/sql
- */
-/**
- * Result of building a SQL query with parameterized values.
- *
- * Contains the SQL string with placeholders and the corresponding parameter values.
- * This separation prevents SQL injection by ensuring values are properly escaped.
- */
-export type SqlQueryResult = {
-    /** The SQL query string with parameter placeholders ($1, $2, etc. or ?) */
-    readonly sql: string;
-    /** The parameter values in order matching the placeholders */
-    readonly params: unknown[];
-};
-/**
- * Supported SQL JOIN types.
- */
-export type SqlJoinType = "inner" | "left" | "right" | "full" | "cross";
-/**
- * SQL JOIN clause definition.
- *
- * Represents a JOIN between two tables with its condition.
- */
-export type SqlJoinClause = {
-    /** Type of JOIN operation */
-    readonly type: SqlJoinType;
-    /** Target table to join */
-    readonly table: string;
-    /** Optional alias for the joined table */
-    readonly alias?: string;
-    /** JOIN condition */
-    readonly on: {
-        /** Field from the left (current) table */
-        readonly left: string;
-        /** Comparison operator (usually "=") */
-        readonly operator: string;
-        /** Field from the right (joined) table */
-        readonly right: string;
-    };
-    /** Additional ON conditions (for complex joins) */
-    readonly additionalConditions?: Array<{
-        readonly left: string;
-        readonly operator: string;
-        readonly right: string;
-    }>;
-};
-/**
- * SQL ORDER BY clause definition.
- */
-export type SqlOrderClause = {
-    /** Column to order by */
-    readonly column: string;
-    /** Sort direction */
-    readonly direction: "asc" | "desc";
-    /** Nulls position (PostgreSQL-specific) */
-    readonly nulls?: "first" | "last";
-};
-/**
- * SQL GROUP BY clause definition.
- */
-export type SqlGroupClause = {
-    /** Columns to group by */
-    readonly columns: string[];
-};
-/**
- * SQL HAVING clause condition.
- */
-export type SqlHavingClause = {
-    /** Aggregate function (count, sum, avg, etc.) */
-    readonly aggregate: string;
-    /** Column the aggregate operates on */
-    readonly column: string;
-    /** Comparison operator */
-    readonly operator: string;
-    /** Value to compare against */
-    readonly value: unknown;
-};
-/**
- * SQL WHERE clause operation types.
- */
-export type SqlWhereType = "where" | "orWhere" | "whereRaw" | "orWhereRaw" | "whereNot" | "orWhereNot" | "whereExists" | "whereNotExists";
-/**
- * SQL WHERE clause operation.
- *
- * Represents a single WHERE condition with its type, field, operator, and value.
- */
-export type SqlWhereOperation = {
-    /** Type of WHERE clause (where, orWhere, whereRaw, etc.) */
-    readonly type: SqlWhereType;
-    /** Field name (for standard where clauses) */
-    readonly field?: string;
-    /** Comparison operator */
-    readonly operator?: string;
-    /** Value to compare against */
-    readonly value?: unknown;
-    /** Raw SQL expression (for whereRaw clauses) */
-    readonly raw?: string;
-    /** Parameter bindings for raw expressions */
-    readonly bindings?: unknown[];
-    /** Nested conditions (for grouped where clauses) */
-    readonly nested?: SqlWhereOperation[];
-};
-/**
- * SQL SELECT clause definition.
- */
-export type SqlSelectClause = {
-    /** Column name or expression */
-    readonly expression: string;
-    /** Optional alias for the column */
-    readonly alias?: string;
-    /** Whether this is a raw expression */
-    readonly isRaw?: boolean;
-};
-/**
- * Configuration for building SQL queries.
- */
-export type SqlQueryConfig = {
-    /** Target table name */
-    readonly table: string;
-    /** Table alias (optional) */
-    readonly alias?: string;
-    /** SELECT columns (empty = SELECT *) */
-    readonly select: SqlSelectClause[];
-    /** JOIN clauses */
-    readonly joins: SqlJoinClause[];
-    /** WHERE conditions */
-    readonly where: SqlWhereOperation[];
-    /** GROUP BY columns */
-    readonly groupBy: string[];
-    /** HAVING conditions */
-    readonly having: SqlHavingClause[];
-    /** ORDER BY clauses */
-    readonly orderBy: SqlOrderClause[];
-    /** LIMIT value */
-    readonly limit?: number;
-    /** OFFSET value */
-    readonly offset?: number;
-    /** DISTINCT flag */
-    readonly distinct?: boolean;
-};
-/**
- * SQL INSERT operation definition.
- */
-export type SqlInsertOperation = {
-    /** Target table */
-    readonly table: string;
-    /** Column names */
-    readonly columns: string[];
-    /** Values to insert (array of arrays for multi-row insert) */
-    readonly values: unknown[][];
-    /** Whether to return the inserted rows */
-    readonly returning?: string[] | boolean;
-    /** Conflict resolution (upsert) */
-    readonly onConflict?: {
-        readonly columns: string[];
-        readonly action: "update" | "nothing";
-        readonly updateColumns?: string[];
-    };
-};
-/**
- * SQL UPDATE operation definition.
- */
-export type SqlUpdateOperation = {
-    /** Target table */
-    readonly table: string;
-    /** Columns to set with their values */
-    readonly set: Record<string, unknown>;
-    /** Columns to increment */
-    readonly increment?: Record<string, number>;
-    /** Columns to set to NULL */
-    readonly unset?: string[];
-    /** WHERE conditions */
-    readonly where: SqlWhereOperation[];
-    /** Whether to return updated rows */
-    readonly returning?: string[] | boolean;
-    /** Maximum rows to update (some databases support LIMIT in UPDATE) */
-    readonly limit?: number;
-};
-/**
- * SQL DELETE operation definition.
- */
-export type SqlDeleteOperation = {
-    /** Target table */
-    readonly table: string;
-    /** WHERE conditions */
-    readonly where: SqlWhereOperation[];
-    /** Whether to return deleted rows */
-    readonly returning?: string[] | boolean;
-    /** Maximum rows to delete */
-    readonly limit?: number;
-};
-/**
- * Aggregate function types supported in SQL.
- */
-export type SqlAggregateFunction = "count" | "sum" | "avg" | "min" | "max" | "array_agg" | "string_agg" | "jsonb_agg";
-//# sourceMappingURL=sql-types.d.ts.map

package/cjs/drivers/sql/sql-types.d.ts.map

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

package/cjs/errors/missing-data-source.error.d.ts

@@ -1,22 +0,0 @@
-/**
- * Error thrown when a requested data source is not found in the registry.
- *
- * This can occur when:
- * - Attempting to retrieve a non-existent named data source
- * - Trying to get the default data source before any have been registered
- * - Context override references an unregistered data source name
- */
-export declare class MissingDataSourceError extends Error {
-    /**
-     * The name of the data source that was not found (if applicable).
-     */
-    readonly dataSourceName?: string;
-    /**
-     * Creates a new MissingDataSourceError.
-     *
-     * @param message - Descriptive error message
-     * @param dataSourceName - Optional data source name that was not found
-     */
-    constructor(message: string, dataSourceName?: string);
-}
-//# sourceMappingURL=missing-data-source.error.d.ts.map

package/cjs/errors/missing-data-source.error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"missing-data-source.error.d.ts","sourceRoot":"","sources":["../../src/errors/missing-data-source.error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C;;OAEG;IACH,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExC;;;;;OAKG;gBACgB,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;CAU5D"}

package/cjs/errors/missing-data-source.error.js

@@ -1,29 +0,0 @@
-'use strict';/**
- * Error thrown when a requested data source is not found in the registry.
- *
- * This can occur when:
- * - Attempting to retrieve a non-existent named data source
- * - Trying to get the default data source before any have been registered
- * - Context override references an unregistered data source name
- */
-class MissingDataSourceError extends Error {
-    /**
-     * The name of the data source that was not found (if applicable).
-     */
-    dataSourceName;
-    /**
-     * Creates a new MissingDataSourceError.
-     *
-     * @param message - Descriptive error message
-     * @param dataSourceName - Optional data source name that was not found
-     */
-    constructor(message, dataSourceName) {
-        super(message);
-        this.name = "MissingDataSourceError";
-        this.dataSourceName = dataSourceName;
-        // Maintains proper stack trace for where error was thrown (V8 only)
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, MissingDataSourceError);
-        }
-    }
-}exports.MissingDataSourceError=MissingDataSourceError;//# sourceMappingURL=missing-data-source.error.js.map

package/cjs/errors/missing-data-source.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"missing-data-source.error.js","sources":["../../src/errors/missing-data-source.error.ts"],"sourcesContent":[null],"names":[],"mappings":"aAAA;;;;;;;AAOG;AACG,MAAO,sBAAuB,SAAQ,KAAK,CAAA;AAC/C;;AAEG;AACa,IAAA,cAAc,CAAU;AAExC;;;;;AAKG;IACH,WAAmB,CAAA,OAAe,EAAE,cAAuB,EAAA;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;AACrC,QAAA,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;;QAGrC,IAAI,KAAK,CAAC,iBAAiB,EAAE;AAC3B,YAAA,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;AACvD,SAAA;KACF;AACF"}

package/cjs/errors/transaction-rollback.error.d.ts

@@ -1,20 +0,0 @@
-/**
- * Error thrown when a transaction is explicitly rolled back via ctx.rollback().
- *
- * This error is used to signal transaction rollback without representing
- * an application error. It's caught by the transaction wrapper to perform
- * cleanup and then re-thrown.
- */
-export declare class TransactionRollbackError extends Error {
-    /**
-     * The reason for the rollback (if provided).
-     */
-    readonly reason?: string;
-    /**
-     * Creates a new TransactionRollbackError.
-     *
-     * @param reason - Optional reason for rollback (for logging/debugging)
-     */
-    constructor(reason?: string);
-}
-//# sourceMappingURL=transaction-rollback.error.d.ts.map

package/cjs/errors/transaction-rollback.error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction-rollback.error.d.ts","sourceRoot":"","sources":["../../src/errors/transaction-rollback.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD;;OAEG;IACH,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;gBACgB,MAAM,CAAC,EAAE,MAAM;CAUnC"}

package/cjs/errors/transaction-rollback.error.js

@@ -1,27 +0,0 @@
-'use strict';/**
- * Error thrown when a transaction is explicitly rolled back via ctx.rollback().
- *
- * This error is used to signal transaction rollback without representing
- * an application error. It's caught by the transaction wrapper to perform
- * cleanup and then re-thrown.
- */
-class TransactionRollbackError extends Error {
-    /**
-     * The reason for the rollback (if provided).
-     */
-    reason;
-    /**
-     * Creates a new TransactionRollbackError.
-     *
-     * @param reason - Optional reason for rollback (for logging/debugging)
-     */
-    constructor(reason) {
-        super(reason || "Transaction rolled back");
-        this.name = "TransactionRollbackError";
-        this.reason = reason;
-        // Maintains proper stack trace for where error was thrown (V8 only)
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, TransactionRollbackError);
-        }
-    }
-}exports.TransactionRollbackError=TransactionRollbackError;//# sourceMappingURL=transaction-rollback.error.js.map

package/cjs/errors/transaction-rollback.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction-rollback.error.js","sources":["../../src/errors/transaction-rollback.error.ts"],"sourcesContent":[null],"names":[],"mappings":"aAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACjD;;AAEG;AACa,IAAA,MAAM,CAAU;AAEhC;;;;AAIG;AACH,IAAA,WAAA,CAAmB,MAAe,EAAA;AAChC,QAAA,KAAK,CAAC,MAAM,IAAI,yBAAyB,CAAC,CAAC;AAC3C,QAAA,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;AACvC,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;;QAGrB,IAAI,KAAK,CAAC,iBAAiB,EAAE;AAC3B,YAAA,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;AACzD,SAAA;KACF;AACF"}

package/cjs/events/model-events.d.ts

@@ -1,231 +0,0 @@
-import { QueryBuilderContract } from "../contracts";
-import type { Model } from "../model/model";
-import { DeleteStrategy } from "../types";
-type OnValidatingEventContext = {
-    isInsert: boolean;
-    mode: "insert" | "update";
-};
-type OnSavingEventContext = {
-    isInsert: boolean;
-    mode: "insert" | "update";
-};
-type OnDeletingEventContext = {
-    strategy: DeleteStrategy;
-    primaryKeyValue: string | number;
-    primaryKey: string;
-};
-export type OnDeletedEventContext = OnDeletingEventContext & {
-    deletedCount: number;
-    trashRecord?: Record<string, unknown>;
-};
-type OnFetchingEventContext = {
-    table: string;
-    modelClass: any;
-};
-type OnHydratingEventContext = {
-    query: QueryBuilderContract;
-    hydrateCallback?: (data: any, index: number) => any;
-};
-type OnFetchedEventContext = {
-    query: QueryBuilderContract;
-    rawRecords: any[];
-    duration: number;
-};
-/**
- * Lifecycle events understood by Cascade models.
- *
- * The list mirrors the hooks in the legacy ORM so downstream code can subscribe
- * with consistent semantics.
- */
-export type ModelEventName = "initializing" | "fetching" | "hydrating" | "fetched" | "validating" | "validated" | "saving" | "saved" | "creating" | "created" | "updating" | "updated" | "deleting" | "deleted" | "restoring" | "restored";
-/** Signature of an event listener registered against a model lifecycle hook. */
-export type ModelEventListener<TModel, TContext = unknown> = (model: TModel, context: TContext) => void | Promise<void>;
-/**
- * Light-weight async event emitter used to power model lifecycle hooks.
- *
- * The implementation intentionally avoids any external dependency so we can
- * re-use it in drivers, writers, and other core services without pulling in
- * heavier event libraries.
- */
-export declare class ModelEvents<TModel> {
-    readonly listeners: Map<ModelEventName, Set<ModelEventListener<TModel, unknown>>>;
-    /**
-     * Register a listener for the given event.
-     * Returns an unsubscribe function for convenience.
-     */
-    on<TContext = unknown>(event: ModelEventName, listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Register a listener that automatically unsubscribes after the first call.
-     */
-    once<TContext = unknown>(event: ModelEventName, listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Deregister a listener for the given event.
-     */
-    off<TContext = unknown>(event: ModelEventName, listener: ModelEventListener<TModel, TContext>): void;
-    /**
-     * Emit an event to all registered listeners.
-     */
-    emit<TContext = unknown>(event: ModelEventName, model: TModel, context: TContext): Promise<void>;
-    /**
-     * Emit events for fetching
-     */
-    emitFetching<TContext = unknown>(query: QueryBuilderContract, context?: TContext): Promise<void>;
-    /**
-     * Remove all registered listeners.
-     */
-    clear(): void;
-    /**
-     * Registers a listener for the "saving" event.
-     *
-     * Fired before a model is persisted (both insert and update), and before validation.
-     * Use this hook for data enrichment and preparation (e.g., setting createdBy, updatedBy).
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onSaving<TContext = OnSavingEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "saved" event.
-     *
-     * Fired after a model has been successfully persisted.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onSaved<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "creating" event.
-     *
-     * Fired before a new model is inserted into the database.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onCreating<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "created" event.
-     *
-     * Fired after a new model has been successfully inserted.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onCreated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "updating" event.
-     *
-     * Fired before an existing model is updated in the database.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onUpdating<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "updated" event.
-     *
-     * Fired after an existing model has been successfully updated.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onUpdated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "deleting" event.
-     *
-     * Fired before a model is deleted from the database.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onDeleting<TContext = OnDeletingEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "deleted" event.
-     *
-     * Fired after a model has been successfully deleted.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onDeleted<TContext = OnDeletedEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "validating" event.
-     *
-     * Fired before model validation is performed.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onValidating<TContext = OnValidatingEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "validated" event.
-     *
-     * Fired after model validation has completed.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onValidated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "fetching" event.
-     *
-     * Fired before a query is executed to fetch models.
-     * Receives the query builder instance, allowing modification before execution.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onFetching<TContext = OnFetchingEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "hydrating" event.
-     *
-     * Fired after raw records are fetched but before they are hydrated into model instances.
-     * Allows modification of raw data before hydration.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onHydrating<TContext = OnHydratingEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "fetched" event.
-     *
-     * Fired after models have been fetched and hydrated.
-     * Receives hydrated model instances and query context.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onFetched<TContext = OnFetchedEventContext>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "restoring" event.
-     *
-     * Fired before a soft-deleted model is restored.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onRestoring<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Registers a listener for the "restored" event.
-     *
-     * Fired after a soft-deleted model has been successfully restored.
-     *
-     * @param listener - The callback to invoke
-     * @returns An unsubscribe function
-     */
-    onRestored<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void;
-    /**
-     * Ensures a listener set exists for the given event.
-     *
-     * @param event - The event name
-     * @returns The listener set for the event
-     * @private
-     */
-    private ensureListenerSet;
-}
-/**
- * Global event emitter invoked for every model instance, regardless of type.
- * Useful for cross-cutting concerns like auditing or request-scoped enrichment.
- */
-export declare const globalModelEvents: ModelEvents<Model<import("../model/model.types").ModelSchema>>;
-export {};
-//# sourceMappingURL=model-events.d.ts.map

package/cjs/events/model-events.d.ts.map

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