@open-mercato/core 0.6.6-develop.6465.1.019f0fb26f → 0.6.6-develop.6472.1.1673e7e66b

package/src/modules/customers/api/dashboard/widgets/new-customers/route.ts

@@ -6,6 +6,9 @@ import { CustomerEntity, type CustomerEntityKind } from '../../../../data/entiti
 import { resolveWidgetScope, type WidgetScopeContext } from '../utils'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import type { FilterQuery } from '@mikro-orm/core'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const querySchema = z.object({
   limit: z.coerce.number().min(1).max(20).default(5),
@@ -83,7 +86,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('customers.widgets.newCustomers failed', err)
+    logger.error('customers.widgets.newCustomers failed', { err })
     return NextResponse.json(
       { error: translate('customers.widgets.newCustomers.error', 'Failed to load recently added customers') },
       { status: 500 }

package/src/modules/customers/api/dashboard/widgets/new-deals/route.ts

@@ -6,6 +6,9 @@ import { CustomerDeal } from '../../../../data/entities'
 import { resolveWidgetScope, type WidgetScopeContext } from '../utils'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import type { FilterQuery } from '@mikro-orm/core'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const querySchema = z.object({
   limit: z.coerce.number().min(1).max(20).default(5),
@@ -78,7 +81,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('customers.widgets.newDeals failed', err)
+    logger.error('customers.widgets.newDeals failed', { err })
     return NextResponse.json(
       { error: translate('customers.widgets.newDeals.error', 'Failed to load recently created deals') },
       { status: 500 },

package/src/modules/customers/api/dashboard/widgets/next-interactions/route.ts

@@ -7,6 +7,9 @@ import type { FilterQuery } from '@mikro-orm/core'
 import { resolveWidgetScope, type WidgetScopeContext } from '../utils'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const querySchema = z.object({
   limit: z.coerce.number().min(1).max(20).default(5),
@@ -92,7 +95,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('customers.widgets.nextInteractions failed', err)
+    logger.error('customers.widgets.nextInteractions failed', { err })
     return NextResponse.json(
       { error: translate('customers.widgets.nextInteractions.error', 'Failed to load upcoming interactions') },
       { status: 500 }

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

@@ -10,6 +10,9 @@ import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import { isOrganizationReadAccessAllowed } from '@open-mercato/core/modules/directory/utils/organizationScopeGuard'
 import { CustomerCompanyProfile, CustomerDeal, CustomerDealCompanyLink, CustomerEntity } from '../../../../data/entities'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const paramsSchema = z.object({
   id: z.string().uuid(),
@@ -164,7 +167,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
     if (isCrudHttpError(error)) {
       return NextResponse.json(error.body, { status: error.status })
     }
-    console.error('[customers.deals.companies.GET]', error)
+    logger.error('customers.deals.companies.GET', { err: error })
     return NextResponse.json({ error: translate('customers.errors.deal_companies_load_failed', 'Failed to load linked companies') }, { status: 500 })
   }
 }

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

@@ -10,6 +10,9 @@ import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import { isOrganizationReadAccessAllowed } from '@open-mercato/core/modules/directory/utils/organizationScopeGuard'
 import { CustomerDeal, CustomerDealPersonLink, CustomerEntity } from '../../../../data/entities'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const paramsSchema = z.object({
   id: z.string().uuid(),
@@ -143,7 +146,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
     if (isCrudHttpError(error)) {
       return NextResponse.json(error.body, { status: error.status })
     }
-    console.error('[customers.deals.people.GET]', error)
+    logger.error('customers.deals.people.GET', { err: error })
     return NextResponse.json({ error: translate('customers.errors.deal_people_load_failed', 'Failed to load linked people') }, { status: 500 })
   }
 }

package/src/modules/customers/api/deals/aggregate/route.ts

@@ -14,6 +14,9 @@ import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { fetchStuckDealIds } from '../../../lib/stuckDeals'
 import { findMatchingEntityIdsBySearchTokensAcrossSources } from '../../utils'
 import { E } from '#generated/entities.ids.generated'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   GET: { requireAuth: true, requireFeatures: ['customers.deals.view'] },
@@ -379,7 +382,7 @@ export async function GET(req: Request) {
         // Swallow — partial totals are still useful and we'll fall back to currency-native
         // sums. Logging at warn level so operators can correlate missing-rate disclosures in
         // the UI (`convertedAll: false` / `missingRateCurrencies`) with the underlying error.
-        console.warn('[customers.deals.aggregate] exchange-rate lookup failed; falling back to per-currency totals', err)
+        logger.warn('exchange-rate lookup failed; falling back to per-currency totals', { component: 'deals.aggregate', err })
       }
     }
 

package/src/modules/customers/api/deals/bulk-update-owner/route.ts

@@ -17,6 +17,9 @@ import {
   dealsBulkUpdateOwnerSchema as requestSchema,
   dealsBulkUpdateResponseSchema as responseSchema,
 } from '../../../data/validators'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['customers.deals.manage'] },
@@ -76,7 +79,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
       mutationPayload: { ids, ownerUserId: parsed.data.ownerUserId },
     })
   } catch (guardError) {
-    console.warn('[customers.deals.bulk-update-owner] mutation-guard skipped', guardError)
+    logger.warn('mutation-guard skipped', { component: 'deals.bulk-update-owner', err: guardError })
     guardResult = null
   }
   if (guardResult && !guardResult.ok) {
@@ -87,7 +90,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
   try {
     progressService = container.resolve('progressService') as ProgressService
   } catch (resolveError) {
-    console.error('[customers.deals.bulk-update-owner] progressService resolve failed', resolveError)
+    logger.error('progressService resolve failed', { component: 'deals.bulk-update-owner', err: resolveError })
     throw new Error(
       `progressService resolve failed: ${resolveError instanceof Error ? resolveError.message : String(resolveError)}`,
     )
@@ -121,7 +124,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
       },
     )
   } catch (createError) {
-    console.error('[customers.deals.bulk-update-owner] progressService.createJob failed', createError)
+    logger.error('progressService.createJob failed', { component: 'deals.bulk-update-owner', err: createError })
     throw new Error(
       `progressService.createJob failed: ${createError instanceof Error ? createError.message : String(createError)}`,
     )
@@ -159,7 +162,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
         },
       )
       .catch((failErr) => {
-        console.warn('[customers.deals.bulk-update-owner] failed to mark progress job as failed', failErr)
+        logger.warn('failed to mark progress job as failed', { component: 'deals.bulk-update-owner', err: failErr })
       })
     throw error
   }
@@ -200,7 +203,7 @@ export async function POST(req: Request) {
   try {
     return await postImpl(req, translate)
   } catch (error) {
-    console.error('[customers.deals.bulk-update-owner] route failed', error)
+    logger.error('route failed', { component: 'deals.bulk-update-owner', err: error })
     return NextResponse.json(
       responseSchema.parse({
         ok: false,

package/src/modules/customers/api/deals/bulk-update-stage/route.ts

@@ -17,6 +17,9 @@ import {
   dealsBulkUpdateStageSchema as requestSchema,
   dealsBulkUpdateResponseSchema as responseSchema,
 } from '../../../data/validators'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['customers.deals.manage'] },
@@ -80,7 +83,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
       mutationPayload: { ids, pipelineStageId: parsed.data.pipelineStageId },
     })
   } catch (guardError) {
-    console.warn('[customers.deals.bulk-update-stage] mutation-guard skipped', guardError)
+    logger.warn('mutation-guard skipped', { component: 'deals.bulk-update-stage', err: guardError })
     guardResult = null
   }
   if (guardResult && !guardResult.ok) {
@@ -91,7 +94,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
   try {
     progressService = container.resolve('progressService') as ProgressService
   } catch (resolveError) {
-    console.error('[customers.deals.bulk-update-stage] progressService resolve failed', resolveError)
+    logger.error('progressService resolve failed', { component: 'deals.bulk-update-stage', err: resolveError })
     throw new Error(
       `progressService resolve failed: ${resolveError instanceof Error ? resolveError.message : String(resolveError)}`,
     )
@@ -125,7 +128,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
       },
     )
   } catch (createError) {
-    console.error('[customers.deals.bulk-update-stage] progressService.createJob failed', createError)
+    logger.error('progressService.createJob failed', { component: 'deals.bulk-update-stage', err: createError })
     throw new Error(
       `progressService.createJob failed: ${createError instanceof Error ? createError.message : String(createError)}`,
     )
@@ -164,7 +167,7 @@ async function postImpl(req: Request, translate: TranslateWithFallbackFn): Promi
         },
       )
       .catch((failErr) => {
-        console.warn('[customers.deals.bulk-update-stage] failed to mark progress job as failed', failErr)
+        logger.warn('failed to mark progress job as failed', { component: 'deals.bulk-update-stage', err: failErr })
       })
     throw error
   }
