@timbra-ec/whatsapp 0.1.0-dev.20260403050717

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @timbra-ec/whatsapp@0.1.1 build /home/runner/work/timbra-app/timbra-app/packages/whatsapp
+> tsc
+

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+import type { WhatsAppConfig } from './types';
+export declare function sendWhatsAppMessage(config: WhatsAppConfig, payload: Record<string, unknown>): Promise<{
+    messageId: string;
+}>;
+export declare class WhatsAppApiError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(message: string, code: string, statusCode: number);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAgB7C,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM;CAKrC"}

package/dist/client.js

@@ -0,0 +1,35 @@
+const GRAPH_API_VERSION = 'v21.0';
+const BASE_URL = `https://graph.facebook.com/${GRAPH_API_VERSION}`;
+export async function sendWhatsAppMessage(config, payload) {
+    const url = `${BASE_URL}/${config.phoneNumberId}/messages`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(payload),
+    });
+    const data = (await response.json());
+    if (!response.ok || data.error) {
+        const error = data.error;
+        const code = error?.code === 4 || error?.error_subcode === 33 ? 'RATE_LIMITED' : 'API_ERROR';
+        throw new WhatsAppApiError(error?.message ?? `WhatsApp API returned ${response.status}`, code, response.status);
+    }
+    const messageId = data.messages?.[0]?.id;
+    if (!messageId) {
+        throw new WhatsAppApiError('No message ID in response', 'UNEXPECTED_RESPONSE', response.status);
+    }
+    return { messageId };
+}
+export class WhatsAppApiError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'WhatsAppApiError';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,OAAO,CAAA;AACjC,MAAM,QAAQ,GAAG,8BAA8B,iBAAiB,EAAE,CAAA;AAalE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAsB,EACtB,OAAgC;IAEhC,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,aAAa,WAAW,CAAA;IAE1D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE;YACvC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAA;IAExD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAA;QAC5F,MAAM,IAAI,gBAAgB,CACxB,KAAK,EAAE,OAAO,IAAI,yBAAyB,QAAQ,CAAC,MAAM,EAAE,EAC5D,IAAI,EACJ,QAAQ,CAAC,MAAM,CAChB,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CAAC,2BAA2B,EAAE,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjG,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAA;AACtB,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,UAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { sendInvoiceWhatsApp, INVOICE_TEMPLATE_NAME } from './send-invoice-whatsapp';
+export type { WhatsAppConfig, SendInvoiceWhatsAppParams, DeliveryResult } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACpF,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { sendInvoiceWhatsApp, INVOICE_TEMPLATE_NAME } from './send-invoice-whatsapp';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/send-invoice-whatsapp.d.ts

@@ -0,0 +1,13 @@
+import type { DeliveryResult, SendInvoiceWhatsAppParams, WhatsAppConfig } from './types';
+/**
+ * Pre-approved template name that must be registered in Meta Business Manager.
+ *
+ * Expected template structure:
+ *   Header: Document (PDF attachment)
+ *   Body: "Estimado cliente, su factura {{1}} de {{2}} ha sido autorizada por el SRI.
+ *          Adjuntamos el comprobante electronico (RIDE) para su registro."
+ *   Language: es
+ */
+export declare const INVOICE_TEMPLATE_NAME = "invoice_notification";
+export declare function sendInvoiceWhatsApp(config: WhatsAppConfig, params: SendInvoiceWhatsAppParams): Promise<DeliveryResult>;
+//# sourceMappingURL=send-invoice-whatsapp.d.ts.map

package/dist/send-invoice-whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-invoice-whatsapp.d.ts","sourceRoot":"","sources":["../src/send-invoice-whatsapp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,yBAAyB,CAAA;AAE3D,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,CA0CzB"}

package/dist/send-invoice-whatsapp.js

