@openconductor/mcp-sdk 1.0.1 → 1.1.0

package/dist/payment/index.d.ts

@@ -0,0 +1,137 @@
+interface PaymentConfig {
+    /** OpenConductor API key for billing */
+    apiKey: string;
+    /** Base URL for billing API (default: https://api.openconductor.ai) */
+    apiUrl?: string;
+    /** Default upgrade URL to show users */
+    upgradeUrl?: string;
+    /** Enable test mode (skips actual billing) */
+    testMode?: boolean;
+}
+interface CreditRequirement {
+    /** Number of credits to deduct per call */
+    credits: number;
+}
+interface SubscriptionRequirement {
+    /** Required subscription tier (e.g., 'pro', 'enterprise') */
+    tier: string;
+    /** Alternative tiers that also grant access */
+    allowedTiers?: string[];
+}
+interface StripeRequirement {
+    /** Stripe Price ID for per-call billing */
+    priceId: string;
+}
+type PaymentRequirement = CreditRequirement | SubscriptionRequirement | StripeRequirement;
+interface UserContext {
+    /** User ID for billing lookup */
+    userId: string;
+    /** Optional API key override */
+    apiKey?: string;
+}
+interface BillingStatus {
+    /** Whether the user can proceed */
+    allowed: boolean;
+    /** Current credit balance (if applicable) */
+    credits?: number;
+    /** Current subscription tier (if applicable) */
+    tier?: string;
+    /** Reason for denial (if not allowed) */
+    reason?: string;
+    /** URL for upgrade/purchase */
+    actionUrl?: string;
+}
+/**
+ * Initialize payment/billing configuration
+ *
+ * @example
+ * ```typescript
+ * initPayment({
+ *   apiKey: process.env.OPENCONDUCTOR_API_KEY!,
+ *   upgradeUrl: 'https://myapp.com/upgrade'
+ * })
+ * ```
+ */
+declare function initPayment(config: PaymentConfig): void;
+/**
+ * Get current payment configuration
+ */
+declare function getPaymentConfig(): PaymentConfig | null;
+interface RequirePaymentOptions {
+    /** Tool name for billing records */
+    toolName?: string;
+    /** Function to extract user ID from input */
+    getUserId?: (input: unknown) => string | undefined;
+    /** Custom error handler */
+    onPaymentError?: (error: Error) => void;
+}
+/**
+ * One-line payment middleware for MCP tools
+ *
+ * @example Credits-based billing
+ * ```typescript
+ * const paidTool = requirePayment({ credits: 10 })(myHandler)
+ * ```
+ *
+ * @example Subscription tier requirement
+ * ```typescript
+ * const premiumTool = requirePayment({ tier: 'pro' })(myHandler)
+ * ```
+ *
+ * @example With wrapTool
+ * ```typescript
+ * const safePaidTool = wrapTool(
+ *   requirePayment({ credits: 5 })(myHandler),
+ *   { name: 'premium-analysis' }
+ * )
+ * ```
+ */
+declare function requirePayment<TInput extends {
+    userId?: string;
+}, TOutput>(requirement: PaymentRequirement, options?: RequirePaymentOptions): (handler: (input: TInput) => TOutput | Promise<TOutput>) => ((input: TInput) => Promise<TOutput>);
+/**
+ * Create a paid tool with built-in payment verification
+ *
+ * @example
+ * ```typescript
+ * const analyzeData = createPaidTool({
+ *   name: 'analyze-data',
+ *   payment: { credits: 10 },
+ *   handler: async (input) => {
+ *     // Your tool logic
+ *     return result
+ *   }
+ * })
+ * ```
+ */
+declare function createPaidTool<TInput extends {
+    userId?: string;
+}, TOutput>(config: {
+    name: string;
+    payment: PaymentRequirement;
+    handler: (input: TInput) => TOutput | Promise<TOutput>;
+    getUserId?: (input: TInput) => string | undefined;
+}): (input: TInput) => Promise<TOutput>;
+/**
+ * Check if a user can access a paid feature without executing it
+ * Useful for UI gating
+ *
+ * @example
+ * ```typescript
+ * const canAccess = await canUserAccess('user_123', { credits: 10 }, 'premium-tool')
+ * if (!canAccess.allowed) {
+ *   showUpgradePrompt(canAccess.actionUrl)
+ * }
+ * ```
+ */
+declare function canUserAccess(userId: string, requirement: PaymentRequirement, toolName?: string): Promise<BillingStatus>;
+/**
+ * Get user's current billing status
+ */
+declare function getUserBillingStatus(userId: string): Promise<{
+    credits: number;
+    tier: string;
+    active: boolean;
+} | null>;
+
+export { type BillingStatus, type CreditRequirement, type PaymentConfig, type PaymentRequirement, type RequirePaymentOptions, type StripeRequirement, type SubscriptionRequirement, type UserContext, canUserAccess, createPaidTool, getPaymentConfig, getUserBillingStatus, initPayment, requirePayment };

