chirpie 1.0.42 → 1.0.43

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)
+        );
       }
     }
   }
@@ -335,9 +389,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 +405,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 +458,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 +479,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);
@@ -548,10 +603,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 +779,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 +991,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.43",
   "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.40",
     "commander": "^13"
   },
   "devDependencies": {