@m5kdev/commons 0.21.9 → 0.23.0

package/dist/src/modules/auth/auth.constants.cjs

@@ -2,8 +2,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/modules/auth/auth.constants.ts
 const ADMIN_CREATE_VERIFIED_USER_HEADER = "Admin-Create-Verified-User";
 const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = "true";
+const USER_LOCALE_HEADER = "User-Locale";
 //#endregion
 exports.ADMIN_CREATE_VERIFIED_USER_HEADER = ADMIN_CREATE_VERIFIED_USER_HEADER;
 exports.ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE;
+exports.USER_LOCALE_HEADER = USER_LOCALE_HEADER;
 
 //# sourceMappingURL=auth.constants.cjs.map

package/dist/src/modules/auth/auth.constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"auth.constants.cjs","names":[],"sources":["../../../../src/modules/auth/auth.constants.ts"],"sourcesContent":["export const ADMIN_CREATE_VERIFIED_USER_HEADER = \"Admin-Create-Verified-User\" as const;\r\nexport const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = \"true\" as const;\r\n"],"mappings":";;AAAA,MAAa,oCAAoC;AACjD,MAAa,0CAA0C"}
+{"version":3,"file":"auth.constants.cjs","names":[],"sources":["../../../../src/modules/auth/auth.constants.ts"],"sourcesContent":["export const ADMIN_CREATE_VERIFIED_USER_HEADER = \"Admin-Create-Verified-User\" as const;\r\nexport const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = \"true\" as const;\r\nexport const USER_LOCALE_HEADER = \"User-Locale\" as const;\r\n"],"mappings":";;AAAA,MAAa,oCAAoC;AACjD,MAAa,0CAA0C;AACvD,MAAa,qBAAqB"}

package/dist/src/modules/auth/auth.constants.d.cts

@@ -1,6 +1,7 @@
 //#region src/modules/auth/auth.constants.d.ts
 declare const ADMIN_CREATE_VERIFIED_USER_HEADER: "Admin-Create-Verified-User";
 declare const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE: "true";
+declare const USER_LOCALE_HEADER: "User-Locale";
 //#endregion
-export { ADMIN_CREATE_VERIFIED_USER_HEADER, ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE };
+export { ADMIN_CREATE_VERIFIED_USER_HEADER, ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE, USER_LOCALE_HEADER };
 //# sourceMappingURL=auth.constants.d.cts.map

package/dist/src/modules/auth/auth.constants.d.mts

@@ -1,6 +1,7 @@
 //#region src/modules/auth/auth.constants.d.ts
 declare const ADMIN_CREATE_VERIFIED_USER_HEADER: "Admin-Create-Verified-User";
 declare const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE: "true";
+declare const USER_LOCALE_HEADER: "User-Locale";
 //#endregion
-export { ADMIN_CREATE_VERIFIED_USER_HEADER, ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE };
+export { ADMIN_CREATE_VERIFIED_USER_HEADER, ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE, USER_LOCALE_HEADER };
 //# sourceMappingURL=auth.constants.d.mts.map

package/dist/src/modules/auth/auth.constants.mjs

@@ -1,7 +1,8 @@
 //#region src/modules/auth/auth.constants.ts
 const ADMIN_CREATE_VERIFIED_USER_HEADER = "Admin-Create-Verified-User";
 const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = "true";
+const USER_LOCALE_HEADER = "User-Locale";
 //#endregion
-export { ADMIN_CREATE_VERIFIED_USER_HEADER, ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE };
+export { ADMIN_CREATE_VERIFIED_USER_HEADER, ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE, USER_LOCALE_HEADER };
 
 //# sourceMappingURL=auth.constants.mjs.map

package/dist/src/modules/auth/auth.constants.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"auth.constants.mjs","names":[],"sources":["../../../../src/modules/auth/auth.constants.ts"],"sourcesContent":["export const ADMIN_CREATE_VERIFIED_USER_HEADER = \"Admin-Create-Verified-User\" as const;\r\nexport const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = \"true\" as const;\r\n"],"mappings":";AAAA,MAAa,oCAAoC;AACjD,MAAa,0CAA0C"}
+{"version":3,"file":"auth.constants.mjs","names":[],"sources":["../../../../src/modules/auth/auth.constants.ts"],"sourcesContent":["export const ADMIN_CREATE_VERIFIED_USER_HEADER = \"Admin-Create-Verified-User\" as const;\r\nexport const ADMIN_CREATE_VERIFIED_USER_HEADER_VALUE = \"true\" as const;\r\nexport const USER_LOCALE_HEADER = \"User-Locale\" as const;\r\n"],"mappings":";AAAA,MAAa,oCAAoC;AACjD,MAAa,0CAA0C;AACvD,MAAa,qBAAqB"}