@@ -212,7 +215,7 @@ export async function POST(req: Request) {
   try {
     return await postImpl(req, translate)
   } catch (error) {
-    console.error('[customers.deals.bulk-update-stage] route failed', error)
+    logger.error('route failed', { component: 'deals.bulk-update-stage', err: error })
     return NextResponse.json(
       responseSchema.parse({
         ok: false,

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

@@ -23,6 +23,9 @@ import { isTenantDataEncryptionEnabled } from '@open-mercato/shared/lib/encrypti
 import { escapeLikePattern } from '@open-mercato/shared/lib/db/escapeLikePattern'
 import { consumeAdvancedFilterState, mergeAdvancedFilterTree } from '@open-mercato/shared/lib/crud/advanced-filter-integration'
 import { fetchStuckDealIds } from '../../lib/stuckDeals'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const rawBodySchema = z.object({}).passthrough()
 
@@ -653,7 +656,7 @@ const crud = makeCrudRoute<unknown, unknown, DealListQuery>({
         // people/companies labels (cards just lose their company pill). Tag every item with
         // `_associations: { ok: false }` so a future surface can render a degraded-state hint
         // instead of silently showing cards without company badges.
-        console.warn('[customers.deals] failed to decorate items with person/company links', err)
+        logger.warn('failed to decorate items with person/company links', { component: 'deals', err })
         payload.items = items.map((item: unknown) => {
           if (!item || typeof item !== 'object') return item
           return {

package/src/modules/customers/api/deals/summary/route.ts

@@ -17,6 +17,9 @@ import {
   type CurrencySum,
   type Delta,
 } from '../../../lib/dealsMetrics'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   GET: { requireAuth: true, requireFeatures: ['customers.deals.view'] },
@@ -366,7 +369,7 @@ export async function GET(req: Request) {
           options: { maxDaysBack: 60, autoFetch: false },
         })
       } catch (err) {
-        console.warn('[customers.deals.summary] exchange-rate lookup failed; falling back to per-currency totals', err)
+        logger.warn('exchange-rate lookup failed; falling back to per-currency totals', { component: 'deals.summary', err })
       }
     }
   }

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

@@ -15,6 +15,9 @@ import {
   runCrudMutationGuardAfterSuccess,
   validateCrudMutationGuard,
 } from '@open-mercato/shared/lib/crud/mutation-guard'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const paramsSchema = z.object({
   id: z.string().uuid(),
@@ -173,7 +176,7 @@ export async function PATCH(req: Request, ctx: { params?: { kind?: string; id?:
       return NextResponse.json(err.body, { status: err.status })
     }
     const { translate } = await resolveTranslations()
-    console.error('customers.dictionaries.update failed', err)
+    logger.error('customers.dictionaries.update failed', { err })
     return NextResponse.json({ error: translate('customers.errors.lookup_failed', 'Failed to save dictionary entry') }, { status: 400 })
   }
 }
@@ -274,7 +277,7 @@ export async function DELETE(req: Request, ctx: { params?: { kind?: string; id?:
       return NextResponse.json(err.body, { status: err.status })
     }
     const { translate } = await resolveTranslations()
-    console.error('customers.dictionaries.delete failed', err)
+    logger.error('customers.dictionaries.delete failed', { err })
     return NextResponse.json({ error: translate('customers.errors.lookup_failed', 'Failed to delete dictionary entry') }, { status: 400 })
   }
 }

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

@@ -21,6 +21,9 @@ import {
 } from '@open-mercato/shared/lib/crud/mutation-guard'
 import { findWithDecryption, findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const colorSchema = z.string().trim().regex(/^#([0-9A-Fa-f]{6})$/, 'Invalid color hex')
 const iconSchema = z.string().trim().min(1).max(48)
@@ -156,7 +159,7 @@ export async function GET(req: Request, ctx: { params?: { kind?: string } }) {
           tags,
         })
       } catch (err) {
-        console.warn('[customers.dictionaries.cache] Failed to set cache entry', err)
+        logger.warn('Failed to set cache entry', { component: 'dictionaries.cache', err })
       }
     }
 
@@ -166,7 +169,7 @@ export async function GET(req: Request, ctx: { params?: { kind?: string } }) {
       return NextResponse.json(err.body, { status: err.status })
     }
     const { translate } = await resolveTranslations()
-    console.error('customers.dictionaries.list failed', err)
+    logger.error('customers.dictionaries.list failed', { err })
     return NextResponse.json({ error: translate('customers.errors.lookup_failed', 'Failed to load dictionary entries') }, { status: 400 })
   }
 }
@@ -265,7 +268,7 @@ export async function POST(req: Request, ctx: { params?: { kind?: string } }) {
       return NextResponse.json(err.body, { status: err.status })
     }
     const { translate } = await resolveTranslations()
-    console.error('customers.dictionaries.create failed', err)
+    logger.error('customers.dictionaries.create failed', { err })
     return NextResponse.json({ error: translate('customers.errors.lookup_failed', 'Failed to save dictionary entry') }, { status: 400 })
   }
 }

package/src/modules/customers/api/dictionaries/cache.ts

@@ -1,4 +1,7 @@
 import type { CacheStrategy } from '@open-mercato/cache'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const CACHE_PREFIX = 'customers:dictionaries'
 export const DICTIONARY_CACHE_TTL_MS = 5 * 60 * 1000
@@ -48,6 +51,6 @@ export async function invalidateDictionaryCache(
   try {
     await cache.deleteByTags(tags)
   } catch (err) {
-    console.warn('[customers.dictionaries.cache] Failed to invalidate cache', err)
+    logger.warn('Failed to invalidate cache', { component: 'dictionaries.cache', err })
   }
 }

package/src/modules/customers/api/dictionaries/context.ts

@@ -8,6 +8,9 @@ import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import type { CacheStrategy } from '@open-mercato/cache'
 import type { CommandRuntimeContext } from '@open-mercato/shared/lib/commands'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const BUILTIN_DICTIONARY_ROUTE_KINDS = [
   'statuses',
@@ -163,7 +166,7 @@ export async function resolveDictionaryRouteContext(
       for (const id of candidateIds) readableOrganizationIds.add(id)
     }
   } catch (err) {
-    console.warn('[customers.dictionaries.context] Failed to resolve ancestor organizations', err)
+    logger.warn('Failed to resolve ancestor organizations', { component: 'dictionaries.context', err })
     for (const id of candidateIds) readableOrganizationIds.add(id)
   }
 

package/src/modules/customers/api/dictionaries/currency/route.ts

@@ -3,6 +3,9 @@ import { z } from 'zod'
 import { Dictionary, DictionaryEntry } from '@open-mercato/core/modules/dictionaries/data/entities'
 import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   GET: { requireAuth: true, requireFeatures: ['customers.people.view'] },
@@ -65,7 +68,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[customers.currencyDictionary.GET] Unexpected error', err)
+    logger.error('Unexpected error', { component: 'currencyDictionary.GET', err })
     return NextResponse.json({ error: 'Failed to load currency dictionary.' }, { status: 500 })
   }
 }

package/src/modules/customers/api/dictionaries/kind-settings/route.ts

@@ -19,6 +19,9 @@ import {
   customerKindSettingsUpsertSchema,
   type CustomerKindSettingsUpsertInput,
 } from '../../../data/validators'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   GET: { requireAuth: true, requireFeatures: ['customers.people.view'] },
@@ -82,7 +85,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[customers/dictionaries/kind-settings.GET]', err)
+    logger.error('customers/dictionaries/kind-settings.GET', { err })
     return NextResponse.json({ error: translate('customers.errors.kind_settings_load_failed', 'Failed to load kind settings') }, { status: 500 })
   }
 }
