stratal 0.0.21 → 0.0.23

package/dist/tiered-cache.service-Dv3BhxxE.d.mts

@@ -0,0 +1,79 @@
+import { t as CacheService } from "./cache.service-uElmBtdS.mjs";
+
+//#region src/cache/services/tiered-cache.service.d.ts
+/**
+ * Tiered Cache Service
+ *
+ * Layers an **isolate-local in-memory L1** over {@link CacheService} (KV, the
+ * L2). Opt-in — inject `CACHE_TOKENS.TieredCacheService` instead of
+ * `CACHE_TOKENS.CacheService` when you want it.
+ *
+ * **Why:** KV reads are eventually consistent (a `get` can return an
+ * edge-cached value for up to ~60s after a `put`). The L1 makes writes made
+ * through *this isolate* immediately and consistently visible to subsequent
+ * reads on the same isolate — closing the read-after-write gap KV alone cannot.
+ * This is what makes set-once patterns (e.g. queue idempotency markers) reliable
+ * within an isolate, even inside KV's consistency window.
+ *
+ * **Use it for:** set-once / read-mostly values (idempotency claims, immutable
+ * lookups). **Do not use it for** read-modify-write counters that need
+ * cross-edge freshness (e.g. rate limiting): an isolate that wrote a key reads
+ * its own value until the L1 entry expires, so concurrent increments from other
+ * isolates are missed and overwritten. Use plain {@link CacheService} (KV) or a
+ * Durable-Object store for those.
+ *
+ * **Semantics:**
+ * - L1 caches string-backed values only (`text`/`json`). `arrayBuffer`/`stream`
+ *   reads and non-string writes bypass and invalidate L1.
+ * - `put`/`delete` are write-through: KV and L1 update in lock-step, honoring
+ *   `expirationTtl`/`expiration` for the L1 entry's own expiry.
+ * - `get` populates L1 from `text` reads (the only path that yields the raw
+ *   string). `json` reads are served from L1 when the string was cached by a
+ *   prior `put`/`text` read, otherwise they go straight to KV.
+ * - `getWithMetadata` and `list` always read KV directly (metadata is not held
+ *   in L1).
+ *
+ * **Cross-isolate caveat:** the L1 only observes writes made through its own
+ * isolate. A value mutated by another isolate is not seen until the local entry
+ * expires or is invalidated by a local write/delete.
+ *
+ * **Bindings:** `binding(name)` returns a memoized tiered instance per binding,
+ * so each KV namespace has its own stable, isolate-lifetime L1.
+ */
+declare class TieredCacheService {
+  private readonly cache;
+  /** Isolate-local L1 tier. Per-instance, so each binding has its own. */
+  private readonly l1;
+  /** Memoized tiered instances per binding name (each with its own L1). */
+  private readonly children;
+  constructor(cache: CacheService);
+  /**
+   * Get the tiered cache bound to a KV namespace by its binding name. Memoized:
+   * repeated calls with the same name return the same instance, preserving its
+   * isolate-local L1 across requests/messages.
+   *
+   * @param name - KV namespace binding name (e.g. `'UPLOADS_CACHE'`)
+   * @throws {CacheError} If no binding with that name exists in the environment
+   */
+  binding(name: string): TieredCacheService;
+  get(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<string | null>;
+  get<ExpectedValue = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<ExpectedValue | null>;
+  get(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<ArrayBuffer | null>;
+  get(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<ReadableStream | null>;
+  getWithMetadata<Metadata = unknown>(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<KVNamespaceGetWithMetadataResult<string, Metadata>>;
+  getWithMetadata<ExpectedValue = unknown, Metadata = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<KVNamespaceGetWithMetadataResult<ExpectedValue, Metadata>>;
+  getWithMetadata<Metadata = unknown>(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<KVNamespaceGetWithMetadataResult<ArrayBuffer, Metadata>>;
+  getWithMetadata<Metadata = unknown>(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<KVNamespaceGetWithMetadataResult<ReadableStream, Metadata>>;
+  put(key: string, value: string | ArrayBuffer | ArrayBufferView | ReadableStream, options?: KVNamespacePutOptions): Promise<void>;
+  delete(key: string): Promise<void>;
+  list<Metadata = unknown>(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult<Metadata>>;
+  /** Read a fresh L1 entry, evicting it if expired. Returns `null` on miss. */
+  private l1Read;
+  /** Write an L1 entry, refreshing its recency and evicting the oldest at cap. */
+  private l1Write;
+  /** Compute an absolute L1 expiry (epoch ms) from KV put options. */
+  private l1ExpiresAt;
+}
+//#endregion
+export { TieredCacheService as t };
+//# sourceMappingURL=tiered-cache.service-Dv3BhxxE.d.mts.map

package/dist/tiered-cache.service-Dv3BhxxE.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered-cache.service-Dv3BhxxE.d.mts","names":[],"sources":["../src/cache/services/tiered-cache.service.ts"],"mappings":";;;;;AA0DA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cACa,kBAAA;EAAA,iBAO2C,KAAA;EA4FnD;EAAA,iBAjGc,EAAA;EAsHL;EAAA,iBApHK,QAAA;cAGqC,KAAA,EAAO,YAAA;EAkH1D;;;;;;;;EAvGH,OAAA,CAAQ,IAAA,WAAe,kBAAA;EAWjB,GAAA,CAAI,GAAA,UAAa,aAAA,YAAyB,qBAAA,WAAgC,OAAA;EAC1E,GAAA,0BAA6B,GAAA,UAAa,aAAA,WAAwB,qBAAA,WAAgC,OAAA,CAAQ,aAAA;EAC1G,GAAA,CAAI,GAAA,UAAa,aAAA,kBAA+B,qBAAA,kBAAuC,OAAA,CAAQ,WAAA;EAC/F,GAAA,CAAI,GAAA,UAAa,aAAA,aAA0B,qBAAA,aAAkC,OAAA,CAAQ,cAAA;EA+BrF,eAAA,qBACJ,GAAA,UACA,aAAA,YAAyB,qBAAA,WACxB,OAAA,CAAQ,gCAAA,SAAyC,QAAA;EAC9C,eAAA,8CACJ,GAAA,UACA,aAAA,WAAwB,qBAAA,WACvB,OAAA,CAAQ,gCAAA,CAAiC,aAAA,EAAe,QAAA;EACrD,eAAA,qBACJ,GAAA,UACA,aAAA,kBAA+B,qBAAA,kBAC9B,OAAA,CAAQ,gCAAA,CAAiC,WAAA,EAAa,QAAA;EACnD,eAAA,qBACJ,GAAA,UACA,aAAA,aAA0B,qBAAA,aACzB,OAAA,CAAQ,gCAAA,CAAiC,cAAA,EAAgB,QAAA;EAiBtD,GAAA,CACJ,GAAA,UACA,KAAA,WAAgB,WAAA,GAAc,eAAA,GAAkB,cAAA,EAChD,OAAA,GAAU,qBAAA,GACT,OAAA;EAaG,MAAA,CAAO,GAAA,WAAc,OAAA;EAOrB,IAAA,qBACJ,OAAA,GAAU,sBAAA,GACT,OAAA,CAAQ,qBAAA,CAAsB,QAAA;EA3FuC;EAAA,QAkGhE,MAAA;EAlGgG;EAAA,QA6GhG,OAAA;EA5GF;EAAA,QAuHE,WAAA;AAAA"}

package/dist/trailing-slash-CFyw8nYu.mjs

@@ -0,0 +1,34 @@
+//#region src/router/trailing-slash.ts
+/**
+* Apply a trailing-slash mode to a URL or path.
+*
+* - `'ignore'` — return as-is.
+* - `'always'` — append `/` to the pathname unless it already has one.
+*   Skipped when the last segment contains `.` (file-like paths) and for the
+*   root `/` path.
+* - `'never'`  — strip a trailing `/` from the pathname. Skipped for root.
+*
+* Preserves query string and hash. Handles both relative paths
+* (`/foo?x=1`) and absolute URLs (`https://host/foo?x=1`).
+*
+* Used by URL-generation helpers and the redirect middleware so canonical
+* form is computed in one place.
+*/
+function applyTrailingSlash(url, mode) {
+	if (mode === "ignore") return url;
+	const isAbsolute = /^https?:\/\//i.test(url);
+	const parsed = isAbsolute ? new URL(url) : new URL(url, "http://placeholder.local");
+	const path = parsed.pathname;
+	if (path === "/") return url;
+	const hasTrailing = path.endsWith("/");
+	if (mode === "always" && !hasTrailing) {
+		if (path.slice(path.lastIndexOf("/") + 1).includes(".")) return url;
+		parsed.pathname = `${path}/`;
+	} else if (mode === "never" && hasTrailing) parsed.pathname = path.slice(0, -1);
+	else return url;
+	return isAbsolute ? parsed.toString() : `${parsed.pathname}${parsed.search}${parsed.hash}`;
+}
+//#endregion
+export { applyTrailingSlash as t };
+
+//# sourceMappingURL=trailing-slash-CFyw8nYu.mjs.map

package/dist/trailing-slash-CFyw8nYu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailing-slash-CFyw8nYu.mjs","names":[],"sources":["../src/router/trailing-slash.ts"],"sourcesContent":["import type { TrailingSlashMode } from './types'\n\n/**\n * Apply a trailing-slash mode to a URL or path.\n *\n * - `'ignore'` — return as-is.\n * - `'always'` — append `/` to the pathname unless it already has one.\n *   Skipped when the last segment contains `.` (file-like paths) and for the\n *   root `/` path.\n * - `'never'`  — strip a trailing `/` from the pathname. Skipped for root.\n *\n * Preserves query string and hash. Handles both relative paths\n * (`/foo?x=1`) and absolute URLs (`https://host/foo?x=1`).\n *\n * Used by URL-generation helpers and the redirect middleware so canonical\n * form is computed in one place.\n */\nexport function applyTrailingSlash(url: string, mode: TrailingSlashMode): string {\n  if (mode === 'ignore') return url\n\n  const isAbsolute = /^https?:\\/\\//i.test(url)\n  const parsed = isAbsolute\n    ? new URL(url)\n    : new URL(url, 'http://placeholder.local')\n\n  const path = parsed.pathname\n  if (path === '/') return url\n\n  const hasTrailing = path.endsWith('/')\n\n  if (mode === 'always' && !hasTrailing) {\n    const lastSegment = path.slice(path.lastIndexOf('/') + 1)\n    if (lastSegment.includes('.')) return url\n    parsed.pathname = `${path}/`\n  } else if (mode === 'never' && hasTrailing) {\n    parsed.pathname = path.slice(0, -1)\n  } else {\n    return url\n  }\n\n  return isAbsolute\n    ? parsed.toString()\n    : `${parsed.pathname}${parsed.search}${parsed.hash}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,KAAa,MAAiC;CAC/E,IAAI,SAAS,UAAU,OAAO;CAE9B,MAAM,aAAa,gBAAgB,KAAK,GAAG;CAC3C,MAAM,SAAS,aACX,IAAI,IAAI,GAAG,IACX,IAAI,IAAI,KAAK,0BAA0B;CAE3C,MAAM,OAAO,OAAO;CACpB,IAAI,SAAS,KAAK,OAAO;CAEzB,MAAM,cAAc,KAAK,SAAS,GAAG;CAErC,IAAI,SAAS,YAAY,CAAC,aAAa;EAErC,IADoB,KAAK,MAAM,KAAK,YAAY,GAAG,IAAI,CACzC,EAAE,SAAS,GAAG,GAAG,OAAO;EACtC,OAAO,WAAW,GAAG,KAAK;CAC5B,OAAO,IAAI,SAAS,WAAW,aAC7B,OAAO,WAAW,KAAK,MAAM,GAAG,EAAE;MAElC,OAAO;CAGT,OAAO,aACH,OAAO,SAAS,IAChB,GAAG,OAAO,WAAW,OAAO,SAAS,OAAO;AAClD"}

package/dist/{types-cySNS_lp.d.mts → types-CmV_9xBD.d.mts}

@@ -16,4 +16,4 @@
 type Constructor<T = object> = new (...args: any[]) => T;
 //#endregion
 export { Constructor as t };
-//# sourceMappingURL=types-cySNS_lp.d.mts.map
+//# sourceMappingURL=types-CmV_9xBD.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-CmV_9xBD.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;AAeA;;;;;;;;AAA+D;;;;;KAAnD,WAAA,uBAAkC,IAAA,YAAgB,CAAC"}

package/dist/uri-h7Q8Jug9.mjs

@@ -0,0 +1,251 @@
+import { t as __exportAll } from "./chunk-BBjsoOtd.mjs";
+import { d as inject, o as Request, r as DI_TOKENS, v as ROUTER_TOKENS } from "./di-DseMn-z9.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-CuAoSZvs.mjs";
+import { o as RouterError } from "./module-registry-Dm-pqHd3.mjs";
+import { t as applyTrailingSlash } from "./trailing-slash-CFyw8nYu.mjs";
+import { t as applyLocalePrefix } from "./locale-url-nZrZxqJP.mjs";
+import { n as verifySignedUrl, t as signUrl } from "./signed-url-DIU0sK_6.mjs";
+//#region src/router/uri.ts
+var uri_exports = /* @__PURE__ */ __exportAll({
+	Uri: () => Uri,
+	buildRouteUrl: () => buildRouteUrl
+});
+/**
+* Encode a value for use as a path parameter.
+*
+* Splits on `/` and encodes each segment with `encodeURIComponent`, so callers
+* can pass slash-containing values for catch-all params (e.g. `:slug{.+}`) and
+* still get a usable URL — `'auth/login'` becomes `'auth/login'`, not
+* `'auth%2Flogin'`. Single segments behave exactly like `encodeURIComponent`.
+*/
+function encodePathParam(value) {
+	return value.split("/").map(encodeURIComponent).join("/");
+}
+/**
+* Build a URL from a registered route, filling path/domain params and appending extras as query string.
+*
+* Pure function — no request context needed. Used by both the `Uri` class and the standalone `route()` function.
+*
+* @param route - The registered route to build a URL for
+* @param name - Route name (used in error messages)
+* @param params - Path params, domain params, and extra query params
+* @returns Relative URL string (or absolute with domain prefix if route has a domain pattern)
+*
+* @throws RouterError if a required path or domain param is missing
+*/
+function buildRouteUrl(route, name, params, localeConfig) {
+	const allParams = { ...params };
+	const consumedKeys = /* @__PURE__ */ new Set();
+	let url = route.path;
+	if (allParams.locale && route.localePaths?.length) {
+		url = applyLocalePrefix(url, allParams.locale, localeConfig);
+		consumedKeys.add("locale");
+	}
+	for (const paramName of route.paramNames) {
+		const value = allParams[paramName];
+		if (value === void 0) throw new RouterError(`Missing required route parameter "${paramName}" for route "${name}" (path: ${route.path})`);
+		url = url.replace(new RegExp(`:${paramName}(\\{[^}]*\\})?`), encodePathParam(value));
+		consumedKeys.add(paramName);
+	}
+	let domain;
+	if (route.domain) {
+		domain = route.domain;
+		for (const domainParam of route.domainParamNames) {
+			const value = allParams[domainParam];
+			if (value === void 0) throw new RouterError(`Missing required domain parameter "${domainParam}" for route "${name}" (domain: ${route.domain})`);
+			domain = domain.replace(`{${domainParam}}`, encodeURIComponent(value));
+			consumedKeys.add(domainParam);
+		}
+	}
+	const queryEntries = Object.entries(allParams).filter(([key]) => !consumedKeys.has(key));
+	if (queryEntries.length > 0) {
+		const queryString = queryEntries.filter(([, value]) => Boolean(value)).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`).join("&");
+		url = `${url}${queryString.length ? `?${queryString}` : ""}`;
+	}
+	if (domain) url = `https://${domain}${url}`;
+	return url;
+}
+let Uri = class Uri {
+	registry;
+	routerContext;
+	_defaults = {};
+	trailingSlash;
+	localeConfig;
+	constructor(registry, routerContext, application, localePathService) {
+		this.registry = registry;
+		this.routerContext = routerContext;
+		this.trailingSlash = application.config.trailingSlash ?? "ignore";
+		this.localeConfig = {
+			defaultLocale: localePathService.localePathConfig?.defaultLocale ?? null,
+			prefixDefaultLocale: localePathService.prefixDefaultLocale
+		};
+	}
+	/**
+	* Set default URL parameters for this request.
+	* Applied to all subsequent `route()` calls — explicit params override defaults.
+	*
+	* @param params - Default parameters (e.g., `{ locale: 'en' }`)
+	*/
+	defaults(params) {
+		this._defaults = {
+			...this._defaults,
+			...params
+		};
+	}
+	/**
+	* Read the currently configured default URL parameters.
+	*
+	* Used by frameworks that need to share these with the client (e.g. the
+	* Inertia adapter ships them as a shared prop so `route()` calls in the
+	* browser auto-fill the same sticky params as the server).
+	*/
+	getDefaults() {
+		return { ...this._defaults };
+	}
+	/**
+	* Generate a URL from a named route.
+	*
+	* Keys matching `:param` placeholders fill the path.
+	* Domain params (`{tenant}`) are consumed from the same object.
+	* Extra keys become query string parameters.
+	* Default params (from `defaults()`) are merged — explicit params override.
+	*
+	* @param name - Named route identifier
+	* @param params - Route params + domain params + extra query params
+	* @param options - URL generation options
+	* @returns Generated URL string
+	*
+	* @throws RouterError if route name not found or required params missing
+	*/
+	route(name, params, options) {
+		const registeredRoute = this.registry.get(name);
+		if (!registeredRoute) throw new RouterError(`Route name "${name}" was not found in the registry`);
+		let url = applyTrailingSlash(buildRouteUrl(registeredRoute, name, {
+			...this._defaults,
+			...params
+		}, this.localeConfig), this.trailingSlash);
+		if (options?.absolute && !url.startsWith("http")) url = `${new URL(this.routerContext.c.req.url).origin}${url}`;
+		return url;
+	}
+	/**
+	* Generate a signed URL from a named route.
+	*
+	* @param name - Named route identifier
+	* @param params - Route params + domain params + extra query params
+	* @param options - Signing options (e.g., expiresIn) and URL options
+	* @returns Signed URL string with signature query param
+	*
+	* @throws Error if APP_SECRET environment variable is not set
+	*/
+	async signedRoute(name, params, options) {
+		return signUrl(this.route(name, params, options), this.getAppSecret(), options);
+	}
+	/**
+	* Generate a temporary signed URL from a named route.
+	*
+	* @param name - Named route identifier
+	* @param expiresIn - Time-to-live in seconds
+	* @param params - Route params + domain params + extra query params
+	* @param options - URL generation options
+	* @returns Signed URL string with signature and expires query params
+	*
+	* @throws Error if APP_SECRET environment variable is not set
+	*/
+	async temporarySignedRoute(name, expiresIn, params, options) {
+		return this.signedRoute(name, params, {
+			...options,
+			expiresIn
+		});
+	}
+	/**
+	* Check if the current request has a valid signature.
+	*
+	* @returns true if the URL signature is valid and not expired
+	*/
+	async hasValidSignature() {
+		const secret = this.routerContext.c.env.APP_SECRET;
+		if (!secret) return false;
+		return verifySignedUrl(this.routerContext.c.req.url, secret);
+	}
+	/**
+	* Get the current request URL pathname (without query string).
+	*/
+	current() {
+		return applyTrailingSlash(new URL(this.routerContext.c.req.url).pathname, this.trailingSlash);
+	}
+	/**
+	* Get the current request URL with query string (pathname + search).
+	*/
+	full() {
+		const parsed = new URL(this.routerContext.c.req.url);
+		return applyTrailingSlash(`${parsed.pathname}${parsed.search}`, this.trailingSlash);
+	}
+	/**
+	* Get the previous request URL from the Referer header.
+	*
+	* @param fallback - URL to return if no Referer header (default: '/')
+	*/
+	previous(fallback = "/") {
+		return this.routerContext.c.req.header("referer") ?? fallback;
+	}
+	/**
+	* Get the previous request URL pathname (no query string or host) from the Referer header.
+	*
+	* @param fallback - Path to return if no Referer header (default: '/')
+	*/
+	previousPath(fallback = "/") {
+		const referer = this.routerContext.c.req.header("referer");
+		if (!referer) return fallback;
+		try {
+			return new URL(referer).pathname;
+		} catch {
+			return referer;
+		}
+	}
+	/**
+	* Build a URL to a raw path (not a named route) with optional query params.
+	*
+	* @param path - URL path (e.g., '/users')
+	* @param queryParams - Query parameters to append
+	* @param options - URL generation options
+	*/
+	to(path, queryParams, options) {
+		let url = applyTrailingSlash(path, this.trailingSlash);
+		if (queryParams) {
+			const entries = Object.entries(queryParams);
+			if (entries.length > 0) {
+				const queryString = entries.map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`).join("&");
+				url = url.includes("?") ? `${url}&${queryString}` : `${url}?${queryString}`;
+			}
+		}
+		if (options?.absolute && !url.startsWith("http")) url = `${new URL(this.routerContext.c.req.url).origin}${url}`;
+		return url;
+	}
+	/**
+	* Build a URL with query string parameters. Merges with existing query params in path.
+	*
+	* @param path - URL path, may already contain query params
+	* @param queryParams - Query parameters to merge (new values override existing)
+	*/
+	query(path, queryParams) {
+		const parsed = new URL(path, "https://placeholder.local");
+		for (const [key, value] of Object.entries(queryParams)) parsed.searchParams.set(key, value);
+		return applyTrailingSlash(`${parsed.pathname}${parsed.search}`, this.trailingSlash);
+	}
+	getAppSecret() {
+		const secret = this.routerContext.c.env.APP_SECRET;
+		if (!secret) throw new Error("APP_SECRET environment variable is required for signed URLs");
+		return secret;
+	}
+};
+Uri = __decorate([
+	Request(ROUTER_TOKENS.Uri),
+	__decorateParam(0, inject(ROUTER_TOKENS.RouteRegistry)),
+	__decorateParam(1, inject(ROUTER_TOKENS.RouterContext)),
+	__decorateParam(2, inject(DI_TOKENS.Application)),
+	__decorateParam(3, inject(ROUTER_TOKENS.LocalePathService))
+], Uri);
+//#endregion
+export { buildRouteUrl as n, uri_exports as r, Uri as t };
+
+//# sourceMappingURL=uri-h7Q8Jug9.mjs.map

package/dist/uri-h7Q8Jug9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-h7Q8Jug9.mjs","names":[],"sources":["../src/router/uri.ts"],"sourcesContent":["import type { Application } from '../application';\nimport { inject } from '../di';\nimport { Request } from '../di/decorators';\nimport { DI_TOKENS } from '../di/tokens';\nimport { applyLocalePrefix } from './locale-url';\nimport type { RouteName, RouteParams } from './route-map';\nimport type { RegisteredRoute, RouteRegistry } from './route-registry';\nimport type { RouterContext } from './router-context';\nimport { RouterError } from './router.error';\nimport { ROUTER_TOKENS } from './router.tokens';\nimport type { LocalePathService } from './services/locale-path.service';\nimport { signUrl, verifySignedUrl, type SignedUrlOptions } from './signed-url';\nimport { applyTrailingSlash } from './trailing-slash';\nimport type { LocaleUrlConfig, TrailingSlashMode } from './types';\n\n/**\n * Options for URL generation methods.\n */\nexport interface UriOptions {\n  /** Generate absolute URL (scheme + host). Defaults to false. */\n  absolute?: boolean\n}\n\n/**\n * Options for signed URL generation methods.\n */\nexport interface SignedUriOptions extends UriOptions, SignedUrlOptions { }\n\n/**\n * Encode a value for use as a path parameter.\n *\n * Splits on `/` and encodes each segment with `encodeURIComponent`, so callers\n * can pass slash-containing values for catch-all params (e.g. `:slug{.+}`) and\n * still get a usable URL — `'auth/login'` becomes `'auth/login'`, not\n * `'auth%2Flogin'`. Single segments behave exactly like `encodeURIComponent`.\n */\nfunction encodePathParam(value: string): string {\n  return value.split('/').map(encodeURIComponent).join('/')\n}\n\n/**\n * Build a URL from a registered route, filling path/domain params and appending extras as query string.\n *\n * Pure function — no request context needed. Used by both the `Uri` class and the standalone `route()` function.\n *\n * @param route - The registered route to build a URL for\n * @param name - Route name (used in error messages)\n * @param params - Path params, domain params, and extra query params\n * @returns Relative URL string (or absolute with domain prefix if route has a domain pattern)\n *\n * @throws RouterError if a required path or domain param is missing\n */\nexport function buildRouteUrl(\n  route: RegisteredRoute,\n  name: string,\n  params?: Record<string, string>,\n  localeConfig?: LocaleUrlConfig,\n): string {\n  const allParams = { ...params }\n  const consumedKeys = new Set<string>()\n  let url = route.path\n\n  if (allParams.locale && route.localePaths?.length) {\n    url = applyLocalePrefix(url, allParams.locale, localeConfig)\n    consumedKeys.add('locale')\n  }\n\n  // Fill path :param placeholders (handles optional regex constraints like :locale{en|de|fr})\n  for (const paramName of route.paramNames) {\n    const value = allParams[paramName]\n    if (value === undefined) {\n      throw new RouterError(`Missing required route parameter \"${paramName}\" for route \"${name}\" (path: ${route.path})`)\n    }\n    url = url.replace(\n      new RegExp(`:${paramName}(\\\\{[^}]*\\\\})?`),\n      encodePathParam(value),\n    )\n    consumedKeys.add(paramName)\n  }\n\n  // Build domain if present\n  let domain: string | undefined\n  if (route.domain) {\n    domain = route.domain\n    for (const domainParam of route.domainParamNames) {\n      const value = allParams[domainParam]\n      if (value === undefined) {\n        throw new RouterError(`Missing required domain parameter \"${domainParam}\" for route \"${name}\" (domain: ${route.domain})`)\n      }\n      domain = domain.replace(`{${domainParam}}`, encodeURIComponent(value))\n      consumedKeys.add(domainParam)\n    }\n  }\n\n  // Remaining params (not consumed by path or domain) become query string\n  const queryEntries = Object.entries(allParams).filter(([key]) => !consumedKeys.has(key))\n  if (queryEntries.length > 0) {\n    const queryString = queryEntries\n      .filter(([, value]) => Boolean(value))\n      .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)\n      .join('&')\n    url = `${url}${queryString.length ? `?${queryString}` : ''}`\n  }\n\n  // Prepend domain if present\n  if (domain) {\n    url = `https://${domain}${url}`\n  }\n\n  return url\n}\n\n/**\n * URL generation service for named routes, signed URLs, and request URL access.\n *\n * Registered as request-scoped in the container — has access to the current request\n * via RouterContext for features like `current()`, `full()`, and signed URLs.\n *\n * @example\n * ```typescript\n * // In a controller:\n * const uri = ctx.getContainer().resolve<Uri>(ROUTER_TOKENS.Uri)\n * uri.route('users.show', { id: '1' })\n * uri.current()\n * await uri.signedRoute('unsubscribe', { user: '1' }, { expiresIn: 3600 })\n *\n * // Set defaults (e.g., in middleware):\n * uri.defaults({ locale: 'en' })\n * uri.route('posts.index') // auto-fills :locale param\n * ```\n */\n@Request(ROUTER_TOKENS.Uri)\nexport class Uri {\n  private _defaults: Record<string, string> = {}\n  private readonly trailingSlash: TrailingSlashMode\n  private readonly localeConfig: LocaleUrlConfig\n\n  constructor(\n    @inject(ROUTER_TOKENS.RouteRegistry) private readonly registry: RouteRegistry,\n    @inject(ROUTER_TOKENS.RouterContext) private readonly routerContext: RouterContext,\n    @inject(DI_TOKENS.Application) application: Application,\n    @inject(ROUTER_TOKENS.LocalePathService) localePathService: LocalePathService,\n  ) {\n    this.trailingSlash = application.config.trailingSlash ?? 'ignore'\n    this.localeConfig = {\n      defaultLocale: localePathService.localePathConfig?.defaultLocale ?? null,\n      prefixDefaultLocale: localePathService.prefixDefaultLocale,\n    }\n  }\n\n  /**\n   * Set default URL parameters for this request.\n   * Applied to all subsequent `route()` calls — explicit params override defaults.\n   *\n   * @param params - Default parameters (e.g., `{ locale: 'en' }`)\n   */\n  defaults(params: Record<string, string>): void {\n    this._defaults = { ...this._defaults, ...params }\n  }\n\n  /**\n   * Read the currently configured default URL parameters.\n   *\n   * Used by frameworks that need to share these with the client (e.g. the\n   * Inertia adapter ships them as a shared prop so `route()` calls in the\n   * browser auto-fill the same sticky params as the server).\n   */\n  getDefaults(): Record<string, string> {\n    return { ...this._defaults }\n  }\n\n  /**\n   * Generate a URL from a named route.\n   *\n   * Keys matching `:param` placeholders fill the path.\n   * Domain params (`{tenant}`) are consumed from the same object.\n   * Extra keys become query string parameters.\n   * Default params (from `defaults()`) are merged — explicit params override.\n   *\n   * @param name - Named route identifier\n   * @param params - Route params + domain params + extra query params\n   * @param options - URL generation options\n   * @returns Generated URL string\n   *\n   * @throws RouterError if route name not found or required params missing\n   */\n  route<N extends RouteName>(name: N, params?: RouteParams<N>, options?: UriOptions): string {\n    const registeredRoute = this.registry.get(name)\n    if (!registeredRoute) {\n      throw new RouterError(`Route name \"${name}\" was not found in the registry`)\n    }\n\n    const mergedParams = { ...this._defaults, ...params } as Record<string, string>\n    let url = applyTrailingSlash(buildRouteUrl(registeredRoute, name, mergedParams, this.localeConfig), this.trailingSlash)\n\n    if (options?.absolute && !url.startsWith('http')) {\n      const origin = new URL(this.routerContext.c.req.url).origin\n      url = `${origin}${url}`\n    }\n\n    return url\n  }\n\n  /**\n   * Generate a signed URL from a named route.\n   *\n   * @param name - Named route identifier\n   * @param params - Route params + domain params + extra query params\n   * @param options - Signing options (e.g., expiresIn) and URL options\n   * @returns Signed URL string with signature query param\n   *\n   * @throws Error if APP_SECRET environment variable is not set\n   */\n  async signedRoute<N extends RouteName>(name: N, params?: RouteParams<N>, options?: SignedUriOptions): Promise<string> {\n    const url = this.route(name, params, options)\n    const secret = this.getAppSecret()\n    return signUrl(url, secret, options)\n  }\n\n  /**\n   * Generate a temporary signed URL from a named route.\n   *\n   * @param name - Named route identifier\n   * @param expiresIn - Time-to-live in seconds\n   * @param params - Route params + domain params + extra query params\n   * @param options - URL generation options\n   * @returns Signed URL string with signature and expires query params\n   *\n   * @throws Error if APP_SECRET environment variable is not set\n   */\n  async temporarySignedRoute<N extends RouteName>(name: N, expiresIn: number, params?: RouteParams<N>, options?: UriOptions): Promise<string> {\n    return this.signedRoute(name, params, { ...options, expiresIn })\n  }\n\n  /**\n   * Check if the current request has a valid signature.\n   *\n   * @returns true if the URL signature is valid and not expired\n   */\n  async hasValidSignature(): Promise<boolean> {\n    const secret = (this.routerContext.c.env as unknown as Record<string, string>).APP_SECRET\n    if (!secret) return false\n    return verifySignedUrl(this.routerContext.c.req.url, secret)\n  }\n\n  /**\n   * Get the current request URL pathname (without query string).\n   */\n  current(): string {\n    const parsed = new URL(this.routerContext.c.req.url)\n    return applyTrailingSlash(parsed.pathname, this.trailingSlash)\n  }\n\n  /**\n   * Get the current request URL with query string (pathname + search).\n   */\n  full(): string {\n    const parsed = new URL(this.routerContext.c.req.url)\n    return applyTrailingSlash(`${parsed.pathname}${parsed.search}`, this.trailingSlash)\n  }\n\n  /**\n   * Get the previous request URL from the Referer header.\n   *\n   * @param fallback - URL to return if no Referer header (default: '/')\n   */\n  previous(fallback = '/'): string {\n    return this.routerContext.c.req.header('referer') ?? fallback\n  }\n\n  /**\n   * Get the previous request URL pathname (no query string or host) from the Referer header.\n   *\n   * @param fallback - Path to return if no Referer header (default: '/')\n   */\n  previousPath(fallback = '/'): string {\n    const referer = this.routerContext.c.req.header('referer')\n    if (!referer) return fallback\n\n    try {\n      const parsed = new URL(referer)\n      return parsed.pathname\n    } catch {\n      return referer\n    }\n  }\n\n  /**\n   * Build a URL to a raw path (not a named route) with optional query params.\n   *\n   * @param path - URL path (e.g., '/users')\n   * @param queryParams - Query parameters to append\n   * @param options - URL generation options\n   */\n  to(path: string, queryParams?: Record<string, string>, options?: UriOptions): string {\n    let url = applyTrailingSlash(path, this.trailingSlash)\n\n    if (queryParams) {\n      const entries = Object.entries(queryParams)\n      if (entries.length > 0) {\n        const queryString = entries\n          .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)\n          .join('&')\n        url = url.includes('?') ? `${url}&${queryString}` : `${url}?${queryString}`\n      }\n    }\n\n    if (options?.absolute && !url.startsWith('http')) {\n      const origin = new URL(this.routerContext.c.req.url).origin\n      url = `${origin}${url}`\n    }\n\n    return url\n  }\n\n  /**\n   * Build a URL with query string parameters. Merges with existing query params in path.\n   *\n   * @param path - URL path, may already contain query params\n   * @param queryParams - Query parameters to merge (new values override existing)\n   */\n  query(path: string, queryParams: Record<string, string>): string {\n    const parsed = new URL(path, 'https://placeholder.local')\n    for (const [key, value] of Object.entries(queryParams)) {\n      parsed.searchParams.set(key, value)\n    }\n    return applyTrailingSlash(`${parsed.pathname}${parsed.search}`, this.trailingSlash)\n  }\n\n  private getAppSecret(): string {\n    const secret = this.routerContext.c.env.APP_SECRET\n    if (!secret) {\n      throw new Error('APP_SECRET environment variable is required for signed URLs')\n    }\n    return secret\n  }\n}\n"],"mappings":"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"}

package/dist/{usage-generator-BUdlhnCK.mjs → usage-generator-DAWYasuP.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-DJaRDXoS.mjs";
+import { t as __exportAll } from "./chunk-BBjsoOtd.mjs";
+import { a as cyan, i as bold, o as dim, s as dimWhite, u as yellow } from "./command-BvmUAPPQ.mjs";
 //#region src/quarry/usage-generator.ts
 var usage_generator_exports = /* @__PURE__ */ __exportAll({
 	generateListing: () => generateListing,
@@ -63,7 +63,10 @@ function generateListing(commands, signatures, options) {
 	lines.push(bold(`${label}${version ? ` v${version}` : ""}`));
 	lines.push("");
 	lines.push(bold(yellow("Usage")));
-	lines.push(`  $ ${bin} <command> [options]`);
+	lines.push(`  $ ${bin} [--env <name>] <command> [options]`);
+	lines.push("");
+	lines.push(bold(yellow("Global Options")));
+	lines.push(...formatTable([[`-e, --env ${cyan("<name>")}`, `Select a wrangler config environment (e.g. staging, production)`]]));
 	lines.push("");
 	if (commands.length === 0) {
 		lines.push("No registered commands.");
@@ -155,4 +158,4 @@ function formatTable(rows) {
 //#endregion
 export { usage_generator_exports as n, generateUsage as t };
 
-//# sourceMappingURL=usage-generator-BUdlhnCK.mjs.map
+//# sourceMappingURL=usage-generator-DAWYasuP.mjs.map

package/dist/usage-generator-DAWYasuP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-generator-DAWYasuP.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} [--env <name>] <command> [options]`)\n  lines.push('')\n\n  // Global Options\n  lines.push(bold(yellow('Global Options')))\n  lines.push(...formatTable([\n    [`-e, --env ${cyan('<name>')}`, `Select a wrangler config environment (e.g. staging, production)`],\n  ]))\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-CpOjviyT.mjs

@@ -0,0 +1,49 @@
+import { n as __reExport, t as __exportAll } from "./chunk-BBjsoOtd.mjs";
+import { n as getContainer } from "./container-storage-BmOJ4_Na.mjs";
+import { t as I18N_TOKENS } from "./i18n.tokens-CZ_v8oyS.mjs";
+import { a as CUID2_REGEX, i as zod_exports, n as ZodError, o as cuid2, r as z, t as OpenAPIHono } from "./zod-eKqqhZ5_.mjs";
+import { t as zodErrorMap } from "./validation.context-CRvmrhq7.mjs";
+//#region src/i18n/validation/with-zod-i18n.ts
+/**
+* Type-safe helper for creating custom Zod error messages with i18n support
+*
+* Usage with .refine():
+* ```typescript
+* const schema = z.string().refine(
+*   (val) => val.length > 5,
+*   withZodI18n('validation.minLength', { min: 5 })
+* )
+* ```
+*
+* Usage with built-in validators:
+* ```typescript
+* const schema = z.string().min(5, withZodI18n('validation.minLength', { min: 5 }))
+* const schema = z.string().email(withZodI18n('validation.email'))
+* ```
+*
+* @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 withZodI18n(key, params) {
+	return { error: (_issue) => {
+		try {
+			return getContainer().resolve(I18N_TOKENS.I18nService).t(key, params);
+		} catch {
+			return "Invalid input";
+		}
+	} };
+}
+__reExport(/* @__PURE__ */ __exportAll({
+	CUID2_REGEX: () => CUID2_REGEX,
+	OpenAPIHono: () => OpenAPIHono,
+	ZodError: () => ZodError,
+	cuid2: () => cuid2,
+	withZodI18n: () => withZodI18n,
+	z: () => z,
+	zodErrorMap: () => zodErrorMap
+}), zod_exports);
+//#endregion
+export { withZodI18n as t };
+
+//# sourceMappingURL=validation-CpOjviyT.mjs.map

package/dist/validation-CpOjviyT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-CpOjviyT.mjs","names":[],"sources":["../src/i18n/validation/with-zod-i18n.ts","../src/i18n/validation/index.ts"],"sourcesContent":["import { type $ZodRawIssue } from 'zod/v4/core'\nimport { getContainer } from '../../di/container-storage'\nimport { I18N_TOKENS } from '../i18n.tokens'\nimport type { II18nService, MessageKeys } from '../i18n.types'\n\n/**\n * Type-safe helper for creating custom Zod error messages with i18n support\n *\n * Usage with .refine():\n * ```typescript\n * const schema = z.string().refine(\n *   (val) => val.length > 5,\n *   withZodI18n('validation.minLength', { min: 5 })\n * )\n * ```\n *\n * Usage with built-in validators:\n * ```typescript\n * const schema = z.string().min(5, withZodI18n('validation.minLength', { min: 5 }))\n * const schema = z.string().email(withZodI18n('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 withZodI18n(\n  key: MessageKeys,\n  params?: Record<string, unknown>\n): { error: (_issue: $ZodRawIssue) => string } {\n  return {\n    error: (_issue: $ZodRawIssue) => {\n      try {\n        const container = getContainer()\n        const i18n = container.resolve<II18nService>(I18N_TOKENS.I18nService)\n        return i18n.t(key, params as Record<string, string | number> | undefined)\n      } catch {\n        return 'Invalid input'\n      }\n    },\n  }\n}\n","export * from './zod'\nexport { withZodI18n } from './with-zod-i18n'\nexport { zodErrorMap } from './validation.context'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,YACd,KACA,QAC6C;CAC7C,OAAO,EACL,QAAQ,WAAyB;EAC/B,IAAI;GAGF,OAFkB,aACG,EAAE,QAAsB,YAAY,WAC/C,EAAE,EAAE,KAAK,MAAqD;EAC1E,QAAQ;GACN,OAAO;EACT;CACF,EACF;AACF"}

package/dist/validation.context-CRvmrhq7.mjs

@@ -0,0 +1,117 @@
+import { n as getContainer } from "./container-storage-BmOJ4_Na.mjs";
+import { t as I18N_TOKENS } from "./i18n.tokens-CZ_v8oyS.mjs";
+//#region src/i18n/validation/validation.error-map.ts
+/**
+* Type guards for narrowing Zod v4 issue types
+*/
+function isInvalidType(issue) {
+	return issue.code === "invalid_type";
+}
+function isTooBig(issue) {
+	return issue.code === "too_big";
+}
+function isTooSmall(issue) {
+	return issue.code === "too_small";
+}
+function isInvalidFormat(issue) {
+	return issue.code === "invalid_format";
+}
+function isNotMultipleOf(issue) {
+	return issue.code === "not_multiple_of";
+}
+function isUnrecognizedKeys(issue) {
+	return issue.code === "unrecognized_keys";
+}
+function isInvalidUnion(issue) {
+	return issue.code === "invalid_union";
+}
+function isInvalidKey(issue) {
+	return issue.code === "invalid_key";
+}
+/**
+* Maps Zod issue codes to zodI18n message keys
+* Adapted for Zod v4's simpler issue code system
+*/
+function getMessageKey(issue) {
+	if (isInvalidType(issue)) {
+		if (issue.input === void 0) return "zodI18n.errors.required";
+		return "zodI18n.errors.invalid_type";
+	}
+	if (isTooSmall(issue)) return `zodI18n.errors.too_small.${issue.origin || "string"}.${issue.exact ? "exact" : issue.inclusive ? "inclusive" : "not_inclusive"}`;
+	if (isTooBig(issue)) return `zodI18n.errors.too_big.${issue.origin || "string"}.${issue.exact ? "exact" : issue.inclusive ? "inclusive" : "not_inclusive"}`;
+	if (isInvalidFormat(issue)) return `zodI18n.errors.invalid_string.${issue.format}`;
+	if (isNotMultipleOf(issue)) return "zodI18n.errors.not_multiple_of";
+	if (isUnrecognizedKeys(issue)) return "zodI18n.errors.unrecognized_keys";
+	if (isInvalidUnion(issue)) return "zodI18n.errors.invalid_union";
+	if (isInvalidKey(issue)) return "zodI18n.errors.invalid_enum_value";
+	return "zodI18n.errors.custom.default";
+}
+/**
+* Extracts interpolation parameters from Zod issue
+* Uses proper type narrowing for v4
+*/
+function getMessageParams(issue) {
+	const params = {};
+	if (isInvalidType(issue)) {
+		params.expected = issue.expected;
+		params.received = String(issue.input);
+		return params;
+	}
+	if (isUnrecognizedKeys(issue)) {
+		params.keys = issue.keys.join(", ");
+		return params;
+	}
+	if (isInvalidKey(issue)) return params;
+	if (isInvalidFormat(issue)) {
+		params.validation = issue.format;
+		if ("prefix" in issue && typeof issue.prefix === "string") params.startsWith = issue.prefix;
+		if ("suffix" in issue && typeof issue.suffix === "string") params.endsWith = issue.suffix;
+		if ("includes" in issue && typeof issue.includes === "string") params.includes = issue.includes;
+		if (issue.pattern) params.pattern = issue.pattern;
+		return params;
+	}
+	if (isTooSmall(issue)) {
+		params.minimum = Number(issue.minimum);
+		params.type = issue.origin;
+		if (issue.origin === "date") params.minimum = new Date(Number(issue.minimum)).toLocaleDateString();
+		return params;
+	}
+	if (isTooBig(issue)) {
+		params.maximum = Number(issue.maximum);
+		params.type = issue.origin;
+		if (issue.origin === "date") params.maximum = new Date(Number(issue.maximum)).toLocaleDateString();
+		return params;
+	}
+	if (isNotMultipleOf(issue)) {
+		params.multipleOf = issue.divisor;
+		return params;
+	}
+	return params;
+}
+/**
+* Creates a Zod error map that uses i18n for translation
+* Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)
+*/
+function createI18nErrorMap() {
+	return (issue) => {
+		const messageKey = getMessageKey(issue);
+		const messageParams = getMessageParams(issue);
+		try {
+			return { message: getContainer().resolve(I18N_TOKENS.I18nService).t(messageKey, messageParams) };
+		} catch {
+			return { message: "Invalid input" };
+		}
+	};
+}
+//#endregion
+//#region src/i18n/validation/validation.context.ts
+/**
+* Zod error map that resolves I18nService from the DI container.
+* Falls back to 'Invalid input' when called outside the container scope
+* (e.g., config validation at startup, tests).
+*/
+const zodErrorMap = createI18nErrorMap();
+//#endregion
+export { zodErrorMap as t };
+
+//# sourceMappingURL=validation.context-CRvmrhq7.mjs.map