@topmail/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,614 @@
+"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, {
+  AuthenticationError: () => AuthenticationError,
+  Automations: () => Automations,
+  Campaigns: () => Campaigns,
+  Contacts: () => Contacts,
+  Conversions: () => Conversions,
+  Domains: () => Domains,
+  Email: () => Email,
+  ForbiddenError: () => ForbiddenError,
+  Health: () => Health,
+  HttpClient: () => HttpClient,
+  Lists: () => Lists,
+  NotFoundError: () => NotFoundError,
+  RateLimitError: () => RateLimitError,
+  Segments: () => Segments,
+  ServerError: () => ServerError,
+  Suppressions: () => Suppressions,
+  Tags: () => Tags,
+  Templates: () => Templates,
+  TopMail: () => TopMail,
+  TopMailError: () => TopMailError,
+  Tracking: () => Tracking,
+  ValidationError: () => ValidationError,
+  Webhooks: () => Webhooks
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var TopMailError = class extends Error {
+  constructor(message, code, statusCode) {
+    super(message);
+    this.name = "TopMailError";
+    this.code = code;
+    this.statusCode = statusCode;
+  }
+};
+var ValidationError = class extends TopMailError {
+  constructor(message, code = "validation_error") {
+    super(message, code, 400);
+    this.name = "ValidationError";
+  }
+};
+var AuthenticationError = class extends TopMailError {
+  constructor(message, code = "authentication_error") {
+    super(message, code, 401);
+    this.name = "AuthenticationError";
+  }
+};
+var ForbiddenError = class extends TopMailError {
+  constructor(message, code = "forbidden") {
+    super(message, code, 403);
+    this.name = "ForbiddenError";
+  }
+};
+var NotFoundError = class extends TopMailError {
+  constructor(message, code = "not_found") {
+    super(message, code, 404);
+    this.name = "NotFoundError";
+  }
+};
+var RateLimitError = class extends TopMailError {
+  constructor(message, retryAfter = null, code = "rate_limit_exceeded") {
+    super(message, code, 429);
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var ServerError = class extends TopMailError {
+  constructor(message, statusCode = 500, code = "server_error") {
+    super(message, code, statusCode);
+    this.name = "ServerError";
+  }
+};
+
+// src/client.ts
+var DEFAULT_MAX_RETRIES = 3;
+var INITIAL_RETRY_DELAY_MS = 1e3;
+var HttpClient = class {
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.apiKey = options.apiKey;
+    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+  }
+  async get(path, params) {
+    const url = this.buildUrl(path, params);
+    return this.request(url, { method: "GET" });
+  }
+  async post(path, body) {
+    const url = this.buildUrl(path);
+    return this.request(url, {
+      method: "POST",
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+  }
+  async put(path, body) {
+    const url = this.buildUrl(path);
+    return this.request(url, {
+      method: "PUT",
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+  }
+  async patch(path, body) {
+    const url = this.buildUrl(path);
+    return this.request(url, {
+      method: "PATCH",
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+  }
+  async delete(path, body) {
+    const url = this.buildUrl(path);
+    return this.request(url, {
+      method: "DELETE",
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+  }
+  buildUrl(path, params) {
+    const url = new URL(`${this.baseUrl}${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 request(url, init) {
+    const headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (attempt > 0) {
+        const delay = this.getRetryDelay(attempt, lastError);
+        await this.sleep(delay);
+      }
+      let response;
+      try {
+        response = await fetch(url, { ...init, headers });
+      } catch (err) {
+        lastError = err instanceof Error ? err : new Error(String(err));
+        continue;
+      }
+      if (response.ok) {
+        if (response.status === 204) {
+          return void 0;
+        }
+        return await response.json();
+      }
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+      }
+      const errorMessage = errorBody?.error?.message ?? response.statusText;
+      const errorCode = errorBody?.error?.code ?? "unknown_error";
+      if (response.status === 429 || response.status >= 500) {
+        if (response.status === 429) {
+          const retryAfter = this.parseRetryAfter(response);
+          lastError = new RateLimitError(errorMessage, retryAfter, errorCode);
+        } else {
+          lastError = new ServerError(errorMessage, response.status, errorCode);
+        }
+        if (attempt < this.maxRetries) {
+          continue;
+        }
+        throw lastError;
+      }
+      throw this.createError(response.status, errorMessage, errorCode);
+    }
+    throw lastError ?? new TopMailError("Request failed", "unknown_error", 0);
+  }
+  createError(status, message, code) {
+    switch (status) {
+      case 400:
+        return new ValidationError(message, code);
+      case 401:
+        return new AuthenticationError(message, code);
+      case 403:
+        return new ForbiddenError(message, code);
+      case 404:
+        return new NotFoundError(message, code);
+      case 429:
+        return new RateLimitError(message, null, code);
+      default:
+        if (status >= 500) {
+          return new ServerError(message, status, code);
+        }
+        return new TopMailError(message, code, status);
+    }
+  }
+  getRetryDelay(attempt, lastError) {
+    if (lastError instanceof RateLimitError && lastError.retryAfter !== null) {
+      return lastError.retryAfter * 1e3;
+    }
+    return INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+  }
+  parseRetryAfter(response) {
+    const header = response.headers.get("retry-after");
+    if (!header) return null;
+    const seconds = Number(header);
+    return isNaN(seconds) ? null : seconds;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/resources/contacts.ts
+var Contacts = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.get("/v1/contacts", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/contacts/${id}`);
+  }
+  async create(data) {
+    return this.client.post("/v1/contacts", data);
+  }
+  async update(id, data) {
+    return this.client.patch(`/v1/contacts/${id}`, data);
+  }
+  async delete(id) {
+    await this.client.delete(`/v1/contacts/${id}`);
+  }
+};
+
+// src/resources/lists.ts
+var ListMembers = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(listId, params) {
+    return this.client.get(
+      `/v1/lists/${listId}/members`,
+      params
+    );
+  }
+  async add(listId, contactIds) {
+    return this.client.post(
+      `/v1/lists/${listId}/members`,
+      { contact_ids: contactIds }
+    );
+  }
+  async remove(listId, contactIds) {
+    await this.client.delete(`/v1/lists/${listId}/members`, { contact_ids: contactIds });
+  }
+};
+var Lists = class {
+  constructor(client) {
+    this.client = client;
+    this.members = new ListMembers(client);
+  }
+  async list(params) {
+    return this.client.get("/v1/lists", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/lists/${id}`);
+  }
+  async create(data) {
+    return this.client.post("/v1/lists", data);
+  }
+  async update(id, data) {
+    return this.client.patch(`/v1/lists/${id}`, data);
+  }
+  async delete(id) {
+    await this.client.delete(`/v1/lists/${id}`);
+  }
+};
+
+// src/resources/campaigns.ts
+var Campaigns = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.get("/v1/campaigns", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/campaigns/${id}`);
+  }
+};
+
+// src/resources/templates.ts
+var Templates = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.get("/v1/templates", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/templates/${id}`);
+  }
+  async create(data) {
+    return this.client.post("/v1/templates", data);
+  }
+};
+
+// src/resources/email.ts
+var Email = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async send(data) {
+    return this.client.post("/v1/email/send", data);
+  }
+  async batch(data) {
+    return this.client.post("/v1/email/batch", data);
+  }
+  async batchStatus(batchId) {
+    return this.client.get(`/v1/email/batch/${batchId}`);
+  }
+  async messageStatus(messageId) {
+    return this.client.get(`/v1/email/${messageId}/status`);
+  }
+};
+
+// src/resources/suppressions.ts
+var Suppressions = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.get("/v1/suppressions", params);
+  }
+  async add(data) {
+    return this.client.post("/v1/suppressions", data);
+  }
+  async remove(email) {
+    await this.client.delete(`/v1/suppressions/${encodeURIComponent(email)}`);
+  }
+};
+
+// src/resources/webhooks.ts
+var Webhooks = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async subscribe(data) {
+    return this.client.post("/v1/webhooks/triggers", data);
+  }
+  async unsubscribe(id) {
+    await this.client.delete(`/v1/webhooks/triggers?id=${id}`);
+  }
+  async test(id) {
+    return this.client.post(`/v1/webhooks/${id}/test`);
+  }
+};
+
+// src/resources/tracking.ts
+var Tracking = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async productView(data) {
+    return this.client.post("/v1/track/product-view", data);
+  }
+};
+
+// src/resources/conversions.ts
+var Conversions = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.get("/v1/conversions", params);
+  }
+  async create(data) {
+    return this.client.post("/v1/conversions", data);
+  }
+};
+
+// src/resources/segments.ts
+var Segments = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.get("/v1/segments", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/segments/${id}`);
+  }
+  async create(data) {
+    return this.client.post("/v1/segments", data);
+  }
+  async update(id, data) {
+    return this.client.patch(`/v1/segments/${id}`, data);
+  }
+  async delete(id) {
+    await this.client.delete(`/v1/segments/${id}`);
+  }
+  async estimateCount(id) {
+    return this.client.post(`/v1/segments/${id}/estimate`);
+  }
+  async listContacts(id, params) {
+    return this.client.get(`/v1/segments/${id}/contacts`, params);
+  }
+};
+
+// src/resources/tags.ts
+var TagContacts = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(tagId, params) {
+    return this.client.get(
+      `/v1/tags/${tagId}/contacts`,
+      params
+    );
+  }
+  async assign(tagId, contactIds) {
+    return this.client.post(
+      `/v1/tags/${tagId}/contacts`,
+      { contact_ids: contactIds }
+    );
+  }
+  async remove(tagId, contactIds) {
+    return this.client.delete(
+      `/v1/tags/${tagId}/contacts`,
+      { contact_ids: contactIds }
+    );
+  }
+};
+var Tags = class {
+  constructor(client) {
+    this.client = client;
+    this.contacts = new TagContacts(client);
+  }
+  async list(params) {
+    return this.client.get("/v1/tags", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/tags/${id}`);
+  }
+  async create(data) {
+    return this.client.post("/v1/tags", data);
+  }
+  async update(id, data) {
+    return this.client.patch(`/v1/tags/${id}`, data);
+  }
+  async delete(id) {
+    await this.client.delete(`/v1/tags/${id}`);
+  }
+};
+
+// src/resources/automations.ts
+var Automations = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(data) {
+    return this.client.post("/v1/automations", data);
+  }
+  async list(params) {
+    return this.client.get("/v1/automations", params);
+  }
+  async get(id) {
+    return this.client.get(`/v1/automations/${id}`);
+  }
+  async update(id, data) {
+    return this.client.patch(`/v1/automations/${id}`, data);
+  }
+  async activate(id) {
+    return this.update(id, { status: "active" });
+  }
+  async pause(id) {
+    return this.update(id, { status: "paused" });
+  }
+  async delete(id) {
+    await this.client.delete(`/v1/automations/${id}`);
+  }
+  async addStep(id, data) {
+    return this.client.post(`/v1/automations/${id}/steps`, data);
+  }
+  async updateStep(automationId, stepId, data) {
+    return this.client.patch(`/v1/automations/${automationId}/steps/${stepId}`, data);
+  }
+  async deleteStep(automationId, stepId) {
+    await this.client.delete(`/v1/automations/${automationId}/steps/${stepId}`);
+  }
+  async batchUpdateSteps(id, data) {
+    return this.client.put(`/v1/automations/${id}/steps`, data);
+  }
+  async trigger(id, data) {
+    return this.client.post(`/v1/automations/${id}/trigger`, data);
+  }
+  async listRuns(id, params) {
+    return this.client.get(
+      `/v1/automations/${id}/runs`,
+      params
+    );
+  }
+  async cancelRun(automationId, runId) {
+    return this.client.post(
+      `/v1/automations/${automationId}/runs/${runId}/cancel`,
+      {}
+    );
+  }
+};
+
+// src/resources/domains.ts
+var Domains = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/v1/domains");
+  }
+  async get(id) {
+    return this.client.get(`/v1/domains/${id}`);
+  }
+  async create(data) {
+    return this.client.post("/v1/domains", data);
+  }
+  async delete(id) {
+    await this.client.delete(`/v1/domains/${id}`);
+  }
+  async verify(id) {
+    return this.client.post(`/v1/domains/${id}/verify`);
+  }
+};
+
+// src/resources/health.ts
+var Health = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async check() {
+    return this.client.get("/v1/health");
+  }
+};
+
+// src/index.ts
+var DEFAULT_BASE_URL = "https://api.topmail.so/api";
+var TopMail = class {
+  constructor(apiKey, options) {
+    if (!apiKey) {
+      throw new Error("API key is required");
+    }
+    this.isSandbox = apiKey.startsWith("tm_test_");
+    const client = new HttpClient({
+      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,
+      apiKey
+    });
+    this.contacts = new Contacts(client);
+    this.lists = new Lists(client);
+    this.campaigns = new Campaigns(client);
+    this.templates = new Templates(client);
+    this.email = new Email(client);
+    this.suppressions = new Suppressions(client);
+    this.webhooks = new Webhooks(client);
+    this.tracking = new Tracking(client);
+    this.conversions = new Conversions(client);
+    this.segments = new Segments(client);
+    this.tags = new Tags(client);
+    this.automations = new Automations(client);
+    this.domains = new Domains(client);
+    this.health = new Health(client);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  Automations,
+  Campaigns,
+  Contacts,
+  Conversions,
+  Domains,
+  Email,
+  ForbiddenError,
+  Health,
+  HttpClient,
+  Lists,
+  NotFoundError,
+  RateLimitError,
+  Segments,
+  ServerError,
+  Suppressions,
+  Tags,
+  Templates,
+  TopMail,
+  TopMailError,
+  Tracking,
+  ValidationError,
+  Webhooks
+});
+//# sourceMappingURL=index.js.map