@misiki/gocommerce-connector 0.7.0 → 0.9.0

package/README.md

@@ -36,10 +36,11 @@ engine's routes start with `/api` too.
 
 ### The engine
 
-Start it with the modules the storefront has screens for:
+Start it with the modules the storefront has screens for. The flags go before
+`serve`; the engine ignores any that come after it.
 
 ```bash
-gocommerce serve -identity -wishlist -reviews -cms -faq -menus
+gocommerce -identity -wishlist -reviews -cms -faq -menus serve
 ```
 
 Each is optional. Without `-identity` there is no sign-in (guest checkout
@@ -50,11 +51,19 @@ business buyers (see "Beyond the storefront's screens").
 
 ### The browser and CORS
 
-The engine sends no CORS headers, so a browser on the storefront's origin cannot
-read a response from the engine's. Server-side rendering is unaffected; it is
-the bag, sign-in and checkout — which run in the browser — that need a route.
+The engine sends CORS headers only to the origins listed in
+`GOCOMMERCE_CORS_ORIGINS` (comma-separated, or `*` for any). Unset, a browser on
+the storefront's origin cannot read a response from the engine's. Server-side
+rendering is unaffected; it is the bag, sign-in and checkout — which run in the
+browser — that need a route.
 
-Proxy a path on the storefront's own origin to the engine and name it in
+The simplest is to list the storefront's origin when starting the engine,
+`GOCOMMERCE_CORS_ORIGINS=https://shop.example`, and leave
+`PUBLIC_GOCOMMERCE_PROXY_PATH` unset. The browser then calls
+`PUBLIC_GOCOMMERCE_API_URL` directly, so that has to be an address the
+shopper's browser can reach.
+
+Or proxy a path on the storefront's own origin to the engine and name it in
 `PUBLIC_GOCOMMERCE_PROXY_PATH`. The browser then calls
 `https://shop.example/gocommerce/api/carts`, and the server keeps calling
 `PUBLIC_GOCOMMERCE_API_URL` directly. With Caddy:
@@ -129,7 +138,9 @@ down stays best-effort: the storefront renders from its static record.
 | reviews | `/x/reviews` |
 | content pages (`/p/…`, legal pages) | `/x/cms/pages` |
 | FAQ | `/x/faq` |
-| composed home page | `/x/layouts/home` (`?preview=` for a draft) — `layoutService.getHomeLayout()`, null when the store has none |
+| 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 |
+| 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 |
 | attribute filters (`?attributes.color=Red`) | `/api/products?attr=color:Red` |
@@ -248,7 +259,7 @@ real one, seeding what they need through the admin API under names unique to
 the run:
 
 ```bash
-gocommerce serve -admin-token dev-token -identity -wishlist -reviews -cms -faq -menus -newsletter -contact -b2b
+gocommerce -admin-token dev-token -identity -wishlist -reviews -cms -faq -menus -newsletter -contact -b2b serve
 GOCOMMERCE_URL=http://127.0.0.1:8080 GOCOMMERCE_ADMIN_TOKEN=dev-token \
 GOCOMMERCE_TEST_DB=postgres://…/the-stores-database npm test
 ```

package/dist/{index-D-hnd6-D.d.cts → index-72kQMxjZ.d.cts}

@@ -5832,18 +5832,43 @@ declare class FaqService extends BaseService {
 declare const pageService: PageService;
 declare const faqService: FaqService;
 
+/**
+ * The store's design tokens (ext/layouts, D127). Every key is optional and
+ * an absent one means the storefront keeps its own look: colours are
+ * `#rrggbb`, fonts are keys of the storefront's font list, `radius` is
+ * none, small, medium or large.
+ */
+type ThemeSettings = Partial<Record<'background' | 'text' | 'accent' | 'accent_text' | 'muted' | 'heading_font' | 'body_font' | 'radius', string>>;
+/** A collection list's card: enough to draw a picture and a title and link to it. */
+type LayoutCollection = {
+    id: string;
+    title: string;
+    slug: string;
+    link: string;
+    image: string | null;
+};
 /**
  * One section of a composed page. `settings` is the merchant's, as validated
  * by the engine: plain text (never HTML) and links that are `/path` or
  * `http(s)://`. A product grid also carries its products, resolved live and
- * mapped like any other product the storefront renders.
+ * mapped like any other product the storefront renders; a collection list
+ * carries its collections.
  */
 type HomeLayoutSection = {
     id: string;
     type: string;
     settings: Record<string, unknown>;
     products?: StorefrontProduct[];
+    collections?: LayoutCollection[];
 };
+/**
+ * A page the shop arranges: the home page, or the template every product or
+ * every collection is drawn in (ext/layouts, D128). A template holds its
+ * core once — `main-product` (the catalogue's pictures, price and buy box)
+ * 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 HomeLayout = {
     page: string;
     theme: string;
@@ -5851,8 +5876,18 @@ type HomeLayout = {
     revision?: number;
     /** True when this is the saved draft shown through a preview key. */
     preview: boolean;
+    /** The design tokens published with the page, or null for none. */
+    themeSettings: ThemeSettings | null;
     sections: HomeLayoutSection[];
 };
+/** A composed page of any kind; a template's `themeSettings` is always null. */
+type PageLayout = HomeLayout;
+/** The design tokens alone, for every page the storefront draws. */
+type ThemeSettingsResult = {
+    revision?: number;
+    preview: boolean;
+    settings: ThemeSettings;
+};
 /**
  * Composed pages from ext/layouts. A store without one — the plugin off,
  * nothing published, an engine built without the module, or a preview key
@@ -5863,6 +5898,32 @@ declare class LayoutService extends BaseService {
     getHomeLayout({ preview }?: {
         preview?: string | null;
     }): Promise<HomeLayout | null>;
+    /**
+     * The template every product page is drawn in: the sections around the
+     * product's core (`main-product`). Null when none is published, so the
+     * product page draws exactly as it did before templates existed.
+     */
+    getProductLayout({ preview }?: {
+        preview?: string | null;
+    }): Promise<PageLayout | null>;
+    /** The template every collection page is drawn in, around its grid (`main-collection`). */
+    getCollectionLayout({ preview }?: {
+        preview?: string | null;
+    }): Promise<PageLayout | null>;
+    /** Any arranged page by its key; null for none, as the three above. */
+    getPageLayout(page: LayoutPage, { preview }?: {
+        preview?: string | null;
+    }): Promise<PageLayout | null>;
+    /**
+     * The store's design tokens, for a page other than the home page: the
+     * published ones, or a preview key's draft. Null when there are none to
+     * apply — nothing published, the editor off, an engine without the
+     * module — and on any failure too: a missing look must never cost the
+     * page.
+     */
+    getThemeSettings({ preview }?: {
+        preview?: string | null;
+    }): Promise<ThemeSettingsResult | null>;
 }
 declare const layoutService: LayoutService;
 
