@publishq/cli 0.0.5 → 0.0.7

package/README.md

@@ -19,7 +19,7 @@ Output is JSON by default: easy to pipe into `jq` and easy for an AI agent to pa
 ## Install
 
 ```bash
-npm install -g @publishq/cli
+npm install -g @publishq/cli@latest
 ```
 
 You get two commands: `publishq` and the shorter `pq`. They do the same thing.
@@ -27,7 +27,7 @@ You get two commands: `publishq` and the shorter `pq`. They do the same thing.
 ## Quick start
 
 ```bash
-# 1. Save your API key (create one under Settings → API Keys in the web app)
+# 1. Save your API key (create one under API Keys in the web app)
 pq auth set --key "pq_live_..."
 
 # 2. See your connected accounts
@@ -51,6 +51,8 @@ pq posts create --content "Hello TikTok" --accounts-json '[{"accountId":"<id>","
 pq posts update <post-id> [--content "New text"] [--scheduled-at <iso>] \
   [--media-id <id>] [--thumbnail-timestamp <ms>]
 pq posts update <post-id> --media-ids-json '[]' # remove all media
+pq posts update <post-id> --accounts-json '[{"accountId":"<id>","platformSpecificSettings":{"thumbnailMediaId":"<image-media-id>"}}]'
+pq posts update <post-id> --accounts-json '[{"accountId":"<id>","platformSpecificSettings":{"thumbnailMediaId":null}}]' # remove one setting
 pq posts delete <post-id>
 pq posts remove-account <post-id> <account-id>
 ```
