@masters-union/outbound-sdk 0.1.0

package/dist/index.mjs

@@ -0,0 +1,389 @@
+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/errors.ts
+var OutboundError = class extends Error {
+  constructor(message, statusCode, details, requestId) {
+    super(message);
+    this.statusCode = statusCode;
+    this.details = details;
+    this.requestId = requestId;
+    this.name = "OutboundError";
+  }
+};
+var BadRequestError = class extends OutboundError {
+  constructor(message, details, requestId) {
+    super(message, 400, details, requestId);
+    this.name = "BadRequestError";
+  }
+};
+var AuthenticationError = class extends OutboundError {
+  constructor(message, details, requestId) {
+    super(message, 401, details, requestId);
+    this.name = "AuthenticationError";
+  }
+};
+var ForbiddenError = class extends OutboundError {
+  constructor(message, details, requestId) {
+    super(message, 403, details, requestId);
+    this.name = "ForbiddenError";
+  }
+};
+var NotFoundError = class extends OutboundError {
+  constructor(message, details, requestId) {
+    super(message, 404, details, requestId);
+    this.name = "NotFoundError";
+  }
+};
+var ConflictError = class extends OutboundError {
+  constructor(message, details, requestId) {
+    super(message, 409, details, requestId);
+    this.name = "ConflictError";
+  }
+};
+var RateLimitError = class extends OutboundError {
+  retryAfter;
+  constructor(message, retryAfter, details, requestId) {
+    super(message, 429, details, requestId);
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var ServerError = class extends OutboundError {
+  constructor(message, statusCode = 500, details, requestId) {
+    super(message, statusCode, details, requestId);
+    this.name = "ServerError";
+  }
+};
+var TimeoutError = class extends OutboundError {
+  constructor(message = "Request timed out") {
+    super(message, 0);
+    this.name = "TimeoutError";
+  }
+};
+var NetworkError = class extends OutboundError {
+  constructor(message = "Network request failed") {
+    super(message, 0);
+    this.name = "NetworkError";
+  }
+};
+
+// src/http.ts
+var HttpClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async get(path, params) {
+    return this.request("GET", path, { params });
+  }
+  async post(path, body) {
+    return this.request("POST", path, { body });
+  }
+  async patch(path, body) {
+    return this.request("PATCH", path, { body });
+  }
+  async delete(path) {
+    return this.request("DELETE", path);
+  }
+  async request(method, path, options) {
+    let lastError;
+    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+      try {
+        const url = this.buildUrl(path, options?.params);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "X-Api-Key": this.config.apiKey,
+            "Content-Type": "application/json"
+          },
+          body: options?.body ? JSON.stringify(options.body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (response.ok) {
+          return await response.json();
+        }
+        const error = await this.parseError(response);
+        if (response.status === 429 || response.status >= 500) {
+          lastError = error;
+          if (attempt < this.config.maxRetries) {
+            const retryAfter = error instanceof RateLimitError && error.retryAfter ? error.retryAfter * 1e3 : this.config.retryDelay * Math.pow(2, attempt);
+            await this.sleep(retryAfter);
+            continue;
+          }
+        }
+        throw error;
+      } catch (err) {
+        if (err instanceof OutboundError) {
+          if ((err.statusCode === 429 || err.statusCode >= 500) && attempt < this.config.maxRetries) {
+            lastError = err;
+            const retryAfter = err instanceof RateLimitError && err.retryAfter ? err.retryAfter * 1e3 : this.config.retryDelay * Math.pow(2, attempt);
+            await this.sleep(retryAfter);
+            continue;
+          }
+          throw err;
+        }
+        if (err instanceof DOMException && err.name === "AbortError") {
+          lastError = new TimeoutError(`Request timed out after ${this.config.timeout}ms`);
+          if (attempt < this.config.maxRetries) {
+            await this.sleep(this.config.retryDelay * Math.pow(2, attempt));
+            continue;
+          }
+          throw lastError;
+        }
+        lastError = new NetworkError(err.message);
+        if (attempt < this.config.maxRetries) {
+          await this.sleep(this.config.retryDelay * Math.pow(2, attempt));
+          continue;
+        }
+        throw lastError;
+      }
+    }
+    throw lastError || new NetworkError("Request failed after retries");
+  }
+  buildUrl(path, params) {
+    const base = this.config.baseUrl.replace(/\/+$/, "");
+    const url = new URL(`${base}${path}`);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  async parseError(response) {
+    let body = {};
+    const requestId = response.headers.get("x-request-id") || void 0;
+    try {
+      body = await response.json();
+    } catch {
+    }
+    const message = body.error || body.message || `HTTP ${response.status}`;
+    const details = body.details;
+    switch (response.status) {
+      case 400:
+        return new BadRequestError(message, details, requestId);
+      case 401:
+        return new AuthenticationError(message, details, requestId);
+      case 403:
+        return new ForbiddenError(message, details, requestId);
+      case 404:
+        return new NotFoundError(message, details, requestId);
+      case 409:
+        return new ConflictError(message, details, requestId);
+      case 429: {
+        const retryAfter = response.headers.get("retry-after");
+        return new RateLimitError(
+          message,
+          retryAfter ? parseInt(retryAfter, 10) : void 0,
+          details,
+          requestId
+        );
+      }
+      default:
+        if (response.status >= 500) {
+          return new ServerError(message, response.status, details, requestId);
+        }
+        return new OutboundError(message, response.status, details, requestId);
+    }
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/resources/email.ts
+var EmailResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async send(params) {
+    return this.http.post("/v1/email/send", params);
+  }
+  async bulk(params) {
+    return this.http.post("/v1/email/bulk", params);
+  }
+  async status(jobId) {
+    return this.http.get(`/v1/email/status/${encodeURIComponent(jobId)}`);
+  }
+};
+
+// src/resources/templates.ts
+var TemplatesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async create(params) {
+    return this.http.post("/v1/email-templates", params);
+  }
+  async list(params) {
+    return this.http.get("/v1/email-templates", params);
+  }
+  async *listAll(params) {
+    let page = 1;
+    const limit = params?.limit || 20;
+    while (true) {
+      const result = await this.list({ ...params, page, limit });
+      for (const template of result.templates) {
+        yield template;
+      }
+      if (result.templates.length < limit) break;
+      page++;
+    }
+  }
+  async get(id) {
+    return this.http.get(`/v1/email-templates/${encodeURIComponent(id)}`);
+  }
+  async update(id, params) {
+    return this.http.patch(`/v1/email-templates/${encodeURIComponent(id)}`, params);
+  }
+  async delete(id) {
+    return this.http.delete(`/v1/email-templates/${encodeURIComponent(id)}`);
+  }
+  async duplicate(id, params) {
+    return this.http.post(`/v1/email-templates/${encodeURIComponent(id)}/duplicate`, params);
+  }
+  async preview(id, params) {
+    return this.http.post(`/v1/email-templates/${encodeURIComponent(id)}/preview`, params);
+  }
+  async send(params) {
+    return this.http.post("/v1/email-templates/send", params);
+  }
+  async bulkSend(params) {
+    return this.http.post("/v1/email-templates/bulk", params);
+  }
+  async stats() {
+    return this.http.get("/v1/email-templates/stats");
+  }
+};
+
+// src/resources/suppressions.ts
+var SuppressionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async list(params) {
+    return this.http.get("/v1/tenants/suppressions", params);
+  }
+  async *listAll(params) {
+    let page = 1;
+    const limit = params?.limit || 50;
+    while (true) {
+      const result = await this.list({ ...params, page, limit });
+      for (const suppression of result.suppressions) {
+        yield suppression;
+      }
+      if (result.suppressions.length < limit) break;
+      page++;
+    }
+  }
+  async add(params) {
+    return this.http.post("/v1/tenants/suppressions", params);
+  }
+  async remove(email) {
+    return this.http.delete(`/v1/tenants/suppressions/${encodeURIComponent(email)}`);
+  }
+};
+
+// src/resources/webhooks.ts
+var WebhooksResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async create(params) {
+    return this.http.post("/v1/tenants/webhooks", params);
+  }
+  async list() {
+    return this.http.get("/v1/tenants/webhooks");
+  }
+  async update(id, params) {
+    return this.http.patch(`/v1/tenants/webhooks/${encodeURIComponent(id)}`, params);
+  }
+  async delete(id) {
+    return this.http.delete(`/v1/tenants/webhooks/${encodeURIComponent(id)}`);
+  }
+};
+
+// src/resources/dashboard.ts
+var DashboardResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async get() {
+    return this.http.get("/v1/tenants/dashboard");
+  }
+  async quota() {
+    return this.http.get("/v1/tenants/quota");
+  }
+};
+
+// src/client.ts
+var BASE_URL = "https://outbound-api.mastersunion.org";
+var Outbound = class {
+  email;
+  templates;
+  suppressions;
+  webhooks;
+  dashboard;
+  constructor(config) {
+    const resolved = {
+      apiKey: config?.apiKey || this.getEnv("OUTBOUND_API_KEY") || "",
+      baseUrl: config?.baseUrl || BASE_URL,
+      timeout: config?.timeout ?? 3e4,
+      maxRetries: config?.maxRetries ?? 3,
+      retryDelay: config?.retryDelay ?? 1e3
+    };
+    if (!resolved.apiKey) {
+      throw new AuthenticationError(
+        "API key is required. Pass it to the constructor or set the OUTBOUND_API_KEY environment variable."
+      );
+    }
+    const http = new HttpClient(resolved);
+    this.email = new EmailResource(http);
+    this.templates = new TemplatesResource(http);
+    this.suppressions = new SuppressionsResource(http);
+    this.webhooks = new WebhooksResource(http);
+    this.dashboard = new DashboardResource(http);
+  }
+  /**
+   * Verify a webhook signature using HMAC-SHA256.
+   * Use this in your webhook handler to validate incoming requests.
+   */
+  static verifyWebhookSignature(payload, signature, secret) {
+    const crypto = __require("crypto");
+    const expected = crypto.createHmac("sha256", secret).update(payload).digest("hex");
+    try {
+      return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+    } catch {
+      return false;
+    }
+  }
+  getEnv(key) {
+    if (typeof process !== "undefined" && process.env) {
+      return process.env[key];
+    }
+    return void 0;
+  }
+};
+export {
+  AuthenticationError,
+  BadRequestError,
+  ConflictError,
+  ForbiddenError,
+  NetworkError,
+  NotFoundError,
+  Outbound,
+  OutboundError,
+  RateLimitError,
+  ServerError,
+  TimeoutError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/email.ts","../src/resources/templates.ts","../src/resources/suppressions.ts","../src/resources/webhooks.ts","../src/resources/dashboard.ts","../src/client.ts"],"sourcesContent":["export class OutboundError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly details?: unknown,\n    public readonly requestId?: string,\n  ) {\n    super(message);\n    this.name = 'OutboundError';\n  }\n}\n\nexport class BadRequestError extends OutboundError {\n  constructor(message: string, details?: unknown, requestId?: string) {\n    super(message, 400, details, requestId);\n    this.name = 'BadRequestError';\n  }\n}\n\nexport class AuthenticationError extends OutboundError {\n  constructor(message: string, details?: unknown, requestId?: string) {\n    super(message, 401, details, requestId);\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class ForbiddenError extends OutboundError {\n  constructor(message: string, details?: unknown, requestId?: string) {\n    super(message, 403, details, requestId);\n    this.name = 'ForbiddenError';\n  }\n}\n\nexport class NotFoundError extends OutboundError {\n  constructor(message: string, details?: unknown, requestId?: string) {\n    super(message, 404, details, requestId);\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class ConflictError extends OutboundError {\n  constructor(message: string, details?: unknown, requestId?: string) {\n    super(message, 409, details, requestId);\n    this.name = 'ConflictError';\n  }\n}\n\nexport class RateLimitError extends OutboundError {\n  public readonly retryAfter?: number;\n\n  constructor(message: string, retryAfter?: number, details?: unknown, requestId?: string) {\n    super(message, 429, details, requestId);\n    this.name = 'RateLimitError';\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class ServerError extends OutboundError {\n  constructor(message: string, statusCode: number = 500, details?: unknown, requestId?: string) {\n    super(message, statusCode, details, requestId);\n    this.name = 'ServerError';\n  }\n}\n\nexport class TimeoutError extends OutboundError {\n  constructor(message: string = 'Request timed out') {\n    super(message, 0);\n    this.name = 'TimeoutError';\n  }\n}\n\nexport class NetworkError extends OutboundError {\n  constructor(message: string = 'Network request failed') {\n    super(message, 0);\n    this.name = 'NetworkError';\n  }\n}\n","import type { ResolvedConfig } from './types';\nimport {\n  OutboundError,\n  BadRequestError,\n  AuthenticationError,\n  ForbiddenError,\n  NotFoundError,\n  ConflictError,\n  RateLimitError,\n  ServerError,\n  TimeoutError,\n  NetworkError,\n} from './errors';\n\nexport interface RequestOptions {\n  body?: unknown;\n  params?: Record<string, unknown>;\n}\n\nexport class HttpClient {\n  constructor(private config: ResolvedConfig) {}\n\n  async get<T>(path: string, params?: Record<string, unknown>): Promise<T> {\n    return this.request<T>('GET', path, { params });\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    return this.request<T>('POST', path, { body });\n  }\n\n  async patch<T>(path: string, body?: unknown): Promise<T> {\n    return this.request<T>('PATCH', path, { body });\n  }\n\n  async delete<T>(path: string): Promise<T> {\n    return this.request<T>('DELETE', path);\n  }\n\n  private async request<T>(method: string, path: string, options?: RequestOptions): Promise<T> {\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {\n      try {\n        const url = this.buildUrl(path, options?.params);\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n        const response = await fetch(url, {\n          method,\n          headers: {\n            'X-Api-Key': this.config.apiKey,\n            'Content-Type': 'application/json',\n          },\n          body: options?.body ? JSON.stringify(options.body) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          return (await response.json()) as T;\n        }\n\n        const error = await this.parseError(response);\n\n        // Only retry on 429 and 5xx\n        if (response.status === 429 || response.status >= 500) {\n          lastError = error;\n\n          if (attempt < this.config.maxRetries) {\n            const retryAfter = error instanceof RateLimitError && error.retryAfter\n              ? error.retryAfter * 1000\n              : this.config.retryDelay * Math.pow(2, attempt);\n\n            await this.sleep(retryAfter);\n            continue;\n          }\n        }\n\n        throw error;\n      } catch (err) {\n        if (err instanceof OutboundError) {\n          // Already a typed error from parseError — check if retryable\n          if ((err.statusCode === 429 || err.statusCode >= 500) && attempt < this.config.maxRetries) {\n            lastError = err;\n            const retryAfter = err instanceof RateLimitError && err.retryAfter\n              ? err.retryAfter * 1000\n              : this.config.retryDelay * Math.pow(2, attempt);\n            await this.sleep(retryAfter);\n            continue;\n          }\n          throw err;\n        }\n\n        if (err instanceof DOMException && err.name === 'AbortError') {\n          lastError = new TimeoutError(`Request timed out after ${this.config.timeout}ms`);\n          if (attempt < this.config.maxRetries) {\n            await this.sleep(this.config.retryDelay * Math.pow(2, attempt));\n            continue;\n          }\n          throw lastError;\n        }\n\n        lastError = new NetworkError((err as Error).message);\n        if (attempt < this.config.maxRetries) {\n          await this.sleep(this.config.retryDelay * Math.pow(2, attempt));\n          continue;\n        }\n        throw lastError;\n      }\n    }\n\n    throw lastError || new NetworkError('Request failed after retries');\n  }\n\n  private buildUrl(path: string, params?: Record<string, unknown>): string {\n    const base = this.config.baseUrl.replace(/\\/+$/, '');\n    const url = new URL(`${base}${path}`);\n\n    if (params) {\n      for (const [key, value] of Object.entries(params)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    return url.toString();\n  }\n\n  private async parseError(response: Response): Promise<OutboundError> {\n    let body: { error?: string; message?: string; details?: unknown } = {};\n    const requestId = response.headers.get('x-request-id') || undefined;\n\n    try {\n      body = (await response.json()) as typeof body;\n    } catch {\n      // Response may not be JSON\n    }\n\n    const message = body.error || body.message || `HTTP ${response.status}`;\n    const details = body.details;\n\n    switch (response.status) {\n      case 400:\n        return new BadRequestError(message, details, requestId);\n      case 401:\n        return new AuthenticationError(message, details, requestId);\n      case 403:\n        return new ForbiddenError(message, details, requestId);\n      case 404:\n        return new NotFoundError(message, details, requestId);\n      case 409:\n        return new ConflictError(message, details, requestId);\n      case 429: {\n        const retryAfter = response.headers.get('retry-after');\n        return new RateLimitError(\n          message,\n          retryAfter ? parseInt(retryAfter, 10) : undefined,\n          details,\n          requestId,\n        );\n      }\n      default:\n        if (response.status >= 500) {\n          return new ServerError(message, response.status, details, requestId);\n        }\n        return new OutboundError(message, response.status, details, requestId);\n    }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n","import type { HttpClient } from '../http';\nimport type {\n  SendEmailParams,\n  SendEmailResponse,\n  BulkEmailParams,\n  BulkEmailResponse,\n  JobStatusResponse,\n} from '../types';\n\nexport class EmailResource {\n  constructor(private http: HttpClient) {}\n\n  async send(params: SendEmailParams): Promise<SendEmailResponse> {\n    return this.http.post<SendEmailResponse>('/v1/email/send', params);\n  }\n\n  async bulk(params: BulkEmailParams): Promise<BulkEmailResponse> {\n    return this.http.post<BulkEmailResponse>('/v1/email/bulk', params);\n  }\n\n  async status(jobId: string): Promise<JobStatusResponse> {\n    return this.http.get<JobStatusResponse>(`/v1/email/status/${encodeURIComponent(jobId)}`);\n  }\n}\n","import type { HttpClient } from '../http';\nimport type {\n  CreateTemplateParams,\n  UpdateTemplateParams,\n  ListTemplatesParams,\n  ListTemplatesResponse,\n  Template,\n  TemplateResponse,\n  TemplateSendParams,\n  SendEmailResponse,\n  TemplateBulkSendParams,\n  TemplateBulkSendResponse,\n  TemplatePreviewParams,\n  TemplatePreviewResponse,\n  TemplateStatsResponse,\n} from '../types';\n\nexport class TemplatesResource {\n  constructor(private http: HttpClient) {}\n\n  async create(params: CreateTemplateParams): Promise<TemplateResponse> {\n    return this.http.post<TemplateResponse>('/v1/email-templates', params);\n  }\n\n  async list(params?: ListTemplatesParams): Promise<ListTemplatesResponse> {\n    return this.http.get<ListTemplatesResponse>('/v1/email-templates', params as Record<string, unknown>);\n  }\n\n  async *listAll(params?: Omit<ListTemplatesParams, 'page'>): AsyncGenerator<Template> {\n    let page = 1;\n    const limit = params?.limit || 20;\n\n    while (true) {\n      const result = await this.list({ ...params, page, limit });\n      for (const template of result.templates) {\n        yield template;\n      }\n      if (result.templates.length < limit) break;\n      page++;\n    }\n  }\n\n  async get(id: string): Promise<TemplateResponse> {\n    return this.http.get<TemplateResponse>(`/v1/email-templates/${encodeURIComponent(id)}`);\n  }\n\n  async update(id: string, params: UpdateTemplateParams): Promise<TemplateResponse> {\n    return this.http.patch<TemplateResponse>(`/v1/email-templates/${encodeURIComponent(id)}`, params);\n  }\n\n  async delete(id: string): Promise<{ message: string; id: string }> {\n    return this.http.delete<{ message: string; id: string }>(`/v1/email-templates/${encodeURIComponent(id)}`);\n  }\n\n  async duplicate(id: string, params?: { name?: string }): Promise<TemplateResponse> {\n    return this.http.post<TemplateResponse>(`/v1/email-templates/${encodeURIComponent(id)}/duplicate`, params);\n  }\n\n  async preview(id: string, params?: TemplatePreviewParams): Promise<TemplatePreviewResponse> {\n    return this.http.post<TemplatePreviewResponse>(`/v1/email-templates/${encodeURIComponent(id)}/preview`, params);\n  }\n\n  async send(params: TemplateSendParams): Promise<SendEmailResponse> {\n    return this.http.post<SendEmailResponse>('/v1/email-templates/send', params);\n  }\n\n  async bulkSend(params: TemplateBulkSendParams): Promise<TemplateBulkSendResponse> {\n    return this.http.post<TemplateBulkSendResponse>('/v1/email-templates/bulk', params);\n  }\n\n  async stats(): Promise<TemplateStatsResponse> {\n    return this.http.get<TemplateStatsResponse>('/v1/email-templates/stats');\n  }\n}\n","import type { HttpClient } from '../http';\nimport type {\n  ListSuppressionsParams,\n  ListSuppressionsResponse,\n  AddSuppressionParams,\n  SuppressionResponse,\n  Suppression,\n} from '../types';\n\nexport class SuppressionsResource {\n  constructor(private http: HttpClient) {}\n\n  async list(params?: ListSuppressionsParams): Promise<ListSuppressionsResponse> {\n    return this.http.get<ListSuppressionsResponse>('/v1/tenants/suppressions', params as Record<string, unknown>);\n  }\n\n  async *listAll(params?: Omit<ListSuppressionsParams, 'page'>): AsyncGenerator<Suppression> {\n    let page = 1;\n    const limit = params?.limit || 50;\n\n    while (true) {\n      const result = await this.list({ ...params, page, limit });\n      for (const suppression of result.suppressions) {\n        yield suppression;\n      }\n      if (result.suppressions.length < limit) break;\n      page++;\n    }\n  }\n\n  async add(params: AddSuppressionParams): Promise<SuppressionResponse> {\n    return this.http.post<SuppressionResponse>('/v1/tenants/suppressions', params);\n  }\n\n  async remove(email: string): Promise<{ message: string }> {\n    return this.http.delete<{ message: string }>(`/v1/tenants/suppressions/${encodeURIComponent(email)}`);\n  }\n}\n","import type { HttpClient } from '../http';\nimport type {\n  CreateWebhookParams,\n  CreateWebhookResponse,\n  UpdateWebhookParams,\n  UpdateWebhookResponse,\n  ListWebhooksResponse,\n} from '../types';\n\nexport class WebhooksResource {\n  constructor(private http: HttpClient) {}\n\n  async create(params: CreateWebhookParams): Promise<CreateWebhookResponse> {\n    return this.http.post<CreateWebhookResponse>('/v1/tenants/webhooks', params);\n  }\n\n  async list(): Promise<ListWebhooksResponse> {\n    return this.http.get<ListWebhooksResponse>('/v1/tenants/webhooks');\n  }\n\n  async update(id: string, params: UpdateWebhookParams): Promise<UpdateWebhookResponse> {\n    return this.http.patch<UpdateWebhookResponse>(`/v1/tenants/webhooks/${encodeURIComponent(id)}`, params);\n  }\n\n  async delete(id: string): Promise<{ message: string; id: string }> {\n    return this.http.delete<{ message: string; id: string }>(`/v1/tenants/webhooks/${encodeURIComponent(id)}`);\n  }\n}\n","import type { HttpClient } from '../http';\nimport type { DashboardResponse, QuotaResponse } from '../types';\n\nexport class DashboardResource {\n  constructor(private http: HttpClient) {}\n\n  async get(): Promise<DashboardResponse> {\n    return this.http.get<DashboardResponse>('/v1/tenants/dashboard');\n  }\n\n  async quota(): Promise<QuotaResponse> {\n    return this.http.get<QuotaResponse>('/v1/tenants/quota');\n  }\n}\n","import { HttpClient } from './http';\nimport { AuthenticationError } from './errors';\nimport { EmailResource } from './resources/email';\nimport { TemplatesResource } from './resources/templates';\nimport { SuppressionsResource } from './resources/suppressions';\nimport { WebhooksResource } from './resources/webhooks';\nimport { DashboardResource } from './resources/dashboard';\nimport type { OutboundConfig, ResolvedConfig } from './types';\n\nconst BASE_URL = 'https://outbound-api.mastersunion.org';\n\nexport class Outbound {\n  readonly email: EmailResource;\n  readonly templates: TemplatesResource;\n  readonly suppressions: SuppressionsResource;\n  readonly webhooks: WebhooksResource;\n  readonly dashboard: DashboardResource;\n\n  constructor(config?: OutboundConfig) {\n    const resolved: ResolvedConfig = {\n      apiKey: config?.apiKey || this.getEnv('OUTBOUND_API_KEY') || '',\n      baseUrl: config?.baseUrl || BASE_URL,\n      timeout: config?.timeout ?? 30_000,\n      maxRetries: config?.maxRetries ?? 3,\n      retryDelay: config?.retryDelay ?? 1000,\n    };\n\n    if (!resolved.apiKey) {\n      throw new AuthenticationError(\n        'API key is required. Pass it to the constructor or set the OUTBOUND_API_KEY environment variable.',\n      );\n    }\n\n    const http = new HttpClient(resolved);\n\n    this.email = new EmailResource(http);\n    this.templates = new TemplatesResource(http);\n    this.suppressions = new SuppressionsResource(http);\n    this.webhooks = new WebhooksResource(http);\n    this.dashboard = new DashboardResource(http);\n  }\n\n  /**\n   * Verify a webhook signature using HMAC-SHA256.\n   * Use this in your webhook handler to validate incoming requests.\n   */\n  static verifyWebhookSignature(\n    payload: string | Buffer,\n    signature: string,\n    secret: string,\n  ): boolean {\n    // Dynamic import to keep browser-compatible at the type level\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const crypto = require('crypto') as typeof import('crypto');\n    const expected = crypto.createHmac('sha256', secret).update(payload).digest('hex');\n    try {\n      return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));\n    } catch {\n      return false;\n    }\n  }\n\n  private getEnv(key: string): string | undefined {\n    if (typeof process !== 'undefined' && process.env) {\n      return process.env[key];\n    }\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;AAAO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACvC,YACE,SACgB,YACA,SACA,WAChB;AACA,UAAM,OAAO;AAJG;AACA;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,kBAAN,cAA8B,cAAc;AAAA,EACjD,YAAY,SAAiB,SAAmB,WAAoB;AAClE,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,sBAAN,cAAkC,cAAc;AAAA,EACrD,YAAY,SAAiB,SAAmB,WAAoB;AAClE,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,iBAAN,cAA6B,cAAc;AAAA,EAChD,YAAY,SAAiB,SAAmB,WAAoB;AAClE,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,gBAAN,cAA4B,cAAc;AAAA,EAC/C,YAAY,SAAiB,SAAmB,WAAoB;AAClE,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,gBAAN,cAA4B,cAAc;AAAA,EAC/C,YAAY,SAAiB,SAAmB,WAAoB;AAClE,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,iBAAN,cAA6B,cAAc;AAAA,EAChC;AAAA,EAEhB,YAAY,SAAiB,YAAqB,SAAmB,WAAoB;AACvF,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;AAEO,IAAM,cAAN,cAA0B,cAAc;AAAA,EAC7C,YAAY,SAAiB,aAAqB,KAAK,SAAmB,WAAoB;AAC5F,UAAM,SAAS,YAAY,SAAS,SAAS;AAC7C,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,eAAN,cAA2B,cAAc;AAAA,EAC9C,YAAY,UAAkB,qBAAqB;AACjD,UAAM,SAAS,CAAC;AAChB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,eAAN,cAA2B,cAAc;AAAA,EAC9C,YAAY,UAAkB,0BAA0B;AACtD,UAAM,SAAS,CAAC;AAChB,SAAK,OAAO;AAAA,EACd;AACF;;;ACzDO,IAAM,aAAN,MAAiB;AAAA,EACtB,YAAoB,QAAwB;AAAxB;AAAA,EAAyB;AAAA,EAE7C,MAAM,IAAO,MAAc,QAA8C;AACvE,WAAO,KAAK,QAAW,OAAO,MAAM,EAAE,OAAO,CAAC;AAAA,EAChD;AAAA,EAEA,MAAM,KAAQ,MAAc,MAA4B;AACtD,WAAO,KAAK,QAAW,QAAQ,MAAM,EAAE,KAAK,CAAC;AAAA,EAC/C;AAAA,EAEA,MAAM,MAAS,MAAc,MAA4B;AACvD,WAAO,KAAK,QAAW,SAAS,MAAM,EAAE,KAAK,CAAC;AAAA,EAChD;AAAA,EAEA,MAAM,OAAU,MAA0B;AACxC,WAAO,KAAK,QAAW,UAAU,IAAI;AAAA,EACvC;AAAA,EAEA,MAAc,QAAW,QAAgB,MAAc,SAAsC;AAC3F,QAAI;AAEJ,aAAS,UAAU,GAAG,WAAW,KAAK,OAAO,YAAY,WAAW;AAClE,UAAI;AACF,cAAM,MAAM,KAAK,SAAS,MAAM,SAAS,MAAM;AAC/C,cAAM,aAAa,IAAI,gBAAgB;AACvC,cAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,OAAO,OAAO;AAE1E,cAAM,WAAW,MAAM,MAAM,KAAK;AAAA,UAChC;AAAA,UACA,SAAS;AAAA,YACP,aAAa,KAAK,OAAO;AAAA,YACzB,gBAAgB;AAAA,UAClB;AAAA,UACA,MAAM,SAAS,OAAO,KAAK,UAAU,QAAQ,IAAI,IAAI;AAAA,UACrD,QAAQ,WAAW;AAAA,QACrB,CAAC;AAED,qBAAa,SAAS;AAEtB,YAAI,SAAS,IAAI;AACf,iBAAQ,MAAM,SAAS,KAAK;AAAA,QAC9B;AAEA,cAAM,QAAQ,MAAM,KAAK,WAAW,QAAQ;AAG5C,YAAI,SAAS,WAAW,OAAO,SAAS,UAAU,KAAK;AACrD,sBAAY;AAEZ,cAAI,UAAU,KAAK,OAAO,YAAY;AACpC,kBAAM,aAAa,iBAAiB,kBAAkB,MAAM,aACxD,MAAM,aAAa,MACnB,KAAK,OAAO,aAAa,KAAK,IAAI,GAAG,OAAO;AAEhD,kBAAM,KAAK,MAAM,UAAU;AAC3B;AAAA,UACF;AAAA,QACF;AAEA,cAAM;AAAA,MACR,SAAS,KAAK;AACZ,YAAI,eAAe,eAAe;AAEhC,eAAK,IAAI,eAAe,OAAO,IAAI,cAAc,QAAQ,UAAU,KAAK,OAAO,YAAY;AACzF,wBAAY;AACZ,kBAAM,aAAa,eAAe,kBAAkB,IAAI,aACpD,IAAI,aAAa,MACjB,KAAK,OAAO,aAAa,KAAK,IAAI,GAAG,OAAO;AAChD,kBAAM,KAAK,MAAM,UAAU;AAC3B;AAAA,UACF;AACA,gBAAM;AAAA,QACR;AAEA,YAAI,eAAe,gBAAgB,IAAI,SAAS,cAAc;AAC5D,sBAAY,IAAI,aAAa,2BAA2B,KAAK,OAAO,OAAO,IAAI;AAC/E,cAAI,UAAU,KAAK,OAAO,YAAY;AACpC,kBAAM,KAAK,MAAM,KAAK,OAAO,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC;AAC9D;AAAA,UACF;AACA,gBAAM;AAAA,QACR;AAEA,oBAAY,IAAI,aAAc,IAAc,OAAO;AACnD,YAAI,UAAU,KAAK,OAAO,YAAY;AACpC,gBAAM,KAAK,MAAM,KAAK,OAAO,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC;AAC9D;AAAA,QACF;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,UAAM,aAAa,IAAI,aAAa,8BAA8B;AAAA,EACpE;AAAA,EAEQ,SAAS,MAAc,QAA0C;AACvE,UAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AACnD,UAAM,MAAM,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE;AAEpC,QAAI,QAAQ;AACV,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,YAAI,UAAU,UAAa,UAAU,MAAM;AACzC,cAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,QACzC;AAAA,MACF;AAAA,IACF;AAEA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEA,MAAc,WAAW,UAA4C;AACnE,QAAI,OAAgE,CAAC;AACrE,UAAM,YAAY,SAAS,QAAQ,IAAI,cAAc,KAAK;AAE1D,QAAI;AACF,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,QAAQ;AAAA,IAER;AAEA,UAAM,UAAU,KAAK,SAAS,KAAK,WAAW,QAAQ,SAAS,MAAM;AACrE,UAAM,UAAU,KAAK;AAErB,YAAQ,SAAS,QAAQ;AAAA,MACvB,KAAK;AACH,eAAO,IAAI,gBAAgB,SAAS,SAAS,SAAS;AAAA,MACxD,KAAK;AACH,eAAO,IAAI,oBAAoB,SAAS,SAAS,SAAS;AAAA,MAC5D,KAAK;AACH,eAAO,IAAI,eAAe,SAAS,SAAS,SAAS;AAAA,MACvD,KAAK;AACH,eAAO,IAAI,cAAc,SAAS,SAAS,SAAS;AAAA,MACtD,KAAK;AACH,eAAO,IAAI,cAAc,SAAS,SAAS,SAAS;AAAA,MACtD,KAAK,KAAK;AACR,cAAM,aAAa,SAAS,QAAQ,IAAI,aAAa;AACrD,eAAO,IAAI;AAAA,UACT;AAAA,UACA,aAAa,SAAS,YAAY,EAAE,IAAI;AAAA,UACxC;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,MACA;AACE,YAAI,SAAS,UAAU,KAAK;AAC1B,iBAAO,IAAI,YAAY,SAAS,SAAS,QAAQ,SAAS,SAAS;AAAA,QACrE;AACA,eAAO,IAAI,cAAc,SAAS,SAAS,QAAQ,SAAS,SAAS;AAAA,IACzE;AAAA,EACF;AAAA,EAEQ,MAAM,IAA2B;AACvC,WAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,EACzD;AACF;;;ACrKO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAEvC,MAAM,KAAK,QAAqD;AAC9D,WAAO,KAAK,KAAK,KAAwB,kBAAkB,MAAM;AAAA,EACnE;AAAA,EAEA,MAAM,KAAK,QAAqD;AAC9D,WAAO,KAAK,KAAK,KAAwB,kBAAkB,MAAM;AAAA,EACnE;AAAA,EAEA,MAAM,OAAO,OAA2C;AACtD,WAAO,KAAK,KAAK,IAAuB,oBAAoB,mBAAmB,KAAK,CAAC,EAAE;AAAA,EACzF;AACF;;;ACNO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAEvC,MAAM,OAAO,QAAyD;AACpE,WAAO,KAAK,KAAK,KAAuB,uBAAuB,MAAM;AAAA,EACvE;AAAA,EAEA,MAAM,KAAK,QAA8D;AACvE,WAAO,KAAK,KAAK,IAA2B,uBAAuB,MAAiC;AAAA,EACtG;AAAA,EAEA,OAAO,QAAQ,QAAsE;AACnF,QAAI,OAAO;AACX,UAAM,QAAQ,QAAQ,SAAS;AAE/B,WAAO,MAAM;AACX,YAAM,SAAS,MAAM,KAAK,KAAK,EAAE,GAAG,QAAQ,MAAM,MAAM,CAAC;AACzD,iBAAW,YAAY,OAAO,WAAW;AACvC,cAAM;AAAA,MACR;AACA,UAAI,OAAO,UAAU,SAAS,MAAO;AACrC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,IAAuC;AAC/C,WAAO,KAAK,KAAK,IAAsB,uBAAuB,mBAAmB,EAAE,CAAC,EAAE;AAAA,EACxF;AAAA,EAEA,MAAM,OAAO,IAAY,QAAyD;AAChF,WAAO,KAAK,KAAK,MAAwB,uBAAuB,mBAAmB,EAAE,CAAC,IAAI,MAAM;AAAA,EAClG;AAAA,EAEA,MAAM,OAAO,IAAsD;AACjE,WAAO,KAAK,KAAK,OAAwC,uBAAuB,mBAAmB,EAAE,CAAC,EAAE;AAAA,EAC1G;AAAA,EAEA,MAAM,UAAU,IAAY,QAAuD;AACjF,WAAO,KAAK,KAAK,KAAuB,uBAAuB,mBAAmB,EAAE,CAAC,cAAc,MAAM;AAAA,EAC3G;AAAA,EAEA,MAAM,QAAQ,IAAY,QAAkE;AAC1F,WAAO,KAAK,KAAK,KAA8B,uBAAuB,mBAAmB,EAAE,CAAC,YAAY,MAAM;AAAA,EAChH;AAAA,EAEA,MAAM,KAAK,QAAwD;AACjE,WAAO,KAAK,KAAK,KAAwB,4BAA4B,MAAM;AAAA,EAC7E;AAAA,EAEA,MAAM,SAAS,QAAmE;AAChF,WAAO,KAAK,KAAK,KAA+B,4BAA4B,MAAM;AAAA,EACpF;AAAA,EAEA,MAAM,QAAwC;AAC5C,WAAO,KAAK,KAAK,IAA2B,2BAA2B;AAAA,EACzE;AACF;;;AChEO,IAAM,uBAAN,MAA2B;AAAA,EAChC,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAEvC,MAAM,KAAK,QAAoE;AAC7E,WAAO,KAAK,KAAK,IAA8B,4BAA4B,MAAiC;AAAA,EAC9G;AAAA,EAEA,OAAO,QAAQ,QAA4E;AACzF,QAAI,OAAO;AACX,UAAM,QAAQ,QAAQ,SAAS;AAE/B,WAAO,MAAM;AACX,YAAM,SAAS,MAAM,KAAK,KAAK,EAAE,GAAG,QAAQ,MAAM,MAAM,CAAC;AACzD,iBAAW,eAAe,OAAO,cAAc;AAC7C,cAAM;AAAA,MACR;AACA,UAAI,OAAO,aAAa,SAAS,MAAO;AACxC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,QAA4D;AACpE,WAAO,KAAK,KAAK,KAA0B,4BAA4B,MAAM;AAAA,EAC/E;AAAA,EAEA,MAAM,OAAO,OAA6C;AACxD,WAAO,KAAK,KAAK,OAA4B,4BAA4B,mBAAmB,KAAK,CAAC,EAAE;AAAA,EACtG;AACF;;;AC5BO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAEvC,MAAM,OAAO,QAA6D;AACxE,WAAO,KAAK,KAAK,KAA4B,wBAAwB,MAAM;AAAA,EAC7E;AAAA,EAEA,MAAM,OAAsC;AAC1C,WAAO,KAAK,KAAK,IAA0B,sBAAsB;AAAA,EACnE;AAAA,EAEA,MAAM,OAAO,IAAY,QAA6D;AACpF,WAAO,KAAK,KAAK,MAA6B,wBAAwB,mBAAmB,EAAE,CAAC,IAAI,MAAM;AAAA,EACxG;AAAA,EAEA,MAAM,OAAO,IAAsD;AACjE,WAAO,KAAK,KAAK,OAAwC,wBAAwB,mBAAmB,EAAE,CAAC,EAAE;AAAA,EAC3G;AACF;;;ACxBO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAEvC,MAAM,MAAkC;AACtC,WAAO,KAAK,KAAK,IAAuB,uBAAuB;AAAA,EACjE;AAAA,EAEA,MAAM,QAAgC;AACpC,WAAO,KAAK,KAAK,IAAmB,mBAAmB;AAAA,EACzD;AACF;;;ACJA,IAAM,WAAW;AAEV,IAAM,WAAN,MAAe;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAyB;AACnC,UAAM,WAA2B;AAAA,MAC/B,QAAQ,QAAQ,UAAU,KAAK,OAAO,kBAAkB,KAAK;AAAA,MAC7D,SAAS,QAAQ,WAAW;AAAA,MAC5B,SAAS,QAAQ,WAAW;AAAA,MAC5B,YAAY,QAAQ,cAAc;AAAA,MAClC,YAAY,QAAQ,cAAc;AAAA,IACpC;AAEA,QAAI,CAAC,SAAS,QAAQ;AACpB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM,OAAO,IAAI,WAAW,QAAQ;AAEpC,SAAK,QAAQ,IAAI,cAAc,IAAI;AACnC,SAAK,YAAY,IAAI,kBAAkB,IAAI;AAC3C,SAAK,eAAe,IAAI,qBAAqB,IAAI;AACjD,SAAK,WAAW,IAAI,iBAAiB,IAAI;AACzC,SAAK,YAAY,IAAI,kBAAkB,IAAI;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,uBACL,SACA,WACA,QACS;AAGT,UAAM,SAAS,UAAQ,QAAQ;AAC/B,UAAM,WAAW,OAAO,WAAW,UAAU,MAAM,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK;AACjF,QAAI;AACF,aAAO,OAAO,gBAAgB,OAAO,KAAK,SAAS,GAAG,OAAO,KAAK,QAAQ,CAAC;AAAA,IAC7E,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEQ,OAAO,KAAiC;AAC9C,QAAI,OAAO,YAAY,eAAe,QAAQ,KAAK;AACjD,aAAO,QAAQ,IAAI,GAAG;AAAA,IACxB;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@masters-union/outbound-sdk",
+  "version": "0.1.0",
+  "description": "Official Node.js SDK for the Outbound email platform",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "email",
+    "bulk-email",
+    "ses",
+    "outbound",
+    "email-api",
+    "transactional-email"
+  ],
+  "author": "Adarsh Chakraborty",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^1.0.0"
+  }
+}