@paragraph-com/cli 0.2.0 → 0.3.0

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";
@@ -8203,6 +8276,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({
@@ -9662,10 +9753,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.0", "-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 +9906,7 @@ function createProgram() {
   registerCoinCommands(program2);
   registerUserCommands(program2);
   registerAnalyticsCommands(program2);
+  registerEmailCommands(program2);
   return program2;
 }
 var init_program = __esm({
@@ -9699,6 +9921,7 @@ var init_program = __esm({
     init_coin();
     init_user();
     init_analytics2();
+    init_email();
   }
 });
 
@@ -10952,7 +11175,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 +11197,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 +11323,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 +11344,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.0",
   "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.0",
     "cli-table3": "^0.6.5",
     "commander": "^12.0.0",
     "ink": "^5.1.0",