@warlock.js/core 5.30.0 → 5.32.0

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/utils/sleep.d.mts

@@ -1,5 +1,4 @@
 //#region ../../packages/core/src/utils/sleep.d.ts
-declare function sleep(ms: number): Promise<unknown>;
+export declare function sleep(ms: number): Promise<unknown>;
 //#endregion
-export { sleep };
 //# sourceMappingURL=sleep.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sleep.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/sleep.ts"],"mappings":";iBAAgB,KAAA,CAAM,EAAA,WAAU,OAAA"}
+{"version":3,"file":"sleep.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/sleep.ts"],"mappings":";wBAAgB,MAAM,aAAU"}

package/esm/utils/sluggable.d.mts

@@ -1,10 +1,8 @@
 import { Model } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/utils/sluggable.d.ts
 /**
  * Used for model castings
  */
-declare function sluggable(generateFrom: string, slugLocaleCode?: string): (model: Model) => any;
+export declare function sluggable(generateFrom: string, slugLocaleCode?: string): (model: Model) => any;
 //#endregion
-export { sluggable };
 //# sourceMappingURL=sluggable.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sluggable.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/sluggable.ts"],"mappings":";;;;;AAMA;iBAAgB,SAAA,CAAU,YAAA,UAAsB,cAAA,aACtC,KAAA,EAAO,KAAK"}
+{"version":3,"file":"sluggable.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/sluggable.ts"],"mappings":";;;;;wBAMgB,UAAU,sBAAsB,2BAAqB,OACpD"}

package/esm/utils/to-json.d.mts

@@ -1,5 +1,4 @@
 //#region ../../packages/core/src/utils/to-json.d.ts
-declare function toJson(value: any): Promise<any>;
+export declare function toJson(value: any): Promise<any>;
 //#endregion
-export { toJson };
 //# sourceMappingURL=to-json.d.mts.map

package/esm/utils/to-json.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"to-json.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/to-json.ts"],"mappings":";iBAEsB,MAAA,CAAO,KAAA,QAAa,OAAO"}
+{"version":3,"file":"to-json.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/to-json.ts"],"mappings":";wBAEsB,OAAO,aAAa"}

package/esm/utils/types.d.mts

@@ -1,5 +1,5 @@
 //#region ../../packages/core/src/utils/types.d.ts
-type AppConfigurations = {
+export type AppConfigurations = {
   /**
    * Set default timezone
    */
@@ -24,5 +24,4 @@ type AppConfigurations = {
   locales?: string[];
 };
 //#endregion
-export { AppConfigurations };
 //# sourceMappingURL=types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/types.ts"],"mappings":";KAAY,iBAAA;EAAA;;;EAIV,QAAA;EAAA;;;EAIA,OAAA;EAcA;;AAAO;;;EARP,UAAA;;;;EAIA,WAAA;;;;EAIA,OAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/types.ts"],"mappings":";YAAY;;;;EAIV;;;;EAIA;;;;;;EAMA;;;;EAIA;;;;EAIA"}

package/esm/utils/urls.d.mts

@@ -2,23 +2,22 @@
 /**
  * Set base url
  */
-declare function setBaseUrl(url: string): void;
+export declare function setBaseUrl(url: string): void;
 /**
  * Get full path for the given path
  */
-declare function url(path?: string): string;
+export declare function url(path?: string): string;
 /**
  * Get uploads url
  */
-declare function uploadsUrl(path?: string): string;
+export declare function uploadsUrl(path?: string): string;
 /**
  * Get full path for the given path related to public route
  */
-declare function publicUrl(path?: string): string;
+export declare function publicUrl(path?: string): string;
 /**
  * Assets url
  */
-declare function assetsUrl(path?: string): string;
+export declare function assetsUrl(path?: string): string;
 //#endregion
-export { assetsUrl, publicUrl, setBaseUrl, uploadsUrl, url };
 //# sourceMappingURL=urls.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"urls.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/urls.ts"],"mappings":";;AAOA;;iBAAgB,UAAA,CAAW,GAAW;;AAAA;AAOtC;iBAAgB,GAAA,CAAI,IAAS;;;AAAA;iBAOb,UAAA,CAAW,IAAS;;;;iBAOpB,SAAA,CAAU,IAAS;AAAnC;;;AAAA,iBAOgB,SAAA,CAAU,IAAS"}
+{"version":3,"file":"urls.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/urls.ts"],"mappings":";;;;wBAOgB,WAAW;;;;wBAOX,IAAI;;;;wBAOJ,WAAW;;;;wBAOX,UAAU;;;;wBAOV,UAAU"}

package/esm/utils/version-compare.d.mts

@@ -14,7 +14,6 @@
  * (`1.2.0` > `1.2.0-beta`). Unparseable input yields `false` — we never nag
  * on a version string we can't understand.
  */
-declare function isNewerVersion(latest: string, current: string): boolean;
+export declare function isNewerVersion(latest: string, current: string): boolean;
 //#endregion
-export { isNewerVersion };
 //# sourceMappingURL=version-compare.d.mts.map

package/esm/utils/version-compare.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version-compare.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/version-compare.ts"],"mappings":";;AAiHA;;;;AAA8D;;;;;;;;;;iBAA9C,cAAA,CAAe,MAAA,UAAgB,OAAe"}
+{"version":3,"file":"version-compare.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/version-compare.ts"],"mappings":";;;;;;;;;;;;;;;;wBAiHgB,eAAe,gBAAgB"}

