meta-cloud-api 3.1.1 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/README.md +14 -10
  2. package/dist/index.d.mts +334 -10
  3. package/dist/index.d.mts.map +1 -1
  4. package/dist/index.mjs +4 -4
  5. package/dist/index.mjs.map +1 -1
  6. package/dist/types/enums.d.ts +19 -2
  7. package/dist/types/enums.d.ts.map +1 -1
  8. package/dist/types/enums.js +1 -1
  9. package/dist/types/enums.js.map +1 -1
  10. package/dist/types/index.d.ts +221 -8
  11. package/dist/types/index.d.ts.map +1 -1
  12. package/dist/types/index.js +1 -1
  13. package/dist/types/index.js.map +1 -1
  14. package/dist/utils/index.d.ts +1 -1
  15. package/dist/utils/index.d.ts.map +1 -1
  16. package/dist/utils/index.js +1 -1
  17. package/dist/utils/index.js.map +1 -1
  18. package/package.json +17 -13
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <div align="center">
2
2
  <img src="public/README.svg" alt="meta-cloud-api" width="120">
3
3
  <h1>meta-cloud-api</h1>
4
- <p><strong>WhatsApp TypeScript SDK</strong> — type-safe, modular, and production-ready.</p>
5
- <p>The complete SDK for the official <a href="https://developers.facebook.com/docs/whatsapp/cloud-api">WhatsApp Business Platform Cloud API</a>.</p>
4
+ <p><strong>The actively maintained TypeScript SDK for the official WhatsApp Cloud API.</strong></p>
5
+ <p>Meta <a href="https://github.com/WhatsApp/WhatsApp-Nodejs-SDK">archived their own Node.js SDK</a> in 2023. This one kept going.</p>
6
6
 
7
7
  [![npm version](https://img.shields.io/npm/v/meta-cloud-api.svg)](https://www.npmjs.com/package/meta-cloud-api)
8
8
  [![npm downloads](https://img.shields.io/npm/dm/meta-cloud-api.svg)](https://www.npmjs.com/package/meta-cloud-api)
@@ -43,14 +43,18 @@ await wa.messages.image({ to: '1234567890', link: 'https://example.com/image.png
43
43
 
44
44
  ## Why meta-cloud-api?
45
45
 
46
- | | meta-cloud-api |
47
- |---|---|
48
- | **Type Safety** | Full TypeScript strict mode — every request and response is typed |
49
- | **17 API Modules** | Messages, Media, Templates, Flows, Groups, Calling, Payments, and more |
50
- | **Webhook Adapters** | Built-in support for Express.js and Next.js (App Router & Pages Router) |
51
- | **Modular** | Tree-shakeable imports, use only what you need |
52
- | **Production Ready** | Error handling, typed error classes, rate limit support |
53
- | **Official API** | Built on the official WhatsApp Business Platform Cloud API |
46
+ > **Meta's own WhatsApp Node.js SDK has been [archived since June 2023](https://github.com/WhatsApp/WhatsApp-Nodejs-SDK)** — no fixes, no updates, no OpenAPI v23 support. meta-cloud-api is a maintained, type-safe alternative built on the same official Cloud API.
47
+
48
+ | | meta-cloud-api | Official SDK | Unofficial libraries (whatsapp-web.js, Baileys) |
49
+ |---|---|---|---|
50
+ | API basis | Official Cloud API | Official Cloud API | Reverse-engineered, unofficial |
51
+ | Account ban risk | None | None | Yes — violates WhatsApp ToS |
52
+ | Maintenance | Active (tracks OpenAPI v23) | **Archived since 2023** | Varies |
53
+ | TypeScript | Strict, full request/response types | Partial | Varies |
54
+ | API coverage | 20 modules (Messages, Flows, Calling, Payments, and more) | Messaging-focused | Personal-account features |
55
+ | Webhook adapters | Built-in Express.js + Next.js | Manual | Custom event system |
56
+
57
+ If you're building on the official Cloud API and don't want to bet on an unmaintained SDK, this is what the archived one would look like if Meta had kept shipping it.
54
58
 
55
59
  ## API Coverage
56
60