@armor/zuora-mcp 0.0.0-development

package/dist/setup.js

@@ -0,0 +1,188 @@
+/**
+ * Interactive setup wizard for zuora-mcp.
+ *
+ * Zero external dependencies — uses only Node built-ins:
+ *   node:readline/promises, node:fs, node:path, node:os
+ *
+ * Detects Claude Code and Claude Desktop config files, prompts for
+ * Zuora OAuth credentials, and writes MCP server entries using the
+ * npx-based format so the server auto-installs on first use.
+ */
+import { createInterface } from "node:readline/promises";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+const ZUORA_BASE_URLS = [
+    { label: "US Sandbox", url: "https://rest.apisandbox.zuora.com" },
+    { label: "US Production", url: "https://rest.zuora.com" },
+    { label: "EU Sandbox", url: "https://rest.sandbox.eu.zuora.com" },
+    { label: "EU Production", url: "https://rest.eu.zuora.com" },
+];
+function getClaudeCodeConfigPath() {
+    return join(homedir(), ".claude", ".mcp.json");
+}
+function getClaudeDesktopConfigPath() {
+    const os = platform();
+    if (os === "darwin") {
+        return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    }
+    if (os === "win32") {
+        const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
+        return join(appData, "Claude", "claude_desktop_config.json");
+    }
+    // Linux / other — XDG_CONFIG_HOME fallback
+    const configHome = process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(configHome, "Claude", "claude_desktop_config.json");
+}
+function detectTargets() {
+    const targets = [
+        {
+            name: "Claude Code",
+            path: getClaudeCodeConfigPath(),
+            exists: existsSync(getClaudeCodeConfigPath()),
+        },
+        {
+            name: "Claude Desktop",
+            path: getClaudeDesktopConfigPath(),
+            exists: existsSync(getClaudeDesktopConfigPath()),
+        },
+    ];
+    return targets;
+}
+function readConfig(configPath) {
+    try {
+        const raw = readFileSync(configPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return { mcpServers: parsed.mcpServers ?? {}, ...parsed };
+    }
+    catch {
+        return { mcpServers: {} };
+    }
+}
+function writeConfig(configPath, config) {
+    const dir = join(configPath, "..");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+function buildServerEntry(env) {
+    return {
+        command: "npx",
+        args: ["-y", "@armor/zuora-mcp"],
+        env: {
+            ZUORA_CLIENT_ID: env.clientId,
+            ZUORA_CLIENT_SECRET: env.clientSecret,
+            ZUORA_BASE_URL: env.baseUrl,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Interactive prompts
+// ---------------------------------------------------------------------------
+async function prompt(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` [${defaultValue}]` : "";
+    const answer = (await rl.question(`${question}${suffix}: `)).trim();
+    return answer || defaultValue || "";
+}
+async function promptRequired(rl, question) {
+    let answer = "";
+    while (!answer) {
+        answer = (await rl.question(`${question}: `)).trim();
+        if (!answer) {
+            console.log("  This field is required.");
+        }
+    }
+    return answer;
+}
+async function promptBaseUrl(rl) {
+    console.log("\nZuora environment:");
+    for (let i = 0; i < ZUORA_BASE_URLS.length; i++) {
+        console.log(`  ${i + 1}. ${ZUORA_BASE_URLS[i].label} (${ZUORA_BASE_URLS[i].url})`);
+    }
+    console.log(`  5. Custom URL`);
+    let choice = "";
+    while (!choice) {
+        choice = (await rl.question("Select [1-5] (default 1): ")).trim() || "1";
+        const num = parseInt(choice, 10);
+        if (num >= 1 && num <= 4) {
+            return ZUORA_BASE_URLS[num - 1].url;
+        }
+        if (num === 5) {
+            return promptRequired(rl, "Custom Zuora base URL");
+        }
+        console.log("  Please enter a number between 1 and 5.");
+        choice = "";
+    }
+    return ZUORA_BASE_URLS[0].url; // unreachable but satisfies TS
+}
+async function promptTargets(rl, targets) {
+    console.log("\nDetected config locations:");
+    const available = [];
+    for (const t of targets) {
+        const status = t.exists ? "found" : "will create";
+        console.log(`  - ${t.name}: ${t.path} (${status})`);
+        available.push(t);
+    }
+    if (available.length === 0) {
+        console.log("  No config locations detected. Will create Claude Code config.");
+        return [{ name: "Claude Code", path: getClaudeCodeConfigPath(), exists: false }];
+    }
+    if (available.length === 1) {
+        const ok = await prompt(rl, `Configure ${available[0].name}? (Y/n)`, "Y");
+        return ok.toLowerCase() === "n" ? [] : available;
+    }
+    const answer = await prompt(rl, "Configure which? (1=Claude Code, 2=Claude Desktop, 3=Both)", "1");
+    if (answer === "3" || answer.toLowerCase() === "both")
+        return available;
+    if (answer === "2")
+        return [available[1]];
+    return [available[0]];
+}
+// ---------------------------------------------------------------------------
+// Main entry
+// ---------------------------------------------------------------------------
+export async function runSetup() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log("=== Zuora MCP Setup ===\n");
+        console.log("This wizard configures Claude to use the Zuora billing MCP server.\n");
+        // 1. Collect credentials
+        const clientId = await promptRequired(rl, "Zuora OAuth Client ID");
+        const clientSecret = await promptRequired(rl, "Zuora OAuth Client Secret");
+        const baseUrl = await promptBaseUrl(rl);
+        // 2. Detect and choose targets
+        const allTargets = detectTargets();
+        const selectedTargets = await promptTargets(rl, allTargets);
+        if (selectedTargets.length === 0) {
+            console.log("\nNo targets selected. Exiting.");
+            return;
+        }
+        // 3. Write config for each target
+        const entry = buildServerEntry({ clientId, clientSecret, baseUrl });
+        for (const target of selectedTargets) {
+            const config = readConfig(target.path);
+            // Check for existing zuora entry
+            if (config.mcpServers.zuora) {
+                const overwrite = await prompt(rl, `\n${target.name} already has a "zuora" entry. Overwrite? (Y/n)`, "Y");
+                if (overwrite.toLowerCase() === "n") {
+                    console.log(`  Skipped ${target.name}.`);
+                    continue;
+                }
+            }
+            config.mcpServers.zuora = entry;
+            writeConfig(target.path, config);
+            console.log(`  Wrote ${target.name} config: ${target.path}`);
+        }
+        // 4. Print next steps
+        console.log("\n=== Setup Complete ===\n");
+        console.log("Next steps:");
+        console.log("  1. Restart Claude Code (or Claude Desktop) to load the new server");
+        console.log("  2. Try asking Claude: \"Show me my Zuora account summary\"");
+        console.log("\nTo verify the server starts correctly:\n  ZUORA_CLIENT_ID=... ZUORA_CLIENT_SECRET=... ZUORA_BASE_URL=... npx @armor/zuora-mcp");
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/token-manager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * OAuth 2.0 Token Manager for Zuora API
+ *
+ * Handles token lifecycle with:
+ * - Proactive refresh before expiry (60s buffer)
+ * - Promise coalescing for concurrent refresh requests
+ * - Clean error propagation on auth failures
+ */
+import type { Config } from "./config.js";
+export declare class TokenManager {
+    private static readonly EXPIRY_BUFFER_MS;
+    private static readonly TOKEN_REQUEST_TIMEOUT_MS;
+    private readonly clientId;
+    private readonly clientSecret;
+    private readonly tokenUrl;
+    private readonly debug;
+    private tokenData;
+    private refreshPromise;
+    constructor(config: Config);
+    private log;
+    /**
+     * Get a valid access token. Refreshes proactively before expiry.
+     * Concurrent callers coalesce onto a single refresh request.
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Force a token refresh. Called when a 401 is received mid-session,
+     * indicating the token expired between the validity check and the API call.
+     */
+    forceRefresh(): Promise<string>;
+    private isTokenValid;
+    private fetchNewToken;
+}
+//# sourceMappingURL=token-manager.d.ts.map

package/dist/token-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../src/token-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQ1C,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IAE1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAEhC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,cAAc,CAAgC;gBAE1C,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,GAAG;IAMX;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBvC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC,OAAO,CAAC,YAAY;YAON,aAAa;CAsD5B"}

package/dist/token-manager.js

@@ -0,0 +1,103 @@
+/**
+ * OAuth 2.0 Token Manager for Zuora API
+ *
+ * Handles token lifecycle with:
+ * - Proactive refresh before expiry (60s buffer)
+ * - Promise coalescing for concurrent refresh requests
+ * - Clean error propagation on auth failures
+ */
+export class TokenManager {
+    static EXPIRY_BUFFER_MS = 60_000;
+    static TOKEN_REQUEST_TIMEOUT_MS = 10_000;
+    clientId;
+    clientSecret;
+    tokenUrl;
+    debug;
+    tokenData = null;
+    refreshPromise = null;
+    constructor(config) {
+        this.clientId = config.zuoraClientId;
+        this.clientSecret = config.zuoraClientSecret;
+        this.tokenUrl = `${config.zuoraBaseUrl}/oauth/token`;
+        this.debug = config.debug;
+    }
+    log(message) {
+        if (this.debug) {
+            console.error(`[TokenManager] ${message}`);
+        }
+    }
+    /**
+     * Get a valid access token. Refreshes proactively before expiry.
+     * Concurrent callers coalesce onto a single refresh request.
+     */
+    async getAccessToken() {
+        if (this.isTokenValid()) {
+            return this.tokenData.accessToken;
+        }
+        // Coalesce concurrent refresh calls into one network request
+        if (!this.refreshPromise) {
+            this.log("Token expired or missing, fetching new token");
+            this.refreshPromise = this.fetchNewToken().finally(() => {
+                this.refreshPromise = null;
+            });
+        }
+        else {
+            this.log("Awaiting in-flight token refresh");
+        }
+        return this.refreshPromise;
+    }
+    /**
+     * Force a token refresh. Called when a 401 is received mid-session,
+     * indicating the token expired between the validity check and the API call.
+     */
+    async forceRefresh() {
+        this.tokenData = null;
+        return this.getAccessToken();
+    }
+    isTokenValid() {
+        return (this.tokenData !== null &&
+            Date.now() < this.tokenData.expiresAt - TokenManager.EXPIRY_BUFFER_MS);
+    }
+    async fetchNewToken() {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), TokenManager.TOKEN_REQUEST_TIMEOUT_MS);
+        try {
+            const response = await fetch(this.tokenUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: new URLSearchParams({
+                    client_id: this.clientId,
+                    client_secret: this.clientSecret,
+                    grant_type: "client_credentials",
+                }).toString(),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => "unknown");
+                throw new Error(`OAuth token request failed (${response.status}): ${errorText}`);
+            }
+            const data = (await response.json());
+            this.tokenData = {
+                accessToken: data.access_token,
+                expiresAt: Date.now() + data.expires_in * 1000,
+            };
+            this.log(`Token acquired, expires in ${data.expires_in}s (scope: ${data.scope})`);
+            return this.tokenData.accessToken;
+        }
+        catch (error) {
+            // Scrub credentials from any error messages using global regex
+            const message = error instanceof Error ? error.message : String(error);
+            const escapeRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const sanitized = message
+                .replace(new RegExp(escapeRegex(this.clientId), "g"), "[CLIENT_ID]")
+                .replace(new RegExp(escapeRegex(this.clientSecret), "g"), "[CLIENT_SECRET]");
+            throw new Error(`Token acquisition failed: ${sanitized}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=token-manager.js.map

package/dist/token-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-manager.js","sourceRoot":"","sources":["../src/token-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,OAAO,YAAY;IACf,MAAM,CAAU,gBAAgB,GAAG,MAAM,CAAC;IAC1C,MAAM,CAAU,wBAAwB,GAAG,MAAM,CAAC;IAEzC,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,QAAQ,CAAS;IACjB,KAAK,CAAU;IAExB,SAAS,GAAqB,IAAI,CAAC;IACnC,cAAc,GAA2B,IAAI,CAAC;IAEtD,YAAY,MAAc;QACxB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,GAAG,MAAM,CAAC,YAAY,cAAc,CAAC;QACrD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;IAEO,GAAG,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,SAAU,CAAC,WAAW,CAAC;QACrC,CAAC;QAED,6DAA6D;QAC7D,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;YACzD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACtD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;IAEO,YAAY;QAClB,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,IAAI;YACvB,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,YAAY,CAAC,gBAAgB,CACtE,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAC1B,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,YAAY,CAAC,wBAAwB,CACtC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,mCAAmC;iBACpD;gBACD,IAAI,EAAE,IAAI,eAAe,CAAC;oBACxB,SAAS,EAAE,IAAI,CAAC,QAAQ;oBACxB,aAAa,EAAE,IAAI,CAAC,YAAY;oBAChC,UAAU,EAAE,oBAAoB;iBACjC,CAAC,CAAC,QAAQ,EAAE;gBACb,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC/D,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;YAEtD,IAAI,CAAC,SAAS,GAAG;gBACf,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI;aAC/C,CAAC;YAEF,IAAI,CAAC,GAAG,CACN,8BAA8B,IAAI,CAAC,UAAU,aAAa,IAAI,CAAC,KAAK,GAAG,CACxE,CAAC;YAEF,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+DAA+D;YAC/D,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,WAAW,GAAG,CAAC,CAAS,EAAU,EAAE,CACxC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,OAAO;iBACtB,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,CAAC;iBACnE,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC"}