@sendly/node 3.15.3 → 3.18.0

package/dist/index.d.mts

@@ -59,12 +59,17 @@ interface SendMessageRequest {
      * Stored on the message record and included in webhook event payloads.
      */
     metadata?: Record<string, any>;
+    /**
+     * URLs of media files to include as MMS attachments.
+     * Must be publicly accessible HTTPS URLs. Max 10 per message.
+     */
+    mediaUrls?: string[];
 }
 /**
  * Message status values
  * Note: "sending" was removed as it doesn't exist in the database
  */
-type MessageStatus = "queued" | "sent" | "delivered" | "failed" | "bounced";
+type MessageStatus = "queued" | "sent" | "delivered" | "failed" | "bounced" | "retrying";
 /**
  * How the message was sent
  */
@@ -101,6 +106,14 @@ interface Message {
      * Error message if status is "failed"
      */
     error?: string | null;
+    /**
+     * Structured error code (e.g., "E001" for invalid number)
+     */
+    errorCode?: string | null;
+    /**
+     * Number of retry attempts made
+     */
+    retryCount?: number;
     /**
      * Number of SMS segments (1 per 160 chars)
      */
@@ -177,6 +190,42 @@ interface MessageListResponse {
      */
     count: number;
 }
+/**
+ * An uploaded media file for MMS
+ */
+interface MediaFile {
+    /**
+     * Unique media file identifier
+     */
+    id: string;
+    /**
+     * Publicly accessible URL for the media file
+     */
+    url: string;
+    /**
+     * MIME type of the file (e.g., "image/jpeg")
+     */
+    contentType: string;
+    /**
+     * File size in bytes
+     */
+    sizeBytes: number;
+}
+/**
+ * Options for uploading a media file
+ */
+interface MediaUploadOptions {
+    /**
+     * Filename for the upload
+     * @default "upload.jpg"
+     */
+    filename?: string;
+    /**
+     * MIME content type
+     * @default "image/jpeg"
+     */
+    contentType?: string;
+}
 /**
  * Request payload for scheduling an SMS message
  */
@@ -625,7 +674,7 @@ declare const ALL_SUPPORTED_COUNTRIES: string[];
 /**
  * Webhook event types
  */
-type WebhookEventType = "message.sent" | "message.delivered" | "message.failed" | "message.bounced" | "message.queued";
+type WebhookEventType = "message.sent" | "message.delivered" | "message.failed" | "message.bounced" | "message.retrying" | "message.queued";
 /**
  * Webhook mode - filters which events are delivered
  * - "all": Receives all events (sandbox + production)
@@ -1492,6 +1541,10 @@ declare class HttpClient {
      * Make an HTTP request to the API
      */
     request<T>(options: RequestOptions): Promise<T>;
+    /**
+     * Make an HTTP request with a raw body (for multipart uploads)
+     */
+    requestFormData<T>(path: string, body: FormData, headers?: Record<string, string>): Promise<T>;
     /**
      * Execute the HTTP request
      */
@@ -1928,6 +1981,25 @@ declare class WebhooksResource {
      * ```
      */
     test(id: string): Promise<WebhookTestResult>;
+    /**
+     * Reset the circuit breaker for a webhook
+     *
+     * Manually resets an open circuit breaker so deliveries resume immediately
+     * instead of waiting for the automatic 5-minute recovery.
+     *
+     * @param id - Webhook ID
+     * @returns Reset confirmation with updated webhook
+     *
+     * @example
+     * ```typescript
+     * const result = await sendly.webhooks.resetCircuit('whk_xxx');
+     * console.log(result.message);
+     * ```
+     */
+    resetCircuit(id: string): Promise<{
+        message: string;
+        webhook: Webhook;
+    }>;
     /**
      * Rotate the webhook signing secret
      *
@@ -2927,6 +2999,57 @@ declare class ContactListsResource {
     private transformList;
 }
 
+/**
+ * Media Resource
+ * @packageDocumentation
+ */
+
+/**
+ * Media API resource
+ *
+ * @example
+ * ```typescript
+ * // Upload an image and send as MMS
+ * const file = fs.readFileSync('photo.jpg');
+ * const media = await sendly.media.upload(file, {
+ *   filename: 'photo.jpg',
+ *   contentType: 'image/jpeg'
+ * });
+ *
+ * await sendly.messages.send({
+ *   to: '+15551234567',
+ *   text: 'Check out this photo!',
+ *   mediaUrls: [media.url]
+ * });
+ * ```
+ */
+declare class MediaResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Upload a media file for use in MMS messages
+     *
+     * @param file - File data as a Buffer or ReadableStream
+     * @param options - Upload options (filename, content type)
+     * @returns The uploaded media file with URL
+     *
+     * @example
+     * ```typescript
+     * const media = await sendly.media.upload(
+     *   fs.readFileSync('image.png'),
+     *   { filename: 'image.png', contentType: 'image/png' }
+     * );
+     *
+     * console.log(media.url); // https://...
+     * ```
+     *
+     * @throws {ValidationError} If the file is invalid or too large
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {RateLimitError} If rate limit is exceeded
+     */
+    upload(file: Buffer | NodeJS.ReadableStream, options?: MediaUploadOptions): Promise<MediaFile>;
+}
+
 /**
  * Sendly Client
  * @packageDocumentation
@@ -3097,6 +3220,26 @@ declare class Sendly {
      * ```
      */
     readonly contacts: ContactsResource;
+    /**
+     * Media API resource - Upload media for MMS
+     *
+     * @example
+     * ```typescript
+     * // Upload a file
+     * const media = await sendly.media.upload(fileBuffer, {
+     *   filename: 'photo.jpg',
+     *   contentType: 'image/jpeg'
+     * });
+     *
+     * // Send as MMS
+     * await sendly.messages.send({
+     *   to: '+15551234567',
+     *   text: 'Check this out!',
+     *   mediaUrls: [media.url]
+     * });
+     * ```
+     */
+    readonly media: MediaResource;
     private readonly http;
     private readonly config;
     /**
@@ -3547,4 +3690,4 @@ declare class Webhooks {
  */
 type WebhookMessageData = WebhookMessageObject;
 
-export { ALL_SUPPORTED_COUNTRIES, type Account, type ApiErrorResponse, type ApiKey, AuthenticationError, type BatchListResponse, type BatchMessageItem, type BatchMessageRequest, type BatchMessageResponse, type BatchMessageResult, type BatchStatus, CREDITS_PER_SMS, type Campaign, type CampaignListResponse, type CampaignPreview, type CampaignStatus, type CancelledMessageResponse, type CheckVerificationRequest, type CheckVerificationResponse, type CircuitState, type Contact, type ContactList, type ContactListResponse, type ContactListsResponse, type CreateCampaignRequest, type CreateContactListRequest, type CreateContactRequest, type CreateTemplateRequest, type CreateVerifySessionRequest, type CreateWebhookOptions, type CreditTransaction, type Credits, type DeliveryStatus, type ImportContactItem, type ImportContactsError, type ImportContactsRequest, type ImportContactsResponse, InsufficientCreditsError, type ListBatchesOptions, type ListCampaignsOptions, type ListContactsOptions, type ListMessagesOptions, type ListScheduledMessagesOptions, type ListVerificationsOptions, type Message, type MessageListResponse, type MessageStatus, type MessageType, NetworkError, NotFoundError, type PricingTier, RateLimitError, type RateLimitInfo, SANDBOX_TEST_NUMBERS, SUPPORTED_COUNTRIES, type ScheduleCampaignRequest, type ScheduleMessageRequest, type ScheduledMessage, type ScheduledMessageListResponse, type ScheduledMessageStatus, type SendMessageRequest, type SendVerificationRequest, type SendVerificationResponse, type SenderType, Sendly, type SendlyConfig, SendlyError, type SendlyErrorCode, type Template, type TemplateListResponse, type TemplatePreview, type TemplateStatus, type TemplateVariable, TimeoutError, type UpdateCampaignRequest, type UpdateContactListRequest, type UpdateContactRequest, type UpdateTemplateRequest, type UpdateWebhookOptions, type ValidateSessionTokenRequest, type ValidateSessionTokenResponse, ValidationError, type Verification, type VerificationDeliveryStatus, type VerificationListResponse, type VerificationStatus, type VerifySession, type VerifySessionStatus, type Webhook, type WebhookCreatedResponse, type WebhookDelivery, type WebhookEvent, type WebhookEventType, type WebhookMessageData, type WebhookMessageStatus, type WebhookSecretRotation, WebhookSignatureError, type WebhookTestResult, Webhooks, calculateSegments, Sendly as default, generateWebhookSignature, getCountryFromPhone, isCountrySupported, parseWebhookEvent, validateMessageText, validatePhoneNumber, validateSenderId, verifyWebhookSignature };
+export { ALL_SUPPORTED_COUNTRIES, type Account, type ApiErrorResponse, type ApiKey, AuthenticationError, type BatchListResponse, type BatchMessageItem, type BatchMessageRequest, type BatchMessageResponse, type BatchMessageResult, type BatchStatus, CREDITS_PER_SMS, type Campaign, type CampaignListResponse, type CampaignPreview, type CampaignStatus, type CancelledMessageResponse, type CheckVerificationRequest, type CheckVerificationResponse, type CircuitState, type Contact, type ContactList, type ContactListResponse, type ContactListsResponse, type CreateCampaignRequest, type CreateContactListRequest, type CreateContactRequest, type CreateTemplateRequest, type CreateVerifySessionRequest, type CreateWebhookOptions, type CreditTransaction, type Credits, type DeliveryStatus, type ImportContactItem, type ImportContactsError, type ImportContactsRequest, type ImportContactsResponse, InsufficientCreditsError, type ListBatchesOptions, type ListCampaignsOptions, type ListContactsOptions, type ListMessagesOptions, type ListScheduledMessagesOptions, type ListVerificationsOptions, type MediaFile, type MediaUploadOptions, type Message, type MessageListResponse, type MessageStatus, type MessageType, NetworkError, NotFoundError, type PricingTier, RateLimitError, type RateLimitInfo, SANDBOX_TEST_NUMBERS, SUPPORTED_COUNTRIES, type ScheduleCampaignRequest, type ScheduleMessageRequest, type ScheduledMessage, type ScheduledMessageListResponse, type ScheduledMessageStatus, type SendMessageRequest, type SendVerificationRequest, type SendVerificationResponse, type SenderType, Sendly, type SendlyConfig, SendlyError, type SendlyErrorCode, type Template, type TemplateListResponse, type TemplatePreview, type TemplateStatus, type TemplateVariable, TimeoutError, type UpdateCampaignRequest, type UpdateContactListRequest, type UpdateContactRequest, type UpdateTemplateRequest, type UpdateWebhookOptions, type ValidateSessionTokenRequest, type ValidateSessionTokenResponse, ValidationError, type Verification, type VerificationDeliveryStatus, type VerificationListResponse, type VerificationStatus, type VerifySession, type VerifySessionStatus, type Webhook, type WebhookCreatedResponse, type WebhookDelivery, type WebhookEvent, type WebhookEventType, type WebhookMessageData, type WebhookMessageStatus, type WebhookSecretRotation, WebhookSignatureError, type WebhookTestResult, Webhooks, calculateSegments, Sendly as default, generateWebhookSignature, getCountryFromPhone, isCountrySupported, parseWebhookEvent, validateMessageText, validatePhoneNumber, validateSenderId, verifyWebhookSignature };

package/dist/index.d.ts

@@ -59,12 +59,17 @@ interface SendMessageRequest {
      * Stored on the message record and included in webhook event payloads.
      */
     metadata?: Record<string, any>;
+    /**
+     * URLs of media files to include as MMS attachments.
+     * Must be publicly accessible HTTPS URLs. Max 10 per message.
+     */
+    mediaUrls?: string[];
 }
 /**
  * Message status values
  * Note: "sending" was removed as it doesn't exist in the database
  */
-type MessageStatus = "queued" | "sent" | "delivered" | "failed" | "bounced";
+type MessageStatus = "queued" | "sent" | "delivered" | "failed" | "bounced" | "retrying";
 /**
  * How the message was sent
  */
@@ -101,6 +106,14 @@ interface Message {
      * Error message if status is "failed"
      */
     error?: string | null;
+    /**
+     * Structured error code (e.g., "E001" for invalid number)
+     */
+    errorCode?: string | null;
+    /**
+     * Number of retry attempts made
+     */
+    retryCount?: number;
     /**
      * Number of SMS segments (1 per 160 chars)
      */
@@ -177,6 +190,42 @@ interface MessageListResponse {
      */
     count: number;
 }
+/**
+ * An uploaded media file for MMS
+ */
+interface MediaFile {
+    /**
+     * Unique media file identifier
+     */
+    id: string;
+    /**
+     * Publicly accessible URL for the media file
+     */
+    url: string;
+    /**
+     * MIME type of the file (e.g., "image/jpeg")
+     */
+    contentType: string;
+    /**
+     * File size in bytes
+     */
+    sizeBytes: number;
+}
+/**
+ * Options for uploading a media file
+ */
+interface MediaUploadOptions {
+    /**
+     * Filename for the upload
+     * @default "upload.jpg"
+     */
+    filename?: string;
+    /**
+     * MIME content type
+     * @default "image/jpeg"
+     */
+    contentType?: string;
+}
 /**
  * Request payload for scheduling an SMS message
  */
@@ -625,7 +674,7 @@ declare const ALL_SUPPORTED_COUNTRIES: string[];
 /**
  * Webhook event types
  */
-type WebhookEventType = "message.sent" | "message.delivered" | "message.failed" | "message.bounced" | "message.queued";
+type WebhookEventType = "message.sent" | "message.delivered" | "message.failed" | "message.bounced" | "message.retrying" | "message.queued";
 /**
  * Webhook mode - filters which events are delivered
  * - "all": Receives all events (sandbox + production)
@@ -1492,6 +1541,10 @@ declare class HttpClient {
      * Make an HTTP request to the API
      */
     request<T>(options: RequestOptions): Promise<T>;
+    /**
+     * Make an HTTP request with a raw body (for multipart uploads)
+     */
+    requestFormData<T>(path: string, body: FormData, headers?: Record<string, string>): Promise<T>;
     /**
      * Execute the HTTP request
      */
@@ -1928,6 +1981,25 @@ declare class WebhooksResource {
      * ```
      */
     test(id: string): Promise<WebhookTestResult>;
+    /**
+     * Reset the circuit breaker for a webhook
+     *
+     * Manually resets an open circuit breaker so deliveries resume immediately
+     * instead of waiting for the automatic 5-minute recovery.
+     *
+     * @param id - Webhook ID
+     * @returns Reset confirmation with updated webhook
+     *
+     * @example
+     * ```typescript
+     * const result = await sendly.webhooks.resetCircuit('whk_xxx');
+     * console.log(result.message);
+     * ```
+     */
+    resetCircuit(id: string): Promise<{
+        message: string;
+        webhook: Webhook;
+    }>;
     /**
      * Rotate the webhook signing secret
      *
@@ -2927,6 +2999,57 @@ declare class ContactListsResource {
     private transformList;
 }
 
+/**
+ * Media Resource
+ * @packageDocumentation
+ */
+
+/**
+ * Media API resource
+ *
+ * @example
+ * ```typescript
+ * // Upload an image and send as MMS
+ * const file = fs.readFileSync('photo.jpg');
+ * const media = await sendly.media.upload(file, {
+ *   filename: 'photo.jpg',
+ *   contentType: 'image/jpeg'
+ * });
+ *
+ * await sendly.messages.send({
+ *   to: '+15551234567',
+ *   text: 'Check out this photo!',
+ *   mediaUrls: [media.url]
+ * });
+ * ```
+ */
+declare class MediaResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Upload a media file for use in MMS messages
+     *
+     * @param file - File data as a Buffer or ReadableStream
+     * @param options - Upload options (filename, content type)
+     * @returns The uploaded media file with URL
+     *
+     * @example
+     * ```typescript
+     * const media = await sendly.media.upload(
+     *   fs.readFileSync('image.png'),
+     *   { filename: 'image.png', contentType: 'image/png' }
+     * );
+     *
+     * console.log(media.url); // https://...
+     * ```
+     *
+     * @throws {ValidationError} If the file is invalid or too large
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {RateLimitError} If rate limit is exceeded
+     */
+    upload(file: Buffer | NodeJS.ReadableStream, options?: MediaUploadOptions): Promise<MediaFile>;
+}
+
 /**
  * Sendly Client
  * @packageDocumentation
@@ -3097,6 +3220,26 @@ declare class Sendly {
      * ```
      */
     readonly contacts: ContactsResource;
+    /**
+     * Media API resource - Upload media for MMS
+     *
+     * @example
+     * ```typescript
+     * // Upload a file
+     * const media = await sendly.media.upload(fileBuffer, {
+     *   filename: 'photo.jpg',
+     *   contentType: 'image/jpeg'
+     * });
+     *
+     * // Send as MMS
+     * await sendly.messages.send({
+     *   to: '+15551234567',
+     *   text: 'Check this out!',
+     *   mediaUrls: [media.url]
+     * });
+     * ```
+     */
+    readonly media: MediaResource;
     private readonly http;
     private readonly config;
     /**
@@ -3547,4 +3690,4 @@ declare class Webhooks {
  */
 type WebhookMessageData = WebhookMessageObject;
 
-export { ALL_SUPPORTED_COUNTRIES, type Account, type ApiErrorResponse, type ApiKey, AuthenticationError, type BatchListResponse, type BatchMessageItem, type BatchMessageRequest, type BatchMessageResponse, type BatchMessageResult, type BatchStatus, CREDITS_PER_SMS, type Campaign, type CampaignListResponse, type CampaignPreview, type CampaignStatus, type CancelledMessageResponse, type CheckVerificationRequest, type CheckVerificationResponse, type CircuitState, type Contact, type ContactList, type ContactListResponse, type ContactListsResponse, type CreateCampaignRequest, type CreateContactListRequest, type CreateContactRequest, type CreateTemplateRequest, type CreateVerifySessionRequest, type CreateWebhookOptions, type CreditTransaction, type Credits, type DeliveryStatus, type ImportContactItem, type ImportContactsError, type ImportContactsRequest, type ImportContactsResponse, InsufficientCreditsError, type ListBatchesOptions, type ListCampaignsOptions, type ListContactsOptions, type ListMessagesOptions, type ListScheduledMessagesOptions, type ListVerificationsOptions, type Message, type MessageListResponse, type MessageStatus, type MessageType, NetworkError, NotFoundError, type PricingTier, RateLimitError, type RateLimitInfo, SANDBOX_TEST_NUMBERS, SUPPORTED_COUNTRIES, type ScheduleCampaignRequest, type ScheduleMessageRequest, type ScheduledMessage, type ScheduledMessageListResponse, type ScheduledMessageStatus, type SendMessageRequest, type SendVerificationRequest, type SendVerificationResponse, type SenderType, Sendly, type SendlyConfig, SendlyError, type SendlyErrorCode, type Template, type TemplateListResponse, type TemplatePreview, type TemplateStatus, type TemplateVariable, TimeoutError, type UpdateCampaignRequest, type UpdateContactListRequest, type UpdateContactRequest, type UpdateTemplateRequest, type UpdateWebhookOptions, type ValidateSessionTokenRequest, type ValidateSessionTokenResponse, ValidationError, type Verification, type VerificationDeliveryStatus, type VerificationListResponse, type VerificationStatus, type VerifySession, type VerifySessionStatus, type Webhook, type WebhookCreatedResponse, type WebhookDelivery, type WebhookEvent, type WebhookEventType, type WebhookMessageData, type WebhookMessageStatus, type WebhookSecretRotation, WebhookSignatureError, type WebhookTestResult, Webhooks, calculateSegments, Sendly as default, generateWebhookSignature, getCountryFromPhone, isCountrySupported, parseWebhookEvent, validateMessageText, validatePhoneNumber, validateSenderId, verifyWebhookSignature };
+export { ALL_SUPPORTED_COUNTRIES, type Account, type ApiErrorResponse, type ApiKey, AuthenticationError, type BatchListResponse, type BatchMessageItem, type BatchMessageRequest, type BatchMessageResponse, type BatchMessageResult, type BatchStatus, CREDITS_PER_SMS, type Campaign, type CampaignListResponse, type CampaignPreview, type CampaignStatus, type CancelledMessageResponse, type CheckVerificationRequest, type CheckVerificationResponse, type CircuitState, type Contact, type ContactList, type ContactListResponse, type ContactListsResponse, type CreateCampaignRequest, type CreateContactListRequest, type CreateContactRequest, type CreateTemplateRequest, type CreateVerifySessionRequest, type CreateWebhookOptions, type CreditTransaction, type Credits, type DeliveryStatus, type ImportContactItem, type ImportContactsError, type ImportContactsRequest, type ImportContactsResponse, InsufficientCreditsError, type ListBatchesOptions, type ListCampaignsOptions, type ListContactsOptions, type ListMessagesOptions, type ListScheduledMessagesOptions, type ListVerificationsOptions, type MediaFile, type MediaUploadOptions, type Message, type MessageListResponse, type MessageStatus, type MessageType, NetworkError, NotFoundError, type PricingTier, RateLimitError, type RateLimitInfo, SANDBOX_TEST_NUMBERS, SUPPORTED_COUNTRIES, type ScheduleCampaignRequest, type ScheduleMessageRequest, type ScheduledMessage, type ScheduledMessageListResponse, type ScheduledMessageStatus, type SendMessageRequest, type SendVerificationRequest, type SendVerificationResponse, type SenderType, Sendly, type SendlyConfig, SendlyError, type SendlyErrorCode, type Template, type TemplateListResponse, type TemplatePreview, type TemplateStatus, type TemplateVariable, TimeoutError, type UpdateCampaignRequest, type UpdateContactListRequest, type UpdateContactRequest, type UpdateTemplateRequest, type UpdateWebhookOptions, type ValidateSessionTokenRequest, type ValidateSessionTokenResponse, ValidationError, type Verification, type VerificationDeliveryStatus, type VerificationListResponse, type VerificationStatus, type VerifySession, type VerifySessionStatus, type Webhook, type WebhookCreatedResponse, type WebhookDelivery, type WebhookEvent, type WebhookEventType, type WebhookMessageData, type WebhookMessageStatus, type WebhookSecretRotation, WebhookSignatureError, type WebhookTestResult, Webhooks, calculateSegments, Sendly as default, generateWebhookSignature, getCountryFromPhone, isCountrySupported, parseWebhookEvent, validateMessageText, validatePhoneNumber, validateSenderId, verifyWebhookSignature };

package/dist/index.js

@@ -268,6 +268,44 @@ var HttpClient = class {
     }
     throw lastError || new NetworkError("Request failed after retries");
   }
+  /**
+   * Make an HTTP request with a raw body (for multipart uploads)
+   */
+  async requestFormData(path, body, headers = {}) {
+    const url = this.buildUrl(path);
+    const baseHeaders = this.buildHeaders();
+    delete baseHeaders["Content-Type"];
+    const mergedHeaders = { ...baseHeaders, ...headers };
+    let lastError;
+    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+      try {
+        const response = await this.executeRequest(url, {
+          method: "POST",
+          headers: mergedHeaders,
+          body
+        });
+        this.updateRateLimitInfo(response.headers);
+        const data = await this.parseResponse(response);
+        return data;
+      } catch (error) {
+        lastError = error;
+        if (error instanceof SendlyError) {
+          if (error.statusCode === 401 || error.statusCode === 403 || error.statusCode === 400 || error.statusCode === 404 || error.statusCode === 402) {
+            throw error;
+          }
+          if (error instanceof RateLimitError) {
+            throw error;
+          }
+        }
+        if (attempt < this.config.maxRetries) {
+          const backoffTime = this.calculateBackoff(attempt);
+          await this.sleep(backoffTime);
+          continue;
+        }
+      }
+    }
+    throw lastError || new NetworkError("Request failed after retries");
+  }
   /**
    * Execute the HTTP request
    */
@@ -640,7 +678,8 @@ var MessagesResource = class {
         text: request.text,
         ...request.from && { from: request.from },
         ...request.messageType && { messageType: request.messageType },
-        ...request.metadata && { metadata: request.metadata }
+        ...request.metadata && { metadata: request.metadata },
+        ...request.mediaUrls && { mediaUrls: request.mediaUrls }
       }
     });
     return message;
