chirpie 1.0.49 → 1.0.51

package/README.md

@@ -30,14 +30,14 @@ 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 (repeat it for several accounts), `-m` media files or URLs, `--alt` descriptions, `--config` per-account overrides, `--first-comment` a comment published under the post as soon as it goes out, `-s` schedule, `--timezone` the IANA zone a `-s` with no offset is read in, `--idempotency-key` to make a retry safe, `--draft` save without sending |
+| `chirpie post <text>` | Create a post. `-a` account (repeat it for several accounts), `-m` media files or URLs, `--alt` descriptions, `--config` per-account overrides, `--first-comment` a comment published under the post as soon as it goes out, `--instagram-placement` and `--facebook-placement` to publish it as a story or a reel instead of a feed post, `-s` schedule, `--timezone` the IANA zone a `-s` with no offset is read in, `--idempotency-key` to make a retry safe, `--draft` save without sending |
 | `chirpie thread <post> <post> ...` | Create a 2 to 25 post thread, or 1 to 25 with `--draft`. `-a` is repeatable, `--config` takes per-account posts, `--first-comment` posts a comment under the last part, `--timezone` and `--idempotency-key` work as they do on a post, `-f` takes a JSON payload file |
 | `chirpie posts` | List posts. `--status`, `--account`, `--group`, `--limit`, `--include-hidden` |
 | `chirpie posts get <id>` | Fetch one post |
-| `chirpie posts update <id>` | Edit a post that has not published yet, or finish a draft. `--text`, `--media`, `--alt`, `--clear-media`, `--first-comment` (`""` removes it), `--schedule-at`, `--timezone`, `--keep-draft`. Leaving `--schedule-at` out keeps the time it already has |
+| `chirpie posts update <id>` | Edit a post that has not published yet, or finish a draft. `--text`, `--media`, `--alt`, `--clear-media`, `--first-comment` (`""` removes it), `--instagram-placement`, `--facebook-placement`, `--clear-placement`, `--schedule-at`, `--timezone`, `--keep-draft`. Leaving `--schedule-at` out keeps the time it already has |
 | `chirpie posts publish <id>` | Send a saved draft now. `-t` sets the final text first |
 | `chirpie posts first-comment <id>` | Post a first comment that failed, again. It re-sends the text the post already carries. `--idempotency-key` makes a retry safe |
-| `chirpie posts delete <id>` | Take a post down from the platform. Chirpie keeps it, marked deleted. Deleting any post of a scheduled thread cancels the thread. Instagram and TikTok offer no delete API and refuse with `delete_unsupported` |
+| `chirpie posts delete <id>` | Take a post down from the platform. Chirpie keeps it, marked deleted. Deleting any post of a scheduled thread cancels the thread. A published Instagram or TikTok post cannot be deleted and refuses with `delete_unsupported` |
 | `chirpie posts hide <id>` / `unhide <id>` | Hide a post from your Chirpie listings, or show it again. Nothing reaches the platform |
 | `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 |

package/dist/index.js

@@ -278,14 +278,41 @@ function printFanOut(groupId, lines) {
   return failed.length;
 }
 
+// src/lib/placement.ts
+var INSTAGRAM_PLACEMENT_HELP = 'Where the post goes on Instagram: feed (the default), story or reel. A story takes exactly one image or video, no caption (pass "" as the text) and no first comment. A reel takes exactly one video. Only pass this when the post is going to an Instagram account';
+var FACEBOOK_PLACEMENT_HELP = "Where the post goes on a Facebook Page: feed (the default) or story. A story takes exactly one image or video, no text and no first comment. Only pass this when the post is going to a Facebook Page";
+var INSTAGRAM_PLACEMENTS = ["feed", "story", "reel"];
+var FACEBOOK_PLACEMENTS = ["feed", "story"];
+function placementConfiguration(opts) {
+  const instagram = opts.instagramPlacement;
+  const facebook = opts.facebookPlacement;
+  if (instagram !== void 0 && !INSTAGRAM_PLACEMENTS.includes(instagram)) {
+    error(
+      `--instagram-placement takes ${INSTAGRAM_PLACEMENTS.join(", ")}, not "${instagram}"`
+    );
+    process.exit(1);
+  }
+  if (facebook !== void 0 && !FACEBOOK_PLACEMENTS.includes(facebook)) {
+    error(
+      `--facebook-placement takes ${FACEBOOK_PLACEMENTS.join(", ")}, not "${facebook}"`
+    );
+    process.exit(1);
+  }
+  if (instagram === void 0 && facebook === void 0) return void 0;
+  return {
+    ...instagram !== void 0 ? { instagram: { placement: instagram } } : {},
+    ...facebook !== void 0 ? { facebook: { placement: facebook } } : {}
+  };
+}
+
 // 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("--first-comment <text>", "Post this as a comment under the post, as soon as it goes out. X, Threads, Instagram and Facebook only. It counts as one post against your monthly quota").option("--alt <text...>", ALT_OPTION_HELP).option(
+).option("-m, --media <files...>", MEDIA_OPTION_HELP).option("--first-comment <text>", "Post this as a comment under the post, as soon as it goes out. X, Threads, Instagram and Facebook only. It counts as one post against your monthly quota").option("--alt <text...>", ALT_OPTION_HELP).option("--instagram-placement <placement>", INSTAGRAM_PLACEMENT_HELP).option("--facebook-placement <placement>", FACEBOOK_PLACEMENT_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": ["..."], "first_comment": "..." } }. Every key must be an account named with --account, and "first_comment": "" publishes that account without the first comment the call is sending'
+  'Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "text": "...", "media_urls": ["..."], "first_comment": "...", "configuration": { "instagram": { "placement": "reel" } } } }. Every key must be an account named with --account, "first_comment": "" publishes that account without the first comment the call is sending, and "configuration" replaces the placement flags for that account and is where the options a placement carries go (collaborators, user_tags, cover, video_cover_timestamp_ms, share_to_feed, trial_reel on Instagram, link on a Facebook Page)'
 ).option("-s, --schedule <datetime>", "Schedule for later. An ISO 8601 timestamp carrying a timezone (2026-04-01T14:00:00Z or 2026-04-01T16:00:00+02:00), or a local time with no offset (2026-11-01T09:30) read in --timezone or the timezone saved on your account. Posts publish within ~5 minutes of the scheduled time.").option(
   "--draft",
   "Save without publishing. Nothing is sent, nothing counts against your quota, and any problems are listed back"
@@ -304,6 +331,7 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
   }
   const accountIds = named.length > 0 ? named : [await resolveSingleAccountId(client)];
   const fanOut = named.length > 1 || Boolean(opts.config);
+  const configuration = placementConfiguration(opts);
   try {
     const media = await resolveMediaArgs(client, opts.media, opts.alt);
     if (fanOut) {
@@ -312,6 +340,7 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
         text,
         ...media ? { media } : {},
         ...opts.firstComment ? { first_comment: opts.firstComment } : {},
+        ...configuration ? { configuration } : {},
         ...opts.config ? {
           account_configurations: parseAccountConfigurations(
             opts.config
@@ -347,6 +376,7 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
       text,
       ...media ? { media } : {},
       ...opts.firstComment ? { first_comment: opts.firstComment } : {},
+      ...configuration ? { configuration } : {},
       schedule_at: opts.schedule,
       ...opts.timezone ? { timezone: opts.timezone } : {},
       ...opts.draft ? { draft: true } : {}
@@ -400,7 +430,7 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
   "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" }], "first_comment": "..." } }. An account's posts replace the whole thread for that account, and "first_comment": "" publishes that account without the first comment the call is sending`
