@salla.sa/twilight-components 3.0.18 → 3.0.20

package/dist/collection/components/salla-wishlist-actions/salla-wishlist-actions.js

@@ -325,7 +325,7 @@ export class SallaWishlistActions {
         }
     }
     render() {
-        return (h(Host, { key: '6329ecd00f2d08cd0fc485c371e98fe7984502d0' }, h("div", { key: '6e24cd1109ae290196337fe3e1e05cfd074966a9', class: "s-wishlist-actions" }, h("div", { key: '82c29d5b203368059c7883272c36576b19bdfd2d', class: "s-wishlist-actions-bar flex items-center justify-end gap-3 mb-3" }, h("div", { key: '3f85ad6a6e72308b71d506d2fc8687672b00ea7a', class: "s-wishlist-actions-dropdown relative" }, h("salla-button", { key: '56c109a338bc9fa06aebdadb041b6587440fa71a', color: "primary", fill: "outline", type: "button", disabled: !this.hasProducts, "aria-haspopup": "true", "aria-expanded": this.menuOpen ? 'true' : 'false', onClick: () => this.toggleMenu() }, h("div", { key: 'f0cf0dc66dd8ce00ac878481bbf21662d1853eba', class: "flex flex-row justify-center items-center gap-2" }, h("svg", { key: '3b97ef84df832a0bc1198319cc63b753da915b37', version: "1.1", xmlns: "http://www.w3.org/2000/svg", width: "16", height: "16", viewBox: "0 0 32 32", style: { width: '16px', height: '16px' } }, h("path", { key: 'e8c626812dad32a5fc3165b58ce76a5c39586f09', d: "M26.667 21.333c-1.699 0-3.196 0.812-4.173 2.052l-11.912-5.211c0.044-0.276 0.085-0.553 0.085-0.841 0-0.472-0.081-0.923-0.197-1.359l12.361-6.952c0.971 1.009 2.328 1.644 3.836 1.644 2.941 0 5.333-2.392 5.333-5.333s-2.392-5.333-5.333-5.333-5.333 2.392-5.333 5.333c0 0.472 0.081 0.923 0.197 1.359l-12.361 6.952c-0.971-1.009-2.328-1.644-3.836-1.644-2.941 0-5.333 2.392-5.333 5.333s2.392 5.333 5.333 5.333c1.699 0 3.196-0.812 4.173-2.052l11.912 5.211c-0.044 0.276-0.085 0.553-0.085 0.841 0 2.941 2.392 5.333 5.333 5.333s5.333-2.392 5.333-5.333-2.392-5.333-5.333-5.333zM26.667 2.667c1.471 0 2.667 1.196 2.667 2.667s-1.196 2.667-2.667 2.667-2.667-1.196-2.667-2.667 1.196-2.667 2.667-2.667zM5.333 20c-1.471 0-2.667-1.196-2.667-2.667s1.196-2.667 2.667-2.667 2.667 1.196 2.667 2.667-1.196 2.667-2.667 2.667zM26.667 29.333c-1.471 0-2.667-1.196-2.667-2.667s1.196-2.667 2.667-2.667 2.667 1.196 2.667 2.667-1.196 2.667-2.667 2.667z" })), this.shareLabel, h("svg", { key: '731093a2d4393fe53d63e96ecc48fcb4c4a360d2', version: "1.1", xmlns: "http://www.w3.org/2000/svg", width: "16", height: "16", viewBox: "0 0 32 32", style: { width: '16px', height: '16px' } }, h("path", { key: 'af87c9481389b4b1e544e0ab2eac43db6c164aac', d: "M26.212 10.996c-0.556-0.484-1.396-0.428-1.881 0.127l-8.331 9.519-8.331-9.52c-0.485-0.555-1.327-0.611-1.881-0.125s-0.609 1.328-0.124 1.881l9.333 10.667c0.253 0.291 0.617 0.456 1.003 0.456s0.749-0.165 1.003-0.456l9.333-10.667c0.485-0.553 0.429-1.396-0.124-1.881z" })))), this.menuOpen && (h("ul", { key: '62ce5ade389fb563d2548fd94939f697dbc03d8a', class: "s-wishlist-actions-menu absolute z-20 mt-1 bg-white rounded-lg shadow overflow-hidden" }, h("li", { key: '7cb443687290ce4c7144b71140b68c020bb52dd4' }, h("button", { key: 'd55410bb2f164d267a9c21af2648fbef3fdc1928', type: "button", class: "s-wishlist-actions-menu-item", onClick: () => this.shareAll() }, this.shareAllLabel)), h("li", { key: 'f921f5241b0e7b7ebb228049f84dfe3996081d92' }, h("button", { key: 'dbc903542086266571c21ada73d54dab62f5a3e2', type: "button", class: "s-wishlist-actions-menu-item", onClick: () => this.shareSpecific() }, this.shareSpecificLabel))))), h("salla-social-share", { key: '0e3aec575c1b4aa4cdd5bb2c61f3cc3e90687f23', class: "s-wishlist-actions-social", ref: el => (this.socialShare = el), url: this.shareUrl, mode: "modal", modalTitle: this.shareModalTitle }, h("span", { key: 'bafce0670b980b583398b3d1a997020298e35bed', slot: "widget", class: "s-wishlist-actions-social-anchor", "aria-hidden": "true" }))), this.specificMode && (h("div", { key: '216cd3409541b0f93b26e2f2bfe256a36d0ff37b', class: "s-wishlist-actions-panel flex items-center justify-between gap-4 flex-wrap p-4 mt-3 mb-3 bg-white rounded-lg" }, h("label", { key: '4bf9a1cc508bfc87c229f69a7134bdefae0f9535', class: "s-wishlist-actions-panel-select-all flex items-center gap-2 cursor-pointer" }, h("input", { key: 'fbc39c6513eec5f4b1f281046b509c642ddce3db', type: "checkbox", class: "s-products-list-select-checkbox s-wishlist-actions-select-all", checked: this.isAllSelected, ref: el => (this.selectAllCheckbox = el), "aria-label": this.selectAllLabel, onChange: () => this.toggleSelectAll() }), h("span", { key: '02ba3b818ecb802d8976734738c8042163b6cdae', class: "s-wishlist-actions-panel-title text-sm font-bold text-gray-700" }, this.shareSpecificLabel, " (", this.selectedCount, ")")), h("div", { key: '447df46aa76c1ecb165b7680465ff6c6dfcc967d', class: "s-wishlist-actions-panel-buttons flex items-center gap-2" }, h("salla-button", { key: '36a6360b83dd07d20ca7763e2f12dc93f169c645', class: "s-wishlist-actions-cancel", color: "light", fill: "outline", type: "button", onClick: () => this.cancelSpecific() }, this.cancelLabel), h("salla-button", { key: '3aa46bcd91bf605f7715fcaa5692e4ca0e8f199e', class: "s-wishlist-actions-share", color: "primary", fill: "outline", type: "button", disabled: !this.selectedCount, loading: this.isSharing, onClick: () => this.shareSelected() }, this.shareLabel)))))));
+        return (h(Host, { key: 'ed2bb2b4e6db13b5dc2a8ceb47d0abb4b91da7ea' }, h("div", { key: '9a368503611af6ccce78d35b76ec17bd3ddd296b', class: "s-wishlist-actions" }, h("div", { key: 'a9dc9b280bd46673892d6c72ffc535eb443beb0f', class: "s-wishlist-actions-bar flex items-center justify-end gap-3 mb-3" }, h("div", { key: '90d6ea21a46becdeffca1a9b722a3a20eb3ed341', class: "s-wishlist-actions-dropdown relative" }, h("salla-button", { key: '9edc9eeea5282fc61d48fce5b29ed095793265cf', color: "primary", fill: "outline", type: "button", disabled: !this.hasProducts, "aria-haspopup": "true", "aria-expanded": this.menuOpen ? 'true' : 'false', onClick: () => this.toggleMenu() }, h("div", { key: 'a5a30a3676d304614ec2e8b14172694d00f2e28c', class: "flex flex-row justify-center items-center gap-2" }, h("svg", { key: '6842723fa0aa1f12fba6b91ddc6095a1e8da20af', version: "1.1", xmlns: "http://www.w3.org/2000/svg", width: "16", height: "16", viewBox: "0 0 32 32", style: { width: '16px', height: '16px' } }, h("path", { key: 'c7aa82770d3ce0a04240ee4ab44b8a4f0cf2d8b3', d: "M26.667 21.333c-1.699 0-3.196 0.812-4.173 2.052l-11.912-5.211c0.044-0.276 0.085-0.553 0.085-0.841 0-0.472-0.081-0.923-0.197-1.359l12.361-6.952c0.971 1.009 2.328 1.644 3.836 1.644 2.941 0 5.333-2.392 5.333-5.333s-2.392-5.333-5.333-5.333-5.333 2.392-5.333 5.333c0 0.472 0.081 0.923 0.197 1.359l-12.361 6.952c-0.971-1.009-2.328-1.644-3.836-1.644-2.941 0-5.333 2.392-5.333 5.333s2.392 5.333 5.333 5.333c1.699 0 3.196-0.812 4.173-2.052l11.912 5.211c-0.044 0.276-0.085 0.553-0.085 0.841 0 2.941 2.392 5.333 5.333 5.333s5.333-2.392 5.333-5.333-2.392-5.333-5.333-5.333zM26.667 2.667c1.471 0 2.667 1.196 2.667 2.667s-1.196 2.667-2.667 2.667-2.667-1.196-2.667-2.667 1.196-2.667 2.667-2.667zM5.333 20c-1.471 0-2.667-1.196-2.667-2.667s1.196-2.667 2.667-2.667 2.667 1.196 2.667 2.667-1.196 2.667-2.667 2.667zM26.667 29.333c-1.471 0-2.667-1.196-2.667-2.667s1.196-2.667 2.667-2.667 2.667 1.196 2.667 2.667-1.196 2.667-2.667 2.667z" })), this.shareLabel, h("svg", { key: '08c44a8306ba2b183aa0549fac2da24c64f3b285', version: "1.1", xmlns: "http://www.w3.org/2000/svg", width: "16", height: "16", viewBox: "0 0 32 32", style: { width: '16px', height: '16px' } }, h("path", { key: '216163cc1b84ceb0b9035c23ef002b80c69ab9bf', d: "M26.212 10.996c-0.556-0.484-1.396-0.428-1.881 0.127l-8.331 9.519-8.331-9.52c-0.485-0.555-1.327-0.611-1.881-0.125s-0.609 1.328-0.124 1.881l9.333 10.667c0.253 0.291 0.617 0.456 1.003 0.456s0.749-0.165 1.003-0.456l9.333-10.667c0.485-0.553 0.429-1.396-0.124-1.881z" })))), this.menuOpen && (h("ul", { key: '57f73a8af50dc9280efde259d639bf3d41434fed', class: "s-wishlist-actions-menu absolute z-20 mt-1 bg-white rounded-lg shadow overflow-hidden" }, h("li", { key: 'd3b5fc449eef1b2af914dcae0dea0b67af599b84' }, h("button", { key: 'e3689eb4db62ff5ee42122819faa28500c555479', type: "button", class: "s-wishlist-actions-menu-item", onClick: () => this.shareAll() }, this.shareAllLabel)), h("li", { key: 'ad40221d90b2ca52ad9544e8d19324ef8af812c4' }, h("button", { key: '9fde093db8640855d4871972b02e3282e9aed6ad', type: "button", class: "s-wishlist-actions-menu-item", onClick: () => this.shareSpecific() }, this.shareSpecificLabel))))), h("salla-social-share", { key: '91287b112e76c9039170ebe54fcbfe7bfcb2dfb1', class: "s-wishlist-actions-social", ref: el => (this.socialShare = el), url: this.shareUrl, mode: "modal", modalTitle: this.shareModalTitle }, h("span", { key: 'e97a4249a046a17d65f214e5c2ecbca2ff21358c', slot: "widget", class: "s-wishlist-actions-social-anchor", "aria-hidden": "true" }))), this.specificMode && (h("div", { key: '50ba30cc24e590986b6031a373f9334e3d8c97a7', class: "s-wishlist-actions-panel flex items-center justify-between gap-4 flex-wrap p-4 mt-3 mb-3 bg-white rounded-lg" }, h("label", { key: '5dbb40eed9828355189d6242131dd07343d19603', class: "s-wishlist-actions-panel-select-all flex items-center gap-2 cursor-pointer" }, h("input", { key: '5bb2571ed6e9d074739fe130d3b3b3bbe77a2393', type: "checkbox", class: "s-products-list-select-checkbox s-wishlist-actions-select-all", checked: this.isAllSelected, ref: el => (this.selectAllCheckbox = el), "aria-label": this.selectAllLabel, onChange: () => this.toggleSelectAll() }), h("span", { key: '60853767d68f23affc964822e41f19fb93b2f380', class: "s-wishlist-actions-panel-title text-sm font-bold text-gray-700" }, this.shareSpecificLabel, " (", this.selectedCount, ")")), h("div", { key: '5d4cab056b372ff6c2d9de0dfa32e1f1870b536a', class: "s-wishlist-actions-panel-buttons flex items-center gap-2" }, h("salla-button", { key: '2ef6d0388714b348ce2e039662c704d0ea9c3afa', class: "s-wishlist-actions-cancel", color: "light", fill: "outline", type: "button", onClick: () => this.cancelSpecific() }, this.cancelLabel), h("salla-button", { key: '0077c263a4eea12fc0b2b1316d4195916d771417', class: "s-wishlist-actions-share", color: "primary", fill: "outline", type: "button", disabled: !this.selectedCount, loading: this.isSharing, onClick: () => this.shareSelected() }, this.shareLabel)))))));
     }
     static get is() { return "salla-wishlist-actions"; }
     static get originalStyleUrls() {

package/dist/components/delivery-promise-intent.js

@@ -0,0 +1,67 @@
+/*!
+ * Crafted with ❤ by Salla
+ */
+import { q as isMapOriginIntent } from './helpers.js';
+
+/**
+ * Bullet delivery intent helpers.
+ * Reads/writes the same storage key as salla-bullet-delivery so both components stay in sync.
+ */
+const INTENT_KEY = 'bullet_delivery_intent';
+function getIntentStorage() {
+    const rememberLastSession = Boolean(salla.config.get('store.settings.bullet_delivery.settings.remember_last_session'));
+    return rememberLastSession ? salla.storage.store : salla.storage.session;
+}
+function getStoredIntent() {
+    const raw = getIntentStorage().get(INTENT_KEY);
+    return raw && typeof raw === 'object' ? raw : null;
+}
+/** Resolve the stored intent into a city or branch selection. Returns null when no usable intent. */
+function resolveIntent() {
+    const intent = getStoredIntent();
+    if (!intent)
+        return null;
+    if (intent.type === 'address') {
+        const city = intent.address_details?.city;
+        const cityId = city?.id != null ? Number(city.id) : intent.city_id != null ? Number(intent.city_id) : null;
+        const cityName = city?.name?.trim() || '';
+        if (cityId != null) {
+            return { type: 'address', option: { id: cityId, name: cityName } };
+        }
+        // Map-origin pick: no city id to query a delivery estimate by, but still show the address.
+        if (isMapOriginIntent(intent) && intent.address_details?.formatted_address) {
+            return { type: 'address', option: { name: intent.address_details.formatted_address } };
+        }
+        return null;
+    }
+    if (intent.type === 'branch') {
+        const branchId = intent.branch_id != null
+            ? Number(intent.branch_id)
+            : intent.branch_details?.id != null
+                ? Number(intent.branch_details.id)
+                : null;
+        const branchName = intent.branch_details?.name?.trim() || '';
+        if (branchId != null) {
+            return { type: 'branch', option: { id: branchId, name: branchName } };
+        }
+        return null;
+    }
+    return null;
+}
+/** Build the payload for opening the bullet delivery modal with preselection. */
+function buildBulletOpenPayload() {
+    const intent = getStoredIntent();
+    const payload = {};
+    if (intent?.type === 'address' && intent.address_id != null) {
+        payload.preselected_address_id = Number(intent.address_id);
+    }
+    if (intent?.type === 'branch') {
+        const branchId = intent.branch_id ?? intent.branch_details?.id;
+        if (branchId != null) {
+            payload.preselected_branch_id = Number(branchId);
+        }
+    }
+    return payload;
+}
+
+export { buildBulletOpenPayload as b, getStoredIntent as g, resolveIntent as r };

package/dist/components/helpers.js

@@ -21,6 +21,8 @@ async function withApiErrorHandling(fn, fallback, logLabel) {
 }
 const apiCache = new Map();
 const CACHE_TTL = 5 * 60 * 1000;
+let branchCacheGeneration = 0;
+const resolvedBranchPages = new WeakMap();
 function getCached(key) {
     const entry = apiCache.get(key);
     if (!entry || Date.now() - entry.timestamp > CACHE_TTL) {
@@ -32,6 +34,47 @@ function getCached(key) {
 function setCache(key, data) {
     apiCache.set(key, { data, timestamp: Date.now() });
 }
+function getCountryBranches(branches, countryId) {
+    if (!branches || countryId == null)
+        return branches;
+    if (branches.some(branch => branch.country?.id == null))
+        return null;
+    const matches = branches.filter(branch => String(branch.country?.id) === String(countryId));
+    return matches.length ? matches : null;
+}
+function getBranchPage({ query, lat, lng, country_id, city_id, page, per_page = 20 }, cachePage = true) {
+    const params = { per_page };
+    if (query && query.trim().length >= 2)
+        params.query = query;
+    if (lat)
+        params.lat = Number(lat).toFixed(6);
+    if (lng)
+        params.lng = Number(lng).toFixed(6);
+    if (country_id)
+        params.country_id = country_id;
+    if (city_id)
+        params.city_id = city_id;
+    if (page && page > 1)
+        params.page = page;
+    const cacheKey = `branches_${JSON.stringify(params)}`;
+    const cached = cachePage ? getCached(cacheKey) : null;
+    if (cached)
+        return cached;
+    const request = (async () => {
+        const res = await salla.api.request('branches', { params });
+        if (!Array.isArray(res?.data))
+            throw new Error('Invalid branches response');
+        return { branches: res.data, perPage: per_page, pagination: res.pagination };
+    })();
+    if (cachePage)
+        setCache(cacheKey, request);
+    void request.then(page => { resolvedBranchPages.set(request, page); }, () => { });
+    void request.catch(() => {
+        if (apiCache.get(cacheKey)?.data === request)
+            apiCache.delete(cacheKey);
+    });
+    return request;
+}
 /** Uses country code from API (e.g. 'SA'). */
 const isSaudiArabia = (countryCode) => String(countryCode).toUpperCase() === 'SA';
 /**
@@ -141,30 +184,105 @@ const bulletDeliveryAPI = {
             return Array.isArray(data) ? data : [];
         }, [], 'Error fetching user addresses');
     },
-    async getBranches({ query, lat, lng, country_id, per_page = 20 } = {}) {
-        const hasSearchParams = query?.trim()?.length >= 2 || lat || lng;
-        const cacheKey = !hasSearchParams && country_id ? `branches_${country_id}` : null;
-        if (cacheKey) {
-            const cached = getCached(cacheKey);
-            if (cached)
-                return cached;
+    /** Complete country rows for the city picker; incomplete reads remain retryable. */
+    async getAllBranches(country_id, per_page = 20) {
+        const collection = await this.getBranchCollection(country_id, per_page, { maxPages: Number.POSITIVE_INFINITY });
+        if (!collection.complete)
+            throw Object.assign(new Error('Incomplete branch city collection'), { branches: collection.branches });
+        return collection.branches;
+    },
+    /** Keeps loaded branches separate from whether the collection is complete. */
+    async getBranchCollection(country_id, per_page = 20, { maxPages = 10, requireComplete = false } = {}) {
+        const generation = branchCacheGeneration;
+        const cacheKey = `branches_all_${JSON.stringify([country_id ?? null, per_page, maxPages, requireComplete])}`;
+        const cached = Number.isFinite(maxPages) ? getCached(cacheKey) : null;
+        if (cached)
+            return cached;
+        const storeBranches = country_id != null ? getCached('branches_all') : null;
+        if (country_id == null)
+            setCache('branches_first', getBranchPage({ per_page, page: 1 }));
+        const partial = { branches: [], complete: false };
+        const request = withApiErrorHandling(async () => {
+            const sharedFirstPage = storeBranches ? getCached('branches_first') : null;
+            const first = sharedFirstPage ? resolvedBranchPages.get(sharedFirstPage) : null;
+            if (storeBranches && getCountryBranches(first?.branches ?? null, country_id)) {
+                const collection = await storeBranches;
+                if (generation !== branchCacheGeneration)
+                    return { branches: [], complete: false };
+                const branches = collection.complete ? getCountryBranches(collection.branches, country_id) : null;
+                if (branches)
+                    return { branches, complete: true };
+            }
+            for (let page = 1; page <= maxPages; page++) {
+                const { branches, pagination } = await getBranchPage({ country_id, per_page, page }, Number.isFinite(maxPages) || page === 1);
+                if (generation !== branchCacheGeneration)
+                    return { branches: [], complete: false };
+                const currentPage = Number(pagination?.currentPage ?? page);
+                const totalPages = Number(pagination?.totalPages);
+                if (page === 1 && totalPages === 0 && !branches.length)
+                    return { branches: [], complete: true };
+                if (pagination && (currentPage !== page || !Number.isInteger(totalPages) || totalPages < page)) {
+                    throw new Error('Invalid branches pagination');
+                }
+                partial.branches.push(...branches);
+                if (pagination) {
+                    if (requireComplete && totalPages > maxPages)
+                        return partial;
+                    if (page === totalPages)
+                        return { branches: partial.branches, complete: true };
+                    if (!branches.length)
+                        throw new Error('Incomplete branches response');
+                }
+                else if (branches.length < per_page) {
+                    return { branches: partial.branches, complete: true };
+                }
+            }
+            return partial;
+        }, partial, 'Error fetching all branches');
+        setCache(cacheKey, request);
+        if (country_id == null)
+            setCache('branches_all', request);
+        void request.then(collection => {
+            if (collection.complete) {
+                if (generation === branchCacheGeneration && apiCache.get('branches_all')?.data === request) {
+                    setCache('branches_complete', collection.branches);
+                }
+                return;
+            }
+            if (apiCache.get(cacheKey)?.data === request)
+                apiCache.delete(cacheKey);
+            if (apiCache.get('branches_all')?.data === request)
+                apiCache.delete('branches_all');
+        });
+        return request;
+    },
+    async getBranches(filters = {}) {
+        const generation = branchCacheGeneration;
+        const hasSearchParams = (filters.query && filters.query.trim().length >= 2) || filters.lat || filters.lng || filters.city_id;
+        const perPage = filters.per_page ?? 20;
+        const offset = ((filters.page ?? 1) - 1) * perPage;
+        if (!hasSearchParams) {
+            const branches = getCountryBranches(getCached('branches_complete'), filters.country_id);
+            if (branches) {
+                return branches.slice(offset, offset + perPage);
+            }
+            const firstPage = getCached('branches_first');
+            if (firstPage) {
+                const result = resolvedBranchPages.get(firstPage);
+                if (generation !== branchCacheGeneration)
+                    return [];
+                if (result) {
+                    const first = getCountryBranches(result.branches, filters.country_id);
+                    const complete = result.pagination
+                        ? Number(result.pagination.totalPages) === 1
+                        : result.branches.length < result.perPage;
+                    if (first && (first.length >= offset + perPage || complete)) {
+                        return first.slice(offset, offset + perPage);
+                    }
+                }
+            }
         }
-        const result = await withApiErrorHandling(async () => {
-            const params = { per_page };
-            if (query?.trim().length >= 2)
-                params.query = query;
-            if (lat)
-                params.lat = lat;
-            if (lng)
-                params.lng = lng;
-            if (country_id)
-                params.country_id = country_id;
-            const res = await salla.api.request("branches", { params });
-            return (Array.isArray(res?.data) ? res.data : []);
-        }, [], 'Error fetching branches');
-        if (cacheKey && result.length > 0)
-            setCache(cacheKey, result);
-        return result;
+        return withApiErrorHandling(async () => (await getBranchPage(filters)).branches, [], 'Error fetching branches');
     },
     async saveAddressLocation(payload) {
         return withApiErrorHandling(async () => {
@@ -182,7 +300,12 @@ const bulletDeliveryAPI = {
         }, false, 'Error setting delivery scope');
     },
     async allocateScope(payload) {
-        const errMsg = (d) => d?.error?.message ?? d?.message ?? 'Failed to allocate scope';
+        // A field reason (e.g. branch_id "not accepting orders") is more useful than the generic "invalid fields" message.
+        const errMsg = (d) => {
+            const body = d;
+            const fieldReason = Object.values(body?.error?.fields ?? {}).flat().find((m) => typeof m === 'string' && m.trim());
+            return fieldReason ?? body?.error?.message ?? body?.message ?? 'Failed to allocate scope';
+        };
         try {
             const response = await salla.api.withoutNotifier(() => salla.api.request("scopes/allocation", payload, 'post'));
             // SDK resolves with { data } and throws on non-2xx; any resolved value is success
@@ -203,8 +326,16 @@ const bulletDeliveryAPI = {
     },
 };
 function clearApiCache() {
+    branchCacheGeneration++;
     apiCache.clear();
 }
+function clearBranchCache() {
+    branchCacheGeneration++;
+    for (const key of apiCache.keys()) {
+        if (key.startsWith('branches_'))
+            apiCache.delete(key);
+    }
+}
 
 /**
  * Helper functions for salla-bullet-delivery component
@@ -233,13 +364,153 @@ const isBranchSelectable = (branch) => {
     const selectable = branch.pickup_readiness?.selectable;
     return typeof selectable === 'boolean' ? selectable : branch.is_open !== false;
 };
-/** Nearest available branch by distance; single pass O(n). */
+/** Backend readiness label ("استلمه غدًا", "جاهز {date}") when pickup is not today; null otherwise. */
+const getBranchReadinessLabel = (branch) => {
+    const readiness = branch?.pickup_readiness;
+    return readiness?.label && ['tomorrow', 'later'].includes(readiness.state) ? readiness.label : null;
+};
+/** Branch-clock "HH:mm" a branch that is closed now becomes ready at later today; null otherwise. */
+const getBranchReadyTodayTime = (branch) => {
+    const readiness = branch?.pickup_readiness;
+    if (readiness?.state !== 'same_day' || branch?.is_open !== false)
+        return null;
+    return readiness.ready_at?.match(/T(\d{2}:\d{2})/)?.[1] ?? null;
+};
+/** Busy branches (stock at the merchant's stop-orders threshold) stay listed but dimmed and unselectable. */
+const isBranchBusy = (branch) => branch?.pickup_readiness?.state === 'orders_paused';
+/** Distinct cities of a branch list, in first-seen order (the API lists nearest first). */
+const getBranchCities = (branches) => {
+    const seen = new Set();
+    const cities = [];
+    for (const { city } of branches) {
+        if (!city?.id || seen.has(String(city.id)))
+            continue;
+        seen.add(String(city.id));
+        cities.push({ id: city.id, name: city.name });
+    }
+    return cities;
+};
+/** "3.52" / "12" — at most two decimals, as the checkout picker shows it; '' when the distance is unknown. */
+const formatBranchDistance = (km) => {
+    if (km == null || Number.isNaN(Number(km)))
+        return '';
+    return String(Math.round(Number(km) * 100) / 100);
+};
+/**
+ * Readiness states the picker hides outright instead of showing as a disabled card: closed and not
+ * taking pickup orders at all. Busy/out-of-stock stay visible-but-disabled so the shopper sees why
+ * (same rule as the checkout picker, INV-1414).
+ */
+const HIDDEN_READINESS_STATES = ['closed', 'unavailable'];
+const isBranchVisible = (branch) => !!branch && !HIDDEN_READINESS_STATES.includes(branch.pickup_readiness?.state);
+/** The branch's pickup offer (INV-1416); null when it has none, or a zero one, so "خصم 0%" never shows. */
+const getBranchDiscount = (branch) => {
+    const type = branch?.discount?.type;
+    const amount = Number(branch?.discount?.amount);
+    if ((type !== 'percentage' && type !== 'fixed_amount') || !(amount > 0))
+        return null;
+    return { type, amount };
+};
+/**
+ * Min–max pickup offer across the listed branches, for the pickup tab badge; null when none has one.
+ * Branches the picker hides are left out so the tab never advertises an offer the shopper can't pick.
+ * A percentage and a fixed amount can't share one range, so percentages win when both are set.
+ */
+const getBranchDiscountRange = (branches) => {
+    const discounts = branches.filter(isBranchVisible).map(getBranchDiscount).filter((d) => !!d);
+    if (!discounts.length)
+        return null;
+    const type = discounts.some(d => d.type === 'percentage') ? 'percentage' : 'fixed_amount';
+    const amounts = discounts.filter(d => d.type === type).map(d => d.amount);
+    return { type, min: Math.min(...amounts), max: Math.max(...amounts) };
+};
+/** The storefront's working_hours and ready_at use 24h "HH:mm"; null for anything else. */
+const parseBranchTime = (time) => {
+    const match = String(time ?? '').trim().match(/^(\d{1,2}):(\d{2})(?::\d{2})?$/);
+    if (!match || Number(match[1]) > 24)
+        return null;
+    return { hours: Number(match[1]) % 24, minutes: Number(match[2]) };
+};
+/** Date#getDay() keys for the day names the storefront API may send (Arabic or English). */
+const DAY_KEYS = {
+    sunday: 0, 'الاحد': 0,
+    monday: 1, 'الاثنين': 1,
+    tuesday: 2, 'الثلاثاء': 2,
+    wednesday: 3, 'الاربعاء': 3,
+    thursday: 4, 'الخميس': 4,
+    friday: 5, 'الجمعة': 5,
+    saturday: 6, 'السبت': 6,
+};
+const dayKeyFromName = (name) => DAY_KEYS[String(name ?? '').trim().toLowerCase().replace(/[أإآ]/g, 'ا')];
+/**
+ * The storefront's `working_hours` (`{ name, times: [{ from, to }] }`, 24h times) as weekly
+ * schedule rows for the hours dropdown.
+ */
+const getBranchWeekSchedule = (branch) => (branch.working_hours || [])
+    .filter(day => day?.name)
+    .map(day => ({
+    day_key: dayKeyFromName(day.name),
+    day: day.name,
+    times: (day.times || []).map(t => ({ start: t.from, end: t.to })),
+}));
+const isBranchAlwaysOpen = (branch) => !!branch.always_open;
+/**
+ * "11:00 م" / "11:00 PM". ar-SA's ICU pattern puts the day period first, which the bidi algorithm
+ * scrambles inside RTL text, so the parts are joined in a fixed "h:mm period" order instead.
+ */
+const formatBranchClockTime = (time, locale) => {
+    const parsed = parseBranchTime(time);
+    if (!parsed)
+        return '';
+    const date = new Date(Date.UTC(2000, 0, 1, parsed.hours, parsed.minutes));
+    const parts = new Intl.DateTimeFormat(locale === 'ar' ? 'ar-SA-u-nu-latn' : 'en', {
+        timeZone: 'UTC',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: true,
+    }).formatToParts(date);
+    const get = (type) => parts.find(p => p.type === type)?.value ?? '';
+    return `${get('hour')}:${get('minute')} ${get('dayPeriod')}`;
+};
+const sameTimes = (a, b) => a.length === b.length && a.every((t, i) => t.start === b[i].start && t.end === b[i].end);
+/** Consecutive days with identical hours collapse into one row; the largest groups come first. */
+const groupBranchSchedule = (weekSchedule) => {
+    const groups = [];
+    const days = [...(weekSchedule || [])].filter(s => s.times?.length).sort((a, b) => (a.day_key ?? 0) - (b.day_key ?? 0));
+    for (const day of days) {
+        const last = groups[groups.length - 1];
+        if (last && day.day_key === last.lastDayKey + 1 && sameTimes(last.times, day.times)) {
+            last.days.push(day.day);
+            last.lastDayKey = day.day_key;
+        }
+        else {
+            groups.push({ days: [day.day], times: day.times, lastDayKey: day.day_key ?? 0 });
+        }
+    }
+    return groups.sort((a, b) => b.days.length - a.days.length).map(({ days, times }) => ({ days, times }));
+};
+/** Keeps the digits and a leading "+" the merchant typed; drops spaces, dashes and brackets. */
+const cleanPhone = (value) => String(value ?? '').trim().replace(/[^\d+]/g, '');
+const getBranchPhoneHref = (branch) => {
+    const phone = cleanPhone(branch.contacts?.phone);
+    return phone ? `tel:${phone}` : null;
+};
+/** wa.me wants the international number as bare digits ("+966…" / "00966…" → "966…"). */
+const getBranchWhatsappHref = (branch) => {
+    const digits = cleanPhone(branch.contacts?.whatsapp).replace(/^\+/, '').replace(/^00/, '').replace(/\D/g, '');
+    return digits ? `https://wa.me/${digits}` : null;
+};
+const getBranchDirectionsHref = (branch) => branch.location?.lat != null && branch.location?.lng != null
+    ? `https://www.google.com/maps?q=${branch.location.lat},${branch.location.lng}`
+    : null;
+/** Nearest selectable branch by distance; single pass O(n). */
 function findNearestBranch(branches, userLat, userLon) {
     let nearest = null;
     let minD = Number.POSITIVE_INFINITY;
     for (const b of branches) {
         const lat = b.location?.lat != null ? Number(b.location.lat) : Number.NaN;
         const lng = b.location?.lng != null ? Number(b.location.lng) : Number.NaN;
+        // Closed branches that still take orders are selectable too, so gate on selectability, not is_open.
         if (Number.isNaN(lat) || Number.isNaN(lng) || !isBranchSelectable(b))
             continue;
         const d = calculateDistance(userLat, userLon, lat, lng);
@@ -250,11 +521,12 @@ function findNearestBranch(branches, userLat, userLon) {
     }
     return nearest;
 }
+/** Matches the fields the branches API searches: branch, city and country names (either language). */
 const filterBranches = (branches, searchQuery) => {
     if (!searchQuery)
         return branches;
     const q = searchQuery.toLowerCase();
-    return branches.filter((b) => b.name.toLowerCase().includes(q) || b.city?.name?.toLowerCase().includes(q));
+    return branches.filter((b) => [b.name, b.city?.name, b.city?.name_en, b.country?.name, b.country?.name_en].some((name) => name?.toLowerCase().includes(q)));
 };
 const getIntentSubtitle = (intent, toAddress, fromBranch) => {
     if (intent.type === 'branch') {
@@ -274,10 +546,30 @@ const getIntentRegionId = (i) => idFrom(i?.address_details?.region?.id);
 const getIntentCityId = (i) => idFrom(i?.address_details?.city?.id);
 const getIntentDistrictId = (i) => idFrom(i?.address_details?.district?.id);
 const getIntentBranchId = (i) => i?.branch_details?.id;
-/** Intent coordinates (branch tab only; address flow no longer uses coordinates). */
-const getIntentLatitude = (i) => i?.branch_details?.latitude;
-const getIntentLongitude = (i) => i?.branch_details?.longitude;
 const isMapOriginIntent = (i) => !!i && i.type === 'address' && i.address_details?.lat != null && i.address_details?.lng != null;
+/** Parse a coordinate to a finite number, treating null and blank/whitespace strings as missing. */
+const toCoordinate = (value) => {
+    if (value == null || (typeof value === 'string' && value.trim() === ''))
+        return null;
+    const num = Number(value);
+    return Number.isFinite(num) ? num : null;
+};
+/**
+ * Address intent complete enough to order against: a national address code, or a district with a
+ * street or real coordinates. The district text may sit in `local` when the district object is empty.
+ */
+const isIntentAddressComplete = (i) => {
+    if (!i || i.type !== 'address')
+        return false;
+    const d = i.address_details;
+    // Stored intents come from the API, so a field may not be a string.
+    const has = (value) => String(value ?? '').trim() !== '';
+    const lat = toCoordinate(d?.lat);
+    const lng = toCoordinate(d?.lng);
+    const hasCoordinates = lat != null && lng != null && !(lat === 0 && lng === 0);
+    const hasDistrict = has(d?.district?.name) || has(d?.local);
+    return has(d?.short_address) || (hasDistrict && (has(d?.street) || hasCoordinates));
+};
 const hasSessionAddressIntent = (intent) => {
     if (!intent || intent.type !== 'address' || intent.address_id)
         return false;
@@ -295,15 +587,5 @@ const hasSessionAddressIntent = (intent) => {
 const requireRegionAndDistrictForSA = (countryCode, regionId, districtIdOrName) => !countryCode || !isSaudiArabia(countryCode)
     ? true
     : (regionId != null && Number(regionId) !== 0) && (districtIdOrName != null && (typeof districtIdOrName === 'number' ? districtIdOrName !== 0 : String(districtIdOrName).trim().length > 0));
-// Geolocation error codes - fallback constants for non-browser environments
-const GEO_ERROR_PERMISSION_DENIED = typeof GeolocationPositionError !== 'undefined' ? GeolocationPositionError.PERMISSION_DENIED : 1;
-const GEO_ERROR_POSITION_UNAVAILABLE = typeof GeolocationPositionError !== 'undefined' ? GeolocationPositionError.POSITION_UNAVAILABLE : 2;
-const GEO_ERROR_TIMEOUT = typeof GeolocationPositionError !== 'undefined' ? GeolocationPositionError.TIMEOUT : 3;
-const GEO_ERROR_MESSAGES = {
-    [GEO_ERROR_PERMISSION_DENIED]: 'Location permission denied',
-    [GEO_ERROR_POSITION_UNAVAILABLE]: 'Location unavailable',
-    [GEO_ERROR_TIMEOUT]: 'Location timeout',
-};
-const getGeolocationErrorMessage = (errorCode) => GEO_ERROR_MESSAGES[errorCode] ?? 'An error occurred while detecting location';
 
-export { getIntentLongitude as a, bulletDeliveryAPI as b, getIntentCityId as c, getIntentCountryId as d, getIntentRegionId as e, getIntentDistrictId as f, getIntentLatitude as g, hasSessionAddressIntent as h, isSaudiArabia as i, isBranchSelectable as j, filterBranches as k, getIntentBranchId as l, findNearestBranch as m, getGeolocationErrorMessage as n, clearApiCache as o, getIntentSubtitle as p, isMapOriginIntent as q, requireRegionAndDistrictForSA as r, getIntentCountryCode as s };
+export { formatBranchDistance as A, getBranchDirectionsHref as B, CACHE_TTL as C, formatBranchClockTime as D, getBranchReadyTodayTime as E, isBranchBusy as F, isBranchAlwaysOpen as G, getIntentCountryCode as H, isIntentAddressComplete as I, getIntentCountryId as a, bulletDeliveryAPI as b, clearBranchCache as c, getIntentRegionId as d, getIntentDistrictId as e, getBranchCities as f, getIntentCityId as g, hasSessionAddressIntent as h, isSaudiArabia as i, isBranchSelectable as j, getBranchDiscountRange as k, filterBranches as l, getIntentBranchId as m, findNearestBranch as n, clearApiCache as o, getIntentSubtitle as p, isMapOriginIntent as q, requireRegionAndDistrictForSA as r, isBranchVisible as s, toCoordinate as t, getBranchReadinessLabel as u, groupBranchSchedule as v, getBranchWeekSchedule as w, getBranchPhoneHref as x, getBranchWhatsappHref as y, getBranchDiscount as z };