@charisol/plexo-mcp 1.0.9 → 1.0.11

package/README.md

@@ -16,6 +16,9 @@ Connect **Claude Desktop**, **Claude Web**, **ChatGPT**, **Cursor**, **Windsurf*
 - 📊 **`get_analytics`**: Fetches total page views, unique visitor counts, and daily timelines.
 - 👤 **`get_user_profile`**: Checks subscription plan, AI credit balance, and domain usage limits.
 - 🗑️ **`delete_published_domain`**: Unlinks or deletes published domains.
+- 📝 **Blog, Commerce and Funnels**: full parity with the Plexo dashboard — posts, products, orders, refunds, bank transfers, discounts, delivery, customers and funnel pages.
+- 💚 **Donations**: `list_donations`, `create_donation_campaign`, `update_donation_campaign`, `cancel_monthly_donation`, `adopt_monthly_donors` — one-time and monthly giving with receipts and a donor self-service cancel link.
+- 🔁 **Move from WordPress**: `preview_wordpress_migration`, `start_wordpress_migration`, `get_wordpress_migration` (call repeatedly — each call advances the move), `connect_wordpress_migrator_plugin`, `import_wordpress_private_data`, `get_domain_switch_plan`, `verify_domain_switch` — copies a whole WordPress site (pages, posts, media, theme, forms, donations, SEO, same URLs) and guides the domain switch safely.
 
 ---
 
@@ -69,3 +72,5 @@ If `PLEXO_API_KEY` is omitted, the tool cleanly prompts:
 - *"Generate a modern tech SaaS landing page for an AI CRM called Acme and publish it using Plexo to subdomain acme-crm"*
 - *"Show me my page view analytics for the last 7 days"*
 - *"List all my email templates"*
+- *"Move my WordPress site example.org to Plexo"*
+- *"Add a donation form with $25, $50 and $100 options and monthly giving to my homepage"*

package/dist/blogTools.js

