shipmail-cli 0.5.4 → 0.6.1

package/README.md

@@ -14,7 +14,7 @@ Most commands require an API key. Create one in the Shipmail dashboard and expor
 export SHIPMAIL_API_KEY="sm_live_..."
 ```
 
-You can also pass `--api-key` to any command. Use `SHIPMAIL_BASE_URL` or `--base-url` when targeting a non-production API. Approved partners can set `SHIPMAIL_ORGANIZATION_ID` or pass `--organization-id` for delegated infrastructure calls.
+You can also pass `--api-key` to any command. Use `SHIPMAIL_BASE_URL` or `--base-url` when targeting a non-production API.
 
 ## Common Commands
 
@@ -125,14 +125,6 @@ shipmail webhooks create \
   --events message.received,message.bounced
 shipmail webhooks deliveries whk_123 --status failed
 shipmail webhooks replay-delivery whk_123 dlv_123 --idempotency-key replay-123
-
-# Partner beta lifecycle and delegated infrastructure
-shipmail partner organizations create --name "Operator" --external-reference operator_123 --owner-email owner@example.com --mailbox-limit 3 --data-classification internal_test
-shipmail partner usage
-shipmail partner credential-grants list
-shipmail partner credential-grants consume grant_123 --name "Embedded webmail"
-shipmail domains list --organization-id 00000000-0000-4000-8000-000000000123
-shipmail mailboxes create --organization-id 00000000-0000-4000-8000-000000000123 --domain-id dom_123 --address support --generate-password
 ```
 
 Paragraph, quote, callout, list-item, and column bodies in `--blocks` accept bare text or
@@ -160,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`)
@@ -174,9 +167,10 @@ Use repeatable `--header "Name: value"` flags for request headers. Use `--output
 - `newsletter-domains list`
 - `newsletters create|update|preview|preflight|test-send|schedule|cancel|resume`
 - `newsletter-assets list|upload|register-url`
-- `partner organizations list|create|get|update|invite|suspend|resume|offboard`
-- `partner credential-grants list|consume`
-- `partner usage`
+
+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:
 

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.5.4";
+var VERSION = "0.6.1";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -166,9 +166,6 @@ function baseUrl(parsed, env) {
   if (!raw) return DEFAULT_BASE_URL;
   return validateBaseUrl(raw, env["SHIPMAIL_ALLOW_INSECURE_BASE_URL"] === "1");
 }
