shipmail-cli 0.1.5 → 0.1.7

package/README.md

@@ -55,6 +55,7 @@ shipmail newsletters preflight nws_123
 shipmail newsletters schedule nws_123 --scheduled-at 2026-08-01T09:00:00.000Z
 shipmail newsletter-assets list --kind image
 shipmail newsletter-assets upload ./hero.png --content-type image/png
+shipmail newsletter-assets register-url https://cdn.shipmail.to/newsletter-images/org_123/hero.png
 
 # Manage webhooks
 shipmail webhooks create \
@@ -63,6 +64,8 @@ shipmail webhooks create \
 shipmail webhooks deliveries whk_123 --status failed
 ```
 
+`newsletter-assets list` includes current newsletter media storage usage in the JSON response.
+
 ## Generic API Command
 
 The `api` command reaches every Shipmail REST endpoint, including endpoints that do not have a shorthand command yet.
@@ -91,6 +94,6 @@ Use repeatable `--header "Name: value"` flags for request headers. Use `--output
 - `suppressions list|remove`
 - `newsletter-domains list`
 - `newsletters create|update|preview|preflight|test-send|schedule|cancel|resume`
-- `newsletter-assets list|upload`
+- `newsletter-assets list|upload|register-url`
 
 Run `shipmail --help` for flags and examples.

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
 } from "shipmail";
 
 // src/version.ts
-var VERSION = "0.1.5";
+var VERSION = "0.1.7";
 
 // src/cli.ts
 var DEFAULT_BASE_URL = "https://shipmail.to/api/v1";
@@ -343,6 +343,7 @@ Usage:
   shipmail newsletters resume <id>
   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-domains list [--limit 25] [--cursor cur]
   shipmail audiences list [--limit 25] [--cursor cur]
   shipmail audiences create <name> --consent-source "Signup form" [--description "..."]
@@ -355,7 +356,19 @@ Usage:
   shipmail audiences subscribers by-email <audience-id> <email>
   shipmail audiences subscribers update <audience-id> <subscriber-id> [--name "..."]
   shipmail audiences subscribers unsubscribe <audience-id> <subscriber-id>
+  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] [--all-day true] [--location "HQ"] [--video-url https://...] [--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 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]
+  shipmail booking-pages create --name "Intro" --mailbox hello@example.com --slug intro --duration-minutes 30 --availability-days 1,2,3,4,5 --window-start-minutes 540 --window-end-minutes 1020 --timezone America/New_York
+  shipmail booking-pages get <id>
+  shipmail booking-pages update <id> [--name "..."] [--active false]
+  shipmail booking-pages delete <id>
 
 Global options:
   --api-key <key>       API key. Defaults to SHIPMAIL_API_KEY.
@@ -777,6 +790,17 @@ async function runSubscribers(client, parsed, out) {
     );
     return;
   }
+  if (action === "resubscribe") {
+    writeJson(
+      out,
+      await client.audiences.subscribers.resubscribe(
+        audienceId,
+        requirePositional(parsed.positional, 4, "subscriber id"),
+        { consent_source: getRequiredString(parsed.options, "consent-source") }
+      )
+    );
+    return;
+  }
   if (action === "remove") {
     const subscriberId = requirePositional(parsed.positional, 4, "subscriber id");
     await client.audiences.subscribers.remove(audienceId, subscriberId);
@@ -948,8 +972,242 @@ async function runNewsletterAssets(client, parsed, out) {
     );
     return;
   }
+  if (subcommand === "register-url") {
+    writeJson(
+      out,
+      await client.newsletters.assets.registerFromUrl({
+        url: requirePositional(parsed.positional, 2, "url"),
+        filename: getString(parsed.options, "filename"),
+        thumbnail_url: getString(parsed.options, "thumbnail-url")
+      })
+    );
+    return;
+  }
   throw new CliUsageError("Unknown newsletter-assets command.");
 }