@@ -1246,6 +1285,31 @@ var WebhooksResource = class {
     });
     return transformKeys(response);
   }
+  /**
+   * Reset the circuit breaker for a webhook
+   *
+   * Manually resets an open circuit breaker so deliveries resume immediately
+   * instead of waiting for the automatic 5-minute recovery.
+   *
+   * @param id - Webhook ID
+   * @returns Reset confirmation with updated webhook
+   *
+   * @example
+   * ```typescript
+   * const result = await sendly.webhooks.resetCircuit('whk_xxx');
+   * console.log(result.message);
+   * ```
+   */
+  async resetCircuit(id) {
+    if (!id || !id.startsWith("whk_")) {
+      throw new Error("Invalid webhook ID format");
+    }
+    const response = await this.http.request({
+      method: "POST",
+      path: `/webhooks/${encodeURIComponent(id)}/reset-circuit`
+    });
+    return transformKeys(response);
+  }
   /**
    * Rotate the webhook signing secret
    *
@@ -2732,6 +2796,43 @@ var ContactListsResource = class {
   }
 };
 
+// src/resources/media.ts
+var MediaResource = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Upload a media file for use in MMS messages
+   *
+   * @param file - File data as a Buffer or ReadableStream
+   * @param options - Upload options (filename, content type)
+   * @returns The uploaded media file with URL
+   *
+   * @example
+   * ```typescript
+   * const media = await sendly.media.upload(
+   *   fs.readFileSync('image.png'),
+   *   { filename: 'image.png', contentType: 'image/png' }
+   * );
+   *
+   * console.log(media.url); // https://...
+   * ```
+   *
+   * @throws {ValidationError} If the file is invalid or too large
+   * @throws {AuthenticationError} If the API key is invalid
+   * @throws {RateLimitError} If rate limit is exceeded
+   */
+  async upload(file, options) {
+    const filename = options?.filename || "upload.jpg";
+    const contentType = options?.contentType || "image/jpeg";
+    const blob = file instanceof Buffer ? new Blob([file], { type: contentType }) : file;
+    const form = new FormData();
+    form.append("file", blob, filename);
+    return this.http.requestFormData("/media", form);
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL2 = "https://sendly.live/api/v1";
 var DEFAULT_TIMEOUT2 = 3e4;
@@ -2870,6 +2971,26 @@ var Sendly = class {
    * ```
    */
   contacts;
+  /**
+   * Media API resource - Upload media for MMS
+   *
+   * @example
+   * ```typescript
+   * // Upload a file
+   * const media = await sendly.media.upload(fileBuffer, {
+   *   filename: 'photo.jpg',
+   *   contentType: 'image/jpeg'
+   * });
+   *
+   * // Send as MMS
+   * await sendly.messages.send({
+   *   to: '+15551234567',
+   *   text: 'Check this out!',
+   *   mediaUrls: [media.url]
+   * });
+   * ```
+   */
+  media;
   http;
   config;
   /**
@@ -2906,6 +3027,7 @@ var Sendly = class {
     this.templates = new TemplatesResource(this.http);
     this.campaigns = new CampaignsResource(this.http);
     this.contacts = new ContactsResource(this.http);
+    this.media = new MediaResource(this.http);
   }
   /**
    * Check if the client is using a test API key

package/dist/index.mjs

@@ -208,6 +208,44 @@ var HttpClient = class {
     }
     throw lastError || new NetworkError("Request failed after retries");
   }
+  /**
+   * Make an HTTP request with a raw body (for multipart uploads)
+   */
+  async requestFormData(path, body, headers = {}) {
+    const url = this.buildUrl(path);
+    const baseHeaders = this.buildHeaders();
+    delete baseHeaders["Content-Type"];
+    const mergedHeaders = { ...baseHeaders, ...headers };
+    let lastError;
+    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+      try {
+        const response = await this.executeRequest(url, {
+          method: "POST",
+          headers: mergedHeaders,
+          body
+        });
+        this.updateRateLimitInfo(response.headers);
+        const data = await this.parseResponse(response);
+        return data;
+      } catch (error) {
+        lastError = error;
+        if (error instanceof SendlyError) {
+          if (error.statusCode === 401 || error.statusCode === 403 || error.statusCode === 400 || error.statusCode === 404 || error.statusCode === 402) {
+            throw error;
+          }
+          if (error instanceof RateLimitError) {
+            throw error;
+          }
+        }
+        if (attempt < this.config.maxRetries) {
+          const backoffTime = this.calculateBackoff(attempt);
+          await this.sleep(backoffTime);
+          continue;
+        }
+      }
+    }
+    throw lastError || new NetworkError("Request failed after retries");
+  }
   /**
    * Execute the HTTP request
    */
@@ -580,7 +618,8 @@ var MessagesResource = class {
         text: request.text,
         ...request.from && { from: request.from },
         ...request.messageType && { messageType: request.messageType },
-        ...request.metadata && { metadata: request.metadata }
+        ...request.metadata && { metadata: request.metadata },
+        ...request.mediaUrls && { mediaUrls: request.mediaUrls }
       }
     });
     return message;
@@ -1186,6 +1225,31 @@ var WebhooksResource = class {
     });
     return transformKeys(response);
   }
+  /**
+   * Reset the circuit breaker for a webhook
+   *
+   * Manually resets an open circuit breaker so deliveries resume immediately
+   * instead of waiting for the automatic 5-minute recovery.
+   *
+   * @param id - Webhook ID
+   * @returns Reset confirmation with updated webhook
+   *
+   * @example
+   * ```typescript
+   * const result = await sendly.webhooks.resetCircuit('whk_xxx');
+   * console.log(result.message);
+   * ```
+   */
+  async resetCircuit(id) {
+    if (!id || !id.startsWith("whk_")) {
+      throw new Error("Invalid webhook ID format");
+    }
+    const response = await this.http.request({
+      method: "POST",
+      path: `/webhooks/${encodeURIComponent(id)}/reset-circuit`
+    });
+    return transformKeys(response);
+  }
   /**
    * Rotate the webhook signing secret
    *
@@ -2672,6 +2736,43 @@ var ContactListsResource = class {
   }
 };
 
+// src/resources/media.ts
+var MediaResource = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Upload a media file for use in MMS messages
+   *
+   * @param file - File data as a Buffer or ReadableStream
+   * @param options - Upload options (filename, content type)
+   * @returns The uploaded media file with URL
+   *
+   * @example
+   * ```typescript
+   * const media = await sendly.media.upload(
+   *   fs.readFileSync('image.png'),
+   *   { filename: 'image.png', contentType: 'image/png' }
+   * );
+   *
+   * console.log(media.url); // https://...
+   * ```
+   *
+   * @throws {ValidationError} If the file is invalid or too large
+   * @throws {AuthenticationError} If the API key is invalid
+   * @throws {RateLimitError} If rate limit is exceeded
+   */
+  async upload(file, options) {
+    const filename = options?.filename || "upload.jpg";
+    const contentType = options?.contentType || "image/jpeg";
+    const blob = file instanceof Buffer ? new Blob([file], { type: contentType }) : file;
+    const form = new FormData();
+    form.append("file", blob, filename);
+    return this.http.requestFormData("/media", form);
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL2 = "https://sendly.live/api/v1";
 var DEFAULT_TIMEOUT2 = 3e4;
@@ -2810,6 +2911,26 @@ var Sendly = class {
    * ```
    */
   contacts;
+  /**
+   * Media API resource - Upload media for MMS
+   *
+   * @example
+   * ```typescript
+   * // Upload a file
+   * const media = await sendly.media.upload(fileBuffer, {
+   *   filename: 'photo.jpg',
+   *   contentType: 'image/jpeg'
+   * });
+   *
+   * // Send as MMS
+   * await sendly.messages.send({
+   *   to: '+15551234567',
+   *   text: 'Check this out!',
+   *   mediaUrls: [media.url]
+   * });
+   * ```
+   */
+  media;
   http;
   config;
   /**
@@ -2846,6 +2967,7 @@ var Sendly = class {
     this.templates = new TemplatesResource(this.http);
     this.campaigns = new CampaignsResource(this.http);
     this.contacts = new ContactsResource(this.http);
+    this.media = new MediaResource(this.http);
   }
   /**
    * Check if the client is using a test API key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendly/node",
-  "version": "3.15.3",
+  "version": "3.18.0",
   "description": "Official Sendly Node.js SDK for SMS messaging",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",