@@ -7006,4 +7067,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type ListMeta 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, LayoutService as Z, type Lead as _, AddressService as a, categoryService as a$, MeilisearchService as a0, type Member as a1, type Menu as a2, type MenuItem as a3, MenuService as a4, type MenuSummary as a5, type Money as a6, NewsletterService as a7, type Offer as a8, type Order as a9, StateService as aA, type StoreProfile as aB, StoreService as aC, type StorefrontCategory as aD, type StorefrontMenu as aE, type StorefrontOrder as aF, type StorefrontProduct as aG, UploadService as aH, UserService as aI, type Variant as aJ, type VariantImage as aK, VariantService as aL, VarniCustomDesignService as aM, VarniCustomProductService as aN, type Vendor as aO, VendorService as aP, WarrantyService as aQ, type Wishlist as aR, type WishlistItem as aS, WishlistService as aT, addressService as aU, authService as aV, autocompleteService as aW, b2bService as aX, bannerService as aY, blogService as aZ, cartService as a_, type OrderLine as aa, OrderService as ab, PageService as ac, type PaymentIntent as ad, PaymentMethodService as ae, type Plugin as af, PluginService as ag, PopularSearchService as ah, PopularityService as ai, type Product as aj, type ProductOption as ak, ProductService as al, ProfileService as am, type Quote as an, REDIRECT_GATEWAYS as ao, ReelsService as ap, RegionService as aq, type RejectedLine as ar, type Review as as, type ReviewPage as at, ReviewService as au, type SearchDoc as av, type SearchResult as aw, SearchService as ax, SettingService as ay, type ShippingRate as az, type AppliedDiscount as b, toRating as b$, chatService as b0, checkoutService as b1, collectionService as b2, contactService as b3, countryService as b4, couponService as b5, currencyExponent as b6, currencyService as b7, dealService as b8, demoRequestService as b9, productImages as bA, productService as bB, profileService as bC, qs as bD, reelsService as bE, regionService as bF, reviewService as bG, searchService as bH, setRequestHost as bI, settingService as bJ, settingsService as bK, stateService as bL, staticStore as bM, storeForHost as bN, storeService as bO, toCart as bP, toCartLine as bQ, toCategory as bR, toCmsPage as bS, toCollection as bT, toEngineAddress as bU, toIdentityAddress as bV, toMajor as bW, toMinor as bX, toOrder as bY, toPage as bZ, toProduct as b_, emptyCart as ba, emptyPage as bb, enquiryService as bc, faqService as bd, feedbackService as be, fromEngineAddress as bf, fromIdentityAddress as bg, fromSearchDoc as bh, galleryService as bi, homeService as bj, initService as bk, layoutService as bl, mediaUrl as bm, meilisearchService as bn, menuService as bo, minorToMajor as bp, newsletterService as bq, orderService as br, ownDomain as bs, pageService as bt, paymentMethodService as bu, pluginService as bv, pluginsService as bw, popularSearchService as bx, popularityService as by, priceOf as bz, type Approval as c, toUser as c0, toVariant as c1, toVendor as c2, uploadService as c3, userService as c4, variantService as c5, varniCustomDesignService as c6, varniCustomProductService as c7, vendorService as c8, warrantyService as c9, wishlistService as ca, 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 { 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 };

