@open-mercato/core 0.6.6-develop.6465.1.019f0fb26f → 0.6.6-develop.6471.1.9ab5bdd79a

package/src/modules/customers/search.ts

@@ -7,6 +7,9 @@ import type {
   SearchIndexSource,
 } from '@open-mercato/shared/modules/search'
 import { CUSTOMER_INTERACTION_TASK_SOURCE, EXAMPLE_TODO_SOURCE } from './lib/interactionCompatibility'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 // =============================================================================
 // Context Types
@@ -198,11 +201,12 @@ async function loadCustomerEntityBundle(ctx: SearchContext, opts: CustomerEntity
     const customFields = extractCustomFieldMap(row)
     return { entity, customFields }
   } catch (error) {
-    console.warn('[search.customers] Failed to load customer entity via QueryEngine', {
+    logger.warn('Failed to load customer entity via QueryEngine', {
+      component: 'search',
       entityId: resolvedEntityId ?? null,
       profileKind: opts.profileKind ?? null,
       profileId: resolvedProfileId ?? null,
-      error: error instanceof Error ? error.message : error,
+      err: error,
     })
     return null
   }
@@ -552,7 +556,8 @@ function resolveCompanyPresenter(
   )
   if (summary) subtitlePieces.push(summary)
   if (!entity && (!title || title === fallbackEntityId)) {
-    console.warn('[search.customers] Missing customer entity during company presenter build', {
+    logger.warn('Missing customer entity during company presenter build', {
+      component: 'search',
       recordId: record.id ?? null,
       entityId: fallbackEntityId,
       recordKeys: Object.keys(record),
@@ -575,11 +580,12 @@ function logMissingPresenterTitle(
   const fallbackId = record.id ?? record.entity_id ?? resolveCustomerEntityId(record)
   if (!fallbackId) return
   if (presenter.title && presenter.title !== String(fallbackId)) return
-  console.warn('[search.customers] Presenter fell back to record id', {
+  logger.warn('Presenter fell back to record id', {
+    component: 'search',
     kind,
     recordId: fallbackId,
     entityId: resolveCustomerEntityId(record),
-    entityDisplayName: entity?.display_name ?? null,
+    hasEntityDisplayName: entity?.display_name != null,
   })
 }
 
@@ -618,7 +624,8 @@ export const searchConfig: SearchModuleConfig = {
           appendCustomFieldLines(lines, entityOnlyCustomFields, 'Customer custom')
         }
         if (!entity) {
-          console.warn('[search.customers] Failed to load customer entity for person profile', {
+          logger.warn('Failed to load customer entity for person profile', {
+            component: 'search',
             recordId: record.id,
             entityId,
             recordKeys: Object.keys(record),
@@ -629,7 +636,8 @@ export const searchConfig: SearchModuleConfig = {
         if (!lines.length) return null
 
         if (!entityId) {
-          console.warn('[search.customers] person profile missing entity id', {
+          logger.warn('Person profile missing entity id', {
+            component: 'search',
             recordId: record.id,
             recordKeys: Object.keys(record),
           })

package/src/modules/customers/widgets/dashboard/customer-todos/widget.client.tsx

@@ -10,6 +10,9 @@ import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { DEFAULT_SETTINGS, hydrateCustomerTodoSettings, type CustomerTodoWidgetSettings } from './config'
 import { resolveExampleIntegrationHref } from '../../../lib/interactionCompatibility'
 import { resolveTodoHref } from '../../../components/detail/utils'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 type TodoLinkSummary = {
   id: string
@@ -114,7 +117,7 @@ const CustomerTodosWidget: React.FC<DashboardWidgetComponentProps<CustomerTodoWi
       const data = await loadTodos(hydrated)
       setItems(data)
     } catch (err) {
-      console.error('Failed to load customer todos widget data', err)
+      logger.error('Failed to load customer todos widget data', { err })
       setError(t('customers.widgets.todos.error'))
     } finally {
       setLoading(false)

package/src/modules/customers/widgets/dashboard/new-customers/widget.client.tsx

@@ -19,6 +19,9 @@ import {
   hydrateNewCustomersSettings,
   type CustomerNewCustomersSettings,
 } from './config'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 type NewCustomerItem = {
   id: string
@@ -110,7 +113,7 @@ const CustomerNewCustomersWidget: React.FC<DashboardWidgetComponentProps<Custome
       const data = await loadNewCustomers(hydrated)
       setItems(data)
     } catch (err) {
-      console.error('Failed to load new customers widget data', err)
+      logger.error('Failed to load new customers widget data', { err })
       setError(t('customers.widgets.newCustomers.error'))
     } finally {
       setLoading(false)

package/src/modules/customers/widgets/dashboard/new-deals/widget.client.tsx

@@ -8,6 +8,9 @@ import { Input } from '@open-mercato/ui/primitives/input'
 import { Spinner } from '@open-mercato/ui/primitives/spinner'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { DEFAULT_SETTINGS, hydrateNewDealsSettings, type CustomerNewDealsSettings } from './config'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 type NewDealItem = {
   id: string
@@ -86,7 +89,7 @@ const CustomerNewDealsWidget: React.FC<DashboardWidgetComponentProps<CustomerNew
       const data = await loadNewDeals(hydrated)
       setItems(data)
     } catch (err) {
-      console.error('Failed to load new deals widget data', err)
+      logger.error('Failed to load new deals widget data', { err })
       setError(t('customers.widgets.newDeals.error'))
     } finally {
       setLoading(false)

package/src/modules/customers/widgets/dashboard/next-interactions/widget.client.tsx

@@ -14,6 +14,9 @@ import {
   type CustomerNextInteractionsSettings,
 } from './config'
 import { renderDictionaryColor, renderDictionaryIcon } from '../../../lib/dictionaries'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('customers')
 
 type NextInteractionItem = {
   id: string
@@ -118,7 +121,7 @@ const CustomerNextInteractionsWidget: React.FC<DashboardWidgetComponentProps<Cus
       const response = await loadNextInteractions(hydrated)
       setData(response.items)
     } catch (err) {
-      console.error('Failed to load next interactions widget data', err)
+      logger.error('Failed to load next interactions widget data', { err })
       setError(t('customers.widgets.nextInteractions.error'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/api/widgets/data/batch/route.ts

@@ -15,6 +15,9 @@ import type { AnalyticsRegistry } from '../../../../services/analyticsRegistry'
 import type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { dashboardsTag, dashboardsErrorSchema } from '../../../openapi'
 import { widgetDataRequestSchema, widgetDataResponseSchema } from '../schema'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'widgets-data-batch' })
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['analytics.view'] },
@@ -127,7 +130,7 @@ export async function POST(req: Request) {
     })
     return NextResponse.json({ results })
   } catch (err) {
-    console.error('[widgets/data/batch] Error:', err)
+    logger.error('Widget batch data request failed', { err })
     return NextResponse.json(
       { error: 'An error occurred while processing your request' },
       { status: 500 },

package/src/modules/dashboards/api/widgets/data/route.ts

@@ -14,6 +14,9 @@ import { runApiInterceptorsBefore } from '@open-mercato/shared/lib/crud/intercep
 import type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { dashboardsTag, dashboardsErrorSchema } from '../../openapi'
 import { widgetDataRequestSchema, widgetDataResponseSchema } from './schema'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'widgets-data' })
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['analytics.view'] },
@@ -122,7 +125,7 @@ export async function POST(req: Request) {
     const result = await service.fetchWidgetData(requestData)
     return NextResponse.json(result)
   } catch (err) {
-    console.error('[widgets/data] Error:', err)
+    logger.error('Widget data request failed', { err })
     if (err instanceof WidgetDataValidationError) {
       return NextResponse.json({ error: err.message }, { status: 400 })
     }

package/src/modules/dashboards/components/WidgetVisibilityEditor.tsx

@@ -9,6 +9,9 @@ import { apiCallOrThrow, readApiResultOrThrow } from '@open-mercato/ui/backend/u
 import { useGuardedMutation } from '@open-mercato/ui/backend/injection/useGuardedMutation'
 import { flash } from '@open-mercato/ui/backend/FlashMessages'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'WidgetVisibilityEditor' })
 
 const WIDGET_VISIBILITY_CONTEXT_ID = 'dashboards-widget-visibility:save'
 
@@ -200,7 +203,7 @@ export const WidgetVisibilityEditor = React.forwardRef<WidgetVisibilityEditorHan
             : loadUserData(tenantIdRef.current, organizationIdRef.current),
         ])
       } catch (err) {
-        console.error('Failed to load widget visibility data', err)
+        logger.error('Failed to load widget visibility data', { err })
         if (!cancelled) {
           setError(tRef.current('dashboards.widgets.error.load', 'Unable to load widget configuration.'))
         }
@@ -224,7 +227,7 @@ export const WidgetVisibilityEditor = React.forwardRef<WidgetVisibilityEditorHan
         if (kind === 'role') await loadRoleData(tenantId, organizationId)
         else await loadUserData(tenantId, organizationId)
       } catch (err) {
-        console.error('Failed to reload widget visibility data', err)
+        logger.error('Failed to reload widget visibility data', { err })
       }
     }
     refetch()
@@ -312,7 +315,7 @@ export const WidgetVisibilityEditor = React.forwardRef<WidgetVisibilityEditorHan
       }
       try { flash(t('dashboards.widgets.flash.saved', 'Dashboard widgets updated'), 'success') } catch {}
     } catch (err) {
-      console.error('Failed to save widget visibility', err)
+      logger.error('Failed to save widget visibility', { err })
       setError(t('dashboards.widgets.error.save', 'Unable to save dashboard widget preferences.'))
     } finally {
       setSaving(false)

package/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.client.tsx

@@ -14,6 +14,9 @@ import {
 import { DEFAULT_SETTINGS, hydrateSettings, type AovKpiSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrencyWithDecimals } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'aov-kpi' })
 
 async function fetchAovData(settings: AovKpiSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -63,7 +66,7 @@ const AovKpiWidget: React.FC<DashboardWidgetComponentProps<AovKpiSettings>> = ({
         setTrend(undefined)
       }
     } catch (err) {
-      console.error('Failed to load AOV KPI data', err)
+      logger.error('Failed to load AOV KPI data', { err })
       setError(t('dashboards.analytics.widgets.aovKpi.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.client.tsx

@@ -13,6 +13,9 @@ import {
 } from '@open-mercato/ui/backend/date-range'
 import { DEFAULT_SETTINGS, hydrateSettings, type NewCustomersKpiSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'new-customers-kpi' })
 
 async function fetchNewCustomersData(settings: NewCustomersKpiSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -62,7 +65,7 @@ const NewCustomersKpiWidget: React.FC<DashboardWidgetComponentProps<NewCustomers
         setTrend(undefined)
       }
     } catch (err) {
-      console.error('Failed to load new customers KPI data', err)
+      logger.error('Failed to load new customers KPI data', { err })
       setError(t('dashboards.analytics.widgets.newCustomersKpi.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.client.tsx

@@ -19,6 +19,9 @@ import {
 } from '@open-mercato/ui/primitives/select'
 import { DEFAULT_SETTINGS, hydrateSettings, type OrdersByStatusSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'orders-by-status' })
 
 async function fetchOrdersByStatusData(settings: OrdersByStatusSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -84,7 +87,7 @@ const OrdersByStatusWidget: React.FC<DashboardWidgetComponentProps<OrdersByStatu
       }))
       setData(chartData)
     } catch (err) {
-      console.error('Failed to load orders by status data', err)
+      logger.error('Failed to load orders by status data', { err })
       setError(t('dashboards.analytics.widgets.ordersByStatus.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.client.tsx

@@ -13,6 +13,9 @@ import {
 } from '@open-mercato/ui/backend/date-range'
 import { DEFAULT_SETTINGS, hydrateSettings, type OrdersKpiSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'orders-kpi' })
 
 async function fetchOrdersData(settings: OrdersKpiSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -62,7 +65,7 @@ const OrdersKpiWidget: React.FC<DashboardWidgetComponentProps<OrdersKpiSettings>
         setTrend(undefined)
       }
     } catch (err) {
-      console.error('Failed to load orders KPI data', err)
+      logger.error('Failed to load orders KPI data', { err })
       setError(t('dashboards.analytics.widgets.ordersKpi.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.client.tsx

@@ -13,6 +13,9 @@ import {
 import { DEFAULT_SETTINGS, hydrateSettings, type PipelineSummarySettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrencyCompact } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'pipeline-summary' })
 
 async function fetchPipelineData(settings: PipelineSummarySettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -73,7 +76,7 @@ const PipelineSummaryWidget: React.FC<DashboardWidgetComponentProps<PipelineSumm
         }))
       setData(chartData)
     } catch (err) {
-      console.error('Failed to load pipeline data', err)
+      logger.error('Failed to load pipeline data', { err })
       setError(t('dashboards.analytics.widgets.pipelineSummary.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.client.tsx

@@ -14,6 +14,9 @@ import {
 import { DEFAULT_SETTINGS, hydrateSettings, type RevenueKpiSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrency } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'revenue-kpi' })
 
 async function fetchRevenueData(settings: RevenueKpiSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -63,7 +66,7 @@ const RevenueKpiWidget: React.FC<DashboardWidgetComponentProps<RevenueKpiSetting
         setTrend(undefined)
       }
     } catch (err) {
-      console.error('Failed to load revenue KPI data', err)
+      logger.error('Failed to load revenue KPI data', { err })
       setError(t('dashboards.analytics.widgets.revenueKpi.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.client.tsx

@@ -21,6 +21,9 @@ import type { DateGranularity } from '@open-mercato/shared/modules/analytics'
 import { DEFAULT_SETTINGS, hydrateSettings, type RevenueTrendSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrencyCompact } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'revenue-trend' })
 
 async function fetchRevenueTrendData(settings: RevenueTrendSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -132,7 +135,7 @@ const RevenueTrendWidget: React.FC<DashboardWidgetComponentProps<RevenueTrendSet
       }))
       setData(chartData)
     } catch (err) {
-      console.error('Failed to load revenue trend data', err)
+      logger.error('Failed to load revenue trend data', { err })
       setError(t('dashboards.analytics.widgets.revenueTrend.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.client.tsx

@@ -10,6 +10,9 @@ import { Input } from '@open-mercato/ui/primitives/input'
 import { DEFAULT_SETTINGS, hydrateSettings, type SalesByRegionSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrencyCompact } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'sales-by-region' })
 
 async function fetchSalesByRegionData(settings: SalesByRegionSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -57,7 +60,7 @@ const SalesByRegionWidget: React.FC<DashboardWidgetComponentProps<SalesByRegionS
       }))
       setData(chartData)
     } catch (err) {
-      console.error('Failed to load sales by region data', err)
+      logger.error('Failed to load sales by region data', { err })
       setError(t('dashboards.analytics.widgets.salesByRegion.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/top-customers/widget.client.tsx

@@ -10,6 +10,9 @@ import { Input } from '@open-mercato/ui/primitives/input'
 import { DEFAULT_SETTINGS, hydrateSettings, type TopCustomersSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrencySafe } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'top-customers' })
 
 type CustomerRow = {
   rank: number
@@ -93,7 +96,7 @@ const TopCustomersWidget: React.FC<DashboardWidgetComponentProps<TopCustomersSet
       }))
       setData(tableData)
     } catch (err) {
-      console.error('Failed to load top customers data', err)
+      logger.error('Failed to load top customers data', { err })
       setError(t('dashboards.analytics.widgets.topCustomers.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/dashboards/widgets/dashboard/top-products/widget.client.tsx

@@ -17,6 +17,9 @@ import {
 import { DEFAULT_SETTINGS, hydrateSettings, type TopProductsSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
 import { formatCurrencyCompact } from '../../../lib/formatters'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dashboards').child({ component: 'top-products' })
 
 async function fetchTopProductsData(settings: TopProductsSettings, fetchWidgetData: WidgetDataFetcher): Promise<WidgetDataResponse> {
   const body = {
@@ -86,7 +89,7 @@ const TopProductsWidget: React.FC<DashboardWidgetComponentProps<TopProductsSetti
       }))
       setData(chartData)
     } catch (err) {
-      console.error('Failed to load top products data', err)
+      logger.error('Failed to load top products data', { err })
       setError(t('dashboards.analytics.widgets.topProducts.error', 'Failed to load data'))
     } finally {
       setLoading(false)

package/src/modules/data_sync/api/run.ts

@@ -13,6 +13,9 @@ import {
   runCrudMutationGuardAfterSuccess,
   validateCrudMutationGuard,
 } from '@open-mercato/shared/lib/crud/mutation-guard'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('data_sync').child({ component: 'run' })
 
 export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['data_sync.run'] },
@@ -138,7 +141,7 @@ export async function POST(req: Request) {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
     const stack = error instanceof Error ? error.stack : undefined
-    console.error('[data_sync.run] unhandled error', { message, stack })
+    logger.error('Unhandled error starting sync run', { message, stack })
     return NextResponse.json(
       { error: 'Failed to start data sync run.' },
       { status: 500 },

package/src/modules/data_sync/backend/data-sync/runs/[id]/page.tsx

@@ -431,7 +431,9 @@ export default function SyncRunDetailPage({ params }: SyncRunDetailPageProps) {
                   message: log.message,
                   body: log.payload ? (
                     <pre className="overflow-x-auto whitespace-pre-wrap rounded-md border bg-card p-3 text-xs">
-                      {JSON.stringify(log.payload, null, 2)}
+                      {log.payload.kind === 'export-item-failure' && typeof log.payload.summary === 'string'
+                        ? log.payload.summary
+                        : JSON.stringify(log.payload, null, 2)}
                     </pre>
                   ) : (
                     <p className="text-sm text-muted-foreground">

package/src/modules/data_sync/lib/adapter-registry.ts

@@ -1,15 +1,27 @@
 import type { DataSyncAdapter } from './adapter'
 
-const adapters = new Map<string, DataSyncAdapter>()
+const DATA_SYNC_ADAPTER_REGISTRY_KEY = Symbol.for('@open-mercato/data-sync/adapter-registry')
+
+type GlobalWithDataSyncRegistry = typeof globalThis & {
+  [DATA_SYNC_ADAPTER_REGISTRY_KEY]?: Map<string, DataSyncAdapter>
+}
+
+function getAdapterRegistry(): Map<string, DataSyncAdapter> {
+  const globalScope = globalThis as GlobalWithDataSyncRegistry
+  if (!globalScope[DATA_SYNC_ADAPTER_REGISTRY_KEY]) {
+    globalScope[DATA_SYNC_ADAPTER_REGISTRY_KEY] = new Map<string, DataSyncAdapter>()
+  }
+  return globalScope[DATA_SYNC_ADAPTER_REGISTRY_KEY]
+}
 
 export function registerDataSyncAdapter(adapter: DataSyncAdapter): void {
-  adapters.set(adapter.providerKey, adapter)
+  getAdapterRegistry().set(adapter.providerKey, adapter)
 }
 
 export function getDataSyncAdapter(providerKey: string): DataSyncAdapter | undefined {
-  return adapters.get(providerKey)
+  return getAdapterRegistry().get(providerKey)
 }
 
 export function getAllDataSyncAdapters(): DataSyncAdapter[] {
-  return Array.from(adapters.values())
+  return Array.from(getAdapterRegistry().values())
 }

package/src/modules/data_sync/lib/sync-engine.ts

@@ -9,6 +9,9 @@ import { emitDataSyncEvent } from '../events'
 import type { DataSyncAdapter, DataMapping, ExportBatch, ImportBatch } from './adapter'
 import { getDataSyncAdapter } from './adapter-registry'
 import type { SyncRunService } from './sync-run-service'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('data_sync').child({ component: 'sync-engine' })
 
 type SyncScope = {
   organizationId: string
@@ -149,6 +152,31 @@ export function createSyncEngine(deps: EngineDeps) {
     }
   }
 
+  async function logExportItemFailures(
+    runId: string,
+    integrationId: string,
+    results: ExportBatch['results'],
+    scope: SyncScope,
+  ): Promise<void> {
+    const failedResults = results.filter((result) => result.status === 'error' && result.error)
+    for (const result of failedResults) {
+      const label = result.externalId ? `${result.externalId} (id: ${result.localId})` : result.localId
+      const errorMessage = result.error!.split('\n')[0]
+      const message = `Failed to export item ${label}: ${errorMessage}`
+
+      await integrationLogService.write(
+        {
+          integrationId,
+          runId,
+          level: 'error',
+          message,
+          payload: { kind: 'export-item-failure', summary: result.error },
+        },
+        scope,
+      )
+    }
+  }
+
   async function writeOperationalLog(params: {
     integrationId: string
     runId: string
@@ -354,7 +382,7 @@ export function createSyncEngine(deps: EngineDeps) {
     async runImport(runId: string, batchSize: number, scope: SyncScope): Promise<void> {
       const run = await syncRunService.getRun(runId, scope)
       if (!run) {
-        console.warn(`[data-sync] Skipping stale import job for missing run ${runId}`)
+        logger.warn('Skipping stale import job for missing run', { runId })
         return
       }
       if (run.status === 'cancelled') {
@@ -499,7 +527,7 @@ export function createSyncEngine(deps: EngineDeps) {
     async runExport(runId: string, batchSize: number, scope: SyncScope): Promise<void> {
       const run = await syncRunService.getRun(runId, scope)
       if (!run) {
-        console.warn(`[data-sync] Skipping stale export job for missing run ${runId}`)
+        logger.warn('Skipping stale export job for missing run', { runId })
         return
       }
       if (run.status === 'cancelled') {
@@ -600,6 +628,7 @@ export function createSyncEngine(deps: EngineDeps) {
             scope,
           )
           await updateProgress(run.progressJobId, processedCount, null, scope)
+          await logExportItemFailures(run.id, run.integrationId, batch.results, scope)
 
           await writeOperationalLog({
             integrationId: run.integrationId,

package/src/modules/data_sync/workers/sync-export.ts

@@ -2,6 +2,9 @@ import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'
 import type { ProgressService } from '../../progress/lib/progressService'
 import type { SyncEngine } from '../lib/sync-engine'
 import type { SyncRunService } from '../lib/sync-run-service'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('data_sync').child({ component: 'sync-export' })
 
 type SyncJobPayload = {
   runId: string
@@ -50,7 +53,7 @@ export default async function handle(job: QueuedJob<SyncJobPayload>, ctx: Handle
         }
       }
     } catch (finalizeError) {
-      console.error('[data-sync] Failed to finalize crashed export worker job:', finalizeError)
+      logger.error('Failed to finalize crashed export worker job', { err: finalizeError })
     }
 
     throw error

package/src/modules/data_sync/workers/sync-import.ts

@@ -2,6 +2,9 @@ import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'
 import type { ProgressService } from '../../progress/lib/progressService'
 import type { SyncEngine } from '../lib/sync-engine'
 import type { SyncRunService } from '../lib/sync-run-service'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('data_sync').child({ component: 'sync-import' })
 
 type SyncJobPayload = {
   runId: string
@@ -50,7 +53,7 @@ export default async function handle(job: QueuedJob<SyncJobPayload>, ctx: Handle
         }
       }
     } catch (finalizeError) {
-      console.error('[data-sync] Failed to finalize crashed import worker job:', finalizeError)
+      logger.error('Failed to finalize crashed import worker job', { err: finalizeError })
     }
 
     throw error

package/src/modules/dictionaries/api/[dictionaryId]/entries/[entryId]/route.ts

@@ -21,6 +21,9 @@ import {
   dictionariesTag,
   updateDictionaryEntrySchema as updateEntryDocSchema,
 } from '../../../openapi'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dictionaries').child({ component: 'entries-api' })
 const paramsSchema = z.object({
   dictionaryId: z.string().uuid(),
   entryId: z.string().uuid(),
@@ -164,7 +167,7 @@ export async function PATCH(req: Request, ctx: { params?: { dictionaryId?: strin
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[dictionaries/:id/entries/:entryId.PATCH] Unexpected error', err)
+    logger.error('Failed to update dictionary entry', { err })
     return NextResponse.json({ error: 'Failed to update dictionary entry' }, { status: 500 })
   }
 }
@@ -238,7 +241,7 @@ export async function DELETE(req: Request, ctx: { params?: { dictionaryId?: stri
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[dictionaries/:id/entries/:entryId.DELETE] Unexpected error', err)
+    logger.error('Failed to delete dictionary entry', { err })
     return NextResponse.json({ error: 'Failed to delete dictionary entry' }, { status: 500 })
   }
 }

package/src/modules/dictionaries/api/[dictionaryId]/entries/reorder/route.ts

@@ -25,6 +25,9 @@ import {
   reorderEntriesRequestSchema,
 } from '../../../openapi'
 import { resolveDictionaryActorId } from '../../../context'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('dictionaries').child({ component: 'entries-api' })
 
 const paramsSchema = z.object({ dictionaryId: z.string().uuid() })
 
@@ -127,7 +130,7 @@ export async function POST(req: Request, ctx: { params?: { dictionaryId?: string
     if (isCrudHttpError(err)) {
       return NextResponse.json(err.body, { status: err.status })
     }
-    console.error('[dictionaries/:id/entries/reorder.POST] Unexpected error', err)
+    logger.error('Failed to reorder dictionary entries', { err })
     return NextResponse.json({ error: 'Failed to reorder dictionary entries' }, { status: 500 })
   }
 }