@@ -183,7 +186,7 @@ export async function PATCH(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[customers/dictionaries/kind-settings.PATCH]', err)
+    logger.error('customers/dictionaries/kind-settings.PATCH', { err })
     return NextResponse.json({ error: 'Failed to update kind setting' }, { status: 500 })
   }
 }

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

@@ -16,6 +16,9 @@ import { withScopedPayload } from './utils'
 import { resolveCustomersRequestContext, resolveAuthActorId } from '../lib/interactionRequestContext'
 import { deriveDisplayNameFromEmail } from '../lib/displayName'
 import { withOperationMetadata } from '../lib/operationMetadata'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const paramsSchema = z.object({ id: z.string().uuid() })
 const roleIdQuerySchema = z.object({ roleId: z.string().uuid() })
@@ -96,7 +99,7 @@ async function ensureFeatureOnOrganization(
   try {
     rbac = container.resolve('rbacService') as RbacService | undefined
   } catch (err) {
-    console.error('[customers.entity-roles-factory] rbacService resolve failed', err)
+    logger.error('rbacService resolve failed', { component: 'entity-roles-factory', err })
     rbac = undefined
   }
   if (!rbac) {
@@ -310,7 +313,7 @@ export function createEntityRolesHandlers(entityType: EntityType) {
     } catch (err) {
       if (isCrudHttpError(err)) return NextResponse.json(err.body, { status: err.status })
       if (err instanceof z.ZodError) return buildValidationErrorResponse(err, translate)
-      console.error(`${logPrefix}.get failed`, err)
+      logger.error('Entity roles GET failed', { component: logPrefix, err })
       return NextResponse.json({ error: translate('customers.errors.failed_to_load_roles', 'Failed to load roles') }, { status: 500 })
     }
   }
@@ -367,7 +370,7 @@ export function createEntityRolesHandlers(entityType: EntityType) {
     } catch (err) {
       if (isCrudHttpError(err)) return NextResponse.json(err.body, { status: err.status })
       if (err instanceof z.ZodError) return buildValidationErrorResponse(err, translate)
-      console.error(`${logPrefix}.post failed`, err)
+      logger.error('Entity roles POST failed', { component: logPrefix, err })
       return NextResponse.json({ error: translate('customers.errors.failed_to_assign_role', 'Failed to assign role') }, { status: 500 })
     }
   }
