mailchannels-sdk 0.6.0 → 0.6.1

package/README.md

@@ -43,8 +43,8 @@ This library provides a simple way to interact with the [MailChannels API](https
 
 ## <a name="requirements">📏 Requirements</a>
 
-- MailChannels account
-- Email API key
+- [Create a MailChannels account](https://www.mailchannels.com/pricing/#for_devs)
+- [Create an API key](https://console.mailchannels.net/settings/accountSettings#APIKeys)
 
 ## <a name="quick-setup">🏃 Quick setup</a>
 

package/dist/mailchannels.d.mts

@@ -17,11 +17,20 @@ interface SuccessResponse {
    * Whether the operation was successful.
    */
   success: boolean;
+  /**
+   * Error message if the operation failed.
+   */
   error: string | null;
 }
 
 interface DataResponse<T> {
+  /**
+   * The response data.
+   */
   data: T | null;
+  /**
+   * Error message if the operation failed.
+   */
   error: string | null;
 }
 

package/dist/mailchannels.d.ts

@@ -17,11 +17,20 @@ interface SuccessResponse {
    * Whether the operation was successful.
    */
   success: boolean;
+  /**
+   * Error message if the operation failed.
+   */
   error: string | null;
 }
 
 interface DataResponse<T> {
+  /**
+   * The response data.
+   */
   data: T | null;
+  /**
+   * Error message if the operation failed.
+   */
   error: string | null;
 }
 

package/dist/mailchannels.mjs

@@ -63,33 +63,37 @@ const getStatusError = (response, errors = {}) => {
   }
   return details ? `${statusText} ${details}` : statusText;
 };
+function getResultError(result, error, fallback) {
+  if (result.error) return result.error;
+  return error instanceof Error ? error.message : fallback;
+}
 
+const isValidEmail = (email) => {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+};
 const parseRecipientString = (input) => {
   const trimmed = input.trim();
-  const match = trimmed.match(/^([^<]*)<([^@\s]+@[^>\s]+)>$/);
+  const match = trimmed.match(/^([^<]*)<([^>]*)>$/);
   if (match) {
     const [, name, email] = match;
-    return { email: email?.trim() || "", name: name?.trim() };
+    if (!email?.trim() || !isValidEmail(email.trim())) return void 0;
+    return { email: email.trim(), name: name?.trim() };
   }
+  if (!isValidEmail(trimmed)) return void 0;
   return { email: trimmed };
 };
 const parseRecipient = (recipient) => {
   if (typeof recipient === "string") {
     return parseRecipientString(recipient);
   }
-  if (recipient?.email) {
-    return { email: recipient.email, name: recipient.name };
-  }
+  if (!recipient?.email || !isValidEmail(recipient.email)) return void 0;
+  return { email: recipient.email, name: recipient.name };
 };
 const parseArrayRecipients = (recipients) => {
-  if (!recipients) return;
-  if (typeof recipients === "string") {
-    return [parseRecipientString(recipients)];
-  }
-  if (Array.isArray(recipients)) {
-    return recipients.map((recipient) => parseRecipient(recipient)).filter((recipient) => Boolean(recipient));
-  }
-  return [recipients];
+  if (!recipients) return void 0;
+  const arr = typeof recipients === "string" ? [parseRecipientString(recipients)] : Array.isArray(recipients) ? recipients.map(parseRecipient) : [recipients];
+  const filtered = arr.filter((recipient) => Boolean(recipient));
+  return filtered.length > 0 ? filtered : void 0;
 };
 
 const stripPemHeaders = (pem) => pem.replace(/-----[^-]+-----|\s|#.*$/gm, "");
@@ -119,6 +123,21 @@ const clean = (data) => {
   }
   return data;
 };
+const validateLimit = (limit, max) => {
+  if (typeof limit === "number" && (limit < 1 || max && limit > max)) {
+    return "The limit value " + (max ? `must be between 1 and ${max}.` : "is invalid. Only positive values are allowed.");
+  }
+  return null;
+};
+const validateOffset = (offset) => {
+  if (typeof offset === "number" && offset < 0) {
+    return "Offset must be greater than or equal to 0.";
+  }
+  return null;
+};
+const mapBuckets = (arr) => {
+  return arr.map(({ count, period_start }) => ({ count, periodStart: period_start }));
+};
 
 class Emails {
   constructor(mailchannels) {
@@ -197,7 +216,10 @@ class Emails {
           [ErrorCode.PayloadTooLarge]: "The total message size should not exceed 30MB. This includes the message itself, headers, and the combined size of any attachments."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to send email.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       rendered: response.data,
@@ -249,7 +271,10 @@ class Emails {
           [ErrorCode.Forbidden]: "User does not have access to this feature."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to check domain.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       dkim: response.check_results.dkim.map((dkimResults) => ({
@@ -297,7 +322,10 @@ class Emails {
           [ErrorCode.Conflict]: "Key pair already created for domain, and selector."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create DKIM key.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       algorithm: response.algorithm,
@@ -329,17 +357,11 @@ class Emails {
   async getDkimKeys(domain, options) {
     const result = { data: null, error: null };
     if (options?.selector && options.selector.length > 63) {
-      result.error = "Selector must be a maximum of 63 characters.";
-      return result;
-    }
-    if (typeof options?.limit === "number" && (options.limit < 1 || options.limit > 100)) {
-      result.error = "Limit must be between 1 and 100.";
-      return result;
-    }
-    if (typeof options?.offset === "number" && options.offset < 0) {
-      result.error = "Offset value is invalid. Only positive values are allowed.";
+      result.error = "Selector must be between 1 and 63 characters.";
       return result;
     }
+    result.error = validateLimit(options?.limit, 100) || validateOffset(options?.offset);
+    if (result.error) return result;
     const payload = {
       selector: options?.selector,
       status: options?.status,
@@ -354,7 +376,10 @@ class Emails {
           [ErrorCode.BadRequest]: "Bad Request."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch DKIM keys.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.keys.map((key) => ({
       algorithm: key.algorithm,
@@ -394,6 +419,7 @@ class Emails {
     };
     await this.mailchannels.patch(`/tx/v1/domains/${domain}/dkim-keys/${options.selector}`, {
       body: payload,
+      ignoreResponseError: true,
       onResponse: async ({ response }) => {
         if (response.ok) {
           result.success = true;
@@ -405,7 +431,7 @@ class Emails {
         });
       }
     }).catch((error) => {
-      result.error = error instanceof Error ? error.message : "Failed to update DKIM key.";
+      result.error = getResultError(result, error, "Failed to update DKIM key.");
     });
     return result;
   }
@@ -450,9 +476,7 @@ class Emails {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to rotate DKIM key.";
-      }
+      result.error = getResultError(result, error, "Failed to rotate DKIM key.");
       return null;
     });
     if (!response) return result;
@@ -525,6 +549,8 @@ class Webhooks {
           [ErrorCode.Conflict]: `Endpoint '${endpoint}' is already enrolled to receive notifications.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to enroll webhook.");
     });
     return result;
   }
@@ -543,9 +569,7 @@ class Webhooks {
         result.error = getStatusError(response2);
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch webhooks.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch webhooks.");
       return null;
     });
     if (!response) return result;
@@ -571,6 +595,8 @@ class Webhooks {
         }
         result.success = true;
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete webhooks.");
     });
     return result;
   }
@@ -589,13 +615,16 @@ class Webhooks {
       query: {
         id
       },
-      onResponseError: ({ response: response2 }) => {
+      onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2, {
           [ErrorCode.BadRequest]: "Bad Request.",
           [ErrorCode.NotFound]: `The key '${id}' is not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to get signing key.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({ key: response.key });
     return result;
@@ -619,13 +648,16 @@ class Webhooks {
       body: {
         request_id: requestId
       },
-      onResponseError: ({ response: response2 }) => {
+      onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2, {
           [ErrorCode.BadRequest]: "Bad Request.",
           [ErrorCode.NotFound]: "No webhooks found for the account."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to validate webhooks.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       allPassed: response.all_passed,
@@ -670,13 +702,16 @@ class SubAccounts {
         company_name: companyName,
         handle
       },
-      onResponseError: ({ response: response2 }) => {
+      onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2, {
           [ErrorCode.Forbidden]: "The parent account does not have permission to create sub-accounts.",
           [ErrorCode.Conflict]: `Sub-account with handle '${handle}' already exists.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create sub-account.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       companyName: response.company_name,
@@ -696,23 +731,15 @@ class SubAccounts {
    */
   async list(options) {
     const result = { data: null, error: null };
-    if (typeof options?.limit === "number" && (options.limit < 1 || options.limit > 1e3)) {
-      result.error = "The limit value is invalid. Possible limit values are 1 to 1000.";
-      return result;
-    }
-    if (typeof options?.offset === "number" && options.offset < 0) {
-      result.error = "Offset must be greater than or equal to 0.";
-      return result;
-    }
+    result.error = validateLimit(options?.limit, 1e3) || validateOffset(options?.offset);
+    if (result.error) return result;
     const response = await this.mailchannels.get("/tx/v1/sub-account", {
       query: options,
       onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2);
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch sub-accounts.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch sub-accounts.");
       return null;
     });
     if (!response) return result;
@@ -746,6 +773,8 @@ class SubAccounts {
         }
         result.success = true;
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete sub-account.");
     });
     return result;
   }
@@ -775,6 +804,8 @@ class SubAccounts {
           [ErrorCode.NotFound]: `The specified sub-account '${handle}' does not exist.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to suspend sub-account.");
     });
     return result;
   }
@@ -805,6 +836,8 @@ class SubAccounts {
           [ErrorCode.NotFound]: `The specified sub-account '${handle}' does not exist.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to activate sub-account.");
     });
     return result;
   }
@@ -831,7 +864,10 @@ class SubAccounts {
           [ErrorCode.UnprocessableEntity]: "You have reached the limit of API keys you can create for this sub-account."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create sub-account API key.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       id: response.id,
@@ -855,21 +891,18 @@ class SubAccounts {
       result.error = "No handle provided.";
       return result;
     }
-    if (typeof options?.limit === "number" && (options.limit < 1 || options.limit > 1e3)) {
-      result.error = "The limit value is invalid. Possible limit values are 1 to 1000.";
-      return result;
-    }
-    if (typeof options?.offset === "number" && options.offset < 0) {
-      result.error = "Offset must be greater than or equal to 0.";
-      return result;
-    }
+    result.error = validateLimit(options?.limit, 1e3) || validateOffset(options?.offset);
+    if (result.error) return result;
     const response = await this.mailchannels.get(`/tx/v1/sub-account/${handle}/api-key`, {
       onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2, {
           [ErrorCode.NotFound]: `Sub-account with handle '${handle}' not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch sub-account API keys.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.map((key) => ({
       id: key.id,
@@ -904,6 +937,8 @@ class SubAccounts {
           [ErrorCode.BadRequest]: "Missing or invalid API key ID."
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete sub-account API key.");
     });
     return result;
   }
@@ -930,7 +965,10 @@ class SubAccounts {
           [ErrorCode.UnprocessableEntity]: "You have reached the limit of SMTP passwords you can create for this sub-account."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create sub-account SMTP password.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       enabled: response.enabled,
@@ -960,7 +998,10 @@ class SubAccounts {
           [ErrorCode.NotFound]: `Sub-account with handle '${handle}' not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch sub-account SMTP passwords.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.map((password) => ({
       enabled: password.enabled,
@@ -996,6 +1037,8 @@ class SubAccounts {
           [ErrorCode.BadRequest]: "Missing or invalid SMTP password ID."
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete sub-account SMTP password.");
     });
     return result;
   }
@@ -1020,7 +1063,10 @@ class SubAccounts {
           [ErrorCode.NotFound]: `Sub-account with handle '${handle}' not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch sub-account limit.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response);
     return result;
@@ -1054,6 +1100,8 @@ class SubAccounts {
           [ErrorCode.NotFound]: `Sub-account with handle '${handle}' not found.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to set sub-account limit.");
     });
     return result;
   }
@@ -1083,6 +1131,8 @@ class SubAccounts {
           [ErrorCode.NotFound]: `Sub-account with handle '${handle}' not found.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete sub-account limit.");
     });
     return result;
   }
@@ -1107,7 +1157,10 @@ class SubAccounts {
           [ErrorCode.NotFound]: `Sub-account with handle '${handle}' not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch sub-account usage.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       endDate: response.period_end_date,
@@ -1118,9 +1171,6 @@ class SubAccounts {
   }
 }
 
-const mapBuckets = (arr) => {
-  return arr.map(({ count, period_start }) => ({ count, periodStart: period_start }));
-};
 class Metrics {
   constructor(mailchannels) {
     this.mailchannels = mailchannels;
@@ -1149,9 +1199,7 @@ class Metrics {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch engagement metrics.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch engagement metrics.");
       return null;
     });
     if (!response) return result;
@@ -1195,9 +1243,7 @@ class Metrics {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch performance metrics.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch performance metrics.");
       return null;
     });
     if (!response) return result;
@@ -1239,9 +1285,7 @@ class Metrics {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch recipient behaviour metrics.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch recipient behaviour metrics.");
       return null;
     });
     if (!response) return result;
@@ -1281,9 +1325,7 @@ class Metrics {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch volume metrics.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch volume metrics.");
       return null;
     });
     if (!response) return result;
@@ -1316,9 +1358,7 @@ class Metrics {
         result.error = getStatusError(response2);
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch usage metrics.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch usage metrics.");
       return null;
     });
     if (!response) return result;
@@ -1341,6 +1381,8 @@ class Metrics {
    */
   async senders(type, options) {
     const result = { data: null, error: null };
+    result.error = validateLimit(options?.limit, 1e3) || validateOffset(options?.offset);
+    if (result.error) return result;
     const response = await this.mailchannels.get(`/tx/v1/metrics/senders/${type}`, {
       query: {
         start_time: options?.startTime,
@@ -1355,9 +1397,7 @@ class Metrics {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch senders metrics.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch senders metrics.");
       return null;
     });
     if (!response) return result;
@@ -1413,6 +1453,8 @@ class Suppressions {
           [ErrorCode.PayloadTooLarge]: "Payload too large. The request exceeds the maximum allowed total of 1000 suppression entries for the parent account and/or its sub-accounts."
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create suppression entries.");
     });
     return result;
   }
@@ -1442,6 +1484,8 @@ class Suppressions {
           [ErrorCode.BadRequest]: "Bad Request."
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete suppression entry.");
     });
     return result;
   }
@@ -1456,14 +1500,8 @@ class Suppressions {
    */
   async list(options) {
     const result = { data: null, error: null };
-    if (typeof options?.limit === "number" && (options.limit < 1 || options.limit > 1e3)) {
-      result.error = "The limit must be between 1 and 1000.";
-      return result;
-    }
-    if (typeof options?.offset === "number" && options.offset < 0) {
-      result.error = "Offset must be greater than or equal to 0.";
-      return result;
-    }
+    result.error = validateLimit(options?.limit, 1e3) || validateOffset(options?.offset);
+    if (result.error) return result;
     const payload = {
       recipient: options?.recipient,
       source: options?.source,
@@ -1479,7 +1517,10 @@ class Suppressions {
           [ErrorCode.BadRequest]: "Bad Request."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch suppression entries.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.suppression_list.map((entry) => ({
       createdAt: entry.created_at,
@@ -1526,9 +1567,7 @@ class Domains {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to provision domain.";
-      }
+      result.error = getResultError(result, error, "Failed to provision domain.");
       return null;
     });
     result.data = clean(response);
@@ -1579,9 +1618,7 @@ class Domains {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to provision domains.";
-      }
+      result.error = getResultError(result, error, "Failed to provision domains.");
       return null;
     });
     if (!response) return result;
@@ -1599,20 +1636,17 @@ class Domains {
    */
   async list(options) {
     const result = { data: null, error: null };
-    if (typeof options?.limit === "number" && (options.limit < 1 || options.limit > 5e3)) {
-      result.error = "The limit value is invalid. Possible limit values are 1 to 5000.";
-      return result;
-    }
-    if (typeof options?.offset === "number" && options.offset < 0) {
-      result.error = "Offset must be greater than or equal to 0.";
-      return result;
-    }
+    result.error = validateLimit(options?.limit, 5e3) || validateOffset(options?.offset);
+    if (result.error) return result;
     const response = await this.mailchannels.get("/inbound/v1/domains", {
       query: options,
       onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2);
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch domains.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       domains: response.domains,
@@ -1647,6 +1681,8 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete domain.");
     });
     return result;
   }
@@ -1682,7 +1718,10 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to add domain list entry.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       action: response.action,
@@ -1718,7 +1757,10 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch domain list entries.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.map(({ action, item, item_type }) => ({
       action,
@@ -1764,6 +1806,8 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete domain list entry.");
     });
     return result;
   }
@@ -1790,7 +1834,10 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create login link.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       link: response.loginLink
@@ -1837,6 +1884,8 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to set downstream address.");
     });
     return result;
   }
@@ -1856,14 +1905,8 @@ class Domains {
       result.error = "No domain provided.";
       return result;
     }
-    if (typeof options?.limit === "number" && options.limit < 1) {
-      result.error = "The limit value is invalid. Only positive values are allowed.";
-      return result;
-    }
-    if (typeof options?.offset === "number" && options.offset < 0) {
-      result.error = "Offset must be greater than or equal to 0.";
-      return result;
-    }
+    result.error = validateLimit(options?.limit) || validateOffset(options?.offset);
+    if (result.error) return result;
     const response = await this.mailchannels.get(`/inbound/v1/domains/${domain}/downstream-address`, {
       query: options,
       onResponseError: async ({ response: response2 }) => {
@@ -1872,7 +1915,10 @@ class Domains {
           [ErrorCode.NotFound]: `The domain '${domain}' was not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to list downstream addresses.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.records);
     return result;
@@ -1910,6 +1956,8 @@ class Domains {
           [ErrorCode.NotFound]: "The domain does not exist."
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to update domain API key.");
     });
     return result;
   }
@@ -1941,7 +1989,10 @@ class Domains {
           [ErrorCode.BadRequest]: "Bad Request."
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create login links.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response);
     return result;
@@ -1976,7 +2027,10 @@ class Lists {
       onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2);
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to add list entry.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       action: response.action,
@@ -2004,7 +2058,10 @@ class Lists {
       onResponseError: async ({ response: response2 }) => {
         result.error = getStatusError(response2);
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch list entries.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.map(({ action, item, item_type }) => ({
       action,
@@ -2042,6 +2099,8 @@ class Lists {
         }
         result.error = getStatusError(response);
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete list entry.");
     });
     return result;
   }
@@ -2084,7 +2143,10 @@ class Users {
           [ErrorCode.BadRequest]: `The email address '${email}' is invalid.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to create user.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       email: response.recipient.email_address,
@@ -2130,7 +2192,10 @@ class Users {
           [ErrorCode.NotFound]: `The recipient '${email}' was not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to add user list entry.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean({
       action: response.action,
@@ -2166,7 +2231,10 @@ class Users {
           [ErrorCode.NotFound]: `The recipient '${email}' was not found.`
         });
       }
-    }).catch(() => null);
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch user list entries.");
+      return null;
+    });
     if (!response) return result;
     result.data = clean(response.map(({ action, item, item_type }) => ({
       action,
@@ -2212,6 +2280,8 @@ class Users {
           [ErrorCode.NotFound]: `The recipient '${email}' was not found.`
         });
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to delete user list entry.");
     });
     return result;
   }
@@ -2240,6 +2310,8 @@ class Service {
         }
         result.error = getStatusError(response);
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to fetch service status.");
     });
     return result;
   }
@@ -2260,9 +2332,7 @@ class Service {
         });
       }
     }).catch((error) => {
-      if (!result.error) {
-        result.error = error instanceof Error ? error.message : "Failed to fetch subscriptions.";
-      }
+      result.error = getResultError(result, error, "Failed to fetch subscriptions.");
       return null;
     });
     if (!response) return result;
@@ -2288,6 +2358,7 @@ class Service {
         report_type: type
       },
       body: payload,
+      ignoreResponseError: true,
       onResponse: async ({ response }) => {
         if (response.ok) {
           result.success = true;
@@ -2295,6 +2366,8 @@ class Service {
         }
         result.error = getStatusError(response);
       }
+    }).catch((error) => {
+      result.error = getResultError(result, error, "Failed to submit report.");
     });
     return result;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailchannels-sdk",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Node.js SDK to integrate MailChannels API into your JavaScript or TypeScript server-side applications.",
   "type": "module",
   "license": "MIT",
@@ -40,10 +40,10 @@
     "@eslint/compat": "^2.0.0",
     "@stylistic/eslint-plugin": "^5.6.1",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^24.10.1",
-    "@typescript-eslint/eslint-plugin": "^8.48.1",
-    "@typescript-eslint/parser": "^8.48.1",
-    "@vitest/coverage-v8": "^4.0.14",
+    "@types/node": "^25.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.49.0",
+    "@typescript-eslint/parser": "^8.49.0",
+    "@vitest/coverage-v8": "^4.0.15",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.1",
     "eslint-plugin-import-x": "^4.16.1",
@@ -54,7 +54,7 @@
     "vitepress": "^1.6.4",
     "vitepress-plugin-group-icons": "^1.6.5",
     "vitepress-plugin-llms": "^1.9.3",
-    "vitest": "^4.0.14"
+    "vitest": "^4.0.15"
   },
   "scripts": {
     "build": "unbuild",
@@ -65,7 +65,7 @@
     "test:types": "tsc --noEmit",
     "test:watch": "vitest watch",
     "docs:dev": "vitepress dev docs",
-    "docs:build": "(git fetch --unshallow || git fetch --all) && vitepress build docs",
+    "docs:build": "(git fetch --unshallow -q || git fetch --all -q) && vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "docs:snippets": "jiti docs/scripts/snippets"
   }