@getcheddar/cheddar-mcp 1.0.5 → 2.0.0

package/README.md

@@ -1,379 +1,91 @@
-# Cheddar MCP Server
+# Cheddar MCP Server (legacy API)
 
-A Model Context Protocol (MCP) server for integrating with the Cheddar Payment Platform. This server provides AI assistants with tools to generate payment integration code and manage Cheddar resources.
+Model Context Protocol server that calls the **legacy Cheddar merchant API** documented at [https://docs.getcheddar.com/](https://docs.getcheddar.com/) using **HTTP Basic** authentication (`Authorization: Basic …`).
 
-**Package:** `@getcheddar/cheddar-mcp`  
-**Version:** 1.0.5
-
----
-
-## Two Modes of Operation
-
-The MCP server works in two modes depending on whether you provide API credentials:
-
-### Mode A: Code Generation Only (No Auth Required)
-
-**Use this mode to:**
-
-- Generate integration code (React, Vue, Next.js, etc.)
-- Create checkout forms and hosted page URLs
-- Configure webhooks and validation logic
-- Get code recommendations and best practices
-
-**No API credentials needed!** These tools work out of the box:
-
-| Tool                                         | Description                                      |
-| -------------------------------------------- | ------------------------------------------------ |
-| `cheddar_checkout_generate_hosted_url`       | Generate hosted checkout page URLs               |
-| `cheddar_checkout_generate_embedded_form`    | Generate embedded checkout form code             |
-| `cheddar_checkout_generate_integration_code` | Generate complete framework-specific integration |
-| `cheddar_checkout_configure_webhook`         | Generate webhook handler code                    |
-| `cheddar_checkout_validate_webhook`          | Validate webhook signatures                      |
-
-**Quick Start (No Auth):**
-
-```json
-{
-  "mcpServers": {
-    "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"]
-    }
-  }
-}
-```
+This package **does not** use `https://api.*` OAuth2 / Bearer REST.
 
-**Example Prompt for Lovable:**
-
-```
-Create a React checkout page for my SaaS using Cheddar payments.
-- Collect customer email and name
-- Accept credit card payments securely
-- Subscribe customers to a "Pro Plan"
-- Handle errors gracefully
-
-Use cheddar_checkout_generate_integration_code with framework "react".
-```
-
----
-
-### Mode B: Full API Access (Auth Required)
-
-**Use this mode to:**
-
-- Query actual customer data from your Cheddar account
-- Create and update customers, subscriptions, payment methods
-- Manage billing and plan changes
-- Access real-time subscription status
-
-**Requires Cheddar API credentials.** These tools need authentication:
-
-| Tool                           | Description                        |
-| ------------------------------ | ---------------------------------- |
-| `cheddar_customer_get`         | Retrieve customer by ID or code    |
-| `cheddar_customer_create`      | Create a new customer              |
-| `cheddar_customer_update`      | Update customer information        |
-| `cheddar_payment_method_get`   | Retrieve payment method by ID      |
-| `cheddar_payment_token_create` | Tokenize card data (PCI-compliant) |
-| `cheddar_subscription_get`     | Retrieve subscription details      |
-| `cheddar_plan_get`             | Retrieve plan information          |
-
-**Setup with Auth:**
-
-1. **Sign up for Cheddar:** https://getcheddar.com/signup
-2. **Get your credentials:**
-   - **Username:** Your Cheddar account email
-   - **Secret Key:** Top navbar → Configuration → Product Settings → Secret Key
-
-3. **Configure MCP:**
-
-```json
-{
-  "mcpServers": {
-    "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"],
-      "env": {
-        "CHEDDAR_API_URL": "https://api.getcheddar.com",
-        "CHEDDAR_USERNAME": "your-email@example.com",
-        "CHEDDAR_SECRET_KEY": "your-secret-key-here"
-      }
-    }
-  }
-}
-```
+**Package:** `@getcheddar/cheddar-mcp`  
+**Version:** 2.0.0
 
-**Alternative: OAuth2 Access Token**
+## Requirements
 
-If you have an OAuth2 access token instead:
+- Node.js **18+**
+- A Cheddar **product site** base URL (same host you use for admin/checkout, e.g. `https://yoursubdomain.chargevault.com`)
+- **Product code** (`productCode` in URLs)
+- An **authorized user email** and **password** *or* the product **API key** (“secret key” from Configuration → Settings) as the Basic password ([auth docs](https://docs.getcheddar.com/#authentication))
 
-```json
-{
-  "mcpServers": {
-    "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"],
-      "env": {
-        "CHEDDAR_API_URL": "https://api.getcheddar.com",
-        "CHEDDAR_ACCESS_TOKEN": "your-oauth2-access-token"
-      }
-    }
-  }
-}
-```
+## Environment variables
 
-**Example Prompt with Auth:**
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CHEDDAR_BASE_URL` | **Yes** | Origin of your product app, no trailing slash (e.g. `https://cvences.chargevault.com`). |
+| `CHEDDAR_PRODUCT_CODE` | **Yes** | Your product’s `productCode` segment in legacy URLs. |
+| `CHEDDAR_USERNAME` | **Yes** | Email of an API-enabled user on that product. |
+| `CHEDDAR_PASSWORD` | One of | That user’s login password. |
+| `CHEDDAR_PRODUCT_API_KEY` | One of | Product secret key from admin settings; used as Basic **password** if `CHEDDAR_PASSWORD` is unset. |
+| `CHEDDAR_SKIP_PREFLIGHT` | No | If set to `1`, skip startup `GET /xml/plans/get/...` check. |
 
-```
-Get customer details for customer code "cust_12345" and show me their subscription status and payment methods.
+## Install & run
 
-Use cheddar_customer_get, then cheddar_subscription_get and cheddar_payment_method_get.
+```bash
+cd packages/cheddar-mcp
+npm install
+npm run build
 ```
 
----
-
-## Configuration Reference
-
-| Variable               | Mode      | Description                                              |
-| ---------------------- | --------- | -------------------------------------------------------- |
-| `CHEDDAR_API_URL`      | Auth only | REST API base URL. Default: `https://api.getcheddar.com` |
-| `CHEDDAR_USERNAME`     | Auth only | Your Cheddar account email address                       |
-| `CHEDDAR_SECRET_KEY`   | Auth only | Secret Key from Product Settings                         |
-| `CHEDDAR_ACCESS_TOKEN` | Auth only | OAuth2 Bearer token (alternative to username/secret)     |
-
-**Note:** If no auth credentials are provided, the server runs in **code generation mode only** and will return clear error messages if you try to use data access tools.
-
----
-
-## Usage with Claude Desktop
-
-Add to your Claude Desktop configuration:
-
-**For code generation (no auth):**
+```bash
+export CHEDDAR_BASE_URL=https://your-product-host.example
+export CHEDDAR_PRODUCT_CODE=YOUR_PRODUCT_CODE
+export CHEDDAR_USERNAME=api-user@example.com
+export CHEDDAR_PRODUCT_API_KEY=your_secret_key
 
-```json
-{
-  "mcpServers": {
-    "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"]
-    }
-  }
-}
+node dist/index.js
 ```
 
-**For full API access (with auth):**
+Or with `npx` after publish:
 
-```json
-{
-  "mcpServers": {
-    "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"],
-      "env": {
-        "CHEDDAR_API_URL": "https://api.getcheddar.com",
-        "CHEDDAR_USERNAME": "your-email@example.com",
-        "CHEDDAR_SECRET_KEY": "your-secret-key"
-      }
-    }
-  }
-}
+```bash
+npx -y @getcheddar/cheddar-mcp
 ```
 
