@stacknet/stacks 0.1.0

package/src/clients/billing.ts

@@ -0,0 +1,157 @@
+/**
+ * Billing Client
+ * Plans, checkout, usage, and payment management scoped to a stack
+ */
+
+import { DEFAULT_GLAYER_NETWORK_URL, JSON_HEADERS } from '../utils/constants';
+import { StacksSDKError } from '../utils/errors';
+import type {
+  BillingState,
+  BillingPlansResponse,
+  CreateCheckoutSessionResponse,
+  BillingPortalResponse,
+  BillingClientConfig,
+} from '../types/billing';
+
+export type { BillingClientConfig } from '../types/billing';
+
+const API_PATH = '/api/v2';
+
+export class BillingClient {
+  private baseUrl: string;
+  private authToken: string | null;
+
+  constructor(config: BillingClientConfig = {}) {
+    this.baseUrl = config.baseUrl || DEFAULT_GLAYER_NETWORK_URL;
+    this.authToken = config.authToken || null;
+  }
+
+  setAuthToken(token: string | null) {
+    this.authToken = token;
+  }
+
+  private get headers(): Record<string, string> {
+    const h: Record<string, string> = { ...JSON_HEADERS };
+    if (this.authToken) {
+      h['Authorization'] = `Bearer ${this.authToken}`;
+    }
+    return h;
+  }
+
+  private url(path: string): string {
+    return `${this.baseUrl}${API_PATH}${path}`;
+  }
+
+  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {
+    const opts: RequestInit = { method, headers: this.headers };
+    if (body && method !== 'GET') {
+      opts.body = JSON.stringify(body);
+    }
+
+    const response = await fetch(this.url(path), opts);
+
+    if (!response.ok) {
+      const data = await response.json().catch(() => ({}));
+      throw new StacksSDKError(
+        response.status === 402 ? 'payment_required:api' : 'bad_request:api',
+        data.error?.message || `Request failed: ${response.statusText}`
+      );
+    }
+
+    const data = await response.json();
+    return (data && typeof data === 'object' && 'data' in data) ? data.data : data;
+  }
+
+  // =========================================================================
+  // Plans
+  // =========================================================================
+
+  async getPlans(stackId: string): Promise<BillingPlansResponse> {
+    return this.request<BillingPlansResponse>('GET', `/stacks/${stackId}/billing/plans`);
+  }
+
+  // =========================================================================
+  // Billing State
+  // =========================================================================
+
+  async getBillingState(stackId: string, identityId: string): Promise<BillingState> {
+    return this.request<BillingState>('GET', `/stacks/${stackId}/identities/${identityId}/billing`);
+  }
+
+  // =========================================================================
+  // Checkout & Portal
+  // =========================================================================
+
+  async createCheckoutSession(
+    stackId: string,
+    identityId: string,
+    planId: string,
+    successUrl: string,
+    cancelUrl: string
+  ): Promise<CreateCheckoutSessionResponse> {
+    return this.request<CreateCheckoutSessionResponse>('POST', `/stacks/${stackId}/billing/checkout`, {
+      identity_id: identityId,
+      plan_id: planId,
+      success_url: successUrl,
+      cancel_url: cancelUrl,
+    });
+  }
+
+  async createBillingPortal(stackId: string, identityId: string, returnUrl: string): Promise<BillingPortalResponse> {
+    return this.request<BillingPortalResponse>('POST', `/stacks/${stackId}/billing/portal`, {
+      identity_id: identityId,
+      return_url: returnUrl,
+    });
+  }
+
+  // =========================================================================
+  // Usage
+  // =========================================================================
+
+  async recordUsage(
+    stackId: string,
+    identityId: string,
+    usageType: string,
+    quantity: number,
+    idempotencyKey?: string
+  ): Promise<{ recorded: boolean; total_usage: number }> {
+    return this.request('POST', `/stacks/${stackId}/billing/usage`, {
+      identity_id: identityId,
+      usage_type: usageType,
+      quantity,
+      idempotency_key: idempotencyKey,
+    });
+  }
+
+  async getCurrentUsage(stackId: string, identityId: string): Promise<{ usage: { type: string; quantity: number; amount: number }[]; total_amount: number }> {
+    return this.request('GET', `/stacks/${stackId}/identities/${identityId}/billing/usage`);
+  }
+
+  // =========================================================================
+  // Payment Method
+  // =========================================================================
+
+  async linkStripeCustomer(stackId: string, identityId: string, stripeCustomerId: string, sessionId: string): Promise<{ linked: boolean }> {
+    return this.request('POST', `/stacks/${stackId}/billing/link`, {
+      identity_id: identityId,
+      stripe_customer_id: stripeCustomerId,
+      checkout_session_id: sessionId,
+    });
+  }
+
+  async hasPaymentMethod(stackId: string, identityId: string): Promise<{ has_payment_method: boolean; card_last_four?: string; card_brand?: string }> {
+    return this.request('GET', `/stacks/${stackId}/identities/${identityId}/billing/payment-method`);
+  }
+}
+
+/**
+ * Create a BillingClient instance
+ */
+export function createBillingClient(config: BillingClientConfig = {}): BillingClient {
+  return new BillingClient(config);
+}
+
+/**
+ * Default billing client instance
+ */
+export const billingClient = createBillingClient();