@warlock.js/cascade 4.0.157 → 4.0.161

package/esm/drivers/postgres/postgres-sync-adapter.js

@@ -1,197 +0,0 @@
-/**
- * PostgreSQL Sync Adapter
- *
- * Implements the SyncAdapterContract for batch update operations
- * on embedded/denormalized data in PostgreSQL.
- *
- * @module cascade/drivers/postgres
- */
-/**
- * PostgreSQL Sync Adapter.
- *
- * Handles batch updates for embedded/denormalized data stored
- * in JSONB columns. In a normalized SQL world, this is less common
- * than in MongoDB, but still useful for JSONB documents.
- *
- * @example
- * ```typescript
- * const syncAdapter = driver.syncAdapter();
- *
- * // Update embedded user data in posts
- * await syncAdapter.executeBatch([
- *   {
- *     targetTable: 'posts',
- *     filter: { 'author.id': 123 },
- *     update: { 'author.name': 'New Name' },
- *     // ... other fields
- *   }
- * ]);
- * ```
- */
-class PostgresSyncAdapter {
-    driver;
-    /**
-     * Create a new sync adapter.
-     *
-     * @param driver - The PostgreSQL driver instance
-     */
-    constructor(driver) {
-        this.driver = driver;
-    }
-    /**
-     * Execute a batch of sync instructions.
-     *
-     * @param instructions - Array of sync instructions
-     * @returns Total number of affected rows
-     */
-    async executeBatch(instructions) {
-        let totalAffected = 0;
-        for (const instruction of instructions) {
-            if (instruction.isArrayUpdate) {
-                totalAffected += await this.executeArrayUpdate(instruction);
-            }
-            else {
-                totalAffected += await this.executeOne(instruction);
-            }
-        }
-        return totalAffected;
-    }
-    /**
-     * Execute a single sync instruction.
-     *
-     * @param instruction - Sync instruction
-     * @returns Number of affected rows
-     */
-    async executeOne(instruction) {
-        const { targetTable, filter, update } = instruction;
-        return this.executeJsonbUpdate(targetTable, filter, update);
-    }
-    /**
-     * Execute an array update instruction with positional operators.
-     *
-     * @param instruction - Sync instruction with array update info
-     * @returns Number of affected rows
-     */
-    async executeArrayUpdate(instruction) {
-        const { targetTable, filter, update, arrayField, identifierField, identifierValue } = instruction;
-        if (!arrayField || !identifierField || identifierValue === undefined) {
-            // Fall back to regular update if array info is missing
-            return this.executeOne(instruction);
-        }
-        return this.executeArrayElementUpdate(targetTable, filter, arrayField, { [identifierField]: identifierValue }, update);
-    }
-    /**
-     * Execute an update on JSONB fields.
-     *
-     * @param table - Table name
-     * @param filter - Row filter
-     * @param update - Fields to update
-     * @returns Number of affected rows
-     */
-    async executeJsonbUpdate(table, filter, update) {
-        const quotedTable = this.driver.dialect.quoteIdentifier(table);
-        const setClauses = [];
-        const params = [];
-        let paramIndex = 1;
-        // Build SET clauses for each update field
-        for (const [path, value] of Object.entries(update)) {
-            if (path.includes(".")) {
-                // JSONB path update: "column.nested.field" -> jsonb_set
-                const [column, ...pathParts] = path.split(".");
-                const quotedColumn = this.driver.dialect.quoteIdentifier(column);
-                const jsonPath = `{${pathParts.join(",")}}`;
-                const placeholder = this.driver.dialect.placeholder(paramIndex++);
-                params.push(JSON.stringify(value));
-                setClauses.push(`${quotedColumn} = jsonb_set(COALESCE(${quotedColumn}, '{}'::jsonb), '${jsonPath}', ${placeholder}::jsonb)`);
-            }
-            else {
-                // Regular column update
-                const quotedColumn = this.driver.dialect.quoteIdentifier(path);
-                const placeholder = this.driver.dialect.placeholder(paramIndex++);
-                params.push(value);
-                setClauses.push(`${quotedColumn} = ${placeholder}`);
-            }
-        }
-        // Build WHERE clause
-        const whereClauses = [];
-        for (const [key, value] of Object.entries(filter)) {
-            if (key.includes(".")) {
-                // JSONB path filter
-                const [column, ...pathParts] = key.split(".");
-                const quotedColumn = this.driver.dialect.quoteIdentifier(column);
-                const jsonPath = pathParts.map((p) => `'${p}'`).join("->>");
-                const placeholder = this.driver.dialect.placeholder(paramIndex++);
-                params.push(value);
-                whereClauses.push(`${quotedColumn}->>${jsonPath} = ${placeholder}`);
-            }
-            else {
-                const quotedKey = this.driver.dialect.quoteIdentifier(key);
-                const placeholder = this.driver.dialect.placeholder(paramIndex++);
-                params.push(value);
-                whereClauses.push(`${quotedKey} = ${placeholder}`);
-            }
-        }
-        const sql = `UPDATE ${quotedTable} SET ${setClauses.join(", ")} WHERE ${whereClauses.join(" AND ")}`;
-        const result = await this.driver.query(sql, params);
-        return result.rowCount ?? 0;
-    }
-    /**
-     * Execute an update on elements within a JSONB array.
-     *
-     * @param table - Table name
-     * @param filter - Row filter
-     * @param arrayField - JSONB array column
-     * @param arrayFilter - Filter to match array elements
-     * @param update - Fields to update on matched elements
-     * @returns Number of affected rows
-     */
-    async executeArrayElementUpdate(table, filter, arrayField, arrayFilter, update) {
-        const quotedTable = this.driver.dialect.quoteIdentifier(table);
-        const quotedArrayField = this.driver.dialect.quoteIdentifier(arrayField);
-        const params = [];
-        let paramIndex = 1;
-        // Build array element filter condition
-        const arrayFilterCondition = Object.entries(arrayFilter)
-            .map(([key, value]) => {
-            params.push(value);
-            return `elem->>'${key}' = ${this.driver.dialect.placeholder(paramIndex++)}`;
-        })
-            .join(" AND ");
-        // Build update expression for matched elements
-        const updateExpr = Object.entries(update)
-            .map(([key, value]) => {
-            params.push(JSON.stringify(value));
-            return `'${key}', ${this.driver.dialect.placeholder(paramIndex++)}::jsonb`;
-        })
-            .join(", ");
-        // Build WHERE clause for row filter
-        const whereClauses = Object.entries(filter).map(([key, value]) => {
-            const quotedKey = this.driver.dialect.quoteIdentifier(key);
-            params.push(value);
-            return `${quotedKey} = ${this.driver.dialect.placeholder(paramIndex++)}`;
-        });
-        // Use a CTE to update array elements
-        const sql = `
-      WITH updated AS (
-        SELECT id, (
-          SELECT jsonb_agg(
-            CASE 
-              WHEN ${arrayFilterCondition}
-              THEN elem || jsonb_build_object(${updateExpr})
-              ELSE elem
-            END
-          )
-          FROM jsonb_array_elements(${quotedArrayField}) elem
-        ) AS new_array
-        FROM ${quotedTable}
-        WHERE ${whereClauses.join(" AND ")}
-      )
-      UPDATE ${quotedTable} t
-      SET ${quotedArrayField} = u.new_array
-      FROM updated u
-      WHERE t.id = u.id
-    `;
-        const result = await this.driver.query(sql, params);
-        return result.rowCount ?? 0;
-    }
-}export{PostgresSyncAdapter};//# sourceMappingURL=postgres-sync-adapter.js.map

