@open-mercato/core 0.5.1-develop.2800.bfe2178a4f → 0.5.1-develop.2851.2854b4507f

package/src/modules/customers/components/detail/RolesSection.tsx

@@ -7,7 +7,9 @@ import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { apiCallOrThrow, readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
 import { flash } from '@open-mercato/ui/backend/FlashMessages'
 import { useGuardedMutation } from '@open-mercato/ui/backend/injection/useGuardedMutation'
+import { useBackendChrome } from '@open-mercato/ui/backend/BackendChromeProvider'
 import { Button } from '@open-mercato/ui/primitives/button'
+import { hasFeature } from '@open-mercato/shared/security/features'
 import type { DictionaryEntryOption } from '@open-mercato/core/modules/dictionaries/lib/clientEntries'
 import { RoleAssignmentRow, type RoleAssignment } from './RoleAssignmentRow'
 import { AssignRoleDialog } from './AssignRoleDialog'
@@ -25,6 +27,11 @@ type GuardedMutationRunner = <T,>(
 
 export function RolesSection({ entityType, entityId, entityName }: RolesSectionProps) {
   const t = useT()
+  const { payload } = useBackendChrome()
+  const canManageRoleTypes = React.useMemo(
+    () => hasFeature(payload?.grantedFeatures ?? [], 'customers.settings.manage'),
+    [payload?.grantedFeatures],
+  )
   const [roles, setRoles] = React.useState<RoleAssignment[]>([])
   const [roleTypes, setRoleTypes] = React.useState<DictionaryEntryOption[]>([])
   const [loading, setLoading] = React.useState(true)
@@ -183,10 +190,21 @@ export function RolesSection({ entityType, entityId, entityName }: RolesSectionP
     )
   }
 
+  const resolvedEntityName =
+    entityName && entityName.trim().length
+      ? entityName.trim()
+      : entityType === 'company'
+        ? t('customers.roles.defaultEntityName.company', 'this company')
+        : t('customers.roles.defaultEntityName.person', 'this person')
+  const groupTitle =
+    entityType === 'company'
+      ? t('customers.roles.groupTitle.company', 'Roles at {{name}}', { name: resolvedEntityName })
+      : t('customers.roles.groupTitle.person', 'My roles with {{name}}', { name: resolvedEntityName })
+
   return (
     <div className="space-y-4">
       <div className="space-y-1">
-        <div className="text-sm font-semibold">{t('customers.roles.groupTitle', 'Roles')}</div>
+        <div className="text-sm font-semibold">{groupTitle}</div>
         <p className="text-xs text-muted-foreground">
           {entityType === 'company'
             ? t('customers.roles.subtitle.company', 'Who is responsible for this company on your side')
@@ -305,6 +323,7 @@ export function RolesSection({ entityType, entityId, entityName }: RolesSectionP
         existingRoleTypes={assignedRoleTypes}
         existingAssignments={roles}
         initialRoleType={initialRoleType}
+        canManageRoleTypes={canManageRoleTypes}
       />
     </div>
   )

package/src/modules/customers/components/formConfig.tsx

@@ -1553,7 +1553,13 @@ export const createCompanyEditGroups = (t: Translator): CrudFormGroup[] => [
     title: t('customers.roles.groupTitle', 'Roles'),
     column: 1,
     component: ({ values }: CrudFormGroupComponentProps) => (
-      values.id ? <RolesSection entityType="company" entityId={values.id as string} /> : null
+      values.id ? (
+        <RolesSection
+          entityType="company"
+          entityId={values.id as string}
+          entityName={typeof values.displayName === 'string' ? values.displayName : null}
+        />
+      ) : null
     ),
   },
   {
@@ -1645,7 +1651,13 @@ export const createPersonEditGroups = (t: Translator): CrudFormGroup[] => [
     title: t('customers.roles.groupTitle', 'Roles'),
     column: 1,
     component: ({ values }: CrudFormGroupComponentProps) => (
-      values.id ? <RolesSection entityType="person" entityId={values.id as string} /> : null
+      values.id ? (
+        <RolesSection
+          entityType="person"
+          entityId={values.id as string}
+          entityName={typeof values.displayName === 'string' ? values.displayName : null}
+        />
+      ) : null
     ),
   },
   {

package/src/modules/customers/i18n/de.json

@@ -13,8 +13,10 @@
   "customers.activities.yearSeparator": "",
   "customers.activityComposer.cancel": "Cancel",
   "customers.activityComposer.dateLabel": "Date",
+  "customers.activityComposer.descriptionLabel": "Beschreibung",
   "customers.activityComposer.descriptionPlaceholder": "What happened?",
   "customers.activityComposer.error": "Failed to save activity",
+  "customers.activityComposer.hideWeekPreview": "Wochenvorschau ausblenden",
   "customers.activityComposer.hint": "Cmd+Enter to save",
   "customers.activityComposer.save": "Save activity",
   "customers.activityComposer.saveActivity": "Save activity",
@@ -22,6 +24,7 @@
   "customers.activityComposer.saving": "Saving...",
   "customers.activityComposer.schedule": "Schedule",
   "customers.activityComposer.scheduledLabel": "Scheduled for",
+  "customers.activityComposer.showWeekPreview": "Wochenvorschau anzeigen",
   "customers.activityComposer.title": "Log activity",
   "customers.activityComposer.today": "Today",
   "customers.activityComposer.types.call": "Call",
@@ -30,6 +33,7 @@
   "customers.activityComposer.types.note": "Note",
   "customers.activityComposer.validation.descriptionRequired": "Description is required",
   "customers.activityComposer.validation.typeRequired": "Select an activity type",
+  "customers.activityComposer.weekPreviewTitle": "Diese Woche",
   "customers.activityLog.direction.to": "to",
   "customers.activityLog.direction.with": "with",
   "customers.activityLog.emptyDescription": "Try broadening the date range or removing some filters.",
@@ -201,6 +205,7 @@
   "customers.companies.detail.actions.manageTags": "Tags bearbeiten",
   "customers.companies.detail.actions.more": "Mehr",
   "customers.companies.detail.actions.save": "Save",
+  "customers.companies.detail.actions.sendMessage": "Nachricht senden",
   "customers.companies.detail.activeDeal": "AKTIVER DEAL",
   "customers.companies.detail.activities.add": "Aktivität protokollieren",
   "customers.companies.detail.activities.loading": "Aktivitäten werden geladen…",
@@ -583,6 +588,7 @@
   "customers.deals.detail.actions.delete": "Delete",
   "customers.deals.detail.actions.moveStage": "Phase ändern",
   "customers.deals.detail.actions.save": "Save",
+  "customers.deals.detail.actions.sendMessage": "Nachricht senden",
   "customers.deals.detail.activities.linkEntityDescription": "Activities on a deal still need a customer record for timeline ownership.",
   "customers.deals.detail.activities.linkEntityTitle": "Link a person or company first",
   "customers.deals.detail.activities.selectEntityDescription": "Pick the person or company that should own new deal activities and follow-ups.",
@@ -1043,6 +1049,7 @@
   "customers.people.detail.actions.manageTags": "Tags bearbeiten",
   "customers.people.detail.actions.more": "More",
   "customers.people.detail.actions.save": "Save",
+  "customers.people.detail.actions.sendMessage": "Nachricht senden",
   "customers.people.detail.activities.add": "Aktivität hinzufügen",
   "customers.people.detail.activities.addTitle": "Aktivität hinzufügen",
   "customers.people.detail.activities.bodyPlaceholder": "Interaktion beschreiben",
@@ -1707,6 +1714,8 @@
   "customers.roles.changeUser": "Change user",
   "customers.roles.choosePerson": "Person auswählen",
   "customers.roles.configureRoleTypes": "Rollentypen konfigurieren",
+  "customers.roles.defaultEntityName.company": "dieses Unternehmen",
+  "customers.roles.defaultEntityName.person": "diese Person",
   "customers.roles.dialog.assign": "Assign role",
   "customers.roles.dialog.change": "Change",
   "customers.roles.dialog.conflict": "Conflict: {{roles}}",
@@ -1716,6 +1725,7 @@
   "customers.roles.dialog.footerNote": "One person per role · can be changed at any time",
   "customers.roles.dialog.loadMore": "Mehr laden",
   "customers.roles.dialog.loadingMore": "Wird geladen...",
+  "customers.roles.dialog.manageRoleTypes": "Rollentypen verwalten",
   "customers.roles.dialog.next": "Next",
   "customers.roles.dialog.noAvailableRoles": "All available role types are already assigned.",
   "customers.roles.dialog.noResults": "No matching team members found.",
@@ -1736,6 +1746,8 @@
   "customers.roles.emptySlot": "Not assigned",
   "customers.roles.emptyState": "Noch keine Rollen zugewiesen. Klicken Sie unten, um eine Person zuzuweisen.",
   "customers.roles.groupTitle": "Roles",
+  "customers.roles.groupTitle.company": "Rollen bei {{name}}",
+  "customers.roles.groupTitle.person": "Meine Rollen mit {{name}}",
   "customers.roles.loadFailed": "Rollenzuweisungen konnten nicht geladen werden.",
   "customers.roles.loading": "Loading roles...",
   "customers.roles.moreActions": "More actions",

package/src/modules/customers/i18n/en.json

@@ -13,8 +13,10 @@
   "customers.activities.yearSeparator": "{year}",
   "customers.activityComposer.cancel": "Cancel",
   "customers.activityComposer.dateLabel": "Date",
+  "customers.activityComposer.descriptionLabel": "Description",
   "customers.activityComposer.descriptionPlaceholder": "What happened?",
   "customers.activityComposer.error": "Failed to save activity",
+  "customers.activityComposer.hideWeekPreview": "Hide week preview",
   "customers.activityComposer.hint": "Cmd+Enter to save",
   "customers.activityComposer.save": "Save activity",
   "customers.activityComposer.saveActivity": "Save activity",
@@ -22,6 +24,7 @@
   "customers.activityComposer.saving": "Saving...",
   "customers.activityComposer.schedule": "Schedule",
   "customers.activityComposer.scheduledLabel": "Scheduled for",
+  "customers.activityComposer.showWeekPreview": "Show week preview",
   "customers.activityComposer.title": "Log activity",
   "customers.activityComposer.today": "Today",
   "customers.activityComposer.types.call": "Call",
@@ -30,6 +33,7 @@
   "customers.activityComposer.types.note": "Note",
   "customers.activityComposer.validation.descriptionRequired": "Description is required",
   "customers.activityComposer.validation.typeRequired": "Select an activity type",
+  "customers.activityComposer.weekPreviewTitle": "This week",
   "customers.activityLog.direction.to": "to",
   "customers.activityLog.direction.with": "with",
   "customers.activityLog.emptyDescription": "Try broadening the date range or removing some filters.",
@@ -201,6 +205,7 @@
   "customers.companies.detail.actions.manageTags": "Edit tags",
   "customers.companies.detail.actions.more": "More",
   "customers.companies.detail.actions.save": "Save",
+  "customers.companies.detail.actions.sendMessage": "Send message",
   "customers.companies.detail.activeDeal": "ACTIVE DEAL",
   "customers.companies.detail.activities.add": "Log activity",
   "customers.companies.detail.activities.loading": "Loading activities…",
@@ -583,6 +588,7 @@
   "customers.deals.detail.actions.delete": "Delete",
   "customers.deals.detail.actions.moveStage": "Move stage",
   "customers.deals.detail.actions.save": "Save",
+  "customers.deals.detail.actions.sendMessage": "Send message",
   "customers.deals.detail.activities.linkEntityDescription": "Activities on a deal still need a customer record for timeline ownership.",
   "customers.deals.detail.activities.linkEntityTitle": "Link a person or company first",
   "customers.deals.detail.activities.selectEntityDescription": "Pick the person or company that should own new deal activities and follow-ups.",
@@ -1043,6 +1049,7 @@
   "customers.people.detail.actions.manageTags": "Edit tags",
   "customers.people.detail.actions.more": "More",
   "customers.people.detail.actions.save": "Save",
+  "customers.people.detail.actions.sendMessage": "Send message",
   "customers.people.detail.activities.add": "Add activity",
   "customers.people.detail.activities.addTitle": "Add activity",
   "customers.people.detail.activities.bodyPlaceholder": "Describe the interaction",
@@ -1707,6 +1714,8 @@
   "customers.roles.changeUser": "Change user",
   "customers.roles.choosePerson": "Choose person",
   "customers.roles.configureRoleTypes": "Configure role types",
+  "customers.roles.defaultEntityName.company": "this company",
+  "customers.roles.defaultEntityName.person": "this person",
   "customers.roles.dialog.assign": "Assign role",
   "customers.roles.dialog.change": "Change",
   "customers.roles.dialog.conflict": "Conflict: {{roles}}",
@@ -1716,6 +1725,7 @@
   "customers.roles.dialog.footerNote": "One person per role · can be changed at any time",
   "customers.roles.dialog.loadMore": "Load more",
   "customers.roles.dialog.loadingMore": "Loading more...",
+  "customers.roles.dialog.manageRoleTypes": "Manage role types",
   "customers.roles.dialog.next": "Next",
   "customers.roles.dialog.noAvailableRoles": "All available role types are already assigned.",
   "customers.roles.dialog.noResults": "No matching team members found.",
@@ -1736,6 +1746,8 @@
   "customers.roles.emptySlot": "Not assigned",
   "customers.roles.emptyState": "No roles assigned yet. Click below to assign a person.",
   "customers.roles.groupTitle": "Roles",
+  "customers.roles.groupTitle.company": "Roles at {{name}}",
+  "customers.roles.groupTitle.person": "My roles with {{name}}",
   "customers.roles.loadFailed": "Failed to load role assignments.",
   "customers.roles.loading": "Loading roles...",
   "customers.roles.moreActions": "More actions",

package/src/modules/customers/i18n/es.json

@@ -13,8 +13,10 @@
   "customers.activities.yearSeparator": "",
   "customers.activityComposer.cancel": "Cancel",
   "customers.activityComposer.dateLabel": "Date",
+  "customers.activityComposer.descriptionLabel": "Descripción",
   "customers.activityComposer.descriptionPlaceholder": "What happened?",
   "customers.activityComposer.error": "Failed to save activity",
+  "customers.activityComposer.hideWeekPreview": "Ocultar vista semanal",
   "customers.activityComposer.hint": "Cmd+Enter to save",
   "customers.activityComposer.save": "Save activity",
   "customers.activityComposer.saveActivity": "Save activity",
@@ -22,6 +24,7 @@
   "customers.activityComposer.saving": "Saving...",
   "customers.activityComposer.schedule": "Schedule",
   "customers.activityComposer.scheduledLabel": "Scheduled for",
+  "customers.activityComposer.showWeekPreview": "Mostrar vista semanal",
   "customers.activityComposer.title": "Log activity",
   "customers.activityComposer.today": "Today",
   "customers.activityComposer.types.call": "Call",
@@ -30,6 +33,7 @@
   "customers.activityComposer.types.note": "Note",
   "customers.activityComposer.validation.descriptionRequired": "Description is required",
   "customers.activityComposer.validation.typeRequired": "Select an activity type",
+  "customers.activityComposer.weekPreviewTitle": "Esta semana",
   "customers.activityLog.direction.to": "to",
   "customers.activityLog.direction.with": "with",
   "customers.activityLog.emptyDescription": "Try broadening the date range or removing some filters.",
@@ -201,6 +205,7 @@
   "customers.companies.detail.actions.manageTags": "Editar etiquetas",
   "customers.companies.detail.actions.more": "Más",
   "customers.companies.detail.actions.save": "Save",
+  "customers.companies.detail.actions.sendMessage": "Enviar mensaje",
   "customers.companies.detail.activeDeal": "DEAL ACTIVO",
   "customers.companies.detail.activities.add": "Registrar actividad",
   "customers.companies.detail.activities.loading": "Cargando actividades…",
@@ -583,6 +588,7 @@
   "customers.deals.detail.actions.delete": "Delete",
   "customers.deals.detail.actions.moveStage": "Mover etapa",
   "customers.deals.detail.actions.save": "Save",
+  "customers.deals.detail.actions.sendMessage": "Enviar mensaje",
   "customers.deals.detail.activities.linkEntityDescription": "Activities on a deal still need a customer record for timeline ownership.",
   "customers.deals.detail.activities.linkEntityTitle": "Link a person or company first",
   "customers.deals.detail.activities.selectEntityDescription": "Pick the person or company that should own new deal activities and follow-ups.",
@@ -968,7 +974,7 @@
   "customers.linking.primary.badge": "Principal",
   "customers.linking.primary.current": "Principal",
   "customers.linking.primary.help": "Elige qué registro vinculado debe tratarse como principal.",
-  "customers.linking.primary.set": "Definir principal",
+  "customers.linking.primary.set": "Establecer como principal",
   "customers.linking.primary.setAction": "Marcar como principal",
   "customers.linking.resultsCount": "{{count}} resultados",
   "customers.linking.searchResults": "Resultados de la búsqueda",
@@ -1043,6 +1049,7 @@
   "customers.people.detail.actions.manageTags": "Editar etiquetas",
   "customers.people.detail.actions.more": "More",
   "customers.people.detail.actions.save": "Save",
+  "customers.people.detail.actions.sendMessage": "Enviar mensaje",
   "customers.people.detail.activities.add": "Agregar actividad",
   "customers.people.detail.activities.addTitle": "Agregar actividad",
   "customers.people.detail.activities.bodyPlaceholder": "Describe la interacción",
@@ -1707,6 +1714,8 @@
   "customers.roles.changeUser": "Change user",
   "customers.roles.choosePerson": "Elegir persona",
   "customers.roles.configureRoleTypes": "Configurar tipos de rol",
+  "customers.roles.defaultEntityName.company": "esta empresa",
+  "customers.roles.defaultEntityName.person": "esta persona",
   "customers.roles.dialog.assign": "Assign role",
   "customers.roles.dialog.change": "Change",
   "customers.roles.dialog.conflict": "Conflict: {{roles}}",
@@ -1716,6 +1725,7 @@
   "customers.roles.dialog.footerNote": "One person per role · can be changed at any time",
   "customers.roles.dialog.loadMore": "Cargar más",
   "customers.roles.dialog.loadingMore": "Cargando más...",
+  "customers.roles.dialog.manageRoleTypes": "Gestionar tipos de rol",
   "customers.roles.dialog.next": "Next",
   "customers.roles.dialog.noAvailableRoles": "All available role types are already assigned.",
   "customers.roles.dialog.noResults": "No matching team members found.",
@@ -1736,6 +1746,8 @@
   "customers.roles.emptySlot": "Not assigned",
   "customers.roles.emptyState": "Todavía no hay roles asignados. Haz clic abajo para asignar una persona.",
   "customers.roles.groupTitle": "Roles",
+  "customers.roles.groupTitle.company": "Roles en {{name}}",
+  "customers.roles.groupTitle.person": "Mis roles con {{name}}",
   "customers.roles.loadFailed": "No se pudieron cargar las asignaciones de rol.",
   "customers.roles.loading": "Loading roles...",
   "customers.roles.moreActions": "More actions",

package/src/modules/customers/i18n/pl.json

@@ -13,8 +13,10 @@
   "customers.activities.yearSeparator": "{year}",
   "customers.activityComposer.cancel": "Anuluj",
   "customers.activityComposer.dateLabel": "Data",
+  "customers.activityComposer.descriptionLabel": "Opis",
   "customers.activityComposer.descriptionPlaceholder": "Co się wydarzyło?",
   "customers.activityComposer.error": "Nie udało się zapisać aktywności",
+  "customers.activityComposer.hideWeekPreview": "Ukryj podgląd tygodnia",
   "customers.activityComposer.hint": "Cmd+Enter aby zapisać",
   "customers.activityComposer.save": "Zapisz aktywność",
   "customers.activityComposer.saveActivity": "Zapisz aktywność",
@@ -22,6 +24,7 @@
   "customers.activityComposer.saving": "Zapisywanie...",
   "customers.activityComposer.schedule": "Schedule",
   "customers.activityComposer.scheduledLabel": "Zaplanowano na",
+  "customers.activityComposer.showWeekPreview": "Pokaż podgląd tygodnia",
   "customers.activityComposer.title": "Zaloguj aktywność",
   "customers.activityComposer.today": "Today",
   "customers.activityComposer.types.call": "Telefon",
@@ -30,6 +33,7 @@
   "customers.activityComposer.types.note": "Notatka",
   "customers.activityComposer.validation.descriptionRequired": "Opis jest wymagany",
   "customers.activityComposer.validation.typeRequired": "Select an activity type",
+  "customers.activityComposer.weekPreviewTitle": "Ten tydzień",
   "customers.activityLog.direction.to": "do",
   "customers.activityLog.direction.with": "z",
   "customers.activityLog.emptyDescription": "Poszerz zakres dat albo usuń część filtrów.",
@@ -201,6 +205,7 @@
   "customers.companies.detail.actions.manageTags": "Edytuj tagi",
   "customers.companies.detail.actions.more": "Więcej",
   "customers.companies.detail.actions.save": "Zapisz",
+  "customers.companies.detail.actions.sendMessage": "Wyślij wiadomość",
   "customers.companies.detail.activeDeal": "AKTYWNY DEAL",
   "customers.companies.detail.activities.add": "Zaloguj aktywność",
   "customers.companies.detail.activities.loading": "Ładowanie aktywności…",
@@ -583,6 +588,7 @@
   "customers.deals.detail.actions.delete": "Delete",
   "customers.deals.detail.actions.moveStage": "Zmień etap",
   "customers.deals.detail.actions.save": "Save",
+  "customers.deals.detail.actions.sendMessage": "Wyślij wiadomość",
   "customers.deals.detail.activities.linkEntityDescription": "Activities on a deal still need a customer record for timeline ownership.",
   "customers.deals.detail.activities.linkEntityTitle": "Link a person or company first",
   "customers.deals.detail.activities.selectEntityDescription": "Pick the person or company that should own new deal activities and follow-ups.",
@@ -968,7 +974,7 @@
   "customers.linking.primary.badge": "Główny",
   "customers.linking.primary.current": "Główny",
   "customers.linking.primary.help": "Wybierz, który powiązany rekord ma być traktowany jako główny.",
-  "customers.linking.primary.set": "Ustaw główny",
+  "customers.linking.primary.set": "Ustaw jako główny",
   "customers.linking.primary.setAction": "Ustaw jako główny",
   "customers.linking.resultsCount": "{{count}} wyników",
   "customers.linking.searchResults": "Wyniki wyszukiwania",
@@ -1043,6 +1049,7 @@
   "customers.people.detail.actions.manageTags": "Edytuj tagi",
   "customers.people.detail.actions.more": "More",
   "customers.people.detail.actions.save": "Zapisz",
+  "customers.people.detail.actions.sendMessage": "Wyślij wiadomość",
   "customers.people.detail.activities.add": "Dodaj aktywność",
   "customers.people.detail.activities.addTitle": "Dodaj aktywność",
   "customers.people.detail.activities.bodyPlaceholder": "Opisz interakcję",
@@ -1707,6 +1714,8 @@
   "customers.roles.changeUser": "Change user",
   "customers.roles.choosePerson": "Wybierz osobę",
   "customers.roles.configureRoleTypes": "Skonfiguruj typy ról",
+  "customers.roles.defaultEntityName.company": "tej firmie",
+  "customers.roles.defaultEntityName.person": "tej osobie",
   "customers.roles.dialog.assign": "Assign role",
   "customers.roles.dialog.change": "Change",
   "customers.roles.dialog.conflict": "Conflict: {{roles}}",
@@ -1716,6 +1725,7 @@
   "customers.roles.dialog.footerNote": "One person per role · can be changed at any time",
   "customers.roles.dialog.loadMore": "Załaduj więcej",
   "customers.roles.dialog.loadingMore": "Ładowanie...",
+  "customers.roles.dialog.manageRoleTypes": "Zarządzaj typami ról",
   "customers.roles.dialog.next": "Next",
   "customers.roles.dialog.noAvailableRoles": "All available role types are already assigned.",
   "customers.roles.dialog.noResults": "No matching team members found.",
@@ -1736,6 +1746,8 @@
   "customers.roles.emptySlot": "Not assigned",
   "customers.roles.emptyState": "Brak przypisanych ról. Kliknij poniżej aby przypisać osobę.",
   "customers.roles.groupTitle": "Role",
+  "customers.roles.groupTitle.company": "Role w {{name}}",
+  "customers.roles.groupTitle.person": "Moje role z {{name}}",
   "customers.roles.loadFailed": "Nie udało się załadować przypisań ról.",
   "customers.roles.loading": "Ładowanie ról...",
   "customers.roles.moreActions": "More actions",

package/src/modules/customers/lib/displayName.ts

@@ -0,0 +1,16 @@
+export function deriveDisplayNameFromEmail(email: string | null | undefined): string | null {
+  if (typeof email !== 'string') return null
+  const trimmed = email.trim()
+  if (!trimmed.length) return null
+  const atIndex = trimmed.indexOf('@')
+  const localPart = (atIndex >= 0 ? trimmed.slice(0, atIndex) : trimmed).trim()
+  if (!localPart.length) return null
+  const segments = localPart
+    .split(/[._\-+]+/)
+    .map((part) => part.trim())
+    .filter((part) => part.length > 0)
+  if (segments.length === 0) return null
+  return segments
+    .map((part) => part.charAt(0).toLocaleUpperCase() + part.slice(1))
+    .join(' ')
+}

package/src/modules/customers/lib/interactionReadModel.ts

@@ -63,14 +63,8 @@ function mergeAdditiveRecord<T extends Record<string, unknown>>(base: T, candida
   }
 }
 
-// `loadCustomFieldValues` returns keys prefixed with `cf_` (the CRUD-factory projection shape).
-// The canonical `InteractionRecord.customValues` contract is unprefixed (e.g. `severity`,
-// `priority`, `description`) and every downstream consumer — the UI hooks, the todo/interaction
-// compatibility helpers, and the example-customers-sync outbound worker — reads the unprefixed
-// form. Normalize at the read-model boundary so the two shapes can't drift again.
 function normalizeInteractionCustomValues(values: Record<string, unknown> | null | undefined): Record<string, unknown> | null {
-  const normalized = normalizeCustomFieldResponse(values)
-  return normalized ?? null
+  return normalizeCustomFieldResponse(values) ?? null
 }
 
 async function resolveUserFeatures(

package/src/modules/customers/lib/operationMetadata.ts

@@ -0,0 +1,38 @@
+import type { NextResponse } from 'next/server'
+import { serializeOperationMetadata } from '@open-mercato/shared/lib/commands/operationMetadata'
+
+export type OperationLogEntry = {
+  undoToken?: string | null
+  id?: string | null
+  commandId?: string | null
+  actionLabel?: string | null
+  resourceKind?: string | null
+  resourceId?: string | null
+  createdAt?: Date | null
+}
+
+export type OperationMetadataFallback = {
+  resourceKind: string
+  resourceId: string | null
+}
+
+export function withOperationMetadata(
+  response: NextResponse,
+  logEntry: OperationLogEntry | null | undefined,
+  fallback: OperationMetadataFallback,
+): NextResponse {
+  if (!logEntry?.undoToken || !logEntry.id || !logEntry.commandId) return response
+  response.headers.set(
+    'x-om-operation',
+    serializeOperationMetadata({
+      id: logEntry.id,
+      undoToken: logEntry.undoToken,
+      commandId: logEntry.commandId,
+      actionLabel: logEntry.actionLabel ?? null,
+      resourceKind: logEntry.resourceKind ?? fallback.resourceKind,
+      resourceId: logEntry.resourceId ?? fallback.resourceId,
+      executedAt: logEntry.createdAt instanceof Date ? logEntry.createdAt.toISOString() : new Date().toISOString(),
+    }),
+  )
+  return response
+}

package/src/modules/messages/components/MessagesInboxPageClient.tsx

@@ -16,8 +16,8 @@ import { useAppEvent } from '@open-mercato/ui/backend/injection/useAppEvent'
 import { Archive, ChevronDown, FilePenLine, Inbox, Layers, Send } from 'lucide-react'
 import { getMessageUiComponentRegistry } from './utils/typeUiRegistry'
 import { DefaultMessageListItem } from './defaults/DefaultMessageListItem'
-
-type MessageFolder = 'inbox' | 'sent' | 'drafts' | 'archived' | 'all'
+import { toErrorMessage } from './message-detail/utils'
+import { useMessagesInboxBulkActions, type MessageFolder } from './useMessagesInboxBulkActions'
 
 type MessageListItem = {
   id: string
@@ -63,29 +63,6 @@ type UserListItem = {
   name?: string | null
 }
 
-function toErrorMessage(payload: unknown): string | null {
-  if (!payload) return null
-  if (typeof payload === 'string') return payload
-  if (Array.isArray(payload)) {
-    for (const item of payload) {
-      const nested = toErrorMessage(item)
-      if (nested) return nested
-    }
-    return null
-  }
-  if (typeof payload === 'object') {
-    const record = payload as Record<string, unknown>
-    return (
-      toErrorMessage(record.error)
-      ?? toErrorMessage(record.message)
-      ?? toErrorMessage(record.detail)
-      ?? toErrorMessage(record.details)
-      ?? null
-    )
-  }
-  return null
-}
-
 export function MessagesInboxPageClient() {
   const router = useRouter()
   const t = useT()
@@ -108,6 +85,12 @@ export function MessagesInboxPageClient() {
   const pageSize = 20
   const folderMenuRef = React.useRef<HTMLDivElement | null>(null)
   const messageUiRegistry = React.useMemo(() => getMessageUiComponentRegistry(), [])
+  const { bulkActions, selectionScopeKey, injectionContext, ConfirmDialogElement } = useMessagesInboxBulkActions<MessageListItem>({
+    folder,
+    page,
+    search,
+    filterValues,
+  })
 
   const listQuery = useQuery({
     queryKey: [
@@ -393,6 +376,8 @@ export function MessagesInboxPageClient() {
         title={t('messages.title', 'Messages')}
         columns={columns}
         data={rows}
+        bulkActions={bulkActions}
+        selectionScopeKey={selectionScopeKey}
         searchValue={search}
         onSearchChange={(value) => {
           setSearch(value)
@@ -409,6 +394,7 @@ export function MessagesInboxPageClient() {
           setFilterValues({})
           setPage(1)
         }}
+        injectionContext={injectionContext}
         isLoading={listQuery.isLoading || listQuery.isFetching}
         pagination={{
           page,
@@ -443,12 +429,14 @@ export function MessagesInboxPageClient() {
                     const Icon = option.icon
                     const isActive = option.id === folder
                     return (
-                      <button
+                      <Button
                         key={option.id}
                         type="button"
+                        variant="ghost"
+                        size="sm"
                         role="menuitemradio"
                         aria-checked={isActive}
-                        className={`flex w-full items-center gap-2 rounded px-2 py-1.5 text-left text-sm hover:bg-accent ${isActive ? 'bg-accent/60' : ''}`}
+                        className={`w-full justify-start h-auto px-2 py-1.5 text-sm font-normal ${isActive ? 'bg-accent/60' : ''}`}
                         onClick={() => {
                           setFolder(option.id)
                           setPage(1)
@@ -457,7 +445,7 @@ export function MessagesInboxPageClient() {
                       >
                         <Icon className="h-4 w-4" aria-hidden />
                         <span>{option.label}</span>
-                      </button>
+                      </Button>
                     )
                   })}
                 </div>
@@ -471,9 +459,9 @@ export function MessagesInboxPageClient() {
         onRowClick={(row) => {
           router.push(`/backend/messages/${row.id}`)
         }}
-        perspective={{ tableId: 'messages.inbox' }}
         embedded
       />
+      {ConfirmDialogElement}
     </div>
   )
 }