@warlock.js/core 5.30.0 → 5.31.0

package/esm/utils/runtime.d.mts

@@ -0,0 +1,59 @@
+//#region ../../packages/core/src/utils/runtime.d.ts
+/**
+ * Which JavaScript runtime is executing this process, and what that means for
+ * the CLI commands that only work on one of them.
+ *
+ * Bun and Deno both run Node programs through their Node compatibility layers,
+ * and both announce themselves the same way: they keep `process.versions.node`
+ * (the Node version they emulate) and add their own entry —
+ * `process.versions.bun` (Bun's documented check,
+ * https://bun.sh/guides/util/detect-bun) and `process.versions.deno`
+ * (observed on Deno 2.9.7, the version the runtime CI job pins). Reading those
+ * entries is therefore the one check that works from inside all three
+ * runtimes without touching a runtime-specific global.
+ */
+/** The runtimes Warlock knows how to name. */
+type JavaScriptRuntimeName = "node" | "bun" | "deno";
+type JavaScriptRuntime = {
+  /** Which runtime is executing this process. */type: JavaScriptRuntimeName; /** That runtime's own version (for Bun and Deno, not the Node version they emulate). */
+  version: string;
+};
+/** Where the supported-runtimes matrix is documented. */
+declare const SUPPORTED_RUNTIMES_DOCS_URL = "https://warlock.js.org/v/latest/core/digging-deeper/supported-runtimes/";
+/**
+ * Detect the runtime executing this process.
+ *
+ * @param versions the `process.versions` to read; injectable for tests.
+ */
+declare function detectJavaScriptRuntime(versions?: NodeJS.ProcessVersions): JavaScriptRuntime;
+/** `"Bun 1.4.3"`, `"Deno 2.9.7"`, `"Node.js 22.15.0"`. */
+declare function describeJavaScriptRuntime(runtime: JavaScriptRuntime): string;
+/**
+ * The error a Node-only CLI command prints when it is started on Bun or Deno,
+ * or `undefined` when the runtime is Node and the command may run.
+ *
+ * Only `warlock dev` is Node-only today: it compiles TypeScript and reloads
+ * modules through Node's module customization hooks, which Bun does not
+ * provide and Deno provides only partially. The production build runs anywhere
+ * the compatibility layers reach, so the message points there.
+ */
+declare function nodeOnlyCommandError(commandName: string, runtime?: JavaScriptRuntime): string | undefined;
+/**
+ * Stop a Node-only command before it does any work when it runs on Bun or Deno.
+ *
+ * Exits with code 1 after printing {@link nodeOnlyCommandError} on stderr; a
+ * no-op on Node.
+ */
+declare function assertNodeOnlyCommand(commandName: string, runtime?: JavaScriptRuntime): void;
+/**
+ * The note `warlock build` prints when it runs on Bun or Deno, or `undefined`
+ * on Node.
+ *
+ * Not an error: the build is plain esbuild and Vite work that the
+ * compatibility layers handle, but only the Node build is verified in CI, so
+ * the user is told which part of the pipeline is supported where.
+ */
+declare function unverifiedBuildRuntimeNotice(runtime?: JavaScriptRuntime): string | undefined;
+//#endregion
+export { JavaScriptRuntime, JavaScriptRuntimeName, SUPPORTED_RUNTIMES_DOCS_URL, assertNodeOnlyCommand, describeJavaScriptRuntime, detectJavaScriptRuntime, nodeOnlyCommandError, unverifiedBuildRuntimeNotice };
+//# sourceMappingURL=runtime.d.mts.map

package/esm/utils/runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/runtime.ts"],"mappings":";;AAeA;;;;AAAiC;AAEjC;;;;;;;;KAFY,qBAAA;AAAA,KAEA,iBAAA;EAQ4B,+CANtC,IAAA,EAAM,qBAAqB,EAMW;EAJtC,OAAA;AAAA;;cAIW,2BAAA;;;;;;iBAcG,uBAAA,CACd,QAAA,GAAU,MAAA,CAAO,eAAA,GAChB,iBAAiB;AAAA;AAAA,iBAiBJ,yBAAA,CAA0B,OAA0B,EAAjB,iBAAiB;;;;AAAA;AAapE;;;;;iBAAgB,oBAAA,CACd,WAAA,UACA,OAAA,GAAS,iBAA6C;;;AAAA;AAsBxD;;;iBAAgB,qBAAA,CACd,WAAA,UACA,OAAA,GAAS,iBAA6C;;;;;AAAA;AAoBxD;;;iBAAgB,4BAAA,CACd,OAAsD,GAA7C,iBAA6C"}

package/esm/utils/runtime.mjs

