retransmit.dev 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,4 +1,22 @@
 // src/emails.ts
+function toBase64(bytes) {
+  if (typeof Buffer !== "undefined") return Buffer.from(bytes).toString("base64");
+  let binary = "";
+  const CHUNK = 32768;
+  for (let i = 0; i < bytes.length; i += CHUNK) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
+  }
+  return btoa(binary);
+}
+function toWireAttachment(attachment) {
+  return {
+    filename: attachment.filename,
+    content: attachment.content === void 0 || typeof attachment.content === "string" ? attachment.content : toBase64(attachment.content),
+    path: attachment.path,
+    content_type: attachment.contentType,
+    content_id: attachment.contentId
+  };
+}
 function toWirePayload(options) {
   return {
     from: options.from,
@@ -10,7 +28,9 @@ function toWirePayload(options) {
     html: options.html,
     text: options.text,
     marketing: options.marketing,
-    tags: options.tags
+    tags: options.tags,
+    headers: options.headers,
+    attachments: options.attachments?.map(toWireAttachment)
   };
 }
 var Emails = class {
@@ -18,9 +38,18 @@ var Emails = class {
     this.client = client;
   }
   client;
-  /** Queues a single email. Poll `get(id)` or subscribe to webhooks for the outcome. */
-  send(options) {
-    return this.client.request("POST", "/v1/emails", toWirePayload(options));
+  /**
+   * Queues a single email. Poll `get(id)` or subscribe to webhooks for the
+   * outcome. Pass `{ idempotencyKey }` to make the call safe to retry.
+   */
+  send(options, requestOptions) {
+    return this.client.request(
+      "POST",
+      "/v1/emails",
+      toWirePayload(options),
+      void 0,
+      requestOptions
+    );
   }
   /** Retrieves an email with its current status and event history. */
   get(id) {
@@ -43,6 +72,21 @@ var Emails = class {
   tags() {
     return this.client.request("GET", "/v1/emails/tags");
   }
+  /**
+   * The attachments of an email, each with a signed `download_url` valid for
+   * one hour. Files are kept for 30 days after the send; after that the link
+   * is `null` and only the metadata remains.
+   */
+  attachments(emailId) {
+    return this.client.request("GET", `/v1/emails/${encodeURIComponent(emailId)}/attachments`);
+  }
+  /** One attachment of an email with a signed download link. */
+  getAttachment(emailId, attachmentId) {
+    return this.client.request(
+      "GET",
+      `/v1/emails/${encodeURIComponent(emailId)}/attachments/${encodeURIComponent(attachmentId)}`
+    );
+  }
 };
 
 // src/batch.ts
@@ -51,11 +95,19 @@ var Batch = class {
     this.client = client;
   }
   client;
-  /** Queues up to 10,000 emails in one request. Track progress with `get(id)`. */
-  send(emails) {
-    return this.client.request("POST", "/v1/emails/batch", {
-      emails: emails.map(toWirePayload)
-    });
+  /**
+   * Queues up to 10,000 emails in one request. Track progress with `get(id)`.
+   * Pass `{ idempotencyKey }` covering the whole batch to make the call safe
+   * to retry.
+   */
+  send(emails, requestOptions) {
+    return this.client.request(
+      "POST",
+      "/v1/emails/batch",
+      { emails: emails.map(toWirePayload) },
+      void 0,
+      requestOptions
+    );
   }
   /** Batch progress: how many emails are in each status so far. */
   get(id) {
@@ -114,7 +166,7 @@ var Whatsapp = class {
 
 // src/retransmit.ts
 var DEFAULT_BASE_URL = "https://api.retransmit.dev";
-var USER_AGENT = "retransmit.dev-node/0.3.0";
+var USER_AGENT = "retransmit.dev-node/0.5.0";
 function readEnv(name) {
   return typeof process !== "undefined" ? process.env?.[name] : void 0;
 }
@@ -139,7 +191,7 @@ var Retransmit = class {
     );
   }
   /** Internal transport shared by the resource classes. API failures are returned, never thrown. */
-  async request(method, path, body, query) {
+  async request(method, path, body, query, options = {}) {
     const params = new URLSearchParams();
     for (const [key, value] of Object.entries(query ?? {})) {
       if (value === void 0) continue;
@@ -147,15 +199,19 @@ var Retransmit = class {
     }
     const encoded = params.toString();
     const search = encoded ? `?${encoded}` : "";
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      "User-Agent": USER_AGENT
+    };
+    if (options.idempotencyKey !== void 0) {
+      headers["Idempotency-Key"] = options.idempotencyKey;
+    }
     let response;
     try {
       response = await fetch(`${this.baseUrl}${path}${search}`, {
         method,
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json",
-          "User-Agent": USER_AGENT
-        },
+        headers,
         body: body === void 0 ? void 0 : JSON.stringify(body)
       });
     } catch (cause) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retransmit.dev",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Node.js SDK for the Retransmit email, SMS and WhatsApp APIs",
   "keywords": [
     "email",
@@ -16,8 +16,10 @@
   "homepage": "https://docs.retransmit.dev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/retransmit-dev/retransmit.git",
-    "directory": "packages/sdk"
+    "url": "git+https://github.com/retransmit-dev/retransmit-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/retransmit-dev/retransmit-node/issues"
   },
   "license": "MIT",
   "type": "module",
@@ -44,7 +46,7 @@
     "@types/node": "^26.2.0",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3",
-    "@retransmit/config": "0.0.0"
+    "vitest": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -54,6 +56,8 @@
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
-    "check-types": "tsc --noEmit"
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }