@zonos/elements 1.3.249 → 1.3.251

package/dist/collection/components/main/zonos-controller.js

@@ -602,7 +602,7 @@ export class ZonosController {
                     "signature": "(countryCode: CountryCode) => Promise<void>",
                     "parameters": [{
                             "name": "countryCode",
-                            "type": "\"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AQ\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AX\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BH\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CC\" | \"CD\" | \"CF\" | \"CG\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CM\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EG\" | \"EH\" | \"ER\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"IC\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KG\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LB\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"ML\" | \"MM\" | \"MN\" | \"MO\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NO\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PF\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PN\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SO\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SX\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TO\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\"",
+                            "type": "\"CC\" | \"TO\" | \"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AQ\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AX\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BH\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CD\" | \"CF\" | \"CG\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CM\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EG\" | \"EH\" | \"ER\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"IC\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KG\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LB\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"ML\" | \"MM\" | \"MN\" | \"MO\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NO\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PF\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PN\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SO\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SX\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\"",
                             "docs": ""
                         }],
                     "references": {

package/dist/collection/components/store/checkout/cart.js

@@ -1,4 +1,5 @@
 import { createStore } from "@stencil/store";
+import { storeCreditStoreGetInput, storeCreditStoreReset, storeCreditStoreSetBalanceFromSession, } from "./storeCredit";
 import { stripeStore, stripeStoreInitCheckoutSession, stripeStoreReset, stripeStoreUpdateCheckoutSession, } from "./stripe";
 import { localizationStore } from "../hello/localization";
 import { storageStore, storageStoreSetEnabledVariantTestKeys, } from "../storageStore";
@@ -46,6 +47,7 @@ const { onChange: cartStoreOnChange, reset, state: cartStore, } = createStore(()
     shippingData: null,
     shouldHideDiscountInput: false,
     step: 'customer-info',
+    storeCredit: 0,
     subtotal: 0,
     tabItems: {
         'customer-info': {
@@ -134,8 +136,16 @@ const cartStoreCheckItemRestrictions = (itemsWorkflow) => {
         restrictedItems: mappedRestrictedItems,
     };
 };
+let storeCreditUpdateTimeout = null;
 const cartStoreReset = () => {
     storageStore.checkoutSessionId = null;
+    // clear pending store credit debounce timer
+    if (storeCreditUpdateTimeout) {
+        clearTimeout(storeCreditUpdateTimeout);
+        storeCreditUpdateTimeout = null;
+    }
+    // reset store credit store
+    storeCreditStoreReset();
     // reset cart store
     reset();
 };
@@ -149,11 +159,13 @@ const cartStoreUpdateToErrorState = ({ messages, title, }) => {
     };
 };
 const cartStoreApplySubtotals = ({ dutiesTaxesFeesEstimate, method, subtotals, }) => {
+    var _a;
     // update exchange rate so we can use it to display cart items
     cartStore.exchangeRate = subtotals.exchangeRate;
     cartStore.adjustmentTotal = subtotals.adjustments;
     cartStore.dutiesTaxesFees =
         method === 'DAP' ? null : subtotals.landedCostTotal;
+    cartStore.storeCredit = (_a = subtotals.storeCredit) !== null && _a !== void 0 ? _a : 0;
     cartStore.subtotal = subtotals.items;
     cartStore.total = subtotals.total;
     cartStore.currency = subtotals.presentmentCurrencyCode;
@@ -170,13 +182,15 @@ const cartStoreHasOneEligibleItem = () => {
     return !!checkItems.find(item => !item.isRestricted);
 };
 const cartStoreSetCheckoutSession = (checkoutSession) => {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     // update stripe store with updated information
     stripeStore.clientSecret = checkoutSession.clientSecret;
     stripeStore.stripeCustomerSessionClientSecret =
         checkoutSession.customerSessionClientSecret;
     stripeStore.customerProfile = checkoutSession.customerProfile;
     cartStore.checkoutSession = checkoutSession;
+    // Populate store credit balance from checkout session customer profile
+    storeCreditStoreSetBalanceFromSession((_b = (_a = checkoutSession.customerProfile) === null || _a === void 0 ? void 0 : _a.storeCreditBalance) !== null && _b !== void 0 ? _b : null);
     if (!checkoutSession.id) {
         // Log error to track down the issue
         void sendErrorLog({
@@ -196,10 +210,10 @@ const cartStoreSetCheckoutSession = (checkoutSession) => {
     const availableSelectedVariantTestKeys = filterValidTests(checkoutSession.varianceTestResults || []);
     storageStoreSetEnabledVariantTestKeys(availableSelectedVariantTestKeys);
     // Check if there is a redirect URL in the metadata to override
-    const externalConfirmationPageURL = ((_c = (_b = (_a = cartStore.checkoutSession) === null || _a === void 0 ? void 0 : _a.metadata) === null || _b === void 0 ? void 0 : _b.find(entry => (entry === null || entry === void 0 ? void 0 : entry.key) === 'externalConfirmationPageURL')) === null || _c === void 0 ? void 0 : _c.value) ||
+    const externalConfirmationPageURL = ((_e = (_d = (_c = cartStore.checkoutSession) === null || _c === void 0 ? void 0 : _c.metadata) === null || _d === void 0 ? void 0 : _d.find(entry => (entry === null || entry === void 0 ? void 0 : entry.key) === 'externalConfirmationPageURL')) === null || _e === void 0 ? void 0 : _e.value) ||
         (
         // Sometimes externalConfirmationPageURL is not in checkoutSession create/update, check if there is a redirect URL in the cart metadata to override
-        (_e = (_d = window.Zonos.cartData) === null || _d === void 0 ? void 0 : _d.metadata.find(entry => (entry === null || entry === void 0 ? void 0 : entry.key) === 'externalConfirmationPageURL')) === null || _e === void 0 ? void 0 : _e.value) ||
+        (_g = (_f = window.Zonos.cartData) === null || _f === void 0 ? void 0 : _f.metadata.find(entry => (entry === null || entry === void 0 ? void 0 : entry.key) === 'externalConfirmationPageURL')) === null || _g === void 0 ? void 0 : _g.value) ||
         null;
     if (externalConfirmationPageURL) {
         log(`Found externalConfirmationPageURL: ${externalConfirmationPageURL}`);
@@ -470,4 +484,48 @@ const cartStoreResetTabItems = () => {
     cartStore.tabItems = Object.assign(Object.assign({}, cartStore.tabItems), { 'customer-info': Object.assign(Object.assign({}, cartStore.tabItems['customer-info']), { isDone: false }), payment: Object.assign(Object.assign({}, cartStore.tabItems.payment), { isDone: false }), shipping: Object.assign(Object.assign({}, cartStore.tabItems.shipping), { isDone: false }) });
     cartStoreResetSelectedShippingOption();
 };
-export { cartStore, cartStoreApplySubtotals, cartStoreCheckItemRestrictions, cartStoreClearCheckoutInterval, cartStoreGetMethod, cartStoreGetShippingTransitInfo, cartStoreHasOneEligibleItem, cartStoreNextStep, cartStoreOnChange, cartStorePreviousStep, cartStoreReCalculateTotal, cartStoreReset, cartStoreResetCartItems, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateSelectedShippingOption, cartStoreUpdateToErrorState, };
+const cartStoreUpdateStoreCreditImmediate = async () => {
+    var _a, _b;
+    if (!storageStore.checkoutSessionId) {
+        log('Could not update store credit without checkout session id', 'info');
+        return;
+    }
+    const selectedLandedCost = cartStore.selectedLandedCost;
+    const currency = cartStore.currency || ((_a = cartStore.items.find(Boolean)) === null || _a === void 0 ? void 0 : _a.currencyCode) || '';
+    const adjustmentsAmount = cartStore.adjustments.reduce((prev, adj) => prev + adj.amount, 0);
+    const itemsAmount = cartStore.items.reduce((amount, item) => amount + item.amount * item.quantity, 0);
+    const { errors, json } = await stripeStoreUpdateCheckoutSession({
+        adjustmentsAmount,
+        cartId: window.Zonos.cartId,
+        currency,
+        id: storageStore.checkoutSessionId,
+        itemsAmount,
+        landedCostId: selectedLandedCost === null || selectedLandedCost === void 0 ? void 0 : selectedLandedCost.landedCostId,
+        presentmentCountryCode: localizationStore.selectedCountryCode,
+        storeCreditApplication: storeCreditStoreGetInput(),
+    });
+    if (errors.length > 0 || !json) {
+        logError('Error updating checkout session with store credit');
+        return;
+    }
+    // Apply updated subtotals from the response
+    cartStoreApplySubtotals({
+        method: ((_b = json.checkoutSessionUpdate.landedCost) === null || _b === void 0 ? void 0 : _b.method) || 'DDP',
+        subtotals: json.checkoutSessionUpdate.subtotals,
+    });
+    cartStoreSetCheckoutSession(json.checkoutSessionUpdate);
+};
+/**
+ * Update the checkout session with the current store credit selection.
+ * Debounced to prevent multiple rapid requests when store changes cascade.
+ */
+const cartStoreUpdateStoreCredit = () => {
+    if (storeCreditUpdateTimeout) {
+        clearTimeout(storeCreditUpdateTimeout);
+    }
+    storeCreditUpdateTimeout = setTimeout(() => {
+        storeCreditUpdateTimeout = null;
+        void cartStoreUpdateStoreCreditImmediate();
+    }, 300);
+};
+export { cartStore, cartStoreApplySubtotals, cartStoreCheckItemRestrictions, cartStoreClearCheckoutInterval, cartStoreGetMethod, cartStoreGetShippingTransitInfo, cartStoreHasOneEligibleItem, cartStoreNextStep, cartStoreOnChange, cartStorePreviousStep, cartStoreReCalculateTotal, cartStoreReset, cartStoreResetCartItems, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateSelectedShippingOption, cartStoreUpdateStoreCredit, cartStoreUpdateToErrorState, };

package/dist/collection/components/store/checkout/paypal.js

@@ -1,6 +1,7 @@
 import { loadScript, } from "@paypal/paypal-js";
 import { createStore } from "@stencil/store";
 import { cartStore, cartStoreClearCheckoutInterval, cartStoreNextStep, } from "./cart";
+import { storeCreditStoreApplyCredit, storeCreditStoreCoversFullAmount, storeCreditStoreCreateOrder, storeCreditStoreGetEffectiveAmount, } from "./storeCredit";
 import { stripeStore, stripeStoreHandleInventoryCheck, } from "./stripe";
 import { storageStore } from "../storageStore";
 import { translate } from "../translationStore";
@@ -121,6 +122,33 @@ const paypalButtonOptions = ({ checkoutSessionId, onPaypalFail, onPaypalSessionD
                 if (cartStore.inventoryCheckErrorMessage) {
                     return '';
                 }
+                // Apply store credit if customer has selected an amount
+                const storeCreditAmount = storeCreditStoreGetEffectiveAmount();
+                if (storeCreditAmount > 0) {
+                    const storeCreditResult = await storeCreditStoreApplyCredit();
+                    if (!storeCreditResult.success) {
+                        paypalStore.paypalErrorMessage =
+                            storeCreditResult.error ||
+                                translate('Unable to apply store credit. Please try again.');
+                        onPaypalFail === null || onPaypalFail === void 0 ? void 0 : onPaypalFail();
+                        return '';
+                    }
+                }
+                // If store credit covers the full order, create order directly
+                if (storeCreditStoreCoversFullAmount()) {
+                    const orderResult = await storeCreditStoreCreateOrder();
+                    if (!orderResult.success) {
+                        paypalStore.paypalErrorMessage =
+                            orderResult.error ||
+                                translate('Unable to place order with store credit. Please try again.');
+                        onPaypalFail === null || onPaypalFail === void 0 ? void 0 : onPaypalFail();
+                        return '';
+                    }
+                    onPaypalSessionDone === null || onPaypalSessionDone === void 0 ? void 0 : onPaypalSessionDone({ orderId: orderResult.orderId || '' });
+                    cartStoreNextStep();
+                    cartStoreClearCheckoutInterval();
+                    return '';
+                }
                 const paypalOrderId = await paypalStoreCreaterOrder({
                     checkoutSessionId,
                 });

package/dist/collection/components/store/checkout/storeCredit.js

@@ -0,0 +1,237 @@
+import { createStore } from "@stencil/store";
+import { cartStore } from "./cart";
+import { storageStore } from "../storageStore";
+import { getCheckoutSession } from "../../utils/api/getCheckoutSession";
+import { handleFetch } from "../../utils/handleFetch";
+import { log } from "../../utils/logging/log";
+import { logError } from "../../utils/logging/logError";
+const { onChange: storeCreditStoreOnChange, reset, state: storeCreditStore, } = createStore(() => ({
+    amountToApply: null,
+    appliedAmount: null,
+    availableBalance: null,
+    error: null,
+    isApplying: false,
+    isEnabled: false,
+    orderIdCreated: null,
+    remainingBalance: null,
+    useFullBalance: true,
+}));
+/**
+ * Reset store credit store to initial state
+ */
+const storeCreditStoreReset = () => {
+    reset();
+};
+/**
+ * Set the available balance from the checkout session's customerProfile.storeCreditBalance
+ */
+const storeCreditStoreSetBalanceFromSession = (balance) => {
+    log('Store credit balance from session', 'info', balance);
+    storeCreditStore.availableBalance = balance;
+};
+/**
+ * Re-fetch the store credit balance from the checkout session.
+ * Called when the payment step loads to ensure the balance is fresh.
+ */
+const storeCreditStoreRefreshBalance = async () => {
+    var _a, _b;
+    const { errors, json } = await getCheckoutSession();
+    if (errors.length || !json) {
+        logError('Failed to refresh store credit balance');
+        return;
+    }
+    const balance = (_b = (_a = json.checkoutSession.customerProfile) === null || _a === void 0 ? void 0 : _a.storeCreditBalance) !== null && _b !== void 0 ? _b : null;
+    storeCreditStoreSetBalanceFromSession(balance);
+};
+/**
+ * Apply store credit to the checkout session.
+ * This must be called BEFORE payment confirmation.
+ * The amount/mode are already set via checkout session update with storeCreditApplication.
+ */
+const storeCreditStoreApplyCredit = async () => {
+    var _a;
+    const checkoutSessionId = storageStore.checkoutSessionId;
+    if (!checkoutSessionId) {
+        const error = 'No checkout session found';
+        logError(error);
+        storeCreditStore.error = error;
+        return { error, success: false };
+    }
+    log('Applying store credit', 'info', { checkoutSessionId });
+    storeCreditStore.isApplying = true;
+    storeCreditStore.error = null;
+    try {
+        const { errors, json } = await handleFetch('/api/zonos-elements/store-credit/apply', {
+            body: {
+                checkoutSessionId,
+            },
+            method: 'POST',
+        });
+        if (errors.length > 0 || !json) {
+            const errorMessage = ((_a = errors[0]) === null || _a === void 0 ? void 0 : _a.message) || 'Failed to apply store credit';
+            logError(errorMessage);
+            storeCreditStore.error = errorMessage;
+            storeCreditStore.isApplying = false;
+            return { error: errorMessage, success: false };
+        }
+        storeCreditStore.appliedAmount = json.amountApplied;
+        storeCreditStore.remainingBalance = json.remainingBalance;
+        storeCreditStore.isApplying = false;
+        log('Store credit applied', 'info', {
+            amountApplied: json.amountApplied,
+            remainingBalance: json.remainingBalance,
+        });
+        return { error: null, success: true };
+    }
+    catch (e) {
+        const errorMessage = e instanceof Error ? e.message : 'Failed to apply store credit';
+        logError(errorMessage);
+        storeCreditStore.error = errorMessage;
+        storeCreditStore.isApplying = false;
+        return { error: errorMessage, success: false };
+    }
+};
+/**
+ * Enable or disable store credit usage.
+ * When enabling, defaults to full balance mode.
+ * When disabling, clears the amount.
+ */
+const storeCreditStoreSetEnabled = (enabled) => {
+    storeCreditStore.isEnabled = enabled;
+    storeCreditStore.error = null;
+    if (!enabled) {
+        storeCreditStore.amountToApply = null;
+    }
+};
+/**
+ * Set the amount of store credit to apply
+ * Validates against available balance and cart total
+ */
+const storeCreditStoreSetAmount = (amount) => {
+    if (amount === null) {
+        storeCreditStore.amountToApply = null;
+        storeCreditStore.error = null;
+        return;
+    }
+    // Validate amount
+    if (amount <= 0) {
+        storeCreditStore.error = 'Amount must be greater than zero';
+        return;
+    }
+    if (storeCreditStore.availableBalance !== null &&
+        amount > storeCreditStore.availableBalance) {
+        storeCreditStore.error = 'Amount exceeds available balance';
+        return;
+    }
+    const orderTotal = cartStore.total + (cartStore.storeCredit || 0);
+    if (amount > orderTotal) {
+        storeCreditStore.error = 'Amount exceeds order total';
+        return;
+    }
+    storeCreditStore.error = null;
+    storeCreditStore.amountToApply = amount;
+};
+/**
+ * Toggle whether to use full balance or custom amount.
+ * When switching to custom mode, clears the applied amount so the user
+ * must explicitly apply via the Apply button.
+ */
+const storeCreditStoreSetUseFullBalance = (useFullBalance) => {
+    storeCreditStore.useFullBalance = useFullBalance;
+    storeCreditStore.error = null;
+    if (useFullBalance && storeCreditStore.availableBalance !== null) {
+        const orderTotal = cartStore.total + (cartStore.storeCredit || 0);
+        const maxAmount = Math.min(storeCreditStore.availableBalance, orderTotal);
+        storeCreditStore.amountToApply = maxAmount;
+    }
+    else if (!useFullBalance) {
+        storeCreditStore.amountToApply = null;
+    }
+};
+/**
+ * Get the storeCreditApplication input for checkout session update.
+ * Sends mode: 'NONE' when store credit is not being used to clear any
+ * previously applied store credit on the backend.
+ */
+const storeCreditStoreGetInput = () => {
+    if (!storeCreditStore.isEnabled || storeCreditStore.amountToApply === null) {
+        return { mode: 'NONE' };
+    }
+    if (storeCreditStore.useFullBalance) {
+        return { mode: 'FULL' };
+    }
+    return {
+        amount: storeCreditStore.amountToApply,
+        mode: 'PARTIAL',
+    };
+};
+/**
+ * Get the effective amount to apply based on settings
+ */
+const storeCreditStoreGetEffectiveAmount = () => {
+    if (!storeCreditStore.isEnabled ||
+        storeCreditStore.availableBalance === null) {
+        return 0;
+    }
+    if (storeCreditStore.useFullBalance) {
+        return Math.min(storeCreditStore.availableBalance, cartStore.total + (cartStore.storeCredit || 0));
+    }
+    return storeCreditStore.amountToApply || 0;
+};
+/**
+ * Check whether the effective store credit amount covers the full order total.
+ * When true, the Stripe/PayPal payment flow should be skipped and
+ * `storeCreditStoreCreateOrder` should be used instead.
+ *
+ * Relies on the backend's computed `cartStore.total` (remaining amount to pay
+ * after store credit) rather than a client-side comparison, which avoids issues
+ * with currency mismatches or rounding.
+ */
+const storeCreditStoreCoversFullAmount = () => {
+    // Only consider full coverage after the backend has confirmed store credit
+    // was applied (cartStore.storeCredit > 0) and the remaining total is 0.
+    return (storeCreditStore.amountToApply !== null &&
+        storeCreditStore.amountToApply > 0 &&
+        cartStore.storeCredit > 0 &&
+        cartStore.total <= 0);
+};
+/**
+ * Create an order paid entirely by store credit.
+ * Should only be called when `storeCreditStoreCoversFullAmount()` is true.
+ */
+const storeCreditStoreCreateOrder = async () => {
+    var _a, _b, _c;
+    const checkoutSessionId = storageStore.checkoutSessionId;
+    if (!checkoutSessionId) {
+        const error = 'No checkout session found';
+        logError(error);
+        storeCreditStore.error = error;
+        return { error, orderId: null, success: false };
+    }
+    log('Creating store credit order', 'info', { checkoutSessionId });
+    try {
+        const { errors, json } = await handleFetch('/api/zonos-elements/store-credit/order-create', {
+            body: {
+                checkoutSessionId,
+            },
+            method: 'POST',
+        });
+        if (errors.length > 0 || !json) {
+            const errorMessage = ((_a = errors[0]) === null || _a === void 0 ? void 0 : _a.message) || 'Failed to create store credit order';
+            logError(errorMessage);
+            storeCreditStore.error = errorMessage;
+            return { error: errorMessage, orderId: null, success: false };
+        }
+        const orderId = ((_c = (_b = json.checkoutSessionStoreCreditOrderCreate) === null || _b === void 0 ? void 0 : _b.order) === null || _c === void 0 ? void 0 : _c.id) || null;
+        storeCreditStore.orderIdCreated = orderId;
+        log('Store credit order created', 'info', { orderId });
+        return { error: null, orderId, success: true };
+    }
+    catch (e) {
+        const errorMessage = e instanceof Error ? e.message : 'Failed to create store credit order';
+        logError(errorMessage);
+        storeCreditStore.error = errorMessage;
+        return { error: errorMessage, orderId: null, success: false };
+    }
+};
+export { storeCreditStore, storeCreditStoreApplyCredit, storeCreditStoreCoversFullAmount, storeCreditStoreCreateOrder, storeCreditStoreGetEffectiveAmount, storeCreditStoreGetInput, storeCreditStoreOnChange, storeCreditStoreRefreshBalance, storeCreditStoreReset, storeCreditStoreSetAmount, storeCreditStoreSetBalanceFromSession, storeCreditStoreSetEnabled, storeCreditStoreSetUseFullBalance, };

package/dist/collection/components/store/checkout/stripe.js

@@ -1025,7 +1025,7 @@ const stripeStoreUpdateCheckoutSessionBaseCurrency = async () => {
 /**
  * Update checkout session. Use for updating amount with landed cost id, or update session when cart items change
  */
-const stripeStoreUpdateCheckoutSession = async ({ adjustmentsAmount, cartId, currency, id, itemsAmount, landedCostId, presentmentCountryCode, }) => {
+const stripeStoreUpdateCheckoutSession = async ({ adjustmentsAmount, cartId, currency, id, itemsAmount, landedCostId, presentmentCountryCode, storeCreditApplication, }) => {
     const varianceTestInput = storageStore.enabledVariantTestKeys || [];
     // No need to set loading state here because this function will be called under the hood to update
     // landed cost id for the section.
@@ -1048,6 +1048,7 @@ const stripeStoreUpdateCheckoutSession = async ({ adjustmentsAmount, cartId, cur
             presentmentCountryCode,
             shipToPartyId: stripeStore.partyShippingId,
             skipPaymentIntent: stripeStore.skipPaymentIntent,
+            storeCreditApplication,
             varianceTestInput,
         },
         method: 'POST',

package/dist/collection/components/store/translationStore/strings.arabic.js

@@ -44,18 +44,27 @@ export const stringsArabic = {
     'Adresa vulytsi': {
         value: 'عنوان الشارع',
     },
+    'Amount to apply: [amount]': {
+        value: 'Amount to apply: [amount]',
+    },
     'An unexpected error occurred when processing PayPal order.': {
         value: 'حدث خطأ غير متوقع عند معالجة طلب PayPal.',
     },
     Apply: {
         value: 'تطبيق',
     },
+    'Apply full balance': {
+        value: 'Apply full balance',
+    },
     'Are you sure?': {
         value: 'هل أنت متأكد؟',
     },
     Area: {
         value: 'منطقة',
     },
+    'Available balance: [amount]': {
+        value: 'Available balance: [amount]',
+    },
     Back: {
         value: 'رجوع',
     },
@@ -224,6 +233,9 @@ export const stringsArabic = {
     Emirate: {
         value: 'إمارة',
     },
+    'Enter amount': {
+        value: 'Enter amount',
+    },
     'Error creating Checkout': {
         value: 'خطأ في إنشاء جلسة الخروج',
     },
@@ -347,6 +359,9 @@ export const stringsArabic = {
     'No shipping methods found - try editing your address or contacting support if the error persists': {
         value: 'لم يتم العثور على طرق شحن - جرب تحرير عنوانك أو الاتصال بالدعم إذا استمر الخطأ',
     },
+    'No store credit available': {
+        value: 'No store credit available',
+    },
     'Nothing due at delivery': {
         value: 'لا شيء مستحق عند التسليم',
     },
@@ -413,6 +428,9 @@ export const stringsArabic = {
     'Phone number': {
         value: 'رقم الهاتف',
     },
+    'Place order': {
+        value: 'تقديم الطلب',
+    },
     'Place test order': {
         value: 'إجراء طلب اختبار',
     },
@@ -569,6 +587,12 @@ export const stringsArabic = {
     'State/Province/Region/Prefecture': {
         value: 'ولاية/مقاطعة/منطقة/محافظة',
     },
+    'Store credit': {
+        value: 'Store credit',
+    },
+    'Store credit covers your full order': {
+        value: 'يغطي رصيد المتجر طلبك بالكامل',
+    },
     'Street address': {
         value: 'عنوان الشارع',
     },
@@ -656,12 +680,18 @@ export const stringsArabic = {
     Ulica: {
         value: 'شارع',
     },
+    'Unable to apply store credit. Please try again.': {
+        value: 'Unable to apply store credit. Please try again.',
+    },
     'Unable to check inventory. Please try again.': {
         value: 'تعذر التحقق من المخزون. حاول مرة أخرى.',
     },
     'Unable to complete payment in [currency]. Please try again or select a different currency. If the issue persists, contact our support team for assistance.': {
         value: 'غير قادر على إتمام الدفع بعملة [currency]. يرجى المحاولة مرة أخرى أو اختيار عملة مختلفة. إذا استمرت المشكلة، اتصل بفريق الدعم لدينا للحصول على المساعدة.',
     },
+    'Unable to place order with store credit. Please try again.': {
+        value: 'تعذر إتمام الطلب باستخدام رصيد المتجر. يرجى المحاولة مرة أخرى.',
+    },
     'Unable to retrieve the checkout session at the moment. Please try again or contact our support team.': {
         value: 'غير قادر على استرداد جلسة الدفع في الوقت الحالي. يرجى المحاولة مرة أخرى أو الاتصال بفريق الدعم لدينا.',
     },
@@ -674,6 +704,9 @@ export const stringsArabic = {
     'Update your address': {
         value: 'قم بتحديث عنوانك',
     },
+    'Use store credit': {
+        value: 'Use store credit',
+    },
     'View GAA Form.': {
         value: 'عرض نموذج GAA.',
     },
@@ -686,6 +719,9 @@ export const stringsArabic = {
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'تعذر علينا اكمال الدفع. يرجى التحقق من تفاصيل الدفع وإعادة المحاولة.',
     },
+    'We detected that you are shipping to a domestic address.': {
+        value: 'لقد اكتشفنا أنك تقوم بالشحن إلى عنوان محلي.',
+    },
     'We detected that you are shipping to an international address.': {
         value: 'لقد اكتشفنا أنك تقوم بالشحن إلى عنوان دولي.',
     },
@@ -713,6 +749,9 @@ export const stringsArabic = {
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'سيتم إعادة توجيهك إلى موقع التاجر في غضون ثوانٍ قليلة.',
     },
+    'You will be redirected to domestic checkout shortly.': {
+        value: 'سيتم إعادة توجيهك إلى الخروج المحلي قريبًا.',
+    },
     'You will be redirected to international checkout shortly.': {
         value: 'سيتم إعادة توجيهك إلى الخروج الدولي قريبًا.',
     },