@open-mercato/channel-resend 0.7.1-develop.7151.1.00d0391847

package/src/modules/channel_resend/lib/health.ts

@@ -0,0 +1,51 @@
+import type { IntegrationScope } from '@open-mercato/shared/modules/integrations/types'
+import { fetchWithTimeout } from '@open-mercato/shared/lib/http/fetchWithTimeout'
+import { resendCredentialsSchema } from './credentials'
+
+type HealthCheckResult = {
+  status: 'healthy' | 'unhealthy'
+  message: string
+  details: Record<string, unknown>
+}
+
+export const channelResendHealthCheck = {
+  async check(
+    credentials: Record<string, unknown> | null,
+    _scope: IntegrationScope,
+  ): Promise<HealthCheckResult> {
+    const parsed = resendCredentialsSchema.safeParse(credentials ?? {})
+    if (!parsed.success) {
+      return {
+        status: 'unhealthy',
+        message: `Resend credentials invalid: ${parsed.error.issues[0]?.message ?? 'unknown validation error'}`,
+        details: { reason: 'invalid_credentials' },
+      }
+    }
+
+    try {
+      const response = await fetchWithTimeout('https://api.resend.com/domains?limit=1', {
+        headers: { Authorization: `Bearer ${parsed.data.apiKey}` },
+        timeoutMs: 8_000,
+      })
+      if (!response.ok) {
+        return {
+          status: 'unhealthy',
+          message: `Resend API rejected the credentials with status ${response.status}`,
+          details: { reason: 'api_rejected', status: response.status },
+        }
+      }
+      return {
+        status: 'healthy',
+        message: 'Resend API credentials are valid',
+        details: { endpoint: 'domains' },
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Resend API request failed'
+      return {
+        status: 'unhealthy',
+        message: `Resend health check failed: ${message}`,
+        details: { reason: 'request_failed' },
+      }
+    }
+  },
+}

package/src/modules/channel_resend/lib/preset.ts

@@ -0,0 +1,95 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import type { AppContainer } from '@open-mercato/shared/lib/di/container'
+import { normalizeEnvString, resolveDefaultEmailFromAddress } from '@open-mercato/shared/lib/email/config'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import { ensureSystemEmailChannel } from '@open-mercato/core/modules/communication_channels/lib/ensure-system-email-channel'
+import { isSelectedSystemEmailProvider } from '@open-mercato/core/modules/communication_channels/lib/system-email-provider-config'
+import { resendCapabilities } from '../capabilities'
+
+const logger = createLogger('channel_resend')
+
+type PresetScope = {
+  em: EntityManager
+  container: AppContainer
+  tenantId: string
+  organizationId: string
+}
+
+type CredentialsServiceLike = {
+  save: (
+    integrationId: string,
+    credentials: Record<string, unknown>,
+    scope: { organizationId: string; tenantId: string; userId?: string | null },
+  ) => Promise<void>
+}
+
+type IntegrationStateServiceLike = {
+  upsert: (
+    integrationId: string,
+    input: { isEnabled: boolean },
+    scope: { organizationId: string; tenantId: string },
+  ) => Promise<unknown>
+}
+
+export function readResendEnvPreset(): { apiKey: string; fromAddress: string } | null {
+  const apiKey = normalizeEnvString(process.env.RESEND_API_KEY)
+  const fromAddress = resolveDefaultEmailFromAddress()
+  if (!apiKey || !fromAddress) {
+    // A key with no from-address is the trap worth naming: `.env.example` documents RESEND_API_KEY
+    // prominently but the from-address separately, so this combination looks configured and seeds
+    // nothing. Say so rather than returning null in silence.
+    if (apiKey && !fromAddress) {
+      logger.warn('RESEND_API_KEY is set but no from-address is configured; skipping Resend preset', {
+        remedy: 'set NOTIFICATIONS_EMAIL_FROM, EMAIL_FROM, or ADMIN_EMAIL',
+      })
+    }
+    return null
+  }
+  return { apiKey, fromAddress }
+}
+
+export async function applyResendEnvPreset(ctx: PresetScope): Promise<void> {
+  // Only the provider this instance actually selected seeds anything, so a leftover RESEND_API_KEY
+  // on an instance that moved to `SYSTEM_EMAIL_PROVIDER=ses` no longer advertises an Enabled Resend
+  // integration and a connected channel that nothing sends through. `resend` is the default, so the
+  // documented `RESEND_API_KEY`-only setup is unaffected.
+  if (!isSelectedSystemEmailProvider('resend')) return
+  const preset = readResendEnvPreset()
+  if (!preset) return
+
+  let credentialsService: CredentialsServiceLike
+  try {
+    credentialsService = ctx.container.resolve('integrationCredentialsService') as CredentialsServiceLike
+  } catch {
+    return
+  }
+
+  await credentialsService.save('channel_resend', preset, {
+    tenantId: ctx.tenantId,
+    organizationId: ctx.organizationId,
+    userId: null,
+  })
+
+  try {
+    const integrationStateService = ctx.container.resolve('integrationStateService') as IntegrationStateServiceLike
+    await integrationStateService.upsert('channel_resend', { isEnabled: true }, {
+      tenantId: ctx.tenantId,
+      organizationId: ctx.organizationId,
+    })
+  } catch (err) {
+    logger.warn('Failed to enable the Resend integration state; Integrations will read Disabled while email is live', {
+      err,
+      tenantId: ctx.tenantId,
+      organizationId: ctx.organizationId,
+    })
+  }
+
+  await ensureSystemEmailChannel(ctx.em, {
+    tenantId: ctx.tenantId,
+    organizationId: ctx.organizationId,
+    providerKey: 'resend',
+    externalIdentifier: preset.fromAddress,
+    displayName: 'Resend system email',
+    capabilities: { ...resendCapabilities },
+  })
+}

package/src/modules/channel_resend/lib/system-email-config.ts

@@ -0,0 +1,10 @@
+import { registerSystemEmailProviderConfigResolver } from '@open-mercato/core/modules/communication_channels/lib/system-email-provider-config'
+import { readResendEnvPreset } from './preset'
+
+export function registerResendSystemEmailConfigResolver(): void {
+  registerSystemEmailProviderConfigResolver({
+    providerKey: 'resend',
+    isConfigured: () => Boolean(readResendEnvPreset()),
+    resolveCredentials: ({ fromAddress }) => readResendEnvPreset() ?? { fromAddress },
+  })
+}

package/src/modules/channel_resend/setup.ts

@@ -0,0 +1,30 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import {
+  hasChannelAdapter,
+  registerChannelAdapter,
+} from '@open-mercato/core/modules/communication_channels/lib/adapter-registry-singleton'
+import { getResendChannelAdapter } from './lib/adapter'
+import { applyResendEnvPreset } from './lib/preset'
+import { registerResendSystemEmailConfigResolver } from './lib/system-email-config'
+
+function ensureResendAdapterRegistered(): void {
+  if (hasChannelAdapter('resend')) return
+  registerChannelAdapter(getResendChannelAdapter())
+}
+
+ensureResendAdapterRegistered()
+registerResendSystemEmailConfigResolver()
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    superadmin: ['channel_resend.view', 'channel_resend.configure'],
+    admin: ['channel_resend.view', 'channel_resend.configure'],
+  },
+  async seedDefaults(ctx) {
+    ensureResendAdapterRegistered()
+    registerResendSystemEmailConfigResolver()
+    await applyResendEnvPreset(ctx)
+  },
+}
+
+export default setup

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/__tests__/**"]
+}

package/watch.mjs

@@ -0,0 +1,7 @@
+import { watch } from '../../scripts/watch.mjs'
+import { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+watch(__dirname)