botcast-sdk 1.0.0

package/dist/webhooks/index.d.ts

@@ -0,0 +1,26 @@
+import { WebhookEvent, WebhookMessageReceivedEvent, WebhookHandler } from '../types/index.js';
+export declare class BotcastWebhook {
+    private handlers;
+    /**
+     * Registers a callback for incoming messages.
+     */
+    onMessage(handler: WebhookHandler<WebhookMessageReceivedEvent>): this;
+    /**
+     * Registers a callback for any event type.
+     */
+    on<T = WebhookEvent>(event: string, handler: WebhookHandler<T>): this;
+    /**
+     * Dispatches and processes a raw webhook event body.
+     */
+    handleEvent(event: WebhookEvent): Promise<void>;
+    /**
+     * Express / Connect compatible middleware:
+     *
+     * @example
+     * ```ts
+     * app.post('/webhook', botcast.webhook.middleware());
+     * ```
+     */
+    middleware(): (req: any, res: any, next?: any) => Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/webhooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/webhooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE9F,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAoD;IAEpE;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,2BAA2B,CAAC,GAAG,IAAI,CAE3E;IAED;;OAEG;IACI,EAAE,CAAC,CAAC,GAAG,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAM3E;IAED;;OAEG;IACU,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3D;IAED;;;;;;;OAOG;IACI,UAAU,UACI,GAAG,OAAO,GAAG,SAAS,GAAG,mBAe7C;CACF"}

package/dist/webhooks/index.js

@@ -0,0 +1,67 @@
+export class BotcastWebhook {
+    handlers = new Map();
+    /**
+     * Registers a callback for incoming messages.
+     */
+    onMessage(handler) {
+        return this.on('message_received', handler);
+    }
+    /**
+     * Registers a callback for any event type.
+     */
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return this;
+    }
+    /**
+     * Dispatches and processes a raw webhook event body.
+     */
+    async handleEvent(event) {
+        if (!event || !event.event)
+            return;
+        // Trigger specific event handlers
+        const specificHandlers = this.handlers.get(event.event);
+        if (specificHandlers) {
+            for (const handler of specificHandlers) {
+                await handler(event);
+            }
+        }
+        // Trigger wildcard '*' handlers
+        const wildcardHandlers = this.handlers.get('*');
+        if (wildcardHandlers) {
+            for (const handler of wildcardHandlers) {
+                await handler(event);
+            }
+        }
+    }
+    /**
+     * Express / Connect compatible middleware:
+     *
+     * @example
+     * ```ts
+     * app.post('/webhook', botcast.webhook.middleware());
+     * ```
+     */
+    middleware() {
+        return async (req, res, next) => {
+            try {
+                const body = req.body;
+                if (body && body.event) {
+                    await this.handleEvent(body);
+                }
+                res.status(200).json({ received: true });
+            }
+            catch (err) {
+                if (typeof next === 'function') {
+                    next(err);
+                }
+                else {
+                    res.status(500).json({ error: 'Webhook processing failed', message: err.message });
+                }
+            }
+        };
+    }
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "botcast-sdk",
+  "version": "1.0.0",
+  "description": "Official TypeScript/JavaScript SDK for Botcast WhatsApp Multi-Instance API Gateway",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./webhooks": {
+      "types": "./dist/webhooks/index.d.ts",
+      "import": "./dist/webhooks/index.js",
+      "require": "./dist/webhooks/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "node --test test/client.test.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "botcast",
+    "whatsapp",
+    "whatsapp-api",
+    "whatsapp-gateway",
+    "baileys",
+    "multi-instance",
+    "whatsapp-bot",
+    "otp",
+    "messaging",
+    "sms-alternative",
+    "webhooks"
+  ],
+  "author": "Botcast <support@botcast.site>",
+  "license": "MIT",
+  "homepage": "https://botcast.site",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ANOOBALSA/Botcast.git",
+    "directory": "packages/botcast-sdk"
+  },
+  "bugs": {
+    "url": "https://botcast.site/support"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  }
+}