@quereus/isolation 0.2.0

package/dist/src/merge-types.d.ts

@@ -0,0 +1,61 @@
+import type { SqlValue, Row } from '@quereus/quereus';
+/**
+ * Comparator function for primary keys.
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+export type PKComparator = (a: SqlValue[], b: SqlValue[]) => number;
+/**
+ * Function to extract primary key from a row.
+ */
+export type PKExtractor = (row: Row) => SqlValue[];
+/**
+ * Comparator function for sort keys (may be PK, index key, or composite).
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+export type SortKeyComparator = (a: SqlValue[], b: SqlValue[]) => number;
+/**
+ * Function to extract sort key from a row.
+ * For PK scans, this returns the PK.
+ * For secondary index scans, this returns [indexKeyParts..., pkParts...].
+ */
+export type SortKeyExtractor = (row: Row) => SqlValue[];
+/**
+ * An entry in the overlay stream.
+ * Can be a regular row (insert/update) or a tombstone (delete).
+ */
+export interface MergeEntry {
+    /** The row data (for inserts/updates) or the PK values (for tombstones) */
+    row: Row;
+    /** If true, this entry represents a deletion */
+    tombstone: boolean;
+    /** Pre-extracted primary key for efficient comparison */
+    pk: SqlValue[];
+    /**
+     * Pre-extracted sort key for merge ordering.
+     * For PK scans, this equals pk.
+     * For secondary index scans, this is [indexKeyParts..., pkParts...].
+     */
+    sortKey: SqlValue[];
+}
+/**
+ * Configuration for the merge iterator.
+ */
+export interface MergeConfig {
+    /** Compare two primary keys */
+    comparePK: PKComparator;
+    /** Extract primary key from an underlying row */
+    extractPK: PKExtractor;
+    /**
+     * Compare two sort keys for merge ordering.
+     * Defaults to comparePK if not provided.
+     * For secondary index scans, compares by index key first, then PK.
+     */
+    compareSortKey?: SortKeyComparator;
+    /**
+     * Extract sort key from an underlying row.
+     * Defaults to extractPK if not provided.
+     * For secondary index scans, extracts [indexKeyParts..., pkParts...].
+     */
+    extractSortKey?: SortKeyExtractor;
+}
+//# sourceMappingURL=merge-types.d.ts.map

package/dist/src/merge-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-types.d.ts","sourceRoot":"","sources":["../../src/merge-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,QAAQ,EAAE,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,QAAQ,EAAE,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,2EAA2E;IAC3E,GAAG,EAAE,GAAG,CAAC;IAET,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IAEnB,yDAAyD;IACzD,EAAE,EAAE,QAAQ,EAAE,CAAC;IAEf;;;;OAIG;IACH,OAAO,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,+BAA+B;IAC/B,SAAS,EAAE,YAAY,CAAC;IAExB,iDAAiD;IACjD,SAAS,EAAE,WAAW,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAEnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC;CAClC"}

package/dist/src/merge-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=merge-types.js.map

package/dist/src/merge-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-types.js","sourceRoot":"","sources":["../../src/merge-types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@quereus/isolation",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Generic transaction isolation layer for Quereus virtual table modules",
+  "keywords": [
+    "quereus",
+    "sql",
+    "database",
+    "transaction",
+    "isolation",
+    "mvcc",
+    "acid",
+    "virtual-table"
+  ],
+  "publisher": "Got Choices Foundation",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/quereus.git",
+    "directory": "packages/quereus-isolation"
+  },
+  "license": "MIT",
+  "main": "dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "cd ../.. && node --import ./packages/quereus-isolation/register.mjs node_modules/mocha/bin/mocha.js \"packages/quereus-isolation/test/**/*.spec.ts\" --colors",
+    "test:single": "cd ../.. && node --import ./packages/quereus-isolation/register.mjs node_modules/mocha/bin/mocha.js --bail"
+  },
+  "peerDependencies": {
+    "@quereus/quereus": "^0.13.0"
+  },
+  "devDependencies": {
+    "@quereus/quereus": "*",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.15.29",
+    "chai": "^5.2.0",
+    "mocha": "^11.5.0",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}