mailchannels-sdk 0.8.0 → 1.0.0

package/README.md

@@ -1,11 +1,15 @@
-![MailChannels Node.js SDK](./docs/public/images/presentation.png)
+![MailChannels Node.js SDK](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/raw/HEAD/docs/public/images/presentation.png)
 
 # MailChannels Node.js SDK
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Build Status][build-status-src]][build-status-href]
+[![License][license-src]][license-href]
+[![TypeScript][typescript-src]][typescript-href]
+[![Node.js][node-src]][node-href]
 
-> Built and tested against Email API `0.21.1`
+> Built and tested against Email API `1.0.0`
 
 Node.js SDK to integrate [MailChannels Email API](https://docs.mailchannels.net/email-api) into your JavaScript or TypeScript server-side applications.
 
@@ -13,7 +17,7 @@ Node.js SDK to integrate [MailChannels Email API](https://docs.mailchannels.net/
 This library provides a simple way to interact with the [MailChannels Email API](https://docs.mailchannels.net/email-api). It is written in TypeScript and can be used in both JavaScript and TypeScript projects and in different runtimes.
 <!-- #endregion overview -->
 
-- [✨ Release Notes](CHANGELOG.md)
+- [✨ Release Notes](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/CHANGELOG.md)
 - [📖 Documentation](https://mailchannels.yizack.com)
 
 ## Contents
@@ -180,12 +184,11 @@ The next planned expansion is outbound webhook delivery so client applications c
 
 ## <a name="license">⚖️ License</a>
 
-[MIT License](LICENSE)
+[MIT License](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/LICENSE)
 
 ## <a name="development">💻 Development</a>
 
-<details>
-  <summary>Local development</summary>
+Local development
 
 ```sh
 # Install dependencies
@@ -204,7 +207,7 @@ pnpm test:watch
 # Run typecheck
 pnpm test:types
 
-# Refresh API parity fixtures
+# Refresh API parity fixtures, specs, and README version note
 pnpm parity:fixtures
 
 # Run the local simulator
@@ -217,11 +220,21 @@ pnpx jiti playground/emails/send.ts
 pnpm release
 ```
 
-</details>
-
 <!-- Badges -->
 [npm-version-src]: https://img.shields.io/npm/v/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
 [npm-version-href]: https://npmjs.com/package/mailchannels-sdk
 
 [npm-downloads-src]: https://img.shields.io/npm/dm/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
 [npm-downloads-href]: https://npmjs.com/package/mailchannels-sdk
+
+[build-status-src]: https://img.shields.io/bitbucket/pipelines/mailchannels/mailchannels-email-api-sdk-js/main.svg?style=flat&colorA=070a30
+[build-status-href]: https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/pipelines
+
+[license-src]: https://img.shields.io/npm/l/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
+[license-href]: https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/LICENSE
+
+[typescript-src]: https://img.shields.io/badge/TypeScript-supported-35a047?style=flat&colorA=070a30
+[typescript-href]: https://www.typescriptlang.org
+
+[node-src]: https://img.shields.io/node/v/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
+[node-href]: https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/package.json

package/dist/mailchannels.d.mts

@@ -44,6 +44,7 @@ declare class MailChannelsClient {
   put<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
   patch<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
 }
+type ErrorType = "invalid_request_error" | "authentication_error" | "permission_error" | "not_found" | "conflict_error" | "payload_too_large_error" | "unprocessable_entity_error" | "rate_limit_error" | "internal_server_error" | "validation_error" | "application_error" | "api_error";
 interface ErrorResponse {
   /**
    * A human-readable description of the error.
@@ -55,6 +56,12 @@ interface ErrorResponse {
    * This field is intended for diagnostic use only and should not be relied upon.
    */
   statusCode: number | null;
+  /**
+   * A string identifier for the type of error.
+   *
+   * This field is intended for diagnostic use only and should not be relied upon.
+   */
+  type: ErrorType;
 }
 interface SuccessResponse {
   /**
@@ -1760,9 +1767,7 @@ declare class Suppressions {
 type AttachmentOptions = Omit<EmailsSendAttachment, "content">;
 declare class Attachment {
   static fromBytes(data: ArrayBuffer | Uint8Array, options: AttachmentOptions): EmailsSendAttachment;
-  static fromFile(path: string | URL, options?: Partial<AttachmentOptions>): Promise<EmailsSendAttachment>;
-  static fromUrl(url: string, options?: Partial<AttachmentOptions>): Promise<EmailsSendAttachment>;
-  static inlineFile(path: string | URL, options?: Partial<Omit<AttachmentOptions, "disposition">>): Promise<EmailsSendAttachment>;
+  static fromBlob(blob: Blob, options: AttachmentOptions): Promise<EmailsSendAttachment>;
 }
 declare class MailChannels extends MailChannelsClient {
   readonly emails: Emails;
@@ -1773,4 +1778,4 @@ declare class MailChannels extends MailChannelsClient {
   readonly suppressions: Suppressions;
   constructor(key: string, options?: MailChannelsClientOptions);
 }
-export { Attachment, type DataResponse, Domains, type DomainsCheckOptions, type DomainsCheckResponse, type DomainsCheckVerdict, type DomainsDkimCreateOptions, type DomainsDkimCreateResponse, type DomainsDkimKey, type DomainsDkimKeyStatus, type DomainsDkimListOptions, type DomainsDkimListResponse, type DomainsDkimRotateOptions, type DomainsDkimRotateResponse, type DomainsDkimUpdateStatusOptions, Emails, type EmailsQueueResponse, type EmailsSendAsyncResponse, type EmailsSendAttachment, type EmailsSendContent, type EmailsSendDkim, type EmailsSendOptions, type EmailsSendPersonalization, type EmailsSendRecipient, type EmailsSendRecipientInput, type EmailsSendResponse, type EmailsSendTemplate, type EmailsSendTemplateType, type EmailsSendTemplateValue, type EmailsSendTracking, type ErrorResponse, MailChannels, MailChannelsClient, type MailChannelsClientOptions, Metrics, type MetricsBucket, type MetricsEngagement, type MetricsEngagementResponse, type MetricsOptions, type MetricsPerformance, type MetricsPerformanceResponse, type MetricsRecipientBehaviour, type MetricsRecipientBehaviourResponse, type MetricsSenders, type MetricsSendersOptions, type MetricsSendersResponse, type MetricsSendersType, type MetricsUsageResponse, type MetricsVolume, type MetricsVolumeResponse, SubAccounts, type SubAccountsAccount, type SubAccountsApiKey, type SubAccountsCreateApiKeyResponse, type SubAccountsCreateResponse, type SubAccountsCreateSmtpPasswordResponse, type SubAccountsLimit, type SubAccountsLimitResponse, type SubAccountsListApiKeyOptions, type SubAccountsListApiKeyResponse, type SubAccountsListOptions, type SubAccountsListResponse, type SubAccountsListSmtpPasswordResponse, type SubAccountsSmtpPassword, type SubAccountsUsage, type SubAccountsUsageResponse, type SuccessResponse, Suppressions, type SuppressionsCreateOptions, type SuppressionsListEntry, type SuppressionsListOptions, type SuppressionsListResponse, type SuppressionsSource, type SuppressionsTypes, type WebhookEvent, type WebhookEventClick, type WebhookEventComplained, type WebhookEventDelivered, type WebhookEventDropped, type WebhookEventHardBounced, type WebhookEventOpen, type WebhookEventProcessed, type WebhookEventSoftBounced, type WebhookEventTest, type WebhookEventType, type WebhookEventUnsubscribed, Webhooks, type WebhooksBatch, type WebhooksBatchResponseStatus, type WebhooksBatchStatus, type WebhooksBatchesOptions, type WebhooksBatchesResponse, type WebhooksListResponse, type WebhooksResendBatch, type WebhooksResendBatchResponse, type WebhooksSigningKeyResponse, type WebhooksValidateResponse, type WebhooksVerifyOptions, type WebhooksVerifyResponse };
+export { Attachment, type DataResponse, Domains, type DomainsCheckOptions, type DomainsCheckResponse, type DomainsCheckVerdict, type DomainsDkimCreateOptions, type DomainsDkimCreateResponse, type DomainsDkimKey, type DomainsDkimKeyStatus, type DomainsDkimListOptions, type DomainsDkimListResponse, type DomainsDkimRotateOptions, type DomainsDkimRotateResponse, type DomainsDkimUpdateStatusOptions, Emails, type EmailsQueueResponse, type EmailsSendAsyncResponse, type EmailsSendAttachment, type EmailsSendContent, type EmailsSendDkim, type EmailsSendOptions, type EmailsSendPersonalization, type EmailsSendRecipient, type EmailsSendRecipientInput, type EmailsSendResponse, type EmailsSendTemplate, type EmailsSendTemplateType, type EmailsSendTemplateValue, type EmailsSendTracking, type ErrorResponse, type ErrorType, MailChannels, MailChannelsClient, type MailChannelsClientOptions, Metrics, type MetricsBucket, type MetricsEngagement, type MetricsEngagementResponse, type MetricsOptions, type MetricsPerformance, type MetricsPerformanceResponse, type MetricsRecipientBehaviour, type MetricsRecipientBehaviourResponse, type MetricsSenders, type MetricsSendersOptions, type MetricsSendersResponse, type MetricsSendersType, type MetricsUsageResponse, type MetricsVolume, type MetricsVolumeResponse, SubAccounts, type SubAccountsAccount, type SubAccountsApiKey, type SubAccountsCreateApiKeyResponse, type SubAccountsCreateResponse, type SubAccountsCreateSmtpPasswordResponse, type SubAccountsLimit, type SubAccountsLimitResponse, type SubAccountsListApiKeyOptions, type SubAccountsListApiKeyResponse, type SubAccountsListOptions, type SubAccountsListResponse, type SubAccountsListSmtpPasswordResponse, type SubAccountsSmtpPassword, type SubAccountsUsage, type SubAccountsUsageResponse, type SuccessResponse, Suppressions, type SuppressionsCreateOptions, type SuppressionsListEntry, type SuppressionsListOptions, type SuppressionsListResponse, type SuppressionsSource, type SuppressionsTypes, type WebhookEvent, type WebhookEventClick, type WebhookEventComplained, type WebhookEventDelivered, type WebhookEventDropped, type WebhookEventHardBounced, type WebhookEventOpen, type WebhookEventProcessed, type WebhookEventSoftBounced, type WebhookEventTest, type WebhookEventType, type WebhookEventUnsubscribed, Webhooks, type WebhooksBatch, type WebhooksBatchResponseStatus, type WebhooksBatchStatus, type WebhooksBatchesOptions, type WebhooksBatchesResponse, type WebhooksListResponse, type WebhooksResendBatch, type WebhooksResendBatchResponse, type WebhooksSigningKeyResponse, type WebhooksValidateResponse, type WebhooksVerifyOptions, type WebhooksVerifyResponse };

package/dist/mailchannels.mjs

@@ -1,10 +1,8 @@
 import { $fetch } from "ofetch";
 import { subtle } from "node:crypto";
 import { Buffer } from "node:buffer";
-import { basename } from "node:path";
-import { readFile } from "node:fs/promises";
 import mime from "mime";
-var version = "0.8.0";
+var version = "1.0.0";
 var MailChannelsClient = class MailChannelsClient {
 	static DEFAULT_BASE_URL = "https://api.mailchannels.net";
 	static DEFAULT_TIMEOUT = 12e4;
@@ -70,10 +68,22 @@ var MailChannelsClient = class MailChannelsClient {
 		});
 	}
 };
-const createError = (message, statusCode = null) => {
+const STATUS_ERROR_TYPE_MAP = {
+	[400]: "invalid_request_error",
+	[401]: "authentication_error",
+	[403]: "permission_error",
+	[404]: "not_found",
+	[409]: "conflict_error",
+	[413]: "payload_too_large_error",
+	[422]: "unprocessable_entity_error",
+	[429]: "rate_limit_error",
+	[500]: "internal_server_error"
+};
+const createError = (message, statusCode = null, type) => {
 	return {
 		message,
-		statusCode
+		statusCode,
+		type
 	};
 };
 const getStatusError = (response, errors = {}) => {
@@ -83,15 +93,18 @@ const getStatusError = (response, errors = {}) => {
 	if (typeof payload === "string") details = payload;
 	else if (payload?.message) details = payload.message;
 	else if (Array.isArray(payload?.errors) && payload.errors?.length) details = payload.errors.join(", ");
-	return createError(details ? `${statusText} ${details}` : statusText, response.status ?? null);
+	return createError(details ? `${statusText} ${details}` : statusText, response.status ?? null, STATUS_ERROR_TYPE_MAP[response.status] || "api_error");
 };
 const getResultError = (e, fallback) => {
-	return createError(e instanceof Error ? e.message : fallback);
+	return createError(e instanceof Error ? e.message : fallback, null, "application_error");
+};
+const createValidationError = (message) => {
+	return createError(message, null, "validation_error");
 };
 const validatePagination = (pagination = {}) => {
 	const { limit, offset, max } = pagination;
-	if (typeof limit === "number" && (limit < 1 || max && limit > max)) return createError("The limit value " + (max ? `must be between 1 and ${max}.` : "is invalid. Only positive values are allowed."));
-	if (typeof offset === "number" && offset < 0) return createError("Offset must be greater than or equal to 0.");
+	if (typeof limit === "number" && (limit < 1 || max && limit > max)) return createValidationError("The limit value " + (max ? `must be between 1 and ${max}.` : "is invalid. Only positive values are allowed."));
+	if (typeof offset === "number" && offset < 0) return createValidationError("Offset must be greater than or equal to 0.");
 	return null;
 };
 const clean = (data) => {
@@ -243,7 +256,8 @@ const buildSendPayload = async (options) => {
 	const { from, html, text } = options;
 	const contentTypes = options.content ? new Set(options.content.map((item) => item.type.toLowerCase())) : void 0;
 	const parsedFrom = parseRecipient(from);
-	if (!parsedFrom || !parsedFrom.email) return "No sender provided. Use the `from` option to specify a sender";
+	if (!parsedFrom || !parsedFrom.email) return "No sender provided. Use the 'from' option to specify a sender.";
+	if (!options.subject || typeof options.subject !== "string" || !options.subject.trim()) return "No subject provided. Use the 'subject' option to specify a subject.";
 	if (!text && !html && (!options.content || !options.content.length)) return "No email content provided";
 	if (html && contentTypes?.has("text/html")) return "Cannot provide both 'html' and a 'content' entry with type 'text/html'.";
 	if (text && contentTypes?.has("text/plain")) return "Cannot provide both 'text' and a 'content' entry with type 'text/plain'.";
@@ -337,7 +351,7 @@ var Emails = class {
 		let error = null;
 		const payload = await buildSendPayload(options);
 		if (typeof payload === "string") {
-			error = createError(payload);
+			error = createValidationError(payload);
 			return {
 				data: null,
 				error
@@ -420,7 +434,7 @@ var Domains = class {
 	async check(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			error = createValidationError("No domain provided.");
 			return {
 				data: null,
 				error
@@ -428,14 +442,14 @@ var Domains = class {
 		}
 		const dkimOptions = options?.dkim ? Array.isArray(options.dkim) ? options.dkim : [options.dkim] : void 0;
 		if (dkimOptions && dkimOptions.length > 10) {
-			error = createError("A maximum of 10 DKIM settings can be provided.");
+			error = createValidationError("A maximum of 10 DKIM settings can be provided.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (dkimOptions?.find(({ privateKey, selector }) => privateKey && !selector)) {
-			error = createError("DKIM settings with a privateKey must also include a selector.");
+			error = createValidationError("DKIM settings with a privateKey must also include a selector.");
 			return {
 				data: null,
 				error
@@ -492,14 +506,14 @@ var DomainsDkim = class {
 	async create(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			error = createValidationError("No domain provided.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (!options.selector || options.selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
@@ -534,14 +548,14 @@ var DomainsDkim = class {
 	async list(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			error = createValidationError("No domain provided.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (options?.selector && options.selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
@@ -583,14 +597,14 @@ var DomainsDkim = class {
 	async updateStatus(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			error = createValidationError("No domain provided.");
 			return {
 				success: false,
 				error
 			};
 		}
 		if (!options.selector || options.selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				success: false,
 				error
@@ -616,21 +630,21 @@ var DomainsDkim = class {
 	async rotate(domain, selector, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			error = createValidationError("No domain provided.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (!selector || selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (!options.newKey.selector || options.newKey.selector.length > 63) {
-			error = createError("New key selector must be between 1 and 63 characters.");
+			error = createValidationError("New key selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
@@ -743,14 +757,14 @@ var Webhooks = class Webhooks {
 	async create(endpoint) {
 		let error = null;
 		if (!endpoint) {
-			error = createError("No endpoint provided.");
+			error = createValidationError("No endpoint provided.");
 			return {
 				success: false,
 				error
 			};
 		}
 		if (endpoint.length > 8e3) {
-			error = createError("The endpoint exceeds the maximum length of 8000 characters.");
+			error = createValidationError("The endpoint exceeds the maximum length of 8000 characters.");
 			return {
 				success: false,
 				error
@@ -827,7 +841,7 @@ var Webhooks = class Webhooks {
 	async validate(requestId) {
 		let error = null;
 		if (requestId && requestId.length > 28) {
-			error = createError("The request id should not exceed 28 characters.");
+			error = createValidationError("The request id should not exceed 28 characters.");
 			return {
 				data: null,
 				error
@@ -860,7 +874,7 @@ var Webhooks = class Webhooks {
 	static async verify(options) {
 		let error = null;
 		if (!await isValidWebhook(options).catch(() => false)) {
-			error = createError("Invalid webhook signature.");
+			error = createValidationError("Invalid webhook signature.");
 			return {
 				data: null,
 				error
@@ -869,7 +883,7 @@ var Webhooks = class Webhooks {
 		try {
 			const payload = JSON.parse(options.payload);
 			if (!Array.isArray(payload)) {
-				error = createError("Invalid webhook payload.");
+				error = createValidationError("Invalid webhook payload.");
 				return {
 					data: null,
 					error
@@ -894,7 +908,7 @@ var Webhooks = class Webhooks {
 				error: null
 			};
 		} catch {
-			error = createError("Invalid webhook payload.");
+			error = createValidationError("Invalid webhook payload.");
 			return {
 				data: null,
 				error
@@ -916,19 +930,19 @@ var Webhooks = class Webhooks {
 		};
 		if (options?.statuses && options.statuses.length > 6) return {
 			data: null,
-			error: createError("A maximum of 6 status filters can be provided.")
+			error: createValidationError("A maximum of 6 status filters can be provided.")
 		};
 		if (options?.statuses && new Set(options.statuses).size !== options.statuses.length) return {
 			data: null,
-			error: createError("Status filters must be unique.")
+			error: createValidationError("Status filters must be unique.")
 		};
 		if (options?.createdAfter && Number.isNaN(Date.parse(options.createdAfter))) return {
 			data: null,
-			error: createError("createdAfter must be a valid date string.")
+			error: createValidationError("createdAfter must be a valid date string.")
 		};
 		if (options?.createdBefore && Number.isNaN(Date.parse(options.createdBefore))) return {
 			data: null,
-			error: createError("createdBefore must be a valid date string.")
+			error: createValidationError("createdBefore must be a valid date string.")
 		};
 		if (options?.createdAfter && options?.createdBefore) {
 			const createdAfter = Date.parse(options.createdAfter);
@@ -936,11 +950,11 @@ var Webhooks = class Webhooks {
 			const maxRangeMs = 744 * 60 * 60 * 1e3;
 			if (createdBefore <= createdAfter) return {
 				data: null,
-				error: createError("createdBefore must be later than createdAfter.")
+				error: createValidationError("createdBefore must be later than createdAfter.")
 			};
 			if (createdBefore - createdAfter > maxRangeMs) return {
 				data: null,
-				error: createError("The time range between createdAfter and createdBefore must not exceed 31 days.")
+				error: createValidationError("The time range between createdAfter and createdBefore must not exceed 31 days.")
 			};
 		}
 		const response = await this.mailchannels.get("/tx/v1/webhook-batch", {
@@ -1016,7 +1030,7 @@ var SubAccounts = class SubAccounts {
 	async create(companyName, handle) {
 		let error = null;
 		if (!SubAccounts.COMPANY_PATTERN.test(companyName)) {
-			error = createError("Invalid company name. Company name must be between 3 and 128 characters.");
+			error = createValidationError("Invalid company name. Company name must be between 3 and 128 characters.");
 			return {
 				data: null,
 				error
@@ -1024,7 +1038,7 @@ var SubAccounts = class SubAccounts {
 		}
 		if (handle) {
 			if (!SubAccounts.HANDLE_PATTERN.test(handle)) {
-				error = createError("Invalid handle. Sub-account handle must be between 3 and 128 characters and contain only lowercase letters and numbers.");
+				error = createValidationError("Invalid handle. Sub-account handle must be between 3 and 128 characters and contain only lowercase letters and numbers.");
 				return {
 					data: null,
 					error
@@ -1094,7 +1108,7 @@ var SubAccounts = class SubAccounts {
 	async delete(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1113,7 +1127,7 @@ var SubAccounts = class SubAccounts {
 	async suspend(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1132,7 +1146,7 @@ var SubAccounts = class SubAccounts {
 	async activate(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1154,7 +1168,7 @@ var SubAccounts = class SubAccounts {
 	async createApiKey(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1182,7 +1196,7 @@ var SubAccounts = class SubAccounts {
 	async listApiKeys(handle, options) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1217,7 +1231,7 @@ var SubAccounts = class SubAccounts {
 	async deleteApiKey(handle, id) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1236,7 +1250,7 @@ var SubAccounts = class SubAccounts {
 	async createSmtpPassword(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1268,7 +1282,7 @@ var SubAccounts = class SubAccounts {
 	async listSmtpPasswords(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1296,7 +1310,7 @@ var SubAccounts = class SubAccounts {
 	async deleteSmtpPassword(handle, id) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1315,7 +1329,7 @@ var SubAccounts = class SubAccounts {
 	async getLimit(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1339,14 +1353,14 @@ var SubAccounts = class SubAccounts {
 	async setLimit(handle, limit) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
 			};
 		}
 		if (limit.sends < 0) {
-			error = createError("The sends value must be at least 0.");
+			error = createValidationError("The sends value must be at least 0.");
 			return {
 				success: false,
 				error
@@ -1371,7 +1385,7 @@ var SubAccounts = class SubAccounts {
 	async deleteLimit(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1390,7 +1404,7 @@ var SubAccounts = class SubAccounts {
 	async getUsage(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1643,7 +1657,7 @@ var Suppressions = class {
 		let error = null;
 		const { addToSubAccounts, entries } = options;
 		if (entries.length > 1e3) {
-			error = createError("The number of suppression entries must not exceed 1000.");
+			error = createValidationError("The number of suppression entries must not exceed 1000.");
 			return {
 				success: false,
 				error
@@ -1692,7 +1706,7 @@ var Suppressions = class {
 	async list(options) {
 		let error = null;
 		if (options?.recipient && options.recipient.length > 255) {
-			error = createError("The recipient must not exceed 255 characters.");
+			error = createValidationError("The recipient must not exceed 255 characters.");
 			return {
 				data: null,
 				error
@@ -1758,41 +1772,12 @@ var Attachment = class Attachment {
 			disposition
 		};
 	}
-	static async fromFile(path, options) {
-		try {
-			const data = await readFile(path);
-			return Attachment.fromBytes(data, {
-				filename: basename(path.toString()),
-				...options
-			});
-		} catch (error) {
-			throw new Error(`Unable to read attachment file: ${path}`, { cause: error });
-		}
-	}
-	static async fromUrl(url, options) {
-		try {
-			let contentType;
-			const data = await $fetch(url, {
-				responseType: "arrayBuffer",
-				timeout: 12e4,
-				onResponse: ({ response }) => {
-					const contentTypeHeader = response.headers.get("content-type");
-					if (contentTypeHeader) contentType = contentTypeHeader.split(";", 1)[0]?.trim();
-				}
-			});
-			return Attachment.fromBytes(data, {
-				type: contentType,
-				filename: basename(new URL(url).pathname),
-				...options
-			});
-		} catch (error) {
-			throw new Error(`Unable to fetch attachment from URL: ${url}`, { cause: error });
-		}
-	}
-	static inlineFile(path, options) {
-		return Attachment.fromFile(path, {
-			...options,
-			disposition: "inline"
+	static async fromBlob(blob, options) {
+		if (!(blob instanceof Blob)) throw new Error("Unable to create attachment: expected a Blob");
+		const bytes = await blob.arrayBuffer();
+		return Attachment.fromBytes(bytes, {
+			type: blob.type,
+			...options
 		});
 	}
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailchannels-sdk",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "Node.js SDK to integrate MailChannels Email API into your JavaScript or TypeScript server-side applications.",
   "type": "module",
   "license": "MIT",
@@ -42,25 +42,25 @@
   "devDependencies": {
     "@stylistic/eslint-plugin": "^5.10.0",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^25.9.1",
-    "@vitest/coverage-v8": "^4.1.7",
+    "@types/node": "^25.9.2",
+    "@vitest/coverage-v8": "^4.1.8",
     "changelogen": "^0.6.2",
     "obuild": "^0.4.36",
-    "oxlint": "^1.67.0",
+    "oxlint": "^1.68.0",
     "scule": "^1.3.0",
     "typescript": "^6.0.3",
     "vitepress": "^2.0.0-alpha.17",
     "vitepress-plugin-group-icons": "^1.7.5",
-    "vitepress-plugin-llms": "^1.13.0",
-    "vitest": "^4.1.7"
+    "vitepress-plugin-llms": "^1.13.1",
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=20"
   },
   "scripts": {
     "build": "obuild",
-    "parity:fixtures": "node scripts/generate-parity-fixtures.mjs",
-    "release": "pnpm lint && pnpm test && pnpm build && changelogen --release && git push --follow-tags",
+    "parity:fixtures": "node scripts/generate-parity-fixtures.ts",
+    "release": "pnpm lint && pnpm test && pnpm build && changelogen --bump",
     "simulate": "node src/cli.ts simulate",
     "lint": "oxlint",
     "lint:fix": "oxlint --fix",