package/dist/src/modules/auth/auth.locale.cjs

@@ -0,0 +1,73 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let zod = require("zod");
+//#region src/modules/auth/auth.locale.ts
+function getAllowedLocaleCodes(config) {
+	return config.locales.map((locale) => locale.code);
+}
+function getLocaleDisplayName(config, code) {
+	return config.locales.find((locale) => locale.code === code)?.displayName ?? code;
+}
+function normalizeLocaleTag(tag) {
+	const trimmed = tag.trim();
+	if (!trimmed) return null;
+	const parts = trimmed.replace(/_/g, "-").split("-").filter(Boolean);
+	if (parts.length === 0) return null;
+	const language = parts[0].toLowerCase();
+	const region = parts.length > 1 ? parts[1].toUpperCase() : null;
+	return {
+		language,
+		region,
+		compareKey: region ? `${language}_${region}` : language
+	};
+}
+function buildCompareKeyFromCanonical(canonical) {
+	return normalizeLocaleTag(canonical)?.compareKey ?? canonical.toLowerCase();
+}
+function toCanonicalLocale(tag, allowedLocales) {
+	const normalized = normalizeLocaleTag(tag);
+	if (!normalized) return null;
+	const allowedByKey = /* @__PURE__ */ new Map();
+	for (const locale of allowedLocales) allowedByKey.set(buildCompareKeyFromCanonical(locale), locale);
+	if (normalized.region) {
+		const regionMatch = allowedByKey.get(`${normalized.language}_${normalized.region}`);
+		if (regionMatch) return regionMatch;
+	}
+	if (!normalized.region) {
+		const languageMatch = allowedByKey.get(normalized.language);
+		if (languageMatch) return languageMatch;
+	}
+	if (normalized.region) {
+		const languageMatch = allowedByKey.get(normalized.language);
+		if (languageMatch) return languageMatch;
+	}
+	return null;
+}
+function toI18nLanguageTag(canonical) {
+	const normalized = normalizeLocaleTag(canonical);
+	if (!normalized) return canonical;
+	if (normalized.region) return `${normalized.language}-${normalized.region}`;
+	return normalized.language;
+}
+function resolveAppLocale(requested, config) {
+	const allowedLocales = getAllowedLocaleCodes(config);
+	if (requested) {
+		const canonical = toCanonicalLocale(requested, allowedLocales);
+		if (canonical) return canonical;
+	}
+	return toCanonicalLocale(config.defaultLocale, allowedLocales) ?? allowedLocales[0] ?? config.defaultLocale;
+}
+function createLocaleValueSchema(config) {
+	const allowed = [...getAllowedLocaleCodes(config)];
+	if (allowed.length === 0) return zod.z.string();
+	return zod.z.enum(allowed);
+}
+//#endregion
+exports.createLocaleValueSchema = createLocaleValueSchema;
+exports.getAllowedLocaleCodes = getAllowedLocaleCodes;
+exports.getLocaleDisplayName = getLocaleDisplayName;
+exports.normalizeLocaleTag = normalizeLocaleTag;
+exports.resolveAppLocale = resolveAppLocale;
+exports.toCanonicalLocale = toCanonicalLocale;
+exports.toI18nLanguageTag = toI18nLanguageTag;
+
+//# sourceMappingURL=auth.locale.cjs.map

