@warlock.js/core 5.31.0 → 5.32.0

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

@@ -63,7 +63,7 @@ function resolveTestFakes(explicit) {
 async function installTestFakes(explicit) {
 	const selected = resolveTestFakes(explicit);
 	for (const name of selected) await fakes[name].install();
-	active = [...new Set([...active, ...selected])];
+	active = [.../* @__PURE__ */ new Set([...active, ...selected])];
 	return selected;
 }
 /**

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 { 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,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,6 +12,7 @@ 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 "./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";

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":"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"}

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.
    *
@@ -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"}

package/esm/tooling/agents-md/agents-md-markers.d.mts

@@ -1,10 +1,10 @@
 //#region ../../packages/core/src/tooling/agents-md/agents-md-markers.d.ts
 /** The file `warlock agents-md --write` and `warlock dev` maintain, at the project root. */
-declare const AGENTS_MD_FILE = "AGENTS.md";
+export declare const AGENTS_MD_FILE = "AGENTS.md";
 /** Opens the generated section. Everything outside the two markers is hand-written. */
-declare const AGENTS_MD_START = "<!-- warlock:generated:start -->";
+export declare const AGENTS_MD_START = "<!-- warlock:generated:start -->";
 /** Closes the generated section. */
-declare const AGENTS_MD_END = "<!-- warlock:generated:end -->";
+export declare const AGENTS_MD_END = "<!-- warlock:generated:end -->";
 /**
  * Put `section` between the generated-section markers of `existing`.
  *
@@ -21,7 +21,6 @@ declare const AGENTS_MD_END = "<!-- warlock:generated:end -->";
  * @param existing The current file content, or `undefined` when the file does not exist.
  * @param section The generated markdown, without markers.
  */
-declare function upsertGeneratedSection(existing: string | undefined, section: string): string;
+export declare function upsertGeneratedSection(existing: string | undefined, section: string): string;
 //#endregion
-export { AGENTS_MD_END, AGENTS_MD_FILE, AGENTS_MD_START, upsertGeneratedSection };
 //# sourceMappingURL=agents-md-markers.d.mts.map

package/esm/tooling/agents-md/agents-md-markers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md-markers.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/agents-md-markers.ts"],"mappings":";;cAGa,cAAA;;cAGA,eAAA;;cAGA,aAAA;AAHb;;;;AAA4B;AAG5B;;;;AAA0B;AAoC1B;;;;AAAoF;;AAvCpF,iBAuCgB,sBAAA,CAAuB,QAAA,sBAA8B,OAAe"}
+{"version":3,"file":"agents-md-markers.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/agents-md-markers.ts"],"mappings":";;qBAGa;;qBAGA;;qBAGA;;;;;;;;;;;;;;;;;wBAoCG,uBAAuB,8BAA8B"}

package/esm/tooling/agents-md/agents-md-markers.mjs