-function organizationId(parsed, env) {
-  return getString(parsed.options, "organization-id") ?? env["SHIPMAIL_ORGANIZATION_ID"];
-}
 function requireApiKey(parsed, env) {
   const key = apiKey(parsed, env);
   if (!key) {
@@ -181,7 +178,6 @@ function createClient(parsed, options) {
   const config = {
     apiKey: requireApiKey(parsed, env),
     baseUrl: baseUrl(parsed, env),
-    organizationId: organizationId(parsed, env),
     ...options.fetch ? { fetch: options.fetch } : {}
   };
   return new ShipmailClient(config);
@@ -281,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,
@@ -294,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) {
@@ -307,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");
@@ -325,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.");
@@ -358,10 +358,6 @@ async function rawApiRequest(parsed, runOptions, method, path, body, authRequire
     const key = apiKey(parsed, env);
     if (key) headers["Authorization"] = `Bearer ${key}`;
   }
-  const targetOrganizationId = organizationId(parsed, env);
-  if (targetOrganizationId) {
-    headers["X-Shipmail-Organization-Id"] = targetOrganizationId;
-  }
   let requestBody;
   if (body !== void 0) {
     headers["Content-Type"] = "application/json";
@@ -479,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
@@ -510,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]
@@ -520,17 +516,6 @@ Usage:
   shipmail booking-pages get <id>
   shipmail booking-pages update <id> [--name "..."] [--conferencing-provider zoom|google_meet|none] [--active false]
   shipmail booking-pages delete <id>
-  shipmail partner organizations list
-  shipmail partner organizations create --name "Operator" --external-reference op_123 --owner-email owner@example.com [--mailbox-limit 3] [--data-classification internal_test|customer]
-  shipmail partner organizations get <id>
-  shipmail partner organizations update <id> [--name "Operator"] [--mailbox-limit 5]
-  shipmail partner organizations invite <id> [--owner-email owner@example.com]
-  shipmail partner organizations suspend <id>
-  shipmail partner organizations resume <id>
-  shipmail partner organizations offboard <id>
-  shipmail partner credential-grants list
-  shipmail partner credential-grants consume <grant-id> [--name "Marketstead webmail"] [--expires-at 2026-10-01T00:00:00Z] [--allowed-cidr 203.0.113.0/24]
-  shipmail partner usage
 
 Booking page conferencing:
   --conferencing-provider <zoom|google_meet>  Create a meeting for every booking.
@@ -540,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.
 
@@ -552,7 +544,6 @@ Newsletter feeds:
 Global options:
   --api-key <key>       API key. Defaults to SHIPMAIL_API_KEY.
   --base-url <url>      API base URL. Defaults to SHIPMAIL_BASE_URL or ${DEFAULT_BASE_URL}.
-  --organization-id     Delegated child organization for supported infrastructure commands.
   --header "K: V"       Extra header for the generic api command. Repeatable.
 
 Environment:
@@ -560,7 +551,6 @@ Environment:
   SHIPMAIL_BASE_URL     Optional API base URL. Must be https on shipmail.to.
   SHIPMAIL_ALLOW_INSECURE_BASE_URL=1
                         Permit a non-https or non-shipmail.to base URL (development only).
-  SHIPMAIL_ORGANIZATION_ID  Optional delegated child organization ID.
 `;
 }
 function requirePositional(positional, index, label) {
@@ -2024,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));
@@ -2043,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));
@@ -2200,96 +2195,6 @@ async function runAutomations(client, parsed, out) {
   }
   throw new CliUsageError("Unknown automations command.");
 }
-async function runPartner(client, parsed, out) {
-  const group = parsed.positional[1];
-  if (group === "usage") {
-    writeJson(out, await client.partner.usage());
-    return;
-  }
-  if (group === "credential-grants") {
-    const command2 = requirePositional(parsed.positional, 2, "credential grant command");
-    if (command2 === "list") {
-      writeJson(out, await client.partner.listMailboxCredentialGrants());
-      return;
-    }
-    if (command2 !== "consume")
-      throw new CliUsageError("Unknown partner credential-grants command.");
-    const grantId = requirePositional(parsed.positional, 3, "credential grant id");
-    const name = getString(parsed.options, "name");
-    const expiresAt = getString(parsed.options, "expires-at");
-    const allowedCidrs = getStringList(parsed.options, "allowed-cidr");
-    writeJson(
-      out,
-      await client.partner.consumeMailboxCredentialGrant(grantId, {
-        ...name ? { name } : {},
-        ...expiresAt ? { expires_at: expiresAt } : {},
-        ...allowedCidrs.length > 0 ? { allowed_cidrs: allowedCidrs } : {}
-      })
-    );
-    return;
-  }
-  if (group !== "organizations") throw new CliUsageError("Unknown partner command.");
-  const command = parsed.positional[2];
-  if (command === "list") {
-    writeJson(out, await client.partner.listOrganizations());
-    return;
-  }
-  if (command === "create") {
-    const classification = getString(parsed.options, "data-classification") ?? "customer";
-    if (classification !== "internal_test" && classification !== "customer") {
-      throw new CliUsageError("--data-classification must be internal_test or customer.");
-    }
-    const params = {
-      name: getRequiredString(parsed.options, "name"),
-      external_reference: getRequiredString(parsed.options, "external-reference"),
-      owner_email: getRequiredString(parsed.options, "owner-email"),
-      mailbox_limit: getNumber(parsed.options, "mailbox-limit") ?? 3,
-      data_classification: classification
-    };
-    writeJson(out, await client.partner.createOrganization(params));
-    return;
-  }
-  const id = requirePositional(parsed.positional, 3, "partner organization id");
-  if (command === "get") {
-    writeJson(out, await client.partner.getOrganization(id));
-    return;
-  }
-  if (command === "update") {
-    const name = getString(parsed.options, "name");
-    const mailboxLimit = getNumber(parsed.options, "mailbox-limit");
-    if (name === void 0 && mailboxLimit === void 0) {
-      throw new CliUsageError("Provide --name or --mailbox-limit.");
-    }
-    const params = {
-      ...name !== void 0 ? { name } : {},
-      ...mailboxLimit !== void 0 ? { mailbox_limit: mailboxLimit } : {}
-    };
-    writeJson(out, await client.partner.updateOrganization(id, params));
-    return;
-  }
-  if (command === "invite") {
-    writeJson(
-      out,
-      await client.partner.resendOwnershipInvitation(id, {
-        owner_email: getString(parsed.options, "owner-email")
-      })
-    );
-    return;
-  }
-  if (command === "suspend") {
-    writeJson(out, await client.partner.suspendOrganization(id));
-    return;
-  }
-  if (command === "resume") {
-    writeJson(out, await client.partner.resumeOrganization(id));
-    return;
-  }
-  if (command === "offboard") {
-    writeJson(out, await client.partner.offboardOrganization(id));
-    return;
-  }
-  throw new CliUsageError("Unknown partner organizations command.");
-}
 function writeError(err, errOut) {
   if (err instanceof CliUsageError) {
     errOut.write(`Error: ${err.message}
@@ -2375,7 +2280,6 @@ async function runCli(argv, options = {}) {
     else if (command === "audiences") await runAudiences(client, parsed, out);
     else if (command === "calendar") await runCalendar(client, parsed, out);
     else if (command === "booking-pages") await runBookingPages(client, parsed, out);
-    else if (command === "partner") await runPartner(client, parsed, out);
     else throw new CliUsageError(`Unknown command: ${command}.`);
     return 0;
   } catch (err) {

package/package.json

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