whatsapp-cloud 0.0.3 → 0.0.5

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 (73) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +11 -0
  3. package/agent_docs/DESIGN.md +707 -0
  4. package/agent_docs/INCOMING_MESSAGES_BRAINSTORM.md +500 -0
  5. package/agent_docs/MESSAGES_NAMESPACE_ANALYSIS.md +368 -0
  6. package/agent_docs/NAMING_DECISION.md +78 -0
  7. package/agent_docs/STRUCTURE.md +711 -0
  8. package/agent_docs/messages-namespace-design.md +357 -0
  9. package/cloud-api-docs/webhooks/endpoint.md +112 -0
  10. package/cloud-api-docs/webhooks/overview.md +154 -0
  11. package/package.json +10 -3
  12. package/src/client/HttpClient.ts +159 -0
  13. package/src/client/WhatsAppClient.ts +58 -0
  14. package/src/client/index.ts +2 -0
  15. package/src/errors.ts +58 -0
  16. package/src/examples/main.ts +9 -0
  17. package/src/examples/template.ts +134 -0
  18. package/src/index.ts +16 -1
  19. package/src/schemas/accounts/index.ts +1 -0
  20. package/src/schemas/accounts/phone-number.ts +20 -0
  21. package/src/schemas/business/account.ts +43 -0
  22. package/src/schemas/business/index.ts +2 -0
  23. package/src/schemas/client.ts +50 -0
  24. package/src/schemas/debug.ts +25 -0
  25. package/src/schemas/index.ts +6 -0
  26. package/src/schemas/messages/index.ts +2 -0
  27. package/src/schemas/messages/request.ts +82 -0
  28. package/src/schemas/messages/response.ts +19 -0
  29. package/src/schemas/templates/component.ts +145 -0
  30. package/src/schemas/templates/index.ts +4 -0
  31. package/src/schemas/templates/request.ts +78 -0
  32. package/src/schemas/templates/response.ts +64 -0
  33. package/src/services/accounts/AccountsClient.ts +34 -0
  34. package/src/services/accounts/AccountsService.ts +45 -0
  35. package/src/services/accounts/index.ts +2 -0
  36. package/src/services/accounts/methods/list-phone-numbers.ts +15 -0
  37. package/src/services/business/BusinessClient.ts +34 -0
  38. package/src/services/business/BusinessService.ts +45 -0
  39. package/src/services/business/index.ts +3 -0
  40. package/src/services/business/methods/list-accounts.ts +17 -0
  41. package/src/services/index.ts +2 -0
  42. package/src/services/messages/MessagesClient.ts +34 -0
  43. package/src/services/messages/MessagesService.ts +97 -0
  44. package/src/services/messages/index.ts +8 -0
  45. package/src/services/messages/methods/send-image.ts +33 -0
  46. package/src/services/messages/methods/send-location.ts +32 -0
  47. package/src/services/messages/methods/send-reaction.ts +33 -0
  48. package/src/services/messages/methods/send-text.ts +32 -0
  49. package/src/services/messages/utils/build-message-payload.ts +32 -0
  50. package/src/services/templates/TemplatesClient.ts +35 -0
  51. package/src/services/templates/TemplatesService.ts +117 -0
  52. package/src/services/templates/index.ts +3 -0
  53. package/src/services/templates/methods/create.ts +27 -0
  54. package/src/services/templates/methods/delete.ts +38 -0
  55. package/src/services/templates/methods/get.ts +23 -0
  56. package/src/services/templates/methods/list.ts +36 -0
  57. package/src/services/templates/methods/update.ts +35 -0
  58. package/src/types/accounts/index.ts +1 -0
  59. package/src/types/accounts/phone-number.ts +9 -0
  60. package/src/types/business/account.ts +10 -0
  61. package/src/types/business/index.ts +2 -0
  62. package/src/types/client.ts +8 -0
  63. package/src/types/debug.ts +8 -0
  64. package/src/types/index.ts +6 -0
  65. package/src/types/messages/index.ts +2 -0
  66. package/src/types/messages/request.ts +27 -0
  67. package/src/types/messages/response.ts +7 -0
  68. package/src/types/templates/component.ts +33 -0
  69. package/src/types/templates/index.ts +4 -0
  70. package/src/types/templates/request.ts +28 -0
  71. package/src/types/templates/response.ts +34 -0
  72. package/src/utils/zod-error.ts +28 -0
  73. package/tsconfig.json +6 -4
