@open-mercato/core 0.6.6-develop.6460.1.f94c74174c → 0.6.6-develop.6471.1.9ab5bdd79a

package/src/modules/customer_accounts/api/domain-resolve/all.ts

@@ -9,9 +9,11 @@ import {
   checkAuthRateLimit,
   domainResolveAllIpRateLimitConfig,
 } from '@open-mercato/core/modules/customer_accounts/lib/rateLimiter'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'domain-resolve-all' })
 
 const ORIGIN_HEADER_NAME = process.env.CUSTOMER_DOMAIN_ORIGIN_HEADER ?? 'X-Open-Mercato-Origin'
-const LOG_PREFIX = '[domain-resolve/all]'
 const ENDPOINT_PATH = '/api/customer_accounts/domain-resolve/all'
 
 export const metadata = {
@@ -39,7 +41,7 @@ export async function GET(req: Request) {
   const expected = process.env.DOMAIN_RESOLVE_SECRET
   if (!expected) {
     // Fail closed when the gating secret is not configured on the server.
-    console.warn(`${LOG_PREFIX} rejected request — secret not configured`, {
+    logger.warn('Rejected request — secret not configured', {
       endpoint: ENDPOINT_PATH,
       ip: callerIp,
       outcome: 'misconfigured',
@@ -60,7 +62,7 @@ export async function GET(req: Request) {
     ipConfig: domainResolveAllIpRateLimitConfig,
   })
   if (rateLimitError) {
-    console.warn(`${LOG_PREFIX} rate-limited`, {
+    logger.warn('Rate-limited', {
       endpoint: ENDPOINT_PATH,
       ip: callerIp,
       outcome: 'rate_limited',
@@ -70,7 +72,7 @@ export async function GET(req: Request) {
 
   const supplied = req.headers.get('x-domain-resolve-secret')
   if (!secretEqual(supplied, expected)) {
-    console.warn(`${LOG_PREFIX} rejected request — invalid secret`, {
+    logger.warn('Rejected request — invalid secret', {
       endpoint: ENDPOINT_PATH,
       ip: callerIp,
       outcome: 'forbidden',
@@ -81,7 +83,7 @@ export async function GET(req: Request) {
   const container = await createRequestContainer()
   const service = container.resolve('domainMappingService') as DomainMappingService
   const records = await service.resolveAll()
-  console.info(`${LOG_PREFIX} authorized`, {
+  logger.info('Authorized', {
     endpoint: ENDPOINT_PATH,
     ip: callerIp,
     outcome: 'ok',

package/src/modules/customer_accounts/api/signup.ts

@@ -26,6 +26,9 @@ import {
   TenantResolutionError,
 } from '@open-mercato/core/modules/customer_accounts/lib/resolveTenantContext'
 import { urlForCustomerOrg } from '@open-mercato/core/modules/customer_accounts/lib/customerUrl'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'signup' })
 
 export const metadata: { path?: string; requireAuth?: boolean } = { requireAuth: false }
 
@@ -142,7 +145,7 @@ export async function POST(req: Request) {
       subject,
       react: CustomerExistingAccountEmail({ loginUrl, copy }),
     }).catch((error) => {
-      console.error('[customer_accounts.signup] existing-account email failed', error)
+      logger.error('Existing-account email failed', { err: error })
     })
 
     return NextResponse.json({ ok: true }, { status: 202 })
@@ -195,7 +198,7 @@ export async function POST(req: Request) {
     subject,
     react: CustomerSignupVerificationEmail({ verifyUrl, copy }),
   }).catch((error) => {
-    console.error('[customer_accounts.signup] verification email failed', error)
+    logger.error('Verification email failed', { err: error })
   })
 
   void emitCustomerAccountsEvent('customer_accounts.user.created', {

package/src/modules/customer_accounts/lib/customerAuthServer.ts

@@ -14,6 +14,9 @@ import { tryNormalizeHostname } from '@open-mercato/core/modules/customer_accoun
 import { platformDomains } from '@open-mercato/core/modules/customer_accounts/lib/platformDomains'
 import { validateUserState } from './customerAuth'
 import type { CustomerAuthContext } from './customerAuth'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'customer-auth-server' })
 
 export type { CustomerAuthContext }
 
@@ -114,7 +117,7 @@ export async function getCustomerAuthForHost(
     if (!resolved || resolved.status !== 'active') return null
     return getCustomerAuthFromCookies({ expectedTenantId: resolved.tenantId })
   } catch (err) {
-    console.warn('[customer_accounts] getCustomerAuthForHost: domain resolve failed; falling back to platform cookie', err)
+    logger.warn('Domain resolve failed; falling back to platform cookie', { err })
     return getCustomerAuthFromCookies()
   }
 }

package/src/modules/customer_accounts/subscribers/autoLinkCrm.ts

@@ -1,6 +1,9 @@
 import type { EntityManager } from '@mikro-orm/postgresql'
 import { CustomerUser } from '@open-mercato/core/modules/customer_accounts/data/entities'
 import { findWithDecryption, findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'auto-link-crm' })
 
 export const metadata = {
   event: 'customer_accounts.user.created',
@@ -55,6 +58,6 @@ export default async function handle(
 
     await em.nativeUpdate(CustomerUser, { id: userId }, updates)
   } catch (err) {
-    console.error('[customer_accounts:auto-link-crm] Failed to link customer user to CRM person:', err)
+    logger.error('Failed to link customer user to CRM person', { err })
   }
 }

package/src/modules/customer_accounts/subscribers/autoLinkCrmReverse.ts

@@ -2,6 +2,9 @@ import type { EntityManager } from '@mikro-orm/postgresql'
 import { CustomerUser } from '@open-mercato/core/modules/customer_accounts/data/entities'
 import { lookupHashCandidates } from '@open-mercato/shared/lib/encryption/aes'
 import { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'auto-link-crm-reverse' })
 
 export const metadata = {
   event: 'customers.person.created',
@@ -72,6 +75,6 @@ export default async function handle(
       if (affected === 0) return
     }
   } catch (err) {
-    console.error('[customer_accounts:auto-link-crm-reverse] Failed to link CRM person to customer user:', err)
+    logger.error('Failed to link CRM person to customer user', { err })
   }
 }

package/src/modules/customer_accounts/subscribers/unlinkOnCompanyDelete.ts

@@ -1,5 +1,8 @@
 import type { EntityManager } from '@mikro-orm/postgresql'
 import { CustomerUser } from '@open-mercato/core/modules/customer_accounts/data/entities'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'unlink-on-company-delete' })
 
 export const metadata = {
   event: 'customers.company.deleted',
@@ -25,6 +28,6 @@ export default async function handle(
       { customerEntityId: null, updatedAt: new Date() },
     )
   } catch (err) {
-    console.error('[customer_accounts:unlink-on-company-delete] Failed to clear customerEntityId on customer users:', err)
+    logger.error('Failed to clear customerEntityId on customer users', { err })
   }
 }

package/src/modules/customer_accounts/subscribers/unlinkOnPersonDelete.ts

@@ -1,5 +1,8 @@
 import type { EntityManager } from '@mikro-orm/postgresql'
 import { CustomerUser } from '@open-mercato/core/modules/customer_accounts/data/entities'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customer_accounts').child({ component: 'unlink-on-person-delete' })
 
 export const metadata = {
   event: 'customers.person.deleted',
@@ -25,6 +28,6 @@ export default async function handle(
       { personEntityId: null, updatedAt: new Date() },
     )
   } catch (err) {
-    console.error('[customer_accounts:unlink-on-person-delete] Failed to clear personEntityId on customer users:', err)
+    logger.error('Failed to clear personEntityId on customer users', { err })
   }
 }

package/src/modules/customers/ai-agents-context.ts

@@ -24,6 +24,9 @@ import type {
   CustomersAiToolDefinition,
   CustomersToolContext,
 } from './ai-tools/types'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i
 
@@ -89,7 +92,7 @@ async function hydrateWithTool(
 ): Promise<unknown | null> {
   const tool = findTool(toolName)
   if (!tool) {
-    console.warn(`[customers.account_assistant] resolvePageContext: tool "${toolName}" not registered`)
+    logger.warn('resolvePageContext: tool not registered', { component: 'account_assistant', toolName })
     return null
   }
   try {
@@ -98,10 +101,7 @@ async function hydrateWithTool(
     if ((result as { found?: boolean }).found === false) return null
     return result
   } catch (error) {
-    console.warn(
-      `[customers.account_assistant] resolvePageContext: tool "${toolName}" failed (reason="hydration_error"); skipping`,
-      error instanceof Error ? error.message : error,
-    )
+    logger.warn('resolvePageContext: tool failed; skipping', { component: 'account_assistant', toolName, err: error })
     return null
   }
 }

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

@@ -30,6 +30,9 @@ import { resolveCustomersRequestContext } from '../../lib/interactionRequestCont
 import { hydrateCanonicalInteractions } from '../../lib/interactionReadModel'
 import { resolveCanonicalActivityTargetId } from '../../lib/legacyActivityBridge'
 import { buildEmailVisibilityMikroFilter } from '../../lib/visibilityFilter'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const listSchema = z.object({
   page: z.coerce.number().min(1).default(1),
@@ -488,7 +491,7 @@ export async function GET(request: Request): Promise<Response> {
         NextResponse.json({ error: 'Validation failed', details: err.issues }, { status: 400 }),
       )
     }
-    console.error('customers.activities.get failed', err)
+    logger.error('customers.activities.get failed', { err })
     return withAdapterHeaders(
       NextResponse.json({ error: 'Internal server error' }, { status: 500 }),
     )
@@ -577,7 +580,7 @@ export async function POST(request: Request): Promise<Response> {
         NextResponse.json({ error: 'Validation failed', details: err.issues }, { status: 400 }),
       )
     }
-    console.error('customers.activities.post failed', err)
+    logger.error('customers.activities.post failed', { err })
     return withAdapterHeaders(
       NextResponse.json({ error: 'Internal server error' }, { status: 500 }),
     )
@@ -660,7 +663,7 @@ export async function PUT(request: Request): Promise<Response> {
         NextResponse.json({ error: 'Validation failed', details: err.issues }, { status: 400 }),
       )
     }
-    console.error('customers.activities.put failed', err)
+    logger.error('customers.activities.put failed', { err })
     return withAdapterHeaders(
       NextResponse.json({ error: 'Internal server error' }, { status: 500 }),
     )
@@ -728,7 +731,7 @@ export async function DELETE(request: Request): Promise<Response> {
         NextResponse.json({ error: 'Validation failed', details: err.issues }, { status: 400 }),
       )
     }
-    console.error('customers.activities.delete failed', err)
+    logger.error('customers.activities.delete failed', { err })
     return withAdapterHeaders(
       NextResponse.json({ error: 'Internal server error' }, { status: 500 }),
     )

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

@@ -13,6 +13,9 @@ import {
   createPagedListResponseSchema,
   defaultOkResponseSchema,
 } from '../openapi'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const rawBodySchema = z.object({}).passthrough()
 
@@ -177,7 +180,7 @@ const crud = makeCrudRoute({
           }
         })
       } catch (err) {
-        console.warn('[customers.comments] failed to enrich deal titles', err)
+        logger.warn('failed to enrich deal titles', { component: 'comments', err })
       }
     },
   },

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

@@ -18,6 +18,9 @@ import {
   filterActivePersonCompanyLinks,
   withActiveCustomerPersonCompanyLinkFilter,
 } from '../../../../lib/personCompanyLinkTable'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const paramsSchema = z.object({
   id: z.string().uuid(),
@@ -202,7 +205,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.companies.people.GET]', error)
+    logger.error('customers.companies.people.GET', { err: error })
     return NextResponse.json({ error: translate('customers.errors.company_people_load_failed', 'Failed to load linked people') }, { status: 500 })
   }
 }

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

@@ -57,6 +57,9 @@ import {
   isCrudCacheEnabled,
   resolveCrudCache,
 } from '@open-mercato/shared/lib/crud/cache'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 export const metadata = {
   GET: { requireAuth: true, requireFeatures: ['customers.companies.view'] },
@@ -414,7 +417,7 @@ async function resolveTodoDetails(
         })
       }
     } catch (err) {
-      console.warn(`customers.companies.detail: failed to resolve todos for source ${source}`, err)
+      logger.warn('customers.companies.detail: failed to resolve todos', { source, err })
     }
   }
 
@@ -693,7 +696,7 @@ export async function GET(_req: Request, ctx: { params?: { id?: string } }) {
         [company.organizationId ?? null, ...(scope?.filterIds ?? [])],
       )
     } catch (err) {
-      console.warn('customers.companies.detail: failed to enrich todo links', err)
+      logger.warn('customers.companies.detail: failed to enrich todo links', { err })
     }
   }
 