package/esm/drivers/postgres/postgres-sync-adapter.js.map

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

package/esm/drivers/postgres/types.d.ts

@@ -1,142 +0,0 @@
-/**
- * PostgreSQL Driver Types
- *
- * Type definitions specific to the PostgreSQL driver implementation.
- *
- * @module cascade/drivers/postgres
- */
-/**
- * PostgreSQL connection configuration options.
- */
-export type PostgresConnectionConfig = {
-    /** Database host (default: "localhost") */
-    readonly host?: string;
-    /** Database port (default: 5432) */
-    readonly port?: number;
-    /** Database name */
-    readonly database: string;
-    /** Database user */
-    readonly user?: string;
-    /** Database password */
-    readonly password?: string;
-    /** Connection string (alternative to individual options) */
-    readonly connectionString?: string;
-    /** SSL configuration */
-    readonly ssl?: boolean | {
-        readonly rejectUnauthorized?: boolean;
-        readonly ca?: string;
-        readonly cert?: string;
-        readonly key?: string;
-    };
-};
-/**
- * PostgreSQL pool configuration options.
- */
-export type PostgresPoolConfig = PostgresConnectionConfig & {
-    /** Maximum number of clients in the pool (default: 10) */
-    readonly max?: number;
-    /** Minimum number of clients in the pool (default: 0) */
-    readonly min?: number;
-    /** How long a client can sit idle before being closed (ms) */
-    readonly idleTimeoutMillis?: number;
-    /** How long to wait for a client before timing out (ms) */
-    readonly connectionTimeoutMillis?: number;
-    /** Maximum times to use a connection before destroying it */
-    readonly maxUses?: number;
-    /** Application name for connection identification */
-    readonly application_name?: string;
-};
-/**
- * PostgreSQL query result wrapper.
- */
-export type PostgresQueryResult<T = Record<string, unknown>> = {
-    /** Array of rows returned by the query */
-    readonly rows: T[];
-    /** Number of rows affected by INSERT/UPDATE/DELETE */
-    readonly rowCount: number | null;
-    /** Column definitions from the result */
-    readonly fields: Array<{
-        readonly name: string;
-        readonly dataTypeID: number;
-    }>;
-    /** Command that was executed (SELECT, INSERT, etc.) */
-    readonly command: string;
-};
-/**
- * PostgreSQL transaction isolation levels.
- */
-export type PostgresIsolationLevel = "read uncommitted" | "read committed" | "repeatable read" | "serializable";
-/**
- * PostgreSQL transaction options.
- */
-export type PostgresTransactionOptions = {
-    /** Isolation level for the transaction */
-    readonly isolationLevel?: PostgresIsolationLevel;
-    /** Whether the transaction is read-only */
-    readonly readOnly?: boolean;
-    /** Use deferrable mode (for serializable + read-only) */
-    readonly deferrable?: boolean;
-};
-/**
- * PostgreSQL-specific operation types used in the query builder.
- */
-export type PostgresOperation = {
-    /** Operation stage (select, where, join, etc.) */
-    readonly stage: "select" | "from" | "join" | "where" | "groupBy" | "having" | "orderBy" | "limit" | "offset";
-    /** Operation type/name */
-    readonly type: string;
-    /** Operation payload/data */
-    readonly data: Record<string, unknown>;
-};
-/**
- * Internal representation of a pending WHERE clause.
- */
-export type PostgresWhereClause = {
-    /** Boolean operator to combine with previous clause */
-    readonly boolean: "and" | "or";
-    /** Type of where clause */
-    readonly type: "basic" | "raw" | "null" | "notNull" | "in" | "notIn" | "between" | "notBetween" | "exists" | "notExists" | "nested" | "column";
-    /** Column/field name */
-    readonly column?: string;
-    /** Comparison operator */
-    readonly operator?: string;
-    /** Value to compare */
-    readonly value?: unknown;
-    /** Raw SQL expression */
-    readonly raw?: string;
-    /** Parameter bindings */
-    readonly bindings?: unknown[];
-    /** Nested conditions */
-    readonly nested?: PostgresWhereClause[];
-};
-/**
- * PostgreSQL NOTIFY payload structure.
- */
-export type PostgresNotification = {
-    /** Channel name */
-    readonly channel: string;
-    /** Notification payload */
-    readonly payload?: string;
-    /** Process ID of the notifying backend */
-    readonly processId: number;
-};
-/**
- * PostgreSQL COPY options for bulk operations.
- */
-export type PostgresCopyOptions = {
-    /** Format (text, csv, binary) */
-    readonly format?: "text" | "csv" | "binary";
-    /** Field delimiter for text/csv */
-    readonly delimiter?: string;
-    /** Quote character for csv */
-    readonly quote?: string;
-    /** Escape character for csv */
-    readonly escape?: string;
-    /** Include header row */
-    readonly header?: boolean;
-    /** Null string representation */
-    readonly null?: string;
-    /** Column list */
-    readonly columns?: string[];
-};
-//# sourceMappingURL=types.d.ts.map

