@charisol/plexo-mcp 1.0.8 → 1.0.10

package/src/client/plexoClient.ts

@@ -196,19 +196,29 @@ export 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: {
     parentTemplateId: string;
     name: string;
     slug?: string;
+    htmlContent?: string;
+    acceptAup?: boolean;
   }): Promise<any> {
     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()) as any;
@@ -219,6 +229,81 @@ export 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: { name?: string; htmlContent: string; acceptAup?: boolean }): Promise<any> {
+    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()) as any;
+    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: {
+    name?: string;
+    htmlContent: string;
+    acceptAup?: boolean;
+    domain: string;
+    type?: "SUBDOMAIN" | "CUSTOM";
+  }): Promise<any> {
+    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: { templateId: string; htmlContent: string; name?: string }): Promise<any> {
+    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()) as any;
+    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
@@ -485,4 +570,229 @@ export class PlexoClient {
   async deleteBlogComment(templateId: string, commentId: string): Promise<any> {
     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). */
+  private async commerceFetch(method: string, templateId: string, path: string, body?: unknown): Promise<any> {
+    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(() => ({}))) as any;
+    if (!res.ok) throw new Error(data?.error || `Commerce request failed (Status ${res.status})`);
+    return data;
+  }
+
+  async listCommerceProducts(templateId: string, params: { kind?: string; activeOnly?: boolean } = {}): Promise<any> {
+    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: string, productId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, `/products/${encodeURIComponent(productId)}`);
+  }
+
+  async createCommerceProduct(templateId: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("POST", templateId, "/products", payload);
+  }
+
+  async updateCommerceProduct(templateId: string, productId: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("PATCH", templateId, `/products/${encodeURIComponent(productId)}`, payload);
+  }
+
+  async deleteCommerceProduct(templateId: string, productId: string): Promise<any> {
+    return this.commerceFetch("DELETE", templateId, `/products/${encodeURIComponent(productId)}`);
+  }
+
+  async getCommerceSettings(templateId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, "/settings");
+  }
+
+  async updateCommerceSettings(templateId: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("PUT", templateId, "/settings", payload);
+  }
+
+  async listCommerceOrders(templateId: string, params: { status?: string; q?: string; page?: number } = {}): Promise<any> {
+    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: string, orderId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, `/orders/${encodeURIComponent(orderId)}`);
+  }
+
+  async updateCommerceOrder(templateId: string, orderId: string, fulfillmentStatus: string): Promise<any> {
+    return this.commerceFetch("PATCH", templateId, `/orders/${encodeURIComponent(orderId)}`, { fulfillmentStatus });
+  }
+
+  async refundCommerceOrder(templateId: string, orderId: string): Promise<any> {
+    return this.commerceFetch("POST", templateId, `/orders/${encodeURIComponent(orderId)}/refund`);
+  }
+
+  async resendDigitalDelivery(templateId: string, orderId: string, deliveryId: string): Promise<any> {
+    return this.commerceFetch("POST", templateId, `/orders/${encodeURIComponent(orderId)}/resend-digital-delivery`, { deliveryId });
+  }
+
+  async getCommerceWallet(templateId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, "/wallet");
+  }
+
+  async listCommerceWithdrawals(templateId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, "/wallet/withdrawals");
+  }
+
+  async requestCommerceWithdrawal(templateId: string, payload: { amountCents: number; accountNumber: string; accountHolderName: string; bankName: string }): Promise<any> {
+    return this.commerceFetch("POST", templateId, "/wallet/withdrawals", payload);
+  }
+
+  async getCommerceStripeAccessStatus(): Promise<any> {
+    this.checkAuth();
+    const res = await fetch(`${this.baseUrl}/api/v1/commerce/stripe-access`, { method: "GET", headers: this.getHeaders() });
+    const data = (await res.json().catch(() => ({}))) as any;
+    if (!res.ok) throw new Error(data?.error || `Failed to fetch Stripe access status (Status ${res.status})`);
+    return data;
+  }
+
+  async requestCommerceStripeAccess(payload: { reason?: string; expectedVolume?: string } = {}): Promise<any> {
+    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(() => ({}))) as any;
+    if (!res.ok) throw new Error(data?.error || `Failed to request Stripe access (Status ${res.status})`);
+    return data;
+  }
+
+  async listCommerceDeliveryMethods(templateId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, "/delivery-methods");
+  }
+
+  async createCommerceDeliveryMethod(templateId: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("POST", templateId, "/delivery-methods", payload);
+  }
+
+  async updateCommerceDeliveryMethod(templateId: string, id: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("PATCH", templateId, `/delivery-methods/${encodeURIComponent(id)}`, payload);
+  }
+
+  async deleteCommerceDeliveryMethod(templateId: string, id: string): Promise<any> {
+    return this.commerceFetch("DELETE", templateId, `/delivery-methods/${encodeURIComponent(id)}`);
+  }
+
+  async listCommerceDiscounts(templateId: string): Promise<any> {
+    return this.commerceFetch("GET", templateId, "/discounts");
+  }
+
+  async createCommerceDiscount(templateId: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("POST", templateId, "/discounts", payload);
+  }
+
+  async updateCommerceDiscount(templateId: string, id: string, payload: Record<string, any>): Promise<any> {
+    return this.commerceFetch("PATCH", templateId, `/discounts/${encodeURIComponent(id)}`, payload);
+  }
+
+  async deleteCommerceDiscount(templateId: string, id: string): Promise<any> {
+    return this.commerceFetch("DELETE", templateId, `/discounts/${encodeURIComponent(id)}`);
+  }
+
+  async listCommerceCustomers(templateId: string, page?: number): Promise<any> {
+    return this.commerceFetch("GET", templateId, `/customers${page ? `?page=${page}` : ""}`);
+  }
+
+  /** Shared request helper for every /api/v1/lms/funnels/{templateId}/... route below. */
+  private async lmsFetch(method: string, templateId: string, path: string, body?: unknown): Promise<any> {
+    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(() => ({}))) as any;
+    if (!res.ok) throw new Error(data?.error || `Funnel request failed (Status ${res.status})`);
+    return data;
+  }
+
+  async createFunnel(templateId: string): Promise<any> {
+    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(() => ({}))) as any;
+    if (!res.ok) throw new Error(data?.error || `Funnel creation failed (Status ${res.status})`);
+    return data;
+  }
+
+  async getFunnel(templateId: string): Promise<any> {
+    return this.lmsFetch("GET", templateId, "");
+  }
+
+  async updateFunnel(templateId: string, payload: Record<string, any>): Promise<any> {
+    return this.lmsFetch("PATCH", templateId, "", payload);
+  }
+
+  async deleteFunnel(templateId: string): Promise<any> {
+    return this.lmsFetch("DELETE", templateId, "");
+  }
+
+  async listFunnelPages(templateId: string): Promise<any> {
+    return this.lmsFetch("GET", templateId, "/pages");
+  }
+
+  async createFunnelPage(templateId: string, payload: { title?: string; kind?: string } = {}): Promise<any> {
+    return this.lmsFetch("POST", templateId, "/pages", payload);
+  }
+
+  async updateFunnelPage(templateId: string, pageId: string, payload: Record<string, any>): Promise<any> {
+    return this.lmsFetch("PATCH", templateId, `/pages/${encodeURIComponent(pageId)}`, payload);
+  }
+
+  async deleteFunnelPage(templateId: string, pageId: string): Promise<any> {
+    return this.lmsFetch("DELETE", templateId, `/pages/${encodeURIComponent(pageId)}`);
+  }
+
+  async reorderFunnelPages(templateId: string, orderedPageIds: string[]): Promise<any> {
+    return this.lmsFetch("POST", templateId, "/pages/reorder", { orderedPageIds });
+  }
+
+  async listFunnelEnrollments(templateId: string): Promise<any> {
+    return this.lmsFetch("GET", templateId, "/enrollments");
+  }
+
+  async getFunnelEnrollment(templateId: string, email: string): Promise<any> {
+    return this.lmsFetch("GET", templateId, `/enrollments/${encodeURIComponent(email)}`);
+  }
+
+  async setFunnelEnrollmentStatus(templateId: string, email: string, status: "ACTIVE" | "REVOKED"): Promise<any> {
+    return this.lmsFetch("PATCH", templateId, `/enrollments/${encodeURIComponent(email)}`, { status });
+  }
+
+  async approveFunnelEnrollmentPage(templateId: string, email: string, pageId: string): Promise<any> {
+    return this.lmsFetch("POST", templateId, `/enrollments/${encodeURIComponent(email)}/approve`, { pageId });
+  }
+
+  async resendFunnelMagicLink(templateId: string, email: string): Promise<any> {
+    return this.lmsFetch("POST", templateId, `/enrollments/${encodeURIComponent(email)}/resend-magic-link`);
+  }
+
+  async getFunnelAddonSlots(): Promise<any> {
+    this.checkAuth();
+    const res = await fetch(`${this.baseUrl}/api/v1/lms/addon-slots`, { method: "GET", headers: this.getHeaders() });
+    const data = (await res.json().catch(() => ({}))) as any;
+    if (!res.ok) throw new Error(data?.error || `Failed to fetch funnel addon slots (Status ${res.status})`);
+    return data;
+  }
 }