@lssm-tech/integration.builder-whatsapp 0.2.11

package/README.md

@@ -0,0 +1,3 @@
+# @contractspec/integration.builder-whatsapp
+
+Meta and Twilio WhatsApp normalization for Builder control-channel workflows.

package/dist/browser/index.js

@@ -0,0 +1 @@
+import{parseMetaWebhookPayload as B,parseTwilioFormPayload as N,verifyMetaSignature as x,verifyTwilioSignature as S}from"@contractspec/integration.runtime/channel";import{defineIntegration as $}from"@contractspec/lib.contracts-integrations";import{defineSchemaModel as Z}from"@contractspec/lib.schema";var z=Z({name:"BuilderWhatsappIntegrationConfig",description:"Managed configuration for @contractspec/integration.builder-whatsapp.",fields:{}}),F=Z({name:"BuilderWhatsappIntegrationSecret",description:"Secret material for @contractspec/integration.builder-whatsapp.",fields:{}}),P=$({meta:{...{key:"integrations.builder-whatsapp",version:"1.0.0",title:"Builder Whatsapp",description:"WhatsApp Builder control-channel integration.",domain:"builder-whatsapp",owners:["@contractspec-core"],tags:["package","integrations","builder-whatsapp"],stability:"experimental"},category:"custom"},supportedModes:["managed"],capabilities:{provides:[]},configSchema:{schema:z,example:{}},secretSchema:{schema:F,example:{}},healthCheck:{method:"ping",timeoutMs:5000}});function O(j){return j&&typeof j==="object"?j:null}function K(j,E,G,D,A){let C=typeof A.from==="string"?A.from:void 0,q=typeof A.id==="string"?A.id:void 0;if(!C||!q)return null;let L=O(A.text)?.body,Q=O(A.interactive),V=typeof Q?.type==="string"?Q.type:void 0,H=O(Q?.button_reply),J=O(Q?.list_reply),U=O(A.audio),X=O(A.document),Y=O(A.image),_=U?"voice":H?"button":J?"list_selection":"text";return{workspaceId:j,conversationId:E,channelType:"whatsapp",eventType:`whatsapp.meta.${typeof A.type==="string"?A.type:"message"}`,externalEventId:q,externalConversationId:C,externalChannelId:D,externalMessageId:q,participantBindingId:G,externalIdentityRef:C,externalUserId:C,messageKind:_,text:typeof L==="string"?L:typeof H?.title==="string"?H.title:typeof J?.title==="string"?J.title:void 0,interactiveSelection:H&&typeof H.id==="string"?{selectionType:"button",selectionId:H.id,label:typeof H.title==="string"?H.title:void 0,payload:{interactiveType:V}}:J&&typeof J.id==="string"?{selectionType:"list_selection",selectionId:J.id,label:typeof J.title==="string"?J.title:void 0,payload:{interactiveType:V}}:void 0,metadata:{phoneNumberId:D??"",audioId:typeof U?.id==="string"?U.id:"",documentId:typeof X?.id==="string"?X.id:"",imageId:typeof Y?.id==="string"?Y.id:""}}}function f(j){let E=[];for(let G of j.payload.entry??[])for(let D of G.changes??[]){let A=D.value;if(!A)continue;let C=A.metadata?.phone_number_id;for(let q of A.messages??[]){let L=K(j.workspaceId,j.conversationId,j.participantBindingId,C,q);if(L)E.push(L)}for(let q of A.statuses??[]){if(!q.id)continue;E.push({workspaceId:j.workspaceId,conversationId:j.conversationId,channelType:"whatsapp",eventType:"whatsapp.meta.status",externalEventId:q.id,externalConversationId:q.recipient_id??q.id,externalChannelId:C,externalMessageId:q.id,participantBindingId:j.participantBindingId,externalIdentityRef:q.recipient_id??void 0,externalUserId:q.recipient_id??void 0,messageKind:"system",statusEvent:{status:q.status??"unknown",providerMessageId:q.id},text:`status ${q.status??"unknown"}`})}}return E}function h(j){let E=j.formBody.get("MessageSid"),G=j.formBody.get("From");if(!E||!G)return null;let D=j.formBody.get("ButtonText"),A=j.formBody.get("ButtonPayload"),C=j.formBody.get("ListTitle")??j.formBody.get("ListSelection"),q=j.formBody.get("MediaContentType0"),L=D?"button":C?"list_selection":q?.startsWith("audio/")?"voice":"text";return{workspaceId:j.workspaceId,conversationId:j.conversationId,channelType:"whatsapp",eventType:"whatsapp.twilio.message",externalEventId:E,externalConversationId:G,externalChannelId:j.formBody.get("To")??void 0,externalMessageId:E,participantBindingId:j.participantBindingId,externalIdentityRef:G,externalUserId:G,messageKind:L,text:D??C??j.formBody.get("Body")??(q?`media ${q}`:void 0)??"",interactiveSelection:D?{selectionType:"button",selectionId:A??D,label:D}:C?{selectionType:"list_selection",selectionId:C,label:C}:void 0,metadata:{accountSid:j.formBody.get("AccountSid")??"",profileName:j.formBody.get("ProfileName")??"",mediaContentType0:q??"",mediaUrl0:j.formBody.get("MediaUrl0")??""}}}export{S as verifyTwilioSignature,x as verifyMetaSignature,N as parseTwilioFormPayload,B as parseMetaWebhookPayload,h as normalizeBuilderTwilioWhatsappEnvelope,f as normalizeBuilderMetaWhatsappEnvelopes,P as BuilderWhatsappIntegrationSpec};

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { type MetaWhatsappWebhookPayload, parseMetaWebhookPayload, parseTwilioFormPayload, verifyMetaSignature, verifyTwilioSignature } from '@contractspec/integration.runtime/channel';
+import type { BuilderChannelInboundEnvelope } from '@contractspec/lib.builder-runtime';
+export { type MetaWhatsappWebhookPayload, parseMetaWebhookPayload, parseTwilioFormPayload, verifyMetaSignature, verifyTwilioSignature, };
+export declare function normalizeBuilderMetaWhatsappEnvelopes(input: {
+    workspaceId: string;
+    conversationId: string;
+    payload: MetaWhatsappWebhookPayload;
+    rawBody?: string;
+    traceId?: string;
+    participantBindingId?: string;
+}): BuilderChannelInboundEnvelope[];
+export declare function normalizeBuilderTwilioWhatsappEnvelope(input: {
+    workspaceId: string;
+    conversationId: string;
+    formBody: URLSearchParams;
+    rawBody?: string;
+    traceId?: string;
+    participantBindingId?: string;
+}): BuilderChannelInboundEnvelope | null;
+export * from './integration';

