@furystack/core 15.0.34 → 15.0.36

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [15.0.36] - 2026-02-11
+
+### ⬆️ Dependencies
+
+- Bump `vitest` from `^4.0.17` to `^4.0.18`
+- Bump `@types/node` from `^25.0.10` to `^25.2.3`
+- Updated internal dependencies
+
+## [15.0.35] - 2026-02-09
+
+### 🐛 Bug Fixes
+
+- Fixed `getPort()` to assign deterministic port ranges per Vitest worker using `VITEST_POOL_ID` instead of a random base port, preventing port collisions in parallel test runs
+
+### 🧪 Tests
+
+- Refactored `globalDisposable` tests to use `usingAsync` for proper `Injector` disposal
+
 ## [15.0.34] - 2026-01-26
 
 ### 🔧 Chores

package/esm/global-disposable.spec.js

@@ -1,4 +1,5 @@
 import { Injector } from '@furystack/inject';
+import { usingAsync } from '@furystack/utils';
 import { describe, expect, it, vi } from 'vitest';
 import { exitHandler, globalDisposables } from './global-disposables.js';
 import { disposeOnProcessExit } from './helpers.js';
@@ -14,13 +15,14 @@ describe('Global Disposables', () => {
         expect(process.listeners('uncaughtException')).toContain(exitHandler);
     });
     it('Should be filled from an injector extension', async () => {
-        const i = new Injector();
-        disposeOnProcessExit(i);
-        expect(globalDisposables).toContain(i);
-        globalDisposables.delete(i);
-        await i[Symbol.asyncDispose]();
+        await usingAsync(new Injector(), async (i) => {
+            disposeOnProcessExit(i);
+            expect(globalDisposables).toContain(i);
+            globalDisposables.delete(i);
+        });
     });
