@proteinjs/db-driver-spanner 1.12.3 → 1.13.0

package/dist/src/SpannerLivenessMonitor.js

@@ -40,6 +40,15 @@ exports.SpannerLivenessMonitor = void 0;
 var logger_1 = require("@proteinjs/logger");
 /** grpc status codes that indicate connectivity trouble rather than an application error */
 var CONNECTIVITY_GRPC_CODES = [4 /* DEADLINE_EXCEEDED */, 14 /* UNAVAILABLE */];
+/**
+ * Restart-requested exit code — the supervision contract shared with @proteinjs/build's
+ * serve-package (ServePackageSupervisor.RESTART_REQUEST_EXIT_CODE): a supervised process
+ * exiting with this code is respawned with bounded backoff instead of being treated as a plain
+ * failure (which the supervisor mirrors, i.e. stays down). Orchestrators that restart on any
+ * nonzero exit (systemd, Kubernetes) treat it like any other failure code, so it is safe
+ * everywhere. Hard-coded by design: the contract crosses a process boundary, like a signal.
+ */
+var RESTART_REQUEST_EXIT_CODE = 86;
 var SpannerLivenessMonitor = /** @class */ (function () {
     function SpannerLivenessMonitor(db) {
         this.db = db;
@@ -108,7 +117,7 @@ var SpannerLivenessMonitor = /** @class */ (function () {
                         return [3 /*break*/, 2];
                     case 8:
                         this.logger.error({
-                            message: "Db unreachable after sustained probing; exiting so supervision can restart into a valid state",
+                            message: "Db unreachable after sustained probing; exiting restart-requested (code ".concat(RESTART_REQUEST_EXIT_CODE, ") so supervision respawns into a valid state"),
                         });
                         this.exit();
                         return [3 /*break*/, 10];
@@ -139,7 +148,7 @@ var SpannerLivenessMonitor = /** @class */ (function () {
         return new Promise(function (resolve) { return setTimeout(resolve, ms); });
     };
     SpannerLivenessMonitor.prototype.exit = function () {
-        process.exit(1);
+        process.exit(RESTART_REQUEST_EXIT_CODE);
     };
     SpannerLivenessMonitor.PROBE_SQL = 'SELECT 1';
     SpannerLivenessMonitor.PROBE_TIMEOUT_MS = 10000;

package/dist/src/SpannerLivenessMonitor.js.map

@@ -1 +1 @@
-{"version":3,"file":"SpannerLivenessMonitor.js","sourceRoot":"","sources":["../../src/SpannerLivenessMonitor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SpannerLivenessMonitor.js","sourceRoot":"","sources":["../../src/SpannerLivenessMonitor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,4CAA2C;AAE3C,4FAA4F;AAC5F,IAAM,uBAAuB,GAAG,CAAC,CAAC,CAAC,uBAAuB,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;AAElF;;;;;;;GAOG;AACH,IAAM,yBAAyB,GAAG,EAAE,CAAC;AAErC;IAQE,gCAAoB,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;QAHxB,WAAM,GAAG,IAAI,eAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,kBAAa,GAAG,KAAK,CAAC;IAEK,CAAC;IAEpC,8FAA8F;IAC9F,sCAAK,GAAL;QAAA,iBASC;QARC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,UAAC,KAAU;;YAC7B,KAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,OAAO,EAAE,4EAA4E;gBACrF,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,EAAE,YAAY,EAAE,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,mCAAI,MAAM,CAAC,KAAK,CAAC,EAAE;aAC1E,CAAC,CAAC;YACH,KAAK,KAAI,CAAC,cAAc,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mFAAmF;IACnF,4CAAW,GAAX,UAAY,KAAU;QACpB,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,CAAC,EAAE;YAClD,OAAO;SACR;QACD,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;IAC7B,CAAC;IAED,uBAAuB;IAET,+CAAc,GAA5B;;;;;;;wBACE,IAAI,IAAI,CAAC,aAAa,EAAE;4BACtB,sBAAO,CAAC,mGAAmG;yBAC5G;wBACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;;;;wBAEf,OAAO,GAAG,CAAC;;;6BAAE,CAAA,OAAO,GAAG,sBAAsB,CAAC,eAAe,CAAC,MAAM,CAAA;wBAC3E,qBAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAA;;wBAAjE,SAAiE,CAAC;;;;wBAEhE,qBAAM,IAAI,CAAC,KAAK,EAAE,EAAA;;wBAAlB,SAAkB,CAAC;wBACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;wBACzF,sBAAO;;;wBAEP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;4BACf,OAAO,EAAE,8BAA8B;4BACvC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,YAAY,EAAE,MAAA,OAAK,aAAL,OAAK,uBAAL,OAAK,CAAE,OAAO,mCAAI,MAAM,CAAC,OAAK,CAAC,EAAE;yBAC7E,CAAC,CAAC;;;wBAVwE,OAAO,EAAE,CAAA;;;wBAaxF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;4BAChB,OAAO,EAAE,kFAA2E,yBAAyB,iDAA8C;yBAC5J,CAAC,CAAC;wBACH,IAAI,CAAC,IAAI,EAAE,CAAC;;;wBAEZ,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;;;;;;KAE9B;IAEa,sCAAK,GAAnB;;;;4BACE,qBAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;4BAChB,GAAG,EAAE,sBAAsB,CAAC,SAAS;4BACrC,UAAU,EAAE,EAAE,OAAO,EAAE,sBAAsB,CAAC,gBAAgB,EAAE;yBACjE,CAAC,EAAA;;wBAHF,SAGE,CAAC;;;;;KACJ;IAEO,sCAAK,GAAb,UAAc,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,UAAC,OAAO,IAAK,OAAA,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAvB,CAAuB,CAAC,CAAC;IAC3D,CAAC;IAEO,qCAAI,GAAZ;QACE,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IAxEuB,gCAAS,GAAG,UAAU,AAAb,CAAc;IACvB,uCAAgB,GAAG,KAAM,AAAT,CAAU;IAClD,gHAAgH;IACxF,sCAAe,GAAG,CAAC,CAAC,EAAE,IAAK,EAAE,KAAM,EAAE,KAAM,EAAE,KAAM,CAAC,AAArC,CAAsC;IAsE/E,6BAAC;CAAA,AA1ED,IA0EC;AA1EY,wDAAsB"}

package/dist/test/ServiceUpdateVerbs.test.d.ts

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

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

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

package/dist/test/ServiceUpdateVerbs.test.js

@@ -0,0 +1,325 @@
+"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 __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var db_driver_spanner_1 = require("@proteinjs/db-driver-spanner");
+var db_1 = require("@proteinjs/db");
+var db_transaction_context_1 = require("@proteinjs/db-transaction-context");
+var getDropTestTable_1 = require("./util/getDropTestTable");
+var SpannerEmulatorProvisioner_1 = require("./util/SpannerEmulatorProvisioner");
+var serviceUpdateVerbsTestTables_1 = require("./util/serviceUpdateVerbsTestTables");
+require("../generated/test/index");
+/**
+ * The RMW update verbs (`updateArrayMembership`, `updatePreserving`) over the DbService RPC
+ * path, against real Spanner transaction semantics.
+ *
+ * The service path differs from bespoke server code in three load-bearing ways, each pinned here:
+ * - ONE long-lived `Db` instance serves every request (ServiceRouter builds its executor map
+ *   once), so the verbs' self-wrapped transactions must not couple concurrent callers through
+ *   instance state.
+ * - args cross a serialization boundary: `Table` as `{ tableName }` resolved via `tableByName`,
+ *   the op payloads (`ArrayMembershipUpdate`, `PreservedPath`) as plain JSON.
+ * - authorization is the `TableServiceAuth.canAccess(methodName, args)` gate plus scoped/column
+ *   query injection inside the verb's read-modify-write — an out-of-scope row must behave as
+ *   nonexistent.
+ */
+var spannerDriver = new db_driver_spanner_1.SpannerDriver({
+    projectId: 'proteinjs-test',
+    instanceName: 'proteinjs-test',
+    databaseName: 'test',
+});
+describe('DbService RMW update verbs (updateArrayMembership / updatePreserving)', function () {
+    var docTable = new serviceUpdateVerbsTestTables_1.ServiceVerbsDocTable();
+    var dropTable = (0, getDropTestTable_1.getDropTestTable)(spannerDriver);
+    // Service-singleton shaped: one shared instance, default table resolution (tableByName).
+    var db = new db_1.Db(spannerDriver, undefined, new db_transaction_context_1.TransactionContext());
+    /**
+     * The wire forms the Serializer produces for DbService args: `Table` crosses as its name and is
+     * resolved via `tableByName` server-side (TableSerializer); the op payloads are plain JSON.
+     */
+    var overWire = function (args) {
+        return args.map(function (arg) { return ((0, db_1.isTable)(arg) ? (0, db_1.tableByName)(arg.name) : JSON.parse(JSON.stringify(arg))); });
+    };
+    /** Invoke like ServiceExecutor does: deserialize wire args, run the canAccess gate, call the method. */
+    var rpc = function (methodName, args) { return __awaiter(void 0, void 0, void 0, function () {
+        var wireArgs;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    wireArgs = overWire(args);
+                    if (!db.serviceMetadata.auth.canAccess(methodName, wireArgs)) {
+                        throw new Error("User not authorized to run service: DbService.".concat(methodName));
+                    }
+                    return [4 /*yield*/, (_a = db)[methodName].apply(_a, wireArgs)];
+                case 1: return [2 /*return*/, _b.sent()];
+            }
+        });
+    }); };
+    var memberIds = function (id) { return __awaiter(void 0, void 0, void 0, function () {
+        var row;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, db.get(docTable, { id: id })];
+                case 1:
+                    row = _b.sent();
+                    return [2 /*return*/, (_a = row === null || row === void 0 ? void 0 : row.members) === null || _a === void 0 ? void 0 : _a._ids];
+            }
+        });
+    }); };
+    beforeAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, SpannerEmulatorProvisioner_1.SpannerEmulatorProvisioner.ensureProvisioned({
+                        projectId: 'proteinjs-test',
+                        instanceName: 'proteinjs-test',
+                        databaseName: 'test',
+                    })];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, dropTable(docTable)];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, spannerDriver.getTableManager().loadTable(docTable)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 60000);
+    afterAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, dropTable(docTable)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, SpannerEmulatorProvisioner_1.SpannerEmulatorProvisioner.release()];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    beforeEach(function () {
+        serviceUpdateVerbsTestTables_1.serviceVerbsScopeContext.current = 'scope-a';
+    });
+    test('membership ops apply against committed truth, not the caller list snapshot', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, update, _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0: return [4 /*yield*/, db.insert(docTable, {
+                        title: 'd1',
+                        members: new db_1.ReferenceArray(docTable.name, ['a', 'b', 'c']),
+                    })];
+                case 1:
+                    doc = _c.sent();
+                    // Another writer's committed wholesale update adds `d` — the caller's snapshot is now stale.
+                    return [4 /*yield*/, db.update(docTable, { id: doc.id, members: new db_1.ReferenceArray(docTable.name, ['a', 'b', 'c', 'd']) })];
+                case 2:
+                    // Another writer's committed wholesale update adds `d` — the caller's snapshot is now stale.
+                    _c.sent();
+                    update = {
+                        recordId: doc.id,
+                        columnPropertyName: 'members',
+                        ops: (0, db_1.computeArrayMembershipOps)(['a', 'b', 'c'], ['a', 'c']),
+                    };
+                    _a = expect;
+                    return [4 /*yield*/, rpc('updateArrayMembership', [docTable, update])];
+                case 3:
+                    _a.apply(void 0, [_c.sent()]).toBe(1);
+                    // Both writers' effects survive; a wholesale write of the stale list would have erased `d`.
+                    _b = expect;
+                    return [4 /*yield*/, memberIds(doc.id)];
+                case 4:
+                    // Both writers' effects survive; a wholesale write of the stale list would have erased `d`.
+                    _b.apply(void 0, [_c.sent()]).toEqual(['a', 'c', 'd']);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('a scoped caller cannot touch another scope’s row via updateArrayMembership', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, removeA, _a, _b, _c, _d;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0: return [4 /*yield*/, db.insert(docTable, { title: 'd2', members: new db_1.ReferenceArray(docTable.name, ['a', 'b']) })];
+                case 1:
+                    doc = _e.sent();
+                    serviceUpdateVerbsTestTables_1.serviceVerbsScopeContext.current = 'scope-b';
+                    removeA = {
+                        recordId: doc.id,
+                        columnPropertyName: 'members',
+                        ops: [{ op: 'remove', id: 'a' }],
+                    };
+                    _a = expect;
+                    return [4 /*yield*/, rpc('updateArrayMembership', [docTable, removeA])];
+                case 2:
+                    _a.apply(void 0, [_e.sent()]).toBe(0);
+                    serviceUpdateVerbsTestTables_1.serviceVerbsScopeContext.current = 'scope-a';
+                    _b = expect;
+                    return [4 /*yield*/, memberIds(doc.id)];
+                case 3:
+                    _b.apply(void 0, [_e.sent()]).toEqual(['a', 'b']);
+                    // The owning scope can perform the identical op.
+                    _c = expect;
+                    return [4 /*yield*/, rpc('updateArrayMembership', [docTable, removeA])];
+                case 4:
+                    // The owning scope can perform the identical op.
+                    _c.apply(void 0, [_e.sent()]).toBe(1);
+                    _d = expect;
+                    return [4 /*yield*/, memberIds(doc.id)];
+                case 5:
+                    _d.apply(void 0, [_e.sent()]).toEqual(['b']);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('a scoped caller cannot touch another scope’s row via updatePreserving', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, preserve, foreignWrite, _a, row;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, db.insert(docTable, { title: 'd3', body: { content: 'v1', style: { color: 'blue' } } })];
+                case 1:
+                    doc = _b.sent();
+                    serviceUpdateVerbsTestTables_1.serviceVerbsScopeContext.current = 'scope-b';
+                    preserve = [{ columnPropertyName: 'body', paths: ['content'], whenType: 'string' }];
+                    foreignWrite = { id: doc.id, body: { content: 'hijack', style: { color: 'red' } } };
+                    _a = expect;
+                    return [4 /*yield*/, rpc('updatePreserving', [docTable, foreignWrite, preserve])];
+                case 2:
+                    _a.apply(void 0, [_b.sent()]).toBe(0);
+                    serviceUpdateVerbsTestTables_1.serviceVerbsScopeContext.current = 'scope-a';
+                    return [4 /*yield*/, db.get(docTable, { id: doc.id })];
+                case 3:
+                    row = _b.sent();
+                    expect(row.body).toEqual({ content: 'v1', style: { color: 'blue' } });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('updatePreserving over the service preserves the committed sub-path while writing owned paths', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, preserve, stalePayload, _a, row;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, db.insert(docTable, { title: 'd4', body: { content: 'v1', style: { color: 'blue' } } })];
+                case 1:
+                    doc = _b.sent();
+                    // The owning writer's committed text save; the structural writer's payload still carries v1.
+                    return [4 /*yield*/, db.update(docTable, { id: doc.id, body: { content: 'v2', style: { color: 'blue' } } })];
+                case 2:
+                    // The owning writer's committed text save; the structural writer's payload still carries v1.
+                    _b.sent();
+                    preserve = [{ columnPropertyName: 'body', paths: ['content'], whenType: 'string' }];
+                    stalePayload = { id: doc.id, body: { content: 'v1', style: { color: 'red' } } };
+                    _a = expect;
+                    return [4 /*yield*/, rpc('updatePreserving', [docTable, stalePayload, preserve])];
+                case 3:
+                    _a.apply(void 0, [_b.sent()]).toBe(1);
+                    return [4 /*yield*/, db.get(docTable, { id: doc.id })];
+                case 4:
+                    row = _b.sent();
+                    expect(row.body).toEqual({ content: 'v2', style: { color: 'red' } });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('concurrent RPCs on the shared service instance get isolated transactions', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, addedIds, inFlight, _i, addedIds_1, id, _a, _b;
+        var _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0: return [4 /*yield*/, db.insert(docTable, { title: 'd5', members: new db_1.ReferenceArray(docTable.name, ['seed']) })];
+                case 1:
+                    doc = _d.sent();
+                    addedIds = ['m1', 'm2', 'm3', 'm4', 'm5', 'm6'];
+                    inFlight = [];
+                    _i = 0, addedIds_1 = addedIds;
+                    _d.label = 2;
+                case 2:
+                    if (!(_i < addedIds_1.length)) return [3 /*break*/, 5];
+                    id = addedIds_1[_i];
+                    inFlight.push(rpc('updateArrayMembership', [
+                        docTable,
+                        { recordId: doc.id, columnPropertyName: 'members', ops: [{ op: 'add', id: id, afterId: 'seed' }] },
+                    ]));
+                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 5); })];
+                case 3:
+                    _d.sent();
+                    _d.label = 4;
+                case 4:
+                    _i++;
+                    return [3 /*break*/, 2];
+                case 5: return [4 /*yield*/, Promise.all(inFlight)];
+                case 6:
+                    _d.sent();
+                    _a = expect;
+                    _b = [[]];
+                    return [4 /*yield*/, memberIds(doc.id)];
+                case 7:
+                    _a.apply(void 0, [__spreadArray.apply(void 0, _b.concat([((_c = (_d.sent())) !== null && _c !== void 0 ? _c : []), true])).sort()]).toEqual(__spreadArray(__spreadArray([], addedIds, true), ['seed'], false).sort());
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 60000);
+    test('updateArrayMembership rejects a non-ReferenceArrayColumn target', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, db.insert(docTable, { title: 'd6' })];
+                case 1:
+                    doc = _a.sent();
+                    return [4 /*yield*/, expect(rpc('updateArrayMembership', [
+                            docTable,
+                            { recordId: doc.id, columnPropertyName: 'title', ops: [{ op: 'add', id: 'x', afterId: null }] },
+                        ])).rejects.toThrow('requires a ReferenceArrayColumn')];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=ServiceUpdateVerbs.test.js.map

