shipmail 0.5.2 → 0.5.4

package/README.md

@@ -199,12 +199,14 @@ const queue = await shipmail.mailboxes.listInboxThreads(mailboxId, {
   after: "2025-07-20T00:00:00.000Z",
 });
 const candidate = queue.data[0];
-const draft = await shipmail.mailboxes.createInboxReplyDraft(mailboxId, candidate.thread_id, {
+// `conversation_id` is the ID to store. `thread_id` is deprecated: it still works and its
+// value is unchanged, but the mail server can re-thread it when conversations merge.
+const draft = await shipmail.mailboxes.createInboxReplyDraft(mailboxId, candidate.conversation_id, {
   text: "Thanks for the note.",
   expected_version: candidate.version,
 });
 // Apply your approval policy before sending. Stale versions fail with 409 without delivery.
-await shipmail.mailboxes.sendInboxReplyDraft(mailboxId, candidate.thread_id, draft.id);
+await shipmail.mailboxes.sendInboxReplyDraft(mailboxId, candidate.conversation_id, draft.id);
 ```
 
 ## Messages
@@ -432,7 +434,7 @@ await shipmail.audiences.feeds.revoke(audience.id);
 import { readFile } from "node:fs/promises";
 
 const senderIdentities = await shipmail.newsletters.senderIdentities.list({ limit: 25 });
-const assets = await shipmail.newsletters.assets.list({ kind: "image", limit: 25 });
+const assets = await shipmail.newsletters.assets.list({ kind: "image", q: "hero", limit: 25 });
 const hero = await shipmail.newsletters.assets.upload({
   filename: "hero.png",
   content_type: "image/png",
@@ -468,8 +470,8 @@ const newsletter = await shipmail.newsletters.create({
     {
       type: "columns",
       ratio: "50-50",
-      left: { title: "For teams", body: "Shared inbox improvements." },
-      right: { title: "For agents", body: "API and MCP improvements." },
+      left: { title: "For teams", image_url: hero.url, image_fit: "natural" },
+      right: { title: "For agents", image_url: existingHero.url, image_fit: "contain" },
     },
   ],
 });
@@ -778,7 +780,7 @@ This is the recommended pattern for unit tests. No HTTP interception or mocking
 ## Links
 
 - [Shipmail docs](https://shipmail.to/docs)
-- [Quick start](https://shipmail.to/docs/quick-start)
+- [Quick start](https://shipmail.to/docs/api/quick-start)
 - [API reference](https://shipmail.to/docs/api)
 - [TypeScript SDK guide](https://shipmail.to/docs/sdks/typescript)
 - [`shipmail-mcp` (MCP server)](https://www.npmjs.com/package/shipmail-mcp)

package/dist/index.cjs

@@ -161,6 +161,18 @@ var InternalServerError = class extends ShipmailError {
     this.name = "InternalServerError";
   }
 };
+var ReconciliationRequiredError = class extends ShipmailError {
+  constructor(message, requestId, messageId) {
+    super(message, {
+      status: 409,
+      type: "reconciliation_required",
+      requestId,
+      retryable: false
+    });
+    this.name = "ReconciliationRequiredError";
+    this.messageId = messageId;
+  }
+};
 var ConnectionError = class extends ShipmailError {
   constructor(message) {
     super(message, { retryable: true });
@@ -191,6 +203,8 @@ function mapErrorFromResponse(status, body, requestId) {
       return new RateLimitError(error.message, { requestId: rid, retryAfter: error.retry_after });
     case "conflict":
       return new ConflictError(error.message, rid);
+    case "reconciliation_required":
+      return new ReconciliationRequiredError(error.message, rid, error.message_id);
     case "internal_error":
       return new InternalServerError(error.message, rid);
     default:
@@ -1685,7 +1699,7 @@ var Webhooks = class extends ApiResource {
 };
 
 // src/version.ts
-var VERSION = "0.5.2";
+var VERSION = "0.5.4";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -1862,6 +1876,8 @@ var WEBHOOK_EVENT_TYPES = [
   "message.bounced",
   "message.complained",
   "mailbox.rule_matched",
+  "mailbox.export.completed",
+  "mailbox.export.failed",
   "domain.verified",
   "domain.verification_failed",
   "domain.degraded",
@@ -1956,6 +1972,7 @@ exports.NotFoundError = NotFoundError;
 exports.Page = Page;
 exports.QuotaExceededError = QuotaExceededError;
 exports.RateLimitError = RateLimitError;
+exports.ReconciliationRequiredError = ReconciliationRequiredError;
 exports.ShipmailClient = ShipmailClient;
 exports.ShipmailError = ShipmailError;
 exports.ValidationError = ValidationError;