package/esm/validation/database/exists-except-current-id.d.mts

@@ -1,11 +1,10 @@
 import { ExistsExceptCurrentIdRuleOptions } from "./types.mjs";
+import "../types.mjs";
 import { SchemaRule } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/validation/database/exists-except-current-id.d.ts
 /**
  * Exists except current ID rule
  */
-declare const existsExceptCurrentIdRule: SchemaRule<ExistsExceptCurrentIdRuleOptions>;
+export declare const existsExceptCurrentIdRule: SchemaRule<ExistsExceptCurrentIdRuleOptions>;
 //#endregion
-export { existsExceptCurrentIdRule };
 //# sourceMappingURL=exists-except-current-id.d.mts.map

package/esm/validation/database/exists-except-current-id.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"exists-except-current-id.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/exists-except-current-id.ts"],"mappings":";;;;;;;cAQa,yBAAA,EAA2B,UAAU,CAAC,gCAAA"}
+{"version":3,"file":"exists-except-current-id.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/exists-except-current-id.ts"],"mappings":";;;;;;;qBAQa,2BAA2B,WAAW"}

package/esm/validation/database/exists-except-current-user.d.mts

@@ -1,11 +1,10 @@
 import { ExistsExceptCurrentUserRuleOptions } from "./types.mjs";
+import "../types.mjs";
 import { SchemaRule } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/validation/database/exists-except-current-user.d.ts
 /**
  * Exists except current user rule
  */
-declare const existsExceptCurrentUserRule: SchemaRule<ExistsExceptCurrentUserRuleOptions>;
+export declare const existsExceptCurrentUserRule: SchemaRule<ExistsExceptCurrentUserRuleOptions>;
 //#endregion
-export { existsExceptCurrentUserRule };
 //# sourceMappingURL=exists-except-current-user.d.mts.map

package/esm/validation/database/exists-except-current-user.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"exists-except-current-user.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/exists-except-current-user.ts"],"mappings":";;;;;;;cAQa,2BAAA,EAA6B,UAAU,CAAC,kCAAA"}
+{"version":3,"file":"exists-except-current-user.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/exists-except-current-user.ts"],"mappings":";;;;;;;qBAQa,6BAA6B,WAAW"}

package/esm/validation/database/index.d.mts

@@ -2,4 +2,5 @@ import { existsExceptCurrentIdRule } from "./exists-except-current-id.mjs";
 import { existsExceptCurrentUserRule } from "./exists-except-current-user.mjs";
 import { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions } from "./types.mjs";
 import { uniqueExceptCurrentIdRule } from "./unique-except-current-id.mjs";
-import { uniqueExceptCurrentUserRule } from "./unique-except-current-user.mjs";
+import { uniqueExceptCurrentUserRule } from "./unique-except-current-user.mjs";
+export { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, existsExceptCurrentIdRule, existsExceptCurrentUserRule, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule };

package/esm/validation/database/index.mjs