package/esm/drivers/postgres/types.d.ts.map

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

package/esm/drivers/sql/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * SQL Driver Exports
- *
- * Central export file for shared SQL infrastructure.
- *
- * @module cascade/drivers/sql
- */
-export * from "./sql-dialect.contract";
-export * from "./sql-types";
-//# sourceMappingURL=index.d.ts.map

package/esm/drivers/sql/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/drivers/sql/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC"}

package/esm/drivers/sql/sql-dialect.contract.d.ts

@@ -1,204 +0,0 @@
-/**
- * SQL Dialect Contract
- *
- * Defines the interface for database-specific SQL syntax variations.
- * Each SQL database driver implements this interface to handle
- * differences in parameter placeholders, identifier quoting, and SQL syntax.
- *
- * @module cascade/drivers/sql
- */
-/**
- * Contract that SQL dialects must implement to handle database-specific
- * SQL syntax variations.
- *
- * Each SQL database (PostgreSQL, MySQL, SQLite) has subtle differences
- * in how they handle parameters, identifiers, and certain SQL features.
- * This interface abstracts those differences.
- *
- * @example
- * ```typescript
- * class PostgresDialect implements SqlDialectContract {
- *   placeholder(index: number): string {
- *     return `$${index}`;  // PostgreSQL uses $1, $2, etc.
- *   }
- * }
- *
- * class MySqlDialect implements SqlDialectContract {
- *   placeholder(index: number): string {
- *     return '?';  // MySQL uses ? for all parameters
- *   }
- * }
- * ```
- */
-export interface SqlDialectContract {
-    /**
-     * The name of the dialect for identification purposes.
-     *
-     * @example "postgres", "mysql", "sqlite"
-     */
-    readonly name: string;
-    /**
-     * Generate a parameter placeholder for the given index.
-     *
-     * Different databases use different placeholder styles:
-     * - PostgreSQL: `$1`, `$2`, `$3`
-     * - MySQL/SQLite: `?` (positional)
-     *
-     * @param index - The 1-based parameter index
-     * @returns The placeholder string to use in the SQL query
-     *
-     * @example
-     * ```typescript
-     * dialect.placeholder(1); // "$1" for PostgreSQL
-     * dialect.placeholder(2); // "?" for MySQL
-     * ```
-     */
-    placeholder(index: number): string;
-    /**
-     * Quote an identifier (table name, column name) for safe use in SQL.
-     *
-     * Different databases use different quote characters:
-     * - PostgreSQL: `"column_name"`
-     * - MySQL: `` `column_name` ``
-     *
-     * This also handles escaping if the identifier contains the quote character.
-     *
-     * @param identifier - The identifier to quote
-     * @returns The quoted identifier safe for use in SQL
-     *
-     * @example
-     * ```typescript
-     * dialect.quoteIdentifier('user'); // '"user"' for PostgreSQL
-     * dialect.quoteIdentifier('order'); // '`order`' for MySQL
-     * ```
-     */
-    quoteIdentifier(identifier: string): string;
-    /**
-     * Convert a boolean value to the appropriate SQL literal.
-     *
-     * Different databases represent booleans differently:
-     * - PostgreSQL: `TRUE` / `FALSE`
-     * - MySQL: `1` / `0`
-     *
-     * @param value - The boolean value to convert
-     * @returns The SQL literal string
-     *
-     * @example
-     * ```typescript
-     * dialect.booleanLiteral(true); // "TRUE" for PostgreSQL
-     * dialect.booleanLiteral(false); // "0" for MySQL
-     * ```
-     */
-    booleanLiteral(value: boolean): string;
-    /**
-     * Whether the database supports the RETURNING clause for INSERT/UPDATE/DELETE.
-     *
-     * - PostgreSQL: `true` (supports `RETURNING *`)
-     * - MySQL: `false` (must use `LAST_INSERT_ID()`)
-     */
-    readonly supportsReturning: boolean;
-    /**
-     * The keyword used for upsert (insert or update) operations.
-     *
-     * - PostgreSQL: `"ON CONFLICT"`
-     * - MySQL: `"ON DUPLICATE KEY"`
-     */
-    readonly upsertKeyword: "ON CONFLICT" | "ON DUPLICATE KEY";
-    /**
-     * Build the LIMIT/OFFSET clause for pagination.
-     *
-     * Most databases use `LIMIT x OFFSET y`, but syntax may vary.
-     *
-     * @param limit - Maximum number of rows to return (undefined = no limit)
-     * @param offset - Number of rows to skip (undefined = no offset)
-     * @returns The SQL clause string (e.g., "LIMIT 10 OFFSET 20")
-     *
-     * @example
-     * ```typescript
-     * dialect.limitOffset(10, 20); // "LIMIT 10 OFFSET 20"
-     * dialect.limitOffset(10);     // "LIMIT 10"
-     * dialect.limitOffset(undefined, 20); // "OFFSET 20"
-     * ```
-     */
-    limitOffset(limit?: number, offset?: number): string;
-    /**
-     * Build a JSON path extraction expression.
-     *
-     * Different databases have different JSON operators:
-     * - PostgreSQL: `column->>'path'` or `column->'path'`
-     * - MySQL: `JSON_EXTRACT(column, '$.path')`
-     *
-     * @param column - The JSON/JSONB column name
-     * @param path - The path to extract (dot notation)
-     * @returns The SQL expression for extracting the path
-     *
-     * @example
-     * ```typescript
-     * dialect.jsonExtract('data', 'user.name');
-     * // PostgreSQL: "data"->>'user'->>'name'
-     * // MySQL: JSON_EXTRACT("data", '$.user.name')
-     * ```
-     */
-    jsonExtract(column: string, path: string): string;
-    /**
-     * Check if a JSON column contains a value.
-     *
-     * - PostgreSQL: `column @> '{"key": "value"}'::jsonb`
-     * - MySQL: `JSON_CONTAINS(column, '"value"', '$.key')`
-     *
-     * @param column - The JSON/JSONB column name
-     * @param value - The value to check for
-     * @param path - Optional path within the JSON
-     * @returns The SQL expression
-     */
-    jsonContains(column: string, value: unknown, path?: string): string;
-    /**
-     * Build a LIKE pattern with proper escaping.
-     *
-     * @param pattern - The pattern (may include % and _ wildcards)
-     * @param caseInsensitive - Whether to use case-insensitive matching
-     * @returns Object with the SQL operator and escaped pattern
-     *
-     * @example
-     * ```typescript
-     * dialect.likePattern('%test%', true);
-     * // PostgreSQL: { operator: 'ILIKE', pattern: '%test%' }
-     * // MySQL: { operator: 'LIKE', pattern: '%test%' } (case-insensitive by default)
-     * ```
-     */
-    likePattern(pattern: string, caseInsensitive?: boolean): {
-        operator: string;
-        pattern: string;
-    };
-    /**
-     * Build an array contains expression.
-     *
-     * - PostgreSQL: `$1 = ANY(column)` or `column @> ARRAY[$1]`
-     * - MySQL: `JSON_CONTAINS(column, ...)` for JSON arrays
-     *
-     * @param column - The array column name
-     * @param paramIndex - The parameter index for the value
-     * @returns The SQL expression
-     */
-    arrayContains(column: string, paramIndex: number): string;
-    /**
-     * Get the SQL type name for common abstract types.
-     *
-     * @param type - The abstract type name
-     * @param options - Type-specific options (length, precision, scale)
-     * @returns The database-specific SQL type
-     *
-     * @example
-     * ```typescript
-     * dialect.getSqlType('string', { length: 255 }); // "VARCHAR(255)"
-     * dialect.getSqlType('json'); // "JSONB" for PostgreSQL, "JSON" for MySQL
-     * ```
-     */
-    getSqlType(type: string, options?: {
-        length?: number;
-        precision?: number;
-        scale?: number;
-        dimensions?: number;
-    }): string;
-}
-//# sourceMappingURL=sql-dialect.contract.d.ts.map

package/esm/drivers/sql/sql-dialect.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sql-dialect.contract.d.ts","sourceRoot":"","sources":["../../../src/drivers/sql/sql-dialect.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5C;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAEpC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAE3D;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAErD;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAElD;;;;;;;;;;OAUG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpE;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAE/F;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1D;;;;;;;;;;;;OAYG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrF,MAAM,CAAC;CACX"}