@quereus/quereus 4.3.0 → 4.3.2

package/dist/src/vtab/memory/utils/predicate.js

@@ -22,16 +22,24 @@ function predicateTruthy(v) {
  * Throws QuereusError on unsupported expression forms or unknown column
  * references so failures surface at index-creation time rather than producing
  * wrong runtime answers.
+ *
+ * When `tableName` is supplied, a `table`-qualified reference naming any OTHER
+ * table (`where zzz.active = 1` on table `t`) is rejected here too — otherwise
+ * the qualifier is ignored and the ref binds by bare name, so two statements
+ * that read differently would compile to the same index. A self-qualifier
+ * (`where t.active = 1`, case-insensitive) is accepted. Callers that do not yet
+ * know their owning table name pass `undefined` and keep the lenient
+ * ignore-the-qualifier behaviour.
  */
-export function compilePredicate(expr, columns) {
+export function compilePredicate(expr, columns, tableName) {
     const columnIndexMap = new Map();
     columns.forEach((col, idx) => columnIndexMap.set(col.name.toLowerCase(), idx));
     const referencedColumns = new Set();
-    const evaluator = compileExpression(expr, columnIndexMap, referencedColumns);
+    const evaluator = compileExpression(expr, columnIndexMap, referencedColumns, tableName);
     const evaluate = (row) => predicateTruthy(evaluator(row));
     return { evaluate, referencedColumns };
 }
-function compileExpression(expr, columnIndexMap, referencedColumns) {
+function compileExpression(expr, columnIndexMap, referencedColumns, tableName) {
     switch (expr.type) {
         case 'literal': {
             const value = expr.value;
@@ -49,6 +57,19 @@ function compileExpression(expr, columnIndexMap, referencedColumns) {
             if (ref.type === 'identifier' && ref.schema) {
                 throw new QuereusError(`Partial-index predicate cannot reference schema-qualified identifier '${ref.schema}.${ref.name}'`, StatusCode.ERROR);
             }
+            // A `table`-qualified ref (`zzz.active`) naming a table other than the owning
+            // one is rejected: without this the qualifier is dropped and the ref binds by
+            // bare name, so `where zzz.active` and `where active` compile identically.
+            // Only `ColumnExpr` carries a `table` field (an `identifier` never does).
+            // NOTE: a persisted store DB written by pre-fix code may already hold such a
+            // foreign-qualified predicate; recompiling it now throws (on rebuild/first
+            // maintenance) where it previously bound by bare name. Only matters if a legacy
+            // DB with an already-wrong index is reopened; no migration is attempted.
+            if (ref.type === 'column' && ref.table && tableName !== undefined
+                && ref.table.toLowerCase() !== tableName.toLowerCase()) {
+                throw new QuereusError(`Partial-index predicate cannot reference column '${ref.table}.${ref.name}' `
+                    + `of a different table (predicate is scoped to '${tableName}')`, StatusCode.ERROR);
+            }
             const colIdx = columnIndexMap.get(ref.name.toLowerCase());
             if (colIdx === undefined) {
                 throw new QuereusError(`Partial-index predicate references unknown column '${ref.name}'`, StatusCode.ERROR);
@@ -57,16 +78,16 @@ function compileExpression(expr, columnIndexMap, referencedColumns) {
             return (row) => row[colIdx];
         }
         case 'unary':
-            return compileUnary(expr, columnIndexMap, referencedColumns);
+            return compileUnary(expr, columnIndexMap, referencedColumns, tableName);
         case 'binary':
-            return compileBinary(expr, columnIndexMap, referencedColumns);
+            return compileBinary(expr, columnIndexMap, referencedColumns, tableName);
         case 'in':
-            return compileIn(expr, columnIndexMap, referencedColumns);
+            return compileIn(expr, columnIndexMap, referencedColumns, tableName);
         default:
             throw new QuereusError(`Unsupported expression in partial-index predicate: ${expr.type}`, StatusCode.ERROR);
     }
 }
-function compileIn(expr, columnIndexMap, referencedColumns) {
+function compileIn(expr, columnIndexMap, referencedColumns, tableName) {
     if (expr.subquery) {
         throw new QuereusError('Partial-index predicate may not contain IN subqueries', StatusCode.ERROR);
     }
@@ -74,8 +95,8 @@ function compileIn(expr, columnIndexMap, referencedColumns) {
         // `col IN ()` is always false (SQLite semantics).
         return () => false;
     }
-    const inputEval = compileExpression(expr.expr, columnIndexMap, referencedColumns);
-    const valueEvals = expr.values.map(v => compileExpression(v, columnIndexMap, referencedColumns));
+    const inputEval = compileExpression(expr.expr, columnIndexMap, referencedColumns, tableName);
+    const valueEvals = expr.values.map(v => compileExpression(v, columnIndexMap, referencedColumns, tableName));
     return (row) => {
         const a = inputEval(row);
         if (a === null)
@@ -94,9 +115,9 @@ function compileIn(expr, columnIndexMap, referencedColumns) {
         return sawNull ? null : false;
     };
 }
-function compileUnary(expr, columnIndexMap, referencedColumns) {
+function compileUnary(expr, columnIndexMap, referencedColumns, tableName) {
     const op = expr.operator.toUpperCase();
-    const operand = compileExpression(expr.expr, columnIndexMap, referencedColumns);
+    const operand = compileExpression(expr.expr, columnIndexMap, referencedColumns, tableName);
     switch (op) {
         case 'IS NULL':
             return (row) => operand(row) === null;
@@ -153,10 +174,10 @@ function compileUnary(expr, columnIndexMap, referencedColumns) {
             throw new QuereusError(`Unsupported unary operator in partial-index predicate: ${expr.operator}`, StatusCode.ERROR);
     }
 }
-function compileBinary(expr, columnIndexMap, referencedColumns) {
+function compileBinary(expr, columnIndexMap, referencedColumns, tableName) {
     const op = expr.operator.toUpperCase();
-    const left = compileExpression(expr.left, columnIndexMap, referencedColumns);
-    const right = compileExpression(expr.right, columnIndexMap, referencedColumns);
+    const left = compileExpression(expr.left, columnIndexMap, referencedColumns, tableName);
+    const right = compileExpression(expr.right, columnIndexMap, referencedColumns, tableName);
     switch (op) {
         case 'AND':
             // Three-valued AND: any FALSE ⇒ false (short-circuit); else any NULL ⇒ null.

package/dist/src/vtab/memory/utils/predicate.js.map

@@ -1 +1 @@
-{"version":3,"file":"predicate.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/predicate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"predicate.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/predicate.ts"],"names":[],"mappings":"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"}

package/dist/src/vtab/memory/utils/primary-key-encode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primary-key-encode.d.ts","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key-encode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAoCtD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CA0BhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9E"}
+{"version":3,"file":"primary-key-encode.d.ts","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key-encode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAwCtD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CA4BhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9E"}

package/dist/src/vtab/memory/utils/primary-key-encode.js

@@ -1,11 +1,15 @@
+import { canonicalJsonString } from '../../../util/json-canonical.js';
 /**
  * Lossless, type-aware encoding of a primary key to a string suitable for keying
  * a `Map<string, BTreeKeyForPrimary>` (the per-entry PK container of a
  * {@link MemoryIndex}). It mirrors {@link compareSqlValuesFast}'s storage-class
  * EQUALITY — NULL < NUMERIC < TEXT < BLOB < OBJECT(JSON), with booleans/bigints in
- * NUMERIC and JSON compared by `JSON.stringify` — so two values the PK comparator
- * treats as equal encode to the same key, and two it treats as distinct encode to
- * different keys.
+ * NUMERIC and JSON reduced to its canonical (recursive object-key-sorted) string via
+ * {@link canonicalJsonString} — so two values the PK comparator treats as equal encode
+ * to the same key, and two it treats as distinct encode to different keys. The JSON
+ * form MUST match the comparator's OBJECT-class canonical form (`objectCanonicalString`
+ * in `util/comparison.ts`), so reorder-equal objects (`{a:1,b:2}` ≡ `{b:2,a:1}`) key
+ * alike; a bare `JSON.stringify` would split them and disagree with the comparator.
  *
  * This is NOT a collation transform. Two collation-EQUAL-but-byte-distinct TEXT
  * values (NOCASE `'A'`/`'a'`; a custom collation's `'café'`/`'cafe'`) encode to
@@ -63,9 +67,11 @@ export function encodeScalar(v) {
         case 'object': {
             if (v instanceof Uint8Array)
                 return 'b' + bytesToHex(v);
-            // JSON object/array. JSON values never contain bigint (JSON.stringify would
-            // throw), so the OBJECT path never sees the numeric-normalization ambiguity.
-            return 'j' + JSON.stringify(v);
+            // JSON object/array. Canonical (recursive object-key-sorted) form so
+            // reorder-equal objects key alike and agree with the PK comparator; array
+            // order stays positional. JSON values never contain bigint (JSON.stringify
+            // would throw), so the OBJECT path never sees the numeric-normalization ambiguity.
+            return 'j' + canonicalJsonString(v);
         }
         default: {
             // SqlValue admits nothing else; guard rather than silently mis-key.

package/dist/src/vtab/memory/utils/primary-key-encode.js.map

@@ -1 +1 @@
-{"version":3,"file":"primary-key-encode.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key-encode.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,6CAA6C;AAC7C,SAAS,UAAU,CAAC,KAAiB;IACpC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,CAAW;IACvC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IAC3B,QAAQ,OAAO,CAAC,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7C,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnC,CAAC;YACD,6EAA6E;YAC7E,yDAAyD;YACzD,OAAO,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;QAC9B,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,YAAY,UAAU;gBAAE,OAAO,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YACxD,4EAA4E;YAC5E,6EAA6E;YAC7E,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACT,oEAAoE;YACpE,MAAM,UAAU,GAAU,CAAC,CAAC;YAC5B,OAAO,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAsB,EAAE,KAAa;IACrE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,GAAG,YAAY,CAAC,EAAc,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,EAAgB,CAAC;IAC/B,IAAI,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}
+{"version":3,"file":"primary-key-encode.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key-encode.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,6CAA6C;AAC7C,SAAS,UAAU,CAAC,KAAiB;IACpC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,CAAW;IACvC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IAC3B,QAAQ,OAAO,CAAC,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7C,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnC,CAAC;YACD,6EAA6E;YAC7E,yDAAyD;YACzD,OAAO,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;QAC9B,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,YAAY,UAAU;gBAAE,OAAO,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YACxD,qEAAqE;YACrE,0EAA0E;YAC1E,2EAA2E;YAC3E,mFAAmF;YACnF,OAAO,GAAG,GAAG,mBAAmB,CAAC,CAAc,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACT,oEAAoE;YACpE,MAAM,UAAU,GAAU,CAAC,CAAC;YAC5B,OAAO,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAsB,EAAE,KAAa;IACrE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,GAAG,YAAY,CAAC,EAAc,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,EAAgB,CAAC;IAC/B,IAAI,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/src/vtab/memory/utils/primary-key.d.ts

@@ -1,6 +1,7 @@
 import type { TableSchema, PrimaryKeyColumnDefinition } from '../../../schema/table.js';
 import type { Row } from '../../../common/types.js';
 import type { BTreeKeyForPrimary } from '../types.js';
+import type { CollationResolver } from '../../../types/logical-type.js';
 /**
  * Result of creating primary key functions for a given schema
  */
@@ -19,8 +20,12 @@ export interface PrimaryKeyFunctions {
 /**
  * Creates optimized primary key extraction and comparison functions for a given table schema.
  * This centralizes the logic that was previously duplicated across BaseLayer and TransactionLayer.
+ *
+ * @param collationResolver Resolves the PK columns' declared collation names against the
+ *   owning database (`Database.getCollationResolver()`). Never defaulted to a global
+ *   lookup: a memory table must sort by the collations registered on *its* connection.
  */
-export declare function createPrimaryKeyFunctions(schema: TableSchema): PrimaryKeyFunctions;
+export declare function createPrimaryKeyFunctions(schema: TableSchema, collationResolver: CollationResolver): PrimaryKeyFunctions;
 /**
  * Builds a primary key from key values and a primary key definition.
  * Used for constructing keys from old key values in UPDATE/DELETE operations.

package/dist/src/vtab/memory/utils/primary-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primary-key.d.ts","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAAE,GAAG,EAAY,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,kBAAkB,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,KAAK,MAAM,CAAC;IAClE;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,MAAM,CAAC;CAC3C;AAKD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAqBlF;AA6GD;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,GAAG,EACd,YAAY,EAAE,aAAa,CAAC,0BAA0B,CAAC,GACrD,kBAAkB,CAcpB"}
+{"version":3,"file":"primary-key.d.ts","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAAE,GAAG,EAAY,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAKxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,kBAAkB,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,KAAK,MAAM,CAAC;IAClE;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,MAAM,CAAC;CAC3C;AAKD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,mBAAmB,CAqBxH;AA+GD;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,GAAG,EACd,YAAY,EAAE,aAAa,CAAC,0BAA0B,CAAC,GACrD,kBAAkB,CAcpB"}

package/dist/src/vtab/memory/utils/primary-key.js

@@ -1,12 +1,16 @@
-import { resolveCollation, createTypedComparator } from '../../../util/comparison.js';
+import { createTypedComparator } from '../../../util/comparison.js';
 import { QuereusError } from '../../../common/errors.js';
 import { StatusCode } from '../../../common/types.js';
 import { encodePrimaryKey } from './primary-key-encode.js';
 /**
  * Creates optimized primary key extraction and comparison functions for a given table schema.
  * This centralizes the logic that was previously duplicated across BaseLayer and TransactionLayer.
+ *
+ * @param collationResolver Resolves the PK columns' declared collation names against the
+ *   owning database (`Database.getCollationResolver()`). Never defaulted to a global
+ *   lookup: a memory table must sort by the collations registered on *its* connection.
  */
-export function createPrimaryKeyFunctions(schema) {
+export function createPrimaryKeyFunctions(schema, collationResolver) {
     const pkDefinition = schema.primaryKeyDefinition
         // Use all columns if no primary key is defined (that's different from an empty primary key)
         // This is an important design change and documented deviation from SQLite behavior, and not something we want to change
@@ -20,10 +24,10 @@ export function createPrimaryKeyFunctions(schema) {
         base = createSingletonPrimaryKeyFunctions();
     }
     else if (arity === 1) {
-        base = createSingleColumnPrimaryKeyFunctions(pkDefinition[0], schema);
+        base = createSingleColumnPrimaryKeyFunctions(pkDefinition[0], schema, collationResolver);
     }
     else {
-        base = createCompositeColumnPrimaryKeyFunctions(pkDefinition, schema);
+        base = createCompositeColumnPrimaryKeyFunctions(pkDefinition, schema, collationResolver);
     }
     return { ...base, encode };
 }
@@ -43,12 +47,12 @@ function createSingletonPrimaryKeyFunctions() {
 /**
  * Creates functions for single-column primary keys (optimized path)
  */
-function createSingleColumnPrimaryKeyFunctions(columnDef, schema) {
+function createSingleColumnPrimaryKeyFunctions(columnDef, schema, collationResolver) {
     const pkColIndex = columnDef.index;
     const descMultiplier = columnDef.desc ? -1 : 1;
     // Get the column's logical type and create type-aware comparator
     const columnSchema = schema.columns[pkColIndex];
-    const collationFunc = columnDef.collation ? resolveCollation(columnDef.collation) : undefined;
+    const collationFunc = columnDef.collation ? collationResolver(columnDef.collation) : undefined;
     const typedComparator = createTypedComparator(columnSchema.logicalType, collationFunc);
     const extractFromRow = (row) => {
         if (!row || !Array.isArray(row)) {
@@ -67,11 +71,11 @@ function createSingleColumnPrimaryKeyFunctions(columnDef, schema) {
 /**
  * Creates functions for composite (multi-column) primary keys
  */
-function createCompositeColumnPrimaryKeyFunctions(pkDefinition, schema) {
+function createCompositeColumnPrimaryKeyFunctions(pkDefinition, schema, collationResolver) {
     // Pre-create type-aware comparators for each primary key column
     const comparators = pkDefinition.map(def => {
         const columnSchema = schema.columns[def.index];
-        const collationFunc = def.collation ? resolveCollation(def.collation) : undefined;
+        const collationFunc = def.collation ? collationResolver(def.collation) : undefined;
         return createTypedComparator(columnSchema.logicalType, collationFunc);
     });
     const extractFromRow = (row) => {

package/dist/src/vtab/memory/utils/primary-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"primary-key.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"primary-key.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/utils/primary-key.ts"],"names":[],"mappings":"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"}

package/dist/src/vtab/module.d.ts

@@ -34,6 +34,22 @@ export interface BaseModuleConfig {
  *   interleave with any other on the same connection.
  */
 export type VtabConcurrencyMode = 'serial' | 'reentrant-reads' | 'fully-reentrant';
+/**
+ * The rows the DDL-issuing connection can currently SEE — committed rows merged with that
+ * connection's own uncommitted writes.
+ *
+ * Supplied only by a wrapper module (today: the isolation layer) that holds those pending rows
+ * outside the target module, where the target module cannot reach them. When present, the target
+ * module MUST use this stream for every row-CONTENT judgement it makes (UNIQUE duplicate
+ * detection, collation-rekey collision detection) and MUST NOT reject the DDL over a duplicate
+ * that exists only in its own committed data. Physical structures are still built from the
+ * module's own rows — an index entry with no live row behind it is harmless, because every
+ * reader resolves an entry back to its live row and drops it if the row is gone.
+ *
+ * Re-callable: each call returns a fresh stream (a single ALTER may validate more than once).
+ * Omitted by the engine's own emitters, which leaves each module on its own effective stream.
+ */
+export type EffectiveRowSource = () => AsyncIterable<Row>;
 /**
  * Assessment result from a module's supports() method indicating
  * whether it can execute a plan subtree and at what cost.
@@ -83,6 +99,32 @@ export interface VirtualTableModule<TTable extends VirtualTable, TConfig extends
      * treat the value as a heuristic; correctness must never depend on it.
      */
     readonly expectedLatencyMs?: number;
+    /**
+     * Declares whether a `query()` iterator opened against a table of this module
+     * sees a STABLE snapshot even if `update()` mutates the same table mid-scan —
+     * i.e. the module is immune to the physical Halloween hazard where a predicate
+     * `DELETE`/`UPDATE` mutates the very structure its own source scan cursor is
+     * still walking.
+     *
+     * The DML executor consults this to decide whether a predicate DELETE/UPDATE
+     * may stream (pull one source row, apply the mutation inline, pull the next
+     * from the same live cursor) or must first fully drain the source match set
+     * into a buffer before applying any write:
+     *
+     * - `true` — the module snapshots reads (e.g. onto an immutable layer), so the
+     *   scan cursor never observes the concurrent write. The executor STREAMS,
+     *   avoiding the O(match-set) buffering spike.
+     * - `false` / omitted (**default**) — the module's scan cursor may cache a path
+     *   into a shared structure that a mid-scan write invalidates (a plain b-tree
+     *   cursor). The executor DRAINS the match set before mutating, so the cursor
+     *   is closed before the first write.
+     *
+     * The false default is **correctness-first**: any durable / third-party store
+     * is safe out of the box (it buffers) and opts into streaming only after it can
+     * prove per-scan snapshot isolation. See `docs/runtime.md` § "DML executor:
+     * read/write phase separation".
+     */
+    readonly scanSnapshotIsolation?: boolean;
     /**
      * Creates the persistent definition of a virtual table.
      * Called by CREATE VIRTUAL TABLE to define schema and initialize storage.
@@ -164,9 +206,11 @@ export interface VirtualTableModule<TTable extends VirtualTable, TConfig extends
      * @param schemaName The name of the database schema
      * @param tableName The name of the virtual table
      * @param indexSchema The schema definition for the index being created
+     * @param rows Optional {@link EffectiveRowSource}. When supplied, the UNIQUE duplicate
+     *   check MUST run over this stream instead of the module's own rows.
      * @throws QuereusError on failure
      */
-    createIndex?(db: Database, schemaName: string, tableName: string, indexSchema: IndexSchema): Promise<void>;
+    createIndex?(db: Database, schemaName: string, tableName: string, indexSchema: IndexSchema, rows?: EffectiveRowSource): Promise<void>;
     /**
      * Drops an index from a virtual table.
      * Called by DROP INDEX.
@@ -178,18 +222,6 @@ export interface VirtualTableModule<TTable extends VirtualTable, TConfig extends
      * @throws QuereusError on failure
      */
     dropIndex?(db: Database, schemaName: string, tableName: string, indexName: string): Promise<void>;
-    /**
-     * Checks for shadow table name conflicts.
-     *
-     * UNWIRED / DEAD: this hook is declared but is never called anywhere in the
-     * engine. Treat it as deprecated — do not build a contract around it expecting
-     * the engine to consult it. See docs/module-authoring.md § "Capability
-     * negotiation surface".
-     *
-     * @param name The name to check
-     * @returns true if the name would conflict
-     */
-    shadowName?(name: string): boolean;
     /**
      * Returns capability flags for this module.
      * Used for runtime capability discovery.
@@ -293,8 +325,12 @@ export interface VirtualTableModule<TTable extends VirtualTable, TConfig extends
      *
      * If not implemented, the engine rejects data-affecting ALTER operations
      * (`renameColumn` degrades to an engine-side schema-only rename instead).
+     *
+     * `rows` is an optional {@link EffectiveRowSource}. When supplied, the row-validating
+     * arms (`addConstraint … unique`, `alterColumn … set collate`) MUST judge that stream
+     * rather than the module's own rows.
      */
-    alterTable?(db: Database, schemaName: string, tableName: string, change: SchemaChangeInfo): Promise<TableSchema>;
+    alterTable?(db: Database, schemaName: string, tableName: string, change: SchemaChangeInfo, rows?: EffectiveRowSource): Promise<TableSchema>;
     /**
      * Rename a table. Called by ALTER TABLE ... RENAME TO before the engine
      * updates the in-memory schema catalog.
@@ -307,6 +343,20 @@ export interface VirtualTableModule<TTable extends VirtualTable, TConfig extends
      * that persist data keyed by the table name must implement this hook.
      */
     renameTable?(db: Database, schemaName: string, oldName: string, newName: string): Promise<void>;
+    /**
+     * Optional second phase of RENAME TABLE, called by the engine at the END of
+     * ALTER TABLE ... RENAME TO — AFTER the engine has propagated the rename into every
+     * dependent object (rewriting CHECK / FK / partial-index predicates in OTHER tables,
+     * plus view and materialized-view bodies) and fired their schema-change events.
+     *
+     * A module that persists its catalog by table name uses this to drop any now-superseded
+     * OLD-name catalog state, but only once those dependent rewrites are durable. Splitting
+     * the old-name removal out of {@link renameTable} (which runs BEFORE propagation) keeps
+     * the durable catalog from ever holding a dependent that names a table already deleted:
+     * a crash in that gap would otherwise strand an un-rehydratable set. Modules that keep no
+     * per-name persistent catalog can omit this hook.
+     */
+    finalizeRename?(db: Database, schemaName: string, oldName: string, newName: string): Promise<void>;
     /**
      * Optional. Called once by APPLY SCHEMA before the migration-DDL loop runs,
      * iff there are migration statements to execute. The module may use this to

package/dist/src/vtab/module.d.ts.map

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

package/dist/src/vtab/table.d.ts

@@ -1,4 +1,4 @@
-import type { AnyVirtualTableModule, SchemaChangeInfo } from './module.js';
+import type { AnyVirtualTableModule, EffectiveRowSource, SchemaChangeInfo } from './module.js';
 import type { Database } from '../core/database.js';
 import type { TableSchema } from '../schema/table.js';
 import type { MaybePromise, Row, SqlValue, CompareFn, UpdateResult } from '../common/types.js';
@@ -49,7 +49,26 @@ export interface UpdateArgs {
 export declare abstract class VirtualTable {
     readonly module: AnyVirtualTableModule;
     readonly db: Database;
+    /**
+     * The **bare** table name — never schema-qualified. It is the `tableName` the module's
+     * `create()`/`connect()` was called with, and every consumer that wants the qualified form
+     * composes `` `${schemaName}.${tableName}` `` itself. A module that stores a qualified name
+     * here doubles the schema in each of those compositions:
+     * - `vtab/memory/table.ts` and `quereus-store/src/common/store-table.ts` name the
+     *   `VirtualTableConnection` they register with the database. The engine matches that name
+     *   against `<schema>.<table>` when resolving a connection (see
+     *   `runtime/deferred-constraint-queue.ts`), so a doubled name never matches.
+     * - `quereus-isolation` keys its per-connection overlays by the pair; a mismatch there used
+     *   to discard staged rows at commit (`docs/design-isolation-layer.md` § "Table identity").
+     *
+     * Modules needing a qualified lookup key must derive it, not overload this field.
+     *
+     * NOTE: nothing enforces this at runtime — every in-repo module complies. If third-party
+     * modules start violating it, assert bareness in the constructor rather than hardening
+     * each consumer.
+     */
     readonly tableName: string;
+    /** The schema (database) this table lives in, e.g. `main`. */
     readonly schemaName: string;
     errorMessage?: string;
     tableSchema?: TableSchema;
@@ -119,6 +138,23 @@ export declare abstract class VirtualTable {
      * @returns The current VirtualTableConnection instance, if any
      */
     getConnection?(): VirtualTableConnection | undefined;
+    /**
+     * (Optional) Offered an existing, already-registered connection for this table so the
+     * instance can reuse it instead of opening its own. The runtime calls this on a freshly
+     * connected instance when a connection for the same qualified table name is already
+     * registered; it passes the registered VirtualTableConnection and ignores the result.
+     *
+     * The module decides whether to adopt: it should downcast to its own connection type,
+     * reject connections it did not create (instanceof / brand check) and connections whose
+     * backing state no longer matches this instance (e.g. a stale connection from a
+     * dropped-then-recreated table), and silently do nothing when it declines.
+     *
+     * Ownership is NOT transferred: the adopted connection remains owned by the database
+     * connection registry that registered it. Adopting it must not make this instance
+     * responsible for closing it beyond the module's existing disconnect contract. The hook
+     * must be safe to call more than once on the same instance.
+     */
+    adoptConnection?(connection: VirtualTableConnection): MaybePromise<void>;
     /**
      * Begins a transaction on this virtual table
      */
@@ -164,8 +200,11 @@ export declare abstract class VirtualTable {
     /**
      * Creates a secondary index on the virtual table
      * @param indexInfo The index definition
+     * @param rows Optional {@link EffectiveRowSource} — the rows the DDL-issuing connection
+     *   can see, supplied by a wrapper module that holds pending rows this table cannot
+     *   reach. When present, the UNIQUE duplicate check MUST judge this stream.
      */
-    createIndex?(indexInfo: IndexSchema): Promise<void>;
+    createIndex?(indexInfo: IndexSchema, rows?: EffectiveRowSource): Promise<void>;
     /**
      * Drops a secondary index from the virtual table
      * @param indexName The name of the index to drop

package/dist/src/vtab/table.d.ts.map

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

package/dist/src/vtab/table.js

@@ -5,7 +5,26 @@
 export class VirtualTable {
     module;
     db;
+    /**
+     * The **bare** table name — never schema-qualified. It is the `tableName` the module's
+     * `create()`/`connect()` was called with, and every consumer that wants the qualified form
+     * composes `` `${schemaName}.${tableName}` `` itself. A module that stores a qualified name
+     * here doubles the schema in each of those compositions:
+     * - `vtab/memory/table.ts` and `quereus-store/src/common/store-table.ts` name the
+     *   `VirtualTableConnection` they register with the database. The engine matches that name
+     *   against `<schema>.<table>` when resolving a connection (see
+     *   `runtime/deferred-constraint-queue.ts`), so a doubled name never matches.
+     * - `quereus-isolation` keys its per-connection overlays by the pair; a mismatch there used
+     *   to discard staged rows at commit (`docs/design-isolation-layer.md` § "Table identity").
+     *
+     * Modules needing a qualified lookup key must derive it, not overload this field.
+     *
+     * NOTE: nothing enforces this at runtime — every in-repo module complies. If third-party
+     * modules start violating it, assert bareness in the constructor rather than hardening
+     * each consumer.
+     */
     tableName;
+    /** The schema (database) this table lives in, e.g. `main`. */
     schemaName;
     errorMessage;
     tableSchema;

package/dist/src/vtab/table.js.map

@@ -1 +1 @@
-{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/vtab/table.ts"],"names":[],"mappings":"AA8CA;;;GAGG;AACH,MAAM,OAAgB,YAAY;IACjB,MAAM,CAAwB;IAC9B,EAAE,CAAW;IACb,SAAS,CAAS;IAClB,UAAU,CAAS;IAC5B,YAAY,CAAU;IACtB,WAAW,CAAe;IAEjC;;;;OAIG;IACI,cAAc,CAAW;IAEhC,YAAY,EAAY,EAAE,MAA6B,EAAE,UAAkB,EAAE,SAAiB;QAC7F,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACO,eAAe,CAAC,OAA2B;QACpD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC7B,CAAC;CA6KD"}
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/vtab/table.ts"],"names":[],"mappings":"AA8CA;;;GAGG;AACH,MAAM,OAAgB,YAAY;IACjB,MAAM,CAAwB;IAC9B,EAAE,CAAW;IAC7B;;;;;;;;;;;;;;;;;OAiBG;IACa,SAAS,CAAS;IAClC,8DAA8D;IAC9C,UAAU,CAAS;IAC5B,YAAY,CAAU;IACtB,WAAW,CAAe;IAEjC;;;;OAIG;IACI,cAAc,CAAW;IAEhC,YAAY,EAAY,EAAE,MAA6B,EAAE,UAAkB,EAAE,SAAiB;QAC7F,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACO,eAAe,CAAC,OAA2B;QACpD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC7B,CAAC;CAkMD"}