@@ -0,0 +1,85 @@
+//#region ../../packages/core/src/utils/runtime.ts
+/** Where the supported-runtimes matrix is documented. */
+const SUPPORTED_RUNTIMES_DOCS_URL = "https://warlock.js.org/v/latest/core/digging-deeper/supported-runtimes/";
+const RUNTIME_LABELS = {
+	node: "Node.js",
+	bun: "Bun",
+	deno: "Deno"
+};
+/**
+* Detect the runtime executing this process.
+*
+* @param versions the `process.versions` to read; injectable for tests.
+*/
+function detectJavaScriptRuntime(versions = process.versions) {
+	const bunVersion = versions.bun;
+	if (typeof bunVersion === "string" && bunVersion.length > 0) return {
+		type: "bun",
+		version: bunVersion
+	};
+	const denoVersion = versions.deno;
+	if (typeof denoVersion === "string" && denoVersion.length > 0) return {
+		type: "deno",
+		version: denoVersion
+	};
+	return {
+		type: "node",
+		version: versions.node
+	};
+}
+/** `"Bun 1.4.3"`, `"Deno 2.9.7"`, `"Node.js 22.15.0"`. */
+function describeJavaScriptRuntime(runtime) {
+	return `${RUNTIME_LABELS[runtime.type]} ${runtime.version}`;
+}
+/**
+* The error a Node-only CLI command prints when it is started on Bun or Deno,
+* or `undefined` when the runtime is Node and the command may run.
+*
+* Only `warlock dev` is Node-only today: it compiles TypeScript and reloads
+* modules through Node's module customization hooks, which Bun does not
+* provide and Deno provides only partially. The production build runs anywhere
+* the compatibility layers reach, so the message points there.
+*/
+function nodeOnlyCommandError(commandName, runtime = detectJavaScriptRuntime()) {
+	if (runtime.type === "node") return;
+	return [
+		`✖ warlock ${commandName} runs on Node.js only — this process is ${describeJavaScriptRuntime(runtime)}.`,
+		`  The development server compiles TypeScript and hot-reloads modules through Node's module loader hooks.`,
+		`  Run it with Node.js 22.15 or newer: npx warlock ${commandName}`,
+		`  ${RUNTIME_LABELS[runtime.type]} can run the production build: build it with Node (npx warlock build),`,
+		`  then start it with ${runtime.type === "bun" ? "bun dist/app.js" : "deno run -A dist/app.js"}.`,
+		`  Supported runtimes: ${SUPPORTED_RUNTIMES_DOCS_URL}`
+	].join("\n");
+}
+/**
+* Stop a Node-only command before it does any work when it runs on Bun or Deno.
+*
+* Exits with code 1 after printing {@link nodeOnlyCommandError} on stderr; a
+* no-op on Node.
+*/
+function assertNodeOnlyCommand(commandName, runtime = detectJavaScriptRuntime()) {
+	const message = nodeOnlyCommandError(commandName, runtime);
+	if (message === void 0) return;
+	console.error(message);
+	process.exit(1);
+}
+/**
+* The note `warlock build` prints when it runs on Bun or Deno, or `undefined`
+* on Node.
+*
+* Not an error: the build is plain esbuild and Vite work that the
+* compatibility layers handle, but only the Node build is verified in CI, so
+* the user is told which part of the pipeline is supported where.
+*/
+function unverifiedBuildRuntimeNotice(runtime = detectJavaScriptRuntime()) {
+	if (runtime.type === "node") return;
+	return [
+		`! warlock build is verified on Node.js; this process is ${describeJavaScriptRuntime(runtime)}.`,
+		`  Build with Node (npx warlock build) for a supported artifact. Starting the built app on ${RUNTIME_LABELS[runtime.type]} is supported.`,
+		`  Supported runtimes: ${SUPPORTED_RUNTIMES_DOCS_URL}`
+	].join("\n");
+}
+
+//#endregion
+export { SUPPORTED_RUNTIMES_DOCS_URL, assertNodeOnlyCommand, describeJavaScriptRuntime, detectJavaScriptRuntime, nodeOnlyCommandError, unverifiedBuildRuntimeNotice };
+//# sourceMappingURL=runtime.mjs.map

