@rkitwork/whatsapp-ramukjar-cloud-sdk 1.0.1 → 1.1.0

package/README.md

@@ -49,70 +49,9 @@ await whatsapp.sendMessage('RECIPIENT_NUMBER', textMessage('Hello World!'));
 
 ---
 
-### 3. NestJS Webhook Controller (Optional)
-
-```ts
-import { WebhookController } from '@rkitwork/whatsapp-ramukjar-cloud-sdk';
-import { Module } from '@nestjs/common';
-
-@Module({
-  controllers: [WebhookController],
-})
-export class AppModule {}
-```
-
-#### Controller handles:
-
-- `GET /webhook` → WhatsApp verification challenge
-- `POST /webhook` → Incoming messages or events
 
 ---
 
-### 4. ExpressJS Example (Optional)
-
-```ts
-import express from 'express';
-import bodyParser from 'body-parser';
-import { WebhookController } from '@rkitwork/whatsapp-ramukjar-cloud-sdk';
-
-const app = express();
-app.use(bodyParser.json());
-
-app.get('/webhook', (req, res) => {
-  const challenge = req.query['hub.challenge'];
-  res.send(challenge);
-});
-
-app.post('/webhook', (req, res) => {
-  console.log('Incoming webhook:', req.body);
-  res.sendStatus(200);
-});
-
-app.listen(3000, () => console.log('Server running on http://localhost:3000'));
-```
-
----
-
-## Types & Payloads
-
-- `textMessage(content: string)` → Returns WhatsApp text message payload
-- `imageMessage(url: string, caption?: string)` → Returns image message payload
-- `templateMessage(name: string, language: string, variables?: any[])` → Template message payload
-- All payloads are fully typed in `payloads.ts`  
-
----
-
-## Contributing
-
-1. Fork the repository  
-2. `npm install` dependencies  
-3. Make changes in `src/`  
-4. Build the package:  
-
-```bash
-npm run build
-```
-
 ---
 
 ## Support / Donations

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+import { WhatsAppPayload } from './payloads';
+export declare class WhatsAppClient {
+    private readonly config;
+    constructor(config: {
+        token: string;
+        phoneNumberId: string;
+        apiVersion: string;
+    });
+    sendMessage(to: string, payload: WhatsAppPayload): Promise<any>;
+}

package/dist/client.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppClient = void 0;
+const sender_1 = require("./sender");
+class WhatsAppClient {
+    constructor(config) {
+        this.config = config;
+    }
+    sendMessage(to, payload) {
+        return (0, sender_1.sendMessage)(this.config.token, this.config.phoneNumberId, this.config.apiVersion, to, payload);
+    }
+}
+exports.WhatsAppClient = WhatsAppClient;

package/dist/helpers.d.ts

@@ -0,0 +1,43 @@
+export declare const WhatsApp: {
+    text: (body: string) => {
+        type: string;
+        text: {
+            body: string;
+        };
+    };
+    image: (link: string, caption?: string) => {
+        type: string;
+        image: {
+            link: string;
+            caption: string | undefined;
+        };
+    };
+    video: (link: string, caption?: string) => {
+        type: string;
+        video: {
+            link: string;
+            caption: string | undefined;
+        };
+    };
+    audio: (link: string) => {
+        type: string;
+        audio: {
+            link: string;
+        };
+    };
+    document: (link: string, filename?: string) => {
+        type: string;
+        document: {
+            link: string;
+            filename: string | undefined;
+        };
+    };
+    location: (lat: number, lng: number, name?: string) => {
+        type: string;
+        location: {
+            latitude: number;
+            longitude: number;
+            name: string | undefined;
+        };
+    };
+};

package/dist/helpers.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsApp = void 0;
+exports.WhatsApp = {
+    text: (body) => ({ type: 'text', text: { body } }),
+    image: (link, caption) => ({ type: 'image', image: { link, caption } }),
+    video: (link, caption) => ({ type: 'video', video: { link, caption } }),
+    audio: (link) => ({ type: 'audio', audio: { link } }),
+    document: (link, filename) => ({ type: 'document', document: { link, filename } }),
+    location: (lat, lng, name) => ({
+        type: 'location',
+        location: { latitude: lat, longitude: lng, name }
+    })
+};

package/dist/index.d.ts

