@adatechnology/meta-whatsapp-contracts 0.2.0-rc.2 → 0.2.0-rc.4

package/dist/index.js

@@ -130,7 +130,7 @@ var flowNodeDataSchema = z2.object({
     z2.string()
   ])).optional(),
   actionKind: z2.string().optional(),
-  simulationTemplate: z2.record(z2.string(), z2.string()).optional(),
+  actionParams: z2.record(z2.string(), z2.unknown()).optional(),
   directMessage: z2.string().optional(),
   fallbackMessage: z2.string().optional(),
   conditionContextKey: z2.string().optional(),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/webhook.types.ts","../src/flow.types.ts","../src/errors.ts"],"sourcesContent":["import { z } from 'zod'\n\n// Extraído de financiamento-imobiliario-bot/apps/api/src/modules/webhook/application/use-cases/\n// ReceiveWhatsAppWebhook.use-case.ts:39-113 — shape real do payload da Cloud API da Meta.\n\nexport const whatsAppMediaSchema = z.object({\n  id: z.string(),\n  mime_type: z.string(),\n  sha256: z.string().optional(),\n  caption: z.string().optional(),\n  filename: z.string().optional(),\n})\nexport type WhatsAppMedia = z.infer<typeof whatsAppMediaSchema>\n\nexport const whatsAppInteractiveSchema = z.object({\n  type: z.string(),\n  button_reply: z.object({ id: z.string(), title: z.string() }).optional(),\n  list_reply: z.object({ id: z.string(), title: z.string() }).optional(),\n})\nexport type WhatsAppInteractive = z.infer<typeof whatsAppInteractiveSchema>\n\nexport const whatsAppOrderSchema = z.object({\n  catalog_id: z.string(),\n  text: z.string().optional(),\n  product_items: z.array(\n    z.object({\n      product_retailer_id: z.string(),\n      quantity: z.number(),\n      item_price: z.number(),\n      currency: z.string(),\n    }),\n  ),\n})\nexport type WhatsAppOrder = z.infer<typeof whatsAppOrderSchema>\n\nexport const whatsAppMessageSchema = z.object({\n  id: z.string(),\n  from: z.string(),\n  type: z.string(),\n  text: z.object({ body: z.string() }).optional(),\n  image: whatsAppMediaSchema.optional(),\n  audio: whatsAppMediaSchema.optional(),\n  video: whatsAppMediaSchema.optional(),\n  document: whatsAppMediaSchema.optional(),\n  sticker: whatsAppMediaSchema.optional(),\n  interactive: whatsAppInteractiveSchema.optional(),\n  // Pedido enviado pelo carrinho do catálogo (WhatsApp Commerce)\n  order: whatsAppOrderSchema.optional(),\n  // Presente quando o cliente abre um item do catálogo e manda mensagem pela página do produto\n  context: z\n    .object({\n      from: z.string().optional(),\n      id: z.string().optional(),\n      referred_product: z.object({ catalog_id: z.string(), product_retailer_id: z.string() }).optional(),\n    })\n    .optional(),\n  timestamp: z.string(),\n})\nexport type WhatsAppMessage = z.infer<typeof whatsAppMessageSchema>\n\nexport const whatsAppMessageEchoSchema = z.object({\n  id: z.string(),\n  from: z.string(),\n  timestamp: z.string(),\n  type: z.string(),\n})\nexport type WhatsAppMessageEcho = z.infer<typeof whatsAppMessageEchoSchema>\n\nexport const whatsAppMessageStatusSchema = z.enum(['sent', 'delivered', 'read', 'failed'])\nexport type WhatsAppMessageStatusValue = z.infer<typeof whatsAppMessageStatusSchema>\n\nexport const whatsAppStatusSchema = z.object({\n  id: z.string(),\n  status: whatsAppMessageStatusSchema,\n  timestamp: z.string(),\n  recipient_id: z.string().optional(),\n})\nexport type WhatsAppStatus = z.infer<typeof whatsAppStatusSchema>\n\nexport const whatsAppWebhookPayloadSchema = z.object({\n  object: z.string(),\n  entry: z.array(\n    z.object({\n      id: z.string(),\n      changes: z.array(\n        z.object({\n          value: z.object({\n            messaging_product: z.string(),\n            messages: z.array(whatsAppMessageSchema).optional(),\n            message_echoes: z.array(whatsAppMessageEchoSchema).optional(),\n            statuses: z.array(whatsAppStatusSchema).optional(),\n            metadata: z.object({ display_phone_number: z.string(), phone_number_id: z.string() }).optional(),\n          }),\n        }),\n      ),\n    }),\n  ),\n})\nexport type WhatsAppWebhookPayload = z.infer<typeof whatsAppWebhookPayloadSchema>\n","// Mesmo shape de dados do editor visual (@adatechnology/conversations-ui/flows) — o backend\n// interpreta/persiste o grafo, o frontend edita; os dois lados precisam concordar no formato.\n// `FlowActionKind` é string aberta (não union fechada): o host registra os próprios actions\n// (ex.: 'trigger_simulation' no bot) via registerFlowAction() no módulo (T4.3) — o pacote nunca\n// assume nenhum caso de negócio específico.\nimport { z } from 'zod'\n\nexport type FlowNodeType = 'question' | 'entrada_choice' | 'action' | 'menu' | 'condition'\nexport type FlowQuestionType = 'text' | 'money' | 'date' | 'int' | 'cpf' | 'choice'\nexport type FlowActionKind = string\nexport type FlowConditionOperator = '>' | '>=' | '<' | '<=' | '==' | '!=' | 'contains'\nexport type FlowNodeNext = string | { byAnswer: Record<string, string>; default: string }\n\n// Destinos \"flow:<key>\" são saltos para outro fluxo — mesma convenção usada pelo editor visual\n// (conversations-ui/flows/flowGraph.ts); backend e frontend precisam concordar no formato.\nexport const CROSS_FLOW_PREFIX = 'flow:'\nexport const isCrossFlowTarget = (target: string): boolean => target.startsWith(CROSS_FLOW_PREFIX)\nexport const crossFlowKey = (target: string): string => target.slice(CROSS_FLOW_PREFIX.length)\n\nexport type FlowNodeData = {\n  id: string\n  type: FlowNodeType\n  contextKey?: string\n  questionType?: FlowQuestionType\n  question?: string\n  options?: [string, string][]\n  actionKind?: FlowActionKind\n  simulationTemplate?: Record<string, string>\n  directMessage?: string\n  fallbackMessage?: string\n  conditionContextKey?: string\n  conditionOperator?: FlowConditionOperator\n  conditionValue?: string\n  position?: { x: number; y: number }\n  next?: FlowNodeNext\n}\n\nexport interface FlowGraphData {\n  key: string\n  label: string\n  startNodeId: string\n  version: number\n  nodes: Record<string, FlowNodeData>\n}\n\nexport interface FlowGraphSummary {\n  key: string\n  label: string\n  nodeCount: number\n  showInMenu: boolean\n  menuOptionLabel?: string\n  updatedAt: string\n}\n\n// Retorno de GetLiveFlowPositions (T4.2) — quantas sessões ativas estão em cada nó agora,\n// usado pelo editor para desenhar o \"liveCount\" nos cards (FlowNodeCardData.liveCount).\nexport interface LiveFlowPosition {\n  flowKey: string\n  nodeId: string\n  count: number\n}\n\n// Validação de runtime do grafo. O `nodes` é um jsonb que entrou pelo editor (dado de origem\n// cliente) e sai do banco como `unknown` — sem parse, um grafo malformado só se manifestaria\n// como comportamento estranho lá dentro do interpretador, longe da causa.\n//\n// Permissivo de propósito em dois pontos: `actionKind` é string aberta (o host registra os\n// seus) e `.passthrough()` deixa passar campos extras — um grafo salvo por uma versão mais nova\n// do editor não pode ficar irrecuperável numa versão mais antiga do módulo.\nexport const flowNodeNextSchema = z.union([\n  z.string(),\n  z.object({ byAnswer: z.record(z.string(), z.string()), default: z.string() }),\n])\n\nexport const flowNodeDataSchema = z\n  .object({\n    id: z.string(),\n    type: z.enum(['question', 'entrada_choice', 'action', 'menu', 'condition']),\n    contextKey: z.string().optional(),\n    questionType: z.enum(['text', 'money', 'date', 'int', 'cpf', 'choice']).optional(),\n    question: z.string().optional(),\n    options: z.array(z.tuple([z.string(), z.string()])).optional(),\n    actionKind: z.string().optional(),\n    simulationTemplate: z.record(z.string(), z.string()).optional(),\n    directMessage: z.string().optional(),\n    fallbackMessage: z.string().optional(),\n    conditionContextKey: z.string().optional(),\n    conditionOperator: z.enum(['>', '>=', '<', '<=', '==', '!=', 'contains']).optional(),\n    conditionValue: z.string().optional(),\n    position: z.object({ x: z.number(), y: z.number() }).optional(),\n    next: flowNodeNextSchema.optional(),\n  })\n  .passthrough()\n\nexport const flowGraphNodesSchema = z.record(z.string(), flowNodeDataSchema)\n","// Hierarquia de erros do módulo — não depende do framework de erros do host (nenhum DomainError\n// importado); o host mapeia estes para o seu próprio formato de resposta no exception filter.\nexport class MetaWhatsAppError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly code: string,\n    public readonly details?: Record<string, unknown>,\n  ) {\n    super(message)\n    this.name = 'MetaWhatsAppError'\n  }\n}\n\nexport const META_WHATSAPP_ERROR_CODES = {\n  WINDOW_EXPIRED: 'META_WHATSAPP_WINDOW_EXPIRED',\n  INVALID_SIGNATURE: 'META_WHATSAPP_INVALID_SIGNATURE',\n  DUPLICATE_DELIVERY: 'META_WHATSAPP_DUPLICATE_DELIVERY',\n  CONFIG_MISSING: 'META_WHATSAPP_CONFIG_MISSING',\n  TEMPLATE_NOT_CONFIGURED: 'META_WHATSAPP_TEMPLATE_NOT_CONFIGURED',\n  SESSION_NOT_FOUND: 'META_WHATSAPP_SESSION_NOT_FOUND',\n} as const\n\nexport class WindowExpiredError extends MetaWhatsAppError {\n  constructor(public readonly hoursSinceLastMessage?: number) {\n    super(\n      'Janela de 24h expirada — não é possível enviar mensagem para este contato fora de template.',\n      400,\n      META_WHATSAPP_ERROR_CODES.WINDOW_EXPIRED,\n      { hoursSinceLastMessage },\n    )\n  }\n}\n\n// Assinatura HMAC do webhook não confere — Meta ou um terceiro tentando forjar uma entrega.\nexport class InvalidWebhookSignatureError extends MetaWhatsAppError {\n  constructor() {\n    super('Assinatura do webhook inválida.', 401, META_WHATSAPP_ERROR_CODES.INVALID_SIGNATURE)\n  }\n}\n\n// Meta reenviou uma entrega dentro da janela de replay (nonce já visto) — não é erro do\n// cliente, é comportamento esperado da Cloud API; o host deve responder 200 e ignorar.\nexport class DuplicateWebhookDeliveryError extends MetaWhatsAppError {\n  constructor(nonce: string) {\n    super('Entrega de webhook duplicada.', 409, META_WHATSAPP_ERROR_CODES.DUPLICATE_DELIVERY, { nonce })\n  }\n}\n\nexport class ConfigMissingError extends MetaWhatsAppError {\n  constructor(missingField: string) {\n    super(`Configuração do WhatsApp ausente: ${missingField}.`, 503, META_WHATSAPP_ERROR_CODES.CONFIG_MISSING, {\n      missingField,\n    })\n  }\n}\n\nexport class TemplateNotConfiguredError extends MetaWhatsAppError {\n  constructor() {\n    super(\n      'Nenhum template de WhatsApp configurado para reabertura de janela.',\n      503,\n      META_WHATSAPP_ERROR_CODES.TEMPLATE_NOT_CONFIGURED,\n    )\n  }\n}\n\nexport class SessionNotFoundError extends MetaWhatsAppError {\n  constructor(whatsappNumber: string) {\n    super(\n      `Sessão de conversa não encontrada para ${whatsappNumber}.`,\n      404,\n      META_WHATSAPP_ERROR_CODES.SESSION_NOT_FOUND,\n      { whatsappNumber },\n    )\n  }\n}\n"],"mappings":"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","names":["z","whatsAppMediaSchema","object","id","string","mime_type","sha256","optional","caption","filename","whatsAppInteractiveSchema","type","button_reply","title","list_reply","whatsAppOrderSchema","catalog_id","text","product_items","array","product_retailer_id","quantity","number","item_price","currency","whatsAppMessageSchema","from","body","image","audio","video","document","sticker","interactive","order","context","referred_product","timestamp","whatsAppMessageEchoSchema","whatsAppMessageStatusSchema","enum","whatsAppStatusSchema","status","recipient_id","whatsAppWebhookPayloadSchema","entry","changes","value","messaging_product","messages","message_echoes","statuses","metadata","display_phone_number","phone_number_id","z","CROSS_FLOW_PREFIX","isCrossFlowTarget","target","startsWith","crossFlowKey","slice","length","flowNodeNextSchema","z","union","string","object","byAnswer","record","default","flowNodeDataSchema","id","type","enum","contextKey","optional","questionType","question","options","array","tuple","actionKind","simulationTemplate","directMessage","fallbackMessage","conditionContextKey","conditionOperator","conditionValue","position","x","number","y","next","passthrough","flowGraphNodesSchema","MetaWhatsAppError","Error","message","statusCode","code","details","name","META_WHATSAPP_ERROR_CODES","WINDOW_EXPIRED","INVALID_SIGNATURE","DUPLICATE_DELIVERY","CONFIG_MISSING","TEMPLATE_NOT_CONFIGURED","SESSION_NOT_FOUND","WindowExpiredError","hoursSinceLastMessage","InvalidWebhookSignatureError","DuplicateWebhookDeliveryError","nonce","ConfigMissingError","missingField","TemplateNotConfiguredError","SessionNotFoundError","whatsappNumber"]}
