@charisol/plexo-mcp 1.0.8 → 1.0.10

package/dist/client/plexoClient.js

@@ -147,15 +147,23 @@ class PlexoClient {
     /**
      * Creates a new page nested under an existing landing page (its home page
      * for a top-level page, or another sub-page's id to nest deeper) — how a
-     * single landing page becomes a multi-page site. Starts blank; use
-     * updateTemplate() with the returned templateId to add content.
+     * single landing page becomes a multi-page site. Starts blank unless
+     * htmlContent is given, in which case it's created as a RAW_UPLOAD page
+     * instead — see updateTemplate() (BUILDER) / updateRawLandingPage()
+     * (RAW_UPLOAD) to add/edit content afterward, depending on which mode.
      */
     async createLandingPageSubpage(params) {
         this.checkAuth();
         const res = await fetch(`${this.baseUrl}/api/templates`, {
             method: "POST",
             headers: this.getHeaders(),
-            body: JSON.stringify({ name: params.name, parentId: params.parentTemplateId, slug: params.slug }),
+            body: JSON.stringify({
+                name: params.name,
+                parentId: params.parentTemplateId,
+                slug: params.slug,
+                htmlContent: params.htmlContent,
+                acceptAup: params.acceptAup,
+            }),
         });
         const data = (await res.json());
         if (!res.ok) {
@@ -163,6 +171,68 @@ class PlexoClient {
         }
         return data;
     }
+    /**
+     * Creates a landing page from raw HTML supplied directly (no designJson),
+     * served byte-for-byte as given — a different storage mode from
+     * createLandingPage/publishLandingPage, which are for the drag-and-drop
+     * BUILDER pages built from designJson. Same endpoint upload-raw's REST
+     * multipart path uses, but with a JSON body — this client has no real
+     * file to upload.
+     */
+    async createRawLandingPage(params) {
+        this.checkAuth();
+        const res = await fetch(`${this.baseUrl}/api/v1/templates/upload-raw`, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify(params),
+        });
+        const data = (await res.json());
+        if (!res.ok) {
+            throw new Error(data?.error || `Raw landing page creation failed with status ${res.status}`);
+        }
+        return data;
+    }
+    /**
+     * Creates AND publishes a raw-HTML landing page in one call — the combined
+     * equivalent of createRawLandingPage() + publishExistingLandingPage().
+     */
+    async publishRawLandingPage(params) {
+        const created = await this.createRawLandingPage({
+            name: params.name,
+            htmlContent: params.htmlContent,
+            acceptAup: params.acceptAup,
+        });
+        const templateId = created?.templateId;
+        if (!templateId) {
+            throw new Error(created?.error || "Raw landing page creation did not return a templateId.");
+        }
+        const published = await this.publishExistingLandingPage({
+            templateId,
+            domain: params.domain,
+            type: params.type,
+        });
+        return { ...created, ...published };
+    }
+    /**
+     * Replaces an existing RAW_UPLOAD page's HTML in place, under the same
+     * template id — the editable URL, live URL, and domain (if published) are
+     * all unchanged. Same endpoint replace-upload's REST multipart path uses,
+     * but with a JSON body.
+     */
+    async updateRawLandingPage(params) {
+        this.checkAuth();
+        const { templateId, ...body } = params;
+        const res = await fetch(`${this.baseUrl}/api/v1/templates/${encodeURIComponent(templateId)}/replace-upload`, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify(body),
+        });
+        const data = (await res.json());
+        if (!res.ok) {
+            throw new Error(data?.error || `Raw landing page update failed with status ${res.status}`);
+        }
+        return data;
+    }
     /**
      * Returns every page belonging to the same multi-page site as templateId
      * — its home page plus all nested sub-pages. templateId can be the home
@@ -380,5 +450,198 @@ 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;
+    }
 }
 exports.PlexoClient = PlexoClient;