@warlock.js/core 5.31.0 → 5.33.0

package/esm/tests/fakes/test-fakes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"test-fakes.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/test-fakes.ts"],"sourcesContent":["import type { GenericObject } from \"@mongez/reinforcements\";\nimport { config } from \"../../config\";\nimport { cacheFake } from \"./cache-fake\";\nimport { clockFake } from \"./clock-fake\";\nimport { idsFake } from \"./ids-fake\";\nimport { mailFake } from \"./mail-fake\";\nimport { queueFake } from \"./queue-fake\";\nimport { storageFake } from \"./storage-fake\";\n\n/** The fakes the test kit installs. */\nexport const TEST_FAKE_NAMES = [\"mail\", \"queue\", \"cache\", \"storage\", \"clock\", \"ids\"] as const;\n\nexport type TestFakeName = (typeof TEST_FAKE_NAMES)[number];\n\n/**\n * Which fakes to install.\n *\n * - `true` (the default) — all of them.\n * - `false` — none: real drivers, real clock, real ids.\n * - an object — all of them except the ones set to `false`, e.g.\n *   `{ cache: false }` keeps the configured cache driver.\n */\nexport type TestFakesSelection = boolean | Partial<Record<TestFakeName, boolean>>;\n\nconst fakes: Record<\n  TestFakeName,\n  { install(): void | Promise<void>; restore(): void | Promise<void> }\n> = {\n  mail: mailFake,\n  queue: queueFake,\n  cache: cacheFake,\n  storage: storageFake,\n  clock: clockFake,\n  ids: idsFake,\n};\n\nlet active: TestFakeName[] = [];\n\n/** Read `tests.fakes` from `src/config/tests.ts`, or `undefined` when unset. */\nexport function readConfiguredFakes(): TestFakesSelection | undefined {\n  // `config.get` resolves an absent key to `null`, not to its default's shape.\n  const testsConfig = config.get<GenericObject>(\"tests\", {}) ?? {};\n\n  return validateSelection(testsConfig.fakes as unknown, \"tests.fakes\");\n}\n\nfunction validateSelection(value: unknown, source: string): TestFakesSelection | undefined {\n  if (value === undefined || typeof value === \"boolean\") return value;\n\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(\n      `${source} must be true, false, or an object such as { cache: false }; got ${JSON.stringify(value)}.`,\n    );\n  }\n\n  const selection: Partial<Record<TestFakeName, boolean>> = {};\n\n  for (const [key, flag] of Object.entries(value)) {\n    const name = TEST_FAKE_NAMES.find((candidate) => candidate === key);\n\n    if (!name) {\n      throw new Error(\n        `${source} has an unknown fake \"${key}\". Known fakes: ${TEST_FAKE_NAMES.join(\", \")}.`,\n      );\n    }\n\n    if (typeof flag !== \"boolean\") {\n      throw new Error(`${source}.${key} must be true or false; got ${JSON.stringify(flag)}.`);\n    }\n\n    selection[name] = flag;\n  }\n\n  return selection;\n}\n\n/**\n * The fakes to install. Precedence: an explicit selection (the `fakes`\n * option of `setupTest()` / `startHttpTestServer()`) > `tests.fakes` in\n * `src/config/tests.ts` > all on.\n */\nexport function resolveTestFakes(explicit?: TestFakesSelection): TestFakeName[] {\n  const selection =\n    explicit !== undefined ? validateSelection(explicit, \"fakes\") : readConfiguredFakes();\n\n  if (selection === undefined || selection === true) return [...TEST_FAKE_NAMES];\n  if (selection === false) return [];\n\n  return TEST_FAKE_NAMES.filter((name) => selection[name] !== false);\n}\n\n/**\n * Install the selected fakes. Called by `setupTest()` and\n * `startHttpTestServer()` once their connectors are up; call it yourself only\n * when you bootstrap the framework without them.\n *\n * @returns the fakes that are now installed.\n */\nexport async function installTestFakes(explicit?: TestFakesSelection): Promise<TestFakeName[]> {\n  const selected = resolveTestFakes(explicit);\n\n  for (const name of selected) {\n    await fakes[name].install();\n  }\n\n  active = [...new Set([...active, ...selected])];\n\n  return selected;\n}\n\n/**\n * Restore every installed fake, in reverse order. Every fake is restored even\n * when one fails; the failures are rethrown together afterwards.\n */\nexport async function restoreTestFakes(): Promise<void> {\n  const errors: unknown[] = [];\n\n  for (const name of [...active].reverse()) {\n    try {\n      await fakes[name].restore();\n    } catch (error) {\n      errors.push(error);\n    }\n  }\n\n  active = [];\n\n  if (errors.length > 0) throw new AggregateError(errors, \"Restoring the test fakes failed.\");\n}\n\n/** The fakes installed right now. */\nexport function installedTestFakes(): TestFakeName[] {\n  return [...active];\n}\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,kBAAkB;CAAC;CAAQ;CAAS;CAAS;CAAW;CAAS;AAAK;AAcnF,MAAM,QAGF;CACF,MAAM;CACN,OAAO;CACP,OAAO;CACP,SAAS;CACT,OAAO;CACP,KAAK;AACP;AAEA,IAAI,SAAyB,CAAC;;AAG9B,SAAgB,sBAAsD;CAIpE,OAAO,mBAFa,OAAO,IAAmB,SAAS,CAAC,CAAC,KAAK,CAAC,EAE3B,CAAC,OAAkB,aAAa;AACtE;AAEA,SAAS,kBAAkB,OAAgB,QAAgD;CACzF,IAAI,UAAU,UAAa,OAAO,UAAU,WAAW,OAAO;CAE9D,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,MAAM,IAAI,MACR,GAAG,OAAO,mEAAmE,KAAK,UAAU,KAAK,EAAE,EACrG;CAGF,MAAM,YAAoD,CAAC;CAE3D,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG;EAC/C,MAAM,OAAO,gBAAgB,MAAM,cAAc,cAAc,GAAG;EAElE,IAAI,CAAC,MACH,MAAM,IAAI,MACR,GAAG,OAAO,wBAAwB,IAAI,kBAAkB,gBAAgB,KAAK,IAAI,EAAE,EACrF;EAGF,IAAI,OAAO,SAAS,WAClB,MAAM,IAAI,MAAM,GAAG,OAAO,GAAG,IAAI,8BAA8B,KAAK,UAAU,IAAI,EAAE,EAAE;EAGxF,UAAU,QAAQ;CACpB;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,iBAAiB,UAA+C;CAC9E,MAAM,YACJ,aAAa,SAAY,kBAAkB,UAAU,OAAO,IAAI,oBAAoB;CAEtF,IAAI,cAAc,UAAa,cAAc,MAAM,OAAO,CAAC,GAAG,eAAe;CAC7E,IAAI,cAAc,OAAO,OAAO,CAAC;CAEjC,OAAO,gBAAgB,QAAQ,SAAS,UAAU,UAAU,KAAK;AACnE;;;;;;;;AASA,eAAsB,iBAAiB,UAAwD;CAC7F,MAAM,WAAW,iBAAiB,QAAQ;CAE1C,KAAK,MAAM,QAAQ,UACjB,MAAM,MAAM,KAAK,CAAC,QAAQ;CAG5B,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;CAE9C,OAAO;AACT;;;;;AAMA,eAAsB,mBAAkC;CACtD,MAAM,SAAoB,CAAC;CAE3B,KAAK,MAAM,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,GACrC,IAAI;EACF,MAAM,MAAM,KAAK,CAAC,QAAQ;CAC5B,SAAS,OAAO;EACd,OAAO,KAAK,KAAK;CACnB;CAGF,SAAS,CAAC;CAEV,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,eAAe,QAAQ,kCAAkC;AAC5F;;AAGA,SAAgB,qBAAqC;CACnD,OAAO,CAAC,GAAG,MAAM;AACnB"}
+{"version":3,"file":"test-fakes.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/test-fakes.ts"],"sourcesContent":["import type { GenericObject } from \"@mongez/reinforcements\";\nimport { config } from \"../../config\";\nimport { cacheFake } from \"./cache-fake\";\nimport { clockFake } from \"./clock-fake\";\nimport { idsFake } from \"./ids-fake\";\nimport { mailFake } from \"./mail-fake\";\nimport { queueFake } from \"./queue-fake\";\nimport { secretsFake } from \"./secrets-fake\";\nimport { storageFake } from \"./storage-fake\";\n\n/** The fakes the test kit installs. */\nexport const TEST_FAKE_NAMES = [\n  \"mail\",\n  \"queue\",\n  \"cache\",\n  \"storage\",\n  \"clock\",\n  \"ids\",\n  \"secrets\",\n] as const;\n\nexport type TestFakeName = (typeof TEST_FAKE_NAMES)[number];\n\n/**\n * Which fakes to install.\n *\n * - `true` (the default) — all of them.\n * - `false` — none: real drivers, real clock, real ids, real secret storage.\n * - an object — all of them except the ones set to `false`, e.g.\n *   `{ cache: false }` keeps the configured cache driver.\n */\nexport type TestFakesSelection = boolean | Partial<Record<TestFakeName, boolean>>;\n\nconst fakes: Record<\n  TestFakeName,\n  { install(): void | Promise<void>; restore(): void | Promise<void> }\n> = {\n  mail: mailFake,\n  queue: queueFake,\n  cache: cacheFake,\n  storage: storageFake,\n  clock: clockFake,\n  ids: idsFake,\n  secrets: secretsFake,\n};\n\nlet active: TestFakeName[] = [];\n\n/** Read `tests.fakes` from `src/config/tests.ts`, or `undefined` when unset. */\nexport function readConfiguredFakes(): TestFakesSelection | undefined {\n  // `config.get` resolves an absent key to `null`, not to its default's shape.\n  const testsConfig = config.get<GenericObject>(\"tests\", {}) ?? {};\n\n  return validateSelection(testsConfig.fakes as unknown, \"tests.fakes\");\n}\n\nfunction validateSelection(value: unknown, source: string): TestFakesSelection | undefined {\n  if (value === undefined || typeof value === \"boolean\") return value;\n\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(\n      `${source} must be true, false, or an object such as { cache: false }; got ${JSON.stringify(value)}.`,\n    );\n  }\n\n  const selection: Partial<Record<TestFakeName, boolean>> = {};\n\n  for (const [key, flag] of Object.entries(value)) {\n    const name = TEST_FAKE_NAMES.find((candidate) => candidate === key);\n\n    if (!name) {\n      throw new Error(\n        `${source} has an unknown fake \"${key}\". Known fakes: ${TEST_FAKE_NAMES.join(\", \")}.`,\n      );\n    }\n\n    if (typeof flag !== \"boolean\") {\n      throw new Error(`${source}.${key} must be true or false; got ${JSON.stringify(flag)}.`);\n    }\n\n    selection[name] = flag;\n  }\n\n  return selection;\n}\n\n/**\n * The fakes to install. Precedence: an explicit selection (the `fakes`\n * option of `setupTest()` / `startHttpTestServer()`) > `tests.fakes` in\n * `src/config/tests.ts` > all on.\n */\nexport function resolveTestFakes(explicit?: TestFakesSelection): TestFakeName[] {\n  const selection =\n    explicit !== undefined ? validateSelection(explicit, \"fakes\") : readConfiguredFakes();\n\n  if (selection === undefined || selection === true) return [...TEST_FAKE_NAMES];\n  if (selection === false) return [];\n\n  return TEST_FAKE_NAMES.filter((name) => selection[name] !== false);\n}\n\n/**\n * Install the selected fakes. Called by `setupTest()` and\n * `startHttpTestServer()` once their connectors are up; call it yourself only\n * when you bootstrap the framework without them.\n *\n * @returns the fakes that are now installed.\n */\nexport async function installTestFakes(explicit?: TestFakesSelection): Promise<TestFakeName[]> {\n  const selected = resolveTestFakes(explicit);\n\n  for (const name of selected) {\n    await fakes[name].install();\n  }\n\n  active = [...new Set([...active, ...selected])];\n\n  return selected;\n}\n\n/**\n * Restore every installed fake, in reverse order. Every fake is restored even\n * when one fails; the failures are rethrown together afterwards.\n */\nexport async function restoreTestFakes(): Promise<void> {\n  const errors: unknown[] = [];\n\n  for (const name of [...active].reverse()) {\n    try {\n      await fakes[name].restore();\n    } catch (error) {\n      errors.push(error);\n    }\n  }\n\n  active = [];\n\n  if (errors.length > 0) throw new AggregateError(errors, \"Restoring the test fakes failed.\");\n}\n\n/** The fakes installed right now. */\nexport function installedTestFakes(): TestFakeName[] {\n  return [...active];\n}\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,kBAAkB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAcA,MAAM,QAGF;CACF,MAAM;CACN,OAAO;CACP,OAAO;CACP,SAAS;CACT,OAAO;CACP,KAAK;CACL,SAAS;AACX;AAEA,IAAI,SAAyB,CAAC;;AAG9B,SAAgB,sBAAsD;CAIpE,OAAO,mBAFa,OAAO,IAAmB,SAAS,CAAC,CAAC,KAAK,CAAC,EAE3B,CAAC,OAAkB,aAAa;AACtE;AAEA,SAAS,kBAAkB,OAAgB,QAAgD;CACzF,IAAI,UAAU,UAAa,OAAO,UAAU,WAAW,OAAO;CAE9D,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,MAAM,IAAI,MACR,GAAG,OAAO,mEAAmE,KAAK,UAAU,KAAK,EAAE,EACrG;CAGF,MAAM,YAAoD,CAAC;CAE3D,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG;EAC/C,MAAM,OAAO,gBAAgB,MAAM,cAAc,cAAc,GAAG;EAElE,IAAI,CAAC,MACH,MAAM,IAAI,MACR,GAAG,OAAO,wBAAwB,IAAI,kBAAkB,gBAAgB,KAAK,IAAI,EAAE,EACrF;EAGF,IAAI,OAAO,SAAS,WAClB,MAAM,IAAI,MAAM,GAAG,OAAO,GAAG,IAAI,8BAA8B,KAAK,UAAU,IAAI,EAAE,EAAE;EAGxF,UAAU,QAAQ;CACpB;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,iBAAiB,UAA+C;CAC9E,MAAM,YACJ,aAAa,SAAY,kBAAkB,UAAU,OAAO,IAAI,oBAAoB;CAEtF,IAAI,cAAc,UAAa,cAAc,MAAM,OAAO,CAAC,GAAG,eAAe;CAC7E,IAAI,cAAc,OAAO,OAAO,CAAC;CAEjC,OAAO,gBAAgB,QAAQ,SAAS,UAAU,UAAU,KAAK;AACnE;;;;;;;;AASA,eAAsB,iBAAiB,UAAwD;CAC7F,MAAM,WAAW,iBAAiB,QAAQ;CAE1C,KAAK,MAAM,QAAQ,UACjB,MAAM,MAAM,KAAK,CAAC,QAAQ;CAG5B,SAAS,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;CAE9C,OAAO;AACT;;;;;AAMA,eAAsB,mBAAkC;CACtD,MAAM,SAAoB,CAAC;CAE3B,KAAK,MAAM,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,GACrC,IAAI;EACF,MAAM,MAAM,KAAK,CAAC,QAAQ;CAC5B,SAAS,OAAO;EACd,OAAO,KAAK,KAAK;CACnB;CAGF,SAAS,CAAC;CAEV,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,eAAe,QAAQ,kCAAkC;AAC5F;;AAGA,SAAgB,qBAAqC;CACnD,OAAO,CAAC,GAAG,MAAM;AACnB"}

