Communication Channels

communication_channels · @open-mercato/core Communication in 0.9.0

Unified hub bridging external chat/email channels (Slack, WhatsApp, Email) to the Messages module. Adapter contract, channel-native payload storage, reactions, and per-channel threading. OAuth state cookies are single-use via short-TTL cache markers (see lib/oauth-state.ts); multi-replica deployments MUST set CACHE_STRATEGY=redis so replay protection is shared across replicas.

Found by static analysis of the 0.9.0 source. Links that only appear at runtime are not visible here.

2 of the 3 modules outside the starter set that communication_channels needs in code are missing from its requires.

Before you enable `communication_channels` in 0.9.0

5 modules its code requires

✓ 1 declared⚠ 2 not declared, outside the starter set2 not declared, in every app

Enable these yourself, they are not in every starter app

integrations⚠ Gap messages⚠ Gap progress

Already enabled in every starter app: 2 modules.

3 more are optional: the module loses a feature without them.

4 calls could not be resolved. See Couldn't resolve.

Before you disable `communication_channels` in 0.9.0

10 modules require it in code

Declared in `requires` by

channel_resendchannel_sespush_notifications

Not declared by

channel_apns⚠ Gap channel_discord⚠ Gap channel_expo⚠ Gap channel_fcm⚠ Gap channel_gmail⚠ Gap channel_imap⚠ Gap customers⚠ Gap

1 more uses it optionally or for collaboration.

Required, declared ⚠ Gap: required in code, not in requires ⚠ Gap into a module every starter app has (lower risk) Optional Collaboration In requires only, not seen in code In every starter appA dot takes its module's area colour. Each side lists the areas in the order of the map.Reads left to right: what uses it → communication_channels → what it needs. Select a module to go to its row.

Needs

