@usethrottle/subscriptions 1.0.4 → 1.2.0

package/CLAUDE.md

@@ -38,6 +38,13 @@ Direct customer-scoped browser tokens are intentionally not in v1 because the AP
 - Mutations invalidate provider queries by bumping the provider cache version. Avoid adding a heavy query dependency unless product needs become more complex.
 - Components are primitive and minimally styled. They accept `className` and `style` so merchants can bring their own design system.
 
+## Errors
+
+`ThrottleSubscriptionsError` extends the shared `ThrottleError` from
+`@usethrottle/errors` (a `dependency`, `workspace:^`); the package re-exports
+`ThrottleError` + `isThrottleError`. Keep it a subclass so a single
+`instanceof ThrottleError` catches errors from every Throttle SDK.
+
 ## Validation
 
 - `pnpm --filter @usethrottle/subscriptions typecheck`

package/README.md

@@ -1,3 +1,8 @@
+<p align="left">
+  <img src="https://raw.githubusercontent.com/Epic-Design-Labs/app-throttle/main/packages/brand/assets/throttle-logo.png" alt="Throttle" height="56" />
+</p>
+
+
 # @usethrottle/subscriptions
 
 Production React hooks, server proxy helpers, and primitive components for Throttle subscriptions.

package/dist/{chunk-YNHK6SPQ.js → chunk-SVK2EVJ4.js}

@@ -1,14 +1,10 @@
 // src/errors.ts
-var ThrottleSubscriptionsError = class extends Error {
-  code;
-  statusCode;
-  details;
+import { ThrottleError } from "@usethrottle/errors";
+import { ThrottleError as ThrottleError2, isThrottleError } from "@usethrottle/errors";
+var ThrottleSubscriptionsError = class extends ThrottleError {
   constructor(args) {
-    super(args.message);
+    super(args);
     this.name = "ThrottleSubscriptionsError";
-    this.code = args.code;
-    this.statusCode = args.statusCode;
-    this.details = args.details;
   }
 };
 
@@ -16,72 +12,70 @@ var ThrottleSubscriptionsError = class extends Error {
 function normalizeSubscription(raw) {
   return {
     id: requiredString(raw?.id, "subscription.id"),
-    workspaceId: optionalString(raw?.workspaceId ?? raw?.merchant_id),
-    applicationId: optionalString(raw?.applicationId ?? raw?.store_id),
-    customerId: requiredString(raw?.customerId ?? raw?.customer_id, "subscription.customerId"),
+    workspaceId: optionalString(raw?.workspaceId),
+    applicationId: optionalString(raw?.applicationId),
+    customerId: requiredString(raw?.customerId, "subscription.customerId"),
     status: raw?.status ?? "active",
-    planReference: requiredString(
-      raw?.planReference ?? raw?.plan_reference,
-      "subscription.planReference"
-    ),
-    planName: optionalString(raw?.planName ?? raw?.plan_name),
+    planReference: requiredString(raw?.planReference, "subscription.planReference"),
+    planName: optionalString(raw?.planName),
     interval: raw?.interval ?? "monthly",
     amount: Number(raw?.amount ?? 0),
     currency: optionalString(raw?.currency) ?? "USD",
     currentPeriodStart: requiredDateString(
-      raw?.currentPeriodStart ?? raw?.current_period_start,
+      raw?.currentPeriodStart,
       "subscription.currentPeriodStart"
     ),
     currentPeriodEnd: requiredDateString(
-      raw?.currentPeriodEnd ?? raw?.current_period_end,
+      raw?.currentPeriodEnd,
       "subscription.currentPeriodEnd"
     ),
-    trialEnd: optionalDateString(raw?.trialEnd ?? raw?.trial_end),
-    cancelAtPeriodEnd: Boolean(raw?.cancelAtPeriodEnd ?? raw?.cancel_at_period_end ?? false),
-    failureCount: Number(raw?.failureCount ?? raw?.failure_count ?? 0),
-    lastPaymentAt: optionalDateString(raw?.lastPaymentAt ?? raw?.last_payment_at),
-    pausedAt: optionalDateString(raw?.pausedAt ?? raw?.paused_at),
-    cancelledAt: optionalDateString(raw?.cancelledAt ?? raw?.cancelled_at),
+    trialEnd: optionalDateString(raw?.trialEnd),
+    cancelAtPeriodEnd: Boolean(raw?.cancelAtPeriodEnd ?? false),
+    failureCount: Number(raw?.failureCount ?? 0),
+    lastPaymentAt: optionalDateString(raw?.lastPaymentAt),
+    pausedAt: optionalDateString(raw?.pausedAt),
+    cancelledAt: optionalDateString(raw?.cancelledAt),
     metadata: objectOrEmpty(raw?.metadata),
-    createdAt: optionalDateString(raw?.createdAt ?? raw?.created_at) ?? void 0,
-    updatedAt: optionalDateString(raw?.updatedAt ?? raw?.updated_at) ?? void 0
+    createdAt: optionalDateString(raw?.createdAt) ?? void 0,
+    updatedAt: optionalDateString(raw?.updatedAt) ?? void 0
   };
 }
 function normalizeCustomer(raw) {
   if (!raw) return null;
   return {
     id: requiredString(raw?.id, "customer.id"),
-    externalId: optionalString(raw?.externalId ?? raw?.external_id),
+    externalId: optionalString(raw?.externalId),
     email: optionalString(raw?.email),
-    firstName: optionalString(raw?.firstName ?? raw?.first_name),
-    lastName: optionalString(raw?.lastName ?? raw?.last_name),
+    firstName: optionalString(raw?.firstName),
+    lastName: optionalString(raw?.lastName),
     phone: optionalString(raw?.phone),
     metadata: objectOrEmpty(raw?.metadata),
-    createdAt: optionalDateString(raw?.createdAt ?? raw?.created_at) ?? void 0,
-    updatedAt: optionalDateString(raw?.updatedAt ?? raw?.updated_at) ?? void 0
+    createdAt: optionalDateString(raw?.createdAt) ?? void 0,
+    updatedAt: optionalDateString(raw?.updatedAt) ?? void 0
   };
 }
 function normalizeCustomerPaymentMethod(raw) {
   return {
     id: requiredString(raw?.id, "paymentMethod.id"),
     processor: optionalString(raw?.processor),
-    methodType: optionalString(raw?.methodType ?? raw?.method_type),
-    cardBrand: optionalString(raw?.cardBrand ?? raw?.card_brand),
-    cardLastFour: optionalString(raw?.cardLastFour ?? raw?.card_last_four),
-    isDefault: Boolean(raw?.isDefault ?? raw?.is_default ?? false),
-    createdAt: optionalDateString(raw?.createdAt ?? raw?.created_at) ?? void 0,
-    updatedAt: optionalDateString(raw?.updatedAt ?? raw?.updated_at) ?? void 0
+    methodType: optionalString(raw?.methodType),
+    cardBrand: optionalString(raw?.cardBrand),
+    cardLastFour: optionalString(raw?.cardLastFour),
+    isDefault: Boolean(raw?.isDefault ?? false),
+    isActive: Boolean(raw?.isActive ?? true),
+    createdAt: optionalDateString(raw?.createdAt) ?? void 0,
+    updatedAt: optionalDateString(raw?.updatedAt) ?? void 0
   };
 }
 function normalizeCheckoutSession(raw) {
-  const sessionId = raw?.sessionId ?? raw?.session_id ?? raw?.id;
+  const sessionId = raw?.sessionId ?? raw?.id;
   return {
-    ...raw,
-    id: optionalString(raw?.id),
+    ...withoutUnderscoreKeys(raw),
+    id: optionalString(raw?.id) ?? void 0,
     sessionId: requiredString(sessionId, "checkoutSession.sessionId"),
-    checkoutUrl: optionalString(raw?.checkoutUrl ?? raw?.checkout_url),
-    embedToken: optionalString(raw?.embedToken ?? raw?.embed_token),
-    expiresAt: optionalDateString(raw?.expiresAt ?? raw?.expires_at) ?? void 0
+    checkoutUrl: optionalString(raw?.checkoutUrl) ?? void 0,
+    embedToken: optionalString(raw?.embedToken) ?? void 0,
+    expiresAt: optionalDateString(raw?.expiresAt) ?? void 0
   };
 }
 function normalizeTrialEligibility(raw) {
@@ -94,7 +88,7 @@ function normalizePagination(raw) {
   if (!raw) return void 0;
   return {
     cursor: raw.cursor ?? null,
-    hasMore: Boolean(raw.hasMore ?? raw.has_more ?? false)
+    hasMore: Boolean(raw.hasMore ?? false)
   };
 }
 function toIso(value) {
@@ -121,6 +115,12 @@ function optionalDateString(value) {
 function objectOrEmpty(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
+function withoutUnderscoreKeys(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  return Object.fromEntries(
+    Object.entries(value).filter(([key]) => !key.includes("_"))
+  );
+}
 
 // src/client.ts
 var SubscriptionsClient = class {
@@ -260,7 +260,7 @@ var SubscriptionsClient = class {
   }
   async checkTrialEligibility(input) {
     const data = await this.request("POST", "/api/v1/subscriptions/eligibility-check", {
-      payment_method_id: input.paymentMethodId
+      paymentMethodId: input.paymentMethodId
     });
     return normalizeTrialEligibility(data);
   }
@@ -317,7 +317,9 @@ function setQuery(query, key, value) {
 
 export {
   ThrottleSubscriptionsError,
+  ThrottleError2 as ThrottleError,
+  isThrottleError,
   SubscriptionsClient,
   createSubscriptionsClient
 };
-//# sourceMappingURL=chunk-YNHK6SPQ.js.map
+//# sourceMappingURL=chunk-SVK2EVJ4.js.map

package/dist/chunk-SVK2EVJ4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/normalize.ts","../src/client.ts"],"sourcesContent":["import { ThrottleError } from '@usethrottle/errors';\n\n/**\n * Thrown on a non-2xx response from the Throttle Subscriptions API.\n *\n * Extends the shared {@link ThrottleError} so a single\n * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every\n * Throttle SDK. `instanceof ThrottleSubscriptionsError` keeps working.\n */\nexport class ThrottleSubscriptionsError extends ThrottleError {\n  constructor(args: { code: string; message: string; statusCode: number; details?: unknown }) {\n    super(args);\n    this.name = 'ThrottleSubscriptionsError';\n  }\n}\n\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\n","import type {\n  CheckoutSession,\n  Customer,\n  CustomerPaymentMethod,\n  Pagination,\n  Subscription,\n  SubscriptionInterval,\n  SubscriptionStatus,\n  TrialEligibilityResult,\n} from './types';\n\nexport function normalizeSubscription(raw: any): Subscription {\n  return {\n    id: requiredString(raw?.id, 'subscription.id'),\n    workspaceId: optionalString(raw?.workspaceId),\n    applicationId: optionalString(raw?.applicationId),\n    customerId: requiredString(raw?.customerId, 'subscription.customerId'),\n    status: (raw?.status ?? 'active') as SubscriptionStatus,\n    planReference: requiredString(raw?.planReference, 'subscription.planReference'),\n    planName: optionalString(raw?.planName),\n    interval: (raw?.interval ?? 'monthly') as SubscriptionInterval,\n    amount: Number(raw?.amount ?? 0),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    currentPeriodStart: requiredDateString(\n      raw?.currentPeriodStart,\n      'subscription.currentPeriodStart',\n    ),\n    currentPeriodEnd: requiredDateString(\n      raw?.currentPeriodEnd,\n      'subscription.currentPeriodEnd',\n    ),\n    trialEnd: optionalDateString(raw?.trialEnd),\n    cancelAtPeriodEnd: Boolean(raw?.cancelAtPeriodEnd ?? false),\n    failureCount: Number(raw?.failureCount ?? 0),\n    lastPaymentAt: optionalDateString(raw?.lastPaymentAt),\n    pausedAt: optionalDateString(raw?.pausedAt),\n    cancelledAt: optionalDateString(raw?.cancelledAt),\n    metadata: objectOrEmpty(raw?.metadata),\n    createdAt: optionalDateString(raw?.createdAt) ?? undefined,\n    updatedAt: optionalDateString(raw?.updatedAt) ?? undefined,\n  };\n}\n\nexport function normalizeCustomer(raw: any): Customer | null {\n  if (!raw) return null;\n  return {\n    id: requiredString(raw?.id, 'customer.id'),\n    externalId: optionalString(raw?.externalId),\n    email: optionalString(raw?.email),\n    firstName: optionalString(raw?.firstName),\n    lastName: optionalString(raw?.lastName),\n    phone: optionalString(raw?.phone),\n    metadata: objectOrEmpty(raw?.metadata),\n    createdAt: optionalDateString(raw?.createdAt) ?? undefined,\n    updatedAt: optionalDateString(raw?.updatedAt) ?? undefined,\n  };\n}\n\nexport function normalizeCustomerPaymentMethod(raw: any): CustomerPaymentMethod {\n  return {\n    id: requiredString(raw?.id, 'paymentMethod.id'),\n    processor: optionalString(raw?.processor),\n    methodType: optionalString(raw?.methodType),\n    cardBrand: optionalString(raw?.cardBrand),\n    cardLastFour: optionalString(raw?.cardLastFour),\n    isDefault: Boolean(raw?.isDefault ?? false),\n    isActive: Boolean(raw?.isActive ?? true),\n    createdAt: optionalDateString(raw?.createdAt) ?? undefined,\n    updatedAt: optionalDateString(raw?.updatedAt) ?? undefined,\n  };\n}\n\nexport function normalizeCheckoutSession(raw: any): CheckoutSession {\n  const sessionId = raw?.sessionId ?? raw?.id;\n  return {\n    ...withoutUnderscoreKeys(raw),\n    id: optionalString(raw?.id) ?? undefined,\n    sessionId: requiredString(sessionId, 'checkoutSession.sessionId'),\n    checkoutUrl: optionalString(raw?.checkoutUrl) ?? undefined,\n    embedToken: optionalString(raw?.embedToken) ?? undefined,\n    expiresAt: optionalDateString(raw?.expiresAt) ?? undefined,\n  };\n}\n\nexport function normalizeTrialEligibility(raw: any): TrialEligibilityResult {\n  return {\n    eligible: Boolean(raw?.eligible),\n    reason: raw?.reason,\n  };\n}\n\nexport function normalizePagination(raw: any): Pagination | undefined {\n  if (!raw) return undefined;\n  return {\n    cursor: raw.cursor ?? null,\n    hasMore: Boolean(raw.hasMore ?? false),\n  };\n}\n\nexport function toIso(value: string | Date | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value instanceof Date ? value.toISOString() : value;\n}\n\nfunction requiredString(value: unknown, label: string): string {\n  if (typeof value === 'string' && value.length > 0) return value;\n  throw new Error(`Invalid Throttle response: missing ${label}`);\n}\n\nfunction optionalString(value: unknown): string | null {\n  return typeof value === 'string' ? value : null;\n}\n\nfunction requiredDateString(value: unknown, label: string): string {\n  if (value instanceof Date) return value.toISOString();\n  if (typeof value === 'string' && value.length > 0) return value;\n  throw new Error(`Invalid Throttle response: missing ${label}`);\n}\n\nfunction optionalDateString(value: unknown): string | null {\n  if (value instanceof Date) return value.toISOString();\n  if (typeof value === 'string' && value.length > 0) return value;\n  return null;\n}\n\nfunction objectOrEmpty(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction withoutUnderscoreKeys(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return Object.fromEntries(\n    Object.entries(value as Record<string, unknown>).filter(([key]) => !key.includes('_')),\n  );\n}\n","import { ThrottleSubscriptionsError } from './errors';\nimport {\n  normalizeCheckoutSession,\n  normalizeCustomer,\n  normalizeCustomerPaymentMethod,\n  normalizePagination,\n  normalizeSubscription,\n  normalizeTrialEligibility,\n  toIso,\n} from './normalize';\nimport type {\n  ChangePlanInput,\n  CheckoutSession,\n  CreateCheckoutSessionInput,\n  CreateSubscriptionInput,\n  Customer,\n  CustomerPaymentMethod,\n  ListSubscriptionsParams,\n  PaginatedSubscriptions,\n  Subscription,\n  SubscriptionsClientContract,\n  SubscriptionsClientOptions,\n  ThrottleEnvelope,\n  TrialEligibilityInput,\n  TrialEligibilityResult,\n  UpdateSubscriptionInput,\n} from './types';\n\nexport class SubscriptionsClient implements SubscriptionsClientContract {\n  private readonly apiKey?: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof globalThis.fetch;\n  private readonly fetcher?: SubscriptionsClientOptions['fetcher'];\n  private readonly timeoutMs: number;\n\n  constructor(opts: SubscriptionsClientOptions = {}) {\n    const fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (!fetchImpl) throw new Error('SubscriptionsClient: fetch is required');\n    if (!opts.apiKey && !opts.fetcher) {\n      throw new Error('SubscriptionsClient: apiKey or fetcher is required');\n    }\n\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? 'https://api.usethrottle.dev').replace(/\\/+$/, '');\n    this.fetchImpl = fetchImpl;\n    this.fetcher = opts.fetcher;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n  }\n\n  async request<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const envelope = await this.requestEnvelope<T>(method, path, body);\n    if (Object.prototype.hasOwnProperty.call(envelope, 'data')) {\n      return envelope.data as T;\n    }\n    return envelope as T;\n  }\n\n  async requestEnvelope<T = unknown>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<ThrottleEnvelope<T>> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n\n    try {\n      const init: RequestInit = {\n        method,\n        headers: {\n          'content-type': 'application/json',\n          ...(this.apiKey ? { 'x-api-key': this.apiKey } : {}),\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: ctrl.signal,\n      };\n\n      const res = this.fetcher\n        ? await this.fetcher(path, init)\n        : await this.fetchImpl(toAbsoluteUrl(this.baseUrl, path), init);\n\n      if (res.status === 204) return { data: undefined as T };\n\n      const json = (await res.json().catch(() => ({}))) as ThrottleEnvelope<T>;\n      if (!res.ok) {\n        throw new ThrottleSubscriptionsError({\n          code: json.error?.code ?? 'unknown_error',\n          message: json.error?.message ?? `HTTP ${res.status}`,\n          statusCode: res.status,\n          details: json.error?.details,\n        });\n      }\n      return json;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async create(input: CreateSubscriptionInput): Promise<Subscription> {\n    const customerId = await this.resolveCustomerId(input.customerId, input.externalCustomerId);\n    const data = await this.request<unknown>('POST', '/api/v1/subscriptions', {\n      applicationId: input.applicationId,\n      customerId,\n      planReference: input.planReference,\n      planName: input.planName,\n      interval: input.interval,\n      amount: input.amount,\n      currency: input.currency,\n      currentPeriodStart: toIso(input.currentPeriodStart),\n      currentPeriodEnd: toIso(input.currentPeriodEnd),\n      trialEnd: toIso(input.trialEnd),\n      metadata: input.metadata ?? {},\n    });\n    return normalizeSubscription(data);\n  }\n\n  async list(params: ListSubscriptionsParams = {}): Promise<PaginatedSubscriptions> {\n    const query = new URLSearchParams();\n    setQuery(query, 'customerId', params.customerId);\n    setQuery(query, 'externalCustomerId', params.externalCustomerId);\n    setQuery(query, 'status', params.status);\n    setQuery(query, 'interval', params.interval);\n    setQuery(query, 'q', params.q);\n    setQuery(query, 'cursor', params.cursor);\n    setQuery(query, 'limit', params.limit);\n    setQuery(query, 'sort', params.sort);\n    setQuery(query, 'createdAfter', toIso(params.createdAfter));\n    setQuery(query, 'createdBefore', toIso(params.createdBefore));\n\n    const suffix = query.toString() ? `?${query}` : '';\n    const envelope = await this.requestEnvelope<unknown[]>('GET', `/api/v1/subscriptions${suffix}`);\n    return {\n      data: (envelope.data ?? []).map(normalizeSubscription),\n      pagination: normalizePagination(envelope.meta?.pagination),\n    };\n  }\n\n  async get(id: string): Promise<Subscription> {\n    const data = await this.request<unknown>(\n      'GET',\n      `/api/v1/subscriptions/${encodeURIComponent(id)}`,\n    );\n    return normalizeSubscription(data);\n  }\n\n  async update(id: string, input: UpdateSubscriptionInput): Promise<Subscription> {\n    const data = await this.request<unknown>(\n      'PATCH',\n      `/api/v1/subscriptions/${encodeURIComponent(id)}`,\n      input,\n    );\n    return normalizeSubscription(data);\n  }\n\n  changePlan(input: ChangePlanInput): Promise<Subscription> {\n    const { id, ...body } = input;\n    return this.update(id, body);\n  }\n\n  async pause(id: string): Promise<Subscription> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/subscriptions/${encodeURIComponent(id)}/pause`,\n    );\n    return normalizeSubscription(data);\n  }\n\n  async resume(id: string): Promise<Subscription> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/subscriptions/${encodeURIComponent(id)}/resume`,\n    );\n    return normalizeSubscription(data);\n  }\n\n  async cancel(id: string, input: { atPeriodEnd?: boolean } = {}): Promise<Subscription> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/subscriptions/${encodeURIComponent(id)}/cancel`,\n      { atPeriodEnd: input.atPeriodEnd ?? false },\n    );\n    return normalizeSubscription(data);\n  }\n\n  async createCheckoutSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout/sessions', input);\n    return normalizeCheckoutSession(data);\n  }\n\n  async checkTrialEligibility(input: TrialEligibilityInput): Promise<TrialEligibilityResult> {\n    const data = await this.request<unknown>('POST', '/api/v1/subscriptions/eligibility-check', {\n      paymentMethodId: input.paymentMethodId,\n    });\n    return normalizeTrialEligibility(data);\n  }\n\n  async getCustomerByExternalId(externalId: string): Promise<Customer | null> {\n    try {\n      const data = await this.request<unknown>(\n        'GET',\n        `/api/v1/customers/by-external/${encodeURIComponent(externalId)}`,\n      );\n      return normalizeCustomer(data);\n    } catch (err) {\n      if (err instanceof ThrottleSubscriptionsError && err.statusCode === 404) return null;\n      throw err;\n    }\n  }\n\n  async listCustomerPaymentMethods(customerId: string): Promise<CustomerPaymentMethod[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/customers/${encodeURIComponent(customerId)}/payment-methods`,\n    );\n    return (data ?? []).map(normalizeCustomerPaymentMethod);\n  }\n\n  private async resolveCustomerId(\n    customerId?: string,\n    externalCustomerId?: string,\n  ): Promise<string> {\n    if (customerId) return customerId;\n    if (!externalCustomerId) {\n      throw new ThrottleSubscriptionsError({\n        code: 'invalid_request',\n        message: 'customerId or externalCustomerId is required',\n        statusCode: 400,\n      });\n    }\n\n    const customer = await this.getCustomerByExternalId(externalCustomerId);\n    if (!customer) {\n      throw new ThrottleSubscriptionsError({\n        code: 'customer_not_found',\n        message: 'Customer not found',\n        statusCode: 404,\n      });\n    }\n    return customer.id;\n  }\n}\n\nexport function createSubscriptionsClient(opts: SubscriptionsClientOptions): SubscriptionsClient {\n  return new SubscriptionsClient(opts);\n}\n\nfunction toAbsoluteUrl(baseUrl: string, path: string): string {\n  if (/^https?:\\/\\//i.test(path)) return path;\n  return `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n}\n\nfunction setQuery(query: URLSearchParams, key: string, value: unknown): void {\n  if (value === undefined || value === null || value === '') return;\n  query.set(key, String(value));\n}\n"],"mappings":"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","names":["ThrottleError"]}

package/dist/{errors-DPfsiLtM.d.cts → errors-BR8lr8_6.d.cts}

@@ -1,4 +1,5 @@
 import { CSSProperties, ReactNode } from 'react';
+import { ThrottleError } from '@usethrottle/errors';
 
 type SubscriptionStatus = 'active' | 'paused' | 'cancelled' | 'past_due' | 'trialing';
 type SubscriptionInterval = 'weekly' | 'monthly' | 'quarterly' | 'yearly';
@@ -44,6 +45,7 @@ interface CustomerPaymentMethod {
     cardBrand?: string | null;
     cardLastFour?: string | null;
     isDefault?: boolean;
+    isActive?: boolean;
     createdAt?: string;
     updatedAt?: string;
 }
@@ -151,10 +153,9 @@ interface TrialEligibilityResult {
 interface ThrottleEnvelope<T> {
     data?: T;
     meta?: {
-        request_id?: string;
+        requestId?: string;
         pagination?: {
             cursor?: string | null;
-            has_more?: boolean;
             hasMore?: boolean;
         };
         [key: string]: unknown;
@@ -268,10 +269,14 @@ declare class SubscriptionsClient implements SubscriptionsClientContract {
 }
 declare function createSubscriptionsClient(opts: SubscriptionsClientOptions): SubscriptionsClient;
 
-declare class ThrottleSubscriptionsError extends Error {
-    readonly code: string;
-    readonly statusCode: number;
-    readonly details?: unknown;
+/**
+ * Thrown on a non-2xx response from the Throttle Subscriptions API.
+ *
+ * Extends the shared {@link ThrottleError} so a single
+ * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every
+ * Throttle SDK. `instanceof ThrottleSubscriptionsError` keeps working.
+ */
+declare class ThrottleSubscriptionsError extends ThrottleError {
     constructor(args: {
         code: string;
         message: string;

package/dist/{errors-DPfsiLtM.d.ts → errors-BR8lr8_6.d.ts}

@@ -1,4 +1,5 @@
 import { CSSProperties, ReactNode } from 'react';
+import { ThrottleError } from '@usethrottle/errors';
 
 type SubscriptionStatus = 'active' | 'paused' | 'cancelled' | 'past_due' | 'trialing';
 type SubscriptionInterval = 'weekly' | 'monthly' | 'quarterly' | 'yearly';
@@ -44,6 +45,7 @@ interface CustomerPaymentMethod {
     cardBrand?: string | null;
     cardLastFour?: string | null;
     isDefault?: boolean;
+    isActive?: boolean;
     createdAt?: string;
     updatedAt?: string;
 }
@@ -151,10 +153,9 @@ interface TrialEligibilityResult {
 interface ThrottleEnvelope<T> {
     data?: T;
     meta?: {
-        request_id?: string;
+        requestId?: string;
         pagination?: {
             cursor?: string | null;
-            has_more?: boolean;
             hasMore?: boolean;
         };
         [key: string]: unknown;
@@ -268,10 +269,14 @@ declare class SubscriptionsClient implements SubscriptionsClientContract {
 }
 declare function createSubscriptionsClient(opts: SubscriptionsClientOptions): SubscriptionsClient;
 
-declare class ThrottleSubscriptionsError extends Error {
-    readonly code: string;
-    readonly statusCode: number;
-    readonly details?: unknown;
+/**
+ * Thrown on a non-2xx response from the Throttle Subscriptions API.
+ *
+ * Extends the shared {@link ThrottleError} so a single
+ * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every
+ * Throttle SDK. `instanceof ThrottleSubscriptionsError` keeps working.
+ */
+declare class ThrottleSubscriptionsError extends ThrottleError {
     constructor(args: {
         code: string;
         message: string;

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   SubscriptionProviderWithClient: () => SubscriptionProviderWithClient,
   SubscriptionStatusBadge: () => SubscriptionStatusBadge,
   SubscriptionsClient: () => SubscriptionsClient,
+  ThrottleError: () => import_errors2.ThrottleError,
   ThrottleSubscriptionsError: () => ThrottleSubscriptionsError,
   TrialCountdown: () => TrialCountdown,
   canCancelSubscription: () => canCancelSubscription,
@@ -36,6 +37,7 @@ __export(index_exports, {
   isSubscriptionPastDue: () => isSubscriptionPastDue,
   isSubscriptionTrialing: () => isSubscriptionTrialing,
   isTerminalSubscription: () => isTerminalSubscription,
+  isThrottleError: () => import_errors2.isThrottleError,
   useCancelSubscription: () => useCancelSubscription,
   useChangePlan: () => useChangePlan,
   useCreateCheckoutSession: () => useCreateCheckoutSession,
@@ -54,16 +56,12 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/errors.ts
-var ThrottleSubscriptionsError = class extends Error {
-  code;
-  statusCode;
-  details;
+var import_errors = require("@usethrottle/errors");
+var import_errors2 = require("@usethrottle/errors");
+var ThrottleSubscriptionsError = class extends import_errors.ThrottleError {
   constructor(args) {
-    super(args.message);
+    super(args);
     this.name = "ThrottleSubscriptionsError";
-    this.code = args.code;
-    this.statusCode = args.statusCode;
-    this.details = args.details;
   }
 };
 
@@ -71,72 +69,70 @@ var ThrottleSubscriptionsError = class extends Error {
 function normalizeSubscription(raw) {
   return {
     id: requiredString(raw?.id, "subscription.id"),
-    workspaceId: optionalString(raw?.workspaceId ?? raw?.merchant_id),
-    applicationId: optionalString(raw?.applicationId ?? raw?.store_id),
-    customerId: requiredString(raw?.customerId ?? raw?.customer_id, "subscription.customerId"),
+    workspaceId: optionalString(raw?.workspaceId),
+    applicationId: optionalString(raw?.applicationId),
+    customerId: requiredString(raw?.customerId, "subscription.customerId"),
     status: raw?.status ?? "active",
-    planReference: requiredString(
-      raw?.planReference ?? raw?.plan_reference,
-      "subscription.planReference"
-    ),
-    planName: optionalString(raw?.planName ?? raw?.plan_name),
+    planReference: requiredString(raw?.planReference, "subscription.planReference"),
+    planName: optionalString(raw?.planName),
     interval: raw?.interval ?? "monthly",
     amount: Number(raw?.amount ?? 0),
     currency: optionalString(raw?.currency) ?? "USD",
     currentPeriodStart: requiredDateString(
-      raw?.currentPeriodStart ?? raw?.current_period_start,
+      raw?.currentPeriodStart,
       "subscription.currentPeriodStart"
     ),
     currentPeriodEnd: requiredDateString(
-      raw?.currentPeriodEnd ?? raw?.current_period_end,
+      raw?.currentPeriodEnd,
       "subscription.currentPeriodEnd"
     ),
-    trialEnd: optionalDateString(raw?.trialEnd ?? raw?.trial_end),
-    cancelAtPeriodEnd: Boolean(raw?.cancelAtPeriodEnd ?? raw?.cancel_at_period_end ?? false),
-    failureCount: Number(raw?.failureCount ?? raw?.failure_count ?? 0),
-    lastPaymentAt: optionalDateString(raw?.lastPaymentAt ?? raw?.last_payment_at),
-    pausedAt: optionalDateString(raw?.pausedAt ?? raw?.paused_at),
-    cancelledAt: optionalDateString(raw?.cancelledAt ?? raw?.cancelled_at),
+    trialEnd: optionalDateString(raw?.trialEnd),
+    cancelAtPeriodEnd: Boolean(raw?.cancelAtPeriodEnd ?? false),
+    failureCount: Number(raw?.failureCount ?? 0),
+    lastPaymentAt: optionalDateString(raw?.lastPaymentAt),
+    pausedAt: optionalDateString(raw?.pausedAt),
+    cancelledAt: optionalDateString(raw?.cancelledAt),
     metadata: objectOrEmpty(raw?.metadata),
-    createdAt: optionalDateString(raw?.createdAt ?? raw?.created_at) ?? void 0,
-    updatedAt: optionalDateString(raw?.updatedAt ?? raw?.updated_at) ?? void 0
+    createdAt: optionalDateString(raw?.createdAt) ?? void 0,
+    updatedAt: optionalDateString(raw?.updatedAt) ?? void 0
   };
 }
 function normalizeCustomer(raw) {
   if (!raw) return null;
   return {
     id: requiredString(raw?.id, "customer.id"),
-    externalId: optionalString(raw?.externalId ?? raw?.external_id),
+    externalId: optionalString(raw?.externalId),
     email: optionalString(raw?.email),
-    firstName: optionalString(raw?.firstName ?? raw?.first_name),
-    lastName: optionalString(raw?.lastName ?? raw?.last_name),
+    firstName: optionalString(raw?.firstName),
+    lastName: optionalString(raw?.lastName),
     phone: optionalString(raw?.phone),
     metadata: objectOrEmpty(raw?.metadata),
-    createdAt: optionalDateString(raw?.createdAt ?? raw?.created_at) ?? void 0,
-    updatedAt: optionalDateString(raw?.updatedAt ?? raw?.updated_at) ?? void 0
+    createdAt: optionalDateString(raw?.createdAt) ?? void 0,
+    updatedAt: optionalDateString(raw?.updatedAt) ?? void 0
   };
 }
 function normalizeCustomerPaymentMethod(raw) {
   return {
     id: requiredString(raw?.id, "paymentMethod.id"),
     processor: optionalString(raw?.processor),
-    methodType: optionalString(raw?.methodType ?? raw?.method_type),
-    cardBrand: optionalString(raw?.cardBrand ?? raw?.card_brand),
-    cardLastFour: optionalString(raw?.cardLastFour ?? raw?.card_last_four),
-    isDefault: Boolean(raw?.isDefault ?? raw?.is_default ?? false),
-    createdAt: optionalDateString(raw?.createdAt ?? raw?.created_at) ?? void 0,
-    updatedAt: optionalDateString(raw?.updatedAt ?? raw?.updated_at) ?? void 0
+    methodType: optionalString(raw?.methodType),
+    cardBrand: optionalString(raw?.cardBrand),
+    cardLastFour: optionalString(raw?.cardLastFour),
+    isDefault: Boolean(raw?.isDefault ?? false),
+    isActive: Boolean(raw?.isActive ?? true),
+    createdAt: optionalDateString(raw?.createdAt) ?? void 0,
+    updatedAt: optionalDateString(raw?.updatedAt) ?? void 0
   };
 }
 function normalizeCheckoutSession(raw) {
-  const sessionId = raw?.sessionId ?? raw?.session_id ?? raw?.id;
+  const sessionId = raw?.sessionId ?? raw?.id;
   return {
-    ...raw,
-    id: optionalString(raw?.id),
+    ...withoutUnderscoreKeys(raw),
+    id: optionalString(raw?.id) ?? void 0,
     sessionId: requiredString(sessionId, "checkoutSession.sessionId"),
-    checkoutUrl: optionalString(raw?.checkoutUrl ?? raw?.checkout_url),
-    embedToken: optionalString(raw?.embedToken ?? raw?.embed_token),
-    expiresAt: optionalDateString(raw?.expiresAt ?? raw?.expires_at) ?? void 0
+    checkoutUrl: optionalString(raw?.checkoutUrl) ?? void 0,
+    embedToken: optionalString(raw?.embedToken) ?? void 0,
+    expiresAt: optionalDateString(raw?.expiresAt) ?? void 0
   };
 }
 function normalizeTrialEligibility(raw) {
@@ -149,7 +145,7 @@ function normalizePagination(raw) {
   if (!raw) return void 0;
   return {
     cursor: raw.cursor ?? null,
-    hasMore: Boolean(raw.hasMore ?? raw.has_more ?? false)
+    hasMore: Boolean(raw.hasMore ?? false)
   };
 }
 function toIso(value) {
@@ -176,6 +172,12 @@ function optionalDateString(value) {
 function objectOrEmpty(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
+function withoutUnderscoreKeys(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  return Object.fromEntries(
+    Object.entries(value).filter(([key]) => !key.includes("_"))
+  );
+}
 
 // src/client.ts
 var SubscriptionsClient = class {
@@ -315,7 +317,7 @@ var SubscriptionsClient = class {
   }
   async checkTrialEligibility(input) {
     const data = await this.request("POST", "/api/v1/subscriptions/eligibility-check", {
-      payment_method_id: input.paymentMethodId
+      paymentMethodId: input.paymentMethodId
     });
     return normalizeTrialEligibility(data);
   }
@@ -740,6 +742,7 @@ function DunningBanner({
   SubscriptionProviderWithClient,
   SubscriptionStatusBadge,
   SubscriptionsClient,
+  ThrottleError,
   ThrottleSubscriptionsError,
   TrialCountdown,
   canCancelSubscription,
@@ -751,6 +754,7 @@ function DunningBanner({
   isSubscriptionPastDue,
   isSubscriptionTrialing,
   isTerminalSubscription,
+  isThrottleError,
   useCancelSubscription,
   useChangePlan,
   useCreateCheckoutSession,