@@ -3,4 +3,4 @@ import { existsExceptCurrentUserRule } from "./exists-except-current-user.mjs";
 import { uniqueExceptCurrentIdRule } from "./unique-except-current-id.mjs";
 import { uniqueExceptCurrentUserRule } from "./unique-except-current-user.mjs";
 
-export {  };
+export { existsExceptCurrentIdRule, existsExceptCurrentUserRule, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule };

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

@@ -1,32 +1,36 @@
 import { BaseQueryRuleOptions, BaseUniqueRuleOptions } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/validation/database/types.d.ts
 /**
  * Options for unique except current user rule
  */
-type UniqueExceptCurrentUserRuleOptions = BaseUniqueRuleOptions & {
-  /** Column for current user filter (default: id) */exceptCurrentUserColumn?: string; /** Value field from current user model (default: id) */
+export type UniqueExceptCurrentUserRuleOptions = BaseUniqueRuleOptions & {
+  /** Column for current user filter (default: id) */
+  exceptCurrentUserColumn?: string;
+  /** Value field from current user model (default: id) */
   exceptCurrentUserValue?: string;
 };
 /**
  * Options for unique except current id rule
  */
-type UniqueExceptCurrentIdRuleOptions = BaseUniqueRuleOptions & {
-  /** Column for current id filter (default: id) */exceptCurrentIdColumn?: string;
+export type UniqueExceptCurrentIdRuleOptions = BaseUniqueRuleOptions & {
+  /** Column for current id filter (default: id) */
+  exceptCurrentIdColumn?: string;
 };
 /**
  * Options for exists except current user rule
  */
-type ExistsExceptCurrentUserRuleOptions = BaseQueryRuleOptions & {
-  /** Column for current user filter (default: id) */exceptCurrentUserColumn?: string; /** Value field from current user model (default: id) */
+export type ExistsExceptCurrentUserRuleOptions = BaseQueryRuleOptions & {
+  /** Column for current user filter (default: id) */
+  exceptCurrentUserColumn?: string;
+  /** Value field from current user model (default: id) */
   exceptCurrentUserValue?: string;
 };
 /**
  * Options for exists except current id rule
  */
-type ExistsExceptCurrentIdRuleOptions = BaseQueryRuleOptions & {
-  /** Column for current id filter (default: id) */exceptCurrentIdColumn?: string;
+export type ExistsExceptCurrentIdRuleOptions = BaseQueryRuleOptions & {
+  /** Column for current id filter (default: id) */
+  exceptCurrentIdColumn?: string;
 };
 //#endregion
-export { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions };
 //# sourceMappingURL=types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/types.ts"],"mappings":";;;;;AAKA;KAAY,kCAAA,GAAqC,qBAAqB;qDAEpE,uBAAA,WAF+C;EAI/C,sBAAA;AAAA;;AAAsB;AAMxB;KAAY,gCAAA,GAAmC,qBAAqB;mDAElE,qBAAqB;AAAA;AAMvB;;;AAAA,KAAY,kCAAA,GAAqC,oBAAoB;EAApB,mDAE/C,uBAAA,WAEA;EAAA,sBAAA;AAAA;AAMF;;;AAAA,KAAY,gCAAA,GAAmC,oBAAoB;EAE5C,iDAArB,qBAAqB;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/types.ts"],"mappings":";;;;;YAKY,qCAAqC;;EAE/C;;EAEA;;;;;YAMU,mCAAmC;;EAE7C;;;;;YAMU,qCAAqC;;EAE/C;;EAEA;;;;;YAMU,mCAAmC;;EAE7C"}

package/esm/validation/database/unique-except-current-id.d.mts

@@ -1,11 +1,10 @@
 import { UniqueExceptCurrentIdRuleOptions } from "./types.mjs";
+import "../types.mjs";
 import { SchemaRule } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/validation/database/unique-except-current-id.d.ts
 /**
  * Unique except current ID rule
  */
-declare const uniqueExceptCurrentIdRule: SchemaRule<UniqueExceptCurrentIdRuleOptions>;
+export declare const uniqueExceptCurrentIdRule: SchemaRule<UniqueExceptCurrentIdRuleOptions>;
 //#endregion
-export { uniqueExceptCurrentIdRule };
 //# sourceMappingURL=unique-except-current-id.d.mts.map

package/esm/validation/database/unique-except-current-id.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"unique-except-current-id.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/unique-except-current-id.ts"],"mappings":";;;;;;;cAOa,yBAAA,EAA2B,UAAU,CAAC,gCAAA"}
+{"version":3,"file":"unique-except-current-id.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/unique-except-current-id.ts"],"mappings":";;;;;;;qBAOa,2BAA2B,WAAW"}

package/esm/validation/database/unique-except-current-user.d.mts

@@ -1,11 +1,10 @@
 import { UniqueExceptCurrentUserRuleOptions } from "./types.mjs";
+import "../types.mjs";
 import { SchemaRule } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/validation/database/unique-except-current-user.d.ts
 /**
  * Unique except current user rule
  */
-declare const uniqueExceptCurrentUserRule: SchemaRule<UniqueExceptCurrentUserRuleOptions>;
+export declare const uniqueExceptCurrentUserRule: SchemaRule<UniqueExceptCurrentUserRuleOptions>;
 //#endregion
-export { uniqueExceptCurrentUserRule };
 //# sourceMappingURL=unique-except-current-user.d.mts.map

package/esm/validation/database/unique-except-current-user.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"unique-except-current-user.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/unique-except-current-user.ts"],"mappings":";;;;;;;cASa,2BAAA,EAA6B,UAAU,CAAC,kCAAA"}
+{"version":3,"file":"unique-except-current-user.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/database/unique-except-current-user.ts"],"mappings":";;;;;;;qBASa,6BAA6B,WAAW"}