+  `Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "posts": [{ "text": "one" }, { "text": "two" }], "first_comment": "...", "configuration": { "facebook": { "link": "https://example.com" } } } }. An account's posts replace the whole thread for that account, "first_comment": "" publishes that account without the first comment the call is sending, and "configuration" carries the publishing options for that account. A thread publishes to the feed: an Instagram story or reel, and a Facebook Page story, are each a single post, so a thread asking for one of those placements is refused`
 ).option("-s, --schedule <datetime>", "Schedule for later. An ISO 8601 timestamp carrying a timezone (2026-04-01T14:00:00Z or 2026-04-01T16:00:00+02:00), or a local time with no offset (2026-11-01T09:30) read in --timezone or the timezone saved on your account. Threads publish within ~5 minutes of the scheduled time.").option(
   "--draft",
   "Save without publishing. Nothing is sent, nothing counts against your quota, and any problems are listed back"
@@ -611,6 +641,15 @@ postsCommand.command("update <id>").description(
 ).option(
   "--first-comment <text>",
   'The comment to post under this one once it publishes. Pass "" to remove the one it has'
+).option(
+  "--instagram-placement <placement>",
+  `${INSTAGRAM_PLACEMENT_HELP}. On an update this replaces every publishing option the post carries, so a queued reel loses its collaborators, cover and trial-reel setting unless you send them again with --config`
+).option(
+  "--facebook-placement <placement>",
+  `${FACEBOOK_PLACEMENT_HELP}. On an update this replaces every publishing option the post carries`
+).option(
+  "--clear-placement",
+  "Put the post back to a plain feed post, dropping every publishing option it carries"
 ).option(
   "--keep-draft",
   "Keep a draft a draft, so --schedule-at only changes the time it remembers"
@@ -619,12 +658,19 @@ postsCommand.command("update <id>").description(
     error("Pass either --media or --clear-media, not both");
     process.exit(1);
   }
-  if (!opts.text && !opts.media && !opts.clearMedia && opts.firstComment === void 0 && !opts.scheduleAt && !opts.keepDraft) {
+  if (opts.clearPlacement && (opts.instagramPlacement !== void 0 || opts.facebookPlacement !== void 0)) {
+    error(
+      "Pass either --clear-placement or a placement flag, not both"
+    );
+    process.exit(1);
+  }
+  if (!opts.text && !opts.media && !opts.clearMedia && opts.firstComment === void 0 && opts.instagramPlacement === void 0 && opts.facebookPlacement === void 0 && !opts.clearPlacement && !opts.scheduleAt && !opts.keepDraft) {
     error(
-      "Nothing to change. Pass --text, --media, --clear-media, --first-comment, --schedule-at or --keep-draft"
+      "Nothing to change. Pass --text, --media, --clear-media, --first-comment, --instagram-placement, --facebook-placement, --clear-placement, --schedule-at or --keep-draft"
     );
     process.exit(1);
   }
+  const configuration = opts.clearPlacement ? {} : placementConfiguration(opts);
   const client = getClient();
   try {
     const media = await resolveMediaArgs(client, opts.media, opts.alt);
@@ -633,6 +679,7 @@ postsCommand.command("update <id>").description(
       ...opts.clearMedia ? { media: [] } : {},
       ...media ? { media } : {},
       ...opts.firstComment !== void 0 ? { first_comment: opts.firstComment } : {},
+      ...configuration ? { configuration } : {},
       ...opts.scheduleAt ? { schedule_at: opts.scheduleAt } : {},
       ...opts.timezone ? { timezone: opts.timezone } : {},
       ...opts.keepDraft ? { draft: true } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chirpie",
-  "version": "1.0.49",
+  "version": "1.0.51",
   "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.46",
+    "@chirpie/sdk": "^1.0.48",
     "commander": "^13"
   },
   "devDependencies": {