@startsimpli/billing 0.1.0

package/src/utils/api.test.ts

@@ -0,0 +1,129 @@
+import { describe, it, expect, vi } from "vitest";
+import { BillingApiClient } from "./api";
+
+describe("BillingApiClient", () => {
+  const mockFetch = vi.fn();
+
+  function createClient(authToken?: string) {
+    return new BillingApiClient({
+      apiBaseUrl: "https://api.test.com/api/v1",
+      authToken,
+      fetcher: mockFetch as unknown as typeof fetch,
+    });
+  }
+
+  beforeEach(() => {
+    mockFetch.mockReset();
+  });
+
+  describe("getProduct", () => {
+    it("calls correct URL with no auth", async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        json: () =>
+          Promise.resolve({ slug: "test", name: "Test", offers: [] }),
+      });
+
+      const client = createClient("tok_123");
+      await client.getProduct("test-product");
+
+      expect(mockFetch).toHaveBeenCalledWith(
+        "https://api.test.com/api/v1/billing/products/test-product/",
+        expect.objectContaining({
+          headers: expect.not.objectContaining({
+            Authorization: expect.any(String),
+          }),
+        })
+      );
+    });
+
+    it("throws on 404", async () => {
+      mockFetch.mockResolvedValue({ ok: false, status: 404 });
+
+      const client = createClient();
+      await expect(client.getProduct("nope")).rejects.toThrow("404");
+    });
+  });
+
+  describe("createCheckout", () => {
+    it("sends POST with auth header", async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        json: () =>
+          Promise.resolve({ session_id: "cs_1", url: "https://pay.com" }),
+      });
+
+      const client = createClient("tok_abc");
+      const result = await client.createCheckout({
+        offerId: "offer-1",
+        successUrl: "https://ok.com",
+        cancelUrl: "https://nope.com",
+      });
+
+      expect(result.session_id).toBe("cs_1");
+      expect(mockFetch).toHaveBeenCalledWith(
+        "https://api.test.com/api/v1/billing/offer-checkout/",
+        expect.objectContaining({
+          method: "POST",
+          headers: expect.objectContaining({
+            Authorization: "Bearer tok_abc",
+          }),
+        })
+      );
+    });
+
+    it("includes quantity in request body", async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        json: () =>
+          Promise.resolve({ session_id: "cs_1", url: "https://pay.com" }),
+      });
+
+      const client = createClient("tok");
+      await client.createCheckout({
+        offerId: "offer-1",
+        successUrl: "https://ok.com",
+        cancelUrl: "https://nope.com",
+        quantity: 10,
+      });
+
+      const body = JSON.parse(mockFetch.mock.calls[0][1].body);
+      expect(body.quantity).toBe(10);
+    });
+
+    it("throws with detail message on failure", async () => {
+      mockFetch.mockResolvedValue({
+        ok: false,
+        status: 400,
+        json: () => Promise.resolve({ detail: "Offer not synced" }),
+      });
+
+      const client = createClient("tok");
+      await expect(
+        client.createCheckout({
+          offerId: "bad",
+          successUrl: "x",
+          cancelUrl: "y",
+        })
+      ).rejects.toThrow("Offer not synced");
+    });
+  });
+
+  describe("createPortal", () => {
+    it("sends POST with return_url", async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        json: () =>
+          Promise.resolve({ url: "https://portal.stripe.com/test" }),
+      });
+
+      const client = createClient("tok_xyz");
+      const result = await client.createPortal("https://app.com/settings");
+
+      expect(result.url).toBe("https://portal.stripe.com/test");
+
+      const body = JSON.parse(mockFetch.mock.calls[0][1].body);
+      expect(body.return_url).toBe("https://app.com/settings");
+    });
+  });
+});

package/src/utils/api.ts

