capacitor-plugin-cdv-purchase 13.14.0 → 13.15.0

package/dist/index.js

@@ -877,26 +877,31 @@ var CdvPurchase;
                         if (initResult === null || initResult === void 0 ? void 0 : initResult.code)
                             return initResult;
                         log.info(`${adapter.name} products: ${JSON.stringify(platformProducts)}`);
-                        if (platformProducts.length === 0)
-                            return;
+                        // Storefront refresh runs in parallel with product / receipt loading.
+                        // Failure or timeout is absorbed so it never blocks store readiness.
+                        const storefrontRefresh = context.storefronts.refreshWith(adapter).catch(() => { });
                         let loadProductsResult = [];
                         let loadReceiptsResult = [];
-                        if (adapter.supportsParallelLoading) {
-                            [loadProductsResult, loadReceiptsResult] = yield Promise.all([
-                                adapter.loadProducts(platformProducts),
-                                adapter.loadReceipts()
-                            ]);
-                        }
-                        else {
-                            loadProductsResult = yield adapter.loadProducts(platformProducts);
-                            loadReceiptsResult = yield adapter.loadReceipts();
+                        if (platformProducts.length > 0) {
+                            if (adapter.supportsParallelLoading) {
+                                [loadProductsResult, loadReceiptsResult] = yield Promise.all([
+                                    adapter.loadProducts(platformProducts),
+                                    adapter.loadReceipts()
+                                ]);
+                            }
+                            else {
+                                loadProductsResult = yield adapter.loadProducts(platformProducts);
+                                loadReceiptsResult = yield adapter.loadReceipts();
+                            }
+                            log.info(`${adapter.name} products loaded: ${JSON.stringify(loadProductsResult)}`);
+                            const loadedProducts = loadProductsResult.filter(p => p instanceof CdvPurchase.Product);
+                            context.listener.productsUpdated(platformToInit.platform, loadedProducts);
+                            log.info(`${adapter.name} receipts loaded: ${JSON.stringify(loadReceiptsResult)}`);
                         }
-                        // const loadProductsResult = await adapter.loadProducts(platformProducts);
-                        log.info(`${adapter.name} products loaded: ${JSON.stringify(loadProductsResult)}`);
-                        const loadedProducts = loadProductsResult.filter(p => p instanceof CdvPurchase.Product);
-                        context.listener.productsUpdated(platformToInit.platform, loadedProducts);
-                        // const loadReceiptsResult = await adapter.loadReceipts();
-                        log.info(`${adapter.name} receipts loaded: ${JSON.stringify(loadReceiptsResult)}`);
+                        // Wait for the storefront refresh (or its timeout) before returning.
+                        // This intentionally delays storeReady by up to the timeout duration
+                        // so that store.getStorefront() has a value once the store is ready.
+                        yield storefrontRefresh;
                         return loadProductsResult.filter(lr => 'code' in lr && 'message' in lr)[0];
                     })));
                     return result.filter(err => err);
@@ -930,6 +935,95 @@ var CdvPurchase;
     })(CdvPurchase.Internal || (CdvPurchase.Internal = {}));
 })(CdvPurchase || (CdvPurchase = {}));
 var CdvPurchase;
