chirpie 1.0.43 → 1.0.45

package/README.md

@@ -30,9 +30,9 @@ 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 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 post <text>` | Create a post. `-a` account (repeat it for several accounts), `-m` media files or URLs, `--alt` descriptions, `--config` per-account overrides, `-s` schedule |
+| `chirpie thread <post> <post> ...` | Create a 2 to 25 post thread. `-a` is repeatable, `--config` takes per-account posts, `-f` takes a JSON payload file |
+| `chirpie posts` | List posts. `--status`, `--account`, `--group`, `--limit` |
 | `chirpie posts get <id>` | Fetch one post |
 | `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 |
@@ -70,6 +70,28 @@ chirpie thread "One" "Two" "Three" -a 550e8400-e29b-41d4-a716-446655440000
 chirpie posts --status scheduled
 ```
 
+## Several accounts at once
+
+Repeat `-a` to publish the same post to up to 25 accounts in one call.
+
+```bash
+chirpie post "Shipped a new release." -a "$X_ACCOUNT" -a "$BSKY_ACCOUNT"
+
+# Give one account its own text, inline or from a file
+chirpie post "Shipped a new release." -a "$X_ACCOUNT" -a "$BSKY_ACCOUNT" \
+  --config "{\"$BSKY_ACCOUNT\":{\"text\":\"Shorter, for Bluesky\"}}"
+chirpie post "Shipped a new release." -a "$X_ACCOUNT" -a "$BSKY_ACCOUNT" --config ./overrides.json
+
+# A thread, with a thread of its own for one account
+chirpie thread "One" "Two" -a "$X_ACCOUNT" -a "$BSKY_ACCOUNT" \
+  --config "{\"$BSKY_ACCOUNT\":{\"posts\":[{\"text\":\"A\"},{\"text\":\"B\"}]}}"
+
+# Read the whole group back
+chirpie posts --group 550e8400-e29b-41d4-a716-446655440000
+```
+
+One line is printed per account, with a group ID above them. An account the platform refused is shown with its error while the others stay published, and the command leaves with a non-zero status when any account failed. An override says only what differs, and naming media replaces the shared media for that account.
+
 ## JSON output
 
 Every command accepts `--json` and prints the raw API response, which is what you want in a script:

package/dist/index.js

@@ -181,28 +181,127 @@ async function resolveMediaArgs(client, media, alt) {
 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 <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) {
-    const accounts = await client.listAccounts();
-    const active = accounts.filter((a) => a.is_active);
-    if (active.length === 0) {
-      error("No connected accounts. Run: chirpie accounts connect");
+// src/lib/accounts.ts
+import { readFileSync } from "fs";
+function collect(value, previous = []) {
+  return [...previous, value];
+}
+async function resolveSingleAccountId(client) {
+  const accounts = await client.listAccounts();
+  const active = accounts.filter((a) => a.is_active);
+  if (active.length === 0) {
+    error("No connected accounts. Run: chirpie accounts connect");
+    process.exit(1);
+  }
+  if (active.length > 1) {
+    error("Multiple accounts found. Use --account <id> to specify:");
+    active.forEach((a) => console.log(`  ${a.id}  @${a.username}`));
+    process.exit(1);
+  }
+  return active[0].id;
+}
+function parseAccountConfigurations(value) {
+  if (!value) return void 0;
+  const trimmed = value.trim();
+  let raw;
+  if (trimmed.startsWith("{")) {
+    raw = trimmed;
+  } else {
+    try {
+      raw = readFileSync(trimmed, "utf8");
+    } catch {
+      error(`Could not read --config file: ${trimmed}`);
       process.exit(1);
     }
-    if (active.length > 1) {
-      error("Multiple accounts found. Use --account <id> to specify:");
-      active.forEach((a) => console.log(`  ${a.id}  @${a.username}`));
-      process.exit(1);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    error("--config must be a JSON object, or a path to a file holding one");
+    process.exit(1);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    error("--config must be a JSON object keyed by account ID");
+    process.exit(1);
+  }
+  return parsed;
+}
+function printFanOut(groupId, lines) {
+  const failed = lines.filter((line) => !line.success);
+  console.log(`Group ${groupId}`);
+  for (const line of lines) {
+    if (line.success) {
+      const where = line.platform_post_url ? ` ${line.platform_post_url}` : "";
+      console.log(
+        `\x1B[32m\u2713\x1B[0m ${line.platform} ${line.account_id} ${line.status ?? ""} ${line.id ?? ""}${where}`.trimEnd()
+      );
+    } else {
+      const reason = line.error ? `${line.error.code}: ${line.error.message}` : "Failed";
+      console.log(
+        `\x1B[31m\u2717\x1B[0m ${line.platform} ${line.account_id} ${reason}`
+      );
     }
-    accountId = active[0].id;
   }
+  console.log(
+    `${lines.length - failed.length} of ${lines.length} accounts succeeded`
+  );
+  return failed.length;
+}
+
+// src/commands/post.ts
+var postCommand = new Command3("post").description("Create a post").argument("<text>", "Post text").option(
+  "-a, --account <id>",
+  "Account ID. Repeat it to publish the same post to several accounts at once (up to 25)",
+  collect
+).option("-m, --media <files...>", MEDIA_OPTION_HELP).option("--alt <text...>", ALT_OPTION_HELP).option(
+  "--config <json-or-file>",
+  'Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "text": "...", "media_urls": ["..."] } }. Every key must be an account named with --account'
+).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();
+  const named = opts.account ?? [];
+  if (opts.config && named.length === 0) {
+    error("--config names accounts, so pass --account <id> for each of them");
+    process.exit(1);
+  }
+  const accountIds = named.length > 0 ? named : [await resolveSingleAccountId(client)];
+  const fanOut = named.length > 1 || Boolean(opts.config);
   try {
     const media = await resolveMediaArgs(client, opts.media, opts.alt);
+    if (fanOut) {
+      const result = await client.createPost({
+        account_ids: accountIds,
+        text,
+        ...media ? { media } : {},
+        ...opts.config ? {
+          account_configurations: parseAccountConfigurations(
+            opts.config
+          )
+        } : {},
+        schedule_at: opts.schedule
+      });
+      if (opts.json) {
+        json(result);
+        if (result.results.some((r) => !r.success)) process.exit(1);
+        return;
+      }
+      const failed = printFanOut(
+        result.group_id,
+        result.results.map((r) => ({
+          account_id: r.account_id,
+          platform: r.platform,
+          success: r.success,
+          id: r.post_id,
+          status: r.status,
+          platform_post_url: r.platform_post_url,
+          error: r.error
+        }))
+      );
+      if (failed > 0) process.exit(1);
+      return;
+    }
     const post = await client.createPost({
-      account_id: accountId,
+      account_id: accountIds[0],
       text,
       ...media ? { media } : {},
       schedule_at: opts.schedule
@@ -222,7 +321,7 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
 
 // src/commands/thread.ts
 import { Command as Command4 } from "commander";
-import { readFileSync } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 function parseMediaSpec(spec) {
   const m = spec.match(/^(\d+):(.+)$/);
   if (!m) return null;
@@ -238,7 +337,11 @@ function parseAltSpec(spec) {
     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(
+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. Repeat it to publish the same thread to several accounts at once (up to 25)",
+  collect
+).option(
   "-m, --media <specs...>",
   '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(
@@ -246,32 +349,27 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
   '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 }"
+  "JSON file with a full thread payload: { posts: [{ text, media_urls? }, ...], schedule_at?: string }. It may also carry account_ids and account_configurations."
+).option(
+  "--config <json-or-file>",
+  `Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "posts": [{ "text": "one" }, { "text": "two" }] } }. An account's posts replace the whole thread for that account`
 ).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). Threads publish within ~5 minutes of the scheduled time.").option("--json", "Output raw JSON").action(async (posts, opts) => {
   const client = getClient();
