@misiki/gocommerce-connector 0.9.1 → 0.11.0

package/README.md

@@ -140,6 +140,7 @@ down stays best-effort: the storefront renders from its static record.
 | FAQ | `/x/faq` |
 | composed home page | `/x/layouts/home` (`?preview=` for a draft) — `layoutService.getHomeLayout()`, null when the store has none; carries `themeSettings` and each collection list's `collections` |
 | product and collection templates | `/x/layouts/product`, `/x/layouts/collection` (`?preview=` for a draft) — `layoutService.getProductLayout()` and `getCollectionLayout()`, the sections the shop arranged around the page's core (`main-product`, `main-collection`); null when none is published, and the page draws as before |
+| header and footer | `/x/layouts/header`, `/x/layouts/footer` (`?preview=` for a draft) — `layoutService.getHeader()` and `getFooter()`: the announcement strip and header menu, the footer's columns menu, words, newsletter switch, social links and copyright line, with the named menu read live from `/x/navigation/menus/{handle}`; null when none is published or on any failure, and the storefront keeps its own. The store's `header` and `footer` menus (`menuService.engineMenus()`, the store record's `menu`) are the ones those name |
 | theme settings | `/x/layouts/theme` (`?preview=` for a draft) — `layoutService.getThemeSettings()`, the store's colours, fonts and rounding for every page; null when there are none |
 | menus | `/x/navigation/menus/{header,footer}`, laid over `store.menu`; any menu by handle |
 | product specs table | the product's category attribute answers |
@@ -225,13 +226,13 @@ Each of these is a real gap, listed so nobody has to find it in production.
   `checkoutService.checkout(code)` for a storefront that drives its own payment
   UI. Payment is confirmed by the gateway's webhook to the engine; the order
   shows `paymentStatus` once it lands.
-- **Attribute filters inside a category.** The engine filters by attribute on
-  the whole-shop listing only; on a category page they are not applied.
+- **Filters on an older engine.** Listing filters and their counts (tags,
+  vendor, product type, category attributes, price) need an engine that counts
+  them (`GET /api/products?facets=1`, D130). Against an older one the filter
+  rail is empty and a category page's attribute filters are not applied.
 - **Tax in the bag.** The engine's cart carries no tax or total; tax is computed
   when the order is placed. The bag shows subtotal − discount + delivery, and the
   order shows the real figures.
-- **Facets.** The engine's search returns hits and a total, not distributions, so
-  category and tag facets and the price slider are not shown.
 - **Phone sign-in by code, account deletion, guest order lookup by email and
   code** are not engine features and throw.
 

package/dist/{index-DSvV8FbK.d.cts → index-90wdO5MM.d.cts}

@@ -109,6 +109,29 @@ type ListMeta = {
     offset: number;
     page: number;
     total_pages: number;
+    /** Only on `GET /api/products?facets=1`, from an engine that counts them (D130). */
+    facets?: ProductFacets;
+};
+type FacetValue = {
+    value: string;
+    count: number;
+};
+/** core/catalog_facets.go: counted over the whole listing, each group without its own selection. */
+type ProductFacets = {
+    price: {
+        min: Money;
+        max: Money;
+    } | null;
+    tags: FacetValue[] | null;
+    vendors: FacetValue[] | null;
+    product_types: FacetValue[] | null;
+    categories: {
+        id: number;
+        slug: string;
+        title: string;
+        count: number;
+    }[] | null;
+    attributes: Record<string, FacetValue[]> | null;
 };
 type Envelope<T> = {
     data: T;
@@ -1327,6 +1350,16 @@ type CatalogQuery = {
      * are not applied.
      */
     attributes?: Record<string, string[]>;
+    tags?: string[];
+    vendors?: string[];
+    productTypes?: string[];
+    /**
+     * Ask the engine to count the filter values too. Such a query goes to
+     * `GET /api/products`, which then also answers the category, the price
+     * range, the sort and every filter above (D130); an engine too old to count
+     * them is asked the way it always was, and the page has no facets.
+     */
+    facets?: boolean;
 };
 type CatalogPage = {
     data: ReturnType<typeof toProduct>[] | ReturnType<typeof fromSearchDoc>[];
@@ -1340,17 +1373,8 @@ type CatalogPage = {
     }[];
     /** Whether the answer honoured `sort` and the price range, or had to drop them. */
     sorted: boolean;
+    facets?: ProductFacets;
 };
-/**
- * One shelf of products, from whichever engine route can answer the question.
- *
- * - A category, no reordering: `GET /api/categories/{slug}`, which sells the
- *   category and its descendants.
- * - A search or the whole shop, no reordering: `GET /api/products?q=`.
- * - Any sort but newest, or a price range: the Meilisearch module, when it is
- *   installed and configured. Without it the shelf comes back in the engine's
- *   order with `sorted: false`, rather than failing or pretending.
- */
 declare class CatalogService extends BaseService {
     protected readonly facts: StoreFacts;
     protected queryCatalog(q: CatalogQuery): Promise<CatalogPage>;
@@ -1968,14 +1992,39 @@ declare class ProductService extends CatalogService {
 }
 declare const productService: ProductService;
 
+/**
+ * The engine's counts in the shape the storefront's filter rail reads. Each
+ * `allFilters` key is also the URL parameter the rail writes when a value is
+ * ticked, and `searchWithUrl` reads it back: `vendor`, `product_type` and
+ * `attributes.<handle>`. Tags go to the rail's own tag group, written as `tags`.
+ */
+declare function toStorefrontFacets(f?: ProductFacets | null): {
+    priceStat: {
+        min: number;
+        max: number;
+    } | {
+        min?: undefined;
+        max?: undefined;
+    };
+    categories: {
+        name: string;
+        slug: string;
+        count: number;
+    }[];
+    tags: {
+        name: string;
+        count: number;
+    }[];
+    allFilters: Record<string, Record<string, number>>;
+};
 /**
  * The listing pages' search: `/products?search=&sort=&page=` and the category
  * catch-all `/{slug}`.
  *
- * Facets are empty. The engine's search route returns hits and a total, not
- * distributions, and a facet list made from one page of hits would count that
- * page, not the shop. An empty `priceStat` hides the price slider rather than
- * drawing one with a made-up range.
+ * Facets come from the engine, counted over the whole listing rather than the
+ * page (D130). An engine too old to count them leaves them empty, and an empty
+ * `priceStat` hides the price slider rather than drawing one with a made-up
+ * range.
  */
 declare class SearchService extends CatalogService {
     emptyResult(): {
@@ -1987,10 +2036,23 @@ declare class SearchService extends CatalogService {
             slug: string;
         }[];
         facets: {
-            priceStat: {};
-            categories: never[];
-            tags: never[];
-            allFilters: {};
+            priceStat: {
+                min: number;
+                max: number;
+            } | {
+                min?: undefined;
+                max?: undefined;
+            };
+            categories: {
+                name: string;
+                slug: string;
+                count: number;
+            }[];
+            tags: {
+                name: string;
+                count: number;
+            }[];
+            allFilters: Record<string, Record<string, number>>;
         };
     };
     searchWithUrl(url: URL | string, slug?: string): Promise<{
@@ -2002,10 +2064,23 @@ declare class SearchService extends CatalogService {
             slug: string;
         }[];
         facets: {
-            priceStat: {};
-            categories: never[];
-            tags: never[];
-            allFilters: {};
+            priceStat: {
+                min: number;
+                max: number;
+            } | {
+                min?: undefined;
+                max?: undefined;
+            };
+            categories: {
+                name: string;
+                slug: string;
+                count: number;
+            }[];
+            tags: {
+                name: string;
+                count: number;
+            }[];
+            allFilters: Record<string, Record<string, number>>;
         };
     } | {
         data: {
@@ -2154,10 +2229,23 @@ declare class SearchService extends CatalogService {
             slug: string;
         }[];
         facets: {
-            priceStat: {};
-            categories: never[];
-            tags: never[];
-            allFilters: {};
+            priceStat: {
+                min: number;
+                max: number;
+            } | {
+                min?: undefined;
+                max?: undefined;
+            };
+            categories: {
+                name: string;
+                slug: string;
+                count: number;
+            }[];
+            tags: {
+                name: string;
+                count: number;
+            }[];
+            allFilters: Record<string, Record<string, number>>;
         };
     }>;
 }
@@ -5577,8 +5665,15 @@ declare class MenuService extends BaseService {
     listMenus(): Promise<MenuSummary[]>;
     /** One menu by handle, in the storefront's shape: `{ menuId, name, items: [{ id, name, link, items }] }`. */
     getMenu(handle: string): Promise<StorefrontMenu>;
-    /** The header and footer menus, or `null` when the module is not there. Cached: a menu is store-level. */
+    /**
+     * The header and footer menus, or `null` when the module is not there. Cached: a menu is
+     * store-level. Each is the menu the shop chose for it in the theme editor's header or footer
+     * (GoCommerce D131), still under the `header` / `footer` id every storefront looks for, so the
+     * choice reaches every place that draws one; the menus named so are the default.
+     */
     engineMenus(): Promise<StorefrontMenu[] | null>;
+    /** The handle of the menu the published header or footer names, else the part's own name. */
+    private chosenMenu;
 }
 declare const menuService: MenuService;
 
@@ -5742,7 +5837,7 @@ type HomeLayoutSection = {
  * or `main-collection` (the collection's grid) — at the place the shop put
  * it, and the storefront draws its own core there.
  */
-type LayoutPage = 'home' | 'product' | 'collection';
+type LayoutPage = 'home' | 'product' | 'collection' | 'header' | 'footer';
 type HomeLayout = {
     page: string;
     theme: string;
@@ -5762,6 +5857,50 @@ type ThemeSettingsResult = {
     preview: boolean;
     settings: ThemeSettings;
 };
+/**
+ * The header's settings as the shop set them (ext/layouts, D131): the strip
+ * above the header — shown or not, its words, its link, and whether it is on
+ * every page or the home page only — and the handle of the menu across it.
+ * Plain text, and a link that is `/path` or `http(s)://`.
+ */
+type HeaderSettings = {
+    show_announcement?: boolean;
+    announcement_text?: string;
+    announcement_link?: string;
+    announcement_pages?: 'all' | 'home';
+    menu?: string;
+};
+/** A footer's link to the shop's page on a social network; `url` is always `http(s)://`. */
+type SocialLink = {
+    network: 'instagram' | 'facebook' | 'x' | 'youtube' | 'pinterest' | 'linkedin' | 'whatsapp' | 'telegram';
+    url: string;
+};
+/**
+ * The footer's settings (D131): the handle of the menu whose top-level links
+ * become its columns, a few words about the shop, whether the newsletter
+ * sign-up shows (absent while the newsletter is off), social links and the
+ * copyright line. An absent one means the storefront keeps its own.
+ */
+type FooterSettings = {
+    menu?: string;
+    about?: string;
+    newsletter?: boolean;
+    social?: SocialLink[];
+    copyright?: string;
+};
+/**
+ * The published header or footer, or a preview key's draft, with the menu
+ * it names already read — live, so a menu edited in the panel shows without a
+ * publish. `menu` is null when none is named or the named one is gone.
+ */
+type SiteChrome<S> = {
+    revision?: number;
+    preview: boolean;
+    settings: S;
+    menu: StorefrontMenu | null;
+};
+type SiteHeader = SiteChrome<HeaderSettings>;
+type SiteFooter = SiteChrome<FooterSettings>;
 /**
  * Composed pages from ext/layouts. A store without one — the plugin off,
  * nothing published, an engine built without the module, or a preview key
@@ -5798,6 +5937,20 @@ declare class LayoutService extends BaseService {
     getThemeSettings({ preview }?: {
         preview?: string | null;
     }): Promise<ThemeSettingsResult | null>;
+    /**
+     * The header the shop set in the theme editor (D131), drawn on every
+     * page: the published one, or a preview key's draft. Null — the
+     * storefront's own header — when none is published, the editor is off, the
+     * engine is older, or anything fails: a header is never worth an error page.
+     */
+    getHeader({ preview }?: {
+        preview?: string | null;
+    }): Promise<SiteHeader | null>;
+    /** The footer the shop set in the theme editor (D131); null for the storefront's own, as getHeader. */
+    getFooter({ preview }?: {
+        preview?: string | null;
+    }): Promise<SiteFooter | null>;
+    private chrome;
 }
 declare const layoutService: LayoutService;
 
@@ -6941,4 +7094,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { LayoutService as $, type Address as A, type B2bPlaced as B, type Cart as C, CountryService as D, CouponService as E, type Credentials as F, type Credit as G, CurrencyService as H, type Customer as I, DealService as J, DemoRequestService as K, type EngineRequest as L, EnquiryService as M, type Envelope as N, type Faq as O, FaqService as P, FeedbackService as Q, type Fulfillment as R, GalleryService as S, type HomeLayout as T, type HomeLayoutSection as U, HomeService as V, type IdentityAddress as W, InitService as X, type Invitation as Y, type LayoutCollection as Z, type LayoutPage as _, AddressService as a, autocompleteService as a$, type Lead as a0, type ListMeta as a1, MeilisearchService as a2, type Member as a3, type Menu as a4, type MenuItem as a5, MenuService as a6, type MenuSummary as a7, type Money as a8, NewsletterService as a9, SearchService as aA, SettingService as aB, type ShippingRate as aC, StateService as aD, type StoreProfile as aE, StoreService as aF, type StorefrontCategory as aG, type StorefrontMenu as aH, type StorefrontOrder as aI, type StorefrontProduct as aJ, type ThemeSettings as aK, type ThemeSettingsResult as aL, UploadService as aM, UserService as aN, type Variant as aO, type VariantImage as aP, VariantService as aQ, VarniCustomDesignService as aR, VarniCustomProductService as aS, type Vendor as aT, VendorService as aU, WarrantyService as aV, type Wishlist as aW, type WishlistItem as aX, WishlistService as aY, addressService as aZ, authService as a_, type Offer as aa, type Order as ab, type OrderLine as ac, OrderService as ad, type PageLayout as ae, PageService as af, type PaymentIntent as ag, PaymentMethodService as ah, type Plugin as ai, PluginService as aj, PopularSearchService as ak, PopularityService as al, type Product as am, type ProductOption as an, ProductService as ao, ProfileService as ap, type Quote as aq, REDIRECT_GATEWAYS as ar, ReelsService as as, RegionService as at, type RejectedLine as au, type Review as av, type ReviewPage as aw, ReviewService as ax, type SearchDoc as ay, type SearchResult as az, type AppliedDiscount as b, toMajor as b$, b2bService as b0, bannerService as b1, blogService as b2, cartService as b3, categoryService as b4, chatService as b5, checkoutService as b6, collectionService as b7, contactService as b8, countryService as b9, pluginService as bA, pluginsService as bB, popularSearchService as bC, popularityService as bD, priceOf as bE, productImages as bF, productService as bG, profileService as bH, qs as bI, reelsService as bJ, regionService as bK, reviewService as bL, searchService as bM, setRequestHost as bN, settingService as bO, settingsService as bP, stateService as bQ, staticStore as bR, storeForHost as bS, storeService as bT, toCart as bU, toCartLine as bV, toCategory as bW, toCmsPage as bX, toCollection as bY, toEngineAddress as bZ, toIdentityAddress as b_, couponService as ba, currencyExponent as bb, currencyService as bc, dealService as bd, demoRequestService as be, emptyCart as bf, emptyPage as bg, enquiryService as bh, faqService as bi, feedbackService as bj, fromEngineAddress as bk, fromIdentityAddress as bl, fromSearchDoc as bm, galleryService as bn, homeService as bo, initService as bp, layoutService as bq, mediaUrl as br, meilisearchService as bs, menuService as bt, minorToMajor as bu, newsletterService as bv, orderService as bw, ownDomain as bx, pageService as by, paymentMethodService as bz, type Approval as c, toMinor as c0, toOrder as c1, toPage as c2, toProduct as c3, toRating as c4, toUser as c5, toVariant as c6, toVendor as c7, uploadService as c8, userService as c9, variantService as ca, varniCustomDesignService as cb, varniCustomProductService as cc, vendorService as cd, warrantyService as ce, wishlistService as cf, type AuthResponse as d, AuthService as e, AutocompleteService as f, type B2bRole as g, B2bService as h, BannerService as i, BaseService as j, BlogService as k, type CartLine as l, CartService as m, CatalogService as n, type Category as o, CategoryService as p, ChatService as q, type CheckoutOptions as r, type CheckoutResult as s, CheckoutService as t, type CmsPage as u, type Collection as v, CollectionService as w, type Company as x, type CompanyOrder as y, ContactService as z };
+export { type Invitation as $, type Address as A, type B2bPlaced as B, type Cart as C, CountryService as D, CouponService as E, type Credentials as F, type Credit as G, CurrencyService as H, type Customer as I, DealService as J, DemoRequestService as K, type EngineRequest as L, EnquiryService as M, type Envelope as N, type FacetValue as O, type Faq as P, FaqService as Q, FeedbackService as R, type FooterSettings as S, type Fulfillment as T, GalleryService as U, type HeaderSettings as V, type HomeLayout as W, type HomeLayoutSection as X, HomeService as Y, type IdentityAddress as Z, InitService as _, AddressService as a, type Vendor as a$, type LayoutCollection as a0, type LayoutPage as a1, LayoutService as a2, type Lead as a3, type ListMeta as a4, MeilisearchService as a5, type Member as a6, type Menu as a7, type MenuItem as a8, MenuService as a9, type ReviewPage as aA, ReviewService as aB, type SearchDoc as aC, type SearchResult as aD, SearchService as aE, SettingService as aF, type ShippingRate as aG, type SiteChrome as aH, type SiteFooter as aI, type SiteHeader as aJ, type SocialLink as aK, StateService as aL, type StoreProfile as aM, StoreService as aN, type StorefrontCategory as aO, type StorefrontMenu as aP, type StorefrontOrder as aQ, type StorefrontProduct as aR, type ThemeSettings as aS, type ThemeSettingsResult as aT, UploadService as aU, UserService as aV, type Variant as aW, type VariantImage as aX, VariantService as aY, VarniCustomDesignService as aZ, VarniCustomProductService as a_, type MenuSummary as aa, type Money as ab, NewsletterService as ac, type Offer as ad, type Order as ae, type OrderLine as af, OrderService as ag, type PageLayout as ah, PageService as ai, type PaymentIntent as aj, PaymentMethodService as ak, type Plugin as al, PluginService as am, PopularSearchService as an, PopularityService as ao, type Product as ap, type ProductFacets as aq, type ProductOption as ar, ProductService as as, ProfileService as at, type Quote as au, REDIRECT_GATEWAYS as av, ReelsService as aw, RegionService as ax, type RejectedLine as ay, type Review as az, type AppliedDiscount as b, storeService as b$, VendorService as b0, WarrantyService as b1, type Wishlist as b2, type WishlistItem as b3, WishlistService as b4, addressService as b5, authService as b6, autocompleteService as b7, b2bService as b8, bannerService as b9, meilisearchService as bA, menuService as bB, minorToMajor as bC, newsletterService as bD, orderService as bE, ownDomain as bF, pageService as bG, paymentMethodService as bH, pluginService as bI, pluginsService as bJ, popularSearchService as bK, popularityService as bL, priceOf as bM, productImages as bN, productService as bO, profileService as bP, qs as bQ, reelsService as bR, regionService as bS, reviewService as bT, searchService as bU, setRequestHost as bV, settingService as bW, settingsService as bX, stateService as bY, staticStore as bZ, storeForHost as b_, blogService as ba, cartService as bb, categoryService as bc, chatService as bd, checkoutService as be, collectionService as bf, contactService as bg, countryService as bh, couponService as bi, currencyExponent as bj, currencyService as bk, dealService as bl, demoRequestService as bm, emptyCart as bn, emptyPage as bo, enquiryService as bp, faqService as bq, feedbackService as br, fromEngineAddress as bs, fromIdentityAddress as bt, fromSearchDoc as bu, galleryService as bv, homeService as bw, initService as bx, layoutService as by, mediaUrl as bz, type Approval as c, toCart as c0, toCartLine as c1, toCategory as c2, toCmsPage as c3, toCollection as c4, toEngineAddress as c5, toIdentityAddress as c6, toMajor as c7, toMinor as c8, toOrder as c9, toPage as ca, toProduct as cb, toRating as cc, toStorefrontFacets as cd, toUser as ce, toVariant as cf, toVendor as cg, uploadService as ch, userService as ci, variantService as cj, varniCustomDesignService as ck, varniCustomProductService as cl, vendorService as cm, warrantyService as cn, wishlistService as co, type AuthResponse as d, AuthService as e, AutocompleteService as f, type B2bRole as g, B2bService as h, BannerService as i, BaseService as j, BlogService as k, type CartLine as l, CartService as m, CatalogService as n, type Category as o, CategoryService as p, ChatService as q, type CheckoutOptions as r, type CheckoutResult as s, CheckoutService as t, type CmsPage as u, type Collection as v, CollectionService as w, type Company as x, type CompanyOrder as y, ContactService as z };

package/dist/{index-DSvV8FbK.d.ts → index-90wdO5MM.d.ts}

@@ -109,6 +109,29 @@ type ListMeta = {
     offset: number;
     page: number;
     total_pages: number;
+    /** Only on `GET /api/products?facets=1`, from an engine that counts them (D130). */
+    facets?: ProductFacets;
+};
+type FacetValue = {
+    value: string;
+    count: number;
+};
+/** core/catalog_facets.go: counted over the whole listing, each group without its own selection. */
+type ProductFacets = {
+    price: {
+        min: Money;
+        max: Money;
+    } | null;
+    tags: FacetValue[] | null;
+    vendors: FacetValue[] | null;
+    product_types: FacetValue[] | null;
+    categories: {
+        id: number;
+        slug: string;
+        title: string;
+        count: number;
+    }[] | null;
+    attributes: Record<string, FacetValue[]> | null;
 };
 type Envelope<T> = {
     data: T;
@@ -1327,6 +1350,16 @@ type CatalogQuery = {
      * are not applied.
      */
     attributes?: Record<string, string[]>;
+    tags?: string[];
+    vendors?: string[];
+    productTypes?: string[];
+    /**
+     * Ask the engine to count the filter values too. Such a query goes to
+     * `GET /api/products`, which then also answers the category, the price
+     * range, the sort and every filter above (D130); an engine too old to count
+     * them is asked the way it always was, and the page has no facets.
+     */
+    facets?: boolean;
 };
 type CatalogPage = {
     data: ReturnType<typeof toProduct>[] | ReturnType<typeof fromSearchDoc>[];
@@ -1340,17 +1373,8 @@ type CatalogPage = {
     }[];
     /** Whether the answer honoured `sort` and the price range, or had to drop them. */
     sorted: boolean;
+    facets?: ProductFacets;
 };
-/**
- * One shelf of products, from whichever engine route can answer the question.
- *
- * - A category, no reordering: `GET /api/categories/{slug}`, which sells the
- *   category and its descendants.
- * - A search or the whole shop, no reordering: `GET /api/products?q=`.
- * - Any sort but newest, or a price range: the Meilisearch module, when it is
- *   installed and configured. Without it the shelf comes back in the engine's
- *   order with `sorted: false`, rather than failing or pretending.
- */
 declare class CatalogService extends BaseService {
     protected readonly facts: StoreFacts;
     protected queryCatalog(q: CatalogQuery): Promise<CatalogPage>;
@@ -1968,14 +1992,39 @@ declare class ProductService extends CatalogService {
 }
 declare const productService: ProductService;
 
+/**
+ * The engine's counts in the shape the storefront's filter rail reads. Each
+ * `allFilters` key is also the URL parameter the rail writes when a value is
+ * ticked, and `searchWithUrl` reads it back: `vendor`, `product_type` and
+ * `attributes.<handle>`. Tags go to the rail's own tag group, written as `tags`.
+ */
+declare function toStorefrontFacets(f?: ProductFacets | null): {
+    priceStat: {
+        min: number;
+        max: number;
+    } | {
+        min?: undefined;
+        max?: undefined;
+    };
+    categories: {
+        name: string;
+        slug: string;
+        count: number;
+    }[];
+    tags: {
+        name: string;
+        count: number;
+    }[];
+    allFilters: Record<string, Record<string, number>>;
+};
 /**
  * The listing pages' search: `/products?search=&sort=&page=` and the category
  * catch-all `/{slug}`.
  *
- * Facets are empty. The engine's search route returns hits and a total, not
- * distributions, and a facet list made from one page of hits would count that
- * page, not the shop. An empty `priceStat` hides the price slider rather than
- * drawing one with a made-up range.
+ * Facets come from the engine, counted over the whole listing rather than the
+ * page (D130). An engine too old to count them leaves them empty, and an empty
+ * `priceStat` hides the price slider rather than drawing one with a made-up
+ * range.
  */
 declare class SearchService extends CatalogService {
     emptyResult(): {
@@ -1987,10 +2036,23 @@ declare class SearchService extends CatalogService {
             slug: string;
         }[];
         facets: {
-            priceStat: {};
-            categories: never[];
-            tags: never[];
-            allFilters: {};
+            priceStat: {
+                min: number;
+                max: number;
+            } | {
+                min?: undefined;
+                max?: undefined;
+            };
+            categories: {
+                name: string;
+                slug: string;
+                count: number;
+            }[];
+            tags: {
+                name: string;
+                count: number;
+            }[];
+            allFilters: Record<string, Record<string, number>>;
         };
     };
     searchWithUrl(url: URL | string, slug?: string): Promise<{
@@ -2002,10 +2064,23 @@ declare class SearchService extends CatalogService {
             slug: string;
         }[];
         facets: {
-            priceStat: {};
-            categories: never[];
-            tags: never[];
-            allFilters: {};
+            priceStat: {
+                min: number;
+                max: number;
+            } | {
+                min?: undefined;
+                max?: undefined;
+            };
+            categories: {
+                name: string;
+                slug: string;
+                count: number;
+            }[];
+            tags: {
+                name: string;
+                count: number;
+            }[];
+            allFilters: Record<string, Record<string, number>>;
         };
     } | {
         data: {
@@ -2154,10 +2229,23 @@ declare class SearchService extends CatalogService {
             slug: string;
         }[];
         facets: {
-            priceStat: {};
-            categories: never[];
-            tags: never[];
-            allFilters: {};
+            priceStat: {
+                min: number;
+                max: number;
+            } | {
+                min?: undefined;
+                max?: undefined;
+            };
+            categories: {
+                name: string;
+                slug: string;
+                count: number;
+            }[];
+            tags: {
+                name: string;
+                count: number;
+            }[];
+            allFilters: Record<string, Record<string, number>>;
         };
     }>;
 }
@@ -5577,8 +5665,15 @@ declare class MenuService extends BaseService {
     listMenus(): Promise<MenuSummary[]>;
     /** One menu by handle, in the storefront's shape: `{ menuId, name, items: [{ id, name, link, items }] }`. */
     getMenu(handle: string): Promise<StorefrontMenu>;
-    /** The header and footer menus, or `null` when the module is not there. Cached: a menu is store-level. */
+    /**
+     * The header and footer menus, or `null` when the module is not there. Cached: a menu is
+     * store-level. Each is the menu the shop chose for it in the theme editor's header or footer
+     * (GoCommerce D131), still under the `header` / `footer` id every storefront looks for, so the
+     * choice reaches every place that draws one; the menus named so are the default.
+     */
     engineMenus(): Promise<StorefrontMenu[] | null>;
+    /** The handle of the menu the published header or footer names, else the part's own name. */
+    private chosenMenu;
 }
 declare const menuService: MenuService;
 
@@ -5742,7 +5837,7 @@ type HomeLayoutSection = {
  * or `main-collection` (the collection's grid) — at the place the shop put
  * it, and the storefront draws its own core there.
  */
-type LayoutPage = 'home' | 'product' | 'collection';
+type LayoutPage = 'home' | 'product' | 'collection' | 'header' | 'footer';
 type HomeLayout = {
     page: string;
     theme: string;
@@ -5762,6 +5857,50 @@ type ThemeSettingsResult = {
     preview: boolean;
     settings: ThemeSettings;
 };
+/**
+ * The header's settings as the shop set them (ext/layouts, D131): the strip
+ * above the header — shown or not, its words, its link, and whether it is on
+ * every page or the home page only — and the handle of the menu across it.
+ * Plain text, and a link that is `/path` or `http(s)://`.
+ */
+type HeaderSettings = {
+    show_announcement?: boolean;
+    announcement_text?: string;
+    announcement_link?: string;
+    announcement_pages?: 'all' | 'home';
+    menu?: string;
+};
+/** A footer's link to the shop's page on a social network; `url` is always `http(s)://`. */
+type SocialLink = {
+    network: 'instagram' | 'facebook' | 'x' | 'youtube' | 'pinterest' | 'linkedin' | 'whatsapp' | 'telegram';
+    url: string;
+};
+/**
+ * The footer's settings (D131): the handle of the menu whose top-level links
+ * become its columns, a few words about the shop, whether the newsletter
+ * sign-up shows (absent while the newsletter is off), social links and the
+ * copyright line. An absent one means the storefront keeps its own.
+ */
+type FooterSettings = {
+    menu?: string;
+    about?: string;
+    newsletter?: boolean;
+    social?: SocialLink[];
+    copyright?: string;
+};
+/**
+ * The published header or footer, or a preview key's draft, with the menu
+ * it names already read — live, so a menu edited in the panel shows without a
+ * publish. `menu` is null when none is named or the named one is gone.
+ */
+type SiteChrome<S> = {
+    revision?: number;
+    preview: boolean;
+    settings: S;
+    menu: StorefrontMenu | null;
+};
+type SiteHeader = SiteChrome<HeaderSettings>;
+type SiteFooter = SiteChrome<FooterSettings>;
 /**
  * Composed pages from ext/layouts. A store without one — the plugin off,
  * nothing published, an engine built without the module, or a preview key
@@ -5798,6 +5937,20 @@ declare class LayoutService extends BaseService {
     getThemeSettings({ preview }?: {
         preview?: string | null;
     }): Promise<ThemeSettingsResult | null>;
+    /**
+     * The header the shop set in the theme editor (D131), drawn on every
+     * page: the published one, or a preview key's draft. Null — the
+     * storefront's own header — when none is published, the editor is off, the
+     * engine is older, or anything fails: a header is never worth an error page.
+     */
+    getHeader({ preview }?: {
+        preview?: string | null;
+    }): Promise<SiteHeader | null>;
+    /** The footer the shop set in the theme editor (D131); null for the storefront's own, as getHeader. */
+    getFooter({ preview }?: {
+        preview?: string | null;
+    }): Promise<SiteFooter | null>;
+    private chrome;
 }
 declare const layoutService: LayoutService;
 
@@ -6941,4 +7094,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { LayoutService as $, type Address as A, type B2bPlaced as B, type Cart as C, CountryService as D, CouponService as E, type Credentials as F, type Credit as G, CurrencyService as H, type Customer as I, DealService as J, DemoRequestService as K, type EngineRequest as L, EnquiryService as M, type Envelope as N, type Faq as O, FaqService as P, FeedbackService as Q, type Fulfillment as R, GalleryService as S, type HomeLayout as T, type HomeLayoutSection as U, HomeService as V, type IdentityAddress as W, InitService as X, type Invitation as Y, type LayoutCollection as Z, type LayoutPage as _, AddressService as a, autocompleteService as a$, type Lead as a0, type ListMeta as a1, MeilisearchService as a2, type Member as a3, type Menu as a4, type MenuItem as a5, MenuService as a6, type MenuSummary as a7, type Money as a8, NewsletterService as a9, SearchService as aA, SettingService as aB, type ShippingRate as aC, StateService as aD, type StoreProfile as aE, StoreService as aF, type StorefrontCategory as aG, type StorefrontMenu as aH, type StorefrontOrder as aI, type StorefrontProduct as aJ, type ThemeSettings as aK, type ThemeSettingsResult as aL, UploadService as aM, UserService as aN, type Variant as aO, type VariantImage as aP, VariantService as aQ, VarniCustomDesignService as aR, VarniCustomProductService as aS, type Vendor as aT, VendorService as aU, WarrantyService as aV, type Wishlist as aW, type WishlistItem as aX, WishlistService as aY, addressService as aZ, authService as a_, type Offer as aa, type Order as ab, type OrderLine as ac, OrderService as ad, type PageLayout as ae, PageService as af, type PaymentIntent as ag, PaymentMethodService as ah, type Plugin as ai, PluginService as aj, PopularSearchService as ak, PopularityService as al, type Product as am, type ProductOption as an, ProductService as ao, ProfileService as ap, type Quote as aq, REDIRECT_GATEWAYS as ar, ReelsService as as, RegionService as at, type RejectedLine as au, type Review as av, type ReviewPage as aw, ReviewService as ax, type SearchDoc as ay, type SearchResult as az, type AppliedDiscount as b, toMajor as b$, b2bService as b0, bannerService as b1, blogService as b2, cartService as b3, categoryService as b4, chatService as b5, checkoutService as b6, collectionService as b7, contactService as b8, countryService as b9, pluginService as bA, pluginsService as bB, popularSearchService as bC, popularityService as bD, priceOf as bE, productImages as bF, productService as bG, profileService as bH, qs as bI, reelsService as bJ, regionService as bK, reviewService as bL, searchService as bM, setRequestHost as bN, settingService as bO, settingsService as bP, stateService as bQ, staticStore as bR, storeForHost as bS, storeService as bT, toCart as bU, toCartLine as bV, toCategory as bW, toCmsPage as bX, toCollection as bY, toEngineAddress as bZ, toIdentityAddress as b_, couponService as ba, currencyExponent as bb, currencyService as bc, dealService as bd, demoRequestService as be, emptyCart as bf, emptyPage as bg, enquiryService as bh, faqService as bi, feedbackService as bj, fromEngineAddress as bk, fromIdentityAddress as bl, fromSearchDoc as bm, galleryService as bn, homeService as bo, initService as bp, layoutService as bq, mediaUrl as br, meilisearchService as bs, menuService as bt, minorToMajor as bu, newsletterService as bv, orderService as bw, ownDomain as bx, pageService as by, paymentMethodService as bz, type Approval as c, toMinor as c0, toOrder as c1, toPage as c2, toProduct as c3, toRating as c4, toUser as c5, toVariant as c6, toVendor as c7, uploadService as c8, userService as c9, variantService as ca, varniCustomDesignService as cb, varniCustomProductService as cc, vendorService as cd, warrantyService as ce, wishlistService as cf, type AuthResponse as d, AuthService as e, AutocompleteService as f, type B2bRole as g, B2bService as h, BannerService as i, BaseService as j, BlogService as k, type CartLine as l, CartService as m, CatalogService as n, type Category as o, CategoryService as p, ChatService as q, type CheckoutOptions as r, type CheckoutResult as s, CheckoutService as t, type CmsPage as u, type Collection as v, CollectionService as w, type Company as x, type CompanyOrder as y, ContactService as z };
+export { type Invitation as $, type Address as A, type B2bPlaced as B, type Cart as C, CountryService as D, CouponService as E, type Credentials as F, type Credit as G, CurrencyService as H, type Customer as I, DealService as J, DemoRequestService as K, type EngineRequest as L, EnquiryService as M, type Envelope as N, type FacetValue as O, type Faq as P, FaqService as Q, FeedbackService as R, type FooterSettings as S, type Fulfillment as T, GalleryService as U, type HeaderSettings as V, type HomeLayout as W, type HomeLayoutSection as X, HomeService as Y, type IdentityAddress as Z, InitService as _, AddressService as a, type Vendor as a$, type LayoutCollection as a0, type LayoutPage as a1, LayoutService as a2, type Lead as a3, type ListMeta as a4, MeilisearchService as a5, type Member as a6, type Menu as a7, type MenuItem as a8, MenuService as a9, type ReviewPage as aA, ReviewService as aB, type SearchDoc as aC, type SearchResult as aD, SearchService as aE, SettingService as aF, type ShippingRate as aG, type SiteChrome as aH, type SiteFooter as aI, type SiteHeader as aJ, type SocialLink as aK, StateService as aL, type StoreProfile as aM, StoreService as aN, type StorefrontCategory as aO, type StorefrontMenu as aP, type StorefrontOrder as aQ, type StorefrontProduct as aR, type ThemeSettings as aS, type ThemeSettingsResult as aT, UploadService as aU, UserService as aV, type Variant as aW, type VariantImage as aX, VariantService as aY, VarniCustomDesignService as aZ, VarniCustomProductService as a_, type MenuSummary as aa, type Money as ab, NewsletterService as ac, type Offer as ad, type Order as ae, type OrderLine as af, OrderService as ag, type PageLayout as ah, PageService as ai, type PaymentIntent as aj, PaymentMethodService as ak, type Plugin as al, PluginService as am, PopularSearchService as an, PopularityService as ao, type Product as ap, type ProductFacets as aq, type ProductOption as ar, ProductService as as, ProfileService as at, type Quote as au, REDIRECT_GATEWAYS as av, ReelsService as aw, RegionService as ax, type RejectedLine as ay, type Review as az, type AppliedDiscount as b, storeService as b$, VendorService as b0, WarrantyService as b1, type Wishlist as b2, type WishlistItem as b3, WishlistService as b4, addressService as b5, authService as b6, autocompleteService as b7, b2bService as b8, bannerService as b9, meilisearchService as bA, menuService as bB, minorToMajor as bC, newsletterService as bD, orderService as bE, ownDomain as bF, pageService as bG, paymentMethodService as bH, pluginService as bI, pluginsService as bJ, popularSearchService as bK, popularityService as bL, priceOf as bM, productImages as bN, productService as bO, profileService as bP, qs as bQ, reelsService as bR, regionService as bS, reviewService as bT, searchService as bU, setRequestHost as bV, settingService as bW, settingsService as bX, stateService as bY, staticStore as bZ, storeForHost as b_, blogService as ba, cartService as bb, categoryService as bc, chatService as bd, checkoutService as be, collectionService as bf, contactService as bg, countryService as bh, couponService as bi, currencyExponent as bj, currencyService as bk, dealService as bl, demoRequestService as bm, emptyCart as bn, emptyPage as bo, enquiryService as bp, faqService as bq, feedbackService as br, fromEngineAddress as bs, fromIdentityAddress as bt, fromSearchDoc as bu, galleryService as bv, homeService as bw, initService as bx, layoutService as by, mediaUrl as bz, type Approval as c, toCart as c0, toCartLine as c1, toCategory as c2, toCmsPage as c3, toCollection as c4, toEngineAddress as c5, toIdentityAddress as c6, toMajor as c7, toMinor as c8, toOrder as c9, toPage as ca, toProduct as cb, toRating as cc, toStorefrontFacets as cd, toUser as ce, toVariant as cf, toVendor as cg, uploadService as ch, userService as ci, variantService as cj, varniCustomDesignService as ck, varniCustomProductService as cl, vendorService as cm, warrantyService as cn, wishlistService as co, type AuthResponse as d, AuthService as e, AutocompleteService as f, type B2bRole as g, B2bService as h, BannerService as i, BaseService as j, BlogService as k, type CartLine as l, CartService as m, CatalogService as n, type Category as o, CategoryService as p, ChatService as q, type CheckoutOptions as r, type CheckoutResult as s, CheckoutService as t, type CmsPage as u, type Collection as v, CollectionService as w, type Company as x, type CompanyOrder as y, ContactService as z };