@warriorteam/messenger-sdk 1.0.0

package/README.md

@@ -0,0 +1,261 @@
+# @warriorteam/messenger-sdk
+
+A modern TypeScript SDK for the Facebook Messenger Platform API, designed with simplicity and type safety in mind.
+
+## Features
+
+- 🚀 **Zero runtime dependencies** - Built with native fetch
+- 📝 **Full TypeScript support** - Complete type definitions
+- 🔄 **Dual module support** - ESM and CommonJS
+- ✅ **Comprehensive validation** - Built-in message and template validation
+- 🛡️ **Error handling** - Detailed error types and messages
+- 📚 **Complete API coverage** - Send API, Templates, Attachments, Moderation
+
+## Installation
+
+```bash
+npm install @warriorteam/messenger-sdk
+```
+
+## Requirements
+
+- Node.js 18+ (for native fetch support)
+- A Facebook Page Access Token
+
+## Quick Start
+
+```typescript
+import { Messenger } from '@warriorteam/messenger-sdk';
+
+const messenger = new Messenger({
+  accessToken: 'YOUR_PAGE_ACCESS_TOKEN',
+  version: 'v23.0'
+});
+
+// Send a text message
+const result = await messenger.send.message({
+  recipient: { id: 'USER_PSID' },
+  message: { text: 'Hello from RedAI Messenger SDK!' }
+});
+
+console.log('Message sent:', result.message_id);
+```
+
+## API Reference
+
+### Client Configuration
+
+```typescript
+const messenger = new Messenger({
+  accessToken: string;    // Required: Your page access token
+  version?: string;       // Optional: API version (default: 'v23.0')
+  baseUrl?: string;       // Optional: Custom base URL
+  timeout?: number;       // Optional: Request timeout in ms (default: 30000)
+  maxRetries?: number;    // Optional: Max retry attempts (default: 3)
+});
+```
+
+### Send API
+
+#### Send Text Message
+
+```typescript
+await messenger.send.message({
+  recipient: { id: 'USER_PSID' },
+  message: { text: 'Hello World!' }
+});
+```
+
+#### Send Message with Quick Replies
+
+```typescript
+await messenger.send.message({
+  recipient: { id: 'USER_PSID' },
+  message: {
+    text: 'Pick a color:',
+    quick_replies: [
+      { content_type: 'text', title: 'Red', payload: 'PICKED_RED' },
+      { content_type: 'text', title: 'Blue', payload: 'PICKED_BLUE' }
+    ]
+  }
+});
+```
+
+#### Send Typing Indicators
+
+```typescript
+await messenger.send.typingOn('USER_PSID');
+await messenger.send.typingOff('USER_PSID');
+await messenger.send.markSeen('USER_PSID');
+```
+
+#### Response Format
+
+The Send API response includes a `message_id` and optionally a `recipient_id`:
+
+```typescript
+const result = await messenger.send.message({...});
+console.log('Message ID:', result.message_id); // Always present
+console.log('Recipient ID:', result.recipient_id || 'Not provided'); // Optional
+```
+
+**Note**: `recipient_id` is only included when using `recipient.id` (PSID). It's not included when using `recipient.user_ref` or `recipient.phone_number`.
+
+### Attachments API
+
+#### Upload Attachment from URL
+
+```typescript
+const attachment = await messenger.attachments.upload({
+  type: 'image',
+  url: 'https://example.com/image.jpg',
+  is_reusable: true
+});
+
+// Use the attachment ID to send
+await messenger.send.message({
+  recipient: { id: 'USER_PSID' },
+  message: {
+    attachment: {
+      type: 'image',
+      payload: { attachment_id: attachment.attachment_id }
+    }
+  }
+});
+```
+
+#### Send Attachment Directly
+
+```typescript
+await messenger.send.message({
+  recipient: { id: 'USER_PSID' },
+  message: {
+    attachment: {
+      type: 'image',
+      payload: { url: 'https://example.com/image.jpg' }
+    }
+  }
+});
+```
+
+### Templates API
+
+#### Generic Template
+
+```typescript
+await messenger.templates.generic({
+  recipient: { id: 'USER_PSID' },
+  elements: [{
+    title: 'Welcome',
+    subtitle: 'Check out our products',
+    image_url: 'https://example.com/image.jpg',
+    buttons: [{
+      type: 'web_url',
+      title: 'Shop Now',
+      url: 'https://example.com/shop'
+    }]
+  }]
+});
+```
+
+#### Button Template
+
+```typescript
+await messenger.templates.button({
+  recipient: { id: 'USER_PSID' },
+  text: 'What would you like to do?',
+  buttons: [{
+    type: 'postback',
+    title: 'Get Started',
+    payload: 'GET_STARTED'
+  }]
+});
+```
+
+### Moderation API
+
+#### User Moderation
+
+```typescript
+// Block a user from messaging (can still see page content)
+await messenger.moderation.blockUser('USER_PSID');
+
+// Ban a user completely (no messaging + no Facebook interactions)
+await messenger.moderation.banUser('USER_PSID');
+
+// Move conversation to spam folder
+await messenger.moderation.moveToSpam('USER_PSID');
+
+// Block and spam (common combo)
+await messenger.moderation.blockAndSpam('USER_PSID');
+
+// Multiple users at once
+await messenger.moderation.blockUser(['USER_1', 'USER_2', 'USER_3']);
+
+// Unblock/unban users
+await messenger.moderation.unblockUser('USER_PSID');
+await messenger.moderation.unbanUser('USER_PSID');
+```
+
+## Error Handling
+
+The SDK provides specific error types for different scenarios:
+
+```typescript
+import { 
+  MessengerAPIError, 
+  MessengerNetworkError, 
+  MessengerTimeoutError,
+  MessengerConfigError 
+} from '@warriorteam/messenger-sdk';
+
+try {
+  await messenger.send.message({
+    recipient: { id: 'USER_PSID' },
+    message: { text: 'Hello!' }
+  });
+} catch (error) {
+  if (error instanceof MessengerAPIError) {
+    console.error('API Error:', error.message, error.code);
+  } else if (error instanceof MessengerNetworkError) {
+    console.error('Network Error:', error.message);
+  } else if (error instanceof MessengerTimeoutError) {
+    console.error('Timeout Error:', error.timeout);
+  }
+}
+```
+
+## Examples
+
+Check the `examples/` directory for complete usage examples:
+
+- `send-message.ts` - Basic message sending
+- `upload-attachment.ts` - Attachment handling
+- `send-template.ts` - Template messages
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+
+# Format code
+npm run format
+```
+
+## License
+
+MIT
+
+## Support
+
+For issues and questions, please visit our [GitHub repository](https://github.com/warriorteam/messenger-sdk).

package/dist/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var f="v23.0",R="https://graph.facebook.com";var p={MESSAGES:"/me/messages",MESSAGE_ATTACHMENTS:"/me/message_attachments",MODERATE_CONVERSATIONS:"/me/moderate_conversations"},E={TEXT_MESSAGE_MAX_CHARS:2e3},U={IMAGE_MAX_SIZE:8*1024*1024,OTHER_MAX_SIZE:25*1024*1024,VIDEO_TIMEOUT:75,OTHER_TIMEOUT:10},o={GENERIC_ELEMENTS_MAX:10,GENERIC_TITLE_MAX_CHARS:80,GENERIC_SUBTITLE_MAX_CHARS:80,BUTTON_TEXT_MAX_CHARS:640,BUTTONS_MAX_COUNT:3,BUTTON_TITLE_MAX_CHARS:20,POSTBACK_PAYLOAD_MAX_CHARS:1e3,MEDIA_ELEMENTS_COUNT:1,MEDIA_BUTTONS_MAX_COUNT:3};var c=class extends Error{code;type;subcode;fbtrace_id;statusCode;response;constructor(e,s,r){super(e.message),this.name="MessengerAPIError",this.code=e.code,this.type=e.type,this.subcode=e.error_subcode,this.fbtrace_id=e.fbtrace_id,this.statusCode=s,this.response=r;}},l=class extends Error{cause;constructor(e,s){super(e),this.name="MessengerNetworkError",this.cause=s;}},u=class extends Error{timeout;constructor(e){super(`Request timed out after ${e}ms`),this.name="MessengerTimeoutError",this.timeout=e;}},m=class extends Error{constructor(e){super(e),this.name="MessengerConfigError";}};var S=class{config;constructor(e){this.config={accessToken:e.accessToken,version:e.version,baseUrl:e.baseUrl||R,timeout:e.timeout||3e4,maxRetries:e.maxRetries||3};}async request(e){let s=this.buildUrl(e.path,e.query),r;for(let i=0;i<=this.config.maxRetries;i++)try{let a=await this.makeRequest(s,e);return await this.handleResponse(a)}catch(a){if(r=a,a instanceof c&&a.statusCode>=400&&a.statusCode<500||i===this.config.maxRetries)throw a;await this.delay(1e3*(i+1));}throw r||new Error("Unknown error occurred")}buildUrl(e,s){let r=new URL(`${this.config.baseUrl}/${this.config.version}${e}`);return r.searchParams.append("access_token",this.config.accessToken),s&&Object.entries(s).forEach(([i,a])=>{r.searchParams.append(i,String(a));}),r.toString()}async makeRequest(e,s){let r=new AbortController,i=setTimeout(()=>r.abort(),this.config.timeout);try{let a={method:s.method,headers:{"Content-Type":"application/json"},signal:r.signal};return s.body&&(a.body=JSON.stringify(s.body)),await fetch(e,a)}catch(a){throw a instanceof Error?a.name==="AbortError"?new u(this.config.timeout):new l(`Network request failed: ${a.message}`,a):a}finally{clearTimeout(i);}}async handleResponse(e){let r=e.headers.get("content-type")?.includes("application/json");if(!e.ok)if(r){let i=await e.json();throw new c(i.error,e.status,i)}else {let i=await e.text();throw new c({message:i||`HTTP ${e.status} ${e.statusText}`,type:"http_error",code:e.status,fbtrace_id:""},e.status,i)}return r?await e.json():await e.text()}delay(e){return new Promise(s=>setTimeout(s,e))}};var T=class extends Error{constructor(e){super(e),this.name="MessageValidationError";}};function P(t){if(!t||t.trim()==="")throw new T("Text message cannot be empty");if(t.length>E.TEXT_MESSAGE_MAX_CHARS)throw new T(`Text message cannot exceed ${E.TEXT_MESSAGE_MAX_CHARS} characters`)}var d=class{constructor(e){this.httpClient=e;}async message(e){return e.message?.text&&P(e.message.text),this.httpClient.request({method:"POST",path:p.MESSAGES,body:e})}async action(e,s){return this.httpClient.request({method:"POST",path:p.MESSAGES,body:{recipient:{id:e},messaging_type:"RESPONSE",sender_action:s}})}async typingOn(e){return this.action(e,"typing_on")}async typingOff(e){return this.action(e,"typing_off")}async markSeen(e){return this.action(e,"mark_seen")}async attachment(e){return this.message({recipient:e.recipient,messaging_type:e.messaging_type??"RESPONSE",message:{attachment:{type:e.type,payload:{attachment_id:e.attachment_id}}}})}async attachmentFromUrl(e){return this.message({recipient:e.recipient,messaging_type:e.messaging_type??"RESPONSE",message:{attachment:{type:e.type,payload:{url:e.url}}}})}};var _=class{constructor(e){this.httpClient=e;}async upload(e){let s={message:{attachment:{type:e.type,payload:{url:e.url,is_reusable:e.is_reusable??true}}}};return this.httpClient.request({method:"POST",path:p.MESSAGE_ATTACHMENTS,body:s})}};var h=class{constructor(e){this.httpClient=e;}async moderate(e){return this.httpClient.request({method:"POST",path:p.MODERATE_CONVERSATIONS,body:e})}async blockUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["block_user"]})}async unblockUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["unblock_user"]})}async banUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["ban_user"]})}async unbanUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["unban_user"]})}async moveToSpam(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["move_to_spam"]})}async blockAndSpam(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["block_user","move_to_spam"]})}};var n=class extends Error{constructor(e){super(e),this.name="TemplateValidationError";}};function b(t){if(t.length===0)throw new n("Generic template must have at least 1 element");if(t.length>o.GENERIC_ELEMENTS_MAX)throw new n(`Generic template cannot have more than ${o.GENERIC_ELEMENTS_MAX} elements`);t.forEach((e,s)=>{I(e,s);});}function I(t,e){if(!t.title||t.title.trim()==="")throw new n(`Element ${e}: title is required`);if(t.title.length>o.GENERIC_TITLE_MAX_CHARS)throw new n(`Element ${e}: title cannot exceed ${o.GENERIC_TITLE_MAX_CHARS} characters`);if(t.subtitle&&t.subtitle.length>o.GENERIC_SUBTITLE_MAX_CHARS)throw new n(`Element ${e}: subtitle cannot exceed ${o.GENERIC_SUBTITLE_MAX_CHARS} characters`);if(t.image_url&&!y(t.image_url))throw new n(`Element ${e}: image_url must be HTTPS`);if(t.buttons&&A(t.buttons,`Element ${e}`),!!!(t.subtitle||t.image_url||t.default_action||t.buttons&&t.buttons.length>0))throw new n(`Element ${e}: must have at least one additional property beyond title`)}function w(t,e){if(!t||t.trim()==="")throw new n("Button template text is required");if(t.length>o.BUTTON_TEXT_MAX_CHARS)throw new n(`Button template text cannot exceed ${o.BUTTON_TEXT_MAX_CHARS} characters`);if(e.length===0)throw new n("Button template must have at least 1 button");A(e,"Button template");}function C(t){if(!t.media_type)throw new n("Media template element must have media_type");if(!t.url&&!t.attachment_id)throw new n("Media template element must have either url or attachment_id");if(t.url&&t.attachment_id)throw new n("Media template element cannot have both url and attachment_id");if(t.url&&!y(t.url))throw new n("Media template url must be HTTPS");if(t.buttons){if(t.buttons.length>o.MEDIA_BUTTONS_MAX_COUNT)throw new n(`Media template cannot have more than ${o.MEDIA_BUTTONS_MAX_COUNT} buttons`);A(t.buttons,"Media template");}}function A(t,e){if(t.length>o.BUTTONS_MAX_COUNT)throw new n(`${e} cannot have more than ${o.BUTTONS_MAX_COUNT} buttons`);t.forEach((s,r)=>{x(s,`${e} button ${r}`);});}function x(t,e){if(!t.type)throw new n(`${e}: type is required`);if(t.type!=="account_unlink"&&(!t.title||t.title.trim()===""))throw new n(`${e}: title is required for ${t.type} buttons`);if(t.title&&t.title.length>o.BUTTON_TITLE_MAX_CHARS)throw new n(`${e}: title cannot exceed ${o.BUTTON_TITLE_MAX_CHARS} characters`);switch(t.type){case "web_url":if(!t.url)throw new n(`${e}: url is required for web_url buttons`);if(!y(t.url))throw new n(`${e}: url must be HTTPS for web_url buttons`);break;case "postback":if(!t.payload)throw new n(`${e}: payload is required for postback buttons`);if(t.payload.length>o.POSTBACK_PAYLOAD_MAX_CHARS)throw new n(`${e}: payload cannot exceed ${o.POSTBACK_PAYLOAD_MAX_CHARS} characters`);break;case "phone_number":if(!t.payload)throw new n(`${e}: payload is required for phone_number buttons`);if(!t.payload.startsWith("+"))throw new n(`${e}: phone_number payload must start with + (e.g., +1234567890)`);break;case "game_play":break;case "account_link":if(!t.url)throw new n(`${e}: url is required for account_link buttons`);if(!y(t.url))throw new n(`${e}: url must be HTTPS for account_link buttons`);break;}if(t.type==="web_url"&&t.messenger_extensions&&t.fallback_url&&!y(t.fallback_url))throw new n(`${e}: fallback_url must be HTTPS`)}function y(t){try{return new URL(t).protocol==="https:"}catch{return  false}}var g=class{constructor(e){this.httpClient=e;}async generic(e){b(e.elements);let s={template_type:"generic",elements:e.elements,image_aspect_ratio:e.image_aspect_ratio},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}async button(e){w(e.text,e.buttons);let s={template_type:"button",text:e.text,buttons:e.buttons},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}async media(e){C(e.element);let s={template_type:"media",elements:[e.element]},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}async product(e){let s={template_type:"product",elements:e.elements},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}};var M=class{send;attachments;moderation;templates;httpClient;constructor(e){this.validateConfig(e);let s={accessToken:e.accessToken,version:e.version||f,baseUrl:e.baseUrl,timeout:e.timeout,maxRetries:e.maxRetries};this.httpClient=new S(s),this.send=new d(this.httpClient),this.attachments=new _(this.httpClient),this.moderation=new h(this.httpClient),this.templates=new g(this.httpClient);}validateConfig(e){if(!e.accessToken)throw new m("Access token is required");if(typeof e.accessToken!="string"||e.accessToken.trim()==="")throw new m("Access token must be a non-empty string");if(e.version&&typeof e.version!="string")throw new m("API version must be a string");if(e.timeout&&(typeof e.timeout!="number"||e.timeout<=0))throw new m("Timeout must be a positive number");if(e.maxRetries&&(typeof e.maxRetries!="number"||e.maxRetries<0))throw new m("Max retries must be a non-negative number")}};
+exports.ATTACHMENT_LIMITS=U;exports.AttachmentsAPI=_;exports.MESSAGE_LIMITS=E;exports.MessageValidationError=T;exports.Messenger=M;exports.MessengerAPIError=c;exports.MessengerConfigError=m;exports.MessengerNetworkError=l;exports.MessengerTimeoutError=u;exports.ModerationAPI=h;exports.SendAPI=d;exports.TEMPLATE_LIMITS=o;exports.TemplateValidationError=n;exports.TemplatesAPI=g;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/constants.ts","../src/core/errors.ts","../src/core/http-client.ts","../src/utils/message-validators.ts","../src/resources/send.ts","../src/resources/attachments.ts","../src/resources/moderation.ts","../src/utils/validators.ts","../src/resources/templates.ts","../src/client.ts"],"names":["DEFAULT_API_VERSION","BASE_URL","API_ENDPOINTS","MESSAGE_LIMITS","ATTACHMENT_LIMITS","TEMPLATE_LIMITS","MessengerAPIError","error","statusCode","response","MessengerNetworkError","message","cause","MessengerTimeoutError","timeout","MessengerConfigError","HTTPClient","config","options","url","lastError","attempt","path","query","key","value","controller","timeoutId","fetchOptions","isJson","errorData","text","ms","resolve","MessageValidationError","validateTextMessage","SendAPI","httpClient","request","recipientId","action","AttachmentsAPI","body","ModerationAPI","userIds","user_ids","id","TemplateValidationError","validateGenericTemplate","elements","element","index","validateGenericElement","isHttpsUrl","validateButtons","validateButtonTemplate","buttons","validateMediaTemplate","context","button","validateButton","TemplatesAPI","payload","Messenger","clientConfig"],"mappings":"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","file":"index.cjs","sourcesContent":["export const DEFAULT_API_VERSION = 'v23.0';\nexport const BASE_URL = 'https://graph.facebook.com';\nexport const DEFAULT_TIMEOUT = 30000; // 30 seconds\nexport const MAX_RETRY_ATTEMPTS = 3;\nexport const RETRY_DELAY_MS = 1000;\n\nexport const API_ENDPOINTS = {\n  MESSAGES: '/me/messages',\n  MESSAGE_ATTACHMENTS: '/me/message_attachments',\n  MODERATE_CONVERSATIONS: '/me/moderate_conversations',\n  PASS_THREAD_CONTROL: '/me/pass_thread_control',\n  TAKE_THREAD_CONTROL: '/me/take_thread_control',\n  REQUEST_THREAD_CONTROL: '/me/request_thread_control',\n} as const;\n\n// Validation constants\nexport const MESSAGE_LIMITS = {\n  // Text messages\n  TEXT_MESSAGE_MAX_CHARS: 2000,\n} as const;\n\nexport const ATTACHMENT_LIMITS = {\n  // File size limits in bytes\n  IMAGE_MAX_SIZE: 8 * 1024 * 1024, // 8MB\n  OTHER_MAX_SIZE: 25 * 1024 * 1024, // 25MB (video, audio, file)\n  \n  // Timeout limits in seconds\n  VIDEO_TIMEOUT: 75,\n  OTHER_TIMEOUT: 10,\n} as const;\n\nexport const TEMPLATE_LIMITS = {\n  // Generic Template\n  GENERIC_ELEMENTS_MAX: 10,\n  GENERIC_TITLE_MAX_CHARS: 80,\n  GENERIC_SUBTITLE_MAX_CHARS: 80,\n  \n  // Button Template  \n  BUTTON_TEXT_MAX_CHARS: 640,\n  BUTTONS_MAX_COUNT: 3,\n  BUTTON_TITLE_MAX_CHARS: 20,\n  \n  // All Templates\n  POSTBACK_PAYLOAD_MAX_CHARS: 1000,\n  \n  // Media Template\n  MEDIA_ELEMENTS_COUNT: 1, // Exactly 1 element required\n  MEDIA_BUTTONS_MAX_COUNT: 3,\n} as const;","import type { MessengerError } from '../types/responses.js';\n\nexport class MessengerAPIError extends Error {\n  public readonly code: number;\n  public readonly type: string;\n  public readonly subcode?: number;\n  public readonly fbtrace_id?: string;\n  public readonly statusCode: number;\n  public readonly response?: any;\n\n  constructor(error: MessengerError, statusCode: number, response?: any) {\n    super(error.message);\n    this.name = 'MessengerAPIError';\n    this.code = error.code;\n    this.type = error.type;\n    this.subcode = error.error_subcode;\n    this.fbtrace_id = error.fbtrace_id;\n    this.statusCode = statusCode;\n    this.response = response;\n  }\n}\n\nexport class MessengerNetworkError extends Error {\n  public readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = 'MessengerNetworkError';\n    this.cause = cause;\n  }\n}\n\nexport class MessengerTimeoutError extends Error {\n  public readonly timeout: number;\n\n  constructor(timeout: number) {\n    super(`Request timed out after ${timeout}ms`);\n    this.name = 'MessengerTimeoutError';\n    this.timeout = timeout;\n  }\n}\n\nexport class MessengerConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'MessengerConfigError';\n  }\n}","import { BASE_URL, DEFAULT_TIMEOUT, MAX_RETRY_ATTEMPTS, RETRY_DELAY_MS } from './constants.js';\nimport { MessengerAPIError, MessengerNetworkError, MessengerTimeoutError } from './errors.js';\nimport type { ErrorResponse } from '../types/responses.js';\n\nexport interface ClientConfig {\n  accessToken: string;\n  version: string;\n  baseUrl?: string;\n  timeout?: number;\n  maxRetries?: number;\n}\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST' | 'DELETE';\n  path: string;\n  body?: any;\n  query?: Record<string, string | number | boolean>;\n}\n\nexport class HTTPClient {\n  private readonly config: Required<ClientConfig>;\n\n  constructor(config: ClientConfig) {\n    this.config = {\n      accessToken: config.accessToken,\n      version: config.version,\n      baseUrl: config.baseUrl || BASE_URL,\n      timeout: config.timeout || DEFAULT_TIMEOUT,\n      maxRetries: config.maxRetries || MAX_RETRY_ATTEMPTS,\n    };\n  }\n\n  async request<T>(options: RequestOptions): Promise<T> {\n    const url = this.buildUrl(options.path, options.query);\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {\n      try {\n        const response = await this.makeRequest(url, options);\n        return await this.handleResponse<T>(response);\n      } catch (error) {\n        lastError = error as Error;\n        \n        // Don't retry on client errors (4xx)\n        if (error instanceof MessengerAPIError && error.statusCode >= 400 && error.statusCode < 500) {\n          throw error;\n        }\n\n        // Don't retry on timeout for the last attempt\n        if (attempt === this.config.maxRetries) {\n          throw error;\n        }\n\n        // Wait before retrying\n        await this.delay(RETRY_DELAY_MS * (attempt + 1));\n      }\n    }\n\n    throw lastError || new Error('Unknown error occurred');\n  }\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean>): string {\n    const url = new URL(`${this.config.baseUrl}/${this.config.version}${path}`);\n    \n    // Always add access token\n    url.searchParams.append('access_token', this.config.accessToken);\n    \n    // Add additional query parameters\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        url.searchParams.append(key, String(value));\n      });\n    }\n\n    return url.toString();\n  }\n\n  private async makeRequest(url: string, options: RequestOptions): Promise<Response> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const fetchOptions: RequestInit = {\n        method: options.method,\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        signal: controller.signal,\n      };\n\n      if (options.body) {\n        fetchOptions.body = JSON.stringify(options.body);\n      }\n\n      const response = await fetch(url, fetchOptions);\n      return response;\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          throw new MessengerTimeoutError(this.config.timeout);\n        }\n        throw new MessengerNetworkError(`Network request failed: ${error.message}`, error);\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private async handleResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    const isJson = contentType?.includes('application/json');\n\n    if (!response.ok) {\n      if (isJson) {\n        const errorData = await response.json() as ErrorResponse;\n        throw new MessengerAPIError(errorData.error, response.status, errorData);\n      } else {\n        const text = await response.text();\n        throw new MessengerAPIError(\n          {\n            message: text || `HTTP ${response.status} ${response.statusText}`,\n            type: 'http_error',\n            code: response.status,\n            fbtrace_id: '',\n          },\n          response.status,\n          text\n        );\n      }\n    }\n\n    if (isJson) {\n      return await response.json() as T;\n    }\n\n    // For non-JSON responses, return the text\n    return await response.text() as unknown as T;\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n  }\n}","import { MESSAGE_LIMITS } from '../core/constants.js';\n\nexport class MessageValidationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'MessageValidationError';\n  }\n}\n\nexport function validateTextMessage(text: string): void {\n  if (!text || text.trim() === '') {\n    throw new MessageValidationError('Text message cannot be empty');\n  }\n\n  if (text.length > MESSAGE_LIMITS.TEXT_MESSAGE_MAX_CHARS) {\n    throw new MessageValidationError(\n      `Text message cannot exceed ${MESSAGE_LIMITS.TEXT_MESSAGE_MAX_CHARS} characters`\n    );\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { SendMessageRequest, SenderAction, Recipient } from '../types/messages.js';\nimport type { SendMessageResponse } from '../types/responses.js';\nimport type { AttachmentType } from '../types/attachments.js';\nimport { validateTextMessage } from '../utils/message-validators.js';\n\nexport class SendAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  async message(request: SendMessageRequest): Promise<SendMessageResponse> {\n    // Validate text message length if present\n    if (request.message?.text) {\n      validateTextMessage(request.message.text);\n    }\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async action(recipientId: string, action: SenderAction): Promise<SendMessageResponse> {\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: {\n        recipient: { id: recipientId },\n        messaging_type: 'RESPONSE',\n        sender_action: action,\n      },\n    });\n  }\n\n  async typingOn(recipientId: string): Promise<SendMessageResponse> {\n    return this.action(recipientId, 'typing_on');\n  }\n\n  async typingOff(recipientId: string): Promise<SendMessageResponse> {\n    return this.action(recipientId, 'typing_off');\n  }\n\n  async markSeen(recipientId: string): Promise<SendMessageResponse> {\n    return this.action(recipientId, 'mark_seen');\n  }\n\n  // Convenience methods for sending attachments\n\n  /**\n   * Send an attachment using a previously uploaded attachment_id\n   */\n  async attachment(options: {\n    recipient: Recipient;\n    type: AttachmentType;\n    attachment_id: string;\n    messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';\n  }): Promise<SendMessageResponse> {\n    return this.message({\n      recipient: options.recipient,\n      messaging_type: options.messaging_type ?? 'RESPONSE',\n      message: {\n        attachment: {\n          type: options.type,\n          payload: {\n            attachment_id: options.attachment_id,\n          },\n        },\n      },\n    });\n  }\n\n  /**\n   * Upload and send an attachment from URL in a single request\n   */\n  async attachmentFromUrl(options: {\n    recipient: Recipient;\n    type: AttachmentType;\n    url: string;\n    messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';\n  }): Promise<SendMessageResponse> {\n    return this.message({\n      recipient: options.recipient,\n      messaging_type: options.messaging_type ?? 'RESPONSE',\n      message: {\n        attachment: {\n          type: options.type,\n          payload: {\n            url: options.url,\n          },\n        },\n      },\n    });\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { AttachmentUploadRequest, AttachmentUploadResponse } from '../types/attachments.js';\n\nexport class AttachmentsAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  async upload(request: AttachmentUploadRequest): Promise<AttachmentUploadResponse> {\n    // Format according to official API - no message wrapper needed\n    const body = {\n      message: {\n        attachment: {\n          type: request.type,\n          payload: {\n            url: request.url,\n            is_reusable: request.is_reusable ?? true,\n          },\n        },\n      },\n    };\n\n    return this.httpClient.request<AttachmentUploadResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGE_ATTACHMENTS,\n      body,\n    });\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { \n  ModerateConversationsRequest,\n  ModerateConversationsResponse\n} from '../types/moderation.js';\n\nexport class ModerationAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  /**\n   * Moderate conversations with specified actions\n   * Up to 10 user IDs and up to 2 actions per request\n   */\n  async moderate(request: ModerateConversationsRequest): Promise<ModerateConversationsResponse> {\n    return this.httpClient.request<ModerateConversationsResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MODERATE_CONVERSATIONS,\n      body: request,\n    });\n  }\n\n  /**\n   * Block a user from messaging the page\n   * Prevents messaging but user can still interact with page content on Facebook\n   */\n  async blockUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds) \n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['block_user'],\n    });\n  }\n\n  /**\n   * Unblock a user to allow messaging again\n   */\n  async unblockUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['unblock_user'],\n    });\n  }\n\n  /**\n   * Ban a user from both messaging and Facebook interactions\n   * More restrictive than blocking - prevents all interactions\n   * Note: Cannot ban user who was unbanned in last 48 hours\n   */\n  async banUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['ban_user'],\n    });\n  }\n\n  /**\n   * Unban a user to restore all interactions\n   * Note: Banned user cannot be unblocked, they must be unbanned first\n   */\n  async unbanUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['unban_user'],\n    });\n  }\n\n  /**\n   * Move conversation to spam folder in Meta Business Suite Inbox\n   */\n  async moveToSpam(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['move_to_spam'],\n    });\n  }\n\n  /**\n   * Block user and move to spam (common moderation action)\n   */\n  async blockAndSpam(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['block_user', 'move_to_spam'],\n    });\n  }\n}","import { TEMPLATE_LIMITS } from '../core/constants.js';\nimport type { Button, GenericTemplateElement, MediaTemplateElement } from '../types/templates.js';\n\nexport class TemplateValidationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TemplateValidationError';\n  }\n}\n\nexport function validateGenericTemplate(elements: GenericTemplateElement[]): void {\n  if (elements.length === 0) {\n    throw new TemplateValidationError('Generic template must have at least 1 element');\n  }\n\n  if (elements.length > TEMPLATE_LIMITS.GENERIC_ELEMENTS_MAX) {\n    throw new TemplateValidationError(\n      `Generic template cannot have more than ${TEMPLATE_LIMITS.GENERIC_ELEMENTS_MAX} elements`\n    );\n  }\n\n  elements.forEach((element, index) => {\n    validateGenericElement(element, index);\n  });\n}\n\nexport function validateGenericElement(element: GenericTemplateElement, index: number): void {\n  if (!element.title || element.title.trim() === '') {\n    throw new TemplateValidationError(`Element ${index}: title is required`);\n  }\n\n  if (element.title.length > TEMPLATE_LIMITS.GENERIC_TITLE_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `Element ${index}: title cannot exceed ${TEMPLATE_LIMITS.GENERIC_TITLE_MAX_CHARS} characters`\n    );\n  }\n\n  if (element.subtitle && element.subtitle.length > TEMPLATE_LIMITS.GENERIC_SUBTITLE_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `Element ${index}: subtitle cannot exceed ${TEMPLATE_LIMITS.GENERIC_SUBTITLE_MAX_CHARS} characters`\n    );\n  }\n\n  if (element.image_url && !isHttpsUrl(element.image_url)) {\n    throw new TemplateValidationError(`Element ${index}: image_url must be HTTPS`);\n  }\n\n  if (element.buttons) {\n    validateButtons(element.buttons, `Element ${index}`);\n  }\n\n  // Validate that element has at least one property beyond title\n  const hasAdditionalProperty = !!(\n    element.subtitle ||\n    element.image_url ||\n    element.default_action ||\n    (element.buttons && element.buttons.length > 0)\n  );\n\n  if (!hasAdditionalProperty) {\n    throw new TemplateValidationError(\n      `Element ${index}: must have at least one additional property beyond title`\n    );\n  }\n}\n\nexport function validateButtonTemplate(text: string, buttons: Button[]): void {\n  if (!text || text.trim() === '') {\n    throw new TemplateValidationError('Button template text is required');\n  }\n\n  if (text.length > TEMPLATE_LIMITS.BUTTON_TEXT_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `Button template text cannot exceed ${TEMPLATE_LIMITS.BUTTON_TEXT_MAX_CHARS} characters`\n    );\n  }\n\n  if (buttons.length === 0) {\n    throw new TemplateValidationError('Button template must have at least 1 button');\n  }\n\n  validateButtons(buttons, 'Button template');\n}\n\nexport function validateMediaTemplate(element: MediaTemplateElement): void {\n  if (!element.media_type) {\n    throw new TemplateValidationError('Media template element must have media_type');\n  }\n\n  if (!element.url && !element.attachment_id) {\n    throw new TemplateValidationError('Media template element must have either url or attachment_id');\n  }\n\n  if (element.url && element.attachment_id) {\n    throw new TemplateValidationError(\n      'Media template element cannot have both url and attachment_id'\n    );\n  }\n\n  if (element.url && !isHttpsUrl(element.url)) {\n    throw new TemplateValidationError('Media template url must be HTTPS');\n  }\n\n  if (element.buttons) {\n    if (element.buttons.length > TEMPLATE_LIMITS.MEDIA_BUTTONS_MAX_COUNT) {\n      throw new TemplateValidationError(\n        `Media template cannot have more than ${TEMPLATE_LIMITS.MEDIA_BUTTONS_MAX_COUNT} buttons`\n      );\n    }\n    validateButtons(element.buttons, 'Media template');\n  }\n}\n\nexport function validateButtons(buttons: Button[], context: string): void {\n  if (buttons.length > TEMPLATE_LIMITS.BUTTONS_MAX_COUNT) {\n    throw new TemplateValidationError(\n      `${context} cannot have more than ${TEMPLATE_LIMITS.BUTTONS_MAX_COUNT} buttons`\n    );\n  }\n\n  buttons.forEach((button, index) => {\n    validateButton(button, `${context} button ${index}`);\n  });\n}\n\nexport function validateButton(button: Button, context: string): void {\n  if (!button.type) {\n    throw new TemplateValidationError(`${context}: type is required`);\n  }\n\n  // Title is required for most button types (not for account_unlink)\n  if (button.type !== 'account_unlink' && (!button.title || button.title.trim() === '')) {\n    throw new TemplateValidationError(`${context}: title is required for ${button.type} buttons`);\n  }\n\n  if (button.title && button.title.length > TEMPLATE_LIMITS.BUTTON_TITLE_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `${context}: title cannot exceed ${TEMPLATE_LIMITS.BUTTON_TITLE_MAX_CHARS} characters`\n    );\n  }\n\n  // Type-specific validations\n  switch (button.type) {\n    case 'web_url':\n      if (!button.url) {\n        throw new TemplateValidationError(`${context}: url is required for web_url buttons`);\n      }\n      if (!isHttpsUrl(button.url)) {\n        throw new TemplateValidationError(`${context}: url must be HTTPS for web_url buttons`);\n      }\n      break;\n\n    case 'postback':\n      if (!button.payload) {\n        throw new TemplateValidationError(`${context}: payload is required for postback buttons`);\n      }\n      if (button.payload.length > TEMPLATE_LIMITS.POSTBACK_PAYLOAD_MAX_CHARS) {\n        throw new TemplateValidationError(\n          `${context}: payload cannot exceed ${TEMPLATE_LIMITS.POSTBACK_PAYLOAD_MAX_CHARS} characters`\n        );\n      }\n      break;\n\n    case 'phone_number':\n      if (!button.payload) {\n        throw new TemplateValidationError(`${context}: payload is required for phone_number buttons`);\n      }\n      // Basic phone number validation (starts with +)\n      if (!button.payload.startsWith('+')) {\n        throw new TemplateValidationError(\n          `${context}: phone_number payload must start with + (e.g., +1234567890)`\n        );\n      }\n      break;\n\n    case 'game_play':\n      // game_play buttons may have optional game_metadata\n      break;\n\n    case 'account_link':\n      if (!button.url) {\n        throw new TemplateValidationError(`${context}: url is required for account_link buttons`);\n      }\n      if (!isHttpsUrl(button.url)) {\n        throw new TemplateValidationError(`${context}: url must be HTTPS for account_link buttons`);\n      }\n      break;\n\n    case 'account_unlink':\n      // account_unlink buttons don't require additional properties\n      break;\n  }\n\n  // Validate webview properties for web_url buttons\n  if (button.type === 'web_url' && button.messenger_extensions && button.fallback_url) {\n    if (!isHttpsUrl(button.fallback_url)) {\n      throw new TemplateValidationError(`${context}: fallback_url must be HTTPS`);\n    }\n  }\n}\n\nfunction isHttpsUrl(url: string): boolean {\n  try {\n    const parsedUrl = new URL(url);\n    return parsedUrl.protocol === 'https:';\n  } catch {\n    return false;\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { Recipient, SendMessageRequest, MessagingType } from '../types/messages.js';\nimport type { SendMessageResponse } from '../types/responses.js';\nimport { validateGenericTemplate, validateButtonTemplate, validateMediaTemplate } from '../utils/validators.js';\nimport type {\n  GenericTemplatePayload,\n  ButtonTemplatePayload,\n  MediaTemplatePayload,\n  ProductTemplatePayload,\n  GenericTemplateElement,\n  Button,\n  MediaTemplateElement,\n  ProductTemplateElement,\n} from '../types/templates.js';\n\nexport class TemplatesAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  async generic(options: {\n    recipient: Recipient;\n    elements: GenericTemplateElement[];\n    messaging_type?: MessagingType;\n    image_aspect_ratio?: 'horizontal' | 'square';\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    // Validate template\n    validateGenericTemplate(options.elements);\n\n    const payload: GenericTemplatePayload = {\n      template_type: 'generic',\n      elements: options.elements,\n      image_aspect_ratio: options.image_aspect_ratio,\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async button(options: {\n    recipient: Recipient;\n    text: string;\n    buttons: Button[];\n    messaging_type?: MessagingType;\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    // Validate template\n    validateButtonTemplate(options.text, options.buttons);\n\n    const payload: ButtonTemplatePayload = {\n      template_type: 'button',\n      text: options.text,\n      buttons: options.buttons,\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async media(options: {\n    recipient: Recipient;\n    element: MediaTemplateElement;\n    messaging_type?: MessagingType;\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    // Validate template\n    validateMediaTemplate(options.element);\n\n    const payload: MediaTemplatePayload = {\n      template_type: 'media',\n      elements: [options.element],\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async product(options: {\n    recipient: Recipient;\n    elements: ProductTemplateElement[];\n    messaging_type?: MessagingType;\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    const payload: ProductTemplatePayload = {\n      template_type: 'product',\n      elements: options.elements,\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n}","import { HTTPClient, type ClientConfig } from './core/http-client.js';\nimport { DEFAULT_API_VERSION } from './core/constants.js';\nimport { MessengerConfigError } from './core/errors.js';\nimport { SendAPI } from './resources/send.js';\nimport { AttachmentsAPI } from './resources/attachments.js';\nimport { ModerationAPI } from './resources/moderation.js';\nimport { TemplatesAPI } from './resources/templates.js';\n\nexport interface MessengerConfig {\n  accessToken: string;\n  version?: string;\n  baseUrl?: string;\n  timeout?: number;\n  maxRetries?: number;\n}\n\nexport class Messenger {\n  public readonly send: SendAPI;\n  public readonly attachments: AttachmentsAPI;\n  public readonly moderation: ModerationAPI;\n  public readonly templates: TemplatesAPI;\n\n  private readonly httpClient: HTTPClient;\n\n  constructor(config: MessengerConfig) {\n    this.validateConfig(config);\n\n    const clientConfig: ClientConfig = {\n      accessToken: config.accessToken,\n      version: config.version || DEFAULT_API_VERSION,\n      baseUrl: config.baseUrl,\n      timeout: config.timeout,\n      maxRetries: config.maxRetries,\n    };\n\n    this.httpClient = new HTTPClient(clientConfig);\n\n    // Initialize API resources\n    this.send = new SendAPI(this.httpClient);\n    this.attachments = new AttachmentsAPI(this.httpClient);\n    this.moderation = new ModerationAPI(this.httpClient);\n    this.templates = new TemplatesAPI(this.httpClient);\n  }\n\n  private validateConfig(config: MessengerConfig): void {\n    if (!config.accessToken) {\n      throw new MessengerConfigError('Access token is required');\n    }\n\n    if (typeof config.accessToken !== 'string' || config.accessToken.trim() === '') {\n      throw new MessengerConfigError('Access token must be a non-empty string');\n    }\n\n    if (config.version && typeof config.version !== 'string') {\n      throw new MessengerConfigError('API version must be a string');\n    }\n\n    if (config.timeout && (typeof config.timeout !== 'number' || config.timeout <= 0)) {\n      throw new MessengerConfigError('Timeout must be a positive number');\n    }\n\n    if (config.maxRetries && (typeof config.maxRetries !== 'number' || config.maxRetries < 0)) {\n      throw new MessengerConfigError('Max retries must be a non-negative number');\n    }\n  }\n}"]}

package/dist/index.d.cts

@@ -0,0 +1,341 @@
+interface ClientConfig {
+    accessToken: string;
+    version: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'DELETE';
+    path: string;
+    body?: any;
+    query?: Record<string, string | number | boolean>;
+}
+declare class HTTPClient {
+    private readonly config;
+    constructor(config: ClientConfig);
+    request<T>(options: RequestOptions): Promise<T>;
+    private buildUrl;
+    private makeRequest;
+    private handleResponse;
+    private delay;
+}
+
+interface Recipient {
+    id?: string;
+    phone_number?: string;
+    user_ref?: string;
+    name?: {
+        first_name: string;
+        last_name: string;
+    };
+}
+interface QuickReply {
+    content_type: 'text' | 'user_phone_number' | 'user_email';
+    title?: string;
+    payload?: string;
+    image_url?: string;
+}
+interface Message {
+    text?: string;
+    attachment?: Attachment;
+    quick_replies?: QuickReply[];
+    metadata?: string;
+}
+interface Attachment {
+    type: 'image' | 'audio' | 'video' | 'file' | 'template';
+    payload: AttachmentPayload | TemplatePayload;
+}
+interface AttachmentPayload {
+    url?: string;
+    attachment_id?: string;
+    is_reusable?: boolean;
+}
+interface TemplatePayload {
+    template_type: 'generic' | 'button' | 'media' | 'product';
+    elements?: any[];
+    buttons?: any[];
+    [key: string]: any;
+}
+type SenderAction = 'mark_seen' | 'typing_on' | 'typing_off';
+type MessagingType = 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';
+interface SendMessageRequest {
+    recipient: Recipient;
+    messaging_type: MessagingType;
+    message?: Message;
+    sender_action?: SenderAction;
+    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+    tag?: string;
+}
+
+interface SendMessageResponse {
+    recipient_id?: string;
+    message_id: string;
+    attachment_id?: string;
+}
+interface MessengerError {
+    message: string;
+    type: string;
+    code: number;
+    error_subcode?: number;
+    fbtrace_id: string;
+}
+interface ErrorResponse {
+    error: MessengerError;
+}
+
+type AttachmentType = 'image' | 'audio' | 'video' | 'file';
+interface AttachmentUploadRequest {
+    type: AttachmentType;
+    url: string;
+    is_reusable?: boolean;
+}
+interface AttachmentUploadResponse {
+    attachment_id: string;
+}
+
+declare class SendAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    message(request: SendMessageRequest): Promise<SendMessageResponse>;
+    action(recipientId: string, action: SenderAction): Promise<SendMessageResponse>;
+    typingOn(recipientId: string): Promise<SendMessageResponse>;
+    typingOff(recipientId: string): Promise<SendMessageResponse>;
+    markSeen(recipientId: string): Promise<SendMessageResponse>;
+    /**
+     * Send an attachment using a previously uploaded attachment_id
+     */
+    attachment(options: {
+        recipient: Recipient;
+        type: AttachmentType;
+        attachment_id: string;
+        messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';
+    }): Promise<SendMessageResponse>;
+    /**
+     * Upload and send an attachment from URL in a single request
+     */
+    attachmentFromUrl(options: {
+        recipient: Recipient;
+        type: AttachmentType;
+        url: string;
+        messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';
+    }): Promise<SendMessageResponse>;
+}
+
+declare class AttachmentsAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    upload(request: AttachmentUploadRequest): Promise<AttachmentUploadResponse>;
+}
+
+interface UserId {
+    id: string;
+}
+type ModerationAction = 'block_user' | 'unblock_user' | 'ban_user' | 'unban_user' | 'move_to_spam';
+interface ModerateConversationsRequest {
+    user_ids: UserId[];
+    actions: ModerationAction[];
+}
+interface ModerateConversationsResponse {
+    result: 'success' | 'failure';
+}
+
+declare class ModerationAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    /**
+     * Moderate conversations with specified actions
+     * Up to 10 user IDs and up to 2 actions per request
+     */
+    moderate(request: ModerateConversationsRequest): Promise<ModerateConversationsResponse>;
+    /**
+     * Block a user from messaging the page
+     * Prevents messaging but user can still interact with page content on Facebook
+     */
+    blockUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Unblock a user to allow messaging again
+     */
+    unblockUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Ban a user from both messaging and Facebook interactions
+     * More restrictive than blocking - prevents all interactions
+     * Note: Cannot ban user who was unbanned in last 48 hours
+     */
+    banUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Unban a user to restore all interactions
+     * Note: Banned user cannot be unblocked, they must be unbanned first
+     */
+    unbanUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Move conversation to spam folder in Meta Business Suite Inbox
+     */
+    moveToSpam(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Block user and move to spam (common moderation action)
+     */
+    blockAndSpam(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+}
+
+interface Button {
+    type: 'web_url' | 'postback' | 'phone_number' | 'game_play' | 'account_link' | 'account_unlink';
+    title?: string;
+    url?: string;
+    payload?: string;
+    webview_height_ratio?: 'compact' | 'tall' | 'full';
+    messenger_extensions?: boolean;
+    fallback_url?: string;
+    webview_share_button?: 'hide' | 'show';
+    game_metadata?: {
+        player_id?: string;
+        context_id?: string;
+    };
+}
+interface DefaultAction {
+    type: 'web_url';
+    url: string;
+    webview_height_ratio?: 'compact' | 'tall' | 'full';
+    messenger_extensions?: boolean;
+    fallback_url?: string;
+    webview_share_button?: 'hide' | 'show';
+}
+interface GenericTemplateElement {
+    title: string;
+    subtitle?: string;
+    image_url?: string;
+    default_action?: DefaultAction;
+    buttons?: Button[];
+}
+interface GenericTemplatePayload {
+    template_type: 'generic';
+    elements: GenericTemplateElement[];
+    image_aspect_ratio?: 'horizontal' | 'square';
+}
+interface ButtonTemplatePayload {
+    template_type: 'button';
+    text: string;
+    buttons: Button[];
+}
+interface MediaTemplateElement {
+    media_type: 'image' | 'video';
+    url?: string;
+    attachment_id?: string;
+    buttons?: Button[];
+    sharable?: boolean;
+}
+interface MediaTemplatePayload {
+    template_type: 'media';
+    elements: [MediaTemplateElement];
+}
+interface ProductTemplateElement {
+    id: string;
+}
+interface ProductTemplatePayload {
+    template_type: 'product';
+    elements: ProductTemplateElement[];
+}
+
+declare class TemplatesAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    generic(options: {
+        recipient: Recipient;
+        elements: GenericTemplateElement[];
+        messaging_type?: MessagingType;
+        image_aspect_ratio?: 'horizontal' | 'square';
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+    button(options: {
+        recipient: Recipient;
+        text: string;
+        buttons: Button[];
+        messaging_type?: MessagingType;
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+    media(options: {
+        recipient: Recipient;
+        element: MediaTemplateElement;
+        messaging_type?: MessagingType;
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+    product(options: {
+        recipient: Recipient;
+        elements: ProductTemplateElement[];
+        messaging_type?: MessagingType;
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+}
+
+interface MessengerConfig {
+    accessToken: string;
+    version?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+declare class Messenger {
+    readonly send: SendAPI;
+    readonly attachments: AttachmentsAPI;
+    readonly moderation: ModerationAPI;
+    readonly templates: TemplatesAPI;
+    private readonly httpClient;
+    constructor(config: MessengerConfig);
+    private validateConfig;
+}
+
+declare class MessengerAPIError extends Error {
+    readonly code: number;
+    readonly type: string;
+    readonly subcode?: number;
+    readonly fbtrace_id?: string;
+    readonly statusCode: number;
+    readonly response?: any;
+    constructor(error: MessengerError, statusCode: number, response?: any);
+}
+declare class MessengerNetworkError extends Error {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+declare class MessengerTimeoutError extends Error {
+    readonly timeout: number;
+    constructor(timeout: number);
+}
+declare class MessengerConfigError extends Error {
+    constructor(message: string);
+}
+
+declare class TemplateValidationError extends Error {
+    constructor(message: string);
+}
+
+declare class MessageValidationError extends Error {
+    constructor(message: string);
+}
+
+declare const MESSAGE_LIMITS: {
+    readonly TEXT_MESSAGE_MAX_CHARS: 2000;
+};
+declare const ATTACHMENT_LIMITS: {
+    readonly IMAGE_MAX_SIZE: number;
+    readonly OTHER_MAX_SIZE: number;
+    readonly VIDEO_TIMEOUT: 75;
+    readonly OTHER_TIMEOUT: 10;
+};
+declare const TEMPLATE_LIMITS: {
+    readonly GENERIC_ELEMENTS_MAX: 10;
+    readonly GENERIC_TITLE_MAX_CHARS: 80;
+    readonly GENERIC_SUBTITLE_MAX_CHARS: 80;
+    readonly BUTTON_TEXT_MAX_CHARS: 640;
+    readonly BUTTONS_MAX_COUNT: 3;
+    readonly BUTTON_TITLE_MAX_CHARS: 20;
+    readonly POSTBACK_PAYLOAD_MAX_CHARS: 1000;
+    readonly MEDIA_ELEMENTS_COUNT: 1;
+    readonly MEDIA_BUTTONS_MAX_COUNT: 3;
+};
+
+export { ATTACHMENT_LIMITS, type AttachmentType, type AttachmentUploadRequest, type AttachmentUploadResponse, AttachmentsAPI, type Button, type ButtonTemplatePayload, type DefaultAction, type ErrorResponse, type GenericTemplateElement, type GenericTemplatePayload, MESSAGE_LIMITS, type MediaTemplateElement, type MediaTemplatePayload, type Message, MessageValidationError, type MessagingType, Messenger, MessengerAPIError, type MessengerConfig, MessengerConfigError, type MessengerError, MessengerNetworkError, MessengerTimeoutError, type ModerateConversationsRequest, type ModerateConversationsResponse, ModerationAPI, type ModerationAction, type ProductTemplateElement, type ProductTemplatePayload, type QuickReply, type Recipient, SendAPI, type SendMessageRequest, type SendMessageResponse, type SenderAction, TEMPLATE_LIMITS, TemplateValidationError, TemplatesAPI, type UserId };

package/dist/index.d.ts

@@ -0,0 +1,341 @@
+interface ClientConfig {
+    accessToken: string;
+    version: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'DELETE';
+    path: string;
+    body?: any;
+    query?: Record<string, string | number | boolean>;
+}
+declare class HTTPClient {
+    private readonly config;
+    constructor(config: ClientConfig);
+    request<T>(options: RequestOptions): Promise<T>;
+    private buildUrl;
+    private makeRequest;
+    private handleResponse;
+    private delay;
+}
+
+interface Recipient {
+    id?: string;
+    phone_number?: string;
+    user_ref?: string;
+    name?: {
+        first_name: string;
+        last_name: string;
+    };
+}
+interface QuickReply {
+    content_type: 'text' | 'user_phone_number' | 'user_email';
+    title?: string;
+    payload?: string;
+    image_url?: string;
+}
+interface Message {
+    text?: string;
+    attachment?: Attachment;
+    quick_replies?: QuickReply[];
+    metadata?: string;
+}
+interface Attachment {
+    type: 'image' | 'audio' | 'video' | 'file' | 'template';
+    payload: AttachmentPayload | TemplatePayload;
+}
+interface AttachmentPayload {
+    url?: string;
+    attachment_id?: string;
+    is_reusable?: boolean;
+}
+interface TemplatePayload {
+    template_type: 'generic' | 'button' | 'media' | 'product';
+    elements?: any[];
+    buttons?: any[];
+    [key: string]: any;
+}
+type SenderAction = 'mark_seen' | 'typing_on' | 'typing_off';
+type MessagingType = 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';
+interface SendMessageRequest {
+    recipient: Recipient;
+    messaging_type: MessagingType;
+    message?: Message;
+    sender_action?: SenderAction;
+    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+    tag?: string;
+}
+
+interface SendMessageResponse {
+    recipient_id?: string;
+    message_id: string;
+    attachment_id?: string;
+}
+interface MessengerError {
+    message: string;
+    type: string;
+    code: number;
+    error_subcode?: number;
+    fbtrace_id: string;
+}
+interface ErrorResponse {
+    error: MessengerError;
+}
+
+type AttachmentType = 'image' | 'audio' | 'video' | 'file';
+interface AttachmentUploadRequest {
+    type: AttachmentType;
+    url: string;
+    is_reusable?: boolean;
+}
+interface AttachmentUploadResponse {
+    attachment_id: string;
+}
+
+declare class SendAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    message(request: SendMessageRequest): Promise<SendMessageResponse>;
+    action(recipientId: string, action: SenderAction): Promise<SendMessageResponse>;
+    typingOn(recipientId: string): Promise<SendMessageResponse>;
+    typingOff(recipientId: string): Promise<SendMessageResponse>;
+    markSeen(recipientId: string): Promise<SendMessageResponse>;
+    /**
+     * Send an attachment using a previously uploaded attachment_id
+     */
+    attachment(options: {
+        recipient: Recipient;
+        type: AttachmentType;
+        attachment_id: string;
+        messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';
+    }): Promise<SendMessageResponse>;
+    /**
+     * Upload and send an attachment from URL in a single request
+     */
+    attachmentFromUrl(options: {
+        recipient: Recipient;
+        type: AttachmentType;
+        url: string;
+        messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';
+    }): Promise<SendMessageResponse>;
+}
+
+declare class AttachmentsAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    upload(request: AttachmentUploadRequest): Promise<AttachmentUploadResponse>;
+}
+
+interface UserId {
+    id: string;
+}
+type ModerationAction = 'block_user' | 'unblock_user' | 'ban_user' | 'unban_user' | 'move_to_spam';
+interface ModerateConversationsRequest {
+    user_ids: UserId[];
+    actions: ModerationAction[];
+}
+interface ModerateConversationsResponse {
+    result: 'success' | 'failure';
+}
+
+declare class ModerationAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    /**
+     * Moderate conversations with specified actions
+     * Up to 10 user IDs and up to 2 actions per request
+     */
+    moderate(request: ModerateConversationsRequest): Promise<ModerateConversationsResponse>;
+    /**
+     * Block a user from messaging the page
+     * Prevents messaging but user can still interact with page content on Facebook
+     */
+    blockUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Unblock a user to allow messaging again
+     */
+    unblockUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Ban a user from both messaging and Facebook interactions
+     * More restrictive than blocking - prevents all interactions
+     * Note: Cannot ban user who was unbanned in last 48 hours
+     */
+    banUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Unban a user to restore all interactions
+     * Note: Banned user cannot be unblocked, they must be unbanned first
+     */
+    unbanUser(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Move conversation to spam folder in Meta Business Suite Inbox
+     */
+    moveToSpam(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+    /**
+     * Block user and move to spam (common moderation action)
+     */
+    blockAndSpam(userIds: string | string[]): Promise<ModerateConversationsResponse>;
+}
+
+interface Button {
+    type: 'web_url' | 'postback' | 'phone_number' | 'game_play' | 'account_link' | 'account_unlink';
+    title?: string;
+    url?: string;
+    payload?: string;
+    webview_height_ratio?: 'compact' | 'tall' | 'full';
+    messenger_extensions?: boolean;
+    fallback_url?: string;
+    webview_share_button?: 'hide' | 'show';
+    game_metadata?: {
+        player_id?: string;
+        context_id?: string;
+    };
+}
+interface DefaultAction {
+    type: 'web_url';
+    url: string;
+    webview_height_ratio?: 'compact' | 'tall' | 'full';
+    messenger_extensions?: boolean;
+    fallback_url?: string;
+    webview_share_button?: 'hide' | 'show';
+}
+interface GenericTemplateElement {
+    title: string;
+    subtitle?: string;
+    image_url?: string;
+    default_action?: DefaultAction;
+    buttons?: Button[];
+}
+interface GenericTemplatePayload {
+    template_type: 'generic';
+    elements: GenericTemplateElement[];
+    image_aspect_ratio?: 'horizontal' | 'square';
+}
+interface ButtonTemplatePayload {
+    template_type: 'button';
+    text: string;
+    buttons: Button[];
+}
+interface MediaTemplateElement {
+    media_type: 'image' | 'video';
+    url?: string;
+    attachment_id?: string;
+    buttons?: Button[];
+    sharable?: boolean;
+}
+interface MediaTemplatePayload {
+    template_type: 'media';
+    elements: [MediaTemplateElement];
+}
+interface ProductTemplateElement {
+    id: string;
+}
+interface ProductTemplatePayload {
+    template_type: 'product';
+    elements: ProductTemplateElement[];
+}
+
+declare class TemplatesAPI {
+    private httpClient;
+    constructor(httpClient: HTTPClient);
+    generic(options: {
+        recipient: Recipient;
+        elements: GenericTemplateElement[];
+        messaging_type?: MessagingType;
+        image_aspect_ratio?: 'horizontal' | 'square';
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+    button(options: {
+        recipient: Recipient;
+        text: string;
+        buttons: Button[];
+        messaging_type?: MessagingType;
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+    media(options: {
+        recipient: Recipient;
+        element: MediaTemplateElement;
+        messaging_type?: MessagingType;
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+    product(options: {
+        recipient: Recipient;
+        elements: ProductTemplateElement[];
+        messaging_type?: MessagingType;
+        notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';
+        tag?: string;
+    }): Promise<SendMessageResponse>;
+}
+
+interface MessengerConfig {
+    accessToken: string;
+    version?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+declare class Messenger {
+    readonly send: SendAPI;
+    readonly attachments: AttachmentsAPI;
+    readonly moderation: ModerationAPI;
+    readonly templates: TemplatesAPI;
+    private readonly httpClient;
+    constructor(config: MessengerConfig);
+    private validateConfig;
+}
+
+declare class MessengerAPIError extends Error {
+    readonly code: number;
+    readonly type: string;
+    readonly subcode?: number;
+    readonly fbtrace_id?: string;
+    readonly statusCode: number;
+    readonly response?: any;
+    constructor(error: MessengerError, statusCode: number, response?: any);
+}
+declare class MessengerNetworkError extends Error {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+declare class MessengerTimeoutError extends Error {
+    readonly timeout: number;
+    constructor(timeout: number);
+}
+declare class MessengerConfigError extends Error {
+    constructor(message: string);
+}
+
+declare class TemplateValidationError extends Error {
+    constructor(message: string);
+}
+
+declare class MessageValidationError extends Error {
+    constructor(message: string);
+}
+
+declare const MESSAGE_LIMITS: {
+    readonly TEXT_MESSAGE_MAX_CHARS: 2000;
+};
+declare const ATTACHMENT_LIMITS: {
+    readonly IMAGE_MAX_SIZE: number;
+    readonly OTHER_MAX_SIZE: number;
+    readonly VIDEO_TIMEOUT: 75;
+    readonly OTHER_TIMEOUT: 10;
+};
+declare const TEMPLATE_LIMITS: {
+    readonly GENERIC_ELEMENTS_MAX: 10;
+    readonly GENERIC_TITLE_MAX_CHARS: 80;
+    readonly GENERIC_SUBTITLE_MAX_CHARS: 80;
+    readonly BUTTON_TEXT_MAX_CHARS: 640;
+    readonly BUTTONS_MAX_COUNT: 3;
+    readonly BUTTON_TITLE_MAX_CHARS: 20;
+    readonly POSTBACK_PAYLOAD_MAX_CHARS: 1000;
+    readonly MEDIA_ELEMENTS_COUNT: 1;
+    readonly MEDIA_BUTTONS_MAX_COUNT: 3;
+};
+
+export { ATTACHMENT_LIMITS, type AttachmentType, type AttachmentUploadRequest, type AttachmentUploadResponse, AttachmentsAPI, type Button, type ButtonTemplatePayload, type DefaultAction, type ErrorResponse, type GenericTemplateElement, type GenericTemplatePayload, MESSAGE_LIMITS, type MediaTemplateElement, type MediaTemplatePayload, type Message, MessageValidationError, type MessagingType, Messenger, MessengerAPIError, type MessengerConfig, MessengerConfigError, type MessengerError, MessengerNetworkError, MessengerTimeoutError, type ModerateConversationsRequest, type ModerateConversationsResponse, ModerationAPI, type ModerationAction, type ProductTemplateElement, type ProductTemplatePayload, type QuickReply, type Recipient, SendAPI, type SendMessageRequest, type SendMessageResponse, type SenderAction, TEMPLATE_LIMITS, TemplateValidationError, TemplatesAPI, type UserId };

package/dist/index.js

@@ -0,0 +1,3 @@
+var f="v23.0",R="https://graph.facebook.com";var p={MESSAGES:"/me/messages",MESSAGE_ATTACHMENTS:"/me/message_attachments",MODERATE_CONVERSATIONS:"/me/moderate_conversations"},E={TEXT_MESSAGE_MAX_CHARS:2e3},U={IMAGE_MAX_SIZE:8*1024*1024,OTHER_MAX_SIZE:25*1024*1024,VIDEO_TIMEOUT:75,OTHER_TIMEOUT:10},o={GENERIC_ELEMENTS_MAX:10,GENERIC_TITLE_MAX_CHARS:80,GENERIC_SUBTITLE_MAX_CHARS:80,BUTTON_TEXT_MAX_CHARS:640,BUTTONS_MAX_COUNT:3,BUTTON_TITLE_MAX_CHARS:20,POSTBACK_PAYLOAD_MAX_CHARS:1e3,MEDIA_ELEMENTS_COUNT:1,MEDIA_BUTTONS_MAX_COUNT:3};var c=class extends Error{code;type;subcode;fbtrace_id;statusCode;response;constructor(e,s,r){super(e.message),this.name="MessengerAPIError",this.code=e.code,this.type=e.type,this.subcode=e.error_subcode,this.fbtrace_id=e.fbtrace_id,this.statusCode=s,this.response=r;}},l=class extends Error{cause;constructor(e,s){super(e),this.name="MessengerNetworkError",this.cause=s;}},u=class extends Error{timeout;constructor(e){super(`Request timed out after ${e}ms`),this.name="MessengerTimeoutError",this.timeout=e;}},m=class extends Error{constructor(e){super(e),this.name="MessengerConfigError";}};var S=class{config;constructor(e){this.config={accessToken:e.accessToken,version:e.version,baseUrl:e.baseUrl||R,timeout:e.timeout||3e4,maxRetries:e.maxRetries||3};}async request(e){let s=this.buildUrl(e.path,e.query),r;for(let i=0;i<=this.config.maxRetries;i++)try{let a=await this.makeRequest(s,e);return await this.handleResponse(a)}catch(a){if(r=a,a instanceof c&&a.statusCode>=400&&a.statusCode<500||i===this.config.maxRetries)throw a;await this.delay(1e3*(i+1));}throw r||new Error("Unknown error occurred")}buildUrl(e,s){let r=new URL(`${this.config.baseUrl}/${this.config.version}${e}`);return r.searchParams.append("access_token",this.config.accessToken),s&&Object.entries(s).forEach(([i,a])=>{r.searchParams.append(i,String(a));}),r.toString()}async makeRequest(e,s){let r=new AbortController,i=setTimeout(()=>r.abort(),this.config.timeout);try{let a={method:s.method,headers:{"Content-Type":"application/json"},signal:r.signal};return s.body&&(a.body=JSON.stringify(s.body)),await fetch(e,a)}catch(a){throw a instanceof Error?a.name==="AbortError"?new u(this.config.timeout):new l(`Network request failed: ${a.message}`,a):a}finally{clearTimeout(i);}}async handleResponse(e){let r=e.headers.get("content-type")?.includes("application/json");if(!e.ok)if(r){let i=await e.json();throw new c(i.error,e.status,i)}else {let i=await e.text();throw new c({message:i||`HTTP ${e.status} ${e.statusText}`,type:"http_error",code:e.status,fbtrace_id:""},e.status,i)}return r?await e.json():await e.text()}delay(e){return new Promise(s=>setTimeout(s,e))}};var T=class extends Error{constructor(e){super(e),this.name="MessageValidationError";}};function P(t){if(!t||t.trim()==="")throw new T("Text message cannot be empty");if(t.length>E.TEXT_MESSAGE_MAX_CHARS)throw new T(`Text message cannot exceed ${E.TEXT_MESSAGE_MAX_CHARS} characters`)}var d=class{constructor(e){this.httpClient=e;}async message(e){return e.message?.text&&P(e.message.text),this.httpClient.request({method:"POST",path:p.MESSAGES,body:e})}async action(e,s){return this.httpClient.request({method:"POST",path:p.MESSAGES,body:{recipient:{id:e},messaging_type:"RESPONSE",sender_action:s}})}async typingOn(e){return this.action(e,"typing_on")}async typingOff(e){return this.action(e,"typing_off")}async markSeen(e){return this.action(e,"mark_seen")}async attachment(e){return this.message({recipient:e.recipient,messaging_type:e.messaging_type??"RESPONSE",message:{attachment:{type:e.type,payload:{attachment_id:e.attachment_id}}}})}async attachmentFromUrl(e){return this.message({recipient:e.recipient,messaging_type:e.messaging_type??"RESPONSE",message:{attachment:{type:e.type,payload:{url:e.url}}}})}};var _=class{constructor(e){this.httpClient=e;}async upload(e){let s={message:{attachment:{type:e.type,payload:{url:e.url,is_reusable:e.is_reusable??true}}}};return this.httpClient.request({method:"POST",path:p.MESSAGE_ATTACHMENTS,body:s})}};var h=class{constructor(e){this.httpClient=e;}async moderate(e){return this.httpClient.request({method:"POST",path:p.MODERATE_CONVERSATIONS,body:e})}async blockUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["block_user"]})}async unblockUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["unblock_user"]})}async banUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["ban_user"]})}async unbanUser(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["unban_user"]})}async moveToSpam(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["move_to_spam"]})}async blockAndSpam(e){let s=Array.isArray(e)?e.map(r=>({id:r})):[{id:e}];return this.moderate({user_ids:s,actions:["block_user","move_to_spam"]})}};var n=class extends Error{constructor(e){super(e),this.name="TemplateValidationError";}};function b(t){if(t.length===0)throw new n("Generic template must have at least 1 element");if(t.length>o.GENERIC_ELEMENTS_MAX)throw new n(`Generic template cannot have more than ${o.GENERIC_ELEMENTS_MAX} elements`);t.forEach((e,s)=>{I(e,s);});}function I(t,e){if(!t.title||t.title.trim()==="")throw new n(`Element ${e}: title is required`);if(t.title.length>o.GENERIC_TITLE_MAX_CHARS)throw new n(`Element ${e}: title cannot exceed ${o.GENERIC_TITLE_MAX_CHARS} characters`);if(t.subtitle&&t.subtitle.length>o.GENERIC_SUBTITLE_MAX_CHARS)throw new n(`Element ${e}: subtitle cannot exceed ${o.GENERIC_SUBTITLE_MAX_CHARS} characters`);if(t.image_url&&!y(t.image_url))throw new n(`Element ${e}: image_url must be HTTPS`);if(t.buttons&&A(t.buttons,`Element ${e}`),!!!(t.subtitle||t.image_url||t.default_action||t.buttons&&t.buttons.length>0))throw new n(`Element ${e}: must have at least one additional property beyond title`)}function w(t,e){if(!t||t.trim()==="")throw new n("Button template text is required");if(t.length>o.BUTTON_TEXT_MAX_CHARS)throw new n(`Button template text cannot exceed ${o.BUTTON_TEXT_MAX_CHARS} characters`);if(e.length===0)throw new n("Button template must have at least 1 button");A(e,"Button template");}function C(t){if(!t.media_type)throw new n("Media template element must have media_type");if(!t.url&&!t.attachment_id)throw new n("Media template element must have either url or attachment_id");if(t.url&&t.attachment_id)throw new n("Media template element cannot have both url and attachment_id");if(t.url&&!y(t.url))throw new n("Media template url must be HTTPS");if(t.buttons){if(t.buttons.length>o.MEDIA_BUTTONS_MAX_COUNT)throw new n(`Media template cannot have more than ${o.MEDIA_BUTTONS_MAX_COUNT} buttons`);A(t.buttons,"Media template");}}function A(t,e){if(t.length>o.BUTTONS_MAX_COUNT)throw new n(`${e} cannot have more than ${o.BUTTONS_MAX_COUNT} buttons`);t.forEach((s,r)=>{x(s,`${e} button ${r}`);});}function x(t,e){if(!t.type)throw new n(`${e}: type is required`);if(t.type!=="account_unlink"&&(!t.title||t.title.trim()===""))throw new n(`${e}: title is required for ${t.type} buttons`);if(t.title&&t.title.length>o.BUTTON_TITLE_MAX_CHARS)throw new n(`${e}: title cannot exceed ${o.BUTTON_TITLE_MAX_CHARS} characters`);switch(t.type){case "web_url":if(!t.url)throw new n(`${e}: url is required for web_url buttons`);if(!y(t.url))throw new n(`${e}: url must be HTTPS for web_url buttons`);break;case "postback":if(!t.payload)throw new n(`${e}: payload is required for postback buttons`);if(t.payload.length>o.POSTBACK_PAYLOAD_MAX_CHARS)throw new n(`${e}: payload cannot exceed ${o.POSTBACK_PAYLOAD_MAX_CHARS} characters`);break;case "phone_number":if(!t.payload)throw new n(`${e}: payload is required for phone_number buttons`);if(!t.payload.startsWith("+"))throw new n(`${e}: phone_number payload must start with + (e.g., +1234567890)`);break;case "game_play":break;case "account_link":if(!t.url)throw new n(`${e}: url is required for account_link buttons`);if(!y(t.url))throw new n(`${e}: url must be HTTPS for account_link buttons`);break;}if(t.type==="web_url"&&t.messenger_extensions&&t.fallback_url&&!y(t.fallback_url))throw new n(`${e}: fallback_url must be HTTPS`)}function y(t){try{return new URL(t).protocol==="https:"}catch{return  false}}var g=class{constructor(e){this.httpClient=e;}async generic(e){b(e.elements);let s={template_type:"generic",elements:e.elements,image_aspect_ratio:e.image_aspect_ratio},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}async button(e){w(e.text,e.buttons);let s={template_type:"button",text:e.text,buttons:e.buttons},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}async media(e){C(e.element);let s={template_type:"media",elements:[e.element]},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}async product(e){let s={template_type:"product",elements:e.elements},r={recipient:e.recipient,messaging_type:e.messaging_type||"UPDATE",message:{attachment:{type:"template",payload:s}},notification_type:e.notification_type,tag:e.tag};return this.httpClient.request({method:"POST",path:p.MESSAGES,body:r})}};var M=class{send;attachments;moderation;templates;httpClient;constructor(e){this.validateConfig(e);let s={accessToken:e.accessToken,version:e.version||f,baseUrl:e.baseUrl,timeout:e.timeout,maxRetries:e.maxRetries};this.httpClient=new S(s),this.send=new d(this.httpClient),this.attachments=new _(this.httpClient),this.moderation=new h(this.httpClient),this.templates=new g(this.httpClient);}validateConfig(e){if(!e.accessToken)throw new m("Access token is required");if(typeof e.accessToken!="string"||e.accessToken.trim()==="")throw new m("Access token must be a non-empty string");if(e.version&&typeof e.version!="string")throw new m("API version must be a string");if(e.timeout&&(typeof e.timeout!="number"||e.timeout<=0))throw new m("Timeout must be a positive number");if(e.maxRetries&&(typeof e.maxRetries!="number"||e.maxRetries<0))throw new m("Max retries must be a non-negative number")}};
+export{U as ATTACHMENT_LIMITS,_ as AttachmentsAPI,E as MESSAGE_LIMITS,T as MessageValidationError,M as Messenger,c as MessengerAPIError,m as MessengerConfigError,l as MessengerNetworkError,u as MessengerTimeoutError,h as ModerationAPI,d as SendAPI,o as TEMPLATE_LIMITS,n as TemplateValidationError,g as TemplatesAPI};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/constants.ts","../src/core/errors.ts","../src/core/http-client.ts","../src/utils/message-validators.ts","../src/resources/send.ts","../src/resources/attachments.ts","../src/resources/moderation.ts","../src/utils/validators.ts","../src/resources/templates.ts","../src/client.ts"],"names":["DEFAULT_API_VERSION","BASE_URL","API_ENDPOINTS","MESSAGE_LIMITS","ATTACHMENT_LIMITS","TEMPLATE_LIMITS","MessengerAPIError","error","statusCode","response","MessengerNetworkError","message","cause","MessengerTimeoutError","timeout","MessengerConfigError","HTTPClient","config","options","url","lastError","attempt","path","query","key","value","controller","timeoutId","fetchOptions","isJson","errorData","text","ms","resolve","MessageValidationError","validateTextMessage","SendAPI","httpClient","request","recipientId","action","AttachmentsAPI","body","ModerationAPI","userIds","user_ids","id","TemplateValidationError","validateGenericTemplate","elements","element","index","validateGenericElement","isHttpsUrl","validateButtons","validateButtonTemplate","buttons","validateMediaTemplate","context","button","validateButton","TemplatesAPI","payload","Messenger","clientConfig"],"mappings":"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","file":"index.js","sourcesContent":["export const DEFAULT_API_VERSION = 'v23.0';\nexport const BASE_URL = 'https://graph.facebook.com';\nexport const DEFAULT_TIMEOUT = 30000; // 30 seconds\nexport const MAX_RETRY_ATTEMPTS = 3;\nexport const RETRY_DELAY_MS = 1000;\n\nexport const API_ENDPOINTS = {\n  MESSAGES: '/me/messages',\n  MESSAGE_ATTACHMENTS: '/me/message_attachments',\n  MODERATE_CONVERSATIONS: '/me/moderate_conversations',\n  PASS_THREAD_CONTROL: '/me/pass_thread_control',\n  TAKE_THREAD_CONTROL: '/me/take_thread_control',\n  REQUEST_THREAD_CONTROL: '/me/request_thread_control',\n} as const;\n\n// Validation constants\nexport const MESSAGE_LIMITS = {\n  // Text messages\n  TEXT_MESSAGE_MAX_CHARS: 2000,\n} as const;\n\nexport const ATTACHMENT_LIMITS = {\n  // File size limits in bytes\n  IMAGE_MAX_SIZE: 8 * 1024 * 1024, // 8MB\n  OTHER_MAX_SIZE: 25 * 1024 * 1024, // 25MB (video, audio, file)\n  \n  // Timeout limits in seconds\n  VIDEO_TIMEOUT: 75,\n  OTHER_TIMEOUT: 10,\n} as const;\n\nexport const TEMPLATE_LIMITS = {\n  // Generic Template\n  GENERIC_ELEMENTS_MAX: 10,\n  GENERIC_TITLE_MAX_CHARS: 80,\n  GENERIC_SUBTITLE_MAX_CHARS: 80,\n  \n  // Button Template  \n  BUTTON_TEXT_MAX_CHARS: 640,\n  BUTTONS_MAX_COUNT: 3,\n  BUTTON_TITLE_MAX_CHARS: 20,\n  \n  // All Templates\n  POSTBACK_PAYLOAD_MAX_CHARS: 1000,\n  \n  // Media Template\n  MEDIA_ELEMENTS_COUNT: 1, // Exactly 1 element required\n  MEDIA_BUTTONS_MAX_COUNT: 3,\n} as const;","import type { MessengerError } from '../types/responses.js';\n\nexport class MessengerAPIError extends Error {\n  public readonly code: number;\n  public readonly type: string;\n  public readonly subcode?: number;\n  public readonly fbtrace_id?: string;\n  public readonly statusCode: number;\n  public readonly response?: any;\n\n  constructor(error: MessengerError, statusCode: number, response?: any) {\n    super(error.message);\n    this.name = 'MessengerAPIError';\n    this.code = error.code;\n    this.type = error.type;\n    this.subcode = error.error_subcode;\n    this.fbtrace_id = error.fbtrace_id;\n    this.statusCode = statusCode;\n    this.response = response;\n  }\n}\n\nexport class MessengerNetworkError extends Error {\n  public readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = 'MessengerNetworkError';\n    this.cause = cause;\n  }\n}\n\nexport class MessengerTimeoutError extends Error {\n  public readonly timeout: number;\n\n  constructor(timeout: number) {\n    super(`Request timed out after ${timeout}ms`);\n    this.name = 'MessengerTimeoutError';\n    this.timeout = timeout;\n  }\n}\n\nexport class MessengerConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'MessengerConfigError';\n  }\n}","import { BASE_URL, DEFAULT_TIMEOUT, MAX_RETRY_ATTEMPTS, RETRY_DELAY_MS } from './constants.js';\nimport { MessengerAPIError, MessengerNetworkError, MessengerTimeoutError } from './errors.js';\nimport type { ErrorResponse } from '../types/responses.js';\n\nexport interface ClientConfig {\n  accessToken: string;\n  version: string;\n  baseUrl?: string;\n  timeout?: number;\n  maxRetries?: number;\n}\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST' | 'DELETE';\n  path: string;\n  body?: any;\n  query?: Record<string, string | number | boolean>;\n}\n\nexport class HTTPClient {\n  private readonly config: Required<ClientConfig>;\n\n  constructor(config: ClientConfig) {\n    this.config = {\n      accessToken: config.accessToken,\n      version: config.version,\n      baseUrl: config.baseUrl || BASE_URL,\n      timeout: config.timeout || DEFAULT_TIMEOUT,\n      maxRetries: config.maxRetries || MAX_RETRY_ATTEMPTS,\n    };\n  }\n\n  async request<T>(options: RequestOptions): Promise<T> {\n    const url = this.buildUrl(options.path, options.query);\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {\n      try {\n        const response = await this.makeRequest(url, options);\n        return await this.handleResponse<T>(response);\n      } catch (error) {\n        lastError = error as Error;\n        \n        // Don't retry on client errors (4xx)\n        if (error instanceof MessengerAPIError && error.statusCode >= 400 && error.statusCode < 500) {\n          throw error;\n        }\n\n        // Don't retry on timeout for the last attempt\n        if (attempt === this.config.maxRetries) {\n          throw error;\n        }\n\n        // Wait before retrying\n        await this.delay(RETRY_DELAY_MS * (attempt + 1));\n      }\n    }\n\n    throw lastError || new Error('Unknown error occurred');\n  }\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean>): string {\n    const url = new URL(`${this.config.baseUrl}/${this.config.version}${path}`);\n    \n    // Always add access token\n    url.searchParams.append('access_token', this.config.accessToken);\n    \n    // Add additional query parameters\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        url.searchParams.append(key, String(value));\n      });\n    }\n\n    return url.toString();\n  }\n\n  private async makeRequest(url: string, options: RequestOptions): Promise<Response> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const fetchOptions: RequestInit = {\n        method: options.method,\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        signal: controller.signal,\n      };\n\n      if (options.body) {\n        fetchOptions.body = JSON.stringify(options.body);\n      }\n\n      const response = await fetch(url, fetchOptions);\n      return response;\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          throw new MessengerTimeoutError(this.config.timeout);\n        }\n        throw new MessengerNetworkError(`Network request failed: ${error.message}`, error);\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private async handleResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    const isJson = contentType?.includes('application/json');\n\n    if (!response.ok) {\n      if (isJson) {\n        const errorData = await response.json() as ErrorResponse;\n        throw new MessengerAPIError(errorData.error, response.status, errorData);\n      } else {\n        const text = await response.text();\n        throw new MessengerAPIError(\n          {\n            message: text || `HTTP ${response.status} ${response.statusText}`,\n            type: 'http_error',\n            code: response.status,\n            fbtrace_id: '',\n          },\n          response.status,\n          text\n        );\n      }\n    }\n\n    if (isJson) {\n      return await response.json() as T;\n    }\n\n    // For non-JSON responses, return the text\n    return await response.text() as unknown as T;\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n  }\n}","import { MESSAGE_LIMITS } from '../core/constants.js';\n\nexport class MessageValidationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'MessageValidationError';\n  }\n}\n\nexport function validateTextMessage(text: string): void {\n  if (!text || text.trim() === '') {\n    throw new MessageValidationError('Text message cannot be empty');\n  }\n\n  if (text.length > MESSAGE_LIMITS.TEXT_MESSAGE_MAX_CHARS) {\n    throw new MessageValidationError(\n      `Text message cannot exceed ${MESSAGE_LIMITS.TEXT_MESSAGE_MAX_CHARS} characters`\n    );\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { SendMessageRequest, SenderAction, Recipient } from '../types/messages.js';\nimport type { SendMessageResponse } from '../types/responses.js';\nimport type { AttachmentType } from '../types/attachments.js';\nimport { validateTextMessage } from '../utils/message-validators.js';\n\nexport class SendAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  async message(request: SendMessageRequest): Promise<SendMessageResponse> {\n    // Validate text message length if present\n    if (request.message?.text) {\n      validateTextMessage(request.message.text);\n    }\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async action(recipientId: string, action: SenderAction): Promise<SendMessageResponse> {\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: {\n        recipient: { id: recipientId },\n        messaging_type: 'RESPONSE',\n        sender_action: action,\n      },\n    });\n  }\n\n  async typingOn(recipientId: string): Promise<SendMessageResponse> {\n    return this.action(recipientId, 'typing_on');\n  }\n\n  async typingOff(recipientId: string): Promise<SendMessageResponse> {\n    return this.action(recipientId, 'typing_off');\n  }\n\n  async markSeen(recipientId: string): Promise<SendMessageResponse> {\n    return this.action(recipientId, 'mark_seen');\n  }\n\n  // Convenience methods for sending attachments\n\n  /**\n   * Send an attachment using a previously uploaded attachment_id\n   */\n  async attachment(options: {\n    recipient: Recipient;\n    type: AttachmentType;\n    attachment_id: string;\n    messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';\n  }): Promise<SendMessageResponse> {\n    return this.message({\n      recipient: options.recipient,\n      messaging_type: options.messaging_type ?? 'RESPONSE',\n      message: {\n        attachment: {\n          type: options.type,\n          payload: {\n            attachment_id: options.attachment_id,\n          },\n        },\n      },\n    });\n  }\n\n  /**\n   * Upload and send an attachment from URL in a single request\n   */\n  async attachmentFromUrl(options: {\n    recipient: Recipient;\n    type: AttachmentType;\n    url: string;\n    messaging_type?: 'RESPONSE' | 'UPDATE' | 'MESSAGE_TAG';\n  }): Promise<SendMessageResponse> {\n    return this.message({\n      recipient: options.recipient,\n      messaging_type: options.messaging_type ?? 'RESPONSE',\n      message: {\n        attachment: {\n          type: options.type,\n          payload: {\n            url: options.url,\n          },\n        },\n      },\n    });\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { AttachmentUploadRequest, AttachmentUploadResponse } from '../types/attachments.js';\n\nexport class AttachmentsAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  async upload(request: AttachmentUploadRequest): Promise<AttachmentUploadResponse> {\n    // Format according to official API - no message wrapper needed\n    const body = {\n      message: {\n        attachment: {\n          type: request.type,\n          payload: {\n            url: request.url,\n            is_reusable: request.is_reusable ?? true,\n          },\n        },\n      },\n    };\n\n    return this.httpClient.request<AttachmentUploadResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGE_ATTACHMENTS,\n      body,\n    });\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { \n  ModerateConversationsRequest,\n  ModerateConversationsResponse\n} from '../types/moderation.js';\n\nexport class ModerationAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  /**\n   * Moderate conversations with specified actions\n   * Up to 10 user IDs and up to 2 actions per request\n   */\n  async moderate(request: ModerateConversationsRequest): Promise<ModerateConversationsResponse> {\n    return this.httpClient.request<ModerateConversationsResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MODERATE_CONVERSATIONS,\n      body: request,\n    });\n  }\n\n  /**\n   * Block a user from messaging the page\n   * Prevents messaging but user can still interact with page content on Facebook\n   */\n  async blockUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds) \n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['block_user'],\n    });\n  }\n\n  /**\n   * Unblock a user to allow messaging again\n   */\n  async unblockUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['unblock_user'],\n    });\n  }\n\n  /**\n   * Ban a user from both messaging and Facebook interactions\n   * More restrictive than blocking - prevents all interactions\n   * Note: Cannot ban user who was unbanned in last 48 hours\n   */\n  async banUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['ban_user'],\n    });\n  }\n\n  /**\n   * Unban a user to restore all interactions\n   * Note: Banned user cannot be unblocked, they must be unbanned first\n   */\n  async unbanUser(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['unban_user'],\n    });\n  }\n\n  /**\n   * Move conversation to spam folder in Meta Business Suite Inbox\n   */\n  async moveToSpam(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['move_to_spam'],\n    });\n  }\n\n  /**\n   * Block user and move to spam (common moderation action)\n   */\n  async blockAndSpam(userIds: string | string[]): Promise<ModerateConversationsResponse> {\n    const user_ids = Array.isArray(userIds)\n      ? userIds.map(id => ({ id }))\n      : [{ id: userIds }];\n\n    return this.moderate({\n      user_ids,\n      actions: ['block_user', 'move_to_spam'],\n    });\n  }\n}","import { TEMPLATE_LIMITS } from '../core/constants.js';\nimport type { Button, GenericTemplateElement, MediaTemplateElement } from '../types/templates.js';\n\nexport class TemplateValidationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TemplateValidationError';\n  }\n}\n\nexport function validateGenericTemplate(elements: GenericTemplateElement[]): void {\n  if (elements.length === 0) {\n    throw new TemplateValidationError('Generic template must have at least 1 element');\n  }\n\n  if (elements.length > TEMPLATE_LIMITS.GENERIC_ELEMENTS_MAX) {\n    throw new TemplateValidationError(\n      `Generic template cannot have more than ${TEMPLATE_LIMITS.GENERIC_ELEMENTS_MAX} elements`\n    );\n  }\n\n  elements.forEach((element, index) => {\n    validateGenericElement(element, index);\n  });\n}\n\nexport function validateGenericElement(element: GenericTemplateElement, index: number): void {\n  if (!element.title || element.title.trim() === '') {\n    throw new TemplateValidationError(`Element ${index}: title is required`);\n  }\n\n  if (element.title.length > TEMPLATE_LIMITS.GENERIC_TITLE_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `Element ${index}: title cannot exceed ${TEMPLATE_LIMITS.GENERIC_TITLE_MAX_CHARS} characters`\n    );\n  }\n\n  if (element.subtitle && element.subtitle.length > TEMPLATE_LIMITS.GENERIC_SUBTITLE_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `Element ${index}: subtitle cannot exceed ${TEMPLATE_LIMITS.GENERIC_SUBTITLE_MAX_CHARS} characters`\n    );\n  }\n\n  if (element.image_url && !isHttpsUrl(element.image_url)) {\n    throw new TemplateValidationError(`Element ${index}: image_url must be HTTPS`);\n  }\n\n  if (element.buttons) {\n    validateButtons(element.buttons, `Element ${index}`);\n  }\n\n  // Validate that element has at least one property beyond title\n  const hasAdditionalProperty = !!(\n    element.subtitle ||\n    element.image_url ||\n    element.default_action ||\n    (element.buttons && element.buttons.length > 0)\n  );\n\n  if (!hasAdditionalProperty) {\n    throw new TemplateValidationError(\n      `Element ${index}: must have at least one additional property beyond title`\n    );\n  }\n}\n\nexport function validateButtonTemplate(text: string, buttons: Button[]): void {\n  if (!text || text.trim() === '') {\n    throw new TemplateValidationError('Button template text is required');\n  }\n\n  if (text.length > TEMPLATE_LIMITS.BUTTON_TEXT_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `Button template text cannot exceed ${TEMPLATE_LIMITS.BUTTON_TEXT_MAX_CHARS} characters`\n    );\n  }\n\n  if (buttons.length === 0) {\n    throw new TemplateValidationError('Button template must have at least 1 button');\n  }\n\n  validateButtons(buttons, 'Button template');\n}\n\nexport function validateMediaTemplate(element: MediaTemplateElement): void {\n  if (!element.media_type) {\n    throw new TemplateValidationError('Media template element must have media_type');\n  }\n\n  if (!element.url && !element.attachment_id) {\n    throw new TemplateValidationError('Media template element must have either url or attachment_id');\n  }\n\n  if (element.url && element.attachment_id) {\n    throw new TemplateValidationError(\n      'Media template element cannot have both url and attachment_id'\n    );\n  }\n\n  if (element.url && !isHttpsUrl(element.url)) {\n    throw new TemplateValidationError('Media template url must be HTTPS');\n  }\n\n  if (element.buttons) {\n    if (element.buttons.length > TEMPLATE_LIMITS.MEDIA_BUTTONS_MAX_COUNT) {\n      throw new TemplateValidationError(\n        `Media template cannot have more than ${TEMPLATE_LIMITS.MEDIA_BUTTONS_MAX_COUNT} buttons`\n      );\n    }\n    validateButtons(element.buttons, 'Media template');\n  }\n}\n\nexport function validateButtons(buttons: Button[], context: string): void {\n  if (buttons.length > TEMPLATE_LIMITS.BUTTONS_MAX_COUNT) {\n    throw new TemplateValidationError(\n      `${context} cannot have more than ${TEMPLATE_LIMITS.BUTTONS_MAX_COUNT} buttons`\n    );\n  }\n\n  buttons.forEach((button, index) => {\n    validateButton(button, `${context} button ${index}`);\n  });\n}\n\nexport function validateButton(button: Button, context: string): void {\n  if (!button.type) {\n    throw new TemplateValidationError(`${context}: type is required`);\n  }\n\n  // Title is required for most button types (not for account_unlink)\n  if (button.type !== 'account_unlink' && (!button.title || button.title.trim() === '')) {\n    throw new TemplateValidationError(`${context}: title is required for ${button.type} buttons`);\n  }\n\n  if (button.title && button.title.length > TEMPLATE_LIMITS.BUTTON_TITLE_MAX_CHARS) {\n    throw new TemplateValidationError(\n      `${context}: title cannot exceed ${TEMPLATE_LIMITS.BUTTON_TITLE_MAX_CHARS} characters`\n    );\n  }\n\n  // Type-specific validations\n  switch (button.type) {\n    case 'web_url':\n      if (!button.url) {\n        throw new TemplateValidationError(`${context}: url is required for web_url buttons`);\n      }\n      if (!isHttpsUrl(button.url)) {\n        throw new TemplateValidationError(`${context}: url must be HTTPS for web_url buttons`);\n      }\n      break;\n\n    case 'postback':\n      if (!button.payload) {\n        throw new TemplateValidationError(`${context}: payload is required for postback buttons`);\n      }\n      if (button.payload.length > TEMPLATE_LIMITS.POSTBACK_PAYLOAD_MAX_CHARS) {\n        throw new TemplateValidationError(\n          `${context}: payload cannot exceed ${TEMPLATE_LIMITS.POSTBACK_PAYLOAD_MAX_CHARS} characters`\n        );\n      }\n      break;\n\n    case 'phone_number':\n      if (!button.payload) {\n        throw new TemplateValidationError(`${context}: payload is required for phone_number buttons`);\n      }\n      // Basic phone number validation (starts with +)\n      if (!button.payload.startsWith('+')) {\n        throw new TemplateValidationError(\n          `${context}: phone_number payload must start with + (e.g., +1234567890)`\n        );\n      }\n      break;\n\n    case 'game_play':\n      // game_play buttons may have optional game_metadata\n      break;\n\n    case 'account_link':\n      if (!button.url) {\n        throw new TemplateValidationError(`${context}: url is required for account_link buttons`);\n      }\n      if (!isHttpsUrl(button.url)) {\n        throw new TemplateValidationError(`${context}: url must be HTTPS for account_link buttons`);\n      }\n      break;\n\n    case 'account_unlink':\n      // account_unlink buttons don't require additional properties\n      break;\n  }\n\n  // Validate webview properties for web_url buttons\n  if (button.type === 'web_url' && button.messenger_extensions && button.fallback_url) {\n    if (!isHttpsUrl(button.fallback_url)) {\n      throw new TemplateValidationError(`${context}: fallback_url must be HTTPS`);\n    }\n  }\n}\n\nfunction isHttpsUrl(url: string): boolean {\n  try {\n    const parsedUrl = new URL(url);\n    return parsedUrl.protocol === 'https:';\n  } catch {\n    return false;\n  }\n}","import type { HTTPClient } from '../core/http-client.js';\nimport { API_ENDPOINTS } from '../core/constants.js';\nimport type { Recipient, SendMessageRequest, MessagingType } from '../types/messages.js';\nimport type { SendMessageResponse } from '../types/responses.js';\nimport { validateGenericTemplate, validateButtonTemplate, validateMediaTemplate } from '../utils/validators.js';\nimport type {\n  GenericTemplatePayload,\n  ButtonTemplatePayload,\n  MediaTemplatePayload,\n  ProductTemplatePayload,\n  GenericTemplateElement,\n  Button,\n  MediaTemplateElement,\n  ProductTemplateElement,\n} from '../types/templates.js';\n\nexport class TemplatesAPI {\n  constructor(private httpClient: HTTPClient) {}\n\n  async generic(options: {\n    recipient: Recipient;\n    elements: GenericTemplateElement[];\n    messaging_type?: MessagingType;\n    image_aspect_ratio?: 'horizontal' | 'square';\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    // Validate template\n    validateGenericTemplate(options.elements);\n\n    const payload: GenericTemplatePayload = {\n      template_type: 'generic',\n      elements: options.elements,\n      image_aspect_ratio: options.image_aspect_ratio,\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async button(options: {\n    recipient: Recipient;\n    text: string;\n    buttons: Button[];\n    messaging_type?: MessagingType;\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    // Validate template\n    validateButtonTemplate(options.text, options.buttons);\n\n    const payload: ButtonTemplatePayload = {\n      template_type: 'button',\n      text: options.text,\n      buttons: options.buttons,\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async media(options: {\n    recipient: Recipient;\n    element: MediaTemplateElement;\n    messaging_type?: MessagingType;\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    // Validate template\n    validateMediaTemplate(options.element);\n\n    const payload: MediaTemplatePayload = {\n      template_type: 'media',\n      elements: [options.element],\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n\n  async product(options: {\n    recipient: Recipient;\n    elements: ProductTemplateElement[];\n    messaging_type?: MessagingType;\n    notification_type?: 'REGULAR' | 'SILENT_PUSH' | 'NO_PUSH';\n    tag?: string;\n  }): Promise<SendMessageResponse> {\n    const payload: ProductTemplatePayload = {\n      template_type: 'product',\n      elements: options.elements,\n    };\n\n    const request: SendMessageRequest = {\n      recipient: options.recipient,\n      messaging_type: options.messaging_type || 'UPDATE',\n      message: {\n        attachment: {\n          type: 'template',\n          payload,\n        },\n      },\n      notification_type: options.notification_type,\n      tag: options.tag,\n    };\n\n    return this.httpClient.request<SendMessageResponse>({\n      method: 'POST',\n      path: API_ENDPOINTS.MESSAGES,\n      body: request,\n    });\n  }\n}","import { HTTPClient, type ClientConfig } from './core/http-client.js';\nimport { DEFAULT_API_VERSION } from './core/constants.js';\nimport { MessengerConfigError } from './core/errors.js';\nimport { SendAPI } from './resources/send.js';\nimport { AttachmentsAPI } from './resources/attachments.js';\nimport { ModerationAPI } from './resources/moderation.js';\nimport { TemplatesAPI } from './resources/templates.js';\n\nexport interface MessengerConfig {\n  accessToken: string;\n  version?: string;\n  baseUrl?: string;\n  timeout?: number;\n  maxRetries?: number;\n}\n\nexport class Messenger {\n  public readonly send: SendAPI;\n  public readonly attachments: AttachmentsAPI;\n  public readonly moderation: ModerationAPI;\n  public readonly templates: TemplatesAPI;\n\n  private readonly httpClient: HTTPClient;\n\n  constructor(config: MessengerConfig) {\n    this.validateConfig(config);\n\n    const clientConfig: ClientConfig = {\n      accessToken: config.accessToken,\n      version: config.version || DEFAULT_API_VERSION,\n      baseUrl: config.baseUrl,\n      timeout: config.timeout,\n      maxRetries: config.maxRetries,\n    };\n\n    this.httpClient = new HTTPClient(clientConfig);\n\n    // Initialize API resources\n    this.send = new SendAPI(this.httpClient);\n    this.attachments = new AttachmentsAPI(this.httpClient);\n    this.moderation = new ModerationAPI(this.httpClient);\n    this.templates = new TemplatesAPI(this.httpClient);\n  }\n\n  private validateConfig(config: MessengerConfig): void {\n    if (!config.accessToken) {\n      throw new MessengerConfigError('Access token is required');\n    }\n\n    if (typeof config.accessToken !== 'string' || config.accessToken.trim() === '') {\n      throw new MessengerConfigError('Access token must be a non-empty string');\n    }\n\n    if (config.version && typeof config.version !== 'string') {\n      throw new MessengerConfigError('API version must be a string');\n    }\n\n    if (config.timeout && (typeof config.timeout !== 'number' || config.timeout <= 0)) {\n      throw new MessengerConfigError('Timeout must be a positive number');\n    }\n\n    if (config.maxRetries && (typeof config.maxRetries !== 'number' || config.maxRetries < 0)) {\n      throw new MessengerConfigError('Max retries must be a non-negative number');\n    }\n  }\n}"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@warriorteam/messenger-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for Facebook Messenger Platform API",
+  "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"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "facebook",
+    "messenger",
+    "sdk",
+    "api",
+    "typescript",
+    "chatbot",
+    "messaging"
+  ],
+  "author": "RedAI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/warriorteam/messenger-sdk"
+  },
+  "homepage": "https://github.com/warriorteam/messenger-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/warriorteam/messenger-sdk/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "eslint": "^9.32.0",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}