shipmail-cli 0.4.6 → 0.4.8

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.4.6";
+var VERSION = "0.4.8";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -185,6 +185,19 @@ function parseStylingMode(options) {
   if (value === "styled" || value === "plain") return value;
   throw new CliUsageError("--styling-mode must be styled or plain.");
 }
+async function automationDefinition(value) {
+  const parsed = await readJsonInput(value);
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new CliUsageError("--definition must be a JSON automation definition object.");
+  }
+  return parsed;
+}
+function automationStatus(options) {
+  const value = getString(options, "status");
+  if (value === void 0) return void 0;
+  if (value === "active" || value === "paused" || value === "disabled") return value;
+  throw new CliUsageError("--status must be active, paused, or disabled.");
+}
 async function newsletterCreateParams(options) {
   const audience_id = getRequiredString(options, "audience-id");
   const sender_identity_id = getRequiredString(options, "sender-identity-id");
@@ -201,6 +214,7 @@ async function newsletterCreateParams(options) {
   }
   const send_window_hours = getNumber(options, "send-window-hours");
   const archive_visibility = parseArchiveVisibility(options);
+  const feed_entry_url = getString(options, "feed-entry-url");
   const styling_mode = parseStylingMode(options);
   const preview_text = getString(options, "preview-text");
   return {
@@ -214,6 +228,7 @@ async function newsletterCreateParams(options) {
     ...body_text !== void 0 ? { body_text } : {},
     ...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 } : {}
   };
 }
@@ -225,6 +240,7 @@ async function newsletterUpdateParams(options) {
   const preview_text = getString(options, "preview-text");
   const send_window_hours = getNumber(options, "send-window-hours");
   const archive_visibility = parseArchiveVisibility(options);
+  const feed_entry_url = getString(options, "feed-entry-url");
   const styling_mode = parseStylingMode(options);
   const blocksInput = getString(options, "blocks");
   const bodyHtmlInput = getString(options, "body-html");
@@ -243,6 +259,7 @@ async function newsletterUpdateParams(options) {
     ...body_text !== void 0 ? { body_text } : {},
     ...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 } : {}
   };
   if (Object.keys(params).length === 0) {
@@ -324,6 +341,11 @@ Usage:
   shipmail status
   shipmail capabilities
   shipmail api <METHOD> <PATH> [--data JSON|@file] [--output file]
+  shipmail automations list
+  shipmail automations create --name "Daily brief" --definition JSON|@file [--idempotency-key key]
+  shipmail automations get <id>
+  shipmail automations update <id> [--name "..."] [--definition JSON|@file] [--status active|paused|disabled] [--idempotency-key key]
+  shipmail automations run <id> [--idempotency-key key]
   shipmail domains list [--limit 25] [--cursor cur]
   shipmail domains search <keyword>
   shipmail domains create <name>
@@ -384,8 +406,8 @@ Usage:
     --name "July changelog" \\
     --subject "What shipped in July" \\
     --blocks @blocks.json \\
-    [--styling-mode styled|plain]
-  shipmail newsletters update nws_789 --subject "Updated subject" --blocks @blocks-v2.json [--styling-mode styled|plain]
+    [--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]
   shipmail newsletters preview <id>
   shipmail newsletters preflight <id>
   shipmail newsletters test-send <id> --recipient-email owner@example.com
@@ -415,9 +437,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] [--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]
   shipmail calendar events get <event-id> --mailbox hello@example.com
-  shipmail calendar events update <event-id> --mailbox hello@example.com [--title "..."] [--start ...]
+  shipmail calendar events update <event-id> --mailbox hello@example.com [--title "..."] [--start ...] [--invitation-language en|fr|es]
   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]
@@ -444,6 +466,9 @@ Booking page conferencing:
 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 feeds:
+  --feed-entry-url <url>  Link this issue's Atom feed title to an http(s) URL instead of its Shipmail archive.
+
 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}.
