@quilla-be-kit/persistence-init-test 0.1.0

package/dist/postgres/pg-query-builder.js

@@ -0,0 +1,260 @@
+import { ALL_FILTER_OPERATORS, FILTER_DELIMITER, } from '../query/field-descriptor.type.js';
+const IDENT_RE = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const QUALIFIED_IDENT_RE = /^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z_][a-zA-Z0-9_]*)?$/;
+// `table` or `schema.table` or `table alias` or `table AS alias`.
+const FROM_RE = /^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z_][a-zA-Z0-9_]*)?(\s+(AS\s+)?[a-zA-Z_][a-zA-Z0-9_]*)?$/i;
+const ALIAS_RE = /^(.+?)\s+AS\s+"([a-zA-Z_][a-zA-Z0-9_]*)"$/i;
+const STAR_RE = /^([a-zA-Z_][a-zA-Z0-9_]*\.)?\*$/;
+const KNOWN_OPERATORS = new Set(ALL_FILTER_OPERATORS);
+const EMPTY_STATE = {
+    columns: [],
+    table: null,
+    joins: [],
+    groupBys: [],
+    rawConditions: [],
+    filterMap: {},
+    sort: null,
+    sortOptions: null,
+    pagination: null,
+};
+export class PgSqlQueryBuilder {
+    resolver;
+    state;
+    constructor(resolver, state = EMPTY_STATE) {
+        this.resolver = resolver;
+        this.state = state;
+    }
+    select(columns) {
+        for (const c of columns)
+            validateSelectColumn(c);
+        return this.fork({ columns: [...columns] });
+    }
+    from(table) {
+        if (!FROM_RE.test(table)) {
+            throw new Error(`SqlQueryBuilder.from: invalid identifier ${JSON.stringify(table)}. Accepts "table", "schema.table", "table alias", or "table AS alias".`);
+        }
+        return this.fork({ table });
+    }
+    join(clause) {
+        return this.fork({ joins: [...this.state.joins, clause] });
+    }
+    groupBy(columns) {
+        for (const c of columns)
+            validateQualifiedIdentifier(c, 'groupBy');
+        return this.fork({ groupBys: [...this.state.groupBys, ...columns] });
+    }
+    where(condition, ...params) {
+        return this.fork({
+            rawConditions: [...this.state.rawConditions, { sql: condition, params }],
+        });
+    }
+    filters(filters) {
+        const merged = { ...this.state.filterMap };
+        for (const [k, v] of Object.entries(filters)) {
+            if (v === undefined)
+                continue;
+            merged[k] = v;
+        }
+        return this.fork({ filterMap: merged });
+    }
+    orderBy(sort, options) {
+        return this.fork({
+            sort: sort ? [...sort] : null,
+            sortOptions: options ?? null,
+        });
+    }
+    paginate(options) {
+        return this.fork({ pagination: options });
+    }
+    build() {
+        if (!this.state.table) {
+            throw new Error('SqlQueryBuilder.build: .from(table) is required');
+        }
+        const params = [];
+        const columnsSql = this.buildColumnsSql();
+        const { whereSql } = this.buildWhereSql(params);
+        let sql = `SELECT ${columnsSql} FROM ${this.state.table}`;
+        for (const j of this.state.joins)
+            sql += ` ${j}`;
+        if (whereSql)
+            sql += ` WHERE ${whereSql}`;
+        if (this.state.groupBys.length > 0) {
+            sql += ` GROUP BY ${this.state.groupBys.map((c) => this.resolveOrPassThrough(c)).join(', ')}`;
+        }
+        const orderSql = this.buildOrderSql();
+        if (orderSql)
+            sql += ` ORDER BY ${orderSql}`;
+        let countSql;
+        if (this.state.pagination) {
+            const { page, pageSize, distinctOn } = this.state.pagination;
+            if (distinctOn?.length) {
+                const distinctCols = distinctOn.map((c) => this.resolveOrPassThrough(c)).join(', ');
+                sql = sql.replace(/^SELECT /, `SELECT DISTINCT ON (${distinctCols}) `);
+            }
+            const offset = Math.max(0, (page - 1) * pageSize);
+            sql += ` LIMIT ${pageSize} OFFSET ${offset}`;
+            countSql = this.buildCountSql(whereSql);
+        }
+        return countSql !== undefined ? { sql, countSql, params } : { sql, params };
+    }
+    fork(patch) {
+        return new PgSqlQueryBuilder(this.resolver, { ...this.state, ...patch });
+    }
+    buildColumnsSql() {
+        if (this.state.columns.length === 0)
+            return '*';
+        return this.state.columns.map((c) => this.projectColumn(c)).join(', ');
+    }
+    projectColumn(column) {
+        if (STAR_RE.test(column))
+            return column;
+        if (ALIAS_RE.test(column))
+            return column;
+        if (column.includes('.')) {
+            validateQualifiedIdentifier(column, 'select');
+            return column;
+        }
+        if (!IDENT_RE.test(column)) {
+            throw new Error(`SqlQueryBuilder.select: invalid column expression ${JSON.stringify(column)}. Use a plain identifier, a qualified "table.col", "*", or pre-aliased "expr AS \\"name\\"".`);
+        }
+        const resolved = this.resolver.resolve(column);
+        return resolved === column ? resolved : `${resolved} AS "${column}"`;
+    }
+    resolveOrPassThrough(key) {
+        if (key.includes('.') || !IDENT_RE.test(key)) {
+            validateQualifiedIdentifier(key, 'column reference');
+            return key;
+        }
+        return this.resolver.resolve(key);
+    }
+    buildWhereSql(params) {
+        const fragments = [];
+        for (const [rawKey, value] of Object.entries(this.state.filterMap)) {
+            const fragment = this.filterFragment(rawKey, value, params);
+            if (fragment)
+                fragments.push(fragment);
+        }
+        for (const raw of this.state.rawConditions) {
+            fragments.push(rebaseQuestionMarks(raw.sql, params, raw.params));
+        }
+        return { whereSql: fragments.join(' AND ') };
+    }
+    filterFragment(rawKey, value, params) {
+        const { field, operator } = parseFilterKey(rawKey);
+        const column = this.resolveOrPassThrough(field);
+        switch (operator) {
+            case 'eq':
+                if (value === null)
+                    return `${column} IS NULL`;
+                return `${column} = ${pushParam(params, value)}`;
+            case 'contains':
+                return `${column} ILIKE ${pushParam(params, `%${String(value)}%`)}`;
+            case 'in':
+                return `${column} = ANY(${pushParam(params, value)})`;
+            case 'notIn':
+                return `(${column} <> ALL(${pushParam(params, value)}) OR ${column} IS NULL)`;
+            case 'gt':
+                return `${column} > ${pushParam(params, value)}`;
+            case 'gte':
+                return `${column} >= ${pushParam(params, value)}`;
+            case 'lt':
+                return `${column} < ${pushParam(params, value)}`;
+            case 'lte':
+                return `${column} <= ${pushParam(params, value)}`;
+            case 'isNull':
+                return value === false ? `${column} IS NOT NULL` : `${column} IS NULL`;
+            case 'isNotNull':
+                return value === false ? `${column} IS NULL` : `${column} IS NOT NULL`;
+            default:
+                return null;
+        }
+    }
+    buildOrderSql() {
+        const { sort, sortOptions } = this.state;
+        const enforced = sortOptions?.enforced ?? [];
+        const defaults = sortOptions?.defaults ?? [];
+        const user = sort ?? [];
+        const effective = user.length > 0 ? [...enforced, ...user] : [...enforced, ...defaults];
+        if (effective.length === 0)
+            return '';
+        const clauses = [];
+        for (const entry of effective) {
+            for (const [field, direction] of Object.entries(entry)) {
+                const column = this.resolveOrPassThrough(field);
+                const dir = direction === 'desc' ? 'DESC' : 'ASC';
+                clauses.push(`${column} ${dir}`);
+            }
+        }
+        return clauses.join(', ');
+    }
+    buildCountSql(whereSql) {
+        // If GROUP BY is present, count must be over the grouped set.
+        if (this.state.groupBys.length > 0) {
+            let inner = `SELECT 1 FROM ${this.state.table}`;
+            for (const j of this.state.joins)
+                inner += ` ${j}`;
+            if (whereSql)
+                inner += ` WHERE ${whereSql}`;
+            inner += ` GROUP BY ${this.state.groupBys
+                .map((c) => this.resolveOrPassThrough(c))
+                .join(', ')}`;
+            return `SELECT COUNT(*)::bigint AS count FROM (${inner}) AS _grouped`;
+        }
+        let sql = `SELECT COUNT(*)::bigint AS count FROM ${this.state.table}`;
+        for (const j of this.state.joins)
+            sql += ` ${j}`;
+        if (whereSql)
+            sql += ` WHERE ${whereSql}`;
+        return sql;
+    }
+}
+function pushParam(params, value) {
+    params.push(value);
+    return `$${params.length}`;
+}
+function rebaseQuestionMarks(sql, targetParams, sourceParams) {
+    let i = 0;
+    const rebased = sql.replace(/\?/g, () => {
+        if (i >= sourceParams.length) {
+            throw new Error(`SqlQueryBuilder.where: more "?" placeholders than parameters in fragment ${JSON.stringify(sql)}`);
+        }
+        targetParams.push(sourceParams[i]);
+        i++;
+        return `$${targetParams.length}`;
+    });
+    if (i < sourceParams.length) {
+        throw new Error(`SqlQueryBuilder.where: more parameters than "?" placeholders in fragment ${JSON.stringify(sql)}`);
+    }
+    return rebased;
+}
+function parseFilterKey(rawKey) {
+    const delimiterIndex = rawKey.indexOf(FILTER_DELIMITER);
+    if (delimiterIndex < 0) {
+        return { field: rawKey, operator: 'eq' };
+    }
+    const field = rawKey.slice(0, delimiterIndex);
+    const opString = rawKey.slice(delimiterIndex + FILTER_DELIMITER.length);
+    if (!KNOWN_OPERATORS.has(opString)) {
+        throw new Error(`SqlQueryBuilder.filters: unknown operator "${opString}" in key "${rawKey}". ` +
+            `Known operators: ${[...KNOWN_OPERATORS].join(', ')}.`);
+    }
+    if (!IDENT_RE.test(field)) {
+        throw new Error(`SqlQueryBuilder.filters: invalid field name "${field}" in key "${rawKey}".`);
+    }
+    return { field, operator: opString };
+}
+function validateSelectColumn(column) {
+    if (STAR_RE.test(column))
+        return;
+    if (ALIAS_RE.test(column))
+        return;
+    if (QUALIFIED_IDENT_RE.test(column))
+        return;
+    throw new Error(`SqlQueryBuilder.select: invalid column expression ${JSON.stringify(column)}. Use a plain identifier, a qualified "table.col", "*", or pre-aliased "expr AS \\"name\\"".`);
+}
+function validateQualifiedIdentifier(value, context) {
+    if (!QUALIFIED_IDENT_RE.test(value)) {
+        throw new Error(`SqlQueryBuilder.${context}: invalid identifier ${JSON.stringify(value)}. Must match /^[a-zA-Z_][a-zA-Z0-9_]*(\\.[a-zA-Z_][a-zA-Z0-9_]*)?$/.`);
+    }
+}
+//# sourceMappingURL=pg-query-builder.js.map