package/esm/tests/index.d.mts

@@ -12,7 +12,9 @@ import { idsFake } from "./fakes/ids-fake.mjs";
 import { MailMatcher, mailFake } from "./fakes/mail-fake.mjs";
 import { JobReference, PushedJob, PushedJobMatcher, queueFake } from "./fakes/queue-fake.mjs";
 import { storageFake } from "./fakes/storage-fake.mjs";
+import { secretsFake } from "./fakes/secrets-fake.mjs";
+import "./fakes/index.mjs";
 import { Factory, FactoryAttributes, FactoryOverrides, FactorySeed, FactoryState, defineFactory, resetFactorySequences } from "./factories.mjs";
 import { CreateTestHttpServerOptions, TestHttpServer, createTestHttpServer } from "./test-http-server.mjs";
 import { REDACTED, ResponseSnapshot, SnapshotResponseOptions, snapshotResponse } from "./snapshot-response.mjs";
-export { AuthenticatedTestClient, CreateTestHttpServerOptions, DEFAULT_FAKE_NOW, Factory, FactoryAttributes, FactoryOverrides, FactorySeed, FactoryState, FakeAssertionError, JobReference, MailMatcher, PushedJob, PushedJobMatcher, REDACTED, ResponseSnapshot, SnapshotResponseOptions, StartHttpTestServerOptions, TEST_FAKE_NAMES, TestAuthenticableUser, type TestConnectorsSelection, TestFakeName, TestFakesSelection, TestHttpServer, TestLifecycleError, TestRequestClient, TestSetupOptions, actingAs, assertPortIsAvailable, cacheFake, clockFake, createTestHttpServer, createTestRequestClient, defineFactory, describeRecorded, expectJson, getTestServerUrl, idsFake, installTestFakes, installedTestFakes, isPortAvailable, isTestServerRunning, mailFake, parseJsonResponse, queueFake, readConfiguredFakes, resetFactorySequences, resolveTestFakes, restoreTestFakes, setupTest, snapshotResponse, startHttpTestServer, stopHttpTestServer, storageFake, teardownTest, testDelete, testGet, testPatch, testPost, testPut, testRequest, warnMissingImportModule };
+export { AuthenticatedTestClient, CreateTestHttpServerOptions, DEFAULT_FAKE_NOW, Factory, FactoryAttributes, FactoryOverrides, FactorySeed, FactoryState, FakeAssertionError, JobReference, MailMatcher, PushedJob, PushedJobMatcher, REDACTED, ResponseSnapshot, SnapshotResponseOptions, StartHttpTestServerOptions, TEST_FAKE_NAMES, TestAuthenticableUser, type TestConnectorsSelection, TestFakeName, TestFakesSelection, TestHttpServer, TestLifecycleError, TestRequestClient, TestSetupOptions, actingAs, assertPortIsAvailable, cacheFake, clockFake, createTestHttpServer, createTestRequestClient, defineFactory, describeRecorded, expectJson, getTestServerUrl, idsFake, installTestFakes, installedTestFakes, isPortAvailable, isTestServerRunning, mailFake, parseJsonResponse, queueFake, readConfiguredFakes, resetFactorySequences, resolveTestFakes, restoreTestFakes, secretsFake, setupTest, snapshotResponse, startHttpTestServer, stopHttpTestServer, storageFake, teardownTest, testDelete, testGet, testPatch, testPost, testPut, testRequest, warnMissingImportModule };