-  let accountId = opts.account;
-  if (!accountId) {
-    const accounts = await client.listAccounts();
-    const active = accounts.filter((a) => a.is_active);
-    if (active.length === 0) {
-      error("No connected accounts. Run: chirpie accounts connect");
-      process.exit(1);
-    }
-    if (active.length > 1) {
-      error("Multiple accounts found. Use --account <id> to specify:");
-      active.forEach((a) => console.log(`  ${a.id}  @${a.username}`));
-      process.exit(1);
-    }
-    accountId = active[0].id;
-  }
   let postPayload;
   let scheduleAt = opts.schedule;
+  let fileAccountIds;
+  let fileConfigurations;
   if (opts.file) {
     try {
-      const raw = JSON.parse(readFileSync(opts.file, "utf8"));
+      const raw = JSON.parse(readFileSync2(opts.file, "utf8"));
       if (!Array.isArray(raw.posts)) throw new Error("File must contain { posts: [...] }");
       postPayload = raw.posts;
       scheduleAt = scheduleAt ?? raw.schedule_at;
+      if (raw.account_ids !== void 0 && (!Array.isArray(raw.account_ids) || raw.account_ids.some((id) => typeof id !== "string"))) {
+        throw new Error("account_ids in the file must be an array of account IDs");
+      }
+      fileAccountIds = raw.account_ids;
+      fileConfigurations = raw.account_configurations;
     } catch (err) {
       error(err instanceof Error ? err.message : "Failed to read thread file");
       process.exit(1);
@@ -314,9 +412,44 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
       }
     }
   }