package/dist/index.js

@@ -0,0 +1,2 @@
+// @bun
+import{parseMetaWebhookPayload as B,parseTwilioFormPayload as N,verifyMetaSignature as x,verifyTwilioSignature as S}from"@contractspec/integration.runtime/channel";import{defineIntegration as $}from"@contractspec/lib.contracts-integrations";import{defineSchemaModel as Z}from"@contractspec/lib.schema";var z=Z({name:"BuilderWhatsappIntegrationConfig",description:"Managed configuration for @contractspec/integration.builder-whatsapp.",fields:{}}),F=Z({name:"BuilderWhatsappIntegrationSecret",description:"Secret material for @contractspec/integration.builder-whatsapp.",fields:{}}),P=$({meta:{...{key:"integrations.builder-whatsapp",version:"1.0.0",title:"Builder Whatsapp",description:"WhatsApp Builder control-channel integration.",domain:"builder-whatsapp",owners:["@contractspec-core"],tags:["package","integrations","builder-whatsapp"],stability:"experimental"},category:"custom"},supportedModes:["managed"],capabilities:{provides:[]},configSchema:{schema:z,example:{}},secretSchema:{schema:F,example:{}},healthCheck:{method:"ping",timeoutMs:5000}});function O(j){return j&&typeof j==="object"?j:null}function K(j,E,G,D,A){let C=typeof A.from==="string"?A.from:void 0,q=typeof A.id==="string"?A.id:void 0;if(!C||!q)return null;let L=O(A.text)?.body,Q=O(A.interactive),V=typeof Q?.type==="string"?Q.type:void 0,H=O(Q?.button_reply),J=O(Q?.list_reply),U=O(A.audio),X=O(A.document),Y=O(A.image),_=U?"voice":H?"button":J?"list_selection":"text";return{workspaceId:j,conversationId:E,channelType:"whatsapp",eventType:`whatsapp.meta.${typeof A.type==="string"?A.type:"message"}`,externalEventId:q,externalConversationId:C,externalChannelId:D,externalMessageId:q,participantBindingId:G,externalIdentityRef:C,externalUserId:C,messageKind:_,text:typeof L==="string"?L:typeof H?.title==="string"?H.title:typeof J?.title==="string"?J.title:void 0,interactiveSelection:H&&typeof H.id==="string"?{selectionType:"button",selectionId:H.id,label:typeof H.title==="string"?H.title:void 0,payload:{interactiveType:V}}:J&&typeof J.id==="string"?{selectionType:"list_selection",selectionId:J.id,label:typeof J.title==="string"?J.title:void 0,payload:{interactiveType:V}}:void 0,metadata:{phoneNumberId:D??"",audioId:typeof U?.id==="string"?U.id:"",documentId:typeof X?.id==="string"?X.id:"",imageId:typeof Y?.id==="string"?Y.id:""}}}function f(j){let E=[];for(let G of j.payload.entry??[])for(let D of G.changes??[]){let A=D.value;if(!A)continue;let C=A.metadata?.phone_number_id;for(let q of A.messages??[]){let L=K(j.workspaceId,j.conversationId,j.participantBindingId,C,q);if(L)E.push(L)}for(let q of A.statuses??[]){if(!q.id)continue;E.push({workspaceId:j.workspaceId,conversationId:j.conversationId,channelType:"whatsapp",eventType:"whatsapp.meta.status",externalEventId:q.id,externalConversationId:q.recipient_id??q.id,externalChannelId:C,externalMessageId:q.id,participantBindingId:j.participantBindingId,externalIdentityRef:q.recipient_id??void 0,externalUserId:q.recipient_id??void 0,messageKind:"system",statusEvent:{status:q.status??"unknown",providerMessageId:q.id},text:`status ${q.status??"unknown"}`})}}return E}function h(j){let E=j.formBody.get("MessageSid"),G=j.formBody.get("From");if(!E||!G)return null;let D=j.formBody.get("ButtonText"),A=j.formBody.get("ButtonPayload"),C=j.formBody.get("ListTitle")??j.formBody.get("ListSelection"),q=j.formBody.get("MediaContentType0"),L=D?"button":C?"list_selection":q?.startsWith("audio/")?"voice":"text";return{workspaceId:j.workspaceId,conversationId:j.conversationId,channelType:"whatsapp",eventType:"whatsapp.twilio.message",externalEventId:E,externalConversationId:G,externalChannelId:j.formBody.get("To")??void 0,externalMessageId:E,participantBindingId:j.participantBindingId,externalIdentityRef:G,externalUserId:G,messageKind:L,text:D??C??j.formBody.get("Body")??(q?`media ${q}`:void 0)??"",interactiveSelection:D?{selectionType:"button",selectionId:A??D,label:D}:C?{selectionType:"list_selection",selectionId:C,label:C}:void 0,metadata:{accountSid:j.formBody.get("AccountSid")??"",profileName:j.formBody.get("ProfileName")??"",mediaContentType0:q??"",mediaUrl0:j.formBody.get("MediaUrl0")??""}}}export{S as verifyTwilioSignature,x as verifyMetaSignature,N as parseTwilioFormPayload,B as parseMetaWebhookPayload,h as normalizeBuilderTwilioWhatsappEnvelope,f as normalizeBuilderMetaWhatsappEnvelopes,P as BuilderWhatsappIntegrationSpec};

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/integration.d.ts

