@open-mercato/core 0.6.7-develop.6553.1.2ec7246e04 → 0.6.7-develop.6566.1.15385fa179

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

@@ -104,7 +104,9 @@
   "customer_accounts.admin.flash.deleted": "User deleted",
   "customer_accounts.admin.inactive": "Inactive",
   "customer_accounts.admin.portalFeatures.addresses.manage": "Manage addresses",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Allows adding, editing, and removing addresses",
   "customer_accounts.admin.portalFeatures.addresses.view": "View addresses",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Allows viewing saved shipping and billing addresses",
   "customer_accounts.admin.portalFeatures.groups.addresses": "Addresses",
   "customer_accounts.admin.portalFeatures.groups.invoices": "Invoices",
   "customer_accounts.admin.portalFeatures.groups.orders": "Orders",
@@ -112,15 +114,25 @@
   "customer_accounts.admin.portalFeatures.groups.quotes": "Quotes",
   "customer_accounts.admin.portalFeatures.groups.users": "Users",
   "customer_accounts.admin.portalFeatures.invoices.view": "View invoices",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Allows viewing invoices and payment history",
   "customer_accounts.admin.portalFeatures.orders.create": "Create orders",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Allows placing new orders through the portal",
   "customer_accounts.admin.portalFeatures.orders.view": "View orders",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Allows viewing order history and order details",
   "customer_accounts.admin.portalFeatures.profile.edit": "Edit profile",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Allows editing display name and other profile settings",
   "customer_accounts.admin.portalFeatures.profile.view": "View profile",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Allows viewing own profile information and account details",
   "customer_accounts.admin.portalFeatures.quotes.request": "Request quotes",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Allows requesting new quotes from the company",
   "customer_accounts.admin.portalFeatures.quotes.view": "View quotes",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Allows viewing received quotes and their details",
   "customer_accounts.admin.portalFeatures.users.invite": "Invite team members",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Allows sending portal invitations to new team members",
   "customer_accounts.admin.portalFeatures.users.manage": "Manage team members",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Allows editing roles and removing team members",
   "customer_accounts.admin.portalFeatures.users.view": "View team members",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Allows viewing other team members in the organization",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",

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

@@ -103,24 +103,36 @@
   "customer_accounts.admin.flash.deactivated": "User deactivated",
   "customer_accounts.admin.flash.deleted": "User deleted",
   "customer_accounts.admin.inactive": "Inactive",
