@open-mercato/shared 0.6.6-develop.6526.1.6df9b3dd84 → 0.6.6-develop.6530.1.6d8442bafd

package/dist/lib/location/countries.js

@@ -11,9 +11,14 @@ const RAW_COUNTRIES = registry.filter(isIsoAlpha2).map((entry) => ({
   code: entry.Subtag,
   name: entry.Description.join(", ")
 }));
-const ISO_COUNTRIES = [...RAW_COUNTRIES].sort(
-  (a, b) => a.name.localeCompare(b.name, "en", { sensitivity: "base" })
-);
+const SUPPLEMENTAL_COUNTRIES = [
+  { code: "XK", name: "Kosovo" }
+];
+const RAW_COUNTRY_CODES = new Set(RAW_COUNTRIES.map((entry) => entry.code));
+const ISO_COUNTRIES = [
+  ...RAW_COUNTRIES,
+  ...SUPPLEMENTAL_COUNTRIES.filter((entry) => !RAW_COUNTRY_CODES.has(entry.code))
+].sort((a, b) => a.name.localeCompare(b.name, "en", { sensitivity: "base" }));
 const COUNTRY_PRIORITY = ["PL", "DE", "ES", "FR", "IT", "US", "GB", "CA"];
 const displayNameCache = /* @__PURE__ */ new Map();
 function getDisplayNames(locale) {
@@ -37,7 +42,8 @@ function resolveCountryName(code, options = {}) {
   if (!displayNames) return fallback;
   try {
     const label = displayNames.of(normalized);
-    return typeof label === "string" ? label : fallback;
+    if (typeof label !== "string" || label === normalized) return fallback;
+    return label;
   } catch {
     return fallback;
   }

package/dist/lib/location/countries.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/location/countries.ts"],
-  "sourcesContent": ["import registry from 'language-subtag-registry/data/json/registry.json'\n\ntype RegistryEntry = {\n  Type: string\n  Subtag?: string\n  Description?: string[]\n  Deprecated?: string\n}\n\nexport type IsoCountry = {\n  code: string\n  name: string\n}\n\nfunction isIsoAlpha2(entry: RegistryEntry): entry is RegistryEntry & { Subtag: string; Description: string[] } {\n  if (entry.Type !== 'region') return false\n  if (!entry.Subtag || !/^[A-Z]{2}$/.test(entry.Subtag)) return false\n  if (entry.Deprecated) return false\n  if (!entry.Description || !entry.Description.length) return false\n  if (entry.Description[0] === 'Private use') return false\n  return true\n}\n\nconst RAW_COUNTRIES: IsoCountry[] = (registry as RegistryEntry[])\n  .filter(isIsoAlpha2)\n  .map((entry) => ({\n    code: entry.Subtag,\n    name: entry.Description.join(', '),\n  }))\n\nexport const ISO_COUNTRIES: IsoCountry[] = [...RAW_COUNTRIES].sort((a, b) =>\n  a.name.localeCompare(b.name, 'en', { sensitivity: 'base' })\n)\n\nexport const COUNTRY_PRIORITY: string[] = ['PL', 'DE', 'ES', 'FR', 'IT', 'US', 'GB', 'CA']\n\nconst displayNameCache = new Map<string, Intl.DisplayNames>()\n\nfunction getDisplayNames(locale: string): Intl.DisplayNames | null {\n  if (typeof Intl === 'undefined' || typeof Intl.DisplayNames === 'undefined') return null\n  const key = locale || 'en'\n  let instance = displayNameCache.get(key)\n  if (!instance) {\n    try {\n      instance = new Intl.DisplayNames([key], { type: 'region' })\n      displayNameCache.set(key, instance)\n    } catch {\n      return null\n    }\n  }\n  return instance\n}\n\nexport function resolveCountryName(code: string, options: { locale?: string } = {}): string {\n  const normalized = code.toUpperCase()\n  const fallback = ISO_COUNTRIES.find((entry) => entry.code === normalized)?.name ?? normalized\n  const displayNames = getDisplayNames(options.locale ?? 'en')\n  if (!displayNames) return fallback\n  try {\n    const label = displayNames.of(normalized as any)\n    return typeof label === 'string' ? label : fallback\n  } catch {\n    return fallback\n  }\n}\n\nexport function buildCountryOptions(options: {\n  locale?: string\n  priority?: string[]\n  transformLabel?: (code: string, defaultLabel: string) => string\n} = {}): Array<{ code: string; label: string }> {\n  const { locale, transformLabel } = options\n  const priority = (options.priority ?? COUNTRY_PRIORITY).map((code) => code.toUpperCase())\n  const prioritySet = new Set(priority)\n  const labelFor = (code: string) => {\n    const base = resolveCountryName(code, { locale })\n    return transformLabel ? transformLabel(code, base) : base\n  }\n\n  const byCode = new Map(ISO_COUNTRIES.map((entry) => [entry.code, entry]))\n\n  const prioritized = priority\n    .map((code) => {\n      const base = byCode.get(code)\n      if (!base) return null\n      return { code, label: labelFor(code) }\n    })\n    .filter((entry): entry is { code: string; label: string } => !!entry)\n    .sort((a, b) => a.label.localeCompare(b.label, locale ?? 'en', { sensitivity: 'base' }))\n\n  const remaining = ISO_COUNTRIES\n    .filter((entry) => !prioritySet.has(entry.code))\n    .map((entry) => ({ code: entry.code, label: labelFor(entry.code) }))\n    .sort((a, b) => a.label.localeCompare(b.label, locale ?? 'en', { sensitivity: 'base' }))\n\n  return [...prioritized, ...remaining]\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import registry from 'language-subtag-registry/data/json/registry.json'\n\ntype RegistryEntry = {\n  Type: string\n  Subtag?: string\n  Description?: string[]\n  Deprecated?: string\n}\n\nexport type IsoCountry = {\n  code: string\n  name: string\n}\n\nfunction isIsoAlpha2(entry: RegistryEntry): entry is RegistryEntry & { Subtag: string; Description: string[] } {\n  if (entry.Type !== 'region') return false\n  if (!entry.Subtag || !/^[A-Z]{2}$/.test(entry.Subtag)) return false\n  if (entry.Deprecated) return false\n  if (!entry.Description || !entry.Description.length) return false\n  if (entry.Description[0] === 'Private use') return false\n  return true\n}\n\nconst RAW_COUNTRIES: IsoCountry[] = (registry as RegistryEntry[])\n  .filter(isIsoAlpha2)\n  .map((entry) => ({\n    code: entry.Subtag,\n    name: entry.Description.join(', '),\n  }))\n\n// Codes in common use that the language-subtag registry does not list as region subtags.\n// XK is user-assigned rather than ISO 3166-1 assigned, so it never appears in the registry.\nconst SUPPLEMENTAL_COUNTRIES: IsoCountry[] = [\n  { code: 'XK', name: 'Kosovo' },\n]\n\nconst RAW_COUNTRY_CODES = new Set(RAW_COUNTRIES.map((entry) => entry.code))\n\nexport const ISO_COUNTRIES: IsoCountry[] = [\n  ...RAW_COUNTRIES,\n  ...SUPPLEMENTAL_COUNTRIES.filter((entry) => !RAW_COUNTRY_CODES.has(entry.code)),\n].sort((a, b) => a.name.localeCompare(b.name, 'en', { sensitivity: 'base' }))\n\nexport const COUNTRY_PRIORITY: string[] = ['PL', 'DE', 'ES', 'FR', 'IT', 'US', 'GB', 'CA']\n\nconst displayNameCache = new Map<string, Intl.DisplayNames>()\n\nfunction getDisplayNames(locale: string): Intl.DisplayNames | null {\n  if (typeof Intl === 'undefined' || typeof Intl.DisplayNames === 'undefined') return null\n  const key = locale || 'en'\n  let instance = displayNameCache.get(key)\n  if (!instance) {\n    try {\n      instance = new Intl.DisplayNames([key], { type: 'region' })\n      displayNameCache.set(key, instance)\n    } catch {\n      return null\n    }\n  }\n  return instance\n}\n\nexport function resolveCountryName(code: string, options: { locale?: string } = {}): string {\n  const normalized = code.toUpperCase()\n  const fallback = ISO_COUNTRIES.find((entry) => entry.code === normalized)?.name ?? normalized\n  const displayNames = getDisplayNames(options.locale ?? 'en')\n  if (!displayNames) return fallback\n  try {\n    const label = displayNames.of(normalized as any)\n    // Intl echoes the raw code back when its ICU data cannot resolve the region.\n    if (typeof label !== 'string' || label === normalized) return fallback\n    return label\n  } catch {\n    return fallback\n  }\n}\n\nexport function buildCountryOptions(options: {\n  locale?: string\n  priority?: string[]\n  transformLabel?: (code: string, defaultLabel: string) => string\n} = {}): Array<{ code: string; label: string }> {\n  const { locale, transformLabel } = options\n  const priority = (options.priority ?? COUNTRY_PRIORITY).map((code) => code.toUpperCase())\n  const prioritySet = new Set(priority)\n  const labelFor = (code: string) => {\n    const base = resolveCountryName(code, { locale })\n    return transformLabel ? transformLabel(code, base) : base\n  }\n\n  const byCode = new Map(ISO_COUNTRIES.map((entry) => [entry.code, entry]))\n\n  const prioritized = priority\n    .map((code) => {\n      const base = byCode.get(code)\n      if (!base) return null\n      return { code, label: labelFor(code) }\n    })\n    .filter((entry): entry is { code: string; label: string } => !!entry)\n    .sort((a, b) => a.label.localeCompare(b.label, locale ?? 'en', { sensitivity: 'base' }))\n\n  const remaining = ISO_COUNTRIES\n    .filter((entry) => !prioritySet.has(entry.code))\n    .map((entry) => ({ code: entry.code, label: labelFor(entry.code) }))\n    .sort((a, b) => a.label.localeCompare(b.label, locale ?? 'en', { sensitivity: 'base' }))\n\n  return [...prioritized, ...remaining]\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.6.6-develop.6526.1.6df9b3dd84";
+const APP_VERSION = "0.6.6-develop.6530.1.6d8442bafd";
 const appVersion = APP_VERSION;
 export {
   APP_VERSION,

package/dist/lib/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/version.ts"],
-  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.6-develop.6526.1.6df9b3dd84'\nexport const appVersion = APP_VERSION\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.6-develop.6530.1.6d8442bafd'\nexport const appVersion = APP_VERSION\n"],
   "mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.6.6-develop.6526.1.6df9b3dd84",
+  "version": "0.6.6-develop.6530.1.6d8442bafd",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -97,7 +97,7 @@
     "@mikro-orm/core": "^7.1.5",
     "@mikro-orm/decorators": "^7.1.5",
     "@mikro-orm/postgresql": "^7.1.5",
-    "@open-mercato/cache": "0.6.6-develop.6526.1.6df9b3dd84",
+    "@open-mercato/cache": "0.6.6-develop.6530.1.6d8442bafd",
     "@types/sanitize-html": "^2.16.1",
     "dotenv": "^17.4.2",
     "pino": "^10.3.1",

package/src/lib/location/__tests__/countries.test.ts

@@ -0,0 +1,82 @@
+import {
+  COUNTRY_PRIORITY,
+  ISO_COUNTRIES,
+  buildCountryOptions,
+  resolveCountryName,
+} from '../countries'
+
+describe('ISO_COUNTRIES', () => {
+  it('includes Kosovo, which the language-subtag registry does not list', () => {
+    const kosovo = ISO_COUNTRIES.filter((entry) => entry.code === 'XK')
+    expect(kosovo).toEqual([{ code: 'XK', name: 'Kosovo' }])
+  })
+
+  it('does not duplicate any country code', () => {
+    const codes = ISO_COUNTRIES.map((entry) => entry.code)
+    expect(codes).toHaveLength(new Set(codes).size)
+  })
+
+  it('keeps registry-derived countries intact', () => {
+    expect(ISO_COUNTRIES).toEqual(
+      expect.arrayContaining([
+        { code: 'PL', name: 'Poland' },
+        { code: 'DE', name: 'Germany' },
+      ])
+    )
+  })
+
+  it('stays sorted by name', () => {
+    const names = ISO_COUNTRIES.map((entry) => entry.name)
+    const sorted = [...names].sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' }))
+    expect(names).toEqual(sorted)
+  })
+})
+
+describe('resolveCountryName', () => {
+  it('resolves Kosovo for XK', () => {
+    expect(resolveCountryName('XK')).toBe('Kosovo')
+  })
+
+  it('resolves Kosovo for a lowercase xk', () => {
+    expect(resolveCountryName('xk')).toBe('Kosovo')
+  })
+
+  it('still resolves registry-backed countries', () => {
+    expect(resolveCountryName('PL')).toBe('Poland')
+  })
+
+  it('falls back to the raw code for an unknown region', () => {
+    expect(resolveCountryName('ZZZ')).toBe('ZZZ')
+  })
+})
+
+describe('buildCountryOptions', () => {
+  it('offers Kosovo as a selectable option', () => {
+    const options = buildCountryOptions()
+    expect(options).toEqual(expect.arrayContaining([{ code: 'XK', label: 'Kosovo' }]))
+  })
+
+  it('offers exactly one Kosovo option', () => {
+    const options = buildCountryOptions().filter((option) => option.code === 'XK')
+    expect(options).toHaveLength(1)
+  })
+
+  it('lists Kosovo after the prioritized countries', () => {
+    const options = buildCountryOptions()
+    const kosovoIndex = options.findIndex((option) => option.code === 'XK')
+    expect(kosovoIndex).toBeGreaterThanOrEqual(COUNTRY_PRIORITY.length)
+  })
+
+  it('keeps the prioritized countries at the top', () => {
+    const options = buildCountryOptions()
+    const leading = options.slice(0, COUNTRY_PRIORITY.length).map((option) => option.code)
+    expect(leading.slice().sort()).toEqual(COUNTRY_PRIORITY.slice().sort())
+  })
+
+  it('applies transformLabel to the supplemental country too', () => {
+    const options = buildCountryOptions({
+      transformLabel: (code, defaultLabel) => `${defaultLabel} (${code})`,
+    })
+    expect(options).toEqual(expect.arrayContaining([{ code: 'XK', label: 'Kosovo (XK)' }]))
+  })
+})

package/src/lib/location/countries.ts

@@ -28,9 +28,18 @@ const RAW_COUNTRIES: IsoCountry[] = (registry as RegistryEntry[])
     name: entry.Description.join(', '),
   }))
 
-export const ISO_COUNTRIES: IsoCountry[] = [...RAW_COUNTRIES].sort((a, b) =>
-  a.name.localeCompare(b.name, 'en', { sensitivity: 'base' })
-)
+// Codes in common use that the language-subtag registry does not list as region subtags.
+// XK is user-assigned rather than ISO 3166-1 assigned, so it never appears in the registry.
+const SUPPLEMENTAL_COUNTRIES: IsoCountry[] = [
+  { code: 'XK', name: 'Kosovo' },
+]
+
+const RAW_COUNTRY_CODES = new Set(RAW_COUNTRIES.map((entry) => entry.code))
+
+export const ISO_COUNTRIES: IsoCountry[] = [
+  ...RAW_COUNTRIES,
+  ...SUPPLEMENTAL_COUNTRIES.filter((entry) => !RAW_COUNTRY_CODES.has(entry.code)),
+].sort((a, b) => a.name.localeCompare(b.name, 'en', { sensitivity: 'base' }))
 
 export const COUNTRY_PRIORITY: string[] = ['PL', 'DE', 'ES', 'FR', 'IT', 'US', 'GB', 'CA']
 
@@ -58,7 +67,9 @@ export function resolveCountryName(code: string, options: { locale?: string } =
   if (!displayNames) return fallback
   try {
     const label = displayNames.of(normalized as any)
-    return typeof label === 'string' ? label : fallback
+    // Intl echoes the raw code back when its ICU data cannot resolve the region.
+    if (typeof label !== 'string' || label === normalized) return fallback
+    return label
   } catch {
     return fallback
   }