@@ -425,7 +428,7 @@ export function createEntityRolesHandlers(entityType: EntityType) {
     } catch (err) {
       if (isCrudHttpError(err)) return NextResponse.json(err.body, { status: err.status })
       if (err instanceof z.ZodError) return buildValidationErrorResponse(err, translate)
-      console.error(`${logPrefix}.put failed`, err)
+      logger.error('Entity roles PUT failed', { component: logPrefix, err })
       return NextResponse.json({ error: translate('customers.errors.failed_to_update_role', 'Failed to update role') }, { status: 500 })
     }
   }
@@ -481,7 +484,7 @@ export function createEntityRolesHandlers(entityType: EntityType) {
     } catch (err) {
       if (isCrudHttpError(err)) return NextResponse.json(err.body, { status: err.status })
       if (err instanceof z.ZodError) return buildValidationErrorResponse(err, translate)
-      console.error(`${logPrefix}.delete failed`, err)
+      logger.error('Entity roles DELETE failed', { component: logPrefix, err })
       return NextResponse.json({ error: translate('customers.errors.failed_to_delete_role', 'Failed to delete role') }, { status: 500 })
     }
   }

package/src/modules/customers/api/interactions/cancel/route.ts

@@ -15,6 +15,9 @@ import {
 } from '@open-mercato/shared/lib/crud/mutation-guard'
 import { resolveAuthActorId } from '../../../lib/interactionRequestContext'
 import { withOperationMetadata } from '../../../lib/operationMetadata'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['customers.interactions.manage'] },
