@warlock.js/cascade 4.0.92 → 4.0.93

package/esm/drivers/postgres/postgres-blueprint.d.ts

@@ -0,0 +1,64 @@
+/**
+ * PostgreSQL Blueprint
+ *
+ * Implements the DriverBlueprintContract for querying PostgreSQL
+ * information schema metadata.
+ *
+ * @module cascade/drivers/postgres
+ */
+import type { DriverBlueprintContract, TableIndexInformation } from "../../contracts/driver-blueprint.contract";
+import type { PostgresDriver } from "./postgres-driver";
+/**
+ * PostgreSQL Blueprint.
+ *
+ * Provides methods for introspecting the database schema
+ * via PostgreSQL's information_schema and pg_catalog.
+ *
+ * @example
+ * ```typescript
+ * const blueprint = driver.blueprint;
+ *
+ * // Get all tables
+ * const tables = await blueprint.listTables();
+ *
+ * // Get columns for a table
+ * const columns = await blueprint.listColumns('users');
+ * ```
+ */
+export declare class PostgresBlueprint implements DriverBlueprintContract {
+    private readonly driver;
+    /**
+     * Create a new blueprint.
+     *
+     * @param driver - The PostgreSQL driver instance
+     */
+    constructor(driver: PostgresDriver);
+    /**
+     * Get all table names in the database.
+     *
+     * @returns Array of table names
+     */
+    listTables(): Promise<string[]>;
+    /**
+     * Get all indexes for a table.
+     *
+     * @param table - Table name
+     * @returns Array of index information
+     */
+    listIndexes(table: string): Promise<TableIndexInformation[]>;
+    /**
+     * Get all column names for a table.
+     *
+     * @param table - Table name
+     * @returns Array of column names
+     */
+    listColumns(table: string): Promise<string[]>;
+    /**
+     * Check if a table exists.
+     *
+     * @param table - Table name
+     * @returns Whether the table exists
+     */
+    tableExists(table: string): Promise<boolean>;
+}
+//# sourceMappingURL=postgres-blueprint.d.ts.map

package/esm/drivers/postgres/postgres-blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-blueprint.d.ts","sourceRoot":"","sources":["../../../src/drivers/postgres/postgres-blueprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAkB,YAAW,uBAAuB;IAM5C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL1C;;;;OAIG;gBACiC,MAAM,EAAE,cAAc;IAE1D;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAY5C;;;;;OAKG;IACU,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA8CzE;;;;;OAKG;IACU,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAa1D;;;;;OAKG;IACU,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAY1D"}

package/esm/drivers/postgres/postgres-blueprint.js

