orez 0.2.34 → 0.3.0

package/dist/bench/serial-mutations.bench.js

@@ -10,7 +10,7 @@ import WebSocket from 'ws';
 import { startZeroLite } from '../index.js';
 import { ensureTablesInPublications, installAllowAllPermissions, } from '../integration/test-permissions.js';
 import { installChangeTracking } from '../replication/change-tracker.js';
-const SYNC_PROTOCOL_VERSION = 49;
+const SYNC_PROTOCOL_VERSION = 50;
 const NUM_MUTATIONS = 100;
 // test schema
 const CLIENT_SCHEMA = {

package/dist/cf-do/worker.d.ts

@@ -9,7 +9,7 @@ import { DurableObject } from 'cloudflare:workers';
  * for zero-cache.
  *
  * Modes:
- *   WS /sync/v49/connect — bespoke Zero sync protocol (dev/protocol testing)
+ *   WS /sync/v50/connect — bespoke Zero sync protocol (dev/protocol testing)
  *   POST /exec — raw SQL execution (from DoBackend adapter)
  *   POST /batch — atomic batch execution via ctx.storage.transaction()
  */

package/dist/pg-proxy-do-backend.d.ts

@@ -57,6 +57,8 @@ export declare class DoBackend {
     private trackingForStatement;
     private trackingRequest;
     private visibleResultForTracking;
+    private currentPublishedSchema;
+    private materializePublishedSchemaFunctions;
     private handleParse;
     private handleBind;
     private handleExecute;
@@ -109,6 +111,7 @@ export declare class DoBackend {
     private publicationTableSpec;
     private publishedTablesResult;
     private publishedIndexesResult;
+    private publishedSchemaResult;
     private pgTypeArrayResult;
     private sqlLiteral;
     private inlineParams;
@@ -116,6 +119,9 @@ export declare class DoBackend {
     private sqliteBoundSQL;
     private buildSQLResponse;
     private copyTextValue;
+    private copyBinaryValue;
+    private copyBinaryRow;
+    private buildBinaryCopyResponse;
     private buildCopyResponse;
     private fieldMetadataForResultColumn;
     private fieldsForResult;

package/dist/pg-proxy-do-backend.d.ts.map

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

package/dist/pg-proxy-do-backend.js

@@ -60,6 +60,10 @@ function i32(v, buf = new ArrayBuffer(4)) {
     new DataView(buf).setInt32(0, v);
     return new Uint8Array(buf);
 }
+function i64(v, buf = new ArrayBuffer(8)) {
+    new DataView(buf).setBigInt64(0, v);
+    return new Uint8Array(buf);
+}
 function int4(v, buf = new ArrayBuffer(4)) {
     new DataView(buf).setInt32(0, v);
     return new Uint8Array(buf);
@@ -946,7 +950,7 @@ function rewriteColumnRefQualifier(node, from, to) {
         return;
     }
     const fields = node.ColumnRef?.fields;
-    if (Array.isArray(fields) && stringValue(fields[0]) === from) {
+    if (Array.isArray(fields) && fields.length > 1 && stringValue(fields[0]) === from) {
         fields[0] = stringNode(to);
     }
     for (const child of Object.values(node)) {
@@ -1510,12 +1514,15 @@ function unwrapJsonEachArraySubLinkArg(arg) {
 function isDistinctOnClause(clause) {
     return (Array.isArray(clause) && clause.some((item) => item && Object.keys(item).length > 0));
 }
-function buildCopyOutResponse(columnCount) {
-    return msg(0x48, concat(new Uint8Array([0]), i16(columnCount), ...Array.from({ length: columnCount }, () => i16(0))));
+function buildCopyOutResponse(columnCount, binary = false) {
+    return msg(0x48, concat(new Uint8Array([binary ? 1 : 0]), i16(columnCount), ...Array.from({ length: columnCount }, () => i16(binary ? 1 : 0))));
 }
 function buildCopyData(data) {
     return msg(0x64, textEncoder.encode(data));
 }
+function buildCopyDataBytes(data) {
+    return msg(0x64, data);
+}
 function buildCopyDone() {
     return msg(0x63, new Uint8Array(0));
 }
@@ -1640,8 +1647,78 @@ function rewriteDistinctOnSelect(stmt) {
         op: 'SETOP_NONE',
     };
 }
+function flattenSelectRangeVarQualifiers(stmt) {
+    const visitFromNode = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        const rangeVar = node.RangeVar;
+        if (rangeVar?.schemaname && rangeVar.relname) {
+            const from = rangeVar.alias?.aliasname ? null : rangeVar.relname;
+            const to = flattenRangeVar(rangeVar);
+            if (from && to)
+                rewriteColumnRefQualifier(stmt, from, to);
+            return;
+        }
+        const join = node.JoinExpr;
+        if (join) {
+            visitFromNode(join.larg);
+            visitFromNode(join.rarg);
+        }
+    };
+    for (const fromNode of stmt?.fromClause ?? [])
+        visitFromNode(fromNode);
+}
+function selectRangeVarNames(stmt) {
+    const names = new Set();
+    const visitFromNode = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        const rangeVar = node.RangeVar;
+        if (rangeVar?.relname) {
+            names.add(rangeVar.relname);
+            if (rangeVar.alias?.aliasname)
+                names.add(rangeVar.alias.aliasname);
+            return;
+        }
+        const join = node.JoinExpr;
+        if (join) {
+            visitFromNode(join.larg);
+            visitFromNode(join.rarg);
+        }
+    };
+    for (const fromNode of stmt?.fromClause ?? [])
+        visitFromNode(fromNode);
+    return names;
+}
+function rewritePgColumnSizeCompositeArgs(value, sourceNames) {
+    if (!value || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => rewritePgColumnSizeCompositeArgs(item, sourceNames));
+    if (value.FuncCall && functionName(value.FuncCall) === 'pg_column_size') {
+        const arg = value.FuncCall.args?.[0];
+        const fields = arg?.ColumnRef?.fields;
+        if (Array.isArray(fields) && fields.length === 1) {
+            const name = stringValue(fields[0]);
+            if (name && sourceNames.has(name))
+                return intConst(0);
+        }
+        else if (Array.isArray(fields) && fields.length === 2) {
+            const schema = stringValue(fields[0]);
+            const table = stringValue(fields[1]);
+            if (schema && table && sourceNames.has(flattenSchemaName(schema, table)))
+                return intConst(0);
+        }
+    }
+    for (const [key, child] of Object.entries(value)) {
+        value[key] = rewritePgColumnSizeCompositeArgs(child, sourceNames);
+    }
+    return value;
+}
 function normalizeSelectStmt(stmt) {
     const normalized = rewriteDistinctOnSelect(stmt);
+    flattenSelectRangeVarQualifiers(normalized);
+    rewritePgColumnSizeCompositeArgs(normalized, selectRangeVarNames(normalized));
     rewriteRowToJsonSelect(normalized);
     delete normalized.lockingClause;
     return normalized;
@@ -2497,10 +2574,20 @@ function rewriteSkippedFunctionInvocationSelect(stmt, context) {
     const name = functionName(funcCall);
     if (!name || !skippedFunctionNames.has(name))
         return false;
+    if (name === 'schema_specs')
+        return false;
     target.name ??= functionDisplayName(funcCall) ?? name;
     target.val = nullConst();
     return true;
 }
+function replaceSchemaSpecsFunctionCalls(sql) {
+    let count = 0;
+    const replaced = sql.replace(/(?:(?:"(?:[^"]|"")+"|[A-Za-z_][A-Za-z0-9_$]*)\s*\.\s*)?schema_specs\s*\(\s*\)/gi, () => {
+        count++;
+        return '?';
+    });
+    return { sql: replaced, count };
+}
 function deparseStatement(version, stmt) {
     return stripTrailingSemicolon(deparseSync({ version, stmts: [{ stmt }] }).trim());
 }
@@ -3115,8 +3202,10 @@ function rewriteParsedStatement(version, rawStmt, context) {
         for (const object of node.objects ?? []) {
             const items = object.List?.items ?? [];
             const name = stringValue(items[items.length - 1]);
-            if (name)
+            if (name) {
+                context?.skippedFunctionNames?.delete(name.toLowerCase());
                 context?.triggerFunctions?.delete(name.toLowerCase());
+            }
         }
         return null;
     }
@@ -3265,12 +3354,15 @@ function rewriteParsedStatement(version, rawStmt, context) {
         nodeType === 'IndexStmt' ||
         nodeType === 'RenameStmt';
     const isWrite = nodeType === 'DeleteStmt' || nodeType === 'InsertStmt' || nodeType === 'UpdateStmt';
+    const usesPublishedSchemaFunction = context?.skippedFunctionNames?.has('schema_specs') &&
+        containsFuncCall(stmt, 'schema_specs');
     return {
         sql: rewritten,
         ...(isDDL ? { isDDL } : null),
         ...(isWrite ? { isWrite } : null),
         ...(writeTable ? { writeTable } : null),
         ...(changeTracking ? { changeTracking } : null),
+        ...(usesPublishedSchemaFunction ? { usesPublishedSchemaFunction } : null),
         ...(context?.arrayParamNumbers?.size
             ? { arrayParamNumbers: new Set(context.arrayParamNumbers) }
             : null),
@@ -3441,10 +3533,18 @@ function copySelectSQL(sql) {
         const copy = parsed.stmts[0]?.stmt?.CopyStmt;
         if (!copy?.query?.SelectStmt)
             return null;
-        return stripTrailingSemicolon(deparseSync({
-            version: parsed.version,
-            stmts: [{ stmt: { SelectStmt: copy.query.SelectStmt } }],
-        }).trim());
+        const binary = (copy.options ?? []).some((option) => {
+            const def = option.DefElem;
+            return (def?.defname?.toLowerCase?.() === 'format' &&
+                stringValue(def.arg)?.toLowerCase() === 'binary');
+        });
+        return {
+            sql: stripTrailingSemicolon(deparseSync({
+                version: parsed.version,
+                stmts: [{ stmt: { SelectStmt: copy.query.SelectStmt } }],
+            }).trim()),
+            binary,
+        };
     }
     catch {
         return null;
@@ -4463,9 +4563,10 @@ export class DoBackend {
                 return;
             // single multi-row INSERT OR REPLACE per chunk. previously this was one
             // HTTP roundtrip per row, which dominated boot when migrations touched
-            // many columns. SQLite caps host params near 999; 4 cols × 200 rows
-            // leaves comfortable headroom.
-            const CHUNK = 200;
+            // many columns. Cloudflare DO SQLite has a lower host-param cap than
+            // stock SQLite; 4 cols × 20 rows keeps metadata persistence comfortably
+            // below that limit.
+            const CHUNK = 20;
             for (let i = 0; i < rows.length; i += CHUNK) {
                 const chunk = rows.slice(i, i + CHUNK);
                 const placeholders = chunk.map(() => '(?, ?, ?, ?)').join(', ');
@@ -4713,9 +4814,9 @@ export class DoBackend {
         }
         const copySelect = copySelectSQL(sql);
         if (copySelect) {
-            const rewrittenCopySelect = this.rewriteSQL(copySelect);
+            const rewrittenCopySelect = this.rewriteSQL(copySelect.sql);
             const result = await this.doExecResult(rewrittenCopySelect);
-            return this.buildCopyResponse(result, copySelect);
+            return this.buildCopyResponse(result, copySelect.sql, copySelect.binary);
         }
         // Prepare query
         const rewrittenStatements = this.rewriteSQLStatements(sql);
@@ -4889,6 +4990,26 @@ export class DoBackend {
             return projectReturningResult(result, tracking.returningProjection);
         return result;
     }
+    async currentPublishedSchema(publications = [...this.publications.keys()]) {
+        const infos = await this.publicationTableInfos(publications);
+        return {
+            tables: infos.map((info) => this.publicationTableSpec(info, publications)),
+            indexes: infos.flatMap((info) => info.indexes),
+        };
+    }
+    async materializePublishedSchemaFunctions(sql, statement, params = []) {
+        if (!statement?.usesPublishedSchemaFunction)
+            return { sql, params };
+        const replaced = replaceSchemaSpecsFunctionCalls(sql);
+        if (replaced.count === 0)
+            return { sql, params };
+        const schema = await this.currentPublishedSchema();
+        const value = JSON.stringify(schema);
+        return {
+            sql: replaced.sql,
+            params: [...params, ...Array.from({ length: replaced.count }, () => value)],
+        };
+    }
     // ── Extended protocol handlers ──────────────────────────────────────────
     handleParse(data) {
         const sql = extractParseQuery(data);
@@ -5029,9 +5150,9 @@ export class DoBackend {
             if (statement)
                 await this.snapshotTransactionWrite(statement);
             const tracking = statement ? this.trackingForStatement(statement) : undefined;
-            const execSql = tracking?.returningSQL ?? sql;
-            const bound = this.sqliteBoundSQL(execSql, portal.params, portal.arrayParamNumbers, portal.jsonParamNumbers, portal.timestampParamNumbers, portal.epochMillisParamNumbers, portal.booleanParamNumbers);
-            const result = await this.doExecResult(bound.sql, bound.params, tracking ? this.trackingRequest(tracking) : undefined);
+            const bound = this.sqliteBoundSQL(tracking?.returningSQL ?? sql, portal.params, portal.arrayParamNumbers, portal.jsonParamNumbers, portal.timestampParamNumbers, portal.epochMillisParamNumbers, portal.booleanParamNumbers);
+            const exec = await this.materializePublishedSchemaFunctions(bound.sql, statement, bound.params);
+            const result = await this.doExecResult(exec.sql, exec.params, tracking ? this.trackingRequest(tracking) : undefined);
             if (portal.schemaColumns?.length) {
                 await this.applyStatementMetadata([{ sql, schemaColumns: portal.schemaColumns }]);
             }
@@ -5111,6 +5232,12 @@ export class DoBackend {
         if (isCatalogQuery(rewritten))
             return (await this.handleCatalogQuery(rewritten)).rows;
         const statement = statements.length === 1 ? statements[0] : undefined;
+        if (statements.some((item) => item.usesPublishedSchemaFunction)) {
+            const result = await this.executeRewrittenStatements(statements);
+            await this.applyStatementMetadata(statements);
+            const tracking = statement ? this.trackingForStatement(statement) : undefined;
+            return this.visibleResultForTracking(result, tracking).rows;
+        }
         if (statement)
             await this.snapshotTransactionWrite(statement);
         const tracking = statement ? this.trackingForStatement(statement) : undefined;
@@ -5180,7 +5307,8 @@ export class DoBackend {
         const execBound = tracking
             ? this.sqliteBoundSQL(tracking.returningSQL, params, arrayParamNumbers, jsonParamNumbers, timestampParamNumbers, epochMillisParamNumbers, booleanParamNumbers)
             : bound;
-        const result = await this.doExecResult(execBound.sql, execBound.params, tracking ? this.trackingRequest(tracking) : undefined);
+        const exec = await this.materializePublishedSchemaFunctions(execBound.sql, statement, execBound.params);
+        const result = await this.doExecResult(exec.sql, exec.params, tracking ? this.trackingRequest(tracking) : undefined);
         await this.applyStatementMetadata(statements);
         return { rows: this.visibleResultForTracking(result, tracking).rows };
     }
@@ -5219,6 +5347,7 @@ export class DoBackend {
         return (statements.length > 0 &&
             statements.every((statement) => statement.sql.trim() &&
                 !statement.isDDL &&
+                !statement.usesPublishedSchemaFunction &&
                 !statement.schemaColumns?.length &&
                 !statement.schemaMetadataChanges?.length &&
                 !statement.publicationChanges?.length));
@@ -5425,7 +5554,8 @@ export class DoBackend {
             return { rows: [], columns: [] };
         await this.snapshotTransactionWrite(statement);
         const tracking = this.trackingForStatement(statement);
-        return this.doExecResult(tracking?.returningSQL ?? statement.sql, undefined, tracking ? this.trackingRequest(tracking) : undefined);
+        const exec = await this.materializePublishedSchemaFunctions(tracking?.returningSQL ?? statement.sql, statement);
+        return this.doExecResult(exec.sql, exec.params, tracking ? this.trackingRequest(tracking) : undefined);
     }
     async executeRewrittenStatements(statements) {
         let result = { rows: [], columns: [] };
@@ -5469,12 +5599,16 @@ export class DoBackend {
                 }
             }
             const tracking = this.trackingForStatement(item);
+            const exec = await this.materializePublishedSchemaFunctions(tracking?.returningSQL ?? item.sql, item);
             sqls.push(tracking
                 ? {
-                    sql: tracking.returningSQL,
+                    sql: exec.sql,
+                    ...(exec.params.length ? { params: exec.params } : null),
                     track: this.trackingRequest(tracking),
                 }
-                : item.sql);
+                : exec.params.length
+                    ? { sql: exec.sql, params: exec.params }
+                    : exec.sql);
         }
         await flush();
     }
@@ -5944,6 +6078,27 @@ export class DoBackend {
             fields: [{ name: 'indexes', oid: PG_TYPE_JSON }],
         };
     }
+    async publishedSchemaResult(select) {
+        const fields = selectTargetFields(select);
+        if (!fields.some((field) => field.name === 'publishedSchema'))
+            return null;
+        if (!selectReferencesTable(select, 'pg_publication_tables'))
+            return null;
+        const requested = stringFilterValues(select, 'pubname');
+        const publications = requested.length ? requested : [...this.publications.keys()];
+        const infos = await this.publicationTableInfos(publications);
+        return {
+            rows: [
+                {
+                    publishedSchema: {
+                        tables: infos.map((info) => this.publicationTableSpec(info, publications)),
+                        indexes: infos.flatMap((info) => info.indexes),
+                    },
+                },
+            ],
+            fields: [{ name: 'publishedSchema', oid: PG_TYPE_JSON }],
+        };
+    }
     pgTypeArrayResult(select) {
         if (!selectReferencesTable(select, 'pg_type'))
             return null;
@@ -6279,7 +6434,58 @@ export class DoBackend {
         }
         return out;
     }
-    buildCopyResponse(result, sql = '') {
+    copyBinaryValue(column, value, field) {
+        if (value === null || value === undefined)
+            return null;
+        const oid = field?.oid;
+        if (oid === PG_TYPE_BOOL)
+            return new Uint8Array([value === true || value === 1 ? 1 : 0]);
+        if (oid === PG_TYPE_INT2)
+            return i16(Number(value));
+        if (oid === PG_TYPE_INT4)
+            return i32(Number(value));
+        if (oid === PG_TYPE_INT8)
+            return i64(BigInt(value));
+        if (oid === PG_TYPE_FLOAT8) {
+            const buf = new ArrayBuffer(8);
+            new DataView(buf).setFloat64(0, Number(value));
+            return new Uint8Array(buf);
+        }
+        if (oid === PG_TYPE_TIMESTAMP || oid === PG_TYPE_TIMESTAMPTZ) {
+            const millis = timestampMillisValue(value);
+            const finite = typeof millis === 'number' && Number.isFinite(millis) ? millis : 0;
+            return i64(BigInt(Math.round((finite - 946684800000) * 1000)));
+        }
+        if (oid === PG_TYPE_JSONB) {
+            const json = typeof value === 'string' ? value : JSON.stringify(sqliteJsonParamValue(value));
+            return concat(new Uint8Array([1]), textEncoder.encode(json));
+        }
+        if (oid === PG_TYPE_BYTEA && value instanceof Uint8Array)
+            return value;
+        if (oid === PG_TYPE_JSON) {
+            const json = typeof value === 'string' ? value : JSON.stringify(sqliteJsonParamValue(value));
+            return textEncoder.encode(json);
+        }
+        return textEncoder.encode(this.copyTextValue(column, value, field));
+    }
+    copyBinaryRow(columns, row, fields) {
+        const parts = [i16(columns.length)];
+        for (const [index, column] of columns.entries()) {
+            const value = this.copyBinaryValue(column, row[column], fields[index]);
+            if (value === null) {
+                parts.push(i32(-1));
+            }
+            else {
+                parts.push(i32(value.length), value);
+            }
+        }
+        return concat(...parts);
+    }
+    buildBinaryCopyResponse(result, columns, fields) {
+        const header = concat(new Uint8Array([80, 71, 67, 79, 80, 89, 10, 255, 13, 10, 0]), i32(0), i32(0));
+        return concat(buildCopyOutResponse(columns.length, true), buildCopyDataBytes(header), ...result.rows.map((row) => buildCopyDataBytes(this.copyBinaryRow(columns, row, fields))), buildCopyDataBytes(i16(-1)), buildCopyDone(), buildCommandComplete(`COPY ${result.rows.length}`), this.readyForQuery());
+    }
+    buildCopyResponse(result, sql = '', binary = false) {
         const columns = result.columns.length > 0
             ? result.columns
             : result.rows.length > 0
@@ -6289,6 +6495,8 @@ export class DoBackend {
             name,
             oid: sql ? this.fieldMetadataForResultColumn(sql, name)?.oid : undefined,
         }));
+        if (binary)
+            return this.buildBinaryCopyResponse(result, columns, fields);
         return concat(buildCopyOutResponse(columns.length), ...result.rows.map((row) => buildCopyData(`${columns.map((column, index) => this.copyTextValue(column, row[column], fields[index])).join('\t')}\n`)), buildCopyDone(), buildCommandComplete(`COPY ${result.rows.length}`), this.readyForQuery());
     }
     fieldMetadataForResultColumn(sql, column) {
@@ -6435,6 +6643,7 @@ export class DoBackend {
             (await this.informationSchemaKeyColumnsResult(select)) ??
             (await this.informationSchemaColumnsResult(select)) ??
             this.pgTypeArrayResult(select) ??
+            (await this.publishedSchemaResult(select)) ??
             (await this.publishedTablesResult(select)) ??
             (await this.publishedIndexesResult(select)) ??
             (await this.pgPublicationTablesResult(select)) ??