package/esm/tests/index.mjs

@@ -5,6 +5,7 @@ import { DEFAULT_FAKE_NOW, clockFake } from "./fakes/clock-fake.mjs";
 import { idsFake } from "./fakes/ids-fake.mjs";
 import { mailFake } from "./fakes/mail-fake.mjs";
 import { queueFake } from "./fakes/queue-fake.mjs";
+import { secretsFake } from "./fakes/secrets-fake.mjs";
 import { storageFake } from "./fakes/storage-fake.mjs";
 import { TEST_FAKE_NAMES, installTestFakes, installedTestFakes, readConfiguredFakes, resolveTestFakes, restoreTestFakes } from "./fakes/test-fakes.mjs";
 import { isTestServerRunning, startHttpTestServer, stopHttpTestServer } from "./start-http-development-server.mjs";
@@ -16,4 +17,4 @@ import { defineFactory, resetFactorySequences } from "./factories.mjs";
 import { createTestHttpServer } from "./test-http-server.mjs";
 import { REDACTED, snapshotResponse } from "./snapshot-response.mjs";
 
-export { DEFAULT_FAKE_NOW, FakeAssertionError, REDACTED, TEST_FAKE_NAMES, TestLifecycleError, actingAs, assertPortIsAvailable, cacheFake, clockFake, createTestHttpServer, createTestRequestClient, defineFactory, describeRecorded, expectJson, getTestServerUrl, idsFake, installTestFakes, installedTestFakes, isPortAvailable, isTestServerRunning, mailFake, parseJsonResponse, queueFake, readConfiguredFakes, resetFactorySequences, resolveTestFakes, restoreTestFakes, setupTest, snapshotResponse, startHttpTestServer, stopHttpTestServer, storageFake, teardownTest, testDelete, testGet, testPatch, testPost, testPut, testRequest, warnMissingImportModule };
+export { DEFAULT_FAKE_NOW, FakeAssertionError, REDACTED, TEST_FAKE_NAMES, TestLifecycleError, actingAs, assertPortIsAvailable, cacheFake, clockFake, createTestHttpServer, createTestRequestClient, defineFactory, describeRecorded, expectJson, getTestServerUrl, idsFake, installTestFakes, installedTestFakes, isPortAvailable, isTestServerRunning, mailFake, parseJsonResponse, queueFake, readConfiguredFakes, resetFactorySequences, resolveTestFakes, restoreTestFakes, secretsFake, setupTest, snapshotResponse, startHttpTestServer, stopHttpTestServer, storageFake, teardownTest, testDelete, testGet, testPatch, testPost, testPut, testRequest, warnMissingImportModule };

package/esm/tests/snapshot-response.d.mts

@@ -5,19 +5,19 @@
  * timestamps) replaced, so the snapshot fails only when the shape or a stable
  * value changes.
  */
-type ResponseSnapshot = {
+export type ResponseSnapshot = {
   status: number;
   contentType: string | null;
   body: unknown;
 };
-type SnapshotResponseOptions = {
+export type SnapshotResponseOptions = {
   /**
    * Dot paths whose values are replaced by `"[redacted]"`. `*` matches any
    * key or array index: `"post.id"`, `"posts.*.createdAt"`, `"*.token"`.
    */
   redact?: string[];
 };
-declare const REDACTED = "[redacted]";
+export declare const REDACTED = "[redacted]";
 /**
  * Read a response into a {@link ResponseSnapshot} for `toMatchSnapshot()`.
  * Consumes the body: call it instead of `response.json()`, not after.
@@ -28,7 +28,6 @@ declare const REDACTED = "[redacted]";
  * expect(await snapshotResponse(response, { redact: ["post.id", "post.createdAt"] }))
  *   .toMatchSnapshot();
  */
-declare function snapshotResponse(response: Response, options?: SnapshotResponseOptions): Promise<ResponseSnapshot>;
+export declare function snapshotResponse(response: Response, options?: SnapshotResponseOptions): Promise<ResponseSnapshot>;
 //#endregion
-export { REDACTED, ResponseSnapshot, SnapshotResponseOptions, snapshotResponse };
 //# sourceMappingURL=snapshot-response.d.mts.map

package/esm/tests/snapshot-response.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-response.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/snapshot-response.ts"],"mappings":";;AAMA;;;;;KAAY,gBAAA;EACV,MAAA;EACA,WAAA;EACA,IAAA;AAAA;AAAA,KAGU,uBAAA;;;AAKJ;AAGR;EAHE,MAAM;AAAA;AAAA,cAGK,QAAA;AAAQ;AAkCrB;;;;;;;;;AAlCqB,iBAkCC,gBAAA,CACpB,QAAA,EAAU,QAAA,EACV,OAAA,GAAS,uBAAA,GACR,OAAA,CAAQ,gBAAA"}
+{"version":3,"file":"snapshot-response.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/snapshot-response.ts"],"mappings":";;;;;;;YAMY;EACV;EACA;EACA;;YAGU;;;;;EAKV;;qBAGW;;;;;;;;;;;wBAkCS,iBACpB,UAAU,UACV,UAAS,0BACR,QAAQ"}

package/esm/tests/start-http-development-server.d.mts

@@ -1,7 +1,6 @@
 import { TestFakesSelection } from "./fakes/test-fakes.mjs";
-
 //#region ../../packages/core/src/tests/start-http-development-server.d.ts
-type StartHttpTestServerOptions = {
+export type StartHttpTestServerOptions = {
   /**
    * Port the test server binds to, overriding `http.port`.
    *
@@ -48,16 +47,15 @@ type StartHttpTestServerOptions = {
  * // let the OS pick a free port; the request helpers follow it
  * await startHttpTestServer({ port: 0 });
  */
-declare function startHttpTestServer(options?: StartHttpTestServerOptions): Promise<void>;
+export declare function startHttpTestServer(options?: StartHttpTestServerOptions): Promise<void>;
 /**
  * Stop the HTTP test server
  * Call this in Vitest's globalTeardown
  */
-declare function stopHttpTestServer(): Promise<void>;
+export declare function stopHttpTestServer(): Promise<void>;
 /**
  * Check if test server is running
  */
-declare function isTestServerRunning(): boolean;
+export declare function isTestServerRunning(): boolean;
 //#endregion
-export { StartHttpTestServerOptions, isTestServerRunning, startHttpTestServer, stopHttpTestServer };
 //# sourceMappingURL=start-http-development-server.d.mts.map

package/esm/tests/start-http-development-server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"start-http-development-server.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/start-http-development-server.ts"],"mappings":";;;KA4BY,0BAAA;;AAAZ;;;;;;;;;EAWE,IAAA;EAqJoB;;;;;;;;AAAsE;EA1I1F,GAAA;EAqQsC;;;AAAW;AAmCnD;;;;AAAmC;;;EA3RjC,KAAA,GAAQ,kBAAkB;AAAA;;;;;;;;;;;;;iBA6HN,mBAAA,CAAoB,OAAA,GAAS,0BAAA,GAAkC,OAAO;;;;;iBA2HtE,kBAAA,IAAsB,OAAO;;;;iBAmCnC,mBAAA"}
+{"version":3,"file":"start-http-development-server.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/start-http-development-server.ts"],"mappings":";;YA4BY;;;;;;;;;;;EAWV;;;;;;;;;;EAWA;;;;;;;;;;;;EAaA,QAAQ;;;;;;;;;;;;;;wBA6HY,oBAAoB,UAAS,6BAAkC;;;;;wBA2H/D,sBAAsB;;;;wBAmC5B"}

package/esm/tests/start-http-development-server.mjs

