@openconductor/mcp-sdk 1.2.0 → 1.3.1

package/dist/payment/index.d.mts

@@ -1,3 +1,5 @@
+import { SubscriptionRequiredError, PaymentRequiredError } from '../errors/index.mjs';
+
 interface PaymentConfig {
     /** OpenConductor API key for billing */
     apiKey: string;
@@ -133,5 +135,140 @@ declare function getUserBillingStatus(userId: string): Promise<{
     tier: string;
     active: boolean;
 } | null>;
+type CreditPack = 'starter' | 'pro' | 'business';
+interface CreditPackInfo {
+    name: string;
+    credits: number;
+    price: number;
+    perCredit: number;
+    savings: number;
+    bestFor: string;
+    popular?: boolean;
+}
+interface CheckoutSession {
+    sessionId: string;
+    url: string;
+    pack: CreditPack;
+    credits: number;
+    price: number;
+    perCredit: number;
+}
+/**
+ * Get available credit packs and pricing
+ *
+ * @example
+ * ```typescript
+ * const packs = await getCreditPacks()
+ * console.log(packs.pro) // { name: 'Pro Pack', credits: 500, price: 39.99, ... }
+ * ```
+ */
+declare function getCreditPacks(): Promise<Record<CreditPack, CreditPackInfo> | null>;
+/**
+ * Create a Stripe checkout session for purchasing credits
+ * Returns a URL to redirect the user to for payment
+ *
+ * @example
+ * ```typescript
+ * const checkout = await createCreditsCheckout('pro', {
+ *   successUrl: 'https://myapp.com/success',
+ *   cancelUrl: 'https://myapp.com/pricing',
+ * })
+ *
+ * // Redirect user to checkout
+ * window.location.href = checkout.url
+ * ```
+ */
+declare function createCreditsCheckout(pack: CreditPack, options?: {
+    successUrl?: string;
+    cancelUrl?: string;
+}): Promise<CheckoutSession | null>;
+/**
+ * Generate a direct checkout URL for embedding in upgrade prompts
+ *
+ * @example In an error handler:
+ * ```typescript
+ * catch (error) {
+ *   if (error instanceof InsufficientCreditsError) {
+ *     const checkoutUrl = await getCheckoutUrl('pro')
+ *     return { error: `Insufficient credits. Buy more: ${checkoutUrl}` }
+ *   }
+ * }
+ * ```
+ */
+declare function getCheckoutUrl(pack: CreditPack): Promise<string | null>;
+interface UpgradePromptOptions {
+    /** Required credits for the blocked action */
+    required?: number;
+    /** Currently available credits */
+    available?: number;
+    /** Tool that was blocked */
+    toolName?: string;
+    /** Include direct checkout links */
+    includeLinks?: boolean;
+}
+/**
+ * Generate a user-friendly upgrade prompt message
+ * Use this in your error handlers to show helpful messages
+ *
+ * @example
+ * ```typescript
+ * catch (error) {
+ *   if (error instanceof InsufficientCreditsError) {
+ *     const prompt = await generateUpgradePrompt({
+ *       required: error.data.required,
+ *       available: error.data.available,
+ *       toolName: 'analyze-data'
+ *     })
+ *     console.log(prompt.message)
+ *     // "You need 10 more credits to use analyze-data.
+ *     //  Buy the Pro Pack (500 credits) for $39.99 → https://..."
+ *   }
+ * }
+ * ```
+ */
+declare function generateUpgradePrompt(options?: UpgradePromptOptions): Promise<{
+    message: string;
+    shortMessage: string;
+    recommendedPack: CreditPack;
+    packs: Record<CreditPack, {
+        credits: number;
+        price: number;
+        url: string | null;
+    }>;
+}>;
+/**
+ * Get a simple checkout URL for the dashboard
+ * Useful when you don't want to create a full Stripe session
+ */
+declare function getDashboardCheckoutUrl(options?: {
+    required?: number;
+    available?: number;
+    pack?: CreditPack;
+}): string;
+/**
+ * Create an error handler that automatically generates upgrade prompts
+ *
+ * @example
+ * ```typescript
+ * const handleError = createUpgradeErrorHandler({
+ *   onInsufficientCredits: (prompt) => {
+ *     return { error: prompt.shortMessage, upgradeUrl: prompt.packs.pro.url }
+ *   }
+ * })
+ *
+ * // In your tool:
+ * try {
+ *   return await paidHandler(input)
+ * } catch (error) {
+ *   return handleError(error)
+ * }
+ * ```
+ */
+declare function createUpgradeErrorHandler(handlers: {
+    onInsufficientCredits?: (prompt: Awaited<ReturnType<typeof generateUpgradePrompt>>) => unknown;
+    onSubscriptionRequired?: (error: SubscriptionRequiredError) => unknown;
+    onPaymentRequired?: (error: PaymentRequiredError) => unknown;
+    onOtherError?: (error: Error) => unknown;
+}): (error: Error) => Promise<unknown>;
 
-export { type BillingStatus, type CreditRequirement, type PaymentConfig, type PaymentRequirement, type RequirePaymentOptions, type StripeRequirement, type SubscriptionRequirement, type UserContext, canUserAccess, createPaidTool, getPaymentConfig, getUserBillingStatus, initPayment, requirePayment };
+export { type BillingStatus, type CheckoutSession, type CreditPack, type CreditPackInfo, type CreditRequirement, type PaymentConfig, type PaymentRequirement, type RequirePaymentOptions, type StripeRequirement, type SubscriptionRequirement, type UpgradePromptOptions, type UserContext, canUserAccess, createCreditsCheckout, createPaidTool, createUpgradeErrorHandler, generateUpgradePrompt, getCheckoutUrl, getCreditPacks, getDashboardCheckoutUrl, getPaymentConfig, getUserBillingStatus, initPayment, requirePayment };

package/dist/payment/index.d.ts

@@ -1,3 +1,5 @@
+import { SubscriptionRequiredError, PaymentRequiredError } from '../errors/index.js';
+
 interface PaymentConfig {
     /** OpenConductor API key for billing */
     apiKey: string;
@@ -133,5 +135,140 @@ declare function getUserBillingStatus(userId: string): Promise<{
     tier: string;
     active: boolean;
 } | null>;
+type CreditPack = 'starter' | 'pro' | 'business';
+interface CreditPackInfo {
+    name: string;
+    credits: number;
+    price: number;
+    perCredit: number;
+    savings: number;
+    bestFor: string;
+    popular?: boolean;
+}
+interface CheckoutSession {
+    sessionId: string;
+    url: string;
+    pack: CreditPack;
+    credits: number;
+    price: number;
+    perCredit: number;
+}
+/**
+ * Get available credit packs and pricing
+ *
+ * @example
+ * ```typescript
+ * const packs = await getCreditPacks()
+ * console.log(packs.pro) // { name: 'Pro Pack', credits: 500, price: 39.99, ... }
+ * ```
+ */
+declare function getCreditPacks(): Promise<Record<CreditPack, CreditPackInfo> | null>;
+/**
+ * Create a Stripe checkout session for purchasing credits
+ * Returns a URL to redirect the user to for payment
+ *
+ * @example
+ * ```typescript
+ * const checkout = await createCreditsCheckout('pro', {
+ *   successUrl: 'https://myapp.com/success',
+ *   cancelUrl: 'https://myapp.com/pricing',
+ * })
+ *
+ * // Redirect user to checkout
+ * window.location.href = checkout.url
+ * ```
+ */
+declare function createCreditsCheckout(pack: CreditPack, options?: {
+    successUrl?: string;
+    cancelUrl?: string;
+}): Promise<CheckoutSession | null>;
+/**
+ * Generate a direct checkout URL for embedding in upgrade prompts
+ *
+ * @example In an error handler:
+ * ```typescript
+ * catch (error) {
+ *   if (error instanceof InsufficientCreditsError) {
+ *     const checkoutUrl = await getCheckoutUrl('pro')
+ *     return { error: `Insufficient credits. Buy more: ${checkoutUrl}` }
+ *   }
+ * }
+ * ```
+ */
+declare function getCheckoutUrl(pack: CreditPack): Promise<string | null>;
+interface UpgradePromptOptions {
+    /** Required credits for the blocked action */
+    required?: number;
+    /** Currently available credits */
+    available?: number;
+    /** Tool that was blocked */
+    toolName?: string;
+    /** Include direct checkout links */
+    includeLinks?: boolean;
+}
+/**
+ * Generate a user-friendly upgrade prompt message
+ * Use this in your error handlers to show helpful messages
+ *
+ * @example
+ * ```typescript
+ * catch (error) {
+ *   if (error instanceof InsufficientCreditsError) {
+ *     const prompt = await generateUpgradePrompt({
+ *       required: error.data.required,
+ *       available: error.data.available,
+ *       toolName: 'analyze-data'
+ *     })
+ *     console.log(prompt.message)
+ *     // "You need 10 more credits to use analyze-data.
+ *     //  Buy the Pro Pack (500 credits) for $39.99 → https://..."
+ *   }
+ * }
+ * ```
+ */
+declare function generateUpgradePrompt(options?: UpgradePromptOptions): Promise<{
+    message: string;
+    shortMessage: string;
+    recommendedPack: CreditPack;
+    packs: Record<CreditPack, {
+        credits: number;
+        price: number;
+        url: string | null;
+    }>;
+}>;
+/**
+ * Get a simple checkout URL for the dashboard
+ * Useful when you don't want to create a full Stripe session
+ */
+declare function getDashboardCheckoutUrl(options?: {
+    required?: number;
+    available?: number;
+    pack?: CreditPack;
+}): string;
+/**
+ * Create an error handler that automatically generates upgrade prompts
+ *
+ * @example
+ * ```typescript
+ * const handleError = createUpgradeErrorHandler({
+ *   onInsufficientCredits: (prompt) => {
+ *     return { error: prompt.shortMessage, upgradeUrl: prompt.packs.pro.url }
+ *   }
+ * })
+ *
+ * // In your tool:
+ * try {
+ *   return await paidHandler(input)
+ * } catch (error) {
+ *   return handleError(error)
+ * }
+ * ```
+ */
+declare function createUpgradeErrorHandler(handlers: {
+    onInsufficientCredits?: (prompt: Awaited<ReturnType<typeof generateUpgradePrompt>>) => unknown;
+    onSubscriptionRequired?: (error: SubscriptionRequiredError) => unknown;
+    onPaymentRequired?: (error: PaymentRequiredError) => unknown;
+    onOtherError?: (error: Error) => unknown;
+}): (error: Error) => Promise<unknown>;
 
-export { type BillingStatus, type CreditRequirement, type PaymentConfig, type PaymentRequirement, type RequirePaymentOptions, type StripeRequirement, type SubscriptionRequirement, type UserContext, canUserAccess, createPaidTool, getPaymentConfig, getUserBillingStatus, initPayment, requirePayment };
+export { type BillingStatus, type CheckoutSession, type CreditPack, type CreditPackInfo, type CreditRequirement, type PaymentConfig, type PaymentRequirement, type RequirePaymentOptions, type StripeRequirement, type SubscriptionRequirement, type UpgradePromptOptions, type UserContext, canUserAccess, createCreditsCheckout, createPaidTool, createUpgradeErrorHandler, generateUpgradePrompt, getCheckoutUrl, getCreditPacks, getDashboardCheckoutUrl, getPaymentConfig, getUserBillingStatus, initPayment, requirePayment };

package/dist/payment/index.js

@@ -242,9 +242,139 @@ async function getUserBillingStatus(userId) {
     return null;
   }
 }
+async function getCreditPacks() {
+  const config = paymentConfig;
+  if (!config) return null;
+  try {
+    const response = await fetch(`${config.apiUrl}/functions/v1/credit-packs`);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return data.packs;
+  } catch {
+    return null;
+  }
+}
+async function createCreditsCheckout(pack, options = {}) {
+  const config = paymentConfig;
+  if (!config) {
+    console.error("[payment] Payment not initialized. Call initPayment() first.");
+    return null;
+  }
+  try {
+    const response = await fetch(`${config.apiUrl}/functions/v1/stripe-checkout-credits`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({
+        pack,
+        successUrl: options.successUrl,
+        cancelUrl: options.cancelUrl
+      })
+    });
+    if (!response.ok) {
+      const error = await response.text();
+      console.error("[payment] Checkout creation failed:", error);
+      return null;
+    }
+    return await response.json();
+  } catch (error) {
+    console.error("[payment] Checkout error:", error);
+    return null;
+  }
+}
+async function getCheckoutUrl(pack) {
+  const session = await createCreditsCheckout(pack);
+  return session?.url ?? null;
+}
+async function generateUpgradePrompt(options = {}) {
+  const { required = 0, available = 0, toolName, includeLinks = true } = options;
+  const needed = Math.max(0, required - available);
+  let recommendedPack = "starter";
+  if (needed > 100) recommendedPack = "pro";
+  if (needed > 500) recommendedPack = "business";
+  const packUrls = {
+    starter: null,
+    pro: null,
+    business: null
+  };
+  if (includeLinks) {
+    const [starterUrl, proUrl, businessUrl] = await Promise.all([
+      getCheckoutUrl("starter"),
+      getCheckoutUrl("pro"),
+      getCheckoutUrl("business")
+    ]);
+    packUrls.starter = starterUrl;
+    packUrls.pro = proUrl;
+    packUrls.business = businessUrl;
+  }
+  const toolPart = toolName ? ` to use ${toolName}` : "";
+  const shortMessage = `Insufficient credits: need ${required}, have ${available}`;
+  let message = `You need ${needed} more credits${toolPart}.
+
+`;
+  message += `\u{1F4B3} Quick top-up options:
+`;
+  message += `  \u2022 Starter: 100 credits for $9.99${packUrls.starter ? ` \u2192 ${packUrls.starter}` : ""}
+`;
+  message += `  \u2022 Pro: 500 credits for $39.99 (20% off)${packUrls.pro ? ` \u2192 ${packUrls.pro}` : ""}
+`;
+  message += `  \u2022 Business: 2,000 credits for $119.99 (40% off)${packUrls.business ? ` \u2192 ${packUrls.business}` : ""}
+`;
+  if (recommendedPack !== "starter") {
+    message += `
+\u2728 Recommended: ${recommendedPack.charAt(0).toUpperCase() + recommendedPack.slice(1)} Pack`;
+  }
+  return {
+    message,
+    shortMessage,
+    recommendedPack,
+    packs: {
+      starter: { credits: 100, price: 9.99, url: packUrls.starter },
+      pro: { credits: 500, price: 39.99, url: packUrls.pro },
+      business: { credits: 2e3, price: 119.99, url: packUrls.business }
+    }
+  };
+}
+function getDashboardCheckoutUrl(options = {}) {
+  const params = new URLSearchParams();
+  params.set("action", "buy-credits");
+  if (options.required) params.set("required", String(options.required));
+  if (options.available) params.set("available", String(options.available));
+  if (options.pack) params.set("pack", options.pack);
+  return `https://dashboard.openconductor.ai?${params.toString()}`;
+}
+function createUpgradeErrorHandler(handlers) {
+  return async (error) => {
+    if (error instanceof InsufficientCreditsError && handlers.onInsufficientCredits) {
+      const prompt = await generateUpgradePrompt({
+        required: error.data?.required,
+        available: error.data?.available
+      });
+      return handlers.onInsufficientCredits(prompt);
+    }
+    if (error instanceof SubscriptionRequiredError && handlers.onSubscriptionRequired) {
+      return handlers.onSubscriptionRequired(error);
+    }
+    if (error instanceof PaymentRequiredError && handlers.onPaymentRequired) {
+      return handlers.onPaymentRequired(error);
+    }
+    if (handlers.onOtherError) {
+      return handlers.onOtherError(error);
+    }
+    throw error;
+  };
+}
 
 exports.canUserAccess = canUserAccess;
