lumail 0.1.0

package/dist/index.cjs

@@ -0,0 +1,364 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// ../../src/lib/lumail-sdk/index.ts
+var exports_lumail_sdk = {};
+__export(exports_lumail_sdk, {
+  LumailValidationError: () => LumailValidationError,
+  LumailRateLimitError: () => LumailRateLimitError,
+  LumailPaymentRequiredError: () => LumailPaymentRequiredError,
+  LumailNotFoundError: () => LumailNotFoundError,
+  LumailError: () => LumailError,
+  LumailAuthenticationError: () => LumailAuthenticationError,
+  Lumail: () => Lumail
+});
+module.exports = __toCommonJS(exports_lumail_sdk);
+
+// ../../src/lib/lumail-sdk/errors.ts
+class LumailError extends Error {
+  status;
+  code;
+  constructor(message, status, code) {
+    super(message);
+    this.name = "LumailError";
+    this.status = status;
+    this.code = code;
+  }
+}
+
+class LumailAuthenticationError extends LumailError {
+  constructor(message = "Invalid or missing API key") {
+    super(message, 401, "AUTHENTICATION_ERROR");
+    this.name = "LumailAuthenticationError";
+  }
+}
+
+class LumailRateLimitError extends LumailError {
+  retryAfter;
+  constructor(message = "Rate limit exceeded", retryAfter = null) {
+    super(message, 429, "RATE_LIMIT_ERROR");
+    this.name = "LumailRateLimitError";
+    this.retryAfter = retryAfter;
+  }
+}
+
+class LumailValidationError extends LumailError {
+  constructor(message) {
+    super(message, 400, "VALIDATION_ERROR");
+    this.name = "LumailValidationError";
+  }
+}
+
+class LumailNotFoundError extends LumailError {
+  constructor(message = "Resource not found") {
+    super(message, 404, "NOT_FOUND");
+    this.name = "LumailNotFoundError";
+  }
+}
+
+class LumailPaymentRequiredError extends LumailError {
+  constructor(message = "Plan limit reached") {
+    super(message, 402, "PLAN_LIMIT_REACHED");
+    this.name = "LumailPaymentRequiredError";
+  }
+}
+
+// ../../src/lib/lumail-sdk/client.ts
+var DEFAULT_BASE_URL = "https://lumail.io/api";
+var DEFAULT_TIMEOUT = 30000;
+var RETRY_DELAYS = [1000, 2000, 4000];
+var IDEMPOTENT_METHODS = new Set(["GET", "PUT", "DELETE"]);
+
+class LumailClient {
+  apiKey;
+  baseUrl;
+  constructor(apiKey, baseUrl) {
+    if (!apiKey?.trim()) {
+      throw new Error("Lumail API key is required. Get yours at lumail.io/settings");
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  async request(method, path, options) {
+    const url = this.buildUrl(path, options?.params);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    const isIdempotent = IDEMPOTENT_METHODS.has(method.toUpperCase());
+    let lastError = null;
+    const maxRetries = isIdempotent ? RETRY_DELAYS.length : 0;
+    for (let attempt = 0;attempt <= maxRetries; attempt++) {
+      try {
+        const signal = options?.signal ?? AbortSignal.timeout(DEFAULT_TIMEOUT);
+        const response = await fetch(url, {
+          method,
+          headers,
+          body: options?.body ? JSON.stringify(options.body) : undefined,
+          signal
+        });
+        if (response.ok) {
+          const data = await response.json();
+          if (data.success === false) {
+            throw new LumailError(data.message ?? "Request failed", response.status, data.code);
+          }
+          return data;
+        }
+        if (response.status === 429 && isIdempotent && attempt < maxRetries) {
+          await sleep(parseRetryAfter(response, RETRY_DELAYS[attempt]));
+          continue;
+        }
+        throw await this.handleErrorResponse(response);
+      } catch (error) {
+        if (error instanceof LumailError) {
+          throw error;
+        }
+        lastError = error;
+        const isNetworkError = error instanceof TypeError || error.name === "AbortError";
+        if (isNetworkError && isIdempotent && attempt < maxRetries) {
+          await sleep(RETRY_DELAYS[attempt]);
+          continue;
+        }
+        throw error;
+      }
+    }
+    throw lastError ?? new LumailError("Request failed after retries", 500);
+  }
+  buildUrl(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  async handleErrorResponse(response) {
+    let body = {};
+    try {
+      body = await response.json();
+    } catch {
+    }
+    const message = body.message ?? body.error ?? response.statusText;
+    const code = body.code;
+    switch (response.status) {
+      case 401:
+        return new LumailAuthenticationError(message);
+      case 402:
+        return new LumailPaymentRequiredError(message);
+      case 404:
+        return new LumailNotFoundError(message);
+      case 429: {
+        const retryAfter = parseRetryAfter(response, null);
+        return new LumailRateLimitError(message, retryAfter);
+      }
+      default:
+        if (response.status >= 400 && response.status < 500) {
+          return new LumailValidationError(message);
+        }
+        return new LumailError(message, response.status, code);
+    }
+  }
+}
+function parseRetryAfter(response, fallback) {
+  const header = response.headers.get("Retry-After");
+  if (!header)
+    return fallback;
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds))
+    return seconds * 1000;
+  const date = new Date(header).getTime();
+  if (!Number.isNaN(date))
+    return Math.max(0, date - Date.now());
+  return fallback;
+}
+async function sleep(ms) {
+  if (ms === null || ms <= 0)
+    return;
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// ../../src/lib/lumail-sdk/resources/campaigns.ts
+class Campaigns {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.request("GET", "/v1/campaigns", {
+      params
+    });
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/campaigns", {
+      body: params
+    });
+  }
+  async get(campaignId) {
+    return this.client.request("GET", `/v1/campaigns/${encodeURIComponent(campaignId)}`);
+  }
+  async update(campaignId, params) {
+    return this.client.request("PATCH", `/v1/campaigns/${encodeURIComponent(campaignId)}`, { body: params });
+  }
+  async delete(campaignId) {
+    return this.client.request("DELETE", `/v1/campaigns/${encodeURIComponent(campaignId)}`);
+  }
+  async send(campaignId, params) {
+    return this.client.request("POST", `/v1/campaigns/${encodeURIComponent(campaignId)}/send`, { body: params ?? {} });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/emails.ts
+class Emails {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async send(params) {
+    return this.client.request("POST", "/v1/emails", {
+      body: params
+    });
+  }
+  async verify(params) {
+    return this.client.request("POST", "/v1/emails/verify", {
+      body: params
+    });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/events.ts
+class Events {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/events", {
+      body: params
+    });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/subscribers.ts
+class Subscribers {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/subscribers", {
+      body: params
+    });
+  }
+  async get(idOrEmail) {
+    return this.client.request("GET", `/v1/subscribers/${encodeURIComponent(idOrEmail)}`);
+  }
+  async update(idOrEmail, params) {
+    return this.client.request("PATCH", `/v1/subscribers/${encodeURIComponent(idOrEmail)}`, { body: params });
+  }
+  async delete(idOrEmail) {
+    return this.client.request("DELETE", `/v1/subscribers/${encodeURIComponent(idOrEmail)}`);
+  }
+  async unsubscribe(idOrEmail) {
+    return this.client.request("POST", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/unsubscribe`);
+  }
+  async addTags(idOrEmail, tags) {
+    return this.client.request("POST", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/tags`, { body: { tags } });
+  }
+  async removeTags(idOrEmail, tags) {
+    return this.client.request("DELETE", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/tags`, { params: { tags: JSON.stringify(tags) } });
+  }
+  async listEvents(idOrEmail, params) {
+    return this.client.request("GET", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/events`, {
+      params: {
+        ...params,
+        eventTypes: params?.eventTypes ? JSON.stringify(params.eventTypes) : undefined
+      }
+    });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/tags.ts
+class Tags {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("GET", "/v1/tags");
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/tags", {
+      body: params
+    });
+  }
+  async get(idOrName) {
+    return this.client.request("GET", `/v1/tags/${encodeURIComponent(idOrName)}`);
+  }
+  async update(idOrName, params) {
+    return this.client.request("PATCH", `/v1/tags/${encodeURIComponent(idOrName)}`, { body: params });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/tools.ts
+class Tools {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("GET", "/v2/tools");
+  }
+  async get(toolName) {
+    return this.client.request("GET", `/v2/tools/${encodeURIComponent(toolName)}`);
+  }
+  async run(toolName, params) {
+    return this.client.request("POST", `/v2/tools/${encodeURIComponent(toolName)}`, { body: params ?? {} });
+  }
+}
+
+// ../../src/lib/lumail-sdk/index.ts
+class Lumail {
+  subscribers;
+  campaigns;
+  emails;
+  tags;
+  events;
+  tools;
+  constructor(options) {
+    const client = new LumailClient(options.apiKey, options.baseUrl);
+    this.subscribers = new Subscribers(client);
+    this.campaigns = new Campaigns(client);
+    this.emails = new Emails(client);
+    this.tags = new Tags(client);
+    this.events = new Events(client);
+    this.tools = new Tools(client);
+  }
+}

