@usethrottle/subscriptions 1.0.0

package/dist/server.js

@@ -0,0 +1,166 @@
+import {
+  SubscriptionsClient,
+  ThrottleSubscriptionsError
+} from "./chunk-LJAXLA7O.js";
+
+// src/server.ts
+var ALLOWED_PATHS = [
+  /^\/api\/v1\/subscriptions(?:\/[\w.-]+)?(?:\/(?:pause|resume|cancel))?$/,
+  /^\/api\/v1\/subscriptions\/eligibility-check$/,
+  /^\/api\/v1\/customers\/by-external\/[\w.:%-]+$/,
+  /^\/api\/v1\/checkout\/sessions$/
+];
+function createSubscriptionProxyHandler(options) {
+  return async function subscriptionProxyHandler(request, context = {}) {
+    const path = await pathFromContext(context);
+    return handleSubscriptionProxyRequest(request, path, options);
+  };
+}
+async function handleSubscriptionProxyRequest(request, pathParts, options) {
+  const externalCustomerId = await options.getExternalCustomerId(request);
+  if (!externalCustomerId) return jsonError(401, "unauthorized", "Unauthorized");
+  const path = normalizePath(pathParts);
+  if (!ALLOWED_PATHS.some((pattern) => pattern.test(path))) {
+    return jsonError(403, "forbidden", "Path is not allowed by the subscription proxy");
+  }
+  const method = request.method.toUpperCase();
+  if (!["GET", "POST", "PATCH"].includes(method)) {
+    return jsonError(405, "method_not_allowed", "Method not allowed");
+  }
+  const client = new SubscriptionsClient({
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl,
+    fetch: options.fetch
+  });
+  if (isSubscriptionMutation(path, method)) {
+    const subId = subscriptionIdFromPath(path);
+    if (subId) {
+      const subscription = await client.get(subId).catch((err) => {
+        if (err instanceof ThrottleSubscriptionsError && err.statusCode === 404) return null;
+        throw err;
+      });
+      if (!subscription) return jsonError(404, "not_found", "Subscription not found");
+      const defaultAuthorized = await defaultMutationAuthorization(
+        client,
+        subscription,
+        externalCustomerId
+      );
+      const customAuthorized = options.authorizeMutation ? await options.authorizeMutation({ request, subscription, externalCustomerId }) : true;
+      if (!defaultAuthorized || !customAuthorized) {
+        return jsonError(403, "forbidden", "Subscription does not belong to this buyer");
+      }
+    }
+  }
+  const targetPath = await buildPinnedPathAndBody(request, path, externalCustomerId, client);
+  if (targetPath instanceof Response) return targetPath;
+  const upstream = await fetchWithApiKey(request, targetPath.path, {
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl,
+    fetch: options.fetch,
+    body: targetPath.body
+  });
+  return new Response(upstream.body, {
+    status: upstream.status,
+    headers: filterHeaders(upstream.headers)
+  });
+}
+async function buildPinnedPathAndBody(request, path, externalCustomerId, client) {
+  const url = new URL(request.url);
+  const query = new URLSearchParams(url.search);
+  if (request.method.toUpperCase() === "GET" && path === "/api/v1/subscriptions") {
+    query.set("externalCustomerId", externalCustomerId);
+    query.delete("customerId");
+    query.delete("customer_id");
+    query.delete("external_customer_id");
+  }
+  if (request.method.toUpperCase() === "GET" && isCustomerByExternalPath(path)) {
+    return {
+      path: withQuery(
+        `/api/v1/customers/by-external/${encodeURIComponent(externalCustomerId)}`,
+        query
+      )
+    };
+  }
+  if (request.method.toUpperCase() !== "GET") {
+    const raw = await request.text();
+    if (path === "/api/v1/subscriptions" && request.method.toUpperCase() === "POST") {
+      const customer = await client.getCustomerByExternalId(externalCustomerId);
+      if (!customer) return jsonError(404, "not_found", "Customer not found");
+      const body = raw ? JSON.parse(raw) : {};
+      body.customerId = customer.id;
+      delete body.customer_id;
+      delete body.externalCustomerId;
+      delete body.external_customer_id;
+      return { path: withQuery(path, query), body: JSON.stringify(body) };
+    }
+    if (path === "/api/v1/checkout/sessions" && raw) {
+      const body = JSON.parse(raw);
+      body.customer = {
+        ...body.customer ?? {},
+        externalCustomerId
+      };
+      delete body.customer.customerId;
+      return { path: withQuery(path, query), body: JSON.stringify(body) };
+    }
+    return { path: withQuery(path, query), body: raw || void 0 };
+  }
+  return { path: withQuery(path, query) };
+}
+async function fetchWithApiKey(request, path, opts) {
+  const fetchImpl = opts.fetch ?? globalThis.fetch;
+  if (!fetchImpl) throw new Error("fetch is required");
+  const baseUrl = (opts.baseUrl ?? "https://api.usethrottle.dev").replace(/\/+$/, "");
+  return fetchImpl(`${baseUrl}${path}`, {
+    method: request.method,
+    headers: {
+      "x-api-key": opts.apiKey,
+      "content-type": request.headers.get("content-type") ?? "application/json"
+    },
+    body: request.method.toUpperCase() === "GET" ? void 0 : opts.body
+  });
+}
+async function defaultMutationAuthorization(client, subscription, externalCustomerId) {
+  const customer = await client.getCustomerByExternalId(externalCustomerId);
+  return Boolean(customer?.id && customer.id === subscription.customerId);
+}
+async function pathFromContext(context) {
+  if (context.path) return context.path;
+  const path = context.params?.path;
+  if (!path) return [];
+  return await path;
+}
+function normalizePath(pathParts) {
+  if (typeof pathParts === "string") {
+    return pathParts.startsWith("/") ? pathParts : `/${pathParts}`;
+  }
+  return `/${pathParts.map((part) => part.replace(/^\/+|\/+$/g, "")).join("/")}`;
+}
+function withQuery(path, query) {
+  const qs = query.toString();
+  return qs ? `${path}?${qs}` : path;
+}
+function isSubscriptionMutation(path, method) {
+  if (path === "/api/v1/subscriptions/eligibility-check") return false;
+  return method !== "GET" && /^\/api\/v1\/subscriptions\/[\w.-]+/.test(path);
+}
+function isCustomerByExternalPath(path) {
+  return /^\/api\/v1\/customers\/by-external\/[\w.:%-]+$/.test(path);
+}
+function subscriptionIdFromPath(path) {
+  return path.match(/^\/api\/v1\/subscriptions\/([\w.-]+)/)?.[1] ?? null;
+}
+function filterHeaders(headers) {
+  const next = new Headers(headers);
+  next.delete("content-encoding");
+  next.delete("content-length");
+  next.delete("transfer-encoding");
+  return next;
+}
+function jsonError(status, code, message) {
+  return Response.json({ error: { code, message } }, { status });
+}
+export {
+  createSubscriptionProxyHandler,
+  handleSubscriptionProxyRequest
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { SubscriptionsClient } from './client';\nimport { ThrottleSubscriptionsError } from './errors';\nimport type { Subscription, SubscriptionsClientOptions } from './types';\n\nexport interface SubscriptionProxyOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  getExternalCustomerId: (request: Request) => string | null | Promise<string | null>;\n  authorizeMutation?: (args: {\n    request: Request;\n    subscription: Subscription;\n    externalCustomerId: string;\n  }) => boolean | Promise<boolean>;\n}\n\nexport interface SubscriptionProxyContext {\n  params?: {\n    path?: string[] | Promise<string[]>;\n  };\n  path?: string[] | string;\n}\n\nconst ALLOWED_PATHS = [\n  /^\\/api\\/v1\\/subscriptions(?:\\/[\\w.-]+)?(?:\\/(?:pause|resume|cancel))?$/,\n  /^\\/api\\/v1\\/subscriptions\\/eligibility-check$/,\n  /^\\/api\\/v1\\/customers\\/by-external\\/[\\w.:%-]+$/,\n  /^\\/api\\/v1\\/checkout\\/sessions$/,\n];\n\nexport function createSubscriptionProxyHandler(options: SubscriptionProxyOptions) {\n  return async function subscriptionProxyHandler(\n    request: Request,\n    context: SubscriptionProxyContext = {},\n  ): Promise<Response> {\n    const path = await pathFromContext(context);\n    return handleSubscriptionProxyRequest(request, path, options);\n  };\n}\n\nexport async function handleSubscriptionProxyRequest(\n  request: Request,\n  pathParts: string[] | string,\n  options: SubscriptionProxyOptions,\n): Promise<Response> {\n  const externalCustomerId = await options.getExternalCustomerId(request);\n  if (!externalCustomerId) return jsonError(401, 'unauthorized', 'Unauthorized');\n\n  const path = normalizePath(pathParts);\n  if (!ALLOWED_PATHS.some((pattern) => pattern.test(path))) {\n    return jsonError(403, 'forbidden', 'Path is not allowed by the subscription proxy');\n  }\n\n  const method = request.method.toUpperCase();\n  if (!['GET', 'POST', 'PATCH'].includes(method)) {\n    return jsonError(405, 'method_not_allowed', 'Method not allowed');\n  }\n\n  const client = new SubscriptionsClient({\n    apiKey: options.apiKey,\n    baseUrl: options.baseUrl,\n    fetch: options.fetch,\n  } satisfies SubscriptionsClientOptions);\n\n  if (isSubscriptionMutation(path, method)) {\n    const subId = subscriptionIdFromPath(path);\n    if (subId) {\n      const subscription = await client.get(subId).catch((err) => {\n        if (err instanceof ThrottleSubscriptionsError && err.statusCode === 404) return null;\n        throw err;\n      });\n      if (!subscription) return jsonError(404, 'not_found', 'Subscription not found');\n\n      const defaultAuthorized = await defaultMutationAuthorization(\n        client,\n        subscription,\n        externalCustomerId,\n      );\n      const customAuthorized = options.authorizeMutation\n        ? await options.authorizeMutation({ request, subscription, externalCustomerId })\n        : true;\n      if (!defaultAuthorized || !customAuthorized) {\n        return jsonError(403, 'forbidden', 'Subscription does not belong to this buyer');\n      }\n    }\n  }\n\n  const targetPath = await buildPinnedPathAndBody(request, path, externalCustomerId, client);\n  if (targetPath instanceof Response) return targetPath;\n  const upstream = await fetchWithApiKey(request, targetPath.path, {\n    apiKey: options.apiKey,\n    baseUrl: options.baseUrl,\n    fetch: options.fetch,\n    body: targetPath.body,\n  });\n\n  return new Response(upstream.body, {\n    status: upstream.status,\n    headers: filterHeaders(upstream.headers),\n  });\n}\n\nasync function buildPinnedPathAndBody(\n  request: Request,\n  path: string,\n  externalCustomerId: string,\n  client: SubscriptionsClient,\n): Promise<{ path: string; body?: string } | Response> {\n  const url = new URL(request.url);\n  const query = new URLSearchParams(url.search);\n\n  if (request.method.toUpperCase() === 'GET' && path === '/api/v1/subscriptions') {\n    query.set('externalCustomerId', externalCustomerId);\n    query.delete('customerId');\n    query.delete('customer_id');\n    query.delete('external_customer_id');\n  }\n\n  if (request.method.toUpperCase() === 'GET' && isCustomerByExternalPath(path)) {\n    return {\n      path: withQuery(\n        `/api/v1/customers/by-external/${encodeURIComponent(externalCustomerId)}`,\n        query,\n      ),\n    };\n  }\n\n  if (request.method.toUpperCase() !== 'GET') {\n    const raw = await request.text();\n    if (path === '/api/v1/subscriptions' && request.method.toUpperCase() === 'POST') {\n      const customer = await client.getCustomerByExternalId(externalCustomerId);\n      if (!customer) return jsonError(404, 'not_found', 'Customer not found');\n\n      const body = raw ? (JSON.parse(raw) as Record<string, any>) : {};\n      body.customerId = customer.id;\n      delete body.customer_id;\n      delete body.externalCustomerId;\n      delete body.external_customer_id;\n      return { path: withQuery(path, query), body: JSON.stringify(body) };\n    }\n\n    if (path === '/api/v1/checkout/sessions' && raw) {\n      const body = JSON.parse(raw) as Record<string, any>;\n      body.customer = {\n        ...(body.customer ?? {}),\n        externalCustomerId,\n      };\n      delete body.customer.customerId;\n      return { path: withQuery(path, query), body: JSON.stringify(body) };\n    }\n    return { path: withQuery(path, query), body: raw || undefined };\n  }\n\n  return { path: withQuery(path, query) };\n}\n\nasync function fetchWithApiKey(\n  request: Request,\n  path: string,\n  opts: {\n    apiKey: string;\n    baseUrl?: string;\n    fetch?: typeof globalThis.fetch;\n    body?: string;\n  },\n) {\n  const fetchImpl = opts.fetch ?? globalThis.fetch;\n  if (!fetchImpl) throw new Error('fetch is required');\n  const baseUrl = (opts.baseUrl ?? 'https://api.usethrottle.dev').replace(/\\/+$/, '');\n  return fetchImpl(`${baseUrl}${path}`, {\n    method: request.method,\n    headers: {\n      'x-api-key': opts.apiKey,\n      'content-type': request.headers.get('content-type') ?? 'application/json',\n    },\n    body: request.method.toUpperCase() === 'GET' ? undefined : opts.body,\n  });\n}\n\nasync function defaultMutationAuthorization(\n  client: SubscriptionsClient,\n  subscription: Subscription,\n  externalCustomerId: string,\n): Promise<boolean> {\n  const customer = await client.getCustomerByExternalId(externalCustomerId);\n  return Boolean(customer?.id && customer.id === subscription.customerId);\n}\n\nasync function pathFromContext(context: SubscriptionProxyContext): Promise<string[] | string> {\n  if (context.path) return context.path;\n  const path = context.params?.path;\n  if (!path) return [];\n  return await path;\n}\n\nfunction normalizePath(pathParts: string[] | string): string {\n  if (typeof pathParts === 'string') {\n    return pathParts.startsWith('/') ? pathParts : `/${pathParts}`;\n  }\n  return `/${pathParts.map((part) => part.replace(/^\\/+|\\/+$/g, '')).join('/')}`;\n}\n\nfunction withQuery(path: string, query: URLSearchParams): string {\n  const qs = query.toString();\n  return qs ? `${path}?${qs}` : path;\n}\n\nfunction isSubscriptionMutation(path: string, method: string): boolean {\n  if (path === '/api/v1/subscriptions/eligibility-check') return false;\n  return method !== 'GET' && /^\\/api\\/v1\\/subscriptions\\/[\\w.-]+/.test(path);\n}\n\nfunction isCustomerByExternalPath(path: string): boolean {\n  return /^\\/api\\/v1\\/customers\\/by-external\\/[\\w.:%-]+$/.test(path);\n}\n\nfunction subscriptionIdFromPath(path: string): string | null {\n  return path.match(/^\\/api\\/v1\\/subscriptions\\/([\\w.-]+)/)?.[1] ?? null;\n}\n\nfunction filterHeaders(headers: Headers): Headers {\n  const next = new Headers(headers);\n  next.delete('content-encoding');\n  next.delete('content-length');\n  next.delete('transfer-encoding');\n  return next;\n}\n\nfunction jsonError(status: number, code: string, message: string): Response {\n  return Response.json({ error: { code, message } }, { status });\n}\n"],"mappings":"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","names":[]}