package/dist/src/modules/auth/auth.locale.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.locale.cjs","names":["z"],"sources":["../../../../src/modules/auth/auth.locale.ts"],"sourcesContent":["import { z } from \"zod\";\r\n\r\nexport interface AuthLocaleDefinition {\r\n  code: string;\r\n  displayName: string;\r\n}\r\n\r\nexport interface AuthLocaleConfig {\r\n  defaultLocale: string;\r\n  locales: readonly AuthLocaleDefinition[];\r\n}\r\n\r\nexport function getAllowedLocaleCodes(config: AuthLocaleConfig): readonly string[] {\r\n  return config.locales.map((locale) => locale.code);\r\n}\r\n\r\nexport function getLocaleDisplayName(config: AuthLocaleConfig, code: string): string {\r\n  return config.locales.find((locale) => locale.code === code)?.displayName ?? code;\r\n}\r\n\r\nexport interface NormalizedLocaleTag {\r\n  language: string;\r\n  region: string | null;\r\n  compareKey: string;\r\n}\r\n\r\nexport function normalizeLocaleTag(tag: string): NormalizedLocaleTag | null {\r\n  const trimmed = tag.trim();\r\n  if (!trimmed) return null;\r\n\r\n  const parts = trimmed.replace(/_/g, \"-\").split(\"-\").filter(Boolean);\r\n  if (parts.length === 0) return null;\r\n\r\n  const language = parts[0].toLowerCase();\r\n  const region = parts.length > 1 ? parts[1].toUpperCase() : null;\r\n  const compareKey = region ? `${language}_${region}` : language;\r\n\r\n  return { language, region, compareKey };\r\n}\r\n\r\nfunction buildCompareKeyFromCanonical(canonical: string): string {\r\n  return normalizeLocaleTag(canonical)?.compareKey ?? canonical.toLowerCase();\r\n}\r\n\r\nexport function toCanonicalLocale(\r\n  tag: string,\r\n  allowedLocales: readonly string[]\r\n): string | null {\r\n  const normalized = normalizeLocaleTag(tag);\r\n  if (!normalized) return null;\r\n\r\n  const allowedByKey = new Map<string, string>();\r\n  for (const locale of allowedLocales) {\r\n    allowedByKey.set(buildCompareKeyFromCanonical(locale), locale);\r\n  }\r\n\r\n  if (normalized.region) {\r\n    const regionMatch = allowedByKey.get(`${normalized.language}_${normalized.region}`);\r\n    if (regionMatch) return regionMatch;\r\n  }\r\n\r\n  if (!normalized.region) {\r\n    const languageMatch = allowedByKey.get(normalized.language);\r\n    if (languageMatch) return languageMatch;\r\n  }\r\n\r\n  if (normalized.region) {\r\n    const languageMatch = allowedByKey.get(normalized.language);\r\n    if (languageMatch) return languageMatch;\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\nexport function toI18nLanguageTag(canonical: string): string {\r\n  const normalized = normalizeLocaleTag(canonical);\r\n  if (!normalized) return canonical;\r\n  if (normalized.region) {\r\n    return `${normalized.language}-${normalized.region}`;\r\n  }\r\n  return normalized.language;\r\n}\r\n\r\nexport function resolveAppLocale(\r\n  requested: string | null | undefined,\r\n  config: AuthLocaleConfig\r\n): string {\r\n  const allowedLocales = getAllowedLocaleCodes(config);\r\n  if (requested) {\r\n    const canonical = toCanonicalLocale(requested, allowedLocales);\r\n    if (canonical) return canonical;\r\n  }\r\n\r\n  const defaultCanonical = toCanonicalLocale(config.defaultLocale, allowedLocales);\r\n  return defaultCanonical ?? allowedLocales[0] ?? config.defaultLocale;\r\n}\r\n\r\nexport function createLocaleValueSchema(config: AuthLocaleConfig) {\r\n  const allowed = [...getAllowedLocaleCodes(config)];\r\n  if (allowed.length === 0) {\r\n    return z.string();\r\n  }\r\n  return z.enum(allowed as [string, ...string[]]);\r\n}\r\n"],"mappings":";;;AAYA,SAAgB,sBAAsB,QAA6C;AACjF,QAAO,OAAO,QAAQ,KAAK,WAAW,OAAO,KAAK;;AAGpD,SAAgB,qBAAqB,QAA0B,MAAsB;AACnF,QAAO,OAAO,QAAQ,MAAM,WAAW,OAAO,SAAS,KAAK,EAAE,eAAe;;AAS/E,SAAgB,mBAAmB,KAAyC;CAC1E,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QAAS,QAAO;CAErB,MAAM,QAAQ,QAAQ,QAAQ,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,QAAQ;AACnE,KAAI,MAAM,WAAW,EAAG,QAAO;CAE/B,MAAM,WAAW,MAAM,GAAG,aAAa;CACvC,MAAM,SAAS,MAAM,SAAS,IAAI,MAAM,GAAG,aAAa,GAAG;AAG3D,QAAO;EAAE;EAAU;EAAQ,YAFR,SAAS,GAAG,SAAS,GAAG,WAAW;EAEf;;AAGzC,SAAS,6BAA6B,WAA2B;AAC/D,QAAO,mBAAmB,UAAU,EAAE,cAAc,UAAU,aAAa;;AAG7E,SAAgB,kBACd,KACA,gBACe;CACf,MAAM,aAAa,mBAAmB,IAAI;AAC1C,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,+BAAe,IAAI,KAAqB;AAC9C,MAAK,MAAM,UAAU,eACnB,cAAa,IAAI,6BAA6B,OAAO,EAAE,OAAO;AAGhE,KAAI,WAAW,QAAQ;EACrB,MAAM,cAAc,aAAa,IAAI,GAAG,WAAW,SAAS,GAAG,WAAW,SAAS;AACnF,MAAI,YAAa,QAAO;;AAG1B,KAAI,CAAC,WAAW,QAAQ;EACtB,MAAM,gBAAgB,aAAa,IAAI,WAAW,SAAS;AAC3D,MAAI,cAAe,QAAO;;AAG5B,KAAI,WAAW,QAAQ;EACrB,MAAM,gBAAgB,aAAa,IAAI,WAAW,SAAS;AAC3D,MAAI,cAAe,QAAO;;AAG5B,QAAO;;AAGT,SAAgB,kBAAkB,WAA2B;CAC3D,MAAM,aAAa,mBAAmB,UAAU;AAChD,KAAI,CAAC,WAAY,QAAO;AACxB,KAAI,WAAW,OACb,QAAO,GAAG,WAAW,SAAS,GAAG,WAAW;AAE9C,QAAO,WAAW;;AAGpB,SAAgB,iBACd,WACA,QACQ;CACR,MAAM,iBAAiB,sBAAsB,OAAO;AACpD,KAAI,WAAW;EACb,MAAM,YAAY,kBAAkB,WAAW,eAAe;AAC9D,MAAI,UAAW,QAAO;;AAIxB,QADyB,kBAAkB,OAAO,eAAe,eAAe,IACrD,eAAe,MAAM,OAAO;;AAGzD,SAAgB,wBAAwB,QAA0B;CAChE,MAAM,UAAU,CAAC,GAAG,sBAAsB,OAAO,CAAC;AAClD,KAAI,QAAQ,WAAW,EACrB,QAAOA,IAAAA,EAAE,QAAQ;AAEnB,QAAOA,IAAAA,EAAE,KAAK,QAAiC"}

