@proteinjs/db-driver-spanner 1.12.3 → 1.14.0

package/dist/test/TransactionSafety.test.js

@@ -0,0 +1,325 @@
+"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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var db_1 = require("@proteinjs/db");
+var db_transaction_context_1 = require("@proteinjs/db-transaction-context");
+var db_driver_spanner_1 = require("@proteinjs/db-driver-spanner");
+var getDropTestTable_1 = require("./util/getDropTestTable");
+var SpannerEmulatorProvisioner_1 = require("./util/SpannerEmulatorProvisioner");
+require("../generated/test/index");
+var SafetyEmployeeTestTable = /** @class */ (function (_super) {
+    __extends(SafetyEmployeeTestTable, _super);
+    function SafetyEmployeeTestTable() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.name = 'db_test_txn_safety_employee';
+        _this.columns = (0, db_1.withRecordColumns)({
+            name: new db_1.StringColumn('name'),
+            department: new db_1.StringColumn('department'),
+        });
+        return _this;
+    }
+    return SafetyEmployeeTestTable;
+}(db_1.Table));
+var employeeTable = new SafetyEmployeeTestTable();
+// Local table — not in any reflection source graph, so thread getTable explicitly.
+var getTable = function () { return employeeTable; };
+var spannerConfig = {
+    projectId: 'proteinjs-test',
+    instanceName: 'proteinjs-test',
+    databaseName: 'test',
+};
+var spannerDriver = new db_driver_spanner_1.SpannerDriver(spannerConfig, getTable);
+/**
+ * The STATELESS transaction contract (plans/DB_PERF_PLAN.md P2, superseding the
+ * construction-time-binding guard): Db instances carry no transaction state — every operation
+ * resolves the ambient transaction (AsyncLocalStorage) at call time. Inside a transaction body
+ * every Db rides the transaction, whenever it was constructed; outside, every Db uses the
+ * pool. The one escape shape — work spawned inside a body that outlives the transaction while
+ * holding its context — fails loudly by name (the ended-context tombstone).
+ */
+describe('Transaction safety (stateless contract)', function () {
+    var dropTable = (0, getDropTestTable_1.getDropTestTable)(spannerDriver);
+    // Constructed at describe scope, BEFORE any transaction — under the old construction-time
+    // binding this instance was the "stale Db" hazard; now it must simply ride whatever ambient
+    // transaction is active at call time.
+    var preconstructedDb = new db_1.Db(spannerDriver, getTable, new db_transaction_context_1.TransactionContext());
+    var txnDb = 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(spannerConfig)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, spannerDriver.createDbIfNotExists()];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, spannerDriver.getTableManager().loadTable(employeeTable)];
+                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(employeeTable)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, SpannerEmulatorProvisioner_1.SpannerEmulatorProvisioner.release()];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 60000);
+    test('a PRE-CONSTRUCTED Db rides the ambient transaction: its reads see the txn write, and the txn commits', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var employee, inserted, committed;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    employee = {
+                        name: 'TxnSafetyRides',
+                        department: 'Engineering',
+                    };
+                    return [4 /*yield*/, txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () {
+                            var emp, seenInside;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, txnDb.insert(employeeTable, employee)];
+                                    case 1:
+                                        emp = _a.sent();
+                                        return [4 /*yield*/, preconstructedDb.query(employeeTable, { id: emp.id })];
+                                    case 2:
+                                        seenInside = _a.sent();
+                                        expect(seenInside.length).toBe(1);
+                                        return [2 /*return*/, emp];
+                                }
+                            });
+                        }); })];
+                case 1:
+                    inserted = _a.sent();
+                    return [4 /*yield*/, preconstructedDb.query(employeeTable, { id: inserted.id })];
+                case 2:
+                    committed = _a.sent();
+                    expect(committed.length).toBe(1);
+                    return [4 /*yield*/, txnDb.delete(employeeTable, { id: inserted.id })];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('a Db constructed INSIDE a transaction, used after commit, cleanly uses the pool and sees committed state', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var escapedDb, inserted, seen;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    escapedDb = new db_1.Db(spannerDriver, getTable, new db_transaction_context_1.TransactionContext());
+                                    return [4 /*yield*/, escapedDb.insert(employeeTable, { name: 'TxnSafetyAfterCommit' })];
+                                case 1: return [2 /*return*/, _a.sent()];
+                            }
+                        });
+                    }); })];
+                case 1:
+                    inserted = _a.sent();
+                    return [4 /*yield*/, escapedDb.query(employeeTable, { id: inserted.id })];
+                case 2:
+                    seen = _a.sent();
+                    expect(seen.length).toBe(1);
+                    return [4 /*yield*/, escapedDb.delete(employeeTable, { id: inserted.id })];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('atomicity through ANY instance: a rollback takes the pre-constructed Db write with it', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var after;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, expect(txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: 
+                                // If this insert did NOT ride the transaction it would self-commit in its own
+                                // transaction and survive the rollback below — the exact decay a severed ambient
+                                // resolution produces (a commit-path assertion can't see it; this one can).
+                                return [4 /*yield*/, preconstructedDb.insert(employeeTable, { name: 'TxnSafetyAtomic' })];
+                                case 1:
+                                    // If this insert did NOT ride the transaction it would self-commit in its own
+                                    // transaction and survive the rollback below — the exact decay a severed ambient
+                                    // resolution produces (a commit-path assertion can't see it; this one can).
+                                    _a.sent();
+                                    throw new Error('force-rollback');
+                            }
+                        });
+                    }); })).rejects.toThrow('force-rollback')];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, preconstructedDb.query(employeeTable, { name: 'TxnSafetyAtomic' })];
+                case 2:
+                    after = _a.sent();
+                    expect(after.length).toBe(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('nested transactions throw, from ANY instance', function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, expect(txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, preconstructedDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                                        return [2 /*return*/, 'never-runs'];
+                                    }); }); })];
+                                case 1:
+                                    _a.sent();
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); })).rejects.toThrow(/already running in this context/)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('two concurrent transactions on ONE shared instance commit independently', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var _a, a, b, seen;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, Promise.all([
+                        txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, txnDb.insert(employeeTable, { name: 'TxnSafetyConcurrentA' })];
+                                case 1: return [2 /*return*/, _a.sent()];
+                            }
+                        }); }); }),
+                        txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, txnDb.insert(employeeTable, { name: 'TxnSafetyConcurrentB' })];
+                                case 1: return [2 /*return*/, _a.sent()];
+                            }
+                        }); }); }),
+                    ])];
+                case 1:
+                    _a = _b.sent(), a = _a[0], b = _a[1];
+                    return [4 /*yield*/, txnDb.query(employeeTable, new db_1.QueryBuilderFactory()
+                            .createQueryBuilder(employeeTable)
+                            .condition({ field: 'id', operator: 'IN', value: [a.id, b.id] }))];
+                case 2:
+                    seen = _b.sent();
+                    expect(seen.length).toBe(2);
+                    return [4 /*yield*/, txnDb.delete(employeeTable, { id: a.id })];
+                case 3:
+                    _b.sent();
+                    return [4 /*yield*/, txnDb.delete(employeeTable, { id: b.id })];
+                case 4:
+                    _b.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('tombstone: work that escapes a finished transaction fails loudly by name', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var releaseEscape, escapeGate, escapedOp;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    escapeGate = new Promise(function (resolve) { return (releaseEscape = resolve); });
+                    return [4 /*yield*/, txnDb.runTransaction(function () { return __awaiter(void 0, void 0, void 0, function () {
+                            return __generator(this, function (_a) {
+                                // Spawned inside the body, NOT awaited by it — it captures the transaction's async
+                                // context and outlives the transaction.
+                                escapedOp = (function () { return __awaiter(void 0, void 0, void 0, function () {
+                                    return __generator(this, function (_a) {
+                                        switch (_a.label) {
+                                            case 0: return [4 /*yield*/, escapeGate];
+                                            case 1:
+                                                _a.sent();
+                                                return [4 /*yield*/, txnDb.query(employeeTable, { name: 'TxnSafetyEscapee' })];
+                                            case 2: return [2 /*return*/, _a.sent()];
+                                        }
+                                    });
+                                }); })();
+                                return [2 /*return*/];
+                            });
+                        }); })];
+                case 1:
+                    _a.sent();
+                    releaseEscape();
+                    return [4 /*yield*/, expect(escapedOp).rejects.toThrow(/transaction that already ended/)];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+    test('queries outside any transaction are plain pool reads', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var seen;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, preconstructedDb.query(employeeTable, { name: 'TxnSafetyNoTxn' })];
+                case 1:
+                    seen = _a.sent();
+                    expect(seen.length).toBe(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 30000);
+});
+//# sourceMappingURL=TransactionSafety.test.js.map

