shipmail-cli 0.4.10 → 0.4.11

package/README.md

@@ -84,12 +84,12 @@ shipmail mailboxes sandbox-inbound mbx_123 --from customer@example.com --subject
 # Read inbound mail
 shipmail inbox list 550e8400-e29b-41d4-a716-446655440000 --folder-role inbox --after 2025-07-20T00:00:00Z --limit 25
 shipmail inbox message 550e8400-e29b-41d4-a716-446655440000 eml_123
-shipmail inbox threads 550e8400-e29b-41d4-a716-446655440000 --reply-state needs_reply --after 2025-07-20T00:00:00Z --limit 50
+shipmail inbox threads 550e8400-e29b-41d4-a716-446655440000 --attention-state needs_reply --after 2025-07-20T00:00:00Z --limit 50
 shipmail inbox thread 550e8400-e29b-41d4-a716-446655440000 thr_123
-shipmail inbox draft 550e8400-e29b-41d4-a716-446655440000 thr_123 --expected-reply-version 7 --text "Thanks for the note"
+shipmail inbox draft 550e8400-e29b-41d4-a716-446655440000 thr_123 --expected-version 7 --text "Thanks for the note"
 # Apply your approval policy; stale drafts fail with 409 without delivery.
 shipmail inbox send-draft 550e8400-e29b-41d4-a716-446655440000 thr_123 drf_123
-shipmail inbox thread-state 550e8400-e29b-41d4-a716-446655440000 thr_123 --reply-state resolved --expected-reply-version 8
+shipmail inbox thread-attention 550e8400-e29b-41d4-a716-446655440000 thr_123 --done true --expected-version 8
 shipmail inbox reply-message 550e8400-e29b-41d4-a716-446655440000 eml_123 --to user@example.com --text "Thanks"
 shipmail inbox reply-thread 550e8400-e29b-41d4-a716-446655440000 thr_123 --to user@example.com --text "Following up"
 
@@ -114,6 +114,7 @@ shipmail newsletters preflight nws_123
 shipmail newsletters schedule nws_123 --scheduled-at 2026-08-01T09:00:00.000Z
 shipmail newsletter-assets list --kind image
 shipmail newsletter-assets upload ./hero.png --content-type image/png
+shipmail newsletter-assets upload ./demo.mp4 --content-type video/mp4 --thumbnail ./demo-poster.jpg
 shipmail newsletter-assets register-url https://cdn.shipmail.to/newsletter-images/org_123/hero.png
 
 # Manage webhooks
@@ -136,7 +137,9 @@ Paragraph, quote, callout, list-item, and column bodies in `--blocks` accept bar
 sanitized inline HTML. Use `<p>` and `<br>` for line breaks. Shipmail keeps `a`, `b`, `br`,
 `code`, `em`, `i`, `p`, `s`, `span`, `strong`, and `u`, with safe attributes and URLs.
 
-`newsletter-assets list` includes current newsletter media storage usage in the JSON response.
+`newsletter-assets upload` uses a five-minute direct storage PUT, then calls the single-use
+completion URL. Video uploads require a JPEG poster through `--thumbnail`. `newsletter-assets list`
+includes current newsletter media storage usage in the JSON response.
 
 ## Generic API Command
 

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.4.10";
+var VERSION = "0.4.11";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -374,10 +374,10 @@ Usage:
   shipmail mailboxes sandbox-inbound <id> --from sender@example.com --subject "Test" (--text "Hello" | --html "<p>Hello</p>") [--to support@example.com]
   shipmail inbox list <mailbox-id> [--folder-role inbox] [--search text] [--after ISO] [--before ISO] [--limit 25] [--cursor cur]
   shipmail inbox message <mailbox-id> <message-id>
-  shipmail inbox threads <mailbox-id> [--reply-state needs_reply] [--after ISO] [--before ISO] [--limit 25] [--cursor cur]
+  shipmail inbox threads <mailbox-id> [--attention-state needs_reply] [--after ISO] [--before ISO] [--limit 25] [--cursor cur]
   shipmail inbox thread <mailbox-id> <thread-id>
-  shipmail inbox thread-state <mailbox-id> <thread-id> --reply-state resolved --expected-reply-version 3
-  shipmail inbox draft <mailbox-id> <thread-id> --expected-reply-version 3 (--text "Hello" | --html "<p>Hello</p>") [--reply-mode reply_all]
+  shipmail inbox thread-attention <mailbox-id> <thread-id> --done true --expected-version 3
+  shipmail inbox draft <mailbox-id> <thread-id> --expected-version 3 (--text "Hello" | --html "<p>Hello</p>") [--reply-mode reply_all]
   shipmail inbox send-draft <mailbox-id> <thread-id> <draft-id>
   shipmail inbox reply-message <mailbox-id> <message-id> --to user@example.com (--text "Hello" | --html "<p>Hello</p>")
   shipmail inbox reply-thread <mailbox-id> <thread-id> --to user@example.com (--text "Hello" | --html "<p>Hello</p>")