package/dist/src/modules/auth/auth.locale.d.cts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+
+//#region src/modules/auth/auth.locale.d.ts
+interface AuthLocaleDefinition {
+  code: string;
+  displayName: string;
+}
+interface AuthLocaleConfig {
+  defaultLocale: string;
+  locales: readonly AuthLocaleDefinition[];
+}
+declare function getAllowedLocaleCodes(config: AuthLocaleConfig): readonly string[];
+declare function getLocaleDisplayName(config: AuthLocaleConfig, code: string): string;
+interface NormalizedLocaleTag {
+  language: string;
+  region: string | null;
+  compareKey: string;
+}
+declare function normalizeLocaleTag(tag: string): NormalizedLocaleTag | null;
+declare function toCanonicalLocale(tag: string, allowedLocales: readonly string[]): string | null;
+declare function toI18nLanguageTag(canonical: string): string;
+declare function resolveAppLocale(requested: string | null | undefined, config: AuthLocaleConfig): string;
+declare function createLocaleValueSchema(config: AuthLocaleConfig): z.ZodString | z.ZodEnum<{
+  [x: string]: string;
+}>;
+//#endregion
+export { AuthLocaleConfig, AuthLocaleDefinition, NormalizedLocaleTag, createLocaleValueSchema, getAllowedLocaleCodes, getLocaleDisplayName, normalizeLocaleTag, resolveAppLocale, toCanonicalLocale, toI18nLanguageTag };
+//# sourceMappingURL=auth.locale.d.cts.map

package/dist/src/modules/auth/auth.locale.d.mts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+
+//#region src/modules/auth/auth.locale.d.ts
+interface AuthLocaleDefinition {
+  code: string;
+  displayName: string;
+}
+interface AuthLocaleConfig {
+  defaultLocale: string;
+  locales: readonly AuthLocaleDefinition[];
+}
+declare function getAllowedLocaleCodes(config: AuthLocaleConfig): readonly string[];
+declare function getLocaleDisplayName(config: AuthLocaleConfig, code: string): string;
+interface NormalizedLocaleTag {
+  language: string;
+  region: string | null;
+  compareKey: string;
+}
+declare function normalizeLocaleTag(tag: string): NormalizedLocaleTag | null;
+declare function toCanonicalLocale(tag: string, allowedLocales: readonly string[]): string | null;
+declare function toI18nLanguageTag(canonical: string): string;
+declare function resolveAppLocale(requested: string | null | undefined, config: AuthLocaleConfig): string;
+declare function createLocaleValueSchema(config: AuthLocaleConfig): z.ZodString | z.ZodEnum<{
+  [x: string]: string;
+}>;
+//#endregion
+export { AuthLocaleConfig, AuthLocaleDefinition, NormalizedLocaleTag, createLocaleValueSchema, getAllowedLocaleCodes, getLocaleDisplayName, normalizeLocaleTag, resolveAppLocale, toCanonicalLocale, toI18nLanguageTag };
+//# sourceMappingURL=auth.locale.d.mts.map

package/dist/src/modules/auth/auth.locale.mjs

