@open-mercato/core 0.8.1-develop.7296.1.2111d779db → 0.9.0

package/dist/helpers/integration/communicationChannelsFixtures.js

@@ -130,6 +130,21 @@ async function ingestInboundChatMessage(request, token, input) {
     channelType: body?.channelType ?? null
   };
 }
+async function inspectMessageChannelLinks(request, token, messageId) {
+  const response = await apiRequest(request, "POST", TEST_SEED_PATH, {
+    token,
+    data: { action: "inspect-message-links", messageId }
+  });
+  expect(
+    response.status(),
+    "POST /api/communication_channels/test-seed (inspect-message-links) should return 200"
+  ).toBe(200);
+  const body = await readJsonSafe(response);
+  return {
+    links: Array.isArray(body?.links) ? body.links : [],
+    threadMappings: Array.isArray(body?.threadMappings) ? body.threadMappings : []
+  };
+}
 async function deleteChannelIfExists(request, token, channelId) {
   if (!token || !channelId) return;
   await apiRequest(
@@ -143,6 +158,7 @@ export {
   clearCapturedSystemEmails,
   deleteChannelIfExists,
   ingestInboundChatMessage,
+  inspectMessageChannelLinks,
   isChannelSeedingAvailable,
   listCapturedSystemEmails,
   seedConnectedChannel,

package/dist/helpers/integration/communicationChannelsFixtures.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/helpers/integration/communicationChannelsFixtures.ts"],
-  "sourcesContent": ["import { expect, type APIRequestContext } from '@playwright/test';\nimport { apiRequest } from './api';\nimport { expectId, readJsonSafe } from './generalFixtures';\n\n/**\n * Communication-channels integration fixtures.\n *\n * These drive the TEST-ONLY seed endpoint `POST /api/communication_channels/test-seed`,\n * which is gated by `OM_ENABLE_TEST_CHANNEL_SEEDING` (inert/404 in production). Use\n * {@link isChannelSeedingAvailable} to skip tests when the gate is off rather than\n * failing them.\n */\n\nexport type SeedAddressField =\n  | string\n  | { address: string; name?: string }\n  | Array<string | { address: string; name?: string }>;\n\nexport type CapturedTestSeedEmail = {\n  capturedAt: string;\n  externalMessageId: string;\n  conversationId?: string;\n  content: {\n    text?: string;\n    html?: string;\n    bodyFormat?: 'text' | 'markdown' | 'html';\n    attachments?: Array<{ url: string; mimeType: string; fileName: string; fileSize?: number; inline?: boolean }>;\n    raw?: Record<string, unknown>;\n  };\n  credentials: Record<string, unknown>;\n  scope: {\n    tenantId: string;\n    organizationId: string;\n  };\n  metadata?: Record<string, unknown>;\n};\n\nconst TEST_SEED_PATH = '/api/communication_channels/test-seed';\n\nfunction resolveSystemCaptureCredentials(): {\n  accessToken: string;\n  captureCorrelationToken: string;\n} {\n  const accessToken = process.env.OM_TEST_EMAIL_CAPTURE_ACCESS_TOKEN?.trim();\n  const captureCorrelationToken = process.env.OM_TEST_EMAIL_CAPTURE_CORRELATION_TOKEN?.trim();\n  if (!accessToken || !captureCorrelationToken) {\n    throw new Error('[internal] System email capture credentials are not configured by the integration harness');\n  }\n  return { accessToken, captureCorrelationToken };\n}\n\n/**\n * Probe whether the env-gated test-seed endpoint is enabled in the target app.\n * Returns false when the route answers 404 (flag off) so callers can `test.skip`.\n * The caller's token must hold `communication_channels.connect_user_channel`.\n */\nexport async function isChannelSeedingAvailable(\n  request: APIRequestContext,\n  token: string,\n): Promise<boolean> {\n  // A malformed body returns 422 when the gate is ON and 404 when it is OFF.\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: '__probe__' },\n  });\n  return response.status() !== 404;\n}\n\n/**\n * Seed a connected, network-free `__test_seed__` channel owned by the caller.\n * Returns the new channel id. Tear down with {@link deleteChannelIfExists}.\n */\nexport async function seedConnectedChannel(\n  request: APIRequestContext,\n  token: string,\n  input: {\n    displayName?: string;\n    externalIdentifier?: string;\n    /**\n     * `chat` connects the non-email stub instead: a channel whose senders carry\n     * an opaque handle and no address, and whose `externalIdentifier` is NULL \u2014\n     * the shape a real Discord/Slack channel has. Use it for anything asserting\n     * the hub's sender-identity contract (#4975); the default `email` flavor\n     * cannot prove it, because it can only ever supply email-shaped data.\n     */\n    providerFlavor?: 'email' | 'chat';\n    /**\n     * Relabel the connected stub channel's `provider_key`. Provider packages own\n     * routes that filter on their own key, and a real channel for those providers\n     * cannot be connected in CI (the Discord adapter validates its bot token\n     * against the live API), so without this a provider-scoped listing can only\n     * be asserted against an empty result \u2014 the assertion that stayed green\n     * through #5602.\n     *\n     * The row is relabelled, nothing is registered: do not drive an outbound send\n     * through a relabelled channel, because delivery would resolve the real\n     * provider's adapter.\n     */\n    labelAsProviderKey?: string;\n  } = {},\n): Promise<string> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'connect-channel', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (connect-channel) should return 201',\n  ).toBe(201);\n  const body = await readJsonSafe<{ channelId?: string }>(response);\n  return expectId(body?.channelId, 'connect-channel response should include channelId');\n}\n\nexport async function seedSystemEmailChannel(\n  request: APIRequestContext,\n  token: string,\n  input: { displayName?: string; externalIdentifier?: string } = {},\n): Promise<string> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'seed-system-channel', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (seed-system-channel) should return 201',\n  ).toBe(201);\n  const body = await readJsonSafe<{ channelId?: string }>(response);\n  return expectId(body?.channelId, 'seed-system-channel response should include channelId');\n}\n\nexport async function clearCapturedSystemEmails(\n  request: APIRequestContext,\n  token: string,\n  options: { systemRecipient?: string } = {},\n): Promise<void> {\n  const captureCredentials = options.systemRecipient ? resolveSystemCaptureCredentials() : null;\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: {\n      action: 'clear-capture',\n      ...options,\n      ...(captureCredentials\n        ? { captureCorrelationToken: captureCredentials.captureCorrelationToken }\n        : {}),\n    },\n    headers: captureCredentials\n      ? { 'x-om-test-email-capture-access-token': captureCredentials.accessToken }\n      : undefined,\n  });\n  expect(response.ok(), 'POST /api/communication_channels/test-seed (clear-capture) should succeed').toBeTruthy();\n}\n\nexport async function listCapturedSystemEmails(\n  request: APIRequestContext,\n  token: string,\n  options: { systemRecipient?: string } = {},\n): Promise<CapturedTestSeedEmail[]> {\n  const captureCredentials = options.systemRecipient ? resolveSystemCaptureCredentials() : null;\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: {\n      action: 'list-capture',\n      ...options,\n      ...(captureCredentials\n        ? { captureCorrelationToken: captureCredentials.captureCorrelationToken }\n        : {}),\n    },\n    headers: captureCredentials\n      ? { 'x-om-test-email-capture-access-token': captureCredentials.accessToken }\n      : undefined,\n  });\n  expect(response.ok(), 'POST /api/communication_channels/test-seed (list-capture) should succeed').toBeTruthy();\n  const body = await readJsonSafe<{ items?: CapturedTestSeedEmail[] }>(response);\n  return Array.isArray(body?.items) ? body.items : [];\n}\n\nexport async function waitForCapturedSystemEmail(\n  request: APIRequestContext,\n  token: string,\n  predicate: (email: CapturedTestSeedEmail) => boolean,\n  options: {\n    timeoutMs?: number;\n    intervalMs?: number;\n    description?: string;\n    systemRecipient?: string;\n  } = {},\n): Promise<CapturedTestSeedEmail> {\n  const timeoutMs = options.timeoutMs ?? 20_000;\n  const intervalMs = options.intervalMs ?? 1_000;\n  const deadline = Date.now() + timeoutMs;\n  let lastItems: CapturedTestSeedEmail[] = [];\n  while (Date.now() < deadline) {\n    lastItems = await listCapturedSystemEmails(request, token, {\n      systemRecipient: options.systemRecipient,\n    });\n    const found = lastItems.find(predicate);\n    if (found) return found;\n    await new Promise((resolve) => setTimeout(resolve, intervalMs));\n  }\n  const summary = lastItems.map((item) => ({\n    to: item.metadata?.to,\n    from: item.metadata?.from,\n    subject: item.metadata?.subject,\n    scope: item.scope,\n    bodyFormat: item.content?.bodyFormat,\n  }));\n  throw new Error(\n    `Timed out waiting for captured system email${options.description ? `: ${options.description}` : ''}. Captured ${lastItems.length} message(s): ${JSON.stringify(summary)}`,\n  );\n}\n\n/**\n * Seed an inbound `MessageChannelLink` for `channelId` and emit\n * `communication_channels.message.received` through the real event bus. The\n * persistent customers link-channel-message-received subscriber is enqueued to\n * the `events` queue \u2014 drain it with `drainIntegrationQueue('events')`.\n *\n * Returns the created link + message ids (the message id is the platform\n * `messages.message` id, usable as `messageThreadId` to thread a follow-up).\n *\n * Pass `createThreadMapping: true` to also seed a `ChannelThreadMapping` for the\n * thread \u2014 required before exercising the reaction (`/messages/[id]/reactions`)\n * and thread-assign (`/threads/[id]/assign`) routes, which resolve the owning\n * channel through that mapping.\n */\nexport async function seedInboundMessage(\n  request: APIRequestContext,\n  token: string,\n  input: {\n    channelId: string;\n    from?: SeedAddressField;\n    to?: SeedAddressField;\n    cc?: SeedAddressField;\n    subject?: string;\n    bodyText?: string;\n    messageId?: string;\n    inReplyTo?: string;\n    references?: string[];\n    messageThreadId?: string;\n    providerKey?: string;\n    createThreadMapping?: boolean;\n  },\n): Promise<{ channelLinkId: string; messageId: string; conversationId: string }> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'emit-inbound', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (emit-inbound) should return 201',\n  ).toBe(201);\n  const body = await readJsonSafe<{\n    channelLinkId?: string;\n    messageId?: string;\n    conversationId?: string;\n  }>(response);\n  return {\n    channelLinkId: expectId(body?.channelLinkId, 'emit-inbound response should include channelLinkId'),\n    messageId: expectId(body?.messageId, 'emit-inbound response should include messageId'),\n    conversationId: expectId(\n      body?.conversationId,\n      'emit-inbound response should include conversationId',\n    ),\n  };\n}\n\n/**\n * Best-effort delete of a seeded channel via the owner-scoped DELETE route.\n * Safe to call with a null id in `finally`.\n */\n/**\n * Ingest an inbound chat message through the REAL `ingest_inbound_message`\n * command: the stub adapter normalizes the frame and the hub composes the\n * platform message via `messages.messages.compose`.\n *\n * Unlike {@link seedInboundMessage}, nothing here is short-circuited \u2014 no row is\n * inserted behind the compose path \u2014 so a hub contract the provider cannot\n * satisfy fails the test instead of hiding behind seeded data. That bypass is\n * exactly why CI was green while every real inbound Discord message was rejected\n * (#4975).\n *\n * The sender is identified only by `senderIdentifier` (a Discord snowflake, a\n * Slack member id, \u2026). There is deliberately no way to pass an address.\n */\nexport async function ingestInboundChatMessage(\n  request: APIRequestContext,\n  token: string,\n  input: {\n    channelId: string;\n    senderIdentifier: string;\n    senderDisplayName?: string;\n    body?: string;\n    externalMessageId: string;\n    externalConversationId: string;\n  },\n): Promise<{\n  status: string;\n  messageId: string | null;\n  conversationId: string | null;\n  channelLinkId: string | null;\n  channelType: string | null;\n}> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'ingest-inbound', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (ingest-inbound) should return 201 \u2014 ' +\n      'a non-201 here means the hub rejected a sender with no email address',\n  ).toBe(201);\n  const body = await readJsonSafe<{\n    status?: string;\n    messageId?: string | null;\n    conversationId?: string | null;\n    channelLinkId?: string | null;\n    channelType?: string | null;\n  }>(response);\n  return {\n    status: body?.status ?? 'unknown',\n    messageId: body?.messageId ?? null,\n    conversationId: body?.conversationId ?? null,\n    channelLinkId: body?.channelLinkId ?? null,\n    channelType: body?.channelType ?? null,\n  };\n}\n\nexport async function deleteChannelIfExists(\n  request: APIRequestContext,\n  token: string | null,\n  channelId: string | null,\n): Promise<void> {\n  if (!token || !channelId) return;\n  await apiRequest(\n    request,\n    'DELETE',\n    `/api/communication_channels/channels/${encodeURIComponent(channelId)}`,\n    { token },\n  ).catch(() => undefined);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { expect, type APIRequestContext } from '@playwright/test';\nimport { apiRequest } from './api';\nimport { expectId, readJsonSafe } from './generalFixtures';\n\n/**\n * Communication-channels integration fixtures.\n *\n * These drive the TEST-ONLY seed endpoint `POST /api/communication_channels/test-seed`,\n * which is gated by `OM_ENABLE_TEST_CHANNEL_SEEDING` (inert/404 in production). Use\n * {@link isChannelSeedingAvailable} to skip tests when the gate is off rather than\n * failing them.\n */\n\nexport type SeedAddressField =\n  | string\n  | { address: string; name?: string }\n  | Array<string | { address: string; name?: string }>;\n\nexport type CapturedTestSeedEmail = {\n  capturedAt: string;\n  externalMessageId: string;\n  conversationId?: string;\n  content: {\n    text?: string;\n    html?: string;\n    bodyFormat?: 'text' | 'markdown' | 'html';\n    attachments?: Array<{ url: string; mimeType: string; fileName: string; fileSize?: number; inline?: boolean }>;\n    raw?: Record<string, unknown>;\n  };\n  credentials: Record<string, unknown>;\n  scope: {\n    tenantId: string;\n    organizationId: string;\n  };\n  metadata?: Record<string, unknown>;\n};\n\nconst TEST_SEED_PATH = '/api/communication_channels/test-seed';\n\nfunction resolveSystemCaptureCredentials(): {\n  accessToken: string;\n  captureCorrelationToken: string;\n} {\n  const accessToken = process.env.OM_TEST_EMAIL_CAPTURE_ACCESS_TOKEN?.trim();\n  const captureCorrelationToken = process.env.OM_TEST_EMAIL_CAPTURE_CORRELATION_TOKEN?.trim();\n  if (!accessToken || !captureCorrelationToken) {\n    throw new Error('[internal] System email capture credentials are not configured by the integration harness');\n  }\n  return { accessToken, captureCorrelationToken };\n}\n\n/**\n * Probe whether the env-gated test-seed endpoint is enabled in the target app.\n * Returns false when the route answers 404 (flag off) so callers can `test.skip`.\n * The caller's token must hold `communication_channels.connect_user_channel`.\n */\nexport async function isChannelSeedingAvailable(\n  request: APIRequestContext,\n  token: string,\n): Promise<boolean> {\n  // A malformed body returns 422 when the gate is ON and 404 when it is OFF.\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: '__probe__' },\n  });\n  return response.status() !== 404;\n}\n\n/**\n * Seed a connected, network-free `__test_seed__` channel owned by the caller.\n * Returns the new channel id. Tear down with {@link deleteChannelIfExists}.\n */\nexport async function seedConnectedChannel(\n  request: APIRequestContext,\n  token: string,\n  input: {\n    displayName?: string;\n    externalIdentifier?: string;\n    /**\n     * `chat` connects the non-email stub instead: a channel whose senders carry\n     * an opaque handle and no address, and whose `externalIdentifier` is NULL \u2014\n     * the shape a real Discord/Slack channel has. Use it for anything asserting\n     * the hub's sender-identity contract (#4975); the default `email` flavor\n     * cannot prove it, because it can only ever supply email-shaped data.\n     */\n    providerFlavor?: 'email' | 'chat';\n    /**\n     * Relabel the connected stub channel's `provider_key`. Provider packages own\n     * routes that filter on their own key, and a real channel for those providers\n     * cannot be connected in CI (the Discord adapter validates its bot token\n     * against the live API), so without this a provider-scoped listing can only\n     * be asserted against an empty result \u2014 the assertion that stayed green\n     * through #5602.\n     *\n     * The row is relabelled, nothing is registered: do not drive an outbound send\n     * through a relabelled channel, because delivery would resolve the real\n     * provider's adapter.\n     */\n    labelAsProviderKey?: string;\n  } = {},\n): Promise<string> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'connect-channel', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (connect-channel) should return 201',\n  ).toBe(201);\n  const body = await readJsonSafe<{ channelId?: string }>(response);\n  return expectId(body?.channelId, 'connect-channel response should include channelId');\n}\n\nexport async function seedSystemEmailChannel(\n  request: APIRequestContext,\n  token: string,\n  input: { displayName?: string; externalIdentifier?: string } = {},\n): Promise<string> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'seed-system-channel', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (seed-system-channel) should return 201',\n  ).toBe(201);\n  const body = await readJsonSafe<{ channelId?: string }>(response);\n  return expectId(body?.channelId, 'seed-system-channel response should include channelId');\n}\n\nexport async function clearCapturedSystemEmails(\n  request: APIRequestContext,\n  token: string,\n  options: { systemRecipient?: string } = {},\n): Promise<void> {\n  const captureCredentials = options.systemRecipient ? resolveSystemCaptureCredentials() : null;\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: {\n      action: 'clear-capture',\n      ...options,\n      ...(captureCredentials\n        ? { captureCorrelationToken: captureCredentials.captureCorrelationToken }\n        : {}),\n    },\n    headers: captureCredentials\n      ? { 'x-om-test-email-capture-access-token': captureCredentials.accessToken }\n      : undefined,\n  });\n  expect(response.ok(), 'POST /api/communication_channels/test-seed (clear-capture) should succeed').toBeTruthy();\n}\n\nexport async function listCapturedSystemEmails(\n  request: APIRequestContext,\n  token: string,\n  options: { systemRecipient?: string } = {},\n): Promise<CapturedTestSeedEmail[]> {\n  const captureCredentials = options.systemRecipient ? resolveSystemCaptureCredentials() : null;\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: {\n      action: 'list-capture',\n      ...options,\n      ...(captureCredentials\n        ? { captureCorrelationToken: captureCredentials.captureCorrelationToken }\n        : {}),\n    },\n    headers: captureCredentials\n      ? { 'x-om-test-email-capture-access-token': captureCredentials.accessToken }\n      : undefined,\n  });\n  expect(response.ok(), 'POST /api/communication_channels/test-seed (list-capture) should succeed').toBeTruthy();\n  const body = await readJsonSafe<{ items?: CapturedTestSeedEmail[] }>(response);\n  return Array.isArray(body?.items) ? body.items : [];\n}\n\nexport async function waitForCapturedSystemEmail(\n  request: APIRequestContext,\n  token: string,\n  predicate: (email: CapturedTestSeedEmail) => boolean,\n  options: {\n    timeoutMs?: number;\n    intervalMs?: number;\n    description?: string;\n    systemRecipient?: string;\n  } = {},\n): Promise<CapturedTestSeedEmail> {\n  const timeoutMs = options.timeoutMs ?? 20_000;\n  const intervalMs = options.intervalMs ?? 1_000;\n  const deadline = Date.now() + timeoutMs;\n  let lastItems: CapturedTestSeedEmail[] = [];\n  while (Date.now() < deadline) {\n    lastItems = await listCapturedSystemEmails(request, token, {\n      systemRecipient: options.systemRecipient,\n    });\n    const found = lastItems.find(predicate);\n    if (found) return found;\n    await new Promise((resolve) => setTimeout(resolve, intervalMs));\n  }\n  const summary = lastItems.map((item) => ({\n    to: item.metadata?.to,\n    from: item.metadata?.from,\n    subject: item.metadata?.subject,\n    scope: item.scope,\n    bodyFormat: item.content?.bodyFormat,\n  }));\n  throw new Error(\n    `Timed out waiting for captured system email${options.description ? `: ${options.description}` : ''}. Captured ${lastItems.length} message(s): ${JSON.stringify(summary)}`,\n  );\n}\n\n/**\n * Seed an inbound `MessageChannelLink` for `channelId` and emit\n * `communication_channels.message.received` through the real event bus. The\n * persistent customers link-channel-message-received subscriber is enqueued to\n * the `events` queue \u2014 drain it with `drainIntegrationQueue('events')`.\n *\n * Returns the created link + message ids (the message id is the platform\n * `messages.message` id, usable as `messageThreadId` to thread a follow-up).\n *\n * Pass `createThreadMapping: true` to also seed a `ChannelThreadMapping` for the\n * thread \u2014 required before exercising the reaction (`/messages/[id]/reactions`)\n * and thread-assign (`/threads/[id]/assign`) routes, which resolve the owning\n * channel through that mapping.\n */\nexport async function seedInboundMessage(\n  request: APIRequestContext,\n  token: string,\n  input: {\n    channelId: string;\n    from?: SeedAddressField;\n    to?: SeedAddressField;\n    cc?: SeedAddressField;\n    subject?: string;\n    bodyText?: string;\n    messageId?: string;\n    inReplyTo?: string;\n    references?: string[];\n    messageThreadId?: string;\n    providerKey?: string;\n    createThreadMapping?: boolean;\n  },\n): Promise<{ channelLinkId: string; messageId: string; conversationId: string }> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'emit-inbound', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (emit-inbound) should return 201',\n  ).toBe(201);\n  const body = await readJsonSafe<{\n    channelLinkId?: string;\n    messageId?: string;\n    conversationId?: string;\n  }>(response);\n  return {\n    channelLinkId: expectId(body?.channelLinkId, 'emit-inbound response should include channelLinkId'),\n    messageId: expectId(body?.messageId, 'emit-inbound response should include messageId'),\n    conversationId: expectId(\n      body?.conversationId,\n      'emit-inbound response should include conversationId',\n    ),\n  };\n}\n\n/**\n * Best-effort delete of a seeded channel via the owner-scoped DELETE route.\n * Safe to call with a null id in `finally`.\n */\n/**\n * Ingest an inbound chat message through the REAL `ingest_inbound_message`\n * command: the stub adapter normalizes the frame and the hub composes the\n * platform message via `messages.messages.compose`.\n *\n * Unlike {@link seedInboundMessage}, nothing here is short-circuited \u2014 no row is\n * inserted behind the compose path \u2014 so a hub contract the provider cannot\n * satisfy fails the test instead of hiding behind seeded data. That bypass is\n * exactly why CI was green while every real inbound Discord message was rejected\n * (#4975).\n *\n * The sender is identified only by `senderIdentifier` (a Discord snowflake, a\n * Slack member id, \u2026). There is deliberately no way to pass an address.\n */\nexport async function ingestInboundChatMessage(\n  request: APIRequestContext,\n  token: string,\n  input: {\n    channelId: string;\n    senderIdentifier: string;\n    senderDisplayName?: string;\n    body?: string;\n    externalMessageId: string;\n    externalConversationId: string;\n  },\n): Promise<{\n  status: string;\n  messageId: string | null;\n  conversationId: string | null;\n  channelLinkId: string | null;\n  channelType: string | null;\n}> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'ingest-inbound', ...input },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (ingest-inbound) should return 201 \u2014 ' +\n      'a non-201 here means the hub rejected a sender with no email address',\n  ).toBe(201);\n  const body = await readJsonSafe<{\n    status?: string;\n    messageId?: string | null;\n    conversationId?: string | null;\n    channelLinkId?: string | null;\n    channelType?: string | null;\n  }>(response);\n  return {\n    status: body?.status ?? 'unknown',\n    messageId: body?.messageId ?? null,\n    conversationId: body?.conversationId ?? null,\n    channelLinkId: body?.channelLinkId ?? null,\n    channelType: body?.channelType ?? null,\n  };\n}\n\nexport type InspectedMessageLinks = {\n  links: Array<{\n    id: string;\n    direction: string;\n    providerKey: string;\n    channelType: string;\n    deliveryStatus: string;\n    externalConversationId: string | null;\n  }>;\n  threadMappings: Array<{\n    id: string;\n    messageThreadId: string;\n    channelId: string;\n    externalConversationId: string;\n  }>;\n};\n\n/**\n * Report the `MessageChannelLink` rows and `ChannelThreadMapping` rows a\n * platform message carries. No product API exposes them, so this is the only way\n * to assert that a send really was routed through the hub rather than the\n * platform sender.\n */\nexport async function inspectMessageChannelLinks(\n  request: APIRequestContext,\n  token: string,\n  messageId: string,\n): Promise<InspectedMessageLinks> {\n  const response = await apiRequest(request, 'POST', TEST_SEED_PATH, {\n    token,\n    data: { action: 'inspect-message-links', messageId },\n  });\n  expect(\n    response.status(),\n    'POST /api/communication_channels/test-seed (inspect-message-links) should return 200',\n  ).toBe(200);\n  const body = await readJsonSafe<InspectedMessageLinks>(response);\n  return {\n    links: Array.isArray(body?.links) ? body.links : [],\n    threadMappings: Array.isArray(body?.threadMappings) ? body.threadMappings : [],\n  };\n}\n\nexport async function deleteChannelIfExists(\n  request: APIRequestContext,\n  token: string | null,\n  channelId: string | null,\n): Promise<void> {\n  if (!token || !channelId) return;\n  await apiRequest(\n    request,\n    'DELETE',\n    `/api/communication_channels/channels/${encodeURIComponent(channelId)}`,\n    { token },\n  ).catch(() => undefined);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/helpers/integration/customerGroupsFixtures.js

@@ -0,0 +1,88 @@
+import { randomInt } from "node:crypto";
+import { expect } from "@playwright/test";
+import { apiRequest } from "./api.js";
+import { expectId, readJsonSafe } from "./generalFixtures.js";
+const GROUPS_PATH = "/api/customer_groups/customer-groups";
+const MEMBERSHIPS_PATH = "/api/customer_groups/customer-groups/memberships";
+function uniqueCustomerGroupPriority() {
+  return 3e6 + randomInt(0, 1e9);
+}
+async function createCustomerGroupFixture(request, token, input) {
+  const response = await apiRequest(request, "POST", GROUPS_PATH, {
+    token,
+    data: {
+      code: input.code,
+      name: input.name,
+      kind: input.kind ?? "b2c",
+      priority: input.priority ?? uniqueCustomerGroupPriority(),
+      isDefault: input.isDefault ?? false,
+      isActive: input.isActive ?? true,
+      ...input.parentId ? { parentId: input.parentId } : {}
+    }
+  });
+  expect(response.status(), `create customer group fixture failed: ${response.status()}`).toBe(201);
+  return expectId(
+    (await readJsonSafe(response))?.id,
+    "customer group fixture should return an id"
+  );
+}
+async function deleteCustomerGroupIfExists(request, token, groupId) {
+  if (!token || !groupId) return;
+  await apiRequest(request, "DELETE", `${GROUPS_PATH}?id=${encodeURIComponent(groupId)}`, { token }).catch(
+    () => void 0
+  );
+}
+async function createCustomerGroupMembershipFixture(request, token, input) {
+  const response = await apiRequest(request, "POST", MEMBERSHIPS_PATH, {
+    token,
+    data: {
+      groupId: input.groupId,
+      customerId: input.customerId,
+      source: input.source ?? "manual",
+      ...input.validFrom ? { validFrom: input.validFrom } : {},
+      ...input.validUntil ? { validUntil: input.validUntil } : {}
+    }
+  });
+  expect(response.status(), `create customer group membership fixture failed: ${response.status()}`).toBe(201);
+  return expectId(
+    (await readJsonSafe(response))?.id,
+    "customer group membership fixture should return an id"
+  );
+}
+async function deleteCustomerGroupMembershipIfExists(request, token, membershipId) {
+  if (!token || !membershipId) return;
+  await apiRequest(request, "DELETE", `${MEMBERSHIPS_PATH}?id=${encodeURIComponent(membershipId)}`, {
+    token
+  }).catch(() => void 0);
+}
+async function createCustomerGroupTermsFixture(request, token, input, headers = {}) {
+  const { groupId, ...fields } = input;
+  const data = {};
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== void 0) data[key] = value;
+  }
+  const response = await apiRequest(request, "PUT", `${GROUPS_PATH}/${groupId}/terms`, {
+    token,
+    data,
+    headers
+  });
+  expect(response.status(), `create/update customer group terms fixture failed: ${response.status()}`).toBe(200);
+  const body = await readJsonSafe(response);
+  return {
+    id: expectId(body?.terms?.id, "customer group terms fixture should return an id"),
+    updatedAt: expectId(body?.terms?.updatedAt, "customer group terms fixture should return updatedAt")
+  };
+}
+async function deleteCustomerGroupTermsIfExists(_request, _token, _groupId) {
+  return void 0;
+}
+export {
+  createCustomerGroupFixture,
+  createCustomerGroupMembershipFixture,
+  createCustomerGroupTermsFixture,
+  deleteCustomerGroupIfExists,
+  deleteCustomerGroupMembershipIfExists,
+  deleteCustomerGroupTermsIfExists,
+  uniqueCustomerGroupPriority
+};
+//# sourceMappingURL=customerGroupsFixtures.js.map

package/dist/helpers/integration/customerGroupsFixtures.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/helpers/integration/customerGroupsFixtures.ts"],
+  "sourcesContent": ["import { randomInt } from 'node:crypto';\nimport { expect, type APIRequestContext } from '@playwright/test';\nimport { apiRequest } from './api';\nimport { expectId, readJsonSafe } from './generalFixtures';\n\nconst GROUPS_PATH = '/api/customer_groups/customer-groups';\nconst MEMBERSHIPS_PATH = '/api/customer_groups/customer-groups/memberships';\n\n/**\n * `CustomerGroup.priority` is unique per tenant among live rows (partial\n * unique index `customer_groups_tenant_priority_unique`), and integration\n * specs share one admin tenant. A fixed default would collide with any live\n * group already holding that value, so callers that do not care about the\n * exact priority get a random value from a band no product flow writes\n * (reorder writes 10, 20, ...; the TC-CGRP `fixturePriority` band is\n * 2,000,000-2,999,999).\n */\nexport function uniqueCustomerGroupPriority(): number {\n  return 3_000_000 + randomInt(0, 1_000_000_000);\n}\n\nexport type CustomerGroupFixtureInput = {\n  code: string;\n  name: string;\n  kind?: 'b2c' | 'b2b' | 'internal' | 'partner';\n  priority?: number;\n  isDefault?: boolean;\n  isActive?: boolean;\n  parentId?: string;\n};\n\nexport async function createCustomerGroupFixture(\n  request: APIRequestContext,\n  token: string,\n  input: CustomerGroupFixtureInput,\n): Promise<string> {\n  const response = await apiRequest(request, 'POST', GROUPS_PATH, {\n    token,\n    data: {\n      code: input.code,\n      name: input.name,\n      kind: input.kind ?? 'b2c',\n      priority: input.priority ?? uniqueCustomerGroupPriority(),\n      isDefault: input.isDefault ?? false,\n      isActive: input.isActive ?? true,\n      ...(input.parentId ? { parentId: input.parentId } : {}),\n    },\n  });\n  expect(response.status(), `create customer group fixture failed: ${response.status()}`).toBe(201);\n  return expectId(\n    (await readJsonSafe<{ id?: string }>(response))?.id,\n    'customer group fixture should return an id',\n  );\n}\n\nexport async function deleteCustomerGroupIfExists(\n  request: APIRequestContext,\n  token: string | null,\n  groupId: string | null,\n): Promise<void> {\n  if (!token || !groupId) return;\n  await apiRequest(request, 'DELETE', `${GROUPS_PATH}?id=${encodeURIComponent(groupId)}`, { token }).catch(\n    () => undefined,\n  );\n}\n\nexport type CustomerGroupMembershipFixtureInput = {\n  groupId: string;\n  customerId: string;\n  source?: 'manual' | 'import' | 'rule' | 'onboarding';\n  validFrom?: string;\n  validUntil?: string;\n};\n\nexport async function createCustomerGroupMembershipFixture(\n  request: APIRequestContext,\n  token: string,\n  input: CustomerGroupMembershipFixtureInput,\n): Promise<string> {\n  const response = await apiRequest(request, 'POST', MEMBERSHIPS_PATH, {\n    token,\n    data: {\n      groupId: input.groupId,\n      customerId: input.customerId,\n      source: input.source ?? 'manual',\n      ...(input.validFrom ? { validFrom: input.validFrom } : {}),\n      ...(input.validUntil ? { validUntil: input.validUntil } : {}),\n    },\n  });\n  expect(response.status(), `create customer group membership fixture failed: ${response.status()}`).toBe(201);\n  return expectId(\n    (await readJsonSafe<{ id?: string }>(response))?.id,\n    'customer group membership fixture should return an id',\n  );\n}\n\nexport async function deleteCustomerGroupMembershipIfExists(\n  request: APIRequestContext,\n  token: string | null,\n  membershipId: string | null,\n): Promise<void> {\n  if (!token || !membershipId) return;\n  await apiRequest(request, 'DELETE', `${MEMBERSHIPS_PATH}?id=${encodeURIComponent(membershipId)}`, {\n    token,\n  }).catch(() => undefined);\n}\n\nexport type CustomerGroupTermsFixtureInput = {\n  groupId: string;\n  priceKindId?: string | null;\n  paymentTermsDays?: number | null;\n  allowPurchaseOnAccount?: boolean;\n  defaultCreditLimit?: number | null;\n  creditCurrencyCode?: string | null;\n  approvalRequiredAbove?: number | null;\n  minOrderValue?: number | null;\n  metadata?: Record<string, unknown> | null;\n};\n\nexport type CustomerGroupTermsFixtureResult = {\n  id: string;\n  updatedAt: string;\n};\n\n/**\n * Upserts (`PUT /api/customer_groups/customer-groups/:id/terms`) the target group's commercial\n * terms row. Mirrors `createCustomerGroupFixture`'s shape but returns\n * `{ id, updatedAt }` instead of a bare id \u2014 callers exercising optimistic\n * locking need the row's `updatedAt` immediately after create/update without\n * an extra GET round-trip.\n */\nexport async function createCustomerGroupTermsFixture(\n  request: APIRequestContext,\n  token: string,\n  input: CustomerGroupTermsFixtureInput,\n  headers: Record<string, string> = {},\n): Promise<CustomerGroupTermsFixtureResult> {\n  const { groupId, ...fields } = input;\n  const data: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(fields)) {\n    if (value !== undefined) data[key] = value;\n  }\n  const response = await apiRequest(request, 'PUT', `${GROUPS_PATH}/${groupId}/terms`, {\n    token,\n    data,\n    headers,\n  });\n  expect(response.status(), `create/update customer group terms fixture failed: ${response.status()}`).toBe(200);\n  const body = await readJsonSafe<{ terms?: { id?: string; updatedAt?: string } }>(response);\n  return {\n    id: expectId(body?.terms?.id, 'customer group terms fixture should return an id'),\n    updatedAt: expectId(body?.terms?.updatedAt, 'customer group terms fixture should return updatedAt'),\n  };\n}\n\n/**\n * `CustomerGroupTerms` has no standalone DELETE endpoint \u2014 `GET/PUT\n * /api/customer_groups/customer-groups/:id/terms` only (see the doc comment on that route:\n * terms are a strict 1:1 sub-resource of a group with no independent\n * list/create/delete semantics). Deleting the PARENT group via\n * `deleteCustomerGroupIfExists` is what actually reclaims a terms row in\n * tests. This no-op exists only for naming symmetry with the other\n * `delete*IfExists` helpers so a spec's `finally` block reads consistently.\n */\nexport async function deleteCustomerGroupTermsIfExists(\n  _request: APIRequestContext,\n  _token: string | null,\n  _groupId: string | null,\n): Promise<void> {\n  return undefined;\n}\n"],
+  "mappings": "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",
+  "names": []
+}