tosend 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) ToSend
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,196 @@
+# ToSend Node.js SDK
+
+Official Node.js SDK for the [ToSend](https://tosend.com) email API.
+
+## Installation
+
+```bash
+npm install tosend
+```
+
+## Quick Start
+
+```typescript
+import { ToSend } from 'tosend';
+
+const tosend = new ToSend('tsend_your_api_key');
+
+const response = await tosend.send({
+  from: { email: 'hello@yourdomain.com', name: 'Your App' },
+  to: [{ email: 'user@example.com' }],
+  subject: 'Welcome!',
+  html: '<h1>Hello!</h1><p>Thanks for signing up.</p>',
+});
+
+console.log(response.message_id);
+```
+
+## Usage
+
+### Send an Email
+
+```typescript
+const response = await tosend.send({
+  from: { email: 'hello@yourdomain.com', name: 'Your App' },
+  to: [
+    { email: 'user@example.com' },
+    { email: 'another@example.com', name: 'John Doe' },
+  ],
+  subject: 'Hello!',
+  html: '<h1>Welcome</h1>',
+  text: 'Welcome', // optional
+});
+```
+
+### With CC, BCC, and Reply-To
+
+```typescript
+const response = await tosend.send({
+  from: { email: 'hello@yourdomain.com' },
+  to: [{ email: 'user@example.com' }],
+  cc: [{ email: 'cc@example.com' }],
+  bcc: [{ email: 'bcc@example.com' }],
+  reply_to: { email: 'support@yourdomain.com', name: 'Support' },
+  subject: 'Hello',
+  html: '<p>Hello World</p>',
+});
+```
+
+### With Attachments
+
+```typescript
+import * as fs from 'fs';
+
+const response = await tosend.send({
+  from: { email: 'hello@yourdomain.com' },
+  to: [{ email: 'user@example.com' }],
+  subject: 'Your Invoice',
+  html: '<p>Please find your invoice attached.</p>',
+  attachments: [
+    {
+      type: 'application/pdf',
+      name: 'invoice.pdf',
+      content: fs.readFileSync('invoice.pdf').toString('base64'),
+    },
+  ],
+});
+```
+
+### Batch Sending
+
+Send multiple emails in a single request:
+
+```typescript
+const response = await tosend.batch([
+  {
+    from: { email: 'hello@yourdomain.com' },
+    to: [{ email: 'user1@example.com' }],
+    subject: 'Hello User 1',
+    html: '<p>Welcome!</p>',
+  },
+  {
+    from: { email: 'hello@yourdomain.com' },
+    to: [{ email: 'user2@example.com' }],
+    subject: 'Hello User 2',
+    html: '<p>Welcome!</p>',
+  },
+]);
+
+response.results.forEach((result) => {
+  if (result.status === 'success') {
+    console.log('Sent:', result.message_id);
+  } else {
+    console.log('Failed:', result.message);
+  }
+});
+```
+
+### Get Account Info
+
+```typescript
+const info = await tosend.getAccountInfo();
+
+console.log(info.account.title);
+console.log(info.account.emails_usage_this_month);
+console.log(info.account.emails_sent_last_24hrs);
+
+info.domains.forEach((domain) => {
+  console.log(domain.domain_name, domain.verification_status);
+});
+```
+
+## Configuration
+
+### Simple (API key only)
+
+```typescript
+const tosend = new ToSend('tsend_your_api_key');
+```
+
+### With Options
+
+```typescript
+const tosend = new ToSend({
+  apiKey: 'tsend_your_api_key',
+  baseUrl: 'https://api.tosend.com', // optional
+  timeout: 30000, // optional, in milliseconds
+});
+```
+
+## Error Handling
+
+```typescript
+import { ToSend, ToSendError } from 'tosend';
+
+try {
+  const response = await tosend.send({
+    from: { email: 'hello@yourdomain.com' },
+    to: [{ email: 'user@example.com' }],
+    subject: 'Hello',
+    html: '<p>Hello</p>',
+  });
+} catch (error) {
+  if (error instanceof ToSendError) {
+    console.log('Error:', error.message);
+    console.log('Code:', error.code);
+    console.log('Errors:', error.errors);
+
+    if (error.isValidationError) {
+      // Handle validation error (422)
+    }
+
+    if (error.isAuthenticationError) {
+      // Handle auth error (401/403)
+    }
+
+    if (error.isRateLimitError) {
+      // Handle rate limit (429)
+    }
+  }
+}
+```
+
+## TypeScript
+
+Full TypeScript support with exported types:
+
+```typescript
+import {
+  ToSend,
+  ToSendError,
+  SendEmailParams,
+  SendEmailResponse,
+  BatchEmailResponse,
+  AccountInfo,
+  Address,
+  Attachment,
+} from 'tosend';
+```
+
+## Requirements
+
+- Node.js 18 or higher
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,154 @@
+/**
+ * ToSend Node.js SDK
+ *
+ * Official SDK for the ToSend email API.
+ * @see https://tosend.com/docs
+ */
+interface Address {
+    email: string;
+    name?: string;
+}
+interface Attachment {
+    /** MIME type (e.g., 'application/pdf') */
+    type: string;
+    /** Filename */
+    name: string;
+    /** Base64 encoded content */
+    content: string;
+}
+interface SendEmailParams {
+    /** Sender address */
+    from: Address;
+    /** Recipients (max 50) */
+    to: Address[];
+    /** Email subject */
+    subject: string;
+    /** HTML content */
+    html?: string;
+    /** Plain text content */
+    text?: string;
+    /** CC recipients */
+    cc?: Address[];
+    /** BCC recipients */
+    bcc?: Address[];
+    /** Reply-to address */
+    reply_to?: Address;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** File attachments */
+    attachments?: Attachment[];
+}
+interface SendEmailResponse {
+    message_id: string;
+}
+interface BatchEmailResult {
+    status: 'success' | 'error' | 'spam';
+    message_id?: string;
+    message?: string;
+    errors?: Record<string, Record<string, string>>;
+}
+interface BatchEmailResponse {
+    results: BatchEmailResult[];
+}
+interface Domain {
+    domain_name: string;
+    verification_status: 'pending' | 'verified' | 'failed';
+    created_at: string;
+}
+interface AccountInfo {
+    account: {
+        title: string;
+        plan_type: string;
+        status: string;
+        emails_usage_this_month: number;
+        emails_sent_last_24hrs: number;
+    };
+    domains: Domain[];
+}
+interface ToSendErrorResponse {
+    error_code: number;
+    message: string;
+    errors?: Record<string, Record<string, string>>;
+}
+interface ToSendConfig {
+    /** Your ToSend API key */
+    apiKey: string;
+    /** Custom base URL (optional) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+declare class ToSendError extends Error {
+    readonly code: number;
+    readonly errors: Record<string, Record<string, string>>;
+    constructor(message: string, code?: number, errors?: Record<string, Record<string, string>>);
+    get isValidationError(): boolean;
+    get isAuthenticationError(): boolean;
+    get isRateLimitError(): boolean;
+}
+declare class ToSend {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(config: string | ToSendConfig);
+    /**
+     * Send a single email.
+     *
+     * @example
+     * ```ts
+     * const response = await tosend.send({
+     *   from: { email: 'hello@example.com', name: 'My App' },
+     *   to: [{ email: 'user@example.com' }],
+     *   subject: 'Hello!',
+     *   html: '<p>Welcome!</p>'
+     * });
+     * console.log(response.message_id);
+     * ```
+     */
+    send(params: SendEmailParams): Promise<SendEmailResponse>;
+    /**
+     * Send multiple emails in a single request.
+     *
+     * @example
+     * ```ts
+     * const response = await tosend.batch([
+     *   {
+     *     from: { email: 'hello@example.com' },
+     *     to: [{ email: 'user1@example.com' }],
+     *     subject: 'Hello User 1',
+     *     html: '<p>Hi!</p>'
+     *   },
+     *   {
+     *     from: { email: 'hello@example.com' },
+     *     to: [{ email: 'user2@example.com' }],
+     *     subject: 'Hello User 2',
+     *     html: '<p>Hi!</p>'
+     *   }
+     * ]);
+     *
+     * response.results.forEach(result => {
+     *   if (result.status === 'success') {
+     *     console.log('Sent:', result.message_id);
+     *   }
+     * });
+     * ```
+     */
+    batch(emails: SendEmailParams[]): Promise<BatchEmailResponse>;
+    /**
+     * Get account information and domains.
+     *
+     * @example
+     * ```ts
+     * const info = await tosend.getAccountInfo();
+     * console.log(info.account.title);
+     * console.log(info.account.emails_usage_this_month);
+     * info.domains.forEach(d => console.log(d.domain_name, d.verification_status));
+     * ```
+     */
+    getAccountInfo(): Promise<AccountInfo>;
+    private validateEmailParams;
+    private isValidEmail;
+    private request;
+}
+
+export { type AccountInfo, type Address, type Attachment, type BatchEmailResponse, type BatchEmailResult, type Domain, type SendEmailParams, type SendEmailResponse, ToSend, type ToSendConfig, ToSendError, type ToSendErrorResponse, ToSend as default };

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+/**
+ * ToSend Node.js SDK
+ *
+ * Official SDK for the ToSend email API.
+ * @see https://tosend.com/docs
+ */
+interface Address {
+    email: string;
+    name?: string;
+}
+interface Attachment {
+    /** MIME type (e.g., 'application/pdf') */
+    type: string;
+    /** Filename */
+    name: string;
+    /** Base64 encoded content */
+    content: string;
+}
+interface SendEmailParams {
+    /** Sender address */
+    from: Address;
+    /** Recipients (max 50) */
+    to: Address[];
+    /** Email subject */
+    subject: string;
+    /** HTML content */
+    html?: string;
+    /** Plain text content */
+    text?: string;
+    /** CC recipients */
+    cc?: Address[];
+    /** BCC recipients */
+    bcc?: Address[];
+    /** Reply-to address */
+    reply_to?: Address;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** File attachments */
+    attachments?: Attachment[];
+}
+interface SendEmailResponse {
+    message_id: string;
+}
+interface BatchEmailResult {
+    status: 'success' | 'error' | 'spam';
+    message_id?: string;
+    message?: string;
+    errors?: Record<string, Record<string, string>>;
+}
+interface BatchEmailResponse {
+    results: BatchEmailResult[];
+}
+interface Domain {
+    domain_name: string;
+    verification_status: 'pending' | 'verified' | 'failed';
+    created_at: string;
+}
+interface AccountInfo {
+    account: {
+        title: string;
+        plan_type: string;
+        status: string;
+        emails_usage_this_month: number;
+        emails_sent_last_24hrs: number;
+    };
+    domains: Domain[];
+}
+interface ToSendErrorResponse {
+    error_code: number;
+    message: string;
+    errors?: Record<string, Record<string, string>>;
+}
+interface ToSendConfig {
+    /** Your ToSend API key */
+    apiKey: string;
+    /** Custom base URL (optional) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+declare class ToSendError extends Error {
+    readonly code: number;
+    readonly errors: Record<string, Record<string, string>>;
+    constructor(message: string, code?: number, errors?: Record<string, Record<string, string>>);
+    get isValidationError(): boolean;
+    get isAuthenticationError(): boolean;
+    get isRateLimitError(): boolean;
+}
+declare class ToSend {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(config: string | ToSendConfig);
+    /**
+     * Send a single email.
+     *
+     * @example
+     * ```ts
+     * const response = await tosend.send({
+     *   from: { email: 'hello@example.com', name: 'My App' },
+     *   to: [{ email: 'user@example.com' }],
+     *   subject: 'Hello!',
+     *   html: '<p>Welcome!</p>'
+     * });
+     * console.log(response.message_id);
+     * ```
+     */
+    send(params: SendEmailParams): Promise<SendEmailResponse>;
+    /**
+     * Send multiple emails in a single request.
+     *
+     * @example
+     * ```ts
+     * const response = await tosend.batch([
+     *   {
+     *     from: { email: 'hello@example.com' },
+     *     to: [{ email: 'user1@example.com' }],
+     *     subject: 'Hello User 1',
+     *     html: '<p>Hi!</p>'
+     *   },
+     *   {
+     *     from: { email: 'hello@example.com' },
+     *     to: [{ email: 'user2@example.com' }],
+     *     subject: 'Hello User 2',
+     *     html: '<p>Hi!</p>'
+     *   }
+     * ]);
+     *
+     * response.results.forEach(result => {
+     *   if (result.status === 'success') {
+     *     console.log('Sent:', result.message_id);
+     *   }
+     * });
+     * ```
+     */
+    batch(emails: SendEmailParams[]): Promise<BatchEmailResponse>;
+    /**
+     * Get account information and domains.
+     *
+     * @example
+     * ```ts
+     * const info = await tosend.getAccountInfo();
+     * console.log(info.account.title);
+     * console.log(info.account.emails_usage_this_month);
+     * info.domains.forEach(d => console.log(d.domain_name, d.verification_status));
+     * ```
+     */
+    getAccountInfo(): Promise<AccountInfo>;
+    private validateEmailParams;
+    private isValidEmail;
+    private request;
+}
+
+export { type AccountInfo, type Address, type Attachment, type BatchEmailResponse, type BatchEmailResult, type Domain, type SendEmailParams, type SendEmailResponse, ToSend, type ToSendConfig, ToSendError, type ToSendErrorResponse, ToSend as default };

package/dist/index.js

@@ -0,0 +1,227 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ToSend: () => ToSend,
+  ToSendError: () => ToSendError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var ToSendError = class extends Error {
+  code;
+  errors;
+  constructor(message, code = 0, errors = {}) {
+    super(message);
+    this.name = "ToSendError";
+    this.code = code;
+    this.errors = errors;
+  }
+  get isValidationError() {
+    return this.code === 422;
+  }
+  get isAuthenticationError() {
+    return this.code === 401 || this.code === 403;
+  }
+  get isRateLimitError() {
+    return this.code === 429;
+  }
+};
+var ToSend = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    if (typeof config === "string") {
+      this.apiKey = config;
+      this.baseUrl = "https://api.tosend.com";
+      this.timeout = 3e4;
+    } else {
+      this.apiKey = config.apiKey;
+      this.baseUrl = config.baseUrl?.replace(/\/$/, "") ?? "https://api.tosend.com";
+      this.timeout = config.timeout ?? 3e4;
+    }
+    if (!this.apiKey?.trim()) {
+      throw new ToSendError("API key is required", 401);
+    }
+  }
+  /**
+   * Send a single email.
+   *
+   * @example
+   * ```ts
+   * const response = await tosend.send({
+   *   from: { email: 'hello@example.com', name: 'My App' },
+   *   to: [{ email: 'user@example.com' }],
+   *   subject: 'Hello!',
+   *   html: '<p>Welcome!</p>'
+   * });
+   * console.log(response.message_id);
+   * ```
+   */
+  async send(params) {
+    this.validateEmailParams(params);
+    return this.request("POST", "/v2/emails", params);
+  }
+  /**
+   * Send multiple emails in a single request.
+   *
+   * @example
+   * ```ts
+   * const response = await tosend.batch([
+   *   {
+   *     from: { email: 'hello@example.com' },
+   *     to: [{ email: 'user1@example.com' }],
+   *     subject: 'Hello User 1',
+   *     html: '<p>Hi!</p>'
+   *   },
+   *   {
+   *     from: { email: 'hello@example.com' },
+   *     to: [{ email: 'user2@example.com' }],
+   *     subject: 'Hello User 2',
+   *     html: '<p>Hi!</p>'
+   *   }
+   * ]);
+   *
+   * response.results.forEach(result => {
+   *   if (result.status === 'success') {
+   *     console.log('Sent:', result.message_id);
+   *   }
+   * });
+   * ```
+   */
+  async batch(emails) {
+    if (!emails?.length) {
+      throw new ToSendError("Emails array is required and cannot be empty", 422, {
+        emails: { required: "At least one email is required" }
+      });
+    }
+    emails.forEach((email, index) => {
+      try {
+        this.validateEmailParams(email);
+      } catch (error) {
+        if (error instanceof ToSendError) {
+          throw new ToSendError(
+            `Email at index ${index}: ${error.message}`,
+            error.code,
+            error.errors
+          );
+        }
+        throw error;
+      }
+    });
+    return this.request("POST", "/v2/emails/batch", { emails });
+  }
+  /**
+   * Get account information and domains.
+   *
+   * @example
+   * ```ts
+   * const info = await tosend.getAccountInfo();
+   * console.log(info.account.title);
+   * console.log(info.account.emails_usage_this_month);
+   * info.domains.forEach(d => console.log(d.domain_name, d.verification_status));
+   * ```
+   */
+  async getAccountInfo() {
+    return this.request("GET", "/v2/info");
+  }
+  // ==========================================================================
+  // Private Methods
+  // ==========================================================================
+  validateEmailParams(params) {
+    const errors = {};
+    if (!params.from?.email) {
+      errors.from = { required: "From email is required" };
+    } else if (!this.isValidEmail(params.from.email)) {
+      errors.from = { invalid: "From email is invalid" };
+    }
+    if (!params.to?.length) {
+      errors.to = { required: "To is required" };
+    } else {
+      const hasValidRecipient = params.to.some(
+        (r) => r.email && this.isValidEmail(r.email)
+      );
+      if (!hasValidRecipient) {
+        errors.to = { invalid: "At least one valid recipient email is required" };
+      }
+    }
+    if (!params.subject) {
+      errors.subject = { required: "Subject is required" };
+    }
+    if (!params.html && !params.text) {
+      errors.content = { required: "Either html or text content is required" };
+    }
+    if (Object.keys(errors).length > 0) {
+      const firstError = Object.values(errors)[0];
+      const message = Object.values(firstError)[0];
+      throw new ToSendError(message, 422, errors);
+    }
+  }
+  isValidEmail(email) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+  }
+  async request(method, endpoint, body) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const data = await response.json();
+      if (!response.ok) {
+        throw new ToSendError(
+          data.message ?? "Unknown error",
+          response.status,
+          data.errors ?? {}
+        );
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof ToSendError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new ToSendError("Request timeout", 408);
+        }
+        throw new ToSendError(error.message);
+      }
+      throw new ToSendError("Unknown error");
+    }
+  }
+};
+var index_default = ToSend;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ToSend,
+  ToSendError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * ToSend Node.js SDK\n *\n * Official SDK for the ToSend email API.\n * @see https://tosend.com/docs\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface Address {\n  email: string;\n  name?: string;\n}\n\nexport interface Attachment {\n  /** MIME type (e.g., 'application/pdf') */\n  type: string;\n  /** Filename */\n  name: string;\n  /** Base64 encoded content */\n  content: string;\n}\n\nexport interface SendEmailParams {\n  /** Sender address */\n  from: Address;\n  /** Recipients (max 50) */\n  to: Address[];\n  /** Email subject */\n  subject: string;\n  /** HTML content */\n  html?: string;\n  /** Plain text content */\n  text?: string;\n  /** CC recipients */\n  cc?: Address[];\n  /** BCC recipients */\n  bcc?: Address[];\n  /** Reply-to address */\n  reply_to?: Address;\n  /** Custom headers */\n  headers?: Record<string, string>;\n  /** File attachments */\n  attachments?: Attachment[];\n}\n\nexport interface SendEmailResponse {\n  message_id: string;\n}\n\nexport interface BatchEmailResult {\n  status: 'success' | 'error' | 'spam';\n  message_id?: string;\n  message?: string;\n  errors?: Record<string, Record<string, string>>;\n}\n\nexport interface BatchEmailResponse {\n  results: BatchEmailResult[];\n}\n\nexport interface Domain {\n  domain_name: string;\n  verification_status: 'pending' | 'verified' | 'failed';\n  created_at: string;\n}\n\nexport interface AccountInfo {\n  account: {\n    title: string;\n    plan_type: string;\n    status: string;\n    emails_usage_this_month: number;\n    emails_sent_last_24hrs: number;\n  };\n  domains: Domain[];\n}\n\nexport interface ToSendErrorResponse {\n  error_code: number;\n  message: string;\n  errors?: Record<string, Record<string, string>>;\n}\n\nexport interface ToSendConfig {\n  /** Your ToSend API key */\n  apiKey: string;\n  /** Custom base URL (optional) */\n  baseUrl?: string;\n  /** Request timeout in ms (default: 30000) */\n  timeout?: number;\n}\n\n// ============================================================================\n// Error Class\n// ============================================================================\n\nexport class ToSendError extends Error {\n  readonly code: number;\n  readonly errors: Record<string, Record<string, string>>;\n\n  constructor(\n    message: string,\n    code: number = 0,\n    errors: Record<string, Record<string, string>> = {}\n  ) {\n    super(message);\n    this.name = 'ToSendError';\n    this.code = code;\n    this.errors = errors;\n  }\n\n  get isValidationError(): boolean {\n    return this.code === 422;\n  }\n\n  get isAuthenticationError(): boolean {\n    return this.code === 401 || this.code === 403;\n  }\n\n  get isRateLimitError(): boolean {\n    return this.code === 429;\n  }\n}\n\n// ============================================================================\n// Main Client\n// ============================================================================\n\nexport class ToSend {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(config: string | ToSendConfig) {\n    if (typeof config === 'string') {\n      this.apiKey = config;\n      this.baseUrl = 'https://api.tosend.com';\n      this.timeout = 30000;\n    } else {\n      this.apiKey = config.apiKey;\n      this.baseUrl = config.baseUrl?.replace(/\\/$/, '') ?? 'https://api.tosend.com';\n      this.timeout = config.timeout ?? 30000;\n    }\n\n    if (!this.apiKey?.trim()) {\n      throw new ToSendError('API key is required', 401);\n    }\n  }\n\n  /**\n   * Send a single email.\n   *\n   * @example\n   * ```ts\n   * const response = await tosend.send({\n   *   from: { email: 'hello@example.com', name: 'My App' },\n   *   to: [{ email: 'user@example.com' }],\n   *   subject: 'Hello!',\n   *   html: '<p>Welcome!</p>'\n   * });\n   * console.log(response.message_id);\n   * ```\n   */\n  async send(params: SendEmailParams): Promise<SendEmailResponse> {\n    this.validateEmailParams(params);\n    return this.request<SendEmailResponse>('POST', '/v2/emails', params);\n  }\n\n  /**\n   * Send multiple emails in a single request.\n   *\n   * @example\n   * ```ts\n   * const response = await tosend.batch([\n   *   {\n   *     from: { email: 'hello@example.com' },\n   *     to: [{ email: 'user1@example.com' }],\n   *     subject: 'Hello User 1',\n   *     html: '<p>Hi!</p>'\n   *   },\n   *   {\n   *     from: { email: 'hello@example.com' },\n   *     to: [{ email: 'user2@example.com' }],\n   *     subject: 'Hello User 2',\n   *     html: '<p>Hi!</p>'\n   *   }\n   * ]);\n   *\n   * response.results.forEach(result => {\n   *   if (result.status === 'success') {\n   *     console.log('Sent:', result.message_id);\n   *   }\n   * });\n   * ```\n   */\n  async batch(emails: SendEmailParams[]): Promise<BatchEmailResponse> {\n    if (!emails?.length) {\n      throw new ToSendError('Emails array is required and cannot be empty', 422, {\n        emails: { required: 'At least one email is required' },\n      });\n    }\n\n    emails.forEach((email, index) => {\n      try {\n        this.validateEmailParams(email);\n      } catch (error) {\n        if (error instanceof ToSendError) {\n          throw new ToSendError(\n            `Email at index ${index}: ${error.message}`,\n            error.code,\n            error.errors\n          );\n        }\n        throw error;\n      }\n    });\n\n    return this.request<BatchEmailResponse>('POST', '/v2/emails/batch', { emails });\n  }\n\n  /**\n   * Get account information and domains.\n   *\n   * @example\n   * ```ts\n   * const info = await tosend.getAccountInfo();\n   * console.log(info.account.title);\n   * console.log(info.account.emails_usage_this_month);\n   * info.domains.forEach(d => console.log(d.domain_name, d.verification_status));\n   * ```\n   */\n  async getAccountInfo(): Promise<AccountInfo> {\n    return this.request<AccountInfo>('GET', '/v2/info');\n  }\n\n  // ==========================================================================\n  // Private Methods\n  // ==========================================================================\n\n  private validateEmailParams(params: SendEmailParams): void {\n    const errors: Record<string, Record<string, string>> = {};\n\n    if (!params.from?.email) {\n      errors.from = { required: 'From email is required' };\n    } else if (!this.isValidEmail(params.from.email)) {\n      errors.from = { invalid: 'From email is invalid' };\n    }\n\n    if (!params.to?.length) {\n      errors.to = { required: 'To is required' };\n    } else {\n      const hasValidRecipient = params.to.some(\n        (r) => r.email && this.isValidEmail(r.email)\n      );\n      if (!hasValidRecipient) {\n        errors.to = { invalid: 'At least one valid recipient email is required' };\n      }\n    }\n\n    if (!params.subject) {\n      errors.subject = { required: 'Subject is required' };\n    }\n\n    if (!params.html && !params.text) {\n      errors.content = { required: 'Either html or text content is required' };\n    }\n\n    if (Object.keys(errors).length > 0) {\n      const firstError = Object.values(errors)[0];\n      const message = Object.values(firstError)[0];\n      throw new ToSendError(message, 422, errors);\n    }\n  }\n\n  private isValidEmail(email: string): boolean {\n    return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email);\n  }\n\n  private async request<T>(\n    method: 'GET' | 'POST',\n    endpoint: string,\n    body?: unknown\n  ): Promise<T> {\n    const url = `${this.baseUrl}${endpoint}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          Accept: 'application/json',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      const data = await response.json() as T & { message?: string; errors?: Record<string, Record<string, string>> };\n\n      if (!response.ok) {\n        throw new ToSendError(\n          data.message ?? 'Unknown error',\n          response.status,\n          data.errors ?? {}\n        );\n      }\n\n      return data;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof ToSendError) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          throw new ToSendError('Request timeout', 408);\n        }\n        throw new ToSendError(error.message);\n      }\n\n      throw new ToSendError('Unknown error');\n    }\n  }\n}\n\n// ============================================================================\n// Default Export\n// ============================================================================\n\nexport default ToSend;\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,201 @@
+// src/index.ts
+var ToSendError = class extends Error {
+  code;
+  errors;
+  constructor(message, code = 0, errors = {}) {
+    super(message);
+    this.name = "ToSendError";
+    this.code = code;
+    this.errors = errors;
+  }
+  get isValidationError() {
+    return this.code === 422;
+  }
+  get isAuthenticationError() {
+    return this.code === 401 || this.code === 403;
+  }
+  get isRateLimitError() {
+    return this.code === 429;
+  }
+};
+var ToSend = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    if (typeof config === "string") {
+      this.apiKey = config;
+      this.baseUrl = "https://api.tosend.com";
+      this.timeout = 3e4;
+    } else {
+      this.apiKey = config.apiKey;
+      this.baseUrl = config.baseUrl?.replace(/\/$/, "") ?? "https://api.tosend.com";
+      this.timeout = config.timeout ?? 3e4;
+    }
+    if (!this.apiKey?.trim()) {
+      throw new ToSendError("API key is required", 401);
+    }
+  }
+  /**
+   * Send a single email.
+   *
+   * @example
+   * ```ts
+   * const response = await tosend.send({
+   *   from: { email: 'hello@example.com', name: 'My App' },
+   *   to: [{ email: 'user@example.com' }],
+   *   subject: 'Hello!',
+   *   html: '<p>Welcome!</p>'
+   * });
+   * console.log(response.message_id);
+   * ```
+   */
+  async send(params) {
+    this.validateEmailParams(params);
+    return this.request("POST", "/v2/emails", params);
+  }
+  /**
+   * Send multiple emails in a single request.
+   *
+   * @example
+   * ```ts
+   * const response = await tosend.batch([
+   *   {
+   *     from: { email: 'hello@example.com' },
+   *     to: [{ email: 'user1@example.com' }],
+   *     subject: 'Hello User 1',
+   *     html: '<p>Hi!</p>'
+   *   },
+   *   {
+   *     from: { email: 'hello@example.com' },
+   *     to: [{ email: 'user2@example.com' }],
+   *     subject: 'Hello User 2',
+   *     html: '<p>Hi!</p>'
+   *   }
+   * ]);
+   *
+   * response.results.forEach(result => {
+   *   if (result.status === 'success') {
+   *     console.log('Sent:', result.message_id);
+   *   }
+   * });
+   * ```
+   */
+  async batch(emails) {
+    if (!emails?.length) {
+      throw new ToSendError("Emails array is required and cannot be empty", 422, {
+        emails: { required: "At least one email is required" }
+      });
+    }
+    emails.forEach((email, index) => {
+      try {
+        this.validateEmailParams(email);
+      } catch (error) {
+        if (error instanceof ToSendError) {
+          throw new ToSendError(
+            `Email at index ${index}: ${error.message}`,
+            error.code,
+            error.errors
+          );
+        }
+        throw error;
+      }
+    });
+    return this.request("POST", "/v2/emails/batch", { emails });
+  }
+  /**
+   * Get account information and domains.
+   *
+   * @example
+   * ```ts
+   * const info = await tosend.getAccountInfo();
+   * console.log(info.account.title);
+   * console.log(info.account.emails_usage_this_month);
+   * info.domains.forEach(d => console.log(d.domain_name, d.verification_status));
+   * ```
+   */
+  async getAccountInfo() {
+    return this.request("GET", "/v2/info");
+  }
+  // ==========================================================================
+  // Private Methods
+  // ==========================================================================
+  validateEmailParams(params) {
+    const errors = {};
+    if (!params.from?.email) {
+      errors.from = { required: "From email is required" };
+    } else if (!this.isValidEmail(params.from.email)) {
+      errors.from = { invalid: "From email is invalid" };
+    }
+    if (!params.to?.length) {
+      errors.to = { required: "To is required" };
+    } else {
+      const hasValidRecipient = params.to.some(
+        (r) => r.email && this.isValidEmail(r.email)
+      );
+      if (!hasValidRecipient) {
+        errors.to = { invalid: "At least one valid recipient email is required" };
+      }
+    }
+    if (!params.subject) {
+      errors.subject = { required: "Subject is required" };
+    }
+    if (!params.html && !params.text) {
+      errors.content = { required: "Either html or text content is required" };
+    }
+    if (Object.keys(errors).length > 0) {
+      const firstError = Object.values(errors)[0];
+      const message = Object.values(firstError)[0];
+      throw new ToSendError(message, 422, errors);
+    }
+  }
+  isValidEmail(email) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+  }
+  async request(method, endpoint, body) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const data = await response.json();
+      if (!response.ok) {
+        throw new ToSendError(
+          data.message ?? "Unknown error",
+          response.status,
+          data.errors ?? {}
+        );
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof ToSendError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new ToSendError("Request timeout", 408);
+        }
+        throw new ToSendError(error.message);
+      }
+      throw new ToSendError("Unknown error");
+    }
+  }
+};
+var index_default = ToSend;
+export {
+  ToSend,
+  ToSendError,
+  index_default as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * ToSend Node.js SDK\n *\n * Official SDK for the ToSend email API.\n * @see https://tosend.com/docs\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface Address {\n  email: string;\n  name?: string;\n}\n\nexport interface Attachment {\n  /** MIME type (e.g., 'application/pdf') */\n  type: string;\n  /** Filename */\n  name: string;\n  /** Base64 encoded content */\n  content: string;\n}\n\nexport interface SendEmailParams {\n  /** Sender address */\n  from: Address;\n  /** Recipients (max 50) */\n  to: Address[];\n  /** Email subject */\n  subject: string;\n  /** HTML content */\n  html?: string;\n  /** Plain text content */\n  text?: string;\n  /** CC recipients */\n  cc?: Address[];\n  /** BCC recipients */\n  bcc?: Address[];\n  /** Reply-to address */\n  reply_to?: Address;\n  /** Custom headers */\n  headers?: Record<string, string>;\n  /** File attachments */\n  attachments?: Attachment[];\n}\n\nexport interface SendEmailResponse {\n  message_id: string;\n}\n\nexport interface BatchEmailResult {\n  status: 'success' | 'error' | 'spam';\n  message_id?: string;\n  message?: string;\n  errors?: Record<string, Record<string, string>>;\n}\n\nexport interface BatchEmailResponse {\n  results: BatchEmailResult[];\n}\n\nexport interface Domain {\n  domain_name: string;\n  verification_status: 'pending' | 'verified' | 'failed';\n  created_at: string;\n}\n\nexport interface AccountInfo {\n  account: {\n    title: string;\n    plan_type: string;\n    status: string;\n    emails_usage_this_month: number;\n    emails_sent_last_24hrs: number;\n  };\n  domains: Domain[];\n}\n\nexport interface ToSendErrorResponse {\n  error_code: number;\n  message: string;\n  errors?: Record<string, Record<string, string>>;\n}\n\nexport interface ToSendConfig {\n  /** Your ToSend API key */\n  apiKey: string;\n  /** Custom base URL (optional) */\n  baseUrl?: string;\n  /** Request timeout in ms (default: 30000) */\n  timeout?: number;\n}\n\n// ============================================================================\n// Error Class\n// ============================================================================\n\nexport class ToSendError extends Error {\n  readonly code: number;\n  readonly errors: Record<string, Record<string, string>>;\n\n  constructor(\n    message: string,\n    code: number = 0,\n    errors: Record<string, Record<string, string>> = {}\n  ) {\n    super(message);\n    this.name = 'ToSendError';\n    this.code = code;\n    this.errors = errors;\n  }\n\n  get isValidationError(): boolean {\n    return this.code === 422;\n  }\n\n  get isAuthenticationError(): boolean {\n    return this.code === 401 || this.code === 403;\n  }\n\n  get isRateLimitError(): boolean {\n    return this.code === 429;\n  }\n}\n\n// ============================================================================\n// Main Client\n// ============================================================================\n\nexport class ToSend {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(config: string | ToSendConfig) {\n    if (typeof config === 'string') {\n      this.apiKey = config;\n      this.baseUrl = 'https://api.tosend.com';\n      this.timeout = 30000;\n    } else {\n      this.apiKey = config.apiKey;\n      this.baseUrl = config.baseUrl?.replace(/\\/$/, '') ?? 'https://api.tosend.com';\n      this.timeout = config.timeout ?? 30000;\n    }\n\n    if (!this.apiKey?.trim()) {\n      throw new ToSendError('API key is required', 401);\n    }\n  }\n\n  /**\n   * Send a single email.\n   *\n   * @example\n   * ```ts\n   * const response = await tosend.send({\n   *   from: { email: 'hello@example.com', name: 'My App' },\n   *   to: [{ email: 'user@example.com' }],\n   *   subject: 'Hello!',\n   *   html: '<p>Welcome!</p>'\n   * });\n   * console.log(response.message_id);\n   * ```\n   */\n  async send(params: SendEmailParams): Promise<SendEmailResponse> {\n    this.validateEmailParams(params);\n    return this.request<SendEmailResponse>('POST', '/v2/emails', params);\n  }\n\n  /**\n   * Send multiple emails in a single request.\n   *\n   * @example\n   * ```ts\n   * const response = await tosend.batch([\n   *   {\n   *     from: { email: 'hello@example.com' },\n   *     to: [{ email: 'user1@example.com' }],\n   *     subject: 'Hello User 1',\n   *     html: '<p>Hi!</p>'\n   *   },\n   *   {\n   *     from: { email: 'hello@example.com' },\n   *     to: [{ email: 'user2@example.com' }],\n   *     subject: 'Hello User 2',\n   *     html: '<p>Hi!</p>'\n   *   }\n   * ]);\n   *\n   * response.results.forEach(result => {\n   *   if (result.status === 'success') {\n   *     console.log('Sent:', result.message_id);\n   *   }\n   * });\n   * ```\n   */\n  async batch(emails: SendEmailParams[]): Promise<BatchEmailResponse> {\n    if (!emails?.length) {\n      throw new ToSendError('Emails array is required and cannot be empty', 422, {\n        emails: { required: 'At least one email is required' },\n      });\n    }\n\n    emails.forEach((email, index) => {\n      try {\n        this.validateEmailParams(email);\n      } catch (error) {\n        if (error instanceof ToSendError) {\n          throw new ToSendError(\n            `Email at index ${index}: ${error.message}`,\n            error.code,\n            error.errors\n          );\n        }\n        throw error;\n      }\n    });\n\n    return this.request<BatchEmailResponse>('POST', '/v2/emails/batch', { emails });\n  }\n\n  /**\n   * Get account information and domains.\n   *\n   * @example\n   * ```ts\n   * const info = await tosend.getAccountInfo();\n   * console.log(info.account.title);\n   * console.log(info.account.emails_usage_this_month);\n   * info.domains.forEach(d => console.log(d.domain_name, d.verification_status));\n   * ```\n   */\n  async getAccountInfo(): Promise<AccountInfo> {\n    return this.request<AccountInfo>('GET', '/v2/info');\n  }\n\n  // ==========================================================================\n  // Private Methods\n  // ==========================================================================\n\n  private validateEmailParams(params: SendEmailParams): void {\n    const errors: Record<string, Record<string, string>> = {};\n\n    if (!params.from?.email) {\n      errors.from = { required: 'From email is required' };\n    } else if (!this.isValidEmail(params.from.email)) {\n      errors.from = { invalid: 'From email is invalid' };\n    }\n\n    if (!params.to?.length) {\n      errors.to = { required: 'To is required' };\n    } else {\n      const hasValidRecipient = params.to.some(\n        (r) => r.email && this.isValidEmail(r.email)\n      );\n      if (!hasValidRecipient) {\n        errors.to = { invalid: 'At least one valid recipient email is required' };\n      }\n    }\n\n    if (!params.subject) {\n      errors.subject = { required: 'Subject is required' };\n    }\n\n    if (!params.html && !params.text) {\n      errors.content = { required: 'Either html or text content is required' };\n    }\n\n    if (Object.keys(errors).length > 0) {\n      const firstError = Object.values(errors)[0];\n      const message = Object.values(firstError)[0];\n      throw new ToSendError(message, 422, errors);\n    }\n  }\n\n  private isValidEmail(email: string): boolean {\n    return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email);\n  }\n\n  private async request<T>(\n    method: 'GET' | 'POST',\n    endpoint: string,\n    body?: unknown\n  ): Promise<T> {\n    const url = `${this.baseUrl}${endpoint}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          Accept: 'application/json',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      const data = await response.json() as T & { message?: string; errors?: Record<string, Record<string, string>> };\n\n      if (!response.ok) {\n        throw new ToSendError(\n          data.message ?? 'Unknown error',\n          response.status,\n          data.errors ?? {}\n        );\n      }\n\n      return data;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof ToSendError) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          throw new ToSendError('Request timeout', 408);\n        }\n        throw new ToSendError(error.message);\n      }\n\n      throw new ToSendError('Unknown error');\n    }\n  }\n}\n\n// ============================================================================\n// Default Export\n// ============================================================================\n\nexport default ToSend;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "tosend",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for the ToSend email API",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "email",
+    "api",
+    "tosend",
+    "transactional",
+    "mail",
+    "smtp"
+  ],
+  "author": "ToSend <support@tosend.com>",
+  "license": "MIT",
+  "homepage": "https://tosend.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tosend/tosend-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tosend/tosend-node/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}