@autoposting.ai/cli 0.3.2 → 0.3.3

package/README.md

@@ -69,7 +69,10 @@ ap doctor
 # Posts — create, schedule, publish, AI-rewrite, AI-score
 ap posts create --brand my-brand --text "Launch day!" --platforms x,linkedin,threads
 ap posts create --brand my-brand --text "Tweet 1" --thread "Tweet 2" "Tweet 3" --platforms x   # multi-tweet thread (X/Threads, max 25)
+ap posts create --brand my-brand --text "Ship day 🚀" --platforms x --media chart.png demo.mp4 --alt-text "Q2 chart"   # attach media (alt text aligns by index)
+ap posts create --brand my-brand --text "Update" --platforms linkedin --account linkedin=@acme-corp   # pick one of several accounts on a platform
 ap posts schedule <id> --at "2025-06-01T09:00:00Z"
+ap posts schedule <id> --cancel                # unschedule, back to draft
 ap posts publish <id>
 ap posts rewrite <id>          # AI-rewrite for better engagement
 ap posts score <id>            # AI scoring with feedback

package/dist/cli.cjs

@@ -42,11 +42,11 @@ function createError(status, body) {
   if (status >= 500) return new ServerError(message, status, code);
   return new AutopostingError(message, status, code);
 }
-var VERSION, AutopostingError, AuthenticationError, ScopeError, NotFoundError, ValidationError, RateLimitError, ServerError, Resource, AgentsResource, BillingResource, BrandsResource, CarouselsResource, ClipsResource, PostsResource, KbResource, IdeasResource, UsageResource, WebhooksResource, WorkspacesResource, IDEMPOTENT_METHODS, RETRYABLE_STATUS, sleep, Autoposting;
+var VERSION, AutopostingError, AuthenticationError, ScopeError, NotFoundError, ValidationError, RateLimitError, ServerError, Resource, MediaResource, AgentsResource, BillingResource, BrandsResource, CarouselsResource, ClipsResource, PostsResource, KbResource, IdeasResource, UsageResource, WebhooksResource, WorkspacesResource, IDEMPOTENT_METHODS, RETRYABLE_STATUS, sleep, Autoposting;
 var init_dist = __esm({
   "../sdk/dist/index.mjs"() {
     "use strict";
-    VERSION = "0.3.2";
+    VERSION = "0.3.3";
     AutopostingError = class extends Error {
       status;
       code;
@@ -92,6 +92,15 @@ var init_dist = __esm({
         return this.client.request("DELETE", path2);
       }
     };
+    MediaResource = class extends Resource {
+      /** POST /media/upload — multipart/form-data, ≤20MB, image/* | video/*. */
+      upload(file) {
+        const form = new FormData();
+        const blob = file.data instanceof Blob ? file.data : new Blob([file.data], { type: file.contentType });
+        form.append("file", blob, file.filename);
+        return this.client.request("POST", "/media/upload", form);
+      }
+    };
     AgentsResource = class extends Resource {
       /** GET /agents — backend returns `{ items, total, limit, offset }`. */
       list() {
@@ -233,6 +242,10 @@ var init_dist = __esm({
       schedule(id, scheduledAt) {
         return this.client.request("PUT", `/posts/${id}/schedule`, { scheduledAt });
       }
+      /** PUT /posts/:id/schedule with { cancel: true } — returns the post to draft. */
+      unschedule(id) {
+        return this.client.request("PUT", `/posts/${id}/schedule`, { cancel: true });
+      }
       retry(id) {
         return this.client.request("POST", `/posts/${id}/retry`);
       }
@@ -361,6 +374,7 @@ var init_dist = __esm({
       authSource;
       maxRetries;
       retryBaseMs;
+      media;
       agents;
       billing;
       brands;
@@ -386,6 +400,7 @@ var init_dist = __esm({
         this.authSource = config.authSource ?? "api-key";
         this.maxRetries = Math.max(0, config.maxRetries ?? 2);
         this.retryBaseMs = Math.max(0, config.retryBaseMs ?? 300);
+        this.media = new MediaResource(this);
         this.agents = new AgentsResource(this);
         this.billing = new BillingResource(this);
         this.brands = new BrandsResource(this);
@@ -2777,16 +2792,226 @@ function createClipsCommand() {
 // src/commands/posts.ts
 var import_commander7 = require("commander");
 init_dist();
+var import_promises = __toESM(require("fs/promises"));
+var import_node_path2 = __toESM(require("path"));
+
+// src/lib/media-flags.ts
+var import_node_fs2 = require("fs");
 var VALID_PLATFORMS = ["x", "linkedin", "instagram", "threads", "youtube"];
+var EXT_TO_MIME = {
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  png: "image/png",
+  gif: "image/gif",
+  webp: "image/webp",
+  mp4: "video/mp4",
+  mov: "video/quicktime",
+  webm: "video/webm"
+};
+function extToMime(filename) {
+  const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+  const mime = EXT_TO_MIME[ext];
+  if (!mime) {
+    throw new Error(
+      `Unsupported file extension ".${ext || "(none)"}" in "${filename}". Supported: ${Object.keys(EXT_TO_MIME).join(", ")}`
+    );
+  }
+  return mime;
+}
+function parsePairs(flag, vals) {
+  const result = {};
+  for (const val of vals) {
+    const eqIdx = val.indexOf("=");
+    if (eqIdx < 1) {
+      throw new Error(`${flag}: expected "platform=value" format, got "${val}"`);
+    }
+    const p = val.slice(0, eqIdx).trim();
+    const v = val.slice(eqIdx + 1);
+    if (!VALID_PLATFORMS.includes(p)) {
+      throw new Error(`${flag}: unknown platform "${p}". Valid: ${VALID_PLATFORMS.join(", ")}`);
+    }
+    result[p] = v;
+  }
+  return result;
+}
+function parsePlatformMediaPairs(flag, vals) {
+  const result = {};
+  for (const val of vals) {
+    const eqIdx = val.indexOf("=");
+    if (eqIdx < 1) {
+      throw new Error(`${flag}: expected "platform=path[,path...]" format, got "${val}"`);
+    }
+    const p = val.slice(0, eqIdx).trim();
+    const paths = val.slice(eqIdx + 1).split(",").map((s) => s.trim()).filter(Boolean);
+    if (!VALID_PLATFORMS.includes(p)) {
+      throw new Error(`${flag}: unknown platform "${p}". Valid: ${VALID_PLATFORMS.join(", ")}`);
+    }
+    result[p] = paths;
+  }
+  return result;
+}
+function validateMediaExtensions(paths) {
+  for (const p of paths) extToMime(p);
+}
+function validateMediaCount(paths) {
+  if (paths.length > 10) {
+    throw new Error(`--media accepts at most 10 files (received ${paths.length}).`);
+  }
+}
+function validateMediaPaths(paths) {
+  for (const p of paths) {
+    if (!(0, import_node_fs2.existsSync)(p)) {
+      throw new Error(`Media file not found: "${p}"`);
+    }
+  }
+}
+function alignAltText(mediaPaths, altTexts) {
+  if (altTexts.length > mediaPaths.length) {
+    throw new Error(
+      `--alt-text has more values (${altTexts.length}) than --media (${mediaPaths.length}). Alt text aligns to media by index.`
+    );
+  }
+  return mediaPaths.map((_, i) => altTexts[i]);
+}
+function buildYoutubeOptions(opts) {
+  const { ytTitle, ytDescription, ytTags, ytPrivacy, ytCategory, ytMadeForKids } = opts;
+  const o = {};
+  if (ytTitle) o.title = ytTitle;
+  if (ytDescription) o.description = ytDescription;
+  if (ytTags) o.tags = ytTags.split(",").map((t) => t.trim()).filter(Boolean);
+  if (ytPrivacy) o.privacyStatus = ytPrivacy;
+  if (ytCategory) o.categoryId = ytCategory;
+  if (ytMadeForKids !== void 0) o.madeForKids = ytMadeForKids;
+  return Object.keys(o).length > 0 ? o : void 0;
+}
+function buildInstagramOptions(opts) {
+  const { igReel, igShareToFeed, igCoverUrl, igThumbOffsetMs, igCollaborators } = opts;
+  const hasAnyReelFlag = igReel !== void 0 || igShareToFeed !== void 0 || igCoverUrl !== void 0 || igThumbOffsetMs !== void 0 || igCollaborators !== void 0;
+  if (!hasAnyReelFlag) return void 0;
+  const reel = {};
+  if (igShareToFeed !== void 0) reel.shareToFeed = igShareToFeed;
+  if (igCoverUrl) reel.coverUrl = igCoverUrl;
+  if (igThumbOffsetMs !== void 0) {
+    const n = Number(igThumbOffsetMs);
+    if (!Number.isFinite(n) || n < 0) {
+      throw new Error(
+        `--ig-thumb-offset-ms must be a non-negative number (received "${igThumbOffsetMs}")`
+      );
+    }
+    reel.thumbOffsetMs = n;
+  }
+  if (igCollaborators) {
+    reel.collaborators = igCollaborators.split(",").map((s) => s.trim()).filter(Boolean);
+  }
+  return { reel };
+}
+function buildThreadsOptions(opts) {
+  const { threadsReplyTo, threadsReplyControl } = opts;
+  if (!threadsReplyTo && !threadsReplyControl) return void 0;
+  const o = {};
+  if (threadsReplyTo) o.replyToId = threadsReplyTo;
+  if (threadsReplyControl) o.replyControl = threadsReplyControl;
+  return o;
+}
+
+// src/lib/account-select.ts
+var VALID_PLATFORMS2 = ["x", "linkedin", "instagram", "threads", "youtube"];
+async function resolveTargetAccounts({
+  brandSlug,
+  platforms,
+  accountFlags,
+  client,
+  isTty
+}) {
+  const accountMap = {};
+  for (const flag of accountFlags) {
+    const eqIdx = flag.indexOf("=");
+    if (eqIdx < 1) {
+      throw Object.assign(
+        new Error(`--account: expected "platform=handle|id" format, got "${flag}"`),
+        { exitCode: 1 }
+      );
+    }
+    const p = flag.slice(0, eqIdx).trim();
+    if (!VALID_PLATFORMS2.includes(p)) {
+      throw Object.assign(
+        new Error(`--account: unknown platform "${p}". Valid: ${VALID_PLATFORMS2.join(", ")}`),
+        { exitCode: 1 }
+      );
+    }
+    accountMap[p] = flag.slice(eqIdx + 1).trim();
+  }
+  const connections = await client.brands.authStatus(brandSlug);
+  const byPlatform = {};
+  for (const conn of connections) {
+    if (!conn.connected) continue;
+    const p = conn.platform;
+    if (!byPlatform[p]) byPlatform[p] = [];
+    byPlatform[p].push(conn);
+  }
+  const result = {};
+  for (const platform of platforms) {
+    const accounts = byPlatform[platform] ?? [];
+    const specifiedValue = accountMap[platform];
+    if (specifiedValue !== void 0) {
+      const normalized = specifiedValue.startsWith("@") ? specifiedValue.slice(1) : specifiedValue;
+      const match = accounts.find(
+        (a) => a.platformUsername?.toLowerCase() === normalized.toLowerCase() || a.platformUserId === specifiedValue
+      );
+      if (!match?.platformUserId) {
+        const valid = accounts.map((a) => `  @${a.platformUsername ?? "?"} (${a.platformUserId ?? "?"})`).join("\n");
+        throw Object.assign(
+          new Error(
+            `--account: unknown ${platform} account "${specifiedValue}".
+Connected accounts:
+${valid || "  (none)"}`
+          ),
+          { exitCode: 1 }
+        );
+      }
+      if (!result[platform]) result[platform] = [];
+      result[platform].push(match.platformUserId);
+    } else if (accounts.length >= 2) {
+      if (isTty) {
+        const { checkbox } = await import("@inquirer/prompts");
+        const choices = accounts.map((a) => ({
+          name: `@${a.platformUsername ?? "?"} (${a.platformUserId ?? "?"})`,
+          value: a.platformUserId ?? ""
+        }));
+        const selected = await checkbox({
+          message: `Multiple ${platform} accounts connected \u2014 select which to post to:`,
+          choices
+        });
+        const valid = selected.filter(Boolean);
+        if (valid.length > 0) result[platform] = valid;
+      } else {
+        const list = accounts.map((a) => `  @${a.platformUsername ?? "?"} (${a.platformUserId ?? "?"})`).join("\n");
+        throw Object.assign(
+          new Error(
+            `Multiple ${platform} accounts connected but no --account specified (non-interactive mode).
+Connected accounts:
+${list}
+Pass --account ${platform}=<handle|id> to select.`
+          ),
+          { exitCode: 1 }
+        );
+      }
+    }
+  }
+  return result;
+}
+
+// src/commands/posts.ts
+var VALID_PLATFORMS3 = ["x", "linkedin", "instagram", "threads", "youtube"];
 function parsePlatforms(raw) {
   const parts = raw.split(",").map((p) => p.trim()).filter(Boolean);
   if (parts.length === 0) {
     throw new Error("No platforms provided. Pass a comma-separated list, e.g. --platforms x,linkedin");
   }
-  const invalid = parts.filter((p) => !VALID_PLATFORMS.includes(p));
+  const invalid = parts.filter((p) => !VALID_PLATFORMS3.includes(p));
   if (invalid.length > 0) {
     throw new Error(
-      `Unsupported platform(s): ${invalid.join(", ")}. Valid platforms: ${VALID_PLATFORMS.join(", ")}`
+      `Unsupported platform(s): ${invalid.join(", ")}. Valid platforms: ${VALID_PLATFORMS3.join(", ")}`
     );
   }
   return parts;
@@ -2867,25 +3092,109 @@ function createPostsCommand() {
   posts.command("create").description("Create a new post").requiredOption("--brand <slug>", "Brand slug").requiredOption("--text <text>", "Post text content").requiredOption("--platforms <list>", "Comma-separated platforms (e.g. x,linkedin)").option("--at <iso>", "Schedule date/time (ISO 8601)").option(
     "--thread <text...>",
     "Additional posts appended after --text to form a thread (X/Threads only, max 25)"
-  ).action(
+  ).option("--media <path...>", "Media file paths to attach (max 10)").option("--alt-text <text...>", "Alt text for --media files, aligned by index").option("--platform-text <pairs...>", "Per-platform text, e.g. x=Hello linkedin=World").option("--platform-media <pairs...>", "Per-platform media, e.g. instagram=photo.jpg x=banner.png").option("--yt-title <t>", "YouTube video title").option("--yt-description <d>", "YouTube video description").option("--yt-tags <list>", "YouTube tags (comma-separated)").option("--yt-privacy <v>", "YouTube privacy status (public|unlisted|private)").option("--yt-category <id>", "YouTube category ID").option("--yt-made-for-kids", "Mark YouTube video as made for kids").option("--ig-reel", "Post as an Instagram Reel").option("--ig-share-to-feed", "Share Reel to feed").option("--ig-cover-url <url>", "Reel cover image URL").option("--ig-thumb-offset-ms <n>", "Reel thumbnail offset in milliseconds").option("--ig-collaborators <list>", "Reel collaborator handles (comma-separated)").option("--threads-reply-to <id>", "Threads post ID to reply to").option("--threads-reply-control <v>", "Threads reply control (everyone|accounts_you_follow|mentioned_only)").option("--account <p=handle|id...>", "Target specific account per platform, e.g. x=@handle").action(
     async (opts, cmd) => {
       const globals = cmd.optsWithGlobals();
       const printer = createPrinter(globals);
-      const spinner = printer.spinner("Creating post\u2026");
+      let spinner;
       try {
         const cred = resolveAuth({ apiKey: globals.apiKey });
         const client = new Autoposting({ apiKey: cred.apiKey });
+        const platforms = parsePlatforms(opts.platforms);
+        const scheduledAt = opts.at ? validateScheduledAt(opts.at) : void 0;
+        if (opts.media && opts.media.length > 0) {
+          validateMediaCount(opts.media);
+          validateMediaPaths(opts.media);
+          validateMediaExtensions(opts.media);
+        }
+        const platformTexts = opts.platformText && opts.platformText.length > 0 ? parsePairs("--platform-text", opts.platformText) : void 0;
+        const platformMediaPaths = opts.platformMedia && opts.platformMedia.length > 0 ? parsePlatformMediaPairs("--platform-media", opts.platformMedia) : {};
+        for (const paths of Object.values(platformMediaPaths)) {
+          validateMediaPaths(paths);
+          validateMediaExtensions(paths);
+        }
+        const altTexts = alignAltText(opts.media ?? [], opts.altText ?? []);
+        const youtubeOptions = buildYoutubeOptions({
+          ytTitle: opts.ytTitle,
+          ytDescription: opts.ytDescription,
+          ytTags: opts.ytTags,
+          ytPrivacy: opts.ytPrivacy,
+          ytCategory: opts.ytCategory,
+          ytMadeForKids: opts.ytMadeForKids
+        });
+        const instagramOptions = buildInstagramOptions({
+          igReel: opts.igReel,
+          igShareToFeed: opts.igShareToFeed,
+          igCoverUrl: opts.igCoverUrl,
+          igThumbOffsetMs: opts.igThumbOffsetMs,
+          igCollaborators: opts.igCollaborators
+        });
+        const threadsOptions = buildThreadsOptions({
+          threadsReplyTo: opts.threadsReplyTo,
+          threadsReplyControl: opts.threadsReplyControl
+        });
+        const targetAccountIds = await resolveTargetAccounts({
+          brandSlug: opts.brand,
+          platforms,
+          accountFlags: opts.account ?? [],
+          client,
+          // Picker reads stdin — gate on a real interactive terminal, not the
+          // output mode (printer.isTty() is true even when stdout/stdin is piped).
+          isTty: Boolean(process.stdin.isTTY)
+        });
+        spinner = printer.spinner("Creating post\u2026");
+        const mediaInputs = [];
+        for (let i = 0; i < (opts.media ?? []).length; i++) {
+          const filePath = opts.media[i];
+          const data = await import_promises.default.readFile(filePath);
+          const filename = import_node_path2.default.basename(filePath);
+          const contentType = extToMime(filename);
+          const uploaded = await client.media.upload({
+            data: new Uint8Array(data),
+            filename,
+            contentType
+          });
+          mediaInputs.push({
+            url: uploaded.url,
+            type: uploaded.type,
+            ...altTexts[i] ? { altText: altTexts[i] } : {}
+          });
+        }
+        const platformMediaResult = {};
+        for (const [p, paths] of Object.entries(platformMediaPaths)) {
+          const uploads = [];
+          for (const filePath of paths) {
+            const data = await import_promises.default.readFile(filePath);
+            const filename = import_node_path2.default.basename(filePath);
+            const contentType = extToMime(filename);
+            const uploaded = await client.media.upload({
+              data: new Uint8Array(data),
+              filename,
+              contentType
+            });
+            uploads.push({ url: uploaded.url, type: uploaded.type });
+          }
+          platformMediaResult[p] = uploads;
+        }
         const post = await client.posts.create({
           brandSlug: opts.brand,
           text: opts.text,
-          platforms: parsePlatforms(opts.platforms),
-          ...opts.at ? { scheduledAt: validateScheduledAt(opts.at) } : {},
-          ...opts.thread && opts.thread.length > 0 ? { thread: opts.thread } : {}
+          platforms,
+          ...scheduledAt ? { scheduledAt } : {},
+          ...opts.thread && opts.thread.length > 0 ? { thread: opts.thread } : {},
+          ...mediaInputs.length > 0 ? { media: mediaInputs } : {},
+          ...Object.keys(platformMediaResult).length > 0 ? { platformMedia: platformMediaResult } : {},
+          ...platformTexts && Object.keys(platformTexts).length > 0 ? { platformTexts } : {},
+          ...Object.keys(targetAccountIds).length > 0 ? { targetAccountIds } : {},
+          ...instagramOptions ? { instagramOptions } : {},
+          ...threadsOptions ? { threadsOptions } : {},
+          ...youtubeOptions ? { youtubeOptions } : {},
+          source: "cli"
         });
         spinner.stop();
         printer.log(post);
       } catch (err) {
-        spinner.fail();
+        spinner?.fail();
         printer.error(err);
         process.exit(resolveExitCode5(err));
       }
@@ -2952,14 +3261,22 @@ function createPostsCommand() {
       process.exit(resolveExitCode5(err));
     }
   });
-  posts.command("schedule <id>").description("Schedule a post for a specific time").requiredOption("--at <iso>", "ISO 8601 datetime to schedule the post").action(async (id, opts, cmd) => {
+  posts.command("schedule <id>").description("Schedule a post for a specific time, or --cancel to unschedule it").option("--at <iso>", "ISO 8601 datetime to schedule the post").option("--cancel", "Unschedule the post (return it to draft)").action(async (id, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
-    const spinner = printer.spinner(`Scheduling post "${id}"\u2026`);
+    const spinner = printer.spinner(
+      opts.cancel ? `Unscheduling post "${id}"\u2026` : `Scheduling post "${id}"\u2026`
+    );
     try {
+      if (opts.cancel && opts.at) {
+        throw new Error("Cannot use --at together with --cancel \u2014 choose one.");
+      }
+      if (!opts.cancel && !opts.at) {
+        throw new Error("Provide either --at <iso> to schedule, or --cancel to unschedule.");
+      }
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const post = await client.posts.schedule(id, validateScheduledAt(opts.at));
+      const post = opts.cancel ? await client.posts.unschedule(id) : await client.posts.schedule(id, validateScheduledAt(opts.at));
       spinner.stop();
       printer.log(post);
     } catch (err) {
@@ -3525,7 +3842,7 @@ function createWorkspacesCommand() {
 // src/commands/doctor.ts
 var import_commander13 = require("commander");
 init_dist();
-var import_node_fs2 = __toESM(require("fs"));
+var import_node_fs3 = __toESM(require("fs"));
 var API_HEALTH_URL = "https://app.autoposting.ai/api-proxy/health";
 async function runChecks() {
   const results = [];
@@ -3545,7 +3862,7 @@ async function runChecks() {
   }
   const credPath = getCredentialsPath();
   try {
-    const stat = import_node_fs2.default.statSync(credPath);
+    const stat = import_node_fs3.default.statSync(credPath);
     const mode = stat.mode & 511;
     const isSecure = mode === 384;
     results.push({