Modules communication_channels needs in 0.9.0
Module	In code	requires	package.json
Module: `integrations`	In code: Required · api, lib	requires: ⚠ Gap	package.json: Same package
18 places Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/get/oauth/[provider]/callback/route.ts:166` · `integrationCredentialsService` Entity import in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/get/oauth/[provider]/callback/route.ts:261` · `@open-mercato/core/modules/integrations/data/entities` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/channels/[id]/test-send/route.ts:198` · `integrationCredentialsService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/oauth/[provider]/initiate/route.ts:98` · `integrationCredentialsService` Service lookup (DI) → Required · api · `packages/core/src/modules/communication_channels/api/post/test-seed/route.ts:331` · `integrationCredentialsService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/webhook/[provider]/route.ts:89` · `integrationCredentialsService` Service lookup (DI) in try/catch → Optional · command · `packages/core/src/modules/communication_channels/commands/connect-credential-channel.ts:132` · `integrationCredentialsService` Entity import in try/catch → Optional · command · `packages/core/src/modules/communication_channels/commands/connect-credential-channel.ts:177` · `@open-mercato/core/modules/integrations/data/entities` Service lookup (DI) in try/catch → Optional · command · `packages/core/src/modules/communication_channels/commands/deliver-outbound-message.ts:277` · `integrationCredentialsService` Service lookup (DI) in try/catch → Optional · command · `packages/core/src/modules/communication_channels/commands/deliver-outbound-message.ts:312` · `integrationLogService` and 8 more in `packages/core/src/modules/communication_channels`
Module: `messages`	In code: Required · command, data, subscriber	requires: ⚠ Gap	package.json: Same package
9 places Entity import → Required · command · `packages/core/src/modules/communication_channels/commands/deliver-outbound-message.ts:19` · `../../messages/data/entities` Entity import → Required · command · `packages/core/src/modules/communication_channels/commands/toggle-outbound-reaction.ts:7` · `../../messages/data/entities` Import → Required · data · `packages/core/src/modules/communication_channels/data/enrichers.ts:4` · `../../messages/lib/participantScope` Entity import → Required · subscriber · `packages/core/src/modules/communication_channels/subscribers/outbound-bridge.ts:4` · `../../messages/data/entities` Import → Required · subscriber · `packages/core/src/modules/communication_channels/subscribers/outbound-bridge.ts:5` · `../../messages/lib/messageSourceEntityTypes` Event subscription → Collaboration · subscriber · `packages/core/src/modules/communication_channels/subscribers/outbound-bridge.ts:33` · `messages.message.sent` Widget injection → Collaboration · ui · `packages/core/src/modules/communication_channels/widgets/injection-table.ts:15` · `data-table:messages:columns` Widget injection → Collaboration · ui · `packages/core/src/modules/communication_channels/widgets/injection-table.ts:21` · `detail:messages:message:body:after` Widget injection → Collaboration · ui · `packages/core/src/modules/communication_channels/widgets/injection-table.ts:31` · `detail:messages:message:sidebar`
Module: `progress`	In code: Required · command, worker	requires: ✓ Declared	package.json: Same package
2 places Service lookup (DI) → Required · command · `packages/core/src/modules/communication_channels/commands/queue-import-history.ts:168` · `progressService` Service lookup (DI) → Required · worker · `packages/core/src/modules/communication_channels/workers/channel-import-history.ts:71` · `progressService`
Module: `scheduler`	In code: Optional · setup	requires: Not declared	package.json: ⚠ Not in package.json
1 place Service lookup (DI) behind a registration check → Optional · setup · `packages/core/src/modules/communication_channels/setup.ts:202` · `schedulerService`

In every app (4)

Modules communication_channels needs in 0.9.0 that every starter app enables
Module	In code	requires	package.json
Module: `directory`	In code: Required · api	requires: ⚠ Gap in every app	package.json: Same package
6 places Import → Required · api · `packages/core/src/modules/communication_channels/api/get/channels/[id]/health/route.ts:8` · `@open-mercato/core/modules/directory/utils/organizationScope` Import → Required · api · `packages/core/src/modules/communication_channels/api/get/channels/[id]/health/route.ts:9` · `@open-mercato/core/modules/directory/utils/organizationScopeFilter` Import → Required · api · `packages/core/src/modules/communication_channels/api/get/channels/[id]/route.ts:7` · `@open-mercato/core/modules/directory/utils/organizationScope` Import → Required · api · `packages/core/src/modules/communication_channels/api/get/channels/[id]/route.ts:8` · `@open-mercato/core/modules/directory/utils/organizationScopeFilter` Import → Required · api · `packages/core/src/modules/communication_channels/api/get/channels/route.ts:7` · `@open-mercato/core/modules/directory/utils/organizationScope` Import → Required · api · `packages/core/src/modules/communication_channels/api/get/channels/route.ts:8` · `@open-mercato/core/modules/directory/utils/organizationScopeFilter`
Module: `notifications`	In code: Required · subscriber	requires: ⚠ Gap in every app	package.json: Same package
2 places Import → Required · subscriber · `packages/core/src/modules/communication_channels/subscribers/channel-requires-reauth-notification.ts:5` · `../../notifications/lib/notificationBuilder` Import → Required · subscriber · `packages/core/src/modules/communication_channels/subscribers/channel-requires-reauth-notification.ts:9` · `../../notifications/lib/notificationService`
Module: `auth`	In code: Optional · api	requires: Not declared	package.json: Same package
10 places Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/delete/admin/channels/[id]/route.ts:86` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/delete/channels/[id]/route.ts:83` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/get/channels/[id]/health/route.ts:84` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/get/channels/[id]/route.ts:71` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/channels/[id]/import-history/route.ts:116` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/channels/[id]/poll-now/route.ts:80` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/channels/[id]/push/register/route.ts:81` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/channels/[id]/test-send/route.ts:135` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/core/src/modules/communication_channels/api/post/test-seed/route.ts:485` · `rbacService` Event subscription → Collaboration · subscriber · `packages/core/src/modules/communication_channels/subscribers/user-deleted-cascade.ts:35` · `auth.user.deleted`
Module: `query_index`	In code: Optional · lib	requires: Not declared	package.json: Same package
1 place Service lookup (DI) in try/catch → Optional · lib · `packages/core/src/modules/communication_channels/lib/contact-resolver.ts:121` · `queryEngine`

Used by

