@proteinjs/db-settings 1.3.46 → 1.3.47

package/dist/test/DeduplicateSettingRows.test.js

@@ -0,0 +1,195 @@
+"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 });
+var db_1 = require("@proteinjs/db");
+var test_1 = require("@proteinjs/db-driver-spanner/test");
+var moment_1 = __importDefault(require("moment"));
+var DeduplicateSettingRows_1 = require("../src/migrations/DeduplicateSettingRows");
+var SettingTable_1 = require("../src/tables/SettingTable");
+var tables_1 = require("../src/tables/tables");
+require("@proteinjs/db-transaction-context");
+require("../generated/index");
+/**
+ * The data step that carries a live database to one row per name: over a setting table as it
+ * stood before the unique index (duplicate rows of a (scope, name) in it), schema sync refuses to
+ * add the index; the migration keeps the newest row of every (scope, name) — by `updated`, then
+ * `created` — and deletes the rest, touching no other row; a second run deletes nothing; the index
+ * then lands. On a database without the table it does nothing.
+ */
+var emulator = { projectId: 'proteinjs-test', instanceName: 'proteinjs-test', databaseName: 'test' };
+describe('keeping one setting row per scope and name ahead of the unique index', function () {
+    var systemDb = (0, db_1.getDbAsSystem)();
+    var migration = new DeduplicateSettingRows_1.DeduplicateSettingRows().record;
+    var driver;
+    var dropTable;
+    var minutesAgo = function (minutes) { return (0, moment_1.default)().subtract(minutes, 'minutes'); };
+    var seed = function (row) { return systemDb.insert(tables_1.tables.Setting, row); };
+    var valuesLeft = function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, systemDb.query(tables_1.tables.Setting, {})];
+            case 1: return [2 /*return*/, (_a.sent()).map(function (row) { return "".concat(row.scope, "/").concat(row.name, "=").concat(row.value); }).sort()];
+        }
+    }); }); };
+    beforeAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        var beforeTheIndex;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, test_1.SpannerEmulatorProvisioner.ensureProvisioned(emulator)];
+                case 1:
+                    _a.sent();
+                    driver = db_1.Db.getDefaultDbDriver();
+                    dropTable = (0, test_1.getDropTestTable)(driver);
+                    return [4 /*yield*/, dropTable(tables_1.tables.Setting)];
+                case 2:
+                    _a.sent();
+                    beforeTheIndex = new SettingTable_1.SettingTable();
+                    beforeTheIndex.indexes = [];
+                    return [4 /*yield*/, driver.getTableManager().loadTable(beforeTheIndex)];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 120000);
+    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(tables_1.tables.Setting)];
+                case 1:
+                    _a.sent();
+                    test_1.SpannerEmulatorProvisioner.release();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 120000);
+    test('keeps the newest row of each (scope, name), deletes the rest, and the index then lands', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var _a, _b, _c, _d, _e, _f, _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
+                case 0: 
+                // ada/theme three times over: the newest by `updated` is the one written last, not the one created last.
+                return [4 /*yield*/, seed({ scope: 'ada', name: 'theme', value: 'first', created: minutesAgo(30), updated: minutesAgo(30) })];
+                case 1:
+                    // ada/theme three times over: the newest by `updated` is the one written last, not the one created last.
+                    _h.sent();
+                    return [4 /*yield*/, seed({ scope: 'ada', name: 'theme', value: 'newest', created: minutesAgo(20), updated: minutesAgo(5) })];
+                case 2:
+                    _h.sent();
+                    return [4 /*yield*/, seed({ scope: 'ada', name: 'theme', value: 'middle', created: minutesAgo(10), updated: minutesAgo(10) })];
+                case 3:
+                    _h.sent();
+                    // ada/font twice with one `updated`: the later `created` is the newest.
+                    return [4 /*yield*/, seed({ scope: 'ada', name: 'font', value: 'serif', created: minutesAgo(20), updated: minutesAgo(1) })];
+                case 4:
+                    // ada/font twice with one `updated`: the later `created` is the newest.
+                    _h.sent();
+                    return [4 /*yield*/, seed({ scope: 'ada', name: 'font', value: 'sans', created: minutesAgo(15), updated: minutesAgo(1) })];
+                case 5:
+                    _h.sent();
+                    // One row each: untouched.
+                    return [4 /*yield*/, seed({ scope: 'ada', name: 'lang', value: 'en' })];
+                case 6:
+                    // One row each: untouched.
+                    _h.sent();
+                    return [4 /*yield*/, seed({ scope: 'grace', name: 'theme', value: 'green' })];
+                case 7:
+                    _h.sent();
+                    return [4 /*yield*/, expect(driver.getTableManager().loadTable(tables_1.tables.Setting)).rejects.toThrow(db_1.DuplicateValuesForUniqueIndexError)];
+                case 8:
+                    _h.sent();
+                    _a = expect;
+                    return [4 /*yield*/, migration.estimate()];
+                case 9:
+                    _a.apply(void 0, [_h.sent()]).toEqual({ units: 3, unit: 'rows' });
+                    _b = expect;
+                    return [4 /*yield*/, migration.run()];
+                case 10:
+                    _b.apply(void 0, [_h.sent()]).toEqual({ deleted: 3 });
+                    _c = expect;
+                    return [4 /*yield*/, valuesLeft()];
+                case 11:
+                    _c.apply(void 0, [_h.sent()]).toEqual(['ada/font=sans', 'ada/lang=en', 'ada/theme=newest', 'grace/theme=green']);
+                    _d = expect;
+                    return [4 /*yield*/, migration.estimate()];
+                case 12:
+                    _d.apply(void 0, [_h.sent()]).toEqual({ units: 0, unit: 'rows' });
+                    _e = expect;
+                    return [4 /*yield*/, migration.run()];
+                case 13:
+                    _e.apply(void 0, [_h.sent()]).toEqual({ deleted: 0 });
+                    _f = expect;
+                    return [4 /*yield*/, valuesLeft()];
+                case 14:
+                    _f.apply(void 0, [_h.sent()]).toEqual(['ada/font=sans', 'ada/lang=en', 'ada/theme=newest', 'grace/theme=green']);
+                    return [4 /*yield*/, driver.getTableManager().loadTable(tables_1.tables.Setting)];
+                case 15:
+                    _h.sent();
+                    _g = expect;
+                    return [4 /*yield*/, driver.getTableManager().schemaMetadata.getIndexes(tables_1.tables.Setting)];
+                case 16:
+                    _g.apply(void 0, [_h.sent()]).toMatchObject({
+                        setting_scope_name_unique: ['scope', 'name'],
+                    });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('a database without the table: nothing to do', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0: return [4 /*yield*/, dropTable(tables_1.tables.Setting)];
+                case 1:
+                    _c.sent();
+                    _a = expect;
+                    return [4 /*yield*/, migration.estimate()];
+                case 2:
+                    _a.apply(void 0, [_c.sent()]).toEqual({ units: 0, unit: 'rows' });
+                    _b = expect;
+                    return [4 /*yield*/, migration.run()];
+                case 3:
+                    _b.apply(void 0, [_c.sent()]).toEqual({ deleted: 0 });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=DeduplicateSettingRows.test.js.map

package/dist/test/DeduplicateSettingRows.test.js.map

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

package/dist/test/SettingsOneRowPerName.test.d.ts

@@ -0,0 +1,3 @@
+import '@proteinjs/db-transaction-context';
+import '../generated/index';
+//# sourceMappingURL=SettingsOneRowPerName.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsOneRowPerName.test.d.ts","sourceRoot":"","sources":["../../test/SettingsOneRowPerName.test.ts"],"names":[],"mappings":"AAQA,OAAO,mCAAmC,CAAC;AAC3C,OAAO,oBAAoB,CAAC"}

package/dist/test/SettingsOneRowPerName.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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var db_1 = require("@proteinjs/db");
+var test_1 = require("@proteinjs/db-driver-spanner/test");
+var logger_1 = require("@proteinjs/logger");
+var Settings_1 = require("../src/Settings");
+var tables_1 = require("../src/tables/tables");
+var HeldFirstWriteDriver_1 = require("./util/HeldFirstWriteDriver");
+var TestSession_1 = require("./util/TestSession");
+require("@proteinjs/db-transaction-context");
+require("../generated/index");
+/**
+ * One setting row per name within a scope, on the real stack (the Spanner emulator, the default
+ * driver and transaction context resolved through reflection — the path `getScopedDb` takes in
+ * production): two concurrent `set`s of a fresh name — each observing no row before either
+ * writes, the interleaving that created two rows — leave ONE row, `get` reads its value, a later
+ * `set` rewrites that row without the driver reporting a refused statement (the common act stays
+ * quiet), the table's unique index refuses a second row of the name in the scope by its typed
+ * error, and the same name in another scope is another person's row.
+ */
+var emulator = { projectId: 'proteinjs-test', instanceName: 'proteinjs-test', databaseName: 'test' };
+var ada = { id: 'settings-test-ada', email: 'ada@settings.test', name: 'Ada' };
+var grace = { id: 'settings-test-grace', email: 'grace@settings.test', name: 'Grace' };
+describe('one setting row per name within a scope', function () {
+    var settings = new Settings_1.Settings();
+    var systemDb = (0, db_1.getDbAsSystem)();
+    var driver;
+    var dropTable;
+    var rowsOf = function (scope, name) { return systemDb.query(tables_1.tables.Setting, { scope: scope, name: name }); };
+    beforeAll(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, test_1.SpannerEmulatorProvisioner.ensureProvisioned(emulator)];
+                case 1:
+                    _a.sent();
+                    driver = db_1.Db.getDefaultDbDriver();
+                    dropTable = (0, test_1.getDropTestTable)(driver);
+                    return [4 /*yield*/, dropTable(tables_1.tables.Setting)];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, driver.getTableManager().loadTable(tables_1.tables.Setting)];
+                case 3:
+                    _a.sent();
+                    TestSession_1.TestSession.as(ada);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 120000);
+    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(tables_1.tables.Setting)];
+                case 1:
+                    _a.sent();
+                    test_1.SpannerEmulatorProvisioner.release();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, 120000);
+    test('two concurrent sets of a fresh name, each observing no row before either writes, leave one row', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var held, defaultDriver, rows, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    held = new HeldFirstWriteDriver_1.HeldFirstWriteDriver(driver, 2);
+                    defaultDriver = jest.spyOn(db_1.Db, 'getDefaultDbDriver').mockImplementation(function () { return held; });
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, , 3, 4]);
+                    return [4 /*yield*/, Promise.all([settings.set('theme', 'dark'), settings.set('theme', 'light')])];
+                case 2:
+                    _b.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    defaultDriver.mockRestore();
+                    return [7 /*endfinally*/];
+                case 4: return [4 /*yield*/, rowsOf(ada.id, 'theme')];
+                case 5:
+                    rows = _b.sent();
+                    expect(rows.length).toBe(1);
+                    expect(['dark', 'light']).toContain(rows[0].value);
+                    _a = expect;
+                    return [4 /*yield*/, settings.get('theme')];
+                case 6:
+                    _a.apply(void 0, [_b.sent()]).toBe(rows[0].value);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('a later set rewrites the one row, and the driver writes no error line for it', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var internals, driverLogger, lines, _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    internals = driver;
+                    driverLogger = internals.logger;
+                    lines = [];
+                    internals.logger = new logger_1.Logger({
+                        name: 'SpannerDriver',
+                        logLevel: 'info',
+                        logWriter: { write: function (line) { return lines.push(line); } },
+                    });
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, , 3, 4]);
+                    return [4 /*yield*/, settings.set('theme', 'blue')];
+                case 2:
+                    _c.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    internals.logger = driverLogger;
+                    return [7 /*endfinally*/];
+                case 4:
+                    expect(lines.filter(function (line) { return line.logLevel === 'error' || line.logLevel === 'warn'; })).toEqual([]);
+                    _a = expect;
+                    return [4 /*yield*/, rowsOf(ada.id, 'theme')];
+                case 5:
+                    _a.apply(void 0, [(_c.sent()).map(function (row) { return row.value; })]).toEqual(['blue']);
+                    _b = expect;
+                    return [4 /*yield*/, settings.get('theme')];
+                case 6:
+                    _b.apply(void 0, [_c.sent()]).toBe('blue');
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('the unique index refuses a second row of the name in the scope by its typed error', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var refusal, error_1, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, systemDb.insert(tables_1.tables.Setting, { scope: ada.id, name: 'theme', value: 'red' })];
+                case 1:
+                    _b.sent();
+                    return [3 /*break*/, 3];
+                case 2:
+                    error_1 = _b.sent();
+                    refusal = error_1;
+                    return [3 /*break*/, 3];
+                case 3:
+                    expect((0, db_1.isDuplicateKeyError)(refusal)).toBe(true);
+                    _a = expect;
+                    return [4 /*yield*/, rowsOf(ada.id, 'theme')];
+                case 4:
+                    _a.apply(void 0, [(_b.sent()).map(function (row) { return row.value; })]).toEqual(['blue']);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('the same name in another scope is another row', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var _a, _b, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    TestSession_1.TestSession.as(grace);
+                    return [4 /*yield*/, settings.set('theme', 'green')];
+                case 1:
+                    _d.sent();
+                    _a = expect;
+                    return [4 /*yield*/, settings.get('theme')];
+                case 2:
+                    _a.apply(void 0, [_d.sent()]).toBe('green');
+                    _b = expect;
+                    return [4 /*yield*/, rowsOf(grace.id, 'theme')];
+                case 3:
+                    _b.apply(void 0, [(_d.sent()).map(function (row) { return row.value; })]).toEqual(['green']);
+                    _c = expect;
+                    return [4 /*yield*/, rowsOf(ada.id, 'theme')];
+                case 4:
+                    _c.apply(void 0, [(_d.sent()).map(function (row) { return row.value; })]).toEqual(['blue']);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=SettingsOneRowPerName.test.js.map

package/dist/test/SettingsOneRowPerName.test.js.map

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

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

@@ -0,0 +1,36 @@
+import { DbDriver, DbDriverDmlStatementConfig, DbDriverQueryStatementConfig, SerializedRecord, Statement, TableManager } from '@proteinjs/db';
+/**
+ * The real driver, with `writers` concurrent writers held in lockstep at their first write: each
+ * writer's first write is held until every writer has reached one, then all run; every later
+ * write waits until every first write has settled. The interleaving under which concurrent
+ * writers of one fresh name each observe no row before any of them writes one — what two requests
+ * produce when they write one setting at the same moment — made exact, so the suite does not
+ * rest on timing (the emulator serializes concurrent transactions with aborts and retries, which
+ * on their own let one writer's second write slip in before the other's first has settled).
+ * Reads go straight through. A barrier that never fills fails the held writers with a named
+ * error instead of hanging the suite.
+ */
+export declare class HeldFirstWriteDriver implements DbDriver {
+    private readonly driver;
+    private readonly writers;
+    private arrivals;
+    private release;
+    private readonly released;
+    private readonly firstWrites;
+    constructor(driver: DbDriver, writers: number);
+    runDml(generateStatement: (config: DbDriverDmlStatementConfig) => Statement, transaction?: unknown): Promise<number>;
+    runQuery(generateStatement: (config: DbDriverQueryStatementConfig) => Statement, transaction?: unknown): Promise<SerializedRecord[]>;
+    runTransaction<T>(fn: (transaction: unknown) => Promise<T>): Promise<T>;
+    isDuplicateKeyError(error: unknown): boolean;
+    getDbName(): string;
+    createDbIfNotExists(): Promise<void>;
+    createDb(name: string, options?: {
+        ddl?: string[];
+    }): Promise<void>;
+    dropDb(name: string): Promise<void>;
+    getTableManager(): TableManager;
+    getOperationDeadlineMs(): number;
+    /** Forwarded; a driver that declares no bound would leave this undeclared, which a wrapper cannot express. */
+    getStatementParameterLimit(): number;
+}
+//# sourceMappingURL=HeldFirstWriteDriver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeldFirstWriteDriver.d.ts","sourceRoot":"","sources":["../../../test/util/HeldFirstWriteDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,4BAA4B,EAC5B,gBAAgB,EAChB,SAAS,EACT,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,QAAQ;IAOjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAGhC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,MAAM;IAW5B,MAAM,CACV,iBAAiB,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,SAAS,EACpE,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC;IAoBlB,QAAQ,CACN,iBAAiB,EAAE,CAAC,MAAM,EAAE,4BAA4B,KAAK,SAAS,EACtE,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI9B,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI5C,SAAS,IAAI,MAAM;IAInB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,eAAe,IAAI,YAAY;IAI/B,sBAAsB,IAAI,MAAM;IAIhC,8GAA8G;IAC9G,0BAA0B,IAAI,MAAM;CAOrC"}

package/dist/test/util/HeldFirstWriteDriver.js

@@ -0,0 +1,130 @@
+"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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeldFirstWriteDriver = void 0;
+/**
+ * The real driver, with `writers` concurrent writers held in lockstep at their first write: each
+ * writer's first write is held until every writer has reached one, then all run; every later
+ * write waits until every first write has settled. The interleaving under which concurrent
+ * writers of one fresh name each observe no row before any of them writes one — what two requests
+ * produce when they write one setting at the same moment — made exact, so the suite does not
+ * rest on timing (the emulator serializes concurrent transactions with aborts and retries, which
+ * on their own let one writer's second write slip in before the other's first has settled).
+ * Reads go straight through. A barrier that never fills fails the held writers with a named
+ * error instead of hanging the suite.
+ */
+var HeldFirstWriteDriver = /** @class */ (function () {
+    function HeldFirstWriteDriver(driver, writers) {
+        var _this = this;
+        this.driver = driver;
+        this.writers = writers;
+        this.arrivals = 0;
+        this.firstWrites = [];
+        this.released = new Promise(function (resolve, reject) {
+            _this.release = resolve;
+            setTimeout(function () { return reject(new Error("Only ".concat(_this.arrivals, " of ").concat(writers, " writers reached their first write"))); }, 10000).unref();
+        });
+    }
+    HeldFirstWriteDriver.prototype.runDml = function (generateStatement, transaction) {
+        return __awaiter(this, void 0, void 0, function () {
+            var write;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!(this.arrivals < this.writers)) return [3 /*break*/, 3];
+                        this.arrivals += 1;
+                        if (this.arrivals === this.writers) {
+                            this.release();
+                        }
+                        return [4 /*yield*/, this.released];
+                    case 1:
+                        _a.sent();
+                        write = this.driver.runDml(generateStatement, transaction);
+                        this.firstWrites.push(write.then(function () { return undefined; }, function () { return undefined; }));
+                        return [4 /*yield*/, write];
+                    case 2: return [2 /*return*/, _a.sent()];
+                    case 3: return [4 /*yield*/, Promise.all(this.firstWrites)];
+                    case 4:
+                        _a.sent();
+                        return [4 /*yield*/, this.driver.runDml(generateStatement, transaction)];
+                    case 5: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    HeldFirstWriteDriver.prototype.runQuery = function (generateStatement, transaction) {
+        return this.driver.runQuery(generateStatement, transaction);
+    };
+    HeldFirstWriteDriver.prototype.runTransaction = function (fn) {
+        return this.driver.runTransaction(fn);
+    };
+    HeldFirstWriteDriver.prototype.isDuplicateKeyError = function (error) {
+        var _a, _b, _c;
+        return (_c = (_b = (_a = this.driver).isDuplicateKeyError) === null || _b === void 0 ? void 0 : _b.call(_a, error)) !== null && _c !== void 0 ? _c : false;
+    };
+    HeldFirstWriteDriver.prototype.getDbName = function () {
+        return this.driver.getDbName();
+    };
+    HeldFirstWriteDriver.prototype.createDbIfNotExists = function () {
+        return this.driver.createDbIfNotExists();
+    };
+    HeldFirstWriteDriver.prototype.createDb = function (name, options) {
+        return this.driver.createDb(name, options);
+    };
+    HeldFirstWriteDriver.prototype.dropDb = function (name) {
+        return this.driver.dropDb(name);
+    };
+    HeldFirstWriteDriver.prototype.getTableManager = function () {
+        return this.driver.getTableManager();
+    };
+    HeldFirstWriteDriver.prototype.getOperationDeadlineMs = function () {
+        return this.driver.getOperationDeadlineMs();
+    };
+    /** Forwarded; a driver that declares no bound would leave this undeclared, which a wrapper cannot express. */
+    HeldFirstWriteDriver.prototype.getStatementParameterLimit = function () {
+        var _a, _b;
+        var limit = (_b = (_a = this.driver).getStatementParameterLimit) === null || _b === void 0 ? void 0 : _b.call(_a);
+        if (limit === undefined) {
+            throw new Error('The wrapped driver declares no statement parameter limit');
+        }
+        return limit;
+    };
+    return HeldFirstWriteDriver;
+}());
+exports.HeldFirstWriteDriver = HeldFirstWriteDriver;
+//# sourceMappingURL=HeldFirstWriteDriver.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { SessionData, SessionDataStorage } from '@proteinjs/server-api';
+/**
+ * The one session a suite's calls run in: a process-wide session store (the async-context store a
+ * server uses does not survive jest's hook and test boundaries), registered where `Session` looks
+ * for one, carrying the user the scoped db reads its scope from. `as(user)` re-seats the session
+ * on another user, so a suite can act as two people.
+ */
+export declare class TestSession implements SessionDataStorage {
+    environment: "node";
+    priority: number;
+    private static data;
+    /** Act as `user` from here on: the session's user, and the scope every scoped write and query carries. */
+    static as(user: {
+        id: string;
+        email: string;
+        name: string;
+    }): void;
+    setData(data: SessionData): void;
+    getData(): SessionData;
+    private static register;
+}
+//# sourceMappingURL=TestSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TestSession.d.ts","sourceRoot":"","sources":["../../../test/util/TestSession.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGjF;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,kBAAkB;IACpD,WAAW,SAAmB;IAC9B,QAAQ,SAAK;IACb,OAAO,CAAC,MAAM,CAAC,IAAI,CAA0E;IAE7F,0GAA0G;IAC1G,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMlE,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIhC,OAAO,IAAI,WAAW;IAItB,OAAO,CAAC,MAAM,CAAC,QAAQ;CAIxB"}