+exports.createCreditsCheckout = createCreditsCheckout;
 exports.createPaidTool = createPaidTool;
+exports.createUpgradeErrorHandler = createUpgradeErrorHandler;
+exports.generateUpgradePrompt = generateUpgradePrompt;
+exports.getCheckoutUrl = getCheckoutUrl;
+exports.getCreditPacks = getCreditPacks;
+exports.getDashboardCheckoutUrl = getDashboardCheckoutUrl;
 exports.getPaymentConfig = getPaymentConfig;
 exports.getUserBillingStatus = getUserBillingStatus;
 exports.initPayment = initPayment;

package/dist/payment/index.js.map

@@ -1 +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}/functions/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}/functions/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}/functions/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"]}
+{"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}/functions/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}/functions/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}/functions/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\n// ============================================================================\n// Checkout Helpers\n// ============================================================================\n\nexport type CreditPack = 'starter' | 'pro' | 'business'\n\nexport interface CreditPackInfo {\n  name: string\n  credits: number\n  price: number\n  perCredit: number\n  savings: number\n  bestFor: string\n  popular?: boolean\n}\n\nexport interface CheckoutSession {\n  sessionId: string\n  url: string\n  pack: CreditPack\n  credits: number\n  price: number\n  perCredit: number\n}\n\n/**\n * Get available credit packs and pricing\n * \n * @example\n * ```typescript\n * const packs = await getCreditPacks()\n * console.log(packs.pro) // { name: 'Pro Pack', credits: 500, price: 39.99, ... }\n * ```\n */\nexport async function getCreditPacks(): Promise<Record<CreditPack, CreditPackInfo> | null> {\n  const config = paymentConfig\n  if (!config) return null\n\n  try {\n    const response = await fetch(`${config.apiUrl}/functions/v1/credit-packs`)\n    if (!response.ok) return null\n    const data = await response.json()\n    return data.packs\n  } catch {\n    return null\n  }\n}\n\n/**\n * Create a Stripe checkout session for purchasing credits\n * Returns a URL to redirect the user to for payment\n * \n * @example\n * ```typescript\n * const checkout = await createCreditsCheckout('pro', {\n *   successUrl: 'https://myapp.com/success',\n *   cancelUrl: 'https://myapp.com/pricing',\n * })\n * \n * // Redirect user to checkout\n * window.location.href = checkout.url\n * ```\n */\nexport async function createCreditsCheckout(\n  pack: CreditPack,\n  options: {\n    successUrl?: string\n    cancelUrl?: string\n  } = {}\n): Promise<CheckoutSession | null> {\n  const config = paymentConfig\n  if (!config) {\n    console.error('[payment] Payment not initialized. Call initPayment() first.')\n    return null\n  }\n\n  try {\n    const response = await fetch(`${config.apiUrl}/functions/v1/stripe-checkout-credits`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.apiKey}`,\n      },\n      body: JSON.stringify({\n        pack,\n        successUrl: options.successUrl,\n        cancelUrl: options.cancelUrl,\n      }),\n    })\n\n    if (!response.ok) {\n      const error = await response.text()\n      console.error('[payment] Checkout creation failed:', error)\n      return null\n    }\n\n    return await response.json() as CheckoutSession\n  } catch (error) {\n    console.error('[payment] Checkout error:', error)\n    return null\n  }\n}\n\n/**\n * Generate a direct checkout URL for embedding in upgrade prompts\n * \n * @example In an error handler:\n * ```typescript\n * catch (error) {\n *   if (error instanceof InsufficientCreditsError) {\n *     const checkoutUrl = await getCheckoutUrl('pro')\n *     return { error: `Insufficient credits. Buy more: ${checkoutUrl}` }\n *   }\n * }\n * ```\n */\nexport async function getCheckoutUrl(pack: CreditPack): Promise<string | null> {\n  const session = await createCreditsCheckout(pack)\n  return session?.url ?? null\n}\n\n// ============================================================================\n// Upgrade Prompts\n// ============================================================================\n\nexport interface UpgradePromptOptions {\n  /** Required credits for the blocked action */\n  required?: number\n  /** Currently available credits */\n  available?: number\n  /** Tool that was blocked */\n  toolName?: string\n  /** Include direct checkout links */\n  includeLinks?: boolean\n}\n\n/**\n * Generate a user-friendly upgrade prompt message\n * Use this in your error handlers to show helpful messages\n * \n * @example\n * ```typescript\n * catch (error) {\n *   if (error instanceof InsufficientCreditsError) {\n *     const prompt = await generateUpgradePrompt({\n *       required: error.data.required,\n *       available: error.data.available,\n *       toolName: 'analyze-data'\n *     })\n *     console.log(prompt.message)\n *     // \"You need 10 more credits to use analyze-data. \n *     //  Buy the Pro Pack (500 credits) for $39.99 → https://...\"\n *   }\n * }\n * ```\n */\nexport async function generateUpgradePrompt(\n  options: UpgradePromptOptions = {}\n): Promise<{\n  message: string\n  shortMessage: string\n  recommendedPack: CreditPack\n  packs: Record<CreditPack, { credits: number; price: number; url: string | null }>\n}> {\n  const { required = 0, available = 0, toolName, includeLinks = true } = options\n  const needed = Math.max(0, required - available)\n  \n  // Determine recommended pack based on needed credits\n  let recommendedPack: CreditPack = 'starter'\n  if (needed > 100) recommendedPack = 'pro'\n  if (needed > 500) recommendedPack = 'business'\n  \n  // Get pack URLs if requested\n  const packUrls: Record<CreditPack, string | null> = {\n    starter: null,\n    pro: null,\n    business: null,\n  }\n  \n  if (includeLinks) {\n    const [starterUrl, proUrl, businessUrl] = await Promise.all([\n      getCheckoutUrl('starter'),\n      getCheckoutUrl('pro'),\n      getCheckoutUrl('business'),\n    ])\n    packUrls.starter = starterUrl\n    packUrls.pro = proUrl\n    packUrls.business = businessUrl\n  }\n  \n  // Build message\n  const toolPart = toolName ? ` to use ${toolName}` : ''\n  const shortMessage = `Insufficient credits: need ${required}, have ${available}`\n  \n  let message = `You need ${needed} more credits${toolPart}.\\n\\n`\n  message += `💳 Quick top-up options:\\n`\n  message += `  • Starter: 100 credits for $9.99${packUrls.starter ? ` → ${packUrls.starter}` : ''}\\n`\n  message += `  • Pro: 500 credits for $39.99 (20% off)${packUrls.pro ? ` → ${packUrls.pro}` : ''}\\n`\n  message += `  • Business: 2,000 credits for $119.99 (40% off)${packUrls.business ? ` → ${packUrls.business}` : ''}\\n`\n  \n  if (recommendedPack !== 'starter') {\n    message += `\\n✨ Recommended: ${recommendedPack.charAt(0).toUpperCase() + recommendedPack.slice(1)} Pack`\n  }\n  \n  return {\n    message,\n    shortMessage,\n    recommendedPack,\n    packs: {\n      starter: { credits: 100, price: 9.99, url: packUrls.starter },\n      pro: { credits: 500, price: 39.99, url: packUrls.pro },\n      business: { credits: 2000, price: 119.99, url: packUrls.business },\n    },\n  }\n}\n\n/**\n * Get a simple checkout URL for the dashboard\n * Useful when you don't want to create a full Stripe session\n */\nexport function getDashboardCheckoutUrl(options: {\n  required?: number\n  available?: number\n  pack?: CreditPack\n} = {}): string {\n  const params = new URLSearchParams()\n  params.set('action', 'buy-credits')\n  if (options.required) params.set('required', String(options.required))\n  if (options.available) params.set('available', String(options.available))\n  if (options.pack) params.set('pack', options.pack)\n  return `https://dashboard.openconductor.ai?${params.toString()}`\n}\n\n/**\n * Create an error handler that automatically generates upgrade prompts\n * \n * @example\n * ```typescript\n * const handleError = createUpgradeErrorHandler({\n *   onInsufficientCredits: (prompt) => {\n *     return { error: prompt.shortMessage, upgradeUrl: prompt.packs.pro.url }\n *   }\n * })\n * \n * // In your tool:\n * try {\n *   return await paidHandler(input)\n * } catch (error) {\n *   return handleError(error)\n * }\n * ```\n */\nexport function createUpgradeErrorHandler(handlers: {\n  onInsufficientCredits?: (prompt: Awaited<ReturnType<typeof generateUpgradePrompt>>) => unknown\n  onSubscriptionRequired?: (error: SubscriptionRequiredError) => unknown\n  onPaymentRequired?: (error: PaymentRequiredError) => unknown\n  onOtherError?: (error: Error) => unknown\n}) {\n  return async (error: Error): Promise<unknown> => {\n    if (error instanceof InsufficientCreditsError && handlers.onInsufficientCredits) {\n      const prompt = await generateUpgradePrompt({\n        required: error.data?.required as number,\n        available: error.data?.available as number,\n      })\n      return handlers.onInsufficientCredits(prompt)\n    }\n    \n    if (error instanceof SubscriptionRequiredError && handlers.onSubscriptionRequired) {\n      return handlers.onSubscriptionRequired(error)\n    }\n    \n    if (error instanceof PaymentRequiredError && handlers.onPaymentRequired) {\n      return handlers.onPaymentRequired(error)\n    }\n    \n    if (handlers.onOtherError) {\n      return handlers.onOtherError(error)\n    }\n    \n    throw error\n  }\n}\n"]}