@@ -1,6 +1,4 @@
-export * from './core/WhatsAppClient';
-export * from './core/payloads';
-export * from './core/types';
-export * from './express/webhook';
-export * from './nest/whatsapp.module';
-export * from './nest/whatsapp.service';
+export * from './client';
+export * from './sender';
+export * from './helpers';
+export * from './payloads';

package/dist/index.js

@@ -14,9 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./core/WhatsAppClient"), exports);
-__exportStar(require("./core/payloads"), exports);
-__exportStar(require("./core/types"), exports);
-__exportStar(require("./express/webhook"), exports);
-__exportStar(require("./nest/whatsapp.module"), exports);
-__exportStar(require("./nest/whatsapp.service"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./sender"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./payloads"), exports);

package/dist/payloads/audio.d.ts

@@ -0,0 +1,7 @@
+export interface AudioMessage {
+    type: 'audio';
+    audio: {
+        link?: string;
+        id?: string;
+    };
+}

package/dist/payloads/document.d.ts

@@ -0,0 +1,8 @@
+export interface DocumentMessage {
+    type: 'document';
+    document: {
+        link?: string;
+        id?: string;
+        filename?: string;
+    };
+}

package/dist/payloads/document.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/image.d.ts

@@ -0,0 +1,8 @@
+export interface ImageMessage {
+    type: 'image';
+    image: {
+        link?: string;
+        id?: string;
+        caption?: string;
+    };
+}

package/dist/payloads/image.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/index.d.ts

@@ -0,0 +1,19 @@
+export * from './text';
+export * from './image';
+export * from './video';
+export * from './audio';
+export * from './document';
+export * from './template';
+export * from './interactive';
+export * from './location';
+export * from './reaction';
+import { TextMessage } from './text';
+import { ImageMessage } from './image';
+import { VideoMessage } from './video';
+import { AudioMessage } from './audio';
+import { DocumentMessage } from './document';
+import { TemplateMessage } from './template';
+import { InteractiveMessage } from './interactive';
+import { LocationMessage } from './location';
+import { ReactionMessage } from './reaction';
+export type WhatsAppPayload = TextMessage | ImageMessage | VideoMessage | AudioMessage | DocumentMessage | TemplateMessage | InteractiveMessage | LocationMessage | ReactionMessage;

package/dist/payloads/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./text"), exports);
+__exportStar(require("./image"), exports);
+__exportStar(require("./video"), exports);
+__exportStar(require("./audio"), exports);
+__exportStar(require("./document"), exports);
+__exportStar(require("./template"), exports);
+__exportStar(require("./interactive"), exports);
+__exportStar(require("./location"), exports);
+__exportStar(require("./reaction"), exports);

package/dist/payloads/interactive.d.ts

@@ -0,0 +1,13 @@
+export interface InteractiveMessage {
+    type: 'interactive';
+    interactive: {
+        type: 'button' | 'list';
+        body: {
+            text: string;
+        };
+        footer?: {
+            text: string;
+        };
+        action: any;
+    };
+}

package/dist/payloads/interactive.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/location.d.ts

@@ -0,0 +1,9 @@
+export interface LocationMessage {
+    type: 'location';
+    location: {
+        latitude: number;
+        longitude: number;
+        name?: string;
+        address?: string;
+    };
+}

package/dist/payloads/location.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/reaction.d.ts

@@ -0,0 +1,7 @@
+export interface ReactionMessage {
+    type: 'reaction';
+    reaction: {
+        message_id: string;
+        emoji: string;
+    };
+}

package/dist/payloads/reaction.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/template.d.ts

@@ -0,0 +1,10 @@
+export interface TemplateMessage {
+    type: 'template';
+    template: {
+        name: string;
+        language: {
+            code: string;
+        };
+        components?: any[];
+    };
+}

package/dist/payloads/template.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/text.d.ts

@@ -0,0 +1,7 @@
+export interface TextMessage {
+    type: 'text';
+    text: {
+        body: string;
+        preview_url?: boolean;
+    };
+}

package/dist/payloads/text.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/payloads/video.d.ts

@@ -0,0 +1,8 @@
+export interface VideoMessage {
+    type: 'video';
+    video: {
+        link?: string;
+        id?: string;
+        caption?: string;
+    };
+}

package/dist/payloads/video.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sender.d.ts

@@ -0,0 +1,2 @@
+import { WhatsAppPayload } from './payloads';
+export declare function sendMessage(token: string, phoneNumberId: string, apiVersion: string, to: string, payload: WhatsAppPayload): Promise<any>;