@@ -1597,6 +1622,7 @@ var CALENDAR_EVENT_STATUSES = [
 ];
 var CALENDAR_FREE_BUSY_STATUSES = ["free", "busy"];
 var CALENDAR_PRIVACIES = ["public", "private", "secret"];
+var CALENDAR_INVITATION_LANGUAGES = ["en", "fr", "es"];
 function requireNumber(options, key) {
   const value = getNumber(options, key);
   if (value === void 0) throw new CliUsageError(`Missing --${key}.`);
@@ -1671,6 +1697,7 @@ async function calendarEventFields(options) {
   const status = getEnum(options, "status", CALENDAR_EVENT_STATUSES);
   const freeBusyStatus = getEnum(options, "free-busy-status", CALENDAR_FREE_BUSY_STATUSES);
   const privacy = getEnum(options, "privacy", CALENDAR_PRIVACIES);
+  const invitationLanguage = getEnum(options, "invitation-language", CALENDAR_INVITATION_LANGUAGES);
   const reminders = await readRemindersInput(getString(options, "reminders"));
   const attendees = await readAttendeesInput(getString(options, "attendees"));
   return {
@@ -1684,6 +1711,7 @@ async function calendarEventFields(options) {
     ...status !== void 0 ? { status } : {},
     ...freeBusyStatus !== void 0 ? { free_busy_status: freeBusyStatus } : {},
     ...privacy !== void 0 ? { privacy } : {},
+    ...invitationLanguage !== void 0 ? { invitation_language: invitationLanguage } : {},
     ...reminders !== void 0 ? { reminders } : {},
     ...attendees !== void 0 ? { attendees } : {}
   };
@@ -1839,6 +1867,53 @@ async function runBookingPages(client, parsed, out) {
   }
   throw new CliUsageError("Unknown booking-pages command.");
 }
+async function runAutomations(client, parsed, out) {
+  const subcommand = parsed.positional[1];
+  const idempotencyKey = getString(parsed.options, "idempotency-key");
+  const options = idempotencyKey ? { idempotencyKey } : void 0;
+  if (subcommand === "list") {
+    writeJson(out, await client.automations.list());
+    return;
+  }
+  if (subcommand === "create") {
+    writeJson(
+      out,
+      await client.automations.create(
+        {
+          name: getRequiredString(parsed.options, "name"),
+          definition: await automationDefinition(getRequiredString(parsed.options, "definition"))
+        },
+        options
+      )
+    );
+    return;
+  }
+  const id = requirePositional(parsed.positional, 2, "automation id");
+  if (subcommand === "get") {
+    writeJson(out, await client.automations.get(id));
+    return;
+  }
+  if (subcommand === "update") {
+    const name = getString(parsed.options, "name");
+    const definitionInput = getString(parsed.options, "definition");
+    const status = automationStatus(parsed.options);
+    const params = {
+      ...name !== void 0 ? { name } : {},
+      ...definitionInput !== void 0 ? { definition: await automationDefinition(definitionInput) } : {},
+      ...status !== void 0 ? { status } : {}
+    };
+    if (Object.keys(params).length === 0) {
+      throw new CliUsageError("Provide --name, --definition, or --status.");
+    }
+    writeJson(out, await client.automations.update(id, params, options));
+    return;
+  }
+  if (subcommand === "run") {
+    writeJson(out, await client.automations.run(id, options));
+    return;
+  }
+  throw new CliUsageError("Unknown automations command.");
+}
 async function runPartner(client, parsed, out) {
   const group = parsed.positional[1];
   if (group === "usage") {
@@ -1994,7 +2069,8 @@ async function runCli(argv, options = {}) {
       return 0;
     }
     const client = createClient(parsed, options);
-    if (command === "domains") await runDomains(client, parsed, out);
+    if (command === "automations") await runAutomations(client, parsed, out);
+    else if (command === "domains") await runDomains(client, parsed, out);
     else if (command === "mailboxes") await runMailboxes(client, parsed, out);
     else if (command === "inbox") await runInbox(client, parsed, out);
     else if (command === "messages") await runMessages(client, parsed, out);

package/package.json

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