@open-mercato/core 0.6.8-develop.6924.1.a8d208fcdc → 0.6.8-develop.6930.1.1e5976efc3

package/src/modules/eudr/migrations/Migration20260706102002_eudr.ts

@@ -0,0 +1,16 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260706102002_eudr extends Migration {
+
+  override up(): void | Promise<void> {
+    this.addSql(`create table "eudr_due_diligence_statements" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "title" text not null, "commodity" text not null, "reference_number" text null, "verification_number" text null, "status" text not null default 'draft', "quantity_kg" numeric(14,3) null, "order_id" uuid null, "notes" text null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+
+    this.addSql(`create table "eudr_evidence_submissions" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "supplier_entity_id" uuid not null, "supplier_snapshot" jsonb null, "commodity" text not null, "product_mapping_id" uuid null, "statement_id" uuid null, "origin_country" text null, "geolocation" jsonb null, "quantity_kg" numeric(14,3) null, "batch_number" text null, "harvest_from" timestamptz null, "harvest_to" timestamptz null, "producer_name" text null, "attachment_ids" jsonb not null default '[]', "status" text not null default 'draft', "completeness_score" int not null default 0, "missing_fields" jsonb not null default '[]', "notes" text null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create index "idx_eudr_submissions_supplier" on "eudr_evidence_submissions" ("supplier_entity_id");`);
+    this.addSql(`create index "idx_eudr_submissions_statement" on "eudr_evidence_submissions" ("statement_id");`);
+
+    this.addSql(`create table "eudr_product_mappings" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "product_id" uuid not null, "product_snapshot" jsonb null, "commodity" text not null, "hs_code" text null, "is_in_scope" boolean not null default true, "notes" text null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create unique index "idx_eudr_mappings_org_product_commodity_unique" on "eudr_product_mappings" ("organization_id", "product_id", "commodity") where deleted_at is null;`);
+  }
+
+}

package/src/modules/eudr/migrations/Migration20260706152612_eudr.ts

@@ -0,0 +1,30 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260706152612_eudr extends Migration {
+
+  override up(): void | Promise<void> {
+    this.addSql(`create table "eudr_mitigation_actions" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "risk_assessment_id" uuid not null, "action_type" text not null default 'other', "title" text not null, "description" text null, "status" text not null default 'planned', "due_date" timestamptz null, "completed_at" timestamptz null, "notes" text null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create index "idx_eudr_mitigation_actions_risk_assessment" on "eudr_mitigation_actions" ("risk_assessment_id");`);
+
+    this.addSql(`create table "eudr_plots" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "supplier_entity_id" uuid not null, "supplier_snapshot" jsonb null, "name" text not null, "external_id" text null, "description" text null, "origin_country" text not null, "plot_type" text not null default 'point', "geometry" jsonb not null, "area_ha" numeric(12,4) null, "validation_warnings" jsonb not null default '[]', "producer_name" text null, "is_active" boolean not null default true, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create index "idx_eudr_plots_supplier" on "eudr_plots" ("supplier_entity_id");`);
+
+    this.addSql(`create table "eudr_risk_assessments" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "statement_id" uuid not null, "country_risks" jsonb not null default '[]', "overall_tier" text not null default 'unknown', "criteria" jsonb not null default '{}', "conclusion" text not null default 'non_negligible', "is_simplified" boolean not null default false, "assessed_at" timestamptz not null, "assessed_by_name" text null, "review_due_at" timestamptz null, "notes" text null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create index "idx_eudr_risk_assessments_statement" on "eudr_risk_assessments" ("statement_id");`);
+
+    this.addSql(`alter table "eudr_due_diligence_statements" add "activity_type" text null, add "actor_role" text null, add "referenced_statements" jsonb not null default '[]', add "supplementary_unit" text null, add "supplementary_quantity" numeric(14,3) null, add "submitted_at" timestamptz null, add "reference_issued_at" timestamptz null, add "order_snapshot" jsonb null;`);
+
+    this.addSql(`alter table "eudr_evidence_submissions" add "plot_ids" jsonb not null default '[]';`);
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`alter table "eudr_due_diligence_statements" drop column "activity_type", drop column "actor_role", drop column "referenced_statements", drop column "supplementary_unit", drop column "supplementary_quantity", drop column "submitted_at", drop column "reference_issued_at", drop column "order_snapshot";`);
+
+    this.addSql(`alter table "eudr_evidence_submissions" drop column "plot_ids";`);
+
+    this.addSql(`drop table if exists "eudr_mitigation_actions" cascade;`);
+    this.addSql(`drop table if exists "eudr_risk_assessments" cascade;`);
+    this.addSql(`drop table if exists "eudr_plots" cascade;`);
+  }
+
+}

package/src/modules/eudr/migrations/Migration20260722100000_eudr.ts

@@ -0,0 +1,17 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260722100000_eudr extends Migration {
+
+  override up(): void | Promise<void> {
+    this.addSql(`alter table "eudr_product_mappings" add column "species_scientific_name" text null, add column "species_common_name" text null;`);
+
+    this.addSql(`create index "eudr_dds_tenant_org_submitted_idx" on "eudr_due_diligence_statements" ("tenant_id", "organization_id", "submitted_at") where "deleted_at" is null;`);
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`drop index "eudr_dds_tenant_org_submitted_idx";`);
+
+    this.addSql(`alter table "eudr_product_mappings" drop column "species_scientific_name", drop column "species_common_name";`);
+  }
+
+}

package/src/modules/eudr/notifications.ts

@@ -0,0 +1,56 @@
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+
+export const notificationTypes: NotificationTypeDefinition[] = [
+  {
+    type: 'eudr.statement.submitted',
+    module: 'eudr',
+    titleKey: 'eudr.notifications.statement.submitted.title',
+    bodyKey: 'eudr.notifications.statement.submitted.body',
+    icon: 'file-check',
+    severity: 'info',
+    actions: [],
+    expiresAfterHours: 168,
+  },
+  {
+    type: 'eudr.statement.reference_issued',
+    module: 'eudr',
+    titleKey: 'eudr.notifications.statement.referenceIssued.title',
+    bodyKey: 'eudr.notifications.statement.referenceIssued.body',
+    icon: 'badge-check',
+    severity: 'success',
+    actions: [],
+    expiresAfterHours: 720,
+  },
+  {
+    type: 'eudr.statement.withdrawn',
+    module: 'eudr',
+    titleKey: 'eudr.notifications.statement.withdrawn.title',
+    bodyKey: 'eudr.notifications.statement.withdrawn.body',
+    icon: 'undo',
+    severity: 'warning',
+    actions: [],
+    expiresAfterHours: 168,
+  },
+  {
+    type: 'eudr.risk.non_negligible',
+    module: 'eudr',
+    titleKey: 'eudr.notifications.risk.nonNegligible.title',
+    bodyKey: 'eudr.notifications.risk.nonNegligible.body',
+    icon: 'alert-triangle',
+    severity: 'warning',
+    actions: [],
+    expiresAfterHours: 168,
+  },
+  {
+    type: 'eudr.mitigation.completed',
+    module: 'eudr',
+    titleKey: 'eudr.notifications.mitigation.completed.title',
+    bodyKey: 'eudr.notifications.mitigation.completed.body',
+    icon: 'check-circle',
+    severity: 'success',
+    actions: [],
+    expiresAfterHours: 168,
+  },
+]
+
+export default notificationTypes

package/src/modules/eudr/search.ts

@@ -0,0 +1,212 @@
+import type { SearchBuildContext, SearchIndexSource, SearchModuleConfig, SearchResultPresenter } from '@open-mercato/shared/modules/search'
+import type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+
+const EUDR_STATEMENTS_URL = '/backend/eudr/statements'
+const EUDR_PLOTS_URL = '/backend/eudr/plots'
+const EUDR_EVIDENCE_SUBMISSIONS_URL = '/backend/eudr/evidence-submissions'
+
+function assertTenantContext(ctx: SearchBuildContext): void {
+  if (typeof ctx.tenantId !== 'string' || ctx.tenantId.length === 0) {
+    throw new Error('[internal] [search.eudr] Missing tenantId in search build context')
+  }
+}
+
+function normalizeText(value: unknown): string | null {
+  if (value === null || value === undefined) return null
+  if (typeof value === 'string') {
+    const trimmed = value.trim()
+    return trimmed.length > 0 ? trimmed : null
+  }
+  if (value instanceof Date) return value.toISOString()
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value)
+  return null
+}
+
+function readRecordText(record: Record<string, unknown>, ...keys: string[]): string | null {
+  for (const key of keys) {
+    const text = normalizeText(record[key])
+    if (text) return text
+  }
+  return null
+}
+
+function readObjectText(source: unknown, ...keys: string[]): string | null {
+  if (!source || typeof source !== 'object') return null
+  return readRecordText(source as Record<string, unknown>, ...keys)
+}
+
+function formatSubtitle(...parts: Array<unknown>): string | undefined {
+  const text = parts
+    .map((part) => normalizeText(part))
+    .filter((value): value is string => Boolean(value))
+  if (!text.length) return undefined
+  return text.join(' · ')
+}
+
+function appendLine(lines: string[], label: string, value: unknown) {
+  const text = normalizeText(value)
+  if (!text) return
+  lines.push(`${label}: ${text}`)
+}
+
+function friendlyLabel(input: string): string {
+  return input
+    .replace(/^cf:/, '')
+    .replace(/_/g, ' ')
+    .replace(/([a-z])([A-Z])/g, (_match, firstChar, secondChar) => `${firstChar} ${secondChar}`)
+    .replace(/\b\w/g, (character) => character.toUpperCase())
+}
+
+function appendCustomFieldLines(lines: string[], customFields: Record<string, unknown>) {
+  for (const [key, value] of Object.entries(customFields)) {
+    if (value === null || value === undefined) continue
+    appendLine(lines, friendlyLabel(key), value)
+  }
+}
+
+function buildIndexSource(
+  ctx: SearchBuildContext,
+  presenter: SearchResultPresenter,
+  lines: string[],
+): SearchIndexSource | null {
+  appendCustomFieldLines(lines, ctx.customFields)
+  if (!lines.length) return null
+  return {
+    text: lines,
+    presenter,
+    checksumSource: { record: ctx.record, customFields: ctx.customFields },
+  }
+}
+
+function buildRecordUrl(baseUrl: string, record: Record<string, unknown>): string | null {
+  const recordId = readRecordText(record, 'id')
+  return recordId ? `${baseUrl}/${encodeURIComponent(recordId)}` : null
+}
+
+function translateToken(translate: TranslateFn, prefix: string, value: string | null): string | null {
+  if (!value) return null
+  return translate(`${prefix}.${value}`, value)
+}
+
+function resolveSupplierName(record: Record<string, unknown>): string | null {
+  const snapshot = record.supplier_snapshot ?? record.supplierSnapshot
+  return readObjectText(snapshot, 'display_name', 'displayName', 'name')
+}
+
+function buildStatementPresenter(translate: TranslateFn, record: Record<string, unknown>): SearchResultPresenter {
+  const label = translate('eudr.search.badge.statement', 'DDS statement')
+  const title = readRecordText(record, 'title') ?? translate('eudr.common.recordUnavailable')
+  const subtitle = formatSubtitle(
+    readRecordText(record, 'reference_number', 'referenceNumber'),
+    translateToken(translate, 'eudr.commodity', readRecordText(record, 'commodity')),
+  )
+  return { title, subtitle, icon: 'file-check', badge: label }
+}
+
+function buildPlotPresenter(translate: TranslateFn, record: Record<string, unknown>): SearchResultPresenter {
+  const label = translate('eudr.search.badge.plot', 'Plot')
+  const title = readRecordText(record, 'name') ?? translate('eudr.common.recordUnavailable')
+  const subtitle = formatSubtitle(
+    readRecordText(record, 'origin_country', 'originCountry'),
+    translateToken(translate, 'eudr.plotType', readRecordText(record, 'plot_type', 'plotType')),
+  )
+  return { title, subtitle, icon: 'map-pin', badge: label }
+}
+
+function buildSubmissionPresenter(translate: TranslateFn, record: Record<string, unknown>): SearchResultPresenter {
+  const label = translate('eudr.search.badge.submission', 'Evidence submission')
+  const batchNumber = readRecordText(record, 'batch_number', 'batchNumber')
+  const supplierName = resolveSupplierName(record)
+  const title = batchNumber
+    ? `${label} ${batchNumber}`
+    : supplierName ?? translate('eudr.common.recordUnavailable')
+  const subtitle = formatSubtitle(
+    supplierName,
+    translateToken(translate, 'eudr.submissionStatus', readRecordText(record, 'status')),
+  )
+  return { title, subtitle, icon: 'package', badge: label }
+}
+
+export const searchConfig: SearchModuleConfig = {
+  entities: [
+    {
+      entityId: 'eudr:eudr_due_diligence_statement',
+      enabled: true,
+      priority: 8,
+      fieldPolicy: {
+        searchable: ['title', 'reference_number', 'commodity'],
+        excluded: ['notes'],
+      },
+      buildSource: async (ctx) => {
+        assertTenantContext(ctx)
+        const { t: translate } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Title', record.title)
+        appendLine(lines, 'Reference number', record.reference_number ?? record.referenceNumber)
+        appendLine(lines, 'Commodity', record.commodity)
+        return buildIndexSource(ctx, buildStatementPresenter(translate, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t: translate } = await resolveTranslations()
+        return buildStatementPresenter(translate, ctx.record)
+      },
+      resolveUrl: async (ctx) => buildRecordUrl(EUDR_STATEMENTS_URL, ctx.record),
+      aclFeatures: ['eudr.statements.view'],
+    },
+    {
+      entityId: 'eudr:eudr_plot',
+      enabled: true,
+      priority: 7,
+      fieldPolicy: {
+        searchable: ['name', 'external_id', 'origin_country'],
+        excluded: ['producer_name'],
+      },
+      buildSource: async (ctx) => {
+        assertTenantContext(ctx)
+        const { t: translate } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Name', record.name)
+        appendLine(lines, 'External ID', record.external_id ?? record.externalId)
+        appendLine(lines, 'Origin country', record.origin_country ?? record.originCountry)
+        return buildIndexSource(ctx, buildPlotPresenter(translate, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t: translate } = await resolveTranslations()
+        return buildPlotPresenter(translate, ctx.record)
+      },
+      resolveUrl: async (ctx) => buildRecordUrl(EUDR_PLOTS_URL, ctx.record),
+      aclFeatures: ['eudr.plots.view'],
+    },
+    {
+      entityId: 'eudr:eudr_evidence_submission',
+      enabled: true,
+      priority: 6,
+      fieldPolicy: {
+        searchable: ['batch_number', 'commodity'],
+        excluded: ['producer_name', 'notes'],
+      },
+      buildSource: async (ctx) => {
+        assertTenantContext(ctx)
+        const { t: translate } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Batch number', record.batch_number ?? record.batchNumber)
+        appendLine(lines, 'Commodity', record.commodity)
+        appendLine(lines, 'Supplier', resolveSupplierName(record))
+        return buildIndexSource(ctx, buildSubmissionPresenter(translate, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t: translate } = await resolveTranslations()
+        return buildSubmissionPresenter(translate, ctx.record)
+      },
+      resolveUrl: async (ctx) => buildRecordUrl(EUDR_EVIDENCE_SUBMISSIONS_URL, ctx.record),
+      aclFeatures: ['eudr.submissions.view'],
+    },
+  ],
+}
+
+export default searchConfig
+export const config = searchConfig

package/src/modules/eudr/setup.ts

@@ -0,0 +1,10 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['eudr.*'],
+    employee: ['eudr.mappings.view', 'eudr.submissions.view', 'eudr.statements.view', 'eudr.plots.view', 'eudr.risk.view'],
+  },
+}
+
+export default setup

package/src/modules/eudr/subscribers/notify-mitigation-completed.ts

@@ -0,0 +1,56 @@
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import {
+  deliverEudrNotification,
+  type EudrNotificationContainer,
+} from '../lib/notifications'
+
+const logger = createLogger('eudr').child({ component: 'notify-mitigation-completed' })
+
+export const metadata = {
+  event: 'eudr.mitigation_action.completed',
+  persistent: true,
+  id: 'eudr:notify-mitigation-completed',
+}
+
+type MitigationCompletedPayload = {
+  id?: string
+  tenantId?: string | null
+  organizationId?: string | null
+  title?: string
+  riskAssessmentId?: string
+  occurredAt?: string
+}
+
+type SubscriberContext = EudrNotificationContainer & {
+  container?: EudrNotificationContainer
+}
+
+export default async function notifyMitigationCompleted(
+  payload: MitigationCompletedPayload,
+  ctx: SubscriberContext,
+): Promise<void> {
+  if (
+    !payload?.tenantId
+    || !payload.id
+    || !payload.riskAssessmentId
+    || !payload.occurredAt
+    || typeof payload.title !== 'string'
+  ) {
+    logger.debug('Skipping mitigation-completed notification because the event payload is incomplete')
+    return
+  }
+
+  await deliverEudrNotification({
+    container: ctx.container ?? ctx,
+    typeId: 'eudr.mitigation.completed',
+    payload: {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+      entityId: payload.id,
+      occurredAt: payload.occurredAt,
+      bodyVariables: { actionTitle: payload.title },
+      linkHref: `/backend/eudr/risk-assessments/${payload.riskAssessmentId}`,
+      sourceEntityType: 'eudr:eudr_mitigation_action',
+    },
+  })
+}

package/src/modules/eudr/subscribers/notify-risk-concluded.ts

@@ -0,0 +1,58 @@
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import {
+  deliverEudrNotification,
+  type EudrNotificationContainer,
+} from '../lib/notifications'
+
+const logger = createLogger('eudr').child({ component: 'notify-risk-concluded' })
+
+export const metadata = {
+  event: 'eudr.risk_assessment.concluded',
+  persistent: true,
+  id: 'eudr:notify-risk-concluded',
+}
+
+type RiskConcludedPayload = {
+  id?: string
+  tenantId?: string | null
+  organizationId?: string | null
+  statementId?: string
+  statementTitle?: string
+  conclusion?: string
+  occurredAt?: string
+}
+
+type SubscriberContext = EudrNotificationContainer & {
+  container?: EudrNotificationContainer
+}
+
+export default async function notifyRiskConcluded(
+  payload: RiskConcludedPayload,
+  ctx: SubscriberContext,
+): Promise<void> {
+  if (payload?.conclusion !== 'non_negligible') return
+  if (
+    !payload.tenantId
+    || !payload.id
+    || !payload.statementId
+    || !payload.occurredAt
+    || typeof payload.statementTitle !== 'string'
+  ) {
+    logger.debug('Skipping risk-concluded notification because the event payload is incomplete')
+    return
+  }
+
+  await deliverEudrNotification({
+    container: ctx.container ?? ctx,
+    typeId: 'eudr.risk.non_negligible',
+    payload: {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+      entityId: payload.id,
+      occurredAt: payload.occurredAt,
+      bodyVariables: { statementTitle: payload.statementTitle },
+      linkHref: `/backend/eudr/statements/${payload.statementId}`,
+      sourceEntityType: 'eudr:eudr_risk_assessment',
+    },
+  })
+}

package/src/modules/eudr/subscribers/notify-statement-reference-issued.ts

@@ -0,0 +1,59 @@
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import {
+  deliverEudrNotification,
+  type EudrNotificationContainer,
+} from '../lib/notifications'
+
+const logger = createLogger('eudr').child({ component: 'notify-statement-reference-issued' })
+
+export const metadata = {
+  event: 'eudr.due_diligence_statement.reference_issued',
+  persistent: true,
+  id: 'eudr:notify-statement-reference-issued',
+}
+
+type StatementReferenceIssuedPayload = {
+  id?: string
+  tenantId?: string | null
+  organizationId?: string | null
+  title?: string
+  referenceNumber?: string
+  occurredAt?: string
+}
+
+type SubscriberContext = EudrNotificationContainer & {
+  container?: EudrNotificationContainer
+}
+
+export default async function notifyStatementReferenceIssued(
+  payload: StatementReferenceIssuedPayload,
+  ctx: SubscriberContext,
+): Promise<void> {
+  if (
+    !payload?.tenantId
+    || !payload.id
+    || !payload.occurredAt
+    || typeof payload.title !== 'string'
+    || typeof payload.referenceNumber !== 'string'
+  ) {
+    logger.debug('Skipping reference-issued notification because the event payload is incomplete')
+    return
+  }
+
+  await deliverEudrNotification({
+    container: ctx.container ?? ctx,
+    typeId: 'eudr.statement.reference_issued',
+    payload: {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+      entityId: payload.id,
+      occurredAt: payload.occurredAt,
+      bodyVariables: {
+        statementTitle: payload.title,
+        referenceNumber: payload.referenceNumber,
+      },
+      linkHref: `/backend/eudr/statements/${payload.id}`,
+      sourceEntityType: 'eudr:eudr_due_diligence_statement',
+    },
+  })
+}

package/src/modules/eudr/subscribers/notify-statement-submitted.ts

@@ -0,0 +1,49 @@
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import {
+  deliverEudrNotification,
+  type EudrNotificationContainer,
+} from '../lib/notifications'
+
+const logger = createLogger('eudr').child({ component: 'notify-statement-submitted' })
+
+export const metadata = {
+  event: 'eudr.due_diligence_statement.submitted',
+  persistent: true,
+  id: 'eudr:notify-statement-submitted',
+}
+
+type StatementSubmittedPayload = {
+  id?: string
+  tenantId?: string | null
+  organizationId?: string | null
+  title?: string
+  occurredAt?: string
+}
+
+type SubscriberContext = EudrNotificationContainer & {
+  container?: EudrNotificationContainer
+}
+
+export default async function notifyStatementSubmitted(
+  payload: StatementSubmittedPayload,
+  ctx: SubscriberContext,
+): Promise<void> {
+  if (!payload?.tenantId || !payload.id || !payload.occurredAt || typeof payload.title !== 'string') {
+    logger.debug('Skipping statement-submitted notification because the event payload is incomplete')
+    return
+  }
+
+  await deliverEudrNotification({
+    container: ctx.container ?? ctx,
+    typeId: 'eudr.statement.submitted',
+    payload: {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+      entityId: payload.id,
+      occurredAt: payload.occurredAt,
+      bodyVariables: { statementTitle: payload.title },
+      linkHref: `/backend/eudr/statements/${payload.id}`,
+      sourceEntityType: 'eudr:eudr_due_diligence_statement',
+    },
+  })
+}

package/src/modules/eudr/subscribers/notify-statement-withdrawn.ts

@@ -0,0 +1,49 @@
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import {
+  deliverEudrNotification,
+  type EudrNotificationContainer,
+} from '../lib/notifications'
+
+const logger = createLogger('eudr').child({ component: 'notify-statement-withdrawn' })
+
+export const metadata = {
+  event: 'eudr.due_diligence_statement.withdrawn',
+  persistent: true,
+  id: 'eudr:notify-statement-withdrawn',
+}
+
+type StatementWithdrawnPayload = {
+  id?: string
+  tenantId?: string | null
+  organizationId?: string | null
+  title?: string
+  occurredAt?: string
+}
+
+type SubscriberContext = EudrNotificationContainer & {
+  container?: EudrNotificationContainer
+}
+
+export default async function notifyStatementWithdrawn(
+  payload: StatementWithdrawnPayload,
+  ctx: SubscriberContext,
+): Promise<void> {
+  if (!payload?.tenantId || !payload.id || !payload.occurredAt || typeof payload.title !== 'string') {
+    logger.debug('Skipping statement-withdrawn notification because the event payload is incomplete')
+    return
+  }
+
+  await deliverEudrNotification({
+    container: ctx.container ?? ctx,
+    typeId: 'eudr.statement.withdrawn',
+    payload: {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+      entityId: payload.id,
+      occurredAt: payload.occurredAt,
+      bodyVariables: { statementTitle: payload.title },
+      linkHref: `/backend/eudr/statements/${payload.id}`,
+      sourceEntityType: 'eudr:eudr_due_diligence_statement',
+    },
+  })
+}