package/dist/postgres/pg-query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-query-builder.js","sourceRoot":"","sources":["../../src/postgres/pg-query-builder.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,mCAAmC,CAAC;AAS3C,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAC5C,MAAM,kBAAkB,GAAG,qDAAqD,CAAC;AACjF,kEAAkE;AAClE,MAAM,OAAO,GACX,0FAA0F,CAAC;AAC7F,MAAM,QAAQ,GAAG,4CAA4C,CAAC;AAC9D,MAAM,OAAO,GAAG,iCAAiC,CAAC;AAElD,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAcnF,MAAM,WAAW,GAAiB;IAChC,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;IACb,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,QAAwB,EACxB,QAAsB,WAAW;QADjC,aAAQ,GAAR,QAAQ,CAAgB;QACxB,UAAK,GAAL,KAAK,CAA4B;IACjD,CAAC;IAEJ,MAAM,CAAC,OAA0B;QAC/B,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,wEAAwE,CAC1I,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,OAA0B;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,2BAA2B,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,GAAG,MAA0B;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC;YACf,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;SACzE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,OAA0C;QAChD,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAS;YAC9B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CACL,IAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;YAC7B,WAAW,EAAE,OAAO,IAAI,IAAI;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEhD,IAAI,GAAG,GAAG,UAAU,UAAU,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,QAAQ;YAAE,GAAG,IAAI,UAAU,QAAQ,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,GAAG,IAAI,aAAa,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChG,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,QAAQ;YAAE,GAAG,IAAI,aAAa,QAAQ,EAAE,CAAC;QAE7C,IAAI,QAA4B,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC7D,IAAI,UAAU,EAAE,MAAM,EAAE,CAAC;gBACvB,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpF,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,uBAAuB,YAAY,IAAI,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;YAClD,GAAG,IAAI,UAAU,QAAQ,WAAW,MAAM,EAAE,CAAC;YAC7C,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC9E,CAAC;IAEO,IAAI,CAAC,KAA4B;QACvC,OAAO,IAAI,iBAAiB,CAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAEO,aAAa,CAAC,MAAc;QAClC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,8FAA8F,CAC1K,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,QAAQ,MAAM,GAAG,CAAC;IACvE,CAAC;IAEO,oBAAoB,CAAC,GAAW;QACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;YACrD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAEO,aAAa,CAAC,MAAiB;QACrC,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5D,IAAI,QAAQ;gBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,CAAC;IAEO,cAAc,CAAC,MAAc,EAAE,KAAc,EAAE,MAAiB;QACtE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAEhD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,IAAI;gBACP,IAAI,KAAK,KAAK,IAAI;oBAAE,OAAO,GAAG,MAAM,UAAU,CAAC;gBAC/C,OAAO,GAAG,MAAM,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACnD,KAAK,UAAU;gBACb,OAAO,GAAG,MAAM,UAAU,SAAS,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACtE,KAAK,IAAI;gBACP,OAAO,GAAG,MAAM,UAAU,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC;YACxD,KAAK,OAAO;gBACV,OAAO,IAAI,MAAM,WAAW,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,MAAM,WAAW,CAAC;YAChF,KAAK,IAAI;gBACP,OAAO,GAAG,MAAM,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACnD,KAAK,KAAK;gBACR,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACpD,KAAK,IAAI;gBACP,OAAO,GAAG,MAAM,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACnD,KAAK,KAAK;gBACR,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACpD,KAAK,QAAQ;gBACX,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,UAAU,CAAC;YACzE,KAAK,WAAW;gBACd,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,cAAc,CAAC;YACzE;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACzC,MAAM,QAAQ,GAAG,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;QACxF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBAChD,MAAM,GAAG,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEO,aAAa,CAAC,QAAgB;QACpC,8DAA8D;QAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,KAAK,GAAG,iBAAiB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAChD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;gBAAE,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,QAAQ;gBAAE,KAAK,IAAI,UAAU,QAAQ,EAAE,CAAC;YAC5C,KAAK,IAAI,aAAa,IAAI,CAAC,KAAK,CAAC,QAAQ;iBACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;iBACxC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChB,OAAO,0CAA0C,KAAK,eAAe,CAAC;QACxE,CAAC;QACD,IAAI,GAAG,GAAG,yCAAyC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACtE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,QAAQ;YAAE,GAAG,IAAI,UAAU,QAAQ,EAAE,CAAC;QAC1C,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,SAAS,CAAC,MAAiB,EAAE,KAAc;IAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAW,EACX,YAAuB,EACvB,YAAgC;IAEhC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE;QACtC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,4EAA4E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAClG,CAAC;QACJ,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,EAAE,CAAC;QACJ,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,4EAA4E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAA0B,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,8CAA8C,QAAQ,aAAa,MAAM,KAAK;YAC5E,oBAAoB,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,aAAa,MAAM,IAAI,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAA0B,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO;IACjC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO;IAClC,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO;IAC5C,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,8FAA8F,CAC1K,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAa,EAAE,OAAe;IACjE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,mBAAmB,OAAO,wBAAwB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,sEAAsE,CAC9I,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/postgres/pg-read-db-adapter.d.ts