package/dist/sender.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendMessage = sendMessage;
+const axios_1 = __importDefault(require("axios"));
+async function sendMessage(token, phoneNumberId, apiVersion, to, payload) {
+    const url = `https://graph.facebook.com/${apiVersion}/${phoneNumberId}/messages`;
+    const response = await axios_1.default.post(url, { messaging_product: 'whatsapp', to, ...payload }, { headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' } });
+    return response.data;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rkitwork/whatsapp-ramukjar-cloud-sdk",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A secure WhatsApp Cloud API SDK for NestJS and Express",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,20 +8,19 @@
     "build": "tsc",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["whatsapp", "sdk", "nestjs", "express", "cloud-api"],
+  "keywords": [
+    "whatsapp",
+    "sdk",
+    "nestjs",
+    "express",
+    "cloud-api"
+  ],
   "author": "rkitwork",
   "license": "MIT",
-  "peerDependencies": {
-    "@nestjs/common": ">=9.0.0",
-    "@nestjs/core": ">=9.0.0",
-    "express": ">=4.17.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.3.3",
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.0.0"
-  },
   "dependencies": {
     "axios": "^1.7.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
   }
 }

package/src/client.ts

@@ -0,0 +1,22 @@
+import { sendMessage } from './sender';
+import { WhatsAppPayload } from './payloads';
+
+export class WhatsAppClient {
+  constructor(
+    private readonly config: {
+      token: string;
+      phoneNumberId: string;
+      apiVersion: string;
+    }
+  ) {}
+
+  sendMessage(to: string, payload: WhatsAppPayload) {
+    return sendMessage(
+      this.config.token,
+      this.config.phoneNumberId,
+      this.config.apiVersion,
+      to,
+      payload
+    );
+  }
+}

package/src/helpers.ts

@@ -0,0 +1,11 @@
+export const WhatsApp = {
+  text: (body: string) => ({ type: 'text', text: { body } }),
+  image: (link: string, caption?: string) => ({ type: 'image', image: { link, caption } }),
+  video: (link: string, caption?: string) => ({ type: 'video', video: { link, caption } }),
+  audio: (link: string) => ({ type: 'audio', audio: { link } }),
+  document: (link: string, filename?: string) => ({ type: 'document', document: { link, filename } }),
+  location: (lat: number, lng: number, name?: string) => ({
+    type: 'location',
+    location: { latitude: lat, longitude: lng, name }
+  })
+};

package/src/index.ts

@@ -1,8 +1,4 @@
-export * from './core/WhatsAppClient';
-export * from './core/payloads';
-export * from './core/types';
-
-export * from './express/webhook';
-
-export * from './nest/whatsapp.module';
-export * from './nest/whatsapp.service';
+export * from './client';
+export * from './sender';
+export * from './helpers';
+export * from './payloads';

package/src/payloads/audio.ts

@@ -0,0 +1,4 @@
+export interface AudioMessage {
+  type: 'audio';
+  audio: { link?: string; id?: string };
+}

package/src/payloads/document.ts

@@ -0,0 +1,4 @@
+export interface DocumentMessage {
+  type: 'document';
+  document: { link?: string; id?: string; filename?: string };
+}

package/src/payloads/image.ts

@@ -0,0 +1,4 @@
+export interface ImageMessage {
+  type: 'image';
+  image: { link?: string; id?: string; caption?: string };
+}

package/src/payloads/index.ts

@@ -0,0 +1,30 @@
+export * from './text';
+export * from './image';
+export * from './video';
+export * from './audio';
+export * from './document';
+export * from './template';
+export * from './interactive';
+export * from './location';
+export * from './reaction';
+
+import { TextMessage } from './text';
+import { ImageMessage } from './image';
+import { VideoMessage } from './video';
+import { AudioMessage } from './audio';
+import { DocumentMessage } from './document';
+import { TemplateMessage } from './template';
+import { InteractiveMessage } from './interactive';
+import { LocationMessage } from './location';
+import { ReactionMessage } from './reaction';
+
+export type WhatsAppPayload =
+  | TextMessage
+  | ImageMessage
+  | VideoMessage
+  | AudioMessage
+  | DocumentMessage
+  | TemplateMessage
+  | InteractiveMessage
+  | LocationMessage
+  | ReactionMessage;

package/src/payloads/interactive.ts

@@ -0,0 +1,9 @@
+export interface InteractiveMessage {
+  type: 'interactive';
+  interactive: {
+    type: 'button' | 'list';
+    body: { text: string };
+    footer?: { text: string };
+    action: any;
+  };
+}

package/src/payloads/location.ts

@@ -0,0 +1,9 @@
+export interface LocationMessage {
+  type: 'location';
+  location: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    address?: string;
+  };
+}

package/src/payloads/reaction.ts

@@ -0,0 +1,7 @@
+export interface ReactionMessage {
+  type: 'reaction';
+  reaction: {
+    message_id: string;
+    emoji: string;
+  };
+}

package/src/payloads/template.ts

@@ -0,0 +1,8 @@
+export interface TemplateMessage {
+  type: 'template';
+  template: {
+    name: string;
+    language: { code: string };
+    components?: any[];
+  };
+}

package/src/payloads/text.ts

@@ -0,0 +1,4 @@
+export interface TextMessage {
+  type: 'text';
+  text: { body: string; preview_url?: boolean };
+}

package/src/payloads/video.ts

@@ -0,0 +1,4 @@
+export interface VideoMessage {
+  type: 'video';
+  video: { link?: string; id?: string; caption?: string };
+}

package/src/sender.ts

@@ -0,0 +1,18 @@
+import axios from 'axios';
+import { WhatsAppPayload } from './payloads';
+
+export async function sendMessage(
+  token: string,
+  phoneNumberId: string,
+  apiVersion: string,
+  to: string,
+  payload: WhatsAppPayload
+) {
+  const url = `https://graph.facebook.com/${apiVersion}/${phoneNumberId}/messages`;
+  const response = await axios.post(
+    url,
+    { messaging_product: 'whatsapp', to, ...payload },
+    { headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' } }
+  );
+  return response.data;
+}

package/dist/core/WhatsAppClient.d.ts

@@ -1,8 +0,0 @@
-import { WhatsAppPayload } from './types';
-export declare class WhatsAppClient {
-    private readonly token;
-    private readonly phoneNumberId;
-    private readonly apiVersion;
-    constructor(token: string, phoneNumberId: string, apiVersion?: string);
-    sendMessage(to: string, payload: WhatsAppPayload): Promise<any>;
-}

package/dist/core/WhatsAppClient.js

@@ -1,29 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WhatsAppClient = void 0;
-const axios_1 = __importDefault(require("axios"));
-class WhatsAppClient {
-    constructor(token, phoneNumberId, apiVersion = 'v24.0') {
-        this.token = token;
-        this.phoneNumberId = phoneNumberId;
-        this.apiVersion = apiVersion;
-    }
-    async sendMessage(to, payload) {
-        const url = `https://graph.facebook.com/${this.apiVersion}/${this.phoneNumberId}/messages`;
-        const response = await axios_1.default.post(url, {
-            messaging_product: 'whatsapp',
-            to,
-            ...payload,
-        }, {
-            headers: {
-                Authorization: `Bearer ${this.token}`,
-                'Content-Type': 'application/json',
-            },
-        });
-        return response.data;
-    }
-}
-exports.WhatsAppClient = WhatsAppClient;

package/dist/core/payloads.d.ts

@@ -1,14 +0,0 @@
-import * as T from './types';
-export declare const textMessage: (body: string, preview?: boolean) => T.TextPayload;
-export declare const imageMessage: (link: string, caption?: string) => T.ImagePayload;
-export declare const audioMessage: (link: string) => T.AudioPayload;
-export declare const videoMessage: (link: string, caption?: string) => T.VideoPayload;
-export declare const documentMessage: (link: string, filename: string, caption?: string) => T.DocumentPayload;
-export declare const locationMessage: (latitude: number, longitude: number, name?: string, address?: string) => T.LocationPayload;
-export declare const contactMessage: (firstName: string, phone: string, lastName?: string) => T.ContactPayload;
-export declare const buttonMessage: (bodyText: string, buttons: {
-    id: string;
-    title: string;
-}[]) => T.ButtonPayload;
-export declare const listMessage: (bodyText: string, buttonText: string, sections: T.ListPayload["interactive"]["action"]["sections"]) => T.ListPayload;
-export declare const templateMessage: (name: string, language?: string, components?: any[]) => T.TemplatePayload;