+  const configurations = parseAccountConfigurations(opts.config) ?? fileConfigurations;
+  const named = opts.account ?? fileAccountIds ?? [];
+  if (configurations && named.length === 0) {
+    error("Per-account posts name accounts, so pass --account <id> for each of them");
+    process.exit(1);
+  }
+  const accountIds = named.length > 0 ? named : [await resolveSingleAccountId(client)];
+  const fanOut = named.length > 1 || Boolean(configurations);
   try {
+    if (fanOut) {
+      const result = await client.createThread({
+        account_ids: accountIds,
+        posts: postPayload,
+        ...configurations ? { account_configurations: configurations } : {},
+        schedule_at: scheduleAt
+      });
+      if (opts.json) {
+        json(result);
+        if (result.results.some((r) => !r.success)) process.exit(1);
+        return;
+      }
+      const failed = printFanOut(
+        result.group_id,
+        result.results.map((r) => ({
+          account_id: r.account_id,
+          platform: r.platform,
+          success: r.success,
+          id: r.thread_id,
+          status: r.status,
+          platform_post_url: r.platform_post_url,
+          error: r.error
+        }))
+      );
+      if (failed > 0) process.exit(1);
+      return;
+    }
     const thread = await client.createThread({
-      account_id: accountId,
+      account_id: accountIds[0],
       posts: postPayload,
       schedule_at: scheduleAt
     });
@@ -333,6 +466,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) {
@@ -341,12 +475,16 @@ function wantsJson(opts, cmd) {
 }
 
 // src/commands/posts.ts
-var postsCommand = new Command5("posts").description("List, get, update, or delete posts").option("--status <status>", "Filter by status").option("--account <id>", "Filter by account").option("--limit <n>", "Limit results", "20").option("--json", "Output raw JSON").action(async (opts, cmd) => {
+var postsCommand = new Command5("posts").description("List, get, update, or delete posts").option("--status <status>", "Filter by status").option("--account <id>", "Filter by account").option(
+  "--group <id>",
+  "Only the posts of one fan-out, from the group ID a multi-account post returned"
+).option("--limit <n>", "Limit results", "20").option("--json", "Output raw JSON").action(async (opts, cmd) => {
   const client = getClient();
   try {
     const posts = await client.listPosts({
       status: opts.status,
       account_id: opts.account,
+      group_id: opts.group,
       limit: parseInt(opts.limit)
     });
     if (wantsJson(opts, cmd)) {
@@ -357,7 +495,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) ?? ""
         }))
       );
     }
@@ -380,6 +521,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");
@@ -525,7 +670,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)
         }))
       );
     }
@@ -534,6 +679,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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chirpie",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "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.40",
+    "@chirpie/sdk": "^1.0.42",
     "commander": "^13"
   },
   "devDependencies": {