+var CALENDAR_EVENT_STATUSES = [
+  "confirmed",
+  "tentative",
+  "cancelled"
+];
+var CALENDAR_FREE_BUSY_STATUSES = ["free", "busy"];
+var CALENDAR_PRIVACIES = ["public", "private", "secret"];
+function requireNumber(options, key) {
+  const value = getNumber(options, key);
+  if (value === void 0) throw new CliUsageError(`Missing --${key}.`);
+  return value;
+}
+function getIntList(options, key) {
+  return getStringList(options, key).map((raw) => {
+    const value = Number(raw);
+    if (!Number.isInteger(value)) {
+      throw new CliUsageError(`--${key} must be a comma-separated list of integers.`);
+    }
+    return value;
+  });
+}
+function requireIntList(options, key) {
+  const values = getIntList(options, key);
+  if (values.length === 0) throw new CliUsageError(`Missing --${key}.`);
+  return values;
+}
+function getEnum(options, key, allowed) {
+  const value = getString(options, key);
+  if (value === void 0) return void 0;
+  const match = allowed.find((candidate) => candidate === value);
+  if (match === void 0) {
+    throw new CliUsageError(`--${key} must be one of: ${allowed.join(", ")}.`);
+  }
+  return match;
+}
+function isReminderArray(value) {
+  return Array.isArray(value) && value.every(
+    (item) => typeof item === "object" && item !== null && !Array.isArray(item) && Number.isInteger(item.minutes_before)
+  );
+}
+async function readRemindersInput(value) {
+  const parsed = await readJsonInput(value);
+  if (parsed === void 0) return void 0;
+  if (!isReminderArray(parsed)) {
+    throw new CliUsageError("--reminders must be a JSON array of { minutes_before } objects.");
+  }
+  return parsed;
+}
+async function calendarEventFields(options) {
+  const description = getString(options, "description");
+  const timezone = getString(options, "timezone");
+  const duration = getString(options, "duration");
+  const allDay = getBoolean(options, "all-day");
+  const location = getString(options, "location");
+  const videoUrl = getString(options, "video-url");
+  const color = getString(options, "color");
+  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 reminders = await readRemindersInput(getString(options, "reminders"));
+  return {
+    ...description !== void 0 ? { description } : {},
+    ...timezone !== void 0 ? { timezone } : {},
+    ...duration !== void 0 ? { duration } : {},
+    ...allDay !== void 0 ? { all_day: allDay } : {},
+    ...location !== void 0 ? { location } : {},
+    ...videoUrl !== void 0 ? { video_url: videoUrl } : {},
+    ...color !== void 0 ? { color } : {},
+    ...status !== void 0 ? { status } : {},
+    ...freeBusyStatus !== void 0 ? { free_busy_status: freeBusyStatus } : {},
+    ...privacy !== void 0 ? { privacy } : {},
+    ...reminders !== void 0 ? { reminders } : {}
+  };
+}
+async function runCalendarEvents(client, parsed, out) {
+  const subcommand = parsed.positional[2];
+  const options = parsed.options;
+  if (subcommand === "list") {
+    const params = {
+      mailbox: getRequiredString(options, "mailbox"),
+      from: getRequiredString(options, "from"),
+      to: getRequiredString(options, "to"),
+      expand: getBoolean(options, "expand"),
+      calendar_id: getString(options, "calendar-id"),
+      cursor: getString(options, "cursor"),
+      limit: getNumber(options, "limit")
+    };
+    writeJson(out, await client.calendar.events.list(params));
+    return;
+  }
+  if (subcommand === "create") {
+    const params = {
+      mailbox: getRequiredString(options, "mailbox"),
+      title: getRequiredString(options, "title"),
+      start: getRequiredString(options, "start"),
+      calendar_id: getString(options, "calendar-id"),
+      ...await calendarEventFields(options)
+    };
+    writeJson(out, await client.calendar.events.create(params));
+    return;
+  }
+  if (subcommand === "get") {
+    const id = requirePositional(parsed.positional, 3, "event id");
+    writeJson(
+      out,
+      await client.calendar.events.get(id, { mailbox: getRequiredString(options, "mailbox") })
+    );
+    return;
+  }
+  if (subcommand === "update") {
+    const id = requirePositional(parsed.positional, 3, "event id");
+    const params = {
+      mailbox: getRequiredString(options, "mailbox"),
+      title: getString(options, "title"),
+      start: getString(options, "start"),
+      ...await calendarEventFields(options)
+    };
+    writeJson(out, await client.calendar.events.update(id, params));
+    return;
+  }
+  if (subcommand === "delete") {
+    const id = requirePositional(parsed.positional, 3, "event id");
+    await client.calendar.events.delete(id, { mailbox: getRequiredString(options, "mailbox") });
+    writeJson(out, { ok: true, id });
+    return;
+  }
+  throw new CliUsageError("Unknown calendar events command.");
+}
+async function runCalendar(client, parsed, out) {
+  const subcommand = parsed.positional[1];
+  if (subcommand === "events") {
+    await runCalendarEvents(client, parsed, out);
+    return;
+  }
+  if (subcommand === "availability") {
+    const options = parsed.options;
+    const days = getIntList(options, "days");
+    const params = {
+      mailbox: getRequiredString(options, "mailbox"),
+      from: getRequiredString(options, "from"),
+      to: getRequiredString(options, "to"),
+      duration: getNumber(options, "duration"),
+      interval: getNumber(options, "interval"),
+      timezone: getString(options, "timezone"),
+      ...days.length > 0 ? { days } : {},
+      window_start: getNumber(options, "window-start"),
+      window_end: getNumber(options, "window-end"),
+      buffer: getNumber(options, "buffer"),
+      minimum_notice: getNumber(options, "minimum-notice")
+    };
+    writeJson(out, await client.calendar.availability(params));
+    return;
+  }
+  throw new CliUsageError("Unknown calendar command.");
+}
+async function runBookingPages(client, parsed, out) {
+  const subcommand = parsed.positional[1];
+  const options = parsed.options;
+  if (subcommand === "list") {
+    writeJson(
+      out,
+      await client.bookingPages.list({
+        cursor: getString(options, "cursor"),
+        limit: getNumber(options, "limit")
+      })
+    );
+    return;
+  }
+  if (subcommand === "create") {
+    const params = {
+      name: getRequiredString(options, "name"),
+      mailbox: getRequiredString(options, "mailbox"),
+      slug: getRequiredString(options, "slug"),
+      duration_minutes: requireNumber(options, "duration-minutes"),
+      availability_days: requireIntList(options, "availability-days"),
+      window_start_minutes: requireNumber(options, "window-start-minutes"),
+      window_end_minutes: requireNumber(options, "window-end-minutes"),
+      timezone: getRequiredString(options, "timezone"),
+      description: getString(options, "description"),
+      buffer_minutes: getNumber(options, "buffer-minutes"),
+      minimum_notice_minutes: getNumber(options, "minimum-notice-minutes"),
+      max_advance_days: getNumber(options, "max-advance-days"),
+      active: getBoolean(options, "active")
+    };
+    writeJson(out, await client.bookingPages.create(params));
+    return;
+  }
+  if (subcommand === "get") {
+    writeJson(
+      out,
+      await client.bookingPages.get(requirePositional(parsed.positional, 2, "booking page id"))
+    );
+    return;
+  }
+  if (subcommand === "update") {
+    const id = requirePositional(parsed.positional, 2, "booking page id");
+    const days = getIntList(options, "availability-days");
+    const params = {
+      name: getString(options, "name"),
+      mailbox: getString(options, "mailbox"),
+      slug: getString(options, "slug"),
+      duration_minutes: getNumber(options, "duration-minutes"),
+      ...days.length > 0 ? { availability_days: days } : {},
+      window_start_minutes: getNumber(options, "window-start-minutes"),
+      window_end_minutes: getNumber(options, "window-end-minutes"),
+      timezone: getString(options, "timezone"),
+      description: getString(options, "description"),
+      buffer_minutes: getNumber(options, "buffer-minutes"),
+      minimum_notice_minutes: getNumber(options, "minimum-notice-minutes"),
+      max_advance_days: getNumber(options, "max-advance-days"),
+      active: getBoolean(options, "active")
+    };
+    writeJson(out, await client.bookingPages.update(id, params));
+    return;
+  }
+  if (subcommand === "delete") {
+    const id = requirePositional(parsed.positional, 2, "booking page id");
+    await client.bookingPages.delete(id);
+    writeJson(out, { ok: true, id });
+    return;
+  }
+  throw new CliUsageError("Unknown booking-pages command.");
+}
 function writeError(err, errOut) {
   if (err instanceof CliUsageError) {
     errOut.write(`Error: ${err.message}
@@ -1013,6 +1271,8 @@ async function runCli(argv, options = {}) {
     else if (command === "newsletter-assets") await runNewsletterAssets(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);
+    else if (command === "booking-pages") await runBookingPages(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.1.5",
+  "version": "0.1.7",
   "description": "Official CLI for the ShipMail API",
   "type": "module",
   "bin": {
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "dependencies": {
-    "shipmail": "0.1.26"
+    "shipmail": "0.1.30"
   },
   "devDependencies": {
     "tsup": "^8.4.0",