package/dist/test/TransactionSafety.test.js.map

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

package/dist/test/index.d.ts

@@ -1,3 +1,4 @@
 export * from './util/getDropTestTable';
 export * from './util/SpannerEmulatorProvisioner';
+export * from './util/serviceUpdateVerbsTestTables';
 //# 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,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../test/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC"}

package/dist/test/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./util/getDropTestTable"), exports);
 __exportStar(require("./util/SpannerEmulatorProvisioner"), exports);
+__exportStar(require("./util/serviceUpdateVerbsTestTables"), 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,0DAAwC;AACxC,oEAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../test/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,oEAAkD;AAClD,sEAAoD"}

package/dist/test/util/serviceUpdateVerbsTestTables.d.ts

@@ -0,0 +1,45 @@
+import { Record, ReferenceArray, Table } from '@proteinjs/db';
+/**
+ * Tables for `ServiceUpdateVerbs.test.ts` (the service-path RMW update verbs:
+ * `updateArrayMembership` / `updatePreserving`).
+ *
+ * Defined here rather than in the test file so the reflection build registers them as `Table`
+ * loadables — `tableByName` (which the db-service singleton and the `Table` wire serializer both
+ * resolve through) must be able to find them for the test's RPC-boundary simulation.
+ */
+/**
+ * Mutable stand-in for the ambient caller identity a scoped column reads (in production, the
+ * session's user id). Tests reassign `current` to act as different callers.
+ */
+export declare const serviceVerbsScopeContext: {
+    current: string;
+};
+export type ServiceVerbsDocBody = {
+    content?: string;
+    style?: {
+        color?: string;
+    };
+};
+export interface ServiceVerbsDoc extends Record {
+    title: string;
+    scope?: string;
+    /** Self-referencing children list — the reference-array shape membership ops target. */
+    members?: ReferenceArray<ServiceVerbsDoc>;
+    /** Plain-JSON column with sub-path ownership split across writers (content vs style). */
+    body?: ServiceVerbsDocBody;
+}
+/** Mirrors the generic scoped-record mechanism: scope forced on insert, immutable, injected into every non-system query. */
+export declare class ServiceVerbsDocTable extends Table<ServiceVerbsDoc> {
+    name: string;
+    columns: {
+        id: import("@proteinjs/db").Column<string, any>;
+        created: import("@proteinjs/db").Column<import("moment").Moment, any>;
+        updated: import("@proteinjs/db").Column<import("moment").Moment, any>;
+    } & {} & {
+        title: import("@proteinjs/db").Column<string, any>;
+        scope: import("@proteinjs/db").Column<string | undefined, any>;
+        members: import("@proteinjs/db").Column<ReferenceArray<ServiceVerbsDoc> | undefined, any>;
+        body: import("@proteinjs/db").Column<ServiceVerbsDocBody | undefined, any>;
+    } & {};
+}
+//# sourceMappingURL=serviceUpdateVerbsTestTables.d.ts.map

package/dist/test/util/serviceUpdateVerbsTestTables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceUpdateVerbsTestTables.d.ts","sourceRoot":"","sources":["../../../test/util/serviceUpdateVerbsTestTables.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EACN,cAAc,EAGd,KAAK,EAEN,MAAM,eAAe,CAAC;AAEvB;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;CAAyB,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,OAAO,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAC1C,yFAAyF;IACzF,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,4HAA4H;AAC5H,qBAAa,oBAAqB,SAAQ,KAAK,CAAC,eAAe,CAAC;IACvD,IAAI,SAAsC;IAC1C,OAAO;;;;;;;;;WAcX;CACJ"}

package/dist/test/util/serviceUpdateVerbsTestTables.js

@@ -0,0 +1,100 @@
+"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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceVerbsDocTable = exports.serviceVerbsScopeContext = void 0;
+var db_1 = require("@proteinjs/db");
+/**
+ * Tables for `ServiceUpdateVerbs.test.ts` (the service-path RMW update verbs:
+ * `updateArrayMembership` / `updatePreserving`).
+ *
+ * Defined here rather than in the test file so the reflection build registers them as `Table`
+ * loadables — `tableByName` (which the db-service singleton and the `Table` wire serializer both
+ * resolve through) must be able to find them for the test's RPC-boundary simulation.
+ */
+/**
+ * Mutable stand-in for the ambient caller identity a scoped column reads (in production, the
+ * session's user id). Tests reassign `current` to act as different callers.
+ */
+exports.serviceVerbsScopeContext = { current: 'scope-a' };
+/** Mirrors the generic scoped-record mechanism: scope forced on insert, immutable, injected into every non-system query. */
+var ServiceVerbsDocTable = /** @class */ (function (_super) {
+    __extends(ServiceVerbsDocTable, _super);
+    function ServiceVerbsDocTable() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.name = 'db_test_service_update_verbs_doc';
+        _this.columns = (0, db_1.withRecordColumns)({
+            title: new db_1.StringColumn('title'),
+            scope: new db_1.StringColumn('scope', {
+                defaultValue: function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                    return [2 /*return*/, exports.serviceVerbsScopeContext.current];
+                }); }); },
+                forceDefaultValue: function (runAsSystem) { return !runAsSystem; },
+                immutable: function (runAsSystem) { return !runAsSystem; },
+                addToQuery: function (qb, runAsSystem) { return __awaiter(_this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        if (!runAsSystem) {
+                            qb.condition({ field: 'scope', operator: 'IN', value: [exports.serviceVerbsScopeContext.current] });
+                        }
+                        return [2 /*return*/];
+                    });
+                }); },
+            }),
+            members: new db_1.ReferenceArrayColumn('members', 'db_test_service_update_verbs_doc', false),
+            body: new db_1.ObjectColumn('body'),
+        });
+        return _this;
+    }
+    return ServiceVerbsDocTable;
+}(db_1.Table));
+exports.ServiceVerbsDocTable = ServiceVerbsDocTable;
+//# sourceMappingURL=serviceUpdateVerbsTestTables.js.map