@@ -0,0 +1,121 @@
+/**
+ * PostgreSQL Blueprint
+ *
+ * Implements the DriverBlueprintContract for querying PostgreSQL
+ * information schema metadata.
+ *
+ * @module cascade/drivers/postgres
+ */
+/**
+ * PostgreSQL Blueprint.
+ *
+ * Provides methods for introspecting the database schema
+ * via PostgreSQL's information_schema and pg_catalog.
+ *
+ * @example
+ * ```typescript
+ * const blueprint = driver.blueprint;
+ *
+ * // Get all tables
+ * const tables = await blueprint.listTables();
+ *
+ * // Get columns for a table
+ * const columns = await blueprint.listColumns('users');
+ * ```
+ */
+class PostgresBlueprint {
+    driver;
+    /**
+     * Create a new blueprint.
+     *
+     * @param driver - The PostgreSQL driver instance
+     */
+    constructor(driver) {
+        this.driver = driver;
+    }
+    /**
+     * Get all table names in the database.
+     *
+     * @returns Array of table names
+     */
+    async listTables() {
+        const result = await this.driver.query(`SELECT table_name 
+       FROM information_schema.tables 
+       WHERE table_schema = 'public' 
+       AND table_type = 'BASE TABLE'
+       ORDER BY table_name`);
+        return result.rows.map((row) => row.table_name);
+    }
+    /**
+     * Get all indexes for a table.
+     *
+     * @param table - Table name
+     * @returns Array of index information
+     */
+    async listIndexes(table) {
+        const result = await this.driver.query(`SELECT indexname, indexdef
+       FROM pg_indexes
+       WHERE schemaname = 'public'
+       AND tablename = $1`, [table]);
+        return result.rows.map((row) => {
+            const isUnique = row.indexdef.includes("UNIQUE");
+            const isPrimary = row.indexname.endsWith("_pkey");
+            // Extract columns from indexdef
+            const columnsMatch = row.indexdef.match(/\(([^)]+)\)/);
+            const columns = columnsMatch
+                ? columnsMatch[1].split(",").map((c) => c.trim().replace(/"/g, ""))
+                : [];
+            // Determine index type
+            let type = "btree"; // default
+            if (row.indexdef.includes("USING GIN"))
+                type = "gin";
+            else if (row.indexdef.includes("USING GIST"))
+                type = "gist";
+            else if (row.indexdef.includes("USING HASH"))
+                type = "hash";
+            else if (row.indexdef.includes("USING ivfflat"))
+                type = "ivfflat";
+            // Check for partial index
+            const isPartial = row.indexdef.includes("WHERE");
+            return {
+                name: row.indexname,
+                columns,
+                type,
+                unique: isUnique || isPrimary,
+                partial: isPartial,
+                options: {
+                    primary: isPrimary,
+                    definition: row.indexdef,
+                },
+            };
+        });
+    }
+    /**
+     * Get all column names for a table.
+     *
+     * @param table - Table name
+     * @returns Array of column names
+     */
+    async listColumns(table) {
+        const result = await this.driver.query(`SELECT column_name
+       FROM information_schema.columns
+       WHERE table_schema = 'public'
+       AND table_name = $1
+       ORDER BY ordinal_position`, [table]);
+        return result.rows.map((row) => row.column_name);
+    }
+    /**
+     * Check if a table exists.
+     *
+     * @param table - Table name
+     * @returns Whether the table exists
+     */
+    async tableExists(table) {
+        const result = await this.driver.query(`SELECT EXISTS (
+        SELECT FROM information_schema.tables 
+        WHERE table_schema = 'public' 
+        AND table_name = $1
+      )`, [table]);
+        return result.rows[0]?.exists ?? false;
+    }
+}export{PostgresBlueprint};//# sourceMappingURL=postgres-blueprint.js.map

package/esm/drivers/postgres/postgres-blueprint.js.map

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

package/esm/drivers/postgres/postgres-dialect.d.ts

@@ -0,0 +1,135 @@
+/**
+ * PostgreSQL Dialect Implementation
+ *
+ * Implements the SqlDialectContract for PostgreSQL-specific SQL syntax.
+ * Handles parameter placeholders ($1, $2), identifier quoting, and
+ * PostgreSQL-specific features like JSONB operators.
+ *
+ * @module cascade/drivers/postgres
+ */
+import type { SqlDialectContract } from "../sql/sql-dialect.contract";
+/**
+ * PostgreSQL-specific SQL dialect implementation.
+ *
+ * Provides PostgreSQL syntax for:
+ * - Parameter placeholders ($1, $2, $3...)
+ * - Identifier quoting with double quotes
+ * - JSONB operators (->, ->>, @>)
+ * - ILIKE for case-insensitive matching
+ * - RETURNING clause support
+ *
+ * @example
+ * ```typescript
+ * const dialect = new PostgresDialect();
+ *
+ * dialect.placeholder(1); // "$1"
+ * dialect.quoteIdentifier('user'); // '"user"'
+ * dialect.jsonExtract('data', 'name'); // "data"->>'name'
+ * ```
+ */
+export declare class PostgresDialect implements SqlDialectContract {
+    /**
+     * Dialect name identifier.
+     */
+    readonly name: "postgres";
+    /**
+     * PostgreSQL supports the RETURNING clause for INSERT/UPDATE/DELETE.
+     */
+    readonly supportsReturning = true;
+    /**
+     * PostgreSQL uses ON CONFLICT for upsert operations.
+     */
+    readonly upsertKeyword: "ON CONFLICT";
+    /**
+     * Generate a PostgreSQL parameter placeholder.
+     *
+     * PostgreSQL uses numbered placeholders: $1, $2, $3, etc.
+     *
+     * @param index - The 1-based parameter index
+     * @returns The placeholder string (e.g., "$1")
+     */
+    placeholder(index: number): string;
+    /**
+     * Quote an identifier using PostgreSQL's double-quote syntax.
+     *
+     * Handles escaping of embedded double quotes by doubling them.
+     * This is necessary for reserved words and special characters.
+     *
+     * @param identifier - The identifier (table/column name) to quote
+     * @returns The quoted identifier (e.g., '"user"')
+     */
+    quoteIdentifier(identifier: string): string;
+    /**
+     * Convert a boolean to PostgreSQL literal.
+     *
+     * @param value - The boolean value
+     * @returns "TRUE" or "FALSE"
+     */
+    booleanLiteral(value: boolean): string;
+    /**
+     * Build LIMIT/OFFSET clause for PostgreSQL.
+     *
+     * @param limit - Maximum rows to return
+     * @param offset - Rows to skip
+     * @returns The SQL clause (e.g., "LIMIT 10 OFFSET 20")
+     */
+    limitOffset(limit?: number, offset?: number): string;
+    /**
+     * Build a JSON path extraction expression for PostgreSQL.
+     *
+     * Uses the ->> operator for text extraction from JSONB columns.
+     * Supports nested paths using chained operators.
+     *
+     * @param column - The JSONB column name
+     * @param path - The path to extract (dot notation: "user.name")
+     * @returns The SQL expression (e.g., "data"->>'user'->>'name')
+     */
+    jsonExtract(column: string, path: string): string;
+    /**
+     * Build a JSON contains expression for PostgreSQL.
+     *
+     * Uses the @> containment operator for JSONB columns.
+     *
+     * @param column - The 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 expression for PostgreSQL.
+     *
+     * Uses ILIKE for case-insensitive matching, LIKE for case-sensitive.
+     *
+     * @param pattern - The pattern to match
+     * @param caseInsensitive - Whether to use case-insensitive matching
+     * @returns Object with operator and pattern
+     */
+    likePattern(pattern: string, caseInsensitive?: boolean): {
+        operator: string;
+        pattern: string;
+    };
+    /**
+     * Build an array contains expression for PostgreSQL.
+     *
+     * Uses ANY() for checking if a value is in an array column.
+     *
+     * @param column - The array column name
+     * @param paramIndex - The parameter index
+     * @returns The SQL expression
+     */
+    arrayContains(column: string, paramIndex: number): string;
+    /**
+     * Get the PostgreSQL SQL type for an abstract type.
+     *
+     * @param type - The abstract type name
+     * @param options - Type-specific options
+     * @returns The PostgreSQL type string
+     */
+    getSqlType(type: string, options?: {
+        length?: number;
+        precision?: number;
+        scale?: number;
+    }): string;
+}
+//# sourceMappingURL=postgres-dialect.d.ts.map

package/esm/drivers/postgres/postgres-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-dialect.d.ts","sourceRoot":"","sources":["../../../src/drivers/postgres/postgres-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD;;OAEG;IACH,SAAgB,IAAI,aAAuB;IAE3C;;OAEG;IACH,SAAgB,iBAAiB,QAAQ;IAEzC;;OAEG;IACH,SAAgB,aAAa,gBAA0B;IAEvD;;;;;;;OAOG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIzC;;;;;;;;OAQG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAMlD;;;;;OAKG;IACI,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAI7C;;;;;;OAMG;IACI,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAc3D;;;;;;;;;OASG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAkBxD;;;;;;;;;OASG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAc1E;;;;;;;;OAQG;IACI,WAAW,CAChB,OAAO,EAAE,MAAM,EACf,eAAe,UAAO,GACrB;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAUxC;;;;;;;;OAQG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhE;;;;;;OAMG;IACI,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,MAAM;CAuEV"}

package/esm/drivers/postgres/postgres-dialect.js

@@ -0,0 +1,245 @@
+/**
+ * PostgreSQL Dialect Implementation
+ *
+ * Implements the SqlDialectContract for PostgreSQL-specific SQL syntax.
+ * Handles parameter placeholders ($1, $2), identifier quoting, and
+ * PostgreSQL-specific features like JSONB operators.
+ *
+ * @module cascade/drivers/postgres
+ */
+/**
+ * PostgreSQL-specific SQL dialect implementation.
+ *
+ * Provides PostgreSQL syntax for:
+ * - Parameter placeholders ($1, $2, $3...)
+ * - Identifier quoting with double quotes
+ * - JSONB operators (->, ->>, @>)
+ * - ILIKE for case-insensitive matching
+ * - RETURNING clause support
+ *
+ * @example
+ * ```typescript
+ * const dialect = new PostgresDialect();
+ *
+ * dialect.placeholder(1); // "$1"
+ * dialect.quoteIdentifier('user'); // '"user"'
+ * dialect.jsonExtract('data', 'name'); // "data"->>'name'
+ * ```
+ */
+class PostgresDialect {
+    /**
+     * Dialect name identifier.
+     */
+    name = "postgres";
+    /**
+     * PostgreSQL supports the RETURNING clause for INSERT/UPDATE/DELETE.
+     */
+    supportsReturning = true;
+    /**
+     * PostgreSQL uses ON CONFLICT for upsert operations.
+     */
+    upsertKeyword = "ON CONFLICT";
+    /**
+     * Generate a PostgreSQL parameter placeholder.
+     *
+     * PostgreSQL uses numbered placeholders: $1, $2, $3, etc.
+     *
+     * @param index - The 1-based parameter index
+     * @returns The placeholder string (e.g., "$1")
+     */
+    placeholder(index) {
+        return `$${index}`;
+    }
+    /**
+     * Quote an identifier using PostgreSQL's double-quote syntax.
+     *
+     * Handles escaping of embedded double quotes by doubling them.
+     * This is necessary for reserved words and special characters.
+     *
+     * @param identifier - The identifier (table/column name) to quote
+     * @returns The quoted identifier (e.g., '"user"')
+     */
+    quoteIdentifier(identifier) {
+        // Split on dots for qualified names (schema.table.column)
+        const parts = identifier.split(".");
+        return parts.map((part) => `"${part.replace(/"/g, '""')}"`).join(".");
+    }
+    /**
+     * Convert a boolean to PostgreSQL literal.
+     *
+     * @param value - The boolean value
+     * @returns "TRUE" or "FALSE"
+     */
+    booleanLiteral(value) {
+        return value ? "TRUE" : "FALSE";
+    }
+    /**
+     * Build LIMIT/OFFSET clause for PostgreSQL.
+     *
+     * @param limit - Maximum rows to return
+     * @param offset - Rows to skip
+     * @returns The SQL clause (e.g., "LIMIT 10 OFFSET 20")
+     */
+    limitOffset(limit, offset) {
+        const parts = [];
+        if (limit !== undefined) {
+            parts.push(`LIMIT ${limit}`);
+        }
+        if (offset !== undefined) {
+            parts.push(`OFFSET ${offset}`);
+        }
+        return parts.join(" ");
+    }
+    /**
+     * Build a JSON path extraction expression for PostgreSQL.
+     *
+     * Uses the ->> operator for text extraction from JSONB columns.
+     * Supports nested paths using chained operators.
+     *
+     * @param column - The JSONB column name
+     * @param path - The path to extract (dot notation: "user.name")
+     * @returns The SQL expression (e.g., "data"->>'user'->>'name')
+     */
+    jsonExtract(column, path) {
+        const quotedColumn = this.quoteIdentifier(column);
+        const pathParts = path.split(".");
+        if (pathParts.length === 1) {
+            return `${quotedColumn}->>'${pathParts[0]}'`;
+        }
+        // For nested paths: data->'user'->>'name' (last one gets text extraction)
+        const jsonPath = pathParts
+            .slice(0, -1)
+            .map((p) => `'${p}'`)
+            .join("->");
+        const lastKey = pathParts[pathParts.length - 1];
+        return `${quotedColumn}->${jsonPath}->>'${lastKey}'`;
+    }
+    /**
+     * Build a JSON contains expression for PostgreSQL.
+     *
+     * Uses the @> containment operator for JSONB columns.
+     *
+     * @param column - The JSONB column name
+     * @param value - The value to check for
+     * @param path - Optional path within the JSON
+     * @returns The SQL expression
+     */
+    jsonContains(column, value, path) {
+        const quotedColumn = this.quoteIdentifier(column);
+        if (path) {
+            // Check if a specific path contains the value
+            const jsonValue = JSON.stringify({ [path]: value });
+            return `${quotedColumn} @> '${jsonValue}'::jsonb`;
+        }
+        // Check if the column contains the value (for arrays or objects)
+        const jsonValue = JSON.stringify(value);
+        return `${quotedColumn} @> '${jsonValue}'::jsonb`;
+    }
+    /**
+     * Build a LIKE pattern expression for PostgreSQL.
+     *
+     * Uses ILIKE for case-insensitive matching, LIKE for case-sensitive.
+     *
+     * @param pattern - The pattern to match
+     * @param caseInsensitive - Whether to use case-insensitive matching
+     * @returns Object with operator and pattern
+     */
+    likePattern(pattern, caseInsensitive = true) {
+        // Escape special characters in the pattern (%, _, \)
+        const escapedPattern = pattern.replace(/\\/g, "\\\\").replace(/%/g, "\\%").replace(/_/g, "\\_");
+        return {
+            operator: caseInsensitive ? "ILIKE" : "LIKE",
+            pattern: escapedPattern,
+        };
+    }
+    /**
+     * Build an array contains expression for PostgreSQL.
+     *
+     * Uses ANY() for checking if a value is in an array column.
+     *
+     * @param column - The array column name
+     * @param paramIndex - The parameter index
+     * @returns The SQL expression
+     */
+    arrayContains(column, paramIndex) {
+        return `${this.placeholder(paramIndex)} = ANY(${this.quoteIdentifier(column)})`;
+    }
+    /**
+     * Get the PostgreSQL SQL type for an abstract type.
+     *
+     * @param type - The abstract type name
+     * @param options - Type-specific options
+     * @returns The PostgreSQL type string
+     */
+    getSqlType(type, options) {
+        switch (type) {
+            case "string":
+                return options?.length ? `VARCHAR(${options.length})` : "TEXT";
+            case "char":
+                return `CHAR(${options?.length ?? 1})`;
+            case "text":
+                return "TEXT";
+            case "mediumText":
+            case "longText":
+                return "TEXT"; // PostgreSQL doesn't distinguish text sizes
+            case "integer":
+                return "INTEGER";
+            case "smallInteger":
+                return "SMALLINT";
+            case "tinyInteger":
+                return "SMALLINT"; // PostgreSQL doesn't have TINYINT
+            case "bigInteger":
+                return "BIGINT";
+            case "float":
+                return "REAL";
+            case "double":
+                return "DOUBLE PRECISION";
+            case "decimal":
+                if (options?.precision !== undefined) {
+                    const scale = options.scale ?? 0;
+                    return `DECIMAL(${options.precision}, ${scale})`;
+                }
+                return "DECIMAL";
+            case "boolean":
+                return "BOOLEAN";
+            case "date":
+                return "DATE";
+            case "dateTime":
+                return "TIMESTAMP";
+            case "timestamp":
+                return "TIMESTAMPTZ"; // With timezone
+            case "time":
+                return "TIME";
+            case "year":
+                return "SMALLINT"; // PostgreSQL doesn't have YEAR type
+            case "json":
+                return "JSONB"; // Prefer JSONB for indexing and operators
+            case "binary":
+                return "BYTEA";
+            case "uuid":
+                return "UUID";
+            case "ulid":
+                return "CHAR(26)"; // ULIDs are 26 characters
+            case "ipAddress":
+                return "INET";
+            case "macAddress":
+                return "MACADDR";
+            case "point":
+                return "POINT";
+            case "polygon":
+                return "POLYGON";
+            case "lineString":
+                return "PATH";
+            case "geometry":
+                return "GEOMETRY"; // Requires PostGIS
+            case "vector":
+                return options?.length ? `VECTOR(${options.length})` : "VECTOR"; // Requires pgvector
+            case "enum":
+                return "TEXT"; // PostgreSQL enums need CREATE TYPE first
+            case "set":
+                return "TEXT[]"; // Use array for set-like behavior
+            default:
+                return type.toUpperCase();
+        }
+    }
+}export{PostgresDialect};//# sourceMappingURL=postgres-dialect.js.map

package/esm/drivers/postgres/postgres-dialect.js.map

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