shipmail-cli 0.4.1 → 0.4.4

package/README.md

@@ -97,11 +97,11 @@ shipmail reply-scans create --mailbox-id 550e8400-e29b-41d4-a716-446655440000 --
 shipmail reply-scans status rsc_123
 shipmail reply-scans results rsc_123 --limit 100
 
-# Find newsletter sending domain IDs, then create a draft with blocks
-shipmail newsletter-domains list
+# Find reusable sender identity IDs, then create a draft with blocks
+shipmail newsletter-sender-identities list
 shipmail newsletters create \
   --audience-id aud_123 \
-  --newsletter-domain-id nwsdom_456 \
+  --sender-identity-id nwsid_456 \
   --name "July changelog" \
   --subject "What shipped in July" \
   --blocks @blocks.json
@@ -159,6 +159,10 @@ 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-sender-identities list`
 - `newsletter-domains list`
 - `newsletters create|update|preview|preflight|test-send|schedule|cancel|resume`
 - `newsletter-assets list|upload|register-url`
@@ -166,4 +170,12 @@ Use repeatable `--header "Name: value"` flags for request headers. Use `--output
 - `partner credential-grants list|consume`
 - `partner usage`
 
+Configure a publisher-owned Atom self URL and the number of recent issues:
+
+```bash
+shipmail audiences feed update aud_123 \
+  --canonical-url https://example.com/feed.xml \
+  --entry-limit 25
+```
+
 Run `shipmail --help` for flags and examples.

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.4.1";
+var VERSION = "0.4.4";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -187,7 +187,7 @@ function parseStylingMode(options) {
 }
 async function newsletterCreateParams(options) {
   const audience_id = getRequiredString(options, "audience-id");
-  const newsletter_domain_id = getRequiredString(options, "newsletter-domain-id");
+  const sender_identity_id = getRequiredString(options, "sender-identity-id");
   const name = getRequiredString(options, "name");
   const subject = getRequiredString(options, "subject");
   const blocksInput = getString(options, "blocks");
@@ -203,14 +203,12 @@ async function newsletterCreateParams(options) {
   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 {
     audience_id,
-    newsletter_domain_id,
+    sender_identity_id,
     name,
     subject,
     ...preview_text !== void 0 ? { preview_text } : {},
-    ...from_name !== void 0 ? { from_name } : {},
     ...blocks ? { blocks } : {},
     ...body_html !== void 0 ? { body_html } : {},
     ...body_text !== void 0 ? { body_text } : {},
@@ -221,11 +219,10 @@ async function newsletterCreateParams(options) {
 }
 async function newsletterUpdateParams(options) {
   const audience_id = getString(options, "audience-id");
-  const newsletter_domain_id = getString(options, "newsletter-domain-id");
+  const sender_identity_id = getString(options, "sender-identity-id");
   const name = getString(options, "name");
   const subject = getString(options, "subject");
   const preview_text = getString(options, "preview-text");
-  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);
@@ -237,11 +234,10 @@ async function newsletterUpdateParams(options) {
   const body_text = bodyTextInput ? await readTextInput(bodyTextInput) : void 0;
   const params = {
     ...audience_id ? { audience_id } : {},
-    ...newsletter_domain_id ? { newsletter_domain_id } : {},
+    ...sender_identity_id ? { sender_identity_id } : {},
     ...name ? { name } : {},
     ...subject ? { subject } : {},
     ...preview_text !== void 0 ? { preview_text } : {},
-    ...from_name !== void 0 ? { from_name } : {},
     ...blocks ? { blocks } : {},
     ...body_html !== void 0 ? { body_html } : {},
     ...body_text !== void 0 ? { body_text } : {},
@@ -383,7 +379,7 @@ Usage:
   shipmail suppressions remove <email>
   shipmail newsletters create \\
     --audience-id aud_123 \\
-    --newsletter-domain-id nwsdom_456 \\
+    --sender-identity-id nwsid_456 \\
     --name "July changelog" \\
     --subject "What shipped in July" \\
     --blocks @blocks.json \\
@@ -398,12 +394,17 @@ Usage:
   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 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]
   shipmail audiences list [--limit 25] [--cursor cur]
   shipmail audiences create <name> --consent-source "Signup form" [--description "..."]
   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://...] [--canonical-url https://...] [--author-name "..."] [--icon-url https://...] [--entry-limit 10..100] [--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>
@@ -1326,12 +1327,72 @@ 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 canonicalUrl = getString(options, "canonical-url");
+  const authorName = getString(options, "author-name");
+  const iconUrl = getString(options, "icon-url");
+  const entryLimit = getNumber(options, "entry-limit");
+  if (entryLimit !== void 0 && (entryLimit < 10 || entryLimit > 100)) {
+    throw new CliUsageError("--entry-limit must be between 10 and 100.");
+  }
+  if (enabled === void 0 && title === void 0 && subtitle === void 0 && siteUrl === void 0 && canonicalUrl === void 0 && authorName === void 0 && iconUrl === void 0 && entryLimit === 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 } : {},
+    ...canonicalUrl !== void 0 ? { canonical_url: canonicalUrl } : {},
+    ...authorName !== void 0 ? { author_name: authorName } : {},
+    ...iconUrl !== void 0 ? { icon_url: iconUrl } : {},
+    ...entryLimit !== void 0 ? { entry_limit: entryLimit } : {}
+  };
+}
+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,
@@ -1396,6 +1457,20 @@ async function runNewsletterDomains(client, parsed, out) {
   }
   throw new CliUsageError("Unknown newsletter-domains command.");
 }
+async function runNewsletterSenderIdentities(client, parsed, out) {
+  const subcommand = parsed.positional[1];
+  if (subcommand === "list") {
+    writeJson(
+      out,
+      await client.newsletters.senderIdentities.list({
+        cursor: getString(parsed.options, "cursor"),
+        limit: getNumber(parsed.options, "limit")
+      })
+    );
+    return;
+  }
+  throw new CliUsageError("Unknown newsletter-sender-identities command.");
+}
 async function runNewsletters(client, parsed, out) {
   const subcommand = parsed.positional[1];
   if (subcommand === "create") {
@@ -1916,6 +1991,8 @@ async function runCli(argv, options = {}) {
     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-sender-identities")
+      await runNewsletterSenderIdentities(client, parsed, out);
     else if (command === "newsletter-domains") await runNewsletterDomains(client, parsed, out);
     else if (command === "audiences") await runAudiences(client, parsed, out);
     else if (command === "calendar") await runCalendar(client, parsed, out);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail-cli",
-  "version": "0.4.1",
+  "version": "0.4.4",
   "description": "Official CLI for the ShipMail API",
   "type": "module",
   "bin": {
@@ -31,7 +31,7 @@
   "homepage": "https://shipmail.to/docs/cli",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jcoulaud/ShipMail.git",
+    "url": "git+https://github.com/shipmail-to/Shipmail.git",
     "directory": "packages/shipmail-cli"
   },
   "engines": {
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "dependencies": {
-    "shipmail": "0.4.4"
+    "shipmail": "0.4.9"
   },
   "devDependencies": {
     "tsup": "^8.4.0",