@jongodb/memory-server 0.1.2 → 0.1.3

package/README.md

@@ -1,68 +1,38 @@
 # @jongodb/memory-server
 
-Node test runtime adapter for `jongodb`.
+Node test runtime adapter for [`jongodb`](https://github.com/midagedev/jongodb).
 
-It starts a local `jongodb` launcher process, exposes a MongoDB URI, and manages process lifecycle for test runners.
+It starts a local `jongodb` launcher process, provides a MongoDB URI, and manages lifecycle for test runners.
+
+## Why This Package Exists
+
+`mongodb-memory-server` is useful, but it still depends on `mongod` bootstrap behavior.
+
+`@jongodb/memory-server` focuses on a different tradeoff:
+- faster integration-test startup loops
+- deterministic local process lifecycle control
+- simple test runner integration (Jest, Vitest, Nest Jest)
+
+This package is for test runtime usage only. It is not a production MongoDB server.
+
+## Value for Integration Test Suites
+
+Observed benchmark summary on one NestJS integration suite shape:
+- historical suite-scoped lifecycle: about `55.9%` faster than `mongodb-memory-server`
+- current single-boot lifecycle: about `64.2%` faster than `mongodb-memory-server`
+
+Actual deltas vary by test shape, dataset size, and CI machine characteristics.
 
 ## Scope
 
-- integration-test runtime only
-- launcher lifecycle management (start/stop/detach)
-- framework-agnostic base helper
-- Jest/Vitest/Nest Jest convenience helpers
-
-This package is not a production MongoDB server.
-
-## Why This vs Embedded MongoDB (`mongodb-memory-server`)
-
-`@jongodb/memory-server` can run in native binary mode instead of booting a full `mongod` test binary.
-
-Practical effects:
-
-- no `mongod` binary download/extract step in cold environments
-- lower launcher startup overhead in many integration-test loops
-- fewer environment issues tied to `mongod` binary provisioning
-
-Rough performance expectation (not a guarantee):
-
-- cold CI/dev machine: often much faster because there is no `mongod` artifact fetch/unpack
-- warm cache environment: startup-phase wins are usually smaller
-
-Observed benchmarks (NestJS integration suite subset, same machine):
-
-- Benchmark A: suite-scoped lifecycle (historical)
-  - workload: `9 suites / 102 tests` (`--runInBand`)
-  - server boots: `9` times per run (once per suite)
-  - `mongodb-memory-server` real:
-    - run1: `28.17s`
-    - run2: `27.19s`
-    - average: `27.68s`
-  - `jongodb` native real:
-    - run1: `12.35s`
-    - run2: `12.04s`
-    - average: `12.20s`
-  - delta: about `55.9%` faster (`15.48s` less wall clock)
-- Benchmark B: single-boot lifecycle (current)
-  - workload: `45 suites / 510 tests` (`--runInBand`)
-  - server boots: `1` time per run (shared for full Jest process)
-  - `mongodb-memory-server` real:
-    - run1: `92.40s`
-    - run2: `91.84s`
-    - average: `92.12s`
-  - `jongodb` native real:
-    - run1: `33.03s`
-    - run2: `32.90s`
-    - average: `32.97s`
-  - delta: about `64.2%` faster (`59.15s` less wall clock)
-
-Your actual delta depends on test shape, I/O, and query workload.
+- integration-test runtime helper
+- launcher process start/stop/detach lifecycle
+- framework-agnostic runtime API
+- convenience hooks for Jest, Vitest, and Nest Jest
 
 ## Requirements
 
 - Node.js 20+
-- one launcher runtime:
-  - native binary, or
-  - Java 17+ with `jongodb` classpath
 
 ## Install
 
@@ -73,20 +43,21 @@ npm i -D @jongodb/memory-server
 ## Module Format
 
 This package supports both:
-
 - ESM (`import`)
 - CommonJS (`require`)
 
-## Quick Start (Recommended)
+## Quick Start
 
-Use `createJongodbEnvRuntime` and keep one runtime per test process.
+Recommended pattern: one runtime per test process.
 
 ```ts
 import { beforeAll, afterAll } from "@jest/globals";
 import { createJongodbEnvRuntime } from "@jongodb/memory-server/runtime";
 
 const runtime = createJongodbEnvRuntime({
-  databaseName: "test"
+  databaseName: "test",
+  databaseNameStrategy: "worker",
+  envVarNames: ["MONGODB_URI", "DATABASE_URL"],
 });
 
 beforeAll(async () => {
@@ -98,85 +69,67 @@ afterAll(async () => {
 });
 ```
 
+Runtime behavior:
+- `setup()` starts launcher and writes URI to configured env key(s)
+- `teardown()` stops launcher and restores previous env values
+
 CommonJS example:
 
 ```js
 const { createJongodbEnvRuntime } = require("@jongodb/memory-server/runtime");
-
 const runtime = createJongodbEnvRuntime({ databaseName: "test" });
 ```
 
-Behavior:
-
-- `setup()` starts launcher and writes `process.env.MONGODB_URI` (default)
-- `teardown()` stops launcher and restores previous env value
-
-## Launcher Modes
-
-`launchMode` values:
-
-- `auto` (default): binary first, Java fallback
-- `binary`: binary only, fail fast if binary not resolvable
-- `java`: Java only, fail fast if classpath not configured
-
-In `auto` mode, launch failures are attempted in order and reported with source tags.
+## Migration from `mongodb-memory-server`
 
-## Binary Runtime
+Basic Jest migration:
 
-Binary resolution order:
-
-1. `options.binaryPath`
-2. `JONGODB_BINARY_PATH`
-3. bundled platform package (if installed)
-
-Current bundled package targets:
-
-- `@jongodb/memory-server-bin-darwin-arm64`
-- `@jongodb/memory-server-bin-linux-x64-gnu`
-- `@jongodb/memory-server-bin-win32-x64`
+Before:
 
-Version policy:
-
-- binary package versions are pinned to the core package version (`optionalDependencies`)
-- if a bundled binary is not installed/available for your version, `auto` mode can still run with Java fallback
+```ts
+import { MongoMemoryServer } from "mongodb-memory-server";
 
-Binary-only example:
+let mongod: MongoMemoryServer;
 
-```ts
-import { startJongodbMemoryServer } from "@jongodb/memory-server";
+beforeAll(async () => {
+  mongod = await MongoMemoryServer.create();
+  process.env.MONGODB_URI = mongod.getUri();
+});
 
-const server = await startJongodbMemoryServer({
-  launchMode: "binary",
-  binaryPath: process.env.JONGODB_BINARY_PATH
+afterAll(async () => {
+  await mongod.stop();
 });
 ```
 
-## Java Runtime
+After:
 
-Provide classpath by:
+```ts
+import { beforeAll, afterAll } from "@jest/globals";
+import { createJongodbEnvRuntime } from "@jongodb/memory-server/runtime";
 
-1. `startJongodbMemoryServer({ classpath: "..." })`, or
-2. `JONGODB_CLASSPATH`
+const runtime = createJongodbEnvRuntime({ databaseName: "test" });
 
-Repository helper command (when using this repo launcher build):
+beforeAll(async () => {
+  await runtime.setup();
+});
 
-```bash
-./.tooling/gradle-8.10.2/bin/gradle -q printLauncherClasspath
+afterAll(async () => {
+  await runtime.teardown();
+});
 ```
 
-## Standalone Launcher Contract
+Option mapping:
+- `MongoMemoryServer.create({ instance: { port } })` -> `createJongodbEnvRuntime({ port })`
+- `MongoMemoryServer.create({ instance: { dbName } })` -> `createJongodbEnvRuntime({ databaseName })`
+- `mongod.getUri()` -> `runtime.uri` (after `setup`) or configured env var
+- `mongod.stop()` -> `runtime.teardown()`
 
-Binary and Java launchers follow one contract:
-
-- readiness line on stdout: `JONGODB_URI=mongodb://...`
-- optional failure line on stderr: `JONGODB_START_FAILURE=...`
-- process remains alive until terminated by signal (`SIGTERM`/`SIGINT`)
-
-The adapter relies on this contract for deterministic startup/teardown handling.
+Parallel test tip:
+- set `databaseNameStrategy: "worker"` to isolate worker data by database name
 
-## Runner Helpers
+## Runner Integrations
 
-### Jest (per-file hooks)
+Jest (per-file hooks):
 
 ```ts
 import { beforeAll, afterAll } from "@jest/globals";
@@ -185,9 +138,9 @@ import { registerJongodbForJest } from "@jongodb/memory-server/jest";
 registerJongodbForJest({ beforeAll, afterAll });
 ```
 
-### Jest (global setup/teardown)
+Jest (global setup/teardown):
 
-`jest.global-setup.ts`:
+`jest.global-setup.ts`
 
 ```ts
 import { createJestGlobalSetup } from "@jongodb/memory-server/jest";
@@ -195,7 +148,7 @@ import { createJestGlobalSetup } from "@jongodb/memory-server/jest";
 export default createJestGlobalSetup();
 ```
 
-`jest.global-teardown.ts`:
+`jest.global-teardown.ts`
 
 ```ts
 import { createJestGlobalTeardown } from "@jongodb/memory-server/jest";
@@ -203,7 +156,7 @@ import { createJestGlobalTeardown } from "@jongodb/memory-server/jest";
 export default createJestGlobalTeardown();
 ```
 
-### Vitest
+Vitest:
 
 ```ts
 import { beforeAll, afterAll } from "vitest";
@@ -212,7 +165,7 @@ import { registerJongodbForVitest } from "@jongodb/memory-server/vitest";
 registerJongodbForVitest({ beforeAll, afterAll });
 ```
 
-### NestJS (Jest E2E)
+NestJS (Jest E2E):
 
 ```ts
 import { beforeAll, afterAll } from "@jest/globals";
@@ -221,25 +174,45 @@ import { registerJongodbForNestJest } from "@jongodb/memory-server/nestjs";
 registerJongodbForNestJest({ beforeAll, afterAll });
 ```
 
-## Common Integration Patterns
+Common patterns:
+- NestJS + Mongoose: use `process.env.MONGODB_URI` in `forRootAsync`
+- Prisma (Mongo): set runtime `envVarNames` to include `DATABASE_URL`
+- TypeORM (Mongo): pass runtime URI into `url`
+
+## Runtime Resolution
 
-- NestJS + Mongoose: `MongooseModule.forRootAsync({ useFactory: () => ({ uri: process.env.MONGODB_URI }) })`
-- Express/Fastify: inject `process.env.MONGODB_URI` into DB bootstrap before app init
-- Prisma (Mongo): set `envVarName: "DATABASE_URL"` for runtime helper
-- TypeORM (Mongo): pass runtime URI as `url`
+`launchMode` values:
+- `auto` (default): binary first, Java fallback
+- `binary`: binary only
+- `java`: Java only
+
+Binary resolution order:
+1. `options.binaryPath`
+2. `JONGODB_BINARY_PATH`
+3. bundled platform binary package
+
+Bundled targets:
+- `@jongodb/memory-server-bin-darwin-arm64`
+- `@jongodb/memory-server-bin-linux-x64-gnu`
+- `@jongodb/memory-server-bin-win32-x64`
+
+Java fallback:
+- set `classpath` option or `JONGODB_CLASSPATH`
+
+Launcher contract:
+- stdout ready line: `JONGODB_URI=mongodb://...`
+- optional stderr failure line: `JONGODB_START_FAILURE=...`
+- process stays alive until termination signal
 
 ## API Surface
 
 Main export (`@jongodb/memory-server`):
-
 - `startJongodbMemoryServer(options?)`
 
 Runtime export (`@jongodb/memory-server/runtime`):
-
 - `createJongodbEnvRuntime(options?)`
 
 Jest export (`@jongodb/memory-server/jest`):
-
 - `registerJongodbForJest(hooks, options?)`
 - `createJestGlobalSetup(options?)`
 - `createJestGlobalTeardown(options?)`
@@ -247,39 +220,40 @@ Jest export (`@jongodb/memory-server/jest`):
 - `readJestGlobalUri(options?)`
 
 Nest export (`@jongodb/memory-server/nestjs`):
-
 - `registerJongodbForNestJest(hooks, options?)`
 
 Vitest export (`@jongodb/memory-server/vitest`):
-
 - `registerJongodbForVitest(hooks, options?)`
 
 ## Options Reference
 
-Core options:
-
+Core:
 - `launchMode`: `auto` | `binary` | `java` (default: `auto`)
-- `binaryPath`: binary executable path
+- `binaryPath`: binary executable override path
 - `classpath`: Java classpath string or string array
 - `javaPath`: Java executable path (default: `java`)
 - `launcherClass`: Java launcher class (default: `org.jongodb.server.TcpMongoServerLauncher`)
-- `databaseName`: default DB in generated URI (default: `test`)
+- `databaseName`: base DB name (default: `test`)
+- `databaseNameSuffix`: suffix appended to `databaseName` (example: `_ci`)
+- `databaseNameStrategy`: `static` | `worker` (default: `static`)
 - `host`: bind host (default: `127.0.0.1`)
-- `port`: bind port (`0` for ephemeral, default: `0`)
+- `port`: bind port (`0` means ephemeral)
 - `startupTimeoutMs`: startup timeout (default: `15000`)
 - `stopTimeoutMs`: stop timeout before forced kill (default: `5000`)
-- `env`: additional child process env vars
+- `env`: extra child process environment variables
 - `logLevel`: `silent` | `info` | `debug` (default: `silent`)
-- `envVarName` (runtime/jest/vitest helpers): target env key (default: `MONGODB_URI`)
+
+Runtime helper options:
+- `envVarName`: single target env key (default: `MONGODB_URI`)
+- `envVarNames`: multiple target env keys (example: `["MONGODB_URI", "DATABASE_URL"]`)
 
 ## Troubleshooting
 
-- `No launcher runtime configured`: set binary path/env or classpath/env
+- `No launcher runtime configured`: set `binaryPath` / `JONGODB_BINARY_PATH` / `classpath` / `JONGODB_CLASSPATH`
 - `Binary launch mode requested but no binary was found`: provide `binaryPath` or `JONGODB_BINARY_PATH`
 - `Java launch mode requested but Java classpath is not configured`: provide `classpath` or `JONGODB_CLASSPATH`
-- `spawn ... ENOENT`: missing binary/java executable path
+- `spawn ... ENOENT`: missing runtime executable path
 - startup timeout: launcher did not emit `JONGODB_URI=...`
 
 Parallel test tip:
-
-- use unique `databaseName` per worker/process to avoid data collisions
+- use `databaseNameStrategy: "worker"` or per-worker suffixes to prevent data collisions

package/dist/cjs/index.js

@@ -21,7 +21,7 @@ async function startJongodbMemoryServer(options = {}) {
     const stopTimeoutMs = normalizeTimeout(options.stopTimeoutMs, DEFAULT_STOP_TIMEOUT_MS, "stopTimeoutMs");
     const host = normalizeHost(options.host);
     const port = normalizePort(options.port);
-    const databaseName = normalizeDatabaseName(options.databaseName);
+    const databaseName = resolveDatabaseName(options);
     const logLevel = options.logLevel ?? "silent";
     const launchConfigs = resolveLaunchConfigs(options, {
         host,
@@ -347,13 +347,59 @@ function normalizePort(port) {
     }
     return normalized;
 }
-function normalizeDatabaseName(databaseName) {
-    const normalized = databaseName?.trim() || DEFAULT_DATABASE;
+function resolveDatabaseName(options) {
+    const base = normalizeDatabaseNameBase(options.databaseName);
+    const explicitSuffix = normalizeDatabaseNameSuffix(options.databaseNameSuffix);
+    const workerSuffix = resolveWorkerDatabaseNameSuffix(options.databaseNameStrategy);
+    return `${base}${explicitSuffix}${workerSuffix}`;
+}
+function normalizeDatabaseNameBase(databaseName) {
+    return databaseName?.trim() || DEFAULT_DATABASE;
+}
+function normalizeDatabaseNameSuffix(databaseNameSuffix) {
+    if (databaseNameSuffix === undefined) {
+        return "";
+    }
+    const normalized = databaseNameSuffix.trim();
     if (normalized.length === 0) {
-        throw new Error("databaseName must not be empty.");
+        throw new Error("databaseNameSuffix must not be empty when provided.");
     }
     return normalized;
 }
+function resolveWorkerDatabaseNameSuffix(strategy) {
+    const resolvedStrategy = strategy ?? "static";
+    if (resolvedStrategy !== "static" && resolvedStrategy !== "worker") {
+        throw new Error(`databaseNameStrategy must be one of: static, worker (got: ${String(strategy)}).`);
+    }
+    if (resolvedStrategy === "static") {
+        return "";
+    }
+    const workerToken = resolveWorkerToken();
+    return `_w${sanitizeDatabaseNameToken(workerToken)}`;
+}
+function resolveWorkerToken() {
+    const envCandidates = [
+        process.env.JONGODB_WORKER_ID,
+        process.env.JEST_WORKER_ID,
+        process.env.VITEST_WORKER_ID,
+        process.env.VITEST_POOL_ID,
+        process.env.NODE_UNIQUE_ID,
+    ];
+    for (const candidate of envCandidates) {
+        const normalized = candidate?.trim();
+        if (normalized !== undefined && normalized.length > 0) {
+            return normalized;
+        }
+    }
+    return String(process.pid);
+}
+function sanitizeDatabaseNameToken(token) {
+    const sanitized = token.replace(/[^A-Za-z0-9_-]/g, "_");
+    if (sanitized.length > 0) {
+        return sanitized;
+    }
+    return "unknown";
+}
 function resolveClasspathOrNull(classpath) {
     const explicit = resolveExplicitClasspath(classpath);
     if (explicit !== null) {

package/dist/cjs/runtime.js

@@ -4,14 +4,15 @@ exports.createJongodbEnvRuntime = createJongodbEnvRuntime;
 const index_js_1 = require("./index.js");
 const DEFAULT_ENV_VAR_NAME = "MONGODB_URI";
 function createJongodbEnvRuntime(options = {}) {
-    const envVarName = normalizeEnvVarName(options.envVarName);
-    const { envVarName: _envVarName, ...serverOptions } = options;
+    const envVarNames = resolveEnvVarNames(options);
+    const envVarName = envVarNames[0];
+    const { envVarName: _envVarName, envVarNames: _envVarNames, ...serverOptions } = options;
     let runtimeServer = null;
     let uri = null;
-    let previousEnvValue;
-    let hadPreviousEnv = false;
+    let previousEnvState = captureEnvState(envVarNames);
     return {
         envVarName,
+        envVarNames,
         get running() {
             return runtimeServer !== null;
         },
@@ -25,11 +26,12 @@ function createJongodbEnvRuntime(options = {}) {
             if (runtimeServer !== null && uri !== null) {
                 return uri;
             }
-            hadPreviousEnv = Object.prototype.hasOwnProperty.call(process.env, envVarName);
-            previousEnvValue = process.env[envVarName];
+            previousEnvState = captureEnvState(envVarNames);
             runtimeServer = await (0, index_js_1.startJongodbMemoryServer)(serverOptions);
             uri = runtimeServer.uri;
-            process.env[envVarName] = uri;
+            for (const candidate of envVarNames) {
+                process.env[candidate] = uri;
+            }
             return uri;
         },
         async teardown() {
@@ -37,22 +39,62 @@ function createJongodbEnvRuntime(options = {}) {
                 await runtimeServer.stop();
                 runtimeServer = null;
             }
-            if (hadPreviousEnv) {
-                process.env[envVarName] = previousEnvValue;
-            }
-            else {
-                delete process.env[envVarName];
-            }
+            restoreEnvState(previousEnvState);
             uri = null;
-            previousEnvValue = undefined;
-            hadPreviousEnv = false;
+            previousEnvState = captureEnvState(envVarNames);
         },
     };
 }
+function resolveEnvVarNames(options) {
+    const explicitCandidates = [];
+    if (options.envVarName !== undefined) {
+        explicitCandidates.push(options.envVarName);
+    }
+    if (options.envVarNames !== undefined) {
+        explicitCandidates.push(...options.envVarNames);
+    }
+    if (explicitCandidates.length === 0) {
+        return [DEFAULT_ENV_VAR_NAME];
+    }
+    const resolved = [];
+    const seen = new Set();
+    for (const candidate of explicitCandidates) {
+        const normalized = normalizeEnvVarName(candidate);
+        if (seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        resolved.push(normalized);
+    }
+    if (resolved.length === 0) {
+        return [DEFAULT_ENV_VAR_NAME];
+    }
+    return resolved;
+}
 function normalizeEnvVarName(name) {
-    const normalized = name?.trim() || DEFAULT_ENV_VAR_NAME;
+    const normalized = name.trim();
     if (normalized.length === 0) {
-        throw new Error("envVarName must not be empty.");
+        throw new Error("envVarName/envVarNames entries must not be empty.");
     }
     return normalized;
 }
+function captureEnvState(envVarNames) {
+    const state = new Map();
+    for (const envVarName of envVarNames) {
+        state.set(envVarName, {
+            hadPrevious: Object.prototype.hasOwnProperty.call(process.env, envVarName),
+            previousValue: process.env[envVarName],
+        });
+    }
+    return state;
+}
+function restoreEnvState(state) {
+    for (const [envVarName, previous] of state.entries()) {
+        if (previous.hadPrevious) {
+            process.env[envVarName] = previous.previousValue;
+        }
+        else {
+            delete process.env[envVarName];
+        }
+    }
+}

package/dist/esm/index.d.ts

@@ -1,9 +1,12 @@
 type LogLevel = "silent" | "info" | "debug";
 type LaunchMode = "auto" | "binary" | "java";
+type DatabaseNameStrategy = "static" | "worker";
 export interface JongodbMemoryServerOptions {
     host?: string;
     port?: number;
     databaseName?: string;
+    databaseNameSuffix?: string;
+    databaseNameStrategy?: DatabaseNameStrategy;
     startupTimeoutMs?: number;
     stopTimeoutMs?: number;
     javaPath?: string;

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAqBA,KAAK,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAC5C,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,MAAM,IAAI,IAAI,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAcD,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAqBA,KAAK,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAC5C,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC7C,KAAK,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,MAAM,IAAI,IAAI,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAcD,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}

package/dist/esm/index.js

@@ -18,7 +18,7 @@ export async function startJongodbMemoryServer(options = {}) {
     const stopTimeoutMs = normalizeTimeout(options.stopTimeoutMs, DEFAULT_STOP_TIMEOUT_MS, "stopTimeoutMs");
     const host = normalizeHost(options.host);
     const port = normalizePort(options.port);
-    const databaseName = normalizeDatabaseName(options.databaseName);
+    const databaseName = resolveDatabaseName(options);
     const logLevel = options.logLevel ?? "silent";
     const launchConfigs = resolveLaunchConfigs(options, {
         host,
@@ -344,13 +344,59 @@ function normalizePort(port) {
     }
     return normalized;
 }
-function normalizeDatabaseName(databaseName) {
-    const normalized = databaseName?.trim() || DEFAULT_DATABASE;
+function resolveDatabaseName(options) {
+    const base = normalizeDatabaseNameBase(options.databaseName);
+    const explicitSuffix = normalizeDatabaseNameSuffix(options.databaseNameSuffix);
+    const workerSuffix = resolveWorkerDatabaseNameSuffix(options.databaseNameStrategy);
+    return `${base}${explicitSuffix}${workerSuffix}`;
+}
+function normalizeDatabaseNameBase(databaseName) {
+    return databaseName?.trim() || DEFAULT_DATABASE;
+}
+function normalizeDatabaseNameSuffix(databaseNameSuffix) {
+    if (databaseNameSuffix === undefined) {
+        return "";
+    }
+    const normalized = databaseNameSuffix.trim();
     if (normalized.length === 0) {
-        throw new Error("databaseName must not be empty.");
+        throw new Error("databaseNameSuffix must not be empty when provided.");
     }
     return normalized;
 }
+function resolveWorkerDatabaseNameSuffix(strategy) {
+    const resolvedStrategy = strategy ?? "static";
+    if (resolvedStrategy !== "static" && resolvedStrategy !== "worker") {
+        throw new Error(`databaseNameStrategy must be one of: static, worker (got: ${String(strategy)}).`);
+    }
+    if (resolvedStrategy === "static") {
+        return "";
+    }
+    const workerToken = resolveWorkerToken();
+    return `_w${sanitizeDatabaseNameToken(workerToken)}`;
+}
+function resolveWorkerToken() {
+    const envCandidates = [
+        process.env.JONGODB_WORKER_ID,
+        process.env.JEST_WORKER_ID,
+        process.env.VITEST_WORKER_ID,
+        process.env.VITEST_POOL_ID,
+        process.env.NODE_UNIQUE_ID,
+    ];
+    for (const candidate of envCandidates) {
+        const normalized = candidate?.trim();
+        if (normalized !== undefined && normalized.length > 0) {
+            return normalized;
+        }
+    }
+    return String(process.pid);
+}
+function sanitizeDatabaseNameToken(token) {
+    const sanitized = token.replace(/[^A-Za-z0-9_-]/g, "_");
+    if (sanitized.length > 0) {
+        return sanitized;
+    }
+    return "unknown";
+}
 function resolveClasspathOrNull(classpath) {
     const explicit = resolveExplicitClasspath(classpath);
     if (explicit !== null) {

package/dist/esm/jest.d.ts

@@ -5,6 +5,7 @@ export interface JestHookRegistrar {
 }
 export interface JestHookOptions extends JongodbMemoryServerOptions {
     envVarName?: string;
+    envVarNames?: string[];
 }
 export interface RegisteredJongodbTestServer {
     readonly uri: string;

package/dist/esm/jest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jest.d.ts","sourceRoot":"","sources":["../../src/jest.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,eAAgB,SAAQ,0BAA0B;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,eAAoB,GAC5B,2BAA2B,CAgB7B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,0BAA+B,GACvC,MAAM,OAAO,CAAC,IAAI,CAAC,CAiBrB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,0BAA+B,GACvC,MAAM,OAAO,CAAC,IAAI,CAAC,CAkBrB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmBvC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM9B"}
+{"version":3,"file":"jest.d.ts","sourceRoot":"","sources":["../../src/jest.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,eAAgB,SAAQ,0BAA0B;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,eAAoB,GAC5B,2BAA2B,CAgB7B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,0BAA+B,GACvC,MAAM,OAAO,CAAC,IAAI,CAAC,CAiBrB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,0BAA+B,GACvC,MAAM,OAAO,CAAC,IAAI,CAAC,CAkBrB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmBvC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM9B"}

package/dist/esm/runtime.d.ts

@@ -1,9 +1,11 @@
 import { type JongodbMemoryServerOptions } from "./index.js";
 export interface JongodbEnvRuntimeOptions extends JongodbMemoryServerOptions {
     envVarName?: string;
+    envVarNames?: string[];
 }
 export interface JongodbEnvRuntime {
     readonly envVarName: string;
+    readonly envVarNames: readonly string[];
     readonly running: boolean;
     readonly uri: string;
     setup(): Promise<string>;

package/dist/esm/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,wBAAyB,SAAQ,0BAA0B;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAkDnB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,wBAAyB,SAAQ,0BAA0B;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAmDnB"}

package/dist/esm/runtime.js

@@ -1,14 +1,15 @@
 import { startJongodbMemoryServer, } from "./index.js";
 const DEFAULT_ENV_VAR_NAME = "MONGODB_URI";
 export function createJongodbEnvRuntime(options = {}) {
-    const envVarName = normalizeEnvVarName(options.envVarName);
-    const { envVarName: _envVarName, ...serverOptions } = options;
+    const envVarNames = resolveEnvVarNames(options);
+    const envVarName = envVarNames[0];
+    const { envVarName: _envVarName, envVarNames: _envVarNames, ...serverOptions } = options;
     let runtimeServer = null;
     let uri = null;
-    let previousEnvValue;
-    let hadPreviousEnv = false;
+    let previousEnvState = captureEnvState(envVarNames);
     return {
         envVarName,
+        envVarNames,
         get running() {
             return runtimeServer !== null;
         },
@@ -22,11 +23,12 @@ export function createJongodbEnvRuntime(options = {}) {
             if (runtimeServer !== null && uri !== null) {
                 return uri;
             }
-            hadPreviousEnv = Object.prototype.hasOwnProperty.call(process.env, envVarName);
-            previousEnvValue = process.env[envVarName];
+            previousEnvState = captureEnvState(envVarNames);
             runtimeServer = await startJongodbMemoryServer(serverOptions);
             uri = runtimeServer.uri;
-            process.env[envVarName] = uri;
+            for (const candidate of envVarNames) {
+                process.env[candidate] = uri;
+            }
             return uri;
         },
         async teardown() {
@@ -34,22 +36,62 @@ export function createJongodbEnvRuntime(options = {}) {
                 await runtimeServer.stop();
                 runtimeServer = null;
             }
-            if (hadPreviousEnv) {
-                process.env[envVarName] = previousEnvValue;
-            }
-            else {
-                delete process.env[envVarName];
-            }
+            restoreEnvState(previousEnvState);
             uri = null;
-            previousEnvValue = undefined;
-            hadPreviousEnv = false;
+            previousEnvState = captureEnvState(envVarNames);
         },
     };
 }
+function resolveEnvVarNames(options) {
+    const explicitCandidates = [];
+    if (options.envVarName !== undefined) {
+        explicitCandidates.push(options.envVarName);
+    }
+    if (options.envVarNames !== undefined) {
+        explicitCandidates.push(...options.envVarNames);
+    }
+    if (explicitCandidates.length === 0) {
+        return [DEFAULT_ENV_VAR_NAME];
+    }
+    const resolved = [];
+    const seen = new Set();
+    for (const candidate of explicitCandidates) {
+        const normalized = normalizeEnvVarName(candidate);
+        if (seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        resolved.push(normalized);
+    }
+    if (resolved.length === 0) {
+        return [DEFAULT_ENV_VAR_NAME];
+    }
+    return resolved;
+}
 function normalizeEnvVarName(name) {
-    const normalized = name?.trim() || DEFAULT_ENV_VAR_NAME;
+    const normalized = name.trim();
     if (normalized.length === 0) {
-        throw new Error("envVarName must not be empty.");
+        throw new Error("envVarName/envVarNames entries must not be empty.");
     }
     return normalized;
 }
+function captureEnvState(envVarNames) {
+    const state = new Map();
+    for (const envVarName of envVarNames) {
+        state.set(envVarName, {
+            hadPrevious: Object.prototype.hasOwnProperty.call(process.env, envVarName),
+            previousValue: process.env[envVarName],
+        });
+    }
+    return state;
+}
+function restoreEnvState(state) {
+    for (const [envVarName, previous] of state.entries()) {
+        if (previous.hadPrevious) {
+            process.env[envVarName] = previous.previousValue;
+        }
+        else {
+            delete process.env[envVarName];
+        }
+    }
+}

package/dist/esm/vitest.d.ts

@@ -5,6 +5,7 @@ export interface VitestHookRegistrar {
 }
 export interface VitestHookOptions extends JongodbMemoryServerOptions {
     envVarName?: string;
+    envVarNames?: string[];
 }
 export interface RegisteredVitestJongodbServer {
     readonly uri: string;

package/dist/esm/vitest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,6BAA6B,CAgB/B"}
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,6BAA6B,CAgB/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jongodb/memory-server",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Node.js test runtime adapter for jongodb standalone launcher (MongoDB-compatible integration tests).",
   "keywords": [
     "mongodb",
@@ -90,9 +90,9 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@jongodb/memory-server-bin-darwin-arm64": "0.1.2",
-    "@jongodb/memory-server-bin-linux-x64-gnu": "0.1.2",
-    "@jongodb/memory-server-bin-win32-x64": "0.1.2"
+    "@jongodb/memory-server-bin-darwin-arm64": "0.1.3",
+    "@jongodb/memory-server-bin-linux-x64-gnu": "0.1.3",
+    "@jongodb/memory-server-bin-win32-x64": "0.1.3"
   },
   "files": [
     "dist",