@proteinjs/db-file 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.8.2](https://github.com/proteinjs/db/compare/@proteinjs/db-file@1.8.1...@proteinjs/db-file@1.8.2) (2026-09-23)
+
+**Note:** Version bump only for package @proteinjs/db-file
+
+
+
+
+
+## [1.8.1](https://github.com/proteinjs/db/compare/@proteinjs/db-file@1.8.0...@proteinjs/db-file@1.8.1) (2026-09-20)
+
+**Note:** Version bump only for package @proteinjs/db-file
+
+
+
+
+
 # [1.8.0](https://github.com/proteinjs/db/compare/@proteinjs/db-file@1.7.22...@proteinjs/db-file@1.8.0) (2026-09-17)
 
 

package/dist/test/emulatorLockName.test.d.ts

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

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

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

package/dist/test/emulatorLockName.test.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var os_1 = __importDefault(require("os"));
+var path_1 = __importDefault(require("path"));
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+var lockFilePathFor = require('./emulatorLock').lockFilePathFor;
+/**
+ * The emulator lock's FILE NAME is a contract between every copy of the lock: two jest runs
+ * serialize on a shared emulator only when they compute the same file for the same host. No
+ * shared package carries the lock yet, so the contract is pinned by value — this table is the
+ * same, row for row, in every repository that keeps a copy. A change to a row here is a change
+ * to all of them, made in the same window; a copy that drifts stops contending, silently.
+ */
+// [emulator host, lock file name, what the row pins]
+var LOCK_FILE_NAMES = [
+    ['localhost:9010', 'spanner-emulator-localhost-9010-0091e79a.lock', 'the default shared emulator'],
+    [
+        'localhost-9010',
+        'spanner-emulator-localhost-9010-493b66d1.lock',
+        'the same slug as the row above: the hash alone keeps two hosts apart',
+    ],
+    [
+        '[emulator.a-host-name-long-enough-to-run-past-the-sixty-four-cap.example.test]:9010',
+        'spanner-emulator-emulator-a-host-name-long-enough-to-run-past-the-sixty-four-cap--fe958a1a.lock',
+        'edge dashes trimmed first, the slug capped at 64 second (the cap lands on a dash, and it stays)',
+    ],
+];
+describe('the emulator lock file name (the contract every copy of the lock shares)', function () {
+    it.each(LOCK_FILE_NAMES)('%s locks on %s (%s)', function (host, fileName) {
+        expect(lockFilePathFor(host)).toBe(path_1.default.join(os_1.default.tmpdir(), fileName));
+    });
+});
+//# sourceMappingURL=emulatorLockName.test.js.map

package/dist/test/emulatorLockName.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulatorLockName.test.js","sourceRoot":"","sources":["../../test/emulatorLockName.test.ts"],"names":[],"mappings":";;;;;AAAA,0CAAoB;AACpB,8CAAwB;AAExB,8DAA8D;AACtD,IAAA,eAAe,GAAK,OAAO,CAAC,gBAAgB,CAAkD,gBAA/E,CAAgF;AAEvG;;;;;;GAMG;AACH,qDAAqD;AACrD,IAAM,eAAe,GAA+B;IAClD,CAAC,gBAAgB,EAAE,+CAA+C,EAAE,6BAA6B,CAAC;IAClG;QACE,gBAAgB;QAChB,+CAA+C;QAC/C,sEAAsE;KACvE;IACD;QACE,qFAAqF;QACrF,iGAAiG;QACjG,iGAAiG;KAClG;CACF,CAAC;AAEF,QAAQ,CAAC,0EAA0E,EAAE;IACnF,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,qBAAqB,EAAE,UAAC,IAAI,EAAE,QAAQ;QAC7D,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteinjs/db-file",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "File storage in the db",
   "publishConfig": {
     "access": "public"
@@ -22,7 +22,7 @@
     "watch": "reflection-watch"
   },
   "dependencies": {
-    "@proteinjs/db": "^1.47.1",
+    "@proteinjs/db": "^1.47.2",
     "@proteinjs/logger": "^1.0.21",
     "@proteinjs/reflection": "^1.2.0",
     "@proteinjs/server-api": "^3.0.11",
@@ -31,7 +31,7 @@
     "moment": "2.29.4"
   },
   "devDependencies": {
-    "@proteinjs/db-driver-spanner": "^1.30.2",
+    "@proteinjs/db-driver-spanner": "^1.31.1",
     "@proteinjs/reflection-build": "^2.0.1",
     "@types/jest": "29.5.5",
     "@types/node": "14.0.27",
@@ -46,5 +46,5 @@
   },
   "main": "./dist/generated/index.js",
   "types": "./dist/generated/index.d.ts",
-  "gitHead": "c1037d11c75f92b6d015f10efb9e1a761f7d7710"
+  "gitHead": "e87f7725a3051bf624920e1089cbc36de5ac476e"
 }

