stratal 0.0.18 → 0.0.20

package/dist/types-cySNS_lp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-cySNS_lp.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,WAAA,uBAAkC,IAAA,YAAgB,CAAA"}

package/dist/{usage-generator-Cl1HPlUp.mjs → usage-generator-BUdlhnCK.mjs}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-D1SwGrFN.mjs";
-import { i as dimWhite, n as cyan, r as dim, s as yellow, t as bold } from "./colors-BTAnQRGU.mjs";
+import { i as dimWhite, n as cyan, r as dim, s as yellow, t as bold } from "./colors-DJaRDXoS.mjs";
 //#region src/quarry/usage-generator.ts
 var usage_generator_exports = /* @__PURE__ */ __exportAll({
 	generateListing: () => generateListing,
@@ -155,4 +155,4 @@ function formatTable(rows) {
 //#endregion
 export { usage_generator_exports as n, generateUsage as t };
 
-//# sourceMappingURL=usage-generator-Cl1HPlUp.mjs.map
+//# sourceMappingURL=usage-generator-BUdlhnCK.mjs.map

package/dist/{usage-generator-Cl1HPlUp.mjs.map → usage-generator-BUdlhnCK.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"usage-generator-Cl1HPlUp.mjs","names":[],"sources":["../src/quarry/usage-generator.ts"],"sourcesContent":["import { bold, cyan, dim, dimWhite, yellow } from './colors'\nimport type { ParsedSignature } from './types'\n\n/**\n * Generate formatted help/usage text from a parsed signature.\n *\n * Pure function, edge-compatible.\n */\nexport function generateUsage(signature: ParsedSignature, description?: string): string {\n  const lines: string[] = []\n\n  // Usage line\n  lines.push(`${bold('Usage:')} ${bold(cyan('quarry ' + buildUsageLine(signature)))}`)\n\n  // Description\n  if (description) {\n    lines.push('')\n    lines.push(description)\n  }\n\n  // Arguments section\n  if (signature.arguments.length > 0) {\n    lines.push('')\n    lines.push(bold(yellow('Arguments:')))\n    const argRows = signature.arguments.map((arg) => {\n      const label = arg.name\n      const parts: string[] = []\n\n      if (arg.description) parts.push(arg.description)\n\n      if (arg.isArray) {\n        parts.push('(variadic)')\n      } else if (arg.required) {\n        parts.push('(required)')\n      } else if (arg.default !== undefined) {\n        parts.push(dim(`(default: ${arg.default})`))\n      } else {\n        parts.push('(optional)')\n      }\n\n      return [label, parts.join(' ')] as const\n    })\n    lines.push(...formatTable(argRows))\n  }\n\n  // Options section\n  if (signature.options.length > 0) {\n    lines.push('')\n    lines.push(bold(yellow('Options:')))\n    const optRows = signature.options.map((opt) => {\n      const flagParts: string[] = []\n      if (opt.alias) flagParts.push(`-${opt.alias},`)\n      flagParts.push(`--${opt.name}`)\n\n      const label = flagParts.join(' ')\n      const parts: string[] = []\n\n      if (opt.description) parts.push(opt.description)\n      if (!opt.isFlag && !opt.description) parts.push('Accepts a value')\n      if (opt.isFlag && !opt.description) parts.push('Boolean flag')\n      if (opt.isArray) parts.push('(multiple)')\n      if (opt.default !== undefined) parts.push(dim(`(default: ${opt.default})`))\n\n      return [label, parts.join(' ')] as const\n    })\n    lines.push(...formatTable(optRows))\n  }\n\n  return lines.join('\\n')\n}\n\nexport interface ListingOptions {\n  binaryName?: string\n  binaryLabel?: string\n  binaryVersion?: string\n}\n\n/**\n * Generate a compact command listing with visual hierarchy.\n */\nexport function generateListing(\n  commands: { name: string; description?: string; aliases: string[] }[],\n  signatures: Map<string, ParsedSignature>,\n  options?: ListingOptions,\n): string {\n  const bin = options?.binaryName ?? 'quarry'\n  const label = options?.binaryLabel ?? 'Quarry CLI'\n  const version = options?.binaryVersion\n\n  const lines: string[] = []\n\n  // Header\n  lines.push(bold(`${label}${version ? ` v${version}` : ''}`))\n  lines.push('')\n\n  // Usage\n  lines.push(bold(yellow('Usage')))\n  lines.push(`  $ ${bin} <command> [options]`)\n  lines.push('')\n\n  // Commands\n  if (commands.length === 0) {\n    lines.push('No registered commands.')\n    return lines.join('\\n')\n  }\n\n  lines.push(bold(yellow('Commands')))\n\n  const termWidth = typeof process !== 'undefined'\n    ? (process.stdout.columns as number | undefined) ?? 80\n    : 80\n\n  for (let i = 0; i < commands.length; i++) {\n    const cmd = commands[i]\n    const sig = signatures.get(cmd.name)\n    const sigParts: string[] = [cyan(cmd.name)]\n\n    if (cmd.aliases.length > 0) {\n      sigParts.push(cyan(`(alias: ${cmd.aliases.join(', ')})`))\n    }\n\n    if (sig) {\n      const inlineParts: string[] = []\n      for (const arg of sig.arguments) {\n        inlineParts.push(formatArgPlaceholder(arg))\n      }\n\n      for (const opt of sig.options) {\n        const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n        inlineParts.push(`[${flagStr}]`)\n      }\n\n      if (inlineParts.length > 0) {\n        sigParts.push(dim(inlineParts.join(' ')))\n      }\n    }\n\n    const sigLine = '  ' + sigParts.join(' ')\n    lines.push(...wrapLine(sigLine, termWidth, '      '))\n\n    if (cmd.description) {\n      lines.push(`    ${dimWhite(cmd.description)}`)\n    }\n\n    if (i < commands.length - 1) {\n      lines.push('')\n    }\n  }\n\n  lines.push('')\n\n  // Footer\n  lines.push(dimWhite(`Run ${bin} help <command> for detailed information.`))\n\n  return lines.join('\\n')\n}\n\n/** Format a single argument into its placeholder representation (e.g. `<name>`, `[name=default]`). */\nfunction formatArgPlaceholder(arg: ParsedSignature['arguments'][number]): string {\n  if (arg.isArray) return `<${arg.name}...>`\n  if (arg.required) return `<${arg.name}>`\n  if (arg.default !== undefined) return `[${arg.name}=${arg.default}]`\n  return `[${arg.name}]`\n}\n\n/** Build the inline usage line showing the command name with argument and option placeholders. */\nfunction buildUsageLine(signature: ParsedSignature): string {\n  const parts = [signature.name]\n\n  for (const arg of signature.arguments) {\n    parts.push(formatArgPlaceholder(arg))\n  }\n\n  for (const opt of signature.options) {\n    const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n\n    if (opt.isFlag) {\n      parts.push(`[${flagStr}]`)\n    } else if (opt.isArray) {\n      parts.push(`[${flagStr} <value...>]`)\n    } else {\n      parts.push(`[${flagStr} <value>]`)\n    }\n  }\n\n  return parts.join(' ')\n}\n\n// eslint-disable-next-line no-control-regex\nconst ANSI_RE = /\\x1b\\[[0-9;]*m/g\n\n/** Remove ANSI escape sequences from a string. */\nfunction stripAnsi(s: string): string {\n  return s.replace(ANSI_RE, '')\n}\n\n// eslint-disable-next-line no-control-regex\nconst TOKEN_RE = /(?:\\x1b\\[[0-9;]*m)*[^\\s\\x1b]+(?:\\x1b\\[[0-9;]*m)*/g\n\n/** Wrap a single line at word boundaries, preserving ANSI codes across wrapped segments. */\nfunction wrapLine(text: string, maxWidth: number, continuationIndent: string): string[] {\n  const visibleLen = stripAnsi(text).length\n  if (visibleLen <= maxWidth) return [text]\n\n  const tokens = text.match(TOKEN_RE) ?? [text]\n\n  const lines: string[] = []\n  let currentLine = ''\n  let currentVisibleLen = 0\n\n  for (const token of tokens) {\n    const tokenVisible = stripAnsi(token).length\n    const separator = currentLine === '' ? '' : ' '\n    const separatorLen = separator.length\n\n    if (currentLine !== '' && currentVisibleLen + separatorLen + tokenVisible > maxWidth) {\n      lines.push(currentLine)\n      currentLine = continuationIndent + token\n      currentVisibleLen = continuationIndent.length + tokenVisible\n    } else {\n      currentLine += separator + token\n      currentVisibleLen += separatorLen + tokenVisible\n    }\n  }\n\n  if (currentLine !== '') {\n    lines.push(currentLine)\n  }\n\n  return lines\n}\n\n/** Format label/description pairs into aligned two-column table rows. */\nfunction formatTable(rows: readonly (readonly [string, string])[]): string[] {\n  if (rows.length === 0) return []\n\n  const maxLabel = Math.max(...rows.map(([label]) => stripAnsi(label).length))\n  const padding = 4\n\n  return rows.map(([label, desc]) => {\n    const visibleLen = stripAnsi(label).length\n    const pad = ' '.repeat(maxLabel - visibleLen + padding)\n    return `  ${label}${pad}${desc}`\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"usage-generator-BUdlhnCK.mjs","names":[],"sources":["../src/quarry/usage-generator.ts"],"sourcesContent":["import { bold, cyan, dim, dimWhite, yellow } from './colors'\nimport type { ParsedSignature } from './types'\n\n/**\n * Generate formatted help/usage text from a parsed signature.\n *\n * Pure function, edge-compatible.\n */\nexport function generateUsage(signature: ParsedSignature, description?: string): string {\n  const lines: string[] = []\n\n  // Usage line\n  lines.push(`${bold('Usage:')} ${bold(cyan('quarry ' + buildUsageLine(signature)))}`)\n\n  // Description\n  if (description) {\n    lines.push('')\n    lines.push(description)\n  }\n\n  // Arguments section\n  if (signature.arguments.length > 0) {\n    lines.push('')\n    lines.push(bold(yellow('Arguments:')))\n    const argRows = signature.arguments.map((arg) => {\n      const label = arg.name\n      const parts: string[] = []\n\n      if (arg.description) parts.push(arg.description)\n\n      if (arg.isArray) {\n        parts.push('(variadic)')\n      } else if (arg.required) {\n        parts.push('(required)')\n      } else if (arg.default !== undefined) {\n        parts.push(dim(`(default: ${arg.default})`))\n      } else {\n        parts.push('(optional)')\n      }\n\n      return [label, parts.join(' ')] as const\n    })\n    lines.push(...formatTable(argRows))\n  }\n\n  // Options section\n  if (signature.options.length > 0) {\n    lines.push('')\n    lines.push(bold(yellow('Options:')))\n    const optRows = signature.options.map((opt) => {\n      const flagParts: string[] = []\n      if (opt.alias) flagParts.push(`-${opt.alias},`)\n      flagParts.push(`--${opt.name}`)\n\n      const label = flagParts.join(' ')\n      const parts: string[] = []\n\n      if (opt.description) parts.push(opt.description)\n      if (!opt.isFlag && !opt.description) parts.push('Accepts a value')\n      if (opt.isFlag && !opt.description) parts.push('Boolean flag')\n      if (opt.isArray) parts.push('(multiple)')\n      if (opt.default !== undefined) parts.push(dim(`(default: ${opt.default})`))\n\n      return [label, parts.join(' ')] as const\n    })\n    lines.push(...formatTable(optRows))\n  }\n\n  return lines.join('\\n')\n}\n\nexport interface ListingOptions {\n  binaryName?: string\n  binaryLabel?: string\n  binaryVersion?: string\n}\n\n/**\n * Generate a compact command listing with visual hierarchy.\n */\nexport function generateListing(\n  commands: { name: string; description?: string; aliases: string[] }[],\n  signatures: Map<string, ParsedSignature>,\n  options?: ListingOptions,\n): string {\n  const bin = options?.binaryName ?? 'quarry'\n  const label = options?.binaryLabel ?? 'Quarry CLI'\n  const version = options?.binaryVersion\n\n  const lines: string[] = []\n\n  // Header\n  lines.push(bold(`${label}${version ? ` v${version}` : ''}`))\n  lines.push('')\n\n  // Usage\n  lines.push(bold(yellow('Usage')))\n  lines.push(`  $ ${bin} <command> [options]`)\n  lines.push('')\n\n  // Commands\n  if (commands.length === 0) {\n    lines.push('No registered commands.')\n    return lines.join('\\n')\n  }\n\n  lines.push(bold(yellow('Commands')))\n\n  const termWidth = typeof process !== 'undefined'\n    ? (process.stdout.columns as number | undefined) ?? 80\n    : 80\n\n  for (let i = 0; i < commands.length; i++) {\n    const cmd = commands[i]\n    const sig = signatures.get(cmd.name)\n    const sigParts: string[] = [cyan(cmd.name)]\n\n    if (cmd.aliases.length > 0) {\n      sigParts.push(cyan(`(alias: ${cmd.aliases.join(', ')})`))\n    }\n\n    if (sig) {\n      const inlineParts: string[] = []\n      for (const arg of sig.arguments) {\n        inlineParts.push(formatArgPlaceholder(arg))\n      }\n\n      for (const opt of sig.options) {\n        const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n        inlineParts.push(`[${flagStr}]`)\n      }\n\n      if (inlineParts.length > 0) {\n        sigParts.push(dim(inlineParts.join(' ')))\n      }\n    }\n\n    const sigLine = '  ' + sigParts.join(' ')\n    lines.push(...wrapLine(sigLine, termWidth, '      '))\n\n    if (cmd.description) {\n      lines.push(`    ${dimWhite(cmd.description)}`)\n    }\n\n    if (i < commands.length - 1) {\n      lines.push('')\n    }\n  }\n\n  lines.push('')\n\n  // Footer\n  lines.push(dimWhite(`Run ${bin} help <command> for detailed information.`))\n\n  return lines.join('\\n')\n}\n\n/** Format a single argument into its placeholder representation (e.g. `<name>`, `[name=default]`). */\nfunction formatArgPlaceholder(arg: ParsedSignature['arguments'][number]): string {\n  if (arg.isArray) return `<${arg.name}...>`\n  if (arg.required) return `<${arg.name}>`\n  if (arg.default !== undefined) return `[${arg.name}=${arg.default}]`\n  return `[${arg.name}]`\n}\n\n/** Build the inline usage line showing the command name with argument and option placeholders. */\nfunction buildUsageLine(signature: ParsedSignature): string {\n  const parts = [signature.name]\n\n  for (const arg of signature.arguments) {\n    parts.push(formatArgPlaceholder(arg))\n  }\n\n  for (const opt of signature.options) {\n    const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n\n    if (opt.isFlag) {\n      parts.push(`[${flagStr}]`)\n    } else if (opt.isArray) {\n      parts.push(`[${flagStr} <value...>]`)\n    } else {\n      parts.push(`[${flagStr} <value>]`)\n    }\n  }\n\n  return parts.join(' ')\n}\n\n// eslint-disable-next-line no-control-regex\nconst ANSI_RE = /\\x1b\\[[0-9;]*m/g\n\n/** Remove ANSI escape sequences from a string. */\nfunction stripAnsi(s: string): string {\n  return s.replace(ANSI_RE, '')\n}\n\n// eslint-disable-next-line no-control-regex\nconst TOKEN_RE = /(?:\\x1b\\[[0-9;]*m)*[^\\s\\x1b]+(?:\\x1b\\[[0-9;]*m)*/g\n\n/** Wrap a single line at word boundaries, preserving ANSI codes across wrapped segments. */\nfunction wrapLine(text: string, maxWidth: number, continuationIndent: string): string[] {\n  const visibleLen = stripAnsi(text).length\n  if (visibleLen <= maxWidth) return [text]\n\n  const tokens = text.match(TOKEN_RE) ?? [text]\n\n  const lines: string[] = []\n  let currentLine = ''\n  let currentVisibleLen = 0\n\n  for (const token of tokens) {\n    const tokenVisible = stripAnsi(token).length\n    const separator = currentLine === '' ? '' : ' '\n    const separatorLen = separator.length\n\n    if (currentLine !== '' && currentVisibleLen + separatorLen + tokenVisible > maxWidth) {\n      lines.push(currentLine)\n      currentLine = continuationIndent + token\n      currentVisibleLen = continuationIndent.length + tokenVisible\n    } else {\n      currentLine += separator + token\n      currentVisibleLen += separatorLen + tokenVisible\n    }\n  }\n\n  if (currentLine !== '') {\n    lines.push(currentLine)\n  }\n\n  return lines\n}\n\n/** Format label/description pairs into aligned two-column table rows. */\nfunction formatTable(rows: readonly (readonly [string, string])[]): string[] {\n  if (rows.length === 0) return []\n\n  const maxLabel = Math.max(...rows.map(([label]) => stripAnsi(label).length))\n  const padding = 4\n\n  return rows.map(([label, desc]) => {\n    const visibleLen = stripAnsi(label).length\n    const pad = ' '.repeat(maxLabel - visibleLen + padding)\n    return `  ${label}${pad}${desc}`\n  })\n}\n"],"mappings":"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"}

package/dist/{validation-B4bePOa_.mjs → validation-DtJwAv7O.mjs}

@@ -1,6 +1,6 @@
 import { n as __reExport, t as __exportAll } from "./chunk-D1SwGrFN.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
-import { OpenAPIHono, z as z$1 } from "@hono/zod-openapi";
+import { OpenAPIHono, z, z as z$2 } from "@hono/zod-openapi";
 import { ZodError } from "zod";
 //#region src/i18n/validation/validation.error-map.ts
 /**
@@ -163,32 +163,86 @@ function runWithErrorMapContext(context, fn) {
 * const schema = z.string().email(withI18n('validation.email'))
 * ```
 *
-* Note: This is the backend version using AsyncLocalStorage.
-* For frontend, use withI18nFrontend from the frontend validation module
-*
 * @param key - Message key from shared i18n messages (type-safe via MessageKeys)
 * @param params - Optional interpolation parameters for the message
 * @returns Zod error configuration object with translated message
 */
 function withI18n(key, params) {
-	return { error: () => {
+	return { error: (_issue) => {
 		const context = errorMapContextStorage.getStore();
 		return context ? context.t(key, params) : "Invalid input";
 	} };
 }
 //#endregion
+//#region src/i18n/validation/cuid2.ts
+/**
+* Default cuid2 shape: 24-32 lowercase-alphanumeric chars, starting with a
+* letter. Matches what `@paralleldrive/cuid2` produces with default settings
+* and what most apps expect when they say "cuid2".
+*
+* Used as the default for {@link cuid2}; exposed for callers who want to
+* compose it into other patterns.
+*/
+const CUID2_REGEX = /^[a-z][0-9a-z]{23,31}$/;
+/**
+* Stratal's cuid2 validator — a stricter drop-in for Zod 4.3.6's `z.cuid2()`.
+*
+* **Why this exists.** Zod 4.3.6's built-in `z.cuid2()` uses the regex
+* `/^[0-9a-z]+$/`, which accepts *any* non-empty lowercase-alphanumeric
+* string (including 2-letter locale prefixes like `'sw'`). That makes it
+* effectively useless as a tenant-id / external-id validator.
+*
+* This helper layers the proper shape regex on top of `z.cuid2()`, so:
+* - validation actually enforces cuid2 shape;
+* - the schema still carries `z.cuid2()`'s OpenAPI metadata (i.e. spec
+*   output keeps `format: 'cuid2'`).
+*
+* @example
+* ```ts
+* import { z, withI18n } from 'stratal/validation'
+* import { cuid2 } from 'stratal/validation'
+*
+* // Default 24-32 char cuid2:
+* router.prefix('/:tenantId', z.object({ tenantId: cuid2() }))
+*
+* // Custom regex (e.g. fixed-length 24):
+* router.prefix('/:tenantId', z.object({
+*   tenantId: cuid2({ pattern: /^[a-z][0-9a-z]{23}$/ }),
+* }))
+*
+* // Custom error message:
+* cuid2(withI18n('tenants.errors.invalidId'))
+*
+* // Compose: chain anything Zod string accepts
+* cuid2().describe('Tenant ID')
+* ```
+*
+* @param options.pattern - Override the shape regex. Defaults to {@link CUID2_REGEX}.
+* @param options.error - Custom error message (string or i18n key) for the regex check.
+*/
+function cuid2(options) {
+	const pattern = options?.pattern ?? CUID2_REGEX;
+	return z.cuid2({
+		pattern,
+		error: typeof options?.error === "string" ? options?.error : void 0,
+		...typeof options?.error === "function" ? { error: options?.error } : {}
+	});
+}
+//#endregion
 //#region src/i18n/validation/index.ts
 var validation_exports = /* @__PURE__ */ __exportAll({
+	CUID2_REGEX: () => CUID2_REGEX,
 	OpenAPIHono: () => OpenAPIHono,
 	ZodError: () => ZodError,
 	backendErrorMap: () => backendErrorMap,
+	cuid2: () => cuid2,
 	runWithErrorMapContext: () => runWithErrorMapContext,
 	withI18n: () => withI18n,
-	z: () => z$1
+	z: () => z$2
 });
 import * as import__hono_zod_openapi from "@hono/zod-openapi";
 __reExport(validation_exports, import__hono_zod_openapi);
 //#endregion
-export { withI18n as a, z$1 as i, ZodError as n, backendErrorMap as o, validation_exports as r, runWithErrorMapContext as s, OpenAPIHono as t };
+export { CUID2_REGEX as a, backendErrorMap as c, z$2 as i, runWithErrorMapContext as l, ZodError as n, cuid2 as o, validation_exports as r, withI18n as s, OpenAPIHono as t };
 
-//# sourceMappingURL=validation-B4bePOa_.mjs.map
+//# sourceMappingURL=validation-DtJwAv7O.mjs.map

package/dist/validation-DtJwAv7O.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-DtJwAv7O.mjs","names":[],"sources":["../src/i18n/validation/validation.error-map.ts","../src/i18n/validation/validation.context.ts","../src/i18n/validation/with-i18n.ts","../src/i18n/validation/cuid2.ts","../src/i18n/validation/index.ts"],"sourcesContent":["import type {\n  $ZodErrorMap,\n  $ZodIssueInvalidKey,\n  $ZodIssueInvalidStringFormat,\n  $ZodIssueInvalidType,\n  $ZodIssueInvalidUnion,\n  $ZodIssueNotMultipleOf,\n  $ZodIssueTooBig,\n  $ZodIssueTooSmall,\n  $ZodIssueUnrecognizedKeys,\n  $ZodRawIssue,\n} from 'zod/v4/core'\nimport type { MessageKeys } from '../i18n.types'\nimport type { ErrorMapContext } from './validation.types'\n\n/**\n * Type guards for narrowing Zod v4 issue types\n */\nfunction isInvalidType(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidType> {\n  return issue.code === 'invalid_type'\n}\n\nfunction isTooBig(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooBig> {\n  return issue.code === 'too_big'\n}\n\nfunction isTooSmall(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooSmall> {\n  return issue.code === 'too_small'\n}\n\nfunction isInvalidFormat(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidStringFormat> {\n  return issue.code === 'invalid_format'\n}\n\nfunction isNotMultipleOf(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueNotMultipleOf> {\n  return issue.code === 'not_multiple_of'\n}\n\nfunction isUnrecognizedKeys(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueUnrecognizedKeys> {\n  return issue.code === 'unrecognized_keys'\n}\n\nfunction isInvalidUnion(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidUnion> {\n  return issue.code === 'invalid_union'\n}\n\nfunction isInvalidKey(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidKey> {\n  return issue.code === 'invalid_key'\n}\n\n/**\n * Maps Zod issue codes to zodI18n message keys\n * Adapted for Zod v4's simpler issue code system\n */\nfunction getMessageKey(issue: $ZodRawIssue): MessageKeys {\n  if (isInvalidType(issue)) {\n    if (issue.input === undefined) {\n      return 'zodI18n.errors.required'\n    }\n    return 'zodI18n.errors.invalid_type'\n  }\n\n  if (isTooSmall(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_small.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isTooBig(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_big.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isInvalidFormat(issue)) {\n    // Map v4's format to v3-style validation keys\n    return `zodI18n.errors.invalid_string.${issue.format}` as MessageKeys\n  }\n\n  if (isNotMultipleOf(issue)) {\n    return 'zodI18n.errors.not_multiple_of'\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    return 'zodI18n.errors.unrecognized_keys'\n  }\n\n  if (isInvalidUnion(issue)) {\n    return 'zodI18n.errors.invalid_union'\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: Replaces invalid_enum_value, invalid_literal\n    return 'zodI18n.errors.invalid_enum_value'\n  }\n\n  // invalid_element, invalid_value, or unknown codes\n  return 'zodI18n.errors.custom.default'\n}\n\n/**\n * Extracts interpolation parameters from Zod issue\n * Uses proper type narrowing for v4\n */\nfunction getMessageParams(issue: $ZodRawIssue): Record<string, unknown> {\n  const params: Record<string, unknown> = {}\n\n  if (isInvalidType(issue)) {\n    params.expected = issue.expected\n    params.received = String(issue.input)\n    return params\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    params.keys = issue.keys.join(', ')\n    return params\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: For enums and records\n    // Since v4 doesn't have options field, we'll use generic message\n    return params\n  }\n\n  if (isInvalidFormat(issue)) {\n    params.validation = issue.format\n\n    // Check for specific string format issues with additional fields\n    if ('prefix' in issue) {\n      params.startsWith = (issue as { prefix?: string }).prefix\n    }\n    if ('suffix' in issue) {\n      params.endsWith = (issue as { suffix?: string }).suffix\n    }\n    if ('includes' in issue) {\n      params.includes = (issue as { includes?: string }).includes\n    }\n    if (issue.pattern) {\n      params.pattern = issue.pattern\n    }\n\n    return params\n  }\n\n  if (isTooSmall(issue)) {\n    params.minimum = issue.minimum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.minimum = new Date(Number(issue.minimum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isTooBig(issue)) {\n    params.maximum = issue.maximum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.maximum = new Date(Number(issue.maximum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isNotMultipleOf(issue)) {\n    params.multipleOf = issue.divisor\n    return params\n  }\n\n  return params\n}\n\n/**\n * Creates a Zod error map that uses i18n for translation\n * Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)\n */\nexport function createI18nErrorMap(getContext: () => ErrorMapContext | undefined): $ZodErrorMap {\n  return (issue: $ZodRawIssue): { message: string } => {\n    // Get message key and params for this issue\n    const messageKey = getMessageKey(issue)\n    const messageParams = getMessageParams(issue)\n\n    // Get translation context\n    const context = getContext()\n\n    if (!context) {\n      // Fallback: Use English messages directly\n      // This handles config validation at startup, tests, etc.\n      return { message: 'Invalid input' }\n    }\n\n    // Normal flow: Use context-aware i18n (respects user locale)\n    return {\n      message: context.t(messageKey, messageParams),\n    }\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { ErrorMapContext } from './validation.types'\nimport { createI18nErrorMap } from './validation.error-map'\n\n/**\n * AsyncLocalStorage for storing request-scoped ErrorMapContext\n * Allows error map to access I18nService without passing through function calls\n */\nexport const errorMapContextStorage = new AsyncLocalStorage<ErrorMapContext>()\n\n/**\n * Gets the current error map context from AsyncLocalStorage\n */\nfunction getErrorMapContext(): ErrorMapContext | undefined {\n  return errorMapContextStorage.getStore()\n}\n\n/**\n * Backend error map that accesses I18nService from AsyncLocalStorage\n * Must be initialized in router middleware after locale detection\n */\nexport const backendErrorMap = createI18nErrorMap(getErrorMapContext)\n\n/**\n * Runs a function within an error map context\n * Used by router middleware to provide I18nService to validation\n *\n * @example\n * ```typescript\n * router.use('*', async (c, next) => {\n *   const i18nService = c.get('i18nService')\n *   const locale = c.get('locale')\n *\n *   return runWithErrorMapContext(\n *     {\n *       t: (key, params) => i18nService.t(key, params),\n *       locale,\n *     },\n *     () => next()\n *   )\n * })\n * ```\n */\nexport function runWithErrorMapContext<T>(\n  context: ErrorMapContext,\n  fn: () => T\n): T {\n  return errorMapContextStorage.run(context, fn)\n}\n","import { type $ZodRawIssue } from 'zod/v4/core'\nimport type { MessageKeys } from '../i18n.types'\nimport { errorMapContextStorage } from './validation.context'\n\n/**\n * Type-safe helper for creating custom Zod error messages with i18n support (Backend)\n *\n * Usage with .refine():\n * ```typescript\n * const schema = z.string().refine(\n *   (val) => val.length > 5,\n *   withI18n('validation.minLength', { min: 5 })\n * )\n * ```\n *\n * Usage with built-in validators:\n * ```typescript\n * const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))\n * const schema = z.string().email(withI18n('validation.email'))\n * ```\n *\n * @param key - Message key from shared i18n messages (type-safe via MessageKeys)\n * @param params - Optional interpolation parameters for the message\n * @returns Zod error configuration object with translated message\n */\nexport function withI18n(\n  key: MessageKeys,\n  params?: Record<string, unknown>\n): { error: (_issue: $ZodRawIssue) => string } {\n  return {\n    error: (_issue: $ZodRawIssue) => {\n      // Get i18n context from AsyncLocalStorage (backend)\n      // This is set by the router middleware before validation\n      const context = errorMapContextStorage.getStore()\n\n      // Translate using context if available, otherwise fallback to generic message\n      const message = context\n        ? context.t(key, params as Record<string, string | number> | undefined)\n        : 'Invalid input'\n\n      return message\n    },\n  }\n}\n","import { z } from '@hono/zod-openapi';\nimport { type $ZodRawIssue } from 'zod/v4/core';\n\n/**\n * Default cuid2 shape: 24-32 lowercase-alphanumeric chars, starting with a\n * letter. Matches what `@paralleldrive/cuid2` produces with default settings\n * and what most apps expect when they say \"cuid2\".\n *\n * Used as the default for {@link cuid2}; exposed for callers who want to\n * compose it into other patterns.\n */\nexport const CUID2_REGEX = /^[a-z][0-9a-z]{23,31}$/\n\n/**\n * Stratal's cuid2 validator — a stricter drop-in for Zod 4.3.6's `z.cuid2()`.\n *\n * **Why this exists.** Zod 4.3.6's built-in `z.cuid2()` uses the regex\n * `/^[0-9a-z]+$/`, which accepts *any* non-empty lowercase-alphanumeric\n * string (including 2-letter locale prefixes like `'sw'`). That makes it\n * effectively useless as a tenant-id / external-id validator.\n *\n * This helper layers the proper shape regex on top of `z.cuid2()`, so:\n * - validation actually enforces cuid2 shape;\n * - the schema still carries `z.cuid2()`'s OpenAPI metadata (i.e. spec\n *   output keeps `format: 'cuid2'`).\n *\n * @example\n * ```ts\n * import { z, withI18n } from 'stratal/validation'\n * import { cuid2 } from 'stratal/validation'\n *\n * // Default 24-32 char cuid2:\n * router.prefix('/:tenantId', z.object({ tenantId: cuid2() }))\n *\n * // Custom regex (e.g. fixed-length 24):\n * router.prefix('/:tenantId', z.object({\n *   tenantId: cuid2({ pattern: /^[a-z][0-9a-z]{23}$/ }),\n * }))\n *\n * // Custom error message:\n * cuid2(withI18n('tenants.errors.invalidId'))\n *\n * // Compose: chain anything Zod string accepts\n * cuid2().describe('Tenant ID')\n * ```\n *\n * @param options.pattern - Override the shape regex. Defaults to {@link CUID2_REGEX}.\n * @param options.error - Custom error message (string or i18n key) for the regex check.\n */\nexport function cuid2(options?: { pattern?: RegExp; error?: string | ((_issue: $ZodRawIssue) => string) }) {\n  const pattern = options?.pattern ?? CUID2_REGEX\n  return z.cuid2({\n    pattern: pattern,\n    error: typeof options?.error === 'string' ? options?.error : undefined,\n    ...(typeof options?.error === 'function' ? { error: options?.error } : {})\n  })\n}\n","// Consolidated zod - single source from @hono/zod-openapi (superset of zod)\nexport { OpenAPIHono, z } from '@hono/zod-openapi'\nexport type * from 'zod'\nexport { ZodError } from 'zod'\n\n// OpenAPI utilities\nexport * from '@hono/zod-openapi'\nexport type { OpenAPIObject, PathItemObject } from 'openapi3-ts/oas30'\n\n// Helpers\nexport { withI18n } from './with-i18n'\nexport { CUID2_REGEX, cuid2 } from './cuid2'\n\n// Backend utilities\nexport { backendErrorMap, runWithErrorMapContext } from './validation.context'\n\n// Types\nexport type { ErrorMapContext, I18nErrorMetadata, LocaleProvider, ZodCustomIssue } from './validation.types'\n\n"],"mappings":"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"}

package/dist/websocket/index.d.mts

@@ -1,5 +1,5 @@
-import { B as ContextQueryResult, V as RouterContext, Yn as RouterEnv, d as ApplicationError, zn as ControllerOptions } from "../index-BrmS34sa.mjs";
-import { t as Constructor } from "../types-CN0zONAZ.mjs";
+import { B as ContextQueryResult, Bn as ControllerOptions, V as RouterContext, Xn as RouterEnv, d as ApplicationError } from "../index-D0US0X14.mjs";
+import { t as Constructor } from "../types-cySNS_lp.mjs";
 import { Context } from "hono";
 import { WSContext, WSContext as WSContext$1, WSEvents, WSMessageReceive, WSReadyState, WSReadyState as WSReadyState$1 } from "hono/ws";
 
@@ -8,7 +8,7 @@ import { WSContext, WSContext as WSContext$1, WSEvents, WSMessageReceive, WSRead
  * Gateway options for @Gateway() decorator
  * Subset of ControllerOptions relevant to WebSocket gateways (no OpenAPI-specific fields)
  */
-type GatewayOptions = Pick<ControllerOptions, 'version'>;
+type GatewayOptions = Pick<ControllerOptions, 'version' | 'name' | 'domain'>;
 //#endregion
 //#region src/websocket/decorators/gateway.decorator.d.ts
 /**
@@ -145,10 +145,15 @@ declare class GatewayContext extends RouterContext {
   /** Current WebSocket ready state */
   get readyState(): WSReadyState$1;
   /**
-   * Get route parameter value from the raw request (no OpenAPI validation)
+   * Get route parameter value(s) from the raw request — WebSocket gateways are
+   * not OpenAPI-registered, so reads come straight from Hono's matcher.
+   *
+   * - With a key → single string value.
+   * - With no args → full `Record<string, string>` (or `{}` when none).
    *
    * @param key - Parameter name (e.g., 'id' for /ws/chat/:id)
    */
+  param(): Record<string, string>;
   param(key: string): string;
   /**
    * Get query parameter value from the raw request (no OpenAPI validation)

package/dist/websocket/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/websocket/types.ts","../../src/websocket/decorators/gateway.decorator.ts","../../src/websocket/decorators/ws-event.decorator.ts","../../src/websocket/errors/websocket-body-not-available.error.ts","../../src/websocket/errors/websocket-duplicate-event-handler.error.ts","../../src/websocket/gateway-context.ts"],"mappings":";;;;;;;;;;KAMY,cAAA,GAAiB,IAAA,CAAK,iBAAA;;;;;;;AAAlC;;;;;;;;AC6BA;;;;;;;;;;;;;;;;iBAAgB,OAAA,CAAQ,KAAA,UAAe,OAAA,GAAU,cAAA,cACpB,WAAA,EAAa,MAAA,EAAQ,CAAA,KAAC,CAAA;;;AAanD;;;;iBAAgB,SAAA,CAAU,MAAA;;;;;;;;AD3C1B;;;;;;;;AC6BA;iBCDgB,SAAA,CAAA,GAAa,eAAA;;;;;;;;;;;;;;;iBAsBb,OAAA,CAAA,GAAW,eAAA;;;ADP3B;;;;;;;;ACfA;;;;iBA0CgB,OAAA,CAAA,GAAW,eAAA;AApB3B;;;AAAA,iBA6BgB,oBAAA,CAAqB,MAAA,EAAQ,WAAA;;AAT7C;;iBAgBgB,kBAAA,CAAmB,MAAA,EAAQ,WAAA;;;AAP3C;iBAcgB,kBAAA,CAAmB,MAAA,EAAQ,WAAA;;;cCjG9B,8BAAA,SAAuC,gBAAA;EAAA,WAAA,CAAA;AAAA;;;cCAvC,mCAAA,SAA4C,gBAAA;cAC3C,SAAA,UAAmB,cAAA;AAAA;;;;AJGjC;;;;;;;;AC6BA;;;;;;;;cIXa,cAAA,SAAuB,aAAA;EAAA,SACiB,EAAA,EAAI,WAAA;cAA3C,CAAA,EAAG,OAAA,CAAQ,SAAA,GAA4B,EAAA,EAAI,WAAA;EJUlB;EILrC,IAAA,CAAK,IAAA,WAAe,WAAA,GAAc,UAAA,CAAW,WAAA;EJMlB;EID3B,KAAA,CAAM,IAAA,WAAe,MAAA;EJCmB;EAAA,IIIpC,UAAA,CAAA,GAAc,cAAA;EJJ+B;;AAanD;;;EIAW,KAAA,CAAM,GAAA;EJAuB;;;;ACfxC;EGwBW,KAAA,WAAgB,MAAA,oFAAA,CAA2F,GAAA,GAAM,CAAA,GAAI,kBAAA,CAAmB,CAAA,EAAG,CAAA;;;;AHFtJ;;EGcW,IAAA,GAAA,CAAA,GAAW,OAAA,CAAQ,CAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/websocket/types.ts","../../src/websocket/decorators/gateway.decorator.ts","../../src/websocket/decorators/ws-event.decorator.ts","../../src/websocket/errors/websocket-body-not-available.error.ts","../../src/websocket/errors/websocket-duplicate-event-handler.error.ts","../../src/websocket/gateway-context.ts"],"mappings":";;;;;;;;;;KAMY,cAAA,GAAiB,IAAA,CAAK,iBAAA;;;;;;;AAAlC;;;;;;;;AC6BA;;;;;;;;;;;;;;;;iBAAgB,OAAA,CAAQ,KAAA,UAAe,OAAA,GAAU,cAAA,cACpB,WAAA,EAAa,MAAA,EAAQ,CAAA,KAAC,CAAA;;;AAanD;;;;iBAAgB,SAAA,CAAU,MAAA;;;;;;;;AD3C1B;;;;;;;;AC6BA;iBCDgB,SAAA,CAAA,GAAa,eAAA;;;;;;;;;;;;;;;iBAsBb,OAAA,CAAA,GAAW,eAAA;;;ADP3B;;;;;;;;ACfA;;;;iBA0CgB,OAAA,CAAA,GAAW,eAAA;AApB3B;;;AAAA,iBA6BgB,oBAAA,CAAqB,MAAA,EAAQ,WAAA;;AAT7C;;iBAgBgB,kBAAA,CAAmB,MAAA,EAAQ,WAAA;;;AAP3C;iBAcgB,kBAAA,CAAmB,MAAA,EAAQ,WAAA;;;cCjG9B,8BAAA,SAAuC,gBAAA;EAAA,WAAA,CAAA;AAAA;;;cCAvC,mCAAA,SAA4C,gBAAA;cAC3C,SAAA,UAAmB,cAAA;AAAA;;;;AJGjC;;;;;;;;AC6BA;;;;;;;;cIXa,cAAA,SAAuB,aAAA;EAAA,SACiB,EAAA,EAAI,WAAA;cAA3C,CAAA,EAAG,OAAA,CAAQ,SAAA,GAA4B,EAAA,EAAI,WAAA;EJUlB;EILrC,IAAA,CAAK,IAAA,WAAe,WAAA,GAAc,UAAA,CAAW,WAAA;EJMlB;EID3B,KAAA,CAAM,IAAA,WAAe,MAAA;EJCmB;EAAA,IIIpC,UAAA,CAAA,GAAc,cAAA;EJJ+B;;AAanD;;;;;;;EIIW,KAAA,CAAA,GAAS,MAAA;EACT,KAAA,CAAM,GAAA;EHpBQ;;;;AAsBzB;EGSW,KAAA,WAAgB,MAAA,oFAAA,CAA2F,GAAA,GAAM,CAAA,GAAI,kBAAA,CAAmB,CAAA,EAAG,CAAA;;;;AHWtJ;;EGCW,IAAA,GAAA,CAAA,GAAW,OAAA,CAAQ,CAAA;AAAA"}

package/dist/websocket/index.mjs

@@ -1,2 +1,2 @@
-import { a as OnMessage, c as getWsOnMessageMethod, d as isGateway, i as OnError, l as WebSocketDuplicateEventHandlerError, n as WebSocketBodyNotAvailableError, o as getWsOnCloseMethod, r as OnClose, s as getWsOnErrorMethod, t as GatewayContext, u as Gateway } from "../gateway-context-BdBFoQd8.mjs";
+import { a as OnMessage, c as getWsOnMessageMethod, d as isGateway, i as OnError, l as WebSocketDuplicateEventHandlerError, n as WebSocketBodyNotAvailableError, o as getWsOnCloseMethod, r as OnClose, s as getWsOnErrorMethod, t as GatewayContext, u as Gateway } from "../gateway-context-CdJjpUCW.mjs";
 export { Gateway, GatewayContext, OnClose, OnError, OnMessage, WebSocketBodyNotAvailableError, WebSocketDuplicateEventHandlerError, getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, isGateway };

package/dist/workers/index.d.mts

@@ -1,4 +1,5 @@
-import { Cr as Container, ir as StratalEnv } from "../index-BrmS34sa.mjs";
+import { Dr as Container } from "../index-D0US0X14.mjs";
+import { t as StratalEnv } from "../env-D1rcZ8_r.mjs";
 import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
 
 //#region src/workers/run-in-scope.d.ts

package/dist/workers/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/workers/run-in-scope.ts","../../src/workers/stratal-durable-object.ts","../../src/workers/stratal-worker-entrypoint.ts","../../src/workers/stratal-workflow.ts"],"mappings":";;;;;;;AASA;;;iBAAsB,UAAA,GAAA,CACpB,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;;;;AAFX;;;;;;;;;;;;;;;;;;;;uBCkBsB,oBAAA,aACR,UAAA,GAAa,UAAA,UACjB,aAAA,CAAc,GAAA;EAAA,UACN,UAAA,GAAA,CACd,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA;;;;ADvBb;;;;;;;;;;;;;;;;;;;uBEgBsB,uBAAA,aACR,UAAA,GAAa,UAAA,UACjB,gBAAA,CAAiB,GAAA;EAAA,UACf,UAAA,GAAA,CACR,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA;;;;AFrBb;;;;;;;;;;;;;;;;;;;uBGgBsB,eAAA,aACR,UAAA,GAAa,UAAA,4BAEjB,kBAAA,CAAmB,GAAA,EAAK,MAAA;EAAA,UACtB,UAAA,GAAA,CACR,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/workers/run-in-scope.ts","../../src/workers/stratal-durable-object.ts","../../src/workers/stratal-worker-entrypoint.ts","../../src/workers/stratal-workflow.ts"],"mappings":";;;;;;;;;AASA;;iBAAsB,UAAA,GAAA,CACpB,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;;;;;AAFX;;;;;;;;;;;;;;;;;;;uBCkBsB,oBAAA,aACR,UAAA,GAAa,UAAA,UACjB,aAAA,CAAc,GAAA;EAAA,UACN,UAAA,GAAA,CACd,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA;;;;;ADvBb;;;;;;;;;;;;;;;;;;uBEgBsB,uBAAA,aACR,UAAA,GAAa,UAAA,UACjB,gBAAA,CAAiB,GAAA;EAAA,UACf,UAAA,GAAA,CACR,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA;;;;;AFrBb;;;;;;;;;;;;;;;;;;uBGgBsB,eAAA,aACR,UAAA,GAAa,UAAA,4BAEjB,kBAAA,CAAmB,GAAA,EAAK,MAAA;EAAA,UACtB,UAAA,GAAA,CACR,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA"}

package/dist/workers/index.mjs

@@ -1,5 +1,5 @@
-import { f as DI_TOKENS } from "../logger-c0ftIK4G.mjs";
-import { t as Stratal } from "../stratal-B7G4i9-N.mjs";
+import { f as DI_TOKENS } from "../logger-V6Ms3QnQ.mjs";
+import { t as Stratal } from "../stratal-DeEcGgdq.mjs";
 import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
 //#region src/workers/run-in-scope.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratal",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "A modular Cloudflare Workers framework with dependency injection, queue-based events, and type-safe configuration",
   "type": "module",
   "license": "MIT",
@@ -94,6 +94,10 @@
       "types": "./dist/logger/index.d.mts",
       "import": "./dist/logger/index.mjs"
     },
+    "./macroable": {
+      "types": "./dist/macroable/index.d.mts",
+      "import": "./dist/macroable/index.mjs"
+    },
     "./module": {
       "types": "./dist/module/index.d.mts",
       "import": "./dist/module/index.mjs"
@@ -110,6 +114,10 @@
       "types": "./dist/queue/index.d.mts",
       "import": "./dist/queue/index.mjs"
     },
+    "./rate-limiter": {
+      "types": "./dist/rate-limiter/index.d.mts",
+      "import": "./dist/rate-limiter/index.mjs"
+    },
     "./router": {
       "types": "./dist/router/index.d.mts",
       "import": "./dist/router/index.mjs"
@@ -156,23 +164,19 @@
   },
   "dependencies": {
     "@hono/swagger-ui": "^0.6.1",
-    "@hono/zod-openapi": "^1.2.3",
-    "@intlify/core-base": "^11.3.0",
-    "@intlify/message-compiler": "^11.3.0",
-    "@modelcontextprotocol/sdk": "^1.28.0",
+    "@hono/zod-openapi": "^1.3.0",
+    "@intlify/core-base": "^11.4.0",
+    "@intlify/message-compiler": "^11.4.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@swc-node/register": "^1.11.1",
-    "@swc/core": "^1.15.21",
-    "@swc/helpers": "^0.5.20",
-    "@xmldom/xmldom": "^0.8.11",
+    "@swc/core": "^1.15.33",
+    "@swc/helpers": "^0.5.21",
     "clipanion": "^4.0.0-rc.4",
-    "hono": "^4.12.9",
+    "hono": "^4.12.16",
     "tsyringe": "^4.10.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.2"
   },
   "peerDependencies": {
-    "@aws-sdk/client-s3": ">=3",
-    "@aws-sdk/lib-storage": ">=3",
-    "@aws-sdk/s3-request-presigner": ">=3",
     "@react-email/components": ">=1",
     "nodemailer": ">=7",
     "react": ">=19",
@@ -181,15 +185,6 @@
     "resend": ">=6"
   },
   "peerDependenciesMeta": {
-    "@aws-sdk/client-s3": {
-      "optional": true
-    },
-    "@aws-sdk/lib-storage": {
-      "optional": true
-    },
-    "@aws-sdk/s3-request-presigner": {
-      "optional": true
-    },
     "@react-email/components": {
       "optional": true
     },
@@ -207,28 +202,25 @@
     }
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "3.1019.0",
-    "@aws-sdk/lib-storage": "^3.1019.0",
-    "@aws-sdk/s3-request-presigner": "3.1019.0",
-    "@cloudflare/vitest-pool-workers": "^0.13.5",
-    "@cloudflare/workers-types": "4.20260317.1",
-    "@react-email/components": "^1.0.10",
+    "@cloudflare/vitest-pool-workers": "^0.15.2",
+    "@cloudflare/workers-types": "4.20260502.1",
+    "@react-email/components": "^1.0.12",
     "@stratal/testing": "workspace:*",
-    "@types/node": "^25.5.0",
-    "@types/nodemailer": "^7.0.11",
+    "@types/node": "^25.6.0",
+    "@types/nodemailer": "^8.0.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitest/coverage-v8": "^4.1.2",
-    "@vitest/runner": "~4.1.2",
-    "@vitest/snapshot": "~4.1.2",
+    "@vitest/coverage-v8": "^4.1.5",
+    "@vitest/runner": "~4.1.5",
+    "@vitest/snapshot": "~4.1.5",
     "jsonc-parser": "^3.3.1",
-    "nodemailer": "^8.0.4",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "nodemailer": "^8.0.7",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "reflect-metadata": "^0.2.2",
-    "resend": "^6.9.4",
-    "tsdown": "^0.21.6",
-    "typescript": "^6.0.2",
-    "vitest": "~4.1.2"
+    "resend": "^6.12.2",
+    "tsdown": "^0.21.10",
+    "typescript": "^6.0.3",
+    "vitest": "~4.1.5"
   }
 }

package/dist/cron-manager-1KnZvojs.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron-manager-1KnZvojs.mjs","names":[],"sources":["../src/cron/errors/cron-execution.error.ts","../src/cron/cron-manager.ts"],"sourcesContent":["import { ApplicationError } from '../../errors'\nimport { ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when one or more cron jobs fail execution\n *\n * This error aggregates failures from multiple jobs that share the same schedule.\n */\nexport class CronExecutionError extends ApplicationError {\n\tconstructor(\n\t\tschedule: string,\n\t\tfailedJobsCount: number,\n\t\tjobNames: string\n\t) {\n\t\tsuper(\n\t\t\t'errors.cronExecutionFailed',\n\t\t\tERROR_CODES.SYSTEM.CRON_EXECUTION_FAILED,\n\t\t\t{\n\t\t\t\tschedule,\n\t\t\t\tcount: failedJobsCount,\n\t\t\t\tjobs: jobNames\n\t\t\t}\n\t\t)\n\t}\n}\n","import { Transient } from '../di/decorators'\nimport type { CronJob } from './cron-job'\nimport { CronExecutionError } from './errors/cron-execution.error'\n\n/**\n * Manages cron job registration and execution\n *\n * CronManager is a singleton service that:\n * - Registers cron jobs from modules\n * - Routes scheduled events to matching jobs\n * - Handles errors during job execution\n *\n * Jobs are grouped by their cron expression, allowing multiple jobs\n * to run on the same schedule.\n */\n@Transient()\nexport class CronManager {\n\t/**\n\t * Map of cron expressions to jobs\n\t * Key: Cron expression (e.g., '0 2 * * *')\n\t * Value: Array of jobs matching that expression\n\t */\n\tprivate jobs = new Map<string, CronJob[]>()\n\n\t/**\n\t * Register a cron job\n\t *\n\t * Jobs with the same schedule are grouped together and executed\n\t * sequentially when the trigger fires.\n\t *\n\t * @param job - CronJob instance to register\n\t */\n\tregisterJob(job: CronJob): void {\n\t\tconst existing = this.jobs.get(job.schedule) ?? []\n\t\texisting.push(job)\n\t\tthis.jobs.set(job.schedule, existing)\n\t}\n\n\t/**\n\t * Execute all jobs matching the triggered cron expression\n\t *\n\t * Jobs are executed sequentially. If a job fails:\n\t * - Its onError() hook is called (if defined)\n\t * - Execution continues with the next job\n\t * - Errors are collected and logged\n\t *\n\t * @param controller - Cloudflare ScheduledController\n\t */\n\tasync executeScheduled(controller: ScheduledController): Promise<void> {\n\t\tconst { cron } = controller\n\t\tconst matchingJobs = this.jobs.get(cron) ?? []\n\n\t\tif (matchingJobs.length === 0) {\n\t\t\treturn\n\t\t}\n\n\t\tconst errors: { job: string; error: Error }[] = []\n\n\t\tfor (const job of matchingJobs) {\n\t\t\tconst jobName = job.constructor.name\n\n\t\t\ttry {\n\t\t\t\tawait job.execute(controller)\n\t\t\t} catch (error) {\n\t\t\t\tconst err = error as Error\n\t\t\t\terrors.push({ job: jobName, error: err })\n\n\t\t\t\t// Call job's error handler if defined\n\t\t\t\tif (job.onError) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait job.onError(err, controller)\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// If onError() itself fails, we just continue\n\t\t\t\t\t\t// The error will be logged by ExceptionHandler\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// If any jobs failed, throw an aggregate error\n\t\t// This ensures the error is logged by ExceptionHandler\n\t\tif (errors.length > 0) {\n\t\t\tconst jobNames = errors\n\t\t\t\t.map(({ job, error }) => `${job}: ${error.message}`)\n\t\t\t\t.join('; ')\n\n\t\t\tthrow new CronExecutionError(cron, errors.length, jobNames)\n\t\t}\n\t}\n\n\t/**\n\t * Get all registered jobs for a specific cron expression\n\t *\n\t * @param schedule - Cron expression\n\t * @returns Array of jobs for that schedule, or empty array if none\n\t */\n\tgetJobsForSchedule(schedule: string): CronJob[] {\n\t\treturn this.jobs.get(schedule) ?? []\n\t}\n\n\t/**\n\t * Get all registered cron expressions\n\t *\n\t * @returns Array of unique cron expressions\n\t */\n\tgetAllSchedules(): string[] {\n\t\treturn Array.from(this.jobs.keys())\n\t}\n\n\t/**\n\t * Get total number of registered jobs across all schedules\n\t *\n\t * @returns Total job count\n\t */\n\tgetTotalJobCount(): number {\n\t\tlet count = 0\n\t\tfor (const jobs of this.jobs.values()) {\n\t\t\tcount += jobs.length\n\t\t}\n\t\treturn count\n\t}\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,qBAAb,cAAwC,iBAAiB;CACxD,YACC,UACA,iBACA,UACC;AACD,QACC,8BACA,YAAY,OAAO,uBACnB;GACC;GACA,OAAO;GACP,MAAM;GACN,CACD;;;;;ACNI,IAAA,cAAA,MAAM,YAAY;;;;;;CAMxB,uBAAe,IAAI,KAAwB;;;;;;;;;CAU3C,YAAY,KAAoB;EAC/B,MAAM,WAAW,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,EAAE;AAClD,WAAS,KAAK,IAAI;AAClB,OAAK,KAAK,IAAI,IAAI,UAAU,SAAS;;;;;;;;;;;;CAatC,MAAM,iBAAiB,YAAgD;EACtE,MAAM,EAAE,SAAS;EACjB,MAAM,eAAe,KAAK,KAAK,IAAI,KAAK,IAAI,EAAE;AAE9C,MAAI,aAAa,WAAW,EAC3B;EAGD,MAAM,SAA0C,EAAE;AAElD,OAAK,MAAM,OAAO,cAAc;GAC/B,MAAM,UAAU,IAAI,YAAY;AAEhC,OAAI;AACH,UAAM,IAAI,QAAQ,WAAW;YACrB,OAAO;IACf,MAAM,MAAM;AACZ,WAAO,KAAK;KAAE,KAAK;KAAS,OAAO;KAAK,CAAC;AAGzC,QAAI,IAAI,QACP,KAAI;AACH,WAAM,IAAI,QAAQ,KAAK,WAAW;YAC3B;;;AAUX,MAAI,OAAO,SAAS,GAAG;GACtB,MAAM,WAAW,OACf,KAAK,EAAE,KAAK,YAAY,GAAG,IAAI,IAAI,MAAM,UAAU,CACnD,KAAK,KAAK;AAEZ,SAAM,IAAI,mBAAmB,MAAM,OAAO,QAAQ,SAAS;;;;;;;;;CAU7D,mBAAmB,UAA6B;AAC/C,SAAO,KAAK,KAAK,IAAI,SAAS,IAAI,EAAE;;;;;;;CAQrC,kBAA4B;AAC3B,SAAO,MAAM,KAAK,KAAK,KAAK,MAAM,CAAC;;;;;;;CAQpC,mBAA2B;EAC1B,IAAI,QAAQ;AACZ,OAAK,MAAM,QAAQ,KAAK,KAAK,QAAQ,CACpC,UAAS,KAAK;AAEf,SAAO;;;0BAxGR,WAAW,CAAA,EAAA,YAAA"}

package/dist/cron-manager-BnEZquBL.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron-manager-BnEZquBL.d.mts","names":[],"sources":["../src/cron/cron-job.ts","../src/cron/cron-manager.ts"],"mappings":";;AA2BA;;;;;;;;;;;;;;;;;;;;;;;;;;UAAiB,OAAA;ECXO;;;;;;;EAAA,SDmBd,QAAA;ECbD;;;;;;EDqBR,OAAA,CAAQ,UAAA,EAAY,mBAAA,GAAsB,OAAA;ECKe;;;;;;;;EDKzD,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,mBAAA,GAAsB,OAAA;AAAA;;;AA1B1D;;;;;;;;;;;AAAA,cCXa,WAAA;ED2BQ;;;;;EAAA,QCrBZ,IAAA;ED+B2B;;;;;;;;ECrBnC,WAAA,CAAY,GAAA,EAAK,OAAA;EAhBM;;;;;;;;;;EAgCjB,gBAAA,CAAiB,UAAA,EAAY,mBAAA,GAAsB,OAAA;EAhB7C;;;;;;EAgEZ,kBAAA,CAAmB,QAAA,WAAmB,OAAA;EAAA;;;;;EAStC,eAAA,CAAA;;;;;;EASA,gBAAA,CAAA;AAAA"}

package/dist/en-3QnZwP-u.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"en-3QnZwP-u.mjs","names":[],"sources":["../src/i18n/messages/en/common.ts","../src/i18n/messages/en/errors.ts","../src/i18n/messages/en/emails.ts","../src/i18n/messages/en/validation.ts","../src/i18n/messages/en/zod.ts","../src/i18n/messages/en/index.ts"],"sourcesContent":["/**\n * System Common Messages - English\n *\n * Common messages used by packages/modules infrastructure.\n * These are automatically merged with application-specific messages.\n */\n\nexport const common = {\n  api: {\n    title: 'Stratal API',\n    description: 'Platform API',\n    serverDescription: 'API server',\n    security: {\n      bearerAuth: 'JWT Bearer token authentication',\n      apiKey: 'API key for service authentication',\n      sessionCookie: 'Session cookie for browser authentication'\n    }\n  }\n} as const\n","/**\n * System Error Messages - English\n *\n * Error messages used by packages/modules infrastructure.\n * These are automatically merged with application-specific messages.\n */\n\nexport const errors = {\n  // Generic errors\n  internalError: 'An internal error occurred',\n  notFound: 'Resource not found',\n  unauthorized: 'Unauthorized. Please sign in.',\n  forbidden: 'Access denied',\n\n  // Router errors\n  honoAppAlreadyConfigured: 'HonoApp has already been configured and can only be configured once',\n  routeNotFound: 'Route not found: {method} {path}',\n  routeAccessDenied: 'Resource not found',\n  controllerMethodNotFound: 'Method {methodName} not found on {controllerName}',\n  controllerRegistration: 'Failed to register controller {controllerName}: {reason}',\n  duplicateRouteName: 'Duplicate route name \"{name}\". Already registered by {existingHandler}, cannot register {newHandler}.',\n  routeNameNotFound: 'Route \"{name}\" not found in registry.',\n  missingRouteParam: 'Missing required parameter \"{param}\" for route \"{name}\" (path: {path}).',\n  routerUseScopeViolation: 'router.use() can only be called on the root Router, not inside group() callbacks. Use router.middleware() for scoped middleware.',\n  missingEnvironmentVariable: 'Environment variable \"{variable}\" is required but not set.',\n\n  // WebSocket errors\n  websocketBodyNotAvailable: 'body() is not available in WebSocket gateways. Use WebSocket messages instead.',\n  websocketDuplicateEventHandler: '@{decorator}() is already applied to \\'{existingMethod}\\'. Only one method per gateway can handle this event.',\n\n  // Context errors\n  contextNotInitialized: 'Context has not been initialized',\n  userNotAuthenticated: 'User is not authenticated',\n  insufficientPermissions: 'Insufficient permissions to perform this action',\n  requestContainerNotInitialized: 'Request container has not been initialized',\n  requestScopeOperationNotAllowed: '{methodName}() cannot be called on this container scope. Check if you are calling it on the correct container (global vs request-scoped).',\n  conditionalBindingFallback: 'Conditional binding predicate returned false for token \"{token}\" but no fallback was provided and no existing registration exists.',\n\n  // Configuration errors\n  configNotInitialized: 'Configuration service has not been initialized',\n  configModuleNotInitialized: 'ConfigModule.forRoot() was not called before module initialization',\n  stratalNotInitialized: 'Stratal has not been instantiated. Ensure you export a Stratal instance as the default export.',\n\n  // Module errors\n  moduleAlreadyRegistered: 'Module {moduleName} is already registered',\n  moduleDependencyNotFound: 'Module dependency {dependency} not found for module {moduleName}',\n  moduleCircularDependency: 'Circular dependency detected: {cycle}',\n  invalidModuleProvider: 'Invalid module provider configuration: {provider}',\n\n  // Database errors\n  databaseGeneric: 'Database error occurred',\n  databaseRecordNotFound: 'Record not found in database',\n  databaseUniqueConstraint: 'Record already exists',\n  databaseForeignKeyConstraint: 'Related record not found',\n  databaseConnectionFailed: 'Failed to connect to database',\n  databaseTimeout: 'Database query timeout',\n  databaseNullConstraint: 'Required field is missing',\n  databaseTooManyConnections: 'Too many database connections',\n  databaseTransactionConflict: 'Transaction conflict or deadlock',\n  databaseConstraintFailed: 'A database constraint was violated',\n  databaseTableNotFound: 'The specified table does not exist in the database',\n  databaseColumnNotFound: 'The specified column does not exist in the table',\n  databaseInvalidQuery: 'The database query is invalid or malformed',\n  invalidErrorCodeRange: 'Invalid error code range: {code}',\n\n  // Queue errors\n  queueBindingNotFound: 'Queue binding {queueName} not found in environment',\n  queueProviderNotSupported: 'Queue provider \"{provider}\" is not supported. Valid providers: cloudflare, sync',\n\n  // Cron errors\n  cronExecutionFailed: '{count} cron job(s) failed for schedule \"{schedule}\": {jobs}',\n\n  // i18n errors\n  localeNotSupported: \"Locale '{locale}' is not supported. Supported locales: {supportedLocales}\",\n  translationMissing: \"Translation missing for key '{key}' in locale '{locale}'\",\n\n  // Container errors\n  containerNotInitialized: 'Application container has not been initialized. Ensure Application.initialize() has been called.',\n\n  // Domain routing errors\n  domainMismatch: 'The requested domain does not match any configured route',\n\n  // Signature errors\n  invalidSignature: 'The URL signature is invalid or has expired',\n\n  // Schema validation errors\n  schemaValidation: 'Schema validation failed',\n  responseValidation: 'Response validation failed',\n\n  // OpenAPI errors\n  openapiValidation: 'OpenAPI validation failed: {details}',\n  openapiRouteRegistration: 'Failed to register OpenAPI route {path}: {reason}',\n\n  // Email errors\n  email: {\n    resendApiKeyMissing: 'Resend API key not configured. Set RESEND_EMAIL_API_KEY environment variable.',\n    smtpConfigurationMissing: 'SMTP configuration missing. Set SMTP_URL environment variable.',\n    smtpHostMissing: 'SMTP host not configured. Check SMTP_URL format (smtp://user:pass@host:port).',\n    smtpConnectionFailed: 'Failed to connect to SMTP server {smtpHost}:{smtpPort}',\n    resendApiFailed: 'Resend API error',\n    providerNotSupported: 'Unsupported email provider: {provider}. Supported providers: resend, smtp'\n  },\n\n  // Storage errors\n  storage: {\n    fileNotFound: 'File at path \"{path}\" was not found',\n    invalidDisk: 'Storage disk \"{disk}\" is not configured',\n    invalidFileType: 'File type \"{mimeType}\" is not allowed',\n    fileTooLarge: 'File size {size} exceeds maximum allowed size of {maxSize}',\n    presignedUrlInvalidExpiry: 'Expiry must be between {min} and {max} seconds',\n    diskNotConfigured: 'Disk \"{disk}\" is not configured',\n    providerNotSupported: 'Storage provider \"{provider}\" is not supported',\n    responseBodyMissing: 'No body in storage response for path: {path}'\n  },\n\n  // Cache errors\n  cache: {\n    getFailed: \"Failed to retrieve value from cache for key '{key}'\",\n    putFailed: \"Failed to store value in cache for key '{key}'\",\n    deleteFailed: \"Failed to delete value from cache for key '{key}'\",\n    listFailed: 'Failed to list cache keys'\n  },\n\n  // Authentication errors\n  auth: {\n    tokenRequired: 'Verification token is required',\n    invalidToken: 'Invalid or expired verification token',\n    verificationFailed: 'Verification failed. Please try again.',\n    userNotFound: 'User not found. Please check your credentials.',\n    invalidCredentials: 'Invalid email or password',\n    invalidPassword: 'Invalid password',\n    invalidEmail: 'Invalid email address',\n    sessionExpired: 'Your session has expired. Please sign in again.',\n    emailNotVerified: 'Please verify your email address before signing in',\n    passwordTooShort: 'Password must be at least {minLength} characters',\n    passwordTooLong: 'Password must be at most {maxLength} characters',\n    accountAlreadyExists: 'An account with this email already exists',\n    failedToCreateUser: 'Failed to create user account. Please try again.',\n    failedToCreateSession: 'Failed to create session. Please try again.',\n    failedToGetSession: 'Failed to retrieve session. Please try again.',\n    failedToUpdateUser: 'Failed to update user information. Please try again.',\n    failedToGetUserInfo: 'Failed to retrieve user information. Please try again.',\n    socialAccountLinked: 'This social account is already linked to another user',\n    providerNotFound: 'Authentication provider not found',\n    userEmailNotFound: 'User email address not found',\n    accountNotFound: 'Account not found',\n    credentialAccountNotFound: 'Credential account not found',\n    cannotUnlinkLastAccount: 'Cannot unlink your last account',\n    userAlreadyHasPassword: 'User already has a password set',\n    emailCannotBeUpdated: 'Email address cannot be updated at this time',\n    tokenExpired: 'The verification token has expired. Please request a new verification email.'\n  },\n\n  // Seeder errors\n  seederNameCollision: 'Seeder name collision: \"{name}\" is already registered. Use distinct class names for each seeder.',\n  seederNotRegistered: 'Seeder \"{name}\" is not registered',\n\n  // Migration errors\n  migration: {\n    failed: 'Migration {migrationName} failed: {error}',\n    checksumMismatch: 'Migration {migrationName} checksum mismatch (expected: {expected}, actual: {actual})',\n    alreadyApplied: 'Migration {migrationName} has already been applied',\n    notFound: 'Migration {migrationName} not found',\n  },\n} as const\n","/**\n * System Email Messages - English\n *\n * Email-related messages used by packages/modules infrastructure.\n * These are automatically merged with application-specific messages.\n */\n\nexport const emails = {\n  magicLink: {\n    subject: 'Your sign-in link'\n  }\n} as const\n","/**\n * Form validation messages - English\n */\n\nexport const validation = {\n  required: 'This field is required',\n  email: 'Invalid email address',\n  minLength: 'Must be at least {min} characters',\n  maxLength: 'Must not exceed {max} characters',\n  min: 'Must be at least {min}',\n  max: 'Must not exceed {max}',\n  pattern: 'Invalid format',\n  numeric: 'Must be a number',\n  url: 'Invalid URL',\n  date: 'Invalid date',\n  passwordStrength: 'Password must contain at least one uppercase letter, one lowercase letter, and one number',\n  passwordMatch: 'Passwords do not match',\n  unique: 'This value already exists',\n  phone: 'Invalid phone number',\n  fileRequired: 'Please upload a file',\n  fileTooLarge: 'File must be smaller than {max}',\n  invalidFileType: 'Please upload a PDF, JPG, or PNG file',\n  schoolTypes: {\n    required: 'School type is required',\n    atLeastOne: 'Please select at least one school type',\n    invalidCode: 'Invalid school type: {code}',\n    notAvailableInCountry: '{schoolType} is not available in {country}',\n    countryNotSupported: 'Country {country} is not supported'\n  },\n  timezone: {\n    required: 'Timezone is required',\n    invalid: 'Invalid timezone. Please select a valid IANA timezone.'\n  },\n  locale: {\n    required: 'Language is required',\n    invalid: 'Invalid language. Supported languages: {locales}'\n  }\n} as const\n","/**\n * Zod validation error messages - English\n *\n * Comprehensive messages for all Zod validation error codes\n * Structured to match Zod's issue types and validation contexts\n */\n\nexport const zodI18n = {\n  errors: {\n    // General errors\n    required: 'Required',\n    invalid_type: 'Expected {expected}, received {received}',\n    invalid_literal: 'Invalid literal value, expected {expected}',\n    custom: {\n      default: 'Invalid value',\n      // Email validation\n      emailOrTextRequired: 'Either html or text content must be provided',\n      invalidFromEmail: 'Invalid from email address',\n      // Storage validation\n      fileInstanceRequired: 'File must be a File instance',\n      filePathRequired: 'File path is required',\n      diskNameRequired: 'Disk name is required',\n      endpointRequired: 'Endpoint URL is required for S3',\n      bucketNameRequired: 'Bucket name is required',\n      accessKeyRequired: 'Access key ID is required',\n      secretKeyRequired: 'Secret access key is required',\n      storageDiskRequired: 'At least one storage disk is required',\n      // Database validation\n      databaseUrlRequired: 'Database URL is required',\n      // Domain validation\n      domainRequired: 'Domain is required',\n      domainTooLong: 'Domain too long',\n      invalidDomainFormat: 'Invalid domain format',\n    },\n    invalid_union: 'Invalid input',\n    invalid_union_discriminator: 'Invalid discriminator value. Expected {options}',\n    invalid_enum_value: 'Invalid enum value. Expected {options}, received {received}',\n    unrecognized_keys: 'Unrecognized key(s) in object: {keys}',\n    invalid_arguments: 'Invalid function arguments',\n    invalid_return_type: 'Invalid function return type',\n    invalid_date: 'Invalid date',\n    invalid_intersection_types: 'Intersection results could not be merged',\n    not_multiple_of: 'Number must be a multiple of {multipleOf}',\n    not_finite: 'Number must be finite',\n\n    // String-specific validation errors\n    invalid_string: {\n      email: 'Invalid email address',\n      url: 'Invalid URL',\n      uuid: 'Invalid UUID',\n      cuid: 'Invalid CUID',\n      cuid2: 'Invalid CUID2',\n      ulid: 'Invalid ULID',\n      regex: 'Invalid format',\n      datetime: 'Invalid datetime',\n      ip: 'Invalid IP address',\n      emoji: 'Invalid emoji',\n      startsWith: 'Must start with \"{startsWith}\"',\n      endsWith: 'Must end with \"{endsWith}\"',\n      includes: 'Must include \"{includes}\"',\n      base64: 'Invalid Base64',\n      nanoid: 'Invalid NanoID',\n      cidr: 'Invalid CIDR',\n      jwt: 'Invalid JWT',\n      time: 'Invalid time',\n    },\n\n    // Size validation errors (strings, arrays, numbers)\n    too_small: {\n      string: {\n        exact: 'Must be exactly {minimum} characters',\n        inclusive: 'Must be at least {minimum} characters',\n        not_inclusive: 'Must be more than {minimum} characters',\n      },\n      number: {\n        exact: 'Must be exactly {minimum}',\n        inclusive: 'Must be at least {minimum}',\n        not_inclusive: 'Must be greater than {minimum}',\n      },\n      array: {\n        exact: 'Must contain exactly {minimum} item(s)',\n        inclusive: 'Must contain at least {minimum} item(s)',\n        not_inclusive: 'Must contain more than {minimum} item(s)',\n      },\n      set: {\n        exact: 'Must contain exactly {minimum} item(s)',\n        inclusive: 'Must contain at least {minimum} item(s)',\n        not_inclusive: 'Must contain more than {minimum} item(s)',\n      },\n      date: {\n        exact: 'Date must be {minimum}',\n        inclusive: 'Date must be {minimum} or later',\n        not_inclusive: 'Date must be after {minimum}',\n      },\n      bigint: {\n        exact: 'Must be exactly {minimum}',\n        inclusive: 'Must be at least {minimum}',\n        not_inclusive: 'Must be greater than {minimum}',\n      },\n    },\n\n    too_big: {\n      string: {\n        exact: 'Must be exactly {maximum} characters',\n        inclusive: 'Must be at most {maximum} characters',\n        not_inclusive: 'Must be less than {maximum} characters',\n      },\n      number: {\n        exact: 'Must be exactly {maximum}',\n        inclusive: 'Must be at most {maximum}',\n        not_inclusive: 'Must be less than {maximum}',\n      },\n      array: {\n        exact: 'Must contain exactly {maximum} item(s)',\n        inclusive: 'Must contain at most {maximum} item(s)',\n        not_inclusive: 'Must contain less than {maximum} item(s)',\n      },\n      set: {\n        exact: 'Must contain exactly {maximum} item(s)',\n        inclusive: 'Must contain at most {maximum} item(s)',\n        not_inclusive: 'Must contain less than {maximum} item(s)',\n      },\n      date: {\n        exact: 'Date must be {maximum}',\n        inclusive: 'Date must be {maximum} or earlier',\n        not_inclusive: 'Date must be before {maximum}',\n      },\n      bigint: {\n        exact: 'Must be exactly {maximum}',\n        inclusive: 'Must be at most {maximum}',\n        not_inclusive: 'Must be less than {maximum}',\n      },\n    },\n  },\n} as const\n","/**\n * System Messages - English\n *\n * Re-exports all system message categories.\n * These messages are used by packages/modules infrastructure\n * and are automatically merged with application-specific messages.\n */\n\nexport { common } from './common'\nexport { errors } from './errors'\nexport { emails } from './emails'\nexport { validation } from './validation'\nexport { zodI18n } from './zod'\n"],"mappings":"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ACN,OAAO;EACP,UAAU;EACV,IAAI;EACJ,OAAO;EACP,YAAY;EACZ,UAAU;EACV,UAAU;EACV,QAAQ;EACR,QAAQ;EACR,MAAM;EACN,KAAK;EACL,MAAM;EACP;CAGD,WAAW;EACT,QAAQ;GACN,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,QAAQ;GACN,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,OAAO;GACL,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,KAAK;GACH,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,MAAM;GACJ,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,QAAQ;GACN,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACF;CAED,SAAS;EACP,QAAQ;GACN,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,QAAQ;GACN,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,OAAO;GACL,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,KAAK;GACH,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,MAAM;GACJ,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACD,QAAQ;GACN,OAAO;GACP,WAAW;GACX,eAAe;GAChB;EACF;CACF,EACF"}