shipmail-cli 0.5.1 → 0.5.3

package/README.md

@@ -89,6 +89,8 @@ shipmail inbox thread 550e8400-e29b-41d4-a716-446655440000 thr_123
 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
+# Save a new message to Drafts for a human to review and send; this never sends
+shipmail inbox compose-draft 550e8400-e29b-41d4-a716-446655440000 --to user@example.com --subject "Kickoff" --text "Draft for review"
 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"

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.5.1";
+var VERSION = "0.5.3";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -385,12 +385,13 @@ Usage:
   shipmail inbox thread <mailbox-id> <thread-id>
   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 compose-draft <mailbox-id> --to user@example.com [--cc ...] [--bcc ...] [--subject "Hi"] (--text "Hello" | --html "<p>Hello</p>") [--idempotency-key key]  (saves a new message to Drafts; never sends)
   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>") [--track-reply true|false]
   shipmail inbox reply-thread <mailbox-id> <thread-id> --to user@example.com (--text "Hello" | --html "<p>Hello</p>") [--track-reply true|false]
   shipmail inbox update <mailbox-id> <message-id> [--read true] [--starred false]
   shipmail inbox move <mailbox-id> <message-id> (--target-role archive | --target-folder-id fld)
-  shipmail messages send --mailbox-id mbx --to user@example.com --subject "Hi" --text "Hello" [--track-reply true|false] [--sandbox-outcome delivered|bounced|complained] [--client-reference crm-123] [--metadata JSON|@file] [--source-rfc-message-id '<crm-123@example.com>'] [--header 'X-CRM-ID: 123']
+  shipmail messages send (--mailbox-id mbx | --from 'Acme Support <hello@example.com>') --to user@example.com --subject "Hi" --text "Hello" [--track-reply true|false] [--sandbox-outcome delivered|bounced|complained] [--client-reference crm-123] [--metadata JSON|@file] [--source-rfc-message-id '<crm-123@example.com>'] [--header 'X-CRM-ID: 123']
   shipmail messages list (--mailbox-id mbx | --client-reference crm-123) [--limit 25] [--cursor cur]
   shipmail messages analytics [--updated-after ISO] [--updated-before ISO] [--limit 100] [--cursor cur]
   shipmail messages get <message-id>
@@ -1069,6 +1070,33 @@ async function runInbox(client, parsed, out) {
     );
     return;
   }
+  if (subcommand === "compose-draft") {
+    const to = messageRecipients(parsed.options, "to");
+    const cc = messageRecipients(parsed.options, "cc");
+    const bcc = messageRecipients(parsed.options, "bcc");
+    const subject = getString(parsed.options, "subject");
+    const text = await readTextInput(getString(parsed.options, "text"));
+    const html = await readTextInput(getString(parsed.options, "html"));
+    const idempotencyKey = getString(parsed.options, "idempotency-key");
+    if (to.length === 0) throw new CliUsageError("Provide at least one --to recipient.");
+    if (!text && !html) throw new CliUsageError("Provide --text or --html.");
+    writeJson(
+      out,
+      await client.mailboxes.createInboxDraft(
+        requirePositional(parsed.positional, 2, "mailbox id"),
+        {
+          to,
+          ...cc.length > 0 ? { cc } : {},
+          ...bcc.length > 0 ? { bcc } : {},
+          ...subject !== void 0 ? { subject } : {},
+          ...text ? { text } : {},
+          ...html ? { html } : {}
+        },
+        idempotencyKey ? { idempotencyKey } : void 0
+      )
+    );
+    return;
+  }
   if (subcommand === "send-draft") {
     writeJson(
       out,

package/package.json

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