@@ -0,0 +1,20 @@
+import type { Database } from '../database/database.interface.js';
+import type { ReadDbAdapter, SelectOptions } from '../db-adapter/read-db-adapter.interface.js';
+import { PgColumnTypeCache } from './pg-sql.js';
+/**
+ * Postgres `ReadDbAdapter`. Query side — never accepts a transaction;
+ * always runs on the pool (or the read-replica pool, depending on which
+ * `Database` is injected).
+ *
+ * Shares the column-type cache with its sibling `PgWriteDbAdapter` when
+ * one is passed in — so a given table's metadata is fetched at most once
+ * per process regardless of which adapter hits it first.
+ */
+export declare class PgReadDbAdapter implements ReadDbAdapter {
+    private readonly db;
+    private readonly columnTypes;
+    constructor(db: Database, columnTypeCache?: PgColumnTypeCache);
+    select<T>(opts: SelectOptions<T>): Promise<readonly T[]>;
+    raw<T>(sql: string, params: readonly unknown[]): Promise<readonly T[]>;
+}
+//# sourceMappingURL=pg-read-db-adapter.d.ts.map

package/dist/postgres/pg-read-db-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-read-db-adapter.d.ts","sourceRoot":"","sources":["../../src/postgres/pg-read-db-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AAE3D;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAIjD,OAAO,CAAC,QAAQ,CAAC,EAAE;IAHrB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAG7B,EAAE,EAAE,QAAQ,EAC7B,eAAe,CAAC,EAAE,iBAAiB;IAK/B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAMxD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;CAI7E"}

