@paragraph-com/cli 0.2.0 → 0.3.1

package/dist/index.js

@@ -980,7 +980,7 @@ var require_command = __commonJS({
     var EventEmitter = __require("events").EventEmitter;
     var childProcess = __require("child_process");
     var path2 = __require("path");
-    var fs8 = __require("fs");
+    var fs9 = __require("fs");
     var process2 = __require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1913,10 +1913,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
           const localBin = path2.resolve(baseDir, baseName);
-          if (fs8.existsSync(localBin)) return localBin;
+          if (fs9.existsSync(localBin)) return localBin;
           if (sourceExt.includes(path2.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs8.existsSync(`${localBin}${ext}`)
+            (ext) => fs9.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1928,7 +1928,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs8.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs9.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
@@ -3266,7 +3266,7 @@ async function loadSellPeers() {
     throw err;
   }
 }
-var BASE_URL, currentApiKey, setCurrentApiKey, ParagraphApiError, customAxios, getParagraphAPI, QueryResult, executeAbi, permit2Abi, AnalyticsResource, AuthResource, MISSING_COIN_PEERS_MESSAGE, CoinsResource, FeedResource, MeResource, PostsResource, PublicationsResource, SearchResource, SubscribersResource, UsersResource, ParagraphAPI;
+var BASE_URL, currentApiKey, setCurrentApiKey, ParagraphApiError, customAxios, getParagraphAPI, QueryResult, executeAbi, permit2Abi, AnalyticsResource, AuthResource, MISSING_COIN_PEERS_MESSAGE, CoinsResource, EmailsResource, FeedResource, MeResource, PostsResource, PublicationsResource, SearchResource, SubscribersResource, UsersResource, ParagraphAPI;
 var init_dist = __esm({
   "node_modules/@paragraph-com/sdk/dist/index.mjs"() {
     "use strict";
@@ -3695,6 +3695,16 @@ var init_dist = __esm({
           }
         );
       };
+      const sendCustomEmail2 = (sendCustomEmailBody2) => {
+        return customAxios(
+          {
+            url: `/v1/emails/send`,
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            data: sendCustomEmailBody2
+          }
+        );
+      };
       const createAuthSession = (createAuthSessionBody2) => {
         return customAxios(
           {
@@ -3721,7 +3731,7 @@ var init_dist = __esm({
           }
         );
       };
-      return { getPublicationById, updatePublication: updatePublication2, getPublicationBySlug, getPublicationByDomain: getPublicationByDomain2, getSubscriberCount: getSubscriberCount2, getPostsFeed, getPostsByTag: getPostsByTag2, getPosts, getPostById, updatePost: updatePost2, deletePost: deletePost2, getPostByPublicationIdAndPostSlug, getPostByPublicationSlugAndPostSlug, createPost: createPost2, listOwnPosts, updatePostBySlug, deletePostBySlug, sendTestEmail: sendTestEmail2, getMe, getUser: getUser2, getUserByWallet, getCoin: getCoin2, getCoinByContract, getCoinHoldersById, getCoinHoldersByContract, getBuyArgsById, getBuyArgsByContract, getSellArgsById, getSellArgsByContract, getQuoteById, getQuoteByContract, getPopularCoins: getPopularCoins2, importSubscribers: importSubscribers2, addSubscriber: addSubscriber2, removeSubscriber: removeSubscriber2, listSubscribers: listSubscribers2, searchPosts: searchPosts2, searchBlogs: searchBlogs2, searchCoins: searchCoins2, analyticsQuery, analyticsSchema, createAuthSession, getAuthSession, deleteAuthSession };
+      return { getPublicationById, updatePublication: updatePublication2, getPublicationBySlug, getPublicationByDomain: getPublicationByDomain2, getSubscriberCount: getSubscriberCount2, getPostsFeed, getPostsByTag: getPostsByTag2, getPosts, getPostById, updatePost: updatePost2, deletePost: deletePost2, getPostByPublicationIdAndPostSlug, getPostByPublicationSlugAndPostSlug, createPost: createPost2, listOwnPosts, updatePostBySlug, deletePostBySlug, sendTestEmail: sendTestEmail2, getMe, getUser: getUser2, getUserByWallet, getCoin: getCoin2, getCoinByContract, getCoinHoldersById, getCoinHoldersByContract, getBuyArgsById, getBuyArgsByContract, getSellArgsById, getSellArgsByContract, getQuoteById, getQuoteByContract, getPopularCoins: getPopularCoins2, importSubscribers: importSubscribers2, addSubscriber: addSubscriber2, removeSubscriber: removeSubscriber2, listSubscribers: listSubscribers2, searchPosts: searchPosts2, searchBlogs: searchBlogs2, searchCoins: searchCoins2, analyticsQuery, analyticsSchema, sendCustomEmail: sendCustomEmail2, createAuthSession, getAuthSession, deleteAuthSession };
     };
     QueryResult = class {
       constructor(promise) {
@@ -4230,6 +4240,68 @@ var init_dist = __esm({
         throw new Error("Invalid identifier provided to getQuote.");
       }
     };
+    EmailsResource = class {
+      constructor(api) {
+        this.api = api;
+      }
+      /**
+       * Sends a custom email from your publication to a list of recipient
+       * addresses. Markdown body, rendered to HTML server-side. Each recipient
+       * receives the email individually with a mandatory unsubscribe footer.
+       * Requires an API key.
+       *
+       * **Eligibility:** Publications must be approved by Paragraph before they
+       * can send custom emails. Ineligible publications receive a 403.
+       *
+       * **Per-recipient filtering:**
+       * - Malformed addresses and known disposable domains are skipped (`invalid`).
+       * - Addresses that previously unsubscribed from this publication are skipped
+       *   (`suppressed`).
+       * - Skipped recipients are returned in the response; nothing is delivered to
+       *   them.
+       *
+       * **Caps:** Maximum of 10,000 addresses per call.
+       *
+       * **Async delivery:** A 200 response means recipients were accepted, not
+       * delivered. Sends are queued asynchronously.
+       *
+       * @example
+       * ```ts
+       * const api = new ParagraphAPI({ apiKey: "your-api-key" });
+       *
+       * // Send a markdown email to a list of recipients
+       * const { accepted, skipped } = await api.emails.send({
+       *   subject: "Hello from Paragraph",
+       *   body: "# Welcome\n\nThanks for reading.",
+       *   emails: ["reader@example.com", "another@example.com"],
+       * });
+       * console.log(`${accepted} queued, ${skipped.length} skipped`);
+       * skipped.forEach(s => console.log(`${s.email}: ${s.reason}`));
+       *
+       * // Dry run — check filtering without sending
+       * const preview = await api.emails.send({
+       *   subject: "Preview",
+       *   body: "Body here",
+       *   emails: ["reader@example.com"],
+       *   dryRun: true,
+       * });
+       * ```
+       *
+       * @param body - The email send request.
+       * @param body.subject - Subject line (1–998 characters).
+       * @param body.body - Markdown body, rendered to HTML server-side (max 100KB).
+       * @param body.emails - Recipient email addresses (max 10,000).
+       * @param body.dryRun - If true, run filtering and return the accepted/skipped
+       * split without scheduling delivery.
+       * @returns A promise resolving to `{ accepted, skipped }`. `accepted` is the
+       * number of recipients queued for delivery; `skipped` lists rejected
+       * recipients with their reason (`suppressed`, `invalid`, or
+       * `scheduling_failed`).
+       */
+      send(body) {
+        return this.api.sendCustomEmail(body);
+      }
+    };
     FeedResource = class {
       constructor(api) {
         this.api = api;
@@ -4899,6 +4971,7 @@ var init_dist = __esm({
         this.feed = new FeedResource(this.api);
         this.users = new UsersResource(this.api);
         this.coins = new CoinsResource(this.api);
+        this.emails = new EmailsResource(this.api);
         this.search = new SearchResource(this.api);
         this.me = new MeResource(this.api);
       }
@@ -7112,7 +7185,7 @@ var init_auth2 = __esm({
 
 // node_modules/@paragraph-com/sdk/dist/zod.mjs
 import * as zod from "zod";
-var getPublicationByIdParams, getPublicationByIdResponseSlugMax, getPublicationByIdResponseSummaryMax, getPublicationByIdResponse, updatePublicationParams, updatePublicationBodyNameMax, updatePublicationBodySummaryMax, updatePublicationBodyPinnedPostIdsItemMax, updatePublicationBodyPinnedPostIdsMax, updatePublicationBody, updatePublicationResponseSlugMax, updatePublicationResponseSummaryMax, updatePublicationResponse, getPublicationBySlugPathSlugMax, getPublicationBySlugParams, getPublicationBySlugResponseSlugMax, getPublicationBySlugResponseSummaryMax, getPublicationBySlugResponse, getPublicationByDomainParams, getPublicationByDomainResponseSlugMax, getPublicationByDomainResponseSummaryMax, getPublicationByDomainResponse, getSubscriberCountParams, getSubscriberCountResponse, getPostsFeedQueryLimitDefault, getPostsFeedQueryLimitMax, getPostsFeedQueryParams, getPostsFeedResponseItemsItemPostTitleMax, getPostsFeedResponseItemsItemPostSubtitleMax, getPostsFeedResponseItemsItemPostSlugMax, getPostsFeedResponseItemsItemPostAuthorsItemWalletAddressRegExp, getPostsFeedResponseItemsItemPostAuthorsItemBioMax, getPostsFeedResponseItemsItemPublicationSlugMax, getPostsFeedResponseItemsItemPublicationSummaryMax, getPostsFeedResponseItemsItemUserWalletAddressRegExp, getPostsFeedResponseItemsItemUserBioMax, getPostsFeedResponse, getPostsByTagParams, getPostsByTagQueryLimitDefault, getPostsByTagQueryLimitMax, getPostsByTagQueryParams, getPostsByTagResponseItemsItemTitleMax, getPostsByTagResponseItemsItemSubtitleMax, getPostsByTagResponseItemsItemSlugMax, getPostsByTagResponseItemsItemAuthorsItemWalletAddressRegExp, getPostsByTagResponseItemsItemAuthorsItemBioMax, getPostsByTagResponse, getPostsParams, getPostsQueryLimitDefault, getPostsQueryLimitMax, getPostsQueryParams, getPostsResponseItemsItemTitleMax, getPostsResponseItemsItemSubtitleMax, getPostsResponseItemsItemSlugMax, getPostsResponseItemsItemAuthorsItemWalletAddressRegExp, getPostsResponseItemsItemAuthorsItemBioMax, getPostsResponse, getPostByIdParams, getPostByIdQueryParams, getPostByIdResponseTitleMax, getPostByIdResponseSubtitleMax, getPostByIdResponseSlugMax, getPostByIdResponseAuthorsItemWalletAddressRegExp, getPostByIdResponseAuthorsItemBioMax, getPostByIdResponse, updatePostParams, updatePostBodyTitleMax, updatePostBodySubtitleMax, updatePostBodySlugMax, updatePostBodyPostPreviewMax, updatePostBodyScheduledAtMin, updatePostBodyPublishedAtMin, updatePostBody, updatePostResponse, deletePostParams, deletePostBody, deletePostResponse, getPostByPublicationIdAndPostSlugPathPostSlugMax, getPostByPublicationIdAndPostSlugParams, getPostByPublicationIdAndPostSlugQueryParams, getPostByPublicationIdAndPostSlugResponseTitleMax, getPostByPublicationIdAndPostSlugResponseSubtitleMax, getPostByPublicationIdAndPostSlugResponseSlugMax, getPostByPublicationIdAndPostSlugResponseAuthorsItemWalletAddressRegExp, getPostByPublicationIdAndPostSlugResponseAuthorsItemBioMax, getPostByPublicationIdAndPostSlugResponse, getPostByPublicationSlugAndPostSlugPathPublicationSlugMax, getPostByPublicationSlugAndPostSlugPathPostSlugMax, getPostByPublicationSlugAndPostSlugParams, getPostByPublicationSlugAndPostSlugQueryParams, getPostByPublicationSlugAndPostSlugResponseTitleMax, getPostByPublicationSlugAndPostSlugResponseSubtitleMax, getPostByPublicationSlugAndPostSlugResponseSlugMax, getPostByPublicationSlugAndPostSlugResponseAuthorsItemWalletAddressRegExp, getPostByPublicationSlugAndPostSlugResponseAuthorsItemBioMax, getPostByPublicationSlugAndPostSlugResponse, createPostBodyTitleMax, createPostBodySubtitleMax, createPostBodySlugMax, createPostBodyPostPreviewMax, createPostBodyScheduledAtMin, createPostBody, createPostResponse, listOwnPostsQueryLimitDefault, listOwnPostsQueryLimitMax, listOwnPostsQueryParams, listOwnPostsResponseItemsItemTitleMax, listOwnPostsResponseItemsItemSubtitleMax, listOwnPostsResponseItemsItemSlugMax, listOwnPostsResponseItemsItemAuthorsItemWalletAddressRegExp, listOwnPostsResponseItemsItemAuthorsItemBioMax, listOwnPostsResponse, updatePostBySlugPathSlugMax, updatePostBySlugParams, updatePostBySlugBodyTitleMax, updatePostBySlugBodySubtitleMax, updatePostBySlugBodySlugMax, updatePostBySlugBodyPostPreviewMax, updatePostBySlugBodyScheduledAtMin, updatePostBySlugBodyPublishedAtMin, updatePostBySlugBody, updatePostBySlugResponse, deletePostBySlugPathSlugMax, deletePostBySlugParams, deletePostBySlugBody, deletePostBySlugResponse, sendTestEmailParams, sendTestEmailBody, sendTestEmailResponse, getMeResponseSlugMax, getMeResponseSummaryMax, getMeResponse, getUserParams, getUserResponseWalletAddressRegExp, getUserResponseBioMax, getUserResponse, getUserByWalletPathWalletAddressRegExp, getUserByWalletParams, getUserByWalletResponseWalletAddressRegExp, getUserByWalletResponseBioMax, getUserByWalletResponse, getCoinParams, getCoinResponseContractAddressRegExp, getCoinResponse, getCoinByContractPathContractAddressRegExp, getCoinByContractParams, getCoinByContractResponseContractAddressRegExp, getCoinByContractResponse, getCoinHoldersByIdParams, getCoinHoldersByIdQueryLimitDefault, getCoinHoldersByIdQueryLimitMax, getCoinHoldersByIdQueryParams, getCoinHoldersByIdResponseItemsItemWalletAddressRegExp, getCoinHoldersByIdResponseItemsItemBalanceRegExp, getCoinHoldersByIdResponse, getCoinHoldersByContractPathContractAddressRegExp, getCoinHoldersByContractParams, getCoinHoldersByContractQueryLimitDefault, getCoinHoldersByContractQueryLimitMax, getCoinHoldersByContractQueryParams, getCoinHoldersByContractResponseItemsItemWalletAddressRegExp, getCoinHoldersByContractResponseItemsItemBalanceRegExp, getCoinHoldersByContractResponse, getBuyArgsByIdParams, getBuyArgsByIdQueryWalletAddressRegExp, getBuyArgsByIdQueryAmountRegExp, getBuyArgsByIdQueryParams, getBuyArgsByIdResponseCommandsRegExp, getBuyArgsByIdResponseInputsItemRegExp, getBuyArgsByIdResponse, getBuyArgsByContractPathContractAddressRegExp, getBuyArgsByContractParams, getBuyArgsByContractQueryWalletAddressRegExp, getBuyArgsByContractQueryAmountRegExp, getBuyArgsByContractQueryParams, getBuyArgsByContractResponseCommandsRegExp, getBuyArgsByContractResponseInputsItemRegExp, getBuyArgsByContractResponse, getSellArgsByIdParams, getSellArgsByIdQueryWalletAddressRegExp, getSellArgsByIdQueryAmountRegExp, getSellArgsByIdQueryParams, getSellArgsByIdResponseCommandsRegExp, getSellArgsByIdResponseInputsItemRegExp, getSellArgsByIdResponse, getSellArgsByContractPathContractAddressRegExp, getSellArgsByContractParams, getSellArgsByContractQueryWalletAddressRegExp, getSellArgsByContractQueryAmountRegExp, getSellArgsByContractQueryParams, getSellArgsByContractResponseCommandsRegExp, getSellArgsByContractResponseInputsItemRegExp, getSellArgsByContractResponse, getQuoteByIdParams, getQuoteByIdQueryAmountRegExp, getQuoteByIdQueryParams, getQuoteByIdResponse, getQuoteByContractParams, getQuoteByContractQueryAmountRegExp, getQuoteByContractQueryParams, getQuoteByContractResponse, getPopularCoinsResponseCoinsItemContractAddressRegExp, getPopularCoinsResponse, importSubscribersBody, importSubscribersResponse, addSubscriberBodyWalletRegExp, addSubscriberBody, addSubscriberResponse, removeSubscriberBodyWalletRegExp, removeSubscriberBody, removeSubscriberResponse, listSubscribersQueryLimitDefault, listSubscribersQueryLimitMax, listSubscribersQueryParams, listSubscribersResponseItemsItemWalletAddressRegExp, listSubscribersResponse, searchPostsQueryParams, searchPostsResponseItem, searchPostsResponse, searchBlogsQueryParams, searchBlogsResponseItem, searchBlogsResponse, searchCoinsQueryParams, searchCoinsResponseItem, searchCoinsResponse, analyticsQueryBody, analyticsQueryResponse, analyticsSchemaResponse, createAuthSessionBodyDeviceNameMax, createAuthSessionBodyCallbackUrlMax, createAuthSessionBody, getAuthSessionParams, getAuthSessionResponse, deleteAuthSessionParams, deleteAuthSessionResponse;
+var getPublicationByIdParams, getPublicationByIdResponseSlugMax, getPublicationByIdResponseSummaryMax, getPublicationByIdResponse, updatePublicationParams, updatePublicationBodyNameMax, updatePublicationBodySummaryMax, updatePublicationBodyPinnedPostIdsItemMax, updatePublicationBodyPinnedPostIdsMax, updatePublicationBody, updatePublicationResponseSlugMax, updatePublicationResponseSummaryMax, updatePublicationResponse, getPublicationBySlugPathSlugMax, getPublicationBySlugParams, getPublicationBySlugResponseSlugMax, getPublicationBySlugResponseSummaryMax, getPublicationBySlugResponse, getPublicationByDomainParams, getPublicationByDomainResponseSlugMax, getPublicationByDomainResponseSummaryMax, getPublicationByDomainResponse, getSubscriberCountParams, getSubscriberCountResponse, getPostsFeedQueryLimitDefault, getPostsFeedQueryLimitMax, getPostsFeedQueryParams, getPostsFeedResponseItemsItemPostTitleMax, getPostsFeedResponseItemsItemPostSubtitleMax, getPostsFeedResponseItemsItemPostSlugMax, getPostsFeedResponseItemsItemPostAuthorsItemWalletAddressRegExp, getPostsFeedResponseItemsItemPostAuthorsItemBioMax, getPostsFeedResponseItemsItemPublicationSlugMax, getPostsFeedResponseItemsItemPublicationSummaryMax, getPostsFeedResponseItemsItemUserWalletAddressRegExp, getPostsFeedResponseItemsItemUserBioMax, getPostsFeedResponse, getPostsByTagParams, getPostsByTagQueryLimitDefault, getPostsByTagQueryLimitMax, getPostsByTagQueryParams, getPostsByTagResponseItemsItemTitleMax, getPostsByTagResponseItemsItemSubtitleMax, getPostsByTagResponseItemsItemSlugMax, getPostsByTagResponseItemsItemAuthorsItemWalletAddressRegExp, getPostsByTagResponseItemsItemAuthorsItemBioMax, getPostsByTagResponse, getPostsParams, getPostsQueryLimitDefault, getPostsQueryLimitMax, getPostsQueryParams, getPostsResponseItemsItemTitleMax, getPostsResponseItemsItemSubtitleMax, getPostsResponseItemsItemSlugMax, getPostsResponseItemsItemAuthorsItemWalletAddressRegExp, getPostsResponseItemsItemAuthorsItemBioMax, getPostsResponse, getPostByIdParams, getPostByIdQueryParams, getPostByIdResponseTitleMax, getPostByIdResponseSubtitleMax, getPostByIdResponseSlugMax, getPostByIdResponseAuthorsItemWalletAddressRegExp, getPostByIdResponseAuthorsItemBioMax, getPostByIdResponse, updatePostParams, updatePostBodyTitleMax, updatePostBodySubtitleMax, updatePostBodySlugMax, updatePostBodyPostPreviewMax, updatePostBodyScheduledAtMin, updatePostBodyPublishedAtMin, updatePostBody, updatePostResponse, deletePostParams, deletePostBody, deletePostResponse, getPostByPublicationIdAndPostSlugPathPostSlugMax, getPostByPublicationIdAndPostSlugParams, getPostByPublicationIdAndPostSlugQueryParams, getPostByPublicationIdAndPostSlugResponseTitleMax, getPostByPublicationIdAndPostSlugResponseSubtitleMax, getPostByPublicationIdAndPostSlugResponseSlugMax, getPostByPublicationIdAndPostSlugResponseAuthorsItemWalletAddressRegExp, getPostByPublicationIdAndPostSlugResponseAuthorsItemBioMax, getPostByPublicationIdAndPostSlugResponse, getPostByPublicationSlugAndPostSlugPathPublicationSlugMax, getPostByPublicationSlugAndPostSlugPathPostSlugMax, getPostByPublicationSlugAndPostSlugParams, getPostByPublicationSlugAndPostSlugQueryParams, getPostByPublicationSlugAndPostSlugResponseTitleMax, getPostByPublicationSlugAndPostSlugResponseSubtitleMax, getPostByPublicationSlugAndPostSlugResponseSlugMax, getPostByPublicationSlugAndPostSlugResponseAuthorsItemWalletAddressRegExp, getPostByPublicationSlugAndPostSlugResponseAuthorsItemBioMax, getPostByPublicationSlugAndPostSlugResponse, createPostBodyTitleMax, createPostBodySubtitleMax, createPostBodySlugMax, createPostBodyPostPreviewMax, createPostBodyScheduledAtMin, createPostBody, createPostResponse, listOwnPostsQueryLimitDefault, listOwnPostsQueryLimitMax, listOwnPostsQueryParams, listOwnPostsResponseItemsItemTitleMax, listOwnPostsResponseItemsItemSubtitleMax, listOwnPostsResponseItemsItemSlugMax, listOwnPostsResponseItemsItemAuthorsItemWalletAddressRegExp, listOwnPostsResponseItemsItemAuthorsItemBioMax, listOwnPostsResponse, updatePostBySlugPathSlugMax, updatePostBySlugParams, updatePostBySlugBodyTitleMax, updatePostBySlugBodySubtitleMax, updatePostBySlugBodySlugMax, updatePostBySlugBodyPostPreviewMax, updatePostBySlugBodyScheduledAtMin, updatePostBySlugBodyPublishedAtMin, updatePostBySlugBody, updatePostBySlugResponse, deletePostBySlugPathSlugMax, deletePostBySlugParams, deletePostBySlugBody, deletePostBySlugResponse, sendTestEmailParams, sendTestEmailBody, sendTestEmailResponse, getMeResponseSlugMax, getMeResponseSummaryMax, getMeResponse, getUserParams, getUserResponseWalletAddressRegExp, getUserResponseBioMax, getUserResponse, getUserByWalletPathWalletAddressRegExp, getUserByWalletParams, getUserByWalletResponseWalletAddressRegExp, getUserByWalletResponseBioMax, getUserByWalletResponse, getCoinParams, getCoinResponseContractAddressRegExp, getCoinResponse, getCoinByContractPathContractAddressRegExp, getCoinByContractParams, getCoinByContractResponseContractAddressRegExp, getCoinByContractResponse, getCoinHoldersByIdParams, getCoinHoldersByIdQueryLimitDefault, getCoinHoldersByIdQueryLimitMax, getCoinHoldersByIdQueryParams, getCoinHoldersByIdResponseItemsItemWalletAddressRegExp, getCoinHoldersByIdResponseItemsItemBalanceRegExp, getCoinHoldersByIdResponse, getCoinHoldersByContractPathContractAddressRegExp, getCoinHoldersByContractParams, getCoinHoldersByContractQueryLimitDefault, getCoinHoldersByContractQueryLimitMax, getCoinHoldersByContractQueryParams, getCoinHoldersByContractResponseItemsItemWalletAddressRegExp, getCoinHoldersByContractResponseItemsItemBalanceRegExp, getCoinHoldersByContractResponse, getBuyArgsByIdParams, getBuyArgsByIdQueryWalletAddressRegExp, getBuyArgsByIdQueryAmountRegExp, getBuyArgsByIdQueryParams, getBuyArgsByIdResponseCommandsRegExp, getBuyArgsByIdResponseInputsItemRegExp, getBuyArgsByIdResponse, getBuyArgsByContractPathContractAddressRegExp, getBuyArgsByContractParams, getBuyArgsByContractQueryWalletAddressRegExp, getBuyArgsByContractQueryAmountRegExp, getBuyArgsByContractQueryParams, getBuyArgsByContractResponseCommandsRegExp, getBuyArgsByContractResponseInputsItemRegExp, getBuyArgsByContractResponse, getSellArgsByIdParams, getSellArgsByIdQueryWalletAddressRegExp, getSellArgsByIdQueryAmountRegExp, getSellArgsByIdQueryParams, getSellArgsByIdResponseCommandsRegExp, getSellArgsByIdResponseInputsItemRegExp, getSellArgsByIdResponse, getSellArgsByContractPathContractAddressRegExp, getSellArgsByContractParams, getSellArgsByContractQueryWalletAddressRegExp, getSellArgsByContractQueryAmountRegExp, getSellArgsByContractQueryParams, getSellArgsByContractResponseCommandsRegExp, getSellArgsByContractResponseInputsItemRegExp, getSellArgsByContractResponse, getQuoteByIdParams, getQuoteByIdQueryAmountRegExp, getQuoteByIdQueryParams, getQuoteByIdResponse, getQuoteByContractParams, getQuoteByContractQueryAmountRegExp, getQuoteByContractQueryParams, getQuoteByContractResponse, getPopularCoinsResponseCoinsItemContractAddressRegExp, getPopularCoinsResponse, importSubscribersBody, importSubscribersResponse, addSubscriberBodyWalletRegExp, addSubscriberBody, addSubscriberResponse, removeSubscriberBodyWalletRegExp, removeSubscriberBody, removeSubscriberResponse, listSubscribersQueryLimitDefault, listSubscribersQueryLimitMax, listSubscribersQueryParams, listSubscribersResponseItemsItemWalletAddressRegExp, listSubscribersResponse, searchPostsQueryParams, searchPostsResponseItem, searchPostsResponse, searchBlogsQueryParams, searchBlogsResponseItem, searchBlogsResponse, searchCoinsQueryParams, searchCoinsResponseItem, searchCoinsResponse, analyticsQueryBody, analyticsQueryResponse, analyticsSchemaResponse, sendCustomEmailBodySubjectMax, sendCustomEmailBodyBodyMax, sendCustomEmailBodyEmailsItemMin, sendCustomEmailBodyEmailsItemMax, sendCustomEmailBodyEmailsMax, sendCustomEmailBody, sendCustomEmailResponse, createAuthSessionBodyDeviceNameMax, createAuthSessionBodyCallbackUrlMax, createAuthSessionBody, getAuthSessionParams, getAuthSessionResponse, deleteAuthSessionParams, deleteAuthSessionResponse;
 var init_zod = __esm({
   "node_modules/@paragraph-com/sdk/dist/zod.mjs"() {
     "use strict";
@@ -7540,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")
@@ -7656,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"),
@@ -7730,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")
@@ -8203,6 +8280,24 @@ var init_zod = __esm({
         "is_nullable": zod.string()
       })).describe("One row per column, grouped by table in ordinal order")
     });
+    sendCustomEmailBodySubjectMax = 998;
+    sendCustomEmailBodyBodyMax = 1e5;
+    sendCustomEmailBodyEmailsItemMin = 3;
+    sendCustomEmailBodyEmailsItemMax = 254;
+    sendCustomEmailBodyEmailsMax = 1e4;
+    sendCustomEmailBody = zod.object({
+      "subject": zod.string().min(1).max(sendCustomEmailBodySubjectMax).describe("Subject line of the email"),
+      "body": zod.string().min(1).max(sendCustomEmailBodyBodyMax).describe("Email body. Markdown; rendered to HTML server-side. Max 100KB."),
+      "emails": zod.array(zod.string().min(sendCustomEmailBodyEmailsItemMin).max(sendCustomEmailBodyEmailsItemMax)).min(1).max(sendCustomEmailBodyEmailsMax).describe('Recipient email addresses (max 10,000). Malformed addresses are returned in `skipped` with `reason: "invalid"` rather than rejecting the whole request.'),
+      "dryRun": zod.boolean().optional().describe("If true, run filtering and return the accepted/skipped split without scheduling delivery")
+    });
+    sendCustomEmailResponse = zod.object({
+      "accepted": zod.number().describe("Number of recipients queued for delivery (or that would be queued when dryRun is true)"),
+      "skipped": zod.array(zod.object({
+        "email": zod.string(),
+        "reason": zod.enum(["suppressed", "invalid", "scheduling_failed"])
+      })).describe("Recipients that were rejected, with the reason each one was skipped. `scheduling_failed` means filtering passed but the delivery task could not be queued \u2014 retry these addresses.")
+    });
     createAuthSessionBodyDeviceNameMax = 100;
     createAuthSessionBodyCallbackUrlMax = 2048;
     createAuthSessionBody = zod.object({
@@ -8363,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);
@@ -8656,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, {
@@ -8680,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(
@@ -9662,10 +9763,140 @@ var init_analytics2 = __esm({
   }
 });
 
+// src/services/emails.ts
+async function sendCustomEmail(params) {
+  const client = createClient(params.apiKey);
+  return client.emails.send({
+    subject: params.subject,
+    body: params.body,
+    emails: params.emails,
+    ...params.dryRun ? { dryRun: true } : {}
+  });
+}
+var init_emails = __esm({
+  "src/services/emails.ts"() {
+    "use strict";
+    init_client();
+  }
+});
+
+// src/cli/commands/email.ts
+import * as fs6 from "fs";
+async function resolveBody(opts) {
+  if (opts.body) return opts.body;
+  if (opts.bodyFile) {
+    if (!fs6.existsSync(opts.bodyFile)) {
+      throw new Error(
+        `File not found: "${opts.bodyFile}". Check the path, or use --body <markdown> to pass content inline.`
+      );
+    }
+    return fs6.readFileSync(opts.bodyFile, "utf-8");
+  }
+  const stdin = await readStdin();
+  return stdin || void 0;
+}
+function collectRecipients(value, previous) {
+  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
+  return previous.concat(parts);
+}
+function registerEmailCommands(program2) {
+  const email = program2.command("email").description("Send custom emails from your publication");
+  email.command("send").description("Send a custom markdown email to a list of recipients").requiredOption("--subject <subject>", "Email subject").option("--body <markdown>", "Email body as markdown string").option("--body-file <path>", "Read email body from a file").option(
+    "--to <emails>",
+    "Recipient email (repeatable, or comma-separated)",
+    collectRecipients,
+    []
+  ).option(
+    "--dry-run",
+    "Run filtering and show the accepted/skipped split without sending"
+  ).option("--yes", "Skip the confirmation prompt before sending").addHelpText(
+    "after",
+    `
+Examples:
+  $ paragraph email send --subject "Hello" --body "# Hi" --to reader@example.com
+  $ paragraph email send --subject "Update" --body-file ./body.md --to a@x.com --to b@x.com
+  $ paragraph email send --subject "Update" --body-file ./body.md --to "a@x.com,b@x.com"
+  $ cat body.md | paragraph email send --subject "Update" --to reader@example.com
+  $ paragraph email send --subject "Update" --body "# Hi" --to a@x.com --dry-run`
+  ).action(async function(opts) {
+    try {
+      const apiKey = requireApiKey();
+      const body = await resolveBody(opts);
+      if (!body) {
+        throw new Error(
+          "Provide email body via --body, --body-file, or pipe to stdin."
+        );
+      }
+      const recipients = opts.to;
+      if (recipients.length === 0) {
+        throw new Error(
+          "Provide at least one recipient via --to <email>. Repeat the flag or pass a comma-separated list."
+        );
+      }
+      if (!opts.dryRun && !opts.yes) {
+        if (!process.stdin.isTTY) {
+          throw new Error(
+            "Cannot confirm send in non-interactive mode. Use --yes to confirm, or --dry-run to preview."
+          );
+        }
+        const ok = await confirm(
+          `Send "${opts.subject}" to ${recipients.length} recipient${recipients.length === 1 ? "" : "s"}?`
+        );
+        if (!ok) {
+          process.stderr.write("Aborted.\n");
+          process.exit(1);
+        }
+      }
+      const result = await sendCustomEmail({
+        apiKey,
+        subject: opts.subject,
+        body,
+        emails: recipients,
+        dryRun: opts.dryRun
+      });
+      const action = opts.dryRun ? "Dry run" : "Email queued";
+      writeSuccess(
+        `${action}: ${result.accepted} accepted, ${result.skipped.length} skipped`
+      );
+      if (result.skipped.length > 0) {
+        writeInfo("Skipped recipients:");
+        for (const s of result.skipped) {
+          process.stderr.write(`  ${s.email} \u2014 ${s.reason}
+`);
+        }
+      }
+      outputData(
+        this,
+        {
+          Subject: opts.subject,
+          Recipients: recipients.length,
+          Accepted: result.accepted,
+          Skipped: result.skipped.length,
+          DryRun: opts.dryRun ? "yes" : "no"
+        },
+        { ...result, dryRun: !!opts.dryRun }
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+var init_email = __esm({
+  "src/cli/commands/email.ts"() {
+    "use strict";
+    init_auth();
+    init_emails();
+    init_output();
+    init_error();
+    init_stdin();
+    init_prompt();
+  }
+});
+
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
-  program2.name("paragraph").description("CLI for Paragraph").version("0.2.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")) {
@@ -9685,6 +9916,7 @@ function createProgram() {
   registerCoinCommands(program2);
   registerUserCommands(program2);
   registerAnalyticsCommands(program2);
+  registerEmailCommands(program2);
   return program2;
 }
 var init_program = __esm({
@@ -9699,6 +9931,7 @@ var init_program = __esm({
     init_coin();
     init_user();
     init_analytics2();
+    init_email();
   }
 });
 
@@ -10952,7 +11185,7 @@ import { useState as useState9 } from "react";
 import { Box as Box21, Text as Text14, useInput as useInput17 } from "ink";
 import { TextInput as TextInput5, Spinner as Spinner9 } from "@inkjs/ui";
 import { StatusMessage as StatusMessage9 } from "@inkjs/ui";
-import * as fs6 from "fs";
+import * as fs7 from "fs";
 import { jsx as jsx23, jsxs as jsxs21 } from "react/jsx-runtime";
 function PostCreate() {
   const { goBack } = useNavigation();
@@ -10974,7 +11207,7 @@ function PostCreate() {
     try {
       let markdown = "";
       if (filePath) {
-        markdown = fs6.readFileSync(filePath, "utf-8");
+        markdown = fs7.readFileSync(filePath, "utf-8");
       } else {
         throw new Error("A file path is required for post content.");
       }
@@ -11100,7 +11333,7 @@ import { useState as useState10 } from "react";
 import { Box as Box22, Text as Text15, useInput as useInput18 } from "ink";
 import { TextInput as TextInput6, Spinner as Spinner10 } from "@inkjs/ui";
 import { StatusMessage as StatusMessage10 } from "@inkjs/ui";
-import * as fs7 from "fs";
+import * as fs8 from "fs";
 import { jsx as jsx24, jsxs as jsxs22 } from "react/jsx-runtime";
 function PostUpdate() {
   const { goBack, screen } = useNavigation();
@@ -11121,7 +11354,7 @@ function PostUpdate() {
     setStep("updating");
     try {
       let markdown;
-      if (filePath) markdown = fs7.readFileSync(filePath, "utf-8");
+      if (filePath) markdown = fs8.readFileSync(filePath, "utf-8");
       await updatePost(idOrSlug, {
         apiKey,
         title: title || void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paragraph-com/cli",
-  "version": "0.2.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.1.0",
+    "@paragraph-com/sdk": "^2.2.1",
     "cli-table3": "^0.6.5",
     "commander": "^12.0.0",
     "ink": "^5.1.0",