@proteinjs/db 1.30.0 → 1.31.0

package/dist/src/MigrationRunner.js

@@ -42,6 +42,7 @@ var Db_1 = require("./Db");
 var SourceRecordRepo_1 = require("./source/SourceRecordRepo");
 var MigrationRunnerService_1 = require("./services/MigrationRunnerService");
 var MigrationTable_1 = require("./tables/MigrationTable");
+var QueryBuilderFactory_1 = require("./QueryBuilderFactory");
 var logger_1 = require("@proteinjs/logger");
 var getMigrationRunner = function () {
     return typeof self === 'undefined' ? new MigrationRunner() : (0, MigrationRunnerService_1.getMigrationRunnerService)();
@@ -81,6 +82,9 @@ var MigrationRunner = /** @class */ (function () {
      *
      * 'ensure' = idempotent: a row already in 'success' status is logged and skipped. A prior
      * 'failure' row is retried by design — a fixed migration should run on the next boot.
+     *
+     * Returns the migration with its final run state (the skipped row, or the run's outcome) —
+     * the series runner ({@link runPendingMigrations}) gates on it.
      */
     MigrationRunner.prototype.ensureMigrationRun = function (id) {
         return __awaiter(this, void 0, void 0, function () {
@@ -95,13 +99,115 @@ var MigrationRunner = /** @class */ (function () {
                         migrationRow = _a.sent();
                         if ((migrationRow === null || migrationRow === void 0 ? void 0 : migrationRow.status) === 'success') {
                             this.logger.info({ message: "Migration (".concat(id, ") already applied, skipping") });
-                            return [2 /*return*/];
+                            return [2 /*return*/, migrationRow];
                         }
                         migration = this.resolveMigration(migrationTable, id);
                         return [4 /*yield*/, this.runAndRecord(migrationTable, migration, function () { return db; })];
                     case 2:
                         _a.sent();
-                        return [2 /*return*/];
+                        return [2 /*return*/, migration];
+                }
+            });
+        });
+    };
+    /**
+     * Deploy-path API (plans/POST_RELEASE_QUEUE.md 27f): the deploy pipeline's migration Job calls
+     * this AFTER `new Db().init()` (schema sync + source-record sync — every source-declared
+     * migration has a ledger row by then) and BEFORE the rollout advances. Pod boot never calls it:
+     * boot stays migration-free (the startupProbe invariant — DbInitStartupTask is schema sync and
+     * source records only).
+     *
+     * Discovery + order: the migration LEDGER (the migration table) is the authority. Rows run in
+     * SERIES, oldest-first by the row's `created` (id tiebreak) — a migration that shipped in an
+     * earlier release always runs before a later one. Never parallel.
+     *
+     * Policy:
+     * - `manual: true` (the source record's declaration) is EXCLUDED — the explicit non-automatable
+     *   class keeps the Migrations-page flow ({@link Migration.manual}).
+     * - rows already in 'success' are skipped; any other status is pending — including 'running'
+     *   (a crashed earlier Job): {@link ensureMigrationRun} re-runs it.
+     * - rows with no source record are history (a loader deleted after its run) — skipped,
+     *   reported as `unresolved`.
+     * - the FIRST failure STOPS the series (later migrations may build on earlier ones). The
+     *   caller exits non-zero, the Job fails, the rollout does not advance.
+     *
+     * EXPAND-CONTRACT INVARIANT (documented at this seam on purpose): every automated migration —
+     * and the schema sync that fronts it — must be backward-compatible with the STILL-RUNNING old
+     * release, because the old pods keep serving while this runs and keep serving indefinitely if
+     * it fails. "Roll back" = do not advance the code; DDL and applied migrations are never
+     * un-applied (Spanner DDL is not transactional-reversible). Contractions (drops, rewrites that
+     * break the old reader) belong in the `manual` class, run only after every consumer of the old
+     * shape is gone.
+     */
+    MigrationRunner.prototype.runPendingMigrations = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var migrationTable, db, qb, ledger, summary, sourceRecordRepo, pending, _i, ledger_1, row, source, i, outcome;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        migrationTable = new MigrationTable_1.MigrationTable();
+                        db = (0, Db_1.getDbAsSystem)();
+                        qb = new QueryBuilderFactory_1.QueryBuilderFactory().createQueryBuilder(migrationTable).sort([
+                            { field: 'created', desc: false },
+                            { field: 'id', desc: false },
+                        ]);
+                        return [4 /*yield*/, db.query(migrationTable, qb)];
+                    case 1:
+                        ledger = _a.sent();
+                        summary = {
+                            applied: [],
+                            skippedManual: [],
+                            alreadyApplied: [],
+                            unresolved: [],
+                            notAttempted: [],
+                        };
+                        sourceRecordRepo = new SourceRecordRepo_1.SourceRecordRepo();
+                        pending = [];
+                        for (_i = 0, ledger_1 = ledger; _i < ledger_1.length; _i++) {
+                            row = ledger_1[_i];
+                            source = sourceRecordRepo.getSourceRecord(migrationTable.name, row.id);
+                            if (!source) {
+                                summary.unresolved.push(row.id);
+                                continue;
+                            }
+                            if (source.manual) {
+                                summary.skippedManual.push(row.id);
+                                continue;
+                            }
+                            if (row.status === 'success') {
+                                summary.alreadyApplied.push(row.id);
+                                continue;
+                            }
+                            pending.push(row);
+                        }
+                        this.logger.info({
+                            message: "Running ".concat(pending.length, " pending migration").concat(pending.length === 1 ? '' : 's', " in series, oldest-first"),
+                            obj: { pending: pending.map(function (row) { return row.id; }), skippedManual: summary.skippedManual },
+                        });
+                        i = 0;
+                        _a.label = 2;
+                    case 2:
+                        if (!(i < pending.length)) return [3 /*break*/, 5];
+                        return [4 /*yield*/, this.ensureMigrationRun(pending[i].id)];
+                    case 3:
+                        outcome = _a.sent();
+                        if (outcome.status === 'success') {
+                            summary.applied.push(outcome.id);
+                            return [3 /*break*/, 4];
+                        }
+                        summary.failed = {
+                            id: outcome.id,
+                            description: outcome.description,
+                            failureMessage: outcome.failureMessage,
+                        };
+                        summary.notAttempted = pending.slice(i + 1).map(function (row) { return row.id; });
+                        return [3 /*break*/, 5];
+                    case 4:
+                        i++;
+                        return [3 /*break*/, 2];
+                    case 5:
+                        this.logger.info({ message: "Migration series finished", obj: summary });
+                        return [2 /*return*/, summary];
                 }
             });
         });