@@ -0,0 +1 @@
+export declare const BuilderWhatsappIntegrationSpec: import("@contractspec/lib.contracts-integrations").IntegrationSpec;

package/dist/node/index.js

@@ -0,0 +1 @@
+import{parseMetaWebhookPayload as B,parseTwilioFormPayload as N,verifyMetaSignature as x,verifyTwilioSignature as S}from"@contractspec/integration.runtime/channel";import{defineIntegration as $}from"@contractspec/lib.contracts-integrations";import{defineSchemaModel as Z}from"@contractspec/lib.schema";var z=Z({name:"BuilderWhatsappIntegrationConfig",description:"Managed configuration for @contractspec/integration.builder-whatsapp.",fields:{}}),F=Z({name:"BuilderWhatsappIntegrationSecret",description:"Secret material for @contractspec/integration.builder-whatsapp.",fields:{}}),P=$({meta:{...{key:"integrations.builder-whatsapp",version:"1.0.0",title:"Builder Whatsapp",description:"WhatsApp Builder control-channel integration.",domain:"builder-whatsapp",owners:["@contractspec-core"],tags:["package","integrations","builder-whatsapp"],stability:"experimental"},category:"custom"},supportedModes:["managed"],capabilities:{provides:[]},configSchema:{schema:z,example:{}},secretSchema:{schema:F,example:{}},healthCheck:{method:"ping",timeoutMs:5000}});function O(j){return j&&typeof j==="object"?j:null}function K(j,E,G,D,A){let C=typeof A.from==="string"?A.from:void 0,q=typeof A.id==="string"?A.id:void 0;if(!C||!q)return null;let L=O(A.text)?.body,Q=O(A.interactive),V=typeof Q?.type==="string"?Q.type:void 0,H=O(Q?.button_reply),J=O(Q?.list_reply),U=O(A.audio),X=O(A.document),Y=O(A.image),_=U?"voice":H?"button":J?"list_selection":"text";return{workspaceId:j,conversationId:E,channelType:"whatsapp",eventType:`whatsapp.meta.${typeof A.type==="string"?A.type:"message"}`,externalEventId:q,externalConversationId:C,externalChannelId:D,externalMessageId:q,participantBindingId:G,externalIdentityRef:C,externalUserId:C,messageKind:_,text:typeof L==="string"?L:typeof H?.title==="string"?H.title:typeof J?.title==="string"?J.title:void 0,interactiveSelection:H&&typeof H.id==="string"?{selectionType:"button",selectionId:H.id,label:typeof H.title==="string"?H.title:void 0,payload:{interactiveType:V}}:J&&typeof J.id==="string"?{selectionType:"list_selection",selectionId:J.id,label:typeof J.title==="string"?J.title:void 0,payload:{interactiveType:V}}:void 0,metadata:{phoneNumberId:D??"",audioId:typeof U?.id==="string"?U.id:"",documentId:typeof X?.id==="string"?X.id:"",imageId:typeof Y?.id==="string"?Y.id:""}}}function f(j){let E=[];for(let G of j.payload.entry??[])for(let D of G.changes??[]){let A=D.value;if(!A)continue;let C=A.metadata?.phone_number_id;for(let q of A.messages??[]){let L=K(j.workspaceId,j.conversationId,j.participantBindingId,C,q);if(L)E.push(L)}for(let q of A.statuses??[]){if(!q.id)continue;E.push({workspaceId:j.workspaceId,conversationId:j.conversationId,channelType:"whatsapp",eventType:"whatsapp.meta.status",externalEventId:q.id,externalConversationId:q.recipient_id??q.id,externalChannelId:C,externalMessageId:q.id,participantBindingId:j.participantBindingId,externalIdentityRef:q.recipient_id??void 0,externalUserId:q.recipient_id??void 0,messageKind:"system",statusEvent:{status:q.status??"unknown",providerMessageId:q.id},text:`status ${q.status??"unknown"}`})}}return E}function h(j){let E=j.formBody.get("MessageSid"),G=j.formBody.get("From");if(!E||!G)return null;let D=j.formBody.get("ButtonText"),A=j.formBody.get("ButtonPayload"),C=j.formBody.get("ListTitle")??j.formBody.get("ListSelection"),q=j.formBody.get("MediaContentType0"),L=D?"button":C?"list_selection":q?.startsWith("audio/")?"voice":"text";return{workspaceId:j.workspaceId,conversationId:j.conversationId,channelType:"whatsapp",eventType:"whatsapp.twilio.message",externalEventId:E,externalConversationId:G,externalChannelId:j.formBody.get("To")??void 0,externalMessageId:E,participantBindingId:j.participantBindingId,externalIdentityRef:G,externalUserId:G,messageKind:L,text:D??C??j.formBody.get("Body")??(q?`media ${q}`:void 0)??"",interactiveSelection:D?{selectionType:"button",selectionId:A??D,label:D}:C?{selectionType:"list_selection",selectionId:C,label:C}:void 0,metadata:{accountSid:j.formBody.get("AccountSid")??"",profileName:j.formBody.get("ProfileName")??"",mediaContentType0:q??"",mediaUrl0:j.formBody.get("MediaUrl0")??""}}}export{S as verifyTwilioSignature,x as verifyMetaSignature,N as parseTwilioFormPayload,B as parseMetaWebhookPayload,h as normalizeBuilderTwilioWhatsappEnvelope,f as normalizeBuilderMetaWhatsappEnvelopes,P as BuilderWhatsappIntegrationSpec};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@lssm-tech/integration.builder-whatsapp",
+  "version": "0.2.11",
+  "description": "WhatsApp Builder control-channel integration.",
+  "keywords": [
+    "contractspec",
+    "builder",
+    "whatsapp",
+    "integration"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .",
+    "lint:check": "node ../../../scripts/biome.cjs check .",
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/integrations/builder-whatsapp"
+  },
+  "dependencies": {
+    "@contractspec/lib.builder-spec": "0.2.11",
+    "@contractspec/lib.builder-runtime": "0.2.11",
+    "@contractspec/lib.provider-spec": "0.2.9",
+    "@contractspec/integration.runtime": "3.10.1",
+    "@contractspec/lib.contracts-integrations": "3.10.0",
+    "@contractspec/lib.schema": "3.7.14"
+  },
+  "devDependencies": {
+    "@contractspec/tool.bun": "3.7.18",
+    "@contractspec/tool.typescript": "3.7.13",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/browser/index.js",
+      "bun": "./dist/index.js",
+      "node": "./dist/node/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "browser": "./dist/browser/index.js",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.js",
+        "default": "./dist/index.js"
+      }
+    }
+  }
+}