@@ -11,7 +11,7 @@ import { filesOrchestrator } from "../dev-server/files-orchestrator.mjs";
 import { loadConfigFiles } from "../config/load-config-files.mjs";
 import { installTestFakes, restoreTestFakes } from "./fakes/test-fakes.mjs";
 import { publishTestServerPort, withdrawTestServerPort } from "./test-server-port-channel.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 
 //#region ../../packages/core/src/tests/start-http-development-server.ts
 /**
@@ -50,16 +50,16 @@ async function startTestServerPhase(phase) {
 * and never falls back to `process.env`.
 */
 async function applyTestServerPort(port) {
-	if (!config.get("http")) {
+	if (!baseConfig.get("http")) {
 		if (port !== void 0) throw new Error(`startHttpTestServer({ port: ${port} }) was given a port, but this app has no \`http\` config, so no HTTP server is started. Add \`src/config/http.ts\` first.`);
 		return "none";
 	}
-	if (port !== void 0) config.set("http.port", port);
-	const resolvedPort = config.get("http.port");
+	if (port !== void 0) baseConfig.set("http.port", port);
+	const resolvedPort = baseConfig.get("http.port");
 	if (typeof resolvedPort !== "number") throw new Error(`startHttpTestServer() cannot use \`http.port\` value ${JSON.stringify(resolvedPort)} — it did not round-trip through Number() (env() only coerces a value when \`String(Number(v)) === v\`, so "03999", "+3999", "1e3", and values with stray whitespace stay strings). Fix \`HTTP_PORT\` in .env, or pass an explicit numeric port: startHttpTestServer({ port: 3999 }).`);
 	if (resolvedPort === 0) return "ephemeral";
 	if (resolvedPort < 0) throw new Error(`startHttpTestServer() cannot run on port ${resolvedPort}. Pass a port number, or 0 to let the OS pick a free one — e.g. startHttpTestServer({ port: 0 }).`);
-	await assertPortIsAvailable(resolvedPort, config.get("http.host") || "localhost");
+	await assertPortIsAvailable(resolvedPort, baseConfig.get("http.host") || "localhost");
 	publishTestServerPort(resolvedPort);
 	return "published";
 }

package/esm/tests/start-http-development-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"start-http-development-server.mjs","names":[],"sources":["../../../../../../../../packages/core/src/tests/start-http-development-server.ts"],"sourcesContent":["/**\n * HTTP Test Server\n *\n * Starts a minimal HTTP server for testing.\n * Unlike the full DevelopmentServer, this:\n * - Does NOT watch files\n * - Does NOT do HMR\n * - Only starts connectors needed for HTTP requests\n *\n * Used in Vitest's globalSetup to start server once for all test workers.\n */\nimport config from \"@mongez/config\";\nimport { Application } from \"../application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { assertPortIsAvailable } from \"../http/port-preflight\";\nimport { getHttpReadyReport } from \"../http/ready-report\";\nimport { loadEnvironmentFiles } from \"../utils/load-environment\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { installTestFakes, restoreTestFakes } from \"./fakes/test-fakes\";\nimport type { TestFakesSelection } from \"./fakes/test-fakes\";\nimport { publishTestServerPort, withdrawTestServerPort } from \"./test-server-port-channel\";\n\nlet isServerRunning = false;\n\nexport type StartHttpTestServerOptions = {\n  /**\n   * Port the test server binds to, overriding `http.port`.\n   *\n   * Needed because the server cannot be moved from outside: this function\n   * bootstraps the app itself, and that bootstrap re-reads `.env`.\n   *\n   * `0` asks the OS for a free port. The port actually bound is published to\n   * the test workers, so `testGet()`, `actingAs()` and friends follow it, and\n   * a suite never collides with `warlock dev` or another suite.\n   */\n  port?: number;\n\n  /**\n   * Whether to boot the optional web connector.\n   *\n   * Defaults to `true` to preserve the full-stack test server. Pass `false`\n   * for API-only suites: the web connector's lazy delegate is skipped before\n   * `boot()`, so it never constructs its Vite-backed implementation.\n   *\n   * @default true\n   */\n  web?: boolean;\n\n  /**\n   * Which test fakes the server process installs (mail, queue, cache,\n   * storage, clock, ids). Same values and precedence as `setupTest({ fakes })`:\n   * this option > `tests.fakes` config > all on.\n   *\n   * A fake records what happens in ITS process: mail sent while this server\n   * handles a request is captured here, not in the test worker that sent the\n   * request. To assert on what an HTTP request did, serve it in the worker\n   * with `createTestHttpServer()`. The storage fake is the exception: its\n   * temp root is shared with the workers.\n   */\n  fakes?: TestFakesSelection;\n};\n\n/**\n * Start one lifecycle phase while omitting the web connector.\n *\n * Kept here rather than changing the manager's public API: this is a\n * test-server-only selection, and retaining the manager's boot-all / start-all\n * ordering is essential for HTTP and socket connector wiring.\n */\nasync function startTestServerPhase(phase: ConnectorLifecyclePhase): Promise<void> {\n  const connectors = connectorsManager\n    .list()\n    .filter((connector) => connector.lifecyclePhase === phase)\n    .filter((connector) => connector.name !== \"web\");\n\n  for (const connector of connectors) {\n    await connector.boot();\n  }\n\n  for (const connector of connectors) {\n    await connector.start();\n  }\n}\n\n/**\n * Apply the caller's port and preflight the bind.\n *\n * Called at the last moment before the HTTP connector binds, and that timing is\n * the fix: `bootstrap()` re-reads `.env` through `loadEnv()` (dotenv overrides\n * by default), and `src/config/http.ts` then resolves its port from that store,\n * so anything the caller set earlier is gone by the time the port is read.\n * Writing into `config` here is also the only channel that works — assigning\n * `process.env.HTTP_PORT` has no effect, since `env()` reads dotenv's own store\n * and never falls back to `process.env`.\n */\nasync function applyTestServerPort(port?: number): Promise<\"published\" | \"ephemeral\" | \"none\"> {\n  const httpConfig = config.get(\"http\");\n\n  if (!httpConfig) {\n    if (port !== undefined) {\n      throw new Error(\n        `startHttpTestServer({ port: ${port} }) was given a port, but this app has no \\`http\\` config, so no HTTP server is started. Add \\`src/config/http.ts\\` first.`,\n      );\n    }\n\n    return \"none\";\n  }\n\n  if (port !== undefined) {\n    config.set(\"http.port\", port);\n  }\n\n  const resolvedPort = config.get(\"http.port\");\n\n  // No configured port at all is fine: Fastify falls back to its own default and\n  // the workers resolve the same one from their own config, so both ends agree\n  // without the channel.\n  //\n  // A non-numeric port is NOT fine, and must fail loudly rather than skip the\n  // preflight silently. `env()` coerces a value only when it round-trips exactly\n  // (`String(Number(v)) === v`), so `HTTP_PORT=3999` and `HTTP_PORT=0` arrive as\n  // numbers, but `03999`, `+3999`, `1e3` and anything with stray whitespace stay\n  // strings. Letting those through used to reach `HttpConnector.start()`'s\n  // `listen({ port })` unchanged — no preflight, no published port, and every\n  // test worker resolving a URL from a channel nothing ever wrote to.\n  if (typeof resolvedPort !== \"number\") {\n    throw new Error(\n      `startHttpTestServer() cannot use \\`http.port\\` value ${JSON.stringify(resolvedPort)} — it did not round-trip through Number() (env() only coerces a value when \\`String(Number(v)) === v\\`, so \"03999\", \"+3999\", \"1e3\", and values with stray whitespace stay strings). Fix \\`HTTP_PORT\\` in .env, or pass an explicit numeric port: startHttpTestServer({ port: 3999 }).`,\n    );\n  }\n\n  // `0` is the OS's \"pick a free one for me\". There is nothing to preflight —\n  // probing 0 would bind some unrelated port and prove nothing — and nothing to\n  // publish yet: the port is only known once the HTTP connector has bound, and\n  // `HttpConnector.start()` records the port `listen()` actually returned (see\n  // `ready-report.ts`). It is published right after the late phase instead.\n  if (resolvedPort === 0) {\n    return \"ephemeral\";\n  }\n\n  if (resolvedPort < 0) {\n    throw new Error(\n      `startHttpTestServer() cannot run on port ${resolvedPort}. Pass a port number, or 0 to let the OS pick a free one — e.g. startHttpTestServer({ port: 0 }).`,\n    );\n  }\n\n  await assertPortIsAvailable(resolvedPort, config.get(\"http.host\") || \"localhost\");\n\n  publishTestServerPort(resolvedPort);\n\n  return \"published\";\n}\n\n/**\n * Publish the port an ephemeral (`port: 0`) bind actually took.\n *\n * `before` is the ready report from before the late phase: the report is a\n * module-level record, so an unchanged one means THIS boot bound nothing and an\n * older report must not be mistaken for it.\n */\nfunction publishEphemeralPort(before: ReturnType<typeof getHttpReadyReport>): void {\n  const report = getHttpReadyReport();\n\n  if (!report || report === before || report.port <= 0) {\n    throw new Error(\n      \"startHttpTestServer({ port: 0 }) booted, but the HTTP connector did not bind a port, so there is no address to give the test workers. Check that `src/config/http.ts` exists and that this process serves HTTP (its role is not worker-only).\",\n    );\n  }\n\n  publishTestServerPort(report.port);\n}\n\n/**\n * Start the HTTP test server (minimal - no file watching)\n * Call this in Vitest's globalSetup\n *\n * @example\n * // run this suite on its own port, whatever `.env` says\n * await startHttpTestServer({ port: 3999 });\n *\n * @example\n * // let the OS pick a free port; the request helpers follow it\n * await startHttpTestServer({ port: 0 });\n */\nexport async function startHttpTestServer(options: StartHttpTestServerOptions = {}): Promise<void> {\n  const nodeEnvironment = process.env.NODE_ENV;\n\n  if (nodeEnvironment === undefined) {\n    process.env.NODE_ENV = \"test\";\n  } else if (nodeEnvironment !== \"test\") {\n    throw new Error(\n      `startHttpTestServer() requires NODE_ENV=\"test\", but received NODE_ENV=${JSON.stringify(nodeEnvironment)}. Set NODE_ENV=test before starting the test server.`,\n    );\n  }\n\n  if (isServerRunning) {\n    console.log(\"[test-server] Server already running, skipping start\");\n    return;\n  }\n\n  console.log(\"[test-server] Starting HTTP test server...\");\n\n  try {\n    // `globalSetup` runs in Vitest's main process, where Vitest's worker env\n    // setup has not run. Load `.env.test` here, before any config is read.\n    await loadEnvironmentFiles();\n\n    // Set environment\n    Application.setRuntimeStrategy(\"development\");\n    Application.setEnvironment(\"test\");\n\n    // Bootstrap (env, etc.)\n    await warlockConfigManager.load();\n    await bootstrap();\n\n    // Initialize file orchestrator (but don't watch)\n    await filesOrchestrator.init();\n    await filesOrchestrator.initializeAll();\n\n    // Load config files\n    await loadConfigFiles(true);\n\n    // Early-phase connectors (database, cache, logger, storage, mailer,\n    // herald) must start BEFORE app modules load: a module's `main.ts` boot\n    // side-effect can query the DB at import time, so the data source has to\n    // be registered first. This mirrors the dev/prod boot order (see\n    // `cli-commands.manager`, `production-builder`, and `DevelopmentServer`).\n    if (options.web === false) {\n      await startTestServerPhase(ConnectorLifecyclePhase.Early);\n    } else {\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\n    }\n\n    // Fakes before app modules load, so module boot code already sees them.\n    await installTestFakes(options.fakes);\n\n    // Load application modules (their boot side-effects now see a live DB).\n    await filesOrchestrator.moduleLoader.loadAll();\n\n    const portMode = await applyTestServerPort(options.port);\n    const readyReportBefore = getHttpReadyReport();\n\n    // A rejecting validator (Application.onValidateBoot) must abort boot\n    // before late-phase connectors bind a port — same slot as\n    // `DevelopmentServer.start()` and the generated production `app.ts`.\n    await Application.runStartupValidators();\n\n    // Late-phase connectors (http, socket) bind after app code has\n    // registered its routes and listeners.\n    if (options.web === false) {\n      await startTestServerPhase(ConnectorLifecyclePhase.Late);\n    } else {\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\n    }\n\n    if (portMode === \"ephemeral\") {\n      publishEphemeralPort(readyReportBefore);\n    }\n\n    isServerRunning = true;\n  } catch (error) {\n    // This function owns the connectors it starts, so a failure part-way\n    // through has to leave nothing behind. Without this, `isServerRunning` was\n    // still `false` — it is only set on the last line — so `globalTeardown`'s\n    // `stopHttpTestServer()` reported \"No server to stop\" and walked away from\n    // live early-phase connectors and a published port that outlived them.\n    await unwindPartialStartup();\n\n    // Rethrown unchanged: the startup failure is the one the caller needs to\n    // read. A cleanup failure that replaced it would hide the actual cause.\n    throw error;\n  }\n}\n\n/**\n * Best-effort teardown of whatever a failed {@link startHttpTestServer} managed\n * to start.\n *\n * Every step is independent and none may throw: this runs while an error is\n * already in flight, and the caller is about to rethrow it.\n */\nasync function unwindPartialStartup(): Promise<void> {\n  try {\n    await restoreTestFakes();\n  } catch (fakesError) {\n    console.error(\n      \"[test-server] Restoring the test fakes after a failed start did not complete:\",\n      fakesError,\n    );\n  }\n\n  try {\n    await connectorsManager.shutdown();\n  } catch (shutdownError) {\n    // Reported, not thrown — it is secondary to the startup error being\n    // rethrown, and losing that one to this would be the worse outcome.\n    console.error(\"[test-server] Cleanup after a failed start did not complete:\", shutdownError);\n  }\n\n  withdrawTestServerPort();\n  isServerRunning = false;\n}\n\n/**\n * Stop the HTTP test server\n * Call this in Vitest's globalTeardown\n */\nexport async function stopHttpTestServer(): Promise<void> {\n  if (!isServerRunning) {\n    console.log(\"[test-server] No server to stop\");\n    return;\n  }\n\n  try {\n    try {\n      await restoreTestFakes();\n    } catch (fakesError) {\n      console.error(\"[test-server] Restoring the test fakes did not complete:\", fakesError);\n    }\n\n    await connectorsManager.shutdown();\n\n    console.log(\"[test-server] HTTP test server stopped\");\n  } catch (error) {\n    // Surfaced, never swallowed — cleaning up is not the same as the shutdown\n    // having succeeded, and a suite whose teardown failed should say so.\n    console.error(\"[test-server] Error stopping HTTP server:\", error);\n\n    throw error;\n  } finally {\n    // In a `finally` rather than after the `await`: when `shutdown()` threw,\n    // the published port survived the server it pointed at, so the next run in\n    // the same process inherited a stale one and sent every request to it.\n    withdrawTestServerPort();\n\n    isServerRunning = false;\n  }\n}\n\n/**\n * Check if test server is running\n */\nexport function isTestServerRunning(): boolean {\n  return isServerRunning;\n}\n"],"mappings":"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"}
+{"version":3,"file":"start-http-development-server.mjs","names":["config"],"sources":["../../../../../../../../packages/core/src/tests/start-http-development-server.ts"],"sourcesContent":["/**\n * HTTP Test Server\n *\n * Starts a minimal HTTP server for testing.\n * Unlike the full DevelopmentServer, this:\n * - Does NOT watch files\n * - Does NOT do HMR\n * - Only starts connectors needed for HTTP requests\n *\n * Used in Vitest's globalSetup to start server once for all test workers.\n */\nimport config from \"@mongez/config\";\nimport { Application } from \"../application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { assertPortIsAvailable } from \"../http/port-preflight\";\nimport { getHttpReadyReport } from \"../http/ready-report\";\nimport { loadEnvironmentFiles } from \"../utils/load-environment\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { installTestFakes, restoreTestFakes } from \"./fakes/test-fakes\";\nimport type { TestFakesSelection } from \"./fakes/test-fakes\";\nimport { publishTestServerPort, withdrawTestServerPort } from \"./test-server-port-channel\";\n\nlet isServerRunning = false;\n\nexport type StartHttpTestServerOptions = {\n  /**\n   * Port the test server binds to, overriding `http.port`.\n   *\n   * Needed because the server cannot be moved from outside: this function\n   * bootstraps the app itself, and that bootstrap re-reads `.env`.\n   *\n   * `0` asks the OS for a free port. The port actually bound is published to\n   * the test workers, so `testGet()`, `actingAs()` and friends follow it, and\n   * a suite never collides with `warlock dev` or another suite.\n   */\n  port?: number;\n\n  /**\n   * Whether to boot the optional web connector.\n   *\n   * Defaults to `true` to preserve the full-stack test server. Pass `false`\n   * for API-only suites: the web connector's lazy delegate is skipped before\n   * `boot()`, so it never constructs its Vite-backed implementation.\n   *\n   * @default true\n   */\n  web?: boolean;\n\n  /**\n   * Which test fakes the server process installs (mail, queue, cache,\n   * storage, clock, ids). Same values and precedence as `setupTest({ fakes })`:\n   * this option > `tests.fakes` config > all on.\n   *\n   * A fake records what happens in ITS process: mail sent while this server\n   * handles a request is captured here, not in the test worker that sent the\n   * request. To assert on what an HTTP request did, serve it in the worker\n   * with `createTestHttpServer()`. The storage fake is the exception: its\n   * temp root is shared with the workers.\n   */\n  fakes?: TestFakesSelection;\n};\n\n/**\n * Start one lifecycle phase while omitting the web connector.\n *\n * Kept here rather than changing the manager's public API: this is a\n * test-server-only selection, and retaining the manager's boot-all / start-all\n * ordering is essential for HTTP and socket connector wiring.\n */\nasync function startTestServerPhase(phase: ConnectorLifecyclePhase): Promise<void> {\n  const connectors = connectorsManager\n    .list()\n    .filter((connector) => connector.lifecyclePhase === phase)\n    .filter((connector) => connector.name !== \"web\");\n\n  for (const connector of connectors) {\n    await connector.boot();\n  }\n\n  for (const connector of connectors) {\n    await connector.start();\n  }\n}\n\n/**\n * Apply the caller's port and preflight the bind.\n *\n * Called at the last moment before the HTTP connector binds, and that timing is\n * the fix: `bootstrap()` re-reads `.env` through `loadEnv()` (dotenv overrides\n * by default), and `src/config/http.ts` then resolves its port from that store,\n * so anything the caller set earlier is gone by the time the port is read.\n * Writing into `config` here is also the only channel that works — assigning\n * `process.env.HTTP_PORT` has no effect, since `env()` reads dotenv's own store\n * and never falls back to `process.env`.\n */\nasync function applyTestServerPort(port?: number): Promise<\"published\" | \"ephemeral\" | \"none\"> {\n  const httpConfig = config.get(\"http\");\n\n  if (!httpConfig) {\n    if (port !== undefined) {\n      throw new Error(\n        `startHttpTestServer({ port: ${port} }) was given a port, but this app has no \\`http\\` config, so no HTTP server is started. Add \\`src/config/http.ts\\` first.`,\n      );\n    }\n\n    return \"none\";\n  }\n\n  if (port !== undefined) {\n    config.set(\"http.port\", port);\n  }\n\n  const resolvedPort = config.get(\"http.port\");\n\n  // No configured port at all is fine: Fastify falls back to its own default and\n  // the workers resolve the same one from their own config, so both ends agree\n  // without the channel.\n  //\n  // A non-numeric port is NOT fine, and must fail loudly rather than skip the\n  // preflight silently. `env()` coerces a value only when it round-trips exactly\n  // (`String(Number(v)) === v`), so `HTTP_PORT=3999` and `HTTP_PORT=0` arrive as\n  // numbers, but `03999`, `+3999`, `1e3` and anything with stray whitespace stay\n  // strings. Letting those through used to reach `HttpConnector.start()`'s\n  // `listen({ port })` unchanged — no preflight, no published port, and every\n  // test worker resolving a URL from a channel nothing ever wrote to.\n  if (typeof resolvedPort !== \"number\") {\n    throw new Error(\n      `startHttpTestServer() cannot use \\`http.port\\` value ${JSON.stringify(resolvedPort)} — it did not round-trip through Number() (env() only coerces a value when \\`String(Number(v)) === v\\`, so \"03999\", \"+3999\", \"1e3\", and values with stray whitespace stay strings). Fix \\`HTTP_PORT\\` in .env, or pass an explicit numeric port: startHttpTestServer({ port: 3999 }).`,\n    );\n  }\n\n  // `0` is the OS's \"pick a free one for me\". There is nothing to preflight —\n  // probing 0 would bind some unrelated port and prove nothing — and nothing to\n  // publish yet: the port is only known once the HTTP connector has bound, and\n  // `HttpConnector.start()` records the port `listen()` actually returned (see\n  // `ready-report.ts`). It is published right after the late phase instead.\n  if (resolvedPort === 0) {\n    return \"ephemeral\";\n  }\n\n  if (resolvedPort < 0) {\n    throw new Error(\n      `startHttpTestServer() cannot run on port ${resolvedPort}. Pass a port number, or 0 to let the OS pick a free one — e.g. startHttpTestServer({ port: 0 }).`,\n    );\n  }\n\n  await assertPortIsAvailable(resolvedPort, config.get(\"http.host\") || \"localhost\");\n\n  publishTestServerPort(resolvedPort);\n\n  return \"published\";\n}\n\n/**\n * Publish the port an ephemeral (`port: 0`) bind actually took.\n *\n * `before` is the ready report from before the late phase: the report is a\n * module-level record, so an unchanged one means THIS boot bound nothing and an\n * older report must not be mistaken for it.\n */\nfunction publishEphemeralPort(before: ReturnType<typeof getHttpReadyReport>): void {\n  const report = getHttpReadyReport();\n\n  if (!report || report === before || report.port <= 0) {\n    throw new Error(\n      \"startHttpTestServer({ port: 0 }) booted, but the HTTP connector did not bind a port, so there is no address to give the test workers. Check that `src/config/http.ts` exists and that this process serves HTTP (its role is not worker-only).\",\n    );\n  }\n\n  publishTestServerPort(report.port);\n}\n\n/**\n * Start the HTTP test server (minimal - no file watching)\n * Call this in Vitest's globalSetup\n *\n * @example\n * // run this suite on its own port, whatever `.env` says\n * await startHttpTestServer({ port: 3999 });\n *\n * @example\n * // let the OS pick a free port; the request helpers follow it\n * await startHttpTestServer({ port: 0 });\n */\nexport async function startHttpTestServer(options: StartHttpTestServerOptions = {}): Promise<void> {\n  const nodeEnvironment = process.env.NODE_ENV;\n\n  if (nodeEnvironment === undefined) {\n    process.env.NODE_ENV = \"test\";\n  } else if (nodeEnvironment !== \"test\") {\n    throw new Error(\n      `startHttpTestServer() requires NODE_ENV=\"test\", but received NODE_ENV=${JSON.stringify(nodeEnvironment)}. Set NODE_ENV=test before starting the test server.`,\n    );\n  }\n\n  if (isServerRunning) {\n    console.log(\"[test-server] Server already running, skipping start\");\n    return;\n  }\n\n  console.log(\"[test-server] Starting HTTP test server...\");\n\n  try {\n    // `globalSetup` runs in Vitest's main process, where Vitest's worker env\n    // setup has not run. Load `.env.test` here, before any config is read.\n    await loadEnvironmentFiles();\n\n    // Set environment\n    Application.setRuntimeStrategy(\"development\");\n    Application.setEnvironment(\"test\");\n\n    // Bootstrap (env, etc.)\n    await warlockConfigManager.load();\n    await bootstrap();\n\n    // Initialize file orchestrator (but don't watch)\n    await filesOrchestrator.init();\n    await filesOrchestrator.initializeAll();\n\n    // Load config files\n    await loadConfigFiles(true);\n\n    // Early-phase connectors (database, cache, logger, storage, mailer,\n    // herald) must start BEFORE app modules load: a module's `main.ts` boot\n    // side-effect can query the DB at import time, so the data source has to\n    // be registered first. This mirrors the dev/prod boot order (see\n    // `cli-commands.manager`, `production-builder`, and `DevelopmentServer`).\n    if (options.web === false) {\n      await startTestServerPhase(ConnectorLifecyclePhase.Early);\n    } else {\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\n    }\n\n    // Fakes before app modules load, so module boot code already sees them.\n    await installTestFakes(options.fakes);\n\n    // Load application modules (their boot side-effects now see a live DB).\n    await filesOrchestrator.moduleLoader.loadAll();\n\n    const portMode = await applyTestServerPort(options.port);\n    const readyReportBefore = getHttpReadyReport();\n\n    // A rejecting validator (Application.onValidateBoot) must abort boot\n    // before late-phase connectors bind a port — same slot as\n    // `DevelopmentServer.start()` and the generated production `app.ts`.\n    await Application.runStartupValidators();\n\n    // Late-phase connectors (http, socket) bind after app code has\n    // registered its routes and listeners.\n    if (options.web === false) {\n      await startTestServerPhase(ConnectorLifecyclePhase.Late);\n    } else {\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\n    }\n\n    if (portMode === \"ephemeral\") {\n      publishEphemeralPort(readyReportBefore);\n    }\n\n    isServerRunning = true;\n  } catch (error) {\n    // This function owns the connectors it starts, so a failure part-way\n    // through has to leave nothing behind. Without this, `isServerRunning` was\n    // still `false` — it is only set on the last line — so `globalTeardown`'s\n    // `stopHttpTestServer()` reported \"No server to stop\" and walked away from\n    // live early-phase connectors and a published port that outlived them.\n    await unwindPartialStartup();\n\n    // Rethrown unchanged: the startup failure is the one the caller needs to\n    // read. A cleanup failure that replaced it would hide the actual cause.\n    throw error;\n  }\n}\n\n/**\n * Best-effort teardown of whatever a failed {@link startHttpTestServer} managed\n * to start.\n *\n * Every step is independent and none may throw: this runs while an error is\n * already in flight, and the caller is about to rethrow it.\n */\nasync function unwindPartialStartup(): Promise<void> {\n  try {\n    await restoreTestFakes();\n  } catch (fakesError) {\n    console.error(\n      \"[test-server] Restoring the test fakes after a failed start did not complete:\",\n      fakesError,\n    );\n  }\n\n  try {\n    await connectorsManager.shutdown();\n  } catch (shutdownError) {\n    // Reported, not thrown — it is secondary to the startup error being\n    // rethrown, and losing that one to this would be the worse outcome.\n    console.error(\"[test-server] Cleanup after a failed start did not complete:\", shutdownError);\n  }\n\n  withdrawTestServerPort();\n  isServerRunning = false;\n}\n\n/**\n * Stop the HTTP test server\n * Call this in Vitest's globalTeardown\n */\nexport async function stopHttpTestServer(): Promise<void> {\n  if (!isServerRunning) {\n    console.log(\"[test-server] No server to stop\");\n    return;\n  }\n\n  try {\n    try {\n      await restoreTestFakes();\n    } catch (fakesError) {\n      console.error(\"[test-server] Restoring the test fakes did not complete:\", fakesError);\n    }\n\n    await connectorsManager.shutdown();\n\n    console.log(\"[test-server] HTTP test server stopped\");\n  } catch (error) {\n    // Surfaced, never swallowed — cleaning up is not the same as the shutdown\n    // having succeeded, and a suite whose teardown failed should say so.\n    console.error(\"[test-server] Error stopping HTTP server:\", error);\n\n    throw error;\n  } finally {\n    // In a `finally` rather than after the `await`: when `shutdown()` threw,\n    // the published port survived the server it pointed at, so the next run in\n    // the same process inherited a stale one and sent every request to it.\n    withdrawTestServerPort();\n\n    isServerRunning = false;\n  }\n}\n\n/**\n * Check if test server is running\n */\nexport function isTestServerRunning(): boolean {\n  return isServerRunning;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAI,kBAAkB;;;;;;;;AA+CtB,eAAe,qBAAqB,OAA+C;CACjF,MAAM,aAAa,kBAChB,KAAK,CAAC,CACN,QAAQ,cAAc,UAAU,mBAAmB,KAAK,CAAC,CACzD,QAAQ,cAAc,UAAU,SAAS,KAAK;CAEjD,KAAK,MAAM,aAAa,YACtB,MAAM,UAAU,KAAK;CAGvB,KAAK,MAAM,aAAa,YACtB,MAAM,UAAU,MAAM;AAE1B;;;;;;;;;;;;AAaA,eAAe,oBAAoB,MAA4D;CAG7F,IAAI,CAFeA,WAAO,IAAI,MAEhB,GAAG;EACf,IAAI,SAAS,QACX,MAAM,IAAI,MACR,+BAA+B,KAAK,2HACtC;EAGF,OAAO;CACT;CAEA,IAAI,SAAS,QACX,WAAO,IAAI,aAAa,IAAI;CAG9B,MAAM,eAAeA,WAAO,IAAI,WAAW;CAa3C,IAAI,OAAO,iBAAiB,UAC1B,MAAM,IAAI,MACR,wDAAwD,KAAK,UAAU,YAAY,EAAE,sRACvF;CAQF,IAAI,iBAAiB,GACnB,OAAO;CAGT,IAAI,eAAe,GACjB,MAAM,IAAI,MACR,4CAA4C,aAAa,kGAC3D;CAGF,MAAM,sBAAsB,cAAcA,WAAO,IAAI,WAAW,KAAK,WAAW;CAEhF,sBAAsB,YAAY;CAElC,OAAO;AACT;;;;;;;;AASA,SAAS,qBAAqB,QAAqD;CACjF,MAAM,SAAS,mBAAmB;CAElC,IAAI,CAAC,UAAU,WAAW,UAAU,OAAO,QAAQ,GACjD,MAAM,IAAI,MACR,+OACF;CAGF,sBAAsB,OAAO,IAAI;AACnC;;;;;;;;;;;;;AAcA,eAAsB,oBAAoB,UAAsC,CAAC,GAAkB;CACjG,MAAM,kBAAkB,QAAQ,IAAI;CAEpC,IAAI,oBAAoB,QACtB,QAAQ,IAAI,WAAW;MAClB,IAAI,oBAAoB,QAC7B,MAAM,IAAI,MACR,yEAAyE,KAAK,UAAU,eAAe,EAAE,qDAC3G;CAGF,IAAI,iBAAiB;EACnB,QAAQ,IAAI,sDAAsD;EAClE;CACF;CAEA,QAAQ,IAAI,4CAA4C;CAExD,IAAI;EAGF,MAAM,qBAAqB;EAG3B,YAAY,mBAAmB,aAAa;EAC5C,YAAY,eAAe,MAAM;EAGjC,MAAM,qBAAqB,KAAK;EAChC,MAAM,UAAU;EAGhB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,kBAAkB,cAAc;EAGtC,MAAM,gBAAgB,IAAI;EAO1B,IAAI,QAAQ,QAAQ,OAClB,MAAM,4BAAkD;OAExD,MAAM,kBAAkB,kBAAwC;EAIlE,MAAM,iBAAiB,QAAQ,KAAK;EAGpC,MAAM,kBAAkB,aAAa,QAAQ;EAE7C,MAAM,WAAW,MAAM,oBAAoB,QAAQ,IAAI;EACvD,MAAM,oBAAoB,mBAAmB;EAK7C,MAAM,YAAY,qBAAqB;EAIvC,IAAI,QAAQ,QAAQ,OAClB,MAAM,2BAAiD;OAEvD,MAAM,kBAAkB,iBAAuC;EAGjE,IAAI,aAAa,aACf,qBAAqB,iBAAiB;EAGxC,kBAAkB;CACpB,SAAS,OAAO;EAMd,MAAM,qBAAqB;EAI3B,MAAM;CACR;AACF;;;;;;;;AASA,eAAe,uBAAsC;CACnD,IAAI;EACF,MAAM,iBAAiB;CACzB,SAAS,YAAY;EACnB,QAAQ,MACN,iFACA,UACF;CACF;CAEA,IAAI;EACF,MAAM,kBAAkB,SAAS;CACnC,SAAS,eAAe;EAGtB,QAAQ,MAAM,gEAAgE,aAAa;CAC7F;CAEA,uBAAuB;CACvB,kBAAkB;AACpB;;;;;AAMA,eAAsB,qBAAoC;CACxD,IAAI,CAAC,iBAAiB;EACpB,QAAQ,IAAI,iCAAiC;EAC7C;CACF;CAEA,IAAI;EACF,IAAI;GACF,MAAM,iBAAiB;EACzB,SAAS,YAAY;GACnB,QAAQ,MAAM,4DAA4D,UAAU;EACtF;EAEA,MAAM,kBAAkB,SAAS;EAEjC,QAAQ,IAAI,wCAAwC;CACtD,SAAS,OAAO;EAGd,QAAQ,MAAM,6CAA6C,KAAK;EAEhE,MAAM;CACR,UAAU;EAIR,uBAAuB;EAEvB,kBAAkB;CACpB;AACF;;;;AAKA,SAAgB,sBAA+B;CAC7C,OAAO;AACT"}

package/esm/tests/test-connectors-selection.d.mts

@@ -1,4 +1,5 @@
 import { ConnectorName } from "../connectors/types.mjs";
+import "../connectors/index.mjs";
 //#region ../../packages/core/src/tests/test-connectors-selection.d.ts
 /**
  * What a test runtime was asked to start.
@@ -8,7 +9,6 @@ import { ConnectorName } from "../connectors/types.mjs";
  * - an array — start exactly those. Order is not promised; lifecycle priority
  *   decides the real boot/shutdown order.
  */
-type TestConnectorsSelection = boolean | ConnectorName[];
+export type TestConnectorsSelection = boolean | ConnectorName[];
 //#endregion
-export { TestConnectorsSelection };
 //# sourceMappingURL=test-connectors-selection.d.mts.map

package/esm/tests/test-connectors-selection.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test-connectors-selection.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/test-connectors-selection.ts"],"mappings":";;;;;AAqBA;;;;AAA6D;KAAjD,uBAAA,aAAoC,aAAa"}
+{"version":3,"file":"test-connectors-selection.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/test-connectors-selection.ts"],"mappings":";;;;;;;;;;;YAqBY,oCAAoC"}