@@ -0,0 +1,66 @@
+import { z } from "zod";
+//#region src/modules/auth/auth.locale.ts
+function getAllowedLocaleCodes(config) {
+	return config.locales.map((locale) => locale.code);
+}
+function getLocaleDisplayName(config, code) {
+	return config.locales.find((locale) => locale.code === code)?.displayName ?? code;
+}
+function normalizeLocaleTag(tag) {
+	const trimmed = tag.trim();
+	if (!trimmed) return null;
+	const parts = trimmed.replace(/_/g, "-").split("-").filter(Boolean);
+	if (parts.length === 0) return null;
+	const language = parts[0].toLowerCase();
+	const region = parts.length > 1 ? parts[1].toUpperCase() : null;
+	return {
+		language,
+		region,
+		compareKey: region ? `${language}_${region}` : language
+	};
+}
+function buildCompareKeyFromCanonical(canonical) {
+	return normalizeLocaleTag(canonical)?.compareKey ?? canonical.toLowerCase();
+}
+function toCanonicalLocale(tag, allowedLocales) {
+	const normalized = normalizeLocaleTag(tag);
+	if (!normalized) return null;
+	const allowedByKey = /* @__PURE__ */ new Map();
+	for (const locale of allowedLocales) allowedByKey.set(buildCompareKeyFromCanonical(locale), locale);
+	if (normalized.region) {
+		const regionMatch = allowedByKey.get(`${normalized.language}_${normalized.region}`);
+		if (regionMatch) return regionMatch;
+	}
+	if (!normalized.region) {
+		const languageMatch = allowedByKey.get(normalized.language);
+		if (languageMatch) return languageMatch;
+	}
+	if (normalized.region) {
+		const languageMatch = allowedByKey.get(normalized.language);
+		if (languageMatch) return languageMatch;
+	}
+	return null;
+}
+function toI18nLanguageTag(canonical) {
+	const normalized = normalizeLocaleTag(canonical);
+	if (!normalized) return canonical;
+	if (normalized.region) return `${normalized.language}-${normalized.region}`;
+	return normalized.language;
+}
+function resolveAppLocale(requested, config) {
+	const allowedLocales = getAllowedLocaleCodes(config);
+	if (requested) {
+		const canonical = toCanonicalLocale(requested, allowedLocales);
+		if (canonical) return canonical;
+	}
+	return toCanonicalLocale(config.defaultLocale, allowedLocales) ?? allowedLocales[0] ?? config.defaultLocale;
+}
+function createLocaleValueSchema(config) {
+	const allowed = [...getAllowedLocaleCodes(config)];
+	if (allowed.length === 0) return z.string();
+	return z.enum(allowed);
+}
+//#endregion
+export { createLocaleValueSchema, getAllowedLocaleCodes, getLocaleDisplayName, normalizeLocaleTag, resolveAppLocale, toCanonicalLocale, toI18nLanguageTag };
+
+//# sourceMappingURL=auth.locale.mjs.map

