@paragraph-com/cli 0.0.3 → 0.0.4

package/README.md

@@ -11,7 +11,7 @@ npm install -g @paragraph-com/cli
 Or via Homebrew:
 
 ```bash
-brew tap paragraph-com/tap && brew install paragraph
+brew tap paragraph-xyz/tap && brew install paragraph
 ```
 
 ## Quick start

package/dist/index.js

@@ -42837,9 +42837,11 @@ async function createPost(params) {
   const body = {
     title: params.title,
     markdown: params.markdown,
-    status: "draft",
+    status: params.scheduledAt ? void 0 : "draft",
     subtitle: params.subtitle,
-    categories: params.tags
+    categories: params.tags,
+    scheduledAt: params.scheduledAt,
+    sendNewsletter: params.sendNewsletter
   };
   createPostBody.parse(body);
   const client = createClient2(params.apiKey);
@@ -42887,6 +42889,31 @@ async function updatePostStatus(idOrSlug, status, apiKey, sendNewsletter) {
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
+async function schedulePost(idOrSlug, scheduledAt, apiKey, sendNewsletter) {
+  const client = createClient2(apiKey);
+  const body = {
+    scheduledAt,
+    sendNewsletter: sendNewsletter || void 0
+  };
+  try {
+    await client.posts.update({ id: idOrSlug, ...body });
+    return;
+  } catch {
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+  }
+  await client.posts.update({ slug: idOrSlug, ...body });
+}
+async function cancelSchedule(idOrSlug, apiKey) {
+  const client = createClient2(apiKey);
+  const body = { scheduledAt: null };
+  try {
+    await client.posts.update({ id: idOrSlug, ...body });
+    return;
+  } catch {
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+  }
+  await client.posts.update({ slug: idOrSlug, ...body });
+}
 var init_posts = __esm({
   "src/services/posts.ts"() {
     "use strict";
@@ -42980,6 +43007,17 @@ var init_args = __esm({
 
 // src/cli/commands/post.ts
 import * as fs2 from "fs";
+function parseScheduleTime(value) {
+  const asNum = Number(value);
+  if (Number.isFinite(asNum) && asNum > 1e12) return asNum;
+  const date = new Date(value);
+  if (isNaN(date.getTime())) {
+    throw new Error(
+      `Invalid schedule time: "${value}". Use ISO 8601 (e.g. "2026-05-01T09:00:00Z") or Unix ms.`
+    );
+  }
+  return date.getTime();
+}
 async function resolveMarkdown(opts) {
   if (opts.text) return opts.text;
   if (opts.file) {
@@ -42993,11 +43031,12 @@ async function resolveMarkdown(opts) {
 }
 function registerPostCommands(program2) {
   const post = program2.command("post").description("Manage posts");
-  const createCmd = (parent) => parent.command("create").description("Create a new post").requiredOption("--title <title>", "Post title").option("--text <markdown>", "Post content as markdown string").option("--file <path>", "Read post content from a file").option("--subtitle <subtitle>", "Post subtitle").option("--tags <tags>", "Comma-separated tags").addHelpText("after", `
+  const createCmd = (parent) => parent.command("create").description("Create a new post").requiredOption("--title <title>", "Post title").option("--text <markdown>", "Post content as markdown string").option("--file <path>", "Read post content from a file").option("--subtitle <subtitle>", "Post subtitle").option("--tags <tags>", "Comma-separated tags").option("--schedule-at <time>", "Schedule publish at a future time (ISO 8601 or Unix ms)").option("--newsletter", "Also send as newsletter email to subscribers").addHelpText("after", `
 Examples:
   $ paragraph post create --title "My Post" --file ./post.md
   $ paragraph post create --title "My Post" --text "# Hello World"
   $ paragraph post create --title "My Post" --tags "web3,defi" --file ./post.md
+  $ paragraph post create --title "My Post" --schedule-at "2026-05-01T09:00:00Z"
   $ cat draft.md | paragraph post create --title "My Post"`).action(async function(opts) {
     try {
       const apiKey = requireApiKey();
@@ -43006,19 +43045,24 @@ Examples:
         throw new Error(
           "Provide content via --text, --file, or pipe to stdin."
         );
+      const scheduledAt = opts.scheduleAt ? parseScheduleTime(opts.scheduleAt) : void 0;
       const data = await createPost({
         apiKey,
         title: opts.title,
         markdown,
         subtitle: opts.subtitle,
-        tags: opts.tags?.split(",").map((t) => t.trim())
+        tags: opts.tags?.split(",").map((t) => t.trim()),
+        scheduledAt,
+        sendNewsletter: opts.newsletter
       });
-      writeSuccess(`Post created: ${opts.title}`);
+      const label = scheduledAt ? "Post scheduled" : "Post created";
+      writeSuccess(`${label}: ${opts.title}`);
       outputData(
         this,
         {
           ID: data.id,
-          Title: opts.title
+          Title: opts.title,
+          Status: data.status
         },
         data
       );
@@ -43323,6 +43367,36 @@ Examples:
       handleError(err);
     }
   });
+  post.command("schedule [id-or-slug]").description("Schedule a draft post for future publication").option("--id <id-or-slug>", "Post ID or slug").requiredOption("--at <time>", "Publish time (ISO 8601 or Unix ms)").option("--newsletter", "Also send as newsletter email to subscribers").addHelpText("after", `
+Examples:
+  $ paragraph post schedule my-post --at "2026-05-01T09:00:00Z"
+  $ paragraph post schedule my-post --at 1746090000000
+  $ paragraph post schedule my-post --at "2026-05-01T09:00:00Z" --newsletter`).action(async function(idOrSlug, opts) {
+    try {
+      const id = requireArg(idOrSlug, opts.id, "post ID or slug");
+      const apiKey = requireApiKey();
+      const scheduledAt = parseScheduleTime(opts.at);
+      await schedulePost(id, scheduledAt, apiKey, opts.newsletter);
+      writeSuccess(`Post scheduled: ${id} at ${new Date(scheduledAt).toISOString()}`);
+      outputData(this, { ID: id, Status: "scheduled", ScheduledAt: new Date(scheduledAt).toISOString() }, { id, status: "scheduled", scheduledAt });
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  post.command("unschedule [id-or-slug]").description("Cancel a scheduled post publication").option("--id <id-or-slug>", "Post ID or slug").addHelpText("after", `
+Examples:
+  $ paragraph post unschedule my-post
+  $ paragraph post unschedule --id my-post`).action(async function(idOrSlug, opts) {
+    try {
+      const id = requireArg(idOrSlug, opts.id, "post ID or slug");
+      const apiKey = requireApiKey();
+      await cancelSchedule(id, apiKey);
+      writeSuccess(`Schedule cancelled: ${id}`);
+      outputData(this, { ID: id, Status: "draft" }, { id, status: "draft" });
+    } catch (err) {
+      handleError(err);
+    }
+  });
   createCmd(post);
   updateCmd(post);
   deleteCmd(post);
@@ -43789,7 +43863,7 @@ var init_user = __esm({
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
-  program2.name("paragraph").description("CLI for Paragraph").version("0.0.3", "-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.0.4", "-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.0.3",
+  "version": "0.0.4",
   "type": "module",
   "description": "CLI for Paragraph",
   "repository": {