@open-mercato/core 0.6.3-develop.3881.1.0b590ac4eb → 0.6.3-develop.3901.1.ddad60693a

package/dist/modules/sync_excel/widgets/injection/upload-config/target-options.js

@@ -172,6 +172,38 @@ const ADDRESS_TARGET_OPTIONS = [
 function normalizeMatchToken(value) {
   return value.trim().replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase().replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
 }
+const TRAILING_IMPORT_QUALIFIERS = /* @__PURE__ */ new Set(["external", "imported", "crm"]);
+function addNormalizedMatchToken(tokens, value) {
+  const normalized = normalizeMatchToken(value);
+  if (normalized.length > 0) {
+    tokens.add(normalized);
+  }
+}
+function stripParentheticalText(value) {
+  return value.replace(/\s*\([^)]*\)\s*/g, " ");
+}
+function stripTrailingImportQualifier(value) {
+  const parts = normalizeMatchToken(value).split(" ").filter((part) => part.length > 0);
+  while (parts.length > 1 && TRAILING_IMPORT_QUALIFIERS.has(parts[parts.length - 1])) {
+    parts.pop();
+  }
+  return parts.join(" ");
+}
+function buildCustomFieldMatchTokens(def, fallback) {
+  const tokens = /* @__PURE__ */ new Set();
+  const candidates = [
+    def.key,
+    fallback,
+    stripParentheticalText(fallback),
+    stripTrailingImportQualifier(def.key),
+    stripTrailingImportQualifier(fallback),
+    stripTrailingImportQualifier(stripParentheticalText(fallback))
+  ];
+  for (const candidate of candidates) {
+    addNormalizedMatchToken(tokens, candidate);
+  }
+  return Array.from(tokens);
+}
 function titleizeKey(key) {
   return key.split("_").map((part) => part.length > 0 ? part[0].toUpperCase() + part.slice(1) : part).join(" ");
 }