----
-
-## Usage with Cursor
-
-1. Open Cursor Settings
-2. Navigate to **Features → MCP**
-3. Add a new MCP server:
-
-**For code generation:**
-
-- **Name:** `cheddar`
-- **Command:** `npx`
-- **Arguments:** `-y`, `@getcheddar/cheddar-mcp@1.0.5`
-
-**For full API access:**
-
-- **Name:** `cheddar`
-- **Command:** `npx`
-- **Arguments:** `-y`, `@getcheddar/cheddar-mcp@1.0.5`
-- **Environment:** Set `CHEDDAR_USERNAME` and `CHEDDAR_SECRET_KEY`
-
----
-
-## Usage with Lovable.dev
-
-### Step 1: Get Credentials (for full API access, optional)
-
-1. Sign up at https://getcheddar.com/signup
-2. Configure your product
-3. Get your Secret Key: Top navbar → Configuration → Product Settings → Secret Key
+## Tools
 
-### Step 2: Configure MCP in Lovable
+| Tool | Legacy endpoint (conceptually) |
+|------|--------------------------------|
+| `cheddar_customer_get` | `GET /xml/customers/get/productCode/.../code/…` or `/id/…` |
+| `cheddar_customers_search` | `GET /xml/customers/search/productCode/...` (requests `format=json` when supported) |
+| `cheddar_customer_create` | `POST /xml/customers/new/productCode/...` (form body) |
+| `cheddar_customer_update` | `POST /xml/customers/edit/productCode/.../code/...` |
+| `cheddar_plans_get` | `GET /xml/plans/get/productCode/...` (optional `planCode`) |
 