-  "customer_accounts.admin.portalFeatures.addresses.manage": "Manage addresses",
-  "customer_accounts.admin.portalFeatures.addresses.view": "View addresses",
-  "customer_accounts.admin.portalFeatures.groups.addresses": "Addresses",
-  "customer_accounts.admin.portalFeatures.groups.invoices": "Invoices",
-  "customer_accounts.admin.portalFeatures.groups.orders": "Orders",
-  "customer_accounts.admin.portalFeatures.groups.profile": "Profile",
-  "customer_accounts.admin.portalFeatures.groups.quotes": "Quotes",
-  "customer_accounts.admin.portalFeatures.groups.users": "Users",
-  "customer_accounts.admin.portalFeatures.invoices.view": "View invoices",
-  "customer_accounts.admin.portalFeatures.orders.create": "Create orders",
-  "customer_accounts.admin.portalFeatures.orders.view": "View orders",
-  "customer_accounts.admin.portalFeatures.profile.edit": "Edit profile",
-  "customer_accounts.admin.portalFeatures.profile.view": "View profile",
-  "customer_accounts.admin.portalFeatures.quotes.request": "Request quotes",
-  "customer_accounts.admin.portalFeatures.quotes.view": "View quotes",
-  "customer_accounts.admin.portalFeatures.users.invite": "Invite team members",
-  "customer_accounts.admin.portalFeatures.users.manage": "Manage team members",
-  "customer_accounts.admin.portalFeatures.users.view": "View team members",
+  "customer_accounts.admin.portalFeatures.addresses.manage": "Gestionar direcciones",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Permite añadir, editar y eliminar direcciones",
+  "customer_accounts.admin.portalFeatures.addresses.view": "Ver direcciones",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Permite ver las direcciones de envío y facturación guardadas",
+  "customer_accounts.admin.portalFeatures.groups.addresses": "Direcciones",
+  "customer_accounts.admin.portalFeatures.groups.invoices": "Facturas",
+  "customer_accounts.admin.portalFeatures.groups.orders": "Pedidos",
+  "customer_accounts.admin.portalFeatures.groups.profile": "Perfil",
+  "customer_accounts.admin.portalFeatures.groups.quotes": "Presupuestos",
+  "customer_accounts.admin.portalFeatures.groups.users": "Usuarios",
+  "customer_accounts.admin.portalFeatures.invoices.view": "Ver facturas",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Permite ver las facturas y el historial de pagos",
+  "customer_accounts.admin.portalFeatures.orders.create": "Crear pedidos",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Permite realizar nuevos pedidos a través del portal",
+  "customer_accounts.admin.portalFeatures.orders.view": "Ver pedidos",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Permite ver el historial y los detalles de los pedidos",
+  "customer_accounts.admin.portalFeatures.profile.edit": "Editar perfil",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Permite editar el nombre visible y otros ajustes del perfil",
+  "customer_accounts.admin.portalFeatures.profile.view": "Ver perfil",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Permite ver la información del propio perfil y los detalles de la cuenta",
+  "customer_accounts.admin.portalFeatures.quotes.request": "Solicitar presupuestos",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Permite solicitar nuevos presupuestos a la empresa",
+  "customer_accounts.admin.portalFeatures.quotes.view": "Ver presupuestos",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Permite ver los presupuestos recibidos y sus detalles",
+  "customer_accounts.admin.portalFeatures.users.invite": "Invitar a miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Permite enviar invitaciones al portal a nuevos miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.manage": "Gestionar miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Permite editar roles y eliminar miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.view": "Ver miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Permite ver a otros miembros del equipo en la organización",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",
@@ -162,10 +174,10 @@
   "customer_accounts.admin.roleDetail.fields.name": "Name",
   "customer_accounts.admin.roleDetail.flash.saved": "Role updated",
   "customer_accounts.admin.roleDetail.loading": "Loading role...",
-  "customer_accounts.admin.roleDetail.sections.details": "Role Details",
-  "customer_accounts.admin.roleDetail.sections.options": "Options",
-  "customer_accounts.admin.roleDetail.sections.permissions": "Portal Permissions",
-  "customer_accounts.admin.roleDetail.selectAll": "Select all",
+  "customer_accounts.admin.roleDetail.sections.details": "Detalles del rol",
+  "customer_accounts.admin.roleDetail.sections.options": "Opciones",
+  "customer_accounts.admin.roleDetail.sections.permissions": "Permisos del portal",
+  "customer_accounts.admin.roleDetail.selectAll": "Seleccionar todo",
   "customer_accounts.admin.roles": "Roles",
   "customer_accounts.admin.roles.actions.create": "Create Role",
   "customer_accounts.admin.roles.actions.delete": "Delete",

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

@@ -103,24 +103,36 @@
   "customer_accounts.admin.flash.deactivated": "Użytkownik dezaktywowany",
   "customer_accounts.admin.flash.deleted": "Użytkownik usunięty",
   "customer_accounts.admin.inactive": "Nieaktywny",