+{"version":3,"sources":["../src/webhook.types.ts","../src/flow.types.ts","../src/errors.ts"],"sourcesContent":["import { z } from 'zod'\n\n// Extraído de financiamento-imobiliario-bot/apps/api/src/modules/webhook/application/use-cases/\n// ReceiveWhatsAppWebhook.use-case.ts:39-113 — shape real do payload da Cloud API da Meta.\n\nexport const whatsAppMediaSchema = z.object({\n  id: z.string(),\n  mime_type: z.string(),\n  sha256: z.string().optional(),\n  caption: z.string().optional(),\n  filename: z.string().optional(),\n})\nexport type WhatsAppMedia = z.infer<typeof whatsAppMediaSchema>\n\nexport const whatsAppInteractiveSchema = z.object({\n  type: z.string(),\n  button_reply: z.object({ id: z.string(), title: z.string() }).optional(),\n  list_reply: z.object({ id: z.string(), title: z.string() }).optional(),\n})\nexport type WhatsAppInteractive = z.infer<typeof whatsAppInteractiveSchema>\n\nexport const whatsAppOrderSchema = z.object({\n  catalog_id: z.string(),\n  text: z.string().optional(),\n  product_items: z.array(\n    z.object({\n      product_retailer_id: z.string(),\n      quantity: z.number(),\n      item_price: z.number(),\n      currency: z.string(),\n    }),\n  ),\n})\nexport type WhatsAppOrder = z.infer<typeof whatsAppOrderSchema>\n\nexport const whatsAppMessageSchema = z.object({\n  id: z.string(),\n  from: z.string(),\n  type: z.string(),\n  text: z.object({ body: z.string() }).optional(),\n  image: whatsAppMediaSchema.optional(),\n  audio: whatsAppMediaSchema.optional(),\n  video: whatsAppMediaSchema.optional(),\n  document: whatsAppMediaSchema.optional(),\n  sticker: whatsAppMediaSchema.optional(),\n  interactive: whatsAppInteractiveSchema.optional(),\n  // Pedido enviado pelo carrinho do catálogo (WhatsApp Commerce)\n  order: whatsAppOrderSchema.optional(),\n  // Presente quando o cliente abre um item do catálogo e manda mensagem pela página do produto\n  context: z\n    .object({\n      from: z.string().optional(),\n      id: z.string().optional(),\n      referred_product: z.object({ catalog_id: z.string(), product_retailer_id: z.string() }).optional(),\n    })\n    .optional(),\n  timestamp: z.string(),\n})\nexport type WhatsAppMessage = z.infer<typeof whatsAppMessageSchema>\n\nexport const whatsAppMessageEchoSchema = z.object({\n  id: z.string(),\n  from: z.string(),\n  timestamp: z.string(),\n  type: z.string(),\n})\nexport type WhatsAppMessageEcho = z.infer<typeof whatsAppMessageEchoSchema>\n\nexport const whatsAppMessageStatusSchema = z.enum(['sent', 'delivered', 'read', 'failed'])\nexport type WhatsAppMessageStatusValue = z.infer<typeof whatsAppMessageStatusSchema>\n\nexport const whatsAppStatusSchema = z.object({\n  id: z.string(),\n  status: whatsAppMessageStatusSchema,\n  timestamp: z.string(),\n  recipient_id: z.string().optional(),\n})\nexport type WhatsAppStatus = z.infer<typeof whatsAppStatusSchema>\n\nexport const whatsAppWebhookPayloadSchema = z.object({\n  object: z.string(),\n  entry: z.array(\n    z.object({\n      id: z.string(),\n      changes: z.array(\n        z.object({\n          value: z.object({\n            messaging_product: z.string(),\n            messages: z.array(whatsAppMessageSchema).optional(),\n            message_echoes: z.array(whatsAppMessageEchoSchema).optional(),\n            statuses: z.array(whatsAppStatusSchema).optional(),\n            metadata: z.object({ display_phone_number: z.string(), phone_number_id: z.string() }).optional(),\n          }),\n        }),\n      ),\n    }),\n  ),\n})\nexport type WhatsAppWebhookPayload = z.infer<typeof whatsAppWebhookPayloadSchema>\n","// Mesmo shape de dados do editor visual (@adatechnology/conversations-ui/flows) — o backend\n// interpreta/persiste o grafo, o frontend edita; os dois lados precisam concordar no formato.\n// `FlowActionKind` é string aberta (não union fechada): o host registra os próprios actions\n// (ex.: 'trigger_simulation' no bot) via registerFlowAction() no módulo (T4.3) — o pacote nunca\n// assume nenhum caso de negócio específico.\nimport { z } from 'zod'\n\nexport type FlowNodeType = 'question' | 'entrada_choice' | 'action' | 'menu' | 'condition'\nexport type FlowQuestionType = 'text' | 'money' | 'date' | 'int' | 'cpf' | 'choice'\nexport type FlowActionKind = string\nexport type FlowConditionOperator = '>' | '>=' | '<' | '<=' | '==' | '!=' | 'contains'\nexport type FlowNodeNext = string | { byAnswer: Record<string, string>; default: string }\n\n// Destinos \"flow:<key>\" são saltos para outro fluxo — mesma convenção usada pelo editor visual\n// (conversations-ui/flows/flowGraph.ts); backend e frontend precisam concordar no formato.\nexport const CROSS_FLOW_PREFIX = 'flow:'\nexport const isCrossFlowTarget = (target: string): boolean => target.startsWith(CROSS_FLOW_PREFIX)\nexport const crossFlowKey = (target: string): string => target.slice(CROSS_FLOW_PREFIX.length)\n\nexport type FlowNodeData = {\n  id: string\n  type: FlowNodeType\n  contextKey?: string\n  questionType?: FlowQuestionType\n  question?: string\n  options?: [string, string][]\n  actionKind?: FlowActionKind\n  // Parâmetros arbitrários que o nó carrega para o handler registrado em `actionKind`. O pacote\n  // nunca os interpreta — é o que permite um nó de ação ser configurado pelo editor sem que o\n  // vocabulário do produto (o antigo `simulationTemplate`) vaze para dentro do contrato.\n  actionParams?: Record<string, unknown>\n  directMessage?: string\n  fallbackMessage?: string\n  conditionContextKey?: string\n  conditionOperator?: FlowConditionOperator\n  conditionValue?: string\n  position?: { x: number; y: number }\n  next?: FlowNodeNext\n}\n\nexport interface FlowGraphData {\n  key: string\n  label: string\n  startNodeId: string\n  version: number\n  nodes: Record<string, FlowNodeData>\n}\n\nexport interface FlowGraphSummary {\n  key: string\n  label: string\n  nodeCount: number\n  showInMenu: boolean\n  menuOptionLabel?: string\n  updatedAt: string\n}\n\n// Retorno de GetLiveFlowPositions (T4.2) — quantas sessões ativas estão em cada nó agora,\n// usado pelo editor para desenhar o \"liveCount\" nos cards (FlowNodeCardData.liveCount).\nexport interface LiveFlowPosition {\n  flowKey: string\n  nodeId: string\n  count: number\n}\n\n// Validação de runtime do grafo. O `nodes` é um jsonb que entrou pelo editor (dado de origem\n// cliente) e sai do banco como `unknown` — sem parse, um grafo malformado só se manifestaria\n// como comportamento estranho lá dentro do interpretador, longe da causa.\n//\n// Permissivo de propósito em dois pontos: `actionKind` é string aberta (o host registra os\n// seus) e `.passthrough()` deixa passar campos extras — um grafo salvo por uma versão mais nova\n// do editor não pode ficar irrecuperável numa versão mais antiga do módulo.\nexport const flowNodeNextSchema = z.union([\n  z.string(),\n  z.object({ byAnswer: z.record(z.string(), z.string()), default: z.string() }),\n])\n\nexport const flowNodeDataSchema = z\n  .object({\n    id: z.string(),\n    type: z.enum(['question', 'entrada_choice', 'action', 'menu', 'condition']),\n    contextKey: z.string().optional(),\n    questionType: z.enum(['text', 'money', 'date', 'int', 'cpf', 'choice']).optional(),\n    question: z.string().optional(),\n    options: z.array(z.tuple([z.string(), z.string()])).optional(),\n    actionKind: z.string().optional(),\n    actionParams: z.record(z.string(), z.unknown()).optional(),\n    directMessage: z.string().optional(),\n    fallbackMessage: z.string().optional(),\n    conditionContextKey: z.string().optional(),\n    conditionOperator: z.enum(['>', '>=', '<', '<=', '==', '!=', 'contains']).optional(),\n    conditionValue: z.string().optional(),\n    position: z.object({ x: z.number(), y: z.number() }).optional(),\n    next: flowNodeNextSchema.optional(),\n  })\n  .passthrough()\n\nexport const flowGraphNodesSchema = z.record(z.string(), flowNodeDataSchema)\n","// Hierarquia de erros do módulo — não depende do framework de erros do host (nenhum DomainError\n// importado); o host mapeia estes para o seu próprio formato de resposta no exception filter.\nexport class MetaWhatsAppError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly code: string,\n    public readonly details?: Record<string, unknown>,\n  ) {\n    super(message)\n    this.name = 'MetaWhatsAppError'\n  }\n}\n\nexport const META_WHATSAPP_ERROR_CODES = {\n  WINDOW_EXPIRED: 'META_WHATSAPP_WINDOW_EXPIRED',\n  INVALID_SIGNATURE: 'META_WHATSAPP_INVALID_SIGNATURE',\n  DUPLICATE_DELIVERY: 'META_WHATSAPP_DUPLICATE_DELIVERY',\n  CONFIG_MISSING: 'META_WHATSAPP_CONFIG_MISSING',\n  TEMPLATE_NOT_CONFIGURED: 'META_WHATSAPP_TEMPLATE_NOT_CONFIGURED',\n  SESSION_NOT_FOUND: 'META_WHATSAPP_SESSION_NOT_FOUND',\n} as const\n\nexport class WindowExpiredError extends MetaWhatsAppError {\n  constructor(public readonly hoursSinceLastMessage?: number) {\n    super(\n      'Janela de 24h expirada — não é possível enviar mensagem para este contato fora de template.',\n      400,\n      META_WHATSAPP_ERROR_CODES.WINDOW_EXPIRED,\n      { hoursSinceLastMessage },\n    )\n  }\n}\n\n// Assinatura HMAC do webhook não confere — Meta ou um terceiro tentando forjar uma entrega.\nexport class InvalidWebhookSignatureError extends MetaWhatsAppError {\n  constructor() {\n    super('Assinatura do webhook inválida.', 401, META_WHATSAPP_ERROR_CODES.INVALID_SIGNATURE)\n  }\n}\n\n// Meta reenviou uma entrega dentro da janela de replay (nonce já visto) — não é erro do\n// cliente, é comportamento esperado da Cloud API; o host deve responder 200 e ignorar.\nexport class DuplicateWebhookDeliveryError extends MetaWhatsAppError {\n  constructor(nonce: string) {\n    super('Entrega de webhook duplicada.', 409, META_WHATSAPP_ERROR_CODES.DUPLICATE_DELIVERY, { nonce })\n  }\n}\n\nexport class ConfigMissingError extends MetaWhatsAppError {\n  constructor(missingField: string) {\n    super(`Configuração do WhatsApp ausente: ${missingField}.`, 503, META_WHATSAPP_ERROR_CODES.CONFIG_MISSING, {\n      missingField,\n    })\n  }\n}\n\nexport class TemplateNotConfiguredError extends MetaWhatsAppError {\n  constructor() {\n    super(\n      'Nenhum template de WhatsApp configurado para reabertura de janela.',\n      503,\n      META_WHATSAPP_ERROR_CODES.TEMPLATE_NOT_CONFIGURED,\n    )\n  }\n}\n\nexport class SessionNotFoundError extends MetaWhatsAppError {\n  constructor(whatsappNumber: string) {\n    super(\n      `Sessão de conversa não encontrada para ${whatsappNumber}.`,\n      404,\n      META_WHATSAPP_ERROR_CODES.SESSION_NOT_FOUND,\n      { whatsappNumber },\n    )\n  }\n}\n"],"mappings":"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","names":["z","whatsAppMediaSchema","object","id","string","mime_type","sha256","optional","caption","filename","whatsAppInteractiveSchema","type","button_reply","title","list_reply","whatsAppOrderSchema","catalog_id","text","product_items","array","product_retailer_id","quantity","number","item_price","currency","whatsAppMessageSchema","from","body","image","audio","video","document","sticker","interactive","order","context","referred_product","timestamp","whatsAppMessageEchoSchema","whatsAppMessageStatusSchema","enum","whatsAppStatusSchema","status","recipient_id","whatsAppWebhookPayloadSchema","entry","changes","value","messaging_product","messages","message_echoes","statuses","metadata","display_phone_number","phone_number_id","z","CROSS_FLOW_PREFIX","isCrossFlowTarget","target","startsWith","crossFlowKey","slice","length","flowNodeNextSchema","z","union","string","object","byAnswer","record","default","flowNodeDataSchema","id","type","enum","contextKey","optional","questionType","question","options","array","tuple","actionKind","actionParams","unknown","directMessage","fallbackMessage","conditionContextKey","conditionOperator","conditionValue","position","x","number","y","next","passthrough","flowGraphNodesSchema","MetaWhatsAppError","Error","message","statusCode","code","details","name","META_WHATSAPP_ERROR_CODES","WINDOW_EXPIRED","INVALID_SIGNATURE","DUPLICATE_DELIVERY","CONFIG_MISSING","TEMPLATE_NOT_CONFIGURED","SESSION_NOT_FOUND","WindowExpiredError","hoursSinceLastMessage","InvalidWebhookSignatureError","DuplicateWebhookDeliveryError","nonce","ConfigMissingError","missingField","TemplateNotConfiguredError","SessionNotFoundError","whatsappNumber"]}