+(function (CdvPurchase) {
+    (function (Internal) {
+        /** Default timeout for a storefront refresh call, in milliseconds. */
+        const DEFAULT_STOREFRONT_REFRESH_TIMEOUT_MS = 2000;
+        /**
+         * Collection of per-platform storefront country codes.
+         *
+         * Maintains the cached value for each platform that exposes one and
+         * notifies listeners when a value changes. Adapter-agnostic — callers
+         * are responsible for validating that a platform has a ready adapter.
+         */
+        class Storefronts {
+            constructor(logger) {
+                /** Cached country code per platform. */
+                this.values = {};
+                this.callbacks = new Internal.Callbacks(logger, 'storefrontUpdated()');
+            }
+            /**
+             * Refresh the cached value for a given adapter.
+             *
+             * The returned promise:
+             *   - resolves when the adapter responds within `timeoutMs`
+             *   - rejects with a timeout error otherwise
+             *
+             * Regardless of timeout, if the adapter eventually yields a value,
+             * the cache is silently updated and listeners are notified.
+             * A failed or empty response never overwrites the cache.
+             */
+            refreshWith(adapter, timeoutMs = DEFAULT_STOREFRONT_REFRESH_TIMEOUT_MS) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    if (!adapter.getStorefront)
+                        return;
+                    const platform = adapter.id;
+                    // Start the fetch; handle result + errors independently of the race.
+                    const fetch = adapter.getStorefront()
+                        .then(code => { if (code)
+                        this.setValue(platform, code); })
+                        .catch(() => { });
+                    let timerId;
+                    const timeout = new Promise((_, reject) => {
+                        timerId = setTimeout(() => reject(new Error('storefront refresh timeout')), timeoutMs);
+                    });
+                    try {
+                        yield Promise.race([fetch, timeout]);
+                    }
+                    finally {
+                        clearTimeout(timerId);
+                    }
+                });
+            }
+            /**
+             * Retrieve a storefront value.
+             *
+             * - With a platform: always returns `{ platform, countryCode }`,
+             *   where `countryCode` may be undefined if nothing is cached.
+             * - Without a platform: returns the first cached non-empty
+             *   storefront, or `undefined` if nothing is cached.
+             */
+            getValueFor(platform) {
+                if (platform) {
+                    return { platform, countryCode: this.values[platform] };
+                }
+                for (const p of Object.keys(this.values)) {
+                    if (this.values[p]) {
+                        return { platform: p, countryCode: this.values[p] };
+                    }
+                }
+                return undefined;
+            }
+            /** Register a change listener. */
+            listen(cb, callbackName) {
+                this.callbacks.push(cb, callbackName);
+            }
+            /** Remove a previously registered listener. */
+            off(cb) {
+                this.callbacks.remove(cb);
+            }
+            /** Update the cache and notify listeners on change. */
+            setValue(platform, countryCode) {
+                if (this.values[platform] === countryCode)
+                    return;
+                this.values[platform] = countryCode;
+                this.callbacks.trigger({ platform, countryCode }, 'storefront_changed');
+            }
+        }
+        Internal.Storefronts = Storefronts;
+    })(CdvPurchase.Internal || (CdvPurchase.Internal = {}));
+})(CdvPurchase || (CdvPurchase = {}));
+var CdvPurchase;
 (function (CdvPurchase) {
     (function (Internal) {
         /**
@@ -1426,6 +1520,7 @@ var CdvPurchase;
 /// <reference path="validator/validator.ts" />
 /// <reference path="log.ts" />
 /// <reference path="internal/adapters.ts" />
+/// <reference path="internal/storefronts.ts" />
 /// <reference path="internal/adapter-listener.ts" />
 /// <reference path="internal/callbacks.ts" />
 /// <reference path="internal/ready.ts" />
@@ -1466,7 +1561,7 @@ var CdvPurchase;
     /**
      * Current release number of the plugin.
      */
-    CdvPurchase.PLUGIN_VERSION = '13.14.0';
+    CdvPurchase.PLUGIN_VERSION = '13.15.0';
     /**
      * Entry class of the plugin.
      */
@@ -1524,6 +1619,8 @@ var CdvPurchase;
             this.receiptsVerifiedCallbacks = new CdvPurchase.Internal.Callbacks(this.log, 'receiptsVerified()', true);
             /** Callbacks for errors */
             this.errorCallbacks = new CdvPurchase.Internal.Callbacks(this.log, 'error()');
+            /** Per-platform storefront cache and change notifications. */
+            this._storefronts = new CdvPurchase.Internal.Storefronts(this.log.child('Storefronts'));
             this.initializedHasBeenCalled = false;
             /** Stores the last time the store was updated (or initialized), to skip calls in quick succession. */
             this.lastUpdate = 0;
@@ -1667,6 +1764,7 @@ var CdvPurchase;
                     get listener() { return store.listener; },
                     get log() { return store.log; },
                     get registeredProducts() { return store.registeredProducts; },
+                    get storefronts() { return store._storefronts; },
                     apiDecorators: {
                         canPurchase: this.canPurchase.bind(this),
                         owned: this.owned.bind(this),
@@ -1692,7 +1790,6 @@ var CdvPurchase;
          * Call to refresh the price of products and status of purchases.
          */
         update() {
-            var _a;
             return __awaiter(this, void 0, void 0, function* () {
                 this.log.info('update()');
                 if (!this._readyCallbacks.isReady) {
@@ -1707,11 +1804,15 @@ var CdvPurchase;
                 this.lastUpdate = now;
                 // Load products metadata
                 for (const registration of this.registeredProducts.byPlatform()) {
-                    const products = yield ((_a = this.adapters.findReady(registration.platform)) === null || _a === void 0 ? void 0 : _a.loadProducts(registration.products));
+                    const adapter = this.adapters.findReady(registration.platform);
+                    const products = yield (adapter === null || adapter === void 0 ? void 0 : adapter.loadProducts(registration.products));
                     products === null || products === void 0 ? void 0 : products.forEach(p => {
                         if (p instanceof CdvPurchase.Product)
                             this.updatedCallbacks.trigger(p, 'update_has_loaded_products');
                     });
+                    if (adapter) {
+                        this._storefronts.refreshWith(adapter).catch(() => { });
+                    }
                 }
             });
         }
@@ -1763,6 +1864,7 @@ var CdvPurchase;
                 unverified: (cb, callbackName) => (this.unverifiedCallbacks.push(cb, callbackName), ret),
                 receiptsReady: (cb, callbackName) => (this.receiptsReadyCallbacks.push(cb, callbackName), ret),
                 receiptsVerified: (cb, callbackName) => (this.receiptsVerifiedCallbacks.push(cb, callbackName), ret),
+                storefrontUpdated: (cb, callbackName) => (this._storefronts.listen(cb, callbackName), ret),
             };
             return ret;
         }
@@ -1781,6 +1883,7 @@ var CdvPurchase;
             this.receiptsVerifiedCallbacks.remove(callback);
             this.errorCallbacks.remove(callback);
             this._readyCallbacks.remove(callback);
+            this._storefronts.off(callback);
         }
         /**
          * Setup a function to be notified of changes to a transaction state.
@@ -1896,6 +1999,8 @@ var CdvPurchase;
                 const ret = yield adapter.order(offer, additionalData || {});
                 if (ret && 'isError' in ret)
                     CdvPurchase.store.triggerError(ret);
+                // Account may have switched during checkout — refresh storefront in the background.
+                this._storefronts.refreshWith(adapter).catch(() => { });
                 return ret;
             });
         }
@@ -1952,6 +2057,7 @@ var CdvPurchase;
             }
             const promise = new CdvPurchase.PaymentRequestPromise();
             adapter.requestPayment(paymentRequest, additionalData).then(result => {
+                this._storefronts.refreshWith(adapter).catch(() => { });
                 promise.trigger(result);
                 if (result instanceof CdvPurchase.Transaction) {
                     const onStateChange = (state) => {
@@ -2052,6 +2158,8 @@ var CdvPurchase;
                 for (const adapter of this.adapters.list) {
                     if (adapter.ready) {
                         error = error !== null && error !== void 0 ? error : yield adapter.restorePurchases();
+                        // Restore often implies a login or account switch — refresh storefront.
+                        this._storefronts.refreshWith(adapter).catch(() => { });
                     }
                 }
                 return error;
@@ -2095,6 +2203,43 @@ var CdvPurchase;
                 return adapter.manageBilling();
             });
         }
+        /**
+         * Retrieve the billing country code from the platform's storefront.
+         *
+         * Returns a `Storefront` object with the platform and its ISO 3166-1
+         * alpha-2 country code (e.g., "US", "FR"). The country code may be
+         * undefined if the underlying fetch has not yet completed or failed —
+         * the platform is still reported. Returns `undefined` only when no
+         * matching adapter is ready.
+         *
+         * The cache is populated before the `storeReady` event fires (with a
+         * best-effort timeout), and refreshed after orders and `restorePurchases()`.
+         *
+         * @param platform - Optional platform. If omitted, returns the first
+         *                   cached non-empty storefront, or a `{ platform, countryCode: undefined }`
+         *                   object for the first ready adapter.
+         *
+         * @example
+         * const storefront = store.getStorefront();
+         * if (storefront?.countryCode) {
+         *     console.log(`Billing country: ${storefront.countryCode}`);
+         * }
+         */
+        getStorefront(platform) {
+            if (platform) {
+                const adapter = this.adapters.findReady(platform);
+                if (!adapter)
+                    return undefined;
+                return this._storefronts.getValueFor(platform);
+            }
+            const cached = this._storefronts.getValueFor();
+            if (cached)
+                return cached;
+            const firstReady = this.adapters.findReady();
+            if (!firstReady)
+                return undefined;
+            return { platform: firstReady.id, countryCode: undefined };
+        }
         /**
          * The default payment platform to use depending on the OS.
          *
@@ -2955,14 +3100,15 @@ var CdvPurchase;
                         ready: () => {
                             this.log.info('ready');
                         },
-                        purchased: (transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation) => __awaiter(this, void 0, void 0, function* () {
+                        purchased: (transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity) => __awaiter(this, void 0, void 0, function* () {
                             this.log.info('purchase: id:' + transactionIdentifier + ' product:' + productId +
                                 ' originalTransaction:' + originalTransactionIdentifier +
                                 ' - date:' + transactionDate + ' - discount:' + discountId +
-                                (jwsRepresentation ? ' - jws:present' : ''));
+                                (jwsRepresentation ? ' - jws:present' : '') +
+                                (quantity && quantity > 1 ? ' - quantity:' + quantity : ''));
                             // we can add the transaction to the receipt here
                             const transaction = yield this.upsertTransaction(productId, transactionIdentifier, CdvPurchase.TransactionState.APPROVED);
-                            transaction.refresh(productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation);
+                            transaction.refresh(productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity);
                             this.removeTransactionInProgress(productId);
                             this.receiptsUpdated.call();
                             this.callPaymentMonitor('purchased');
@@ -2977,12 +3123,7 @@ var CdvPurchase;
                             this.log.info('purchaseFailed: ' + productId + ' - ' + code + ' - ' + message);
                             this.removeTransactionInProgress(productId);
                             this.context.listener.receiptsUpdated(CdvPurchase.Platform.APPLE_APPSTORE, [this.pseudoReceipt]);
-                            if (code === CdvPurchase.ErrorCode.PAYMENT_CANCELLED) {
-                                this.callPaymentMonitor('cancelled', code, message);
-                            }
-                            else {
-                                this.callPaymentMonitor('failed', code, message);
-                            }
+                            this.callPaymentMonitor('failed', code, message);
                         },
                         purchasing: (productId) => __awaiter(this, void 0, void 0, function* () {
                             // purchase has been requested, but there's no transactionIdentifier yet.
@@ -3018,10 +3159,10 @@ var CdvPurchase;
                             yield this.upsertTransaction(productId, transactionIdentifier, CdvPurchase.TransactionState.FINISHED);
                             this.receiptsUpdated.call();
                         }),
-                        restored: (transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation) => __awaiter(this, void 0, void 0, function* () {
+                        restored: (transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity) => __awaiter(this, void 0, void 0, function* () {
                             this.log.info('restore: ' + transactionIdentifier + ' - ' + productId);
                             const transaction = yield this.upsertTransaction(productId, transactionIdentifier, CdvPurchase.TransactionState.APPROVED);
-                            transaction.refresh(productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation);
+                            transaction.refresh(productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity);
                             this.receiptsUpdated.call();
                         }),
                         receiptsRefreshed: (receipt) => {
@@ -3268,7 +3409,7 @@ var CdvPurchase;
                 return __awaiter(this, void 0, void 0, function* () {
                     let resolved = false;
                     return new Promise(resolve => {
-                        var _a;
+                        var _a, _b;
                         const callResolve = (result) => {
                             if (resolved)
                                 return;
@@ -3277,8 +3418,12 @@ var CdvPurchase;
                             resolve(result);
                         };
                         this.log.info('order');
+                        const quantity = (_a = additionalData === null || additionalData === void 0 ? void 0 : additionalData.quantity) !== null && _a !== void 0 ? _a : 1;
+                        if (quantity < 1 || quantity > 10 || !Number.isInteger(quantity)) {
+                            return callResolve(appStoreError(CdvPurchase.ErrorCode.PURCHASE, 'Invalid quantity: must be an integer between 1 and 10', offer.productId));
+                        }
                         const discountId = offer.id !== AppleAppStore.DEFAULT_OFFER_ID ? offer.id : undefined;
-                        const discount = (_a = additionalData === null || additionalData === void 0 ? void 0 : additionalData.appStore) === null || _a === void 0 ? void 0 : _a.discount;
+                        const discount = (_b = additionalData === null || additionalData === void 0 ? void 0 : additionalData.appStore) === null || _b === void 0 ? void 0 : _b.discount;
                         if (discountId && !discount) {
                             return callResolve(appStoreError(CdvPurchase.ErrorCode.MISSING_OFFER_PARAMS, 'Missing additionalData.appStore.discount when ordering a discount offer', offer.productId));
                         }
@@ -3317,7 +3462,7 @@ var CdvPurchase;
                         // When we switch AppStore user, the cached receipt isn't from the new user.
                         // so after a purchase, we want to make sure we're using the receipt from the logged in user.
                         this.forceReceiptReload = true;
-                        this.bridge.purchase(offer.productId, 1, this.context.getApplicationUsername(), discount, success, error);
+                        this.bridge.purchase(offer.productId, quantity, this.context.getApplicationUsername(), discount, success, error);
                     });
                 });
             }
@@ -3467,7 +3612,7 @@ var CdvPurchase;
                 if (functionality === 'order')
                     return this._canMakePayments;
                 const supported = [
-                    'order', 'manageBilling', 'manageSubscriptions'
+                    'order', 'orderQuantity', 'manageBilling', 'manageSubscriptions', 'getStorefront'
                 ];
                 return supported.indexOf(functionality) >= 0;
             }
@@ -3490,8 +3635,83 @@ var CdvPurchase;
                     this.bridge.presentCodeRedemptionSheet(resolve);
                 });
             }
+            getStorefront() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    if (!this.bridge.getStorefront)
+                        return undefined;
+                    const countryCode = yield this.bridge.getStorefront();
+                    if (!countryCode)
+                        return undefined;
+                    // SKStorefront.countryCode typically returns ISO 3166-1 alpha-3 (e.g., "USA").
+                    // The fallback `|| countryCode` handles cases where Apple returns alpha-2 directly
+                    // or uses a non-standard code (e.g., territories not in ISO 3166-1).
+                    return isoAlpha3ToAlpha2(countryCode) || countryCode;
+                });
+            }
         }
         AppleAppStore.Adapter = Adapter;
+        /**
+         * Convert ISO 3166-1 alpha-3 country code to alpha-2.
+         *
+         * Apple's SKStorefront.countryCode returns alpha-3 codes (e.g., "USA").
+         * This function converts them to the more common alpha-2 format (e.g., "US")
+         * for consistency with Google Play which already returns alpha-2.
+         */
+        const ISO_ALPHA3_TO_ALPHA2 = {
+            AFG: 'AF', ALB: 'AL', DZA: 'DZ', ASM: 'AS', AND: 'AD',
+            AGO: 'AO', AIA: 'AI', ATA: 'AQ', ATG: 'AG', ARG: 'AR',
+            ARM: 'AM', ABW: 'AW', AUS: 'AU', AUT: 'AT', AZE: 'AZ',
+            BHS: 'BS', BHR: 'BH', BGD: 'BD', BRB: 'BB', BLR: 'BY',
+            BEL: 'BE', BLZ: 'BZ', BEN: 'BJ', BMU: 'BM', BTN: 'BT',
+            BOL: 'BO', BES: 'BQ', BIH: 'BA', BWA: 'BW', BVT: 'BV',
+            BRA: 'BR', IOT: 'IO', BRN: 'BN', BGR: 'BG', BFA: 'BF',
+            BDI: 'BI', CPV: 'CV', KHM: 'KH', CMR: 'CM', CAN: 'CA',
+            CYM: 'KY', CAF: 'CF', TCD: 'TD', CHL: 'CL', CHN: 'CN',
+            CXR: 'CX', CCK: 'CC', COL: 'CO', COM: 'KM', COG: 'CG',
+            COD: 'CD', COK: 'CK', CRI: 'CR', CIV: 'CI', HRV: 'HR',
+            CUB: 'CU', CUW: 'CW', CYP: 'CY', CZE: 'CZ', DNK: 'DK',
+            DJI: 'DJ', DMA: 'DM', DOM: 'DO', ECU: 'EC', EGY: 'EG',
+            SLV: 'SV', GNQ: 'GQ', ERI: 'ER', EST: 'EE', SWZ: 'SZ',
+            ETH: 'ET', FLK: 'FK', FRO: 'FO', FJI: 'FJ', FIN: 'FI',
+            FRA: 'FR', GUF: 'GF', PYF: 'PF', ATF: 'TF', GAB: 'GA',
+            GMB: 'GM', GEO: 'GE', DEU: 'DE', GHA: 'GH', GIB: 'GI',
+            GRC: 'GR', GRL: 'GL', GRD: 'GD', GLP: 'GP', GUM: 'GU',
+            GTM: 'GT', GGY: 'GG', GIN: 'GN', GNB: 'GW', GUY: 'GY',
+            HTI: 'HT', HMD: 'HM', VAT: 'VA', HND: 'HN', HKG: 'HK',
+            HUN: 'HU', ISL: 'IS', IND: 'IN', IDN: 'ID', IRN: 'IR',
+            IRQ: 'IQ', IRL: 'IE', IMN: 'IM', ISR: 'IL', ITA: 'IT',
+            JAM: 'JM', JPN: 'JP', JEY: 'JE', JOR: 'JO', KAZ: 'KZ',
+            KEN: 'KE', KIR: 'KI', PRK: 'KP', KOR: 'KR', KWT: 'KW',
+            KGZ: 'KG', LAO: 'LA', LVA: 'LV', LBN: 'LB', LSO: 'LS',
+            LBR: 'LR', LBY: 'LY', LIE: 'LI', LTU: 'LT', LUX: 'LU',
+            MAC: 'MO', MDG: 'MG', MWI: 'MW', MYS: 'MY', MDV: 'MV',
+            MLI: 'ML', MLT: 'MT', MHL: 'MH', MTQ: 'MQ', MRT: 'MR',
+            MUS: 'MU', MYT: 'YT', MEX: 'MX', FSM: 'FM', MDA: 'MD',
+            MCO: 'MC', MNG: 'MN', MNE: 'ME', MSR: 'MS', MAR: 'MA',
+            MOZ: 'MZ', MMR: 'MM', NAM: 'NA', NRU: 'NR', NPL: 'NP',
+            NLD: 'NL', NCL: 'NC', NZL: 'NZ', NIC: 'NI', NER: 'NE',
+            NGA: 'NG', NIU: 'NU', NFK: 'NF', MKD: 'MK', MNP: 'MP',
+            NOR: 'NO', OMN: 'OM', PAK: 'PK', PLW: 'PW', PSE: 'PS',
+            PAN: 'PA', PNG: 'PG', PRY: 'PY', PER: 'PE', PHL: 'PH',
+            PCN: 'PN', POL: 'PL', PRT: 'PT', PRI: 'PR', QAT: 'QA',
+            REU: 'RE', ROU: 'RO', RUS: 'RU', RWA: 'RW', BLM: 'BL',
+            SHN: 'SH', KNA: 'KN', LCA: 'LC', MAF: 'MF', SPM: 'PM',
+            VCT: 'VC', WSM: 'WS', SMR: 'SM', STP: 'ST', SAU: 'SA',
+            SEN: 'SN', SRB: 'RS', SYC: 'SC', SLE: 'SL', SGP: 'SG',
+            SXM: 'SX', SVK: 'SK', SVN: 'SI', SLB: 'SB', SOM: 'SO',
+            ZAF: 'ZA', SGS: 'GS', SSD: 'SS', ESP: 'ES', LKA: 'LK',
+            SDN: 'SD', SUR: 'SR', SJM: 'SJ', SWE: 'SE', CHE: 'CH',
+            SYR: 'SY', TWN: 'TW', TJK: 'TJ', TZA: 'TZ', THA: 'TH',
+            TLS: 'TL', TGO: 'TG', TKL: 'TK', TON: 'TO', TTO: 'TT',
+            TUN: 'TN', TUR: 'TR', TKM: 'TM', TCA: 'TC', TUV: 'TV',
+            UGA: 'UG', UKR: 'UA', ARE: 'AE', GBR: 'GB', USA: 'US',
+            UMI: 'UM', URY: 'UY', UZB: 'UZ', VUT: 'VU', VEN: 'VE',
+            VNM: 'VN', VGB: 'VG', VIR: 'VI', WLF: 'WF', ESH: 'EH',
+            YEM: 'YE', ZMB: 'ZM', ZWE: 'ZW',
+        };
+        function isoAlpha3ToAlpha2(alpha3) {
+            return ISO_ALPHA3_TO_ALPHA2[alpha3.toUpperCase()];
+        }
         function appStoreError(code, message, productId) {
             return CdvPurchase.storeError(code, message, CdvPurchase.Platform.APPLE_APPSTORE, productId);
         }
@@ -3501,6 +3721,9 @@ var CdvPurchase;
 (function (CdvPurchase) {
     (function (AppleAppStore) {
         (function (CapacitorBridge) {
+            let log = function log(msg) {
+                console.log("StoreKit[capacitor]: " + msg);
+            };
             /**
              * Capacitor implementation of the Apple AppStore bridge.
              * Uses Capacitor.Plugins.PurchasePlugin with StoreKit 2 (iOS 15+).
@@ -3537,7 +3760,7 @@ var CdvPurchase;
                 }
                 init(options, success, error) {
                     if (options.log)
-                        options.log;
+                        log = options.log;
                     // Merge provided options over defaults (noop callbacks)
                     this.options = Object.assign(Object.assign({}, this.options), options);
                     const plugin = this.plugin;
@@ -3547,7 +3770,7 @@ var CdvPurchase;
                     }
                     // Listen for transaction updates from native
                     plugin.addListener('transactionUpdated', (data) => {
-                        this.transactionUpdated(data.state, data.errorCode, data.errorText, data.transactionIdentifier, data.productId, data.transactionReceipt, data.originalTransactionIdentifier, data.transactionDate, data.discountId, data.expirationDate, data.jwsRepresentation);
+                        this.transactionUpdated(data.state, data.errorCode, data.errorText, data.transactionIdentifier, data.productId, data.transactionReceipt, data.originalTransactionIdentifier, data.transactionDate, data.discountId, data.expirationDate, data.jwsRepresentation, data.quantity);
                     });
                     plugin.addListener('restoreCompleted', () => {
                         this.restoreCompletedTransactionsFinished();
@@ -3568,7 +3791,7 @@ var CdvPurchase;
                         const pending = this.pendingTransactionUpdates;
                         this.pendingTransactionUpdates = [];
                         for (const args of pending) {
-                            this.transactionUpdated(args.state, args.errorCode, args.errorText, args.transactionIdentifier, args.productId, args.transactionReceipt, args.originalTransactionIdentifier, args.transactionDate, args.discountId, args.expirationDate, args.jwsRepresentation);
+                            this.transactionUpdated(args.state, args.errorCode, args.errorText, args.transactionIdentifier, args.productId, args.transactionReceipt, args.originalTransactionIdentifier, args.transactionDate, args.discountId, args.expirationDate, args.jwsRepresentation, args.quantity);
                         }
                         if (this.options.ready)
                             this.options.ready();
@@ -3652,12 +3875,13 @@ var CdvPurchase;
                         .catch((err) => errorCb(CdvPurchase.ErrorCode.LOAD, (err === null || err === void 0 ? void 0 : err.message) || 'loadReceipts failed'));
                 }
                 // Called when the native side sends a transaction update
-                transactionUpdated(state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation) {
+                transactionUpdated(state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity) {
                     if (!this.initialized) {
                         this.pendingTransactionUpdates.push({
                             state, errorCode, errorText, transactionIdentifier,
                             productId, transactionReceipt, originalTransactionIdentifier,
                             transactionDate, discountId, expirationDate, jwsRepresentation,
+                            quantity,
                         });
                         return;
                     }
@@ -3677,7 +3901,7 @@ var CdvPurchase;
                             break;
                         case 'PaymentTransactionStatePurchased':
                             if (this.options.purchased) {
-                                this.options.purchased(transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation);
+                                this.options.purchased(transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity);
                             }
                             break;
                         case 'PaymentTransactionStateFailed':
@@ -3689,8 +3913,11 @@ var CdvPurchase;
                             }
                             break;
                         case 'PaymentTransactionStateRestored':
+                            // quantity is passed through for positional consistency with
+                            // purchased, but is meaningless here: consumables cannot be
+                            // restored, so restored transactions are always quantity 1.
                             if (this.options.restored) {
-                                this.options.restored(transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation);
+                                this.options.restored(transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity);
                             }
                             break;
                         case 'PaymentTransactionStateDeferred':
@@ -3718,6 +3945,23 @@ var CdvPurchase;
                         this.options.restoreFailed(errorCode);
                     }
                 }
+                /** Retrieve the storefront country code from StoreKit */
+                getStorefront() {
+                    return new Promise((resolve) => {
+                        const plugin = this.plugin;
+                        if (!plugin) {
+                            log('getStorefront failed: plugin not available');
+                            resolve(undefined);
+                            return;
+                        }
+                        plugin.getStorefront()
+                            .then((result) => resolve(result.countryCode || undefined))
+                            .catch((err) => {
+                            log('getStorefront failed: ' + ((err === null || err === void 0 ? void 0 : err.message) || err));
+                            resolve(undefined);
+                        });
+                    });
+                }
             }
             CapacitorBridge.CapacitorNativeBridge = CapacitorNativeBridge;
         })(AppleAppStore.CapacitorBridge || (AppleAppStore.CapacitorBridge = {}));
@@ -3887,7 +4131,7 @@ var CdvPurchase;
                 finalizeTransactionUpdates() {
                     for (let i = 0; i < this.pendingUpdates.length; ++i) {
                         const args = this.pendingUpdates[i];
-                        this.transactionUpdated(args.state, args.errorCode, args.errorText, args.transactionIdentifier, args.productId, args.transactionReceipt, args.originalTransactionIdentifier, args.transactionDate, args.discountId, args.expirationDate, args.jwsRepresentation);
+                        this.transactionUpdated(args.state, args.errorCode, args.errorText, args.transactionIdentifier, args.productId, args.transactionReceipt, args.originalTransactionIdentifier, args.transactionDate, args.discountId, args.expirationDate, args.jwsRepresentation, args.quantity);
                     }
                     this.pendingUpdates = [];
                 }
@@ -3895,12 +4139,13 @@ var CdvPurchase;
                     // no more pending transactions
                 }
                 /** Called from native. Same as SK1 but with extra SK2 fields. */
-                transactionUpdated(state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation) {
+                transactionUpdated(state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity) {
                     if (!this.initialized) {
                         this.pendingUpdates.push({
                             state, errorCode, errorText, transactionIdentifier,
                             productId, transactionReceipt, originalTransactionIdentifier,
-                            transactionDate, discountId, expirationDate, jwsRepresentation
+                            transactionDate, discountId, expirationDate, jwsRepresentation,
+                            quantity
                         });
                         return;
                     }
@@ -3919,7 +4164,7 @@ var CdvPurchase;
                             protectCall(this.options.purchasing, 'options.purchasing', productId);
                             return;
                         case "PaymentTransactionStatePurchased":
-                            protectCall(this.options.purchased, 'options.purchased', transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation);
+                            protectCall(this.options.purchased, 'options.purchased', transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity);
                             return;
                         case "PaymentTransactionStateDeferred":
                             protectCall(this.options.deferred, 'options.deferred', productId);
@@ -3929,7 +4174,10 @@ var CdvPurchase;
                             protectCall(this.options.error, 'options.error', errorCode || CdvPurchase.ErrorCode.UNKNOWN, errorText || 'ERROR', { productId });
                             return;
                         case "PaymentTransactionStateRestored":
-                            protectCall(this.options.restored, 'options.restored', transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation);
+                            // Note: quantity is always irrelevant for restored transactions on iOS —
+                            // consumable products cannot be restored. Passed through to maintain
+                            // positional argument consistency with the purchased callback.
+                            protectCall(this.options.restored, 'options.restored', transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, expirationDate, jwsRepresentation, quantity);
                             return;
                         case "PaymentTransactionStateFinished":
                             protectCall(this.options.finished, 'options.finished', transactionIdentifier, productId);
@@ -3971,6 +4219,18 @@ var CdvPurchase;
                     this.appStoreReceipt = null;
                     exec('appStoreRefreshReceipt', [], loaded, error);
                 }
+                /** Retrieve the storefront country code from StoreKit */
+                getStorefront() {
+                    return new Promise((resolve) => {
+                        // SK2 uses the same native getStorefront action via InAppPurchase plugin
+                        window.cordova.exec((countryCode) => {
+                            resolve(countryCode || undefined);
+                        }, (err) => {
+                            log('getStorefront failed: ' + err);
+                            resolve(undefined);
+                        }, "InAppPurchase", "getStorefront", []);
+                    });
+                }
                 loadReceipts(callback, errorCb) {
                     const loaded = (args) => {
                         const data = this.parseReceiptArgs(args);
@@ -4257,7 +4517,7 @@ var CdvPurchase;
                 finalizeTransactionUpdates() {
                     for (let i = 0; i < this.pendingUpdates.length; ++i) {
                         const args = this.pendingUpdates[i];
-                        this.transactionUpdated(args.state, args.errorCode, args.errorText, args.transactionIdentifier, args.productId, args.transactionReceipt, args.originalTransactionIdentifier, args.transactionDate, args.discountId);
+                        this.transactionUpdated(args.state, args.errorCode, args.errorText, args.transactionIdentifier, args.productId, args.transactionReceipt, args.originalTransactionIdentifier, args.transactionDate, args.discountId, args.quantity);
                     }
                     this.pendingUpdates = [];
                 }
@@ -4268,9 +4528,9 @@ var CdvPurchase;
                 //
                 // Note that it may eventually be called before initialization... unfortunately.
                 // In this case, we'll just keep pending updates in a list for later processing.
-                transactionUpdated(state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId) {
+                transactionUpdated(state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId, quantity) {
                     if (!this.initialized) {
-                        this.pendingUpdates.push({ state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId });
+                        this.pendingUpdates.push({ state, errorCode, errorText, transactionIdentifier, productId, transactionReceipt, originalTransactionIdentifier, transactionDate, discountId, quantity });
                         return;
                     }
                     log("transaction updated:" + transactionIdentifier + " state:" + state + " product:" + productId);
@@ -4287,7 +4547,7 @@ var CdvPurchase;
                             protectCall(this.options.purchasing, 'options.purchasing', productId);
                             return;
                         case "PaymentTransactionStatePurchased":
-                            protectCall(this.options.purchased, 'options.purchase', transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId);
+                            protectCall(this.options.purchased, 'options.purchase', transactionIdentifier, productId, originalTransactionIdentifier, transactionDate, discountId, undefined, undefined, quantity);
                             return;
                         case "PaymentTransactionStateDeferred":
                             protectCall(this.options.deferred, 'options.deferred', productId);
@@ -4297,7 +4557,10 @@ var CdvPurchase;
                             protectCall(this.options.error, 'options.error', errorCode || CdvPurchase.ErrorCode.UNKNOWN, errorText || 'ERROR', { productId });
                             return;
                         case "PaymentTransactionStateRestored":
-                            protectCall(this.options.restored, 'options.restore', transactionIdentifier, productId);
+                            // Note: quantity is always irrelevant for restored transactions on iOS —
+                            // consumable products cannot be restored. Passed through to maintain
+                            // positional argument consistency with the purchased callback.
+                            protectCall(this.options.restored, 'options.restore', transactionIdentifier, productId, undefined, undefined, undefined, undefined, undefined, quantity);
                             return;
                         case "PaymentTransactionStateFinished":
                             protectCall(this.options.finished, 'options.finish', transactionIdentifier, productId);
@@ -4350,6 +4613,17 @@ var CdvPurchase;
                     log('refreshing appStoreReceipt');
                     exec('appStoreRefreshReceipt', [], loaded, error);
                 }
+                /** Retrieve the storefront country code from StoreKit */
+                getStorefront() {
+                    return new Promise((resolve) => {
+                        exec('getStorefront', [], (countryCode) => {
+                            resolve(countryCode || undefined);
+                        }, (err) => {
+                            log('getStorefront failed: ' + err);
+                            resolve(undefined);
+                        });
+                    });
+                }
                 loadReceipts(callback, errorCb) {
                     const loaded = (args) => {
                         const data = this.parseReceiptArgs(args);
@@ -4539,7 +4813,7 @@ var CdvPurchase;
         AppleAppStore.SKApplicationReceipt = SKApplicationReceipt;
         /** StoreKit transaction */
         class SKTransaction extends CdvPurchase.Transaction {
-            refresh(productId, originalTransactionIdentifier, transactionDate, discountId, expirationDateMs, jwsRepresentation) {
+            refresh(productId, originalTransactionIdentifier, transactionDate, discountId, expirationDateMs, jwsRepresentation, quantity) {
                 if (productId)
                     this.products = [{ id: productId, offerId: discountId }];
                 if (originalTransactionIdentifier)
@@ -4550,6 +4824,8 @@ var CdvPurchase;
                     this.expirationDate = new Date(+expirationDateMs);
                 if (jwsRepresentation)
                     this.jwsRepresentation = jwsRepresentation;
+                if (quantity !== undefined)
+                    this.quantity = quantity;
             }
         }
         AppleAppStore.SKTransaction = SKTransaction;
@@ -5880,9 +6156,21 @@ var CdvPurchase;
                     return;
                 });
             }
+            getStorefront() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    return new Promise((resolve) => {
+                        this.bridge.getStorefront((countryCode) => {
+                            resolve(countryCode || undefined);
+                        }, (message) => {
+                            this.log.warn('getStorefront failed: ' + message);
+                            resolve(undefined);
+                        });
+                    });
+                });
+            }
             checkSupport(functionality) {
                 const supported = [
-                    'order', 'manageBilling', 'manageSubscriptions'
+                    'order', 'manageBilling', 'manageSubscriptions', 'getStorefront'
                 ];
                 return supported.indexOf(functionality) >= 0;
             }
@@ -6051,6 +6339,14 @@ var CdvPurchase;
                 launchPriceChangeConfirmationFlow(productId) {
                     this.plugin.launchPriceChangeConfirmationFlow({ productId });
                 }
+                getStorefront(success, fail) {
+                    if (this.options.showLog) {
+                        log('getStorefront()');
+                    }
+                    this.plugin.getStorefront()
+                        .then((result) => success(result.countryCode))
+                        .catch((err) => fail((err === null || err === void 0 ? void 0 : err.message) || 'getStorefront failed', err === null || err === void 0 ? void 0 : err.code));
+                }
             }
             Bridge.CapacitorBridge = CapacitorBridge;
             function ensureObject(obj) {
@@ -6242,6 +6538,12 @@ var CdvPurchase;
                 manageBilling() {
                     return window.cordova.exec(function () { }, function () { }, "InAppBillingPlugin", "manageBilling", []);
                 }
+                getStorefront(success, fail) {
+                    if (this.options.showLog) {
+                        log('getStorefront()');
+                    }
+                    return window.cordova.exec(success, errorCb(fail), "InAppBillingPlugin", "getStorefront", []);
+                }
                 launchPriceChangeConfirmationFlow(productId) {
                     return window.cordova.exec(function () { }, function () { }, "InAppBillingPlugin", "launchPriceChangeConfirmationFlow", [productId]);
                 }
@@ -7503,6 +7805,11 @@ var CdvPurchase;
                     return undefined;
                 });
             }
+            getStorefront() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    return 'US';
+                });
+            }
         }
         Test.Adapter = Adapter;
         function testStoreError(code, message, productId) {