package/dist/{index-D-hnd6-D.d.ts → index-72kQMxjZ.d.ts}

@@ -5832,18 +5832,43 @@ declare class FaqService extends BaseService {
 declare const pageService: PageService;
 declare const faqService: FaqService;
 
+/**
+ * The store's design tokens (ext/layouts, D127). Every key is optional and
+ * an absent one means the storefront keeps its own look: colours are
+ * `#rrggbb`, fonts are keys of the storefront's font list, `radius` is
+ * none, small, medium or large.
+ */
+type ThemeSettings = Partial<Record<'background' | 'text' | 'accent' | 'accent_text' | 'muted' | 'heading_font' | 'body_font' | 'radius', string>>;
+/** A collection list's card: enough to draw a picture and a title and link to it. */
+type LayoutCollection = {
+    id: string;
+    title: string;
+    slug: string;
+    link: string;
+    image: string | null;
+};
 /**
  * One section of a composed page. `settings` is the merchant's, as validated
  * by the engine: plain text (never HTML) and links that are `/path` or
  * `http(s)://`. A product grid also carries its products, resolved live and
- * mapped like any other product the storefront renders.
+ * mapped like any other product the storefront renders; a collection list
+ * carries its collections.
  */
 type HomeLayoutSection = {
     id: string;
     type: string;
     settings: Record<string, unknown>;
     products?: StorefrontProduct[];
+    collections?: LayoutCollection[];
 };
+/**
+ * A page the shop arranges: the home page, or the template every product or
+ * every collection is drawn in (ext/layouts, D128). A template holds its
+ * core once — `main-product` (the catalogue's pictures, price and buy box)
+ * 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 HomeLayout = {
     page: string;
     theme: string;
@@ -5851,8 +5876,18 @@ type HomeLayout = {
     revision?: number;
     /** True when this is the saved draft shown through a preview key. */
     preview: boolean;
+    /** The design tokens published with the page, or null for none. */
+    themeSettings: ThemeSettings | null;
     sections: HomeLayoutSection[];
 };