package/esm/validation/file/file.d.mts

@@ -1,26 +1,24 @@
 import { SchemaRule } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/validation/file/file.d.ts
 /**
  * File rule - validates uploaded file
  */
-declare const fileRule: SchemaRule;
+export declare const fileRule: SchemaRule;
 /**
  * Image rule - validates uploaded image
  */
-declare const imageRule: SchemaRule;
+export declare const imageRule: SchemaRule;
 /**
  * File extension rule - validates file extension
  */
-declare const fileExtensionRule: SchemaRule<{
+export declare const fileExtensionRule: SchemaRule<{
   extensions: string | string[];
 }>;
 /**
  * File type rule - validates MIME type
  */
-declare const fileTypeRule: SchemaRule<{
+export declare const fileTypeRule: SchemaRule<{
   mimeTypes: string | string[];
 }>;
 //#endregion
-export { fileExtensionRule, fileRule, fileTypeRule, imageRule };
 //# sourceMappingURL=file.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"file.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/file/file.ts"],"mappings":";;;;;AAMA;cAAa,QAAA,EAAU,UAStB;;;AAAA;cAKY,SAAA,EAAW,UAUvB;;;;cAKY,iBAAA,EAAmB,UAAU;EACxC,UAAU;AAAA;;;AAAA;cAsBC,YAAA,EAAc,UAAU;EAAG,SAAS;AAAA"}
+{"version":3,"file":"file.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/file/file.ts"],"mappings":";;;;;qBAMa,UAAU;;;;qBAcV,WAAW;;;;qBAeX,mBAAmB;EAC9B;;;;;qBAsBW,cAAc;EAAa"}

package/esm/validation/file/index.d.mts

@@ -1 +1,2 @@
-import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./file.mjs";
+import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./file.mjs";
+export { fileExtensionRule, fileRule, fileTypeRule, imageRule };

package/esm/validation/file/index.mjs

@@ -1,3 +1,3 @@
 import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./file.mjs";
 
-export {  };
+export { fileExtensionRule, fileRule, fileTypeRule, imageRule };

package/esm/validation/index.d.mts

@@ -3,6 +3,10 @@ import { existsExceptCurrentUserRule } from "./database/exists-except-current-us
 import { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions } from "./database/types.mjs";
 import { uniqueExceptCurrentIdRule } from "./database/unique-except-current-id.mjs";
 import { uniqueExceptCurrentUserRule } from "./database/unique-except-current-user.mjs";
+import "./database/index.mjs";
 import { FileValidator, uploadedFileMetadataSchema } from "./validators/file-validator.mjs";
-import { ValidationConfiguration } from "./types.mjs";
-import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./file/file.mjs";
+import "./validators/index.mjs";
+import { ValidationConfiguration, ValidationResponseConfiguration } from "./types.mjs";
+import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./file/file.mjs";
+import "./file/index.mjs";
+export { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FileValidator, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, ValidationConfiguration, ValidationResponseConfiguration, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fileExtensionRule, fileRule, fileTypeRule, imageRule, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, uploadedFileMetadataSchema };

package/esm/validation/index.mjs

@@ -8,4 +8,4 @@ import "./file/index.mjs";
 import { FileValidator, uploadedFileMetadataSchema } from "./validators/file-validator.mjs";
 import "./validators/index.mjs";
 
-export {  };
+export { FileValidator, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fileExtensionRule, fileRule, fileTypeRule, imageRule, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, uploadedFileMetadataSchema };

package/esm/validation/plugins/index.mjs

@@ -2,4 +2,4 @@ import { databasePlugin } from "./database-plugin.mjs";
 import { filePlugin } from "./file-plugin.mjs";
 import { localizedPlugin } from "./localized-plugin.mjs";
 
-export {  };
+export { databasePlugin, filePlugin, localizedPlugin };

package/esm/validation/types.d.mts

@@ -1,9 +1,12 @@
 import { UploadedFile } from "../http/uploaded-file.mjs";
+import "../http/index.mjs";
+import { Route } from "../router/types.mjs";
 import { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions } from "./database/types.mjs";
+import "./database/index.mjs";
 import { FileValidator } from "./validators/file-validator.mjs";
-import { ArrayValidator, BaseValidator, Infer, ObjectValidator, StandardSchemaV1, StringValidator, TranslateAttributeCallback, TranslateRuleCallback } from "@warlock.js/seal";
+import "./validators/index.mjs";
+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
 /**
  * The object shape produced by `v.localized()`'s inner `v.object({
@@ -60,7 +63,61 @@ declare module "@warlock.js/seal" {
     }): this;
   }
 }
-type ValidationConfiguration = {
+/**
+ * `validation.response`: how a failed schema validation is answered.
+ */
+export 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;
+};
+export 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 +148,5 @@ type ValidationConfiguration = {
   translateAttribute?: TranslateAttributeCallback;
 };
 //#endregion