@@ -39,7 +39,8 @@ function lineBreakOf(text) {
 */
 function upsertGeneratedSection(existing, section) {
 	const eol = existing === void 0 ? "\n" : lineBreakOf(existing);
-	const block = `${AGENTS_MD_START}${eol}${section.replace(/\r?\n/g, eol).replace(/(?:\r?\n)+$/, "")}${eol}${AGENTS_MD_END}`;
+	const body = section.replace(/\r?\n/g, eol).replace(/(?:\r?\n)+$/, "");
+	const block = `${AGENTS_MD_START}${eol}${body}${eol}${AGENTS_MD_END}`;
 	if (existing === void 0) return `${block}${eol}`;
 	const starts = occurrences(existing, AGENTS_MD_START);
 	const ends = occurrences(existing, AGENTS_MD_END);

package/esm/tooling/agents-md/agents-md-markers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md-markers.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/agents-md-markers.ts"],"sourcesContent":["import { WarlockError } from \"../../errors/warlock-error\";\n\n/** The file `warlock agents-md --write` and `warlock dev` maintain, at the project root. */\nexport const AGENTS_MD_FILE = \"AGENTS.md\";\n\n/** Opens the generated section. Everything outside the two markers is hand-written. */\nexport const AGENTS_MD_START = \"<!-- warlock:generated:start -->\";\n\n/** Closes the generated section. */\nexport const AGENTS_MD_END = \"<!-- warlock:generated:end -->\";\n\n/** Every index at which `needle` occurs in `text`. */\nfunction occurrences(text: string, needle: string): number[] {\n  const found: number[] = [];\n  let index = text.indexOf(needle);\n\n  while (index !== -1) {\n    found.push(index);\n    index = text.indexOf(needle, index + needle.length);\n  }\n\n  return found;\n}\n\n/** The line break the file already uses, so an inserted section matches it. */\nfunction lineBreakOf(text: string): string {\n  return text.includes(\"\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n}\n\n/**\n * Put `section` between the generated-section markers of `existing`.\n *\n * - `existing` undefined (no file): the markers and the section, alone.\n * - no markers: the existing text unchanged, then a blank line, then the\n *   markers and the section at the end.\n * - one start marker followed by one end marker: only the bytes between them\n *   are replaced; the markers and everything outside them stay byte-for-byte.\n *\n * Throws `WL7501` when the markers are malformed (one without the other, a\n * duplicate, or the end before the start) — rather than guess which part is\n * hand-written.\n *\n * @param existing The current file content, or `undefined` when the file does not exist.\n * @param section The generated markdown, without markers.\n */\nexport function upsertGeneratedSection(existing: string | undefined, section: string): string {\n  const eol = existing === undefined ? \"\\n\" : lineBreakOf(existing);\n  const body = section.replace(/\\r?\\n/g, eol).replace(/(?:\\r?\\n)+$/, \"\");\n  const block = `${AGENTS_MD_START}${eol}${body}${eol}${AGENTS_MD_END}`;\n\n  if (existing === undefined) return `${block}${eol}`;\n\n  const starts = occurrences(existing, AGENTS_MD_START);\n  const ends = occurrences(existing, AGENTS_MD_END);\n\n  if (starts.length === 0 && ends.length === 0) {\n    if (existing.length === 0) return `${block}${eol}`;\n\n    const separator = existing.endsWith(eol) ? eol : `${eol}${eol}`;\n\n    return `${existing}${separator}${block}${eol}`;\n  }\n\n  const [start] = starts;\n  const [end] = ends;\n\n  if (starts.length !== 1 || ends.length !== 1 || start === undefined || end === undefined) {\n    throw new WarlockError(\n      \"WL7501\",\n      `AGENTS.md has ${starts.length} \"${AGENTS_MD_START}\" and ${ends.length} \"${AGENTS_MD_END}\" marker(s); expected exactly one of each. Fix the markers by hand — nothing was written.`,\n    );\n  }\n\n  if (end < start) {\n    throw new WarlockError(\n      \"WL7501\",\n      `AGENTS.md has \"${AGENTS_MD_END}\" before \"${AGENTS_MD_START}\". Fix the markers by hand — nothing was written.`,\n    );\n  }\n\n  return `${existing.slice(0, start)}${block}${existing.slice(end + AGENTS_MD_END.length)}`;\n}\n"],"mappings":";;;;AAGA,MAAa,iBAAiB;;AAG9B,MAAa,kBAAkB;;AAG/B,MAAa,gBAAgB;;AAG7B,SAAS,YAAY,MAAc,QAA0B;CAC3D,MAAM,QAAkB,CAAC;CACzB,IAAI,QAAQ,KAAK,QAAQ,MAAM;CAE/B,OAAO,UAAU,IAAI;EACnB,MAAM,KAAK,KAAK;EAChB,QAAQ,KAAK,QAAQ,QAAQ,QAAQ,OAAO,MAAM;CACpD;CAEA,OAAO;AACT;;AAGA,SAAS,YAAY,MAAsB;CACzC,OAAO,KAAK,SAAS,MAAM,IAAI,SAAS;AAC1C;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAAuB,UAA8B,SAAyB;CAC5F,MAAM,MAAM,aAAa,SAAY,OAAO,YAAY,QAAQ;CAEhE,MAAM,QAAQ,GAAG,kBAAkB,MADtB,QAAQ,QAAQ,UAAU,GAAG,CAAC,CAAC,QAAQ,eAAe,EACvB,IAAI,MAAM;CAEtD,IAAI,aAAa,QAAW,OAAO,GAAG,QAAQ;CAE9C,MAAM,SAAS,YAAY,UAAU,eAAe;CACpD,MAAM,OAAO,YAAY,UAAU,aAAa;CAEhD,IAAI,OAAO,WAAW,KAAK,KAAK,WAAW,GAAG;EAC5C,IAAI,SAAS,WAAW,GAAG,OAAO,GAAG,QAAQ;EAI7C,OAAO,GAAG,WAFQ,SAAS,SAAS,GAAG,IAAI,MAAM,GAAG,MAAM,QAEzB,QAAQ;CAC3C;CAEA,MAAM,CAAC,SAAS;CAChB,MAAM,CAAC,OAAO;CAEd,IAAI,OAAO,WAAW,KAAK,KAAK,WAAW,KAAK,UAAU,UAAa,QAAQ,QAC7E,MAAM,IAAI,aACR,UACA,iBAAiB,OAAO,OAAO,IAAI,gBAAgB,QAAQ,KAAK,OAAO,IAAI,cAAc,0FAC3F;CAGF,IAAI,MAAM,OACR,MAAM,IAAI,aACR,UACA,kBAAkB,cAAc,YAAY,gBAAgB,kDAC9D;CAGF,OAAO,GAAG,SAAS,MAAM,GAAG,KAAK,IAAI,QAAQ,SAAS,MAAM,MAAM,EAAoB;AACxF"}
+{"version":3,"file":"agents-md-markers.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/agents-md-markers.ts"],"sourcesContent":["import { WarlockError } from \"../../errors/warlock-error\";\n\n/** The file `warlock agents-md --write` and `warlock dev` maintain, at the project root. */\nexport const AGENTS_MD_FILE = \"AGENTS.md\";\n\n/** Opens the generated section. Everything outside the two markers is hand-written. */\nexport const AGENTS_MD_START = \"<!-- warlock:generated:start -->\";\n\n/** Closes the generated section. */\nexport const AGENTS_MD_END = \"<!-- warlock:generated:end -->\";\n\n/** Every index at which `needle` occurs in `text`. */\nfunction occurrences(text: string, needle: string): number[] {\n  const found: number[] = [];\n  let index = text.indexOf(needle);\n\n  while (index !== -1) {\n    found.push(index);\n    index = text.indexOf(needle, index + needle.length);\n  }\n\n  return found;\n}\n\n/** The line break the file already uses, so an inserted section matches it. */\nfunction lineBreakOf(text: string): string {\n  return text.includes(\"\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n}\n\n/**\n * Put `section` between the generated-section markers of `existing`.\n *\n * - `existing` undefined (no file): the markers and the section, alone.\n * - no markers: the existing text unchanged, then a blank line, then the\n *   markers and the section at the end.\n * - one start marker followed by one end marker: only the bytes between them\n *   are replaced; the markers and everything outside them stay byte-for-byte.\n *\n * Throws `WL7501` when the markers are malformed (one without the other, a\n * duplicate, or the end before the start) — rather than guess which part is\n * hand-written.\n *\n * @param existing The current file content, or `undefined` when the file does not exist.\n * @param section The generated markdown, without markers.\n */\nexport function upsertGeneratedSection(existing: string | undefined, section: string): string {\n  const eol = existing === undefined ? \"\\n\" : lineBreakOf(existing);\n  const body = section.replace(/\\r?\\n/g, eol).replace(/(?:\\r?\\n)+$/, \"\");\n  const block = `${AGENTS_MD_START}${eol}${body}${eol}${AGENTS_MD_END}`;\n\n  if (existing === undefined) return `${block}${eol}`;\n\n  const starts = occurrences(existing, AGENTS_MD_START);\n  const ends = occurrences(existing, AGENTS_MD_END);\n\n  if (starts.length === 0 && ends.length === 0) {\n    if (existing.length === 0) return `${block}${eol}`;\n\n    const separator = existing.endsWith(eol) ? eol : `${eol}${eol}`;\n\n    return `${existing}${separator}${block}${eol}`;\n  }\n\n  const [start] = starts;\n  const [end] = ends;\n\n  if (starts.length !== 1 || ends.length !== 1 || start === undefined || end === undefined) {\n    throw new WarlockError(\n      \"WL7501\",\n      `AGENTS.md has ${starts.length} \"${AGENTS_MD_START}\" and ${ends.length} \"${AGENTS_MD_END}\" marker(s); expected exactly one of each. Fix the markers by hand — nothing was written.`,\n    );\n  }\n\n  if (end < start) {\n    throw new WarlockError(\n      \"WL7501\",\n      `AGENTS.md has \"${AGENTS_MD_END}\" before \"${AGENTS_MD_START}\". Fix the markers by hand — nothing was written.`,\n    );\n  }\n\n  return `${existing.slice(0, start)}${block}${existing.slice(end + AGENTS_MD_END.length)}`;\n}\n"],"mappings":";;;;AAGA,MAAa,iBAAiB;;AAG9B,MAAa,kBAAkB;;AAG/B,MAAa,gBAAgB;;AAG7B,SAAS,YAAY,MAAc,QAA0B;CAC3D,MAAM,QAAkB,CAAC;CACzB,IAAI,QAAQ,KAAK,QAAQ,MAAM;CAE/B,OAAO,UAAU,IAAI;EACnB,MAAM,KAAK,KAAK;EAChB,QAAQ,KAAK,QAAQ,QAAQ,QAAQ,OAAO,MAAM;CACpD;CAEA,OAAO;AACT;;AAGA,SAAS,YAAY,MAAsB;CACzC,OAAO,KAAK,SAAS,MAAM,IAAI,SAAS;AAC1C;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAAuB,UAA8B,SAAyB;CAC5F,MAAM,MAAM,aAAa,SAAY,OAAO,YAAY,QAAQ;CAChE,MAAM,OAAO,QAAQ,QAAQ,UAAU,GAAG,CAAC,CAAC,QAAQ,eAAe,EAAE;CACrE,MAAM,QAAQ,GAAG,kBAAkB,MAAM,OAAO,MAAM;CAEtD,IAAI,aAAa,QAAW,OAAO,GAAG,QAAQ;CAE9C,MAAM,SAAS,YAAY,UAAU,eAAe;CACpD,MAAM,OAAO,YAAY,UAAU,aAAa;CAEhD,IAAI,OAAO,WAAW,KAAK,KAAK,WAAW,GAAG;EAC5C,IAAI,SAAS,WAAW,GAAG,OAAO,GAAG,QAAQ;EAI7C,OAAO,GAAG,WAFQ,SAAS,SAAS,GAAG,IAAI,MAAM,GAAG,MAAM,QAEzB,QAAQ;CAC3C;CAEA,MAAM,CAAC,SAAS;CAChB,MAAM,CAAC,OAAO;CAEd,IAAI,OAAO,WAAW,KAAK,KAAK,WAAW,KAAK,UAAU,UAAa,QAAQ,QAC7E,MAAM,IAAI,aACR,UACA,iBAAiB,OAAO,OAAO,IAAI,gBAAgB,QAAQ,KAAK,OAAO,IAAI,cAAc,0FAC3F;CAGF,IAAI,MAAM,OACR,MAAM,IAAI,aACR,UACA,kBAAkB,cAAc,YAAY,gBAAgB,kDAC9D;CAGF,OAAO,GAAG,SAAS,MAAM,GAAG,KAAK,IAAI,QAAQ,SAAS,MAAM,MAAM,EAAoB;AACxF"}