package/dist/test/util/serviceUpdateVerbsTestTables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceUpdateVerbsTestTables.js","sourceRoot":"","sources":["../../../test/util/serviceUpdateVerbsTestTables.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oCAQuB;AAEvB;;;;;;;GAOG;AAEH;;;GAGG;AACU,QAAA,wBAAwB,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAa/D,4HAA4H;AAC5H;IAA0C,wCAAsB;IAAhE;QAAA,qEAiBC;QAhBQ,UAAI,GAAG,kCAAkC,CAAC;QAC1C,aAAO,GAAG,IAAA,sBAAiB,EAAkB;YAClD,KAAK,EAAE,IAAI,iBAAY,CAAC,OAAO,CAAC;YAChC,KAAK,EAAE,IAAI,iBAAY,CAAC,OAAO,EAAE;gBAC/B,YAAY,EAAE;oBAAY,sBAAA,gCAAwB,CAAC,OAAO,EAAA;yBAAA;gBAC1D,iBAAiB,EAAE,UAAC,WAAW,IAAK,OAAA,CAAC,WAAW,EAAZ,CAAY;gBAChD,SAAS,EAAE,UAAC,WAAW,IAAK,OAAA,CAAC,WAAW,EAAZ,CAAY;gBACxC,UAAU,EAAE,UAAO,EAAE,EAAE,WAAW;;wBAChC,IAAI,CAAC,WAAW,EAAE;4BAChB,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,gCAAwB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;yBAC7F;;;qBACF;aACF,CAAC;YACF,OAAO,EAAE,IAAI,yBAAoB,CAAC,SAAS,EAAE,kCAAkC,EAAE,KAAK,CAAC;YACvF,IAAI,EAAE,IAAI,iBAAY,CAAsB,MAAM,CAAC;SACpD,CAAC,CAAC;;IACL,CAAC;IAAD,2BAAC;AAAD,CAAC,AAjBD,CAA0C,UAAK,GAiB9C;AAjBY,oDAAoB"}