@proteinjs/db 1.50.2 → 1.51.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.51.0](https://github.com/proteinjs/db/compare/@proteinjs/db@1.50.2...@proteinjs/db@1.51.0) (2026-10-01)
+
+
+### Features
+
+* **db:** the db service's reads declared on the factory — query, get, getRowCount and tableExists ride the service client's retry policy ([173ab85](https://github.com/proteinjs/db/commit/173ab8598f4f9bd413795baa80136d85ca684267))
+
+
+
+
+
 ## [1.50.2](https://github.com/proteinjs/db/compare/@proteinjs/db@1.50.1...@proteinjs/db@1.50.2) (2026-09-30)
 
 

package/dist/src/services/DbService.d.ts

@@ -4,6 +4,13 @@ import { Record } from '../Record';
 import { QueryBuilder } from '@proteinjs/db-query';
 import { ArrayMembershipUpdate } from '../reference/ArrayMembershipOps';
 import { PreservedPath } from '../UpdatePreserving';
+/**
+ * The db service rides the service client's retry policy by declaration alone, no logic of its
+ * own: the reads (`query`, `get`, `getRowCount`, `tableExists`) are declared `'read'` — bounded at
+ * the first contact and redelivered under the client's series when a delivery produced no
+ * response — and every write stays undeclared: one delivery, never redelivered (a redelivered
+ * `insert` would insert twice). The policy's numbers and exceptions are @proteinjs/service's.
+ */
 export declare const getDbService: () => DbService<Record>;
 export type Query<T> = ObjectQuery<T> | QueryBuilder<T>;
 export type ObjectQuery<T> = Partial<{

package/dist/src/services/DbService.d.ts.map

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

package/dist/src/services/DbService.js

@@ -2,5 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDbService = void 0;
 var service_1 = require("@proteinjs/service");
-exports.getDbService = (0, service_1.serviceFactory)('@proteinjs/db/DbService');
+/**
+ * The db service rides the service client's retry policy by declaration alone, no logic of its
+ * own: the reads (`query`, `get`, `getRowCount`, `tableExists`) are declared `'read'` — bounded at
+ * the first contact and redelivered under the client's series when a delivery produced no
+ * response — and every write stays undeclared: one delivery, never redelivered (a redelivered
+ * `insert` would insert twice). The policy's numbers and exceptions are @proteinjs/service's.
+ */
+exports.getDbService = (0, service_1.serviceFactory)('@proteinjs/db/DbService', undefined, {
+    query: 'read',
+    get: 'read',
+    getRowCount: 'read',
+    tableExists: 'read',
+});
 //# sourceMappingURL=DbService.js.map

package/dist/src/services/DbService.js.map

@@ -1 +1 @@
-{"version":3,"file":"DbService.js","sourceRoot":"","sources":["../../../src/services/DbService.ts"],"names":[],"mappings":";;;AAAA,8CAA6D;AAOhD,QAAA,YAAY,GAAG,IAAA,wBAAc,EAAY,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"DbService.js","sourceRoot":"","sources":["../../../src/services/DbService.ts"],"names":[],"mappings":";;;AAAA,8CAA6D;AAO7D;;;;;;GAMG;AACU,QAAA,YAAY,GAAG,IAAA,wBAAc,EAAY,yBAAyB,EAAE,SAAS,EAAE;IAC1F,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,MAAM;IACX,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;CACpB,CAAC,CAAC"}

package/dist/test/DbServiceRetryDeclaration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DbServiceRetryDeclaration.test.d.ts.map

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

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

package/dist/test/DbServiceRetryDeclaration.test.js

@@ -0,0 +1,139 @@
+"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 reflection_1 = require("@proteinjs/reflection");
+var service_1 = require("@proteinjs/service");
+var DbService_1 = require("../src/services/DbService");
+var READS = ['query', 'get', 'getRowCount', 'tableExists'];
+var WRITES = ['insert', 'update', 'updateArrayMembership', 'updatePreserving', 'delete'];
+beforeAll(function () {
+    // Node's Request rejects the relative service paths a browser resolves against the page origin.
+    global.Request = /** @class */ (function () {
+        function class_1(url, init) {
+            this.url = url;
+            this.init = init;
+        }
+        return class_1;
+    }());
+    var returnType = { name: 'Promise<any>' };
+    var methods = __spreadArray(__spreadArray([], READS, true), WRITES, true).map(function (name) { return new reflection_1.Method(name, returnType, true, false, false, false, 'public', []); });
+    reflection_1.SourceRepository.get().flattenedSourceGraph.interfaces['@proteinjs/db/DbService'] = new reflection_1.Interface('@proteinjs/db', 'DbService', [], methods);
+});
+/** A transport that never answers: its promise settles only when the request is abandoned (its signal aborts). */
+var neverAnswers = function () {
+    return jest.fn(function (request) {
+        return new Promise(function (unused, reject) {
+            var _a;
+            (_a = request.init.signal) === null || _a === void 0 ? void 0 : _a.addEventListener('abort', function () {
+                return reject(Object.assign(new Error('The operation was aborted.'), { name: 'AbortError' }));
+            });
+        });
+    });
+};
+var sentRequests = function () { return global.fetch.mock.calls.map(function (_a) {
+    var request = _a[0];
+    return request;
+}); };
+/** The call's outcome, readable without awaiting it — a pending call must read as pending. */
+var track = function (promise) {
+    var outcome = { state: 'pending' };
+    promise.then(function () {
+        outcome.state = 'resolved';
+    }, function () {
+        outcome.state = 'rejected';
+    });
+    return outcome;
+};
+var aTable = { name: 'a_table' };
+describe('the db service under the client retry policy', function () {
+    beforeEach(function () { return jest.useFakeTimers(); });
+    afterEach(function () { return jest.useRealTimers(); });
+    it.each(READS)('%s is a declared read: bounded at the first contact, redelivered as a fresh request', function (name) { return __awaiter(void 0, void 0, void 0, function () {
+        var service, outcome;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    global.fetch = neverAnswers();
+                    service = (0, DbService_1.getDbService)();
+                    outcome = track(service[name](aTable, {}));
+                    return [4 /*yield*/, jest.advanceTimersByTimeAsync(service_1.READ_CONTACT_TIMEOUT_MS)];
+                case 1:
+                    _a.sent();
+                    expect(sentRequests()).toHaveLength(1);
+                    expect(sentRequests()[0].url).toBe("/service/@proteinjs/db/DbService/".concat(name));
+                    expect(sentRequests()[0].init.signal.aborted).toBe(true);
+                    return [4 /*yield*/, jest.advanceTimersByTimeAsync(service_1.REDELIVERY_BASE_MS)];
+                case 2:
+                    _a.sent();
+                    expect(sentRequests()).toHaveLength(2);
+                    expect(sentRequests()[1].init.signal.aborted).toBe(false);
+                    expect(outcome.state).toBe('pending');
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it.each(WRITES)('%s is undeclared: one delivery, no bound, never redelivered', function (name) { return __awaiter(void 0, void 0, void 0, function () {
+        var service, outcome;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    global.fetch = neverAnswers();
+                    service = (0, DbService_1.getDbService)();
+                    outcome = track(service[name](aTable, {}));
+                    return [4 /*yield*/, jest.advanceTimersByTimeAsync(service_1.READ_CONTACT_TIMEOUT_MS * 4)];
+                case 1:
+                    _a.sent();
+                    expect(sentRequests()).toHaveLength(1);
+                    expect(sentRequests()[0].url).toBe("/service/@proteinjs/db/DbService/".concat(name));
+                    expect(sentRequests()[0].init.signal).toBeUndefined();
+                    expect(outcome.state).toBe('pending');
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=DbServiceRetryDeclaration.test.js.map

package/dist/test/DbServiceRetryDeclaration.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteinjs/db",
-  "version": "1.50.2",
+  "version": "1.51.0",
   "main": "./dist/generated/index.js",
   "types": "./dist/generated/index.d.ts",
   "exports": {
@@ -46,7 +46,7 @@
     "@proteinjs/reflection": "^1.2.0",
     "@proteinjs/serializer": "^1.1.10",
     "@proteinjs/server-api": "^3.0.11",
-    "@proteinjs/service": "^1.6.0",
+    "@proteinjs/service": "^1.8.0",
     "@proteinjs/user-auth": "^1.3.0",
     "@proteinjs/util": "^1.6.1",
     "moment": "2.29.4",
@@ -66,5 +66,5 @@
     "ts-jest": "29.1.1",
     "typescript": "5.2.2"
   },
-  "gitHead": "6a487f9e29bc1ab5e3a7f79e1cce178cd2512beb"
+  "gitHead": "1128b1e6374c7f52cd5de172620b619b8f92e119"
 }

package/src/services/DbService.ts

@@ -5,7 +5,19 @@ import { QueryBuilder } from '@proteinjs/db-query';
 import { ArrayMembershipUpdate } from '../reference/ArrayMembershipOps';
 import { PreservedPath } from '../UpdatePreserving';
 
-export const getDbService = serviceFactory<DbService>('@proteinjs/db/DbService');
+/**
+ * The db service rides the service client's retry policy by declaration alone, no logic of its
+ * own: the reads (`query`, `get`, `getRowCount`, `tableExists`) are declared `'read'` — bounded at
+ * the first contact and redelivered under the client's series when a delivery produced no
+ * response — and every write stays undeclared: one delivery, never redelivered (a redelivered
+ * `insert` would insert twice). The policy's numbers and exceptions are @proteinjs/service's.
+ */
+export const getDbService = serviceFactory<DbService>('@proteinjs/db/DbService', undefined, {
+  query: 'read',
+  get: 'read',
+  getRowCount: 'read',
+  tableExists: 'read',
+});
 
 export type Query<T> = ObjectQuery<T> | QueryBuilder<T>;
 export type ObjectQuery<T> = Partial<{ [P in keyof T]: any }>;

package/test/DbServiceRetryDeclaration.test.ts

@@ -0,0 +1,105 @@
+import { Interface, Method, SourceRepository, TypeAliasDeclaration } from '@proteinjs/reflection';
+import { READ_CONTACT_TIMEOUT_MS, REDELIVERY_BASE_MS } from '@proteinjs/service';
+import { getDbService } from '../src/services/DbService';
+
+/**
+ * The db service rides the service client's retry policy by declaration alone: its reads (`query`,
+ * `get`, `getRowCount`, `tableExists`) are declared `'read'` on the factory — bounded at the first
+ * contact and redelivered as fresh requests under the client's series when a delivery produced no
+ * response — and its writes (`insert`, `update`, `updateArrayMembership`, `updatePreserving`,
+ * `delete`) stay undeclared: one delivery, no bound, never redelivered. Nothing here is the db
+ * package's own logic — the policy, its numbers and its exceptions are @proteinjs/service's; this
+ * suite pins the declaration. Read as OUTCOMES off the transport: the requests that left and their
+ * watchdog signals, under fake timers.
+ *
+ * The service interface is seeded into the source repository directly (this package's own test pattern —
+ * DbDefaultDriverDuplicateModuleState seeds the object cache the same way), so the real factory
+ * builds the real clients without the generated source graph.
+ */
+
+type RepositoryInternals = { flattenedSourceGraph: { interfaces: { [qualifiedName: string]: Interface } } };
+
+const READS = ['query', 'get', 'getRowCount', 'tableExists'];
+const WRITES = ['insert', 'update', 'updateArrayMembership', 'updatePreserving', 'delete'];
+
+beforeAll(() => {
+  // Node's Request rejects the relative service paths a browser resolves against the page origin.
+  global.Request = class {
+    constructor(
+      public url: string,
+      public init: any
+    ) {}
+  } as any;
+  const returnType = { name: 'Promise<any>' } as unknown as TypeAliasDeclaration;
+  const methods = [...READS, ...WRITES].map(
+    (name) => new Method(name, returnType, true, false, false, false, 'public', [])
+  );
+  (SourceRepository.get() as unknown as RepositoryInternals).flattenedSourceGraph.interfaces[
+    '@proteinjs/db/DbService'
+  ] = new Interface('@proteinjs/db', 'DbService', [], methods);
+});
+
+/** A transport that never answers: its promise settles only when the request is abandoned (its signal aborts). */
+const neverAnswers = () =>
+  jest.fn(
+    (request: any) =>
+      new Promise((unused, reject) => {
+        request.init.signal?.addEventListener('abort', () =>
+          reject(Object.assign(new Error('The operation was aborted.'), { name: 'AbortError' }))
+        );
+      })
+  );
+
+const sentRequests = (): any[] => (global.fetch as jest.Mock).mock.calls.map(([request]) => request);
+
+/** The call's outcome, readable without awaiting it — a pending call must read as pending. */
+const track = (promise: Promise<any>) => {
+  const outcome: { state: 'pending' | 'resolved' | 'rejected' } = { state: 'pending' };
+  promise.then(
+    () => {
+      outcome.state = 'resolved';
+    },
+    () => {
+      outcome.state = 'rejected';
+    }
+  );
+  return outcome;
+};
+
+const aTable = { name: 'a_table' } as any;
+
+describe('the db service under the client retry policy', () => {
+  beforeEach(() => jest.useFakeTimers());
+  afterEach(() => jest.useRealTimers());
+
+  it.each(READS)(
+    '%s is a declared read: bounded at the first contact, redelivered as a fresh request',
+    async (name) => {
+      global.fetch = neverAnswers() as any;
+      const service = getDbService() as any;
+      const outcome = track(service[name](aTable, {}));
+
+      await jest.advanceTimersByTimeAsync(READ_CONTACT_TIMEOUT_MS);
+      expect(sentRequests()).toHaveLength(1);
+      expect(sentRequests()[0].url).toBe(`/service/@proteinjs/db/DbService/${name}`);
+      expect(sentRequests()[0].init.signal.aborted).toBe(true);
+
+      await jest.advanceTimersByTimeAsync(REDELIVERY_BASE_MS);
+      expect(sentRequests()).toHaveLength(2);
+      expect(sentRequests()[1].init.signal.aborted).toBe(false);
+      expect(outcome.state).toBe('pending');
+    }
+  );
+
+  it.each(WRITES)('%s is undeclared: one delivery, no bound, never redelivered', async (name) => {
+    global.fetch = neverAnswers() as any;
+    const service = getDbService() as any;
+    const outcome = track(service[name](aTable, {}));
+
+    await jest.advanceTimersByTimeAsync(READ_CONTACT_TIMEOUT_MS * 4);
+    expect(sentRequests()).toHaveLength(1);
+    expect(sentRequests()[0].url).toBe(`/service/@proteinjs/db/DbService/${name}`);
+    expect(sentRequests()[0].init.signal).toBeUndefined();
+    expect(outcome.state).toBe('pending');
+  });
+});