chirpie 1.0.42 → 1.0.44

package/README.md

@@ -30,11 +30,11 @@ export CHIRPIE_API_KEY=chirpie_sk_...
 | Command | What it does |
 |---------|--------------|
 | `chirpie login` / `logout` / `auth` / `whoami` | Manage credentials |
-| `chirpie post <text>` | Create a post. `-a` account, `-m` media URLs, `-s` schedule |
+| `chirpie post <text>` | Create a post. `-a` account, `-m` media files or URLs, `--alt` descriptions, `-s` schedule |
 | `chirpie thread <post> <post> ...` | Create a 2 to 25 post thread. `-f` takes a JSON payload file |
 | `chirpie posts` | List posts. `--status`, `--account`, `--limit` |
 | `chirpie posts get <id>` | Fetch one post |
-| `chirpie posts update <id>` | Edit a post that has not published yet. `--text`, `--media`, `--clear-media`, `--schedule-at`. Leaving `--schedule-at` out keeps the time it already has |
+| `chirpie posts update <id>` | Edit a post that has not published yet. `--text`, `--media`, `--alt`, `--clear-media`, `--schedule-at`. Leaving `--schedule-at` out keeps the time it already has |
 | `chirpie posts delete <id>` | Delete a post. Deleting any post of a scheduled thread cancels the thread |
 | `chirpie accounts` | List connected accounts, active and inactive |
 | `chirpie accounts activate <id>` / `deactivate <id>` | Choose which accounts publish. Deactivating cancels that account's scheduled posts |
@@ -57,8 +57,8 @@ Run `chirpie <command> --help` for the full option list. Threads, Instagram, Fac
 # Post now, picking the account interactively
 chirpie post "Shipped a new release."
 
-# Post with media to a specific account
-chirpie post "Look at this" -a 550e8400-e29b-41d4-a716-446655440000 -m https://example.com/a.png
+# Post with media to a specific account. A local file is uploaded first.
+chirpie post "Look at this" -a 550e8400-e29b-41d4-a716-446655440000 -m ./shot.png --alt "The new dashboard"
 
 # Schedule. Any ISO 8601 timestamp that carries a timezone.
 chirpie post "Later" -s 2026-04-01T14:00:00Z

package/dist/index.js

@@ -45,10 +45,10 @@ var authCommand = new Command("auth").description("Configure your Chirpie API ke
   let apiKey = opts.key;
   if (!apiKey) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
-    apiKey = await new Promise((resolve) => {
+    apiKey = await new Promise((resolve2) => {
       rl.question("Enter your Chirpie API key: ", (answer) => {
         rl.close();
-        resolve(answer.trim());
+        resolve2(answer.trim());
       });
     });
   }
@@ -156,8 +156,33 @@ function getClient() {
   });
 }
 
+// src/lib/media.ts
+import { readFile } from "fs/promises";
+import { basename, resolve } from "path";
+async function resolveMediaArgs(client, media, alt) {
+  if (!media?.length) return void 0;
+  const items = [];
+  for (const [index, value] of media.entries()) {
+    const description = alt?.[index];
+    if (/^https?:\/\//i.test(value)) {
+      items.push({ url: value, ...description ? { alt: description } : {} });
+      continue;
+    }
+    const path = resolve(value);
+    const bytes = await readFile(path);
+    const uploaded = await client.uploadMedia({
+      data: new Uint8Array(bytes),
+      filename: basename(path)
+    });
+    items.push({ id: uploaded.id, ...description ? { alt: description } : {} });
+  }
+  return items;
+}
+var MEDIA_OPTION_HELP = "Image or video files on this machine, or public URLs. Files are uploaded first. Image caps: X, Bluesky, LinkedIn and Mastodon 4, Threads 1, Instagram, Facebook and Telegram 10. Video: X, Mastodon and Telegram only, one per post, never with images. Anything a platform cannot take is refused rather than dropped.";
+var ALT_OPTION_HELP = "Describe each item for people using a screen reader, in the same order as --media. Carried to X, Bluesky, LinkedIn, Mastodon, Instagram and Facebook.";
+
 // src/commands/post.ts