@@ -86,7 +89,7 @@ export async function POST(req: Request) {
     if (err instanceof z.ZodError) {
       return NextResponse.json({ error: 'Validation failed', details: err.issues }, { status: 400 })
     }
-    console.error('customers.interactions.cancel failed', err)
+    logger.error('customers.interactions.cancel failed', { err })
     return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
   }
 }

package/src/modules/customers/api/interactions/complete/route.ts

@@ -15,6 +15,9 @@ import {
 } from '@open-mercato/shared/lib/crud/mutation-guard'
 import { resolveAuthActorId } from '../../../lib/interactionRequestContext'
 import { withOperationMetadata } from '../../../lib/operationMetadata'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['customers.interactions.manage'] },
@@ -86,7 +89,7 @@ export async function POST(req: Request) {
     if (err instanceof z.ZodError) {
       return NextResponse.json({ error: 'Validation failed', details: err.issues }, { status: 400 })
     }
-    console.error('customers.interactions.complete failed', err)
+    logger.error('customers.interactions.complete failed', { err })
     return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
   }
 }

package/src/modules/customers/api/interactions/conflicts/route.ts

@@ -10,6 +10,9 @@ import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { CustomerInteraction } from '../../../data/entities'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const querySchema = z.object({
   date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
@@ -193,7 +196,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[customers/interactions/conflicts] GET failed', err)
+    logger.error('GET failed', { component: 'interactions/conflicts', err })
     return NextResponse.json({ error: translate('customers.errors.internal', 'Internal server error') }, { status: 500 })
   }
 }