Modules that use communication_channels in 0.9.0
Module	In code	requires	package.json
Module: `channel_apns`	In code: Required · di, lib, setup, ui	requires: ⚠ Gap	package.json: ✓ Declared
8 places Import → Required · di · `packages/channel-apns/src/modules/channel_apns/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-apns/src/modules/channel_apns/lib/adapter.ts:6` · `@open-mercato/core/modules/communication_channels/lib/push-adapter` Import → Required · lib · `packages/channel-apns/src/modules/channel_apns/lib/adapter.ts:12` · `@open-mercato/core/modules/communication_channels/lib/refcounted-client-cache` Import → Required · lib · `packages/channel-apns/src/modules/channel_apns/lib/adapter.ts:13` · `@open-mercato/core/modules/communication_channels/lib/push-envelope` Import → Required · lib · `packages/channel-apns/src/modules/channel_apns/lib/credentials.ts:4` · `@open-mercato/core/modules/communication_channels/lib/push-credential-errors` Import → Required · setup · `packages/channel-apns/src/modules/channel_apns/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Widget injection → Collaboration · ui · `packages/channel-apns/src/modules/channel_apns/widgets/injection-table.ts:5` · `data-table:communication_channels.channels:toolbar` Import → Required · ui · `packages/channel-apns/src/modules/channel_apns/widgets/injection/connect/widget.client.tsx:9` · `@open-mercato/core/modules/communication_channels/lib/push-connect-error`
Module: `channel_discord`	In code: Required · api, command, di, lib, setup, subscriber, worker	requires: ⚠ Gap	package.json: ✓ Declared
20 places Entity import → Required · api · `packages/channel-discord/src/modules/channel_discord/api/ai-auto-reply/channels/route.ts:9` · `@open-mercato/core/modules/communication_channels/data/entities` Import → Required · api · `packages/channel-discord/src/modules/channel_discord/api/ai-auto-reply/channels/route.ts:10` · `@open-mercato/core/modules/communication_channels/lib/access-control` Import → Required · api · `packages/channel-discord/src/modules/channel_discord/api/channels/[id]/ai-auto-reply/route.ts:10` · `@open-mercato/core/modules/communication_channels/lib/route-mutation-guard` Entity import → Required · api · `packages/channel-discord/src/modules/channel_discord/api/interactions/route.ts:7` · `@open-mercato/core/modules/communication_channels/data/entities` Entity import → Required · command · `packages/channel-discord/src/modules/channel_discord/commands/update-ai-auto-reply.ts:8` · `@open-mercato/core/modules/communication_channels/data/entities` Import → Required · command · `packages/channel-discord/src/modules/channel_discord/commands/update-ai-auto-reply.ts:9` · `@open-mercato/core/modules/communication_channels/lib/access-control` Import → Required · di · `packages/channel-discord/src/modules/channel_discord/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Entity import → Required · lib · `packages/channel-discord/src/modules/channel_discord/lib/ai-proposal.ts:5` · `@open-mercato/core/modules/communication_channels/data/entities` Import → Required · lib · `packages/channel-discord/src/modules/channel_discord/lib/ai-service-principal.ts:3` · `@open-mercato/core/modules/communication_channels/lib/system-user` Entity import → Required · lib · `packages/channel-discord/src/modules/channel_discord/lib/channel-access.ts:7` · `@open-mercato/core/modules/communication_channels/data/entities` and 10 more in `packages/channel-discord/src/modules/channel_discord`
Module: `channel_expo`	In code: Required · di, lib, setup, ui	requires: ⚠ Gap	package.json: ✓ Declared
6 places Import → Required · di · `packages/channel-expo/src/modules/channel_expo/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-expo/src/modules/channel_expo/lib/adapter.ts:6` · `@open-mercato/core/modules/communication_channels/lib/push-adapter` Import → Required · lib · `packages/channel-expo/src/modules/channel_expo/lib/adapter.ts:14` · `@open-mercato/core/modules/communication_channels/lib/push-envelope` Import → Required · setup · `packages/channel-expo/src/modules/channel_expo/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Widget injection → Collaboration · ui · `packages/channel-expo/src/modules/channel_expo/widgets/injection-table.ts:5` · `data-table:communication_channels.channels:toolbar` Import → Required · ui · `packages/channel-expo/src/modules/channel_expo/widgets/injection/connect/widget.client.tsx:9` · `@open-mercato/core/modules/communication_channels/lib/push-connect-error`
Module: `channel_fcm`	In code: Required · di, lib, setup, ui	requires: ⚠ Gap	package.json: ✓ Declared
8 places Import → Required · di · `packages/channel-fcm/src/modules/channel_fcm/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-fcm/src/modules/channel_fcm/lib/adapter.ts:6` · `@open-mercato/core/modules/communication_channels/lib/push-adapter` Import → Required · lib · `packages/channel-fcm/src/modules/channel_fcm/lib/adapter.ts:12` · `@open-mercato/core/modules/communication_channels/lib/refcounted-client-cache` Import → Required · lib · `packages/channel-fcm/src/modules/channel_fcm/lib/adapter.ts:13` · `@open-mercato/core/modules/communication_channels/lib/push-envelope` Import → Required · lib · `packages/channel-fcm/src/modules/channel_fcm/lib/credentials.ts:2` · `@open-mercato/core/modules/communication_channels/lib/push-credential-errors` Import → Required · setup · `packages/channel-fcm/src/modules/channel_fcm/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Widget injection → Collaboration · ui · `packages/channel-fcm/src/modules/channel_fcm/widgets/injection-table.ts:5` · `data-table:communication_channels.channels:toolbar` Import → Required · ui · `packages/channel-fcm/src/modules/channel_fcm/widgets/injection/connect/widget.client.tsx:9` · `@open-mercato/core/modules/communication_channels/lib/push-connect-error`
Module: `channel_gmail`	In code: Required · di, lib, setup, ui	requires: ⚠ Gap	package.json: ✓ Declared
11 places Import → Required · di · `packages/channel-gmail/src/modules/channel_gmail/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/adapter.ts:56` · `@open-mercato/core/modules/communication_channels/lib/email-contact` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/adapter.ts:57` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/adapter.ts:58` · `@open-mercato/core/modules/communication_channels/lib/import-history-limits` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/capabilities.ts:2` · `@open-mercato/core/modules/communication_channels/lib/email-capabilities` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/convert-outbound.ts:5` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/health.ts:1` · `@open-mercato/core/modules/communication_channels/lib/provider-health` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/normalize-inbound.ts:2` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-gmail/src/modules/channel_gmail/lib/oauth.ts:12` · `@open-mercato/core/modules/communication_channels/lib/oauth-token` Import → Required · setup · `packages/channel-gmail/src/modules/channel_gmail/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` and 1 more in `packages/channel-gmail/src/modules/channel_gmail`
Module: `channel_imap`	In code: Required · di, lib, setup	requires: ⚠ Gap	package.json: ✓ Declared
8 places Import → Required · di · `packages/channel-imap/src/modules/channel_imap/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-imap/src/modules/channel_imap/lib/adapter.ts:34` · `@open-mercato/core/modules/communication_channels/lib/email-contact` Import → Required · lib · `packages/channel-imap/src/modules/channel_imap/lib/adapter.ts:35` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-imap/src/modules/channel_imap/lib/adapter.ts:36` · `@open-mercato/core/modules/communication_channels/lib/import-history-limits` Import → Required · lib · `packages/channel-imap/src/modules/channel_imap/lib/capabilities.ts:2` · `@open-mercato/core/modules/communication_channels/lib/email-capabilities` Import → Required · lib · `packages/channel-imap/src/modules/channel_imap/lib/convert-outbound.ts:5` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-imap/src/modules/channel_imap/lib/normalize-inbound.ts:2` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · setup · `packages/channel-imap/src/modules/channel_imap/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton`
Module: `customers`	In code: Required · api	requires: ⚠ Gap	package.json: Same package
4 places Service lookup (DI) → Required · api · `packages/core/src/modules/customers/api/people/[id]/emails/route.ts:118` · `communicationChannelsSendAsUser` Event subscription → Collaboration · subscriber · `packages/core/src/modules/customers/subscribers/channel-visibility-changed.ts:36` · `communication_channels.channel.visibility_changed` Event subscription → Collaboration · subscriber · `packages/core/src/modules/customers/subscribers/link-channel-message-received.ts:16` · `communication_channels.message.received` Event subscription → Collaboration · subscriber · `packages/core/src/modules/customers/subscribers/link-channel-message-sent.ts:16` · `communication_channels.message.sent`
Module: `channel_resend`	In code: Required · di, lib, module-config, setup	requires: ✓ Declared	package.json: ✓ Declared
7 places Import → Required · module-config · `packages/channel-resend/src/modules/channel_resend/capabilities.ts:1` · `@open-mercato/core/modules/communication_channels/lib/email-capabilities` Import → Required · di · `packages/channel-resend/src/modules/channel_resend/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-resend/src/modules/channel_resend/lib/adapter.ts:14` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-resend/src/modules/channel_resend/lib/preset.ts:5` · `@open-mercato/core/modules/communication_channels/lib/ensure-system-email-channel` Import → Required · lib · `packages/channel-resend/src/modules/channel_resend/lib/preset.ts:6` · `@open-mercato/core/modules/communication_channels/lib/system-email-provider-config` Import → Required · lib · `packages/channel-resend/src/modules/channel_resend/lib/system-email-config.ts:1` · `@open-mercato/core/modules/communication_channels/lib/system-email-provider-config` Import → Required · setup · `packages/channel-resend/src/modules/channel_resend/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton`
Module: `channel_ses`	In code: Required · di, lib, module-config, setup	requires: ✓ Declared	package.json: ✓ Declared
7 places Import → Required · module-config · `packages/channel-ses/src/modules/channel_ses/capabilities.ts:1` · `@open-mercato/core/modules/communication_channels/lib/email-capabilities` Import → Required · di · `packages/channel-ses/src/modules/channel_ses/di.ts:3` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton` Import → Required · lib · `packages/channel-ses/src/modules/channel_ses/lib/adapter.ts:15` · `@open-mercato/core/modules/communication_channels/lib/email-mime` Import → Required · lib · `packages/channel-ses/src/modules/channel_ses/lib/preset.ts:5` · `@open-mercato/core/modules/communication_channels/lib/ensure-system-email-channel` Import → Required · lib · `packages/channel-ses/src/modules/channel_ses/lib/preset.ts:6` · `@open-mercato/core/modules/communication_channels/lib/system-email-provider-config` Import → Required · lib · `packages/channel-ses/src/modules/channel_ses/lib/system-email-config.ts:1` · `@open-mercato/core/modules/communication_channels/lib/system-email-provider-config` Import → Required · setup · `packages/channel-ses/src/modules/channel_ses/setup.ts:2` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton`
Module: `push_notifications`	In code: Required · lib	requires: ✓ Declared	package.json: Same package
6 places Import → Required · lib · `packages/core/src/modules/push_notifications/lib/push-delivery.ts:6` · `@open-mercato/core/modules/communication_channels/lib/push-adapter` Import → Required · lib · `packages/core/src/modules/push_notifications/lib/push-delivery.ts:7` · `@open-mercato/core/modules/communication_channels/lib/credential-refresh` Import → Required · lib · `packages/core/src/modules/push_notifications/lib/push-receipt-reaper.ts:4` · `@open-mercato/core/modules/communication_channels/lib/push-adapter` Import → Required · lib · `packages/core/src/modules/push_notifications/lib/push-stub-adapter.ts:6` · `@open-mercato/core/modules/communication_channels/lib/push-adapter` Import → Required · lib · `packages/core/src/modules/push_notifications/lib/push-stub-adapter.ts:11` · `@open-mercato/core/modules/communication_channels/lib/push-envelope` Import → Required · lib · `packages/core/src/modules/push_notifications/lib/push-stub-adapter.ts:12` · `@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton`
Module: `messages`	In code: Optional · lib	requires: Not declared	package.json: Same package
3 places Service lookup (DI) in try/catch → Optional · lib · `packages/core/src/modules/messages/lib/channelThreadAccess.ts:50` · `communicationChannelsResolveChannelThreadAccess` Service lookup (DI) in try/catch → Optional · lib · `packages/core/src/modules/messages/lib/composeSenderDelegation.ts:55` · `communicationChannelsSendAsUser` Service lookup (DI) in try/catch → Optional · lib · `packages/core/src/modules/messages/lib/composeSourceChannelType.ts:54` · `communicationChannelsResolveChannelType`