@movmo_app/payments 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -73,41 +73,6 @@ export declare interface CardValidationState {
  */
 export declare const createMovmoAuthFetch: (options: CreateMovmoAuthFetchOptions) => typeof fetch;
 
-/**
- * Auth-aware `fetch` wrapper for `@movmo_app/payments`. The package's API
- * helpers call through `getPaymentsConfig().fetch`, bypassing whatever axios
- * interceptor stack the consumer wires up. Without this wrapper:
- *
- *   - Session cookie expiry → silent 401/403 (no refresh, no logout).
- *   - State-mutating endpoints → 403 because the CSRF cookie isn't echoed.
- *   - Local-dev / multi-tenant flows → missing per-request headers like
- *     `X-Movmo-Proxy-Auth` or `movmo-customer-id`.
- *
- * This factory replaces a ~95-line `paymentsFetch.ts` copy that was
- * duplicated across consumer apps. The contract:
- *
- *   1. CSRF token from `csrfCookieName` is set on every request as
- *      `X-CSRF-Token` (matching the axios interceptor's unconditional set).
- *   2. `extraHeaders(input, init)` is invoked per-request to allow dynamic
- *      headers (proxy-auth, customer id, etc.). Headers the caller already
- *      set on `init.headers` win — `extraHeaders` only fills gaps.
- *   3. `credentials: 'include'` is forced so the session cookie travels.
- *   4. On a 401/403 from a non-auth endpoint, the wrapper calls
- *      `refreshSession()` once (concurrent failures share one in-flight
- *      promise) and retries the original request. If refresh ITSELF fails,
- *      `onRefreshFailed(err)` fires so the consumer can drive a sign-out —
- *      silently swallowing here would strand the user on a broken page.
- *      Failures on the *retry* fetch are logged and the original response is
- *      returned so the SDK still sees a Response to render an error from.
- *   5. The original fetch's network errors (offline, CORS, DNS) propagate.
- *      Only retry-path failures are caught; pre-refresh errors are left for
- *      the consumer to surface.
- *
- * The duplicated copies that this replaces both silently swallowed refresh
- * failure (see review issue #1 on both PR #47 + PR #180). Making
- * `onRefreshFailed` *required* enforces at the type level that consumers
- * wire up a logout path.
- */
 export declare interface CreateMovmoAuthFetchOptions {
     /**
      * Refreshes the session cookie. Called once on the first 401/403; concurrent
@@ -143,6 +108,11 @@ export declare interface CreateMovmoAuthFetchOptions {
      * infinite recursion when refresh returns 401. Defaults to `/v1/auth/`.
      */
     authPathFragment?: string;
+    /**
+     * 403 response `code`s that skip refresh + retry (the response is returned
+     * as-is). Defaults to {@link DEFAULT_NO_REFRESH_CODES}.
+     */
+    noRefreshCodes?: ReadonlySet<string>;
     /**
      * Underlying fetch impl. Defaults to `globalThis.fetch.bind(globalThis)`.
      * Override only for tests or non-browser environments.
@@ -155,6 +125,9 @@ export declare interface CreateMovmoAuthFetchOptions {
     readCookie?: (name: string) => string | null;
 }
 
+/** 403 error codes that mean "refreshing will not help"; the wrapper returns them untouched. */
+export declare const DEFAULT_NO_REFRESH_CODES: ReadonlySet<string>;
+
 /**
  * The cardholder/zip subset of {@link UpdatePaymentMethodPatch} that the Edit
  * flow (MOVMO-381) can mutate. Derived via `Pick` so it stays in sync if the
@@ -276,6 +249,12 @@ export declare interface PaymentManagerError {
     source: PaymentErrorSource;
     message: string;
     cause?: unknown;
+    /** HTTP status when the failure was an API response. */
+    status?: number;
+    /** Server error code (e.g. `recovery_cooldown`) when present. */
+    code?: string;
+    /** RFC3339 UTC end of a `recovery_cooldown`, when the server sent it. */
+    until?: string;
 }
 
 /**
@@ -448,6 +427,22 @@ export declare interface PaymentMethodSummary {
     zip?: string;
 }
 
+/**
+ * Error thrown by every API helper on a non-2xx response. `code`/`until` come
+ * from the server's JSON error body (e.g. `recovery_cooldown`); `message` is
+ * user-facing (cool-down copy, the server `message`, or the helper's fallback).
+ */
+export declare class PaymentsApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly until?: string;
+    constructor(message: string, opts: {
+        status: number;
+        code?: string;
+        until?: string;
+    });
+}
+
 export declare interface PaymentsConfig {
     baseUrl: string;
     /**