@sendmailos/sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,525 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/utils/errors.ts
+var SendMailOSError = class _SendMailOSError extends Error {
+  constructor(message, code, statusCode, retryAfter) {
+    super(message);
+    this.name = "SendMailOSError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.retryAfter = retryAfter;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _SendMailOSError);
+    }
+  }
+  /** Whether this error is retryable (rate limit or server error) */
+  get isRetryable() {
+    return this.statusCode === 429 || this.statusCode >= 500;
+  }
+};
+var AuthenticationError = class extends SendMailOSError {
+  constructor(message = "Invalid API key") {
+    super(message, "UNAUTHORIZED", 401);
+    this.name = "AuthenticationError";
+  }
+};
+var ValidationError = class extends SendMailOSError {
+  constructor(message) {
+    super(message, "VALIDATION_ERROR", 400);
+    this.name = "ValidationError";
+  }
+};
+var RateLimitError = class extends SendMailOSError {
+  constructor(message, retryAfter) {
+    super(message, "RATE_LIMITED", 429, retryAfter);
+    this.name = "RateLimitError";
+  }
+};
+var NotFoundError = class extends SendMailOSError {
+  constructor(message) {
+    super(message, "NOT_FOUND", 404);
+    this.name = "NotFoundError";
+  }
+};
+
+// src/resources/emails.ts
+var EmailsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * Send a transactional email
+   * 
+   * @example
+   * ```ts
+   * const result = await client.emails.send({
+   *   to: 'user@example.com',
+   *   fromName: 'Your Company',
+   *   fromEmail: 'hello@yourcompany.com',
+   *   subject: 'Welcome!',
+   *   html: '<h1>Hello!</h1>'
+   * });
+   * ```
+   */
+  async send(params) {
+    return this.request("/send", {
+      method: "POST",
+      body: JSON.stringify({
+        to: params.to,
+        subject: params.subject,
+        html: params.html,
+        templateId: params.templateId,
+        from_name: params.fromName,
+        from_email: params.fromEmail,
+        variables: params.variables,
+        type: params.type || "transactional"
+      })
+    });
+  }
+  /**
+   * Send email using a template
+   * 
+   * @example
+   * ```ts
+   * const result = await client.emails.sendTemplate({
+   *   to: 'user@example.com',
+   *   templateId: 'tmpl_welcome',
+   *   variables: { firstName: 'John' }
+   * });
+   * ```
+   */
+  async sendTemplate(params) {
+    return this.send({
+      to: params.to,
+      subject: params.subject || "",
+      templateId: params.templateId,
+      fromName: params.fromName,
+      fromEmail: params.fromEmail,
+      variables: params.variables,
+      type: "transactional"
+    });
+  }
+};
+
+// src/resources/subscribers.ts
+var SubscribersResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * Create or update a subscriber (upsert)
+   * 
+   * @example
+   * ```ts
+   * const { subscriber } = await client.subscribers.create({
+   *   email: 'user@example.com',
+   *   firstName: 'John',
+   *   tags: ['newsletter', 'premium']
+   * });
+   * ```
+   */
+  async create(params) {
+    return this.request("/subscribers", {
+      method: "POST",
+      body: JSON.stringify({
+        email: params.email,
+        first_name: params.firstName,
+        last_name: params.lastName,
+        tags: params.tags,
+        domain_id: params.domainId
+      })
+    });
+  }
+  /**
+   * List all subscribers with pagination
+   * 
+   * @example
+   * ```ts
+   * const { subscribers, total } = await client.subscribers.list({
+   *   limit: 50,
+   *   offset: 0
+   * });
+   * ```
+   */
+  async list(params = {}) {
+    const searchParams = new URLSearchParams();
+    if (params.limit) searchParams.set("limit", String(params.limit));
+    if (params.offset) searchParams.set("offset", String(params.offset));
+    const query = searchParams.toString();
+    const endpoint = query ? `/subscribers?${query}` : "/subscribers";
+    return this.request(endpoint, {
+      method: "GET"
+    });
+  }
+  /**
+   * Get a single subscriber by ID
+   */
+  async get(subscriberId) {
+    return this.request(`/subscribers/${subscriberId}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Update a subscriber by ID
+   */
+  async update(subscriberId, params) {
+    return this.request(`/subscribers/${subscriberId}`, {
+      method: "PATCH",
+      body: JSON.stringify({
+        first_name: params.firstName,
+        last_name: params.lastName,
+        tags: params.tags
+      })
+    });
+  }
+  /**
+   * Update a subscriber by email address
+   */
+  async updateByEmail(email, params) {
+    return this.create({
+      email,
+      ...params
+    });
+  }
+  /**
+   * Delete/unsubscribe a subscriber
+   */
+  async delete(subscriberId) {
+    return this.request(`/subscribers/${subscriberId}`, {
+      method: "DELETE"
+    });
+  }
+  /**
+   * Add tags to a subscriber
+   */
+  async addTags(subscriberId, tags) {
+    return this.request(`/subscribers/${subscriberId}/tags`, {
+      method: "POST",
+      body: JSON.stringify({ tags })
+    });
+  }
+  /**
+   * Remove tags from a subscriber
+   */
+  async removeTags(subscriberId, tags) {
+    return this.request(`/subscribers/${subscriberId}/tags`, {
+      method: "DELETE",
+      body: JSON.stringify({ tags })
+    });
+  }
+};
+
+// src/resources/campaigns.ts
+var CampaignsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * Send a campaign to subscribers
+   * 
+   * @example
+   * ```ts
+   * const result = await client.campaigns.send({
+   *   name: 'January Newsletter',
+   *   subject: 'What\'s new this month',
+   *   fromName: 'Your Company',
+   *   fromEmail: 'news@yourcompany.com',
+   *   html: '<h1>Hello {{first_name}}!</h1>',
+   *   tags: ['newsletter', 'active']
+   * });
+   * ```
+   */
+  async send(params) {
+    return this.request("/campaigns/send", {
+      method: "POST",
+      body: JSON.stringify({
+        name: params.name,
+        subject: params.subject,
+        from_name: params.fromName,
+        from_email: params.fromEmail,
+        html: params.html,
+        templateId: params.templateId,
+        tags: params.tags,
+        variables: params.variables
+      })
+    });
+  }
+  /**
+   * Send campaign using a saved template
+   */
+  async sendTemplate(params) {
+    return this.send({
+      name: params.name,
+      subject: params.subject,
+      fromName: params.fromName,
+      fromEmail: params.fromEmail,
+      templateId: params.templateId,
+      tags: params.tags,
+      variables: params.variables
+    });
+  }
+};
+
+// src/resources/domains.ts
+var DomainsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * Add a new sending domain
+   * Returns DKIM tokens and DNS records for verification
+   * 
+   * @example
+   * ```ts
+   * const { domain } = await client.domains.create({
+   *   domain: 'yourcompany.com'
+   * });
+   * 
+   * console.log('Add these DNS records:', domain.dnsRecords);
+   * ```
+   */
+  async create(params) {
+    return this.request("/domains", {
+      method: "POST",
+      body: JSON.stringify({
+        domain: params.domain
+      })
+    });
+  }
+  /**
+   * List all domains for the organization
+   */
+  async list() {
+    return this.request("/domains", {
+      method: "GET"
+    });
+  }
+  /**
+   * Get a single domain by ID
+   */
+  async get(domainId) {
+    return this.request(`/domains/${domainId}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Verify a domain (trigger DNS check)
+   */
+  async verify(domainId) {
+    return this.request(`/domains/${domainId}/verify`, {
+      method: "POST"
+    });
+  }
+  /**
+   * Delete a domain
+   */
+  async delete(domainId) {
+    return this.request(`/domains/${domainId}`, {
+      method: "DELETE"
+    });
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.sendmailos.com/api/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var SDK_VERSION = "1.0.0";
+var SendMailOS = class {
+  constructor(apiKey, options = {}) {
+    if (!apiKey) {
+      throw new Error("API key is required");
+    }
+    if (!apiKey.startsWith("sk_live_") && !apiKey.startsWith("sk_test_")) {
+      throw new Error(
+        'Invalid API key format. Keys should start with "sk_live_" or "sk_test_"'
+      );
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = options.baseUrl?.replace(/\/$/, "") || DEFAULT_BASE_URL;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT;
+    this.fetchFn = options.fetch || globalThis.fetch;
+    if (!this.fetchFn) {
+      throw new Error(
+        "fetch is not available. Please provide a fetch implementation or use Node.js 18+"
+      );
+    }
+    const boundRequest = this.request.bind(this);
+    this.emails = new EmailsResource(boundRequest);
+    this.subscribers = new SubscribersResource(boundRequest);
+    this.campaigns = new CampaignsResource(boundRequest);
+    this.domains = new DomainsResource(boundRequest);
+  }
+  /**
+   * Make an authenticated request to the API
+   */
+  async request(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await this.fetchFn(url, {
+        ...options,
+        signal: controller.signal,
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          "User-Agent": `sendmailos-sdk/${SDK_VERSION}`,
+          "X-SDK-Version": SDK_VERSION,
+          ...options.headers
+        }
+      });
+      clearTimeout(timeoutId);
+      if (response.status === 429) {
+        const retryAfter = parseInt(response.headers.get("Retry-After") || "60", 10);
+        const errorData = await this.safeParseJson(response);
+        throw new RateLimitError(
+          errorData?.error || "Rate limit exceeded",
+          retryAfter
+        );
+      }
+      if (response.status === 401) {
+        throw new AuthenticationError();
+      }
+      if (!response.ok) {
+        const errorData = await this.safeParseJson(response);
+        throw new SendMailOSError(
+          errorData?.error || `Request failed with status ${response.status}`,
+          errorData?.code || "UNKNOWN_ERROR",
+          response.status
+        );
+      }
+      return response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof SendMailOSError) {
+        throw error;
+      }
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new SendMailOSError("Request timeout", "TIMEOUT", 408);
+      }
+      throw new SendMailOSError(
+        error instanceof Error ? error.message : "Unknown error",
+        "NETWORK_ERROR",
+        0
+      );
+    }
+  }
+  async safeParseJson(response) {
+    try {
+      return await response.json();
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Check if the API key is valid (test mode only)
+   */
+  get isTestMode() {
+    return this.apiKey.startsWith("sk_test_");
+  }
+  /**
+   * Get the SDK version
+   */
+  static get version() {
+    return SDK_VERSION;
+  }
+};
+
+// src/utils/webhook.ts
+function verifyWebhookSignature(params) {
+  const { payload, signature, timestamp, secret, tolerance = 300 } = params;
+  if (!payload || !signature || !timestamp || !secret) {
+    return false;
+  }
+  const timestampInt = parseInt(timestamp, 10);
+  if (isNaN(timestampInt)) {
+    return false;
+  }
+  const age = Math.floor(Date.now() / 1e3) - timestampInt;
+  if (age > tolerance) {
+    console.warn("[SendMailOS] Webhook timestamp too old:", age, "seconds");
+    return false;
+  }
+  if (typeof globalThis.crypto !== "undefined" && "subtle" in globalThis.crypto) {
+    return verifySync(payload, signature, timestamp, secret);
+  }
+  return verifySync(payload, signature, timestamp, secret);
+}
+async function verifyWebhookSignatureAsync(params) {
+  const { payload, signature, timestamp, secret, tolerance = 300 } = params;
+  if (!payload || !signature || !timestamp || !secret) {
+    return false;
+  }
+  const timestampInt = parseInt(timestamp, 10);
+  if (isNaN(timestampInt)) {
+    return false;
+  }
+  const age = Math.floor(Date.now() / 1e3) - timestampInt;
+  if (age > tolerance) {
+    return false;
+  }
+  const message = `${timestamp}.${payload}`;
+  const encoder = new TextEncoder();
+  const key = await crypto.subtle.importKey(
+    "raw",
+    encoder.encode(secret),
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const signatureBytes = await crypto.subtle.sign(
+    "HMAC",
+    key,
+    encoder.encode(message)
+  );
+  const expectedSig = bufferToHex(signatureBytes);
+  return timingSafeEqual(signature, expectedSig);
+}
+function verifySync(payload, signature, timestamp, secret) {
+  try {
+    const crypto2 = __require("crypto");
+    const message = `${timestamp}.${payload}`;
+    const expectedSig = crypto2.createHmac("sha256", secret).update(message).digest("hex");
+    return crypto2.timingSafeEqual(
+      Buffer.from(signature),
+      Buffer.from(expectedSig)
+    );
+  } catch {
+    console.warn("[SendMailOS] Use verifyWebhookSignatureAsync for browser/edge");
+    return false;
+  }
+}
+function bufferToHex(buffer) {
+  return Array.from(new Uint8Array(buffer)).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function timingSafeEqual(a, b) {
+  if (a.length !== b.length) {
+    return false;
+  }
+  let result = 0;
+  for (let i = 0; i < a.length; i++) {
+    result |= a.charCodeAt(i) ^ b.charCodeAt(i);
+  }
+  return result === 0;
+}
+function constructWebhookEvent(payload, headers, secret) {
+  const isValid = verifyWebhookSignature({
+    payload,
+    signature: headers.signature,
+    timestamp: headers.timestamp,
+    secret
+  });
+  if (!isValid) {
+    throw new Error("Invalid webhook signature");
+  }
+  return JSON.parse(payload);
+}
+
+export { AuthenticationError, NotFoundError, RateLimitError, SendMailOS, SendMailOSError, ValidationError, constructWebhookEvent, SendMailOS as default, verifyWebhookSignature, verifyWebhookSignatureAsync };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/errors.ts","../src/resources/emails.ts","../src/resources/subscribers.ts","../src/resources/campaigns.ts","../src/resources/domains.ts","../src/client.ts","../src/utils/webhook.ts"],"names":["crypto"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Custom error classes for SendMailOS SDK\n */\n\nexport class SendMailOSError extends Error {\n  public readonly code: string;\n  public readonly statusCode: number;\n  public readonly retryAfter?: number;\n\n  constructor(\n    message: string,\n    code: string,\n    statusCode: number,\n    retryAfter?: number\n  ) {\n    super(message);\n    this.name = 'SendMailOSError';\n    this.code = code;\n    this.statusCode = statusCode;\n    this.retryAfter = retryAfter;\n    \n    // Maintains proper stack trace for where error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, SendMailOSError);\n    }\n  }\n\n  /** Whether this error is retryable (rate limit or server error) */\n  get isRetryable(): boolean {\n    return this.statusCode === 429 || this.statusCode >= 500;\n  }\n}\n\nexport class AuthenticationError extends SendMailOSError {\n  constructor(message: string = 'Invalid API key') {\n    super(message, 'UNAUTHORIZED', 401);\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class ValidationError extends SendMailOSError {\n  constructor(message: string) {\n    super(message, 'VALIDATION_ERROR', 400);\n    this.name = 'ValidationError';\n  }\n}\n\nexport class RateLimitError extends SendMailOSError {\n  constructor(message: string, retryAfter: number) {\n    super(message, 'RATE_LIMITED', 429, retryAfter);\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class NotFoundError extends SendMailOSError {\n  constructor(message: string) {\n    super(message, 'NOT_FOUND', 404);\n    this.name = 'NotFoundError';\n  }\n}\n","import type { SendEmailRequest, SendEmailResponse } from '../types';\n\n/**\n * Emails resource for sending transactional emails\n */\nexport class EmailsResource {\n  constructor(\n    private request: <T>(endpoint: string, options?: RequestInit) => Promise<T>\n  ) {}\n\n  /**\n   * Send a transactional email\n   * \n   * @example\n   * ```ts\n   * const result = await client.emails.send({\n   *   to: 'user@example.com',\n   *   fromName: 'Your Company',\n   *   fromEmail: 'hello@yourcompany.com',\n   *   subject: 'Welcome!',\n   *   html: '<h1>Hello!</h1>'\n   * });\n   * ```\n   */\n  async send(params: SendEmailRequest): Promise<SendEmailResponse> {\n    return this.request<SendEmailResponse>('/send', {\n      method: 'POST',\n      body: JSON.stringify({\n        to: params.to,\n        subject: params.subject,\n        html: params.html,\n        templateId: params.templateId,\n        from_name: params.fromName,\n        from_email: params.fromEmail,\n        variables: params.variables,\n        type: params.type || 'transactional',\n      }),\n    });\n  }\n\n  /**\n   * Send email using a template\n   * \n   * @example\n   * ```ts\n   * const result = await client.emails.sendTemplate({\n   *   to: 'user@example.com',\n   *   templateId: 'tmpl_welcome',\n   *   variables: { firstName: 'John' }\n   * });\n   * ```\n   */\n  async sendTemplate(params: {\n    to: string;\n    templateId: string;\n    fromName?: string;\n    fromEmail?: string;\n    subject?: string;\n    variables?: Record<string, unknown>;\n  }): Promise<SendEmailResponse> {\n    return this.send({\n      to: params.to,\n      subject: params.subject || '',\n      templateId: params.templateId,\n      fromName: params.fromName,\n      fromEmail: params.fromEmail,\n      variables: params.variables,\n      type: 'transactional',\n    });\n  }\n}\n","import type {\n  Subscriber,\n  CreateSubscriberRequest,\n  CreateSubscriberResponse,\n  ListSubscribersRequest,\n  ListSubscribersResponse,\n} from '../types';\n\n/**\n * Subscribers resource for managing email contacts\n */\nexport class SubscribersResource {\n  constructor(\n    private request: <T>(endpoint: string, options?: RequestInit) => Promise<T>\n  ) {}\n\n  /**\n   * Create or update a subscriber (upsert)\n   * \n   * @example\n   * ```ts\n   * const { subscriber } = await client.subscribers.create({\n   *   email: 'user@example.com',\n   *   firstName: 'John',\n   *   tags: ['newsletter', 'premium']\n   * });\n   * ```\n   */\n  async create(params: CreateSubscriberRequest): Promise<CreateSubscriberResponse> {\n    return this.request<CreateSubscriberResponse>('/subscribers', {\n      method: 'POST',\n      body: JSON.stringify({\n        email: params.email,\n        first_name: params.firstName,\n        last_name: params.lastName,\n        tags: params.tags,\n        domain_id: params.domainId,\n      }),\n    });\n  }\n\n  /**\n   * List all subscribers with pagination\n   * \n   * @example\n   * ```ts\n   * const { subscribers, total } = await client.subscribers.list({\n   *   limit: 50,\n   *   offset: 0\n   * });\n   * ```\n   */\n  async list(params: ListSubscribersRequest = {}): Promise<ListSubscribersResponse> {\n    const searchParams = new URLSearchParams();\n    if (params.limit) searchParams.set('limit', String(params.limit));\n    if (params.offset) searchParams.set('offset', String(params.offset));\n    \n    const query = searchParams.toString();\n    const endpoint = query ? `/subscribers?${query}` : '/subscribers';\n    \n    return this.request<ListSubscribersResponse>(endpoint, {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Get a single subscriber by ID\n   */\n  async get(subscriberId: string): Promise<{ success: boolean; subscriber: Subscriber }> {\n    return this.request(`/subscribers/${subscriberId}`, {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Update a subscriber by ID\n   */\n  async update(\n    subscriberId: string,\n    params: Partial<CreateSubscriberRequest>\n  ): Promise<CreateSubscriberResponse> {\n    return this.request<CreateSubscriberResponse>(`/subscribers/${subscriberId}`, {\n      method: 'PATCH',\n      body: JSON.stringify({\n        first_name: params.firstName,\n        last_name: params.lastName,\n        tags: params.tags,\n      }),\n    });\n  }\n\n  /**\n   * Update a subscriber by email address\n   */\n  async updateByEmail(\n    email: string,\n    params: Partial<Omit<CreateSubscriberRequest, 'email'>>\n  ): Promise<CreateSubscriberResponse> {\n    // Upsert via create endpoint\n    return this.create({\n      email,\n      ...params,\n    });\n  }\n\n  /**\n   * Delete/unsubscribe a subscriber\n   */\n  async delete(subscriberId: string): Promise<{ success: boolean }> {\n    return this.request(`/subscribers/${subscriberId}`, {\n      method: 'DELETE',\n    });\n  }\n\n  /**\n   * Add tags to a subscriber\n   */\n  async addTags(subscriberId: string, tags: string[]): Promise<CreateSubscriberResponse> {\n    return this.request<CreateSubscriberResponse>(`/subscribers/${subscriberId}/tags`, {\n      method: 'POST',\n      body: JSON.stringify({ tags }),\n    });\n  }\n\n  /**\n   * Remove tags from a subscriber\n   */\n  async removeTags(subscriberId: string, tags: string[]): Promise<CreateSubscriberResponse> {\n    return this.request<CreateSubscriberResponse>(`/subscribers/${subscriberId}/tags`, {\n      method: 'DELETE',\n      body: JSON.stringify({ tags }),\n    });\n  }\n}\n","import type { SendCampaignRequest, SendCampaignResponse } from '../types';\n\n/**\n * Campaigns resource for bulk email sending\n */\nexport class CampaignsResource {\n  constructor(\n    private request: <T>(endpoint: string, options?: RequestInit) => Promise<T>\n  ) {}\n\n  /**\n   * Send a campaign to subscribers\n   * \n   * @example\n   * ```ts\n   * const result = await client.campaigns.send({\n   *   name: 'January Newsletter',\n   *   subject: 'What\\'s new this month',\n   *   fromName: 'Your Company',\n   *   fromEmail: 'news@yourcompany.com',\n   *   html: '<h1>Hello {{first_name}}!</h1>',\n   *   tags: ['newsletter', 'active']\n   * });\n   * ```\n   */\n  async send(params: SendCampaignRequest): Promise<SendCampaignResponse> {\n    return this.request<SendCampaignResponse>('/campaigns/send', {\n      method: 'POST',\n      body: JSON.stringify({\n        name: params.name,\n        subject: params.subject,\n        from_name: params.fromName,\n        from_email: params.fromEmail,\n        html: params.html,\n        templateId: params.templateId,\n        tags: params.tags,\n        variables: params.variables,\n      }),\n    });\n  }\n\n  /**\n   * Send campaign using a saved template\n   */\n  async sendTemplate(params: {\n    name?: string;\n    templateId: string;\n    subject: string;\n    fromName: string;\n    fromEmail: string;\n    tags?: string[];\n    variables?: Record<string, unknown>;\n  }): Promise<SendCampaignResponse> {\n    return this.send({\n      name: params.name,\n      subject: params.subject,\n      fromName: params.fromName,\n      fromEmail: params.fromEmail,\n      templateId: params.templateId,\n      tags: params.tags,\n      variables: params.variables,\n    });\n  }\n}\n","import type {\n  Domain,\n  CreateDomainRequest,\n  CreateDomainResponse,\n  ListDomainsResponse,\n} from '../types';\n\n/**\n * Domains resource for managing sending domains\n */\nexport class DomainsResource {\n  constructor(\n    private request: <T>(endpoint: string, options?: RequestInit) => Promise<T>\n  ) {}\n\n  /**\n   * Add a new sending domain\n   * Returns DKIM tokens and DNS records for verification\n   * \n   * @example\n   * ```ts\n   * const { domain } = await client.domains.create({\n   *   domain: 'yourcompany.com'\n   * });\n   * \n   * console.log('Add these DNS records:', domain.dnsRecords);\n   * ```\n   */\n  async create(params: CreateDomainRequest): Promise<CreateDomainResponse> {\n    return this.request<CreateDomainResponse>('/domains', {\n      method: 'POST',\n      body: JSON.stringify({\n        domain: params.domain,\n      }),\n    });\n  }\n\n  /**\n   * List all domains for the organization\n   */\n  async list(): Promise<ListDomainsResponse> {\n    return this.request<ListDomainsResponse>('/domains', {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Get a single domain by ID\n   */\n  async get(domainId: string): Promise<{ success: boolean; domain: Domain }> {\n    return this.request(`/domains/${domainId}`, {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Verify a domain (trigger DNS check)\n   */\n  async verify(domainId: string): Promise<{ success: boolean; domain: Domain }> {\n    return this.request(`/domains/${domainId}/verify`, {\n      method: 'POST',\n    });\n  }\n\n  /**\n   * Delete a domain\n   */\n  async delete(domainId: string): Promise<{ success: boolean }> {\n    return this.request(`/domains/${domainId}`, {\n      method: 'DELETE',\n    });\n  }\n}\n","import type { SendMailOSOptions, ApiError } from './types';\nimport { SendMailOSError, AuthenticationError, RateLimitError } from './utils/errors';\nimport { EmailsResource } from './resources/emails';\nimport { SubscribersResource } from './resources/subscribers';\nimport { CampaignsResource } from './resources/campaigns';\nimport { DomainsResource } from './resources/domains';\n\nconst DEFAULT_BASE_URL = 'https://api.sendmailos.com/api/v1';\nconst DEFAULT_TIMEOUT = 30000;\nconst SDK_VERSION = '1.0.0';\n\n/**\n * SendMailOS SDK Client\n * \n * @example\n * ```ts\n * import { SendMailOS } from '@sendmailos/sdk';\n * \n * const client = new SendMailOS('sk_live_your_api_key');\n * \n * // Send an email\n * await client.emails.send({\n *   to: 'user@example.com',\n *   subject: 'Hello!',\n *   html: '<h1>Welcome!</h1>'\n * });\n * \n * // Add a subscriber\n * await client.subscribers.create({\n *   email: 'user@example.com',\n *   tags: ['newsletter']\n * });\n * ```\n */\nexport class SendMailOS {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n  private readonly fetchFn: typeof fetch;\n\n  /** Email sending operations */\n  public readonly emails: EmailsResource;\n  /** Subscriber management */\n  public readonly subscribers: SubscribersResource;\n  /** Campaign operations */\n  public readonly campaigns: CampaignsResource;\n  /** Domain management */\n  public readonly domains: DomainsResource;\n\n  constructor(apiKey: string, options: SendMailOSOptions = {}) {\n    // Validate API key format\n    if (!apiKey) {\n      throw new Error('API key is required');\n    }\n    \n    if (!apiKey.startsWith('sk_live_') && !apiKey.startsWith('sk_test_')) {\n      throw new Error(\n        'Invalid API key format. Keys should start with \"sk_live_\" or \"sk_test_\"'\n      );\n    }\n\n    this.apiKey = apiKey;\n    this.baseUrl = options.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n    this.timeout = options.timeout || DEFAULT_TIMEOUT;\n    this.fetchFn = options.fetch || globalThis.fetch;\n\n    // Ensure fetch is available\n    if (!this.fetchFn) {\n      throw new Error(\n        'fetch is not available. Please provide a fetch implementation or use Node.js 18+'\n      );\n    }\n\n    // Initialize resources with bound request method\n    const boundRequest = this.request.bind(this);\n    this.emails = new EmailsResource(boundRequest);\n    this.subscribers = new SubscribersResource(boundRequest);\n    this.campaigns = new CampaignsResource(boundRequest);\n    this.domains = new DomainsResource(boundRequest);\n  }\n\n  /**\n   * Make an authenticated request to the API\n   */\n  private async request<T>(endpoint: string, options: RequestInit = {}): 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 this.fetchFn(url, {\n        ...options,\n        signal: controller.signal,\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': `sendmailos-sdk/${SDK_VERSION}`,\n          'X-SDK-Version': SDK_VERSION,\n          ...options.headers,\n        },\n      });\n\n      clearTimeout(timeoutId);\n\n      // Handle rate limiting\n      if (response.status === 429) {\n        const retryAfter = parseInt(response.headers.get('Retry-After') || '60', 10);\n        const errorData = await this.safeParseJson(response);\n        throw new RateLimitError(\n          errorData?.error || 'Rate limit exceeded',\n          retryAfter\n        );\n      }\n\n      // Handle authentication errors\n      if (response.status === 401) {\n        throw new AuthenticationError();\n      }\n\n      // Handle other errors\n      if (!response.ok) {\n        const errorData = await this.safeParseJson(response) as ApiError | null;\n        throw new SendMailOSError(\n          errorData?.error || `Request failed with status ${response.status}`,\n          errorData?.code || 'UNKNOWN_ERROR',\n          response.status\n        );\n      }\n\n      return response.json() as Promise<T>;\n    } catch (error) {\n      clearTimeout(timeoutId);\n      \n      if (error instanceof SendMailOSError) {\n        throw error;\n      }\n      \n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new SendMailOSError('Request timeout', 'TIMEOUT', 408);\n      }\n      \n      throw new SendMailOSError(\n        error instanceof Error ? error.message : 'Unknown error',\n        'NETWORK_ERROR',\n        0\n      );\n    }\n  }\n\n  private async safeParseJson(response: Response): Promise<ApiError | null> {\n    try {\n      return await response.json();\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Check if the API key is valid (test mode only)\n   */\n  get isTestMode(): boolean {\n    return this.apiKey.startsWith('sk_test_');\n  }\n\n  /**\n   * Get the SDK version\n   */\n  static get version(): string {\n    return SDK_VERSION;\n  }\n}\n","/**\n * Webhook signature verification utilities\n * \n * IMPORTANT: This module uses timing-safe comparison to prevent timing attacks.\n */\n\nexport interface VerifyWebhookParams {\n  /** Raw request body as string */\n  payload: string;\n  /** Value of X-SendMailOS-Signature header */\n  signature: string;\n  /** Value of X-SendMailOS-Timestamp header */\n  timestamp: string;\n  /** Your webhook signing secret */\n  secret: string;\n  /** Maximum age in seconds (default: 300 = 5 minutes) */\n  tolerance?: number;\n}\n\n/**\n * Verify a webhook signature to ensure the request came from SendMailOS\n * \n * @example\n * ```ts\n * import { verifyWebhookSignature } from '@sendmailos/sdk';\n * \n * app.post('/webhooks', (req, res) => {\n *   const isValid = verifyWebhookSignature({\n *     payload: JSON.stringify(req.body),\n *     signature: req.headers['x-sendmailos-signature'],\n *     timestamp: req.headers['x-sendmailos-timestamp'],\n *     secret: process.env.WEBHOOK_SECRET\n *   });\n *   \n *   if (!isValid) {\n *     return res.status(401).json({ error: 'Invalid signature' });\n *   }\n *   \n *   // Process webhook...\n * });\n * ```\n */\nexport function verifyWebhookSignature(params: VerifyWebhookParams): boolean {\n  const { payload, signature, timestamp, secret, tolerance = 300 } = params;\n\n  // Validate inputs\n  if (!payload || !signature || !timestamp || !secret) {\n    return false;\n  }\n\n  // Prevent replay attacks - check timestamp age\n  const timestampInt = parseInt(timestamp, 10);\n  if (isNaN(timestampInt)) {\n    return false;\n  }\n\n  const age = Math.floor(Date.now() / 1000) - timestampInt;\n  if (age > tolerance) {\n    console.warn('[SendMailOS] Webhook timestamp too old:', age, 'seconds');\n    return false;\n  }\n\n  // Node.js crypto (server-side)\n  if (typeof globalThis.crypto !== 'undefined' && 'subtle' in globalThis.crypto) {\n    // Use SubtleCrypto for browser/edge environments\n    // Note: This is synchronous verification, use verifyWebhookSignatureAsync for async\n    return verifySync(payload, signature, timestamp, secret);\n  }\n\n  return verifySync(payload, signature, timestamp, secret);\n}\n\n/**\n * Async version of webhook verification (recommended for edge/browser)\n */\nexport async function verifyWebhookSignatureAsync(params: VerifyWebhookParams): Promise<boolean> {\n  const { payload, signature, timestamp, secret, tolerance = 300 } = params;\n\n  if (!payload || !signature || !timestamp || !secret) {\n    return false;\n  }\n\n  const timestampInt = parseInt(timestamp, 10);\n  if (isNaN(timestampInt)) {\n    return false;\n  }\n\n  const age = Math.floor(Date.now() / 1000) - timestampInt;\n  if (age > tolerance) {\n    return false;\n  }\n\n  const message = `${timestamp}.${payload}`;\n  \n  // Use Web Crypto API\n  const encoder = new TextEncoder();\n  const key = await crypto.subtle.importKey(\n    'raw',\n    encoder.encode(secret),\n    { name: 'HMAC', hash: 'SHA-256' },\n    false,\n    ['sign']\n  );\n  \n  const signatureBytes = await crypto.subtle.sign(\n    'HMAC',\n    key,\n    encoder.encode(message)\n  );\n  \n  const expectedSig = bufferToHex(signatureBytes);\n  \n  // Timing-safe comparison\n  return timingSafeEqual(signature, expectedSig);\n}\n\n// ============ Internal Helpers ============\n\nfunction verifySync(payload: string, signature: string, timestamp: string, secret: string): boolean {\n  try {\n    // Try Node.js crypto first\n    const crypto = require('crypto');\n    const message = `${timestamp}.${payload}`;\n    const expectedSig = crypto\n      .createHmac('sha256', secret)\n      .update(message)\n      .digest('hex');\n    \n    // Use timing-safe comparison\n    return crypto.timingSafeEqual(\n      Buffer.from(signature),\n      Buffer.from(expectedSig)\n    );\n  } catch {\n    // Fallback for non-Node environments\n    console.warn('[SendMailOS] Use verifyWebhookSignatureAsync for browser/edge');\n    return false;\n  }\n}\n\nfunction bufferToHex(buffer: ArrayBuffer): string {\n  return Array.from(new Uint8Array(buffer))\n    .map(b => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n\nfunction timingSafeEqual(a: string, b: string): boolean {\n  if (a.length !== b.length) {\n    return false;\n  }\n  \n  let result = 0;\n  for (let i = 0; i < a.length; i++) {\n    result |= a.charCodeAt(i) ^ b.charCodeAt(i);\n  }\n  return result === 0;\n}\n\n/**\n * Construct a webhook event from raw request data\n */\nexport function constructWebhookEvent<T = unknown>(\n  payload: string,\n  headers: { signature: string; timestamp: string },\n  secret: string\n): T {\n  const isValid = verifyWebhookSignature({\n    payload,\n    signature: headers.signature,\n    timestamp: headers.timestamp,\n    secret,\n  });\n\n  if (!isValid) {\n    throw new Error('Invalid webhook signature');\n  }\n\n  return JSON.parse(payload) as T;\n}\n"]}