package/dist/testing/index.cjs

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing/index.ts
+var testing_exports = {};
+__export(testing_exports, {
+  PREVIEW_AUDIO_MIME_TYPE: () => PREVIEW_AUDIO_MIME_TYPE,
+  PREVIEW_DISPLAY_PHONE_NUMBER: () => PREVIEW_DISPLAY_PHONE_NUMBER,
+  PREVIEW_PHONE_NUMBER_ID: () => PREVIEW_PHONE_NUMBER_ID,
+  PREVIEW_WABA_ID: () => PREVIEW_WABA_ID,
+  buildInboundAudioPayload: () => buildInboundAudioPayload,
+  buildInboundInteractivePayload: () => buildInboundInteractivePayload,
+  buildInboundTextPayload: () => buildInboundTextPayload,
+  serializeWebhookPayload: () => serializeWebhookPayload
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/testing/inboundPayloads.ts
+var PREVIEW_PHONE_NUMBER_ID = "000000000000000";
+var PREVIEW_WABA_ID = "000000000000001";
+var PREVIEW_DISPLAY_PHONE_NUMBER = "+5511900000000";
+var PREVIEW_AUDIO_MIME_TYPE = "audio/ogg; codecs=opus";
+function generateWamid() {
+  const unique = globalThis.crypto.randomUUID().replaceAll("-", "");
+  return `wamid.${unique}`;
+}
+__name(generateWamid, "generateWamid");
+function currentTimestamp() {
+  return Math.floor(Date.now() / 1e3).toString();
+}
+__name(currentTimestamp, "currentTimestamp");
+function buildEnvelope(params) {
+  return {
+    object: "whatsapp_business_account",
+    entry: [
+      {
+        id: params.wabaId ?? PREVIEW_WABA_ID,
+        changes: [
+          {
+            value: {
+              messaging_product: "whatsapp",
+              metadata: {
+                display_phone_number: params.displayPhoneNumber ?? PREVIEW_DISPLAY_PHONE_NUMBER,
+                phone_number_id: params.phoneNumberId ?? PREVIEW_PHONE_NUMBER_ID
+              },
+              messages: [
+                params.message
+              ]
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
+__name(buildEnvelope, "buildEnvelope");
+function buildInboundTextPayload(params) {
+  const { text, ...envelope } = params;
+  return buildEnvelope({
+    ...envelope,
+    message: {
+      id: generateWamid(),
+      from: params.from,
+      type: "text",
+      text: {
+        body: text
+      },
+      timestamp: currentTimestamp()
+    }
+  });
+}
+__name(buildInboundTextPayload, "buildInboundTextPayload");
+function buildInboundInteractivePayload(params) {
+  const { buttonReply, listReply, ...envelope } = params;
+  const interactive = buttonReply ? {
+    type: "button_reply",
+    button_reply: buttonReply
+  } : {
+    type: "list_reply",
+    list_reply: listReply
+  };
+  return buildEnvelope({
+    ...envelope,
+    message: {
+      id: generateWamid(),
+      from: params.from,
+      type: "interactive",
+      interactive,
+      timestamp: currentTimestamp()
+    }
+  });
+}
+__name(buildInboundInteractivePayload, "buildInboundInteractivePayload");
+function buildInboundAudioPayload(params) {
+  const { mediaId, mimeType, ...envelope } = params;
+  return buildEnvelope({
+    ...envelope,
+    message: {
+      id: generateWamid(),
+      from: params.from,
+      type: "audio",
+      audio: {
+        id: mediaId,
+        mime_type: mimeType ?? PREVIEW_AUDIO_MIME_TYPE
+      },
+      timestamp: currentTimestamp()
+    }
+  });
+}
+__name(buildInboundAudioPayload, "buildInboundAudioPayload");
+function serializeWebhookPayload(payload) {
+  return JSON.stringify(payload);
+}
+__name(serializeWebhookPayload, "serializeWebhookPayload");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PREVIEW_AUDIO_MIME_TYPE,
+  PREVIEW_DISPLAY_PHONE_NUMBER,
+  PREVIEW_PHONE_NUMBER_ID,
+  PREVIEW_WABA_ID,
+  buildInboundAudioPayload,
+  buildInboundInteractivePayload,
+  buildInboundTextPayload,
+  serializeWebhookPayload
+});
+//# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts","../../src/testing/inboundPayloads.ts"],"sourcesContent":["/**\n * Export separado (`@adatechnology/meta-whatsapp-contracts/testing`): utilitário de\n * desenvolvimento não entra no grafo de import de quem consome os contratos em produção.\n */\n\nexport {\n  buildInboundTextPayload,\n  buildInboundInteractivePayload,\n  buildInboundAudioPayload,\n  serializeWebhookPayload,\n  PREVIEW_PHONE_NUMBER_ID,\n  PREVIEW_WABA_ID,\n  PREVIEW_DISPLAY_PHONE_NUMBER,\n  PREVIEW_AUDIO_MIME_TYPE,\n} from './inboundPayloads'\n\nexport type {\n  BuildInboundTextPayloadParams,\n  BuildInboundInteractivePayloadParams,\n  BuildInboundAudioPayloadParams,\n  InteractiveReplyOption,\n} from './inboundPayloads'\n","/**\n * Builders de payload inbound para exercitar o webhook em desenvolvimento sem um app da Meta\n * credenciado. Moram aqui, e não no módulo, por uma razão de runtime: o preview do navegador\n * precisa montar payloads, e o módulo depende de `node:crypto` — importá-lo do frontend quebraria\n * o bundle. Este pacote só depende de zod, então roda nos dois lados.\n *\n * São construção de payload, não assinatura: assinar depende do runtime (`node:crypto` no\n * servidor, WebCrypto no navegador) e fica com quem tem o segredo.\n *\n * Por que `id` e `timestamp` são novos a cada chamada: o anti-replay do webhook usa o header de\n * assinatura como nonce, e a assinatura é derivada do corpo cru. Dois payloads idênticos geram a\n * mesma assinatura, e a segunda entrega é descartada como duplicata — numa conversa real (\"sim\"\n * duas vezes) isso apareceria como mensagem engolida, sem erro nenhum para investigar.\n */\n\nimport type { WhatsAppMessage, WhatsAppWebhookPayload } from '../webhook.types'\n\n// Valores de dev que espelham o formato dos reais (15 dígitos) sem apontar para nada da Meta.\nexport const PREVIEW_PHONE_NUMBER_ID = '000000000000000'\nexport const PREVIEW_WABA_ID = '000000000000001'\nexport const PREVIEW_DISPLAY_PHONE_NUMBER = '+5511900000000'\n\n// O que a Meta manda para áudio gravado no app; o pipeline de STT depende do mime para decodificar.\nexport const PREVIEW_AUDIO_MIME_TYPE = 'audio/ogg; codecs=opus'\n\ntype InboundEnvelopeParams = {\n  readonly from: string\n  readonly phoneNumberId?: string\n  readonly displayPhoneNumber?: string\n  readonly wabaId?: string\n}\n\n// `globalThis.crypto` em vez de `node:crypto`: é o que existe tanto no navegador quanto no Node\n// 19+/Bun, e é o que mantém estes builders utilizáveis pelo preview do navegador.\nfunction generateWamid(): string {\n  // Formato real é `wamid.<base64>`. O prefixo importa para quem faz parsing por prefixo; o corpo\n  // só precisa ser único por entrega, que é o que mantém a assinatura — e o nonce — distinta.\n  const unique = globalThis.crypto.randomUUID().replaceAll('-', '')\n  return `wamid.${unique}`\n}\n\nfunction currentTimestamp(): string {\n  return Math.floor(Date.now() / 1000).toString()\n}\n\ntype BuildEnvelopeParams = InboundEnvelopeParams & {\n  readonly message: WhatsAppMessage\n}\n\nfunction buildEnvelope(params: BuildEnvelopeParams): WhatsAppWebhookPayload {\n  return {\n    object: 'whatsapp_business_account',\n    entry: [\n      {\n        id: params.wabaId ?? PREVIEW_WABA_ID,\n        changes: [\n          {\n            value: {\n              messaging_product: 'whatsapp',\n              metadata: {\n                display_phone_number: params.displayPhoneNumber ?? PREVIEW_DISPLAY_PHONE_NUMBER,\n                phone_number_id: params.phoneNumberId ?? PREVIEW_PHONE_NUMBER_ID,\n              },\n              messages: [params.message],\n            },\n          },\n        ],\n      },\n    ],\n  }\n}\n\nexport type BuildInboundTextPayloadParams = InboundEnvelopeParams & {\n  readonly text: string\n}\n\nexport function buildInboundTextPayload(params: BuildInboundTextPayloadParams): WhatsAppWebhookPayload {\n  const { text, ...envelope } = params\n\n  return buildEnvelope({\n    ...envelope,\n    message: {\n      id: generateWamid(),\n      from: params.from,\n      type: 'text',\n      text: { body: text },\n      timestamp: currentTimestamp(),\n    },\n  })\n}\n\nexport type InteractiveReplyOption = {\n  readonly id: string\n  readonly title: string\n}\n\n// União exclusiva: uma resposta interativa é de botão OU de lista, nunca das duas nem de nenhuma.\n// O tipo torna o erro impossível em vez de validá-lo em runtime.\nexport type BuildInboundInteractivePayloadParams = InboundEnvelopeParams &\n  (\n    | { readonly buttonReply: InteractiveReplyOption; readonly listReply?: never }\n    | { readonly listReply: InteractiveReplyOption; readonly buttonReply?: never }\n  )\n\nexport function buildInboundInteractivePayload(params: BuildInboundInteractivePayloadParams): WhatsAppWebhookPayload {\n  const { buttonReply, listReply, ...envelope } = params\n\n  const interactive = buttonReply\n    ? { type: 'button_reply', button_reply: buttonReply }\n    : { type: 'list_reply', list_reply: listReply }\n\n  return buildEnvelope({\n    ...envelope,\n    message: {\n      id: generateWamid(),\n      from: params.from,\n      type: 'interactive',\n      interactive,\n      timestamp: currentTimestamp(),\n    },\n  })\n}\n\nexport type BuildInboundAudioPayloadParams = InboundEnvelopeParams & {\n  readonly mediaId: string\n  readonly mimeType?: string\n}\n\nexport function buildInboundAudioPayload(params: BuildInboundAudioPayloadParams): WhatsAppWebhookPayload {\n  const { mediaId, mimeType, ...envelope } = params\n\n  return buildEnvelope({\n    ...envelope,\n    message: {\n      id: generateWamid(),\n      from: params.from,\n      type: 'audio',\n      audio: { id: mediaId, mime_type: mimeType ?? PREVIEW_AUDIO_MIME_TYPE },\n      timestamp: currentTimestamp(),\n    },\n  })\n}\n\n/**\n * Serializa o payload uma única vez. A validação assina os bytes exatos recebidos: quem reserializa\n * antes de enviar (ou deixa o cliente HTTP serializar o objeto) muda espaçamento/ordem e derruba a\n * assinatura. Assinar e enviar SEMPRE a string devolvida aqui é o contrato.\n */\nexport function serializeWebhookPayload(payload: WhatsAppWebhookPayload): string {\n  return JSON.stringify(payload)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;ACkBO,IAAMA,0BAA0B;AAChC,IAAMC,kBAAkB;AACxB,IAAMC,+BAA+B;AAGrC,IAAMC,0BAA0B;AAWvC,SAASC,gBAAAA;AAGP,QAAMC,SAASC,WAAWC,OAAOC,WAAU,EAAGC,WAAW,KAAK,EAAA;AAC9D,SAAO,SAASJ,MAAAA;AAClB;AALSD;AAOT,SAASM,mBAAAA;AACP,SAAOC,KAAKC,MAAMC,KAAKC,IAAG,IAAK,GAAA,EAAMC,SAAQ;AAC/C;AAFSL;AAQT,SAASM,cAAcC,QAA2B;AAChD,SAAO;IACLC,QAAQ;IACRC,OAAO;MACL;QACEC,IAAIH,OAAOI,UAAUpB;QACrBqB,SAAS;UACP;YACEC,OAAO;cACLC,mBAAmB;cACnBC,UAAU;gBACRC,sBAAsBT,OAAOU,sBAAsBzB;gBACnD0B,iBAAiBX,OAAOY,iBAAiB7B;cAC3C;cACA8B,UAAU;gBAACb,OAAOc;;YACpB;UACF;;MAEJ;;EAEJ;AACF;AArBSf;AA2BF,SAASgB,wBAAwBf,QAAqC;AAC3E,QAAM,EAAEgB,MAAM,GAAGC,SAAAA,IAAajB;AAE9B,SAAOD,cAAc;IACnB,GAAGkB;IACHH,SAAS;MACPX,IAAIhB,cAAAA;MACJ+B,MAAMlB,OAAOkB;MACbC,MAAM;MACNH,MAAM;QAAEI,MAAMJ;MAAK;MACnBK,WAAW5B,iBAAAA;IACb;EACF,CAAA;AACF;AAbgBsB;AA4BT,SAASO,+BAA+BtB,QAA4C;AACzF,QAAM,EAAEuB,aAAaC,WAAW,GAAGP,SAAAA,IAAajB;AAEhD,QAAMyB,cAAcF,cAChB;IAAEJ,MAAM;IAAgBO,cAAcH;EAAY,IAClD;IAAEJ,MAAM;IAAcQ,YAAYH;EAAU;AAEhD,SAAOzB,cAAc;IACnB,GAAGkB;IACHH,SAAS;MACPX,IAAIhB,cAAAA;MACJ+B,MAAMlB,OAAOkB;MACbC,MAAM;MACNM;MACAJ,WAAW5B,iBAAAA;IACb;EACF,CAAA;AACF;AAjBgB6B;AAwBT,SAASM,yBAAyB5B,QAAsC;AAC7E,QAAM,EAAE6B,SAASC,UAAU,GAAGb,SAAAA,IAAajB;AAE3C,SAAOD,cAAc;IACnB,GAAGkB;IACHH,SAAS;MACPX,IAAIhB,cAAAA;MACJ+B,MAAMlB,OAAOkB;MACbC,MAAM;MACNY,OAAO;QAAE5B,IAAI0B;QAASG,WAAWF,YAAY5C;MAAwB;MACrEmC,WAAW5B,iBAAAA;IACb;EACF,CAAA;AACF;AAbgBmC;AAoBT,SAASK,wBAAwBC,SAA+B;AACrE,SAAOC,KAAKC,UAAUF,OAAAA;AACxB;AAFgBD;","names":["PREVIEW_PHONE_NUMBER_ID","PREVIEW_WABA_ID","PREVIEW_DISPLAY_PHONE_NUMBER","PREVIEW_AUDIO_MIME_TYPE","generateWamid","unique","globalThis","crypto","randomUUID","replaceAll","currentTimestamp","Math","floor","Date","now","toString","buildEnvelope","params","object","entry","id","wabaId","changes","value","messaging_product","metadata","display_phone_number","displayPhoneNumber","phone_number_id","phoneNumberId","messages","message","buildInboundTextPayload","text","envelope","from","type","body","timestamp","buildInboundInteractivePayload","buttonReply","listReply","interactive","button_reply","list_reply","buildInboundAudioPayload","mediaId","mimeType","audio","mime_type","serializeWebhookPayload","payload","JSON","stringify"]}

package/dist/testing/index.d.cts

@@ -0,0 +1,57 @@
+import { g as WhatsAppWebhookPayload } from '../webhook.types-PxhpmpzC.cjs';
+import 'zod';
+
+/**
+ * Builders de payload inbound para exercitar o webhook em desenvolvimento sem um app da Meta
+ * credenciado. Moram aqui, e não no módulo, por uma razão de runtime: o preview do navegador
+ * precisa montar payloads, e o módulo depende de `node:crypto` — importá-lo do frontend quebraria
+ * o bundle. Este pacote só depende de zod, então roda nos dois lados.
+ *
+ * São construção de payload, não assinatura: assinar depende do runtime (`node:crypto` no
+ * servidor, WebCrypto no navegador) e fica com quem tem o segredo.
+ *
+ * Por que `id` e `timestamp` são novos a cada chamada: o anti-replay do webhook usa o header de
+ * assinatura como nonce, e a assinatura é derivada do corpo cru. Dois payloads idênticos geram a
+ * mesma assinatura, e a segunda entrega é descartada como duplicata — numa conversa real ("sim"
+ * duas vezes) isso apareceria como mensagem engolida, sem erro nenhum para investigar.
+ */
+
+declare const PREVIEW_PHONE_NUMBER_ID = "000000000000000";
+declare const PREVIEW_WABA_ID = "000000000000001";
+declare const PREVIEW_DISPLAY_PHONE_NUMBER = "+5511900000000";
+declare const PREVIEW_AUDIO_MIME_TYPE = "audio/ogg; codecs=opus";
+type InboundEnvelopeParams = {
+    readonly from: string;
+    readonly phoneNumberId?: string;
+    readonly displayPhoneNumber?: string;
+    readonly wabaId?: string;
+};
+type BuildInboundTextPayloadParams = InboundEnvelopeParams & {
+    readonly text: string;
+};
+declare function buildInboundTextPayload(params: BuildInboundTextPayloadParams): WhatsAppWebhookPayload;
+type InteractiveReplyOption = {
+    readonly id: string;
+    readonly title: string;
+};
+type BuildInboundInteractivePayloadParams = InboundEnvelopeParams & ({
+    readonly buttonReply: InteractiveReplyOption;
+    readonly listReply?: never;
+} | {
+    readonly listReply: InteractiveReplyOption;
+    readonly buttonReply?: never;
+});
+declare function buildInboundInteractivePayload(params: BuildInboundInteractivePayloadParams): WhatsAppWebhookPayload;
+type BuildInboundAudioPayloadParams = InboundEnvelopeParams & {
+    readonly mediaId: string;
+    readonly mimeType?: string;
+};
+declare function buildInboundAudioPayload(params: BuildInboundAudioPayloadParams): WhatsAppWebhookPayload;
+/**
+ * Serializa o payload uma única vez. A validação assina os bytes exatos recebidos: quem reserializa
+ * antes de enviar (ou deixa o cliente HTTP serializar o objeto) muda espaçamento/ordem e derruba a
+ * assinatura. Assinar e enviar SEMPRE a string devolvida aqui é o contrato.
+ */
+declare function serializeWebhookPayload(payload: WhatsAppWebhookPayload): string;
+
+export { type BuildInboundAudioPayloadParams, type BuildInboundInteractivePayloadParams, type BuildInboundTextPayloadParams, type InteractiveReplyOption, PREVIEW_AUDIO_MIME_TYPE, PREVIEW_DISPLAY_PHONE_NUMBER, PREVIEW_PHONE_NUMBER_ID, PREVIEW_WABA_ID, buildInboundAudioPayload, buildInboundInteractivePayload, buildInboundTextPayload, serializeWebhookPayload };

package/dist/testing/index.d.ts

@@ -0,0 +1,57 @@
+import { g as WhatsAppWebhookPayload } from '../webhook.types-PxhpmpzC.js';
+import 'zod';
+
+/**
+ * Builders de payload inbound para exercitar o webhook em desenvolvimento sem um app da Meta
+ * credenciado. Moram aqui, e não no módulo, por uma razão de runtime: o preview do navegador
+ * precisa montar payloads, e o módulo depende de `node:crypto` — importá-lo do frontend quebraria
+ * o bundle. Este pacote só depende de zod, então roda nos dois lados.
+ *
+ * São construção de payload, não assinatura: assinar depende do runtime (`node:crypto` no
+ * servidor, WebCrypto no navegador) e fica com quem tem o segredo.
+ *
+ * Por que `id` e `timestamp` são novos a cada chamada: o anti-replay do webhook usa o header de
+ * assinatura como nonce, e a assinatura é derivada do corpo cru. Dois payloads idênticos geram a
+ * mesma assinatura, e a segunda entrega é descartada como duplicata — numa conversa real ("sim"
+ * duas vezes) isso apareceria como mensagem engolida, sem erro nenhum para investigar.
+ */
+
+declare const PREVIEW_PHONE_NUMBER_ID = "000000000000000";
+declare const PREVIEW_WABA_ID = "000000000000001";
+declare const PREVIEW_DISPLAY_PHONE_NUMBER = "+5511900000000";
+declare const PREVIEW_AUDIO_MIME_TYPE = "audio/ogg; codecs=opus";
+type InboundEnvelopeParams = {
+    readonly from: string;
+    readonly phoneNumberId?: string;
+    readonly displayPhoneNumber?: string;
+    readonly wabaId?: string;
+};
+type BuildInboundTextPayloadParams = InboundEnvelopeParams & {
+    readonly text: string;
+};
+declare function buildInboundTextPayload(params: BuildInboundTextPayloadParams): WhatsAppWebhookPayload;
+type InteractiveReplyOption = {
+    readonly id: string;
+    readonly title: string;
+};
+type BuildInboundInteractivePayloadParams = InboundEnvelopeParams & ({
+    readonly buttonReply: InteractiveReplyOption;
+    readonly listReply?: never;
+} | {
+    readonly listReply: InteractiveReplyOption;
+    readonly buttonReply?: never;
+});
+declare function buildInboundInteractivePayload(params: BuildInboundInteractivePayloadParams): WhatsAppWebhookPayload;
+type BuildInboundAudioPayloadParams = InboundEnvelopeParams & {
+    readonly mediaId: string;
+    readonly mimeType?: string;
+};
+declare function buildInboundAudioPayload(params: BuildInboundAudioPayloadParams): WhatsAppWebhookPayload;
+/**
+ * Serializa o payload uma única vez. A validação assina os bytes exatos recebidos: quem reserializa
+ * antes de enviar (ou deixa o cliente HTTP serializar o objeto) muda espaçamento/ordem e derruba a
+ * assinatura. Assinar e enviar SEMPRE a string devolvida aqui é o contrato.
+ */
+declare function serializeWebhookPayload(payload: WhatsAppWebhookPayload): string;
+
+export { type BuildInboundAudioPayloadParams, type BuildInboundInteractivePayloadParams, type BuildInboundTextPayloadParams, type InteractiveReplyOption, PREVIEW_AUDIO_MIME_TYPE, PREVIEW_DISPLAY_PHONE_NUMBER, PREVIEW_PHONE_NUMBER_ID, PREVIEW_WABA_ID, buildInboundAudioPayload, buildInboundInteractivePayload, buildInboundTextPayload, serializeWebhookPayload };

package/dist/testing/index.js

@@ -0,0 +1,111 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/testing/inboundPayloads.ts
+var PREVIEW_PHONE_NUMBER_ID = "000000000000000";
+var PREVIEW_WABA_ID = "000000000000001";
+var PREVIEW_DISPLAY_PHONE_NUMBER = "+5511900000000";
+var PREVIEW_AUDIO_MIME_TYPE = "audio/ogg; codecs=opus";
+function generateWamid() {
+  const unique = globalThis.crypto.randomUUID().replaceAll("-", "");
+  return `wamid.${unique}`;
+}
+__name(generateWamid, "generateWamid");
+function currentTimestamp() {
+  return Math.floor(Date.now() / 1e3).toString();
+}
+__name(currentTimestamp, "currentTimestamp");
+function buildEnvelope(params) {
+  return {
+    object: "whatsapp_business_account",
+    entry: [
+      {
+        id: params.wabaId ?? PREVIEW_WABA_ID,
+        changes: [
+          {
+            value: {
+              messaging_product: "whatsapp",
+              metadata: {
+                display_phone_number: params.displayPhoneNumber ?? PREVIEW_DISPLAY_PHONE_NUMBER,
+                phone_number_id: params.phoneNumberId ?? PREVIEW_PHONE_NUMBER_ID
+              },
+              messages: [
+                params.message
+              ]
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
+__name(buildEnvelope, "buildEnvelope");
+function buildInboundTextPayload(params) {
+  const { text, ...envelope } = params;
+  return buildEnvelope({
+    ...envelope,
+    message: {
+      id: generateWamid(),
+      from: params.from,
+      type: "text",
+      text: {
+        body: text
+      },
+      timestamp: currentTimestamp()
+    }
+  });
+}
+__name(buildInboundTextPayload, "buildInboundTextPayload");
+function buildInboundInteractivePayload(params) {
+  const { buttonReply, listReply, ...envelope } = params;
+  const interactive = buttonReply ? {
+    type: "button_reply",
+    button_reply: buttonReply
+  } : {
+    type: "list_reply",
+    list_reply: listReply
+  };
+  return buildEnvelope({
+    ...envelope,
+    message: {
+      id: generateWamid(),
+      from: params.from,
+      type: "interactive",
+      interactive,
+      timestamp: currentTimestamp()
+    }
+  });
+}
+__name(buildInboundInteractivePayload, "buildInboundInteractivePayload");
+function buildInboundAudioPayload(params) {
+  const { mediaId, mimeType, ...envelope } = params;
+  return buildEnvelope({
+    ...envelope,
+    message: {
+      id: generateWamid(),
+      from: params.from,
+      type: "audio",
+      audio: {
+        id: mediaId,
+        mime_type: mimeType ?? PREVIEW_AUDIO_MIME_TYPE
+      },
+      timestamp: currentTimestamp()
+    }
+  });
+}
+__name(buildInboundAudioPayload, "buildInboundAudioPayload");
+function serializeWebhookPayload(payload) {
+  return JSON.stringify(payload);
+}
+__name(serializeWebhookPayload, "serializeWebhookPayload");
+export {
+  PREVIEW_AUDIO_MIME_TYPE,
+  PREVIEW_DISPLAY_PHONE_NUMBER,
+  PREVIEW_PHONE_NUMBER_ID,
+  PREVIEW_WABA_ID,
+  buildInboundAudioPayload,
+  buildInboundInteractivePayload,
+  buildInboundTextPayload,
+  serializeWebhookPayload
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/inboundPayloads.ts"],"sourcesContent":["/**\n * Builders de payload inbound para exercitar o webhook em desenvolvimento sem um app da Meta\n * credenciado. Moram aqui, e não no módulo, por uma razão de runtime: o preview do navegador\n * precisa montar payloads, e o módulo depende de `node:crypto` — importá-lo do frontend quebraria\n * o bundle. Este pacote só depende de zod, então roda nos dois lados.\n *\n * São construção de payload, não assinatura: assinar depende do runtime (`node:crypto` no\n * servidor, WebCrypto no navegador) e fica com quem tem o segredo.\n *\n * Por que `id` e `timestamp` são novos a cada chamada: o anti-replay do webhook usa o header de\n * assinatura como nonce, e a assinatura é derivada do corpo cru. Dois payloads idênticos geram a\n * mesma assinatura, e a segunda entrega é descartada como duplicata — numa conversa real (\"sim\"\n * duas vezes) isso apareceria como mensagem engolida, sem erro nenhum para investigar.\n */\n\nimport type { WhatsAppMessage, WhatsAppWebhookPayload } from '../webhook.types'\n\n// Valores de dev que espelham o formato dos reais (15 dígitos) sem apontar para nada da Meta.\nexport const PREVIEW_PHONE_NUMBER_ID = '000000000000000'\nexport const PREVIEW_WABA_ID = '000000000000001'\nexport const PREVIEW_DISPLAY_PHONE_NUMBER = '+5511900000000'\n\n// O que a Meta manda para áudio gravado no app; o pipeline de STT depende do mime para decodificar.\nexport const PREVIEW_AUDIO_MIME_TYPE = 'audio/ogg; codecs=opus'\n\ntype InboundEnvelopeParams = {\n  readonly from: string\n  readonly phoneNumberId?: string\n  readonly displayPhoneNumber?: string\n  readonly wabaId?: string\n}\n\n// `globalThis.crypto` em vez de `node:crypto`: é o que existe tanto no navegador quanto no Node\n// 19+/Bun, e é o que mantém estes builders utilizáveis pelo preview do navegador.\nfunction generateWamid(): string {\n  // Formato real é `wamid.<base64>`. O prefixo importa para quem faz parsing por prefixo; o corpo\n  // só precisa ser único por entrega, que é o que mantém a assinatura — e o nonce — distinta.\n  const unique = globalThis.crypto.randomUUID().replaceAll('-', '')\n  return `wamid.${unique}`\n}\n\nfunction currentTimestamp(): string {\n  return Math.floor(Date.now() / 1000).toString()\n}\n\ntype BuildEnvelopeParams = InboundEnvelopeParams & {\n  readonly message: WhatsAppMessage\n}\n\nfunction buildEnvelope(params: BuildEnvelopeParams): WhatsAppWebhookPayload {\n  return {\n    object: 'whatsapp_business_account',\n    entry: [\n      {\n        id: params.wabaId ?? PREVIEW_WABA_ID,\n        changes: [\n          {\n            value: {\n              messaging_product: 'whatsapp',\n              metadata: {\n                display_phone_number: params.displayPhoneNumber ?? PREVIEW_DISPLAY_PHONE_NUMBER,\n                phone_number_id: params.phoneNumberId ?? PREVIEW_PHONE_NUMBER_ID,\n              },\n              messages: [params.message],\n            },\n          },\n        ],\n      },\n    ],\n  }\n}\n\nexport type BuildInboundTextPayloadParams = InboundEnvelopeParams & {\n  readonly text: string\n}\n\nexport function buildInboundTextPayload(params: BuildInboundTextPayloadParams): WhatsAppWebhookPayload {\n  const { text, ...envelope } = params\n\n  return buildEnvelope({\n    ...envelope,\n    message: {\n      id: generateWamid(),\n      from: params.from,\n      type: 'text',\n      text: { body: text },\n      timestamp: currentTimestamp(),\n    },\n  })\n}\n\nexport type InteractiveReplyOption = {\n  readonly id: string\n  readonly title: string\n}\n\n// União exclusiva: uma resposta interativa é de botão OU de lista, nunca das duas nem de nenhuma.\n// O tipo torna o erro impossível em vez de validá-lo em runtime.\nexport type BuildInboundInteractivePayloadParams = InboundEnvelopeParams &\n  (\n    | { readonly buttonReply: InteractiveReplyOption; readonly listReply?: never }\n    | { readonly listReply: InteractiveReplyOption; readonly buttonReply?: never }\n  )\n\nexport function buildInboundInteractivePayload(params: BuildInboundInteractivePayloadParams): WhatsAppWebhookPayload {\n  const { buttonReply, listReply, ...envelope } = params\n\n  const interactive = buttonReply\n    ? { type: 'button_reply', button_reply: buttonReply }\n    : { type: 'list_reply', list_reply: listReply }\n\n  return buildEnvelope({\n    ...envelope,\n    message: {\n      id: generateWamid(),\n      from: params.from,\n      type: 'interactive',\n      interactive,\n      timestamp: currentTimestamp(),\n    },\n  })\n}\n\nexport type BuildInboundAudioPayloadParams = InboundEnvelopeParams & {\n  readonly mediaId: string\n  readonly mimeType?: string\n}\n\nexport function buildInboundAudioPayload(params: BuildInboundAudioPayloadParams): WhatsAppWebhookPayload {\n  const { mediaId, mimeType, ...envelope } = params\n\n  return buildEnvelope({\n    ...envelope,\n    message: {\n      id: generateWamid(),\n      from: params.from,\n      type: 'audio',\n      audio: { id: mediaId, mime_type: mimeType ?? PREVIEW_AUDIO_MIME_TYPE },\n      timestamp: currentTimestamp(),\n    },\n  })\n}\n\n/**\n * Serializa o payload uma única vez. A validação assina os bytes exatos recebidos: quem reserializa\n * antes de enviar (ou deixa o cliente HTTP serializar o objeto) muda espaçamento/ordem e derruba a\n * assinatura. Assinar e enviar SEMPRE a string devolvida aqui é o contrato.\n */\nexport function serializeWebhookPayload(payload: WhatsAppWebhookPayload): string {\n  return JSON.stringify(payload)\n}\n"],"mappings":";;;;AAkBO,IAAMA,0BAA0B;AAChC,IAAMC,kBAAkB;AACxB,IAAMC,+BAA+B;AAGrC,IAAMC,0BAA0B;AAWvC,SAASC,gBAAAA;AAGP,QAAMC,SAASC,WAAWC,OAAOC,WAAU,EAAGC,WAAW,KAAK,EAAA;AAC9D,SAAO,SAASJ,MAAAA;AAClB;AALSD;AAOT,SAASM,mBAAAA;AACP,SAAOC,KAAKC,MAAMC,KAAKC,IAAG,IAAK,GAAA,EAAMC,SAAQ;AAC/C;AAFSL;AAQT,SAASM,cAAcC,QAA2B;AAChD,SAAO;IACLC,QAAQ;IACRC,OAAO;MACL;QACEC,IAAIH,OAAOI,UAAUpB;QACrBqB,SAAS;UACP;YACEC,OAAO;cACLC,mBAAmB;cACnBC,UAAU;gBACRC,sBAAsBT,OAAOU,sBAAsBzB;gBACnD0B,iBAAiBX,OAAOY,iBAAiB7B;cAC3C;cACA8B,UAAU;gBAACb,OAAOc;;YACpB;UACF;;MAEJ;;EAEJ;AACF;AArBSf;AA2BF,SAASgB,wBAAwBf,QAAqC;AAC3E,QAAM,EAAEgB,MAAM,GAAGC,SAAAA,IAAajB;AAE9B,SAAOD,cAAc;IACnB,GAAGkB;IACHH,SAAS;MACPX,IAAIhB,cAAAA;MACJ+B,MAAMlB,OAAOkB;MACbC,MAAM;MACNH,MAAM;QAAEI,MAAMJ;MAAK;MACnBK,WAAW5B,iBAAAA;IACb;EACF,CAAA;AACF;AAbgBsB;AA4BT,SAASO,+BAA+BtB,QAA4C;AACzF,QAAM,EAAEuB,aAAaC,WAAW,GAAGP,SAAAA,IAAajB;AAEhD,QAAMyB,cAAcF,cAChB;IAAEJ,MAAM;IAAgBO,cAAcH;EAAY,IAClD;IAAEJ,MAAM;IAAcQ,YAAYH;EAAU;AAEhD,SAAOzB,cAAc;IACnB,GAAGkB;IACHH,SAAS;MACPX,IAAIhB,cAAAA;MACJ+B,MAAMlB,OAAOkB;MACbC,MAAM;MACNM;MACAJ,WAAW5B,iBAAAA;IACb;EACF,CAAA;AACF;AAjBgB6B;AAwBT,SAASM,yBAAyB5B,QAAsC;AAC7E,QAAM,EAAE6B,SAASC,UAAU,GAAGb,SAAAA,IAAajB;AAE3C,SAAOD,cAAc;IACnB,GAAGkB;IACHH,SAAS;MACPX,IAAIhB,cAAAA;MACJ+B,MAAMlB,OAAOkB;MACbC,MAAM;MACNY,OAAO;QAAE5B,IAAI0B;QAASG,WAAWF,YAAY5C;MAAwB;MACrEmC,WAAW5B,iBAAAA;IACb;EACF,CAAA;AACF;AAbgBmC;AAoBT,SAASK,wBAAwBC,SAA+B;AACrE,SAAOC,KAAKC,UAAUF,OAAAA;AACxB;AAFgBD;","names":["PREVIEW_PHONE_NUMBER_ID","PREVIEW_WABA_ID","PREVIEW_DISPLAY_PHONE_NUMBER","PREVIEW_AUDIO_MIME_TYPE","generateWamid","unique","globalThis","crypto","randomUUID","replaceAll","currentTimestamp","Math","floor","Date","now","toString","buildEnvelope","params","object","entry","id","wabaId","changes","value","messaging_product","metadata","display_phone_number","displayPhoneNumber","phone_number_id","phoneNumberId","messages","message","buildInboundTextPayload","text","envelope","from","type","body","timestamp","buildInboundInteractivePayload","buttonReply","listReply","interactive","button_reply","list_reply","buildInboundAudioPayload","mediaId","mimeType","audio","mime_type","serializeWebhookPayload","payload","JSON","stringify"]}