@paragraph-com/cli 0.1.0 → 0.2.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 fs6 = __require("fs");
+    var fs8 = __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 (fs6.existsSync(localBin)) return localBin;
+          if (fs8.existsSync(localBin)) return localBin;
           if (sourceExt.includes(path2.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs6.existsSync(`${localBin}${ext}`)
+            (ext) => fs8.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 = fs6.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs8.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, 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, FeedResource, MeResource, PostsResource, PublicationsResource, SearchResource, SubscribersResource, UsersResource, ParagraphAPI;
 var init_dist = __esm({
   "node_modules/@paragraph-com/sdk/dist/index.mjs"() {
     "use strict";
@@ -3330,6 +3330,16 @@ var init_dist = __esm({
           }
         );
       };
+      const updatePublication2 = (publicationId, updatePublicationBody2) => {
+        return customAxios(
+          {
+            url: `/v1/publications/${publicationId}`,
+            method: "PATCH",
+            headers: { "Content-Type": "application/json" },
+            data: updatePublicationBody2
+          }
+        );
+      };
       const getPublicationBySlug = (slug) => {
         return customAxios(
           {
@@ -3621,6 +3631,16 @@ var init_dist = __esm({
           }
         );
       };
+      const removeSubscriber2 = (removeSubscriberBody2) => {
+        return customAxios(
+          {
+            url: `/v1/subscribers`,
+            method: "DELETE",
+            headers: { "Content-Type": "application/json" },
+            data: removeSubscriberBody2
+          }
+        );
+      };
       const listSubscribers2 = (params) => {
         return customAxios(
           {
@@ -3657,6 +3677,24 @@ var init_dist = __esm({
           }
         );
       };
+      const analyticsQuery = (analyticsQueryBody2) => {
+        return customAxios(
+          {
+            url: `/v1/analytics/query`,
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            data: analyticsQueryBody2
+          }
+        );
+      };
+      const analyticsSchema = () => {
+        return customAxios(
+          {
+            url: `/v1/analytics/schema`,
+            method: "GET"
+          }
+        );
+      };
       const createAuthSession = (createAuthSessionBody2) => {
         return customAxios(
           {
@@ -3683,7 +3721,7 @@ var init_dist = __esm({
           }
         );
       };
-      return { getPublicationById, 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, listSubscribers: listSubscribers2, searchPosts: searchPosts2, searchBlogs: searchBlogs2, searchCoins: searchCoins2, 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, createAuthSession, getAuthSession, deleteAuthSession };
     };
     QueryResult = class {
       constructor(promise) {
@@ -3739,6 +3777,99 @@ var init_dist = __esm({
         ]
       }
     ];
+    AnalyticsResource = class {
+      constructor(api) {
+        this.api = api;
+      }
+      /**
+       * Executes a read-only SQL query against the analytics schema for your
+       * publication. The query runs in a transaction scoped to your publication —
+       * you do not need to (and cannot) reference a blog id in the SQL. Requires
+       * an API key.
+       *
+       * **SQL requirements:**
+       * - `SELECT` or `WITH` (CTE) statements only
+       * - Reference tables unprefixed (e.g. `FROM posts`) — the `analytics`
+       *   schema is the default `search_path`
+       * - No semicolons, writes, DDL, or superuser functions
+       * - Hard limit of 10,000 rows; excess rows are truncated and
+       *   `truncated: true` is returned
+       * - 30-second statement timeout
+       *
+       * Call {@link AnalyticsResource.schema} first if you need to discover the
+       * available tables and columns.
+       *
+       * @example
+       * ```ts
+       * const api = new ParagraphAPI({ apiKey: "your-api-key" });
+       *
+       * // Top 5 posts by views
+       * const { rows } = await api.analytics.query({
+       *   sql: `
+       *     SELECT title, total_views, open_rate
+       *     FROM post_analytics_summary
+       *     ORDER BY total_views DESC
+       *     LIMIT 5
+       *   `,
+       * });
+       * rows.forEach(r => console.log(r.title, r.total_views));
+       *
+       * // Subscriber count
+       * const { rows: [counts] } = await api.analytics.query({
+       *   sql: "SELECT active_count FROM blog_subscriber_counts",
+       * });
+       * console.log("Active subscribers:", counts.active_count);
+       *
+       * // Average open rate across the last 30 days
+       * const { rows: [avg] } = await api.analytics.query({
+       *   sql: `
+       *     SELECT AVG(open_rate) AS avg_open_rate
+       *     FROM post_analytics_summary
+       *     WHERE published_at > NOW() - INTERVAL '30 days'
+       *   `,
+       * });
+       * ```
+       *
+       * @param body - An object containing the SQL string.
+       * @param body.sql - A `SELECT` or `WITH` query against the analytics schema.
+       * @returns A promise that resolves to an object with `rows`, `rowCount`,
+       * `fields` (column names), and `truncated` (whether the 10,000-row cap was hit).
+       */
+      query(body) {
+        return this.api.analyticsQuery(body);
+      }
+      /**
+       * Returns column metadata for every table and view in the analytics schema.
+       * Useful for discovering available tables and columns before writing a query.
+       * Requires an API key.
+       *
+       * @example
+       * ```ts
+       * const api = new ParagraphAPI({ apiKey: "your-api-key" });
+       *
+       * const { tables } = await api.analytics.schema();
+       *
+       * // Group columns by table
+       * const byTable = new Map<string, string[]>();
+       * for (const col of tables) {
+       *   const cols = byTable.get(col.table_name) ?? [];
+       *   cols.push(`${col.column_name} (${col.data_type})`);
+       *   byTable.set(col.table_name, cols);
+       * }
+       * for (const [table, cols] of byTable) {
+       *   console.log(`\n${table}:`);
+       *   cols.forEach(c => console.log(`  - ${c}`));
+       * }
+       * ```
+       *
+       * @returns A promise that resolves to an object with a `tables` array,
+       * where each item describes one column (`table_name`, `column_name`,
+       * `data_type`, `is_nullable`).
+       */
+      schema() {
+        return this.api.analyticsSchema();
+      }
+    };
     AuthResource = class {
       constructor(api) {
         this.api = api;
@@ -4361,6 +4492,12 @@ var init_dist = __esm({
        *   id: "postId",
        *   scheduledAt: null,
        * });
+       *
+       * // Backdate a post — publishedAt sticks across re-publishes
+       * await api.posts.update({
+       *   id: "postId",
+       *   publishedAt: new Date("2024-01-01T00:00:00Z").getTime(),
+       * });
        * ```
        *
        * @param params - An object containing either `id` or `slug` to identify the post, plus the fields to update.
@@ -4469,6 +4606,45 @@ var init_dist = __esm({
         }
         throw new Error("Invalid identifier provided to get.");
       }
+      /**
+       * Updates settings for the publication associated with the API key.
+       * Only provided fields are updated; omitted fields remain unchanged.
+       * Requires an API key, and `publicationId` must match the publication that owns the key.
+       *
+       * @example
+       * ```ts
+       * const api = new ParagraphAPI({ apiKey: "your-api-key" });
+       *
+       * // Update name and theme
+       * await api.publications.update("publicationId", {
+       *   name: "My Blog",
+       *   themeColor: "purple-600",
+       *   headerFont: "serif",
+       * });
+       *
+       * // Pin posts to the top of the homepage (replaces the existing pinned list, max 50)
+       * await api.publications.update("publicationId", {
+       *   pinnedPostIds: ["postId1", "postId2"],
+       * });
+       *
+       * // Set a featured post — use a post ID, "latest", "popular", or "disabled"
+       * await api.publications.update("publicationId", {
+       *   featuredPost: "latest",
+       * });
+       *
+       * // Email notifications are merged onto existing settings; only the toggles you send change
+       * await api.publications.update("publicationId", {
+       *   emailNotifications: { newSubscriber: true },
+       * });
+       * ```
+       *
+       * @param publicationId - The unique identifier of the publication to update.
+       * @param body - The fields to update. See {@link UpdatePublicationBody}.
+       * @returns A promise that resolves to the updated publication.
+       */
+      update(publicationId, body) {
+        return this.api.updatePublication(publicationId, body);
+      }
     };
     SearchResource = class {
       constructor(api) {
@@ -4616,6 +4792,35 @@ var init_dist = __esm({
       create(body) {
         return this.api.addSubscriber(body);
       }
+      /**
+       * Removes a subscriber from the publication associated with the API key.
+       * The subscriber is identified by email, wallet, or both. If both are provided,
+       * they must resolve to the same user. This is a hard delete; consider calling
+       * `get()` first to confirm the subscriber exists. Requires an API key.
+       *
+       * @example
+       * ```ts
+       * const api = new ParagraphAPI({ apiKey: "your-api-key" });
+       *
+       * // Remove subscriber by email
+       * await api.subscribers.remove({ email: "user@example.com" });
+       *
+       * // Remove subscriber by wallet
+       * await api.subscribers.remove({ wallet: "0x1234..." });
+       *
+       * // Pass both — must resolve to the same user
+       * await api.subscribers.remove({
+       *   email: "user@example.com",
+       *   wallet: "0x1234...",
+       * });
+       * ```
+       *
+       * @param body - The subscriber to remove. At least one of email or wallet must be provided.
+       * @returns A promise that resolves to the result of the operation.
+       */
+      remove(body) {
+        return this.api.removeSubscriber(body);
+      }
       /**
        * Imports subscribers from a CSV file into the publication associated with the API key.
        * Requires an API key.
@@ -4686,6 +4891,7 @@ var init_dist = __esm({
       constructor(options) {
         this.apiKey = options?.apiKey;
         this.api = wrapAPIWithAuth(getParagraphAPI(), this.apiKey, setCurrentApiKey);
+        this.analytics = new AnalyticsResource(this.api);
         this.auth = new AuthResource(this.api);
         this.publications = new PublicationsResource(this.api);
         this.subscribers = new SubscribersResource(this.api);
@@ -4741,6 +4947,7 @@ async function validateApiKey(token) {
   const client = createClient(token);
   const me = await client.me.get();
   return {
+    id: me.id,
     name: me.name,
     slug: me.slug,
     customDomain: me.customDomain
@@ -4781,7 +4988,7 @@ async function waitForLogin(sessionId, signal) {
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       if (msg.includes("404") || msg.includes("Not found")) {
-        throw new Error("Login was denied or expired. Please try again.");
+        throw new Error("Login was denied or expired. For non-interactive use, pass the key directly: `paragraph login --token <key>` (get one at paragraph.com/settings \u2192 Publication \u2192 Developer).");
       }
       continue;
     }
@@ -4789,10 +4996,10 @@ async function waitForLogin(sessionId, signal) {
       return status.apiKey;
     }
     if (status.status !== "pending") {
-      throw new Error("Login was denied or expired. Please try again.");
+      throw new Error("Login was denied or expired. For non-interactive use, pass the key directly: `paragraph login --token <key>` (get one at paragraph.com/settings \u2192 Publication \u2192 Developer).");
     }
   }
-  throw new Error("Login timed out after 5 minutes. Please try again.");
+  throw new Error("Login timed out after 5 minutes. For non-interactive use, pass the key directly: `paragraph login --token <key>` (get one at paragraph.com/settings \u2192 Publication \u2192 Developer).");
 }
 function openBrowser(url) {
   return new Promise((resolve, reject) => {
@@ -6733,8 +6940,11 @@ function extractError(err) {
     const message = data?.message || err.message;
     if (status === 401) {
       return { message: "Unauthorized. Check your API key or run `paragraph login`.", status, code: errorCode(status) };
+    } else if (status === 403) {
+      return { message: "Forbidden. Your API key doesn't have access to this resource. Run `paragraph whoami --json` to verify which publication the key is for.", status, code: errorCode(status) };
     } else if (status === 404) {
-      return { message: "Not found. " + (message || ""), status, code: errorCode(status) };
+      const detail = message ? `${message}. ` : "";
+      return { message: `Not found. ${detail}Verify the identifier is correct \u2014 use the matching list command (e.g. \`paragraph post list --json\`, \`paragraph subscriber list --json\`) to find valid values.`, status, code: errorCode(status) };
     } else if (status === 429) {
       return { message: "Rate limited. Please wait and try again.", status, code: errorCode(status) };
     }
@@ -6822,7 +7032,7 @@ Examples:
           chunks.push(chunk);
         }
         token = Buffer.concat(chunks).toString("utf-8").trim();
-        if (!token) throw new Error("No API key received on stdin.");
+        if (!token) throw new Error("No API key received on stdin. Pipe the key (e.g. `echo $PARAGRAPH_API_KEY | paragraph login --with-token`) or use --token <key>.");
       } else if (!process.stdin.isTTY) {
         throw new Error(
           "No --token provided and stdin is not a TTY. Use --token <key> or --with-token."
@@ -6877,6 +7087,7 @@ Examples:
       const apiKey = requireApiKey();
       const me = await validateApiKey(apiKey);
       outputData(this, {
+        ID: me.id,
         Name: me.name,
         Slug: me.slug,
         Domain: me.customDomain
@@ -6901,7 +7112,7 @@ var init_auth2 = __esm({
 
 // node_modules/@paragraph-com/sdk/dist/zod.mjs
 import * as zod from "zod";
-var getPublicationByIdParams, getPublicationByIdResponseSlugMax, getPublicationByIdResponseSummaryMax, getPublicationByIdResponse, 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, 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, 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, listSubscribersQueryLimitDefault, listSubscribersQueryLimitMax, listSubscribersQueryParams, listSubscribersResponseItemsItemWalletAddressRegExp, listSubscribersResponse, searchPostsQueryParams, searchPostsResponseItem, searchPostsResponse, searchBlogsQueryParams, searchBlogsResponseItem, searchBlogsResponse, searchCoinsQueryParams, searchCoinsResponseItem, searchCoinsResponse, 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, createAuthSessionBodyDeviceNameMax, createAuthSessionBodyCallbackUrlMax, createAuthSessionBody, getAuthSessionParams, getAuthSessionResponse, deleteAuthSessionParams, deleteAuthSessionResponse;
 var init_zod = __esm({
   "node_modules/@paragraph-com/sdk/dist/zod.mjs"() {
     "use strict";
@@ -6917,7 +7128,86 @@ var init_zod = __esm({
       "slug": zod.string().min(1).max(getPublicationByIdResponseSlugMax).describe("URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]"),
       "customDomain": zod.string().url().optional().describe("Custom domain configured for this publication"),
       "summary": zod.string().max(getPublicationByIdResponseSummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
-      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image")
+      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image"),
+      "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+      "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+      "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+      "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+      "showMostPopular": zod.boolean().optional().describe("Whether the 'most popular posts' widget is shown"),
+      "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+      "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+      "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+      "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on this publication's posts"),
+      "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+      "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+      "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+      "pinnedPostIds": zod.array(zod.string()).optional().describe("Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed."),
+      "emailNotifications": zod.object({
+        "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+        "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+        "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+        "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+      }).optional().describe("Owner-side email notification toggles")
+    });
+    updatePublicationParams = zod.object({
+      "publicationId": zod.string().describe("Unique identifier of the publication to update")
+    });
+    updatePublicationBodyNameMax = 100;
+    updatePublicationBodySummaryMax = 500;
+    updatePublicationBodyPinnedPostIdsItemMax = 64;
+    updatePublicationBodyPinnedPostIdsMax = 50;
+    updatePublicationBody = zod.object({
+      "name": zod.string().min(1).max(updatePublicationBodyNameMax).optional().describe("Display name of the publication"),
+      "summary": zod.string().max(updatePublicationBodySummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
+      "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+      "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+      "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+      "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+      "showMostPopular": zod.boolean().optional().describe("Whether to show the 'most popular posts' widget"),
+      "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+      "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+      "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+      "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on posts"),
+      "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+      "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+      "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+      "pinnedPostIds": zod.array(zod.string().min(1).max(updatePublicationBodyPinnedPostIdsItemMax)).max(updatePublicationBodyPinnedPostIdsMax).optional().describe("Ordered list of post IDs to pin to the top of the homepage. Each ID must belong to this publication. Replaces the existing pinned list. Maximum 50 IDs."),
+      "emailNotifications": zod.object({
+        "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+        "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+        "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+        "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+      }).optional().describe("Owner-side email notification toggles")
+    });
+    updatePublicationResponseSlugMax = 256;
+    updatePublicationResponseSummaryMax = 500;
+    updatePublicationResponse = zod.object({
+      "id": zod.string().describe("Unique identifier for the publication"),
+      "name": zod.string().describe("Display name of the publication"),
+      "ownerUserId": zod.string().describe("ID of the user who owns this publication"),
+      "slug": zod.string().min(1).max(updatePublicationResponseSlugMax).describe("URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]"),
+      "customDomain": zod.string().url().optional().describe("Custom domain configured for this publication"),
+      "summary": zod.string().max(updatePublicationResponseSummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
+      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image"),
+      "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+      "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+      "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+      "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+      "showMostPopular": zod.boolean().optional().describe("Whether the 'most popular posts' widget is shown"),
+      "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+      "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+      "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+      "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on this publication's posts"),
+      "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+      "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+      "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+      "pinnedPostIds": zod.array(zod.string()).optional().describe("Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed."),
+      "emailNotifications": zod.object({
+        "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+        "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+        "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+        "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+      }).optional().describe("Owner-side email notification toggles")
     });
     getPublicationBySlugPathSlugMax = 256;
     getPublicationBySlugParams = zod.object({
@@ -6932,7 +7222,26 @@ var init_zod = __esm({
       "slug": zod.string().min(1).max(getPublicationBySlugResponseSlugMax).describe("URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]"),
       "customDomain": zod.string().url().optional().describe("Custom domain configured for this publication"),
       "summary": zod.string().max(getPublicationBySlugResponseSummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
-      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image")
+      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image"),
+      "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+      "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+      "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+      "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+      "showMostPopular": zod.boolean().optional().describe("Whether the 'most popular posts' widget is shown"),
+      "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+      "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+      "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+      "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on this publication's posts"),
+      "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+      "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+      "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+      "pinnedPostIds": zod.array(zod.string()).optional().describe("Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed."),
+      "emailNotifications": zod.object({
+        "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+        "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+        "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+        "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+      }).optional().describe("Owner-side email notification toggles")
     });
     getPublicationByDomainParams = zod.object({
       "domain": zod.string().describe("Custom domain of the publication")
@@ -6946,7 +7255,26 @@ var init_zod = __esm({
       "slug": zod.string().min(1).max(getPublicationByDomainResponseSlugMax).describe("URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]"),
       "customDomain": zod.string().url().optional().describe("Custom domain configured for this publication"),
       "summary": zod.string().max(getPublicationByDomainResponseSummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
-      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image")
+      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image"),
+      "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+      "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+      "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+      "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+      "showMostPopular": zod.boolean().optional().describe("Whether the 'most popular posts' widget is shown"),
+      "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+      "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+      "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+      "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on this publication's posts"),
+      "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+      "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+      "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+      "pinnedPostIds": zod.array(zod.string()).optional().describe("Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed."),
+      "emailNotifications": zod.object({
+        "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+        "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+        "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+        "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+      }).optional().describe("Owner-side email notification toggles")
     });
     getSubscriberCountParams = zod.object({
       "publicationId": zod.string().describe("Unique identifier of the publication")
@@ -6999,7 +7327,8 @@ var init_zod = __esm({
             }).optional().describe("Farcaster profile information, if linked")
           })).optional().describe("Authors of this post"),
           "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-          "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+          "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+          "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
         }).describe("The post content"),
         "publication": zod.object({
           "id": zod.string().describe("Unique identifier for the publication"),
@@ -7008,7 +7337,26 @@ var init_zod = __esm({
           "slug": zod.string().min(1).max(getPostsFeedResponseItemsItemPublicationSlugMax).describe("URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]"),
           "customDomain": zod.string().url().optional().describe("Custom domain configured for this publication"),
           "summary": zod.string().max(getPostsFeedResponseItemsItemPublicationSummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
-          "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image")
+          "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image"),
+          "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+          "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+          "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+          "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+          "showMostPopular": zod.boolean().optional().describe("Whether the 'most popular posts' widget is shown"),
+          "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+          "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+          "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+          "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on this publication's posts"),
+          "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+          "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+          "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+          "pinnedPostIds": zod.array(zod.string()).optional().describe("Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed."),
+          "emailNotifications": zod.object({
+            "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+            "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+            "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+            "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+          }).optional().describe("Owner-side email notification toggles")
         }).describe("The publication this post belongs to"),
         "user": zod.object({
           "id": zod.string().describe("Unique identifier for the user"),
@@ -7073,7 +7421,8 @@ var init_zod = __esm({
           }).optional().describe("Farcaster profile information, if linked")
         })).optional().describe("Authors of this post"),
         "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+        "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+        "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
       })).describe("Array of items in this page"),
       "pagination": zod.object({
         "cursor": zod.string().optional().describe("Cursor for fetching the next page of results"),
@@ -7124,7 +7473,8 @@ var init_zod = __esm({
           }).optional().describe("Farcaster profile information, if linked")
         })).optional().describe("Authors of this post"),
         "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+        "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+        "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
       })).describe("Array of items in this page"),
       "pagination": zod.object({
         "cursor": zod.string().optional().describe("Cursor for fetching the next page of results"),
@@ -7170,7 +7520,8 @@ var init_zod = __esm({
         }).optional().describe("Farcaster profile information, if linked")
       })).optional().describe("Authors of this post"),
       "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+      "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+      "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
     });
     updatePostParams = zod.object({
       "postId": zod.string().describe("Unique identifier of the post to update")
@@ -7180,6 +7531,7 @@ var init_zod = __esm({
     updatePostBodySlugMax = 256;
     updatePostBodyPostPreviewMax = 500;
     updatePostBodyScheduledAtMin = 0;
+    updatePostBodyPublishedAtMin = 0;
     updatePostBody = zod.object({
       "markdown": zod.string().optional().describe("Post content in Markdown format. Replaces full content \u2014 rich blocks created in the editor will be lost"),
       "title": zod.string().max(updatePostBodyTitleMax).optional().describe("Title of the post"),
@@ -7189,7 +7541,8 @@ var init_zod = __esm({
       "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."),
-      "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")
+      "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.")
     });
     updatePostResponse = zod.object({
       "success": zod.literal(true).describe("Whether the update succeeded")
@@ -7241,7 +7594,8 @@ var init_zod = __esm({
         }).optional().describe("Farcaster profile information, if linked")
       })).optional().describe("Authors of this post"),
       "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+      "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+      "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
     });
     getPostByPublicationSlugAndPostSlugPathPublicationSlugMax = 256;
     getPostByPublicationSlugAndPostSlugPathPostSlugMax = 256;
@@ -7284,7 +7638,8 @@ var init_zod = __esm({
         }).optional().describe("Farcaster profile information, if linked")
       })).optional().describe("Authors of this post"),
       "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-      "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+      "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+      "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
     });
     createPostBodyTitleMax = 200;
     createPostBodySubtitleMax = 300;
@@ -7348,7 +7703,8 @@ var init_zod = __esm({
           }).optional().describe("Farcaster profile information, if linked")
         })).optional().describe("Authors of this post"),
         "authorIds": zod.array(zod.string()).optional().describe("IDs of the authors of this post"),
-        "views": zod.number().optional().describe("Total page views. Only included when fetching your own posts via GET /v1/posts")
+        "views": zod.number().optional().describe("Total views. Only included when fetching your own posts via GET /v1/posts"),
+        "status": zod.enum(["published", "draft", "scheduled", "archived"]).optional().describe("Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state \u2014 publishedAt is preserved across unpublishing.")
       })).describe("Array of items in this page"),
       "pagination": zod.object({
         "cursor": zod.string().optional().describe("Cursor for fetching the next page of results"),
@@ -7365,6 +7721,7 @@ var init_zod = __esm({
     updatePostBySlugBodySlugMax = 256;
     updatePostBySlugBodyPostPreviewMax = 500;
     updatePostBySlugBodyScheduledAtMin = 0;
+    updatePostBySlugBodyPublishedAtMin = 0;
     updatePostBySlugBody = zod.object({
       "markdown": zod.string().optional().describe("Post content in Markdown format. Replaces full content \u2014 rich blocks created in the editor will be lost"),
       "title": zod.string().max(updatePostBySlugBodyTitleMax).optional().describe("Title of the post"),
@@ -7374,7 +7731,8 @@ var init_zod = __esm({
       "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."),
-      "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")
+      "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.")
     });
     updatePostBySlugResponse = zod.object({
       "success": zod.literal(true).describe("Whether the update succeeded")
@@ -7403,7 +7761,26 @@ var init_zod = __esm({
       "slug": zod.string().min(1).max(getMeResponseSlugMax).describe("URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]"),
       "customDomain": zod.string().url().optional().describe("Custom domain configured for this publication"),
       "summary": zod.string().max(getMeResponseSummaryMax).optional().describe("Brief description of the publication (max 500 characters)"),
-      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image")
+      "logoUrl": zod.string().url().optional().describe("URL to the publication's logo image"),
+      "postListType": zod.enum(["feed", "grid", "full-post"]).optional().describe("Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column."),
+      "themeColor": zod.enum(["default", "orange-500", "rose-600", "pink-500", "fuchsia-600", "purple-600", "violet-600", "indigo-600", "blue-600", "sky-600", "cyan-600", "teal-600", "emerald-600", "green-600", "lime-600", "yellow-700", "amber-600", "orange-600", "stone-800", "rose-900", "indigo-950", "teal-950", "lime-950", "orange-950"]).optional().describe("Theme accent color for the publication"),
+      "headerFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for headers"),
+      "bodyFont": zod.enum(["default", "serif", "mono"]).optional().describe("Font family used for body text"),
+      "showMostPopular": zod.boolean().optional().describe("Whether the 'most popular posts' widget is shown"),
+      "hideStats": zod.boolean().optional().describe("Whether to hide stats like subscriber count, post count, and collects"),
+      "featuredPost": zod.string().min(1).optional().describe("Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication."),
+      "disableComments": zod.union([zod.boolean(), zod.enum(["on-platform"])]).optional().describe("Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments."),
+      "disableHighlights": zod.boolean().optional().describe("Whether to disable highlights on this publication's posts"),
+      "enableTableOfContents": zod.boolean().optional().describe("Whether the table of contents is enabled on posts"),
+      "enableSubscribePopup": zod.boolean().optional().describe("Whether to show the subscribe popup to first-time visitors arriving from external links"),
+      "enableSubscribeScroll": zod.boolean().optional().describe("Whether to show the subscribe popup when first-time visitors scroll a post"),
+      "pinnedPostIds": zod.array(zod.string()).optional().describe("Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed."),
+      "emailNotifications": zod.object({
+        "newComment": zod.boolean().optional().describe("Email the writer when someone comments on a post"),
+        "newSubscriber": zod.boolean().optional().describe("Email the writer when a new free subscriber signs up"),
+        "newPaidSubscriber": zod.boolean().optional().describe("Email the writer when a new paid subscriber signs up"),
+        "newContentCollected": zod.boolean().optional().describe("Email the writer when someone collects their content")
+      }).optional().describe("Owner-side email notification toggles")
     });
     getUserParams = zod.object({
       "userId": zod.string().describe("Unique identifier of the user")
@@ -7699,6 +8076,14 @@ var init_zod = __esm({
     addSubscriberResponse = zod.object({
       "success": zod.literal(true).describe("Whether the subscriber was added")
     });
+    removeSubscriberBodyWalletRegExp = new RegExp("^0x[a-fA-F0-9]{40}$");
+    removeSubscriberBody = zod.object({
+      "email": zod.string().email().optional().describe("Email address of the subscriber to remove"),
+      "wallet": zod.string().regex(removeSubscriberBodyWalletRegExp).optional().describe("Wallet address of the subscriber to remove (0x format)")
+    });
+    removeSubscriberResponse = zod.object({
+      "success": zod.literal(true).describe("Whether the subscriber was removed")
+    });
     listSubscribersQueryLimitDefault = 10;
     listSubscribersQueryLimitMax = 100;
     listSubscribersQueryParams = zod.object({
@@ -7799,6 +8184,25 @@ var init_zod = __esm({
       "activeSubscriberCount": zod.number().describe("Number of active subscribers to this publication")
     });
     searchCoinsResponse = zod.array(searchCoinsResponseItem);
+    analyticsQueryBody = zod.object({
+      "sql": zod.string().min(1).describe("A SELECT or WITH query against the analytics schema. The analytics.* prefix is implicit.")
+    });
+    analyticsQueryResponse = zod.object({
+      "rows": zod.array(zod.record(zod.string(), zod.unknown())).describe("Result rows. Each row is a column-name \u2192 value map."),
+      "rowCount": zod.number().describe("Number of rows returned (after truncation if any)"),
+      "fields": zod.array(zod.object({
+        "name": zod.string()
+      })).describe("Column names in row order"),
+      "truncated": zod.boolean().describe("True if the result was truncated at the 10,000 row limit")
+    });
+    analyticsSchemaResponse = zod.object({
+      "tables": zod.array(zod.object({
+        "table_name": zod.string(),
+        "column_name": zod.string(),
+        "data_type": zod.string(),
+        "is_nullable": zod.string()
+      })).describe("One row per column, grouped by table in ordinal order")
+    });
     createAuthSessionBodyDeviceNameMax = 100;
     createAuthSessionBodyCallbackUrlMax = 2048;
     createAuthSessionBody = zod.object({
@@ -7846,9 +8250,15 @@ async function resolvePublication(identifier, apiKey) {
   }
   return getPublication(identifier, apiKey);
 }
+async function updatePublication(publicationId, body, apiKey) {
+  updatePublicationBody.parse(body);
+  const client = createClient(apiKey);
+  return client.publications.update(publicationId, body);
+}
 var init_publications = __esm({
   "src/services/publications.ts"() {
     "use strict";
+    init_zod();
     init_client();
   }
 });
@@ -7905,7 +8315,7 @@ async function resolveOwnPost(idOrSlug, apiKey) {
   const pub = await validateApiKey2(apiKey);
   const pubSlug = pub.slug;
   if (!pubSlug) {
-    throw new Error(`Post not found: ${idOrSlug}`);
+    throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   return getPostBySlugs(pubSlug, idOrSlug, apiKey);
 }
@@ -7952,7 +8362,8 @@ async function updatePost(idOrSlug, params) {
     title: params.title,
     subtitle: params.subtitle,
     markdown: params.markdown,
-    categories: params.tags
+    categories: params.tags,
+    publishedAt: params.publishedAt
   };
   updatePostBody.parse(body);
   const client = createClient(params.apiKey);
@@ -7960,7 +8371,7 @@ async function updatePost(idOrSlug, params) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -7974,7 +8385,7 @@ async function deletePost(idOrSlug, apiKey) {
     await client.posts.delete({ id: idOrSlug });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.delete({ slug: idOrSlug });
 }
@@ -7985,7 +8396,7 @@ async function updatePostStatus(idOrSlug, status, apiKey, sendNewsletter) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -7999,7 +8410,7 @@ async function schedulePost(idOrSlug, scheduledAt, apiKey, sendNewsletter) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -8010,7 +8421,7 @@ async function cancelSchedule(idOrSlug, apiKey) {
     await client.posts.update({ id: idOrSlug, ...body });
     return;
   } catch {
-    if (!isSlug(idOrSlug)) throw new Error(`Post not found: ${idOrSlug}`);
+    if (!isSlug(idOrSlug)) throw new Error(`Post not found: "${idOrSlug}". Run \`paragraph post list --json\` to see your posts, or use the full \`@publication/slug\` form for posts outside your publication.`);
   }
   await client.posts.update({ slug: idOrSlug, ...body });
 }
@@ -8086,7 +8497,7 @@ var init_prompt = __esm({
 // src/cli/lib/args.ts
 function requireArg(positional, flag, name, flagName = "--id") {
   if (positional && flag && positional !== flag) {
-    throw new Error(`Conflicting values for ${name}: "${positional}" (argument) vs "${flag}" (${flagName}).`);
+    throw new Error(`Conflicting values for ${name}: "${positional}" (argument) vs "${flag}" (${flagName}). Pass only one.`);
   }
   const value = positional || flag;
   if (!value) throw new Error(`Missing ${name}. Pass it as an argument or with ${flagName}.`);
@@ -8122,7 +8533,7 @@ async function resolveMarkdown(opts) {
   if (opts.text) return opts.text;
   if (opts.file) {
     if (!fs2.existsSync(opts.file)) {
-      throw new Error(`File not found: ${opts.file}`);
+      throw new Error(`File not found: "${opts.file}". Check the path, or use --text <markdown> to pass content inline.`);
     }
     return fs2.readFileSync(opts.file, "utf-8");
   }
@@ -8192,10 +8603,11 @@ Examples:
         limit: parseLimit(opts.limit),
         cursor: opts.cursor
       });
-      const headers = ["ID", "Title", "Date"];
+      const headers = ["ID", "Title", "Status", "Date"];
       const rows = result.items.map((p) => [
         p.id,
         p.title,
+        p.status ?? "\u2014",
         formatDate(p)
       ]);
       outputTable(this, headers, rows, result.items, { cursor: result.cursor });
@@ -8234,6 +8646,7 @@ Examples:
           Title: data.title,
           Subtitle: data.subtitle,
           Slug: data.slug,
+          Status: data.status ?? "\u2014",
           Date: formatDate(data),
           Content: preview
         },
@@ -8243,29 +8656,44 @@ 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").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.").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`).action(async function(idOrSlug, opts) {
+  $ 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) {
     try {
       const id = requireArg(idOrSlug, opts.id, "post ID or slug");
       const apiKey = requireApiKey();
       const markdown = await resolveMarkdown(opts);
-      if (!opts.title && !opts.subtitle && !markdown && !opts.tags) {
-        throw new Error("Nothing to update. Provide --title, --subtitle, --text, --file, or --tags.");
+      const publishedAt = opts.publishedAt ? parseScheduleTime(opts.publishedAt) : void 0;
+      if (!opts.title && !opts.subtitle && !markdown && !opts.tags && publishedAt === void 0) {
+        throw new Error(
+          "Nothing to update. Provide --title, --subtitle, --text, --file, --tags, or --published-at."
+        );
       }
       await updatePost(id, {
         apiKey,
         title: opts.title,
         markdown,
         subtitle: opts.subtitle,
-        tags: opts.tags?.split(",").map((t) => t.trim())
+        tags: opts.tags?.split(",").map((t) => t.trim()),
+        publishedAt
       });
       writeSuccess(`Post updated: ${id}`);
-      outputData(this, { ID: id }, { id, updated: true, title: opts.title, subtitle: opts.subtitle });
+      outputData(
+        this,
+        { ID: id },
+        {
+          id,
+          updated: true,
+          title: opts.title,
+          subtitle: opts.subtitle,
+          publishedAt
+        }
+      );
     } catch (err) {
       handleError(err);
     }
@@ -8518,6 +8946,7 @@ var init_post = __esm({
 });
 
 // src/cli/commands/publication.ts
+import * as fs3 from "fs";
 function registerPublicationCommands(program2) {
   const publication = program2.command("publication").description("Manage publications");
   publication.command("get [identifier]").description("Get publication details by ID, slug, or domain").option("--id <identifier>", "Publication ID, slug, or domain").addHelpText("after", `
@@ -8542,6 +8971,106 @@ Examples:
       handleError(err);
     }
   });
+  publication.command("update [publication-id]").description("Update publication settings (only provided fields are changed)").option("--id <id>", "Publication ID").option("--from-json <file>", "Read the full update body from a JSON file (merged with explicit flags; flags win)").option("--name <name>", "Display name").option("--summary <summary>", "Brief description (max 500 chars)").option("--theme-color <color>", "Theme accent color (e.g. 'purple-600', 'default')").option("--header-font <font>", "Header font: default | serif | mono").option("--body-font <font>", "Body font: default | serif | mono").option("--post-list-type <type>", "Homepage layout: feed | grid | full-post").option("--featured-post <selector>", "Post ID, or 'latest' | 'popular' | 'disabled'").option("--pinned-post-ids <ids>", "Comma-separated post IDs to pin (max 50, replaces existing list)").option("--disable-comments <value>", "Comment visibility: true | false | on-platform").option(
+    "--email-notifications <pairs>",
+    "Owner email toggles as key=value,... (keys: newComment, newSubscriber, newPaidSubscriber, newContentCollected)"
+  ).addHelpText("after", `
+Examples:
+  $ paragraph publication update abc123 --name "My Blog" --theme-color purple-600
+  $ paragraph publication update abc123 --featured-post latest
+  $ paragraph publication update abc123 --pinned-post-ids id1,id2,id3
+  $ paragraph publication update abc123 --disable-comments on-platform
+  $ paragraph publication update abc123 --email-notifications newSubscriber=true,newComment=false
+  $ paragraph publication update abc123 --from-json ./settings.json
+  $ paragraph publication update abc123 --from-json ./base.json --name "Override Name"`).action(async function(positionalId, opts) {
+    try {
+      const id = requireArg(positionalId, opts.id, "publication ID");
+      const apiKey = requireApiKey();
+      const body = {};
+      if (opts.fromJson) {
+        if (!fs3.existsSync(opts.fromJson)) {
+          throw new Error(`File not found: "${opts.fromJson}".`);
+        }
+        const parsed = JSON.parse(fs3.readFileSync(opts.fromJson, "utf-8"));
+        Object.assign(body, parsed);
+      }
+      if (opts.name !== void 0) body.name = opts.name;
+      if (opts.summary !== void 0) body.summary = opts.summary;
+      if (opts.themeColor !== void 0)
+        body.themeColor = opts.themeColor;
+      if (opts.headerFont !== void 0)
+        body.headerFont = opts.headerFont;
+      if (opts.bodyFont !== void 0) body.bodyFont = opts.bodyFont;
+      if (opts.postListType !== void 0)
+        body.postListType = opts.postListType;
+      if (opts.featuredPost !== void 0)
+        body.featuredPost = opts.featuredPost;
+      if (opts.pinnedPostIds !== void 0) {
+        const ids = opts.pinnedPostIds.split(",").map((s) => s.trim()).filter(Boolean);
+        if (ids.length > 50) {
+          throw new Error(
+            `--pinned-post-ids accepts at most 50 IDs (got ${ids.length}).`
+          );
+        }
+        body.pinnedPostIds = ids;
+      }
+      if (opts.disableComments !== void 0) {
+        const v = opts.disableComments;
+        if (v === "true") body.disableComments = true;
+        else if (v === "false") body.disableComments = false;
+        else if (v === "on-platform") body.disableComments = "on-platform";
+        else
+          throw new Error(
+            `--disable-comments must be 'true', 'false', or 'on-platform' (got "${v}").`
+          );
+      }
+      if (opts.emailNotifications !== void 0) {
+        const pairs = opts.emailNotifications.split(",").map((s) => s.trim()).filter(Boolean);
+        const allowed = /* @__PURE__ */ new Set([
+          "newComment",
+          "newSubscriber",
+          "newPaidSubscriber",
+          "newContentCollected"
+        ]);
+        const out = {};
+        for (const pair of pairs) {
+          const [key, value] = pair.split("=");
+          if (!allowed.has(key)) {
+            throw new Error(
+              `--email-notifications: unknown key "${key}". Allowed: newComment, newSubscriber, newPaidSubscriber, newContentCollected.`
+            );
+          }
+          if (value !== "true" && value !== "false") {
+            throw new Error(
+              `--email-notifications: value for "${key}" must be 'true' or 'false' (got "${value}").`
+            );
+          }
+          out[key] = value === "true";
+        }
+        body.emailNotifications = out;
+      }
+      if (Object.keys(body).length === 0) {
+        throw new Error(
+          "Nothing to update. Provide at least one field flag, or pass --from-json <file>."
+        );
+      }
+      const updated = await updatePublication(id, body, apiKey);
+      writeSuccess(`Publication updated: ${updated.name}`);
+      outputData(
+        this,
+        {
+          ID: updated.id,
+          Name: updated.name,
+          Slug: updated.slug,
+          Theme: updated.themeColor,
+          "Pinned posts": updated.pinnedPostIds?.length ?? 0
+        },
+        updated
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
 }
 var init_publication = __esm({
   "src/cli/commands/publication.ts"() {
@@ -8624,7 +9153,7 @@ var init_search2 = __esm({
 });
 
 // src/services/subscribers.ts
-import * as fs3 from "fs";
+import * as fs4 from "fs";
 async function listSubscribers(apiKey, pagination) {
   const client = createClient(apiKey);
   const result = await client.subscribers.get(
@@ -8635,6 +9164,16 @@ async function listSubscribers(apiKey, pagination) {
 }
 async function getSubscriberCount(publicationId) {
   const client = createClient();
+  try {
+    await client.publications.get({ id: publicationId }).single();
+  } catch (err) {
+    if (err instanceof ParagraphApiError && err.status === 404) {
+      throw new Error(
+        `Invalid publication ID "${publicationId}". Run \`paragraph whoami --json\` to get the valid publication ID.`
+      );
+    }
+    throw err;
+  }
   const result = await client.subscribers.getCount({ id: publicationId });
   return result.count || 0;
 }
@@ -8643,9 +9182,14 @@ async function addSubscriber(params, apiKey) {
   const client = createClient(apiKey);
   await client.subscribers.create(params);
 }
+async function removeSubscriber(params, apiKey) {
+  removeSubscriberBody.parse(params);
+  const client = createClient(apiKey);
+  await client.subscribers.remove(params);
+}
 async function importSubscribers(csvPath, apiKey) {
   const client = createClient(apiKey);
-  const csvContent = fs3.readFileSync(csvPath, "utf-8");
+  const csvContent = fs4.readFileSync(csvPath, "utf-8");
   const file = new Blob([csvContent], { type: "text/csv" });
   await client.subscribers.importCsv({ file });
 }
@@ -8653,6 +9197,7 @@ var init_subscribers = __esm({
   "src/services/subscribers.ts"() {
     "use strict";
     init_zod();
+    init_dist();
     init_client();
   }
 });
@@ -8696,7 +9241,17 @@ Examples:
   $ paragraph subscriber count --publication abc123
   $ paragraph subscriber count abc123 --json`).action(async function(positionalId, opts) {
     try {
-      const id = requireArg(positionalId, opts.publication, "publication ID", "--publication");
+      const id = positionalId || opts.publication;
+      if (!id) {
+        throw new Error(
+          "Missing publication ID. Run `paragraph whoami --json` to get the publication ID, then pass it as an argument or with --publication."
+        );
+      }
+      if (positionalId && opts.publication && positionalId !== opts.publication) {
+        throw new Error(
+          `Conflicting values for publication ID: "${positionalId}" (argument) vs "${opts.publication}" (--publication).`
+        );
+      }
       const count = await getSubscriberCount(id);
       outputData(this, { Count: count }, { count });
     } catch (err) {
@@ -8720,6 +9275,41 @@ Examples:
       handleError(err);
     }
   });
+  subscriber.command("remove").description("Remove a subscriber by email or wallet address (hard delete, irreversible)").option("--email <email>", "Subscriber email address").option("--wallet <address>", "Subscriber wallet address (0x format)").option("--yes", "Skip confirmation prompt").addHelpText("after", `
+Examples:
+  $ paragraph subscriber remove --email user@example.com
+  $ paragraph subscriber remove --wallet 0x1234...abcd
+  $ paragraph subscriber remove --email user@example.com --yes
+  $ paragraph subscriber remove --email user@example.com --json --yes`).action(async function(opts) {
+    try {
+      if (!opts.email && !opts.wallet) {
+        throw new Error("Provide --email or --wallet (or both).");
+      }
+      const apiKey = requireApiKey();
+      const target = opts.email || opts.wallet;
+      if (!opts.yes) {
+        const ok = await confirm(
+          `Permanently remove subscriber ${target}? This cannot be undone.`
+        );
+        if (!ok) {
+          writeInfo("Cancelled.");
+          return;
+        }
+      }
+      await removeSubscriber(
+        { email: opts.email, wallet: opts.wallet },
+        apiKey
+      );
+      writeSuccess(`Subscriber removed: ${target}`);
+      outputData(
+        this,
+        { Email: opts.email, Wallet: opts.wallet },
+        { email: opts.email, wallet: opts.wallet, removed: true }
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
   subscriber.command("import").description("Import subscribers from a CSV file").requiredOption("--csv <file>", "Path to CSV file").addHelpText("after", `
 Examples:
   $ paragraph subscriber import --csv ./subscribers.csv
@@ -8741,6 +9331,7 @@ var init_subscriber = __esm({
     init_subscribers();
     init_output();
     init_error();
+    init_prompt();
     init_args();
   }
 });
@@ -8960,10 +9551,121 @@ var init_user = __esm({
   }
 });
 
+// src/services/analytics.ts
+async function runQuery(sql, apiKey) {
+  const client = createClient(apiKey);
+  return client.analytics.query({ sql });
+}
+async function getSchema(apiKey) {
+  const client = createClient(apiKey);
+  return client.analytics.schema();
+}
+var init_analytics = __esm({
+  "src/services/analytics.ts"() {
+    "use strict";
+    init_client();
+  }
+});
+
+// src/cli/commands/analytics.ts
+import * as fs5 from "fs";
+async function resolveSql(opts) {
+  if (opts.sql) return opts.sql;
+  if (opts.file) {
+    if (!fs5.existsSync(opts.file)) {
+      throw new Error(`File not found: "${opts.file}".`);
+    }
+    return fs5.readFileSync(opts.file, "utf-8");
+  }
+  const stdin = await readStdin();
+  return stdin || void 0;
+}
+function registerAnalyticsCommands(program2) {
+  const cmd = program2.command("analytics").description("Query your publication's analytics data");
+  cmd.command("query").description("Run a read-only SQL query against the analytics schema").option("--sql <sql>", "SQL string (SELECT or WITH only)").option("--file <path>", "Read SQL from a file").addHelpText("after", `
+Examples:
+  $ paragraph analytics query --sql "SELECT * FROM blog_subscriber_counts"
+  $ paragraph analytics query --file ./query.sql
+  $ paragraph analytics query --file ./query.sql --json
+  $ echo "SELECT title, total_views FROM post_analytics_summary ORDER BY total_views DESC LIMIT 5" | paragraph analytics query`).action(async function(opts) {
+    try {
+      const sql = await resolveSql(opts);
+      if (!sql) {
+        throw new Error(
+          "Provide SQL via --sql, --file, or pipe to stdin."
+        );
+      }
+      const apiKey = requireApiKey();
+      const result = await runQuery(sql, apiKey);
+      if (isJsonMode(this)) {
+        outputData(this, {}, result);
+        return;
+      }
+      if (result.rows.length === 0) {
+        writeInfo("No rows.");
+        return;
+      }
+      const headers = result.fields.map((f) => f.name);
+      const rows = result.rows.map(
+        (r) => headers.map((h) => {
+          const v = r[h];
+          if (v === null || v === void 0) return "";
+          if (typeof v === "object") return JSON.stringify(v);
+          return String(v);
+        })
+      );
+      outputTable(this, headers, rows, result.rows);
+      const summary = `${result.rowCount} row${result.rowCount === 1 ? "" : "s"}${result.truncated ? " (truncated at 10,000)" : ""}`;
+      writeInfo(summary);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  cmd.command("schema").description("List all tables and columns in the analytics schema").option("--table <name>", "Filter to columns of a single table").addHelpText("after", `
+Examples:
+  $ paragraph analytics schema
+  $ paragraph analytics schema --table post_analytics_summary
+  $ paragraph analytics schema --json`).action(async function(opts) {
+    try {
+      const apiKey = requireApiKey();
+      const result = await getSchema(apiKey);
+      const items8 = opts.table ? result.tables.filter((c) => c.table_name === opts.table) : result.tables;
+      if (opts.table && items8.length === 0) {
+        throw new Error(
+          `No table named "${opts.table}". Run \`paragraph analytics schema\` to list available tables.`
+        );
+      }
+      outputTable(
+        this,
+        ["Table", "Column", "Type", "Nullable"],
+        items8.map((c) => [
+          c.table_name,
+          c.column_name,
+          c.data_type,
+          c.is_nullable
+        ]),
+        items8
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+var init_analytics2 = __esm({
+  "src/cli/commands/analytics.ts"() {
+    "use strict";
+    init_auth();
+    init_analytics();
+    init_stdin();
+    init_output();
+    init_error();
+  }
+});
+
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
-  program2.name("paragraph").description("CLI for Paragraph").version("0.1.0", "-v, --version").option("--json", "Output as JSON").option("--verbose", "Show detailed output for debugging").exitOverride().configureOutput({
+  program2.name("paragraph").description("CLI for Paragraph").version("0.2.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")) {
@@ -8982,6 +9684,7 @@ function createProgram() {
   registerSubscriberCommands(program2);
   registerCoinCommands(program2);
   registerUserCommands(program2);
+  registerAnalyticsCommands(program2);
   return program2;
 }
 var init_program = __esm({
@@ -8995,6 +9698,7 @@ var init_program = __esm({
     init_subscriber();
     init_coin();
     init_user();
+    init_analytics2();
   }
 });
 
@@ -10248,7 +10952,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 fs4 from "fs";
+import * as fs6 from "fs";
 import { jsx as jsx23, jsxs as jsxs21 } from "react/jsx-runtime";
 function PostCreate() {
   const { goBack } = useNavigation();
@@ -10270,7 +10974,7 @@ function PostCreate() {
     try {
       let markdown = "";
       if (filePath) {
-        markdown = fs4.readFileSync(filePath, "utf-8");
+        markdown = fs6.readFileSync(filePath, "utf-8");
       } else {
         throw new Error("A file path is required for post content.");
       }
@@ -10396,7 +11100,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 fs5 from "fs";
+import * as fs7 from "fs";
 import { jsx as jsx24, jsxs as jsxs22 } from "react/jsx-runtime";
 function PostUpdate() {
   const { goBack, screen } = useNavigation();
@@ -10417,7 +11121,7 @@ function PostUpdate() {
     setStep("updating");
     try {
       let markdown;
-      if (filePath) markdown = fs5.readFileSync(filePath, "utf-8");
+      if (filePath) markdown = fs7.readFileSync(filePath, "utf-8");
       await updatePost(idOrSlug, {
         apiKey,
         title: title || void 0,