@lightspeed/online-payments-sdk 1.6.1 → 1.6.3

package/README.md

@@ -55,6 +55,7 @@ import {THEME_COLORS} from '@lightspeed/online-payments-sdk';
 ## Documentation
 
 - Datadog logging reference: `packages/lsp-online-payments-sdk/docs/DATADOG_LOGGING.md`
+- Sandbox releases (testing unreleased builds in a real app): `packages/lsp-online-payments-sdk/docs/sandbox-releases.md`
 
 ## Development
 
@@ -90,3 +91,11 @@ Publishing is handled by CircleCI (not manual local publish).
 - A human must approve before the `release` job runs `npm publish`.
 
 In practice: bump `version` in `packages/lsp-online-payments-sdk/package.json`, merge to `main`, then approve the release hold in CircleCI.
+
+### Sandbox releases
+
+To test unreleased SDK changes inside a real app without touching the production
+package on public npm, publish a **sandbox** build to GitHub Packages: push a
+`sandbox/*` branch and approve the `hold_sandbox` step in CircleCI. Consuming an
+app requires no `import` changes — just an `.npmrc` scope + a `package.json`
+alias. See `docs/sandbox-releases.md` for the full publish and consume steps.

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

@@ -25,7 +25,7 @@ exports.ACH_TERMS_TEXT = {
      */
     EXPANDED_TERMS_PARAGRAPHS: [
         'By providing your bank account details and confirming this payment, you authorize the merchant to debit your account for the amount shown.',
-        'If you choose to save your bank account for future payments, this authorization will also apply to any amounts now or hereafter due and payable, including amounts previously invoiced, accrued, outstanding, or otherwise payable, in addition to current, and future payment obligations owed for products or services provided by the merchant, until you cancel it.',
+        'If you choose to save your bank account for future payments, this authorization will also apply to any amounts now or hereafter due and payable, including amounts previously invoiced, accrued, outstanding, or otherwise payable, in addition to current, and future payment obligations owed for products or services provided by the merchant, until you cancel it. For returns due to insufficient funds or uncollected funds, the merchant may retry the debit up to two additional times. If you save your bank account, you authorize Stripe and Lightspeed to access your account status and balance information, where available, before submitting current or future ACH payments. A balance check does not guarantee that an ACH payment will be completed.',
         'You also authorize the merchant to credit your account as necessary to correct any erroneous debits.',
         'You may revoke authorization at any time by contacting the merchant, allowing up to thirty (30) days for processing.\nYou confirm that you are an authorized signer on the account and that sufficient funds will be available for each payment.\nACH payments may take up to five (5) business days to complete, and you may be responsible for fees if a payment is returned.',
     ],

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

@@ -43,22 +43,28 @@ var shared_1 = require("../shared");
  */
 function mountPaymentWidget(mountElement, session, eventBroadcaster, defaultValues, theme) {
     return __awaiter(this, void 0, void 0, function () {
-        var _a, stripe, elements, addressOptions, _b, addressElement, addressContainer, productMetadata, isPartnerProduct, showCardMandate, paymentOptions, _c, paymentElement, paymentContainer, customTermsContainer;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
+        var _a, stripe, elements, productMetadata, isPartnerProduct, addressElement, addressContainer, addressOptions, created, showCardMandate, paymentOptions, _b, paymentElement, paymentContainer, customTermsContainer;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
                 case 0: return [4 /*yield*/, (0, shared_1.initStripe)(session.context, theme)];
                 case 1:
-                    _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;
+                    _a = _c.sent(), stripe = _a.stripe, elements = _a.elements;
                     productMetadata = session.metadata.product;
                     isPartnerProduct = typeof productMetadata === 'string' &&
                         productMetadata.startsWith('partner:');
+                    addressElement = null;
+                    addressContainer = null;
+                    if (!isPartnerProduct) {
+                        addressOptions = (0, shared_1.createAddressElementOptions)(defaultValues);
+                        created = (0, shared_1.createAddressElement)(elements, addressOptions, mountElement);
+                        addressElement = created.element;
+                        addressContainer = created.container;
+                    }
                     showCardMandate = session.metadata.sessionType === 'payment-with-save' &&
                         !!session.context.businessName &&
                         isPartnerProduct;
-                    paymentOptions = (0, shared_1.createPaymentElementOptions)(defaultValues, theme, true, session.context.businessName, showCardMandate);
-                    _c = (0, shared_1.createPaymentElement)(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _c.element, paymentContainer = _c.container, customTermsContainer = _c.customTermsContainer;
+                    paymentOptions = (0, shared_1.createPaymentElementOptions)(defaultValues, theme, !!addressElement, session.context.businessName, showCardMandate);
+                    _b = (0, shared_1.createPaymentElement)(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _b.element, paymentContainer = _b.container, customTermsContainer = _b.customTermsContainer;
                     // Setup change handler that emits Complete only when both elements are complete
                     (0, shared_1.setupChangeEventHandler)(paymentElement, eventBroadcaster, addressElement);
                     return [2 /*return*/, {

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.6.1';
+exports.SDK_VERSION = '1.6.3';

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

@@ -20,7 +20,7 @@ export declare const ACH_TERMS_TEXT: {
      * Each entry is a separate paragraph rendered when the user expands
      * "these terms". Kept as plain text — HTML structure is built in code.
      */
-    readonly EXPANDED_TERMS_PARAGRAPHS: readonly ["By providing your bank account details and confirming this payment, you authorize the merchant to debit your account for the amount shown.", "If you choose to save your bank account for future payments, this authorization will also apply to any amounts now or hereafter due and payable, including amounts previously invoiced, accrued, outstanding, or otherwise payable, in addition to current, and future payment obligations owed for products or services provided by the merchant, until you cancel it.", "You also authorize the merchant to credit your account as necessary to correct any erroneous debits.", "You may revoke authorization at any time by contacting the merchant, allowing up to thirty (30) days for processing.\nYou confirm that you are an authorized signer on the account and that sufficient funds will be available for each payment.\nACH payments may take up to five (5) business days to complete, and you may be responsible for fees if a payment is returned."];
+    readonly EXPANDED_TERMS_PARAGRAPHS: readonly ["By providing your bank account details and confirming this payment, you authorize the merchant to debit your account for the amount shown.", "If you choose to save your bank account for future payments, this authorization will also apply to any amounts now or hereafter due and payable, including amounts previously invoiced, accrued, outstanding, or otherwise payable, in addition to current, and future payment obligations owed for products or services provided by the merchant, until you cancel it. For returns due to insufficient funds or uncollected funds, the merchant may retry the debit up to two additional times. If you save your bank account, you authorize Stripe and Lightspeed to access your account status and balance information, where available, before submitting current or future ACH payments. A balance check does not guarantee that an ACH payment will be completed.", "You also authorize the merchant to credit your account as necessary to correct any erroneous debits.", "You may revoke authorization at any time by contacting the merchant, allowing up to thirty (30) days for processing.\nYou confirm that you are an authorized signer on the account and that sufficient funds will be available for each payment.\nACH payments may take up to five (5) business days to complete, and you may be responsible for fees if a payment is returned."];
     /**
      * Final paragraph containing a link to the Privacy Policy.
      * The link text and URL are defined separately so translators only

package/dist/v1/stripe/terms.js

@@ -22,7 +22,7 @@ export var ACH_TERMS_TEXT = {
      */
     EXPANDED_TERMS_PARAGRAPHS: [
         'By providing your bank account details and confirming this payment, you authorize the merchant to debit your account for the amount shown.',
-        'If you choose to save your bank account for future payments, this authorization will also apply to any amounts now or hereafter due and payable, including amounts previously invoiced, accrued, outstanding, or otherwise payable, in addition to current, and future payment obligations owed for products or services provided by the merchant, until you cancel it.',
+        'If you choose to save your bank account for future payments, this authorization will also apply to any amounts now or hereafter due and payable, including amounts previously invoiced, accrued, outstanding, or otherwise payable, in addition to current, and future payment obligations owed for products or services provided by the merchant, until you cancel it. For returns due to insufficient funds or uncollected funds, the merchant may retry the debit up to two additional times. If you save your bank account, you authorize Stripe and Lightspeed to access your account status and balance information, where available, before submitting current or future ACH payments. A balance check does not guarantee that an ACH payment will be completed.',
         'You also authorize the merchant to credit your account as necessary to correct any erroneous debits.',
         'You may revoke authorization at any time by contacting the merchant, allowing up to thirty (30) days for processing.\nYou confirm that you are an authorized signer on the account and that sufficient funds will be available for each payment.\nACH payments may take up to five (5) business days to complete, and you may be responsible for fees if a payment is returned.',
     ],

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

@@ -40,22 +40,28 @@ import { initStripe, createPaymentElementOptions, createAddressElementOptions, c
  */
 export function mountPaymentWidget(mountElement, session, eventBroadcaster, defaultValues, theme) {
     return __awaiter(this, void 0, void 0, function () {
-        var _a, stripe, elements, addressOptions, _b, addressElement, addressContainer, productMetadata, isPartnerProduct, showCardMandate, paymentOptions, _c, paymentElement, paymentContainer, customTermsContainer;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
+        var _a, stripe, elements, productMetadata, isPartnerProduct, addressElement, addressContainer, addressOptions, created, showCardMandate, paymentOptions, _b, paymentElement, paymentContainer, customTermsContainer;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
                 case 0: return [4 /*yield*/, initStripe(session.context, theme)];
                 case 1:
-                    _a = _d.sent(), stripe = _a.stripe, elements = _a.elements;
-                    addressOptions = createAddressElementOptions(defaultValues);
-                    _b = createAddressElement(elements, addressOptions, mountElement), addressElement = _b.element, addressContainer = _b.container;
+                    _a = _c.sent(), stripe = _a.stripe, elements = _a.elements;
                     productMetadata = session.metadata.product;
                     isPartnerProduct = typeof productMetadata === 'string' &&
                         productMetadata.startsWith('partner:');
+                    addressElement = null;
+                    addressContainer = null;
+                    if (!isPartnerProduct) {
+                        addressOptions = createAddressElementOptions(defaultValues);
+                        created = createAddressElement(elements, addressOptions, mountElement);
+                        addressElement = created.element;
+                        addressContainer = created.container;
+                    }
                     showCardMandate = session.metadata.sessionType === 'payment-with-save' &&
                         !!session.context.businessName &&
                         isPartnerProduct;
-                    paymentOptions = createPaymentElementOptions(defaultValues, theme, true, session.context.businessName, showCardMandate);
-                    _c = createPaymentElement(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _c.element, paymentContainer = _c.container, customTermsContainer = _c.customTermsContainer;
+                    paymentOptions = createPaymentElementOptions(defaultValues, theme, !!addressElement, session.context.businessName, showCardMandate);
+                    _b = createPaymentElement(elements, paymentOptions, mountElement, eventBroadcaster), paymentElement = _b.element, paymentContainer = _b.container, customTermsContainer = _b.customTermsContainer;
                     // Setup change handler that emits Complete only when both elements are complete
                     setupChangeEventHandler(paymentElement, eventBroadcaster, addressElement);
                     return [2 /*return*/, {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.6.1";
+export declare const SDK_VERSION = "1.6.3";

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.6.1';
+export var SDK_VERSION = '1.6.3';

package/package.json

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