package/dist/test/ServiceUpdateVerbs.test.js.map

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

package/dist/test/SessionRecordTableQuery.test.d.ts

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

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

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

package/dist/test/SessionRecordTableQuery.test.js

@@ -0,0 +1,185 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+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 });
+var moment_1 = __importDefault(require("moment"));
+var db_driver_spanner_1 = require("@proteinjs/db-driver-spanner");
+var db_1 = require("@proteinjs/db");
+var db_transaction_context_1 = require("@proteinjs/db-transaction-context");
+var getDropTestTable_1 = require("./util/getDropTestTable");
+var SpannerEmulatorProvisioner_1 = require("./util/SpannerEmulatorProvisioner");
+require("../generated/test/index");
+/** Mirrors @proteinjs/user SessionTable column-for-column (namespaced test table name). */
+var SessionShapeTable = /** @class */ (function (_super) {
+    __extends(SessionShapeTable, _super);
+    function SessionShapeTable() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.name = 'db_test_session_record_table_query';
+        _this.columns = (0, db_1.withRecordColumns)({
+            sessionId: new db_1.StringColumn('session_id'),
+            session: new db_1.StringColumn('serialized_session', {}, 4000),
+            expires: new db_1.DateColumn('expires'),
+            userEmail: new db_1.StringColumn('user_email'),
+        });
+        return _this;
+    }
+    return SessionShapeTable;
+}(db_1.Table));
+var table = new SessionShapeTable();
+var getTable = function (tableName) {
+    if (tableName === table.name) {
+        return table;
+    }
+    throw new Error("Unexpected table lookup in test: ".concat(tableName));
+};
+var spannerDriver = new db_driver_spanner_1.SpannerDriver({
+    projectId: 'proteinjs-test',
+    instanceName: 'proteinjs-test',
+    databaseName: 'test',
+}, getTable);
+/**
+ * What DbSessionStore serializes into a row (shape from a real dev session). `updated` is
+ * stamped explicitly for deterministic newest-first assertions: the insert-time default takes
+ * moment() per row, and rows landing in the same millisecond would make the order ambiguous.
+ */
+var storeShapedRow = function (n, updatedMs) { return ({
+    sessionId: "test-session-".concat(n),
+    session: JSON.stringify({
+        cookie: { originalMaxAge: 5184000000, expires: '2026-10-01T00:00:00.000Z', httpOnly: true, path: '/' },
+        passport: { user: "user-".concat(n, "@test.local") },
+    }),
+    expires: new Date(Date.now() + 5184000000),
+    userEmail: "user-".concat(n, "@test.local"),
+    updated: (0, moment_1.default)(updatedMs),
+}); };
+describe('Session-shaped record table query (the admin Sessions table path)', function () {
+    var dropTable = (0, getDropTestTable_1.getDropTestTable)(spannerDriver);
+    // Writes as the session store writes (system db), reads as the record table reads.
+    var systemDb = new db_1.Db(spannerDriver, getTable, new db_transaction_context_1.TransactionContext(), true);
+    var db = new db_1.Db(spannerDriver, getTable, new db_transaction_context_1.TransactionContext());
+    beforeAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, SpannerEmulatorProvisioner_1.SpannerEmulatorProvisioner.ensureProvisioned({
+                        projectId: 'proteinjs-test',
+                        instanceName: 'proteinjs-test',
+                        databaseName: 'test',
+                    })];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, dropTable(table)];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, spannerDriver.getTableManager().loadTable(table)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 60000);
+    afterAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, dropTable(table)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, SpannerEmulatorProvisioner_1.SpannerEmulatorProvisioner.release()];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('store-written session rows all come back through the record-table query, newest-first', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var base, n, qb, rows, countQb, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    base = Date.now() - 60000;
+                    n = 1;
+                    _b.label = 1;
+                case 1:
+                    if (!(n <= 3)) return [3 /*break*/, 4];
+                    return [4 /*yield*/, systemDb.insert(table, storeShapedRow(n, base + n * 1000))];
+                case 2:
+                    _b.sent();
+                    _b.label = 3;
+                case 3:
+                    n++;
+                    return [3 /*break*/, 1];
+                case 4:
+                    qb = new db_1.QueryBuilderFactory()
+                        .createQueryBuilder(table)
+                        .sort([{ field: 'updated', desc: true }])
+                        .paginate({ start: 0, end: 10 });
+                    return [4 /*yield*/, db.query(table, qb)];
+                case 5:
+                    rows = _b.sent();
+                    expect(rows.map(function (row) { return row.sessionId; })).toEqual(['test-session-3', 'test-session-2', 'test-session-1']);
+                    // Round-trip fidelity of the store-shaped fields the table displays.
+                    expect(rows[0].userEmail).toBe('user-3@test.local');
+                    expect(JSON.parse(rows[0].session).passport.user).toBe('user-3@test.local');
+                    expect(rows[0].expires).toBeTruthy();
+                    countQb = new db_1.QueryBuilderFactory().createQueryBuilder(table);
+                    _a = expect;
+                    return [4 /*yield*/, db.getRowCount(table, countQb)];
+                case 6:
+                    _a.apply(void 0, [_b.sent()]).toBe(3);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 60000);
+});
+//# sourceMappingURL=SessionRecordTableQuery.test.js.map