-  "customer_accounts.admin.portalFeatures.addresses.manage": "Manage addresses",
-  "customer_accounts.admin.portalFeatures.addresses.view": "View addresses",
-  "customer_accounts.admin.portalFeatures.groups.addresses": "Addresses",
-  "customer_accounts.admin.portalFeatures.groups.invoices": "Invoices",
-  "customer_accounts.admin.portalFeatures.groups.orders": "Orders",
-  "customer_accounts.admin.portalFeatures.groups.profile": "Profile",
-  "customer_accounts.admin.portalFeatures.groups.quotes": "Quotes",
-  "customer_accounts.admin.portalFeatures.groups.users": "Users",
-  "customer_accounts.admin.portalFeatures.invoices.view": "View invoices",
-  "customer_accounts.admin.portalFeatures.orders.create": "Create orders",
-  "customer_accounts.admin.portalFeatures.orders.view": "View orders",
-  "customer_accounts.admin.portalFeatures.profile.edit": "Edit profile",
-  "customer_accounts.admin.portalFeatures.profile.view": "View profile",
-  "customer_accounts.admin.portalFeatures.quotes.request": "Request quotes",
-  "customer_accounts.admin.portalFeatures.quotes.view": "View quotes",
-  "customer_accounts.admin.portalFeatures.users.invite": "Invite team members",
-  "customer_accounts.admin.portalFeatures.users.manage": "Manage team members",
-  "customer_accounts.admin.portalFeatures.users.view": "View team members",
+  "customer_accounts.admin.portalFeatures.addresses.manage": "Zarządzanie adresami",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Umożliwia dodawanie, edycję i usuwanie adresów",
+  "customer_accounts.admin.portalFeatures.addresses.view": "Wyświetlanie adresów",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Umożliwia przeglądanie zapisanych adresów wysyłki i rozliczeniowych",
+  "customer_accounts.admin.portalFeatures.groups.addresses": "Adresy",
+  "customer_accounts.admin.portalFeatures.groups.invoices": "Faktury",
+  "customer_accounts.admin.portalFeatures.groups.orders": "Zamówienia",
+  "customer_accounts.admin.portalFeatures.groups.profile": "Profil",
+  "customer_accounts.admin.portalFeatures.groups.quotes": "Oferty",
+  "customer_accounts.admin.portalFeatures.groups.users": "Użytkownicy",
+  "customer_accounts.admin.portalFeatures.invoices.view": "Wyświetlanie faktur",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Umożliwia przeglądanie faktur i historii płatności",
+  "customer_accounts.admin.portalFeatures.orders.create": "Tworzenie zamówień",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Umożliwia składanie nowych zamówień przez portal",
+  "customer_accounts.admin.portalFeatures.orders.view": "Wyświetlanie zamówień",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Umożliwia przeglądanie historii i szczegółów zamówień",
+  "customer_accounts.admin.portalFeatures.profile.edit": "Edycja profilu",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Umożliwia edycję nazwy wyświetlanej i innych ustawień profilu",
+  "customer_accounts.admin.portalFeatures.profile.view": "Wyświetlanie profilu",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Umożliwia przeglądanie własnych informacji profilowych i szczegółów konta",
+  "customer_accounts.admin.portalFeatures.quotes.request": "Prośba o oferty",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Umożliwia zamawianie nowych ofert od firmy",
+  "customer_accounts.admin.portalFeatures.quotes.view": "Wyświetlanie ofert",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Umożliwia przeglądanie otrzymanych ofert i ich szczegółów",
+  "customer_accounts.admin.portalFeatures.users.invite": "Zapraszanie członków zespołu",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Umożliwia wysyłanie zaproszeń do portalu nowym członkom zespołu",
+  "customer_accounts.admin.portalFeatures.users.manage": "Zarządzanie członkami zespołu",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Umożliwia edycję ról i usuwanie członków zespołu",
+  "customer_accounts.admin.portalFeatures.users.view": "Wyświetlanie członków zespołu",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Umożliwia przeglądanie innych członków zespołu w organizacji",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",
@@ -163,9 +175,9 @@
   "customer_accounts.admin.roleDetail.flash.saved": "Rola zaktualizowana",
   "customer_accounts.admin.roleDetail.loading": "Ładowanie roli...",
   "customer_accounts.admin.roleDetail.sections.details": "Szczegóły roli",
-  "customer_accounts.admin.roleDetail.sections.options": "Options",
+  "customer_accounts.admin.roleDetail.sections.options": "Opcje",
   "customer_accounts.admin.roleDetail.sections.permissions": "Uprawnienia portalu",
-  "customer_accounts.admin.roleDetail.selectAll": "Select all",
+  "customer_accounts.admin.roleDetail.selectAll": "Zaznacz wszystko",
   "customer_accounts.admin.roles": "Role",
   "customer_accounts.admin.roles.actions.create": "Utwórz rolę",
   "customer_accounts.admin.roles.actions.delete": "Usuń",