@@ -83,7 +85,7 @@ pq media get <media-id>
 pq media upload --file ./photo.jpg [--filename custom.jpg]
 ```
 
-Upload returns a media object whose `id` you can pass to `pq posts create --media-id <id>`.
+Upload returns a media object whose `id` you can pass to `pq posts create --media-id <id>`. Files up to 4 GB are accepted (500 MB on the Free plan).
 
 ## Scopes
 
@@ -101,8 +103,8 @@ API keys carry scopes that control access. A call missing the required scope ret
 
 ## Related
 
-- [`@publishq/sdk`](https://www.npmjs.com/package/@publishq/sdk) — the TypeScript SDK this CLI is built on.
-- [`@publishq/mcp`](https://www.npmjs.com/package/@publishq/mcp) — Model Context Protocol server for Claude Desktop and other AI agents.
+- [`@publishq/sdk`](https://www.npmjs.com/package/@publishq/sdk): the TypeScript SDK this CLI is built on.
+- [`@publishq/mcp`](https://www.npmjs.com/package/@publishq/mcp): Model Context Protocol server for Claude Desktop and other AI agents.
 
 ## License
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { openAsBlob, statSync } from "fs";
 import { basename } from "path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -33,7 +33,7 @@ function getClient() {
   const apiKey = getApiKey();
   if (!apiKey) {
     console.error(
-      'No API key found. Generate one at https://publishq.com/app/settings, then run `publishq auth set --key "pq_live_..."` or set PUBLISHQ_API_KEY.'
+      'No API key found. Generate one at https://publishq.com/app/api-keys, then run `publishq auth set --key "pq_live_..."` or set PUBLISHQ_API_KEY.'
     );
     process.exit(1);
   }
@@ -70,6 +70,7 @@ function describeError(error) {
 }
 
 // src/index.ts
+var OPEN_AS_BLOB_MAX_BYTES = 2 ** 32;
 function parseJsonOption(option, value) {
   try {
     return JSON.parse(value);
@@ -115,18 +116,26 @@ yargs(hideBin(process.argv)).scriptName("publishq").usage("$0 <command> [options
   "Create, list, update, and delete posts",
   (y) => y.command(
     ["list", "$0"],
-    "List posts (paginate with --page and --limit)",
+    "List the posts you created through PublishQ (paginate with --page and --limit; imported posts need --include-imported or --only-imported)",
     (yy) => yy.option("page", {
       type: "number",
       describe: "Page number (starts at 1)"
     }).option("limit", {
       type: "number",
       describe: "Page size (max 100)"
+    }).option("include-imported", {
+      type: "boolean",
+      describe: "Also include posts imported from a connected platform (excluded by default)"
+    }).option("only-imported", {
+      type: "boolean",
+      describe: "Return only posts imported from a connected platform"
     }),
     (argv) => {
       const query = {
         ...argv.page !== void 0 ? { page: argv.page } : {},
-        ...argv.limit !== void 0 ? { limit: argv.limit } : {}
+        ...argv.limit !== void 0 ? { limit: argv.limit } : {},
+        ...argv.includeImported !== void 0 ? { includeImported: argv.includeImported } : {},
+        ...argv.onlyImported !== void 0 ? { onlyImported: argv.onlyImported } : {}
       };
       output(
         getClient().posts.list(
@@ -203,18 +212,26 @@ yargs(hideBin(process.argv)).scriptName("publishq").usage("$0 <command> [options
     }).conflicts("media-id", "media-ids-json").option("thumbnail-timestamp", {
       type: "number",
       describe: "New video thumbnail timestamp in milliseconds"
+    }).option("accounts-json", {
+      type: "string",
+      describe: "JSON array of account objects to update or add, with accountId and optional postOverrides/platformSpecificSettings. Only the fields you send change; send a field as null to remove it."
     }),
     (argv) => {
       const mediaIds = argv["media-ids-json"] !== void 0 ? parseJsonOption(
         "--media-ids-json",
         argv["media-ids-json"]
       ) : argv["media-id"];
+      const accounts = argv["accounts-json"] !== void 0 ? parseJsonOption(
+        "--accounts-json",
+        argv["accounts-json"]
+      ) : void 0;
       output(
         getClient().posts.update(argv.id, {
           ...argv.content !== void 0 ? { content: argv.content } : {},
           ...argv["scheduled-at"] !== void 0 ? { scheduledAt: argv["scheduled-at"] } : {},
           ...mediaIds !== void 0 ? { mediaIds } : {},
-          ...argv["thumbnail-timestamp"] !== void 0 ? { thumbnailTimestamp: argv["thumbnail-timestamp"] } : {}
+          ...argv["thumbnail-timestamp"] !== void 0 ? { thumbnailTimestamp: argv["thumbnail-timestamp"] } : {},
+          ...accounts !== void 0 ? { accounts } : {}
         }),
         argv.pretty
       );
@@ -361,11 +378,21 @@ yargs(hideBin(process.argv)).scriptName("publishq").usage("$0 <command> [options
       type: "string",
       describe: "Override the uploaded file name"
     }),
-    (argv) => {
-      const buffer = readFileSync2(argv.file);
+    async (argv) => {
+      if (statSync(argv.file).size >= OPEN_AS_BLOB_MAX_BYTES) {
+        console.error(
+          JSON.stringify({
+            error: `${argv.file} is too big to upload: files must be smaller than 4 GB.`
+          })
+        );
+        process.exit(1);
+      }
       const name = argv.filename ?? basename(argv.file);
-      const file = new File([buffer], name);
-      output(getClient().media.upload({ file }), argv.pretty);
+      const file = new File([await openAsBlob(argv.file)], name);
+      return output(
+        getClient().media.upload({ file }),
+        argv.pretty
+      );
     }
   ).demandCommand(1, "Specify a media subcommand."),
   () => {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@publishq/cli",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "private": false,
-  "description": "Official command-line interface for the PublishQ API — schedule and publish across your social platforms.",
+  "description": "Official command-line interface for the PublishQ API. Schedule and publish across your social platforms.",
   "license": "Apache-2.0",
   "author": "PublishQ",
   "homepage": "https://publishq.com",
@@ -27,8 +27,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "yargs": "^17.7.2",
-    "@publishq/sdk": "^0.0.1"
+    "@publishq/sdk": "^0.0.3",
+    "yargs": "^17.7.2"
   },
   "devDependencies": {
     "@types/node": "^20",