@proteinjs/db 1.30.0 → 1.32.0

package/dist/test/CursorWindowPager.test.js

@@ -0,0 +1,213 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * CursorWindowPager (src/CursorWindowPager.ts) at the pure level: effective-sort derivation
+ * (id tiebreak appended, explicit id ends the list, byValues rejected), lexicographic anchor
+ * conditions, next-anchor derivation (short-window and null-tail exhaustion), anchor
+ * encode/decode fidelity, and fresh-query-per-window construction. The db round trip is a
+ * constructor-injected stub — no module mocking, the pager's `options.db` seam IS the
+ * injection point.
+ */
+var moment_1 = __importDefault(require("moment"));
+var db_query_1 = require("@proteinjs/db-query");
+var db_1 = require("@proteinjs/db");
+// Load the reflection source graph so the house Serializer's custom serializers (moments)
+// are registered — anchor encode/decode fidelity rides them.
+require("../generated/index");
+var table = { name: 'pager_test' };
+var staged = { rows: [] };
+var executed = [];
+var stubDb = {
+    query: function (_table, qb) { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            executed.push(qb);
+            return [2 /*return*/, staged.rows];
+        });
+    }); },
+};
+var createQuery = function () { return new db_query_1.QueryBuilder(table.name); };
+var pager = function (sort) {
+    return new db_1.CursorWindowPager(table, createQuery, sort, { db: stubDb });
+};
+var internals = function (instance) { return instance; };
+var graphNodes = function (qb) { return qb.graph.nodes().map(function (id) { return qb.graph.node(id); }); };
+var conditionNodes = function (qb) { return graphNodes(qb).filter(function (node) { return (node === null || node === void 0 ? void 0 : node.type) === 'CONDITION'; }); };
+var logicalNodes = function (qb) { return graphNodes(qb).filter(function (node) { return (node === null || node === void 0 ? void 0 : node.type) === 'LOGICAL'; }); };
+var paginationNode = function (qb) { return graphNodes(qb).find(function (node) { return (node === null || node === void 0 ? void 0 : node.type) === 'PAGINATION'; }); };
+var sortNodes = function (qb) { return graphNodes(qb).filter(function (node) { return (node === null || node === void 0 ? void 0 : node.type) === 'SORT'; }); };
+var row = function (id, seq, at) { return ({
+    id: id,
+    name: id,
+    seq: seq,
+    stampedAt: at ? (0, moment_1.default)(at) : at === null ? null : undefined,
+}); };
+beforeEach(function () {
+    staged.rows = [];
+    executed.length = 0;
+});
+describe('effective sort', function () {
+    it('appends the id tiebreak to the consumer sort', function () {
+        var instance = pager([{ field: 'seq', desc: true }]);
+        expect(internals(instance).effectiveSort).toEqual([
+            { field: 'seq', desc: true },
+            { field: 'id', desc: false },
+        ]);
+    });
+    it('no sort = pure id order', function () {
+        expect(internals(pager()).effectiveSort).toEqual([{ field: 'id', desc: false }]);
+    });
+    it('an explicit id criterion ends the list (axes after it can never influence order)', function () {
+        var instance = pager([
+            { field: 'id', desc: true },
+            { field: 'seq', desc: false },
+        ]);
+        expect(internals(instance).effectiveSort).toEqual([{ field: 'id', desc: true }]);
+    });
+    it('rejects byValues sorts — a CASE ordering has no comparable cursor axis', function () {
+        expect(function () { return pager([{ field: 'name', byValues: ['a', 'b'] }]); }).toThrow(/byValues/);
+    });
+});
+describe('buildWindowQuery', function () {
+    it('the first window carries no cursor conditions — just the effective sort and the window pagination', function () {
+        var qb = internals(pager([{ field: 'seq', desc: false }])).buildWindowQuery(null, 30);
+        expect(conditionNodes(qb)).toHaveLength(0);
+        expect(paginationNode(qb)).toMatchObject({ start: 0, end: 30 });
+        expect(sortNodes(qb).map(function (node) { return node.criteria; })).toEqual([
+            { field: 'seq', desc: false },
+            { field: 'id', desc: false },
+        ]);
+    });
+    it('an anchored window builds the lexicographic continuation: past-on-axis OR (equal-on-axis AND past-on-id)', function () {
+        var qb = internals(pager([{ field: 'seq', desc: true }])).buildWindowQuery({ values: [40, 'row-4'] }, 10);
+        // Disjunct 1: seq < 40. Disjunct 2: seq = 40 AND id > 'row-4'.
+        expect(conditionNodes(qb)).toEqual(expect.arrayContaining([
+            expect.objectContaining({ field: 'seq', operator: '<', value: 40 }),
+            expect.objectContaining({ field: 'seq', operator: '=', value: 40 }),
+            expect.objectContaining({ field: 'id', operator: '>', value: 'row-4' }),
+        ]));
+        expect(conditionNodes(qb)).toHaveLength(3);
+        var operators = logicalNodes(qb).map(function (node) { return node.operator; });
+        expect(operators).toContain('OR');
+        expect(operators).toContain('AND');
+    });
+    it('an ascending axis flips the past operator to `>`', function () {
+        var qb = internals(pager([{ field: 'seq', desc: false }])).buildWindowQuery({ values: [40, 'row-4'] }, 10);
+        expect(conditionNodes(qb)).toEqual(expect.arrayContaining([expect.objectContaining({ field: 'seq', operator: '>', value: 40 })]));
+    });
+    it('every window builds on a FRESH query — cursor conditions never accumulate', function () {
+        var instance = pager([{ field: 'seq', desc: true }]);
+        internals(instance).buildWindowQuery({ values: [40, 'row-4'] }, 10);
+        var second = internals(instance).buildWindowQuery({ values: [20, 'row-2'] }, 10);
+        expect(conditionNodes(second)).toHaveLength(3);
+    });
+});
+describe('deriveNextAnchor', function () {
+    var instance = pager([{ field: 'seq', desc: false }]);
+    it('a short window is exhausted', function () {
+        expect(internals(instance).deriveNextAnchor([row('a', 10)], 3)).toBeNull();
+        expect(internals(instance).deriveNextAnchor([], 3)).toBeNull();
+    });
+    it('a full window anchors at its tail row, one value per effective criterion', function () {
+        var anchor = internals(instance).deriveNextAnchor([row('a', 10), row('b', 20), row('c', 30)], 3);
+        expect(anchor).toEqual({ values: [30, 'c'] });
+    });
+    it('a full window with a NULL sort-value tail is exhausted (null rows collect at the tail; no anchor)', function () {
+        expect(internals(instance).deriveNextAnchor([row('a', 10), row('b', 20), row('c', null)], 3)).toBeNull();
+    });
+});
+describe('anchor encode/decode', function () {
+    it('round-trips values with type fidelity (moments survive)', function () {
+        var at = (0, moment_1.default)('2026-08-10T12:00:00.000Z');
+        var encoded = db_1.CursorWindowPager.encodeAnchor({ values: [at, 'row-1'] });
+        expect(typeof encoded).toBe('string');
+        var decoded = db_1.CursorWindowPager.decodeAnchor(encoded);
+        expect(moment_1.default.isMoment(decoded.values[0])).toBe(true);
+        expect(decoded.values[0].toISOString()).toBe(at.toISOString());
+        expect(decoded.values[1]).toBe('row-1');
+    });
+});
+describe('loadWindow', function () {
+    it('returns the queried rows with the derived next anchor, querying through the injected db', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var instance, window;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    instance = pager([{ field: 'seq', desc: false }]);
+                    staged.rows = [row('a', 10), row('b', 20), row('c', 30)];
+                    return [4 /*yield*/, instance.loadWindow(null, 3)];
+                case 1:
+                    window = _a.sent();
+                    expect(window.rows).toBe(staged.rows);
+                    expect(window.nextAnchor).toEqual({ values: [30, 'c'] });
+                    expect(executed).toHaveLength(1);
+                    expect(paginationNode(executed[0])).toMatchObject({ start: 0, end: 3 });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('returns an exhausted window (null anchor) when the query comes back short', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var instance, window;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    instance = pager([{ field: 'seq', desc: false }]);
+                    staged.rows = [row('a', 10)];
+                    return [4 /*yield*/, instance.loadWindow({ values: [5, 'z'] }, 3)];
+                case 1:
+                    window = _a.sent();
+                    expect(window.nextAnchor).toBeNull();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('rejects a nonsensical window size', function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, expect(pager().loadWindow(null, 0)).rejects.toThrow(/window size/i)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=CursorWindowPager.test.js.map

package/dist/test/CursorWindowPager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CursorWindowPager.test.js","sourceRoot":"","sources":["../../test/CursorWindowPager.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,kDAA4B;AAC5B,gDAAmD;AACnD,oCAAyG;AACzG,0FAA0F;AAC1F,6DAA6D;AAC7D,8BAA4B;AAS5B,IAAM,KAAK,GAAG,EAAE,IAAI,EAAE,YAAY,EAAqE,CAAC;AAGxG,IAAM,MAAM,GAAoB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC7C,IAAM,QAAQ,GAA6B,EAAE,CAAC;AAC9C,IAAM,MAAM,GAAG;IACb,KAAK,EAAE,UAAO,MAAe,EAAE,EAA0B;;YACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,sBAAO,MAAM,CAAC,IAAI,EAAC;;SACpB;CACe,CAAC;AAEnB,IAAM,WAAW,GAAG,cAAM,OAAA,IAAI,uBAAY,CAAW,KAAK,CAAC,IAAI,CAAC,EAAtC,CAAsC,CAAC;AAEjE,IAAM,KAAK,GAAG,UAAC,IAA+B;IAC5C,OAAA,IAAI,sBAAiB,CAAW,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AAAzE,CAAyE,CAAC;AAQ5E,IAAM,SAAS,GAAG,UAAC,QAAqC,IAAK,OAAA,QAAqC,EAArC,CAAqC,CAAC;AAEnG,IAAM,UAAU,GAAG,UAAC,EAA0B,IAAY,OAAA,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,UAAC,EAAU,IAAK,OAAA,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAjB,CAAiB,CAAC,EAAvD,CAAuD,CAAC;AAClH,IAAM,cAAc,GAAG,UAAC,EAA0B,IAAK,OAAA,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,WAAW,EAA1B,CAA0B,CAAC,EAA3D,CAA2D,CAAC;AACnH,IAAM,YAAY,GAAG,UAAC,EAA0B,IAAK,OAAA,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,SAAS,EAAxB,CAAwB,CAAC,EAAzD,CAAyD,CAAC;AAC/G,IAAM,cAAc,GAAG,UAAC,EAA0B,IAAK,OAAA,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAC,IAAI,IAAK,OAAA,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,YAAY,EAA3B,CAA2B,CAAC,EAA1D,CAA0D,CAAC;AAClH,IAAM,SAAS,GAAG,UAAC,EAA0B,IAAK,OAAA,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,MAAM,EAArB,CAAqB,CAAC,EAAtD,CAAsD,CAAC;AAEzG,IAAM,GAAG,GAAG,UAAC,EAAU,EAAE,GAAkB,EAAE,EAAkB,IAAU,OAAA,CAAC;IACxE,EAAE,IAAA;IACF,IAAI,EAAE,EAAE;IACR,GAAG,KAAA;IACH,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAA,gBAAM,EAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CAC5D,CAAC,EALuE,CAKvE,CAAC;AAEH,UAAU,CAAC;IACT,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACtB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE;IACzB,EAAE,CAAC,8CAA8C,EAAE;QACjD,IAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC;YAChD,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;YAC5B,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE;QAC5B,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE;QACrF,IAAM,QAAQ,GAAG,KAAK,CAAC;YACrB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;YAC3B,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE;QAC3E,MAAM,CAAC,cAAM,OAAA,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAhD,CAAgD,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE;IAC3B,EAAE,CAAC,mGAAmG,EAAE;QACtG,IAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxF,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,QAAQ,EAAb,CAAa,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;YAC7B,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0GAA0G,EAAE;QAC7G,IAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5G,+DAA+D;QAC/D,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAChC,MAAM,CAAC,eAAe,CAAC;YACrB,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACnE,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACnE,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;SACxE,CAAC,CACH,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAM,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,QAAQ,EAAb,CAAa,CAAC,CAAC;QAChE,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE;QACrD,IAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7G,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAChC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAC9F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE;QAC9E,IAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,SAAS,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,IAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnF,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE;IAC3B,IAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAExD,EAAE,CAAC,6BAA6B,EAAE;QAChC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3E,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE;QAC7E,IAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mGAAmG,EAAE;QACtG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3G,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE;IAC/B,EAAE,CAAC,yDAAyD,EAAE;QAC5D,IAAM,EAAE,GAAG,IAAA,gBAAM,EAAC,0BAA0B,CAAC,CAAC;QAC9C,IAAM,OAAO,GAAG,sBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAM,OAAO,GAAG,sBAAiB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,CAAC,gBAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE;IACrB,EAAE,CAAC,yFAAyF,EAAE;;;;;oBACtF,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;oBACxD,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;oBAChB,qBAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAA;;oBAArE,MAAM,GAA6B,SAAkC;oBAC3E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACtC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBACzD,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;oBACjC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;;;;SACzE,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE;;;;;oBACxE,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;oBACxD,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;oBACd,qBAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAA;;oBAA3D,MAAM,GAAG,SAAkD;oBACjE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;;;;SACtC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE;;;wBACtC,qBAAM,MAAM,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,EAAA;;oBAAzE,SAAyE,CAAC;;;;SAC3E,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/index.d.ts

@@ -5,11 +5,13 @@ export * from './reusable/DynamicReferenceColumnTests';
 export * from './reusable/TransactionTests';
 export * from './reusable/CascadeDeleteTests';
 export * from './reusable/PreloadReferencesTests';
+export * from './reusable/RecordIteratorTests';
 export * from './util/testUser';
 export * from './util/tables/cascadeDeleteTestTables';
 export * from './util/tables/columnTypesTestTables';
 export * from './util/tables/crudTestTables';
 export * from './util/tables/dynamicReferenceColumnTestTables';
+export * from './util/tables/recordIteratorTestTables';
 export * from './util/tables/tableManagerTestTables';
 export * from './util/tables/transactionTestTables';
 //# sourceMappingURL=index.d.ts.map

package/dist/test/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../test/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAElD,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../test/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAE/C,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC"}

package/dist/test/index.js

@@ -21,11 +21,13 @@ __exportStar(require("./reusable/DynamicReferenceColumnTests"), exports);
 __exportStar(require("./reusable/TransactionTests"), exports);
 __exportStar(require("./reusable/CascadeDeleteTests"), exports);
 __exportStar(require("./reusable/PreloadReferencesTests"), exports);
+__exportStar(require("./reusable/RecordIteratorTests"), exports);
 __exportStar(require("./util/testUser"), exports);
 __exportStar(require("./util/tables/cascadeDeleteTestTables"), exports);
 __exportStar(require("./util/tables/columnTypesTestTables"), exports);
 __exportStar(require("./util/tables/crudTestTables"), exports);
 __exportStar(require("./util/tables/dynamicReferenceColumnTestTables"), exports);
+__exportStar(require("./util/tables/recordIteratorTestTables"), exports);
 __exportStar(require("./util/tables/tableManagerTestTables"), exports);
 __exportStar(require("./util/tables/transactionTestTables"), exports);
 //# sourceMappingURL=index.js.map

package/dist/test/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../test/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,uDAAqC;AACrC,8DAA4C;AAC5C,yEAAuD;AACvD,8DAA4C;AAC5C,gEAA8C;AAC9C,oEAAkD;AAElD,kDAAgC;AAEhC,wEAAsD;AACtD,sEAAoD;AACpD,+DAA6C;AAC7C,iFAA+D;AAC/D,uEAAqD;AACrD,sEAAoD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../test/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,uDAAqC;AACrC,8DAA4C;AAC5C,yEAAuD;AACvD,8DAA4C;AAC5C,gEAA8C;AAC9C,oEAAkD;AAClD,iEAA+C;AAE/C,kDAAgC;AAEhC,wEAAsD;AACtD,sEAAoD;AACpD,+DAA6C;AAC7C,iFAA+D;AAC/D,yEAAuD;AACvD,uEAAqD;AACrD,sEAAoD"}

package/dist/test/reusable/RecordIteratorTests.d.ts

@@ -0,0 +1,13 @@
+import { DbDriver, Table, DefaultTransactionContextFactory } from '@proteinjs/db';
+/**
+ * RecordIterator's iteration contract under CONCURRENT WRITES — the offset-window drift class.
+ *
+ * Offset paging frames every window by position (`OFFSET n`), so a row deleted behind the
+ * iterator slides an unvisited row into the already-consumed range (SKIP), and a row inserted
+ * ahead of the consumed prefix slides a consumed row back into the next window (DUPLICATE).
+ * Cursor windows frame by the tail row's sort values instead, so concurrent writes can never
+ * shift the frame. These tests mutate the table exactly at a window boundary (window size 3,
+ * mutation after the 3rd yield) and assert the OUTCOME: every seeded row visited exactly once.
+ */
+export declare const recordIteratorTests: (driver: DbDriver, transactionContextFactory: DefaultTransactionContextFactory, dropTable: (table: Table<any>) => Promise<void>) => () => void;
+//# sourceMappingURL=RecordIteratorTests.d.ts.map

package/dist/test/reusable/RecordIteratorTests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordIteratorTests.d.ts","sourceRoot":"","sources":["../../../test/reusable/RecordIteratorTests.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EAGR,KAAK,EACL,gCAAgC,EAGjC,MAAM,eAAe,CAAC;AAIvB;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,WACtB,QAAQ,6BACW,gCAAgC,qBACxC,MAAM,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,eAkKhD,CAAC"}