package/esm/tests/test-connectors-selection.mjs

@@ -68,5 +68,5 @@ function describeConnectorsSelection(selection) {
 }
 
 //#endregion
-export { describeConnectorsSelection, isSameConnectorsSelection, normalizeConnectorNames, readRequestedConnectors, resolveEffectiveConnectors };
+export { describeConnectorsSelection, isSameConnectorsSelection, normalizeConnectorNames, readConfiguredConnectors, readRequestedConnectors, resolveEffectiveConnectors };
 //# sourceMappingURL=test-connectors-selection.mjs.map

package/esm/tests/test-helpers.d.mts

@@ -7,14 +7,14 @@
 /**
  * Get the test server base URL
  */
-declare function getTestServerUrl(): string;
+export declare function getTestServerUrl(): string;
 /**
  * Simple HTTP request helper for test server
  * Uses native fetch - lightweight, no extra dependencies
  */
-declare function testRequest(path: string, options?: RequestInit): Promise<Response>;
+export declare function testRequest(path: string, options?: RequestInit): Promise<Response>;
 /** The request helpers, bound to one server. */
-type TestRequestClient = {
+export type TestRequestClient = {
   request(path: string, options?: RequestInit): Promise<Response>;
   get(path: string, options?: RequestInit): Promise<Response>;
   post(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
@@ -31,35 +31,34 @@ type TestRequestClient = {
  * const client = createTestRequestClient("http://127.0.0.1:4100");
  * await client.post("/posts", { title: "Hello" });
  */
-declare function createTestRequestClient(baseUrl: string | (() => string)): TestRequestClient;
+export declare function createTestRequestClient(baseUrl: string | (() => string)): TestRequestClient;
 /**
  * GET request helper
  */
-declare function testGet(path: string, options?: RequestInit): Promise<Response>;
+export declare function testGet(path: string, options?: RequestInit): Promise<Response>;
 /**
  * POST request helper
  */
-declare function testPost(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
+export declare function testPost(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
 /**
  * PUT request helper
  */
-declare function testPut(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
+export declare function testPut(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
 /**
  * DELETE request helper
  */
-declare function testDelete(path: string, options?: RequestInit): Promise<Response>;
+export declare function testDelete(path: string, options?: RequestInit): Promise<Response>;
 /**
  * PATCH request helper
  */
-declare function testPatch(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
+export declare function testPatch(path: string, body?: unknown, options?: RequestInit): Promise<Response>;
 /**
  * Parse JSON response with type safety
  */
-declare function parseJsonResponse<T>(response: Response): Promise<T>;
+export declare function parseJsonResponse<T>(response: Response): Promise<T>;
 /**
  * Assert response status and return parsed JSON
  */
-declare function expectJson<T>(response: Response, expectedStatus?: number): Promise<T>;
+export declare function expectJson<T>(response: Response, expectedStatus?: number): Promise<T>;
 //#endregion
-export { TestRequestClient, createTestRequestClient, expectJson, getTestServerUrl, parseJsonResponse, testDelete, testGet, testPatch, testPost, testPut, testRequest };
 //# sourceMappingURL=test-helpers.d.mts.map

package/esm/tests/test-helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/test-helpers.ts"],"mappings":";;AAaA;;;;AAAgC;AA6BhC;;AA7BgC,iBAAhB,gBAAA;;;;;iBA6BM,WAAA,CAAY,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;KA8CxE,iBAAA;EACV,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,QAAA;EACtD,GAAA,CAAI,IAAA,UAAc,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,QAAA;EAClD,IAAA,CAAK,IAAA,UAAc,IAAA,YAAgB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,QAAA;EACnE,GAAA,CAAI,IAAA,UAAc,IAAA,YAAgB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,QAAA;EAClE,KAAA,CAAM,IAAA,UAAc,IAAA,YAAgB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,QAAA;EACpE,MAAA,CAAO,IAAA,UAAc,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,QAAA;AAAA;;;;;;;;;;iBAYvC,uBAAA,CAAwB,OAAA,4BAAmC,iBAAiB;;;;iBAqBtE,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;;iBAO1D,QAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAOW,OAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAOW,UAAA,CAAW,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;;iBAO7D,SAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAOW,iBAAA,IAAqB,QAAA,EAAU,QAAA,GAAW,OAAA,CAAQ,CAAA;;;;iBAOlD,UAAA,IAAc,QAAA,EAAU,QAAA,EAAU,cAAA,YAAuB,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"test-helpers.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/test-helpers.ts"],"mappings":";;;;;;;;;wBAagB;;;;;wBA6BM,YAAY,cAAc,UAAS,cAAmB,QAAQ;;YA8CxE;EACV,QAAQ,cAAc,UAAU,cAAc,QAAQ;EACtD,IAAI,cAAc,UAAU,cAAc,QAAQ;EAClD,KAAK,cAAc,gBAAgB,UAAU,cAAc,QAAQ;EACnE,IAAI,cAAc,gBAAgB,UAAU,cAAc,QAAQ;EAClE,MAAM,cAAc,gBAAgB,UAAU,cAAc,QAAQ;EACpE,OAAO,cAAc,UAAU,cAAc,QAAQ;;;;;;;;;;;wBAYvC,wBAAwB,mCAAmC;;;;wBAqBrD,QAAQ,cAAc,UAAS,cAAmB,QAAQ;;;;wBAO1D,SACpB,cACA,gBACA,UAAS,cACR,QAAQ;;;;wBAOW,QACpB,cACA,gBACA,UAAS,cACR,QAAQ;;;;wBAOW,WAAW,cAAc,UAAS,cAAmB,QAAQ;;;;wBAO7D,UACpB,cACA,gBACA,UAAS,cACR,QAAQ;;;;wBAOW,kBAAkB,GAAG,UAAU,WAAW,QAAQ;;;;wBAOlD,WAAW,GAAG,UAAU,UAAU,0BAAuB,QAAQ"}

package/esm/tests/test-http-server.d.mts

@@ -3,9 +3,8 @@ import { Router } from "../router/router.mjs";
 import { TestRequestClient } from "./test-helpers.mjs";
 import { AuthenticatedTestClient, TestAuthenticableUser } from "./authenticated-test-client.mjs";
 import { AppModuleImporter } from "../loader/app-module-importer.mjs";
-
 //#region ../../packages/core/src/tests/test-http-server.d.ts
-type CreateTestHttpServerOptions = {
+export type CreateTestHttpServerOptions = {
   /**
    * Register routes for this server, exactly as a `routes.ts` would. They are
    * tagged with a source of their own and removed again by `close()`.
@@ -22,14 +21,20 @@ type CreateTestHttpServerOptions = {
    * `(file) => import(file)` from the test file, as `setupTest()` takes it, so
    * app classes are the same ones the test imports.
    */
-  importModule?: AppModuleImporter; /** Interface to bind. Defaults to `127.0.0.1`. */
+  importModule?: AppModuleImporter;
+  /** Interface to bind. Defaults to `127.0.0.1`. */
   host?: string;
 };
-type TestHttpServer = TestRequestClient & {
-  /** `http://127.0.0.1:<port>` */readonly url: string; /** The port the OS assigned. */
-  readonly port: number; /** The Fastify instance, for `inject()` or anything else Fastify offers. */
-  readonly server: FastifyInstance; /** A client for this server, signed in as `user` with a real access token. */
-  actingAs(user: TestAuthenticableUser): Promise<AuthenticatedTestClient>; /** Stop listening and remove the routes `routes` registered. */
+export type TestHttpServer = TestRequestClient & {
+  /** `http://127.0.0.1:<port>` */
+  readonly url: string;
+  /** The port the OS assigned. */
+  readonly port: number;
+  /** The Fastify instance, for `inject()` or anything else Fastify offers. */
+  readonly server: FastifyInstance;
+  /** A client for this server, signed in as `user` with a real access token. */
+  actingAs(user: TestAuthenticableUser): Promise<AuthenticatedTestClient>;
+  /** Stop listening and remove the routes `routes` registered. */
   close(): Promise<void>;
 };
 /**
@@ -56,7 +61,6 @@ type TestHttpServer = TestRequestClient & {
  * await app.post("/contact", { email: "ada@example.test", message: "Hi" });
  * mailFake.assertSent({ to: "support@example.test" });
  */
-declare function createTestHttpServer(options?: CreateTestHttpServerOptions): Promise<TestHttpServer>;
+export declare function createTestHttpServer(options?: CreateTestHttpServerOptions): Promise<TestHttpServer>;
 //#endregion
-export { CreateTestHttpServerOptions, TestHttpServer, createTestHttpServer };
 //# sourceMappingURL=test-http-server.d.mts.map

package/esm/tests/test-http-server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test-http-server.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/test-http-server.ts"],"mappings":";;;;;;;KA+BY,2BAAA;;AAAZ;;;EAKE,MAAA,IAAU,MAAA,EAAQ,MAAA;EAAlB;;;;;EAMA,cAAA;EAQA;;AAAI;AAGN;;EALE,YAAA,GAAe,iBAAiB,EAKL;EAH3B,IAAA;AAAA;AAAA,KAGU,cAAA,GAAiB,iBAAA;EAQY,yCAN9B,GAAA,UAQO;EAAA,SANP,IAAA,UAJkB;EAAA,SAMlB,MAAA,EAAQ,eAAA,EAFR;EAIT,QAAA,CAAS,IAAA,EAAM,qBAAA,GAAwB,OAAA,CAAQ,uBAAA,GAF9B;EAIjB,KAAA,IAAS,OAAA;AAAA;;;;;;;AAAO;AAmElB;;;;;;;;;;;;;AAEyB;;;;iBAFH,oBAAA,CACpB,OAAA,GAAS,2BAAA,GACR,OAAA,CAAQ,cAAA"}
+{"version":3,"file":"test-http-server.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/test-http-server.ts"],"mappings":";;;;;;YA+BY;;;;;EAKV,UAAU,QAAQ;;;;;;EAMlB;;;;;;EAMA,eAAe;;EAEf;;YAGU,iBAAiB;;WAElB;;WAEA;;WAEA,QAAQ;;EAEjB,SAAS,MAAM,wBAAwB,QAAQ;;EAE/C,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmEW,qBACpB,UAAS,8BACR,QAAQ"}

package/esm/tests/test-lifecycle-state.mjs

@@ -23,5 +23,5 @@ function getTestLifecycleRegistry() {
 }
 
 //#endregion
-export { getTestLifecycleRegistry };
+export { TEST_LIFECYCLE_REGISTRY_KEY, getTestLifecycleRegistry };
 //# sourceMappingURL=test-lifecycle-state.mjs.map

package/esm/tests/vitest-setup.d.mts

@@ -1,9 +1,8 @@
 import { TestFakesSelection } from "./fakes/test-fakes.mjs";
 import { AppModuleImporter } from "../loader/app-module-importer.mjs";
 import { TestConnectorsSelection } from "./test-connectors-selection.mjs";
-
 //#region ../../packages/core/src/tests/vitest-setup.d.ts
-type TestSetupOptions = {
+export type TestSetupOptions = {
   /**
    * Which connectors to start.
    *
@@ -25,7 +24,7 @@ type TestSetupOptions = {
   importModule?: AppModuleImporter;
   /**
    * Which test fakes to install once the connectors are up: mail, queue,
-   * cache, storage, clock and ids (see `installTestFakes`).
+   * cache, storage, clock, ids and secrets (see `installTestFakes`).
    *
    * Precedence is `explicit option > tests.fakes config > true`, so every fake
    * is on unless the project or this call opts out. `false` keeps the real
@@ -37,12 +36,12 @@ type TestSetupOptions = {
 /**
  * Warn — once per process — that app modules are loaded outside Vitest's graph.
  */
-declare function warnMissingImportModule(importModule: AppModuleImporter | undefined): void;
+export declare function warnMissingImportModule(importModule: AppModuleImporter | undefined): void;
 /**
  * Raised by the lifecycle itself, never by the runtime it manages — a conflict
  * between two calls, or a refusal to reuse a runtime that did not close.
  */
-declare class TestLifecycleError extends Error {
+export declare class TestLifecycleError extends Error {
   constructor(message: string);
 }
 /**
@@ -72,7 +71,7 @@ declare class TestLifecycleError extends Error {
  * // bootstrap only — no connectors, whatever config says
  * await setupTest({ connectors: false });
  */
-declare function setupTest(options?: TestSetupOptions): Promise<void>;
+export declare function setupTest(options?: TestSetupOptions): Promise<void>;
 /**
  * Shut the test runtime down and release the lifecycle.
  *
@@ -90,7 +89,7 @@ declare function setupTest(options?: TestSetupOptions): Promise<void>;
  * `connectorsManager.shutdown()`, so they never reach this function and never
  * poison anything. This lifecycle can only surface what that layer reports.
  */
-declare function teardownTest(): Promise<void>;
+export declare function teardownTest(): Promise<void>;
 //#endregion
-export { TestLifecycleError, TestSetupOptions, setupTest, teardownTest, warnMissingImportModule };
+export type { TestConnectorsSelection };
 //# sourceMappingURL=vitest-setup.d.mts.map

package/esm/tests/vitest-setup.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-setup.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/vitest-setup.ts"],"mappings":";;;;;KAqDY,gBAAA;EAAA;;;;;;;;EASV,UAAA,GAAa,uBAAA;EAAA;;;;;;AAoBa;AAQ5B;;EAlBE,YAAA,GAAe,iBAAA;EAkBqC;AAA6B;AAkBnF;;;;;;;EA1BE,KAAA,GAAQ,kBAAA;AAAA;AAgEV;;;AAAA,iBAxDgB,uBAAA,CAAwB,YAA2C,EAA7B,iBAAiB;;;;;cAkB1D,kBAAA,SAA2B,KAAK;cACxB,OAAA;AAAA;;;AA+FwB;;;;;;;;;;;;;;;;;;;;;;;;;iBA1DvB,SAAA,CAAU,OAAA,GAAU,gBAAA,GAAmB,OAAO;;;;;;;;;;;;;;;;;;iBA0D9C,YAAA,IAAgB,OAAO"}
+{"version":3,"file":"vitest-setup.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/vitest-setup.ts"],"mappings":";;;;YAqDY;;;;;;;;;EASV,aAAa;;;;;;;;;;EAUb,eAAe;;;;;;;;;;EAUf,QAAQ;;;;;wBAQM,wBAAwB,cAAc;;;;;qBAkBzC,2BAA2B;EACtC,YAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqCC,UAAU,UAAU,mBAAmB;;;;;;;;;;;;;;;;;;wBA0DvC,gBAAgB"}