@@ -0,0 +1,123 @@
+/**
+ * API client for billing endpoints.
+ */
+
+import type {
+  BillingConfig,
+  BillingProduct,
+  CheckoutResult,
+  FreeSubscriptionResult,
+  PortalResult,
+  SubscriptionInfo,
+} from "../types";
+
+export class BillingApiClient {
+  private config: BillingConfig;
+
+  constructor(config: BillingConfig) {
+    this.config = config;
+  }
+
+  private get fetcher() {
+    return this.config.fetcher ?? fetch.bind(globalThis);
+  }
+
+  private headers(authenticated: boolean = false): HeadersInit {
+    const h: Record<string, string> = {
+      "Content-Type": "application/json",
+    };
+    if (authenticated && this.config.authToken) {
+      h["Authorization"] = `Bearer ${this.config.authToken}`;
+    }
+    return h;
+  }
+
+  /** Fetch a public billing product by slug. */
+  async getProduct(slug: string): Promise<BillingProduct> {
+    const url = `${this.config.apiBaseUrl}/billing/products/${slug}/`;
+    const resp = await this.fetcher(url, {
+      headers: this.headers(false),
+    });
+    if (!resp.ok) {
+      throw new Error(`Failed to fetch product "${slug}": ${resp.status}`);
+    }
+    return resp.json();
+  }
+
+  /** Create a checkout session for an offer. */
+  async createCheckout(params: {
+    offerId: string;
+    successUrl: string;
+    cancelUrl: string;
+    quantity?: number;
+  }): Promise<CheckoutResult> {
+    const url = `${this.config.apiBaseUrl}/billing/offer-checkout/`;
+    const resp = await this.fetcher(url, {
+      method: "POST",
+      headers: this.headers(true),
+      body: JSON.stringify({
+        offer_id: params.offerId,
+        success_url: params.successUrl,
+        cancel_url: params.cancelUrl,
+        quantity: params.quantity ?? 1,
+      }),
+    });
+    if (!resp.ok) {
+      const data = await resp.json().catch(() => ({}));
+      throw new Error(
+        data.detail ?? `Checkout failed: ${resp.status}`
+      );
+    }
+    return resp.json();
+  }
+
+  /** Subscribe to a free offer (no billing provider). */
+  async subscribeFree(offerId: string): Promise<FreeSubscriptionResult> {
+    const url = `${this.config.apiBaseUrl}/billing/subscribe-free/`;
+    const resp = await this.fetcher(url, {
+      method: "POST",
+      headers: this.headers(true),
+      body: JSON.stringify({ offer_id: offerId }),
+    });
+    if (!resp.ok) {
+      const data = await resp.json().catch(() => ({}));
+      throw new Error(data.detail ?? `Free signup failed: ${resp.status}`);
+    }
+    return resp.json();
+  }
+
+  /** Create a customer portal session. */
+  async createPortal(returnUrl: string): Promise<PortalResult> {
+    const url = `${this.config.apiBaseUrl}/billing/offer-portal/`;
+    const resp = await this.fetcher(url, {
+      method: "POST",
+      headers: this.headers(true),
+      body: JSON.stringify({ return_url: returnUrl }),
+    });
+    if (!resp.ok) {
+      const data = await resp.json().catch(() => ({}));
+      throw new Error(
+        data.detail ?? `Portal session failed: ${resp.status}`
+      );
+    }
+    return resp.json();
+  }
+
+  /** Get current user's subscription. */
+  async getSubscription(): Promise<SubscriptionInfo | null> {
+    const url = `${this.config.apiBaseUrl}/billing/subscription/current/`;
+    const resp = await this.fetcher(url, {
+      headers: this.headers(true),
+    });
+    if (resp.status === 404) {
+      return null; // No active subscription
+    }
+    if (!resp.ok) {
+      const data = await resp.json().catch(() => ({}));
+      throw new Error(
+        data.detail ?? `Failed to fetch subscription: ${resp.status}`
+      );
+    }
+    return resp.json();
+  }
+}