@flopay/js 1.4.0 → 1.4.1

package/README.md

@@ -24,7 +24,13 @@ const flopay = await loadFloPay('pk_test_...', {
 });
 ```
 
-`loadFloPay` caches the instance -- calling it again with the same key returns the cached `FloPay` instance. The optional second argument accepts a `FloPayConfig` with `billingApiUrl`, `locale`, `appearance`, and `telemetry`; set `telemetry: false` to opt out of privacy-safe operational telemetry.
+`loadFloPay` caches by publishable key and behavior-affecting options. Concurrent
+calls with the same key and options share one in-flight provider initialization
+and resolve to the same `FloPay` instance. A failed initialization is evicted so
+a later call can retry. The optional second argument accepts
+`Omit<FloPayConfig, 'publishableKey'>`, including `billingApiUrl`, `locale`,
+`appearance`, and `telemetry`; set `telemetry: false` to opt out of privacy-safe
+operational telemetry.
 
 ### Create and Mount Elements
 
@@ -267,7 +273,7 @@ The same default-on behavior and boolean opt-out apply to direct `FloPay`,
 
 | Export | Description |
 |--------|-------------|
-| `loadFloPay(publishableKey, options?)` | Initializes the SDK. Returns a `Promise<FloPay>`. Caches by key. |
+| `loadFloPay(publishableKey, options?)` | Initializes the SDK. Returns a `Promise<FloPay>`. Shares successful and in-flight work by key; failed work remains retryable. |
 | `FloPay` | Main SDK class. Methods: `elements()`, `submitElements()`, `createPaymentMethod()`, `confirmCardPayment()`, `cardCapture()`, `confirmPayment()`, `confirmPayPalPayment()`, `resumePayPalPayment()`, `retrieveSession()`, `retrieveUnifiedSession()`, `getRawProvider()`, `destroy()` |
 | `FloPayElements` | Element group manager. Methods: `create(type, options?)`, `getElement(type)`, `submit()`, `destroy()` |
 | `StripeAdapter` | `PaymentProviderAdapter` implementation for Stripe |

package/dist/index.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -48,7 +38,14 @@ module.exports = __toCommonJS(index_exports);
 var import_shared7 = require("@flopay/shared");
 
 // src/stripe-adapter.ts
+var import_stripe_js = require("@stripe/stripe-js");
 var import_shared = require("@flopay/shared");
+
+// src/card-three-ds.ts
+var CARD_THREE_DS_ATTEMPT_TTL_MS = 15 * 6e4;
+var MAX_CARD_THREE_DS_ATTEMPTS = 32;
+
+// src/stripe-adapter.ts
 function toStripeElementType(type) {
   const map = {
     payment: "payment",
@@ -71,8 +68,6 @@ function toStripeAppearanceTheme(theme) {
       return "stripe";
   }
 }
-var CARD_THREE_DS_ATTEMPT_TTL_MS = 15 * 6e4;
-var MAX_CARD_THREE_DS_ATTEMPTS = 32;
 function cardThreeDsNow() {
   return globalThis.performance?.now() ?? Date.now();
 }
@@ -99,6 +94,24 @@ function wrapStripeElement(stripeElement) {
     }
   };
 }
+function toStripeBillingDetails(billing) {
+  return {
+    billing_details: {
+      ...billing.email ? { email: billing.email } : {},
+      ...billing.name ? { name: billing.name } : {},
+      ...billing.address ? {
+        address: {
+          ...billing.address.country ? { country: billing.address.country } : {},
+          ...billing.address.postal_code ? { postal_code: billing.address.postal_code } : {},
+          ...billing.address.city ? { city: billing.address.city } : {},
+          ...billing.address.line1 ? { line1: billing.address.line1 } : {},
+          ...billing.address.line2 ? { line2: billing.address.line2 } : {},
+          ...billing.address.state ? { state: billing.address.state } : {}
+        }
+      } : {}
+    }
+  };
+}
 var StripeAdapter = class {
   constructor() {
     this.name = "stripe";
@@ -116,17 +129,7 @@ var StripeAdapter = class {
     if (typeof window === "undefined") {
       return;
     }
-    let loadStripe;
-    try {
-      ({ loadStripe } = await import("@stripe/stripe-js"));
-    } catch {
-      throw new import_shared.FloPayError(
-        "Failed to load @stripe/stripe-js. Reinstall @flopay/js.",
-        "api_error",
-        { code: "StripeJsLoadFailed" }
-      );
-    }
-    const stripe = await loadStripe(config.publishableKey, {
+    const stripe = await (0, import_stripe_js.loadStripe)(config.publishableKey, {
       locale: config.locale ?? "auto"
     });
     if (!stripe) {
@@ -237,22 +240,7 @@ var StripeAdapter = class {
       };
     }
     const cardNumberEl = this.elements.getElement("cardNumber");
-    const stripeBilling = billingDetails ? {
-      billing_details: {
-        ...billingDetails.email ? { email: billingDetails.email } : {},
-        ...billingDetails.name ? { name: billingDetails.name } : {},
-        ...billingDetails.address ? {
-          address: {
-            ...billingDetails.address.country ? { country: billingDetails.address.country } : {},
-            ...billingDetails.address.postal_code ? { postal_code: billingDetails.address.postal_code } : {},
-            ...billingDetails.address.city ? { city: billingDetails.address.city } : {},
-            ...billingDetails.address.line1 ? { line1: billingDetails.address.line1 } : {},
-            ...billingDetails.address.line2 ? { line2: billingDetails.address.line2 } : {},
-            ...billingDetails.address.state ? { state: billingDetails.address.state } : {}
-          }
-        } : {}
-      }
-    } : {};
+    const stripeBilling = billingDetails ? toStripeBillingDetails(billingDetails) : {};
     const { error, paymentMethod } = cardNumberEl ? await this.stripe.createPaymentMethod({
       type: "card",
       card: cardNumberEl,
@@ -372,22 +360,7 @@ var StripeAdapter = class {
       );
     }
     const billing = params.billingDetails;
-    const paymentMethodData = billing ? {
-      billing_details: {
-        ...billing.email ? { email: billing.email } : {},
-        ...billing.name ? { name: billing.name } : {},
-        ...billing.address ? {
-          address: {
-            ...billing.address.country ? { country: billing.address.country } : {},
-            ...billing.address.postal_code ? { postal_code: billing.address.postal_code } : {},
-            ...billing.address.city ? { city: billing.address.city } : {},
-            ...billing.address.line1 ? { line1: billing.address.line1 } : {},
-            ...billing.address.line2 ? { line2: billing.address.line2 } : {},
-            ...billing.address.state ? { state: billing.address.state } : {}
-          }
-        } : {}
-      }
-    } : void 0;
+    const paymentMethodData = billing ? toStripeBillingDetails(billing) : void 0;
     const { error, paymentIntent } = await this.stripe.confirmPayment({
       elements: this.elements,
       clientSecret: params.clientSecret,
@@ -612,6 +585,19 @@ var FloPayElements = class {
 // src/payment-api.ts
 var import_shared4 = require("@flopay/shared");
 
+// src/api-error.ts
+function readErrorString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function readErrorMessage(value) {
+  if (typeof value === "string") return value.trim() ? value : void 0;
+  if (Array.isArray(value)) {
+    const joined = value.filter((entry) => typeof entry === "string" && entry.trim().length > 0).join("; ");
+    return joined || void 0;
+  }
+  return void 0;
+}
+
 // src/session-display-cache.ts
 var STORAGE_KEY_PREFIX = "flopay_session_display:";
 var DEFAULT_TTL_MS = 60 * 60 * 1e3;
@@ -1035,17 +1021,10 @@ function telemetryFailure(error, fallbackCode) {
   };
 }
 function readString(payload, key) {
-  const value = payload?.[key];
-  return typeof value === "string" && value.trim() ? value : void 0;
+  return readErrorString(payload?.[key]);
 }
 function readMessage(payload, key) {
-  const value = payload?.[key];
-  if (typeof value === "string") return value.trim() ? value : void 0;
-  if (Array.isArray(value)) {
-    const joined = value.filter((entry) => typeof entry === "string" && entry.trim().length > 0).join("; ");
-    return joined || void 0;
-  }
-  return void 0;
+  return readErrorMessage(payload?.[key]);
 }
 function readNumber(payload, key) {
   const value = payload?.[key];
@@ -2877,8 +2856,6 @@ function telemetryProvider(name) {
   if (name === "stripe" || name === "paypal" || name === "pcivault") return name;
   return "other";
 }
-var CARD_THREE_DS_ATTEMPT_TTL_MS2 = 15 * 6e4;
-var MAX_CARD_THREE_DS_ATTEMPTS2 = 32;
 var FloPay = class {
   constructor(provider, config, telemetryReporter) {
     this.currentElements = null;
@@ -3060,7 +3037,7 @@ var FloPay = class {
   trackCardThreeDsAttempt(attemptId, startedAt) {
     this.pruneExpiredCardThreeDsAttempts(startedAt);
     if (this.cardThreeDsStartedAt.has(attemptId)) return false;
-    while (this.cardThreeDsStartedAt.size >= MAX_CARD_THREE_DS_ATTEMPTS2) {
+    while (this.cardThreeDsStartedAt.size >= MAX_CARD_THREE_DS_ATTEMPTS) {
       const oldestAttemptId = this.cardThreeDsStartedAt.keys().next().value;
       if (oldestAttemptId === void 0) break;
       this.cardThreeDsStartedAt.delete(oldestAttemptId);
@@ -3076,7 +3053,7 @@ var FloPay = class {
   }
   pruneExpiredCardThreeDsAttempts(now) {
     for (const [attemptId, startedAt] of this.cardThreeDsStartedAt) {
-      if (now - startedAt >= CARD_THREE_DS_ATTEMPT_TTL_MS2) {
+      if (now - startedAt >= CARD_THREE_DS_ATTEMPT_TTL_MS) {
         this.cardThreeDsStartedAt.delete(attemptId);
       }
     }
@@ -3516,20 +3493,21 @@ function instanceCacheKey(publishableKey, options) {
     stableCacheValue(options?.appearance ?? null)
   ]);
 }
+var initializationCache = /* @__PURE__ */ new Map();
 async function loadFloPay(publishableKey, options) {
   if (!publishableKey) {
-    const reporter2 = new TelemetryReporter({
+    const reporter = new TelemetryReporter({
       billingApiUrl: (0, import_shared7.resolveBillingApiUrl)(options?.billingApiUrl),
       sdkVersion: import_shared7.SDK_VERSION,
       enabled: options?.telemetry !== false
     });
-    reporter2.error({
+    reporter.error({
       errorCode: "CONFIGURATION_INVALID",
       stage: "sdk_initialize",
       paymentMethodCategory: "unknown"
     });
-    void reporter2.flush().catch(() => {
-    }).finally(() => reporter2.destroy());
+    void reporter.flush().catch(() => {
+    }).finally(() => reporter.destroy());
     throw new import_shared7.FloPayError(
       "A publishable key is required to initialize FloPay.",
       "validation_error",
@@ -3547,71 +3525,80 @@ async function loadFloPay(publishableKey, options) {
     }
     return cached;
   }
+  const initializing = initializationCache.get(cacheKey);
+  if (initializing) return initializing;
   const config = {
-    publishableKey,
-    ...options
+    ...options,
+    publishableKey
   };
-  const reporter = new TelemetryReporter({
-    billingApiUrl: (0, import_shared7.resolveBillingApiUrl)(config.billingApiUrl),
-    sdkVersion: import_shared7.SDK_VERSION,
-    enabled: config.telemetry !== false
-  });
-  const initializationStarted = reporter.now();
-  reporter.log({ name: "sdk.initialize.started", stage: "sdk_initialize" });
-  reporter.log({ name: "sdk.cache.miss", stage: "sdk_initialize" });
-  reporter.log({
-    name: "provider.load.started",
-    stage: "provider_load",
-    provider: "stripe"
-  });
-  const adapter = new StripeAdapter();
-  try {
-    await adapter.initialize(config);
-  } catch (error) {
-    reporter.error({
-      errorCode: "SDK_INITIALIZATION_FAILED",
+  const initialization = (async () => {
+    const reporter = new TelemetryReporter({
+      billingApiUrl: (0, import_shared7.resolveBillingApiUrl)(config.billingApiUrl),
+      sdkVersion: import_shared7.SDK_VERSION,
+      enabled: config.telemetry !== false
+    });
+    const initializationStarted = reporter.now();
+    reporter.log({ name: "sdk.initialize.started", stage: "sdk_initialize" });
+    reporter.log({ name: "sdk.cache.miss", stage: "sdk_initialize" });
+    reporter.log({
+      name: "provider.load.started",
+      stage: "provider_load",
+      provider: "stripe"
+    });
+    const adapter = new StripeAdapter();
+    try {
+      await adapter.initialize(config);
+    } catch (error) {
+      reporter.error({
+        errorCode: "SDK_INITIALIZATION_FAILED",
+        stage: "sdk_initialize",
+        provider: "stripe",
+        paymentMethodCategory: "unknown"
+      });
+      reporter.destroy();
+      throw error;
+    }
+    reporter.log({ name: "provider.ready", stage: "provider_ready", provider: "stripe" });
+    reporter.log({
+      name: "provider.availability.checked",
+      stage: "provider_ready",
+      provider: "stripe"
+    });
+    reporter.log({ name: "sdk.initialize.ready", stage: "sdk_initialize" });
+    const initializationDuration = reporter.now() - initializationStarted;
+    reporter.performance({
       stage: "sdk_initialize",
-      provider: "stripe",
-      paymentMethodCategory: "unknown"
+      durationMs: initializationDuration,
+      durationMode: "machine",
+      provider: "stripe"
     });
-    reporter.destroy();
-    throw error;
+    reporter.performance({
+      stage: "provider_ready",
+      durationMs: initializationDuration,
+      durationMode: "machine",
+      provider: "stripe"
+    });
+    const instance = createInstrumentedFloPay(adapter, config, reporter);
+    instanceCache.set(cacheKey, instance);
+    return instance;
+  })();
+  initializationCache.set(cacheKey, initialization);
+  try {
+    return await initialization;
+  } finally {
+    if (initializationCache.get(cacheKey) === initialization) {
+      initializationCache.delete(cacheKey);
+    }
   }
-  reporter.log({ name: "provider.ready", stage: "provider_ready", provider: "stripe" });
-  reporter.log({
-    name: "provider.availability.checked",
-    stage: "provider_ready",
-    provider: "stripe"
-  });
-  reporter.log({ name: "sdk.initialize.ready", stage: "sdk_initialize" });
-  const initializationDuration = reporter.now() - initializationStarted;
-  reporter.performance({
-    stage: "sdk_initialize",
-    durationMs: initializationDuration,
-    durationMode: "machine",
-    provider: "stripe"
-  });
-  reporter.performance({
-    stage: "provider_ready",
-    durationMs: initializationDuration,
-    durationMode: "machine",
-    provider: "stripe"
-  });
-  const instance = createInstrumentedFloPay(adapter, config, reporter);
-  instanceCache.set(cacheKey, instance);
-  return instance;
 }
 
 // src/create-checkout-session.ts
 var import_shared8 = require("@flopay/shared");
 var MAX_COUPON_CODES = 5;
-function readString2(value) {
-  return typeof value === "string" && value.trim() ? value : void 0;
-}
 function buildCheckoutSessionError(status, payload) {
   const nested = payload?.error;
-  const code = readString2(payload?.code) ?? readString2(nested?.code) ?? `http_${status}`;
-  const message = readString2(payload?.message) ?? readString2(nested?.message) ?? defaultMessageForCode(code, status);
+  const code = readErrorString(payload?.code) ?? readErrorString(nested?.code) ?? `http_${status}`;
+  const message = readErrorString(payload?.message) ?? readErrorString(nested?.message) ?? defaultMessageForCode(code, status);
   return new import_shared8.FloPayError(message, "api_error", { code, statusCode: status });
 }
 function defaultMessageForCode(code, status) {