package/dist/types-PiTA3r6t.d.cts

@@ -0,0 +1,233 @@
+import { CSSProperties, ReactNode } from 'react';
+
+type SubscriptionStatus = 'active' | 'paused' | 'cancelled' | 'past_due' | 'trialing';
+type SubscriptionInterval = 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+type SubscriptionSort = 'asc' | 'desc';
+interface Subscription {
+    id: string;
+    merchantId?: string | null;
+    storeId?: string | null;
+    customerId: string;
+    status: SubscriptionStatus;
+    planReference: string;
+    planName?: string | null;
+    interval: SubscriptionInterval;
+    amount: number;
+    currency: string;
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    trialEnd?: string | null;
+    cancelAtPeriodEnd: boolean;
+    failureCount: number;
+    lastPaymentAt?: string | null;
+    pausedAt?: string | null;
+    cancelledAt?: string | null;
+    metadata: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Customer {
+    id: string;
+    externalId?: string | null;
+    email?: string | null;
+    firstName?: string | null;
+    lastName?: string | null;
+    phone?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Pagination {
+    cursor: string | null;
+    hasMore: boolean;
+}
+interface PaginatedSubscriptions {
+    data: Subscription[];
+    pagination?: Pagination;
+}
+interface ListSubscriptionsParams {
+    customerId?: string;
+    externalCustomerId?: string;
+    status?: SubscriptionStatus;
+    interval?: SubscriptionInterval;
+    q?: string;
+    cursor?: string;
+    limit?: number;
+    sort?: SubscriptionSort;
+    createdAfter?: string | Date;
+    createdBefore?: string | Date;
+}
+interface CreateSubscriptionInput {
+    storeId?: string;
+    customerId?: string;
+    externalCustomerId?: string;
+    planReference: string;
+    planName?: string;
+    interval: SubscriptionInterval;
+    amount: number;
+    currency?: string;
+    currentPeriodStart: string | Date;
+    currentPeriodEnd: string | Date;
+    trialEnd?: string | Date;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateSubscriptionInput {
+    planReference?: string;
+    planName?: string;
+    interval?: SubscriptionInterval;
+    amount?: number;
+    metadata?: Record<string, unknown>;
+}
+interface CancelSubscriptionInput {
+    id: string;
+    atPeriodEnd?: boolean;
+}
+interface ChangePlanInput extends UpdateSubscriptionInput {
+    id: string;
+    planReference: string;
+}
+interface RecurringIntent {
+    plan: string;
+    interval: SubscriptionInterval;
+    amount?: number;
+    trialDays?: number;
+    planName?: string;
+    create?: 'auto' | 'manual';
+}
+interface CheckoutCustomerInput {
+    customerId?: string;
+    externalCustomerId?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    shippingAddress?: Record<string, unknown>;
+    billingAddress?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface CheckoutCollectInput {
+    shippingAddress?: boolean;
+    billingAddress?: boolean;
+}
+interface CreateCheckoutSessionInput {
+    storeId: string;
+    cartId?: string;
+    externalCartId?: string;
+    customerEmail?: string;
+    customer?: CheckoutCustomerInput;
+    returnUrl: string;
+    cancelUrl: string;
+    allowedMethods?: string[];
+    recurring: RecurringIntent;
+    collect?: CheckoutCollectInput;
+    metadata?: Record<string, unknown>;
+}
+interface CheckoutSession {
+    sessionId: string;
+    id?: string;
+    checkoutUrl?: string;
+    embedToken?: string;
+    expiresAt?: string;
+    [key: string]: unknown;
+}
+interface TrialEligibilityInput {
+    paymentMethodId: string;
+}
+type TrialEligibilityReason = 'card_already_used_for_trial' | 'payment_method_not_found' | 'no_fingerprint_available';
+interface TrialEligibilityResult {
+    eligible: boolean;
+    reason?: TrialEligibilityReason;
+}
+interface ThrottleEnvelope<T> {
+    data?: T;
+    meta?: {
+        request_id?: string;
+        pagination?: {
+            cursor?: string | null;
+            has_more?: boolean;
+            hasMore?: boolean;
+        };
+        [key: string]: unknown;
+    };
+    error?: {
+        code?: string;
+        message?: string;
+        details?: unknown;
+    };
+}
+type SubscriptionFetcher = (path: string, init?: RequestInit) => Promise<Response>;
+interface SubscriptionsClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    fetcher?: SubscriptionFetcher;
+    timeoutMs?: number;
+}
+interface SubscriptionProviderProps {
+    children: ReactNode;
+    client?: SubscriptionsClientContract;
+    fetcher?: SubscriptionFetcher;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+interface QueryState<T> {
+    data: T | null;
+    isLoading: boolean;
+    isFetching: boolean;
+    error: unknown;
+    refetch: () => Promise<T | null>;
+}
+interface MutationState<TData, TVariables> {
+    data: TData | null;
+    error: unknown;
+    isPending: boolean;
+    mutate: (variables: TVariables) => void;
+    mutateAsync: (variables: TVariables) => Promise<TData>;
+    reset: () => void;
+}
+interface QueryOptions<T> {
+    enabled?: boolean;
+    initialData?: T | null;
+}
+interface SubscriptionStatusBadgeProps {
+    status: SubscriptionStatus;
+    className?: string;
+    style?: CSSProperties;
+    labels?: Partial<Record<SubscriptionStatus, string>>;
+}
+interface TrialCountdownProps {
+    endDate: string | Date;
+    now?: Date;
+    className?: string;
+    style?: CSSProperties;
+    expiredLabel?: string;
+    prefix?: string;
+}
+interface DunningBannerProps {
+    subscription: Pick<Subscription, 'status' | 'failureCount' | 'currentPeriodEnd'>;
+    onUpdateCard?: () => void;
+    title?: string;
+    message?: string;
+    actionLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SubscriptionsClientContract {
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    requestEnvelope<T>(method: string, path: string, body?: unknown): Promise<ThrottleEnvelope<T>>;
+    create(input: CreateSubscriptionInput): Promise<Subscription>;
+    list(params?: ListSubscriptionsParams): Promise<PaginatedSubscriptions>;
+    get(id: string): Promise<Subscription>;
+    update(id: string, input: UpdateSubscriptionInput): Promise<Subscription>;
+    changePlan(input: ChangePlanInput): Promise<Subscription>;
+    pause(id: string): Promise<Subscription>;
+    resume(id: string): Promise<Subscription>;
+    cancel(id: string, input?: {
+        atPeriodEnd?: boolean;
+    }): Promise<Subscription>;
+    createCheckoutSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession>;
+    checkTrialEligibility(input: TrialEligibilityInput): Promise<TrialEligibilityResult>;
+    getCustomerByExternalId(externalId: string): Promise<Customer | null>;
+}
+
+export type { CreateSubscriptionInput as C, DunningBannerProps as D, ListSubscriptionsParams as L, MutationState as M, PaginatedSubscriptions as P, QueryOptions as Q, RecurringIntent as R, SubscriptionsClientContract as S, ThrottleEnvelope as T, UpdateSubscriptionInput as U, SubscriptionsClientOptions as a, Subscription as b, ChangePlanInput as c, CreateCheckoutSessionInput as d, CheckoutSession as e, TrialEligibilityInput as f, TrialEligibilityResult as g, Customer as h, SubscriptionProviderProps as i, SubscriptionFetcher as j, CancelSubscriptionInput as k, QueryState as l, SubscriptionStatusBadgeProps as m, TrialCountdownProps as n, SubscriptionStatus as o, CheckoutCollectInput as p, CheckoutCustomerInput as q, Pagination as r, SubscriptionInterval as s, SubscriptionSort as t, TrialEligibilityReason as u };

package/dist/types-PiTA3r6t.d.ts

@@ -0,0 +1,233 @@
+import { CSSProperties, ReactNode } from 'react';
+
+type SubscriptionStatus = 'active' | 'paused' | 'cancelled' | 'past_due' | 'trialing';
+type SubscriptionInterval = 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+type SubscriptionSort = 'asc' | 'desc';
+interface Subscription {
+    id: string;
+    merchantId?: string | null;
+    storeId?: string | null;
+    customerId: string;
+    status: SubscriptionStatus;
+    planReference: string;
+    planName?: string | null;
+    interval: SubscriptionInterval;
+    amount: number;
+    currency: string;
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    trialEnd?: string | null;
+    cancelAtPeriodEnd: boolean;
+    failureCount: number;
+    lastPaymentAt?: string | null;
+    pausedAt?: string | null;
+    cancelledAt?: string | null;
+    metadata: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Customer {
+    id: string;
+    externalId?: string | null;
+    email?: string | null;
+    firstName?: string | null;
+    lastName?: string | null;
+    phone?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Pagination {
+    cursor: string | null;
+    hasMore: boolean;
+}
+interface PaginatedSubscriptions {
+    data: Subscription[];
+    pagination?: Pagination;
+}
+interface ListSubscriptionsParams {
+    customerId?: string;
+    externalCustomerId?: string;
+    status?: SubscriptionStatus;
+    interval?: SubscriptionInterval;
+    q?: string;
+    cursor?: string;
+    limit?: number;
+    sort?: SubscriptionSort;
+    createdAfter?: string | Date;
+    createdBefore?: string | Date;
+}
+interface CreateSubscriptionInput {
+    storeId?: string;
+    customerId?: string;
+    externalCustomerId?: string;
+    planReference: string;
+    planName?: string;
+    interval: SubscriptionInterval;
+    amount: number;
+    currency?: string;
+    currentPeriodStart: string | Date;
+    currentPeriodEnd: string | Date;
+    trialEnd?: string | Date;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateSubscriptionInput {
+    planReference?: string;
+    planName?: string;
+    interval?: SubscriptionInterval;
+    amount?: number;
+    metadata?: Record<string, unknown>;
+}
+interface CancelSubscriptionInput {
+    id: string;
+    atPeriodEnd?: boolean;
+}
+interface ChangePlanInput extends UpdateSubscriptionInput {
+    id: string;
+    planReference: string;
+}
+interface RecurringIntent {
+    plan: string;
+    interval: SubscriptionInterval;
+    amount?: number;
+    trialDays?: number;
+    planName?: string;
+    create?: 'auto' | 'manual';
+}
+interface CheckoutCustomerInput {
+    customerId?: string;
+    externalCustomerId?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    shippingAddress?: Record<string, unknown>;
+    billingAddress?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface CheckoutCollectInput {
+    shippingAddress?: boolean;
+    billingAddress?: boolean;
+}
+interface CreateCheckoutSessionInput {
+    storeId: string;
+    cartId?: string;
+    externalCartId?: string;
+    customerEmail?: string;
+    customer?: CheckoutCustomerInput;
+    returnUrl: string;
+    cancelUrl: string;
+    allowedMethods?: string[];
+    recurring: RecurringIntent;
+    collect?: CheckoutCollectInput;
+    metadata?: Record<string, unknown>;
+}
+interface CheckoutSession {
+    sessionId: string;
+    id?: string;
+    checkoutUrl?: string;
+    embedToken?: string;
+    expiresAt?: string;
+    [key: string]: unknown;
+}
+interface TrialEligibilityInput {
+    paymentMethodId: string;
+}
+type TrialEligibilityReason = 'card_already_used_for_trial' | 'payment_method_not_found' | 'no_fingerprint_available';
+interface TrialEligibilityResult {
+    eligible: boolean;
+    reason?: TrialEligibilityReason;
+}
+interface ThrottleEnvelope<T> {
+    data?: T;
+    meta?: {
+        request_id?: string;
+        pagination?: {
+            cursor?: string | null;
+            has_more?: boolean;
+            hasMore?: boolean;
+        };
+        [key: string]: unknown;
+    };
+    error?: {
+        code?: string;
+        message?: string;
+        details?: unknown;
+    };
+}
+type SubscriptionFetcher = (path: string, init?: RequestInit) => Promise<Response>;
+interface SubscriptionsClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    fetcher?: SubscriptionFetcher;
+    timeoutMs?: number;
+}
+interface SubscriptionProviderProps {
+    children: ReactNode;
+    client?: SubscriptionsClientContract;
+    fetcher?: SubscriptionFetcher;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+interface QueryState<T> {
+    data: T | null;
+    isLoading: boolean;
+    isFetching: boolean;
+    error: unknown;
+    refetch: () => Promise<T | null>;
+}
+interface MutationState<TData, TVariables> {
+    data: TData | null;
+    error: unknown;
+    isPending: boolean;
+    mutate: (variables: TVariables) => void;
+    mutateAsync: (variables: TVariables) => Promise<TData>;
+    reset: () => void;
+}
+interface QueryOptions<T> {
+    enabled?: boolean;
+    initialData?: T | null;
+}
+interface SubscriptionStatusBadgeProps {
+    status: SubscriptionStatus;
+    className?: string;
+    style?: CSSProperties;
+    labels?: Partial<Record<SubscriptionStatus, string>>;
+}
+interface TrialCountdownProps {
+    endDate: string | Date;
+    now?: Date;
+    className?: string;
+    style?: CSSProperties;
+    expiredLabel?: string;
+    prefix?: string;
+}
+interface DunningBannerProps {
+    subscription: Pick<Subscription, 'status' | 'failureCount' | 'currentPeriodEnd'>;
+    onUpdateCard?: () => void;
+    title?: string;
+    message?: string;
+    actionLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SubscriptionsClientContract {
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    requestEnvelope<T>(method: string, path: string, body?: unknown): Promise<ThrottleEnvelope<T>>;
+    create(input: CreateSubscriptionInput): Promise<Subscription>;
+    list(params?: ListSubscriptionsParams): Promise<PaginatedSubscriptions>;
+    get(id: string): Promise<Subscription>;
+    update(id: string, input: UpdateSubscriptionInput): Promise<Subscription>;
+    changePlan(input: ChangePlanInput): Promise<Subscription>;
+    pause(id: string): Promise<Subscription>;
+    resume(id: string): Promise<Subscription>;
+    cancel(id: string, input?: {
+        atPeriodEnd?: boolean;
+    }): Promise<Subscription>;
+    createCheckoutSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession>;
+    checkTrialEligibility(input: TrialEligibilityInput): Promise<TrialEligibilityResult>;
+    getCustomerByExternalId(externalId: string): Promise<Customer | null>;
+}
+
+export type { CreateSubscriptionInput as C, DunningBannerProps as D, ListSubscriptionsParams as L, MutationState as M, PaginatedSubscriptions as P, QueryOptions as Q, RecurringIntent as R, SubscriptionsClientContract as S, ThrottleEnvelope as T, UpdateSubscriptionInput as U, SubscriptionsClientOptions as a, Subscription as b, ChangePlanInput as c, CreateCheckoutSessionInput as d, CheckoutSession as e, TrialEligibilityInput as f, TrialEligibilityResult as g, Customer as h, SubscriptionProviderProps as i, SubscriptionFetcher as j, CancelSubscriptionInput as k, QueryState as l, SubscriptionStatusBadgeProps as m, TrialCountdownProps as n, SubscriptionStatus as o, CheckoutCollectInput as p, CheckoutCustomerInput as q, Pagination as r, SubscriptionInterval as s, SubscriptionSort as t, TrialEligibilityReason as u };