package/dist/src/modules/auth/auth.locale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.locale.mjs","names":[],"sources":["../../../../src/modules/auth/auth.locale.ts"],"sourcesContent":["import { z } from \"zod\";\r\n\r\nexport interface AuthLocaleDefinition {\r\n  code: string;\r\n  displayName: string;\r\n}\r\n\r\nexport interface AuthLocaleConfig {\r\n  defaultLocale: string;\r\n  locales: readonly AuthLocaleDefinition[];\r\n}\r\n\r\nexport function getAllowedLocaleCodes(config: AuthLocaleConfig): readonly string[] {\r\n  return config.locales.map((locale) => locale.code);\r\n}\r\n\r\nexport function getLocaleDisplayName(config: AuthLocaleConfig, code: string): string {\r\n  return config.locales.find((locale) => locale.code === code)?.displayName ?? code;\r\n}\r\n\r\nexport interface NormalizedLocaleTag {\r\n  language: string;\r\n  region: string | null;\r\n  compareKey: string;\r\n}\r\n\r\nexport function normalizeLocaleTag(tag: string): NormalizedLocaleTag | null {\r\n  const trimmed = tag.trim();\r\n  if (!trimmed) return null;\r\n\r\n  const parts = trimmed.replace(/_/g, \"-\").split(\"-\").filter(Boolean);\r\n  if (parts.length === 0) return null;\r\n\r\n  const language = parts[0].toLowerCase();\r\n  const region = parts.length > 1 ? parts[1].toUpperCase() : null;\r\n  const compareKey = region ? `${language}_${region}` : language;\r\n\r\n  return { language, region, compareKey };\r\n}\r\n\r\nfunction buildCompareKeyFromCanonical(canonical: string): string {\r\n  return normalizeLocaleTag(canonical)?.compareKey ?? canonical.toLowerCase();\r\n}\r\n\r\nexport function toCanonicalLocale(\r\n  tag: string,\r\n  allowedLocales: readonly string[]\r\n): string | null {\r\n  const normalized = normalizeLocaleTag(tag);\r\n  if (!normalized) return null;\r\n\r\n  const allowedByKey = new Map<string, string>();\r\n  for (const locale of allowedLocales) {\r\n    allowedByKey.set(buildCompareKeyFromCanonical(locale), locale);\r\n  }\r\n\r\n  if (normalized.region) {\r\n    const regionMatch = allowedByKey.get(`${normalized.language}_${normalized.region}`);\r\n    if (regionMatch) return regionMatch;\r\n  }\r\n\r\n  if (!normalized.region) {\r\n    const languageMatch = allowedByKey.get(normalized.language);\r\n    if (languageMatch) return languageMatch;\r\n  }\r\n\r\n  if (normalized.region) {\r\n    const languageMatch = allowedByKey.get(normalized.language);\r\n    if (languageMatch) return languageMatch;\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\nexport function toI18nLanguageTag(canonical: string): string {\r\n  const normalized = normalizeLocaleTag(canonical);\r\n  if (!normalized) return canonical;\r\n  if (normalized.region) {\r\n    return `${normalized.language}-${normalized.region}`;\r\n  }\r\n  return normalized.language;\r\n}\r\n\r\nexport function resolveAppLocale(\r\n  requested: string | null | undefined,\r\n  config: AuthLocaleConfig\r\n): string {\r\n  const allowedLocales = getAllowedLocaleCodes(config);\r\n  if (requested) {\r\n    const canonical = toCanonicalLocale(requested, allowedLocales);\r\n    if (canonical) return canonical;\r\n  }\r\n\r\n  const defaultCanonical = toCanonicalLocale(config.defaultLocale, allowedLocales);\r\n  return defaultCanonical ?? allowedLocales[0] ?? config.defaultLocale;\r\n}\r\n\r\nexport function createLocaleValueSchema(config: AuthLocaleConfig) {\r\n  const allowed = [...getAllowedLocaleCodes(config)];\r\n  if (allowed.length === 0) {\r\n    return z.string();\r\n  }\r\n  return z.enum(allowed as [string, ...string[]]);\r\n}\r\n"],"mappings":";;AAYA,SAAgB,sBAAsB,QAA6C;AACjF,QAAO,OAAO,QAAQ,KAAK,WAAW,OAAO,KAAK;;AAGpD,SAAgB,qBAAqB,QAA0B,MAAsB;AACnF,QAAO,OAAO,QAAQ,MAAM,WAAW,OAAO,SAAS,KAAK,EAAE,eAAe;;AAS/E,SAAgB,mBAAmB,KAAyC;CAC1E,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QAAS,QAAO;CAErB,MAAM,QAAQ,QAAQ,QAAQ,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,QAAQ;AACnE,KAAI,MAAM,WAAW,EAAG,QAAO;CAE/B,MAAM,WAAW,MAAM,GAAG,aAAa;CACvC,MAAM,SAAS,MAAM,SAAS,IAAI,MAAM,GAAG,aAAa,GAAG;AAG3D,QAAO;EAAE;EAAU;EAAQ,YAFR,SAAS,GAAG,SAAS,GAAG,WAAW;EAEf;;AAGzC,SAAS,6BAA6B,WAA2B;AAC/D,QAAO,mBAAmB,UAAU,EAAE,cAAc,UAAU,aAAa;;AAG7E,SAAgB,kBACd,KACA,gBACe;CACf,MAAM,aAAa,mBAAmB,IAAI;AAC1C,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,+BAAe,IAAI,KAAqB;AAC9C,MAAK,MAAM,UAAU,eACnB,cAAa,IAAI,6BAA6B,OAAO,EAAE,OAAO;AAGhE,KAAI,WAAW,QAAQ;EACrB,MAAM,cAAc,aAAa,IAAI,GAAG,WAAW,SAAS,GAAG,WAAW,SAAS;AACnF,MAAI,YAAa,QAAO;;AAG1B,KAAI,CAAC,WAAW,QAAQ;EACtB,MAAM,gBAAgB,aAAa,IAAI,WAAW,SAAS;AAC3D,MAAI,cAAe,QAAO;;AAG5B,KAAI,WAAW,QAAQ;EACrB,MAAM,gBAAgB,aAAa,IAAI,WAAW,SAAS;AAC3D,MAAI,cAAe,QAAO;;AAG5B,QAAO;;AAGT,SAAgB,kBAAkB,WAA2B;CAC3D,MAAM,aAAa,mBAAmB,UAAU;AAChD,KAAI,CAAC,WAAY,QAAO;AACxB,KAAI,WAAW,OACb,QAAO,GAAG,WAAW,SAAS,GAAG,WAAW;AAE9C,QAAO,WAAW;;AAGpB,SAAgB,iBACd,WACA,QACQ;CACR,MAAM,iBAAiB,sBAAsB,OAAO;AACpD,KAAI,WAAW;EACb,MAAM,YAAY,kBAAkB,WAAW,eAAe;AAC9D,MAAI,UAAW,QAAO;;AAIxB,QADyB,kBAAkB,OAAO,eAAe,eAAe,IACrD,eAAe,MAAM,OAAO;;AAGzD,SAAgB,wBAAwB,QAA0B;CAChE,MAAM,UAAU,CAAC,GAAG,sBAAsB,OAAO,CAAC;AAClD,KAAI,QAAQ,WAAW,EACrB,QAAO,EAAE,QAAQ;AAEnB,QAAO,EAAE,KAAK,QAAiC"}