-var postCommand = new Command3("post").description("Create a post").argument("<text>", "Post text").option("-a, --account <id>", "Account ID").option("-m, --media <urls...>", "Image or video URLs. Image caps: X, Bluesky, LinkedIn and Mastodon 4, Threads 1, Instagram, Facebook and Telegram 10. Video: X, Mastodon and Telegram only, one per post, never with images. Anything a platform cannot take is refused rather than dropped.").option("-s, --schedule <datetime>", "Schedule for later. Any ISO 8601 timestamp with a timezone (2026-04-01T14:00:00Z or 2026-04-01T16:00:00+02:00). Posts publish within ~5 minutes of the scheduled time.").option("--json", "Output raw JSON").action(async (text, opts) => {
+var postCommand = new Command3("post").description("Create a post").argument("<text>", "Post text").option("-a, --account <id>", "Account ID").option("-m, --media <files...>", MEDIA_OPTION_HELP).option("--alt <text...>", ALT_OPTION_HELP).option("-s, --schedule <datetime>", "Schedule for later. Any ISO 8601 timestamp with a timezone (2026-04-01T14:00:00Z or 2026-04-01T16:00:00+02:00). Posts publish within ~5 minutes of the scheduled time.").option("--json", "Output raw JSON").action(async (text, opts) => {
   const client = getClient();
   let accountId = opts.account;
   if (!accountId) {
@@ -175,10 +200,11 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
     accountId = active[0].id;
   }
   try {
+    const media = await resolveMediaArgs(client, opts.media, opts.alt);
     const post = await client.createPost({
       account_id: accountId,
       text,
-      media_urls: opts.media,
+      ...media ? { media } : {},
       schedule_at: opts.schedule
     });
     if (opts.json) {
@@ -201,12 +227,23 @@ function parseMediaSpec(spec) {
   const m = spec.match(/^(\d+):(.+)$/);
   if (!m) return null;
   const index = parseInt(m[1], 10);
-  const urls = m[2].split(",").map((u) => u.trim()).filter(Boolean);
-  return { index, urls };
+  const files = m[2].split(",").map((u) => u.trim()).filter(Boolean);
+  return { index, files };
+}
+function parseAltSpec(spec) {
+  const m = spec.match(/^(\d+):(.+)$/);
+  if (!m) return null;
+  return {
+    index: parseInt(m[1], 10),
+    alts: m[2].split(",").map((a) => a.trim())
+  };
 }
 var threadCommand = new Command4("thread").description("Create a thread").argument("[posts...]", "Thread posts (each argument is one post). Omit when using --file.").option("-a, --account <id>", "Account ID").option(
   "-m, --media <specs...>",
-  'Per-post media as "INDEX:url1,url2" (repeatable). Example: -m 0:https://a.png 2:https://b.png,https://c.png'
+  'Per-post media as "INDEX:file1,file2" (repeatable). Files on this machine are uploaded first; public URLs are used as they are. Example: -m 0:./shot.png 2:https://b.png,https://c.png'
+).option(
+  "--alt <specs...>",
+  'Per-post alt text as "INDEX:first,second", lining up with --media. Carried to X, Bluesky, LinkedIn, Mastodon, Instagram and Facebook.'
 ).option(
   "-f, --file <path>",
   "JSON file with a full thread payload: { posts: [{ text, media_urls? }, ...], schedule_at?: string }"
@@ -245,6 +282,19 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
       process.exit(1);
     }
     postPayload = posts.map((text) => ({ text }));
+    if (opts.alt && !opts.media) {
+      error("--alt describes the items in --media, so pass --media too");
+      process.exit(1);
+    }
+    const altByIndex = /* @__PURE__ */ new Map();
+    for (const spec of opts.alt ?? []) {
+      const parsed = parseAltSpec(spec);
+      if (!parsed) {
+        error(`Invalid --alt spec: "${spec}". Expected "INDEX:first,second".`);
+        process.exit(1);
+      }
+      altByIndex.set(parsed.index, parsed.alts);
+    }
     if (opts.media) {
       for (const spec of opts.media) {
         const parsed = parseMediaSpec(spec);
@@ -256,7 +306,11 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
           error(`--media index ${parsed.index} out of range (thread has ${postPayload.length} posts)`);
           process.exit(1);
         }
-        postPayload[parsed.index].media_urls = parsed.urls;
+        postPayload[parsed.index].media = await resolveMediaArgs(
+          client,
+          parsed.files,
+          altByIndex.get(parsed.index)
+        );
       }
     }
   }
@@ -279,6 +333,7 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
 
 // src/commands/posts.ts
 import { Command as Command5 } from "commander";
+import { postFailureReason } from "@chirpie/sdk";
 
 // src/lib/flags.ts
 function wantsJson(opts, cmd) {
@@ -303,7 +358,10 @@ var postsCommand = new Command5("posts").description("List, get, update, or dele
           id: p.id.slice(0, 8),
           status: p.status,
           text: p.text.length > 50 ? p.text.slice(0, 50) + "..." : p.text,
-          created: p.created_at.slice(0, 10)
+          created: p.created_at.slice(0, 10),
+          // Why a post is not where you expected it. Empty for the ones
+          // that are exactly where you left them.
+          issue: postFailureReason(p) ?? ""
         }))
       );
     }
@@ -326,6 +384,10 @@ postsCommand.command("get <id>").description("Get a post by ID").option("--json"
       if (post.scheduled_at) console.log(`Scheduled: ${post.scheduled_at}`);
       if (post.published_at) console.log(`Published: ${post.published_at}`);
       if (post.platform_post_id) console.log(`Platform Post ID: ${post.platform_post_id}`);
+      if (post.platform_post_url) console.log(`URL:       ${post.platform_post_url}`);
+      if (post.retry_count > 0) console.log(`Attempts:  ${post.retry_count}`);
+      const issue = postFailureReason(post);
+      if (issue) console.log(`Issue:     ${issue}`);
     }
   } catch (err) {
     error(err instanceof Error ? err.message : "Failed to get post");
@@ -335,9 +397,9 @@ postsCommand.command("get <id>").description("Get a post by ID").option("--json"
 postsCommand.command("update <id>").description(
   "Edit a post that has not published yet. Leaving --schedule-at out keeps the time it already has"
 ).option("-t, --text <text>", "Replacement post text").option(
-  "-m, --media <urls...>",
-  "Replacement image or video URLs, following the same per-platform rules as creating a post. Pass --clear-media to remove the media instead."
-).option("--clear-media", "Remove the media from the post").option(
+  "-m, --media <files...>",
+  "Replacement image or video files on this machine, or public URLs, following the same per-platform rules as creating a post. Pass --clear-media to remove the media instead."
+).option("--alt <text...>", ALT_OPTION_HELP).option("--clear-media", "Remove the media from the post").option(
   "-s, --schedule-at <datetime>",
   "New publish time. Any ISO 8601 timestamp with a timezone (2027-04-01T14:00:00Z or 2027-04-01T16:00:00+02:00). Omit it to keep the time the post already has. Rescheduling one part of a thread moves the whole thread."
 ).option("--json", "Output raw JSON").action(async (id, opts, cmd) => {
@@ -351,10 +413,11 @@ postsCommand.command("update <id>").description(
   }
   const client = getClient();
   try {
+    const media = await resolveMediaArgs(client, opts.media, opts.alt);
     const post = await client.updatePost(id, {
       ...opts.text !== void 0 ? { text: opts.text } : {},
-      ...opts.clearMedia ? { media_urls: [] } : {},
-      ...opts.media ? { media_urls: opts.media } : {},
+      ...opts.clearMedia ? { media: [] } : {},
+      ...media ? { media } : {},
       ...opts.scheduleAt ? { schedule_at: opts.scheduleAt } : {}
     });
     if (wantsJson(opts, cmd)) {
@@ -403,14 +466,14 @@ async function readSecretFromStdin(prompt) {
   if (!stdin.isTTY) {
     const readline = await import("readline");
     const rl = readline.createInterface({ input: stdin });
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       rl.on("line", (line) => {
         rl.close();
-        resolve(line.trim());
+        resolve2(line.trim());
       });
     });
   }
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const chars = [];
     stdin.setRawMode(true);
     stdin.resume();
@@ -424,7 +487,7 @@ async function readSecretFromStdin(prompt) {
           stdin.pause();
           stdin.off("data", onData);
           process.stderr.write("\n");
-          resolve(chars.join("").trim());
+          resolve2(chars.join("").trim());
           break;
         case "":
           stdin.setRawMode(false);
@@ -470,7 +533,7 @@ var accountsCommand = new Command6("accounts").description("List connected socia
           // Inactive accounts are listed too, so a Facebook Page that was
           // connected past the plan's account limit is visible and can be
           // switched on with `chirpie accounts activate <id>`.
-          note: a.is_active ? "" : a.inactive_reason === "plan_limit" ? "over plan limit" : ""
+          note: a.is_active ? "" : inactiveNote(a.inactive_reason)
         }))
       );
     }
@@ -479,6 +542,13 @@ var accountsCommand = new Command6("accounts").description("List connected socia
     process.exit(1);
   }
 });
