@rvoh/psychic-spec-helpers 3.1.0 → 3.1.1

package/dist/esm/src/unit/createPsychicServer.js

@@ -1,14 +1,28 @@
-// eslint-disable-next-line
-const _server = undefined;
+// The booted spec server is cached for the lifetime of the worker process so it
+// is created and booted exactly once, then reused by every spec — instead of
+// re-booting a brand-new PsychicServer for each spec, which re-runs application
+// initialization and churns database/websocket connections (a significant
+// source of slow suites and flaky, connection-exhaustion-driven failures).
+//
+// The cache lives on `globalThis` rather than in a module-scoped variable
+// because isolating test runners (e.g. Vitest with the default `isolate: true`)
+// reset the module registry between spec files. A module-scoped cache would be
+// discarded at every file boundary, forcing a fresh boot per file; `globalThis`
+// persists for the whole worker process, so the server boots once per worker.
+const CACHED_SPEC_SERVER_KEY = Symbol.for('@rvoh/psychic-spec-helpers:cachedSpecServer');
 // eslint-disable-next-line
 export default async function createPsychicServer(PsychicServer) {
     // eslint-disable-next-line
-    if (_server)
-        return _server;
+    const store = globalThis;
+    // eslint-disable-next-line
+    if (store[CACHED_SPEC_SERVER_KEY])
+        return store[CACHED_SPEC_SERVER_KEY];
     // eslint-disable-next-line
     const server = new PsychicServer();
     // eslint-disable-next-line
     await server.boot();
     // eslint-disable-next-line
+    store[CACHED_SPEC_SERVER_KEY] = server;
+    // eslint-disable-next-line
     return server;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@rvoh/psychic-spec-helpers",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "psychic framework spec helpers",
   "author": "RVO Health",
   "repository": {
@@ -80,5 +80,5 @@
     "dotenv": "^17.2.3",
     "pluralize-esm": "^9.0.5"
   },
-  "packageManager": "pnpm@10.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a"
+  "packageManager": "pnpm@11.1.3+sha512.c85357fe17ca12dd23dd7071822666dfd7e3cb76fe214e3370b5ea2fb34f2a231185509b63e717f3cd0acb38dd3f8d82bcd5e8172400ae678b70ea4fbed0896d"
 }

package/src/unit/createPsychicServer.ts

@@ -1,15 +1,31 @@
-// eslint-disable-next-line
-const _server: any = undefined
+// The booted spec server is cached for the lifetime of the worker process so it
+// is created and booted exactly once, then reused by every spec — instead of
+// re-booting a brand-new PsychicServer for each spec, which re-runs application
+// initialization and churns database/websocket connections (a significant
+// source of slow suites and flaky, connection-exhaustion-driven failures).
+//
+// The cache lives on `globalThis` rather than in a module-scoped variable
+// because isolating test runners (e.g. Vitest with the default `isolate: true`)
+// reset the module registry between spec files. A module-scoped cache would be
+// discarded at every file boundary, forcing a fresh boot per file; `globalThis`
+// persists for the whole worker process, so the server boots once per worker.
+const CACHED_SPEC_SERVER_KEY = Symbol.for('@rvoh/psychic-spec-helpers:cachedSpecServer')
 
 // eslint-disable-next-line
 export default async function createPsychicServer(PsychicServer: any) {
   // eslint-disable-next-line
-  if (_server) return _server!
+  const store = globalThis as Record<symbol, any>
+
+  // eslint-disable-next-line
+  if (store[CACHED_SPEC_SERVER_KEY]) return store[CACHED_SPEC_SERVER_KEY]
 
   // eslint-disable-next-line
   const server = new PsychicServer()
   // eslint-disable-next-line
   await server.boot()
+
+  // eslint-disable-next-line
+  store[CACHED_SPEC_SERVER_KEY] = server
   // eslint-disable-next-line
   return server
 }