package/dist/src/MigrationRunner.js.map

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

package/dist/src/RecordIterator.d.ts

@@ -2,13 +2,23 @@ import { Db } from './Db';
 import { Table } from './Table';
 import { Record } from './Record';
 import { Query } from './services/DbService';
+/**
+ * Iterate a table query in cursor-anchored windows (`CursorWindowPager`), `windowSize` rows
+ * per query. Cursor windows frame on the last row served instead of a positional offset, so
+ * rows inserted or deleted while iterating can never skip or duplicate rows — every row that
+ * exists throughout the iteration is yielded exactly once.
+ *
+ * Ordering: the sort criteria on the consumer's query builder become the cursor axes, with a
+ * unique `id` tiebreak appended (ties can't skip across window boundaries); with no sort the
+ * iteration runs in plain `id` order. Sort axes should be non-null columns — a window whose
+ * tail carries a NULL sort value ends the iteration (a null can't anchor a continuation).
+ *
+ * The caller's query builder is never mutated: every window builds on a fresh copy.
+ */
 export declare class RecordIterator<T extends Record> implements AsyncIterable<T> {
-    private db;
-    private table;
-    private query;
-    private pageSize;
-    private currentPage;
-    constructor(table: Table<T>, query: Query<T>, pageSize?: number, db?: Db);
+    private windowSize;
+    private pager;
+    constructor(table: Table<T>, query: Query<T>, windowSize?: number, db?: Db);
     [Symbol.asyncIterator](): AsyncIterator<T>;
 }
 //# sourceMappingURL=RecordIterator.d.ts.map