@@ -0,0 +1,55 @@
+import { sendWhatsAppMessage, WhatsAppApiError } from './client';
+/**
+ * Pre-approved template name that must be registered in Meta Business Manager.
+ *
+ * Expected template structure:
+ *   Header: Document (PDF attachment)
+ *   Body: "Estimado cliente, su factura {{1}} de {{2}} ha sido autorizada por el SRI.
+ *          Adjuntamos el comprobante electronico (RIDE) para su registro."
+ *   Language: es
+ */
+export const INVOICE_TEMPLATE_NAME = 'invoice_notification';
+export async function sendInvoiceWhatsApp(config, params) {
+    const payload = {
+        messaging_product: 'whatsapp',
+        to: params.phoneNumber,
+        type: 'template',
+        template: {
+            name: INVOICE_TEMPLATE_NAME,
+            language: { code: 'es' },
+            components: [
+                {
+                    type: 'header',
+                    parameters: [
+                        {
+                            type: 'document',
+                            document: {
+                                link: params.ridePdfUrl,
+                                filename: `Factura_${params.invoiceNumber}.pdf`,
+                            },
+                        },
+                    ],
+                },
+                {
+                    type: 'body',
+                    parameters: [
+                        { type: 'text', text: params.invoiceNumber },
+                        { type: 'text', text: params.businessName },
+                    ],
+                },
+            ],
+        },
+    };
+    try {
+        const result = await sendWhatsAppMessage(config, payload);
+        return { success: true, messageId: result.messageId };
+    }
+    catch (error) {
+        if (error instanceof WhatsAppApiError) {
+            return { success: false, error: error.message, code: error.code };
+        }
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return { success: false, error: message, code: 'UNKNOWN' };
+    }
+}
+//# sourceMappingURL=send-invoice-whatsapp.js.map

package/dist/send-invoice-whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-invoice-whatsapp.js","sourceRoot":"","sources":["../src/send-invoice-whatsapp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,CAAA;AAE3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAsB,EACtB,MAAiC;IAEjC,MAAM,OAAO,GAAG;QACd,iBAAiB,EAAE,UAAU;QAC7B,EAAE,EAAE,MAAM,CAAC,WAAW;QACtB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YACxB,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV;4BACE,IAAI,EAAE,UAAU;4BAChB,QAAQ,EAAE;gCACR,IAAI,EAAE,MAAM,CAAC,UAAU;gCACvB,QAAQ,EAAE,WAAW,MAAM,CAAC,aAAa,MAAM;6BAChD;yBACF;qBACF;iBACF;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,EAAE;wBAC5C,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE;qBAC5C;iBACF;aACF;SACF;KACF,CAAA;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;QACnE,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;QACxE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IAC5D,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+/** WhatsApp Cloud API configuration */
+export interface WhatsAppConfig {
+    token: string;
+    phoneNumberId: string;
+}
+/** Parameters for sending an invoice via WhatsApp */
+export interface SendInvoiceWhatsAppParams {
+    phoneNumber: string;
+    invoiceNumber: string;
+    ridePdfUrl: string;
+    businessName: string;
+}
+interface DeliverySuccess {
+    success: true;
+    messageId: string;
+}
+interface DeliveryFailure {
+    success: false;
+    error: string;
+    code?: string;
+}
+/** Result of a WhatsApp delivery attempt */
+export type DeliveryResult = DeliverySuccess | DeliveryFailure;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,IAAI,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,eAAe,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@timbra-ec/whatsapp",
+  "version": "0.1.0-dev.20260403050717",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/timbra-ec/timbra-app.git",
+    "directory": "packages/whatsapp"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@timbra-ec/types": "0.1.0-dev.20260403050717"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'no lint configured yet'"
+  }
+}

package/src/client.ts

