@paragraph-com/cli 0.1.0 → 0.1.1

package/dist/index.js

@@ -4741,6 +4741,7 @@ async function validateApiKey(token) {
   const client = createClient(token);
   const me = await client.me.get();
   return {
+    id: me.id,
     name: me.name,
     slug: me.slug,
     customDomain: me.customDomain
@@ -4781,7 +4782,7 @@ async function waitForLogin(sessionId, signal) {
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       if (msg.includes("404") || msg.includes("Not found")) {
-        throw new Error("Login was denied or expired. Please try again.");
+        throw new Error("Login was denied or expired. For non-interactive use, pass the key directly: `paragraph login --token <key>` (get one at paragraph.com/settings \u2192 Publication \u2192 Developer).");
       }
       continue;
     }
@@ -4789,10 +4790,10 @@ async function waitForLogin(sessionId, signal) {
       return status.apiKey;
     }
     if (status.status !== "pending") {
-      throw new Error("Login was denied or expired. Please try again.");
+      throw new Error("Login was denied or expired. For non-interactive use, pass the key directly: `paragraph login --token <key>` (get one at paragraph.com/settings \u2192 Publication \u2192 Developer).");
     }
   }
-  throw new Error("Login timed out after 5 minutes. Please try again.");
+  throw new Error("Login timed out after 5 minutes. For non-interactive use, pass the key directly: `paragraph login --token <key>` (get one at paragraph.com/settings \u2192 Publication \u2192 Developer).");
 }
 function openBrowser(url) {
   return new Promise((resolve, reject) => {
@@ -6733,8 +6734,11 @@ function extractError(err) {
     const message = data?.message || err.message;
     if (status === 401) {
       return { message: "Unauthorized. Check your API key or run `paragraph login`.", status, code: errorCode(status) };
+    } else if (status === 403) {
+      return { message: "Forbidden. Your API key doesn't have access to this resource. Run `paragraph whoami --json` to verify which publication the key is for.", status, code: errorCode(status) };
     } else if (status === 404) {
-      return { message: "Not found. " + (message || ""), status, code: errorCode(status) };
+      const detail = message ? `${message}. ` : "";
+      return { message: `Not found. ${detail}Verify the identifier is correct \u2014 use the matching list command (e.g. \`paragraph post list --json\`, \`paragraph subscriber list --json\`) to find valid values.`, status, code: errorCode(status) };
     } else if (status === 429) {
       return { message: "Rate limited. Please wait and try again.", status, code: errorCode(status) };
     }
@@ -6822,7 +6826,7 @@ Examples:
           chunks.push(chunk);
         }
         token = Buffer.concat(chunks).toString("utf-8").trim();
-        if (!token) throw new Error("No API key received on stdin.");
+        if (!token) throw new Error("No API key received on stdin. Pipe the key (e.g. `echo $PARAGRAPH_API_KEY | paragraph login --with-token`) or use --token <key>.");
       } else if (!process.stdin.isTTY) {
         throw new Error(
           "No --token provided and stdin is not a TTY. Use --token <key> or --with-token."
@@ -6877,6 +6881,7 @@ Examples:
       const apiKey = requireApiKey();
       const me = await validateApiKey(apiKey);
       outputData(this, {
+        ID: me.id,
         Name: me.name,
         Slug: me.slug,
         Domain: me.customDomain
@@ -6999,7 +7004,8 @@ var init_zod = __esm({
             }).optional().describe("Farcaster profile information, if linked")
           })).optional().describe("Authors of this post"),
           "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-          "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+          "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+          "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
         }).describe("The post content"),
         "publication": zod.object({
           "id": zod.string().describe("Unique identifier for the publication"),
@@ -7073,7 +7079,8 @@ var init_zod = __esm({
           }).optional().describe("Farcaster profile information, if linked")
         })).optional().describe("Authors of this post"),
         "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+        "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
       })).describe("Array of items in this page"),
       "pagination": zod.object({
         "cursor": zod.string().optional().describe("Cursor for fetching the next page of results"),
@@ -7124,7 +7131,8 @@ var init_zod = __esm({
           }).optional().describe("Farcaster profile information, if linked")
         })).optional().describe("Authors of this post"),
         "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+        "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
       })).describe("Array of items in this page"),
       "pagination": zod.object({
         "cursor": zod.string().optional().describe("Cursor for fetching the next page of results"),
@@ -7170,7 +7178,8 @@ var init_zod = __esm({
         }).optional().describe("Farcaster profile information, if linked")
       })).optional().describe("Authors of this post"),
       "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+      "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
     });
     updatePostParams = zod.object({
       "postId": zod.string().describe("Unique identifier of the post to update")
@@ -7241,7 +7250,8 @@ var init_zod = __esm({
         }).optional().describe("Farcaster profile information, if linked")
       })).optional().describe("Authors of this post"),
       "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+      "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
     });
     getPostByPublicationSlugAndPostSlugPathPublicationSlugMax = 256;
     getPostByPublicationSlugAndPostSlugPathPostSlugMax = 256;
@@ -7284,7 +7294,8 @@ var init_zod = __esm({
         }).optional().describe("Farcaster profile information, if linked")
       })).optional().describe("Authors of this post"),
       "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+      "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
     });
     createPostBodyTitleMax = 200;
     createPostBodySubtitleMax = 300;
@@ -7348,7 +7359,8 @@ var init_zod = __esm({
           }).optional().describe("Farcaster profile information, if linked")
         })).optional().describe("Authors of this post"),
         "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts"),