package/dist/postgres/pg-read-db-adapter.js

@@ -0,0 +1,28 @@
+import { PgColumnTypeCache, runSelect } from './pg-sql.js';
+/**
+ * Postgres `ReadDbAdapter`. Query side — never accepts a transaction;
+ * always runs on the pool (or the read-replica pool, depending on which
+ * `Database` is injected).
+ *
+ * Shares the column-type cache with its sibling `PgWriteDbAdapter` when
+ * one is passed in — so a given table's metadata is fetched at most once
+ * per process regardless of which adapter hits it first.
+ */
+export class PgReadDbAdapter {
+    db;
+    columnTypes;
+    constructor(db, columnTypeCache) {
+        this.db = db;
+        this.columnTypes = columnTypeCache ?? new PgColumnTypeCache(db);
+    }
+    async select(opts) {
+        const types = await this.columnTypes.get(opts.table);
+        const result = await runSelect(this.db, opts, types, { forUpdate: false });
+        return result.rows;
+    }
+    async raw(sql, params) {
+        const result = await this.db.query(sql, params);
+        return result.rows;
+    }
+}
+//# sourceMappingURL=pg-read-db-adapter.js.map

package/dist/postgres/pg-read-db-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-read-db-adapter.js","sourceRoot":"","sources":["../../src/postgres/pg-read-db-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAIP;IAHF,WAAW,CAAoB;IAEhD,YACmB,EAAY,EAC7B,eAAmC;QADlB,OAAE,GAAF,EAAE,CAAU;QAG7B,IAAI,CAAC,WAAW,GAAG,eAAe,IAAI,IAAI,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,IAAsB;QACpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC,IAAoB,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,MAA0B;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,IAAoB,CAAC;IACrC,CAAC;CACF"}