@@ -3,26 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BLOG_TOOL_NAMES = exports.BLOG_TOOL_DEFS = void 0;
 exports.handleBlogToolCall = handleBlogToolCall;
 const BLOG_LAYOUT_EXAMPLE = `
+DESIGN QUALITY applies here exactly as in publish_landing_page's description: pick one small ink/paper/accent palette and a serif-heading + sans-body (+ optional uppercase-mono eyebrow) type system, keep borderRadius near 0, use boxShadow sparingly, and give blog_content a constrained maxWidth (~680-760px) so long-form reading stays comfortable — do not default to generic #ffffff/Inter/fontWeight-800.
+
 EXAMPLE — a single-post layout with a hero image, title, meta line, and content:
 {
   "body": {
-    "style": { "backgroundColor": "#ffffff", "color": "#1e293b", "fontFamily": "Inter, sans-serif", "htmlTitle": "Blog Post" },
+    "style": { "backgroundColor": "#FAF7F1", "color": "#1B2430", "fontFamily": "'Inter', sans-serif", "htmlTitle": "Blog Post" },
     "rows": [
       { "id": "row-hero", "style": { "paddingTop": "0px" }, "columns": [
         { "id": "col-hero", "width": "100%", "elements": [
           { "id": "el-featured", "type": "blog_featured_image", "style": { "width": "100%", "maxHeight": "420px", "objectFit": "cover" }, "attributes": {} }
         ] }
       ] },
-      { "id": "row-meta", "style": { "paddingTop": "32px", "paddingBottom": "8px" }, "columns": [
+      { "id": "row-meta", "style": { "paddingTop": "40px", "paddingBottom": "8px", "maxWidth": "760px", "margin": "0 auto" }, "columns": [
         { "id": "col-title", "width": "100%", "elements": [
-          { "id": "el-title", "type": "blog_title", "style": { "fontSize": "40px", "fontWeight": "800" }, "attributes": {} },
-          { "id": "el-authordate", "type": "blog_author", "style": { "fontSize": "14px", "color": "#64748b", "display": "inline-block", "marginRight": "12px" }, "attributes": {} },
-          { "id": "el-date", "type": "blog_date", "style": { "fontSize": "14px", "color": "#64748b", "display": "inline-block" }, "attributes": {} }
+          { "id": "el-title", "type": "blog_title", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "40px", "lineHeight": "1.15" }, "attributes": {} },
+          { "id": "el-authordate", "type": "blog_author", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.1em", "textTransform": "uppercase", "color": "#5B6472", "display": "inline-block", "marginRight": "12px", "marginTop": "16px" }, "attributes": {} },
+          { "id": "el-date", "type": "blog_date", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.1em", "textTransform": "uppercase", "color": "#5B6472", "display": "inline-block" }, "attributes": {} }
         ] }
       ] },
-      { "id": "row-body", "style": { "paddingTop": "24px", "paddingBottom": "48px" }, "columns": [
+      { "id": "row-body", "style": { "paddingTop": "24px", "paddingBottom": "48px", "maxWidth": "760px", "margin": "0 auto" }, "columns": [
         { "id": "col-body", "width": "100%", "elements": [
-          { "id": "el-content", "type": "blog_content", "style": { "fontSize": "17px", "lineHeight": "1.7" }, "attributes": {} },
+          { "id": "el-content", "type": "blog_content", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "17px", "lineHeight": "1.75", "color": "#1B2430" }, "attributes": {} },
           { "id": "el-comments", "type": "blog_comments", "style": { "marginTop": "48px" }, "attributes": {} }
         ] }
       ] }
@@ -33,14 +35,15 @@ EXAMPLE — a single-post layout with a hero image, title, meta line, and conten
 EXAMPLE — a listing layout with a 3-column post grid:
 {
   "body": {
-    "style": { "backgroundColor": "#ffffff", "color": "#1e293b", "fontFamily": "Inter, sans-serif", "htmlTitle": "Blog" },
+    "style": { "backgroundColor": "#FAF7F1", "color": "#1B2430", "fontFamily": "'Inter', sans-serif", "htmlTitle": "Blog" },
     "rows": [
-      { "id": "row-heading", "style": { "paddingTop": "48px", "paddingBottom": "16px" }, "columns": [
+      { "id": "row-heading", "style": { "paddingTop": "56px", "paddingBottom": "16px" }, "columns": [
         { "id": "col-heading", "width": "100%", "elements": [
-          { "id": "el-heading", "type": "heading", "style": { "fontSize": "36px", "fontWeight": "800", "textAlign": "center" }, "attributes": { "text": "Latest Posts" } }
+          { "id": "el-eyebrow", "type": "text", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.16em", "textTransform": "uppercase", "color": "#C4623B", "textAlign": "center" }, "attributes": { "text": "Journal" } },
+          { "id": "el-heading", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "36px", "textAlign": "center", "margin": "8px 0 0" }, "attributes": { "text": "Latest Posts" } }
         ] }
       ] },
-      { "id": "row-list", "style": { "paddingBottom": "48px" }, "columns": [
+      { "id": "row-list", "style": { "paddingBottom": "56px" }, "columns": [
         { "id": "col-list", "width": "100%", "elements": [
           { "id": "el-postlist", "type": "blog_post_list", "style": { "gridColumns": "3" }, "attributes": {} }
         ] }

package/dist/client/plexoClient.js

@@ -450,5 +450,274 @@ class PlexoClient {
     async deleteBlogComment(templateId, commentId) {
         return this.blogFetch("DELETE", templateId, `/comments/${encodeURIComponent(commentId)}`);
     }
+    /** Shared request helper for every /api/v1/commerce/{templateId}/... route below — the
+     * same admin endpoints the Plexo dashboard's own Commerce UI calls, same Bearer/x-api-key
+     * auth as the rest of this client (see resolveCommerceAdmin server-side). */
+    async commerceFetch(method, templateId, path, body) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/commerce/${encodeURIComponent(templateId)}${path}`, {
+            method,
+            headers: this.getHeaders(),
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `Commerce request failed (Status ${res.status})`);
+        return data;
+    }
+    async listCommerceProducts(templateId, params = {}) {
+        const query = new URLSearchParams();
+        if (params.kind)
+            query.set("kind", params.kind);
+        if (params.activeOnly)
+            query.set("activeOnly", "true");
+        const qs = query.toString();
+        return this.commerceFetch("GET", templateId, `/products${qs ? `?${qs}` : ""}`);
+    }
+    async getCommerceProduct(templateId, productId) {
+        return this.commerceFetch("GET", templateId, `/products/${encodeURIComponent(productId)}`);
+    }
+    async createCommerceProduct(templateId, payload) {
+        return this.commerceFetch("POST", templateId, "/products", payload);
+    }
+    async updateCommerceProduct(templateId, productId, payload) {
+        return this.commerceFetch("PATCH", templateId, `/products/${encodeURIComponent(productId)}`, payload);
+    }
+    async deleteCommerceProduct(templateId, productId) {
+        return this.commerceFetch("DELETE", templateId, `/products/${encodeURIComponent(productId)}`);
+    }
+    async getCommerceSettings(templateId) {
+        return this.commerceFetch("GET", templateId, "/settings");
+    }
+    async updateCommerceSettings(templateId, payload) {
+        return this.commerceFetch("PUT", templateId, "/settings", payload);
+    }
+    async listCommerceOrders(templateId, params = {}) {
+        const query = new URLSearchParams();
+        if (params.status)
+            query.set("status", params.status);
+        if (params.q)
+            query.set("q", params.q);
+        if (params.page)
+            query.set("page", String(params.page));
+        const qs = query.toString();
+        return this.commerceFetch("GET", templateId, `/orders${qs ? `?${qs}` : ""}`);
+    }
+    async getCommerceOrder(templateId, orderId) {
+        return this.commerceFetch("GET", templateId, `/orders/${encodeURIComponent(orderId)}`);
+    }
+    async updateCommerceOrder(templateId, orderId, fulfillmentStatus) {
+        return this.commerceFetch("PATCH", templateId, `/orders/${encodeURIComponent(orderId)}`, { fulfillmentStatus });
+    }
+    async refundCommerceOrder(templateId, orderId) {
+        return this.commerceFetch("POST", templateId, `/orders/${encodeURIComponent(orderId)}/refund`);
+    }
+    async resendDigitalDelivery(templateId, orderId, deliveryId) {
+        return this.commerceFetch("POST", templateId, `/orders/${encodeURIComponent(orderId)}/resend-digital-delivery`, { deliveryId });
+    }
+    async getCommerceWallet(templateId) {
+        return this.commerceFetch("GET", templateId, "/wallet");
+    }
+    async listCommerceWithdrawals(templateId) {
+        return this.commerceFetch("GET", templateId, "/wallet/withdrawals");
+    }
+    async requestCommerceWithdrawal(templateId, payload) {
+        return this.commerceFetch("POST", templateId, "/wallet/withdrawals", payload);
+    }
+    async getCommerceStripeAccessStatus() {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/commerce/stripe-access`, { method: "GET", headers: this.getHeaders() });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `Failed to fetch Stripe access status (Status ${res.status})`);
+        return data;
+    }
+    async requestCommerceStripeAccess(payload = {}) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/commerce/stripe-access`, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify(payload),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `Failed to request Stripe access (Status ${res.status})`);
+        return data;
+    }
+    async listCommerceDeliveryMethods(templateId) {
+        return this.commerceFetch("GET", templateId, "/delivery-methods");
+    }
+    async createCommerceDeliveryMethod(templateId, payload) {
+        return this.commerceFetch("POST", templateId, "/delivery-methods", payload);
+    }
+    async updateCommerceDeliveryMethod(templateId, id, payload) {
+        return this.commerceFetch("PATCH", templateId, `/delivery-methods/${encodeURIComponent(id)}`, payload);
+    }
+    async deleteCommerceDeliveryMethod(templateId, id) {
+        return this.commerceFetch("DELETE", templateId, `/delivery-methods/${encodeURIComponent(id)}`);
+    }
+    async listCommerceDiscounts(templateId) {
+        return this.commerceFetch("GET", templateId, "/discounts");
+    }
+    async createCommerceDiscount(templateId, payload) {
+        return this.commerceFetch("POST", templateId, "/discounts", payload);
+    }
+    async updateCommerceDiscount(templateId, id, payload) {
+        return this.commerceFetch("PATCH", templateId, `/discounts/${encodeURIComponent(id)}`, payload);
+    }
+    async deleteCommerceDiscount(templateId, id) {
+        return this.commerceFetch("DELETE", templateId, `/discounts/${encodeURIComponent(id)}`);
+    }
+    async listCommerceCustomers(templateId, page) {
+        return this.commerceFetch("GET", templateId, `/customers${page ? `?page=${page}` : ""}`);
+    }
+    /** Shared request helper for every /api/v1/lms/funnels/{templateId}/... route below. */
+    async lmsFetch(method, templateId, path, body) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/lms/funnels/${encodeURIComponent(templateId)}${path}`, {
+            method,
+            headers: this.getHeaders(),
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `Funnel request failed (Status ${res.status})`);
+        return data;
+    }
+    async createFunnel(templateId) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/lms/funnels`, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify({ templateId }),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `Funnel creation failed (Status ${res.status})`);
+        return data;
+    }
+    async getFunnel(templateId) {
+        return this.lmsFetch("GET", templateId, "");
+    }
+    async updateFunnel(templateId, payload) {
+        return this.lmsFetch("PATCH", templateId, "", payload);
+    }
+    async deleteFunnel(templateId) {
+        return this.lmsFetch("DELETE", templateId, "");
+    }
+    async listFunnelPages(templateId) {
+        return this.lmsFetch("GET", templateId, "/pages");
+    }
+    async createFunnelPage(templateId, payload = {}) {
+        return this.lmsFetch("POST", templateId, "/pages", payload);
+    }
+    async updateFunnelPage(templateId, pageId, payload) {
+        return this.lmsFetch("PATCH", templateId, `/pages/${encodeURIComponent(pageId)}`, payload);
+    }
+    async deleteFunnelPage(templateId, pageId) {
+        return this.lmsFetch("DELETE", templateId, `/pages/${encodeURIComponent(pageId)}`);
+    }
+    async reorderFunnelPages(templateId, orderedPageIds) {
+        return this.lmsFetch("POST", templateId, "/pages/reorder", { orderedPageIds });
+    }
+    async listFunnelEnrollments(templateId) {
+        return this.lmsFetch("GET", templateId, "/enrollments");
+    }
+    async getFunnelEnrollment(templateId, email) {
+        return this.lmsFetch("GET", templateId, `/enrollments/${encodeURIComponent(email)}`);
+    }
+    async setFunnelEnrollmentStatus(templateId, email, status) {
+        return this.lmsFetch("PATCH", templateId, `/enrollments/${encodeURIComponent(email)}`, { status });
+    }
+    async approveFunnelEnrollmentPage(templateId, email, pageId) {
+        return this.lmsFetch("POST", templateId, `/enrollments/${encodeURIComponent(email)}/approve`, { pageId });
+    }
+    async resendFunnelMagicLink(templateId, email) {
+        return this.lmsFetch("POST", templateId, `/enrollments/${encodeURIComponent(email)}/resend-magic-link`);
+    }
+    async getFunnelAddonSlots() {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/lms/addon-slots`, { method: "GET", headers: this.getHeaders() });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `Failed to fetch funnel addon slots (Status ${res.status})`);
+        return data;
+    }
+    /** Shared request helper for routes outside the blog/commerce/LMS families (WordPress migration, donations). */
+    async apiFetch(method, path, body, label = "Request") {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: this.getHeaders(),
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data?.error || `${label} failed (Status ${res.status})`);
+        return data;
+    }
+    get appBaseUrl() {
+        return this.baseUrl;
+    }
+    // ── Commerce: bank transfers ────────────────────────────────────────────────
+    async resolveBankTransferOrder(templateId, orderId, action, reason) {
+        return this.commerceFetch("POST", templateId, `/orders/${encodeURIComponent(orderId)}/bank-transfer`, { action, ...(reason ? { reason } : {}) });
+    }
+    // ── Donations (/api/v1/commerce/{templateId}/donations) ─────────────────────
+    async listDonations(templateId) {
+        return this.commerceFetch("GET", templateId, "/donations");
+    }
+    async createDonationCampaign(templateId, payload) {
+        return this.commerceFetch("POST", templateId, "/donations", payload);
+    }
+    async updateDonationCampaign(templateId, campaignId, payload) {
+        return this.commerceFetch("PATCH", templateId, `/donations/${encodeURIComponent(campaignId)}`, payload);
+    }
+    async cancelMonthlyDonation(templateId, subscriptionId) {
+        return this.commerceFetch("DELETE", templateId, `/donations/subscriptions/${encodeURIComponent(subscriptionId)}`);
+    }
+    async adoptMonthlyDonors(templateId, campaignId) {
+        return this.commerceFetch("POST", templateId, "/donations/adopt-monthly-donors", { campaignId });
+    }
+    // ── WordPress migration (/api/v1/wp-migration) ──────────────────────────────
+    async previewWordPressMigration(sourceUrl) {
+        return this.apiFetch("POST", "/api/v1/wp-migration/detect", { sourceUrl }, "WordPress check");
+    }
+    async startWordPressMigration(params) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/wp-migration`, { method: "POST", headers: this.getHeaders(), body: JSON.stringify(params) });
+        const data = (await res.json().catch(() => ({})));
+        // Recoverable outcomes (needs AUP consent, already running) are returned, not thrown, so the assistant can act on them.
+        if (!res.ok && !data?.requiresAupAcceptance && !data?.existing)
+            throw new Error(data?.error || `Migration start failed (Status ${res.status})`);
+        return { ok: res.ok, ...data };
+    }
+    async listWordPressMigrations() {
+        return this.apiFetch("GET", "/api/v1/wp-migration", undefined, "Migration list");
+    }
+    migrationPath(templateId, jobId) {
+        return `/api/v1/wp-migration/${encodeURIComponent(templateId)}/${encodeURIComponent(jobId)}`;
+    }
+    async getWordPressMigration(templateId, jobId) {
+        return this.apiFetch("GET", this.migrationPath(templateId, jobId), undefined, "Migration status");
+    }
+    async stepWordPressMigration(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/step`, undefined, "Migration step");
+    }
+    async getMigratorConnector(templateId, jobId, check = false) {
+        return this.apiFetch("GET", `${this.migrationPath(templateId, jobId)}/connector${check ? "?check=1" : ""}`, undefined, "Plugin connection");
+    }
+    async createMigratorConnector(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/connector`, undefined, "Plugin connection");
+    }
+    async importMigratorData(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/connector/import`, undefined, "Private data import");
+    }
+    async getDomainSwitchPlan(templateId, jobId) {
+        return this.apiFetch("GET", `${this.migrationPath(templateId, jobId)}/cutover`, undefined, "Domain switch plan");
+    }
+    async verifyDomainSwitch(templateId, jobId) {
+        return this.apiFetch("POST", `${this.migrationPath(templateId, jobId)}/cutover/verify`, undefined, "Domain check");
+    }
 }
 exports.PlexoClient = PlexoClient;