package/dist/index.js

@@ -0,0 +1,332 @@
+// ../../src/lib/lumail-sdk/errors.ts
+class LumailError extends Error {
+  status;
+  code;
+  constructor(message, status, code) {
+    super(message);
+    this.name = "LumailError";
+    this.status = status;
+    this.code = code;
+  }
+}
+
+class LumailAuthenticationError extends LumailError {
+  constructor(message = "Invalid or missing API key") {
+    super(message, 401, "AUTHENTICATION_ERROR");
+    this.name = "LumailAuthenticationError";
+  }
+}
+
+class LumailRateLimitError extends LumailError {
+  retryAfter;
+  constructor(message = "Rate limit exceeded", retryAfter = null) {
+    super(message, 429, "RATE_LIMIT_ERROR");
+    this.name = "LumailRateLimitError";
+    this.retryAfter = retryAfter;
+  }
+}
+
+class LumailValidationError extends LumailError {
+  constructor(message) {
+    super(message, 400, "VALIDATION_ERROR");
+    this.name = "LumailValidationError";
+  }
+}
+
+class LumailNotFoundError extends LumailError {
+  constructor(message = "Resource not found") {
+    super(message, 404, "NOT_FOUND");
+    this.name = "LumailNotFoundError";
+  }
+}
+
+class LumailPaymentRequiredError extends LumailError {
+  constructor(message = "Plan limit reached") {
+    super(message, 402, "PLAN_LIMIT_REACHED");
+    this.name = "LumailPaymentRequiredError";
+  }
+}
+
+// ../../src/lib/lumail-sdk/client.ts
+var DEFAULT_BASE_URL = "https://lumail.io/api";
+var DEFAULT_TIMEOUT = 30000;
+var RETRY_DELAYS = [1000, 2000, 4000];
+var IDEMPOTENT_METHODS = new Set(["GET", "PUT", "DELETE"]);
+
+class LumailClient {
+  apiKey;
+  baseUrl;
+  constructor(apiKey, baseUrl) {
+    if (!apiKey?.trim()) {
+      throw new Error("Lumail API key is required. Get yours at lumail.io/settings");
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  async request(method, path, options) {
+    const url = this.buildUrl(path, options?.params);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    const isIdempotent = IDEMPOTENT_METHODS.has(method.toUpperCase());
+    let lastError = null;
+    const maxRetries = isIdempotent ? RETRY_DELAYS.length : 0;
+    for (let attempt = 0;attempt <= maxRetries; attempt++) {
+      try {
+        const signal = options?.signal ?? AbortSignal.timeout(DEFAULT_TIMEOUT);
+        const response = await fetch(url, {
+          method,
+          headers,
+          body: options?.body ? JSON.stringify(options.body) : undefined,
+          signal
+        });
+        if (response.ok) {
+          const data = await response.json();
+          if (data.success === false) {
+            throw new LumailError(data.message ?? "Request failed", response.status, data.code);
+          }
+          return data;
+        }
+        if (response.status === 429 && isIdempotent && attempt < maxRetries) {
+          await sleep(parseRetryAfter(response, RETRY_DELAYS[attempt]));
+          continue;
+        }
+        throw await this.handleErrorResponse(response);
+      } catch (error) {
+        if (error instanceof LumailError) {
+          throw error;
+        }
+        lastError = error;
+        const isNetworkError = error instanceof TypeError || error.name === "AbortError";
+        if (isNetworkError && isIdempotent && attempt < maxRetries) {
+          await sleep(RETRY_DELAYS[attempt]);
+          continue;
+        }
+        throw error;
+      }
+    }
+    throw lastError ?? new LumailError("Request failed after retries", 500);
+  }
+  buildUrl(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  async handleErrorResponse(response) {
+    let body = {};
+    try {
+      body = await response.json();
+    } catch {
+    }
+    const message = body.message ?? body.error ?? response.statusText;
+    const code = body.code;
+    switch (response.status) {
+      case 401:
+        return new LumailAuthenticationError(message);
+      case 402:
+        return new LumailPaymentRequiredError(message);
+      case 404:
+        return new LumailNotFoundError(message);
+      case 429: {
+        const retryAfter = parseRetryAfter(response, null);
+        return new LumailRateLimitError(message, retryAfter);
+      }
+      default:
+        if (response.status >= 400 && response.status < 500) {
+          return new LumailValidationError(message);
+        }
+        return new LumailError(message, response.status, code);
+    }
+  }
+}
+function parseRetryAfter(response, fallback) {
+  const header = response.headers.get("Retry-After");
+  if (!header)
+    return fallback;
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds))
+    return seconds * 1000;
+  const date = new Date(header).getTime();
+  if (!Number.isNaN(date))
+    return Math.max(0, date - Date.now());
+  return fallback;
+}
+async function sleep(ms) {
+  if (ms === null || ms <= 0)
+    return;
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// ../../src/lib/lumail-sdk/resources/campaigns.ts
+class Campaigns {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.request("GET", "/v1/campaigns", {
+      params
+    });
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/campaigns", {
+      body: params
+    });
+  }
+  async get(campaignId) {
+    return this.client.request("GET", `/v1/campaigns/${encodeURIComponent(campaignId)}`);
+  }
+  async update(campaignId, params) {
+    return this.client.request("PATCH", `/v1/campaigns/${encodeURIComponent(campaignId)}`, { body: params });
+  }
+  async delete(campaignId) {
+    return this.client.request("DELETE", `/v1/campaigns/${encodeURIComponent(campaignId)}`);
+  }
+  async send(campaignId, params) {
+    return this.client.request("POST", `/v1/campaigns/${encodeURIComponent(campaignId)}/send`, { body: params ?? {} });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/emails.ts
+class Emails {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async send(params) {
+    return this.client.request("POST", "/v1/emails", {
+      body: params
+    });
+  }
+  async verify(params) {
+    return this.client.request("POST", "/v1/emails/verify", {
+      body: params
+    });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/events.ts
+class Events {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/events", {
+      body: params
+    });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/subscribers.ts
+class Subscribers {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/subscribers", {
+      body: params
+    });
+  }
+  async get(idOrEmail) {
+    return this.client.request("GET", `/v1/subscribers/${encodeURIComponent(idOrEmail)}`);
+  }
+  async update(idOrEmail, params) {
+    return this.client.request("PATCH", `/v1/subscribers/${encodeURIComponent(idOrEmail)}`, { body: params });
+  }
+  async delete(idOrEmail) {
+    return this.client.request("DELETE", `/v1/subscribers/${encodeURIComponent(idOrEmail)}`);
+  }
+  async unsubscribe(idOrEmail) {
+    return this.client.request("POST", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/unsubscribe`);
+  }
+  async addTags(idOrEmail, tags) {
+    return this.client.request("POST", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/tags`, { body: { tags } });
+  }
+  async removeTags(idOrEmail, tags) {
+    return this.client.request("DELETE", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/tags`, { params: { tags: JSON.stringify(tags) } });
+  }
+  async listEvents(idOrEmail, params) {
+    return this.client.request("GET", `/v1/subscribers/${encodeURIComponent(idOrEmail)}/events`, {
+      params: {
+        ...params,
+        eventTypes: params?.eventTypes ? JSON.stringify(params.eventTypes) : undefined
+      }
+    });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/tags.ts
+class Tags {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("GET", "/v1/tags");
+  }
+  async create(params) {
+    return this.client.request("POST", "/v1/tags", {
+      body: params
+    });
+  }
+  async get(idOrName) {
+    return this.client.request("GET", `/v1/tags/${encodeURIComponent(idOrName)}`);
+  }
+  async update(idOrName, params) {
+    return this.client.request("PATCH", `/v1/tags/${encodeURIComponent(idOrName)}`, { body: params });
+  }
+}
+
+// ../../src/lib/lumail-sdk/resources/tools.ts
+class Tools {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("GET", "/v2/tools");
+  }
+  async get(toolName) {
+    return this.client.request("GET", `/v2/tools/${encodeURIComponent(toolName)}`);
+  }
+  async run(toolName, params) {
+    return this.client.request("POST", `/v2/tools/${encodeURIComponent(toolName)}`, { body: params ?? {} });
+  }
+}
+
+// ../../src/lib/lumail-sdk/index.ts
+class Lumail {
+  subscribers;
+  campaigns;
+  emails;
+  tags;
+  events;
+  tools;
+  constructor(options) {
+    const client = new LumailClient(options.apiKey, options.baseUrl);
+    this.subscribers = new Subscribers(client);
+    this.campaigns = new Campaigns(client);
+    this.emails = new Emails(client);
+    this.tags = new Tags(client);
+    this.events = new Events(client);
+    this.tools = new Tools(client);
+  }
+}
+export {
+  LumailValidationError,
+  LumailRateLimitError,
+  LumailPaymentRequiredError,
+  LumailNotFoundError,
+  LumailError,
+  LumailAuthenticationError,
+  Lumail
+};