package/dist/postgres/pg-sql.d.ts

@@ -0,0 +1,44 @@
+import type { DatabaseResult } from '../database/database-result.type.js';
+import type { DatabaseTransaction } from '../database/database-transaction.interface.js';
+import type { Database } from '../database/database.interface.js';
+import type { FilterQuery } from '../db-adapter/filter-query.type.js';
+import type { SelectOptions } from '../db-adapter/read-db-adapter.interface.js';
+export type ColumnTypeMap = Record<string, string>;
+/**
+ * Maps `information_schema.columns.data_type` (or `udt_name` for arrays)
+ * to the Postgres type name used for explicit parameter casting
+ * (`$1::UUID`, `$2::JSONB`, etc.). Unknown types fall back to `TEXT`.
+ */
+export declare function mapPostgresType(dataType: string | undefined): string;
+/**
+ * Builds a parameterised `WHERE` clause from a `FilterQuery`. Scalar values
+ * emit `col = $n::TYPE`; arrays emit `col = ANY($n::TYPE[])`.
+ *
+ * `startIndex` is the placeholder offset — pass the number of params
+ * already consumed upstream (e.g. by a SET clause in UPDATE). Read-side
+ * callers pass `0`.
+ */
+export declare function buildWhere<T>(filters: FilterQuery<T>, types: ColumnTypeMap, startIndex?: number): {
+    sql: string;
+    values: unknown[];
+};
+/**
+ * Assembles a parameterised `SELECT` statement for the shared read path
+ * (used by both `PgWriteDbAdapter.find*` and `PgReadDbAdapter.select`).
+ */
+export declare function runSelect<T>(db: Database, opts: SelectOptions<T>, types: ColumnTypeMap, flags: {
+    forUpdate: boolean;
+    trx?: DatabaseTransaction | undefined;
+}): Promise<DatabaseResult>;
+/**
+ * Caches column types per table across the life of a process. Shared by
+ * `PgWriteDbAdapter` and `PgReadDbAdapter` so a given table's metadata is
+ * fetched at most once, regardless of which adapter gets there first.
+ */
+export declare class PgColumnTypeCache {
+    private readonly db;
+    private readonly cache;
+    constructor(db: Database);
+    get(table: string): Promise<ColumnTypeMap>;
+}
+//# sourceMappingURL=pg-sql.d.ts.map