+/** A composed page of any kind; a template's `themeSettings` is always null. */
+type PageLayout = HomeLayout;
+/** The design tokens alone, for every page the storefront draws. */
+type ThemeSettingsResult = {
+    revision?: number;
+    preview: boolean;
+    settings: ThemeSettings;
+};
 /**
  * Composed pages from ext/layouts. A store without one — the plugin off,
  * nothing published, an engine built without the module, or a preview key
@@ -5863,6 +5898,32 @@ declare class LayoutService extends BaseService {
     getHomeLayout({ preview }?: {
         preview?: string | null;
     }): Promise<HomeLayout | null>;
+    /**
+     * The template every product page is drawn in: the sections around the
+     * product's core (`main-product`). Null when none is published, so the
+     * product page draws exactly as it did before templates existed.
+     */
+    getProductLayout({ preview }?: {
+        preview?: string | null;
+    }): Promise<PageLayout | null>;
+    /** The template every collection page is drawn in, around its grid (`main-collection`). */
+    getCollectionLayout({ preview }?: {
+        preview?: string | null;
+    }): Promise<PageLayout | null>;
+    /** Any arranged page by its key; null for none, as the three above. */
+    getPageLayout(page: LayoutPage, { preview }?: {
+        preview?: string | null;
+    }): Promise<PageLayout | null>;
+    /**
+     * The store's design tokens, for a page other than the home page: the
+     * published ones, or a preview key's draft. Null when there are none to
+     * apply — nothing published, the editor off, an engine without the
+     * module — and on any failure too: a missing look must never cost the
+     * page.
+     */
+    getThemeSettings({ preview }?: {
+        preview?: string | null;
+    }): Promise<ThemeSettingsResult | null>;
 }
 declare const layoutService: LayoutService;
 
@@ -7006,4 +7067,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type ListMeta 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, LayoutService as Z, type Lead as _, AddressService as a, categoryService as a$, MeilisearchService as a0, type Member as a1, type Menu as a2, type MenuItem as a3, MenuService as a4, type MenuSummary as a5, type Money as a6, NewsletterService as a7, type Offer as a8, type Order as a9, StateService as aA, type StoreProfile as aB, StoreService as aC, type StorefrontCategory as aD, type StorefrontMenu as aE, type StorefrontOrder as aF, type StorefrontProduct as aG, UploadService as aH, UserService as aI, type Variant as aJ, type VariantImage as aK, VariantService as aL, VarniCustomDesignService as aM, VarniCustomProductService as aN, type Vendor as aO, VendorService as aP, WarrantyService as aQ, type Wishlist as aR, type WishlistItem as aS, WishlistService as aT, addressService as aU, authService as aV, autocompleteService as aW, b2bService as aX, bannerService as aY, blogService as aZ, cartService as a_, type OrderLine as aa, OrderService as ab, PageService as ac, type PaymentIntent as ad, PaymentMethodService as ae, type Plugin as af, PluginService as ag, PopularSearchService as ah, PopularityService as ai, type Product as aj, type ProductOption as ak, ProductService as al, ProfileService as am, type Quote as an, REDIRECT_GATEWAYS as ao, ReelsService as ap, RegionService as aq, type RejectedLine as ar, type Review as as, type ReviewPage as at, ReviewService as au, type SearchDoc as av, type SearchResult as aw, SearchService as ax, SettingService as ay, type ShippingRate as az, type AppliedDiscount as b, toRating as b$, chatService as b0, checkoutService as b1, collectionService as b2, contactService as b3, countryService as b4, couponService as b5, currencyExponent as b6, currencyService as b7, dealService as b8, demoRequestService as b9, productImages as bA, productService as bB, profileService as bC, qs as bD, reelsService as bE, regionService as bF, reviewService as bG, searchService as bH, setRequestHost as bI, settingService as bJ, settingsService as bK, stateService as bL, staticStore as bM, storeForHost as bN, storeService as bO, toCart as bP, toCartLine as bQ, toCategory as bR, toCmsPage as bS, toCollection as bT, toEngineAddress as bU, toIdentityAddress as bV, toMajor as bW, toMinor as bX, toOrder as bY, toPage as bZ, toProduct as b_, emptyCart as ba, emptyPage as bb, enquiryService as bc, faqService as bd, feedbackService as be, fromEngineAddress as bf, fromIdentityAddress as bg, fromSearchDoc as bh, galleryService as bi, homeService as bj, initService as bk, layoutService as bl, mediaUrl as bm, meilisearchService as bn, menuService as bo, minorToMajor as bp, newsletterService as bq, orderService as br, ownDomain as bs, pageService as bt, paymentMethodService as bu, pluginService as bv, pluginsService as bw, popularSearchService as bx, popularityService as by, priceOf as bz, type Approval as c, toUser as c0, toVariant as c1, toVendor as c2, uploadService as c3, userService as c4, variantService as c5, varniCustomDesignService as c6, varniCustomProductService as c7, vendorService as c8, warrantyService as c9, wishlistService as ca, 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 { 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 };