-Add to your Lovable project configuration:
+Responses are returned as **JSON text**: XML from the API is parsed to a plain object where possible.
 
-**Option 1: Code Generation Only (Recommended for starters)**
+## Claude Desktop example
 
 ```json
 {
   "mcpServers": {
     "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"]
-    }
-  }
-}
-```
-
-**Option 2: Full API Access**
-
-```json
-{
-  "mcpServers": {
-    "cheddar": {
-      "command": "npx",
-      "args": ["-y", "@getcheddar/cheddar-mcp@1.0.5"],
+      "command": "node",
+      "args": ["/absolute/path/to/cheddar-mcp/dist/index.js"],
       "env": {
-        "CHEDDAR_API_URL": "https://api.getcheddar.com",
-        "CHEDDAR_USERNAME": "your-email@example.com",
-        "CHEDDAR_SECRET_KEY": "your-secret-key"
+        "CHEDDAR_BASE_URL": "https://your-product-host.example",
+        "CHEDDAR_PRODUCT_CODE": "YOUR_PRODUCT_CODE",
+        "CHEDDAR_USERNAME": "api-user@example.com",
+        "CHEDDAR_PRODUCT_API_KEY": "your_secret_key"
       }
     }
   }
 }
 ```
 
-### Step 3: Try These Prompts
-
-**For code generation (no auth needed):**
-
-```
-Create a complete payment integration for my React app:
-1. A pricing page with 3 tiers (Basic, Pro, Enterprise)
-2. Checkout flow using Cheddar's embedded form
-3. Webhook handler for subscription events
-4. Use Tailwind CSS for styling
-
-Start with cheddar_checkout_generate_integration_code.
-```
-
-**For data access (requires auth):**
-
-```
-Build a customer dashboard showing:
-- Customer profile from Cheddar
-- Current subscription plan
-- Payment methods on file
-- Recent invoices
-
-Use cheddar_customer_get and related tools.
-```
-
----
-
-## Testing
-
-### Sandbox Environment
-
-Use the sandbox for testing before going live:
-
-```json
-{
-  "env": {
-    "CHEDDAR_API_URL": "https://sandbox.getcheddar.com",
-    "CHEDDAR_USERNAME": "your-sandbox-email",
-    "CHEDDAR_SECRET_KEY": "your-sandbox-secret"
-  }
-}
-```
-
-### Test Card Numbers
-
-- `4111111111111111` - Visa (success)
-- `4000000000000002` - Declined
-
----
-
-## Complete Tool Reference
-
-### Code Generation Tools (No Auth Required)
-
-| Tool                                         | Description                                  |
-| -------------------------------------------- | -------------------------------------------- |
-| `cheddar_checkout_generate_hosted_url`       | Generate hosted checkout page URLs           |
-| `cheddar_checkout_generate_embedded_form`    | Generate embedded checkout form code         |
-| `cheddar_checkout_generate_integration_code` | Generate framework-specific integration code |
-| `cheddar_checkout_configure_webhook`         | Generate webhook handler code                |
-| `cheddar_checkout_validate_webhook`          | Validate webhook signatures                  |
-
-### Data Access Tools (Auth Required)
-
-| Tool                                         | Description                              |
-| -------------------------------------------- | ---------------------------------------- |
-| `cheddar_customer_get`                       | Retrieve a customer by ID or code        |
-| `cheddar_customer_create`                    | Create a new customer                    |
-| `cheddar_customer_update`                    | Update customer information              |
-| `cheddar_payment_method_get`                 | Retrieve a payment method by ID          |
-| `cheddar_payment_method_get_customer`        | Get customer from payment method         |
-| `cheddar_payment_method_get_gateway_account` | Get gateway account for payment method   |
-| `cheddar_payment_token_create`               | Tokenize card data (PCI-compliant)       |
-| `cheddar_payment_method_add_to_customer`     | Add tokenized payment method to customer |
-| `cheddar_subscription_get`                   | Retrieve subscription by ID              |
-| `cheddar_subscription_get_customer`          | Get customer from subscription           |
-| `cheddar_subscription_get_plan`              | Get plan from subscription               |
-| `cheddar_subscription_get_payment_method`    | Get payment method from subscription     |
-| `cheddar_subscription_delete_promotion`      | Remove promotion from subscription       |
-| `cheddar_plan_get`                           | Retrieve plan by ID or code              |
-| `cheddar_gateway_account_get`                | Get gateway account details              |
-
----
-
-## Docker Usage
-
-Build and run with Docker:
-
-```bash
-# Build
-docker build -t cheddar-mcp ./packages/cheddar-mcp
-
-# Run (code generation only)
-docker run -i --rm cheddar-mcp
-
-# Run with auth
-docker run -i --rm \
-  -e CHEDDAR_API_URL=https://api.getcheddar.com \
-  -e CHEDDAR_USERNAME=your-email \
-  -e CHEDDAR_SECRET_KEY=your-secret \
-  cheddar-mcp
-```
-
----
-
 ## Development
 
 ```bash
-# Clone the repository
-git clone https://github.com/chdr/cheddar-ai-tools.git
-cd cheddar-ai-tools/packages/cheddar-mcp
-
-# Install dependencies
-npm install
-
-# Build
 npm run build
-
-# Run in development mode
-npm run dev
-
-# Test
 npm test
 ```
 