package/dist/postgres/pg-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-sql.d.ts","sourceRoot":"","sources":["../../src/postgres/pg-sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAEhF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAwCpE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,aAAa,EACpB,UAAU,SAAI,GACb;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAkBpC;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;CAAE,GACnE,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAMD;;;;GAIG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,EAAE;IAF/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE7B,EAAE,EAAE,QAAQ;IAEnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAgBjD"}

package/dist/postgres/pg-sql.js

@@ -0,0 +1,128 @@
+/**
+ * Maps `information_schema.columns.data_type` (or `udt_name` for arrays)
+ * to the Postgres type name used for explicit parameter casting
+ * (`$1::UUID`, `$2::JSONB`, etc.). Unknown types fall back to `TEXT`.
+ */
+export function mapPostgresType(dataType) {
+    if (!dataType)
+        return 'TEXT';
+    switch (dataType) {
+        case 'uuid':
+            return 'UUID';
+        case 'integer':
+        case 'smallint':
+        case 'bigint':
+            return 'INTEGER';
+        case 'boolean':
+            return 'BOOLEAN';
+        case 'timestamp without time zone':
+        case 'timestamp with time zone':
+        case 'timestamptz':
+            return 'TIMESTAMPTZ';
+        case 'date':
+            return 'DATE';
+        case 'numeric':
+        case 'real':
+        case 'double precision':
+            return 'NUMERIC';
+        case 'json':
+            return 'JSON';
+        case 'jsonb':
+            return 'JSONB';
+        case 'text':
+        case 'character varying':
+            return 'TEXT';
+        case 'bytea':
+            return 'BYTEA';
+        case '_uuid':
+            return 'UUID[]';
+        case '_int4':
+            return 'INTEGER[]';
+        case '_text':
+        case '_varchar':
+            return 'TEXT[]';
+        default:
+            return 'TEXT';
+    }
+}
+/**
+ * Builds a parameterised `WHERE` clause from a `FilterQuery`. Scalar values
+ * emit `col = $n::TYPE`; arrays emit `col = ANY($n::TYPE[])`.
+ *
+ * `startIndex` is the placeholder offset — pass the number of params
+ * already consumed upstream (e.g. by a SET clause in UPDATE). Read-side
+ * callers pass `0`.
+ */
+export function buildWhere(filters, types, startIndex = 0) {
+    const entries = Object.entries(filters);
+    if (entries.length === 0) {
+        throw new Error('WHERE clause requires at least one filter');
+    }
+    const values = [];
+    const clauses = entries.map(([key, value]) => {
+        const pgType = mapPostgresType(types[key]);
+        if (Array.isArray(value)) {
+            values.push(value);
+            return `${key} = ANY($${startIndex + values.length}::${pgType}[])`;
+        }
+        values.push(value);
+        return `${key} = $${startIndex + values.length}::${pgType}`;
+    });
+    return { sql: clauses.join(' AND '), values };
+}
+/**
+ * Assembles a parameterised `SELECT` statement for the shared read path
+ * (used by both `PgWriteDbAdapter.find*` and `PgReadDbAdapter.select`).
+ */
+export async function runSelect(db, opts, types, flags) {
+    const columns = opts.columns?.length ? opts.columns.join(', ') : '*';
+    let sql = `SELECT ${columns} FROM ${opts.table}`;
+    const values = [];
+    if (opts.where && Object.keys(opts.where).length > 0) {
+        const where = buildWhere(opts.where, types);
+        values.push(...where.values);
+        sql += ` WHERE ${where.sql}`;
+    }
+    if (opts.orderBy?.length) {
+        const orderClauses = opts.orderBy.map((o) => `${o.column} ${o.direction.toUpperCase()}`);
+        sql += ` ORDER BY ${orderClauses.join(', ')}`;
+    }
+    if (opts.limit !== undefined) {
+        sql += ` LIMIT ${opts.limit}`;
+    }
+    if (flags.forUpdate) {
+        sql += ' FOR UPDATE';
+    }
+    return db.query(sql, values, flags.trx);
+}
+const INFO_SCHEMA_SQL = `SELECT column_name, data_type, udt_name
+       FROM information_schema.columns
+       WHERE table_name = $1`;
+/**
+ * Caches column types per table across the life of a process. Shared by
+ * `PgWriteDbAdapter` and `PgReadDbAdapter` so a given table's metadata is
+ * fetched at most once, regardless of which adapter gets there first.
+ */
+export class PgColumnTypeCache {
+    db;
+    cache = new Map();
+    constructor(db) {
+        this.db = db;
+    }
+    async get(table) {
+        const cached = this.cache.get(table);
+        if (cached)
+            return cached;
+        const result = await this.db.query(INFO_SCHEMA_SQL, [table]);
+        const types = {};
+        for (const row of result.rows) {
+            const name = String(row.column_name);
+            const dataType = String(row.data_type);
+            const udtName = String(row.udt_name);
+            types[name] = dataType === 'ARRAY' ? udtName : dataType;
+        }
+        this.cache.set(table, types);
+        return types;
+    }
+}
+//# sourceMappingURL=pg-sql.js.map

