@paragraph-com/cli 0.3.0 → 0.3.1

package/dist/index.js

@@ -7613,9 +7613,11 @@ var init_zod = __esm({
       "postPreview": zod.string().max(updatePostBodyPostPreviewMax).optional().describe("Preview text for the post"),
       "categories": zod.union([zod.array(zod.string()), zod.string()]).optional().describe("Category tags for the post. Can also be a comma-separated string."),
       "status": zod.enum(["draft", "published", "archived"]).optional().describe("Set to 'published' to publish, 'draft' to unpublish, or 'archived' to archive"),
-      "scheduledAt": zod.number().min(updatePostBodyScheduledAtMin).nullish().describe("Unix timestamp (milliseconds) to schedule the post's first publish at a future time. Must be in the future and at most 30 days out. Only valid for draft posts that haven't been published or already scheduled. Cannot be combined with status: 'draft' or 'archived'. Pass null to cancel a previously scheduled publish."),
+      "scheduledAt": zod.number().min(updatePostBodyScheduledAtMin).nullish().describe("Unix timestamp (milliseconds) to schedule the post's first publish at a future time. Must be in the future and at most 30 days out. Only valid for draft posts that haven't been published or already scheduled. Cannot be combined with status: 'draft' or 'archived'. Pass null to cancel a previously scheduled publish. The value 0 is treated the same as omitting the field (no scheduling request); note that on an already-scheduled post, omitting `scheduledAt` while changing `status` cancels the schedule."),
       "sendNewsletter": zod.union([zod.boolean(), zod.enum(["true", "false", "1", "0"])]).optional().describe("Whether to send an email newsletter to subscribers when the post publishes. Only meaningful when publishing (status: 'published') or scheduling (scheduledAt set). Default: false"),
-      "publishedAt": zod.number().min(updatePostBodyPublishedAtMin).optional().describe("Unix timestamp (milliseconds) to set as the post's publish date. Once set, the date is preserved across re-publishes.")
+      "publishedAt": zod.number().min(updatePostBodyPublishedAtMin).optional().describe("Unix timestamp (milliseconds) to set as the post's publish date. Once set, the date is preserved across re-publishes."),
+      "imageUrl": zod.string().url().optional().describe("URL of an image to set as the post's cover/hero image. The image is fetched, re-hosted on Paragraph's CDN, and a placeholder is generated. Pass clearImage: true instead to remove the existing cover."),
+      "clearImage": zod.boolean().optional().describe("When true, removes the post's existing cover/hero image. Ignored if imageUrl is also provided.")
     });
     updatePostResponse = zod.object({
       "success": zod.literal(true).describe("Whether the update succeeded")
@@ -7729,7 +7731,7 @@ var init_zod = __esm({
       "slug": zod.string().min(1).max(createPostBodySlugMax).optional().describe("Optional URL-friendly identifier for the post. If not provided, will be generated from title"),
       "postPreview": zod.string().max(createPostBodyPostPreviewMax).optional().describe("Optional preview text for the post. If not provided, will be generated from content"),
       "categories": zod.union([zod.array(zod.string()), zod.string()]).optional().describe("Optional array of category tags for the post. Can also be a comma-separated string."),
-      "scheduledAt": zod.number().min(createPostBodyScheduledAtMin).optional().describe("Optional Unix timestamp (milliseconds) to schedule first-publish of the post at a future time. Must be in the future. Cannot be combined with status: 'draft'. When set, the post is created and queued to publish (and send newsletter, if requested) at the specified time.")
+      "scheduledAt": zod.number().min(createPostBodyScheduledAtMin).optional().describe("Optional Unix timestamp (milliseconds) to schedule first-publish of the post at a future time. Must be in the future. Cannot be combined with status: 'draft'. When set, the post is created and queued to publish (and send newsletter, if requested) at the specified time. Pass 0 or omit the field for an unscheduled post.")
     });
     createPostResponse = zod.object({
       "id": zod.string().describe("The ID of the created post"),
@@ -7803,9 +7805,11 @@ var init_zod = __esm({
       "postPreview": zod.string().max(updatePostBySlugBodyPostPreviewMax).optional().describe("Preview text for the post"),
       "categories": zod.union([zod.array(zod.string()), zod.string()]).optional().describe("Category tags for the post. Can also be a comma-separated string."),
       "status": zod.enum(["draft", "published", "archived"]).optional().describe("Set to 'published' to publish, 'draft' to unpublish, or 'archived' to archive"),
-      "scheduledAt": zod.number().min(updatePostBySlugBodyScheduledAtMin).nullish().describe("Unix timestamp (milliseconds) to schedule the post's first publish at a future time. Must be in the future and at most 30 days out. Only valid for draft posts that haven't been published or already scheduled. Cannot be combined with status: 'draft' or 'archived'. Pass null to cancel a previously scheduled publish."),
+      "scheduledAt": zod.number().min(updatePostBySlugBodyScheduledAtMin).nullish().describe("Unix timestamp (milliseconds) to schedule the post's first publish at a future time. Must be in the future and at most 30 days out. Only valid for draft posts that haven't been published or already scheduled. Cannot be combined with status: 'draft' or 'archived'. Pass null to cancel a previously scheduled publish. The value 0 is treated the same as omitting the field (no scheduling request); note that on an already-scheduled post, omitting `scheduledAt` while changing `status` cancels the schedule."),
       "sendNewsletter": zod.union([zod.boolean(), zod.enum(["true", "false", "1", "0"])]).optional().describe("Whether to send an email newsletter to subscribers when the post publishes. Only meaningful when publishing (status: 'published') or scheduling (scheduledAt set). Default: false"),
-      "publishedAt": zod.number().min(updatePostBySlugBodyPublishedAtMin).optional().describe("Unix timestamp (milliseconds) to set as the post's publish date. Once set, the date is preserved across re-publishes.")
+      "publishedAt": zod.number().min(updatePostBySlugBodyPublishedAtMin).optional().describe("Unix timestamp (milliseconds) to set as the post's publish date. Once set, the date is preserved across re-publishes."),
+      "imageUrl": zod.string().url().optional().describe("URL of an image to set as the post's cover/hero image. The image is fetched, re-hosted on Paragraph's CDN, and a placeholder is generated. Pass clearImage: true instead to remove the existing cover."),
+      "clearImage": zod.boolean().optional().describe("When true, removes the post's existing cover/hero image. Ignored if imageUrl is also provided.")
     });
     updatePostBySlugResponse = zod.object({
       "success": zod.literal(true).describe("Whether the update succeeded")
@@ -8454,7 +8458,9 @@ async function updatePost(idOrSlug, params) {
     subtitle: params.subtitle,
     markdown: params.markdown,
     categories: params.tags,
-    publishedAt: params.publishedAt
+    publishedAt: params.publishedAt,
+    imageUrl: params.imageUrl,
+    clearImage: params.clearImage
   };
   updatePostBody.parse(body);
   const client = createClient(params.apiKey);
@@ -8747,22 +8753,24 @@ Examples:
       handleError(err);
     }
   });
-  const updateCmd = (parent) => parent.command("update [id-or-slug]").description("Update a post").option("--id <id-or-slug>", "Post ID or slug").option("--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("--published-at <time>", "Set the post's display publish date (ISO 8601 or Unix ms). Sticks across re-publishes \u2014 useful for backdating.").addHelpText("after", `
+  const updateCmd = (parent) => parent.command("update [id-or-slug]").description("Update a post").option("--id <id-or-slug>", "Post ID or slug").option("--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("--published-at <time>", "Set the post's display publish date (ISO 8601 or Unix ms). Sticks across re-publishes \u2014 useful for backdating.").option("--image-url <url>", "URL of an image to set as the post's cover. Fetched server-side, re-hosted on Paragraph's CDN.").option("--clear-image", "Remove the post's existing cover image. Ignored if --image-url is also provided.").addHelpText("after", `
 Examples:
   $ paragraph post update my-post --title "New Title"
   $ paragraph post update --id my-post --title "New Title"
   $ paragraph post update my-post --file ./updated.md
   $ cat updated.md | paragraph post update my-post
   $ paragraph post update my-post --tags "web3,defi" --json
-  $ paragraph post update my-post --published-at "2024-01-01T00:00:00Z"`).action(async function(idOrSlug, opts) {
+  $ paragraph post update my-post --published-at "2024-01-01T00:00:00Z"
+  $ paragraph post update my-post --image-url https://example.com/cover.jpg
+  $ paragraph post update my-post --clear-image`).action(async function(idOrSlug, opts) {
     try {
       const id = requireArg(idOrSlug, opts.id, "post ID or slug");
       const apiKey = requireApiKey();
       const markdown = await resolveMarkdown(opts);
       const publishedAt = opts.publishedAt ? parseScheduleTime(opts.publishedAt) : void 0;
-      if (!opts.title && !opts.subtitle && !markdown && !opts.tags && publishedAt === void 0) {
+      if (!opts.title && !opts.subtitle && !markdown && !opts.tags && publishedAt === void 0 && !opts.imageUrl && !opts.clearImage) {
         throw new Error(
-          "Nothing to update. Provide --title, --subtitle, --text, --file, --tags, or --published-at."
+          "Nothing to update. Provide --title, --subtitle, --text, --file, --tags, --published-at, --image-url, or --clear-image."
         );
       }
       await updatePost(id, {
@@ -8771,7 +8779,9 @@ Examples:
         markdown,
         subtitle: opts.subtitle,
         tags: opts.tags?.split(",").map((t) => t.trim()),
-        publishedAt
+        publishedAt,
+        imageUrl: opts.imageUrl,
+        clearImage: opts.clearImage
       });
       writeSuccess(`Post updated: ${id}`);
       outputData(
@@ -9886,7 +9896,7 @@ var init_email = __esm({
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
-  program2.name("paragraph").description("CLI for Paragraph").version("0.3.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.3.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.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "CLI for Paragraph",
   "repository": {
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "@inkjs/ui": "^2.0.0",
-    "@paragraph-com/sdk": "^2.2.0",
+    "@paragraph-com/sdk": "^2.2.1",
     "cli-table3": "^0.6.5",
     "commander": "^12.0.0",
     "ink": "^5.1.0",