package/src/modules/customers/api/companies/[id]/people/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -116,7 +116,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
       decryptionScope,
     )
     if (!company) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.company_not_found', 'Company not found') })
+      throw notFound(translate('customers.errors.company_not_found', 'Company not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: company.organizationId })) {

package/src/modules/customers/api/deals/[id]/companies/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -98,7 +98,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
       decryptionScope,
     )
     if (!deal) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.deal_not_found', 'Deal not found') })
+      throw notFound(translate('customers.errors.deal_not_found', 'Deal not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: deal.organizationId })) {

package/src/modules/customers/api/deals/[id]/people/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -98,7 +98,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
       decryptionScope,
     )
     if (!deal) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.deal_not_found', 'Deal not found') })
+      throw notFound(translate('customers.errors.deal_not_found', 'Deal not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: deal.organizationId })) {

package/src/modules/customers/api/dictionaries/[kind]/[id]/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import { serializeOperationMetadata } from '@open-mercato/shared/lib/commands/operationMetadata'
 import type { CommandExecuteResult } from '@open-mercato/shared/lib/commands/types'
@@ -86,7 +86,7 @@ export async function PATCH(req: Request, ctx: { params?: { kind?: string; id?:
     } catch (err) {
       if (isCrudHttpError(err)) {
         if (err.status === 404) {
-          throw new CrudHttpError(404, { error: routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found') })
+          throw notFound(routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found'))
         }
         if (err.status === 409) {
           if ((err.body as Record<string, unknown> | undefined)?.code === 'role_type_in_use') {
@@ -123,7 +123,7 @@ export async function PATCH(req: Request, ctx: { params?: { kind?: string; id?:
       },
     )
     if (!entry) {
-      throw new CrudHttpError(404, { error: routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found') })
+      throw notFound(routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found'))
     }
 
     if (result.changed) {
@@ -218,7 +218,7 @@ export async function DELETE(req: Request, ctx: { params?: { kind?: string; id?:
       })) as CommandExecuteResult<{ entryId: string }>
     } catch (err) {
       if (isCrudHttpError(err) && err.status === 404) {
-        throw new CrudHttpError(404, { error: routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found') })
+        throw notFound(routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found'))
       }
       if (isCrudHttpError(err) && err.status === 409 && (err.body as Record<string, unknown> | undefined)?.code === 'role_type_in_use') {
         const usageCount = Number((err.body as Record<string, unknown> | undefined)?.usageCount ?? 0)

package/src/modules/customers/api/entity-roles-factory.ts

@@ -4,7 +4,7 @@ import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'
 import { validateCrudMutationGuard, runCrudMutationGuardAfterSuccess } from '@open-mercato/shared/lib/crud/mutation-guard'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import { isOrganizationReadAccessAllowed } from '@open-mercato/core/modules/directory/utils/organizationScopeGuard'
@@ -130,7 +130,7 @@ async function resolveEntityRouteScope(
     { tenantId: auth.tenantId, organizationId: scope?.selectedId ?? auth.orgId ?? null },
   )
   if (!entity || entity.tenantId !== auth.tenantId) {
-    throw new CrudHttpError(404, { error: translate('customers.errors.customer_not_found', 'Customer not found') })
+    throw notFound(translate('customers.errors.customer_not_found', 'Customer not found'))
   }
   ensureRouteOrganizationAccess(entity.organizationId, scope, auth, translate)
   return {
@@ -162,7 +162,7 @@ async function resolveRoleRouteScope(
     role.entityType !== entityType ||
     role.entityId !== entityId
   ) {
-    throw new CrudHttpError(404, { error: translate('customers.errors.role_not_found', 'Role not found') })
+    throw notFound(translate('customers.errors.role_not_found', 'Role not found'))
   }
   ensureRouteOrganizationAccess(role.organizationId, scope, auth, translate)
   return {

package/src/modules/customers/api/labels/assign/route.ts

@@ -4,7 +4,7 @@ import { labelAssignCommandSchema, labelAssignmentSchema, type LabelAssignComman
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
@@ -80,7 +80,7 @@ export async function POST(req: Request) {
       { tenantId: auth.tenantId, organizationId },
     )
     if (!targetEntity) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.entity_not_found', 'Entity not found') })
+      throw notFound(translate('customers.errors.entity_not_found', 'Entity not found'))
     }
     const entityKind = targetEntity.kind === 'person' || targetEntity.kind === 'company' ? targetEntity.kind : null
     const resourceKind = resolveResourceKind(entityKind)

package/src/modules/customers/api/labels/unassign/route.ts

@@ -4,7 +4,7 @@ import { labelUnassignCommandSchema, labelAssignmentSchema, type LabelUnassignCo
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
@@ -80,7 +80,7 @@ export async function POST(req: Request) {
       { tenantId: auth.tenantId, organizationId },
     )
     if (!targetEntity) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.entity_not_found', 'Entity not found') })
+      throw notFound(translate('customers.errors.entity_not_found', 'Entity not found'))
     }
     const entityKind = targetEntity.kind === 'person' || targetEntity.kind === 'company' ? targetEntity.kind : null
     const resourceKind = resolveResourceKind(entityKind)

package/src/modules/customers/api/people/[id]/companies/[linkId]/route.ts

@@ -1,6 +1,6 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import {
   runCrudMutationGuardAfterSuccess,
   validateCrudMutationGuard,
@@ -147,9 +147,7 @@ export async function PATCH(req: Request, ctx: { params?: { id?: string; linkId?
       selectedOrganizationId,
     )
     if (!resolvedLinkId) {
-      throw new CrudHttpError(404, {
-        error: translate('customers.errors.person_company_link_not_found', 'Person-company link not found'),
-      })
+      throw notFound(translate('customers.errors.person_company_link_not_found', 'Person-company link not found'))
     }
 
     const commandInput = personCompanyLinkUpdateSchema.parse({
@@ -265,9 +263,7 @@ export async function DELETE(req: Request, ctx: { params?: { id?: string; linkId
       selectedOrganizationId,
     )
     if (!resolvedLinkId) {
-      throw new CrudHttpError(404, {
-        error: translate('customers.errors.person_company_link_not_found', 'Person-company link not found'),
-      })
+      throw notFound(translate('customers.errors.person_company_link_not_found', 'Person-company link not found'))
     }
 
     const commandInput = personCompanyLinkDeleteSchema.parse({

package/src/modules/customers/api/people/[id]/companies/context.ts

@@ -1,5 +1,5 @@
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import {
@@ -35,7 +35,7 @@ export async function loadPersonContext(req: Request, personId: string) {
   )
 
   if (!person) {
-    throw new CrudHttpError(404, { error: translate('customers.errors.person_not_found', 'Person not found') })
+    throw notFound(translate('customers.errors.person_not_found', 'Person not found'))
   }
 
   if (!isOrganizationReadAccessAllowed({ scope, auth: authenticatedAuth, organizationId: person.organizationId })) {
@@ -53,7 +53,7 @@ export async function loadPersonContext(req: Request, personId: string) {
     },
   )
   if (!profile) {
-    throw new CrudHttpError(404, { error: translate('customers.errors.person_profile_not_found', 'Person profile not found') })
+    throw notFound(translate('customers.errors.person_profile_not_found', 'Person profile not found'))
   }
 
   return {

package/src/modules/customers/api/people/[id]/companies/enriched/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -174,7 +174,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
     const decryptionScope = { tenantId: auth.tenantId, organizationId: auth.orgId ?? null }
     const person = await findOneWithDecryption(em, CustomerEntity, { id, kind: 'person', tenantId: auth.tenantId, deletedAt: null }, {}, decryptionScope)
     if (!person) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.person_not_found', 'Person not found') })
+      throw notFound(translate('customers.errors.person_not_found', 'Person not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: person.organizationId })) {

package/src/modules/customers/api/todos/route.ts

@@ -7,7 +7,7 @@ import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import {
@@ -218,7 +218,7 @@ async function resolveCanonicalTodoTargetId(
 
   const legacyLink = await findLegacyTodoLink(em, target, tenantId)
   if (!legacyLink) {
-    if (!target.todoId) throw new CrudHttpError(404, { error: 'Todo not found' })
+    if (!target.todoId) throw notFound('Todo not found')
     return target.todoId
   }
 

package/src/modules/customers/commands/addresses.ts

@@ -14,7 +14,7 @@ import {
   resolveParentResourceKind,
 } from './shared'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { CrudIndexerConfig, CrudEventsConfig } from '@open-mercato/shared/lib/crud/types'
 import { E } from '#generated/entities.ids.generated'
 import { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'
@@ -288,7 +288,7 @@ const updateAddressCommand: CommandHandler<AddressUpdateInput, { addressId: stri
     const parsed = addressUpdateSchema.parse(rawInput)
     const em = (ctx.container.resolve('em') as EntityManager).fork()
     const address = await em.findOne(CustomerAddress, { id: parsed.id })
-    if (!address) throw new CrudHttpError(404, { error: 'Address not found' })
+    if (!address) throw notFound('Address not found')
     ensureTenantScope(ctx, address.tenantId)
     ensureOrganizationScope(ctx, address.organizationId)
 
@@ -477,7 +477,7 @@ const deleteAddressCommand: CommandHandler<{ body?: Record<string, unknown>; que
       const id = requireId(input, 'Address id required')
       const em = (ctx.container.resolve('em') as EntityManager).fork()
       const address = await em.findOne(CustomerAddress, { id })
-      if (!address) throw new CrudHttpError(404, { error: 'Address not found' })
+      if (!address) throw notFound('Address not found')
       ensureTenantScope(ctx, address.tenantId)
       ensureOrganizationScope(ctx, address.organizationId)
       em.remove(address)

package/src/modules/customers/commands/comments.ts

@@ -15,7 +15,7 @@ import {
   resolveParentResourceKind,
 } from './shared'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { CrudIndexerConfig, CrudEventsConfig } from '@open-mercato/shared/lib/crud/types'
 import { E } from '#generated/entities.ids.generated'
 import { makeCreateRedo } from '@open-mercato/shared/lib/commands/redo'
@@ -196,7 +196,7 @@ const updateCommentCommand: CommandHandler<CommentUpdateInput, { commentId: stri
     const parsed = commentUpdateSchema.parse(rawInput)
     const em = (ctx.container.resolve('em') as EntityManager).fork()
     const comment = await em.findOne(CustomerComment, { id: parsed.id })
-    if (!comment) throw new CrudHttpError(404, { error: 'Comment not found' })
+    if (!comment) throw notFound('Comment not found')
     ensureTenantScope(ctx, comment.tenantId)
     ensureOrganizationScope(ctx, comment.organizationId)
 
@@ -332,7 +332,7 @@ const deleteCommentCommand: CommandHandler<{ body?: Record<string, unknown>; que
       const id = requireId(input, 'Comment id required')
       const em = (ctx.container.resolve('em') as EntityManager).fork()
       const comment = await em.findOne(CustomerComment, { id })
-      if (!comment) throw new CrudHttpError(404, { error: 'Comment not found' })
+      if (!comment) throw notFound('Comment not found')
       ensureTenantScope(ctx, comment.tenantId)
       ensureOrganizationScope(ctx, comment.organizationId)
       em.remove(comment)

package/src/modules/customers/commands/companies.ts

@@ -11,7 +11,7 @@ import {
 import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { CommandRuntimeContext } from '@open-mercato/shared/lib/commands'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import {
   CustomerAddress,
   CustomerComment,
@@ -738,7 +738,7 @@ const updateCompanyCommand: CommandHandler<CompanyUpdateInput, { entityId: strin
     ensureTenantScope(ctx, record.tenantId)
     ensureOrganizationScope(ctx, record.organizationId)
     const profile = await em.findOne(CustomerCompanyProfile, { entity: record })
-    if (!profile) throw new CrudHttpError(404, { error: 'Company profile not found' })
+    if (!profile) throw notFound('Company profile not found')
 
     await withAtomicFlush(em, [
       () => {

package/src/modules/customers/commands/deals.ts

@@ -40,7 +40,7 @@ import {
   buildCustomFieldResetMap,
   type CustomFieldChangeSet,
 } from '@open-mercato/shared/lib/commands/customFieldSnapshots'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { CrudIndexerConfig, CrudEventsConfig } from '@open-mercato/shared/lib/crud/types'
 import { E } from '#generated/entities.ids.generated'
 import { findWithDecryption, findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
@@ -625,7 +625,7 @@ const updateDealCommand: CommandHandler<DealUpdateInput, { dealId: string }> = {
     const em = (ctx.container.resolve('em') as EntityManager).fork()
     const deal = await findOneWithDecryption(em, CustomerDeal, { id: parsed.id, deletedAt: null })
     const record = deal ?? null
-    if (!record) throw new CrudHttpError(404, { error: 'Deal not found' })
+    if (!record) throw notFound('Deal not found')
     ensureTenantScope(ctx, record.tenantId)
     ensureOrganizationScope(ctx, record.organizationId)
 
@@ -936,7 +936,7 @@ const deleteDealCommand: CommandHandler<{ body?: Record<string, unknown>; query?
       const em = (ctx.container.resolve('em') as EntityManager).fork()
       const deal = await findOneWithDecryption(em, CustomerDeal, { id, deletedAt: null })
       const record = deal ?? null
-      if (!record) throw new CrudHttpError(404, { error: 'Deal not found' })
+      if (!record) throw notFound('Deal not found')
       ensureTenantScope(ctx, record.tenantId)
       ensureOrganizationScope(ctx, record.organizationId)
       await deleteDealStageTransitions(em, record)

package/src/modules/customers/commands/dictionaries.ts

@@ -1,7 +1,7 @@
 import { registerCommand, type CommandHandler } from '@open-mercato/shared/lib/commands'
 import type { CommandRuntimeContext } from '@open-mercato/shared/lib/commands'
 import { buildChanges } from '@open-mercato/shared/lib/commands/helpers'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import { invalidateDictionaryCache } from '../api/dictionaries/cache'
@@ -425,7 +425,7 @@ const updateDictionaryEntryCommand: CommandHandler<CustomerDictionaryEntryUpdate
       },
     )
     if (!entry || entry.organizationId !== parsed.organizationId || entry.tenantId !== parsed.tenantId || entry.kind !== parsed.kind) {
-      throw new CrudHttpError(404, { error: 'Dictionary entry not found' })
+      throw notFound('Dictionary entry not found')
     }
 
     let changed = false
@@ -611,7 +611,7 @@ const deleteDictionaryEntryCommand: CommandHandler<CustomerDictionaryEntryDelete
       },
     )
     if (!entry || entry.organizationId !== parsed.organizationId || entry.tenantId !== parsed.tenantId || entry.kind !== parsed.kind) {
-      throw new CrudHttpError(404, { error: 'Dictionary entry not found' })
+      throw notFound('Dictionary entry not found')
     }
     if (entry.kind === 'person_company_role') {
       const usage = await loadRoleTypeUsage(em, {

package/src/modules/customers/commands/entity-roles.ts

@@ -2,7 +2,7 @@ import { registerCommand } from '@open-mercato/shared/lib/commands'
 import type { CommandHandler } from '@open-mercato/shared/lib/commands'
 import type { CrudEventsConfig } from '@open-mercato/shared/lib/crud/types'
 import { emitCrudSideEffects, emitCrudUndoSideEffects } from '@open-mercato/shared/lib/commands/helpers'
-import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
@@ -345,7 +345,7 @@ const updateEntityRoleCommand: CommandHandler<EntityRoleUpdateInput, { roleId: s
       { tenantId: parsed.tenantId, organizationId: parsed.organizationId },
     )
     if (!role) {
-      throw new CrudHttpError(404, { error: 'Role not found' })
+      throw notFound('Role not found')
     }
 
     role.userId = parsed.userId
@@ -448,7 +448,7 @@ const deleteEntityRoleCommand: CommandHandler<EntityRoleDeleteInput, { roleId: s
       { tenantId: parsed.tenantId, organizationId: parsed.organizationId },
     )
     if (!role) {
-      throw new CrudHttpError(404, { error: 'Role not found' })
+      throw notFound('Role not found')
     }
 
     role.deletedAt = new Date()