@rpcbase/db 0.95.0 → 0.97.0

package/README.md

@@ -15,14 +15,19 @@ const ZUser = z.object({
 
 ### `LocalizedString` / `zI18nString()`
 
-`zI18nString()` (alias of `zLocalizedString()`) describes a localized string as an object keyed by *language codes* (BCP47):
+`zI18nString()` (alias of `zLocalizedString()`) describes a localized string as an object keyed by *language codes* (BCP47), where each locale stores the translated value and metadata:
 
 ```ts
 import { z, zI18nString } from "@rpcbase/db"
 
 const ZPost = z.object({
-  title: zI18nString(), // { "en": "...", "fr": "...", "fr-FR": "..." }
+  title: zI18nString(),
 })
+
+const title = {
+  en: { value: "Hello", updatedAt: new Date(), autoTranslated: false },
+  fr: { value: "Bonjour", updatedAt: new Date() },
+}
 ```
 
 ### Mongoose re-export
@@ -77,7 +82,7 @@ Notes:
 
 ### Mongoose localized fallback (optional)
 
-When storing localized strings as plain objects, `mongooseLocalizedStringField()` adds a getter that returns a proxy with fallback behavior:
+When storing localized strings as plain objects, `mongooseLocalizedStringField()` adds a getter that returns a proxy with fallback behavior. Fallback access returns the full locale entry:
 
 ```ts
 import { Schema, mongooseLocalizedStringField } from "@rpcbase/db"
@@ -85,6 +90,9 @@ import { Schema, mongooseLocalizedStringField } from "@rpcbase/db"
 const PostSchema = new Schema({
   title: mongooseLocalizedStringField(),
 })
+
+const entry = doc.title.get("fr-CA")
+const text = resolveLocalizedString(doc.title, "fr-CA")
 ```
 
 ### Search helpers

package/dist/{index-BQeL_LHp.js → index-BNcI2Uw0.js}

@@ -38,6 +38,9 @@ function buildLocaleFallbackChain(locale, fallbacks) {
   return output;
 }
 function resolveLocalizedString(value, locale, options) {
+  return resolveLocalizedStringEntry(value, locale, options)?.value;
+}
+function resolveLocalizedStringEntry(value, locale, options) {
   if (!value) return void 0;
   const chain = buildLocaleFallbackChain(locale, options?.fallbacks);
   if (chain.length === 0) return void 0;
@@ -59,17 +62,17 @@ function withLocalizedStringFallback(value) {
 }
 function withFallbackRecord(record) {
   const getExact = (key) => {
-    const current = record[key];
-    return typeof current === "string" ? current : void 0;
+    if (!hasExact(key)) return void 0;
+    return record[key];
   };
   const hasExact = (key) => Object.prototype.hasOwnProperty.call(record, key);
   return new Proxy(record, {
     get(target, prop) {
       if (prop === "getExact") return getExact;
       if (prop === "hasExact") return hasExact;
-      if (prop === "get") return (key) => resolveLocalizedString(target, key);
+      if (prop === "get") return (key) => resolveLocalizedStringEntry(target, key);
       if (typeof prop === "string" && !(prop in target)) {
-        return resolveLocalizedString(target, prop);
+        return resolveLocalizedStringEntry(target, prop);
       }
       return Reflect.get(target, prop);
     },
@@ -79,9 +82,15 @@ function withFallbackRecord(record) {
   });
 }
 const zLocalizedString = () => {
-  const schema = z$1.record(z$1.string().regex(LANGUAGE_CODE_REGEX, {
+  const languageCodeSchema = z$1.string().regex(LANGUAGE_CODE_REGEX, {
     message: "Expected a language code (BCP 47, e.g. en or fr-FR)."
-  }), z$1.string());
+  });
+  const entrySchema = z$1.object({
+    value: z$1.string(),
+    updatedAt: z$1.date(),
+    autoTranslated: z$1.boolean().optional()
+  }).passthrough();
+  const schema = z$1.record(languageCodeSchema, entrySchema);
   return schema;
 };
 const zI18nString = zLocalizedString;
@@ -130,4 +139,4 @@ export {
   withLocalizedStringFallback as w,
   z
 };
-//# sourceMappingURL=index-BQeL_LHp.js.map
+//# sourceMappingURL=index-BNcI2Uw0.js.map

package/dist/index-BNcI2Uw0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BNcI2Uw0.js","sources":["../src/zod/localizedString.ts","../src/zod/e164Phone.ts","../src/zod/extension.ts","../src/zod/index.ts"],"sourcesContent":["import { z } from \"zod\"\n\n\nexport type LanguageCode = string\n\nexport type LocalizedStringEntry<TExtra extends Record<string, unknown> = Record<string, unknown>> = {\n  value: string\n  updatedAt: Date\n  autoTranslated?: boolean\n} & TExtra\n\nexport type LocalizedString<TExtra extends Record<string, unknown> = Record<string, unknown>> = Record<\n  LanguageCode,\n  LocalizedStringEntry<TExtra>\n>\n\nexport type I18nStringRecord = LocalizedString\n\nexport type I18nString = LocalizedString\n\nexport type LocalizedStringWithFallback = LocalizedString & {\n  get: (key: string) => LocalizedStringEntry | undefined\n  getExact: (key: string) => LocalizedStringEntry | undefined\n  hasExact: (key: string) => boolean\n}\n\nexport const LANGUAGE_CODE_REGEX = /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/\n\nconst LOCALIZED_STRING_PROXY_CACHE = new WeakMap<object, unknown>()\n\nfunction normalizeLocale(locale: string): string {\n  const trimmed = locale.trim()\n  if (!trimmed) return \"\"\n  const getCanonicalLocales = (Intl as typeof Intl & {\n    getCanonicalLocales?: (locales: string | readonly string[]) => string[]\n  }).getCanonicalLocales\n  if (typeof getCanonicalLocales !== \"function\") return trimmed\n  try {\n    return getCanonicalLocales(trimmed)[0] ?? trimmed\n  } catch {\n    return trimmed\n  }\n}\n\nexport function buildLocaleFallbackChain(locale: string, fallbacks?: string | string[]): string[] {\n  const base = locale.trim()\n  const canonical = normalizeLocale(base)\n  const extra = typeof fallbacks === \"string\" ? [fallbacks] : (fallbacks ?? [])\n\n  const output: string[] = []\n  const seen = new Set<string>()\n\n  const push = (value: string) => {\n    if (!value) return\n    if (seen.has(value)) return\n    seen.add(value)\n    output.push(value)\n  }\n\n  const addChain = (value: string) => {\n    if (!value) return\n    const parts = value.split(\"-\").filter(Boolean)\n    while (parts.length > 0) {\n      push(parts.join(\"-\"))\n      parts.pop()\n    }\n  }\n\n  addChain(base)\n  addChain(canonical)\n  for (const fallback of extra) addChain(normalizeLocale(fallback))\n\n  return output\n}\n\nexport function resolveLocalizedString(\n  value: LocalizedString | null | undefined,\n  locale: string,\n  options?: { fallbacks?: string | string[] }\n): string | undefined {\n  return resolveLocalizedStringEntry(value, locale, options)?.value\n}\n\nfunction resolveLocalizedStringEntry(\n  value: LocalizedString | null | undefined,\n  locale: string,\n  options?: { fallbacks?: string | string[] }\n): LocalizedStringEntry | undefined {\n  if (!value) return undefined\n  const chain = buildLocaleFallbackChain(locale, options?.fallbacks)\n  if (chain.length === 0) return undefined\n\n  const record = value\n  for (const key of chain) {\n    if (!Object.prototype.hasOwnProperty.call(record, key)) continue\n    return record[key] as LocalizedStringEntry\n  }\n  return undefined\n}\n\nexport function withLocalizedStringFallback<T>(value: T): T {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return value\n  if (value instanceof Map) return value\n  const cached = LOCALIZED_STRING_PROXY_CACHE.get(value)\n  if (cached) return cached as T\n\n  const proxy = withFallbackRecord(value as Record<string, unknown>)\n  LOCALIZED_STRING_PROXY_CACHE.set(value, proxy)\n  return proxy as T\n}\n\nfunction withFallbackRecord(record: Record<string, unknown>): LocalizedStringWithFallback {\n  const getExact = (key: string): LocalizedStringEntry | undefined => {\n    if (!hasExact(key)) return undefined\n    return record[key] as LocalizedStringEntry\n  }\n  const hasExact = (key: string) => Object.prototype.hasOwnProperty.call(record, key)\n\n  return new Proxy(record, {\n    get(target, prop) {\n      if (prop === \"getExact\") return getExact\n      if (prop === \"hasExact\") return hasExact\n      if (prop === \"get\") return (key: string) => resolveLocalizedStringEntry(target as LocalizedString, key)\n      if (typeof prop === \"string\" && !(prop in target)) {\n        return resolveLocalizedStringEntry(target as LocalizedString, prop)\n      }\n\n      return Reflect.get(target, prop)\n    },\n    set(target, prop, next) {\n      return Reflect.set(target, prop, next)\n    },\n  }) as LocalizedStringWithFallback\n}\n\nexport const zLocalizedString = () => {\n  const languageCodeSchema = z\n    .string()\n    .regex(LANGUAGE_CODE_REGEX, { message: \"Expected a language code (BCP 47, e.g. en or fr-FR).\" })\n  const entrySchema = z.object({\n    value: z.string(),\n    updatedAt: z.date(),\n    autoTranslated: z.boolean().optional(),\n  }).passthrough()\n  const schema = z.record(\n    languageCodeSchema,\n    entrySchema,\n  )\n\n  return schema\n}\n\nexport const zI18nString = zLocalizedString\n","import { z } from \"zod\"\n\n\nexport const E164_PHONE_REGEX = /^\\+[1-9]\\d{1,14}$/\nexport const E164_PHONE_OR_EMPTY_REGEX = /^(?:\\+[1-9]\\d{1,14})?$/\n\nexport type E164PhoneOptions = {\n  allowEmpty?: boolean\n}\n\nexport const makeZE164Phone = (zod: typeof z, options?: E164PhoneOptions) => {\n  const allowEmpty = options?.allowEmpty ?? false\n  return zod.string().trim().regex(allowEmpty ? E164_PHONE_OR_EMPTY_REGEX : E164_PHONE_REGEX, {\n    message: allowEmpty\n      ? \"Expected an empty string or a phone number in E.164 format (e.g. +33608707197).\"\n      : \"Expected a phone number in E.164 format (e.g. +33608707197).\",\n  })\n}\n\nexport const zE164Phone = (options?: E164PhoneOptions) => makeZE164Phone(z, options)\n","import { z } from \"zod\"\n\nimport { type E164PhoneOptions, makeZE164Phone } from \"./e164Phone\"\n\n\ntype RpcbaseZodExtension = typeof z & {\n  e164Phone?: (options?: E164PhoneOptions) => z.ZodString\n}\n\ntype ExtendableZodPrototype = {\n  unique?: (this: unknown, arg?: boolean) => unknown\n  sparse?: (this: unknown, arg?: boolean) => unknown\n}\n\ndeclare module \"zod\" {\n  interface ZodString {\n    unique(arg?: boolean): this\n    sparse(arg?: boolean): this\n  }\n\n  interface ZodNumber {\n    unique(arg?: boolean): this\n    sparse(arg?: boolean): this\n  }\n\n  interface ZodDate {\n    unique(arg?: boolean): this\n    sparse(arg?: boolean): this\n  }\n\n}\n\nlet zodPrototypesExtended = false\n\nexport function extendZod(zod: typeof z) {\n  const zodWithExtension = zod as RpcbaseZodExtension\n  if (Object.isExtensible(zodWithExtension) && typeof zodWithExtension.e164Phone !== \"function\") {\n    zodWithExtension.e164Phone = (options?: E164PhoneOptions) => makeZE164Phone(zod, options)\n  }\n\n  if (zodPrototypesExtended) return\n  zodPrototypesExtended = true\n\n  const supported = [zod.ZodString, zod.ZodNumber, zod.ZodDate] as const\n  for (const type of supported) {\n    const proto = type?.prototype as ExtendableZodPrototype | undefined\n    if (!proto) continue\n\n    proto.unique = function unique(this: unknown, _flag = true) {\n      return this\n    }\n\n    proto.sparse = function sparse(this: unknown, _flag = true) {\n      return this\n    }\n  }\n}\n","import { z as baseZ, type ZodError, type ZodString, type ZodType } from \"zod\"\n\nimport { extendZod } from \"./extension\"\n\n\nexport * from \"./e164Phone\"\nexport * from \"./localizedString\"\n\nexport type RpcbaseZod = typeof baseZ & {\n  e164Phone: (options?: import(\"./e164Phone\").E164PhoneOptions) => ZodString\n}\n\nexport const z = Object.create(baseZ) as RpcbaseZod\nextendZod(z)\n\nexport namespace z {\n  export type infer<T> = import(\"zod\").infer<T>\n  export type input<T> = import(\"zod\").input<T>\n  export type output<T> = import(\"zod\").output<T>\n  export type TypeOf<T> = import(\"zod\").TypeOf<T>\n  export type Infer<T> = import(\"zod\").Infer<T>\n}\n\nexport { extendZod, ZodError, ZodType }\n"],"names":["LANGUAGE_CODE_REGEX","LOCALIZED_STRING_PROXY_CACHE","WeakMap","normalizeLocale","locale","trimmed","trim","getCanonicalLocales","Intl","buildLocaleFallbackChain","fallbacks","base","canonical","extra","output","seen","Set","push","value","has","add","addChain","parts","split","filter","Boolean","length","join","pop","fallback","resolveLocalizedString","options","resolveLocalizedStringEntry","undefined","chain","record","key","Object","prototype","hasOwnProperty","call","withLocalizedStringFallback","Array","isArray","Map","cached","get","proxy","withFallbackRecord","set","getExact","hasExact","Proxy","target","prop","Reflect","next","zLocalizedString","languageCodeSchema","z","string","regex","message","entrySchema","object","updatedAt","date","autoTranslated","boolean","optional","passthrough","schema","zI18nString","E164_PHONE_REGEX","E164_PHONE_OR_EMPTY_REGEX","makeZE164Phone","zod","allowEmpty","zE164Phone","zodPrototypesExtended","extendZod","zodWithExtension","isExtensible","e164Phone","supported","ZodString","ZodNumber","ZodDate","type","proto","unique","_flag","sparse","create","baseZ"],"mappings":"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"}

package/dist/index.browser.js

@@ -1,4 +1,4 @@
-import { E, a, L, b, e, m, r, w, z, c, d, f } from "./index-BQeL_LHp.js";
+import { E, a, L, b, e, m, r, w, z, c, d, f } from "./index-BNcI2Uw0.js";
 export {
   E as E164_PHONE_OR_EMPTY_REGEX,
   a as E164_PHONE_REGEX,

package/dist/index.js

@@ -4,8 +4,8 @@ import mongoose, { Schema as Schema$1, Types } from "mongoose";
 import { default as default2 } from "mongoose";
 import { z } from "zod";
 import { timingSafeEqual, createHmac } from "node:crypto";
-import { w as withLocalizedStringFallback } from "./index-BQeL_LHp.js";
-import { E, a as a2, L, b as b2, e as e2, m, r, z as z2, c as c2, d as d2, f as f2 } from "./index-BQeL_LHp.js";
+import { w as withLocalizedStringFallback } from "./index-BNcI2Uw0.js";
+import { E, a as a2, L, b as b2, e as e2, m, r, z as z2, c as c2, d as d2, f as f2 } from "./index-BNcI2Uw0.js";
 import assert from "assert";
 import { getMongoUrl } from "./mongo.js";
 import { accessibleBy, accessibleRecordsPlugin } from "@casl/mongoose";

package/dist/zod/localizedString.d.ts

@@ -1,11 +1,16 @@
 import { z } from 'zod';
 export type LanguageCode = string;
-export type LocalizedString = Record<LanguageCode, string>;
+export type LocalizedStringEntry<TExtra extends Record<string, unknown> = Record<string, unknown>> = {
+    value: string;
+    updatedAt: Date;
+    autoTranslated?: boolean;
+} & TExtra;
+export type LocalizedString<TExtra extends Record<string, unknown> = Record<string, unknown>> = Record<LanguageCode, LocalizedStringEntry<TExtra>>;
 export type I18nStringRecord = LocalizedString;
 export type I18nString = LocalizedString;
 export type LocalizedStringWithFallback = LocalizedString & {
-    get: (key: string) => string | undefined;
-    getExact: (key: string) => string | undefined;
+    get: (key: string) => LocalizedStringEntry | undefined;
+    getExact: (key: string) => LocalizedStringEntry | undefined;
     hasExact: (key: string) => boolean;
 };
 export declare const LANGUAGE_CODE_REGEX: RegExp;
@@ -14,6 +19,14 @@ export declare function resolveLocalizedString(value: LocalizedString | null | u
     fallbacks?: string | string[];
 }): string | undefined;
 export declare function withLocalizedStringFallback<T>(value: T): T;
-export declare const zLocalizedString: () => z.ZodRecord<z.ZodString, z.ZodString>;
-export declare const zI18nString: () => z.ZodRecord<z.ZodString, z.ZodString>;
+export declare const zLocalizedString: () => z.ZodRecord<z.ZodString, z.ZodObject<{
+    value: z.ZodString;
+    updatedAt: z.ZodDate;
+    autoTranslated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>>;
+export declare const zI18nString: () => z.ZodRecord<z.ZodString, z.ZodObject<{
+    value: z.ZodString;
+    updatedAt: z.ZodDate;
+    autoTranslated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>>;
 //# sourceMappingURL=localizedString.d.ts.map

package/dist/zod/localizedString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localizedString.d.ts","sourceRoot":"","sources":["../../src/zod/localizedString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;AAE1D,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE9C,MAAM,MAAM,UAAU,GAAG,eAAe,CAAA;AAExC,MAAM,MAAM,2BAA2B,GAAG,eAAe,GAAG;IAC1D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC7C,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACnC,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAuC,CAAA;AAkBvE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CA6BhG;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,GAC1C,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAS1D;AA0BD,eAAO,MAAM,gBAAgB,6CAS5B,CAAA;AAED,eAAO,MAAM,WAAW,6CAAmB,CAAA"}
+{"version":3,"file":"localizedString.d.ts","sourceRoot":"","sources":["../../src/zod/localizedString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,MAAM,MAAM,oBAAoB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACnG,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,IAAI,CAAA;IACf,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,GAAG,MAAM,CAAA;AAEV,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CACpG,YAAY,EACZ,oBAAoB,CAAC,MAAM,CAAC,CAC7B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE9C,MAAM,MAAM,UAAU,GAAG,eAAe,CAAA;AAExC,MAAM,MAAM,2BAA2B,GAAG,eAAe,GAAG;IAC1D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,oBAAoB,GAAG,SAAS,CAAA;IACtD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,oBAAoB,GAAG,SAAS,CAAA;IAC3D,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACnC,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAuC,CAAA;AAkBvE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CA6BhG;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,GAC1C,MAAM,GAAG,SAAS,CAEpB;AAmBD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAS1D;AA0BD,eAAO,MAAM,gBAAgB;;;;kBAe5B,CAAA;AAED,eAAO,MAAM,WAAW;;;;kBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpcbase/db",
-  "version": "0.95.0",
+  "version": "0.97.0",
   "type": "module",
   "files": [
     "dist"
@@ -52,7 +52,11 @@
     },
     "build-watch": {
       "command": "../../node_modules/.bin/vite build --watch",
-      "service": true
+      "service": {
+        "readyWhen": {
+          "lineMatches": "^built in .*\\.$"
+        }
+      }
     },
     "release": {
       "command": "../../scripts/publish.js",

package/dist/index-BQeL_LHp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-BQeL_LHp.js","sources":["../src/zod/localizedString.ts","../src/zod/e164Phone.ts","../src/zod/extension.ts","../src/zod/index.ts"],"sourcesContent":["import { z } from \"zod\"\n\n\nexport type LanguageCode = string\n\nexport type LocalizedString = Record<LanguageCode, string>\n\nexport type I18nStringRecord = LocalizedString\n\nexport type I18nString = LocalizedString\n\nexport type LocalizedStringWithFallback = LocalizedString & {\n  get: (key: string) => string | undefined\n  getExact: (key: string) => string | undefined\n  hasExact: (key: string) => boolean\n}\n\nexport const LANGUAGE_CODE_REGEX = /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/\n\nconst LOCALIZED_STRING_PROXY_CACHE = new WeakMap<object, unknown>()\n\nfunction normalizeLocale(locale: string): string {\n  const trimmed = locale.trim()\n  if (!trimmed) return \"\"\n  const getCanonicalLocales = (Intl as typeof Intl & {\n    getCanonicalLocales?: (locales: string | readonly string[]) => string[]\n  }).getCanonicalLocales\n  if (typeof getCanonicalLocales !== \"function\") return trimmed\n  try {\n    return getCanonicalLocales(trimmed)[0] ?? trimmed\n  } catch {\n    return trimmed\n  }\n}\n\nexport function buildLocaleFallbackChain(locale: string, fallbacks?: string | string[]): string[] {\n  const base = locale.trim()\n  const canonical = normalizeLocale(base)\n  const extra = typeof fallbacks === \"string\" ? [fallbacks] : (fallbacks ?? [])\n\n  const output: string[] = []\n  const seen = new Set<string>()\n\n  const push = (value: string) => {\n    if (!value) return\n    if (seen.has(value)) return\n    seen.add(value)\n    output.push(value)\n  }\n\n  const addChain = (value: string) => {\n    if (!value) return\n    const parts = value.split(\"-\").filter(Boolean)\n    while (parts.length > 0) {\n      push(parts.join(\"-\"))\n      parts.pop()\n    }\n  }\n\n  addChain(base)\n  addChain(canonical)\n  for (const fallback of extra) addChain(normalizeLocale(fallback))\n\n  return output\n}\n\nexport function resolveLocalizedString(\n  value: LocalizedString | null | undefined,\n  locale: string,\n  options?: { fallbacks?: string | string[] }\n): string | undefined {\n  if (!value) return undefined\n  const chain = buildLocaleFallbackChain(locale, options?.fallbacks)\n  if (chain.length === 0) return undefined\n\n  const record = value\n  for (const key of chain) {\n    if (!Object.prototype.hasOwnProperty.call(record, key)) continue\n    return record[key]\n  }\n  return undefined\n}\n\nexport function withLocalizedStringFallback<T>(value: T): T {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return value\n  if (value instanceof Map) return value\n  const cached = LOCALIZED_STRING_PROXY_CACHE.get(value)\n  if (cached) return cached as T\n\n  const proxy = withFallbackRecord(value as Record<string, unknown>)\n  LOCALIZED_STRING_PROXY_CACHE.set(value, proxy)\n  return proxy as T\n}\n\nfunction withFallbackRecord(record: Record<string, unknown>): LocalizedStringWithFallback {\n  const getExact = (key: string): string | undefined => {\n    const current = record[key]\n    return typeof current === \"string\" ? current : undefined\n  }\n  const hasExact = (key: string) => Object.prototype.hasOwnProperty.call(record, key)\n\n  return new Proxy(record, {\n    get(target, prop) {\n      if (prop === \"getExact\") return getExact\n      if (prop === \"hasExact\") return hasExact\n      if (prop === \"get\") return (key: string) => resolveLocalizedString(target as LocalizedString, key)\n      if (typeof prop === \"string\" && !(prop in target)) {\n        return resolveLocalizedString(target as LocalizedString, prop)\n      }\n\n      return Reflect.get(target, prop)\n    },\n    set(target, prop, next) {\n      return Reflect.set(target, prop, next)\n    },\n  }) as LocalizedStringWithFallback\n}\n\nexport const zLocalizedString = () => {\n  const schema = z.record(\n    z\n      .string()\n      .regex(LANGUAGE_CODE_REGEX, { message: \"Expected a language code (BCP 47, e.g. en or fr-FR).\" }),\n    z.string()\n  ) as z.ZodRecord<z.ZodString, z.ZodString>\n\n  return schema\n}\n\nexport const zI18nString = zLocalizedString\n","import { z } from \"zod\"\n\n\nexport const E164_PHONE_REGEX = /^\\+[1-9]\\d{1,14}$/\nexport const E164_PHONE_OR_EMPTY_REGEX = /^(?:\\+[1-9]\\d{1,14})?$/\n\nexport type E164PhoneOptions = {\n  allowEmpty?: boolean\n}\n\nexport const makeZE164Phone = (zod: typeof z, options?: E164PhoneOptions) => {\n  const allowEmpty = options?.allowEmpty ?? false\n  return zod.string().trim().regex(allowEmpty ? E164_PHONE_OR_EMPTY_REGEX : E164_PHONE_REGEX, {\n    message: allowEmpty\n      ? \"Expected an empty string or a phone number in E.164 format (e.g. +33608707197).\"\n      : \"Expected a phone number in E.164 format (e.g. +33608707197).\",\n  })\n}\n\nexport const zE164Phone = (options?: E164PhoneOptions) => makeZE164Phone(z, options)\n","import { z } from \"zod\"\n\nimport { type E164PhoneOptions, makeZE164Phone } from \"./e164Phone\"\n\n\ntype RpcbaseZodExtension = typeof z & {\n  e164Phone?: (options?: E164PhoneOptions) => z.ZodString\n}\n\ntype ExtendableZodPrototype = {\n  unique?: (this: unknown, arg?: boolean) => unknown\n  sparse?: (this: unknown, arg?: boolean) => unknown\n}\n\ndeclare module \"zod\" {\n  interface ZodString {\n    unique(arg?: boolean): this\n    sparse(arg?: boolean): this\n  }\n\n  interface ZodNumber {\n    unique(arg?: boolean): this\n    sparse(arg?: boolean): this\n  }\n\n  interface ZodDate {\n    unique(arg?: boolean): this\n    sparse(arg?: boolean): this\n  }\n\n}\n\nlet zodPrototypesExtended = false\n\nexport function extendZod(zod: typeof z) {\n  const zodWithExtension = zod as RpcbaseZodExtension\n  if (Object.isExtensible(zodWithExtension) && typeof zodWithExtension.e164Phone !== \"function\") {\n    zodWithExtension.e164Phone = (options?: E164PhoneOptions) => makeZE164Phone(zod, options)\n  }\n\n  if (zodPrototypesExtended) return\n  zodPrototypesExtended = true\n\n  const supported = [zod.ZodString, zod.ZodNumber, zod.ZodDate] as const\n  for (const type of supported) {\n    const proto = type?.prototype as ExtendableZodPrototype | undefined\n    if (!proto) continue\n\n    proto.unique = function unique(this: unknown, _flag = true) {\n      return this\n    }\n\n    proto.sparse = function sparse(this: unknown, _flag = true) {\n      return this\n    }\n  }\n}\n","import { z as baseZ, type ZodError, type ZodString, type ZodType } from \"zod\"\n\nimport { extendZod } from \"./extension\"\n\n\nexport * from \"./e164Phone\"\nexport * from \"./localizedString\"\n\nexport type RpcbaseZod = typeof baseZ & {\n  e164Phone: (options?: import(\"./e164Phone\").E164PhoneOptions) => ZodString\n}\n\nexport const z = Object.create(baseZ) as RpcbaseZod\nextendZod(z)\n\nexport namespace z {\n  export type infer<T> = import(\"zod\").infer<T>\n  export type input<T> = import(\"zod\").input<T>\n  export type output<T> = import(\"zod\").output<T>\n  export type TypeOf<T> = import(\"zod\").TypeOf<T>\n  export type Infer<T> = import(\"zod\").Infer<T>\n}\n\nexport { extendZod, ZodError, ZodType }\n"],"names":["LANGUAGE_CODE_REGEX","LOCALIZED_STRING_PROXY_CACHE","WeakMap","normalizeLocale","locale","trimmed","trim","getCanonicalLocales","Intl","buildLocaleFallbackChain","fallbacks","base","canonical","extra","output","seen","Set","push","value","has","add","addChain","parts","split","filter","Boolean","length","join","pop","fallback","resolveLocalizedString","options","undefined","chain","record","key","Object","prototype","hasOwnProperty","call","withLocalizedStringFallback","Array","isArray","Map","cached","get","proxy","withFallbackRecord","set","getExact","current","hasExact","Proxy","target","prop","Reflect","next","zLocalizedString","schema","z","string","regex","message","zI18nString","E164_PHONE_REGEX","E164_PHONE_OR_EMPTY_REGEX","makeZE164Phone","zod","allowEmpty","zE164Phone","zodPrototypesExtended","extendZod","zodWithExtension","isExtensible","e164Phone","supported","ZodString","ZodNumber","ZodDate","type","proto","unique","_flag","sparse","create","baseZ"],"mappings":"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"}