@open-mercato/core 0.6.8-develop.6998.1.d2bc46c56c → 0.6.8-develop.7001.1.03608ab252

package/src/modules/warranty_claims/subscribers/auto-vendor-recovery.ts

@@ -0,0 +1,140 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import type { AwilixContainer } from 'awilix'
+import type { CommandBus, CommandRuntimeContext } from '@open-mercato/shared/lib/commands'
+import { isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { WarrantyClaim, WarrantyClaimLine, WarrantyVendorPolicy } from '../data/entities'
+import type { VendorRecoveryInput } from '../data/validators'
+import {
+  buildVendorRecoveryCommandRequests,
+  findVendorRecoveryMatches,
+} from '../lib/vendorPolicyRecovery'
+
+export const metadata = {
+  event: 'warranty_claims.claim.status_changed',
+  persistent: true,
+  id: 'warranty_claims:auto-vendor-recovery',
+}
+
+type ResolverContainer = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+type ResolverContext = ResolverContainer & {
+  container?: ResolverContainer
+  tenantId?: string | null
+  organizationId?: string | null
+}
+
+function readString(record: Record<string, unknown>, key: string): string | null {
+  const value = record[key]
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+function toRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}
+}
+
+function resolveContainer(ctx: ResolverContext): ResolverContainer {
+  return ctx.container ?? { resolve: ctx.resolve }
+}
+
+function isBenignVendorRecoveryNoop(error: unknown): boolean {
+  if (!isCrudHttpError(error)) return false
+  if (error.status !== 400) return false
+  return error.body.error === 'warranty_claims.errors.vendorRecoveryNeedsResolvedLines'
+}
+
+export default async function handle(payload: unknown, ctx: ResolverContext): Promise<void> {
+  const record = toRecord(payload)
+  const toStatus = readString(record, 'toStatus') ?? readString(record, 'status')
+  if (toStatus !== 'resolved') return
+  const claimId = readString(record, 'claimId') ?? readString(record, 'id')
+  const tenantId = ctx.tenantId ?? null
+  const organizationId = ctx.organizationId ?? null
+  if (!claimId || !tenantId || !organizationId) return
+
+  const container = resolveContainer(ctx)
+  const em = container.resolve<EntityManager>('em').fork()
+  const scope = { tenantId, organizationId }
+  const claim = await findOneWithDecryption(
+    em,
+    WarrantyClaim,
+    { id: claimId, tenantId, organizationId, deletedAt: null },
+    {},
+    scope,
+  )
+  if (!claim || claim.claimType !== 'warranty' || claim.status !== 'resolved') return
+
+  const lines = await findWithDecryption(
+    em,
+    WarrantyClaimLine,
+    {
+      claim: claim.id,
+      tenantId,
+      organizationId,
+      lineStatus: 'resolved',
+      vendorClaimLineId: null,
+      // Do not pre-filter on a per-line vendor name: the matcher now falls back to the
+      // claim-level vendor name, so vendor-less resolved lines must still be considered (VENDOR-05).
+      deletedAt: null,
+    },
+    { orderBy: { lineNo: 'ASC' } },
+    scope,
+  )
+  if (!lines.length) return
+
+  const policies = await findWithDecryption(
+    em,
+    WarrantyVendorPolicy,
+    {
+      tenantId,
+      organizationId,
+      isActive: true,
+      autoGenerateRecovery: true,
+      deletedAt: null,
+    },
+    { orderBy: { vendorName: 'ASC', updatedAt: 'DESC' } },
+    scope,
+  )
+  if (!policies.length) return
+
+  const matches = findVendorRecoveryMatches({
+    claim,
+    lines,
+    policies,
+    autoOnly: true,
+    requireWarrantyResolved: true,
+  })
+  const requests = buildVendorRecoveryCommandRequests(claim.id, matches)
+  if (!requests.length) return
+
+  const commandBus = container.resolve<CommandBus>('commandBus')
+  const commandCtx: CommandRuntimeContext = {
+    container: container as unknown as AwilixContainer,
+    auth: null,
+    organizationScope: null,
+    selectedOrganizationId: organizationId,
+    organizationIds: [organizationId],
+  }
+
+  for (const request of requests) {
+    const input: VendorRecoveryInput = {
+      claimId: request.claimId,
+      organizationId,
+      tenantId,
+      lineIds: request.lineIds,
+      vendorName: request.vendorName,
+      vendorRef: request.vendorRef,
+    }
+    try {
+      await commandBus.execute<VendorRecoveryInput, { claimId: string }>(
+        'warranty_claims.claim.create_vendor_recovery',
+        { input, ctx: commandCtx },
+      )
+    } catch (error) {
+      if (isBenignVendorRecoveryNoop(error)) continue
+      throw error
+    }
+  }
+}