+        "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
       })).describe("Array of items in this page"),
       "pagination": zod.object({
         "cursor": zod.string().optional().describe("Cursor for fetching the next page of results"),
@@ -7905,7 +7917,7 @@ async function resolveOwnPost(idOrSlug, apiKey) {
   const pub = await validateApiKey2(apiKey);
   const pubSlug = pub.slug;
   if (!pubSlug) {
-    throw new Error(`Post not found: ${idOrSlug}`);
+    throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   return getPostBySlugs(pubSlug, idOrSlug, apiKey);
 }
@@ -7960,7 +7972,7 @@ async function updatePost(idOrSlug, params) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -7974,7 +7986,7 @@ async function deletePost(idOrSlug, apiKey) {
     await client.posts.delete({ id: idOrSlug });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.delete({ slug: idOrSlug });
 }
@@ -7985,7 +7997,7 @@ async function updatePostStatus(idOrSlug, status, apiKey, sendNewsletter) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -7999,7 +8011,7 @@ async function schedulePost(idOrSlug, scheduledAt, apiKey, sendNewsletter) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -8010,7 +8022,7 @@ async function cancelSchedule(idOrSlug, apiKey) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -8086,7 +8098,7 @@ var init_prompt = __esm({
 // src/cli/lib/args.ts
 function requireArg(positional, flag, name, flagName = "--id") {
   if (positional && flag && positional !== flag) {
-    throw new Error(`Conflicting values for ${name}: "${positional}" (argument) vs "${flag}" (${flagName}).`);
+    throw new Error(`Conflicting values for ${name}: "${positional}" (argument) vs "${flag}" (${flagName}). Pass only one.`);
   }
   const value = positional || flag;
   if (!value) throw new Error(`Missing ${name}. Pass it as an argument or with ${flagName}.`);
@@ -8122,7 +8134,7 @@ async function resolveMarkdown(opts) {
   if (opts.text) return opts.text;
   if (opts.file) {
     if (!fs2.existsSync(opts.file)) {
-      throw new Error(`File not found: ${opts.file}`);
+      throw new Error(`File not found: "${opts.file}". Check the path, or use --text <markdown> to pass content inline.`);
     }
     return fs2.readFileSync(opts.file, "utf-8");
   }
@@ -8192,10 +8204,11 @@ Examples:
         limit: parseLimit(opts.limit),
         cursor: opts.cursor
       });
-      const headers = ["ID", "Title", "Date"];
+      const headers = ["ID", "Title", "Status", "Date"];
       const rows = result.items.map((p) => [
         p.id,
         p.title,
+        p.status ?? "\u2014",
         formatDate(p)
       ]);
       outputTable(this, headers, rows, result.items, { cursor: result.cursor });
@@ -8234,6 +8247,7 @@ Examples:
           Title: data.title,
           Subtitle: data.subtitle,
           Slug: data.slug,
+          Status: data.status ?? "\u2014",
           Date: formatDate(data),
           Content: preview
         },
@@ -8635,6 +8649,16 @@ async function listSubscribers(apiKey, pagination) {
 }
 async function getSubscriberCount(publicationId) {
   const client = createClient();
+  try {
+    await client.publications.get({ id: publicationId }).single();
+  } catch (err) {
+    if (err instanceof ParagraphApiError && err.status === 404) {
+      throw new Error(
+        `Invalid publication ID "${publicationId}". Run \`paragraph whoami --json\` to get the valid publication ID.`
+      );
+    }
+    throw err;
+  }
   const result = await client.subscribers.getCount({ id: publicationId });
   return result.count || 0;
 }
@@ -8653,6 +8677,7 @@ var init_subscribers = __esm({
   "src/services/subscribers.ts"() {
     "use strict";
     init_zod();
+    init_dist();
     init_client();
   }
 });
@@ -8696,7 +8721,17 @@ Examples:
   $ paragraph subscriber count --publication abc123
   $ paragraph subscriber count abc123 --json`).action(async function(positionalId, opts) {
     try {
-      const id = requireArg(positionalId, opts.publication, "publication ID", "--publication");
+      const id = positionalId || opts.publication;
+      if (!id) {
+        throw new Error(
+          "Missing publication ID. Run `paragraph whoami --json` to get the publication ID, then pass it as an argument or with --publication."
+        );
+      }
+      if (positionalId && opts.publication && positionalId !== opts.publication) {
+        throw new Error(
+          `Conflicting values for publication ID: "${positionalId}" (argument) vs "${opts.publication}" (--publication).`
+        );
+      }
       const count = await getSubscriberCount(id);
       outputData(this, { Count: count }, { count });
     } catch (err) {
@@ -8963,7 +8998,7 @@ var init_user = __esm({
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
-  program2.name("paragraph").description("CLI for Paragraph").version("0.1.0", "-v, --version").option("--json", "Output as JSON").option("--verbose", "Show detailed output for debugging").exitOverride().configureOutput({
+  program2.name("paragraph").description("CLI for Paragraph").version("0.1.1", "-v, --version").option("--json", "Output as JSON").option("--verbose", "Show detailed output for debugging").exitOverride().configureOutput({
     writeOut: (str) => process.stdout.write(str),
     writeErr: (str) => {
       if (process.argv.includes("--json")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paragraph-com/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "CLI for Paragraph",
   "repository": {
@@ -43,13 +43,13 @@
   },
   "dependencies": {
     "@inkjs/ui": "^2.0.0",
-    "@paragraph-com/sdk": "^2.0.0",
-    "zod": "^3.24.0",
+    "@paragraph-com/sdk": "^2.0.1",
     "cli-table3": "^0.6.5",
     "commander": "^12.0.0",
     "ink": "^5.1.0",
     "picocolors": "^1.1.0",
-    "react": "^18.3.1"
+    "react": "^18.3.1",
+    "zod": "^3.24.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",