@@ -1273,7 +1276,7 @@ export async function GET(_req: Request, ctx: { params?: { id?: string } }) {
         }),
       )
     } catch (err) {
-      console.warn('[customers:companies] Failed to set company detail cache', err)
+      logger.warn('Failed to set company detail cache', { component: 'companies', err })
     }
   }
 

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

@@ -39,6 +39,9 @@ import {
   withScopedCustomerDealLinkWhere,
 } from '../../lib/personCompanyLinkTable'
 import { normalizeCompanyProfilePayload } from './payload'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 const rawBodySchema = z.object({}).passthrough()
 
@@ -241,7 +244,7 @@ const crud = makeCrudRoute({
             if (typeof companyId === 'string' && companyId.length > 0) excludedIds.add(companyId)
           })
         } catch (err) {
-          console.warn('[customers.companies.list] exclusion lookup failed; falling back to base result set', err)
+          logger.warn('exclusion lookup failed; falling back to base result set', { component: 'companies.list', err })
         }
       }
       if (typeof query.excludeLinkedCompanyId === 'string' && query.excludeLinkedCompanyId.length > 0) {
@@ -266,7 +269,7 @@ const crud = makeCrudRoute({
             if (typeof companyId === 'string' && companyId.length > 0) excludedIds.add(companyId)
           })
         } catch (err) {
-          console.warn('[customers.companies.list] exclusion lookup failed; falling back to base result set', err)
+          logger.warn('exclusion lookup failed; falling back to base result set', { component: 'companies.list', err })
         }
       }
       applyEntityIdExclusion(filters, Array.from(excludedIds))
@@ -315,7 +318,7 @@ const crud = makeCrudRoute({
           })
           Object.assign(filters, cfFilters)
         } catch (err) {
-          console.warn('[customers.companies.list] custom field filter resolution failed; falling back to base filters', err)
+          logger.warn('custom field filter resolution failed; falling back to base filters', { component: 'companies.list', err })
         }
       }
       if (ctx && advancedFilterTree) {

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

@@ -13,6 +13,9 @@ import {
   sortTodoRows,
   type CustomerTodoRow,
 } from '../../../../lib/todoCompatibility'
+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),
@@ -130,7 +133,7 @@ export async function GET(req: Request) {
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('customers.widgets.todos failed', err)
+    logger.error('customers.widgets.todos failed', { err })
     return NextResponse.json(
       { error: translate('customers.widgets.todos.error', 'Failed to load customer tasks') },
       { status: 500 }

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 })
       }
     }
   }