@tratto/email 0.1.0

package/dist/index.mjs

@@ -0,0 +1,375 @@
+// src/error.ts
+var TrattoError = class extends Error {
+  constructor(message, code, statusCode, docs) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.docs = docs;
+    this.name = "TrattoError";
+  }
+};
+
+// src/resources/base.ts
+var BaseResource = class {
+  constructor(apiKey, baseUrl) {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+  }
+  async fetch(method, path, options) {
+    const hasBody = options?.body !== void 0;
+    const contentType = options?.contentType ?? (hasBody ? "application/json" : void 0);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "User-Agent": "@tratto/email/0.1.0",
+      ...contentType ? { "Content-Type": contentType } : {},
+      ...options?.headers
+    };
+    let body;
+    if (hasBody) {
+      body = contentType === "application/json" ? JSON.stringify(options.body) : options.body;
+    }
+    const res = await globalThis.fetch(`${this.baseUrl}${path}`, { method, headers, body });
+    if (res.status === 204) return void 0;
+    const json = await res.json();
+    if (!res.ok) {
+      const err = json["error"] ?? {};
+      throw new TrattoError(
+        err.message ?? res.statusText,
+        err.code ?? "unknown_error",
+        res.status,
+        err.docs
+      );
+    }
+    return json;
+  }
+  async fetchData(method, path, options) {
+    const res = await this.fetch(method, path, options);
+    return res.data;
+  }
+  buildQuery(params) {
+    const qs = new URLSearchParams();
+    for (const [key, val] of Object.entries(params)) {
+      if (val == null) continue;
+      qs.set(key, val instanceof Date ? val.toISOString() : String(val));
+    }
+    const str = qs.toString();
+    return str ? `?${str}` : "";
+  }
+};
+
+// src/resources/emails.ts
+var EmailsResource = class extends BaseResource {
+  send(params, idempotencyKey) {
+    return this.fetchData("POST", "/v1/emails", {
+      body: params,
+      headers: idempotencyKey ? { "Idempotency-Key": idempotencyKey } : void 0
+    });
+  }
+  list(params) {
+    const qs = this.buildQuery({
+      after: params?.after,
+      limit: params?.limit,
+      status: params?.status,
+      domainId: params?.domainId,
+      tags: params?.tags,
+      dateFrom: params?.dateFrom,
+      dateTo: params?.dateTo
+    });
+    return this.fetch("GET", `/v1/emails${qs}`);
+  }
+  get(id) {
+    return this.fetchData("GET", `/v1/emails/${id}`);
+  }
+  listEvents(id) {
+    return this.fetchData("GET", `/v1/emails/${id}/events`);
+  }
+};
+
+// src/resources/contacts.ts
+var ContactsResource = class extends BaseResource {
+  create(params) {
+    return this.fetchData("POST", "/v1/contacts", { body: params });
+  }
+  list(params) {
+    const qs = this.buildQuery({
+      status: params?.status,
+      audienceId: params?.audienceId,
+      tag: params?.tag,
+      after: params?.after,
+      limit: params?.limit
+    });
+    return this.fetch("GET", `/v1/contacts${qs}`);
+  }
+  update(id, params) {
+    return this.fetchData("PATCH", `/v1/contacts/${id}`, { body: params });
+  }
+  importCsv(csvText) {
+    return this.fetchData(
+      "POST",
+      "/v1/contacts/import",
+      { body: csvText, contentType: "text/csv" }
+    );
+  }
+  getImportJob(jobId) {
+    return this.fetchData("GET", `/v1/contacts/import/${jobId}`);
+  }
+};
+
+// src/resources/audiences.ts
+var AudiencesResource = class extends BaseResource {
+  create(params) {
+    return this.fetchData("POST", "/v1/audiences", { body: params });
+  }
+  list(params) {
+    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
+    return this.fetch("GET", `/v1/audiences${qs}`);
+  }
+  get(id) {
+    return this.fetchData("GET", `/v1/audiences/${id}`);
+  }
+  addContacts(audienceId, contactIds) {
+    return this.fetchData(
+      "POST",
+      `/v1/audiences/${audienceId}/contacts`,
+      { body: { contactIds } }
+    );
+  }
+};
+
+// src/resources/campaigns.ts
+var CampaignsResource = class extends BaseResource {
+  create(params) {
+    return this.fetchData("POST", "/v1/campaigns", { body: params });
+  }
+  list(params) {
+    const qs = this.buildQuery({
+      status: params?.status,
+      after: params?.after,
+      limit: params?.limit
+    });
+    return this.fetch("GET", `/v1/campaigns${qs}`);
+  }
+  get(id) {
+    return this.fetchData("GET", `/v1/campaigns/${id}`);
+  }
+  getStats(id) {
+    return this.fetchData("GET", `/v1/campaigns/${id}/stats`);
+  }
+  send(id, params) {
+    const body = {};
+    if (params?.scheduledAt) {
+      body["scheduledAt"] = params.scheduledAt instanceof Date ? params.scheduledAt.toISOString() : params.scheduledAt;
+    }
+    return this.fetchData("POST", `/v1/campaigns/${id}/send`, { body });
+  }
+  pause(id) {
+    return this.fetchData("POST", `/v1/campaigns/${id}/pause`, { body: {} });
+  }
+  testSend(id, to) {
+    return this.fetchData(
+      "POST",
+      `/v1/campaigns/${id}/test-send`,
+      { body: { to } }
+    );
+  }
+};
+
+// src/resources/templates.ts
+var TemplatesResource = class extends BaseResource {
+  list(params) {
+    const qs = this.buildQuery({
+      limit: params?.limit,
+      after: params?.after,
+      status: params?.status
+    });
+    return this.fetch("GET", `/v1/templates${qs}`);
+  }
+  create(params) {
+    return this.fetchData("POST", "/v1/templates", { body: params });
+  }
+  get(id) {
+    return this.fetchData("GET", `/v1/templates/${id}`);
+  }
+  update(id, params) {
+    return this.fetchData("PATCH", `/v1/templates/${id}`, { body: params });
+  }
+  delete(id) {
+    return this.fetch("DELETE", `/v1/templates/${id}`);
+  }
+  listVersions(id) {
+    return this.fetchData("GET", `/v1/templates/${id}/versions`);
+  }
+  getVersion(id, version) {
+    return this.fetchData("GET", `/v1/templates/${id}/versions/${version}`);
+  }
+  testSend(id, to, variables = {}) {
+    return this.fetchData(
+      "POST",
+      `/v1/templates/${id}/test-send`,
+      { body: { to, variables } }
+    );
+  }
+};
+
+// src/resources/webhooks.ts
+var WebhooksResource = class extends BaseResource {
+  create(params) {
+    return this.fetchData("POST", "/v1/webhooks", { body: params });
+  }
+  list() {
+    return this.fetchData("GET", "/v1/webhooks");
+  }
+  delete(id) {
+    return this.fetch("DELETE", `/v1/webhooks/${id}`);
+  }
+  listDeliveries(id, params) {
+    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
+    return this.fetch(
+      "GET",
+      `/v1/webhooks/${id}/deliveries${qs}`
+    );
+  }
+  test(id) {
+    return this.fetchData("POST", `/v1/webhooks/${id}/test`, { body: {} });
+  }
+  rotateSecret(id) {
+    return this.fetchData(
+      "POST",
+      `/v1/webhooks/${id}/rotate-secret`,
+      { body: {} }
+    );
+  }
+};
+
+// src/resources/domains.ts
+var DomainsResource = class extends BaseResource {
+  add(domain) {
+    return this.fetchData("POST", "/v1/domains", { body: { domain } });
+  }
+  list(params) {
+    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
+    return this.fetch("GET", `/v1/domains${qs}`);
+  }
+  get(id) {
+    return this.fetchData("GET", `/v1/domains/${id}`);
+  }
+  verify(id) {
+    return this.fetchData("POST", `/v1/domains/${id}/verify`, { body: {} });
+  }
+  delete(id) {
+    return this.fetchData("DELETE", `/v1/domains/${id}`);
+  }
+};
+
+// src/resources/api-keys.ts
+var ApiKeysResource = class extends BaseResource {
+  create(params, idempotencyKey) {
+    return this.fetchData("POST", "/v1/api-keys", {
+      body: params,
+      headers: idempotencyKey ? { "Idempotency-Key": idempotencyKey } : void 0
+    });
+  }
+  list(params) {
+    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
+    return this.fetch("GET", `/v1/api-keys${qs}`);
+  }
+  revoke(id) {
+    return this.fetchData("DELETE", `/v1/api-keys/${id}`);
+  }
+};
+
+// src/resources/analytics.ts
+var AnalyticsResource = class extends BaseResource {
+  getSummary(period = "30d") {
+    return this.fetchData(
+      "GET",
+      `/v1/analytics/summary${this.buildQuery({ period })}`
+    );
+  }
+  getTimeseries(period = "30d") {
+    return this.fetchData(
+      "GET",
+      `/v1/analytics/timeseries${this.buildQuery({ period })}`
+    );
+  }
+};
+
+// src/resources/flows.ts
+var FlowsResource = class extends BaseResource {
+  list(params) {
+    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
+    return this.fetch("GET", `/v1/flows${qs}`);
+  }
+  create(params) {
+    return this.fetchData("POST", "/v1/flows", { body: params });
+  }
+  get(id) {
+    return this.fetchData("GET", `/v1/flows/${id}`);
+  }
+  update(id, params) {
+    return this.fetchData("PATCH", `/v1/flows/${id}`, { body: params });
+  }
+  delete(id) {
+    return this.fetchData("DELETE", `/v1/flows/${id}`);
+  }
+  activate(id) {
+    return this.fetchData("POST", `/v1/flows/${id}/activate`, { body: {} });
+  }
+  deactivate(id) {
+    return this.fetchData("POST", `/v1/flows/${id}/deactivate`, { body: {} });
+  }
+};
+
+// src/resources/workspace.ts
+var WorkspaceResource = class extends BaseResource {
+  get() {
+    return this.fetchData("GET", "/v1/workspace");
+  }
+  update(params) {
+    return this.fetchData("PATCH", "/v1/workspace", { body: params });
+  }
+  delete() {
+    return this.fetch("DELETE", "/v1/workspace");
+  }
+  updatePreferences(params) {
+    return this.fetchData("PATCH", "/v1/workspace/preferences", {
+      body: params
+    });
+  }
+  inviteMember(params) {
+    return this.fetchData("POST", "/v1/workspace/members/invite", {
+      body: params
+    });
+  }
+  updateMember(userId, params) {
+    return this.fetchData("PATCH", `/v1/workspace/members/${userId}`, {
+      body: params
+    });
+  }
+  removeMember(userId) {
+    return this.fetch("DELETE", `/v1/workspace/members/${userId}`);
+  }
+};
+
+// src/client.ts
+var Tratto = class {
+  constructor(apiKey, options) {
+    if (!apiKey) throw new Error("apiKey is required");
+    const baseUrl = (options?.baseUrl ?? "https://api.tratto.email").replace(/\/$/, "");
+    this.emails = new EmailsResource(apiKey, baseUrl);
+    this.contacts = new ContactsResource(apiKey, baseUrl);
+    this.audiences = new AudiencesResource(apiKey, baseUrl);
+    this.campaigns = new CampaignsResource(apiKey, baseUrl);
+    this.templates = new TemplatesResource(apiKey, baseUrl);
+    this.webhooks = new WebhooksResource(apiKey, baseUrl);
+    this.domains = new DomainsResource(apiKey, baseUrl);
+    this.apiKeys = new ApiKeysResource(apiKey, baseUrl);
+    this.analytics = new AnalyticsResource(apiKey, baseUrl);
+    this.flows = new FlowsResource(apiKey, baseUrl);
+    this.workspace = new WorkspaceResource(apiKey, baseUrl);
+  }
+};
+export {
+  Tratto,
+  TrattoError
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@tratto/email",
+  "version": "0.1.0",
+  "description": "Tratto Node.js SDK — send transactional and marketing email",
+  "author": "Tratto <hello@tratto.email>",
+  "license": "MIT",
+  "homepage": "https://tratto.email",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tratto-email/tratto-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tratto-email/tratto-node/issues"
+  },
+  "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"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}