/** * Types normalisés d'Omniloq — AUCUN JSON provider ne traverse cette frontière. * Le runtime (core) ne voit QUE ces types. Tout ce qui est spécifique à un * provider (Meta, Telegram, …) reste confiné dans l'adaptateur de canal. */ export type ChannelType = 'whatsapp' | 'telegram' | 'web'; /** Message entrant normalisé, produit par l'adaptateur de canal. */ export interface InboundMessage { channelType: ChannelType; /** Identifiant externe du compte (ex: phone_number_id Meta) — pour résolution multi-tenant. */ channelAccountExternalId: string; /** Identifiant externe de l'utilisateur (ex: numéro WhatsApp). */ externalUserId: string; /** Identifiant externe du message (ex: wamid Meta) — idempotence. */ externalMessageId: string; text: string; timestamp: Date; } export type MessageStatus = 'sent' | 'delivered' | 'read' | 'failed'; export interface MessageReceivedEvent { type: 'message_received'; inbound: InboundMessage; } export interface MessageStatusEvent { type: 'message_status'; channelType: ChannelType; channelAccountExternalId: string; externalMessageId: string; status: MessageStatus; timestamp: Date; error?: string; } export type ChannelEvent = MessageReceivedEvent | MessageStatusEvent; export interface SendResult { status: 'sent' | 'failed'; externalMessageId?: string; error?: string; } /** Interface que chaque canal doit implémenter. */ export interface Channel { readonly channelType: ChannelType; /** Vérifie un challenge de webhook (GET). */ verifyWebhook(query: Record): { verified: boolean; challenge?: string }; /** Parse un payload webhook → événements normalisés. */ parseWebhook(payload: unknown): ChannelEvent[]; /** Envoie un message texte sortant vers un destinataire externe. */ sendMessage(to: string, text: string): Promise; }