-export { ValidationConfiguration };
+export type { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions };
 //# 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,wBAAwB,UAAU,iBAAiB;EACtD,YAAY,kBAAkB;EAC9B,OAAO;KAEP;EACE;EACA,OAAO,MAAM;;;YAME;IACf,OAAO,0BAA0B,gBAAgB,iBAAiB;IAClE,YACE,UAAU,gBAAgB,kBAAkB,6CAE5C,iBAAiB,GACjB,0BACG;MACH,WAAW,wBAAwB;QACjC,iBACA;MACE;MACA,OAAO,MAAM;;;YAKX;;IAER,wBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;;IAKJ,sBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;;IAKJ,wBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;;IAKJ,sBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;;YAMI;IACR,wBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;IAGJ,sBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;IAGJ,wBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;IAGJ,sBACE,OAAO,WAAW,iBAClB,cAAc,QAAQ;MACpB;;;;;;;YAiBI;;;;;;EAMV;;;;;;EAMA;;;;;;EAMA;;;;;;;EAOA;;;;;;;;;;;;EAYA,QAAQ,QAAQ,kBAAkB,OAAO;;YAG/B;;;;;EAKV,WAAW;;;;;;;EAOX;;;;;;;EAQA;;;;;;;EAOA;;;;;EAKA;;;;;EAKA,gBAAgB;;;;EAIhB,qBAAqB"}

package/esm/validation/validateAll.mjs

@@ -1,6 +1,7 @@
+import { validationFailureStatus } from "./validation-failure-status.mjs";
 import { Response } from "../http/response.mjs";
 import { v } from "@warlock.js/seal";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { log } from "@warlock.js/logger";
 import { merge } from "@mongez/reinforcements";
 
@@ -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);
@@ -99,7 +116,7 @@ async function validateAll(validation, request, response) {
 		if (result) {
 			log.info("validation", "failed", "Validation failed");
 			if (result instanceof Response) return result;
-			return response.send(result, config.get("validation.responseStatus", 400));
+			return response.send(result, baseConfig.get("validation.responseStatus", 400));
 		}
 		log.info("validation", "passed", "Validation passed");
 	}