package/dist/src/RecordIterator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordIterator.d.ts","sourceRoot":"","sources":["../../src/RecordIterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAS,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,qBAAa,cAAc,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAE,MAAW,EAAE,EAAE,CAAC,EAAE,EAAE;IAQrE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAqBlD"}
+{"version":3,"file":"RecordIterator.d.ts","sourceRoot":"","sources":["../../src/RecordIterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAK7C;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAMrE,OAAO,CAAC,UAAU;IALpB,OAAO,CAAC,KAAK,CAAuB;gBAGlC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACP,UAAU,GAAE,MAAW,EAC/B,EAAE,CAAC,EAAE,EAAE;IAUF,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAelD"}

package/dist/src/RecordIterator.js

@@ -40,54 +40,67 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RecordIterator = void 0;
-var Db_1 = require("./Db");
 var QueryBuilderFactory_1 = require("./QueryBuilderFactory");
+var db_query_1 = require("@proteinjs/db-query");
+var CursorWindowPager_1 = require("./CursorWindowPager");
+/**
+ * Iterate a table query in cursor-anchored windows (`CursorWindowPager`), `windowSize` rows
+ * per query. Cursor windows frame on the last row served instead of a positional offset, so
+ * rows inserted or deleted while iterating can never skip or duplicate rows — every row that
+ * exists throughout the iteration is yielded exactly once.
+ *
+ * Ordering: the sort criteria on the consumer's query builder become the cursor axes, with a
+ * unique `id` tiebreak appended (ties can't skip across window boundaries); with no sort the
+ * iteration runs in plain `id` order. Sort axes should be non-null columns — a window whose
+ * tail carries a NULL sort value ends the iteration (a null can't anchor a continuation).
+ *
+ * The caller's query builder is never mutated: every window builds on a fresh copy.
+ */
 var RecordIterator = /** @class */ (function () {
-    function RecordIterator(table, query, pageSize, db) {
-        if (pageSize === void 0) { pageSize = 10; }
-        this.db = db || (0, Db_1.getDb)();
-        this.table = table;
-        this.query = new QueryBuilderFactory_1.QueryBuilderFactory().getQueryBuilder(table, query);
-        this.pageSize = pageSize;
-        this.currentPage = 0;
+    function RecordIterator(table, query, windowSize, db) {
+        if (windowSize === void 0) { windowSize = 10; }
+        this.windowSize = windowSize;
+        // A fresh copy of the consumer's query; its sort criteria lift off the base (the pager
+        // owns ordering — cursor axes and ORDER BY have to agree) and the conditions-only base
+        // seeds every window's fresh build.
+        var base = new QueryBuilderFactory_1.QueryBuilderFactory().createQueryBuilder(table, query);
+        var sort = base.removeSortCriteria();
+        this.pager = new CursorWindowPager_1.CursorWindowPager(table, function () { return db_query_1.QueryBuilder.fromQueryBuilder(base, table.name); }, sort, { db: db });
     }
     RecordIterator.prototype[Symbol.asyncIterator] = function () {
         return __asyncGenerator(this, arguments, function _a() {
-            var pagination, results, _i, results_1, item;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var anchor, window_1, _i, _b, row;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
-                        if (!true) return [3 /*break*/, 11];
-                        pagination = { start: this.currentPage * this.pageSize, end: (this.currentPage + 1) * this.pageSize };
-                        this.query.paginate(pagination);
-                        return [4 /*yield*/, __await(this.db.query(this.table, this.query))];
+                        anchor = null;
+                        _c.label = 1;
                     case 1:
-                        results = _b.sent();
-                        if (!(results.length === 0)) return [3 /*break*/, 3];
-                        return [4 /*yield*/, __await(void 0)];
-                    case 2: return [2 /*return*/, _b.sent()];
+                        if (!true) return [3 /*break*/, 10];
+                        return [4 /*yield*/, __await(this.pager.loadWindow(anchor, this.windowSize))];
+                    case 2:
+                        window_1 = _c.sent();
+                        _i = 0, _b = window_1.rows;
+                        _c.label = 3;
                     case 3:
-                        _i = 0, results_1 = results;
-                        _b.label = 4;
-                    case 4:
-                        if (!(_i < results_1.length)) return [3 /*break*/, 8];
-                        item = results_1[_i];
-                        return [4 /*yield*/, __await(item)];
-                    case 5: return [4 /*yield*/, _b.sent()];
+                        if (!(_i < _b.length)) return [3 /*break*/, 7];
+                        row = _b[_i];
+                        return [4 /*yield*/, __await(row)];
+                    case 4: return [4 /*yield*/, _c.sent()];
+                    case 5:
+                        _c.sent();
+                        _c.label = 6;
                     case 6:
-                        _b.sent();
-                        _b.label = 7;
-                    case 7:
                         _i++;
-                        return [3 /*break*/, 4];
-                    case 8:
-                        if (!(results.length < this.pageSize)) return [3 /*break*/, 10];
+                        return [3 /*break*/, 3];
+                    case 7:
+                        if (!!window_1.nextAnchor) return [3 /*break*/, 9];
                         return [4 /*yield*/, __await(void 0)];
-                    case 9: return [2 /*return*/, _b.sent()];
-                    case 10:
-                        this.currentPage++;
-                        return [3 /*break*/, 0];
-                    case 11: return [2 /*return*/];
+                    case 8: return [2 /*return*/, _c.sent()];
+                    case 9:
+                        anchor = window_1.nextAnchor;
+                        return [3 /*break*/, 1];
+                    case 10: return [2 /*return*/];
                 }
             });
         });

package/dist/src/RecordIterator.js.map

@@ -1 +1 @@
-{"version":3,"file":"RecordIterator.js","sourceRoot":"","sources":["../../src/RecordIterator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2BAAiC;AAIjC,6DAA4D;AAG5D;IAOE,wBAAY,KAAe,EAAE,KAAe,EAAE,QAAqB,EAAE,EAAO;QAA9B,yBAAA,EAAA,aAAqB;QACjE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,IAAA,UAAK,GAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,yCAAmB,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAEM,yBAAC,MAAM,CAAC,aAAa,CAAC,GAA7B;;;;;;6BACS,IAAI;wBACH,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;wBAC5G,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;wBAChB,6BAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAA;;wBAArD,OAAO,GAAG,SAA2C;6BAEvD,CAAA,OAAO,CAAC,MAAM,KAAK,CAAC,CAAA,EAApB,wBAAoB;;4BACtB,iCAAO;;8BAGiB,EAAP,mBAAO;;;6BAAP,CAAA,qBAAO,CAAA;wBAAf,IAAI;qDACP,IAAI;4BAAV,gCAAU;;wBAAV,SAAU,CAAC;;;wBADM,IAAO,CAAA;;;6BAItB,CAAA,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAA,EAA9B,yBAA8B;;4BAChC,iCAAO;;wBAGT,IAAI,CAAC,WAAW,EAAE,CAAC;;;;;;KAEtB;IACH,qBAAC;AAAD,CAAC,AApCD,IAoCC;AApCY,wCAAc"}
+{"version":3,"file":"RecordIterator.js","sourceRoot":"","sources":["../../src/RecordIterator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,6DAA4D;AAC5D,gDAAmD;AACnD,yDAAsE;AAEtE;;;;;;;;;;;;GAYG;AACH;IAGE,wBACE,KAAe,EACf,KAAe,EACP,UAAuB,EAC/B,EAAO;QADC,2BAAA,EAAA,eAAuB;QAAvB,eAAU,GAAV,UAAU,CAAa;QAG/B,uFAAuF;QACvF,uFAAuF;QACvF,oCAAoC;QACpC,IAAM,IAAI,GAAG,IAAI,yCAAmB,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxE,IAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,qCAAiB,CAAI,KAAK,EAAE,cAAM,OAAA,uBAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAA/C,CAA+C,EAAE,IAAI,EAAE,EAAE,EAAE,IAAA,EAAE,CAAC,CAAC;IACpH,CAAC;IAEM,yBAAC,MAAM,CAAC,aAAa,CAAC,GAA7B;;;;;;wBACM,MAAM,GAAwB,IAAI,CAAC;;;6BAChC,IAAI;wBACM,6BAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,GAAA;;wBAA7D,WAAS,SAAoD;8BACtC,EAAX,KAAA,QAAM,CAAC,IAAI;;;6BAAX,CAAA,cAAW,CAAA;wBAAlB,GAAG;qDACN,GAAG;4BAAT,gCAAS;;wBAAT,SAAS,CAAC;;;wBADM,IAAW,CAAA;;;6BAIzB,CAAC,QAAM,CAAC,UAAU,EAAlB,wBAAkB;;4BACpB,iCAAO;;wBAGT,MAAM,GAAG,QAAM,CAAC,UAAU,CAAC;;;;;;KAE9B;IACH,qBAAC;AAAD,CAAC,AAhCD,IAgCC;AAhCY,wCAAc"}

package/dist/src/tables/MigrationTable.d.ts

@@ -3,6 +3,15 @@ import { Table } from '../Table';
 import { SourceRecord } from '../source/SourceRecord';
 export interface Migration extends SourceRecord {
     description: string;
+    /**
+     * The explicit non-automatable class (plans/POST_RELEASE_QUEUE.md 27f): destructive
+     * contractions (column/table drops), long backfills over big tables, data-dependent one-offs.
+     * `manual: true` EXCLUDES the migration from the deploy-gated auto-run
+     * ({@link MigrationRunner.runPendingMigrations}); it keeps the Migrations-page flow
+     * (`runMigration`). Absence of the flag = automated — the invariant lives here, in the
+     * schema, not in deploy-pipeline prose.
+     */
+    manual?: boolean;
     status?: 'proposed' | 'running' | 'success' | 'failure';
     failureMessage?: string;
     failureStack?: string;
@@ -28,6 +37,7 @@ export declare class MigrationTable extends Table<Migration> {
         isLoadedFromSource: import("../Table").Column<boolean | undefined, any>;
     } & {} & {
         description: import("../Table").Column<string, any>;
+        manual: import("../Table").Column<boolean | undefined, any>;
         status: import("../Table").Column<"proposed" | "running" | "success" | "failure" | undefined, any>;
         failureMessage: import("../Table").Column<string | undefined, any>;
         failureStack: import("../Table").Column<string | undefined, any>;

package/dist/src/tables/MigrationTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MigrationTable.d.ts","sourceRoot":"","sources":["../../../src/tables/MigrationTable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,GAAG,EAAE,MAAM,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;CAChC;AAED,qBAAa,cAAe,SAAQ,KAAK,CAAC,SAAS,CAAC;IAC3C,IAAI,SAAe;IAC1B;;;;;OAKG;IACI,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAGnC;IACK,OAAO;;;;;;;;;;;;;;;;MASX;IACI,mBAAmB;;;;;MAKxB;CACH"}
+{"version":3,"file":"MigrationTable.d.ts","sourceRoot":"","sources":["../../../src/tables/MigrationTable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,GAAG,EAAE,MAAM,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;CAChC;AAED,qBAAa,cAAe,SAAQ,KAAK,CAAC,SAAS,CAAC;IAC3C,IAAI,SAAe;IAC1B;;;;;OAKG;IACI,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAGnC;IACK,OAAO;;;;;;;;;;;;;;;;;MAUX;IACI,mBAAmB;;;;;MAKxB;CACH"}

package/dist/src/tables/MigrationTable.js

@@ -72,6 +72,7 @@ var MigrationTable = /** @class */ (function (_super) {
         };
         _this.columns = (0, SourceRecord_1.withSourceRecordColumns)({
             description: new Columns_1.StringColumn('description', {}, 4000),
+            manual: new Columns_1.BooleanColumn('manual'),
             status: new Columns_1.StringColumn('status', { defaultValue: function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
                     return [2 /*return*/, 'proposed'];
                 }); }); } }),

package/dist/src/tables/MigrationTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"MigrationTable.js","sourceRoot":"","sources":["../../../src/tables/MigrationTable.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,sCAAwE;AACxE,kCAAiC;AACjC,uDAA+E;AAc/E;IAAoC,kCAAgB;IAApD;QAAA,qEA4BC;QA3BQ,UAAI,GAAG,WAAW,CAAC;QAC1B;;;;;WAKG;QACI,UAAI,GAA6B;YACtC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;YAClC,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;SACxC,CAAC;QACK,aAAO,GAAG,IAAA,sCAAuB,EAAY;YAClD,WAAW,EAAE,IAAI,sBAAY,CAAC,aAAa,EAAE,EAAE,EAAE,IAAI,CAAC;YACtD,MAAM,EAAE,IAAI,sBAAY,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE;oBAAY,sBAAA,UAAU,EAAA;yBAAA,EAAE,CAAC;YAC5E,cAAc,EAAE,IAAI,sBAAY,CAAC,iBAAiB,EAAE,EAAE,EAAE,IAAI,CAAC;YAC7D,YAAY,EAAE,IAAI,sBAAY,CAAC,eAAe,EAAE,EAAE,EAAE,KAAK,CAAC;YAC1D,SAAS,EAAE,IAAI,wBAAc,CAAC,YAAY,CAAC;YAC3C,OAAO,EAAE,IAAI,wBAAc,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,IAAI,sBAAY,CAAC,UAAU,CAAC;YACtC,MAAM,EAAE,IAAI,sBAAY,CAAC,QAAQ,CAAC;SACnC,CAAC,CAAC;QACI,yBAAmB,GAAG;YAC3B,8BAA8B,EAAE,IAAI;YACpC,EAAE,EAAE;gBACF,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;;IACJ,CAAC;IAAD,qBAAC;AAAD,CAAC,AA5BD,CAAoC,aAAK,GA4BxC;AA5BY,wCAAc"}
+{"version":3,"file":"MigrationTable.js","sourceRoot":"","sources":["../../../src/tables/MigrationTable.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,sCAAuF;AACvF,kCAAiC;AACjC,uDAA+E;AAuB/E;IAAoC,kCAAgB;IAApD;QAAA,qEA6BC;QA5BQ,UAAI,GAAG,WAAW,CAAC;QAC1B;;;;;WAKG;QACI,UAAI,GAA6B;YACtC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;YAClC,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;SACxC,CAAC;QACK,aAAO,GAAG,IAAA,sCAAuB,EAAY;YAClD,WAAW,EAAE,IAAI,sBAAY,CAAC,aAAa,EAAE,EAAE,EAAE,IAAI,CAAC;YACtD,MAAM,EAAE,IAAI,uBAAa,CAAC,QAAQ,CAAC;YACnC,MAAM,EAAE,IAAI,sBAAY,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE;oBAAY,sBAAA,UAAU,EAAA;yBAAA,EAAE,CAAC;YAC5E,cAAc,EAAE,IAAI,sBAAY,CAAC,iBAAiB,EAAE,EAAE,EAAE,IAAI,CAAC;YAC7D,YAAY,EAAE,IAAI,sBAAY,CAAC,eAAe,EAAE,EAAE,EAAE,KAAK,CAAC;YAC1D,SAAS,EAAE,IAAI,wBAAc,CAAC,YAAY,CAAC;YAC3C,OAAO,EAAE,IAAI,wBAAc,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,IAAI,sBAAY,CAAC,UAAU,CAAC;YACtC,MAAM,EAAE,IAAI,sBAAY,CAAC,QAAQ,CAAC;SACnC,CAAC,CAAC;QACI,yBAAmB,GAAG;YAC3B,8BAA8B,EAAE,IAAI;YACpC,EAAE,EAAE;gBACF,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;;IACJ,CAAC;IAAD,qBAAC;AAAD,CAAC,AA7BD,CAAoC,aAAK,GA6BxC;AA7BY,wCAAc"}

package/dist/test/CursorWindowPager.test.d.ts

@@ -0,0 +1,2 @@
+import '../generated/index';
+//# sourceMappingURL=CursorWindowPager.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CursorWindowPager.test.d.ts","sourceRoot":"","sources":["../../test/CursorWindowPager.test.ts"],"names":[],"mappings":"AAaA,OAAO,oBAAoB,CAAC"}

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":"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"}

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