@base44-preview/sdk 0.8.57-pr.356.0052aed → 0.8.57-pr.357.4227057

package/dist/modules/payments-checkout.d.ts

@@ -24,6 +24,11 @@ export interface MountCheckoutDeps {
  * @internal
  */
 export declare const loadScript: LoadScript;
+/**
+ * Fetches the payments config and loads the provider's script ahead of mountCheckout().
+ * @internal
+ */
+export declare function preloadCheckout(provider: "paypal" | "stripe", deps: Pick<MountCheckoutDeps, "getConfig" | "loadScript">): Promise<void>;
 /**
  * Mounts the embedded checkout that createCheckout() returned.
  * @internal

package/dist/modules/payments-checkout.js

@@ -209,6 +209,23 @@ async function mountPayPal(element, scriptUrl, checkoutId, currency, embedded, o
         },
     };
 }
+/**
+ * Fetches the payments config and loads the provider's script ahead of mountCheckout().
+ * @internal
+ */
+export async function preloadCheckout(provider, deps) {
+    if (typeof window === "undefined" || typeof document === "undefined")
+        return;
+    const read = () => (provider === "paypal" ? browserGlobals().paypal : browserGlobals().Stripe);
+    try {
+        if (!read()) {
+            await deps.loadScript(await scriptUrlFor(provider, deps));
+        }
+    }
+    catch (_a) {
+        // A hint only: mountCheckout() fetches and loads again and reports the failure.
+    }
+}
 /**
  * Mounts the embedded checkout that createCheckout() returned.
  * @internal

package/dist/modules/payments.js

@@ -1,4 +1,4 @@
-import { loadScript, mountCheckout, } from "./payments-checkout.js";
+import { loadScript, mountCheckout, preloadCheckout, } from "./payments-checkout.js";
 function requireId(value, name) {
     if (!value || typeof value !== "string") {
         throw new Error(`${name} is required and must be a string`);
@@ -64,6 +64,9 @@ export function createPaymentsModule(axios, appId) {
                 loadScript,
             });
         },
+        preloadCheckout(provider) {
+            return preloadCheckout(provider, { getConfig, loadScript });
+        },
     };
 }
 /**

package/dist/modules/payments.types.d.ts

@@ -492,6 +492,25 @@ export interface PaymentsModule {
      * ```
      */
     mountCheckout(element: CheckoutElement, checkout: MountableCheckout, options?: MountCheckoutOptions): Promise<CheckoutMount>;
+    /**
+     * Loads the provider's checkout script before you mount a checkout.
+     *
+     * Call it when the checkout page or form opens, while the buyer is still filling it in. A later {@linkcode mountCheckout | mountCheckout()} then skips loading the script and renders sooner.
+     *
+     * It never rejects, so you don't need to await it or catch errors. If the script can't load, `mountCheckout()` tries again and rejects with the error. In the backend it does nothing.
+     *
+     * @param provider - The provider the app is connected to.
+     * @returns Promise resolving once the script has loaded or failed to load.
+     *
+     * @example
+     * ```tsx
+     * // Start loading PayPal when the checkout form opens
+     * useEffect(() => {
+     *   base44.payments.preloadCheckout('paypal');
+     * }, []);
+     * ```
+     */
+    preloadCheckout(provider: "paypal" | "stripe"): Promise<void>;
 }
 /**
  * Payments module with service role authentication, for backend functions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.57-pr.356.0052aed",
+  "version": "0.8.57-pr.357.4227057",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",