package/src/modules/warranty_claims/subscribers/claim-assigned-notification.ts

@@ -0,0 +1,54 @@
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { notificationTypes } from '../notifications'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('warranty_claims')
+
+export const metadata = {
+  event: 'warranty_claims.claim.assigned',
+  persistent: true,
+  id: 'warranty_claims:claim-assigned-notification',
+}
+
+type ResolverContext = {
+  resolve: <T = unknown>(name: string) => T
+  container?: { resolve<T = unknown>(name: string): T }
+  tenantId?: string | null
+  organizationId?: string | null
+}
+
+function readString(record: Record<string, unknown>, key: string): string | null {
+  const value = record[key]
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+export default async function handle(payload: unknown, ctx: ResolverContext): Promise<void> {
+  const record = payload && typeof payload === 'object' ? payload as Record<string, unknown> : {}
+  const claimId = readString(record, 'claimId') ?? readString(record, 'id')
+  const claimNumber = readString(record, 'claimNumber') ?? ''
+  const tenantId = ctx.tenantId ?? null
+  const organizationId = ctx.organizationId ?? null
+  const assigneeUserId = readString(record, 'assigneeUserId')
+  if (!claimId || !tenantId || !organizationId || !assigneeUserId) return
+
+  try {
+    const notificationService = resolveNotificationService(ctx.container ?? { resolve: ctx.resolve })
+    const typeDef = notificationTypes.find((type) => type.type === 'warranty_claims.claim.assigned')
+    if (!typeDef) return
+    const notificationInput = buildNotificationFromType(typeDef, {
+      recipientUserId: assigneeUserId,
+      bodyVariables: { claimNumber },
+      sourceEntityType: 'warranty_claims:warranty_claim',
+      sourceEntityId: claimId,
+      linkHref: `/backend/warranty_claims/${claimId}`,
+      groupKey: `warranty_claims.claim.assigned:${claimId}:${assigneeUserId}`,
+    })
+    await notificationService.create(notificationInput, {
+      tenantId,
+      organizationId,
+    })
+  } catch (err) {
+    logger.warn('[warranty_claims:claim-assigned-notification] create failed', { err })
+  }
+}

package/src/modules/warranty_claims/subscribers/claim-customer-reply-notification.ts

@@ -0,0 +1,68 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { WarrantyClaim } from '../data/entities'
+import { notificationTypes } from '../notifications'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('warranty_claims')
+
+export const metadata = {
+  event: 'warranty_claims.claim.comment_added',
+  persistent: true,
+  id: 'warranty_claims:claim-customer-reply-notification',
+}
+
+type ResolverContext = {
+  resolve: <T = unknown>(name: string) => T
+  container?: { resolve<T = unknown>(name: string): T }
+  tenantId?: string | null
+  organizationId?: string | null
+}
+
+function readString(record: Record<string, unknown>, key: string): string | null {
+  const value = record[key]
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+export default async function handle(payload: unknown, ctx: ResolverContext): Promise<void> {
+  const record = payload && typeof payload === 'object' ? payload as Record<string, unknown> : {}
+  const actorCustomerId = readString(record, 'actorCustomerId')
+  if (!actorCustomerId) return
+  const claimId = readString(record, 'claimId') ?? readString(record, 'id')
+  const tenantId = ctx.tenantId ?? null
+  const organizationId = ctx.organizationId ?? null
+  if (!claimId || !tenantId || !organizationId) return
+
+  try {
+    const em = (ctx.resolve('em') as EntityManager).fork()
+    const scope = { tenantId, organizationId }
+    const claim = await findOneWithDecryption(
+      em,
+      WarrantyClaim,
+      { id: claimId, tenantId, organizationId, deletedAt: null },
+      {},
+      scope,
+    )
+    const assigneeUserId = claim?.assigneeUserId ?? null
+    if (!claim || !assigneeUserId) return
+    const notificationService = resolveNotificationService(ctx.container ?? { resolve: ctx.resolve })
+    const typeDef = notificationTypes.find((type) => type.type === 'warranty_claims.claim.customer_replied')
+    if (!typeDef) return
+    const notificationInput = buildNotificationFromType(typeDef, {
+      recipientUserId: assigneeUserId,
+      bodyVariables: { claimNumber: claim.claimNumber },
+      sourceEntityType: 'warranty_claims:warranty_claim',
+      sourceEntityId: claim.id,
+      linkHref: `/backend/warranty_claims/${claim.id}`,
+      groupKey: `warranty_claims.claim.customer_replied:${claim.id}:${assigneeUserId}`,
+    })
+    await notificationService.create(notificationInput, {
+      tenantId,
+      organizationId,
+    })
+  } catch (err) {
+    logger.warn('[warranty_claims:claim-customer-reply-notification] create failed', { err })
+  }
+}

package/src/modules/warranty_claims/subscribers/claim-status-notification.ts

@@ -0,0 +1,100 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildBatchNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { WarrantyClaim, WarrantyClaimEvent } from '../data/entities'
+import { notificationTypes } from '../notifications'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('warranty_claims')
+
+export const metadata = {
+  event: 'warranty_claims.claim.status_changed',
+  persistent: true,
+  id: 'warranty_claims:claim-status-notification',
+}
+
+type ResolverContext = {
+  resolve: <T = unknown>(name: string) => T
+  container?: { resolve<T = unknown>(name: string): T }
+  tenantId?: string | null
+  organizationId?: string | null
+}
+
+function readString(record: Record<string, unknown>, key: string): string | null {
+  const value = record[key]
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+function readEventPayload(event: WarrantyClaimEvent): Record<string, unknown> {
+  return event.payload && typeof event.payload === 'object' && !Array.isArray(event.payload)
+    ? event.payload
+    : {}
+}
+
+async function resolveCreatorUserId(
+  em: EntityManager,
+  claimId: string,
+  scope: { tenantId: string; organizationId: string },
+): Promise<string | null> {
+  const events = await findWithDecryption(
+    em,
+    WarrantyClaimEvent,
+    { claim: claimId, tenantId: scope.tenantId, organizationId: scope.organizationId },
+    { orderBy: { createdAt: 'asc' }, limit: 25 },
+    scope,
+  )
+  for (const event of events) {
+    const payload = readEventPayload(event)
+    if (event.kind === 'system' && payload.action === 'created' && event.actorUserId) {
+      return event.actorUserId
+    }
+  }
+  return null
+}
+
+export default async function handle(payload: unknown, ctx: ResolverContext): Promise<void> {
+  const record = payload && typeof payload === 'object' ? payload as Record<string, unknown> : {}
+  const claimId = readString(record, 'claimId') ?? readString(record, 'id')
+  const claimNumber = readString(record, 'claimNumber') ?? ''
+  const tenantId = ctx.tenantId ?? null
+  const organizationId = ctx.organizationId ?? null
+  const fromStatus = readString(record, 'fromStatus') ?? ''
+  const toStatus = readString(record, 'toStatus') ?? readString(record, 'status') ?? ''
+  if (!claimId || !tenantId || !organizationId) return
+
+  try {
+    const container = ctx.container ?? { resolve: ctx.resolve }
+    const em = container.resolve<EntityManager>('em').fork()
+    const scope = { tenantId, organizationId }
+    const claim = await findOneWithDecryption(em, WarrantyClaim, { id: claimId, tenantId, organizationId, deletedAt: null }, {}, scope)
+    if (!claim) return
+    const creatorUserId = await resolveCreatorUserId(em, claimId, scope)
+    const recipientUserIds = Array.from(
+      new Set([creatorUserId, claim.assigneeUserId ?? null].filter((value): value is string => typeof value === 'string' && value.length > 0)),
+    )
+    if (!recipientUserIds.length) return
+
+    const notificationService = resolveNotificationService(container)
+    const typeDef = notificationTypes.find((type) => type.type === 'warranty_claims.claim.status_changed')
+    if (!typeDef) return
+    const notificationInput = buildBatchNotificationFromType(typeDef, {
+      recipientUserIds,
+      bodyVariables: {
+        claimNumber,
+        fromStatus,
+        toStatus,
+      },
+      sourceEntityType: 'warranty_claims:warranty_claim',
+      sourceEntityId: claimId,
+      linkHref: `/backend/warranty_claims/${claimId}`,
+      groupKey: `warranty_claims.claim.status_changed:${claimId}:${toStatus}`,
+    })
+    await notificationService.createBatch(notificationInput, {
+      tenantId,
+      organizationId,
+    })
+  } catch (err) {
+    logger.warn('[warranty_claims:claim-status-notification] create failed', { err })
+  }
+}

package/src/modules/warranty_claims/subscribers/claim-submitted-notification.ts

@@ -0,0 +1,53 @@
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildFeatureNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { notificationTypes } from '../notifications'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('warranty_claims')
+
+export const metadata = {
+  event: 'warranty_claims.claim.submitted',
+  persistent: true,
+  id: 'warranty_claims:claim-submitted-notification',
+}
+
+type ResolverContext = {
+  resolve: <T = unknown>(name: string) => T
+  container?: { resolve<T = unknown>(name: string): T }
+  tenantId?: string | null
+  organizationId?: string | null
+}
+
+function readString(record: Record<string, unknown>, key: string): string | null {
+  const value = record[key]
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+export default async function handle(payload: unknown, ctx: ResolverContext): Promise<void> {
+  const record = payload && typeof payload === 'object' ? payload as Record<string, unknown> : {}
+  const claimId = readString(record, 'claimId') ?? readString(record, 'id')
+  const claimNumber = readString(record, 'claimNumber') ?? ''
+  const tenantId = ctx.tenantId ?? null
+  const organizationId = ctx.organizationId ?? null
+  if (!claimId || !tenantId || !organizationId) return
+
+  try {
+    const notificationService = resolveNotificationService(ctx.container ?? { resolve: ctx.resolve })
+    const typeDef = notificationTypes.find((type) => type.type === 'warranty_claims.claim.submitted')
+    if (!typeDef) return
+    const notificationInput = buildFeatureNotificationFromType(typeDef, {
+      requiredFeature: 'warranty_claims.claim.manage',
+      bodyVariables: { claimNumber },
+      sourceEntityType: 'warranty_claims:warranty_claim',
+      sourceEntityId: claimId,
+      linkHref: `/backend/warranty_claims/${claimId}`,
+      groupKey: `warranty_claims.claim.submitted:${claimId}`,
+    })
+    await notificationService.createForFeature(notificationInput, {
+      tenantId,
+      organizationId,
+    })
+  } catch (err) {
+    logger.warn('[warranty_claims:claim-submitted-notification] create failed', { err })
+  }
+}

package/src/modules/warranty_claims/subscribers/email-to-claim.ts

@@ -0,0 +1,175 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import type { AwilixContainer } from 'awilix'
+import type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'
+import { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'
+import { createOrGetClaimFromInboundMessage } from '../lib/emailIntake'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('warranty_claims')
+
+// Chosen over `communication_channels.message.received`: that hub event currently
+// carries only message/channel ids, while `inbox_ops.email.received` includes the
+// sender address required to create an unlinked warranty claim contact snapshot.
+export const metadata = {
+  event: 'inbox_ops.email.received',
+  persistent: true,
+  id: 'warranty_claims:email-to-claim',
+}
+
+const MODULE_ID = 'warranty_claims'
+const EMAIL_INTAKE_ENABLED_KEY = 'emailIntakeEnabled'
+const EMAIL_INTAKE_ENV = 'OM_WARRANTY_EMAIL_INTAKE'
+
+type Resolver = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+type SubscriberContext = Resolver & {
+  container?: Resolver
+  tenantId?: string | null
+  organizationId?: string | null
+}
+
+function toRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}
+}
+
+function readString(record: Record<string, unknown>, key: string): string | null {
+  const value = record[key]
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+function readFirstString(record: Record<string, unknown>, keys: string[]): string | null {
+  for (const key of keys) {
+    const value = readString(record, key)
+    if (value) return value
+  }
+  return null
+}
+
+function readNestedString(record: Record<string, unknown>, parentKey: string, childKey: string): string | null {
+  const child = toRecord(record[parentKey])
+  return readString(child, childKey)
+}
+
+function resolveContainer(ctx: SubscriberContext): AwilixContainer {
+  return (ctx.container ?? { resolve: ctx.resolve }) as AwilixContainer
+}
+
+function tryResolve<T>(ctx: SubscriberContext, name: string): T | undefined {
+  try {
+    return resolveContainer(ctx).resolve<T>(name)
+  } catch {
+    return undefined
+  }
+}
+
+function parseConfigBoolean(value: unknown): boolean {
+  if (typeof value === 'boolean') return parseBooleanWithDefault(value ? 'true' : 'false', false)
+  if (typeof value === 'string') return parseBooleanWithDefault(value, false)
+  return false
+}
+
+async function isEmailIntakeEnabled(
+  ctx: SubscriberContext,
+  scope: { tenantId: string; organizationId: string },
+): Promise<boolean> {
+  const moduleConfig = tryResolve<ModuleConfigService>(ctx, 'moduleConfigService')
+  if (!moduleConfig) {
+    return parseBooleanWithDefault(process.env[EMAIL_INTAKE_ENV], false)
+  }
+
+  try {
+    const value = await moduleConfig.getValue<unknown>(MODULE_ID, EMAIL_INTAKE_ENABLED_KEY, {
+      defaultValue: null,
+      scope,
+    })
+    return parseConfigBoolean(value)
+  } catch {
+    return false
+  }
+}
+
+function readMessageRef(record: Record<string, unknown>): string | null {
+  return readFirstString(record, [
+    'intakeMessageRef',
+    'messageId',
+    'emailId',
+    'externalMessageId',
+    'id',
+  ])
+}
+
+function readContactEmail(record: Record<string, unknown>): string | null {
+  return readFirstString(record, [
+    'contactEmail',
+    'contact_email',
+    'forwardedByAddress',
+    'senderEmail',
+    'senderIdentifier',
+    'fromEmail',
+    'fromAddress',
+  ])
+    ?? readNestedString(record, 'from', 'email')
+    ?? readNestedString(record, 'sender', 'email')
+}
+
+function readSenderName(record: Record<string, unknown>): string | null {
+  return readFirstString(record, [
+    'customerName',
+    'contactName',
+    'forwardedByName',
+    'senderName',
+    'senderDisplayName',
+    'fromName',
+  ])
+    ?? readNestedString(record, 'from', 'name')
+    ?? readNestedString(record, 'sender', 'name')
+}
+
+export default async function handle(payload: unknown, ctx: SubscriberContext): Promise<void> {
+  const record = toRecord(payload)
+  const tenantId = ctx.tenantId ?? null
+  const organizationId = ctx.organizationId ?? null
+
+  if (!tenantId || !organizationId) {
+    logger.warn('[warranty_claims:email-to-claim] skipped inbound email without trusted scope', {
+      hasTenantId: Boolean(tenantId),
+      hasOrganizationId: Boolean(organizationId),
+    })
+    return
+  }
+
+  // Tenant enables warranty email intake deliberately once a dedicated warranty inbox is routed.
+  if (!(await isEmailIntakeEnabled(ctx, { tenantId, organizationId }))) return
+
+  const intakeMessageRef = readMessageRef(record)
+  const contactEmail = readContactEmail(record)
+
+  if (!intakeMessageRef || !contactEmail) {
+    logger.warn('[warranty_claims:email-to-claim] skipped inbound email payload', {
+      hasTenantId: true,
+      hasOrganizationId: true,
+      hasIntakeMessageRef: Boolean(intakeMessageRef),
+      hasContactEmail: Boolean(contactEmail),
+    })
+    return
+  }
+
+  try {
+    const container = resolveContainer(ctx)
+    const em = container.resolve<EntityManager>('em').fork()
+    await createOrGetClaimFromInboundMessage({
+      em,
+      container,
+      scope: { tenantId, organizationId },
+      contactEmail,
+      customerName: readSenderName(record),
+      subject: readFirstString(record, ['subject', 'title']),
+      body: readFirstString(record, ['body', 'bodyText', 'text', 'cleanedText', 'rawText']),
+      intakeMessageRef,
+    })
+  } catch (err) {
+    logger.warn('[warranty_claims:email-to-claim] failed to create warranty claim from inbound email', { err })
+  }
+}