@burdenoff/mcp-libs 2026.511.1

package/dist/modules/billing/index.js

@@ -0,0 +1,606 @@
+import { mcpToolName, jsonResult, errorResult } from '../../chunk-H2OYWLOA.js';
+import { z } from 'zod';
+
+// src/modules/billing/operations.ts
+var GET_DEFAULT_BILLING_ACCOUNT = `
+  query GetDefaultBillingAccount {
+    getDefaultBillingAccount {
+      id creditAmount currency
+    }
+  }
+`;
+var GET_ACTIVE_SUBSCRIPTIONS = `
+  query GetActiveSubscriptions($billingAccountId: ID!) {
+    getActiveSubscriptions(billingAccountId: $billingAccountId) {
+      id status seatCount nextBillingDate
+      plan { name price currency }
+    }
+  }
+`;
+var GET_SUBSCRIPTION = `
+  query GetSubscription($id: ID!) {
+    getSubscription(id: $id) {
+      id status startDate endDate seatCount billingAccountId
+    }
+  }
+`;
+var UPDATE_SUBSCRIPTION_SEATS = `
+  mutation UpdateSubscriptionSeats($input: UpdateSubscriptionSeatsInput!) {
+    updateSubscriptionSeats(input: $input) {
+      id seatCount lastSeatChangeAt
+    }
+  }
+`;
+var CANCEL_SUBSCRIPTION = `
+  mutation CancelSubscription($input: CancelSubscriptionInput!) {
+    cancelSubscription(input: $input) {
+      id status canceledAt cancellationReason
+    }
+  }
+`;
+var GET_ALL_PLANS = `
+  query GetAllPlans($filter: PlanFilterInput) {
+    getAllPlans(filter: $filter) {
+      id name price currency duration pricingModel
+    }
+  }
+`;
+var GET_PLAN = `
+  query GetPlan($id: ID!) {
+    getPlan(id: $id) {
+      id name price pricePerSeat minSeats maxSeats isActive
+    }
+  }
+`;
+var GET_ALL_ADDONS = `
+  query GetAllAddOns($filter: AddOnFilterInput, $limit: Int) {
+    getAllAddOns(filter: $filter, limit: $limit) {
+      id name price currency duration isActive
+    }
+  }
+`;
+var GET_PAGINATED_INVOICES = `
+  query GetPaginatedInvoices($billingAccountId: ID!, $page: Int, $pageSize: Int) {
+    getPaginatedInvoices(billingAccountId: $billingAccountId, page: $page, pageSize: $pageSize) {
+      invoices { id invoiceNumber status total currency paidAt pdfUrl }
+      totalCount hasMore
+    }
+  }
+`;
+var GET_INVOICE = `
+  query GetInvoice($id: ID!) {
+    getInvoice(id: $id) {
+      id invoiceNumber status subtotal tax total
+      items { description amount }
+    }
+  }
+`;
+var GET_PAYMENT_METHODS = `
+  query GetPaymentMethods($billingAccountId: ID!) {
+    getPaymentMethods(billingAccountId: $billingAccountId) {
+      id type last4 expiryYear brand isDefault isVerified
+    }
+  }
+`;
+var ADD_PAYMENT_METHOD = `
+  mutation AddPaymentMethod($input: AddPaymentMethodInput!) {
+    addPaymentMethod(input: $input) {
+      id type isDefault isVerified
+    }
+  }
+`;
+var DELETE_PAYMENT_METHOD = `
+  mutation DeletePaymentMethod($id: ID!) {
+    deletePaymentMethod(id: $id) { success }
+  }
+`;
+var GRANT_CREDITS = `
+  mutation GrantCredits($input: GrantCreditsInput!) {
+    grantCredits(input: $input) {
+      id amount status type
+    }
+  }
+`;
+var REQUEST_CREDIT_WITHDRAWAL = `
+  mutation RequestCreditWithdrawal($input: RequestCreditWithdrawalInput!) {
+    requestCreditWithdrawal(input: $input) {
+      id status amount
+    }
+  }
+`;
+var GET_PENDING_REFUNDS = `
+  query GetPendingRefunds($page: Int, $pageSize: Int) {
+    getPendingRefunds(page: $page, pageSize: $pageSize) {
+      records { id amount status source createdAt }
+      totalCount
+    }
+  }
+`;
+var GET_QUOTAS_OF_SUB = `
+  query GetQuotas($subscriptionId: ID!) {
+    getAllQuotasOfSub(subscriptionId: $subscriptionId) {
+      id name limits currentUsageSum reusable
+    }
+  }
+`;
+
+// src/modules/billing/tools.ts
+async function resolveBillingAccountId(ctx, override) {
+  if (override !== void 0 && override !== "") return override;
+  const data = await ctx.gql.global.request(GET_DEFAULT_BILLING_ACCOUNT);
+  if (!data.getDefaultBillingAccount?.id) {
+    throw new Error("No default billing account on file. Pass account explicitly.");
+  }
+  return data.getDefaultBillingAccount.id;
+}
+function registerBillingTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_subscriptions_list")),
+    {
+      title: "List Subscriptions",
+      description: "List active subscriptions on a billing account (defaults to current).",
+      inputSchema: {
+        account: z.string().optional().describe("Billing account ID (defaults to current)")
+      }
+    },
+    async ({ account }) => {
+      try {
+        const billingAccountId = await resolveBillingAccountId(ctx, account);
+        const data = await ctx.gql.global.request(
+          GET_ACTIVE_SUBSCRIPTIONS,
+          { billingAccountId }
+        );
+        return jsonResult(data.getActiveSubscriptions);
+      } catch (error) {
+        ctx.logger.error("billing_subscriptions_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list subscriptions: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_subscriptions_get")),
+    {
+      title: "Get Subscription",
+      description: "Get a subscription by ID.",
+      inputSchema: { id: z.string().describe("Subscription ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.global.request(
+          GET_SUBSCRIPTION,
+          { id }
+        );
+        if (!data.getSubscription) return errorResult(`Subscription ${id} not found`);
+        return jsonResult(data.getSubscription);
+      } catch (error) {
+        ctx.logger.error("billing_subscriptions_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get subscription: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_subscriptions_upgrade")),
+    {
+      title: "Update Subscription Seats",
+      description: "Change the seat count on a subscription.",
+      inputSchema: {
+        id: z.string().describe("Subscription ID"),
+        seats: z.number().describe("Target seat count")
+      }
+    },
+    async ({ id, seats }) => {
+      try {
+        const input = { subscriptionId: id, seatCount: seats };
+        const data = await ctx.gql.global.request(
+          UPDATE_SUBSCRIPTION_SEATS,
+          { input }
+        );
+        return jsonResult(data.updateSubscriptionSeats);
+      } catch (error) {
+        ctx.logger.error("billing_subscriptions_upgrade failed", { error: String(error) });
+        return errorResult(
+          `Failed to update seats: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_subscriptions_cancel")),
+    {
+      title: "Cancel Subscription",
+      description: "Cancel a subscription with an optional reason.",
+      inputSchema: {
+        id: z.string().describe("Subscription ID"),
+        reason: z.string().optional().describe("Cancellation reason")
+      }
+    },
+    async ({ id, reason }) => {
+      try {
+        const input = { subscriptionId: id };
+        if (reason !== void 0) input.reason = reason;
+        const data = await ctx.gql.global.request(
+          CANCEL_SUBSCRIPTION,
+          { input }
+        );
+        return jsonResult(data.cancelSubscription);
+      } catch (error) {
+        ctx.logger.error("billing_subscriptions_cancel failed", { error: String(error) });
+        return errorResult(
+          `Failed to cancel subscription: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_plans_list")),
+    {
+      title: "List Plans",
+      description: "List available plans, optionally filtered by product.",
+      inputSchema: {
+        product: z.string().optional().describe("Product ID filter")
+      }
+    },
+    async ({ product }) => {
+      try {
+        const filter = {};
+        if (product !== void 0) filter.productId = product;
+        const data = await ctx.gql.global.request(GET_ALL_PLANS, {
+          filter: Object.keys(filter).length ? filter : void 0
+        });
+        return jsonResult(data.getAllPlans);
+      } catch (error) {
+        ctx.logger.error("billing_plans_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list plans: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_plans_get")),
+    {
+      title: "Get Plan",
+      description: "Get a plan by ID.",
+      inputSchema: { id: z.string().describe("Plan ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_PLAN, { id });
+        if (!data.getPlan) return errorResult(`Plan ${id} not found`);
+        return jsonResult(data.getPlan);
+      } catch (error) {
+        ctx.logger.error("billing_plans_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get plan: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_addons_list")),
+    {
+      title: "List Addons",
+      description: "List addons, optionally filtered by product.",
+      inputSchema: {
+        product: z.string().optional().describe("Product ID filter"),
+        limit: z.number().optional().describe("Page size (default 50)")
+      }
+    },
+    async ({ product, limit }) => {
+      try {
+        const filter = {};
+        if (product !== void 0) filter.productId = product;
+        const data = await ctx.gql.global.request(GET_ALL_ADDONS, {
+          filter: Object.keys(filter).length ? filter : void 0,
+          limit
+        });
+        return jsonResult(data.getAllAddOns);
+      } catch (error) {
+        ctx.logger.error("billing_addons_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list addons: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_invoices_list")),
+    {
+      title: "List Invoices",
+      description: "Paginated list of invoices on a billing account.",
+      inputSchema: {
+        account: z.string().optional().describe("Billing account ID (defaults to current)"),
+        page: z.number().optional().describe("Page number (default 1)"),
+        pageSize: z.number().optional().describe("Page size (default 20)")
+      }
+    },
+    async ({ account, page, pageSize }) => {
+      try {
+        const billingAccountId = await resolveBillingAccountId(ctx, account);
+        const data = await ctx.gql.global.request(GET_PAGINATED_INVOICES, { billingAccountId, page, pageSize });
+        return jsonResult(data.getPaginatedInvoices);
+      } catch (error) {
+        ctx.logger.error("billing_invoices_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list invoices: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_invoices_get")),
+    {
+      title: "Get Invoice",
+      description: "Get an invoice by ID.",
+      inputSchema: { id: z.string().describe("Invoice ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_INVOICE, {
+          id
+        });
+        if (!data.getInvoice) return errorResult(`Invoice ${id} not found`);
+        return jsonResult(data.getInvoice);
+      } catch (error) {
+        ctx.logger.error("billing_invoices_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get invoice: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_invoices_get_pdf_url")),
+    {
+      title: "Get Invoice PDF URL",
+      description: "Return the invoice PDF download URL. The actual PDF must be opened in a browser by the user.",
+      inputSchema: { id: z.string().describe("Invoice ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_INVOICE, {
+          id
+        });
+        if (!data.getInvoice?.pdfUrl) return errorResult(`Invoice ${id} has no pdfUrl`);
+        return jsonResult({ url: data.getInvoice.pdfUrl });
+      } catch (error) {
+        ctx.logger.error("billing_invoices_get_pdf_url failed", { error: String(error) });
+        return errorResult(
+          `Failed to fetch invoice URL: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_payment_methods_list")),
+    {
+      title: "List Payment Methods",
+      description: "List payment methods on a billing account.",
+      inputSchema: {
+        account: z.string().optional().describe("Billing account ID (defaults to current)")
+      }
+    },
+    async ({ account }) => {
+      try {
+        const billingAccountId = await resolveBillingAccountId(ctx, account);
+        const data = await ctx.gql.global.request(
+          GET_PAYMENT_METHODS,
+          { billingAccountId }
+        );
+        return jsonResult(data.getPaymentMethods);
+      } catch (error) {
+        ctx.logger.error("billing_payment_methods_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list payment methods: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_payment_methods_add")),
+    {
+      title: "Add Payment Method",
+      description: "Add a payment method (card metadata only \u2014 provider handles secrets). Use the provider checkout URL elsewhere for full card capture.",
+      inputSchema: {
+        type: z.enum(["CREDIT_CARD", "BANK", "UPI"]).describe("Payment method type"),
+        last4: z.string().describe("Last 4 digits / identifier"),
+        brand: z.string().optional().describe("Brand (Visa, MasterCard, etc.)"),
+        expiryMonth: z.number().optional().describe("Expiry month (1-12)"),
+        expiryYear: z.number().optional().describe("Expiry year (4 digits)"),
+        account: z.string().optional().describe("Billing account ID (defaults to current)"),
+        isDefault: z.boolean().optional().describe("Make it the default")
+      }
+    },
+    async ({ type, last4, brand, expiryMonth, expiryYear, account, isDefault }) => {
+      try {
+        const billingAccountId = await resolveBillingAccountId(ctx, account);
+        const input = {
+          billingAccountId,
+          type,
+          last4,
+          isDefault: isDefault === true
+        };
+        if (brand !== void 0) input.brand = brand;
+        if (expiryMonth !== void 0) input.expiryMonth = expiryMonth;
+        if (expiryYear !== void 0) input.expiryYear = expiryYear;
+        const data = await ctx.gql.global.request(
+          ADD_PAYMENT_METHOD,
+          { input }
+        );
+        return jsonResult(data.addPaymentMethod);
+      } catch (error) {
+        ctx.logger.error("billing_payment_methods_add failed", { error: String(error) });
+        return errorResult(
+          `Failed to add payment method: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_payment_methods_remove")),
+    {
+      title: "Remove Payment Method",
+      description: "Delete a payment method by ID.",
+      inputSchema: { id: z.string().describe("Payment method ID") }
+    },
+    async ({ id }) => {
+      try {
+        await ctx.gql.global.request(
+          DELETE_PAYMENT_METHOD,
+          { id }
+        );
+        return jsonResult({ status: "success", message: "Payment method removed", id });
+      } catch (error) {
+        ctx.logger.error("billing_payment_methods_remove failed", { error: String(error) });
+        return errorResult(
+          `Failed to remove payment method: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_credits_balance")),
+    {
+      title: "Credit Balance",
+      description: "Show current credit balance on the default billing account.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.global.request(GET_DEFAULT_BILLING_ACCOUNT);
+        return jsonResult(data.getDefaultBillingAccount);
+      } catch (error) {
+        ctx.logger.error("billing_credits_balance failed", { error: String(error) });
+        return errorResult(
+          `Failed to read balance: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_credits_grant")),
+    {
+      title: "Grant Credits",
+      description: "Grant credits to a billing account (admin only).",
+      inputSchema: {
+        account: z.string().describe("Billing account ID"),
+        amount: z.number().describe("Amount to grant"),
+        reason: z.string().optional().describe("Reason for grant")
+      }
+    },
+    async ({ account, amount, reason }) => {
+      try {
+        const input = {
+          billingAccountId: account,
+          amount,
+          reason: reason ?? "mcp-grant"
+        };
+        await ctx.gql.global.request(GRANT_CREDITS, { input });
+        return jsonResult({ status: "success", message: "Credits granted", amount, account });
+      } catch (error) {
+        ctx.logger.error("billing_credits_grant failed", { error: String(error) });
+        return errorResult(
+          `Failed to grant credits: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_credits_withdraw")),
+    {
+      title: "Withdraw Credits",
+      description: "Request a credit withdrawal to a payout account.",
+      inputSchema: {
+        account: z.string().describe("Billing account ID"),
+        amount: z.number().describe("Amount to withdraw"),
+        payout: z.string().describe("Payout account ID")
+      }
+    },
+    async ({ account, amount, payout }) => {
+      try {
+        const input = {
+          billingAccountId: account,
+          creditAmount: amount,
+          payoutAccountId: payout
+        };
+        await ctx.gql.global.request(REQUEST_CREDIT_WITHDRAWAL, { input });
+        return jsonResult({ status: "success", message: "Withdrawal requested", amount, account });
+      } catch (error) {
+        ctx.logger.error("billing_credits_withdraw failed", { error: String(error) });
+        return errorResult(
+          `Failed to request withdrawal: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_refunds_list")),
+    {
+      title: "List Pending Refunds",
+      description: "List pending refund records (paginated).",
+      inputSchema: {
+        page: z.number().optional().describe("Page number (default 0)"),
+        pageSize: z.number().optional().describe("Page size (default 20)")
+      }
+    },
+    async ({ page, pageSize }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_PENDING_REFUNDS, { page, pageSize });
+        return jsonResult(data.getPendingRefunds);
+      } catch (error) {
+        ctx.logger.error("billing_refunds_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list refunds: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "billing_quota_list")),
+    {
+      title: "List Subscription Quotas",
+      description: "Get all quotas for a subscription.",
+      inputSchema: {
+        subscriptionId: z.string().describe("Subscription ID")
+      }
+    },
+    async ({ subscriptionId }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_QUOTAS_OF_SUB, { subscriptionId });
+        return jsonResult(data.getAllQuotasOfSub);
+      } catch (error) {
+        ctx.logger.error("billing_quota_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list quotas: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/billing/index.ts
+var billingModule = {
+  id: "billing",
+  version: "0.0.1",
+  displayName: "Billing",
+  dependsOn: ["auth"],
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const tools = [];
+    const track = (n) => {
+      tools.push(n);
+      return n;
+    };
+    registerBillingTools(server, ctx, track);
+    return { tools, resources: [], prompts: [] };
+  }
+};
+var billing_default = billingModule;
+
+export { billing_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map