package/dist/test/SessionRecordTableQuery.test.js.map

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

package/dist/test/SpannerLivenessMonitor.test.js

@@ -122,6 +122,29 @@ describe('SpannerLivenessMonitor', function () {
             }
         });
     }); });
+    test('the sustained-failure exit is RESTART-REQUESTED (code 86) so supervision respawns instead of staying down', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var processExitSpy, check;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    // The serve-package contract (ServePackageSupervisor.RESTART_REQUEST_EXIT_CODE): 86 asks
+                    // the supervisor for a respawn with backoff; a plain exit(1) is mirrored and stays down —
+                    // observed as a dev server dead all night after a transient network outage.
+                    exitSpy.mockRestore();
+                    processExitSpy = jest.spyOn(process, 'exit').mockImplementation((function () { return undefined; }));
+                    probeSpy.mockRejectedValue(new Error('14 UNAVAILABLE: fake'));
+                    check = internals.verifyLiveness();
+                    return [4 /*yield*/, jest.advanceTimersByTimeAsync(ALL_PROBE_DELAYS_MS)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, check];
+                case 2:
+                    _a.sent();
+                    expect(processExitSpy).toHaveBeenCalledWith(86);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
     test('burst coalescing: reportError while a check is in flight triggers one probe cycle', function () { return __awaiter(void 0, void 0, void 0, function () {
         return __generator(this, function (_a) {
             switch (_a.label) {