package/dist/src/modules/notification/notification.schema.d.cts

@@ -12,9 +12,9 @@ declare const notificationProviderSchema: z.ZodEnum<{
   fcm: "fcm";
 }>;
 declare const notificationSendStatusSchema: z.ZodEnum<{
+  failed: "failed";
   pending: "pending";
   sent: "sent";
-  failed: "failed";
 }>;
 /** Web Push `PushSubscriptionJSON` subset we persist and accept from clients. */
 declare const pushSubscriptionJsonSchema: z.ZodObject<{
@@ -100,9 +100,9 @@ declare const notificationSendLogSelectSchema: z.ZodObject<{
   body: z.ZodString;
   data: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   status: z.ZodEnum<{
+    failed: "failed";
     pending: "pending";
     sent: "sent";
-    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   jobId: z.ZodNullable<z.ZodString>;
@@ -127,9 +127,9 @@ declare const notificationListSendLogsOutputSchema: z.ZodArray<z.ZodObject<{
   body: z.ZodString;
   data: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   status: z.ZodEnum<{
+    failed: "failed";
     pending: "pending";
     sent: "sent";
-    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   jobId: z.ZodNullable<z.ZodString>;

package/dist/src/modules/notification/notification.schema.d.mts

@@ -12,9 +12,9 @@ declare const notificationProviderSchema: z.ZodEnum<{
   fcm: "fcm";
 }>;
 declare const notificationSendStatusSchema: z.ZodEnum<{
+  failed: "failed";
   pending: "pending";
   sent: "sent";
-  failed: "failed";
 }>;
 /** Web Push `PushSubscriptionJSON` subset we persist and accept from clients. */
 declare const pushSubscriptionJsonSchema: z.ZodObject<{
@@ -100,9 +100,9 @@ declare const notificationSendLogSelectSchema: z.ZodObject<{
   body: z.ZodString;
   data: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   status: z.ZodEnum<{
+    failed: "failed";
     pending: "pending";
     sent: "sent";
-    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   jobId: z.ZodNullable<z.ZodString>;
@@ -127,9 +127,9 @@ declare const notificationListSendLogsOutputSchema: z.ZodArray<z.ZodObject<{
   body: z.ZodString;
   data: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   status: z.ZodEnum<{
+    failed: "failed";
     pending: "pending";
     sent: "sent";
-    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   jobId: z.ZodNullable<z.ZodString>;

package/dist/src/modules/schemas/query.schema.d.cts

@@ -12,10 +12,10 @@ declare const filterSchema: z.ZodObject<{
     jsonArray: "jsonArray";
   }>;
   method: z.ZodEnum<{
-    contains: "contains";
-    equals: "equals";
     starts_with: "starts_with";
     ends_with: "ends_with";
+    contains: "contains";
+    equals: "equals";
     greater_than: "greater_than";
     less_than: "less_than";
     on: "on";
@@ -44,10 +44,10 @@ declare const filtersSchema: z.ZodArray<z.ZodObject<{
     jsonArray: "jsonArray";
   }>;
   method: z.ZodEnum<{
-    contains: "contains";
-    equals: "equals";
     starts_with: "starts_with";
     ends_with: "ends_with";
+    contains: "contains";
+    equals: "equals";
     greater_than: "greater_than";
     less_than: "less_than";
     on: "on";
@@ -84,10 +84,10 @@ declare const querySchema: z.ZodObject<{
       jsonArray: "jsonArray";
     }>;
     method: z.ZodEnum<{
-      contains: "contains";
-      equals: "equals";
       starts_with: "starts_with";
       ends_with: "ends_with";
+      contains: "contains";
+      equals: "equals";
       greater_than: "greater_than";
       less_than: "less_than";
       on: "on";

package/dist/src/modules/schemas/query.schema.d.mts

@@ -12,10 +12,10 @@ declare const filterSchema: z.ZodObject<{
     jsonArray: "jsonArray";
   }>;
   method: z.ZodEnum<{
-    contains: "contains";
-    equals: "equals";
     starts_with: "starts_with";
     ends_with: "ends_with";
+    contains: "contains";
+    equals: "equals";
     greater_than: "greater_than";
     less_than: "less_than";
     on: "on";
@@ -44,10 +44,10 @@ declare const filtersSchema: z.ZodArray<z.ZodObject<{
     jsonArray: "jsonArray";
   }>;
   method: z.ZodEnum<{
-    contains: "contains";
-    equals: "equals";
     starts_with: "starts_with";
     ends_with: "ends_with";
+    contains: "contains";
+    equals: "equals";
     greater_than: "greater_than";
     less_than: "less_than";
     on: "on";
@@ -84,10 +84,10 @@ declare const querySchema: z.ZodObject<{
       jsonArray: "jsonArray";
     }>;
     method: z.ZodEnum<{
-      contains: "contains";
-      equals: "equals";
       starts_with: "starts_with";
       ends_with: "ends_with";
+      contains: "contains";
+      equals: "equals";
       greater_than: "greater_than";
       less_than: "less_than";
       on: "on";

package/dist/src/modules/tag/tag.schema.d.cts

@@ -42,10 +42,10 @@ declare const tagListInputSchema: z.ZodObject<{
       jsonArray: "jsonArray";
     }>;
     method: z.ZodEnum<{
-      contains: "contains";
-      equals: "equals";
       starts_with: "starts_with";
       ends_with: "ends_with";
+      contains: "contains";
+      equals: "equals";
       greater_than: "greater_than";
       less_than: "less_than";
       on: "on";

package/dist/src/modules/tag/tag.schema.d.mts

@@ -42,10 +42,10 @@ declare const tagListInputSchema: z.ZodObject<{
       jsonArray: "jsonArray";
     }>;
     method: z.ZodEnum<{
-      contains: "contains";
-      equals: "equals";
       starts_with: "starts_with";
       ends_with: "ends_with";
+      contains: "contains";
+      equals: "equals";
       greater_than: "greater_than";
       less_than: "less_than";
       on: "on";

package/dist/src/modules/workflow/workflow.schema.d.cts

@@ -11,10 +11,10 @@ declare const workflowSelectSchema: z.ZodObject<{
   input: z.ZodUnknown;
   output: z.ZodUnknown;
   status: z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   retries: z.ZodNumber;
@@ -28,10 +28,10 @@ declare const workflowReadInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const workflowListInputSchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>>>;
   jobName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -51,10 +51,10 @@ declare const workflowReadOutputSchema: z.ZodObject<{
   input: z.ZodUnknown;
   output: z.ZodUnknown;
   status: z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   retries: z.ZodNumber;
@@ -73,10 +73,10 @@ declare const workflowListOutputSchema: z.ZodArray<z.ZodObject<{
   input: z.ZodUnknown;
   output: z.ZodUnknown;
   status: z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   retries: z.ZodNumber;

package/dist/src/modules/workflow/workflow.schema.d.mts

@@ -11,10 +11,10 @@ declare const workflowSelectSchema: z.ZodObject<{
   input: z.ZodUnknown;
   output: z.ZodUnknown;
   status: z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   retries: z.ZodNumber;
@@ -28,10 +28,10 @@ declare const workflowReadInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const workflowListInputSchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>>>;
   jobName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -51,10 +51,10 @@ declare const workflowReadOutputSchema: z.ZodObject<{
   input: z.ZodUnknown;
   output: z.ZodUnknown;
   status: z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   retries: z.ZodNumber;
@@ -73,10 +73,10 @@ declare const workflowListOutputSchema: z.ZodArray<z.ZodObject<{
   input: z.ZodUnknown;
   output: z.ZodUnknown;
   status: z.ZodEnum<{
-    failed: "failed";
     queued: "queued";
     running: "running";
     completed: "completed";
+    failed: "failed";
   }>;
   error: z.ZodNullable<z.ZodString>;
   retries: z.ZodNumber;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m5kdev/commons",
-  "version": "0.21.9",
+  "version": "0.23.0",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -18,7 +18,7 @@
   "devDependencies": {
     "tsdown": "0.21.7",
     "typescript": "6.0.3",
-    "@m5kdev/config": "0.21.9"
+    "@m5kdev/config": "0.23.0"
   },
   "exports": {
     "./utils/*": {