@@ -0,0 +1,34 @@
1
+ import { z } from "zod";
2
+ import {
3
+ templateResponseSchema,
4
+ createTemplateResponseSchema,
5
+ listTemplatesResponseSchema,
6
+ updateTemplateResponseSchema,
7
+ deleteTemplateResponseSchema,
8
+ } from "../../schemas/templates/response";
9
+
10
+ /**
11
+ * Type for a single template
12
+ */
13
+ export type TemplateResponse = z.infer<typeof templateResponseSchema>;
14
+
15
+ /**
16
+ * Type for create template response
17
+ */
18
+ export type CreateTemplateResponse = z.infer<typeof createTemplateResponseSchema>;
19
+
20
+ /**
21
+ * Type for list templates response
22
+ */
23
+ export type ListTemplatesResponse = z.infer<typeof listTemplatesResponseSchema>;
24
+
25
+ /**
26
+ * Type for update template response
27
+ */
28
+ export type UpdateTemplateResponse = z.infer<typeof updateTemplateResponseSchema>;
29
+
30
+ /**
31
+ * Type for delete template response
32
+ */
33
+ export type DeleteTemplateResponse = z.infer<typeof deleteTemplateResponseSchema>;
34
+
@@ -0,0 +1,28 @@
1
+ import { ZodError } from "zod";
2
+ import { WhatsAppValidationError } from "../errors";
3
+
4
+ /**
5
+ * Transform a ZodError into a WhatsAppValidationError
6
+ *
7
+ * Uses the first error's message (Zod already orders errors by importance)
8
+ * Can be used for any validation: config, requests, responses, etc.
9
+ */
10
+ export function transformZodError(error: ZodError): WhatsAppValidationError {
11
+ const issues = error.issues.map((err) => ({
12
+ path: err.path as readonly (string | number)[],
13
+ message: err.message,
14
+ }));
15
+
16
+ // Use the first error as the main message (Zod orders by importance)
17
+ const firstError = error.issues[0];
18
+ if (firstError) {
19
+ return new WhatsAppValidationError(
20
+ firstError.message,
21
+ typeof firstError.path[0] === "string" ? firstError.path[0] : undefined,
22
+ issues
23
+ );
24
+ }
25
+
26
+ // Fallback (shouldn't happen)
27
+ return new WhatsAppValidationError("Validation failed", undefined, issues);
28
+ }
package/tsconfig.json CHANGED
@@ -1,5 +1,7 @@
1
1
  {
2
2
  // Visit https://aka.ms/tsconfig to read more about this file
3
+ "include": ["src/**/*"],
4
+ "exclude": ["node_modules", "dist", "examples"],
3
5
  "compilerOptions": {
4
6
  // File Layout
5
7
  "rootDir": "./src",
@@ -7,12 +9,12 @@
7
9
 
8
10
  // Environment Settings
9
11
  // See also https://aka.ms/tsconfig/module
10
- "module": "nodenext",
12
+ "module": "esnext",
13
+ "moduleResolution": "bundler",
11
14
  "target": "esnext",
12
- "types": [],
13
15
  // For nodejs:
14
- // "lib": ["esnext"],
15
- // "types": ["node"],
16
+ "lib": ["esnext"],
17
+ "types": ["node"],
16
18
  // and npm install -D @types/node
17
19
 
18
20
  // Other Outputs