@whop/elements 1.0.0-beta.5 → 1.0.0-beta.6

package/dashboard.d.cts

@@ -11,11 +11,11 @@
  */
 export interface DashboardOptions {
 	/**
-	 * A scoped token every surface under this handle reads with. Mint one token for the whole handle on your server with `POST /api/v1/access_tokens`, and set a fresh one with `update({ accessToken })` before it expires. Reading payments needs `payment:basic:read`; buyer emails additionally need `member:email:read`, the customer journey `member:basic:read`, the tracking column `shipment:basic:read`, and the product and plan names on a payment `access_pass:basic:read` and `plan:basic:read`. Omitted, the reads carry the viewer's own session, which only answers same-origin.
+	 * A scoped token every surface under this handle reads with. Mint one token for the whole handle on your server with `POST /api/v1/access_tokens`, and set a fresh one with `update({ accessToken })` before it expires. Reading payments needs `payment:basic:read`; buyer emails additionally need `member:email:read`, the customer journey `member:basic:read`, the tracking column `shipment:basic:read`, and the product and plan names on a payment `access_pass:basic:read` and `plan:basic:read`. The banners need `payout:account:read`, and starting verification from the action bar `identity:write`. Omitted, the reads carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * Account ID, prefixed `biz_`, whose payments these surfaces read.
+	 * Account or user ID whose records these surfaces read. Account IDs are prefixed `biz_`; user IDs are prefixed `user_`, can read only the viewer's own outstanding actions, and have no payments.
 	 */
 	accountId: string;
 	/**
@@ -36,6 +36,160 @@ export interface DashboardOptions {
 	locale?: import("./_framework.js").WhopElementsLocale;
 }
 
+/**
+ * Consumer props for the "required-actions" element. Set at create (or as `<RequiredActionsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/dashboard/required-actions
+ */
+export interface RequiredActionsElementProps {
+	/**
+	 * Which verification the Verify button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+}
+
+/**
+ * The live handle for a mounted "required-actions" element. Returned by `create("required-actions")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/dashboard/required-actions
+ */
+export interface RequiredActionsElementHandle {
+	/**
+	 * Re-read the account. Call it when the viewer returns from verifying or depositing so the banners reflect the new state without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<RequiredActionsElementProps>) => void;
+}
+
+/**
+ * Options for `create("required-actions")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const required_actions = dashboard.create("required-actions", {}); // this interface: props + on<Event> callbacks
+ * required_actions.mount("#dashboard-required-actions");
+ * ```
+ * @see https://docs.whop.com/elements/latest/dashboard/required-actions
+ */
+export interface RequiredActionsElementCreateOptions {
+	/**
+	 * Which verification the Verify button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * The viewer pressed a banner button. Fires for every action, including ones the element also handles itself.
+	 */
+	onActionRequested?: ((payload: { action: "deposit_funds" | "review_held_payments" | "accept_airwallex_terms" | "submit_information_request" | "update_automatic_withdrawal_method" | "reauthorize_payout_methods" | "update_payout_profile" | "card_usage_review" | "verify_identity" | "verify_airwallex_account" | "sign_formation_documents" | "connect_fulfillment_tracker" | "setup_apple_pay_domains" | "configure_tax_remitter" | "add_vat_registration" | "enable_two_factor_authentication"; accountId: string; }) => void);
+	/**
+	 * The viewer pressed Verify on a `verify_identity` action the element can start. The element opens identity verification itself — this fires alongside, so a host can record the trip.
+	 */
+	onIdentityVerificationRequested?: ((payload: { accountId: string; }) => void);
+	/**
+	 * The viewer pressed Add money. The element never opens a deposit flow itself — mount your own, such as the `wallet` controller’s `deposit` element, in answer to this.
+	 */
+	onDepositRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * Consumer props for the "verification" element. Set at create (or as `<VerificationElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/dashboard/verification
+ */
+export interface VerificationElementProps {
+	/**
+	 * Which verification the button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * Show a compact inline prompt without the supporting description.
+	 * @default false
+	 */
+	compact?: boolean;
+}
+
+/**
+ * The live handle for a mounted "verification" element. Returned by `create("verification")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/dashboard/verification
+ */
+export interface VerificationElementHandle {
+	/**
+	 * Re-read the account. Call it when the viewer returns from verifying so the banner reflects the new state without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<VerificationElementProps>) => void;
+}
+
+/**
+ * Options for `create("verification")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const verification = dashboard.create("verification", {}); // this interface: props + on<Event> callbacks
+ * verification.mount("#dashboard-verification");
+ * ```
+ * @see https://docs.whop.com/elements/latest/dashboard/verification
+ */
+export interface VerificationElementCreateOptions {
+	/**
+	 * Which verification the button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * Show a compact inline prompt without the supporting description.
+	 * @default false
+	 */
+	compact?: boolean;
+	/**
+	 * The viewer pressed the verify button. The element never navigates — mount your own verification, such as the `verifications` controller, in answer to this.
+	 */
+	onVerificationRequested?: ((payload: { accountId: string; }) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
 /**
  * Consumer props for the "paymentsTable" element. Set at create (or as `<PaymentsTableElement />` JSX props), and updatable live via `update()`.
  * @see https://docs.whop.com/elements/latest/dashboard/paymentsTable
@@ -303,6 +457,14 @@ export interface PaymentDetailElementCreateOptions {
  * @see https://docs.whop.com/elements/latest/dashboard/overview
  */
 export interface DashboardHandle {
+	/**
+	 * The outstanding-action banners from Whop's balance dashboard — identity verification, deposits, tax, and the rest — in the same order the API returns them. An account with nothing outstanding renders nothing at all, so the element can sit permanently in a layout. Copy comes from the API. Pressing Verify starts a hosted identity session and leaves for it; Add money reports `depositRequested` and stays put, so the host mounts its own deposit flow — the `wallet` controller's `deposit` element, say; every other button follows the action's own link. Reads with the Dashboard handle's `accessToken`, which needs `payout:account:read`, plus `identity:write` to start verification. A failed read renders nothing rather than an error — a banner should never become the loudest thing on someone else's page.
+	 */
+	create(name: "required-actions", options?: RequiredActionsElementCreateOptions): RequiredActionsElementHandle;
+	/**
+	 * A banner asking the account holder to verify their identity, shown only while verification is outstanding — an account that has already verified renders nothing at all, so the element can sit permanently in a layout. The headline and status messages come from the API, with a shorter description when inviting the account holder to start verification, so they track the account's actual state: an unstarted account is invited to unlock cards and payouts, one under review reads as pending, and a failed or flagged one says so. Pressing the button reports `verificationRequested` and stays put, so the host mounts its own verification — the `verifications` controller's `kyc` element, say. Reads with the Dashboard handle's `accessToken`, which needs `payout:account:read`. A failed read renders nothing rather than an error — a nudge should never become the loudest thing on the page.
+	 */
+	create(name: "verification", options?: VerificationElementCreateOptions): VerificationElementHandle;
 	/**
 	 * The dashboard payments table with status cards, search, filters, sorting, row selection, CSV export, column settings, and pagination. Reads all payment pages to compute complete counts and filter locally; intended for accounts with modest payment histories. Customer details and refunds are handed to your application through events.
 	 */

package/dashboard.d.ts

@@ -11,11 +11,11 @@
  */
 export interface DashboardOptions {
 	/**
-	 * A scoped token every surface under this handle reads with. Mint one token for the whole handle on your server with `POST /api/v1/access_tokens`, and set a fresh one with `update({ accessToken })` before it expires. Reading payments needs `payment:basic:read`; buyer emails additionally need `member:email:read`, the customer journey `member:basic:read`, the tracking column `shipment:basic:read`, and the product and plan names on a payment `access_pass:basic:read` and `plan:basic:read`. Omitted, the reads carry the viewer's own session, which only answers same-origin.
+	 * A scoped token every surface under this handle reads with. Mint one token for the whole handle on your server with `POST /api/v1/access_tokens`, and set a fresh one with `update({ accessToken })` before it expires. Reading payments needs `payment:basic:read`; buyer emails additionally need `member:email:read`, the customer journey `member:basic:read`, the tracking column `shipment:basic:read`, and the product and plan names on a payment `access_pass:basic:read` and `plan:basic:read`. The banners need `payout:account:read`, and starting verification from the action bar `identity:write`. Omitted, the reads carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
-	 * Account ID, prefixed `biz_`, whose payments these surfaces read.
+	 * Account or user ID whose records these surfaces read. Account IDs are prefixed `biz_`; user IDs are prefixed `user_`, can read only the viewer's own outstanding actions, and have no payments.
 	 */
 	accountId: string;
 	/**
@@ -36,6 +36,160 @@ export interface DashboardOptions {
 	locale?: import("./_framework.js").WhopElementsLocale;
 }
 
+/**
+ * Consumer props for the "required-actions" element. Set at create (or as `<RequiredActionsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/dashboard/required-actions
+ */
+export interface RequiredActionsElementProps {
+	/**
+	 * Which verification the Verify button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+}
+
+/**
+ * The live handle for a mounted "required-actions" element. Returned by `create("required-actions")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/dashboard/required-actions
+ */
+export interface RequiredActionsElementHandle {
+	/**
+	 * Re-read the account. Call it when the viewer returns from verifying or depositing so the banners reflect the new state without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<RequiredActionsElementProps>) => void;
+}
+
+/**
+ * Options for `create("required-actions")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const required_actions = dashboard.create("required-actions", {}); // this interface: props + on<Event> callbacks
+ * required_actions.mount("#dashboard-required-actions");
+ * ```
+ * @see https://docs.whop.com/elements/latest/dashboard/required-actions
+ */
+export interface RequiredActionsElementCreateOptions {
+	/**
+	 * Which verification the Verify button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * The viewer pressed a banner button. Fires for every action, including ones the element also handles itself.
+	 */
+	onActionRequested?: ((payload: { action: "deposit_funds" | "review_held_payments" | "accept_airwallex_terms" | "submit_information_request" | "update_automatic_withdrawal_method" | "reauthorize_payout_methods" | "update_payout_profile" | "card_usage_review" | "verify_identity" | "verify_airwallex_account" | "sign_formation_documents" | "connect_fulfillment_tracker" | "setup_apple_pay_domains" | "configure_tax_remitter" | "add_vat_registration" | "enable_two_factor_authentication"; accountId: string; }) => void);
+	/**
+	 * The viewer pressed Verify on a `verify_identity` action the element can start. The element opens identity verification itself — this fires alongside, so a host can record the trip.
+	 */
+	onIdentityVerificationRequested?: ((payload: { accountId: string; }) => void);
+	/**
+	 * The viewer pressed Add money. The element never opens a deposit flow itself — mount your own, such as the `wallet` controller’s `deposit` element, in answer to this.
+	 */
+	onDepositRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
+/**
+ * Consumer props for the "verification" element. Set at create (or as `<VerificationElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/dashboard/verification
+ */
+export interface VerificationElementProps {
+	/**
+	 * Which verification the button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * Show a compact inline prompt without the supporting description.
+	 * @default false
+	 */
+	compact?: boolean;
+}
+
+/**
+ * The live handle for a mounted "verification" element. Returned by `create("verification")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/dashboard/verification
+ */
+export interface VerificationElementHandle {
+	/**
+	 * Re-read the account. Call it when the viewer returns from verifying so the banner reflects the new state without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<VerificationElementProps>) => void;
+}
+
+/**
+ * Options for `create("verification")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const verification = dashboard.create("verification", {}); // this interface: props + on<Event> callbacks
+ * verification.mount("#dashboard-verification");
+ * ```
+ * @see https://docs.whop.com/elements/latest/dashboard/verification
+ */
+export interface VerificationElementCreateOptions {
+	/**
+	 * Which verification the button starts. `individual` (KYC) is what unlocks payouts and a Whop card. `business` (KYB) covers that and additionally unlocks financing and business cards — use it for a company that will need those.
+	 * @default "individual"
+	 */
+	kind?: "individual" | "business";
+	/**
+	 * Show a compact inline prompt without the supporting description.
+	 * @default false
+	 */
+	compact?: boolean;
+	/**
+	 * The viewer pressed the verify button. The element never navigates — mount your own verification, such as the `verifications` controller, in answer to this.
+	 */
+	onVerificationRequested?: ((payload: { accountId: string; }) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
 /**
  * Consumer props for the "paymentsTable" element. Set at create (or as `<PaymentsTableElement />` JSX props), and updatable live via `update()`.
  * @see https://docs.whop.com/elements/latest/dashboard/paymentsTable
@@ -303,6 +457,14 @@ export interface PaymentDetailElementCreateOptions {
  * @see https://docs.whop.com/elements/latest/dashboard/overview
  */
 export interface DashboardHandle {
+	/**
+	 * The outstanding-action banners from Whop's balance dashboard — identity verification, deposits, tax, and the rest — in the same order the API returns them. An account with nothing outstanding renders nothing at all, so the element can sit permanently in a layout. Copy comes from the API. Pressing Verify starts a hosted identity session and leaves for it; Add money reports `depositRequested` and stays put, so the host mounts its own deposit flow — the `wallet` controller's `deposit` element, say; every other button follows the action's own link. Reads with the Dashboard handle's `accessToken`, which needs `payout:account:read`, plus `identity:write` to start verification. A failed read renders nothing rather than an error — a banner should never become the loudest thing on someone else's page.
+	 */
+	create(name: "required-actions", options?: RequiredActionsElementCreateOptions): RequiredActionsElementHandle;
+	/**
+	 * A banner asking the account holder to verify their identity, shown only while verification is outstanding — an account that has already verified renders nothing at all, so the element can sit permanently in a layout. The headline and status messages come from the API, with a shorter description when inviting the account holder to start verification, so they track the account's actual state: an unstarted account is invited to unlock cards and payouts, one under review reads as pending, and a failed or flagged one says so. Pressing the button reports `verificationRequested` and stays put, so the host mounts its own verification — the `verifications` controller's `kyc` element, say. Reads with the Dashboard handle's `accessToken`, which needs `payout:account:read`. A failed read renders nothing rather than an error — a nudge should never become the loudest thing on the page.
+	 */
+	create(name: "verification", options?: VerificationElementCreateOptions): VerificationElementHandle;
 	/**
 	 * The dashboard payments table with status cards, search, filters, sorting, row selection, CSV export, column settings, and pagination. Reads all payment pages to compute complete counts and filter locally; intended for accounts with modest payment histories. Customer details and refunds are handed to your application through events.
 	 */

package/index.cjs

@@ -31,50 +31,103 @@ module.exports = __toCommonJS(npm_loader_exports);
 var define_WHOP_ELEMENTS_LOCALES_default = ["en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl", "tr"];
 
 // ../../packages/elements-codegen/src/cli/build/npm-loader.ts
-var ORIGIN = "https://js.whop.cloud";
-var SDK_URL = "https://js.whop.cloud/elements/amber/elements.js";
+var ORIGIN = "https://cdn.whop.com";
+var SDK_URL = "https://cdn.whop.com/elements/amber/elements.js";
 var WHOP_ELEMENTS_LOCALES = define_WHOP_ELEMENTS_LOCALES_default;
+var TAG = "script[data-whop-elements]";
+var resolved = null;
+function withRetry(promise) {
+  return Object.assign(promise, { retry: retryWhop });
+}
 function loadWhop() {
-  if (typeof window === "undefined") return Promise.reject(new Error("WhopElements requires a browser environment"));
+  if (typeof window === "undefined") return withRetry(Promise.reject(new Error("WhopElements requires a browser environment")));
   const w = window;
-  if (w.WhopElements) return Promise.resolve(w.WhopElements);
-  let s = document.querySelector("script[data-whop-elements]");
-  const created = !s;
-  if (!s) {
-    s = document.createElement("script");
-    s.src = SDK_URL;
-    s.async = true;
-    s.setAttribute("data-whop-elements", "");
+  const existing = document.querySelector(TAG);
+  if (existing?.__whopReady) return cached(existing);
+  if (w.WhopElements) return resolved ??= withRetry(Promise.resolve(w.WhopElements));
+  return watch(w, existing ?? inject(), !existing);
+}
+function cached(script) {
+  const ready = script.__whopReady;
+  if (typeof ready.retry !== "function") {
+    let settled = false;
+    ready.then(
+      () => {
+        settled = true;
+      },
+      () => {
+        settled = true;
+        script.__whopFailed = true;
+      }
+    );
+    Object.assign(ready, {
+      retry: () => settled ? retryWhop() : withRetry(ready.then((value) => value, () => retryWhop()))
+    });
+  }
+  return ready;
+}
+function retryWhop() {
+  if (typeof window === "undefined") return loadWhop();
+  const dead = document.querySelector(TAG);
+  if (!dead?.__whopFailed) return loadWhop();
+  return watch(window, inject(dead), true);
+}
+function inject(replacing) {
+  const s = document.createElement("script");
+  s.src = replacing?.src || SDK_URL;
+  s.async = true;
+  s.setAttribute("data-whop-elements", "");
+  if (replacing) {
+    if (replacing.nonce) s.nonce = replacing.nonce;
+    if (replacing.crossOrigin) s.crossOrigin = replacing.crossOrigin;
+    if (replacing.integrity) s.integrity = replacing.integrity;
+    if (replacing.referrerPolicy) s.referrerPolicy = replacing.referrerPolicy;
+    replacing.replaceWith(s);
+  } else {
     document.head.appendChild(s);
   }
-  const script = s;
+  return s;
+}
+function measured(src) {
+  const entry = performance.getEntriesByName(src).pop();
+  if (!entry) return "";
+  const after = `after ${Math.round(entry.duration)}ms`;
+  return entry.responseStatus ? ` (HTTP ${entry.responseStatus} ${after})` : ` (${after}, no status visible)`;
+}
+function watch(w, script, created) {
   if (!script.__whopReady) {
-    script.__whopReady = new Promise((resolve, reject) => {
-      let timer = null;
-      function settle(fn, v) {
-        if (timer !== null) {
-          clearInterval(timer);
-          timer = null;
-        }
-        fn(v);
-      }
-      script.addEventListener("load", () => {
-        if (w.WhopElements) settle(resolve, w.WhopElements);
-        else settle(reject, new Error("WhopElements loaded but did not initialize"));
-      });
-      script.addEventListener("error", () => settle(reject, new Error("Failed to load " + SDK_URL)));
-      if (!created) {
-        let waited = 0;
-        timer = setInterval(() => {
-          if (w.WhopElements) {
-            settle(resolve, w.WhopElements);
-            return;
+    script.__whopReady = withRetry(
+      new Promise((resolve, reject) => {
+        let timer = null;
+        function settle(fn, v) {
+          if (timer !== null) {
+            clearInterval(timer);
+            timer = null;
           }
-          waited += 200;
-          if (waited >= 1e4) settle(reject, new Error("existing data-whop-elements script did not initialize within 10s \u2014 if its network load already failed before loadWhop() ran (check the console/CSP), no load/error event will ever fire on it"));
-        }, 200);
-      }
-    });
+          fn(v);
+        }
+        function fail(message) {
+          script.__whopFailed = true;
+          settle(reject, new Error(message));
+        }
+        script.addEventListener("load", () => {
+          if (w.WhopElements) settle(resolve, w.WhopElements);
+          else fail("WhopElements loaded but did not initialize");
+        });
+        script.addEventListener("error", () => fail("Failed to load " + script.src + measured(script.src)));
+        if (!created) {
+          let waited = 0;
+          timer = setInterval(() => {
+            if (w.WhopElements) {
+              settle(resolve, w.WhopElements);
+              return;
+            }
+            waited += 200;
+            if (waited >= 1e4) fail("existing data-whop-elements script did not initialize within 10s \u2014 if its network load already failed before loadWhop() ran (check the console/CSP), no load/error event will ever fire on it");
+          }, 200);
+        }
+      })
+    );
   }
   return script.__whopReady;
 }

package/index.d.cts

@@ -34,7 +34,7 @@ export interface Whop {
 	 */
 	tracking: { create(options: TrackingOptions): TrackingHandle } & TrackingStatics;
 	/**
-	 * Drives an account's money surfaces. `required-actions` is the outstanding-action bar from Whop's balance dashboard. `actions` renders the Deposit, Accept, Send, and Convert controls: Deposit, Send, and Convert open their Wallet overlays, while Accept opens Whop's checkout-link creator for a business account or company creation for a personal account. `deposit` returns live funding rails; `convert` swaps USD with Gold or Bitcoin and exposes FX currencies when the host enables `fxEnabled`; `send` moves money to a recipient or creates a public claim link; `withdraw` lists payout methods and creates the payout when the host does not already drive that API; `balances` holds two faces — the holdings list, and the balance block drawing value over a window; `cards` is the compact issued-card list; `cardsTable` renders the full sortable card roster; `cardsChart` plots card spend; `whopCard` renders one revealable card; `activity` lists ledger movements; `activityDetail` renders a prefetched movement, or retrieves one by activity ID or card transaction ID, in a standalone drawer; and `verification` is the identity-only nudge. Every data-backed surface can use the viewer's session when no token is provided.
+	 * Drives an account's money surfaces. `actions` renders the Deposit, Accept, Send, and Convert controls: Deposit, Send, and Convert open their Wallet overlays, while Accept opens Whop's checkout-link creator for a business account or company creation for a personal account. `deposit` returns live funding rails; `convert` swaps USD with Gold or Bitcoin and exposes FX currencies when the host enables `fxEnabled`; `send` moves money to a recipient or creates a public claim link; `withdraw` lists payout methods and creates the payout when the host does not already drive that API; `balances` holds two faces — the holdings list, and the balance block drawing value over a window; `cards` is the compact issued-card list; `cardsTable` renders the full sortable card roster; `cardsChart` plots card spend; `whopCard` renders one revealable card; `activity` lists ledger movements; `activityDetail` renders a prefetched movement, or retrieves one by activity ID or card transaction ID, in a standalone drawer. The outstanding-action bar and the identity nudge live on the `dashboard` controller. Every data-backed surface can use the viewer's session when no token is provided.
 	 */
 	wallet: { create(options: WalletOptions): WalletHandle } & WalletStatics;
 	/**
@@ -42,7 +42,7 @@ export interface Whop {
 	 */
 	websites: { create(options: WebsitesOptions): WebsitesHandle } & WebsitesStatics;
 	/**
-	 * An account's own payment records, embedded on your site. Scope it to an account with `accountId`, then mount `paymentsTable` for the account's payments and `paymentDetail` for one payment. Both read with the same credential, so two surfaces side by side always show the same account.
+	 * An account's own dashboard surfaces, embedded on your site. Scope it to an account with `accountId`, then mount `paymentsTable` for the account's payments, `paymentDetail` for one payment, `required-actions` for the outstanding-action banners Whop's own dashboard shows above the balance — identity verification, deposits, tax, and the rest — and `verification` for the identity-only nudge. Every surface reads with the same credential, so two side by side always show the same account. The banners render nothing once the account has nothing outstanding, so they can sit permanently in a layout, and they report the presses they cannot answer themselves — Add money and Verify — so the host mounts its own deposit or verification flow, such as the `wallet` controller's `deposit` element or the `verifications` controller's `kyc` element.
 	 */
 	dashboard: { create(options: DashboardOptions): DashboardHandle } & DashboardStatics;
 }
@@ -55,8 +55,11 @@ export interface WhopConstructor {
 /** The hosted SDK bundle `loadWhop()` loads. The URL carries the release train, so it follows this package's major. */
 export declare const SDK_URL: string;
 
-/** Load the hosted SDK: injects the `<script data-whop-elements>` tag once and resolves the global constructor. Safe to call any number of times: one script, one shared promise. */
-export declare function loadWhop(): Promise<WhopConstructor>;
+/** The promise `loadWhop()` returns: the load itself, plus `retry()`, which starts a fresh load after a failure. While a load is in flight or has succeeded, `retry()` is that same load. */
+export type WhopLoad = Promise<WhopConstructor> & { retry(): WhopLoad };
+
+/** Load the hosted SDK: injects the `<script data-whop-elements>` tag once and resolves the global constructor. Safe to call any number of times: one script, one shared promise. A failed load is held, so every later call returns the same rejected promise and nothing retries on its own; call `retry()` on it to load again. */
+export declare function loadWhop(): WhopLoad;
 
 /** Resource hints (preconnect/preload) for the hosted SDK. Render them into `<head>` to start the fetch before `loadWhop()` runs. */
 export declare function preloadHints(): { rel: string; href: string; as?: string }[];

package/index.d.ts

@@ -34,7 +34,7 @@ export interface Whop {
 	 */
 	tracking: { create(options: TrackingOptions): TrackingHandle } & TrackingStatics;
 	/**
-	 * Drives an account's money surfaces. `required-actions` is the outstanding-action bar from Whop's balance dashboard. `actions` renders the Deposit, Accept, Send, and Convert controls: Deposit, Send, and Convert open their Wallet overlays, while Accept opens Whop's checkout-link creator for a business account or company creation for a personal account. `deposit` returns live funding rails; `convert` swaps USD with Gold or Bitcoin and exposes FX currencies when the host enables `fxEnabled`; `send` moves money to a recipient or creates a public claim link; `withdraw` lists payout methods and creates the payout when the host does not already drive that API; `balances` holds two faces — the holdings list, and the balance block drawing value over a window; `cards` is the compact issued-card list; `cardsTable` renders the full sortable card roster; `cardsChart` plots card spend; `whopCard` renders one revealable card; `activity` lists ledger movements; `activityDetail` renders a prefetched movement, or retrieves one by activity ID or card transaction ID, in a standalone drawer; and `verification` is the identity-only nudge. Every data-backed surface can use the viewer's session when no token is provided.
+	 * Drives an account's money surfaces. `actions` renders the Deposit, Accept, Send, and Convert controls: Deposit, Send, and Convert open their Wallet overlays, while Accept opens Whop's checkout-link creator for a business account or company creation for a personal account. `deposit` returns live funding rails; `convert` swaps USD with Gold or Bitcoin and exposes FX currencies when the host enables `fxEnabled`; `send` moves money to a recipient or creates a public claim link; `withdraw` lists payout methods and creates the payout when the host does not already drive that API; `balances` holds two faces — the holdings list, and the balance block drawing value over a window; `cards` is the compact issued-card list; `cardsTable` renders the full sortable card roster; `cardsChart` plots card spend; `whopCard` renders one revealable card; `activity` lists ledger movements; `activityDetail` renders a prefetched movement, or retrieves one by activity ID or card transaction ID, in a standalone drawer. The outstanding-action bar and the identity nudge live on the `dashboard` controller. Every data-backed surface can use the viewer's session when no token is provided.
 	 */
 	wallet: { create(options: WalletOptions): WalletHandle } & WalletStatics;
 	/**
@@ -42,7 +42,7 @@ export interface Whop {
 	 */
 	websites: { create(options: WebsitesOptions): WebsitesHandle } & WebsitesStatics;
 	/**
-	 * An account's own payment records, embedded on your site. Scope it to an account with `accountId`, then mount `paymentsTable` for the account's payments and `paymentDetail` for one payment. Both read with the same credential, so two surfaces side by side always show the same account.
+	 * An account's own dashboard surfaces, embedded on your site. Scope it to an account with `accountId`, then mount `paymentsTable` for the account's payments, `paymentDetail` for one payment, `required-actions` for the outstanding-action banners Whop's own dashboard shows above the balance — identity verification, deposits, tax, and the rest — and `verification` for the identity-only nudge. Every surface reads with the same credential, so two side by side always show the same account. The banners render nothing once the account has nothing outstanding, so they can sit permanently in a layout, and they report the presses they cannot answer themselves — Add money and Verify — so the host mounts its own deposit or verification flow, such as the `wallet` controller's `deposit` element or the `verifications` controller's `kyc` element.
 	 */
 	dashboard: { create(options: DashboardOptions): DashboardHandle } & DashboardStatics;
 }
@@ -55,8 +55,11 @@ export interface WhopConstructor {
 /** The hosted SDK bundle `loadWhop()` loads. The URL carries the release train, so it follows this package's major. */
 export declare const SDK_URL: string;
 
-/** Load the hosted SDK: injects the `<script data-whop-elements>` tag once and resolves the global constructor. Safe to call any number of times: one script, one shared promise. */
-export declare function loadWhop(): Promise<WhopConstructor>;
+/** The promise `loadWhop()` returns: the load itself, plus `retry()`, which starts a fresh load after a failure. While a load is in flight or has succeeded, `retry()` is that same load. */
+export type WhopLoad = Promise<WhopConstructor> & { retry(): WhopLoad };
+
+/** Load the hosted SDK: injects the `<script data-whop-elements>` tag once and resolves the global constructor. Safe to call any number of times: one script, one shared promise. A failed load is held, so every later call returns the same rejected promise and nothing retries on its own; call `retry()` on it to load again. */
+export declare function loadWhop(): WhopLoad;
 
 /** Resource hints (preconnect/preload) for the hosted SDK. Render them into `<head>` to start the fetch before `loadWhop()` runs. */
 export declare function preloadHints(): { rel: string; href: string; as?: string }[];