package/dist/postgres/pg-sql.js.map

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

package/dist/postgres/pg-write-db-adapter.d.ts

@@ -0,0 +1,30 @@
+import type { DatabaseResult } from '../database/database-result.type.js';
+import type { DatabaseTransaction } from '../database/database-transaction.interface.js';
+import type { Database } from '../database/database.interface.js';
+import type { SelectOptions } from '../db-adapter/read-db-adapter.interface.js';
+import type { DeleteOptions, ExistsOptions, InsertOptions, UpdateManyOptions, UpdateOptions, WriteDbAdapter } from '../db-adapter/write-db-adapter.interface.js';
+import { PgColumnTypeCache } from './pg-sql.js';
+/**
+ * Postgres `WriteDbAdapter`. Resolves column types once per table via
+ * `PgColumnTypeCache`, emits explicit parameter casts, JSON.stringify's
+ * JSONB values, and renders millisecond-truncated timestamps so
+ * optimistic-lock comparisons round-trip with JS `Date`.
+ *
+ * Accepts an optional shared `PgColumnTypeCache` so a sibling
+ * `PgReadDbAdapter` can share the same type cache (one info-schema fetch
+ * per table, regardless of which adapter hits it first).
+ */
+export declare class PgWriteDbAdapter implements WriteDbAdapter {
+    private readonly columnTypes;
+    constructor(db: Database, columnTypeCache?: PgColumnTypeCache);
+    private readonly db;
+    insert(opts: InsertOptions, trx?: DatabaseTransaction): Promise<DatabaseResult>;
+    update<T>(opts: UpdateOptions<T>, trx?: DatabaseTransaction): Promise<DatabaseResult>;
+    updateMany(opts: UpdateManyOptions, trx?: DatabaseTransaction): Promise<DatabaseResult>;
+    delete<T>(opts: DeleteOptions<T>, trx?: DatabaseTransaction): Promise<DatabaseResult>;
+    find<T>(opts: SelectOptions<T>, trx?: DatabaseTransaction): Promise<readonly T[]>;
+    findForUpdate<T>(opts: SelectOptions<T>, trx: DatabaseTransaction): Promise<readonly T[]>;
+    exists<T>(opts: ExistsOptions<T>, trx?: DatabaseTransaction): Promise<boolean>;
+    private executeSelect;
+}
+//# sourceMappingURL=pg-write-db-adapter.d.ts.map

package/dist/postgres/pg-write-db-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-write-db-adapter.d.ts","sourceRoot":"","sources":["../../src/postgres/pg-write-db-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAA0C,MAAM,aAAa,CAAC;AAMxF;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAEpC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,iBAAiB;IAK7D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAExB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IA6B/E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BrF,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqCvF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAOrF,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAKjF,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAKzF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;YAQtE,aAAa;CAQ5B"}