package/dist/index.cjs

@@ -2758,12 +2758,28 @@ var pageService = new PageService();
 var faqService = new FaqService();
 
 // src/services/layout-service.ts
-var IMAGE_KEYS = ["image", "mobile_image"];
+var MEDIA_KEYS = /* @__PURE__ */ new Set(["image", "mobile_image", "poster", "video_file"]);
 var LayoutService = class extends BaseService {
   async getHomeLayout({ preview } = {}) {
+    return this.getPageLayout("home", { preview });
+  }
+  /**
+   * The template every product page is drawn in: the sections around the
+   * product's core (`main-product`). Null when none is published, so the
+   * product page draws exactly as it did before templates existed.
+   */
+  async getProductLayout({ preview } = {}) {
+    return this.getPageLayout("product", { preview });
+  }
+  /** The template every collection page is drawn in, around its grid (`main-collection`). */
+  async getCollectionLayout({ preview } = {}) {
+    return this.getPageLayout("collection", { preview });
+  }
+  /** Any arranged page by its key; null for none, as the three above. */
+  async getPageLayout(page, { preview } = {}) {
     let layout;
     try {
-      layout = await this.data("/x/layouts/home", {
+      layout = await this.data(`/x/layouts/${encodeURIComponent(page)}`, {
         query: { preview: preview?.trim() || void 0 }
       });
     } catch (err) {
@@ -2776,17 +2792,53 @@ var LayoutService = class extends BaseService {
       theme: layout.theme,
       revision: layout.revision,
       preview: !!layout.preview,
+      themeSettings: tokens(layout.theme_settings),
       sections: (layout.sections ?? []).map(toSection)
     };
   }
+  /**
+   * The store's design tokens, for a page other than the home page: the
+   * published ones, or a preview key's draft. Null when there are none to
+   * apply — nothing published, the editor off, an engine without the
+   * module — and on any failure too: a missing look must never cost the
+   * page.
+   */
+  async getThemeSettings({ preview } = {}) {
+    try {
+      const out = await this.data("/x/layouts/theme", {
+        query: { preview: preview?.trim() || void 0 }
+      });
+      if (!out) return null;
+      return { revision: out.revision, preview: !!out.preview, settings: tokens(out.settings) ?? {} };
+    } catch {
+      return null;
+    }
+  }
 };
-function toSection(s) {
-  const settings = { ...s.settings ?? {} };
-  for (const key of IMAGE_KEYS) {
-    if (typeof settings[key] === "string") settings[key] = mediaUrl(settings[key]);
+function tokens(v) {
+  return v && typeof v === "object" && !Array.isArray(v) && Object.keys(v).length ? { ...v } : null;
+}
+function withMedia(value, key) {
+  if (Array.isArray(value)) return value.map((x) => withMedia(x, null));
+  if (value && typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([k, x]) => [k, withMedia(x, k)]));
   }
+  if (key && MEDIA_KEYS.has(key) && typeof value === "string") return mediaUrl(value);
+  return value;
+}
+function toSection(s) {
+  const settings = withMedia(s.settings ?? {}, null);
   const out = { id: s.id, type: s.type, settings };
   if (s.type === "product-grid") out.products = (s.products ?? []).map((p) => toProduct(p));
+  if (s.type === "collection-list") {
+    out.collections = (s.collections ?? []).map((c) => ({
+      id: String(c.id),
+      title: c.title,
+      slug: c.slug,
+      link: `/collections/${c.slug}`,
+      image: mediaUrl(c.image) ?? null
+    }));
+  }
   return out;
 }
 var layoutService = new LayoutService();