shipmail-cli 0.6.0 → 0.6.1

package/README.md

@@ -152,6 +152,7 @@ Use repeatable `--header "Name: value"` flags for request headers. Use `--output
 - `api <METHOD> <PATH>`
 - `domains list|search|create|get|verify|delete`
 - `mailboxes list|create|get|suspend|resume|forwarding|forwarding-add|forwarding-remove|app-passwords|folders|identities|stage-attachment|prepare-attachment-upload`
+- `members list|get`
 - `inbox list|message|threads|thread|thread-state|draft|send-draft|reply-message|reply-thread|update|move`
 - `reply-scans create|status|results`
 - `messages send|list|analytics|get|reply` (test keys also support `--sandbox-outcome`)
@@ -167,6 +168,10 @@ Use repeatable `--header "Name: value"` flags for request headers. Use `--output
 - `newsletters create|update|preview|preflight|test-send|schedule|cancel|resume`
 - `newsletter-assets list|upload|register-url`
 
+Member output uses the roles `owner`, `admin`, and `member`. Its `mailbox_access.scope` is `all` or
+`selected`; `mailbox_ids` is empty for `all`, while selected IDs may be limited to mailboxes the
+API key can reach.
+
 Configure a publisher-owned Atom self URL and the number of recent issues:
 
 ```bash

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.6.0";
+var VERSION = "0.6.1";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -277,6 +277,7 @@ async function newsletterCreateParams(options) {
   const archive_visibility = parseArchiveVisibility(options);
   const feed_entry_url = getString(options, "feed-entry-url");
   const styling_mode = parseStylingMode(options);
+  const track_engagement = getBoolean(options, "track-engagement");
   const preview_text = getString(options, "preview-text");
   return {
     audience_id,
@@ -290,7 +291,8 @@ async function newsletterCreateParams(options) {
     ...send_window_hours !== void 0 ? { send_window_hours } : {},
     ...archive_visibility !== void 0 ? { archive_visibility } : {},
     ...feed_entry_url !== void 0 ? { feed_entry_url } : {},
-    ...styling_mode !== void 0 ? { styling_mode } : {}
+    ...styling_mode !== void 0 ? { styling_mode } : {},
+    ...track_engagement !== void 0 ? { track_engagement } : {}
   };
 }
 async function newsletterUpdateParams(options) {
@@ -303,6 +305,7 @@ async function newsletterUpdateParams(options) {
   const archive_visibility = parseArchiveVisibility(options);
   const feed_entry_url = getString(options, "feed-entry-url");
   const styling_mode = parseStylingMode(options);
+  const track_engagement = getBoolean(options, "track-engagement");
   const blocksInput = getString(options, "blocks");
   const bodyHtmlInput = getString(options, "body-html");
   const bodyTextInput = getString(options, "body-text");
@@ -321,7 +324,8 @@ async function newsletterUpdateParams(options) {
     ...send_window_hours !== void 0 ? { send_window_hours } : {},
     ...archive_visibility !== void 0 ? { archive_visibility } : {},
     ...feed_entry_url !== void 0 ? { feed_entry_url } : {},
-    ...styling_mode !== void 0 ? { styling_mode } : {}
+    ...styling_mode !== void 0 ? { styling_mode } : {},
+    ...track_engagement !== void 0 ? { track_engagement } : {}
   };
   if (Object.keys(params).length === 0) {
     throw new CliUsageError("Provide at least one field to update.");
@@ -471,8 +475,8 @@ Usage:
     --name "July changelog" \\
     --subject "What shipped in July" \\
     --blocks @blocks.json \\
-    [--feed-entry-url https://example.com/post] [--styling-mode styled|plain]
-  shipmail newsletters update nws_789 --subject "Updated subject" --blocks @blocks-v2.json [--feed-entry-url https://example.com/post] [--styling-mode styled|plain]
+    [--feed-entry-url https://example.com/post] [--styling-mode styled|plain] [--track-engagement true|false]
+  shipmail newsletters update nws_789 --subject "Updated subject" --blocks @blocks-v2.json [--feed-entry-url https://example.com/post] [--styling-mode styled|plain] [--track-engagement true|false]
   shipmail newsletters preview <id>
   shipmail newsletters preflight <id>
   shipmail newsletters test-send <id> --recipient-email owner@example.com
@@ -502,9 +506,9 @@ Usage:
   shipmail audiences subscribers resubscribe <audience-id> <subscriber-id> --consent-source "Signup form"
   shipmail audiences subscribers remove <audience-id> <subscriber-id>
   shipmail calendar events list --mailbox hello@example.com --from 2026-08-01T00:00:00Z --to 2026-08-08T00:00:00Z [--expand true] [--limit 100]
-  shipmail calendar events create --mailbox hello@example.com --title "Sync" --start 2026-08-01T14:00:00 [--timezone Europe/Paris] [--duration PT30M] [--invitation-language en|fr|es] [--attendees JSON|@file] [--reminders JSON|@file]
+  shipmail calendar events create --mailbox hello@example.com --title "Sync" --start 2026-08-01T14:00:00 [--timezone Europe/Paris] [--duration PT30M] [--invitation-language en|fr|es] [--attendees JSON|@file] [--reminders JSON|@file] [--operation-key key] [--send-invitations true|false]
   shipmail calendar events get <event-id> --mailbox hello@example.com
-  shipmail calendar events update <event-id> --mailbox hello@example.com [--title "..."] [--start ...] [--invitation-language en|fr|es]
+  shipmail calendar events update <event-id> --mailbox hello@example.com [--title "..."] [--start ...] [--invitation-language en|fr|es] [--operation-key key] [--expected-revision sha256] [--send-guest-updates true|false]
   shipmail calendar events delete <event-id> --mailbox hello@example.com
   shipmail calendar availability --mailbox hello@example.com --from 2026-08-03T00:00:00Z --to 2026-08-04T00:00:00Z [--duration 30] [--days 1,2,3,4,5] [--window-start 540] [--window-end 1020]
   shipmail booking-pages list [--limit 25] [--cursor cur]
@@ -521,9 +525,16 @@ Conversation IDs:
   <thread-id> accepts a conversation ID (thd_...) or the mail-server thread ID. Store the
   conversation_id every response carries. thread_id is deprecated and unchanged.
 
+Member access output:
+  role is owner, admin, or member. mailbox_access.scope is all or selected. mailbox_ids is empty
+  for all; selected IDs may be limited to mailboxes the API key can reach.
+
 Newsletter styling:
   --styling-mode <styled|plain>  styled applies Shipmail's email theme. plain sends your HTML without injected styles, width, or centering, so the reader's email client styles it.
 
+Newsletter tracking:
+  --track-engagement <true|false>  Track opens and clicks for this issue. Off by default. Changes only while the issue is a draft or scheduled for later.
+
 Newsletter block prose:
   Paragraph, quote, callout, list-item, and column bodies accept bare text or sanitized inline HTML. Use <p> and <br> for line breaks.
 
@@ -2003,6 +2014,8 @@ async function runCalendarEvents(client, parsed, out) {
       title: getRequiredString(options, "title"),
       start: getRequiredString(options, "start"),
       calendar_id: getString(options, "calendar-id"),
+      operation_key: getString(options, "operation-key"),
+      send_invitations: getBoolean(options, "send-invitations"),
       ...await calendarEventFields(options)
     };
     writeJson(out, await client.calendar.events.create(params));
@@ -2022,6 +2035,9 @@ async function runCalendarEvents(client, parsed, out) {
       mailbox: getRequiredString(options, "mailbox"),
       title: getString(options, "title"),
       start: getString(options, "start"),
+      operation_key: getString(options, "operation-key"),
+      expected_revision: getString(options, "expected-revision"),
+      send_guest_updates: getBoolean(options, "send-guest-updates"),
       ...await calendarEventFields(options)
     };
     writeJson(out, await client.calendar.events.update(id, params));

package/package.json

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