package/esm/utils/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/runtime.ts"],"sourcesContent":["/**\n * Which JavaScript runtime is executing this process, and what that means for\n * the CLI commands that only work on one of them.\n *\n * Bun and Deno both run Node programs through their Node compatibility layers,\n * and both announce themselves the same way: they keep `process.versions.node`\n * (the Node version they emulate) and add their own entry —\n * `process.versions.bun` (Bun's documented check,\n * https://bun.sh/guides/util/detect-bun) and `process.versions.deno`\n * (observed on Deno 2.9.7, the version the runtime CI job pins). Reading those\n * entries is therefore the one check that works from inside all three\n * runtimes without touching a runtime-specific global.\n */\n\n/** The runtimes Warlock knows how to name. */\nexport type JavaScriptRuntimeName = \"node\" | \"bun\" | \"deno\";\n\nexport type JavaScriptRuntime = {\n  /** Which runtime is executing this process. */\n  type: JavaScriptRuntimeName;\n  /** That runtime's own version (for Bun and Deno, not the Node version they emulate). */\n  version: string;\n};\n\n/** Where the supported-runtimes matrix is documented. */\nexport const SUPPORTED_RUNTIMES_DOCS_URL =\n  \"https://warlock.js.org/v/latest/core/digging-deeper/supported-runtimes/\";\n\nconst RUNTIME_LABELS: Record<JavaScriptRuntimeName, string> = {\n  node: \"Node.js\",\n  bun: \"Bun\",\n  deno: \"Deno\",\n};\n\n/**\n * Detect the runtime executing this process.\n *\n * @param versions the `process.versions` to read; injectable for tests.\n */\nexport function detectJavaScriptRuntime(\n  versions: NodeJS.ProcessVersions = process.versions,\n): JavaScriptRuntime {\n  const bunVersion = versions.bun;\n\n  if (typeof bunVersion === \"string\" && bunVersion.length > 0) {\n    return { type: \"bun\", version: bunVersion };\n  }\n\n  const denoVersion = versions.deno;\n\n  if (typeof denoVersion === \"string\" && denoVersion.length > 0) {\n    return { type: \"deno\", version: denoVersion };\n  }\n\n  return { type: \"node\", version: versions.node };\n}\n\n/** `\"Bun 1.4.3\"`, `\"Deno 2.9.7\"`, `\"Node.js 22.15.0\"`. */\nexport function describeJavaScriptRuntime(runtime: JavaScriptRuntime): string {\n  return `${RUNTIME_LABELS[runtime.type]} ${runtime.version}`;\n}\n\n/**\n * The error a Node-only CLI command prints when it is started on Bun or Deno,\n * or `undefined` when the runtime is Node and the command may run.\n *\n * Only `warlock dev` is Node-only today: it compiles TypeScript and reloads\n * modules through Node's module customization hooks, which Bun does not\n * provide and Deno provides only partially. The production build runs anywhere\n * the compatibility layers reach, so the message points there.\n */\nexport function nodeOnlyCommandError(\n  commandName: string,\n  runtime: JavaScriptRuntime = detectJavaScriptRuntime(),\n): string | undefined {\n  if (runtime.type === \"node\") {\n    return undefined;\n  }\n\n  return [\n    `✖ warlock ${commandName} runs on Node.js only — this process is ${describeJavaScriptRuntime(runtime)}.`,\n    `  The development server compiles TypeScript and hot-reloads modules through Node's module loader hooks.`,\n    `  Run it with Node.js 22.15 or newer: npx warlock ${commandName}`,\n    `  ${RUNTIME_LABELS[runtime.type]} can run the production build: build it with Node (npx warlock build),`,\n    `  then start it with ${runtime.type === \"bun\" ? \"bun dist/app.js\" : \"deno run -A dist/app.js\"}.`,\n    `  Supported runtimes: ${SUPPORTED_RUNTIMES_DOCS_URL}`,\n  ].join(\"\\n\");\n}\n\n/**\n * Stop a Node-only command before it does any work when it runs on Bun or Deno.\n *\n * Exits with code 1 after printing {@link nodeOnlyCommandError} on stderr; a\n * no-op on Node.\n */\nexport function assertNodeOnlyCommand(\n  commandName: string,\n  runtime: JavaScriptRuntime = detectJavaScriptRuntime(),\n): void {\n  const message = nodeOnlyCommandError(commandName, runtime);\n\n  if (message === undefined) {\n    return;\n  }\n\n  console.error(message);\n  process.exit(1);\n}\n\n/**\n * The note `warlock build` prints when it runs on Bun or Deno, or `undefined`\n * on Node.\n *\n * Not an error: the build is plain esbuild and Vite work that the\n * compatibility layers handle, but only the Node build is verified in CI, so\n * the user is told which part of the pipeline is supported where.\n */\nexport function unverifiedBuildRuntimeNotice(\n  runtime: JavaScriptRuntime = detectJavaScriptRuntime(),\n): string | undefined {\n  if (runtime.type === \"node\") {\n    return undefined;\n  }\n\n  return [\n    `! warlock build is verified on Node.js; this process is ${describeJavaScriptRuntime(runtime)}.`,\n    `  Build with Node (npx warlock build) for a supported artifact. Starting the built app on ${RUNTIME_LABELS[runtime.type]} is supported.`,\n    `  Supported runtimes: ${SUPPORTED_RUNTIMES_DOCS_URL}`,\n  ].join(\"\\n\");\n}\n"],"mappings":";;AAyBA,MAAa,8BACX;AAEF,MAAM,iBAAwD;CAC5D,MAAM;CACN,KAAK;CACL,MAAM;AACR;;;;;;AAOA,SAAgB,wBACd,WAAmC,QAAQ,UACxB;CACnB,MAAM,aAAa,SAAS;CAE5B,IAAI,OAAO,eAAe,YAAY,WAAW,SAAS,GACxD,OAAO;EAAE,MAAM;EAAO,SAAS;CAAW;CAG5C,MAAM,cAAc,SAAS;CAE7B,IAAI,OAAO,gBAAgB,YAAY,YAAY,SAAS,GAC1D,OAAO;EAAE,MAAM;EAAQ,SAAS;CAAY;CAG9C,OAAO;EAAE,MAAM;EAAQ,SAAS,SAAS;CAAK;AAChD;;AAGA,SAAgB,0BAA0B,SAAoC;CAC5E,OAAO,GAAG,eAAe,QAAQ,MAAM,GAAG,QAAQ;AACpD;;;;;;;;;;AAWA,SAAgB,qBACd,aACA,UAA6B,wBAAwB,GACjC;CACpB,IAAI,QAAQ,SAAS,QACnB;CAGF,OAAO;EACL,aAAa,YAAY,0CAA0C,0BAA0B,OAAO,EAAE;EACtG;EACA,qDAAqD;EACrD,KAAK,eAAe,QAAQ,MAAM;EAClC,wBAAwB,QAAQ,SAAS,QAAQ,oBAAoB,0BAA0B;EAC/F,yBAAyB;CAC3B,CAAC,CAAC,KAAK,IAAI;AACb;;;;;;;AAQA,SAAgB,sBACd,aACA,UAA6B,wBAAwB,GAC/C;CACN,MAAM,UAAU,qBAAqB,aAAa,OAAO;CAEzD,IAAI,YAAY,QACd;CAGF,QAAQ,MAAM,OAAO;CACrB,QAAQ,KAAK,CAAC;AAChB;;;;;;;;;AAUA,SAAgB,6BACd,UAA6B,wBAAwB,GACjC;CACpB,IAAI,QAAQ,SAAS,QACnB;CAGF,OAAO;EACL,2DAA2D,0BAA0B,OAAO,EAAE;EAC9F,6FAA6F,eAAe,QAAQ,MAAM;EAC1H,yBAAyB;CAC3B,CAAC,CAAC,KAAK,IAAI;AACb"}

package/esm/validation/index.d.mts

@@ -4,5 +4,5 @@ import { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, U
 import { uniqueExceptCurrentIdRule } from "./database/unique-except-current-id.mjs";
 import { uniqueExceptCurrentUserRule } from "./database/unique-except-current-user.mjs";
 import { FileValidator, uploadedFileMetadataSchema } from "./validators/file-validator.mjs";
-import { ValidationConfiguration } from "./types.mjs";
+import { ValidationConfiguration, ValidationResponseConfiguration } from "./types.mjs";
 import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./file/file.mjs";

package/esm/validation/types.d.mts

@@ -1,7 +1,8 @@
 import { UploadedFile } from "../http/uploaded-file.mjs";
+import { Route } from "../router/types.mjs";
 import { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions } from "./database/types.mjs";
 import { FileValidator } from "./validators/file-validator.mjs";
-import { ArrayValidator, BaseValidator, Infer, ObjectValidator, StandardSchemaV1, StringValidator, TranslateAttributeCallback, TranslateRuleCallback } from "@warlock.js/seal";
+import { ArrayValidator, BaseValidator, Infer, ObjectValidator, StandardSchemaV1, StringValidator, TranslateAttributeCallback, TranslateRuleCallback, ValidationResult } from "@warlock.js/seal";
 import { ChildModel, Model } from "@warlock.js/cascade";
 
 //#region ../../packages/core/src/validation/types.d.ts
@@ -60,7 +61,61 @@ declare module "@warlock.js/seal" {
     }): this;
   }
 }