@@ -0,0 +1,61 @@
+import type { WhatsAppConfig } from './types'
+
+const GRAPH_API_VERSION = 'v21.0'
+const BASE_URL = `https://graph.facebook.com/${GRAPH_API_VERSION}`
+
+interface GraphApiResponse {
+  messages?: { id: string }[]
+  error?: {
+    message: string
+    type: string
+    code: number
+    error_subcode?: number
+    fbtrace_id?: string
+  }
+}
+
+export async function sendWhatsAppMessage(
+  config: WhatsAppConfig,
+  payload: Record<string, unknown>,
+): Promise<{ messageId: string }> {
+  const url = `${BASE_URL}/${config.phoneNumberId}/messages`
+
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${config.token}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(payload),
+  })
+
+  const data = (await response.json()) as GraphApiResponse
+
+  if (!response.ok || data.error) {
+    const error = data.error
+    const code = error?.code === 4 || error?.error_subcode === 33 ? 'RATE_LIMITED' : 'API_ERROR'
+    throw new WhatsAppApiError(
+      error?.message ?? `WhatsApp API returned ${response.status}`,
+      code,
+      response.status,
+    )
+  }
+
+  const messageId = data.messages?.[0]?.id
+  if (!messageId) {
+    throw new WhatsAppApiError('No message ID in response', 'UNEXPECTED_RESPONSE', response.status)
+  }
+
+  return { messageId }
+}
+
+export class WhatsAppApiError extends Error {
+  constructor(
+    message: string,
+    public readonly code: string,
+    public readonly statusCode: number,
+  ) {
+    super(message)
+    this.name = 'WhatsAppApiError'
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { sendInvoiceWhatsApp, INVOICE_TEMPLATE_NAME } from './send-invoice-whatsapp'
+export type { WhatsAppConfig, SendInvoiceWhatsAppParams, DeliveryResult } from './types'

package/src/send-invoice-whatsapp.ts

@@ -0,0 +1,60 @@
+import { sendWhatsAppMessage, WhatsAppApiError } from './client'
+import type { DeliveryResult, SendInvoiceWhatsAppParams, WhatsAppConfig } from './types'
+
+/**
+ * Pre-approved template name that must be registered in Meta Business Manager.
+ *
+ * Expected template structure:
+ *   Header: Document (PDF attachment)
+ *   Body: "Estimado cliente, su factura {{1}} de {{2}} ha sido autorizada por el SRI.
+ *          Adjuntamos el comprobante electronico (RIDE) para su registro."
+ *   Language: es
+ */
+export const INVOICE_TEMPLATE_NAME = 'invoice_notification'
+
+export async function sendInvoiceWhatsApp(
+  config: WhatsAppConfig,
+  params: SendInvoiceWhatsAppParams,
+): Promise<DeliveryResult> {
+  const payload = {
+    messaging_product: 'whatsapp',
+    to: params.phoneNumber,
+    type: 'template',
+    template: {
+      name: INVOICE_TEMPLATE_NAME,
+      language: { code: 'es' },
+      components: [
+        {
+          type: 'header',
+          parameters: [
+            {
+              type: 'document',
+              document: {
+                link: params.ridePdfUrl,
+                filename: `Factura_${params.invoiceNumber}.pdf`,
+              },
+            },
+          ],
+        },
+        {
+          type: 'body',
+          parameters: [
+            { type: 'text', text: params.invoiceNumber },
+            { type: 'text', text: params.businessName },
+          ],
+        },
+      ],
+    },
+  }
+
+  try {
+    const result = await sendWhatsAppMessage(config, payload)
+    return { success: true, messageId: result.messageId }
+  } catch (error) {
+    if (error instanceof WhatsAppApiError) {
+      return { success: false, error: error.message, code: error.code }
+    }
+    const message = error instanceof Error ? error.message : 'Unknown error'
+    return { success: false, error: message, code: 'UNKNOWN' }
+  }
+}

package/src/types.ts

@@ -0,0 +1,27 @@
+/** WhatsApp Cloud API configuration */
+export interface WhatsAppConfig {
+  token: string
+  phoneNumberId: string
+}
+
+/** Parameters for sending an invoice via WhatsApp */
+export interface SendInvoiceWhatsAppParams {
+  phoneNumber: string // E.164 format, e.g., "+593991234567"
+  invoiceNumber: string // e.g., "001-001-000000042"
+  ridePdfUrl: string
+  businessName: string
+}
+
+interface DeliverySuccess {
+  success: true
+  messageId: string
+}
+
+interface DeliveryFailure {
+  success: false
+  error: string
+  code?: string
+}
+
+/** Result of a WhatsApp delivery attempt */
+export type DeliveryResult = DeliverySuccess | DeliveryFailure

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@timbra-ec/config-ts/library.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}