@@ -207,15 +239,11 @@ function scoreCustomFieldDefinition(def, entityIndex) {
 }
 function buildCustomFieldOption(def) {
   const fallback = typeof def.label === "string" && def.label.trim().length > 0 ? def.label.trim() : titleizeKey(def.key);
-  const normalizedTokens = Array.from(new Set([
-    normalizeMatchToken(def.key),
-    normalizeMatchToken(fallback)
-  ].filter((value) => value.length > 0)));
   return {
     value: `cf:${def.key}`,
     fallback,
     mappingKind: "custom_field",
-    matchTokens: normalizedTokens
+    matchTokens: buildCustomFieldMatchTokens(def, fallback)
   };
 }
 function selectPreferredCustomFieldDefs(customFieldDefs) {

package/dist/modules/sync_excel/widgets/injection/upload-config/target-options.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/modules/sync_excel/widgets/injection/upload-config/target-options.ts"],
-  "sourcesContent": ["import type { CustomFieldDefDto } from '@open-mercato/ui/backend/utils/customFieldDefs'\nimport type { FieldMapping, FieldMappingDedupeRole, FieldMappingKind } from '../../../../data_sync/lib/adapter'\n\nexport const SYNC_EXCEL_PEOPLE_CUSTOM_FIELD_ENTITY_IDS = [\n  'customers:customer_entity',\n  'customers:customer_person_profile',\n] as const\n\nexport type SuggestedMapping = {\n  entityType: 'customers.person'\n  matchStrategy: 'externalId' | 'email' | 'custom'\n  matchField?: string\n  fields: FieldMapping[]\n  unmappedColumns: string[]\n}\n\nexport type MappingTargetOption = {\n  value: string\n  labelKey?: string\n  fallback: string\n  mappingKind: FieldMappingKind\n  dedupeRole?: FieldMappingDedupeRole\n  matchTokens: string[]\n}\n\nconst CORE_TARGET_OPTIONS: MappingTargetOption[] = [\n  {\n    value: 'person.externalId',\n    labelKey: 'sync_excel.mapping.targets.externalId',\n    fallback: 'External ID',\n    mappingKind: 'external_id',\n    dedupeRole: 'primary',\n    matchTokens: ['external id', 'record id', 'lead id'],\n  },\n  {\n    value: 'person.firstName',\n    labelKey: 'sync_excel.mapping.targets.firstName',\n    fallback: 'First name',\n    mappingKind: 'core',\n    matchTokens: ['first name', 'firstname', 'given name'],\n  },\n  {\n    value: 'person.lastName',\n    labelKey: 'sync_excel.mapping.targets.lastName',\n    fallback: 'Last name',\n    mappingKind: 'core',\n    matchTokens: ['last name', 'lastname', 'surname', 'family name'],\n  },\n  {\n    value: 'person.displayName',\n    labelKey: 'sync_excel.mapping.targets.displayName',\n    fallback: 'Display name',\n    mappingKind: 'core',\n    matchTokens: ['display name', 'lead name', 'full name', 'name'],\n  },\n  {\n    value: 'person.primaryEmail',\n    labelKey: 'sync_excel.mapping.targets.primaryEmail',\n    fallback: 'Primary email',\n    mappingKind: 'core',\n    dedupeRole: 'secondary',\n    matchTokens: ['email', 'primary email', 'email address'],\n  },\n  {\n    value: 'person.primaryPhone',\n    labelKey: 'sync_excel.mapping.targets.primaryPhone',\n    fallback: 'Primary phone',\n    mappingKind: 'core',\n    matchTokens: ['phone', 'primary phone', 'mobile', 'mobile phone', 'telephone'],\n  },\n  {\n    value: 'person.jobTitle',\n    labelKey: 'sync_excel.mapping.targets.jobTitle',\n    fallback: 'Job title',\n    mappingKind: 'core',\n    matchTokens: ['job title', 'title', 'position'],\n  },\n  {\n    value: 'person.status',\n    labelKey: 'sync_excel.mapping.targets.status',\n    fallback: 'Status',\n    mappingKind: 'core',\n    matchTokens: ['status', 'lead status'],\n  },\n  {\n    value: 'person.source',\n    labelKey: 'sync_excel.mapping.targets.source',\n    fallback: 'Source',\n    mappingKind: 'core',\n    matchTokens: ['source', 'lead source'],\n  },\n  {\n    value: 'person.description',\n    labelKey: 'sync_excel.mapping.targets.description',\n    fallback: 'Description',\n    mappingKind: 'core',\n    matchTokens: ['description', 'notes', 'comment'],\n  },\n]\n\nconst ADDRESS_TARGET_OPTIONS: MappingTargetOption[] = [\n  {\n    value: 'address.name',\n    labelKey: 'sync_excel.mapping.targets.addressName',\n    fallback: 'Address label',\n    mappingKind: 'core',\n    matchTokens: ['address label', 'address name', 'label'],\n  },\n  {\n    value: 'address.purpose',\n    labelKey: 'sync_excel.mapping.targets.addressPurpose',\n    fallback: 'Address purpose',\n    mappingKind: 'core',\n    matchTokens: ['address purpose', 'address type'],\n  },\n  {\n    value: 'address.companyName',\n    labelKey: 'sync_excel.mapping.targets.addressCompanyName',\n    fallback: 'Address company',\n    mappingKind: 'core',\n    matchTokens: ['address company', 'address company name'],\n  },\n  {\n    value: 'address.addressLine1',\n    labelKey: 'sync_excel.mapping.targets.addressLine1',\n    fallback: 'Address line 1',\n    mappingKind: 'core',\n    matchTokens: ['address line 1', 'street address', 'street', 'street 1'],\n  },\n  {\n    value: 'address.addressLine2',\n    labelKey: 'sync_excel.mapping.targets.addressLine2',\n    fallback: 'Address line 2',\n    mappingKind: 'core',\n    matchTokens: ['address line 2', 'street 2'],\n  },\n  {\n    value: 'address.buildingNumber',\n    labelKey: 'sync_excel.mapping.targets.buildingNumber',\n    fallback: 'Building number',\n    mappingKind: 'core',\n    matchTokens: ['building number', 'building no', 'house number'],\n  },\n  {\n    value: 'address.flatNumber',\n    labelKey: 'sync_excel.mapping.targets.flatNumber',\n    fallback: 'Flat number',\n    mappingKind: 'core',\n    matchTokens: ['flat number', 'apartment number', 'unit number'],\n  },\n  {\n    value: 'address.city',\n    labelKey: 'sync_excel.mapping.targets.city',\n    fallback: 'City',\n    mappingKind: 'core',\n    matchTokens: ['city', 'town'],\n  },\n  {\n    value: 'address.region',\n    labelKey: 'sync_excel.mapping.targets.region',\n    fallback: 'Region / State',\n    mappingKind: 'core',\n    matchTokens: ['region', 'state', 'province'],\n  },\n  {\n    value: 'address.postalCode',\n    labelKey: 'sync_excel.mapping.targets.postalCode',\n    fallback: 'Postal code',\n    mappingKind: 'core',\n    matchTokens: ['postal code', 'zip code', 'postcode'],\n  },\n  {\n    value: 'address.country',\n    labelKey: 'sync_excel.mapping.targets.country',\n    fallback: 'Country',\n    mappingKind: 'core',\n    matchTokens: ['country'],\n  },\n  {\n    value: 'address.latitude',\n    labelKey: 'sync_excel.mapping.targets.latitude',\n    fallback: 'Latitude',\n    mappingKind: 'core',\n    matchTokens: ['latitude', 'lat'],\n  },\n  {\n    value: 'address.longitude',\n    labelKey: 'sync_excel.mapping.targets.longitude',\n    fallback: 'Longitude',\n    mappingKind: 'core',\n    matchTokens: ['longitude', 'lng', 'lon'],\n  },\n]\n\nfunction normalizeMatchToken(value: string): string {\n  return value\n    .trim()\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .toLowerCase()\n    .replace(/[_-]+/g, ' ')\n    .replace(/\\s+/g, ' ')\n    .trim()\n}\n\nfunction titleizeKey(key: string): string {\n  return key\n    .split('_')\n    .map((part) => (part.length > 0 ? part[0].toUpperCase() + part.slice(1) : part))\n    .join(' ')\n}\n\nfunction scoreCustomFieldDefinition(def: CustomFieldDefDto, entityIndex: number): {\n  base: number\n  penalty: number\n  entityIndex: number\n} {\n  const listVisibleScore = def.listVisible === false ? 0 : 1\n  const formEditableScore = def.formEditable === false ? 0 : 1\n  const filterableScore = def.filterable ? 1 : 0\n  const kindScore = (() => {\n    switch (def.kind) {\n      case 'dictionary':\n        return 8\n      case 'relation':\n        return 6\n      case 'select':\n        return 4\n      case 'multiline':\n        return 3\n      case 'boolean':\n      case 'integer':\n      case 'float':\n        return 2\n      default:\n        return 1\n    }\n  })()\n  const optionsBonus = Array.isArray(def.options) && def.options.length > 0 ? 2 : 0\n  const dictionaryBonus = typeof def.dictionaryId === 'string' && def.dictionaryId.trim().length > 0 ? 5 : 0\n  return {\n    base: (listVisibleScore * 16) + (formEditableScore * 8) + (filterableScore * 4) + kindScore + optionsBonus + dictionaryBonus,\n    penalty: typeof def.priority === 'number' ? def.priority : 0,\n    entityIndex,\n  }\n}\n\nfunction buildCustomFieldOption(def: CustomFieldDefDto): MappingTargetOption {\n  const fallback = typeof def.label === 'string' && def.label.trim().length > 0\n    ? def.label.trim()\n    : titleizeKey(def.key)\n  const normalizedTokens = Array.from(new Set([\n    normalizeMatchToken(def.key),\n    normalizeMatchToken(fallback),\n  ].filter((value) => value.length > 0)))\n\n  return {\n    value: `cf:${def.key}`,\n    fallback,\n    mappingKind: 'custom_field',\n    matchTokens: normalizedTokens,\n  }\n}\n\nfunction selectPreferredCustomFieldDefs(customFieldDefs: CustomFieldDefDto[]): CustomFieldDefDto[] {\n  const entityOrder = new Map<string, number>()\n  SYNC_EXCEL_PEOPLE_CUSTOM_FIELD_ENTITY_IDS.forEach((entityId, index) => entityOrder.set(entityId, index))\n  const bestByKey = new Map<string, { def: CustomFieldDefDto; score: { base: number; penalty: number; entityIndex: number } }>()\n\n  for (const def of customFieldDefs) {\n    if (typeof def.key !== 'string' || def.key.trim().length === 0) continue\n    const score = scoreCustomFieldDefinition(def, entityOrder.get(def.entityId ?? '') ?? Number.MAX_SAFE_INTEGER)\n    const existing = bestByKey.get(def.key)\n    const isBetter = !existing\n      || score.base > existing.score.base\n      || (\n        score.base === existing.score.base\n        && (score.penalty < existing.score.penalty\n          || (score.penalty === existing.score.penalty && score.entityIndex < existing.score.entityIndex))\n      )\n    if (isBetter) {\n      bestByKey.set(def.key, { def, score })\n    }\n  }\n\n  return Array.from(bestByKey.values()).map((entry) => entry.def)\n}\n\nexport function buildPeopleTargetOptions(customFieldDefs: CustomFieldDefDto[]): MappingTargetOption[] {\n  const customOptions = selectPreferredCustomFieldDefs(customFieldDefs).map(buildCustomFieldOption)\n  return [...CORE_TARGET_OPTIONS, ...ADDRESS_TARGET_OPTIONS, ...customOptions]\n}\n\nexport function buildPeopleSuggestedMapping(\n  headers: string[],\n  suggestedMapping: SuggestedMapping,\n  customFieldDefs: CustomFieldDefDto[],\n): SuggestedMapping {\n  const fields = [...suggestedMapping.fields]\n  const usedExternalFields = new Set(fields.map((field) => field.externalField))\n  const usedTargetFields = new Set(fields.map((field) => field.localField))\n  const supplementalTargetOptions = buildPeopleTargetOptions(customFieldDefs).filter(\n    (option) => option.mappingKind === 'custom_field' || option.value.startsWith('address.'),\n  )\n\n  for (const header of headers) {\n    if (usedExternalFields.has(header)) continue\n    const normalizedHeader = normalizeMatchToken(header)\n    const matchedOption = supplementalTargetOptions.find((option) => {\n      if (usedTargetFields.has(option.value)) return false\n      return option.matchTokens.includes(normalizedHeader)\n    })\n    if (!matchedOption) continue\n\n    fields.push({\n      externalField: header,\n      localField: matchedOption.value,\n      mappingKind: matchedOption.mappingKind,\n    })\n    usedExternalFields.add(header)\n    usedTargetFields.add(matchedOption.value)\n  }\n\n  return {\n    ...suggestedMapping,\n    fields,\n    unmappedColumns: headers.filter((header) => !usedExternalFields.has(header)),\n  }\n}\n\nexport function buildSuggestedMappingSignature(headers: string[], suggestedMapping: SuggestedMapping): string {\n  return JSON.stringify({\n    headers,\n    matchStrategy: suggestedMapping.matchStrategy,\n    matchField: suggestedMapping.matchField ?? null,\n    fields: suggestedMapping.fields.map((field) => ({\n      externalField: field.externalField,\n      localField: field.localField,\n      mappingKind: field.mappingKind ?? null,\n      dedupeRole: field.dedupeRole ?? null,\n    })),\n  })\n}\n\nexport function findMappingTargetOption(\n  targetOptions: MappingTargetOption[],\n  targetField: string,\n): MappingTargetOption | undefined {\n  return targetOptions.find((option) => option.value === targetField)\n}\n\nexport { normalizeMatchToken }\n"],
-  "mappings": "AAGO,MAAM,4CAA4C;AAAA,EACvD;AAAA,EACA;AACF;AAmBA,MAAM,sBAA6C;AAAA,EACjD;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa,CAAC,eAAe,aAAa,SAAS;AAAA,EACrD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,cAAc,aAAa,YAAY;AAAA,EACvD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,aAAa,YAAY,WAAW,aAAa;AAAA,EACjE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,gBAAgB,aAAa,aAAa,MAAM;AAAA,EAChE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa,CAAC,SAAS,iBAAiB,eAAe;AAAA,EACzD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,SAAS,iBAAiB,UAAU,gBAAgB,WAAW;AAAA,EAC/E;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,aAAa,SAAS,UAAU;AAAA,EAChD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,UAAU,aAAa;AAAA,EACvC;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,UAAU,aAAa;AAAA,EACvC;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,eAAe,SAAS,SAAS;AAAA,EACjD;AACF;AAEA,MAAM,yBAAgD;AAAA,EACpD;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,iBAAiB,gBAAgB,OAAO;AAAA,EACxD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,mBAAmB,cAAc;AAAA,EACjD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,mBAAmB,sBAAsB;AAAA,EACzD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,kBAAkB,kBAAkB,UAAU,UAAU;AAAA,EACxE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,kBAAkB,UAAU;AAAA,EAC5C;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,mBAAmB,eAAe,cAAc;AAAA,EAChE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,eAAe,oBAAoB,aAAa;AAAA,EAChE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,QAAQ,MAAM;AAAA,EAC9B;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,UAAU,SAAS,UAAU;AAAA,EAC7C;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,eAAe,YAAY,UAAU;AAAA,EACrD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,SAAS;AAAA,EACzB;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,YAAY,KAAK;AAAA,EACjC;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,aAAa,OAAO,KAAK;AAAA,EACzC;AACF;AAEA,SAAS,oBAAoB,OAAuB;AAClD,SAAO,MACJ,KAAK,EACL,QAAQ,sBAAsB,OAAO,EACrC,YAAY,EACZ,QAAQ,UAAU,GAAG,EACrB,QAAQ,QAAQ,GAAG,EACnB,KAAK;AACV;AAEA,SAAS,YAAY,KAAqB;AACxC,SAAO,IACJ,MAAM,GAAG,EACT,IAAI,CAAC,SAAU,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,IAAI,IAAK,EAC9E,KAAK,GAAG;AACb;AAEA,SAAS,2BAA2B,KAAwB,aAI1D;AACA,QAAM,mBAAmB,IAAI,gBAAgB,QAAQ,IAAI;AACzD,QAAM,oBAAoB,IAAI,iBAAiB,QAAQ,IAAI;AAC3D,QAAM,kBAAkB,IAAI,aAAa,IAAI;AAC7C,QAAM,aAAa,MAAM;AACvB,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AAAA,MACT;AACE,eAAO;AAAA,IACX;AAAA,EACF,GAAG;AACH,QAAM,eAAe,MAAM,QAAQ,IAAI,OAAO,KAAK,IAAI,QAAQ,SAAS,IAAI,IAAI;AAChF,QAAM,kBAAkB,OAAO,IAAI,iBAAiB,YAAY,IAAI,aAAa,KAAK,EAAE,SAAS,IAAI,IAAI;AACzG,SAAO;AAAA,IACL,MAAO,mBAAmB,KAAO,oBAAoB,IAAM,kBAAkB,IAAK,YAAY,eAAe;AAAA,IAC7G,SAAS,OAAO,IAAI,aAAa,WAAW,IAAI,WAAW;AAAA,IAC3D;AAAA,EACF;AACF;AAEA,SAAS,uBAAuB,KAA6C;AAC3E,QAAM,WAAW,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,KAAK,EAAE,SAAS,IACxE,IAAI,MAAM,KAAK,IACf,YAAY,IAAI,GAAG;AACvB,QAAM,mBAAmB,MAAM,KAAK,IAAI,IAAI;AAAA,IAC1C,oBAAoB,IAAI,GAAG;AAAA,IAC3B,oBAAoB,QAAQ;AAAA,EAC9B,EAAE,OAAO,CAAC,UAAU,MAAM,SAAS,CAAC,CAAC,CAAC;AAEtC,SAAO;AAAA,IACL,OAAO,MAAM,IAAI,GAAG;AAAA,IACpB;AAAA,IACA,aAAa;AAAA,IACb,aAAa;AAAA,EACf;AACF;AAEA,SAAS,+BAA+B,iBAA2D;AACjG,QAAM,cAAc,oBAAI,IAAoB;AAC5C,4CAA0C,QAAQ,CAAC,UAAU,UAAU,YAAY,IAAI,UAAU,KAAK,CAAC;AACvG,QAAM,YAAY,oBAAI,IAAuG;AAE7H,aAAW,OAAO,iBAAiB;AACjC,QAAI,OAAO,IAAI,QAAQ,YAAY,IAAI,IAAI,KAAK,EAAE,WAAW,EAAG;AAChE,UAAM,QAAQ,2BAA2B,KAAK,YAAY,IAAI,IAAI,YAAY,EAAE,KAAK,OAAO,gBAAgB;AAC5G,UAAM,WAAW,UAAU,IAAI,IAAI,GAAG;AACtC,UAAM,WAAW,CAAC,YACb,MAAM,OAAO,SAAS,MAAM,QAE7B,MAAM,SAAS,SAAS,MAAM,SAC1B,MAAM,UAAU,SAAS,MAAM,WAC7B,MAAM,YAAY,SAAS,MAAM,WAAW,MAAM,cAAc,SAAS,MAAM;AAEzF,QAAI,UAAU;AACZ,gBAAU,IAAI,IAAI,KAAK,EAAE,KAAK,MAAM,CAAC;AAAA,IACvC;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,UAAU,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,MAAM,GAAG;AAChE;AAEO,SAAS,yBAAyB,iBAA6D;AACpG,QAAM,gBAAgB,+BAA+B,eAAe,EAAE,IAAI,sBAAsB;AAChG,SAAO,CAAC,GAAG,qBAAqB,GAAG,wBAAwB,GAAG,aAAa;AAC7E;AAEO,SAAS,4BACd,SACA,kBACA,iBACkB;AAClB,QAAM,SAAS,CAAC,GAAG,iBAAiB,MAAM;AAC1C,QAAM,qBAAqB,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,MAAM,aAAa,CAAC;AAC7E,QAAM,mBAAmB,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,MAAM,UAAU,CAAC;AACxE,QAAM,4BAA4B,yBAAyB,eAAe,EAAE;AAAA,IAC1E,CAAC,WAAW,OAAO,gBAAgB,kBAAkB,OAAO,MAAM,WAAW,UAAU;AAAA,EACzF;AAEA,aAAW,UAAU,SAAS;AAC5B,QAAI,mBAAmB,IAAI,MAAM,EAAG;AACpC,UAAM,mBAAmB,oBAAoB,MAAM;AACnD,UAAM,gBAAgB,0BAA0B,KAAK,CAAC,WAAW;AAC/D,UAAI,iBAAiB,IAAI,OAAO,KAAK,EAAG,QAAO;AAC/C,aAAO,OAAO,YAAY,SAAS,gBAAgB;AAAA,IACrD,CAAC;AACD,QAAI,CAAC,cAAe;AAEpB,WAAO,KAAK;AAAA,MACV,eAAe;AAAA,MACf,YAAY,cAAc;AAAA,MAC1B,aAAa,cAAc;AAAA,IAC7B,CAAC;AACD,uBAAmB,IAAI,MAAM;AAC7B,qBAAiB,IAAI,cAAc,KAAK;AAAA,EAC1C;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA,iBAAiB,QAAQ,OAAO,CAAC,WAAW,CAAC,mBAAmB,IAAI,MAAM,CAAC;AAAA,EAC7E;AACF;AAEO,SAAS,+BAA+B,SAAmB,kBAA4C;AAC5G,SAAO,KAAK,UAAU;AAAA,IACpB;AAAA,IACA,eAAe,iBAAiB;AAAA,IAChC,YAAY,iBAAiB,cAAc;AAAA,IAC3C,QAAQ,iBAAiB,OAAO,IAAI,CAAC,WAAW;AAAA,MAC9C,eAAe,MAAM;AAAA,MACrB,YAAY,MAAM;AAAA,MAClB,aAAa,MAAM,eAAe;AAAA,MAClC,YAAY,MAAM,cAAc;AAAA,IAClC,EAAE;AAAA,EACJ,CAAC;AACH;AAEO,SAAS,wBACd,eACA,aACiC;AACjC,SAAO,cAAc,KAAK,CAAC,WAAW,OAAO,UAAU,WAAW;AACpE;",
+  "sourcesContent": ["import type { CustomFieldDefDto } from '@open-mercato/ui/backend/utils/customFieldDefs'\nimport type { FieldMapping, FieldMappingDedupeRole, FieldMappingKind } from '../../../../data_sync/lib/adapter'\n\nexport const SYNC_EXCEL_PEOPLE_CUSTOM_FIELD_ENTITY_IDS = [\n  'customers:customer_entity',\n  'customers:customer_person_profile',\n] as const\n\nexport type SuggestedMapping = {\n  entityType: 'customers.person'\n  matchStrategy: 'externalId' | 'email' | 'custom'\n  matchField?: string\n  fields: FieldMapping[]\n  unmappedColumns: string[]\n}\n\nexport type MappingTargetOption = {\n  value: string\n  labelKey?: string\n  fallback: string\n  mappingKind: FieldMappingKind\n  dedupeRole?: FieldMappingDedupeRole\n  matchTokens: string[]\n}\n\nconst CORE_TARGET_OPTIONS: MappingTargetOption[] = [\n  {\n    value: 'person.externalId',\n    labelKey: 'sync_excel.mapping.targets.externalId',\n    fallback: 'External ID',\n    mappingKind: 'external_id',\n    dedupeRole: 'primary',\n    matchTokens: ['external id', 'record id', 'lead id'],\n  },\n  {\n    value: 'person.firstName',\n    labelKey: 'sync_excel.mapping.targets.firstName',\n    fallback: 'First name',\n    mappingKind: 'core',\n    matchTokens: ['first name', 'firstname', 'given name'],\n  },\n  {\n    value: 'person.lastName',\n    labelKey: 'sync_excel.mapping.targets.lastName',\n    fallback: 'Last name',\n    mappingKind: 'core',\n    matchTokens: ['last name', 'lastname', 'surname', 'family name'],\n  },\n  {\n    value: 'person.displayName',\n    labelKey: 'sync_excel.mapping.targets.displayName',\n    fallback: 'Display name',\n    mappingKind: 'core',\n    matchTokens: ['display name', 'lead name', 'full name', 'name'],\n  },\n  {\n    value: 'person.primaryEmail',\n    labelKey: 'sync_excel.mapping.targets.primaryEmail',\n    fallback: 'Primary email',\n    mappingKind: 'core',\n    dedupeRole: 'secondary',\n    matchTokens: ['email', 'primary email', 'email address'],\n  },\n  {\n    value: 'person.primaryPhone',\n    labelKey: 'sync_excel.mapping.targets.primaryPhone',\n    fallback: 'Primary phone',\n    mappingKind: 'core',\n    matchTokens: ['phone', 'primary phone', 'mobile', 'mobile phone', 'telephone'],\n  },\n  {\n    value: 'person.jobTitle',\n    labelKey: 'sync_excel.mapping.targets.jobTitle',\n    fallback: 'Job title',\n    mappingKind: 'core',\n    matchTokens: ['job title', 'title', 'position'],\n  },\n  {\n    value: 'person.status',\n    labelKey: 'sync_excel.mapping.targets.status',\n    fallback: 'Status',\n    mappingKind: 'core',\n    matchTokens: ['status', 'lead status'],\n  },\n  {\n    value: 'person.source',\n    labelKey: 'sync_excel.mapping.targets.source',\n    fallback: 'Source',\n    mappingKind: 'core',\n    matchTokens: ['source', 'lead source'],\n  },\n  {\n    value: 'person.description',\n    labelKey: 'sync_excel.mapping.targets.description',\n    fallback: 'Description',\n    mappingKind: 'core',\n    matchTokens: ['description', 'notes', 'comment'],\n  },\n]\n\nconst ADDRESS_TARGET_OPTIONS: MappingTargetOption[] = [\n  {\n    value: 'address.name',\n    labelKey: 'sync_excel.mapping.targets.addressName',\n    fallback: 'Address label',\n    mappingKind: 'core',\n    matchTokens: ['address label', 'address name', 'label'],\n  },\n  {\n    value: 'address.purpose',\n    labelKey: 'sync_excel.mapping.targets.addressPurpose',\n    fallback: 'Address purpose',\n    mappingKind: 'core',\n    matchTokens: ['address purpose', 'address type'],\n  },\n  {\n    value: 'address.companyName',\n    labelKey: 'sync_excel.mapping.targets.addressCompanyName',\n    fallback: 'Address company',\n    mappingKind: 'core',\n    matchTokens: ['address company', 'address company name'],\n  },\n  {\n    value: 'address.addressLine1',\n    labelKey: 'sync_excel.mapping.targets.addressLine1',\n    fallback: 'Address line 1',\n    mappingKind: 'core',\n    matchTokens: ['address line 1', 'street address', 'street', 'street 1'],\n  },\n  {\n    value: 'address.addressLine2',\n    labelKey: 'sync_excel.mapping.targets.addressLine2',\n    fallback: 'Address line 2',\n    mappingKind: 'core',\n    matchTokens: ['address line 2', 'street 2'],\n  },\n  {\n    value: 'address.buildingNumber',\n    labelKey: 'sync_excel.mapping.targets.buildingNumber',\n    fallback: 'Building number',\n    mappingKind: 'core',\n    matchTokens: ['building number', 'building no', 'house number'],\n  },\n  {\n    value: 'address.flatNumber',\n    labelKey: 'sync_excel.mapping.targets.flatNumber',\n    fallback: 'Flat number',\n    mappingKind: 'core',\n    matchTokens: ['flat number', 'apartment number', 'unit number'],\n  },\n  {\n    value: 'address.city',\n    labelKey: 'sync_excel.mapping.targets.city',\n    fallback: 'City',\n    mappingKind: 'core',\n    matchTokens: ['city', 'town'],\n  },\n  {\n    value: 'address.region',\n    labelKey: 'sync_excel.mapping.targets.region',\n    fallback: 'Region / State',\n    mappingKind: 'core',\n    matchTokens: ['region', 'state', 'province'],\n  },\n  {\n    value: 'address.postalCode',\n    labelKey: 'sync_excel.mapping.targets.postalCode',\n    fallback: 'Postal code',\n    mappingKind: 'core',\n    matchTokens: ['postal code', 'zip code', 'postcode'],\n  },\n  {\n    value: 'address.country',\n    labelKey: 'sync_excel.mapping.targets.country',\n    fallback: 'Country',\n    mappingKind: 'core',\n    matchTokens: ['country'],\n  },\n  {\n    value: 'address.latitude',\n    labelKey: 'sync_excel.mapping.targets.latitude',\n    fallback: 'Latitude',\n    mappingKind: 'core',\n    matchTokens: ['latitude', 'lat'],\n  },\n  {\n    value: 'address.longitude',\n    labelKey: 'sync_excel.mapping.targets.longitude',\n    fallback: 'Longitude',\n    mappingKind: 'core',\n    matchTokens: ['longitude', 'lng', 'lon'],\n  },\n]\n\nfunction normalizeMatchToken(value: string): string {\n  return value\n    .trim()\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .toLowerCase()\n    .replace(/[_-]+/g, ' ')\n    .replace(/\\s+/g, ' ')\n    .trim()\n}\n\nconst TRAILING_IMPORT_QUALIFIERS = new Set(['external', 'imported', 'crm'])\n\nfunction addNormalizedMatchToken(tokens: Set<string>, value: string): void {\n  const normalized = normalizeMatchToken(value)\n  if (normalized.length > 0) {\n    tokens.add(normalized)\n  }\n}\n\nfunction stripParentheticalText(value: string): string {\n  return value.replace(/\\s*\\([^)]*\\)\\s*/g, ' ')\n}\n\nfunction stripTrailingImportQualifier(value: string): string {\n  const parts = normalizeMatchToken(value).split(' ').filter((part) => part.length > 0)\n  while (parts.length > 1 && TRAILING_IMPORT_QUALIFIERS.has(parts[parts.length - 1])) {\n    parts.pop()\n  }\n  return parts.join(' ')\n}\n\nfunction buildCustomFieldMatchTokens(def: CustomFieldDefDto, fallback: string): string[] {\n  const tokens = new Set<string>()\n  const candidates = [\n    def.key,\n    fallback,\n    stripParentheticalText(fallback),\n    stripTrailingImportQualifier(def.key),\n    stripTrailingImportQualifier(fallback),\n    stripTrailingImportQualifier(stripParentheticalText(fallback)),\n  ]\n\n  for (const candidate of candidates) {\n    addNormalizedMatchToken(tokens, candidate)\n  }\n\n  return Array.from(tokens)\n}\n\nfunction titleizeKey(key: string): string {\n  return key\n    .split('_')\n    .map((part) => (part.length > 0 ? part[0].toUpperCase() + part.slice(1) : part))\n    .join(' ')\n}\n\nfunction scoreCustomFieldDefinition(def: CustomFieldDefDto, entityIndex: number): {\n  base: number\n  penalty: number\n  entityIndex: number\n} {\n  const listVisibleScore = def.listVisible === false ? 0 : 1\n  const formEditableScore = def.formEditable === false ? 0 : 1\n  const filterableScore = def.filterable ? 1 : 0\n  const kindScore = (() => {\n    switch (def.kind) {\n      case 'dictionary':\n        return 8\n      case 'relation':\n        return 6\n      case 'select':\n        return 4\n      case 'multiline':\n        return 3\n      case 'boolean':\n      case 'integer':\n      case 'float':\n        return 2\n      default:\n        return 1\n    }\n  })()\n  const optionsBonus = Array.isArray(def.options) && def.options.length > 0 ? 2 : 0\n  const dictionaryBonus = typeof def.dictionaryId === 'string' && def.dictionaryId.trim().length > 0 ? 5 : 0\n  return {\n    base: (listVisibleScore * 16) + (formEditableScore * 8) + (filterableScore * 4) + kindScore + optionsBonus + dictionaryBonus,\n    penalty: typeof def.priority === 'number' ? def.priority : 0,\n    entityIndex,\n  }\n}\n\nfunction buildCustomFieldOption(def: CustomFieldDefDto): MappingTargetOption {\n  const fallback = typeof def.label === 'string' && def.label.trim().length > 0\n    ? def.label.trim()\n    : titleizeKey(def.key)\n\n  return {\n    value: `cf:${def.key}`,\n    fallback,\n    mappingKind: 'custom_field',\n    matchTokens: buildCustomFieldMatchTokens(def, fallback),\n  }\n}\n\nfunction selectPreferredCustomFieldDefs(customFieldDefs: CustomFieldDefDto[]): CustomFieldDefDto[] {\n  const entityOrder = new Map<string, number>()\n  SYNC_EXCEL_PEOPLE_CUSTOM_FIELD_ENTITY_IDS.forEach((entityId, index) => entityOrder.set(entityId, index))\n  const bestByKey = new Map<string, { def: CustomFieldDefDto; score: { base: number; penalty: number; entityIndex: number } }>()\n\n  for (const def of customFieldDefs) {\n    if (typeof def.key !== 'string' || def.key.trim().length === 0) continue\n    const score = scoreCustomFieldDefinition(def, entityOrder.get(def.entityId ?? '') ?? Number.MAX_SAFE_INTEGER)\n    const existing = bestByKey.get(def.key)\n    const isBetter = !existing\n      || score.base > existing.score.base\n      || (\n        score.base === existing.score.base\n        && (score.penalty < existing.score.penalty\n          || (score.penalty === existing.score.penalty && score.entityIndex < existing.score.entityIndex))\n      )\n    if (isBetter) {\n      bestByKey.set(def.key, { def, score })\n    }\n  }\n\n  return Array.from(bestByKey.values()).map((entry) => entry.def)\n}\n\nexport function buildPeopleTargetOptions(customFieldDefs: CustomFieldDefDto[]): MappingTargetOption[] {\n  const customOptions = selectPreferredCustomFieldDefs(customFieldDefs).map(buildCustomFieldOption)\n  return [...CORE_TARGET_OPTIONS, ...ADDRESS_TARGET_OPTIONS, ...customOptions]\n}\n\nexport function buildPeopleSuggestedMapping(\n  headers: string[],\n  suggestedMapping: SuggestedMapping,\n  customFieldDefs: CustomFieldDefDto[],\n): SuggestedMapping {\n  const fields = [...suggestedMapping.fields]\n  const usedExternalFields = new Set(fields.map((field) => field.externalField))\n  const usedTargetFields = new Set(fields.map((field) => field.localField))\n  const supplementalTargetOptions = buildPeopleTargetOptions(customFieldDefs).filter(\n    (option) => option.mappingKind === 'custom_field' || option.value.startsWith('address.'),\n  )\n\n  for (const header of headers) {\n    if (usedExternalFields.has(header)) continue\n    const normalizedHeader = normalizeMatchToken(header)\n    const matchedOption = supplementalTargetOptions.find((option) => {\n      if (usedTargetFields.has(option.value)) return false\n      return option.matchTokens.includes(normalizedHeader)\n    })\n    if (!matchedOption) continue\n\n    fields.push({\n      externalField: header,\n      localField: matchedOption.value,\n      mappingKind: matchedOption.mappingKind,\n    })\n    usedExternalFields.add(header)\n    usedTargetFields.add(matchedOption.value)\n  }\n\n  return {\n    ...suggestedMapping,\n    fields,\n    unmappedColumns: headers.filter((header) => !usedExternalFields.has(header)),\n  }\n}\n\nexport function buildSuggestedMappingSignature(headers: string[], suggestedMapping: SuggestedMapping): string {\n  return JSON.stringify({\n    headers,\n    matchStrategy: suggestedMapping.matchStrategy,\n    matchField: suggestedMapping.matchField ?? null,\n    fields: suggestedMapping.fields.map((field) => ({\n      externalField: field.externalField,\n      localField: field.localField,\n      mappingKind: field.mappingKind ?? null,\n      dedupeRole: field.dedupeRole ?? null,\n    })),\n  })\n}\n\nexport function findMappingTargetOption(\n  targetOptions: MappingTargetOption[],\n  targetField: string,\n): MappingTargetOption | undefined {\n  return targetOptions.find((option) => option.value === targetField)\n}\n\nexport { normalizeMatchToken }\n"],
+  "mappings": "AAGO,MAAM,4CAA4C;AAAA,EACvD;AAAA,EACA;AACF;AAmBA,MAAM,sBAA6C;AAAA,EACjD;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa,CAAC,eAAe,aAAa,SAAS;AAAA,EACrD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,cAAc,aAAa,YAAY;AAAA,EACvD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,aAAa,YAAY,WAAW,aAAa;AAAA,EACjE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,gBAAgB,aAAa,aAAa,MAAM;AAAA,EAChE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa,CAAC,SAAS,iBAAiB,eAAe;AAAA,EACzD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,SAAS,iBAAiB,UAAU,gBAAgB,WAAW;AAAA,EAC/E;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,aAAa,SAAS,UAAU;AAAA,EAChD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,UAAU,aAAa;AAAA,EACvC;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,UAAU,aAAa;AAAA,EACvC;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,eAAe,SAAS,SAAS;AAAA,EACjD;AACF;AAEA,MAAM,yBAAgD;AAAA,EACpD;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,iBAAiB,gBAAgB,OAAO;AAAA,EACxD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,mBAAmB,cAAc;AAAA,EACjD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,mBAAmB,sBAAsB;AAAA,EACzD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,kBAAkB,kBAAkB,UAAU,UAAU;AAAA,EACxE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,kBAAkB,UAAU;AAAA,EAC5C;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,mBAAmB,eAAe,cAAc;AAAA,EAChE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,eAAe,oBAAoB,aAAa;AAAA,EAChE;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,QAAQ,MAAM;AAAA,EAC9B;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,UAAU,SAAS,UAAU;AAAA,EAC7C;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,eAAe,YAAY,UAAU;AAAA,EACrD;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,SAAS;AAAA,EACzB;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,YAAY,KAAK;AAAA,EACjC;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa;AAAA,IACb,aAAa,CAAC,aAAa,OAAO,KAAK;AAAA,EACzC;AACF;AAEA,SAAS,oBAAoB,OAAuB;AAClD,SAAO,MACJ,KAAK,EACL,QAAQ,sBAAsB,OAAO,EACrC,YAAY,EACZ,QAAQ,UAAU,GAAG,EACrB,QAAQ,QAAQ,GAAG,EACnB,KAAK;AACV;AAEA,MAAM,6BAA6B,oBAAI,IAAI,CAAC,YAAY,YAAY,KAAK,CAAC;AAE1E,SAAS,wBAAwB,QAAqB,OAAqB;AACzE,QAAM,aAAa,oBAAoB,KAAK;AAC5C,MAAI,WAAW,SAAS,GAAG;AACzB,WAAO,IAAI,UAAU;AAAA,EACvB;AACF;AAEA,SAAS,uBAAuB,OAAuB;AACrD,SAAO,MAAM,QAAQ,oBAAoB,GAAG;AAC9C;AAEA,SAAS,6BAA6B,OAAuB;AAC3D,QAAM,QAAQ,oBAAoB,KAAK,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AACpF,SAAO,MAAM,SAAS,KAAK,2BAA2B,IAAI,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG;AAClF,UAAM,IAAI;AAAA,EACZ;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;AAEA,SAAS,4BAA4B,KAAwB,UAA4B;AACvF,QAAM,SAAS,oBAAI,IAAY;AAC/B,QAAM,aAAa;AAAA,IACjB,IAAI;AAAA,IACJ;AAAA,IACA,uBAAuB,QAAQ;AAAA,IAC/B,6BAA6B,IAAI,GAAG;AAAA,IACpC,6BAA6B,QAAQ;AAAA,IACrC,6BAA6B,uBAAuB,QAAQ,CAAC;AAAA,EAC/D;AAEA,aAAW,aAAa,YAAY;AAClC,4BAAwB,QAAQ,SAAS;AAAA,EAC3C;AAEA,SAAO,MAAM,KAAK,MAAM;AAC1B;AAEA,SAAS,YAAY,KAAqB;AACxC,SAAO,IACJ,MAAM,GAAG,EACT,IAAI,CAAC,SAAU,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,IAAI,IAAK,EAC9E,KAAK,GAAG;AACb;AAEA,SAAS,2BAA2B,KAAwB,aAI1D;AACA,QAAM,mBAAmB,IAAI,gBAAgB,QAAQ,IAAI;AACzD,QAAM,oBAAoB,IAAI,iBAAiB,QAAQ,IAAI;AAC3D,QAAM,kBAAkB,IAAI,aAAa,IAAI;AAC7C,QAAM,aAAa,MAAM;AACvB,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AAAA,MACT;AACE,eAAO;AAAA,IACX;AAAA,EACF,GAAG;AACH,QAAM,eAAe,MAAM,QAAQ,IAAI,OAAO,KAAK,IAAI,QAAQ,SAAS,IAAI,IAAI;AAChF,QAAM,kBAAkB,OAAO,IAAI,iBAAiB,YAAY,IAAI,aAAa,KAAK,EAAE,SAAS,IAAI,IAAI;AACzG,SAAO;AAAA,IACL,MAAO,mBAAmB,KAAO,oBAAoB,IAAM,kBAAkB,IAAK,YAAY,eAAe;AAAA,IAC7G,SAAS,OAAO,IAAI,aAAa,WAAW,IAAI,WAAW;AAAA,IAC3D;AAAA,EACF;AACF;AAEA,SAAS,uBAAuB,KAA6C;AAC3E,QAAM,WAAW,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,KAAK,EAAE,SAAS,IACxE,IAAI,MAAM,KAAK,IACf,YAAY,IAAI,GAAG;AAEvB,SAAO;AAAA,IACL,OAAO,MAAM,IAAI,GAAG;AAAA,IACpB;AAAA,IACA,aAAa;AAAA,IACb,aAAa,4BAA4B,KAAK,QAAQ;AAAA,EACxD;AACF;AAEA,SAAS,+BAA+B,iBAA2D;AACjG,QAAM,cAAc,oBAAI,IAAoB;AAC5C,4CAA0C,QAAQ,CAAC,UAAU,UAAU,YAAY,IAAI,UAAU,KAAK,CAAC;AACvG,QAAM,YAAY,oBAAI,IAAuG;AAE7H,aAAW,OAAO,iBAAiB;AACjC,QAAI,OAAO,IAAI,QAAQ,YAAY,IAAI,IAAI,KAAK,EAAE,WAAW,EAAG;AAChE,UAAM,QAAQ,2BAA2B,KAAK,YAAY,IAAI,IAAI,YAAY,EAAE,KAAK,OAAO,gBAAgB;AAC5G,UAAM,WAAW,UAAU,IAAI,IAAI,GAAG;AACtC,UAAM,WAAW,CAAC,YACb,MAAM,OAAO,SAAS,MAAM,QAE7B,MAAM,SAAS,SAAS,MAAM,SAC1B,MAAM,UAAU,SAAS,MAAM,WAC7B,MAAM,YAAY,SAAS,MAAM,WAAW,MAAM,cAAc,SAAS,MAAM;AAEzF,QAAI,UAAU;AACZ,gBAAU,IAAI,IAAI,KAAK,EAAE,KAAK,MAAM,CAAC;AAAA,IACvC;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,UAAU,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,MAAM,GAAG;AAChE;AAEO,SAAS,yBAAyB,iBAA6D;AACpG,QAAM,gBAAgB,+BAA+B,eAAe,EAAE,IAAI,sBAAsB;AAChG,SAAO,CAAC,GAAG,qBAAqB,GAAG,wBAAwB,GAAG,aAAa;AAC7E;AAEO,SAAS,4BACd,SACA,kBACA,iBACkB;AAClB,QAAM,SAAS,CAAC,GAAG,iBAAiB,MAAM;AAC1C,QAAM,qBAAqB,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,MAAM,aAAa,CAAC;AAC7E,QAAM,mBAAmB,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,MAAM,UAAU,CAAC;AACxE,QAAM,4BAA4B,yBAAyB,eAAe,EAAE;AAAA,IAC1E,CAAC,WAAW,OAAO,gBAAgB,kBAAkB,OAAO,MAAM,WAAW,UAAU;AAAA,EACzF;AAEA,aAAW,UAAU,SAAS;AAC5B,QAAI,mBAAmB,IAAI,MAAM,EAAG;AACpC,UAAM,mBAAmB,oBAAoB,MAAM;AACnD,UAAM,gBAAgB,0BAA0B,KAAK,CAAC,WAAW;AAC/D,UAAI,iBAAiB,IAAI,OAAO,KAAK,EAAG,QAAO;AAC/C,aAAO,OAAO,YAAY,SAAS,gBAAgB;AAAA,IACrD,CAAC;AACD,QAAI,CAAC,cAAe;AAEpB,WAAO,KAAK;AAAA,MACV,eAAe;AAAA,MACf,YAAY,cAAc;AAAA,MAC1B,aAAa,cAAc;AAAA,IAC7B,CAAC;AACD,uBAAmB,IAAI,MAAM;AAC7B,qBAAiB,IAAI,cAAc,KAAK;AAAA,EAC1C;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA,iBAAiB,QAAQ,OAAO,CAAC,WAAW,CAAC,mBAAmB,IAAI,MAAM,CAAC;AAAA,EAC7E;AACF;AAEO,SAAS,+BAA+B,SAAmB,kBAA4C;AAC5G,SAAO,KAAK,UAAU;AAAA,IACpB;AAAA,IACA,eAAe,iBAAiB;AAAA,IAChC,YAAY,iBAAiB,cAAc;AAAA,IAC3C,QAAQ,iBAAiB,OAAO,IAAI,CAAC,WAAW;AAAA,MAC9C,eAAe,MAAM;AAAA,MACrB,YAAY,MAAM;AAAA,MAClB,aAAa,MAAM,eAAe;AAAA,MAClC,YAAY,MAAM,cAAc;AAAA,IAClC,EAAE;AAAA,EACJ,CAAC;AACH;AAEO,SAAS,wBACd,eACA,aACiC;AACjC,SAAO,cAAc,KAAK,CAAC,WAAW,OAAO,UAAU,WAAW;AACpE;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.3-develop.3881.1.0b590ac4eb",
+  "version": "0.6.3-develop.3901.1.ddad60693a",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -243,16 +243,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.3-develop.3881.1.0b590ac4eb",
-    "@open-mercato/shared": "0.6.3-develop.3881.1.0b590ac4eb",
-    "@open-mercato/ui": "0.6.3-develop.3881.1.0b590ac4eb",
+    "@open-mercato/ai-assistant": "0.6.3-develop.3901.1.ddad60693a",
+    "@open-mercato/shared": "0.6.3-develop.3901.1.ddad60693a",
+    "@open-mercato/ui": "0.6.3-develop.3901.1.ddad60693a",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.3-develop.3881.1.0b590ac4eb",
-    "@open-mercato/shared": "0.6.3-develop.3881.1.0b590ac4eb",
-    "@open-mercato/ui": "0.6.3-develop.3881.1.0b590ac4eb",
+    "@open-mercato/ai-assistant": "0.6.3-develop.3901.1.ddad60693a",
+    "@open-mercato/shared": "0.6.3-develop.3901.1.ddad60693a",
+    "@open-mercato/ui": "0.6.3-develop.3901.1.ddad60693a",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/modules/auth/backend/auth/profile/page.tsx

@@ -55,7 +55,7 @@ export default function AuthProfilePage() {
       setError(null)
       try {
         const { ok, result } = await apiCall<ProfileResponse>('/api/auth/profile')
-        if (!ok) throw new Error('load_failed')
+        if (!ok) throw new Error(t('auth.profile.form.errors.load', 'Failed to load profile.'))
         const resolvedEmail = typeof result?.email === 'string' ? result.email : ''
         if (!cancelled) setEmail(resolvedEmail)
       } catch (err) {

package/src/modules/auth/backend/profile/change-password/page.tsx

@@ -54,7 +54,7 @@ export default function ProfileChangePasswordPage() {
       setError(null)
       try {
         const { ok, result } = await apiCall<ProfileResponse>('/api/auth/profile')
-        if (!ok) throw new Error('load_failed')
+        if (!ok) throw new Error(t('auth.profile.form.errors.load', 'Failed to load profile.'))
         const resolvedEmail = typeof result?.email === 'string' ? result.email : ''
         if (!cancelled) setEmail(resolvedEmail)
       } catch (err) {

package/src/modules/auth/backend/users/[id]/edit/page.tsx

@@ -176,7 +176,7 @@ export default function EditUserPage({ params }: { params?: { id?: string } }) {
         const { ok, result } = await apiCall<UserListResponse>(
           `/api/auth/users?id=${encodeURIComponent(String(id))}&page=1&pageSize=1`,
         )
-        if (!ok) throw new Error('load_failed')
+        if (!ok) throw new Error(tRef.current('auth.users.form.errors.load', 'Failed to load user data'))
         const item = Array.isArray(result?.items) ? result?.items?.[0] : undefined
         if (!cancelled) {
           setActorIsSuperAdmin(Boolean(result?.isSuperAdmin))

package/src/modules/auth/backend/users/create/page.tsx

@@ -109,7 +109,12 @@ export default function CreateUserPage() {
       setWidgetError(null)
       try {
         const { ok, result } = await apiCall<WidgetCatalogResponse>('/api/dashboards/widgets/catalog')
-        if (!ok) throw new Error('request_failed')
+        if (!ok) {
+          throw new Error(t(
+            'auth.users.widgets.errors.load',
+            'Unable to load dashboard widgets. You can configure them later from the user page.',
+          ))
+        }
         if (!cancelled) {
           const rawItems: unknown[] = Array.isArray(result?.items) ? result?.items ?? [] : []
           const normalized = rawItems

package/src/modules/catalog/backend/catalog/products/[id]/page.tsx

@@ -556,7 +556,14 @@ export default function EditCatalogProductPage({
         const productRes = await apiCall<ProductResponse>(
           `/api/catalog/products?id=${encodeURIComponent(productId!)}&page=1&pageSize=1&withDeleted=false`,
         );
-        if (!productRes.ok) throw new Error("load_failed");
+        if (!productRes.ok) {
+          throw new Error(
+            t(
+              "catalog.products.edit.errors.load",
+              "Failed to load product details.",
+            ),
+          );
+        }
         const record = Array.isArray(productRes.result?.items)
           ? productRes.result?.items?.[0]
           : undefined;

package/src/modules/catalog/backend/catalog/products/[productId]/variants/[variantId]/page.tsx

@@ -9,6 +9,7 @@ import { createCrudFormError } from '@open-mercato/ui/backend/utils/serverErrors
 import { collectCustomFieldValues } from '@open-mercato/ui/backend/utils/customFieldValues'
 import { apiCall, readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
 import { flash } from '@open-mercato/ui/backend/FlashMessages'
+import { ErrorMessage } from '@open-mercato/ui/backend/detail'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { extractCustomFieldEntries } from '@open-mercato/shared/lib/crud/custom-fields-client'
 import { E } from '#generated/entities.ids.generated'
@@ -165,7 +166,7 @@ export default function EditVariantPage({ params }: { params?: { productId?: str
         const variantRes = await apiCall<VariantResponse>(
           `/api/catalog/variants?id=${encodeURIComponent(variantId!)}&page=1&pageSize=1`,
         )
-        if (!variantRes.ok) throw new Error('load_variant_failed')
+        if (!variantRes.ok) throw new Error(t('catalog.variants.form.errors.load', 'Failed to load variant.'))
         const record = Array.isArray(variantRes.result?.items) ? variantRes.result?.items?.[0] : undefined
         if (!record) throw new Error(t('catalog.variants.form.errors.notFound', 'Variant not found.'))
         const resolvedProductId =
@@ -421,7 +422,7 @@ export default function EditVariantPage({ params }: { params?: { productId?: str
     <Page>
       <PageBody>
         {error ? (
-          <div className="mb-4 rounded border border-destructive/40 bg-destructive/10 px-4 py-3 text-sm text-destructive">{error}</div>
+          <ErrorMessage label={error} className="mb-4" />
         ) : null}
         <CrudForm<VariantFormValues>
           title={formTitle}

package/src/modules/catalog/backend/catalog/products/[productId]/variants/create/page.tsx

@@ -9,6 +9,7 @@ import { createCrudFormError } from '@open-mercato/ui/backend/utils/serverErrors
 import { collectCustomFieldValues } from '@open-mercato/ui/backend/utils/customFieldValues'
 import { apiCall, readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
 import { flash } from '@open-mercato/ui/backend/FlashMessages'
+import { ErrorMessage } from '@open-mercato/ui/backend/detail'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { E } from '#generated/entities.ids.generated'
 import {
@@ -136,7 +137,7 @@ export default function CreateVariantPage({ params }: { params?: { productId?: s
         const res = await apiCall<ProductResponse>(
           `/api/catalog/products?id=${encodeURIComponent(productId!)}&page=1&pageSize=1`,
         )
-        if (!res.ok) throw new Error('load_failed')
+        if (!res.ok) throw new Error(t('catalog.variants.form.errors.load', 'Failed to load product context.'))
         const record = Array.isArray(res.result?.items) ? res.result?.items?.[0] : undefined
         if (!record) throw new Error(t('catalog.products.edit.errors.notFound', 'Product not found.'))
         const metadata = (record.metadata ?? {}) as Record<string, unknown>
@@ -298,7 +299,7 @@ export default function CreateVariantPage({ params }: { params?: { productId?: s
     <Page>
       <PageBody>
         {error ? (
-          <div className="mb-4 rounded border border-destructive/40 bg-destructive/10 px-4 py-3 text-sm text-destructive">{error}</div>
+          <ErrorMessage label={error} className="mb-4" />
         ) : null}
         <CrudForm<VariantFormValues>
           title={formTitle}

package/src/modules/configs/cli.ts

@@ -16,6 +16,12 @@ import { touchGeneratedBarrels } from './lib/touchGeneratedBarrels'
 
 type ParsedArgs = Record<string, string | boolean>
 
+export const STRUCTURAL_CACHE_REQUESTS: CachePurgeRequest[] = [
+  { kind: 'pattern', pattern: 'nav:*' },
+  { kind: 'segment', segment: 'admin-nav' },
+  { kind: 'segment', segment: 'portal-nav' },
+]
+
 type CacheScope = {
   label: string
   tenantId: string | null
@@ -157,7 +163,7 @@ function printCacheHelp() {
   console.log('ℹ️ Notes:')
   console.log('  `stats` mirrors the cache admin page segment overview for CRUD/widget caches.')
   console.log('  `purge --id` removes every key whose name contains the provided token (for example a user id or entity id).')
-  console.log('  `structural` targets navigation caches (`nav:*`) and is the recommended post-step after module/sidebar structure changes.')
+  console.log('  `structural` targets navigation/sidebar caches and is the recommended post-step after module/sidebar structure changes.')
   console.log('  When no scope flag is supplied, this command uses the global cache scope only.')
 }
 
@@ -201,11 +207,14 @@ async function runCacheStats(args: ParsedArgs) {
   }
 }
 
-async function runCachePurge(args: ParsedArgs) {
+async function runCachePurgeRequest(
+  args: ParsedArgs,
+  request: CachePurgeRequest,
+  emitOutput = true,
+) {
   const json = flagEnabled(args, 'json')
   const quiet = flagEnabled(args, 'quiet')
   const dryRun = flagEnabled(args, 'dry-run', 'dryRun')
-  const request = resolveCachePurgeRequest(args)
   const container = await createRequestContainer()
   try {
     const em = container.resolve('em') as EntityManager
@@ -228,13 +237,13 @@ async function runCachePurge(args: ParsedArgs) {
       })
     }
 
-    if (json) {
+    if (json && emitOutput) {
       console.log(JSON.stringify(results, null, 2))
-      return
+      return results
     }
 
-    if (quiet) {
-      return
+    if (quiet || !emitOutput) {
+      return results
     }
 
     for (const result of results) {
@@ -246,22 +255,34 @@ async function runCachePurge(args: ParsedArgs) {
         }
       }
     }
+    return results
   } finally {
     await disposeContainer(container)
   }
 }
 
+async function runCachePurge(args: ParsedArgs) {
+  await runCachePurgeRequest(args, resolveCachePurgeRequest(args))
+}
+
 async function runStructuralCachePurge(args: ParsedArgs) {
-  const nextArgs: ParsedArgs = {
-    ...args,
-    pattern: 'nav:*',
+  const json = flagEnabled(args, 'json')
+  const structuralResults: Array<{
+    request: CachePurgeRequest
+    results: Awaited<ReturnType<typeof runCachePurgeRequest>>
+  }> = []
+  for (const request of STRUCTURAL_CACHE_REQUESTS) {
+    const results = await runCachePurgeRequest(args, request, !json)
+    structuralResults.push({ request, results })
+  }
+  if (json) {
+    console.log(JSON.stringify(structuralResults, null, 2))
   }
-  await runCachePurge(nextArgs)
   const quiet = flagEnabled(args, 'quiet')
   try {
-    touchGeneratedBarrels({ quiet })
+    touchGeneratedBarrels({ quiet: quiet || json })
   } catch (err) {
-    if (!quiet) {
+    if (!quiet && !json) {
       console.warn(
         `[structural] failed to touch generated barrels: ${(err as Error).message ?? err}`,
       )

package/src/modules/resources/backend/resources/resource-types/[id]/edit/page.tsx

@@ -37,7 +37,7 @@ export default function ResourcesResourceTypeEditPage({ params }: { params?: { i
           { errorMessage: t('resources.resourceTypes.errors.load', 'Failed to load resource types.') },
         )
         const item = Array.isArray(payload.items) ? payload.items[0] : null
-        if (!item) throw new Error('not_found')
+        if (!item) throw new Error(t('resources.resourceTypes.errors.notFound', 'Resource type not found.'))
         if (!cancelled) {
           const customValues = extractCustomFieldValues(item)
           setInitialValues({

package/src/modules/sales/backend/sales/channels/[channelId]/edit/page.tsx

@@ -53,7 +53,7 @@ export default function EditChannelPage({ params }: { params?: { channelId?: str
         )
         const item = Array.isArray(payload.items) ? payload.items[0] : null
         if (!item) {
-          throw new Error('not_found')
+          throw new Error(t('sales.channels.form.errors.notFound', 'Channel not found.'))
         }
         if (!cancelled) {
           setInitialValues(mapChannelToFormValues(item))

package/src/modules/sales/components/channels/ChannelOfferForm.tsx

@@ -291,7 +291,7 @@ export function ChannelOfferForm({ channelId: lockedChannelId, offerId, mode }:
           { errorMessage: t('sales.channels.offers.errors.loadOffer', 'Failed to load offer.') },
         )
         const offer = Array.isArray(payload.items) ? payload.items[0] : null
-        if (!offer) throw new Error('not_found')
+        if (!offer) throw new Error(t('sales.channels.offers.errors.notFound', 'Offer not found.'))
         const values = mapOfferToFormValues(offer, lockedChannelId)
         const pricePayload = await readApiResultOrThrow<PriceResponse>(
           `/api/catalog/prices?offerId=${encodeURIComponent(offer.id as string)}&pageSize=${MAX_LIST_PAGE_SIZE}`,

package/src/modules/sync_excel/widgets/injection/upload-config/target-options.ts

@@ -202,6 +202,45 @@ function normalizeMatchToken(value: string): string {
     .trim()
 }
 
+const TRAILING_IMPORT_QUALIFIERS = new Set(['external', 'imported', 'crm'])
+
+function addNormalizedMatchToken(tokens: Set<string>, value: string): void {
+  const normalized = normalizeMatchToken(value)
+  if (normalized.length > 0) {
+    tokens.add(normalized)
+  }
+}
+
+function stripParentheticalText(value: string): string {
+  return value.replace(/\s*\([^)]*\)\s*/g, ' ')
+}
+
+function stripTrailingImportQualifier(value: string): string {
+  const parts = normalizeMatchToken(value).split(' ').filter((part) => part.length > 0)
+  while (parts.length > 1 && TRAILING_IMPORT_QUALIFIERS.has(parts[parts.length - 1])) {
+    parts.pop()
+  }
+  return parts.join(' ')
+}
+
+function buildCustomFieldMatchTokens(def: CustomFieldDefDto, fallback: string): string[] {
+  const tokens = new Set<string>()
+  const candidates = [
+    def.key,
+    fallback,
+    stripParentheticalText(fallback),
+    stripTrailingImportQualifier(def.key),
+    stripTrailingImportQualifier(fallback),
+    stripTrailingImportQualifier(stripParentheticalText(fallback)),
+  ]
+
+  for (const candidate of candidates) {
+    addNormalizedMatchToken(tokens, candidate)
+  }
+
+  return Array.from(tokens)
+}
+
 function titleizeKey(key: string): string {
   return key
     .split('_')
@@ -248,16 +287,12 @@ function buildCustomFieldOption(def: CustomFieldDefDto): MappingTargetOption {
   const fallback = typeof def.label === 'string' && def.label.trim().length > 0
     ? def.label.trim()
     : titleizeKey(def.key)
-  const normalizedTokens = Array.from(new Set([
-    normalizeMatchToken(def.key),
-    normalizeMatchToken(fallback),
-  ].filter((value) => value.length > 0)))
 
   return {
     value: `cf:${def.key}`,
     fallback,
     mappingKind: 'custom_field',
-    matchTokens: normalizedTokens,
+    matchTokens: buildCustomFieldMatchTokens(def, fallback),
   }
 }