@lightspeed/online-payments-sdk 1.4.2 → 1.6.0

package/dist/cjs/v1/EventBroadcaster.js

@@ -33,6 +33,9 @@ var EventBroadcaster = /** @class */ (function () {
         if ('paymentMethodType' in event && event.paymentMethodType) {
             externalEvent.paymentMethodType = event.paymentMethodType;
         }
+        if ('saveCheckboxChecked' in event && event.saveCheckboxChecked !== undefined) {
+            externalEvent.saveCheckboxChecked = event.saveCheckboxChecked;
+        }
         return externalEvent;
     };
     EventBroadcaster.prototype.registerMiddleware = function (middleware) {

package/dist/cjs/v1/session.js

@@ -5,7 +5,9 @@ exports.isTokenValid = isTokenValid;
 var error_1 = require("./error");
 function decodePaymentSessionToContext(paymentSession) {
     try {
-        var decoded = atob(paymentSession);
+        var binary = atob(paymentSession);
+        var bytes = Uint8Array.from(binary, function (c) { return c.charCodeAt(0); });
+        var decoded = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
         var jsonToken = JSON.parse(decoded);
         if (jsonToken && isTokenValid(jsonToken)) {
             return jsonToken;

package/dist/cjs/v1/stripe/shared.js

@@ -92,10 +92,11 @@ function initStripe(context, theme) {
  * @param defaultValues - Default values for the payment element
  * @param theme - Theme configuration
  * @param hideNameField - Whether to hide the billing details name field (used when address element is present to avoid duplicates with ACH)
+ * @param businessName - Overrides the merchant name Stripe renders in mandate text (passed to `business.name`)
  */
-function createPaymentElementOptions(defaultValues, theme, hideNameField) {
+function createPaymentElementOptions(defaultValues, theme, hideNameField, businessName) {
     if (hideNameField === void 0) { hideNameField = false; }
-    var options = __assign(__assign({ wallets: {
+    var options = __assign(__assign(__assign({ wallets: {
             applePay: 'never',
             googlePay: 'never',
             link: 'never',
@@ -107,7 +108,7 @@ function createPaymentElementOptions(defaultValues, theme, hideNameField) {
         },
     })), { terms: {
             usBankAccount: 'never', // Hide Stripe's default T&Cs (shown for ACH payments)
-        } });
+        } }), (businessName && { business: { name: businessName } }));
     if (defaultValues) {
         options.defaultValues = {
             billingDetails: {
@@ -221,17 +222,22 @@ function createPaymentElement(elements, options, mountElement, eventBroadcaster)
  * When addressElement is provided (payment form): emits "Complete" only when BOTH elements are complete,
  * and "Incomplete" when at least one element becomes incomplete.
  * When addressElement is not provided (MOTO form): emits based on payment element completion only.
+ * Also includes the current save-payment-method checkbox state (when present) on every Change event,
+ * and emits a Change event when that checkbox state changes.
  */
 function setupChangeEventHandler(paymentElement, eventBroadcaster, addressElement) {
     var paymentComplete = false;
     var addressComplete = !addressElement; // If no address element, consider it complete
     var previousComplete = null;
     var previousMethodType;
+    var previousSaveCheckboxState; // Track save checkbox state
     var emitChangeEvent = function () {
         var complete = paymentComplete && addressComplete;
         previousComplete = complete;
-        eventBroadcaster.publish(__assign({ status: 'Change', code: complete ? 'Complete' : 'Incomplete' }, (previousMethodType && {
+        eventBroadcaster.publish(__assign(__assign({ status: 'Change', code: complete ? 'Complete' : 'Incomplete' }, (previousMethodType && {
             paymentMethodType: previousMethodType,
+        })), (previousSaveCheckboxState !== undefined && {
+            saveCheckboxChecked: previousSaveCheckboxState,
         })));
     };
     paymentElement.on('change', function (event) {
@@ -243,7 +249,15 @@ function setupChangeEventHandler(paymentElement, eventBroadcaster, addressElemen
         if (methodType !== undefined) {
             previousMethodType = methodType;
         }
-        if (completenessChanged || methodTypeChanged) {
+        // Check for save checkbox state from Stripe's value object
+        // The value object may contain a `savePaymentMethod` property
+        var saveCheckboxChanged = false;
+        if (event.value && typeof event.value === 'object' && 'savePaymentMethod' in event.value) {
+            var saveCheckboxState = event.value.savePaymentMethod;
+            saveCheckboxChanged = previousSaveCheckboxState !== saveCheckboxState;
+            previousSaveCheckboxState = saveCheckboxState;
+        }
+        if (completenessChanged || methodTypeChanged || saveCheckboxChanged) {
             emitChangeEvent();
         }
     });

package/dist/cjs/v1/stripe/widgets/moto.js

@@ -50,7 +50,7 @@ function mountMotoWidget(mountElement, session, eventBroadcaster, defaultValues,
                 case 0: return [4 /*yield*/, (0, shared_1.initStripe)(session.context, theme)];
                 case 1:
                     _a = _c.sent(), stripe = _a.stripe, elements = _a.elements;
-                    paymentOptions = (0, shared_1.createPaymentElementOptions)(defaultValues, theme);
+                    paymentOptions = (0, shared_1.createPaymentElementOptions)(defaultValues, theme, false, session.context.businessName);
                     _b = (0, shared_1.createPaymentElement)(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _b.element, paymentContainer = _b.container, customTermsContainer = _b.customTermsContainer;
                     // Setup change handler for payment element only (MOTO forms don't have address element)
                     (0, shared_1.setupChangeEventHandler)(paymentElement, eventBroadcaster);

package/dist/cjs/v1/stripe/widgets/payment.js

@@ -51,7 +51,7 @@ function mountPaymentWidget(mountElement, session, eventBroadcaster, defaultValu
                     _a = _d.sent(), stripe = _a.stripe, elements = _a.elements;
                     addressOptions = (0, shared_1.createAddressElementOptions)(defaultValues);
                     _b = (0, shared_1.createAddressElement)(elements, addressOptions, mountElement), addressElement = _b.element, addressContainer = _b.container;
-                    paymentOptions = (0, shared_1.createPaymentElementOptions)(defaultValues, theme, true);
+                    paymentOptions = (0, shared_1.createPaymentElementOptions)(defaultValues, theme, true, session.context.businessName);
                     _c = (0, shared_1.createPaymentElement)(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _c.element, paymentContainer = _c.container, customTermsContainer = _c.customTermsContainer;
                     // Setup change handler that emits Complete only when both elements are complete
                     (0, shared_1.setupChangeEventHandler)(paymentElement, eventBroadcaster, addressElement);

package/dist/cjs/version.js

@@ -3,4 +3,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
 // This file is auto-generated during the build process
 // DO NOT EDIT MANUALLY - Version is extracted from package.json
-exports.SDK_VERSION = '1.4.2';
+exports.SDK_VERSION = '1.6.0';

package/dist/v1/EventBroadcaster.d.ts

@@ -23,13 +23,15 @@ export type ChangeEvent = BaseEvent & {
     status: 'Change';
     code: 'Complete' | 'Incomplete';
     paymentMethodType?: string;
+    saveCheckboxChecked?: boolean;
 };
 export type ErrorResultEvent = BaseEvent & {
     code: SupportedErrorCodes;
     status: 'Error';
 };
 export type InternalEvent = SucceededResultEvent | PendingResultEvent | DeclinedResultEvent | ErrorResultEvent | ReadyEvent | ChangeEvent;
-export type Event = Omit<InternalEvent, 'loggingEnrichment'>;
+type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
+export type Event = DistributiveOmit<InternalEvent, 'loggingEnrichment'>;
 export type EventHandler = (result: Event) => void;
 export type EventMiddleware = (event: InternalEvent) => InternalEvent | void;
 export type EventListeners = Partial<Record<`on${Status}`, EventHandler>>;
@@ -42,3 +44,4 @@ export declare class EventBroadcaster {
     applyMiddlewares(event: InternalEvent): Event;
     publish(event: InternalEvent): void;
 }
+export {};

package/dist/v1/EventBroadcaster.js

@@ -30,6 +30,9 @@ var EventBroadcaster = /** @class */ (function () {
         if ('paymentMethodType' in event && event.paymentMethodType) {
             externalEvent.paymentMethodType = event.paymentMethodType;
         }
+        if ('saveCheckboxChecked' in event && event.saveCheckboxChecked !== undefined) {
+            externalEvent.saveCheckboxChecked = event.saveCheckboxChecked;
+        }
         return externalEvent;
     };
     EventBroadcaster.prototype.registerMiddleware = function (middleware) {

package/dist/v1/session.js

@@ -1,7 +1,9 @@
 import { InvalidSessionPayloadError, InvalidSessionError } from './error';
 export function decodePaymentSessionToContext(paymentSession) {
     try {
-        var decoded = atob(paymentSession);
+        var binary = atob(paymentSession);
+        var bytes = Uint8Array.from(binary, function (c) { return c.charCodeAt(0); });
+        var decoded = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
         var jsonToken = JSON.parse(decoded);
         if (jsonToken && isTokenValid(jsonToken)) {
             return jsonToken;

package/dist/v1/stripe/session.d.ts

@@ -11,4 +11,5 @@ export type StripeContext = {
     intent: 'save-card' | 'payment';
     locale?: StripeElementLocale;
     redirectUrl?: string;
+    businessName?: string;
 };

package/dist/v1/stripe/shared.d.ts

@@ -21,8 +21,9 @@ export declare function initStripe(context: StripeContext, theme?: PaymentWidget
  * @param defaultValues - Default values for the payment element
  * @param theme - Theme configuration
  * @param hideNameField - Whether to hide the billing details name field (used when address element is present to avoid duplicates with ACH)
+ * @param businessName - Overrides the merchant name Stripe renders in mandate text (passed to `business.name`)
  */
-export declare function createPaymentElementOptions(defaultValues?: DefaultValues, theme?: PaymentWidgetTheme, hideNameField?: boolean): StripePaymentElementOptions;
+export declare function createPaymentElementOptions(defaultValues?: DefaultValues, theme?: PaymentWidgetTheme, hideNameField?: boolean, businessName?: string): StripePaymentElementOptions;
 /**
  * Create address element options
  */
@@ -40,6 +41,8 @@ export declare function createPaymentElement(elements: StripeElements, options:
  * When addressElement is provided (payment form): emits "Complete" only when BOTH elements are complete,
  * and "Incomplete" when at least one element becomes incomplete.
  * When addressElement is not provided (MOTO form): emits based on payment element completion only.
+ * Also includes the current save-payment-method checkbox state (when present) on every Change event,
+ * and emits a Change event when that checkbox state changes.
  */
 export declare function setupChangeEventHandler(paymentElement: StripePaymentElement, eventBroadcaster: EventBroadcaster, addressElement?: StripeAddressElement | null): void;
 /**

package/dist/v1/stripe/shared.js

@@ -80,10 +80,11 @@ export function initStripe(context, theme) {
  * @param defaultValues - Default values for the payment element
  * @param theme - Theme configuration
  * @param hideNameField - Whether to hide the billing details name field (used when address element is present to avoid duplicates with ACH)
+ * @param businessName - Overrides the merchant name Stripe renders in mandate text (passed to `business.name`)
  */
-export function createPaymentElementOptions(defaultValues, theme, hideNameField) {
+export function createPaymentElementOptions(defaultValues, theme, hideNameField, businessName) {
     if (hideNameField === void 0) { hideNameField = false; }
-    var options = __assign(__assign({ wallets: {
+    var options = __assign(__assign(__assign({ wallets: {
             applePay: 'never',
             googlePay: 'never',
             link: 'never',
@@ -95,7 +96,7 @@ export function createPaymentElementOptions(defaultValues, theme, hideNameField)
         },
     })), { terms: {
             usBankAccount: 'never', // Hide Stripe's default T&Cs (shown for ACH payments)
-        } });
+        } }), (businessName && { business: { name: businessName } }));
     if (defaultValues) {
         options.defaultValues = {
             billingDetails: {
@@ -209,17 +210,22 @@ export function createPaymentElement(elements, options, mountElement, eventBroad
  * When addressElement is provided (payment form): emits "Complete" only when BOTH elements are complete,
  * and "Incomplete" when at least one element becomes incomplete.
  * When addressElement is not provided (MOTO form): emits based on payment element completion only.
+ * Also includes the current save-payment-method checkbox state (when present) on every Change event,
+ * and emits a Change event when that checkbox state changes.
  */
 export function setupChangeEventHandler(paymentElement, eventBroadcaster, addressElement) {
     var paymentComplete = false;
     var addressComplete = !addressElement; // If no address element, consider it complete
     var previousComplete = null;
     var previousMethodType;
+    var previousSaveCheckboxState; // Track save checkbox state
     var emitChangeEvent = function () {
         var complete = paymentComplete && addressComplete;
         previousComplete = complete;
-        eventBroadcaster.publish(__assign({ status: 'Change', code: complete ? 'Complete' : 'Incomplete' }, (previousMethodType && {
+        eventBroadcaster.publish(__assign(__assign({ status: 'Change', code: complete ? 'Complete' : 'Incomplete' }, (previousMethodType && {
             paymentMethodType: previousMethodType,
+        })), (previousSaveCheckboxState !== undefined && {
+            saveCheckboxChecked: previousSaveCheckboxState,
         })));
     };
     paymentElement.on('change', function (event) {
@@ -231,7 +237,15 @@ export function setupChangeEventHandler(paymentElement, eventBroadcaster, addres
         if (methodType !== undefined) {
             previousMethodType = methodType;
         }
-        if (completenessChanged || methodTypeChanged) {
+        // Check for save checkbox state from Stripe's value object
+        // The value object may contain a `savePaymentMethod` property
+        var saveCheckboxChanged = false;
+        if (event.value && typeof event.value === 'object' && 'savePaymentMethod' in event.value) {
+            var saveCheckboxState = event.value.savePaymentMethod;
+            saveCheckboxChanged = previousSaveCheckboxState !== saveCheckboxState;
+            previousSaveCheckboxState = saveCheckboxState;
+        }
+        if (completenessChanged || methodTypeChanged || saveCheckboxChanged) {
             emitChangeEvent();
         }
     });

package/dist/v1/stripe/widgets/moto.js

@@ -47,7 +47,7 @@ export function mountMotoWidget(mountElement, session, eventBroadcaster, default
                 case 0: return [4 /*yield*/, initStripe(session.context, theme)];
                 case 1:
                     _a = _c.sent(), stripe = _a.stripe, elements = _a.elements;
-                    paymentOptions = createPaymentElementOptions(defaultValues, theme);
+                    paymentOptions = createPaymentElementOptions(defaultValues, theme, false, session.context.businessName);
                     _b = createPaymentElement(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _b.element, paymentContainer = _b.container, customTermsContainer = _b.customTermsContainer;
                     // Setup change handler for payment element only (MOTO forms don't have address element)
                     setupChangeEventHandler(paymentElement, eventBroadcaster);

package/dist/v1/stripe/widgets/payment.js

@@ -48,7 +48,7 @@ export function mountPaymentWidget(mountElement, session, eventBroadcaster, defa
                     _a = _d.sent(), stripe = _a.stripe, elements = _a.elements;
                     addressOptions = createAddressElementOptions(defaultValues);
                     _b = createAddressElement(elements, addressOptions, mountElement), addressElement = _b.element, addressContainer = _b.container;
-                    paymentOptions = createPaymentElementOptions(defaultValues, theme, true);
+                    paymentOptions = createPaymentElementOptions(defaultValues, theme, true, session.context.businessName);
                     _c = createPaymentElement(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _c.element, paymentContainer = _c.container, customTermsContainer = _c.customTermsContainer;
                     // Setup change handler that emits Complete only when both elements are complete
                     setupChangeEventHandler(paymentElement, eventBroadcaster, addressElement);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.4.2";
+export declare const SDK_VERSION = "1.6.0";

package/dist/version.js

@@ -1,3 +1,3 @@
 // This file is auto-generated during the build process
 // DO NOT EDIT MANUALLY - Version is extracted from package.json
-export var SDK_VERSION = '1.4.2';
+export var SDK_VERSION = '1.6.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightspeed/online-payments-sdk",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "Process online-payments with Lightspeed Payments",
   "author": "Lightspeed Commerce Inc.",
   "license": "SEE LICENSE IN LICENSE.md",