package/src/modules/customers/api/interactions/counts/route.ts

@@ -9,6 +9,9 @@ import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/d
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { applyEmailVisibilityFilter } from '../../../lib/visibilityFilter'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const querySchema = z.object({
   entityId: z.string().uuid(),
@@ -119,7 +122,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[customers/interactions/counts] GET failed', err)
+    logger.error('GET failed', { component: 'interactions/counts', err })
     return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
   }
 }

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

@@ -29,6 +29,9 @@ import { applyEmailVisibilityFilter } from '../../lib/visibilityFilter'
 import { resolveEncryptedSortPage } from './encryptedSortPage'
 import { resolveCanonicalActivityTargetId } from '../../lib/legacyActivityBridge'
 import type { CommandBus, CommandRuntimeContext } from '@open-mercato/shared/lib/commands'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const rawBodySchema = z.object({}).passthrough()
 
@@ -122,7 +125,7 @@ const crud = makeCrudRoute({
           } catch (err) {
             // Bridging is best-effort; downstream lookup will surface a 404
             // when neither canonical nor legacy rows exist.
-            console.warn('[customers.interactions.put] legacy bridge failed', { id: parsed.id, error: err })
+            logger.warn('Legacy interaction bridge failed', { component: 'interactions.put', id: parsed.id, err })
           }
         }
         return parsed
@@ -492,7 +495,8 @@ export async function GET(req: Request) {
       }
       const candidateRows = await candidateQuery.execute() as Array<{ id: string } & Record<string, unknown>>
       if (cap !== null && candidateRows.length >= cap) {
-        console.warn('[customers/interactions.GET] encrypted sort candidate scan hit OM_ENCRYPTED_SORT_MAX_ROWS cap; results may be incomplete', {
+        logger.warn('Encrypted sort candidate scan hit OM_ENCRYPTED_SORT_MAX_ROWS cap; results may be incomplete', {
+          component: 'interactions.GET',
           cap,
           sortField: sortConfig.column,
           tenantId: auth.tenantId,
@@ -508,7 +512,7 @@ export async function GET(req: Request) {
             const decrypted = await decryptPayload(CUSTOMER_INTERACTION_ENTITY_ID, row, auth.tenantId, selectedOrganizationId)
             return { ...row, ...decrypted }
           } catch (err) {
-            console.error('[customers/interactions.GET] error decrypting sort candidate', err)
+            logger.error('error decrypting sort candidate', { component: 'interactions.GET', err })
             return row
           }
         },
@@ -695,7 +699,7 @@ export async function GET(req: Request) {
         { status: 400 },
       )
     }
-    console.error('customers.interactions.get failed', err)
+    logger.error('customers.interactions.get failed', { err })
     const { translate } = await resolveTranslations()
     return NextResponse.json(
       { error: translate('customers.interactions.load.error', 'Failed to load interactions.') },

package/src/modules/customers/api/interactions/tasks/route.ts

@@ -17,6 +17,9 @@ import {
   paginateTodoRows,
   sortTodoRows,
 } from '../../../lib/todoCompatibility'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const querySchema = z.object({
   page: z.coerce.number().min(1).default(1),
@@ -114,7 +117,7 @@ export async function GET(request: Request): Promise<Response> {
     if (err instanceof z.ZodError) {
       return NextResponse.json({ error: translate('customers.errors.validationFailed', 'Validation failed'), details: err.issues }, { status: 400 })
     }
-    console.error('customers.interactions.tasks.get failed', err)
+    logger.error('customers.interactions.tasks.get failed', { err })
     return NextResponse.json({ error: translate('customers.errors.internalError', 'Internal server error') }, { status: 500 })
   }
 }

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

@@ -23,6 +23,9 @@ import {
 } from '../table-errors'
 import { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   POST: { requireAuth: true },
@@ -171,7 +174,7 @@ export async function POST(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[customers/labels/assign.POST]', err)
+    logger.error('customers/labels/assign.POST', { err })
     const { translate: fallbackTranslate } = await resolveTranslations()
     return NextResponse.json(
       { error: fallbackTranslate('customers.errors.failed_to_assign_label', 'Failed to assign label') },