package/esm/tooling/agents-md/agents-md-refresher.d.mts

@@ -1,20 +1,28 @@
 import { InspectReport } from "../inspect/inspect-report.types.mjs";
 import { WriteAgentsMdResult } from "./write-agents-md.mjs";
-
 //#region ../../packages/core/src/tooling/agents-md/agents-md-refresher.d.ts
 /** Options of {@link createAgentsMdRefresher}. */
-type AgentsMdRefresherOptions = {
-  /** Project root. Default: `process.cwd()`. */cwd?: string; /** Produce a fresh report (the dev server calls `inspectApp()` in-process). */
-  collect: () => Promise<InspectReport>; /** Quiet period after the last `schedule()` before a refresh runs. Default: 1000 ms. */
-  debounceMs?: number; /** Create AGENTS.md when it is missing. Default: `true`. */
-  create?: boolean; /** Called with each refresh's result. */
-  onWrite?: (result: WriteAgentsMdResult) => void; /** Called when a refresh fails; the error never escapes the timer. */
+export type AgentsMdRefresherOptions = {
+  /** Project root. Default: `process.cwd()`. */
+  cwd?: string;
+  /** Produce a fresh report (the dev server calls `inspectApp()` in-process). */
+  collect: () => Promise<InspectReport>;
+  /** Quiet period after the last `schedule()` before a refresh runs. Default: 1000 ms. */
+  debounceMs?: number;
+  /** Create AGENTS.md when it is missing. Default: `true`. */
+  create?: boolean;
+  /** Called with each refresh's result. */
+  onWrite?: (result: WriteAgentsMdResult) => void;
+  /** Called when a refresh fails; the error never escapes the timer. */
   onError?: (error: unknown) => void;
 };
 /** A debounced AGENTS.md refresher. */
-type AgentsMdRefresher = {
-  /** Ask for a refresh; calls within `debounceMs` of each other collapse into one. */schedule(): void; /** Run a pending (or, with none pending, a fresh) refresh now and wait for it. */
-  flush(): Promise<void>; /** Cancel a pending refresh; later `schedule()` calls do nothing. */
+export type AgentsMdRefresher = {
+  /** Ask for a refresh; calls within `debounceMs` of each other collapse into one. */
+  schedule(): void;
+  /** Run a pending (or, with none pending, a fresh) refresh now and wait for it. */
+  flush(): Promise<void>;
+  /** Cancel a pending refresh; later `schedule()` calls do nothing. */
   dispose(): void;
 };
 /**
@@ -30,7 +38,6 @@ type AgentsMdRefresher = {
  * });
  * refresher.schedule();
  */
-declare function createAgentsMdRefresher(options: AgentsMdRefresherOptions): AgentsMdRefresher;
+export declare function createAgentsMdRefresher(options: AgentsMdRefresherOptions): AgentsMdRefresher;
 //#endregion
-export { AgentsMdRefresher, AgentsMdRefresherOptions, createAgentsMdRefresher };
 //# sourceMappingURL=agents-md-refresher.d.mts.map

package/esm/tooling/agents-md/agents-md-refresher.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md-refresher.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/agents-md-refresher.ts"],"mappings":";;;;;KAIY,wBAAA;EAAA,8CAEV,GAAA;EAEA,OAAA,QAAe,OAAA,CAAQ,aAAA,GAAR;EAEf,UAAA,WAIsC;EAFtC,MAAA,YANA;EAQA,OAAA,IAAW,MAAA,EAAQ,mBAAA,WANJ;EAQf,OAAA,IAAW,KAAA;AAAA;;KAID,iBAAA;EANS,oFAQnB,QAAA,UANA;EAQA,KAAA,IAAS,OAAO,QARS;EAUzB,OAAA;AAAA;;;;;;;;;AAAO;AAgBT;;;;iBAAgB,uBAAA,CAAwB,OAAA,EAAS,wBAAA,GAA2B,iBAAiB"}
+{"version":3,"file":"agents-md-refresher.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/agents-md-refresher.ts"],"mappings":";;;;YAIY;;EAEV;;EAEA,eAAe,QAAQ;;EAEvB;;EAEA;;EAEA,WAAW,QAAQ;;EAEnB,WAAW;;;YAID;;EAEV;;EAEA,SAAS;;EAET;;;;;;;;;;;;;;;wBAgBc,wBAAwB,SAAS,2BAA2B"}