shipmail-cli 0.4.0 → 0.4.2

package/README.md

@@ -34,6 +34,7 @@ shipmail mailboxes resume mbx_123
 shipmail mailboxes forwarding-add mbx_123 --destination owner@example.net
 shipmail mailboxes forwarding mbx_123
 shipmail mailboxes forwarding-remove mbx_123 fwd_123
+shipmail mailboxes rules mbx_123
 shipmail mailboxes app-passwords list mbx_123
 shipmail mailboxes app-passwords create mbx_123 --name "Desktop mail" --expires-at 2026-10-01T00:00:00Z
 shipmail mailboxes app-passwords revoke mbx_123 appwd_123
@@ -158,6 +159,9 @@ Use repeatable `--header "Name: value"` flags for request headers. Use `--output
 - `mailboxes sandbox-inbound`
 - `webhooks list|create|test|deliveries|replay-delivery`
 - `suppressions list|remove`
+- `audiences list|create|get|update|delete`
+- `audiences feed get|update|rotate|revoke`
+- `audiences subscribers add|list|get|by-email|update|unsubscribe|resubscribe|remove`
 - `newsletter-domains list`
 - `newsletters create|update|preview|preflight|test-send|schedule|cancel|resume`
 - `newsletter-assets list|upload|register-url`

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.4.0";
+var VERSION = "0.4.2";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -179,6 +179,12 @@ function parseArchiveVisibility(options) {
   if (value === "private" || value === "public") return value;
   throw new CliUsageError("--archive-visibility must be private or public.");
 }
+function parseStylingMode(options) {
+  const value = getString(options, "styling-mode");
+  if (value === void 0) return void 0;
+  if (value === "styled" || value === "plain") return value;
+  throw new CliUsageError("--styling-mode must be styled or plain.");
+}
 async function newsletterCreateParams(options) {
   const audience_id = getRequiredString(options, "audience-id");
   const newsletter_domain_id = getRequiredString(options, "newsletter-domain-id");
@@ -195,6 +201,7 @@ async function newsletterCreateParams(options) {
   }
   const send_window_hours = getNumber(options, "send-window-hours");
   const archive_visibility = parseArchiveVisibility(options);
+  const styling_mode = parseStylingMode(options);
   const preview_text = getString(options, "preview-text");
   const from_name = getString(options, "from-name");
   return {
@@ -208,7 +215,8 @@ async function newsletterCreateParams(options) {
     ...body_html !== void 0 ? { body_html } : {},
     ...body_text !== void 0 ? { body_text } : {},
     ...send_window_hours !== void 0 ? { send_window_hours } : {},
-    ...archive_visibility !== void 0 ? { archive_visibility } : {}
+    ...archive_visibility !== void 0 ? { archive_visibility } : {},
+    ...styling_mode !== void 0 ? { styling_mode } : {}
   };
 }
 async function newsletterUpdateParams(options) {
@@ -220,6 +228,7 @@ async function newsletterUpdateParams(options) {
   const from_name = getString(options, "from-name");
   const send_window_hours = getNumber(options, "send-window-hours");
   const archive_visibility = parseArchiveVisibility(options);
+  const styling_mode = parseStylingMode(options);
   const blocksInput = getString(options, "blocks");
   const bodyHtmlInput = getString(options, "body-html");
   const bodyTextInput = getString(options, "body-text");
@@ -237,7 +246,8 @@ async function newsletterUpdateParams(options) {
     ...body_html !== void 0 ? { body_html } : {},
     ...body_text !== void 0 ? { body_text } : {},
     ...send_window_hours !== void 0 ? { send_window_hours } : {},
-    ...archive_visibility !== void 0 ? { archive_visibility } : {}
+    ...archive_visibility !== void 0 ? { archive_visibility } : {},
+    ...styling_mode !== void 0 ? { styling_mode } : {}
   };
   if (Object.keys(params).length === 0) {
     throw new CliUsageError("Provide at least one field to update.");
@@ -337,6 +347,7 @@ Usage:
   shipmail mailboxes app-passwords revoke <id> <app-password-id>
   shipmail mailboxes folders <id>
   shipmail mailboxes identities <id>
+  shipmail mailboxes rules <id>
   shipmail mailboxes forwarding <id>
   shipmail mailboxes forwarding-add <id> --destination owner@example.com
   shipmail mailboxes forwarding-remove <id> <forwarding-id>
@@ -375,8 +386,9 @@ Usage:
     --newsletter-domain-id nwsdom_456 \\
     --name "July changelog" \\
     --subject "What shipped in July" \\
-    --blocks @blocks.json
-  shipmail newsletters update nws_789 --subject "Updated subject" --blocks @blocks-v2.json
+    --blocks @blocks.json \\
+    [--styling-mode styled|plain]
+  shipmail newsletters update nws_789 --subject "Updated subject" --blocks @blocks-v2.json [--styling-mode styled|plain]
   shipmail newsletters preview <id>
   shipmail newsletters preflight <id>
   shipmail newsletters test-send <id> --recipient-email owner@example.com
@@ -392,6 +404,10 @@ Usage:
   shipmail audiences get <id>
   shipmail audiences update <id> [--name "..."] [--description "..."]
   shipmail audiences delete <id>
+  shipmail audiences feed get <audience-id>
+  shipmail audiences feed update <audience-id> [--enabled true|false] [--title "..."] [--subtitle "..."] [--site-url https://...] [--author-name "..."] [--icon-url https://...] [--idempotency-key key]
+  shipmail audiences feed rotate <audience-id> [--idempotency-key key]
+  shipmail audiences feed revoke <audience-id> [--idempotency-key key]
   shipmail audiences subscribers add <audience-id> <email> [--name "Jane"] [--consent-source "..."]
   shipmail audiences subscribers list <audience-id> [--status subscribed] [--email jane@x.com] [--limit 25]
   shipmail audiences subscribers get <audience-id> <subscriber-id>
@@ -427,6 +443,9 @@ Booking page conferencing:
   --conferencing-provider <zoom|google_meet>  Create a meeting for every booking.
   --conferencing-provider none                Stop creating meeting links on update.
 
+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.
+
 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}.
@@ -744,6 +763,13 @@ async function runMailboxes(client, parsed, out) {
     );
     return;
   }
+  if (subcommand === "rules") {
+    writeJson(
+      out,
+      await client.mailboxes.getRules(requirePositional(parsed.positional, 2, "mailbox id"))
+    );
+    return;
+  }
   if (subcommand === "forwarding") {
     writeJson(
       out,
@@ -1304,12 +1330,65 @@ async function runSubscribers(client, parsed, out) {
   }
   throw new CliUsageError("Unknown audiences subscribers command.");
 }
+function audienceFeedUpdateParams(options) {
+  const enabled = getBoolean(options, "enabled");
+  const title = getString(options, "title");
+  const subtitle = getString(options, "subtitle");
+  const siteUrl = getString(options, "site-url");
+  const authorName = getString(options, "author-name");
+  const iconUrl = getString(options, "icon-url");
+  if (enabled === void 0 && title === void 0 && subtitle === void 0 && siteUrl === void 0 && authorName === void 0 && iconUrl === void 0) {
+    throw new CliUsageError("Provide at least one feed setting to update.");
+  }
+  return {
+    ...enabled !== void 0 ? { enabled } : {},
+    ...title !== void 0 ? { title } : {},
+    ...subtitle !== void 0 ? { subtitle } : {},
+    ...siteUrl !== void 0 ? { site_url: siteUrl } : {},
+    ...authorName !== void 0 ? { author_name: authorName } : {},
+    ...iconUrl !== void 0 ? { icon_url: iconUrl } : {}
+  };
+}
+async function runAudienceFeed(client, parsed, out) {
+  const action = parsed.positional[2];
+  const audienceId = requirePositional(parsed.positional, 3, "audience id");
+  if (action === "get") {
+    writeJson(out, await client.audiences.feeds.get(audienceId));
+    return;
+  }
+  const idempotencyKey = getString(parsed.options, "idempotency-key");
+  const methodOptions = idempotencyKey ? { idempotencyKey } : void 0;
+  if (action === "update") {
+    writeJson(
+      out,
+      await client.audiences.feeds.update(
+        audienceId,
+        audienceFeedUpdateParams(parsed.options),
+        methodOptions
+      )
+    );
+    return;
+  }
+  if (action === "rotate") {
+    writeJson(out, await client.audiences.feeds.rotate(audienceId, methodOptions));
+    return;
+  }
+  if (action === "revoke") {
+    writeJson(out, await client.audiences.feeds.revoke(audienceId, methodOptions));
+    return;
+  }
+  throw new CliUsageError("Unknown audiences feed command.");
+}
 async function runAudiences(client, parsed, out) {
   const subcommand = parsed.positional[1];
   if (subcommand === "subscribers") {
     await runSubscribers(client, parsed, out);
     return;
   }
+  if (subcommand === "feed") {
+    await runAudienceFeed(client, parsed, out);
+    return;
+  }
   if (subcommand === "list") {
     writeJson(
       out,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail-cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Official CLI for the ShipMail API",
   "type": "module",
   "bin": {
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "dependencies": {
-    "shipmail": "0.4.1"
+    "shipmail": "0.4.6"
   },
   "devDependencies": {
     "tsup": "^8.4.0",