package/dist/payment/index.js

@@ -0,0 +1,253 @@
+'use strict';
+
+// src/errors/codes.ts
+var ErrorCodes = {
+  CONFIGURATION_ERROR: -32010,
+  PAYMENT_REQUIRED: -32011,
+  INSUFFICIENT_CREDITS: -32012,
+  SUBSCRIPTION_REQUIRED: -32013
+};
+
+// src/errors/index.ts
+var MCPError = class extends Error {
+  code;
+  data;
+  constructor(code, message, data) {
+    super(message);
+    this.name = "MCPError";
+    this.code = code;
+    this.data = data;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  /**
+   * Returns JSON-RPC 2.0 formatted error object
+   */
+  toJSON() {
+    return {
+      code: this.code,
+      message: this.message,
+      ...this.data && { data: this.data }
+    };
+  }
+  /**
+   * Create error response for JSON-RPC
+   */
+  toResponse(id = null) {
+    return {
+      jsonrpc: "2.0",
+      id,
+      error: this.toJSON()
+    };
+  }
+};
+var ConfigurationError = class extends MCPError {
+  constructor(setting, reason) {
+    super(ErrorCodes.CONFIGURATION_ERROR, `Invalid configuration '${setting}': ${reason}`, {
+      setting,
+      reason
+    });
+    this.name = "ConfigurationError";
+  }
+};
+var PaymentRequiredError = class extends MCPError {
+  constructor(toolName, options) {
+    super(ErrorCodes.PAYMENT_REQUIRED, `Payment required to use '${toolName}'`, {
+      tool: toolName,
+      ...options?.upgradeUrl && { upgradeUrl: options.upgradeUrl },
+      ...options?.priceId && { priceId: options.priceId }
+    });
+    this.name = "PaymentRequiredError";
+  }
+};
+var InsufficientCreditsError = class extends MCPError {
+  constructor(required, available, options) {
+    super(ErrorCodes.INSUFFICIENT_CREDITS, `Insufficient credits: need ${required}, have ${available}`, {
+      required,
+      available,
+      ...options?.purchaseUrl && { purchaseUrl: options.purchaseUrl }
+    });
+    this.name = "InsufficientCreditsError";
+  }
+};
+var SubscriptionRequiredError = class extends MCPError {
+  constructor(requiredTier, currentTier, options) {
+    const msg = currentTier ? `Subscription '${requiredTier}' required (current: '${currentTier}')` : `Subscription '${requiredTier}' required`;
+    super(ErrorCodes.SUBSCRIPTION_REQUIRED, msg, {
+      requiredTier,
+      ...currentTier && { currentTier },
+      ...options?.upgradeUrl && { upgradeUrl: options.upgradeUrl }
+    });
+    this.name = "SubscriptionRequiredError";
+  }
+};
+
+// src/payment/index.ts
+var paymentConfig = null;
+function initPayment(config) {
+  paymentConfig = {
+    apiUrl: "https://api.openconductor.ai",
+    testMode: false,
+    ...config
+  };
+}
+function getPaymentConfig() {
+  return paymentConfig;
+}
+async function checkBilling(params) {
+  const config = paymentConfig;
+  if (!config) {
+    throw new ConfigurationError("payment", "Payment not initialized. Call initPayment() first.");
+  }
+  if (config.testMode) {
+    return { allowed: true, credits: 9999, tier: "test" };
+  }
+  try {
+    const response = await fetch(`${config.apiUrl}/v1/billing/check`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        userId: params.userId,
+        requirement: params.requirement,
+        tool: params.toolName
+      })
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      console.error("[payment] Billing check failed:", response.status, errorBody);
+      return {
+        allowed: false,
+        reason: "Billing service unavailable",
+        actionUrl: config.upgradeUrl
+      };
+    }
+    return await response.json();
+  } catch (error) {
+    console.error("[payment] Billing check error:", error);
+    return {
+      allowed: false,
+      reason: "Unable to verify billing status",
+      actionUrl: config.upgradeUrl
+    };
+  }
+}
+async function deductCredits(params) {
+  const config = paymentConfig;
+  if (!config) return false;
+  if (config.testMode) return true;
+  try {
+    const response = await fetch(`${config.apiUrl}/v1/billing/deduct`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        userId: params.userId,
+        credits: params.credits,
+        tool: params.toolName,
+        callId: params.callId
+      })
+    });
+    return response.ok;
+  } catch (error) {
+    console.error("[payment] Credit deduction error:", error);
+    return false;
+  }
+}
+function isCreditRequirement(req) {
+  return "credits" in req && typeof req.credits === "number";
+}
+function isSubscriptionRequirement(req) {
+  return "tier" in req && typeof req.tier === "string";
+}
+function isStripeRequirement(req) {
+  return "priceId" in req && typeof req.priceId === "string";
+}
+function requirePayment(requirement, options = {}) {
+  return (handler) => {
+    const { toolName = "unknown", getUserId } = options;
+    return async (input) => {
+      const userId = getUserId?.(input) ?? input.userId;
+      if (!userId) {
+        throw new PaymentRequiredError(toolName, {
+          upgradeUrl: paymentConfig?.upgradeUrl
+        });
+      }
+      const status = await checkBilling({
+        userId,
+        requirement,
+        toolName
+      });
+      if (!status.allowed) {
+        if (isCreditRequirement(requirement)) {
+          throw new InsufficientCreditsError(
+            requirement.credits,
+            status.credits ?? 0,
+            { purchaseUrl: status.actionUrl }
+          );
+        }
+        if (isSubscriptionRequirement(requirement)) {
+          throw new SubscriptionRequiredError(
+            requirement.tier,
+            status.tier,
+            { upgradeUrl: status.actionUrl }
+          );
+        }
+        throw new PaymentRequiredError(toolName, {
+          upgradeUrl: status.actionUrl,
+          ...isStripeRequirement(requirement) && { priceId: requirement.priceId }
+        });
+      }
+      const result = await handler(input);
+      if (isCreditRequirement(requirement)) {
+        await deductCredits({
+          userId,
+          credits: requirement.credits,
+          toolName
+        });
+      }
+      return result;
+    };
+  };
+}
+function createPaidTool(config) {
+  return requirePayment(config.payment, {
+    toolName: config.name,
+    getUserId: config.getUserId
+  })(config.handler);
+}
+async function canUserAccess(userId, requirement, toolName = "check") {
+  return checkBilling({ userId, requirement, toolName });
+}
+async function getUserBillingStatus(userId) {
+  const config = paymentConfig;
+  if (!config) return null;
+  if (config.testMode) {
+    return { credits: 9999, tier: "test", active: true };
+  }
+  try {
+    const response = await fetch(`${config.apiUrl}/v1/billing/status/${userId}`, {
+      headers: {
+        "Authorization": `Bearer ${config.apiKey}`
+      }
+    });
+    if (!response.ok) return null;
+    return await response.json();
+  } catch {
+    return null;
+  }
+}
+
+exports.canUserAccess = canUserAccess;
+exports.createPaidTool = createPaidTool;
+exports.getPaymentConfig = getPaymentConfig;
+exports.getUserBillingStatus = getUserBillingStatus;
+exports.initPayment = initPayment;
+exports.requirePayment = requirePayment;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/payment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/codes.ts","../../src/errors/index.ts","../../src/payment/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * JSON-RPC 2.0 Standard Error Codes\n * https://www.jsonrpc.org/specification#error_object\n */\nexport const ErrorCodes = {\n  // JSON-RPC 2.0 Standard Errors\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n\n  // MCP-Specific Errors (-32000 to -32099 reserved for implementation)\n  TOOL_NOT_FOUND: -32001,\n  TOOL_EXECUTION_ERROR: -32002,\n  RESOURCE_NOT_FOUND: -32003,\n  AUTHENTICATION_ERROR: -32004,\n  AUTHORIZATION_ERROR: -32005,\n  RATE_LIMIT_ERROR: -32006,\n  TIMEOUT_ERROR: -32007,\n  VALIDATION_ERROR: -32008,\n  DEPENDENCY_ERROR: -32009,\n  CONFIGURATION_ERROR: -32010,\n  PAYMENT_REQUIRED: -32011,\n  INSUFFICIENT_CREDITS: -32012,\n  SUBSCRIPTION_REQUIRED: -32013,\n} as const\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes]\n","import { ErrorCodes, type ErrorCode } from './codes'\n\nexport { ErrorCodes, type ErrorCode } from './codes'\n\n/**\n * Base error class for MCP servers\n * Formats errors according to JSON-RPC 2.0 specification\n */\nexport class MCPError extends Error {\n  public readonly code: ErrorCode\n  public readonly data?: Record<string, unknown>\n\n  constructor(\n    code: ErrorCode,\n    message: string,\n    data?: Record<string, unknown>\n  ) {\n    super(message)\n    this.name = 'MCPError'\n    this.code = code\n    this.data = data\n\n    // Maintains proper stack trace in V8 environments\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor)\n    }\n  }\n\n  /**\n   * Returns JSON-RPC 2.0 formatted error object\n   */\n  toJSON() {\n    return {\n      code: this.code,\n      message: this.message,\n      ...(this.data && { data: this.data }),\n    }\n  }\n\n  /**\n   * Create error response for JSON-RPC\n   */\n  toResponse(id: string | number | null = null) {\n    return {\n      jsonrpc: '2.0' as const,\n      id,\n      error: this.toJSON(),\n    }\n  }\n}\n\n/**\n * Thrown when tool input validation fails\n */\nexport class ValidationError extends MCPError {\n  constructor(field: string, reason: string, value?: unknown) {\n    super(ErrorCodes.INVALID_PARAMS, `Validation failed for '${field}': ${reason}`, {\n      field,\n      reason,\n      ...(value !== undefined && { value }),\n    })\n    this.name = 'ValidationError'\n  }\n}\n\n/**\n * Thrown when a requested tool doesn't exist\n */\nexport class ToolNotFoundError extends MCPError {\n  constructor(toolName: string) {\n    super(ErrorCodes.TOOL_NOT_FOUND, `Tool '${toolName}' not found`, {\n      tool: toolName,\n    })\n    this.name = 'ToolNotFoundError'\n  }\n}\n\n/**\n * Thrown when tool execution fails\n */\nexport class ToolExecutionError extends MCPError {\n  constructor(toolName: string, reason: string, cause?: Error) {\n    super(ErrorCodes.TOOL_EXECUTION_ERROR, `Tool '${toolName}' failed: ${reason}`, {\n      tool: toolName,\n      reason,\n      ...(cause && { cause: cause.message }),\n    })\n    this.name = 'ToolExecutionError'\n  }\n}\n\n/**\n * Thrown when a requested resource doesn't exist\n */\nexport class ResourceNotFoundError extends MCPError {\n  constructor(resourceUri: string) {\n    super(ErrorCodes.RESOURCE_NOT_FOUND, `Resource '${resourceUri}' not found`, {\n      uri: resourceUri,\n    })\n    this.name = 'ResourceNotFoundError'\n  }\n}\n\n/**\n * Thrown when authentication fails\n */\nexport class AuthenticationError extends MCPError {\n  constructor(reason: string = 'Authentication required') {\n    super(ErrorCodes.AUTHENTICATION_ERROR, reason)\n    this.name = 'AuthenticationError'\n  }\n}\n\n/**\n * Thrown when authorization fails (authenticated but not permitted)\n */\nexport class AuthorizationError extends MCPError {\n  constructor(action: string, resource?: string) {\n    const msg = resource\n      ? `Not authorized to ${action} on '${resource}'`\n      : `Not authorized to ${action}`\n    super(ErrorCodes.AUTHORIZATION_ERROR, msg, {\n      action,\n      ...(resource && { resource }),\n    })\n    this.name = 'AuthorizationError'\n  }\n}\n\n/**\n * Thrown when rate limits are exceeded\n */\nexport class RateLimitError extends MCPError {\n  constructor(retryAfterMs?: number) {\n    super(ErrorCodes.RATE_LIMIT_ERROR, 'Rate limit exceeded', {\n      ...(retryAfterMs && { retryAfterMs }),\n    })\n    this.name = 'RateLimitError'\n  }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends MCPError {\n  constructor(operation: string, timeoutMs: number) {\n    super(ErrorCodes.TIMEOUT_ERROR, `Operation '${operation}' timed out after ${timeoutMs}ms`, {\n      operation,\n      timeoutMs,\n    })\n    this.name = 'TimeoutError'\n  }\n}\n\n/**\n * Thrown when a required dependency is unavailable\n */\nexport class DependencyError extends MCPError {\n  constructor(dependency: string, reason: string) {\n    super(ErrorCodes.DEPENDENCY_ERROR, `Dependency '${dependency}' unavailable: ${reason}`, {\n      dependency,\n      reason,\n    })\n    this.name = 'DependencyError'\n  }\n}\n\n/**\n * Thrown when server configuration is invalid\n */\nexport class ConfigurationError extends MCPError {\n  constructor(setting: string, reason: string) {\n    super(ErrorCodes.CONFIGURATION_ERROR, `Invalid configuration '${setting}': ${reason}`, {\n      setting,\n      reason,\n    })\n    this.name = 'ConfigurationError'\n  }\n}\n\n/**\n * Thrown when payment is required to access a tool\n */\nexport class PaymentRequiredError extends MCPError {\n  constructor(toolName: string, options?: { upgradeUrl?: string; priceId?: string }) {\n    super(ErrorCodes.PAYMENT_REQUIRED, `Payment required to use '${toolName}'`, {\n      tool: toolName,\n      ...(options?.upgradeUrl && { upgradeUrl: options.upgradeUrl }),\n      ...(options?.priceId && { priceId: options.priceId }),\n    })\n    this.name = 'PaymentRequiredError'\n  }\n}\n\n/**\n * Thrown when user doesn't have enough credits\n */\nexport class InsufficientCreditsError extends MCPError {\n  constructor(required: number, available: number, options?: { purchaseUrl?: string }) {\n    super(ErrorCodes.INSUFFICIENT_CREDITS, `Insufficient credits: need ${required}, have ${available}`, {\n      required,\n      available,\n      ...(options?.purchaseUrl && { purchaseUrl: options.purchaseUrl }),\n    })\n    this.name = 'InsufficientCreditsError'\n  }\n}\n\n/**\n * Thrown when a subscription tier is required\n */\nexport class SubscriptionRequiredError extends MCPError {\n  constructor(requiredTier: string, currentTier?: string, options?: { upgradeUrl?: string }) {\n    const msg = currentTier \n      ? `Subscription '${requiredTier}' required (current: '${currentTier}')`\n      : `Subscription '${requiredTier}' required`\n    super(ErrorCodes.SUBSCRIPTION_REQUIRED, msg, {\n      requiredTier,\n      ...(currentTier && { currentTier }),\n      ...(options?.upgradeUrl && { upgradeUrl: options.upgradeUrl }),\n    })\n    this.name = 'SubscriptionRequiredError'\n  }\n}\n","import {\n  PaymentRequiredError,\n  InsufficientCreditsError,\n  SubscriptionRequiredError,\n  ConfigurationError,\n} from '../errors'\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface PaymentConfig {\n  /** OpenConductor API key for billing */\n  apiKey: string\n  /** Base URL for billing API (default: https://api.openconductor.ai) */\n  apiUrl?: string\n  /** Default upgrade URL to show users */\n  upgradeUrl?: string\n  /** Enable test mode (skips actual billing) */\n  testMode?: boolean\n}\n\nexport interface CreditRequirement {\n  /** Number of credits to deduct per call */\n  credits: number\n}\n\nexport interface SubscriptionRequirement {\n  /** Required subscription tier (e.g., 'pro', 'enterprise') */\n  tier: string\n  /** Alternative tiers that also grant access */\n  allowedTiers?: string[]\n}\n\nexport interface StripeRequirement {\n  /** Stripe Price ID for per-call billing */\n  priceId: string\n}\n\nexport type PaymentRequirement = \n  | CreditRequirement \n  | SubscriptionRequirement \n  | StripeRequirement\n\nexport interface UserContext {\n  /** User ID for billing lookup */\n  userId: string\n  /** Optional API key override */\n  apiKey?: string\n}\n\nexport interface BillingStatus {\n  /** Whether the user can proceed */\n  allowed: boolean\n  /** Current credit balance (if applicable) */\n  credits?: number\n  /** Current subscription tier (if applicable) */\n  tier?: string\n  /** Reason for denial (if not allowed) */\n  reason?: string\n  /** URL for upgrade/purchase */\n  actionUrl?: string\n}\n\n// ============================================================================\n// Configuration\n// ============================================================================\n\nlet paymentConfig: PaymentConfig | null = null\n\n/**\n * Initialize payment/billing configuration\n * \n * @example\n * ```typescript\n * initPayment({\n *   apiKey: process.env.OPENCONDUCTOR_API_KEY!,\n *   upgradeUrl: 'https://myapp.com/upgrade'\n * })\n * ```\n */\nexport function initPayment(config: PaymentConfig): void {\n  paymentConfig = {\n    apiUrl: 'https://api.openconductor.ai',\n    testMode: false,\n    ...config,\n  }\n}\n\n/**\n * Get current payment configuration\n */\nexport function getPaymentConfig(): PaymentConfig | null {\n  return paymentConfig\n}\n\n// ============================================================================\n// Billing Client\n// ============================================================================\n\ninterface CheckBillingParams {\n  userId: string\n  requirement: PaymentRequirement\n  toolName: string\n}\n\ninterface DeductCreditsParams {\n  userId: string\n  credits: number\n  toolName: string\n  callId?: string\n}\n\nasync function checkBilling(params: CheckBillingParams): Promise<BillingStatus> {\n  const config = paymentConfig\n  if (!config) {\n    throw new ConfigurationError('payment', 'Payment not initialized. Call initPayment() first.')\n  }\n\n  // Test mode - always allow\n  if (config.testMode) {\n    return { allowed: true, credits: 9999, tier: 'test' }\n  }\n\n  try {\n    const response = await fetch(`${config.apiUrl}/v1/billing/check`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.apiKey}`,\n      },\n      body: JSON.stringify({\n        userId: params.userId,\n        requirement: params.requirement,\n        tool: params.toolName,\n      }),\n    })\n\n    if (!response.ok) {\n      // Non-2xx response - treat as billing check failed\n      const errorBody = await response.text()\n      console.error('[payment] Billing check failed:', response.status, errorBody)\n      return {\n        allowed: false,\n        reason: 'Billing service unavailable',\n        actionUrl: config.upgradeUrl,\n      }\n    }\n\n    return await response.json() as BillingStatus\n  } catch (error) {\n    // Network error - fail open or closed based on config\n    console.error('[payment] Billing check error:', error)\n    return {\n      allowed: false,\n      reason: 'Unable to verify billing status',\n      actionUrl: config.upgradeUrl,\n    }\n  }\n}\n\nasync function deductCredits(params: DeductCreditsParams): Promise<boolean> {\n  const config = paymentConfig\n  if (!config) return false\n\n  // Test mode - don't actually deduct\n  if (config.testMode) return true\n\n  try {\n    const response = await fetch(`${config.apiUrl}/v1/billing/deduct`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.apiKey}`,\n      },\n      body: JSON.stringify({\n        userId: params.userId,\n        credits: params.credits,\n        tool: params.toolName,\n        callId: params.callId,\n      }),\n    })\n\n    return response.ok\n  } catch (error) {\n    console.error('[payment] Credit deduction error:', error)\n    return false\n  }\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\nfunction isCreditRequirement(req: PaymentRequirement): req is CreditRequirement {\n  return 'credits' in req && typeof req.credits === 'number'\n}\n\nfunction isSubscriptionRequirement(req: PaymentRequirement): req is SubscriptionRequirement {\n  return 'tier' in req && typeof req.tier === 'string'\n}\n\nfunction isStripeRequirement(req: PaymentRequirement): req is StripeRequirement {\n  return 'priceId' in req && typeof req.priceId === 'string'\n}\n\n// ============================================================================\n// Main Middleware\n// ============================================================================\n\nexport interface RequirePaymentOptions {\n  /** Tool name for billing records */\n  toolName?: string\n  /** Function to extract user ID from input */\n  getUserId?: (input: unknown) => string | undefined\n  /** Custom error handler */\n  onPaymentError?: (error: Error) => void\n}\n\n/**\n * One-line payment middleware for MCP tools\n * \n * @example Credits-based billing\n * ```typescript\n * const paidTool = requirePayment({ credits: 10 })(myHandler)\n * ```\n * \n * @example Subscription tier requirement\n * ```typescript\n * const premiumTool = requirePayment({ tier: 'pro' })(myHandler)\n * ```\n * \n * @example With wrapTool\n * ```typescript\n * const safePaidTool = wrapTool(\n *   requirePayment({ credits: 5 })(myHandler),\n *   { name: 'premium-analysis' }\n * )\n * ```\n */\nexport function requirePayment<TInput extends { userId?: string }, TOutput>(\n  requirement: PaymentRequirement,\n  options: RequirePaymentOptions = {}\n) {\n  return (\n    handler: (input: TInput) => TOutput | Promise<TOutput>\n  ): ((input: TInput) => Promise<TOutput>) => {\n    \n    const { toolName = 'unknown', getUserId } = options\n\n    return async (input: TInput): Promise<TOutput> => {\n      // Extract user ID\n      const userId = getUserId?.(input) ?? input.userId\n      \n      if (!userId) {\n        throw new PaymentRequiredError(toolName, {\n          upgradeUrl: paymentConfig?.upgradeUrl,\n        })\n      }\n\n      // Check billing status\n      const status = await checkBilling({\n        userId,\n        requirement,\n        toolName,\n      })\n\n      if (!status.allowed) {\n        // Throw appropriate error based on requirement type\n        if (isCreditRequirement(requirement)) {\n          throw new InsufficientCreditsError(\n            requirement.credits,\n            status.credits ?? 0,\n            { purchaseUrl: status.actionUrl }\n          )\n        }\n\n        if (isSubscriptionRequirement(requirement)) {\n          throw new SubscriptionRequiredError(\n            requirement.tier,\n            status.tier,\n            { upgradeUrl: status.actionUrl }\n          )\n        }\n\n        // Generic payment required\n        throw new PaymentRequiredError(toolName, {\n          upgradeUrl: status.actionUrl,\n          ...(isStripeRequirement(requirement) && { priceId: requirement.priceId }),\n        })\n      }\n\n      // Execute the handler\n      const result = await handler(input)\n\n      // Deduct credits after successful execution (if credit-based)\n      if (isCreditRequirement(requirement)) {\n        await deductCredits({\n          userId,\n          credits: requirement.credits,\n          toolName,\n        })\n      }\n\n      return result\n    }\n  }\n}\n\n// ============================================================================\n// Convenience Functions\n// ============================================================================\n\n/**\n * Create a paid tool with built-in payment verification\n * \n * @example\n * ```typescript\n * const analyzeData = createPaidTool({\n *   name: 'analyze-data',\n *   payment: { credits: 10 },\n *   handler: async (input) => {\n *     // Your tool logic\n *     return result\n *   }\n * })\n * ```\n */\nexport function createPaidTool<TInput extends { userId?: string }, TOutput>(config: {\n  name: string\n  payment: PaymentRequirement\n  handler: (input: TInput) => TOutput | Promise<TOutput>\n  getUserId?: (input: TInput) => string | undefined\n}): (input: TInput) => Promise<TOutput> {\n  return requirePayment<TInput, TOutput>(config.payment, {\n    toolName: config.name,\n    getUserId: config.getUserId as (input: unknown) => string | undefined,\n  })(config.handler)\n}\n\n/**\n * Check if a user can access a paid feature without executing it\n * Useful for UI gating\n * \n * @example\n * ```typescript\n * const canAccess = await canUserAccess('user_123', { credits: 10 }, 'premium-tool')\n * if (!canAccess.allowed) {\n *   showUpgradePrompt(canAccess.actionUrl)\n * }\n * ```\n */\nexport async function canUserAccess(\n  userId: string,\n  requirement: PaymentRequirement,\n  toolName: string = 'check'\n): Promise<BillingStatus> {\n  return checkBilling({ userId, requirement, toolName })\n}\n\n/**\n * Get user's current billing status\n */\nexport async function getUserBillingStatus(userId: string): Promise<{\n  credits: number\n  tier: string\n  active: boolean\n} | null> {\n  const config = paymentConfig\n  if (!config) return null\n\n  if (config.testMode) {\n    return { credits: 9999, tier: 'test', active: true }\n  }\n\n  try {\n    const response = await fetch(`${config.apiUrl}/v1/billing/status/${userId}`, {\n      headers: {\n        'Authorization': `Bearer ${config.apiKey}`,\n      },\n    })\n\n    if (!response.ok) return null\n    return await response.json()\n  } catch {\n    return null\n  }\n}\n"]}