----
-
 ## License
 
 MIT © Cheddar (chdr)

package/bin/cheddar-mcp.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * CLI entry for npm `bin` (stable path). npm 10+ may reject `bin` pointing at build output under `dist/`.
+ */
+import "../dist/index.js";

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export {};
+import "dotenv/config";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -1,84 +1,86 @@
+import "dotenv/config";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { CheddarApiClient } from "./lib/cheddar-client.js";
+import { LegacyApiError, LegacyCheddarClient } from "./lib/legacy-client.js";
 import { customerTools, handleCustomerTool } from "./tools/customers.js";
-import { paymentMethodTools, handlePaymentMethodTool } from "./tools/payment-methods.js";
-import { subscriptionTools, handleSubscriptionTool } from "./tools/subscriptions.js";
-import { checkoutTools, handleCheckoutTool } from "./tools/checkout.js";
-// Configuration from environment
-const config = {
-    apiUrl: process.env.CHEDDAR_API_URL || "https://api.chdr.dev",
-    clientId: process.env.CHEDDAR_CLIENT_ID || "",
-    clientSecret: process.env.CHEDDAR_CLIENT_SECRET || "",
-    accessToken: process.env.CHEDDAR_ACCESS_TOKEN || "",
-};
-// Validate required config
-if (!config.accessToken && (!config.clientId || !config.clientSecret)) {
-    console.error("Error: CHEDDAR_ACCESS_TOKEN or both CHEDDAR_CLIENT_ID and CHEDDAR_CLIENT_SECRET must be set");
+import { planTools, handlePlanTool } from "./tools/plans.js";
+const baseUrl = (process.env.CHEDDAR_BASE_URL || "").replace(/\/+$/, "");
+const productCode = process.env.CHEDDAR_PRODUCT_CODE || "";
+const username = process.env.CHEDDAR_USERNAME || "";
+const password = process.env.CHEDDAR_PASSWORD || process.env.CHEDDAR_PRODUCT_API_KEY || "";
+if (!baseUrl || !productCode || !username || !password) {
+    console.error("Missing config. Set CHEDDAR_BASE_URL, CHEDDAR_PRODUCT_CODE, CHEDDAR_USERNAME, and CHEDDAR_PASSWORD or CHEDDAR_PRODUCT_API_KEY.");
     process.exit(1);
 }
-// Initialize Cheddar API client
-const cheddarClient = new CheddarApiClient(config);
-// Combine all tools
-const ALL_TOOLS = [
-    ...customerTools,
-    ...paymentMethodTools,
-    ...subscriptionTools,
-    ...checkoutTools,
-];
-// Create MCP server
+const client = new LegacyCheddarClient({
+    baseUrl,
+    productCode,
+    username,
+    password,
+});
+const ALL_TOOLS = [...customerTools, ...planTools];
 const server = new Server({
     name: "cheddar-mcp",
-    version: "0.1.0",
+    version: "2.0.0",
 }, {
     capabilities: {
         tools: {},
     },
 });
-// Handler for listing available tools
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: ALL_TOOLS,
-    };
-});
-// Handler for tool execution
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: ALL_TOOLS }));
+function toolErrorMessage(error) {
+    if (error instanceof LegacyApiError) {
+        return `Cheddar API error (HTTP ${error.status}). See server logs for details.`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
-        // Route to appropriate handler based on tool name prefix
-        if (name.startsWith("cheddar_customer_")) {
-            return await handleCustomerTool(cheddarClient, name, args);
-        }
-        if (name.startsWith("cheddar_payment_")) {
-            return await handlePaymentMethodTool(cheddarClient, name, args);
+        if (name.startsWith("cheddar_customer")) {
+            return await handleCustomerTool(client, name, args);
         }
-        if (name.startsWith("cheddar_subscription_")) {
-            return await handleSubscriptionTool(cheddarClient, name, args);
-        }
-        if (name.startsWith("cheddar_checkout_")) {
-            return await handleCheckoutTool(cheddarClient, name, args);
+        if (name.startsWith("cheddar_plans_")) {
+            return await handlePlanTool(client, name, args);
         }
         throw new Error(`Unknown tool: ${name}`);
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (error instanceof LegacyApiError) {
+            console.error("[cheddar-mcp] LegacyApiError body:", typeof error.body === "string" ? error.body.slice(0, 4000) : JSON.stringify(error.body).slice(0, 4000));
+        }
+        else {
+            console.error("[cheddar-mcp] Tool error:", error);
+        }
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error: ${errorMessage}`,
-                },
-            ],
+            content: [{ type: "text", text: `Error: ${toolErrorMessage(error)}` }],
             isError: true,
         };
     }
 });
-// Start server
 async function main() {
+    if (!process.env.CHEDDAR_SKIP_PREFLIGHT) {
+        try {
+            await client.ping();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`Cheddar legacy API preflight failed: ${msg}`);
+            if (err instanceof LegacyApiError) {
+                console.error("[cheddar-mcp] Preflight response body:", typeof err.body === "string"
+                    ? err.body.slice(0, 4000)
+                    : JSON.stringify(err.body).slice(0, 4000));
+            }
+            process.exit(1);
+        }
+    }
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("Cheddar MCP server running on stdio");
+    console.error("Cheddar MCP (legacy HTTP Basic) running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAExE,iCAAiC;AACjC,MAAM,MAAM,GAAG;IACb,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,sBAAsB;IAC7D,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;IAC7C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;IACrD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE;CACpD,CAAC;AAEF,2BAA2B;AAC3B,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,KAAK,CACX,6FAA6F,CAC9F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,gCAAgC;AAChC,MAAM,aAAa,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEnD,oBAAoB;AACpB,MAAM,SAAS,GAAW;IACxB,GAAG,aAAa;IAChB,GAAG,kBAAkB;IACrB,GAAG,iBAAiB;IACpB,GAAG,aAAa;CACjB,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,sCAAsC;AACtC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,yDAAyD;QACzD,IAAI,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACzC,OAAO,MAAM,kBAAkB,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxC,OAAO,MAAM,uBAAuB,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC7C,OAAO,MAAM,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACzC,OAAO,MAAM,kBAAkB,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,YAAY,EAAE;iBAC/B;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/legacy-client.d.ts

@@ -0,0 +1,44 @@
+export interface LegacyCheddarConfig {
+    /** Product site origin, e.g. https://yoursubdomain.chargevault.com (no trailing slash) */
+    baseUrl: string;
+    productCode: string;
+    /** HTTP Basic username (authorized user email) */
+    username: string;
+    /** HTTP Basic password (user password or product API key) */
+    password: string;
+}
+export declare class LegacyCheddarClient {
+    private readonly base;
+    private readonly productCode;
+    private readonly auth;
+    constructor(cfg: LegacyCheddarConfig);
+    private parseBody;
+    /**
+     * GET legacy XML (or JSON if the endpoint supports `format=json`).
+     */
+    get(pathWithLeadingSlash: string, query?: Record<string, string>): Promise<unknown>;
+    /**
+     * POST `application/x-www-form-urlencoded` (legacy API style).
+     */
+    postForm(pathWithLeadingSlash: string, fields: Record<string, string>): Promise<unknown>;
+    ping(): Promise<unknown>;
+    getCustomer(by: "code" | "id", value: string): Promise<unknown>;
+    searchCustomers(params: Record<string, string>): Promise<unknown>;
+    getPlans(planCode?: string): Promise<unknown>;
+    /**
+     * Flat object keys become form keys; nested objects use bracket notation (subscription[planCode]).
+     */
+    createCustomer(fields: Record<string, unknown>): Promise<unknown>;
+    updateCustomer(customerCode: string, fields: Record<string, unknown>): Promise<unknown>;
+}
+export declare class LegacyApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+/**
+ * Flattens `{ firstName: "a", subscription: { planCode: "FREE" } }` into
+ * `firstName`, `subscription[planCode]` for legacy form posts.
+ */
+export declare function flattenFormFields(obj: Record<string, unknown>, prefix?: string): Record<string, string>;
+//# sourceMappingURL=legacy-client.d.ts.map

package/dist/lib/legacy-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-client.d.ts","sourceRoot":"","sources":["../../src/lib/legacy-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,GAAG,EAAE,mBAAmB;YAMtB,SAAS;IAiBvB;;OAEG;IACG,GAAG,CAAC,oBAAoB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBzF;;OAEG;IACG,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBxF,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASnD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjE,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAO9F;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,SAAK,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB"}