shipmail 0.1.23 → 0.1.25

package/README.md

@@ -21,6 +21,8 @@ Official TypeScript SDK for the [Shipmail](https://shipmail.to) API. Zero runtim
 - [Threads](#threads)
 - [Webhooks](#webhooks)
 - [Suppressions](#suppressions)
+- [Audiences](#audiences)
+- [Newsletters](#newsletters)
 - [Status](#status)
 - [Pagination](#pagination)
 - [Webhook verification](#webhook-verification)
@@ -232,6 +234,44 @@ for await (const item of shipmail.suppressions.listAutoPaginating({ limit: 100 }
 }
 ```
 
+## Audiences
+
+```ts
+const audience = await shipmail.audiences.create({
+  name: "Newsletter",
+  consent_source: "Website signup form",
+});
+
+await shipmail.audiences.subscribers.add(audience.id, {
+  email_address: "jane@example.com",
+  merge_fields: { plan: "pro" },
+});
+```
+
+## Newsletters
+
+```ts
+const newsletter = await shipmail.newsletters.create({
+  audience_id: "aud_...",
+  newsletter_domain_id: "nwsdom_...",
+  name: "July changelog",
+  subject: "What shipped in July",
+  preview_text: "A quick product update",
+  body_html: "<h1>July updates</h1><p>...</p>",
+  body_text: "July updates\n...",
+});
+
+await shipmail.newsletters.sendTest(newsletter.id, {
+  recipient_email: "owner@example.com",
+});
+
+await shipmail.newsletters.preflight(newsletter.id);
+
+await shipmail.newsletters.schedule(newsletter.id, {
+  scheduled_at: "2026-08-01T09:00:00.000Z",
+});
+```
+
 ## Status
 
 ```ts

package/dist/index.cjs

@@ -117,9 +117,9 @@ function mapErrorFromResponse(status, body, requestId) {
 
 // src/pagination.ts
 var Page = class {
-  constructor(client, path, query) {
+  constructor(client, path2, query) {
     this.client = client;
-    this.path = path;
+    this.path = path2;
     this.query = query;
   }
   async *[Symbol.asyncIterator]() {
@@ -146,6 +146,132 @@ var ApiResource = class {
   }
 };
 
+// src/resources/audiences.ts
+function base(audienceId) {
+  return `/audiences/${encodeURIComponent(audienceId)}/subscribers`;
+}
+var Subscribers = class extends ApiResource {
+  add(audienceId, params, options) {
+    return this.client.request({
+      method: "POST",
+      path: base(audienceId),
+      body: params,
+      methodOptions: options
+    });
+  }
+  addBatch(audienceId, params, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${base(audienceId)}/batch`,
+      body: params,
+      methodOptions: options
+    });
+  }
+  list(audienceId, params, options) {
+    return this.client.request({
+      method: "GET",
+      path: base(audienceId),
+      query: {
+        cursor: params?.cursor,
+        limit: params?.limit,
+        status: params?.status,
+        email: params?.email
+      },
+      methodOptions: options
+    });
+  }
+  listAutoPaginating(audienceId, params) {
+    return new Page(this.client, base(audienceId), {
+      limit: params?.limit,
+      status: params?.status,
+      email: params?.email
+    });
+  }
+  get(audienceId, subscriberId, options) {
+    return this.client.request({
+      method: "GET",
+      path: `${base(audienceId)}/${encodeURIComponent(subscriberId)}`,
+      methodOptions: options
+    });
+  }
+  getByEmail(audienceId, email, options) {
+    return this.client.request({
+      method: "GET",
+      path: `${base(audienceId)}/by-email/${encodeURIComponent(email)}`,
+      methodOptions: options
+    });
+  }
+  update(audienceId, subscriberId, params, options) {
+    return this.client.request({
+      method: "PATCH",
+      path: `${base(audienceId)}/${encodeURIComponent(subscriberId)}`,
+      body: params,
+      methodOptions: options
+    });
+  }
+  unsubscribe(audienceId, subscriberId, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${base(audienceId)}/${encodeURIComponent(subscriberId)}/unsubscribe`,
+      methodOptions: options
+    });
+  }
+  remove(audienceId, subscriberId, options) {
+    return this.client.request({
+      method: "DELETE",
+      path: `${base(audienceId)}/${encodeURIComponent(subscriberId)}`,
+      methodOptions: options
+    });
+  }
+};
+var Audiences = class extends ApiResource {
+  constructor(client) {
+    super(client);
+    this.subscribers = new Subscribers(client);
+  }
+  create(params, options) {
+    return this.client.request({
+      method: "POST",
+      path: "/audiences",
+      body: params,
+      methodOptions: options
+    });
+  }
+  list(params, options) {
+    return this.client.request({
+      method: "GET",
+      path: "/audiences",
+      query: { cursor: params?.cursor, limit: params?.limit },
+      methodOptions: options
+    });
+  }
+  listAutoPaginating(params) {
+    return new Page(this.client, "/audiences", { limit: params?.limit });
+  }
+  get(id, options) {
+    return this.client.request({
+      method: "GET",
+      path: `/audiences/${encodeURIComponent(id)}`,
+      methodOptions: options
+    });
+  }
+  update(id, params, options) {
+    return this.client.request({
+      method: "PATCH",
+      path: `/audiences/${encodeURIComponent(id)}`,
+      body: params,
+      methodOptions: options
+    });
+  }
+  delete(id, options) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/audiences/${encodeURIComponent(id)}`,
+      methodOptions: options
+    });
+  }
+};
+
 // src/resources/domains.ts
 var Domains = class extends ApiResource {
   create(params, options) {
@@ -493,6 +619,84 @@ var Messages = class extends ApiResource {
   }
 };
 
+// src/resources/newsletters.ts
+function path(id) {
+  return `/newsletters/${encodeURIComponent(id)}`;
+}
+var Newsletters = class extends ApiResource {
+  create(params, options) {
+    return this.client.request({
+      method: "POST",
+      path: "/newsletters",
+      body: params,
+      methodOptions: options
+    });
+  }
+  list(params, options) {
+    return this.client.request({
+      method: "GET",
+      path: "/newsletters",
+      query: { cursor: params?.cursor, limit: params?.limit },
+      methodOptions: options
+    });
+  }
+  listAutoPaginating(params) {
+    return new Page(this.client, "/newsletters", { limit: params?.limit });
+  }
+  get(id, options) {
+    return this.client.request({
+      method: "GET",
+      path: path(id),
+      methodOptions: options
+    });
+  }
+  update(id, params, options) {
+    return this.client.request({
+      method: "PATCH",
+      path: path(id),
+      body: params,
+      methodOptions: options
+    });
+  }
+  preflight(id, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${path(id)}/preflight`,
+      methodOptions: options
+    });
+  }
+  sendTest(id, params, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${path(id)}/test-send`,
+      body: params,
+      methodOptions: options
+    });
+  }
+  schedule(id, params, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${path(id)}/schedule`,
+      body: params,
+      methodOptions: options
+    });
+  }
+  cancel(id, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${path(id)}/cancel`,
+      methodOptions: options
+    });
+  }
+  resume(id, options) {
+    return this.client.request({
+      method: "POST",
+      path: `${path(id)}/resume`,
+      methodOptions: options
+    });
+  }
+};
+
 // src/resources/status.ts
 var Status = class extends ApiResource {
   get(options) {
@@ -661,7 +865,7 @@ var Webhooks = class extends ApiResource {
 };
 
 // src/version.ts
-var VERSION = "0.1.23";
+var VERSION = "0.1.25";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -674,9 +878,9 @@ function calculateBackoff(attempt, retryAfterMs) {
   if (retryAfterMs !== void 0 && retryAfterMs > 0) {
     return retryAfterMs;
   }
-  const base = Math.min(2 ** attempt * 500, 8e3);
-  const jitter = Math.random() * base * 0.5;
-  return base + jitter;
+  const base2 = Math.min(2 ** attempt * 500, 8e3);
+  const jitter = Math.random() * base2 * 0.5;
+  return base2 + jitter;
 }
 function isApiErrorBody(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -706,9 +910,11 @@ var ShipMailClient = class {
       this.fetchFn = config.fetch ?? globalThis.fetch;
       this.defaultHeaders = config.defaultHeaders ? { ...config.defaultHeaders } : {};
     }
+    this.audiences = new Audiences(this);
     this.domains = new Domains(this);
     this.mailboxes = new Mailboxes(this);
     this.messages = new Messages(this);
+    this.newsletters = new Newsletters(this);
     this.suppressions = new Suppressions(this);
     this.threads = new Threads(this);
     this.webhooks = new Webhooks(this);
@@ -792,8 +998,8 @@ var ShipMailClient = class {
     }
     throw lastError ?? new ShipMailError("Request failed after retries");
   }
-  buildUrl(path, query) {
-    const url = new URL(`${this.baseUrl}${path}`);
+  buildUrl(path2, query) {
+    const url = new URL(`${this.baseUrl}${path2}`);
     if (query) {
       for (const [key, value] of Object.entries(query)) {
         if (value !== void 0) {