whatsapp-cloud 0.0.4 → 0.0.6

package/src/services/webhooks/utils/extract-statuses.ts

@@ -0,0 +1,25 @@
+import type { WebhookPayload } from "../../../types/webhooks";
+
+/**
+ * Extract status updates from webhook payload
+ *
+ * Flattens the nested structure: entry[].changes[].value.statuses[]
+ * Returns a flat array of status updates
+ *
+ * @param payload - Webhook payload from Meta
+ * @returns Flat array of status updates
+ */
+export function extractStatuses(payload: WebhookPayload): unknown[] {
+  const statuses: unknown[] = [];
+
+  for (const entry of payload.entry) {
+    for (const change of entry.changes) {
+      if (change.field === "messages" && change.value.statuses) {
+        statuses.push(...change.value.statuses);
+      }
+    }
+  }
+
+  return statuses;
+}
+

package/src/services/webhooks/utils/verify.ts

@@ -0,0 +1,29 @@
+/**
+ * Verify webhook GET request from Meta
+ *
+ * Meta sends GET requests to verify webhook endpoints:
+ * GET /webhook?hub.mode=subscribe&hub.challenge=<CHALLENGE>&hub.verify_token=<TOKEN>
+ *
+ * @param query - Query parameters from GET request
+ * @param verifyToken - Your verification token (stored on your server)
+ * @returns Challenge string if valid, null if invalid
+ */
+export function verifyWebhook(
+  query: {
+    "hub.mode"?: string;
+    "hub.verify_token"?: string;
+    "hub.challenge"?: string;
+  },
+  verifyToken: string
+): string | null {
+  const mode = query["hub.mode"];
+  const token = query["hub.verify_token"];
+  const challenge = query["hub.challenge"];
+
+  // Verify mode is "subscribe" and token matches
+  if (mode === "subscribe" && token === verifyToken && challenge) {
+    return challenge;
+  }
+
+  return null;
+}

package/src/types/index.ts

@@ -2,4 +2,6 @@ export type * from "./client";
 export type * from "./messages/index";
 export type * from "./accounts/index";
 export type * from "./business/index";
+export type * from "./templates/index";
+export type * from "./webhooks/index";
 export type * from "./debug";

package/src/types/templates/component.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import {
+  buttonSchema,
+  componentSchema,
+  quickReplyButtonSchema,
+  urlButtonSchema,
+  phoneNumberButtonSchema,
+  copyCodeButtonSchema,
+  flowButtonSchema,
+  headerComponentSchema,
+  bodyComponentSchema,
+  footerComponentSchema,
+  buttonsComponentSchema,
+} from "../../schemas/templates/component";
+
+/**
+ * Button types
+ */
+export type QuickReplyButton = z.infer<typeof quickReplyButtonSchema>;
+export type UrlButton = z.infer<typeof urlButtonSchema>;
+export type PhoneNumberButton = z.infer<typeof phoneNumberButtonSchema>;
+export type CopyCodeButton = z.infer<typeof copyCodeButtonSchema>;
+export type FlowButton = z.infer<typeof flowButtonSchema>;
+export type Button = z.infer<typeof buttonSchema>;
+
+/**
+ * Component types
+ */
+export type HeaderComponent = z.infer<typeof headerComponentSchema>;
+export type BodyComponent = z.infer<typeof bodyComponentSchema>;
+export type FooterComponent = z.infer<typeof footerComponentSchema>;
+export type ButtonsComponent = z.infer<typeof buttonsComponentSchema>;
+export type Component = z.infer<typeof componentSchema>;

package/src/types/templates/index.ts

@@ -0,0 +1,4 @@
+export * from "./component";
+export * from "./request";
+export * from "./response";
+

package/src/types/templates/request.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import {
+  createTemplateRequestSchema,
+  updateTemplateRequestSchema,
+  listTemplatesRequestSchema,
+  deleteTemplateRequestSchema,
+} from "../../schemas/templates/request";
+
+/**
+ * Type for creating a template
+ */
+export type CreateTemplateRequest = z.infer<typeof createTemplateRequestSchema>;
+
+/**
+ * Type for updating a template
+ */
+export type UpdateTemplateRequest = z.infer<typeof updateTemplateRequestSchema>;
+
+/**
+ * Type for listing templates
+ */
+export type ListTemplatesRequest = z.infer<typeof listTemplatesRequestSchema>;
+
+/**
+ * Type for deleting a template
+ */
+export type DeleteTemplateRequest = z.infer<typeof deleteTemplateRequestSchema>;
+

package/src/types/templates/response.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import {
+  templateResponseSchema,
+  createTemplateResponseSchema,
+  listTemplatesResponseSchema,
+  updateTemplateResponseSchema,
+  deleteTemplateResponseSchema,
+} from "../../schemas/templates/response";
+
+/**
+ * Type for a single template
+ */
+export type TemplateResponse = z.infer<typeof templateResponseSchema>;
+
+/**
+ * Type for create template response
+ */
+export type CreateTemplateResponse = z.infer<typeof createTemplateResponseSchema>;
+
+/**
+ * Type for list templates response
+ */
+export type ListTemplatesResponse = z.infer<typeof listTemplatesResponseSchema>;
+
+/**
+ * Type for update template response
+ */
+export type UpdateTemplateResponse = z.infer<typeof updateTemplateResponseSchema>;
+
+/**
+ * Type for delete template response
+ */
+export type DeleteTemplateResponse = z.infer<typeof deleteTemplateResponseSchema>;
+

package/src/types/webhooks/incoming-message.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import {
+  incomingTextMessageSchema,
+  incomingMessageSchema,
+} from "../../schemas/webhooks/incoming-message";
+
+/**
+ * Type for incoming text message
+ */
+export type IncomingTextMessage = z.infer<typeof incomingTextMessageSchema>;
+
+/**
+ * Union type for all incoming message types
+ */
+export type IncomingMessage = z.infer<typeof incomingMessageSchema>;
+

package/src/types/webhooks/index.ts

@@ -0,0 +1,3 @@
+export * from "./incoming-message";
+export * from "./payload";
+

package/src/types/webhooks/payload.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import { webhookPayloadSchema } from "../../schemas/webhooks/payload";
+
+/**
+ * Type for webhook payload
+ */
+export type WebhookPayload = z.infer<typeof webhookPayloadSchema>;
+

package/tsconfig.json

@@ -12,10 +12,9 @@
     "module": "esnext",
     "moduleResolution": "bundler",
     "target": "esnext",
-    "types": [],
     // For nodejs:
-    // "lib": ["esnext"],
-    // "types": ["node"],
+    "lib": ["esnext"],
+    "types": ["node"],
     // and npm install -D @types/node
 
     // Other Outputs