-    it('Should dispose the injector on exit', async () => {
+    it('Should dispose the injector on exit', () => {
+        // Not using usingAsync here because exitHandler() itself disposes the injector
         const i = new Injector();
         i[Symbol.asyncDispose] = vi.fn(i[Symbol.asyncDispose]);
         disposeOnProcessExit(i);

package/esm/global-disposable.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"global-disposable.spec.js","sourceRoot":"","sources":["../src/global-disposable.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC1D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC3D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC3D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAA;QACxB,oBAAoB,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACtC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;IACF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAA;QACxB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;QACtD,oBAAoB,CAAC,CAAC,CAAC,CAAA;QACvB,WAAW,EAAE,CAAA;QACb,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;QAC3C,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"global-disposable.spec.js","sourceRoot":"","sources":["../src/global-disposable.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC1D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC3D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC3D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,UAAU,CAAC,IAAI,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC3C,oBAAoB,CAAC,CAAC,CAAC,CAAA;YACvB,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YACtC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,+EAA+E;QAC/E,MAAM,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAA;QACxB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;QACtD,oBAAoB,CAAC,CAAC,CAAC,CAAA;QACvB,WAAW,EAAE,CAAA;QACb,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;QAC3C,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/esm/port-generator.d.ts

@@ -1,6 +1,8 @@
 /**
- * Generates a unique port number for testing purposes
- * @returns the next sequential port number starting from a random base between 14000 and 16000
+ * Generates a unique port number for testing purposes.
+ * Each Vitest worker gets a dedicated range of {@link PORTS_PER_WORKER} ports
+ * based on its VITEST_POOL_ID to avoid collisions between parallel workers.
+ * @returns the next sequential port number
  */
 export declare const getPort: () => number;
 //# sourceMappingURL=port-generator.d.ts.map

package/esm/port-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port-generator.d.ts","sourceRoot":"","sources":["../src/port-generator.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAO,MAAgC,CAAA"}
+{"version":3,"file":"port-generator.d.ts","sourceRoot":"","sources":["../src/port-generator.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,QAAO,MAAgC,CAAA"}

package/esm/port-generator.js

@@ -1,14 +1,18 @@
+const PORTS_PER_WORKER = 200;
+const BASE_PORT = 14000;
 const portGenerator = function* () {
-    const initialPort = 14000 + Math.floor(Math.random() * 2000);
-    let port = initialPort;
+    const workerId = parseInt(process.env.VITEST_POOL_ID ?? '0', 10);
+    let port = BASE_PORT + workerId * PORTS_PER_WORKER;
     while (true) {
         yield port++;
     }
 };
 const generator = portGenerator();
 /**
- * Generates a unique port number for testing purposes
- * @returns the next sequential port number starting from a random base between 14000 and 16000
+ * Generates a unique port number for testing purposes.
+ * Each Vitest worker gets a dedicated range of {@link PORTS_PER_WORKER} ports
+ * based on its VITEST_POOL_ID to avoid collisions between parallel workers.
+ * @returns the next sequential port number
  */
 export const getPort = () => generator.next().value;
 //# sourceMappingURL=port-generator.js.map

package/esm/port-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"port-generator.js","sourceRoot":"","sources":["../src/port-generator.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,QAAQ,CAAC;IAC7B,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;IAC5D,IAAI,IAAI,GAAG,WAAW,CAAA;IACtB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,EAAE,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA"}
+{"version":3,"file":"port-generator.js","sourceRoot":"","sources":["../src/port-generator.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAC5B,MAAM,SAAS,GAAG,KAAK,CAAA;AAEvB,MAAM,aAAa,GAAG,QAAQ,CAAC;IAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IAChE,IAAI,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAA;IAClD,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,EAAE,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAW,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/core",
-  "version": "15.0.34",
+  "version": "15.0.36",
   "description": "Core FuryStack package",
   "type": "module",
   "scripts": {
@@ -46,13 +46,13 @@
   },
   "homepage": "https://github.com/furystack/furystack",
   "devDependencies": {
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.2.3",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
-    "@furystack/inject": "^12.0.28",
-    "@furystack/utils": "^8.1.9"
+    "@furystack/inject": "^12.0.30",
+    "@furystack/utils": "^8.1.10"
   },
   "engines": {
     "node": ">=22.0.0"

package/src/global-disposable.spec.ts

@@ -1,34 +1,36 @@
-import { Injector } from '@furystack/inject'
-import { describe, expect, it, vi } from 'vitest'
-import { exitHandler, globalDisposables } from './global-disposables.js'
-import { disposeOnProcessExit } from './helpers.js'
-
-describe('Global Disposables', () => {
-  it('Should be empty by default', () => {
-    expect(globalDisposables.size).toBe(0)
-  })
-
-  it('Should attach event listeners', () => {
-    expect(process.listeners('exit')).toContain(exitHandler)
-    expect(process.listeners('SIGINT')).toContain(exitHandler)
-    expect(process.listeners('SIGUSR1')).toContain(exitHandler)
-    expect(process.listeners('SIGUSR2')).toContain(exitHandler)
-    expect(process.listeners('uncaughtException')).toContain(exitHandler)
-  })
-
-  it('Should be filled from an injector extension', async () => {
-    const i = new Injector()
-    disposeOnProcessExit(i)
-    expect(globalDisposables).toContain(i)
-    globalDisposables.delete(i)
-    await i[Symbol.asyncDispose]()
-  })
-  it('Should dispose the injector on exit', async () => {
-    const i = new Injector()
-    i[Symbol.asyncDispose] = vi.fn(i[Symbol.asyncDispose])
-    disposeOnProcessExit(i)
-    exitHandler()
-    expect(i[Symbol.asyncDispose]).toBeCalled()
-    globalDisposables.delete(i)
-  })
-})
+import { Injector } from '@furystack/inject'
+import { usingAsync } from '@furystack/utils'
+import { describe, expect, it, vi } from 'vitest'
+import { exitHandler, globalDisposables } from './global-disposables.js'
+import { disposeOnProcessExit } from './helpers.js'
+
+describe('Global Disposables', () => {
+  it('Should be empty by default', () => {
+    expect(globalDisposables.size).toBe(0)
+  })
+
+  it('Should attach event listeners', () => {
+    expect(process.listeners('exit')).toContain(exitHandler)
+    expect(process.listeners('SIGINT')).toContain(exitHandler)
+    expect(process.listeners('SIGUSR1')).toContain(exitHandler)
+    expect(process.listeners('SIGUSR2')).toContain(exitHandler)
+    expect(process.listeners('uncaughtException')).toContain(exitHandler)
+  })
+
+  it('Should be filled from an injector extension', async () => {
+    await usingAsync(new Injector(), async (i) => {
+      disposeOnProcessExit(i)
+      expect(globalDisposables).toContain(i)
+      globalDisposables.delete(i)
+    })
+  })
+  it('Should dispose the injector on exit', () => {
+    // Not using usingAsync here because exitHandler() itself disposes the injector
+    const i = new Injector()
+    i[Symbol.asyncDispose] = vi.fn(i[Symbol.asyncDispose])
+    disposeOnProcessExit(i)
+    exitHandler()
+    expect(i[Symbol.asyncDispose]).toBeCalled()
+    globalDisposables.delete(i)
+  })
+})

package/src/port-generator.ts

@@ -1,6 +1,9 @@
+const PORTS_PER_WORKER = 200
+const BASE_PORT = 14000
+
 const portGenerator = function* () {
-  const initialPort = 14000 + Math.floor(Math.random() * 2000)
-  let port = initialPort
+  const workerId = parseInt(process.env.VITEST_POOL_ID ?? '0', 10)
+  let port = BASE_PORT + workerId * PORTS_PER_WORKER
   while (true) {
     yield port++
   }
@@ -9,7 +12,9 @@ const portGenerator = function* () {
 const generator = portGenerator()
 
 /**
- * Generates a unique port number for testing purposes
- * @returns the next sequential port number starting from a random base between 14000 and 16000
+ * Generates a unique port number for testing purposes.
+ * Each Vitest worker gets a dedicated range of {@link PORTS_PER_WORKER} ports
+ * based on its VITEST_POOL_ID to avoid collisions between parallel workers.
+ * @returns the next sequential port number
  */
 export const getPort = (): number => generator.next().value