@@ -415,7 +415,7 @@ Usage:
   shipmail newsletters cancel <id>
   shipmail newsletters resume <id>
   shipmail newsletter-assets list [--kind image|video] [--q text] [--limit 25] [--cursor cur]
-  shipmail newsletter-assets upload <file> [--filename name] [--content-type type]
+  shipmail newsletter-assets upload <file> [--filename name] [--content-type type] [--thumbnail poster.jpg]
   shipmail newsletter-assets register-url <url> [--filename name] [--thumbnail-url url]
   shipmail newsletter-sender-identities list [--limit 25] [--cursor cur]
   shipmail newsletter-domains list [--limit 25] [--cursor cur]
@@ -912,7 +912,7 @@ async function runInbox(client, parsed, out) {
     return;
   }
   if (subcommand === "threads") {
-    const replyState = getString(parsed.options, "reply-state");
+    const attentionState = getString(parsed.options, "attention-state");
     const sortBy = getString(parsed.options, "sort-by");
     const order = getString(parsed.options, "order");
     writeJson(
@@ -920,8 +920,8 @@ async function runInbox(client, parsed, out) {
       await client.mailboxes.listInboxThreads(
         requirePositional(parsed.positional, 2, "mailbox id"),
         {
-          ...replyState ? {
-            reply_state: replyState
+          ...attentionState ? {
+            attention_state: attentionState
           } : {},
           ...sortBy ? { sort_by: sortBy } : {},
           ...order ? { order } : {},
@@ -934,29 +934,31 @@ async function runInbox(client, parsed, out) {
     );
     return;
   }
-  if (subcommand === "thread-state") {
-    const replyState = getString(parsed.options, "reply-state");
-    const expectedReplyVersion = getNumber(parsed.options, "expected-reply-version");
-    if (!replyState || expectedReplyVersion === void 0) {
-      throw new CliUsageError("Provide --reply-state and --expected-reply-version.");
+  if (subcommand === "thread-attention") {
+    const done = getBoolean(parsed.options, "done");
+    const followUpAt = getString(parsed.options, "follow-up-at");
+    const expectedVersion = getNumber(parsed.options, "expected-version");
+    if (done === void 0 && followUpAt === void 0 || expectedVersion === void 0) {
+      throw new CliUsageError("Provide --done or --follow-up-at, and provide --expected-version.");
     }
     writeJson(
       out,
-      await client.mailboxes.updateInboxThreadReplyState(
+      await client.mailboxes.updateInboxThreadAttention(
         requirePositional(parsed.positional, 2, "mailbox id"),
         requirePositional(parsed.positional, 3, "thread id"),
         {
-          reply_state: replyState,
-          expected_reply_version: expectedReplyVersion
+          ...done === void 0 ? {} : { done },
+          ...followUpAt === void 0 ? {} : { follow_up_at: followUpAt === "null" ? null : followUpAt },
+          expected_version: expectedVersion
         }
       )
     );
     return;
   }
   if (subcommand === "draft") {
-    const expectedReplyVersion = getNumber(parsed.options, "expected-reply-version");
-    if (expectedReplyVersion === void 0) {
-      throw new CliUsageError("Provide --expected-reply-version.");
+    const expectedVersion = getNumber(parsed.options, "expected-version");
+    if (expectedVersion === void 0) {
+      throw new CliUsageError("Provide --expected-version.");
     }
     const text = await readTextInput(getString(parsed.options, "text"));
     const html = await readTextInput(getString(parsed.options, "html"));
@@ -967,7 +969,7 @@ async function runInbox(client, parsed, out) {
         requirePositional(parsed.positional, 2, "mailbox id"),
         requirePositional(parsed.positional, 3, "thread id"),
         {
-          expected_reply_version: expectedReplyVersion,
+          expected_version: expectedVersion,
           ...text ? { text } : {},
           ...html ? { html } : {},
           ...getString(parsed.options, "reply-mode") ? { reply_mode: getString(parsed.options, "reply-mode") } : {}
@@ -1574,7 +1576,7 @@ async function runNewsletters(client, parsed, out) {
   }
   throw new CliUsageError("Unknown newsletters command.");
 }
-async function runNewsletterAssets(client, parsed, out) {
+async function runNewsletterAssets(client, parsed, out, fetchImpl) {
   const subcommand = parsed.positional[1];
   if (subcommand === "list") {
     const kind = getString(parsed.options, "kind");
@@ -1595,14 +1597,37 @@ async function runNewsletterAssets(client, parsed, out) {
   if (subcommand === "upload") {
     const filePath = requirePositional(parsed.positional, 2, "file");
     const data = await readFile(realpathSync(filePath));
-    writeJson(
-      out,
-      await client.newsletters.assets.upload({
-        filename: getString(parsed.options, "filename") ?? filePath.split(/[\\/]/).at(-1) ?? "newsletter-asset",
-        data,
-        content_type: getString(parsed.options, "content-type")
-      })
-    );
+    const filename = getString(parsed.options, "filename") ?? filePath.split(/[\\/]/).at(-1) ?? "newsletter-asset";
+    const contentType = newsletterAssetContentType(
+      filePath,
+      getString(parsed.options, "content-type")
+    );
+    const thumbnail = contentType.startsWith("video/") ? await readNewsletterVideoThumbnail(parsed.options) : void 0;
+    const prepared = await client.newsletters.assets.prepareUpload({
+      filename,
+      content_type: contentType,
+      size: data.byteLength,
+      sha256: createHash("sha256").update(data).digest("hex")
+    });
+    await putPreparedNewsletterBytes(fetchImpl, prepared.upload_url, prepared.upload_headers, data);
+    if (prepared.kind === "video") {
+      if (!thumbnail) throw new CliUsageError("Video uploads require --thumbnail <jpeg-file>.");
+      await putPreparedNewsletterBytes(
+        fetchImpl,
+        prepared.thumbnail_upload_url,
+        prepared.thumbnail_upload_headers,
+        thumbnail
+      );
+    }
+    const completion = await fetchImpl(prepared.complete_url, {
+      method: prepared.complete_method,
+      redirect: "error"
+    });
+    if (!completion.ok) {
+      throw new CliHttpError(completion.status, { response: await completion.text() });
+    }
+    const asset = await completion.json();
+    writeJson(out, asset);
     return;
   }
   if (subcommand === "register-url") {
@@ -1618,6 +1643,55 @@ async function runNewsletterAssets(client, parsed, out) {
   }
   throw new CliUsageError("Unknown newsletter-assets command.");
 }
+function newsletterAssetContentType(filePath, declared) {
+  const value = declared?.trim().toLowerCase() ?? "";
+  switch (value) {
+    case "image/gif":
+    case "image/jpeg":
+    case "image/png":
+    case "image/webp":
+    case "video/mp4":
+    case "video/quicktime":
+    case "video/webm":
+      return value;
+    default:
+      if (value) throw new CliUsageError("Unsupported newsletter asset content type.");
+  }
+  const lowerPath = filePath.toLowerCase();
+  if (lowerPath.endsWith(".gif")) return "image/gif";
+  if (lowerPath.endsWith(".jpg") || lowerPath.endsWith(".jpeg")) return "image/jpeg";
+  if (lowerPath.endsWith(".png")) return "image/png";
+  if (lowerPath.endsWith(".webp")) return "image/webp";
+  if (lowerPath.endsWith(".mp4")) return "video/mp4";
+  if (lowerPath.endsWith(".mov")) return "video/quicktime";
+  if (lowerPath.endsWith(".webm")) return "video/webm";
+  throw new CliUsageError("Use --content-type for this newsletter asset file.");
+}
+async function readNewsletterVideoThumbnail(options) {
+  const thumbnailPath = getString(options, "thumbnail");
+  if (!thumbnailPath) throw new CliUsageError("Video uploads require --thumbnail <jpeg-file>.");
+  const bytes = await readFile(realpathSync(thumbnailPath));
+  if (bytes.byteLength < 3 || bytes[0] !== 255 || bytes[1] !== 216 || bytes[2] !== 255) {
+    throw new CliUsageError("--thumbnail must be a JPEG file.");
+  }
+  return bytes;
+}
+function uploadBody(bytes) {
+  const body = new ArrayBuffer(bytes.byteLength);
+  new Uint8Array(body).set(bytes);
+  return body;
+}
+async function putPreparedNewsletterBytes(fetchImpl, url, headers, bytes) {
+  const response = await fetchImpl(url, {
+    method: "PUT",
+    headers,
+    body: uploadBody(bytes),
+    redirect: "error"
+  });
+  if (!response.ok) {
+    throw new CliHttpError(response.status, { response: await response.text() });
+  }
+}
 var CALENDAR_EVENT_STATUSES = [
   "confirmed",
   "tentative",
@@ -2082,7 +2156,8 @@ async function runCli(argv, options = {}) {
     else if (command === "webhooks") await runWebhooks(client, parsed, out);
     else if (command === "suppressions") await runSuppressions(client, parsed, out);
     else if (command === "newsletters") await runNewsletters(client, parsed, out);
-    else if (command === "newsletter-assets") await runNewsletterAssets(client, parsed, out);
+    else if (command === "newsletter-assets")
+      await runNewsletterAssets(client, parsed, out, options.fetch ?? globalThis.fetch);
     else if (command === "newsletter-sender-identities")
       await runNewsletterSenderIdentities(client, parsed, out);
     else if (command === "newsletter-domains") await runNewsletterDomains(client, parsed, out);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail-cli",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "description": "Official CLI for the Shipmail API",
   "type": "module",
   "bin": {
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "dependencies": {
-    "shipmail": "0.4.16"
+    "shipmail": "0.4.17"
   },
   "devDependencies": {
     "tsup": "^8.4.0",