package/test/emulatorLock.js

@@ -7,11 +7,10 @@
  * FAILED_PRECONDITION). This lock closes that gap for this package: a lockfile in os.tmpdir()
  * keyed by the emulator host string, held for the whole jest run via globalSetup/globalTeardown.
  *
- * The lockfile PATH FORMULA must stay byte-identical to the fleet's canonical implementation
- * (`EmulatorLock.lockFilePathFor` in @n3xah/thought-common/test) so suites from every repo
- * pointed at the same emulator actually contend on the same file. The logic is duplicated here
- * because this repo sits BELOW @n3xah in the dependency layering (thought-common itself depends
- * on @proteinjs/user) — future extraction target: @proteinjs/db-driver-spanner/test, beside
+ * The lockfile PATH FORMULA must stay byte-identical in every copy of this lock (other
+ * repositories' suites, a consumer application's suites) so runs pointed at the same emulator
+ * actually contend on the same file. The logic is duplicated here because no shared package
+ * carries it yet — future extraction target: @proteinjs/db-driver-spanner/test, beside
  * SpannerEmulatorProvisioner.
  */
 const crypto = require('crypto');
@@ -30,7 +29,7 @@ function lockFilePathFor(host) {
     .replace(/^-+|-+$/g, '')
     .slice(0, 64);
   const hash = crypto.createHash('sha1').update(host).digest('hex').slice(0, 8);
-  return path.join(os.tmpdir(), `n3xa-spanner-emulator-${slug}-${hash}.lock`);
+  return path.join(os.tmpdir(), `spanner-emulator-${slug}-${hash}.lock`);
 }
 
 function isPidAlive(pid) {

package/test/emulatorLockName.test.ts

@@ -0,0 +1,33 @@
+import os from 'os';
+import path from 'path';
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { lockFilePathFor } = require('./emulatorLock') as { lockFilePathFor: (host: string) => string };
+
+/**
+ * The emulator lock's FILE NAME is a contract between every copy of the lock: two jest runs
+ * serialize on a shared emulator only when they compute the same file for the same host. No
+ * shared package carries the lock yet, so the contract is pinned by value — this table is the
+ * same, row for row, in every repository that keeps a copy. A change to a row here is a change
+ * to all of them, made in the same window; a copy that drifts stops contending, silently.
+ */
+// [emulator host, lock file name, what the row pins]
+const LOCK_FILE_NAMES: [string, string, string][] = [
+  ['localhost:9010', 'spanner-emulator-localhost-9010-0091e79a.lock', 'the default shared emulator'],
+  [
+    'localhost-9010',
+    'spanner-emulator-localhost-9010-493b66d1.lock',
+    'the same slug as the row above: the hash alone keeps two hosts apart',
+  ],
+  [
+    '[emulator.a-host-name-long-enough-to-run-past-the-sixty-four-cap.example.test]:9010',
+    'spanner-emulator-emulator-a-host-name-long-enough-to-run-past-the-sixty-four-cap--fe958a1a.lock',
+    'edge dashes trimmed first, the slug capped at 64 second (the cap lands on a dash, and it stays)',
+  ],
+];
+
+describe('the emulator lock file name (the contract every copy of the lock shares)', () => {
+  it.each(LOCK_FILE_NAMES)('%s locks on %s (%s)', (host, fileName) => {
+    expect(lockFilePathFor(host)).toBe(path.join(os.tmpdir(), fileName));
+  });
+});