orez 0.4.46 → 0.4.48

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

@@ -49,7 +49,9 @@ export declare class DoBackend {
     private ensureMetadataTable;
     private publicationToJSON;
     private publicationFromJSON;
+    private hydrateSchemaMetadataRow;
     private loadDurableMetadata;
+    private reloadSchemaMetadataIfEmpty;
     private reloadPublicationsIfEmpty;
     private repairShardMetadataPublications;
     private persistDurableMetadata;
@@ -129,6 +131,7 @@ export declare class DoBackend {
     private generatedIndexName;
     private uniqueIndexName;
     private sqliteIndexColumnsFromRows;
+    private promotedUniqueIndexKey;
     private tableIndexInfos;
     private publicationContainsTable;
     private publicationsForTable;

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

@@ -4859,6 +4859,17 @@ export class DoBackend {
             return null;
         }
     }
+    hydrateSchemaMetadataRow(tableName, columnName, value) {
+        const metadata = JSON.parse(value);
+        let table = this.schemaMetadata.get(tableName);
+        if (!table) {
+            table = new Map();
+            this.schemaMetadata.set(tableName, table);
+        }
+        const changed = JSON.stringify(table.get(columnName)) !== value;
+        table.set(columnName, metadata);
+        return changed;
+    }
     async loadDurableMetadata() {
         try {
             await this.ensureMetadataTable();
@@ -4871,13 +4882,7 @@ export class DoBackend {
                 const value = String(row.value ?? '');
                 this.lastPersistedMetadata.set(`${kind}\u0000${key}\u0000${subkey}`, value);
                 if (kind === 'schema-column') {
-                    const metadata = JSON.parse(value);
-                    let table = this.schemaMetadata.get(key);
-                    if (!table) {
-                        table = new Map();
-                        this.schemaMetadata.set(key, table);
-                    }
-                    table.set(subkey, metadata);
+                    this.hydrateSchemaMetadataRow(key, subkey, value);
                 }
                 else if (kind === 'publication') {
                     const publication = this.publicationFromJSON(value);
@@ -4894,6 +4899,42 @@ export class DoBackend {
         }
         catch { }
     }
+    // Schema migrations persist PostgreSQL type metadata directly into the
+    // shared SQL DO, outside this backend instance. If this backend initialized
+    // first, its one-time load cached an empty schema and requests then exposed
+    // physical SQLite INTEGER/TEXT types to zero forever. Refresh before parsing
+    // any request so prepared statements also get semantic parameter types. Do
+    // not negative-cache an empty read: the migration may commit immediately
+    // after it, which is the race this self-heal exists to close.
+    async reloadSchemaMetadataIfEmpty() {
+        if (this.dbName !== 'postgres' || this.schemaMetadata.size > 0)
+            return;
+        try {
+            await this.ensureMetadataTable();
+            const result = await this.doExecResult(`SELECT kind, key, subkey, value FROM ${quoteIdentifier(METADATA_TABLE)} WHERE kind = 'schema-column'`);
+            let changed = false;
+            const persisted = this.lastPersistedMetadata ?? new Map();
+            this.lastPersistedMetadata = persisted;
+            for (const row of result.rows) {
+                const key = String(row.key ?? '');
+                const subkey = String(row.subkey ?? '');
+                const value = String(row.value ?? '');
+                changed = this.hydrateSchemaMetadataRow(key, subkey, value) || changed;
+                persisted.set(`schema-column\u0000${key}\u0000${subkey}`, value);
+            }
+            if (changed) {
+                if (this.txSnapshot) {
+                    // The rows were committed out-of-band, not by this transaction. A
+                    // later ROLLBACK must preserve them rather than restoring the stale
+                    // empty snapshot captured before the migration finished.
+                    this.txSnapshot.schemaMetadata = this.cloneSchemaMetadata(this.schemaMetadata);
+                }
+                this.rewriteCache.clear();
+                this.publicationTableInfoCache = null;
+            }
+        }
+        catch { }
+    }
     // self-heal a stale-empty publication cache. publications are durable
     // (_orez_pg_metadata) and SHARED across every DoBackend instance pointed at
     // one DO, but each instance only loads them once at init(). when this
@@ -5206,8 +5247,10 @@ export class DoBackend {
         try {
             switch (msgType) {
                 case FT_QUERY:
+                    await this.reloadSchemaMetadataIfEmpty();
                     return this.handleSimpleQuery(message);
                 case FT_PARSE:
+                    await this.reloadSchemaMetadataIfEmpty();
                     return this.handleParse(message);
                 case FT_BIND:
                     return this.handleBind(message);
@@ -5706,6 +5749,7 @@ export class DoBackend {
     async execLocked(sql) {
         if (!this.ready)
             await this.waitReady;
+        await this.reloadSchemaMetadataIfEmpty();
         if (await this.handleTransactionControl(sql))
             return [];
         const statements = this.rewriteSQLStatements(sql);
@@ -5761,6 +5805,7 @@ export class DoBackend {
     async queryLocked(sql, params) {
         if (!this.ready)
             await this.waitReady;
+        await this.reloadSchemaMetadataIfEmpty();
         if (await this.handleTransactionControl(sql))
             return { rows: [] };
         const statements = this.rewriteSQLStatements(sql);
@@ -6262,6 +6307,54 @@ export class DoBackend {
             columns[row.name] = row.desc === 1 ? 'DESC' : 'ASC';
         return columns;
     }
+    // a table with no PRIMARY KEY but a full, non-partial UNIQUE index is keyed
+    // by that index — the shape soot's DDL generator emits for composite drizzle
+    // primaryKey() tables (CREATE TABLE without a PK + CREATE UNIQUE INDEX
+    // <table>_pkey), because a PK cannot be retrofitted onto an existing sqlite
+    // table. real pg conveys this key via replica identity; without promoting it
+    // here, zero's initial sync builds a keyless replica spec and its change
+    // processor throws "Cannot replicate table without a PRIMARY KEY or UNIQUE
+    // INDEX" on the first UPDATE (2026-07-10 soot prod outage).
+    //
+    // the <table>_pkey name IS the generator's primary-key convention, so it is
+    // trusted outright: legacy tables created before NOT NULL reached their DDL
+    // have nullable physical columns (and possibly no durable metadata), yet the
+    // index still represents the app-level composite PK — requiring NOT NULL
+    // there would silently skip exactly the tables this promotion exists to
+    // heal. any OTHER unique index must cover only NOT NULL columns (a unique
+    // index over nullable columns permits duplicate NULL rows and is not a row
+    // identity); among those, narrowest wins, name as the tiebreak.
+    promotedUniqueIndexKey(sqliteTableName, columns, indexListRows, indexColumnsByName) {
+        const columnNames = new Set(columns.map((column) => column.name));
+        const notNull = new Set(columns
+            .filter((column) => {
+            const metadata = this.schemaMetadata.get(sqliteTableName)?.get(column.name);
+            return metadata?.notNull || metadata?.primaryKey || column.notnull || column.pk;
+        })
+            .map((column) => column.name));
+        const ref = this.tableRefForSqliteTable(sqliteTableName);
+        const pkeyName = `${ref.tableName}_pkey`;
+        const candidates = [];
+        for (const row of indexListRows) {
+            const name = String(row.name ?? '');
+            if (!name || !Number(row.unique ?? 0) || Number(row.partial ?? 0))
+                continue;
+            const indexColumns = Object.keys(indexColumnsByName.get(name) ?? {});
+            if (indexColumns.length === 0)
+                continue;
+            if (!indexColumns.every((column) => columnNames.has(column)))
+                continue;
+            if (name === pkeyName)
+                return indexColumns;
+            if (!indexColumns.every((column) => notNull.has(column)))
+                continue;
+            candidates.push({ name, columns: indexColumns });
+        }
+        if (candidates.length === 0)
+            return [];
+        candidates.sort((a, b) => a.columns.length - b.columns.length || a.name.localeCompare(b.name));
+        return candidates[0].columns;
+    }
     tableIndexInfos(table, columns, primaryKey, indexListRows, indexColumnsByName) {
         const usedNames = new Set();
         const seenSignatures = new Set();
@@ -6387,17 +6480,21 @@ export class DoBackend {
             const metadataPrimaryKey = columns
                 .filter((column) => this.schemaMetadata.get(table.name)?.get(column.name)?.primaryKey)
                 .map((column) => column.name);
+            const sqlitePrimaryKey = columns
+                .filter((column) => column.pk > 0)
+                .sort((a, b) => a.pk - b.pk)
+                .map((column) => column.name);
+            const primaryKey = metadataPrimaryKey.length > 0
+                ? metadataPrimaryKey
+                : sqlitePrimaryKey.length > 0
+                    ? sqlitePrimaryKey
+                    : this.promotedUniqueIndexKey(table.name, columns, pragmaResults[i * 2 + 1]?.rows ?? [], indexColumnsByName);
             const info = {
                 name: table.name,
                 schema: ref.schema,
                 tableName: ref.tableName,
                 columns,
-                primaryKey: metadataPrimaryKey.length > 0
-                    ? metadataPrimaryKey
-                    : columns
-                        .filter((column) => column.pk > 0)
-                        .sort((a, b) => a.pk - b.pk)
-                        .map((column) => column.name),
+                primaryKey,
                 indexes: [],
             };
             info.indexes = this.tableIndexInfos(ref, columns, info.primaryKey, pragmaResults[i * 2 + 1]?.rows ?? [], indexColumnsByName);
@@ -6606,7 +6703,16 @@ export class DoBackend {
                         elemPgTypeClass: metadata?.elemTyptype ?? null,
                         typeOID: metadata?.typeOid ?? pgTypeOid(dataType),
                         characterMaximumLength: metadata?.characterMaximumLength ?? null,
-                        notNull: Boolean(metadata?.notNull || metadata?.primaryKey || column.notnull || column.pk),
+                        // primary-key columns are never-null by definition; legacy
+                        // tables whose key was promoted from a <table>_pkey unique
+                        // index carry nullable physical columns, and zero's
+                        // view-syncer refuses to sync a table whose key columns are
+                        // nullable on the replica (checkClientSchema).
+                        notNull: Boolean(metadata?.notNull ||
+                            metadata?.primaryKey ||
+                            column.notnull ||
+                            column.pk ||
+                            info.primaryKey.includes(column.name)),
                         dflt: null,
                     },
                 ];