+function inactiveNote(reason) {
+  if (reason === "plan_limit") return "over plan limit";
+  if (reason === "token_revoked" || reason === "token_expired" || reason === "reauth_required") {
+    return "needs reconnecting";
+  }
+  return "";
+}
 accountsCommand.command("activate").argument("<id>", "Account ID (from `chirpie accounts`)").description("Activate a connected account so it can publish").option("--json", "Output raw JSON").action(async (id, opts, cmd) => {
   const client = getClient();
   try {
@@ -548,10 +618,10 @@ async function confirm(question) {
     input: process.stdin,
     output: process.stderr
   });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(`${question} [y/N] `, (answer) => {
       rl.close();
-      resolve(answer.trim().toLowerCase() === "y");
+      resolve2(answer.trim().toLowerCase() === "y");
     });
   });
 }
@@ -724,11 +794,11 @@ accountsCommand.command("connect-telegram").description("Connect a Telegram bot
     if (!chatId) {
       const readline = await import("readline");
       const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-      chatId = await new Promise((resolve) => {
+      chatId = await new Promise((resolve2) => {
         process.stderr.write("Chat ID: ");
         rl.question("", (answer) => {
           rl.close();
-          resolve(answer.trim());
+          resolve2(answer.trim());
         });
       });
       if (!chatId) {
@@ -936,10 +1006,10 @@ async function confirm2(question) {
     input: process.stdin,
     output: process.stderr
   });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(`${question} [y/N] `, (answer) => {
       rl.close();
-      resolve(answer.trim().toLowerCase() === "y");
+      resolve2(answer.trim().toLowerCase() === "y");
     });
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chirpie",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "description": "Chirpie CLI: post to social media from the command line",
   "repository": {
     "type": "git",
@@ -44,7 +44,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@chirpie/sdk": "^1.0.39",
+    "@chirpie/sdk": "^1.0.41",
     "commander": "^13"
   },
   "devDependencies": {