package/dist/payment/index.mjs

@@ -0,0 +1,246 @@
+// src/errors/codes.ts
+var ErrorCodes = {
+  CONFIGURATION_ERROR: -32010,
+  PAYMENT_REQUIRED: -32011,
+  INSUFFICIENT_CREDITS: -32012,
+  SUBSCRIPTION_REQUIRED: -32013
+};
+
+// src/errors/index.ts
+var MCPError = class extends Error {
+  code;
+  data;
+  constructor(code, message, data) {
+    super(message);
+    this.name = "MCPError";
+    this.code = code;
+    this.data = data;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  /**
+   * Returns JSON-RPC 2.0 formatted error object
+   */
+  toJSON() {
+    return {
+      code: this.code,
+      message: this.message,
+      ...this.data && { data: this.data }
+    };
+  }
+  /**
+   * Create error response for JSON-RPC
+   */
+  toResponse(id = null) {
+    return {
+      jsonrpc: "2.0",
+      id,
+      error: this.toJSON()
+    };
+  }
+};
+var ConfigurationError = class extends MCPError {
+  constructor(setting, reason) {
+    super(ErrorCodes.CONFIGURATION_ERROR, `Invalid configuration '${setting}': ${reason}`, {
+      setting,
+      reason
+    });
+    this.name = "ConfigurationError";
+  }
+};
+var PaymentRequiredError = class extends MCPError {
+  constructor(toolName, options) {
+    super(ErrorCodes.PAYMENT_REQUIRED, `Payment required to use '${toolName}'`, {
+      tool: toolName,
+      ...options?.upgradeUrl && { upgradeUrl: options.upgradeUrl },
+      ...options?.priceId && { priceId: options.priceId }
+    });
+    this.name = "PaymentRequiredError";
+  }
+};
+var InsufficientCreditsError = class extends MCPError {
+  constructor(required, available, options) {
+    super(ErrorCodes.INSUFFICIENT_CREDITS, `Insufficient credits: need ${required}, have ${available}`, {
+      required,
+      available,
+      ...options?.purchaseUrl && { purchaseUrl: options.purchaseUrl }
+    });
+    this.name = "InsufficientCreditsError";
+  }
+};
+var SubscriptionRequiredError = class extends MCPError {
+  constructor(requiredTier, currentTier, options) {
+    const msg = currentTier ? `Subscription '${requiredTier}' required (current: '${currentTier}')` : `Subscription '${requiredTier}' required`;
+    super(ErrorCodes.SUBSCRIPTION_REQUIRED, msg, {
+      requiredTier,
+      ...currentTier && { currentTier },
+      ...options?.upgradeUrl && { upgradeUrl: options.upgradeUrl }
+    });
+    this.name = "SubscriptionRequiredError";
+  }
+};
+
+// src/payment/index.ts
+var paymentConfig = null;
+function initPayment(config) {
+  paymentConfig = {
+    apiUrl: "https://api.openconductor.ai",
+    testMode: false,
+    ...config
+  };
+}
+function getPaymentConfig() {
+  return paymentConfig;
+}
+async function checkBilling(params) {
+  const config = paymentConfig;
+  if (!config) {
+    throw new ConfigurationError("payment", "Payment not initialized. Call initPayment() first.");
+  }
+  if (config.testMode) {
+    return { allowed: true, credits: 9999, tier: "test" };
+  }
+  try {
+    const response = await fetch(`${config.apiUrl}/v1/billing/check`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        userId: params.userId,
+        requirement: params.requirement,
+        tool: params.toolName
+      })
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      console.error("[payment] Billing check failed:", response.status, errorBody);
+      return {
+        allowed: false,
+        reason: "Billing service unavailable",
+        actionUrl: config.upgradeUrl
+      };
+    }
+    return await response.json();
+  } catch (error) {
+    console.error("[payment] Billing check error:", error);
+    return {
+      allowed: false,
+      reason: "Unable to verify billing status",
+      actionUrl: config.upgradeUrl
+    };
+  }
+}
+async function deductCredits(params) {
+  const config = paymentConfig;
+  if (!config) return false;
+  if (config.testMode) return true;
+  try {
+    const response = await fetch(`${config.apiUrl}/v1/billing/deduct`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        userId: params.userId,
+        credits: params.credits,
+        tool: params.toolName,
+        callId: params.callId
+      })
+    });
+    return response.ok;
+  } catch (error) {
+    console.error("[payment] Credit deduction error:", error);
+    return false;
+  }
+}
+function isCreditRequirement(req) {
+  return "credits" in req && typeof req.credits === "number";
+}
+function isSubscriptionRequirement(req) {
+  return "tier" in req && typeof req.tier === "string";
+}
+function isStripeRequirement(req) {
+  return "priceId" in req && typeof req.priceId === "string";
+}
+function requirePayment(requirement, options = {}) {
+  return (handler) => {
+    const { toolName = "unknown", getUserId } = options;
+    return async (input) => {
+      const userId = getUserId?.(input) ?? input.userId;
+      if (!userId) {
+        throw new PaymentRequiredError(toolName, {
+          upgradeUrl: paymentConfig?.upgradeUrl
+        });
+      }
+      const status = await checkBilling({
+        userId,
+        requirement,
+        toolName
+      });
+      if (!status.allowed) {
+        if (isCreditRequirement(requirement)) {
+          throw new InsufficientCreditsError(
+            requirement.credits,
+            status.credits ?? 0,
+            { purchaseUrl: status.actionUrl }
+          );
+        }
+        if (isSubscriptionRequirement(requirement)) {
+          throw new SubscriptionRequiredError(
+            requirement.tier,
+            status.tier,
+            { upgradeUrl: status.actionUrl }
+          );
+        }
+        throw new PaymentRequiredError(toolName, {
+          upgradeUrl: status.actionUrl,
+          ...isStripeRequirement(requirement) && { priceId: requirement.priceId }
+        });
+      }
+      const result = await handler(input);
+      if (isCreditRequirement(requirement)) {
+        await deductCredits({
+          userId,
+          credits: requirement.credits,
+          toolName
+        });
+      }
+      return result;
+    };
+  };
+}
+function createPaidTool(config) {
+  return requirePayment(config.payment, {
+    toolName: config.name,
+    getUserId: config.getUserId
+  })(config.handler);
+}
+async function canUserAccess(userId, requirement, toolName = "check") {
+  return checkBilling({ userId, requirement, toolName });
+}
+async function getUserBillingStatus(userId) {
+  const config = paymentConfig;
+  if (!config) return null;
+  if (config.testMode) {
+    return { credits: 9999, tier: "test", active: true };
+  }
+  try {
+    const response = await fetch(`${config.apiUrl}/v1/billing/status/${userId}`, {
+      headers: {
+        "Authorization": `Bearer ${config.apiKey}`
+      }
+    });
+    if (!response.ok) return null;
+    return await response.json();
+  } catch {
+    return null;
+  }
+}
+
+export { canUserAccess, createPaidTool, getPaymentConfig, getUserBillingStatus, initPayment, requirePayment };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map