+/**
+ * `validation.response`: how a failed schema validation is answered.
+ */
+type ValidationResponseConfiguration = {
+  /**
+   * Key holding the list of field errors in the framework body.
+   *
+   * @default "errors"
+   */
+  errors?: string;
+  /**
+   * Key holding the field name in each error.
+   *
+   * @default "input"
+   */
+  inputKey?: string;
+  /**
+   * Key holding the message in each error.
+   *
+   * @default "error"
+   */
+  inputError?: string;
+  /**
+   * Status of a failed schema validation, including a body returned by
+   * `body` or by a route's `onFailure` hook without its own `status`.
+   *
+   * @default 422
+   */
+  status?: number;
+  /**
+   * Build the failure body for every route, instead of the framework's
+   * `{ errors: [...] }`. Return `undefined` to keep the framework body for a
+   * route. A route's own `validation.onFailure` wins over this hook.
+   *
+   * @example
+   * response: {
+   *   status: 400,
+   *   body: (result, route) => ({ error: `${route.name}.invalid`, fields: result.errors.length }),
+   * },
+   */
+  body?: (result: ValidationResult, route: Route) => unknown;
+};
 type ValidationConfiguration = {
+  /**
+   * How a failed schema validation is answered: the framework body's keys,
+   * its status, or a `body` hook that replaces it.
+   */
+  response?: ValidationResponseConfiguration;
+  /**
+   * Status sent when a custom `validation.validate` middleware returns a
+   * value that is not a `Response`.
+   *
+   * @default 400
+   */
+  responseStatus?: number;
   /**
    * Translation group that will be prefixed the rules
    * For example required rule translation will be taken from validation.required
@@ -91,5 +146,5 @@ type ValidationConfiguration = {
   translateAttribute?: TranslateAttributeCallback;
 };
 //#endregion
-export { ValidationConfiguration };
+export { ValidationConfiguration, ValidationResponseConfiguration };
 //# sourceMappingURL=types.d.mts.map

package/esm/validation/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/validation/types.ts"],"mappings":";;;;;;;;;;;;KAmCK,uBAAA,WAAkC,aAAA,IAAiB,eAAA;EACtD,UAAA,EAAY,eAAA,GAAkB,gBAAA;EAC9B,KAAA,EAAO,CAAA;AAAA,KAEP,gBAAA;EACE,UAAA;EACA,KAAA,EAAO,KAAA,CAAM,CAAA;AAAA;AAAA;EAAA,UAME,UAAA;IACf,IAAA,GAAO,YAAA,cAA0B,aAAA,GAAgB,gBAAA,CAAiB,YAAA;IAClE,SAAA,aACY,aAAA,GAAgB,eAAA,GAAkB,gBAAA,6BAE5C,cAAA,GAAiB,CAAA,EACjB,YAAA,cACG,cAAA;MACH,SAAA,EAAW,uBAAA,CAAwB,CAAA;IAAA,IACjC,gBAAA,CACA,KAAA;MACE,UAAA;MACA,KAAA,EAAO,KAAA,CAAM,CAAA;IAAA;EAAA;EAAA,UAKX,eAAA;IAvBM;IAyBd,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IA5BU;IAiCd,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;IA3BQ;IAgCZ,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IA/BC;IAoCL,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAMI,eAAA;IACR,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IAGJ,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;IAGJ,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IAGJ,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;EAAA;AAAA;AAAA,KAcI,uBAAA;EA3CQ;;;;;;EAmDlB,gBAAA;EAnC0B;;;;;;EA0C1B,cAAA;EA/BW;;;;EAoCX,cAAA;EA5GiB;;;;EAiHjB,aAAA,GAAgB,qBAAA;EAhHoD;;;EAoHpE,kBAAA,GAAqB,0BAA0B;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/validation/types.ts"],"mappings":";;;;;;;;;;;;;KAoCK,uBAAA,WAAkC,aAAA,IAAiB,eAAA;EACtD,UAAA,EAAY,eAAA,GAAkB,gBAAA;EAC9B,KAAA,EAAO,CAAA;AAAA,KAEP,gBAAA;EACE,UAAA;EACA,KAAA,EAAO,KAAA,CAAM,CAAA;AAAA;AAAA;EAAA,UAME,UAAA;IACf,IAAA,GAAO,YAAA,cAA0B,aAAA,GAAgB,gBAAA,CAAiB,YAAA;IAClE,SAAA,aACY,aAAA,GAAgB,eAAA,GAAkB,gBAAA,6BAE5C,cAAA,GAAiB,CAAA,EACjB,YAAA,cACG,cAAA;MACH,SAAA,EAAW,uBAAA,CAAwB,CAAA;IAAA,IACjC,gBAAA,CACA,KAAA;MACE,UAAA;MACA,KAAA,EAAO,KAAA,CAAM,CAAA;IAAA;EAAA;EAAA,UAKX,eAAA;IAvBM;IAyBd,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IA5BU;IAiCd,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;IA3BQ;IAgCZ,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IA/BC;IAoCL,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAMI,eAAA;IACR,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IAGJ,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;IAGJ,uBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,kCAAA;MACpB,YAAA;IAAA;IAGJ,qBAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,gCAAA;MACpB,YAAA;IAAA;EAAA;AAAA;;;;KAiBI,+BAAA;EApCgB;;;;;EA0C1B,MAAA;EA/BsB;;;;;EAqCtB,QAAA;EA9B0B;;;;;EAoC1B,UAAA;EA5GS;;;;;;EAmHT,MAAA;EAjH8B;;;;;;;;;;;EA6H9B,IAAA,IAAQ,MAAA,EAAQ,gBAAA,EAAkB,KAAA,EAAO,KAAK;AAAA;AAAA,KAGpC,uBAAA;EAvHW;;;;EA4HrB,QAAA,GAAW,+BAAA;EApHP;;;;;;EA2HJ,cAAA;EAnHsB;;;;;;EA2HtB,gBAAA;EAnHW;;;;;;EA0HX,cAAA;EAnHE;;;;EAwHF,cAAA;EAtH0B;;;;EA2H1B,aAAA,GAAgB,qBAAA;EAlHL;;;EAsHX,kBAAA,GAAqB,0BAAA;AAAA"}

package/esm/validation/validateAll.mjs

@@ -1,3 +1,4 @@
+import { validationFailureStatus } from "./validation-failure-status.mjs";
 import { Response } from "../http/response.mjs";
 import { v } from "@warlock.js/seal";
 import config from "@mongez/config";
@@ -47,6 +48,22 @@ function buildCoercingParamsSchema(schema) {
 	return cloned;
 }
 /**
+* Answer a failed `schema` or `params` validation: the route's own
+* `onFailure` hook first, then `response.failedSchema(result)`, which applies
+* the global `validation.response.body` hook or the framework body.
+*/
+async function sendValidationFailure(validation, result, request, response) {
+	if (validation.onFailure) {
+		const custom = await validation.onFailure(result, {
+			request,
+			response,
+			route: request.route
+		});
+		if (custom) return response.send(custom.body, custom.status ?? validationFailureStatus());
+	}
+	return response.failedSchema(result);
+}
+/**
 * Validate the request route
 */
 async function validateAll(validation, request, response) {
@@ -60,7 +77,7 @@ async function validateAll(validation, request, response) {
 			const result = await v.validate(validation.schema, data);
 			if (!result.isValid) {
 				log.warn("validation", "schema", "Schema Validation failed");
-				return response.failedSchema(result);
+				return sendValidationFailure(validation, result, request, response);
 			}
 			if (result.data) validatedData = result.data;
 			log.success("validation", "schema", "Schema Validation passed");
@@ -75,7 +92,7 @@ async function validateAll(validation, request, response) {
 			const result = await v.validate(coercingParamsSchema(validation.params), request.params);
 			if (!result.isValid) {
 				log.warn("validation", "params", "Route params schema validation failed");
-				return response.failedSchema(result);
+				return sendValidationFailure(validation, result, request, response);
 			}
 			if (result.data) {
 				for (const [key, value] of Object.entries(result.data)) request.setParam(key, value);

package/esm/validation/validateAll.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateAll.mjs","names":["candidate"],"sources":["../../../../../../../../packages/core/src/validation/validateAll.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { merge } from \"@mongez/reinforcements\";\nimport { log } from \"@warlock.js/logger\";\nimport { v, type ObjectValidator } from \"@warlock.js/seal\";\nimport type { Request } from \"../http\";\nimport { Response } from \"../http/response\";\nimport type { RequestHandlerValidation, Route } from \"../router\";\n\nfunction resolveDataToParse(\n  validating: RequestHandlerValidation[\"validating\"],\n  schema: RequestHandlerValidation[\"schema\"],\n  request: Request,\n) {\n  if (!validating || validating.length === 0) {\n    const data = request.allExceptParams();\n\n    // Duck-typed rather than `instanceof ObjectValidator`: the app's schema can\n    // come from a different copy of seal than core's, and `instanceof` would\n    // then silently fall back to ignoring params.\n    const shape = (schema as { schema?: unknown } | undefined)?.schema;\n\n    if (!shape || typeof shape !== \"object\") return data;\n\n    for (const [key, value] of Object.entries(request.params)) {\n      if (data[key] === undefined && Object.hasOwn(shape, key)) {\n        data[key] = value;\n      }\n    }\n\n    return data;\n  }\n\n  let data: any = {};\n\n  for (const validatingType of validating) {\n    if (validatingType === \"body\") {\n      data = merge(data, request.body);\n    }\n\n    if (validatingType === \"query\") {\n      data = merge(data, request.query);\n    }\n\n    if (validatingType === \"params\") {\n      data = merge(data, request.params);\n    }\n\n    if (validatingType === \"headers\") {\n      data = merge(data, request.headers);\n    }\n  }\n\n  return data;\n}\n\n/**\n * Route segments arrive from Fastify as strings. A params schema is an\n * explicit request to parse those segments, so enable Seal's built-in\n * coercion for validators that support it (numbers and booleans) without\n * mutating the application-owned schema.\n *\n * This is deliberately duck-typed: a route may carry a Seal schema from a\n * linked application copy rather than core's installed copy.\n */\nconst coercingParamsSchemas = new WeakMap<ObjectValidator, ObjectValidator>();\n\nfunction coercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const cached = coercingParamsSchemas.get(schema);\n\n  if (cached) return cached;\n\n  const coercing = buildCoercingParamsSchema(schema);\n\n  coercingParamsSchemas.set(schema, coercing);\n\n  return coercing;\n}\n\nfunction buildCoercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const candidate = schema as ObjectValidator & {\n    clone?: () => ObjectValidator;\n    schema?: Record<string, { coerce?: () => unknown }>;\n  };\n  const cloned = candidate.clone?.() ?? schema;\n  const shape = (cloned as typeof candidate).schema;\n\n  if (!shape) return cloned;\n\n  for (const [key, validator] of Object.entries(shape)) {\n    if (typeof validator.coerce === \"function\") {\n      shape[key] = validator.coerce() as typeof validator;\n    }\n  }\n\n  return cloned;\n}\n\n/**\n * Validate the request route\n */\nexport async function validateAll(\n  validation: Route[\"handler\"][\"validation\"],\n  request: Request,\n  response: Response,\n) {\n  if (!validation) return;\n\n  log.info(\"validation\", \"started\", \"Start validating the request\");\n\n  let validatedData: Record<string, unknown> | undefined;\n\n  if (validation.schema) {\n    log.info(\"validation\", \"schema\", \"Validating request schema\");\n    try {\n      const data = resolveDataToParse(validation.validating, validation.schema, request);\n      const result = await v.validate(validation.schema, data);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"schema\", \"Schema Validation failed\");\n        return response.failedSchema(result);\n      }\n\n      if (result.data) {\n        validatedData = result.data;\n      }\n\n      log.success(\"validation\", \"schema\", \"Schema Validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validation.params) {\n    log.info(\"validation\", \"params\", \"Validating route params schema\");\n    try {\n      const result = await v.validate(coercingParamsSchema(validation.params), request.params);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"params\", \"Route params schema validation failed\");\n        return response.failedSchema(result);\n      }\n\n      if (result.data) {\n        for (const [key, value] of Object.entries(result.data)) {\n          request.setParam(key, value);\n        }\n\n        validatedData = { ...validatedData, ...result.data };\n      }\n\n      log.success(\"validation\", \"params\", \"Route params schema validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validatedData) {\n    request.setValidatedData(validatedData);\n  }\n\n  if (validation.validate) {\n    const result = await validation.validate({ request, response });\n\n    // if there is a result, it means it failed\n    if (result) {\n      log.info(\"validation\", \"failed\", \"Validation failed\");\n\n      // a returned Response already carries its own status; anything else is\n      // sent with the configured failure status (400 by default)\n      if (result instanceof Response) return result;\n\n      return response.send(result, config.get(\"validation.responseStatus\", 400));\n    }\n\n    log.info(\"validation\", \"passed\", \"Validation passed\");\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"validateAll.mjs","names":["candidate"],"sources":["../../../../../../../../packages/core/src/validation/validateAll.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { merge } from \"@mongez/reinforcements\";\nimport { log } from \"@warlock.js/logger\";\nimport { v, type ObjectValidator, type ValidationResult } from \"@warlock.js/seal\";\nimport type { Request } from \"../http\";\nimport { Response } from \"../http/response\";\nimport type { RequestHandlerValidation, Route } from \"../router\";\nimport { validationFailureStatus } from \"./validation-failure-status\";\n\nfunction resolveDataToParse(\n  validating: RequestHandlerValidation[\"validating\"],\n  schema: RequestHandlerValidation[\"schema\"],\n  request: Request,\n) {\n  if (!validating || validating.length === 0) {\n    const data = request.allExceptParams();\n\n    // Duck-typed rather than `instanceof ObjectValidator`: the app's schema can\n    // come from a different copy of seal than core's, and `instanceof` would\n    // then silently fall back to ignoring params.\n    const shape = (schema as { schema?: unknown } | undefined)?.schema;\n\n    if (!shape || typeof shape !== \"object\") return data;\n\n    for (const [key, value] of Object.entries(request.params)) {\n      if (data[key] === undefined && Object.hasOwn(shape, key)) {\n        data[key] = value;\n      }\n    }\n\n    return data;\n  }\n\n  let data: any = {};\n\n  for (const validatingType of validating) {\n    if (validatingType === \"body\") {\n      data = merge(data, request.body);\n    }\n\n    if (validatingType === \"query\") {\n      data = merge(data, request.query);\n    }\n\n    if (validatingType === \"params\") {\n      data = merge(data, request.params);\n    }\n\n    if (validatingType === \"headers\") {\n      data = merge(data, request.headers);\n    }\n  }\n\n  return data;\n}\n\n/**\n * Route segments arrive from Fastify as strings. A params schema is an\n * explicit request to parse those segments, so enable Seal's built-in\n * coercion for validators that support it (numbers and booleans) without\n * mutating the application-owned schema.\n *\n * This is deliberately duck-typed: a route may carry a Seal schema from a\n * linked application copy rather than core's installed copy.\n */\nconst coercingParamsSchemas = new WeakMap<ObjectValidator, ObjectValidator>();\n\nfunction coercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const cached = coercingParamsSchemas.get(schema);\n\n  if (cached) return cached;\n\n  const coercing = buildCoercingParamsSchema(schema);\n\n  coercingParamsSchemas.set(schema, coercing);\n\n  return coercing;\n}\n\nfunction buildCoercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const candidate = schema as ObjectValidator & {\n    clone?: () => ObjectValidator;\n    schema?: Record<string, { coerce?: () => unknown }>;\n  };\n  const cloned = candidate.clone?.() ?? schema;\n  const shape = (cloned as typeof candidate).schema;\n\n  if (!shape) return cloned;\n\n  for (const [key, validator] of Object.entries(shape)) {\n    if (typeof validator.coerce === \"function\") {\n      shape[key] = validator.coerce() as typeof validator;\n    }\n  }\n\n  return cloned;\n}\n\n/**\n * Answer a failed `schema` or `params` validation: the route's own\n * `onFailure` hook first, then `response.failedSchema(result)`, which applies\n * the global `validation.response.body` hook or the framework body.\n */\nasync function sendValidationFailure(\n  validation: RequestHandlerValidation,\n  result: ValidationResult,\n  request: Request,\n  response: Response,\n) {\n  if (validation.onFailure) {\n    const custom = await validation.onFailure(result, { request, response, route: request.route });\n\n    if (custom) {\n      return response.send(custom.body, custom.status ?? validationFailureStatus());\n    }\n  }\n\n  return response.failedSchema(result);\n}\n\n/**\n * Validate the request route\n */\nexport async function validateAll(\n  validation: Route[\"handler\"][\"validation\"],\n  request: Request,\n  response: Response,\n) {\n  if (!validation) return;\n\n  log.info(\"validation\", \"started\", \"Start validating the request\");\n\n  let validatedData: Record<string, unknown> | undefined;\n\n  if (validation.schema) {\n    log.info(\"validation\", \"schema\", \"Validating request schema\");\n    try {\n      const data = resolveDataToParse(validation.validating, validation.schema, request);\n      const result = await v.validate(validation.schema, data);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"schema\", \"Schema Validation failed\");\n        return sendValidationFailure(validation, result, request, response);\n      }\n\n      if (result.data) {\n        validatedData = result.data;\n      }\n\n      log.success(\"validation\", \"schema\", \"Schema Validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validation.params) {\n    log.info(\"validation\", \"params\", \"Validating route params schema\");\n    try {\n      const result = await v.validate(coercingParamsSchema(validation.params), request.params);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"params\", \"Route params schema validation failed\");\n        return sendValidationFailure(validation, result, request, response);\n      }\n\n      if (result.data) {\n        for (const [key, value] of Object.entries(result.data)) {\n          request.setParam(key, value);\n        }\n\n        validatedData = { ...validatedData, ...result.data };\n      }\n\n      log.success(\"validation\", \"params\", \"Route params schema validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validatedData) {\n    request.setValidatedData(validatedData);\n  }\n\n  if (validation.validate) {\n    const result = await validation.validate({ request, response });\n\n    // if there is a result, it means it failed\n    if (result) {\n      log.info(\"validation\", \"failed\", \"Validation failed\");\n\n      // a returned Response already carries its own status; anything else is\n      // sent with the configured failure status (400 by default)\n      if (result instanceof Response) return result;\n\n      return response.send(result, config.get(\"validation.responseStatus\", 400));\n    }\n\n    log.info(\"validation\", \"passed\", \"Validation passed\");\n  }\n}\n"],"mappings":"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"}

package/esm/validation/validation-failure-status.mjs

@@ -0,0 +1,15 @@
+import config from "@mongez/config";
+
+//#region ../../packages/core/src/validation/validation-failure-status.ts
+/**
+* The status of a failed schema validation: `validation.response.status`, or
+* 422 when it is not configured.
+*/
+function validationFailureStatus() {
+	const status = config.get("validation.response.status");
+	return typeof status === "number" && Number.isInteger(status) ? status : 422;
+}
+
+//#endregion
+export { validationFailureStatus };
+//# sourceMappingURL=validation-failure-status.mjs.map

package/esm/validation/validation-failure-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-failure-status.mjs","names":[],"sources":["../../../../../../../../packages/core/src/validation/validation-failure-status.ts"],"sourcesContent":["import config from \"@mongez/config\";\n\n/**\n * The status of a failed schema validation: `validation.response.status`, or\n * 422 when it is not configured.\n */\nexport function validationFailureStatus(): number {\n  const status: unknown = config.get(\"validation.response.status\");\n\n  return typeof status === \"number\" && Number.isInteger(status) ? status : 422;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,0BAAkC;CAChD,MAAM,SAAkB,OAAO,IAAI,4BAA4B;CAE/D,OAAO,OAAO,WAAW,YAAY,OAAO,UAAU,MAAM,IAAI,SAAS;AAC3E"}

package/esm/validation/validators/file-validator.d.mts

@@ -9,22 +9,6 @@ declare const uploadedFileMetadataSchema: import("@warlock.js/seal").ObjectValid
   mimeType: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
   extension: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
   name: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
-}> & StandardSchemaV1<{
-  location: string;
-  width: number;
-  height: number;
-  size: number;
-  mimeType: string;
-  extension: string;
-  name: string;
-}, {
-  location: string;
-  width: number;
-  height: number;
-  size: number;
-  mimeType: string;
-  extension: string;
-  name: string;
 }>;
 /**
  * File validator class

package/esm/validation/validators/file-validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-validator.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/validators/file-validator.ts"],"mappings":";;;cAoBa,0BAAA,6BAA0B,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAa1B,aAAA,SAAsB,aAAA;cACd,YAAA;;;;EAQZ,WAAA,CAAY,KAAA;;EAKZ,KAAA,CAAM,YAAA;;EAKN,MAAA,CAAO,UAAA,qBAA+B,YAAA;;EAOtC,QAAA,CAAS,SAAA,qBAA8B,YAAA;;EAOvC,GAAA,CAAI,YAAA;;EAKJ,KAAA,CAAM,YAAA;;EAWN,IAAA,CAAK,YAAA;;EAWL,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAOvC,GAAA,CAAI,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAKnC,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAOvC,GAAA,CAAI,IAAA,UAAc,YAAA;EA/EA;EAoFlB,QAAA,CAAS,KAAA,UAAe,YAAA;EAxBD;EA+BvB,QAAA,CAAS,KAAA,UAAe,YAAA;EAnBD;EA0BvB,SAAA,CAAU,MAAA,UAAgB,YAAA;EAmByB;EAZnD,SAAA,CAAU,MAAA,UAAgB,YAAA;EAmCyC;;;;;;EAvBnE,MAAA,CAAO,iBAAA,WAA4B,aAAA,GAAgB,gBAAA;EA5GnD;;;;;;;;;;;;;;;EAmIS,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"file-validator.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/validators/file-validator.ts"],"mappings":";;;cAoBa,0BAAA,6BAA0B,eAAA;;;;;;;;;;;;cAa1B,aAAA,SAAsB,aAAA;cACd,YAAA;;;;EAQZ,WAAA,CAAY,KAAA;;EAKZ,KAAA,CAAM,YAAA;;EAKN,MAAA,CAAO,UAAA,qBAA+B,YAAA;;EAOtC,QAAA,CAAS,SAAA,qBAA8B,YAAA;;EAOvC,GAAA,CAAI,YAAA;;EAKJ,KAAA,CAAM,YAAA;;EAWN,IAAA,CAAK,YAAA;;EAWL,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAOvC,GAAA,CAAI,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAKnC,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAOvC,GAAA,CAAI,IAAA,UAAc,YAAA;EA/EA;EAoFlB,QAAA,CAAS,KAAA,UAAe,YAAA;EAxBD;EA+BvB,QAAA,CAAS,KAAA,UAAe,YAAA;EAnBD;EA0BvB,SAAA,CAAU,MAAA,UAAgB,YAAA;EAmByB;EAZnD,SAAA,CAAU,MAAA,UAAgB,YAAA;EAmCyC;;;;;;EAvBnE,MAAA,CAAO,iBAAA,WAA4B,aAAA,GAAgB,gBAAA;EA5GnD;;;;;;;;;;;;;;;EAmIS,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/warlock-config/bundle-config.mjs

@@ -1,7 +1,7 @@
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { readFile } from "node:fs/promises";
 import { getTsconfig } from "get-tsconfig";
-import { pathToFileURL } from "node:url";
 
 //#region ../../packages/core/src/warlock-config/bundle-config.ts
 /**

package/esm/warlock-config/types.d.mts

@@ -1,4 +1,4 @@
-import { FileHealthCheckerContract } from "../dev-server/health-checker/file-health-checker.contract.mjs";
+import { BuiltInHealthCheckerOptions, FileHealthCheckerContract } from "../dev-server/health-checker/file-health-checker.contract.mjs";
 import { Connector } from "../connectors/types.mjs";
 import { CLICommand } from "../commands/cli-command.mjs";
 import { MigrationConstructor } from "@warlock.js/cascade";
@@ -169,9 +169,10 @@ type WarlockConfig = {
       exclude?: string[];
     };
     /**
-     * Custom health checkers
+     * Built-in checker switches, custom checker array, or false to disable.
+     * Installed/configured ESLint and Oxlint both run by default.
      */
-    healthCheckers?: FileHealthCheckerContract[] | false;
+    healthCheckers?: FileHealthCheckerContract[] | BuiltInHealthCheckerOptions | false;
     /**
      * Whether to generate typings on dev server start
      * @default true
@@ -217,6 +218,29 @@ type WarlockConfig = {
      * @default false
      */
     timings?: boolean;
+    /**
+     * Keep the generated section of the project's `AGENTS.md` fresh: written
+     * on boot and again (debounced) after reloads, between the
+     * `<!-- warlock:generated:start -->` / `end` markers. Content outside the
+     * markers is never touched; the file is created when missing. Set to
+     * `false` to leave `AGENTS.md` alone (`warlock agents-md --write` still
+     * works).
+     * @default true
+     */
+    agentsMd?: boolean;
+    /**
+     * Serve `warlock mcp` from inside the dev server, over Streamable HTTP on
+     * loopback, so its `inspect_*` tools read the live registries. Same as
+     * `warlock dev --mcp`. `true` uses the defaults; an object sets them. The
+     * endpoint is printed and recorded in `.warlock/dev-server.json`. Needs
+     * `@warlock.js/ai-tools`.
+     * @default false
+     */
+    mcp?: boolean | {
+      /** `0` picks a free port. @default 0 */port?: number; /** Bearer token clients must send. @default none (loopback only) */
+      token?: string; /** Let generate tools write into the project. @default false */
+      allowWrites?: boolean;
+    };
   };
   /**
    * Database configuration

package/esm/warlock-config/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;AAWA;;;KAAY,aAAA;EA8BF;;;EA1BR,MAAA;IAsOqB;;;IAlOnB,IAAA;IAJF;;;IAQE,IAAA;IAkBF;;;IAdE,cAAA;EAAA;EAqCA;;;;;;;;;;;EAvBF,KAAA,GAAQ,IAAA,CAAK,YAAA;IAsHX;;;;;IAhHA,MAAA;IA+IA;;;;;;;;;;IApIA,YAAA;IAsNO;AAAA;;;;IAhNP,OAAA;;;;;;;IAOA,0BAAA;;;;;;;;;;;;;;;;;IAiBA,YAAA;;;;;;;;;;;;;;;;IAgBA,OAAA;;;;;;IAMA,MAAA;;;;;;IAMA,SAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,UAAA,GAAa,SAAA;;;;EAKb,GAAA;IACE,QAAA,GAAW,UAAA;EAAA;;;;EAMb,SAAA;;;;IAIE,KAAA;;;;;;MAME,OAAA;;;;;;MAMA,OAAA;IAAA;;;;IAKF,cAAA,GAAiB,yBAAA;;;;;IAKjB,eAAA;;;;;;;;;IASA,eAAA;;;;;;;;;IASA,qBAAA;;;;;;;;;;IAUA,mBAAA;;;;;;;;;;;;IAYA,OAAA;EAAA;;;;EAMF,QAAA;;;;;;;;;;;;;;;;;;IAkBE,UAAA,GAAa,KAAA,CAAM,oBAAA;EAAA;;;;;;;EASrB,OAAA;;;;;;;;;IASE,OAAA;;;;;;;;IASA,OAAA;EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;AAcA;;;KAAY,aAAA;EA8BF;;;EA1BR,MAAA;IAkKiD;;;IA9J/C,IAAA;IA+PkB;;;IA3PlB,IAAA;IAIA;;;IAAA,cAAA;EAAA;EA+BA;;;;;;;;;;;EAjBF,KAAA,GAAQ,IAAA,CAAK,YAAA;IAkHb;;;;;IA5GE,MAAA;IAkI+C;;;;;;;;;;IAvH/C,YAAA;IAsMF;;;;;IAhME,OAAA;IA6OA;;AAAO;;;;IAtOP,0BAAA;;;;;;;;;;;;;;;;;IAiBA,YAAA;;;;;;;;;;;;;;;;IAgBA,OAAA;;;;;;IAMA,MAAA;;;;;;IAMA,SAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,UAAA,GAAa,SAAA;;;;EAKb,GAAA;IACE,QAAA,GAAW,UAAA;EAAA;;;;EAMb,SAAA;;;;IAIE,KAAA;;;;;;MAME,OAAA;;;;;;MAMA,OAAA;IAAA;;;;;IAMF,cAAA,GAAiB,yBAAA,KAA8B,2BAAA;;;;;IAK/C,eAAA;;;;;;;;;IASA,eAAA;;;;;;;;;IASA,qBAAA;;;;;;;;;;IAUA,mBAAA;;;;;;;;;;;;IAYA,OAAA;;;;;;;;;;IAUA,QAAA;;;;;;;;;IASA,GAAA;8CAIM,IAAA;MAEA,KAAA;MAEA,WAAA;IAAA;EAAA;;;;EAOR,QAAA;;;;;;;;;;;;;;;;;;IAkBE,UAAA,GAAa,KAAA,CAAM,oBAAA;EAAA;;;;;;;EASrB,OAAA;;;;;;;;;IASE,OAAA;;;;;;;;IASA,OAAA;EAAA;AAAA"}