@misiki/gocommerce-connector 0.3.1 → 0.4.1

package/README.md

@@ -26,6 +26,7 @@ PUBLIC_GOCOMMERCE_API_URL=https://api.shop.example    # the engine
 PUBLIC_GOCOMMERCE_PROXY_PATH=/gocommerce              # see "The browser and CORS"
 # PUBLIC_GOCOMMERCE_CHANNEL=web                       # a sales channel, if the store has several
 # PUBLIC_GOCOMMERCE_STORE=acme                        # under `gocommerce platform`, on a shared API host
+# PUBLIC_GOCOMMERCE_BASE_DOMAIN=shopnx.in             # or every store: acme.shopnx.in is store `acme`
 # PUBLIC_GOCOMMERCE_LANGUAGE=fr                       # ask for this language (?lang=) on every read
 ```
 
@@ -77,6 +78,35 @@ location /            { proxy_pass http://storefront:3000; }
 Serving the storefront and the engine from one origin works too; then leave the
 proxy path unset and point the API URL at that origin.
 
+### One storefront for every store
+
+Under `gocommerce platform` a storefront can sell for one store, named in
+`PUBLIC_GOCOMMERCE_STORE`, or for all of them. Set `PUBLIC_GOCOMMERCE_BASE_DOMAIN`
+to the domain the engine hands out subdomains of and point every
+`<slug>.<base domain>` at the one deployment: a request for `acme.shopnx.in` is
+sent to the engine with `X-Store: acme`, by the same rule the engine applies to
+its own host (one label, case-insensitive, a port ignored). A host outside the
+base domain falls back to `PUBLIC_GOCOMMERCE_STORE`, or to no store at all.
+
+The browser knows its own host. The server does not, so tell the connector where
+to read it, once, from `src/hooks.server.ts`:
+
+```ts
+import { getRequestEvent } from '$app/server'
+import { setRequestHost } from '@misiki/gocommerce-connector'
+
+setRequestHost(() => getRequestEvent().url.hostname)
+```
+
+Each store renders with the name, email and phone its owner set in the panel
+(`GET /api/store`); the static record's values stand only where the owner left
+one empty. Store-level facts (name, plugins, currency, menus) are cached per
+store, so two stores on one process never see each other's. A host under the base domain that names
+a store the engine does not have makes `getStoreByIdOrDomain` throw a
+`GoCommerceError` with status 404 and "store not found" in its message, which
+Svelte Commerce renders as its own "Store not found" page. An engine that is
+down stays best-effort: the storefront renders from its static record.
+
 ## What maps to what
 
 | Storefront | Engine |

package/dist/{index-D8lNRhqJ.d.cts → index-DIj1rK1d.d.cts}

@@ -31,6 +31,16 @@ interface Credentials {
      * shared API host. Leave unset when the store has a host of its own.
      */
     store?: string;
+    /**
+     * `PUBLIC_GOCOMMERCE_BASE_DOMAIN` — under `gocommerce platform`, the domain
+     * every store gets a subdomain of, `shopnx.in`. One storefront deployment
+     * then serves them all: a request for `acme.shopnx.in` is sent with
+     * `X-Store: acme`, the same rule the engine applies to its own host. A host
+     * outside the base domain falls back to `store`. Server-side the connector
+     * learns the request's host through `setRequestHost`; in the browser it is
+     * `window.location.hostname`.
+     */
+    baseDomain?: string;
     /**
      * `PUBLIC_GOCOMMERCE_CHANNEL` — the sales channel new carts and the product
      * listing belong to, when the store sells through more than one.
@@ -336,6 +346,13 @@ type Plugin = {
     title: string;
     settings: Record<string, unknown>;
 };
+/** `GET /api/store`: what anyone may read about the shop. */
+type StoreProfile = {
+    name: string;
+    email: string;
+    phone: string;
+    support_url: string;
+};
 type Vendor = {
     id: number;
     slug: string;
@@ -1163,6 +1180,13 @@ declare class BaseService {
     static setCredentials(creds: Partial<Credentials>): void;
     static getCredentials(): Credentials;
     protected get creds(): Credentials;
+    /**
+     * The store this call is for: the request host's subdomain under
+     * `baseDomain`, else the static `store`. Read per call, never stored on the
+     * instance, because the server shares one process (and one credentials
+     * object) across every concurrent request and each may be for a different host.
+     */
+    protected get store(): string | undefined;
     /**
      * The engine's base URL from wherever this code runs. In the browser a
      * configured proxy path wins, because the engine answers no CORS preflight.
@@ -1200,6 +1224,19 @@ declare class BaseService {
     delete<T = any>(path: string): Promise<T>;
     private raw;
 }
+/**
+ * Where the server learns the current request's host, for `baseDomain`. A
+ * SvelteKit storefront registers `() => getRequestEvent().url.hostname` once
+ * at boot; the browser needs nothing, it reads `window.location`.
+ */
+declare function setRequestHost(fn: () => string | undefined): void;
+/**
+ * `acme.shopnx.in` under `shopnx.in` is store `acme`; anything else is nobody's.
+ * The engine's own rule (`Stores.ByHost`): case-insensitive, a port and a
+ * trailing dot ignored, and exactly one label, so `a.b.shopnx.in` and
+ * `shopnx.in` itself name no store.
+ */
+declare function storeForHost(host: string | undefined, baseDomain: string | undefined): string | undefined;
 /** `?a=1&b=2`, dropping what was not asked for. Arrays repeat the key. */
 declare function qs(query?: Query): string;
 /** The family's list shape, from the engine's `{data, meta}`. Totals are the engine's, never invented. */
@@ -1234,6 +1271,8 @@ declare class StoreFacts extends BaseService {
         language: string;
         version: string;
     }>;
+    /** The store's own name and how a buyer reaches it, as set in its panel. */
+    profile(): Promise<StoreProfile>;
     checkoutOptions(): Promise<CheckoutOptions>;
     /**
      * The whole tree, flat and depth-first. Past 500 categories the engine
@@ -5202,12 +5241,16 @@ declare const menuService: MenuService;
 /**
  * The store record every page renders from.
  *
- * Name, logo, theme and the rest are the storefront's own (its static store,
+ * Logo, theme and the rest are the storefront's own (its static store,
  * registered through `setStaticStore`); the engine has no opinion on them.
- * Where the engine does have one, it wins: the settlement currency — every
- * price on the site is formatted with it, and a store record saying USD over
- * an engine charging INR would print the wrong symbol on every price — the
- * modules that back a storefront feature, and the menus.
+ * Where the engine does have one, it wins:
+ * - the store's name and contact, as its owner set them in the panel. One
+ *   storefront serves every store under `baseDomain`, so a name in the static
+ *   record would be every store's name;
+ * - the settlement currency. Every price on the site is formatted with it, and
+ *   a store record saying USD over an engine charging INR would print the
+ *   wrong symbol on every price;
+ * - the modules that back a storefront feature, and the menus.
  *
  * This runs on every request and a throw here takes every page down, so the
  * engine's half is best-effort: unreachable, the storefront still renders
@@ -6459,4 +6502,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type Menu 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, HomeService as T, type IdentityAddress as U, InitService as V, type Invitation as W, type Lead as X, type ListMeta as Y, MeilisearchService as Z, type Member as _, AddressService as a, contactService as a$, type MenuItem as a0, MenuService as a1, type MenuSummary as a2, type Money as a3, NewsletterService as a4, type Offer as a5, type Order as a6, type OrderLine as a7, OrderService as a8, PageService as a9, type StorefrontMenu as aA, type StorefrontOrder as aB, type StorefrontProduct as aC, UploadService as aD, UserService as aE, type Variant as aF, type VariantImage as aG, VariantService as aH, VarniCustomDesignService as aI, VarniCustomProductService as aJ, type Vendor as aK, VendorService as aL, WarrantyService as aM, type Wishlist as aN, type WishlistItem as aO, WishlistService as aP, addressService as aQ, authService as aR, autocompleteService as aS, b2bService as aT, bannerService as aU, blogService as aV, cartService as aW, categoryService as aX, chatService as aY, checkoutService as aZ, collectionService as a_, type PaymentIntent as aa, PaymentMethodService as ab, type Plugin as ac, PluginService as ad, PopularSearchService as ae, PopularityService as af, type Product as ag, type ProductOption as ah, ProductService as ai, ProfileService as aj, type Quote as ak, REDIRECT_GATEWAYS as al, ReelsService as am, RegionService as an, type RejectedLine as ao, type Review as ap, type ReviewPage as aq, ReviewService as ar, type SearchDoc as as, type SearchResult as at, SearchService as au, SettingService as av, type ShippingRate as aw, StateService as ax, StoreService as ay, type StorefrontCategory as az, type AppliedDiscount as b, varniCustomProductService as b$, countryService as b0, couponService as b1, currencyExponent as b2, currencyService as b3, dealService as b4, demoRequestService as b5, emptyCart as b6, emptyPage as b7, enquiryService as b8, faqService as b9, reviewService as bA, searchService as bB, settingService as bC, settingsService as bD, stateService as bE, staticStore as bF, storeService as bG, toCart as bH, toCartLine as bI, toCategory as bJ, toCmsPage as bK, toCollection as bL, toEngineAddress as bM, toIdentityAddress as bN, toMajor as bO, toMinor as bP, toOrder as bQ, toPage as bR, toProduct as bS, toRating as bT, toUser as bU, toVariant as bV, toVendor as bW, uploadService as bX, userService as bY, variantService as bZ, varniCustomDesignService as b_, feedbackService as ba, fromEngineAddress as bb, fromIdentityAddress as bc, fromSearchDoc as bd, galleryService as be, homeService as bf, initService as bg, mediaUrl as bh, meilisearchService as bi, menuService as bj, minorToMajor as bk, newsletterService as bl, orderService as bm, pageService as bn, paymentMethodService as bo, pluginService as bp, pluginsService as bq, popularSearchService as br, popularityService as bs, priceOf as bt, productImages as bu, productService as bv, profileService as bw, qs as bx, reelsService as by, regionService as bz, type Approval as c, vendorService as c0, warrantyService as c1, wishlistService as c2, 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 Menu 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, HomeService as T, type IdentityAddress as U, InitService as V, type Invitation as W, type Lead as X, type ListMeta as Y, MeilisearchService as Z, type Member as _, AddressService as a, collectionService as a$, type MenuItem as a0, MenuService as a1, type MenuSummary as a2, type Money as a3, NewsletterService as a4, type Offer as a5, type Order as a6, type OrderLine as a7, OrderService as a8, PageService as a9, type StorefrontCategory as aA, type StorefrontMenu as aB, type StorefrontOrder as aC, type StorefrontProduct as aD, UploadService as aE, UserService as aF, type Variant as aG, type VariantImage as aH, VariantService as aI, VarniCustomDesignService as aJ, VarniCustomProductService as aK, type Vendor as aL, VendorService as aM, WarrantyService as aN, type Wishlist as aO, type WishlistItem as aP, WishlistService as aQ, addressService as aR, authService as aS, autocompleteService as aT, b2bService as aU, bannerService as aV, blogService as aW, cartService as aX, categoryService as aY, chatService as aZ, checkoutService as a_, type PaymentIntent as aa, PaymentMethodService as ab, type Plugin as ac, PluginService as ad, PopularSearchService as ae, PopularityService as af, type Product as ag, type ProductOption as ah, ProductService as ai, ProfileService as aj, type Quote as ak, REDIRECT_GATEWAYS as al, ReelsService as am, RegionService as an, type RejectedLine as ao, type Review as ap, type ReviewPage as aq, ReviewService as ar, type SearchDoc as as, type SearchResult as at, SearchService as au, SettingService as av, type ShippingRate as aw, StateService as ax, type StoreProfile as ay, StoreService as az, type AppliedDiscount as b, userService as b$, contactService as b0, countryService as b1, couponService as b2, currencyExponent as b3, currencyService as b4, dealService as b5, demoRequestService as b6, emptyCart as b7, emptyPage as b8, enquiryService as b9, regionService as bA, reviewService as bB, searchService as bC, setRequestHost as bD, settingService as bE, settingsService as bF, stateService as bG, staticStore as bH, storeForHost as bI, storeService as bJ, toCart as bK, toCartLine as bL, toCategory as bM, toCmsPage as bN, toCollection as bO, toEngineAddress as bP, toIdentityAddress as bQ, toMajor as bR, toMinor as bS, toOrder as bT, toPage as bU, toProduct as bV, toRating as bW, toUser as bX, toVariant as bY, toVendor as bZ, uploadService as b_, faqService as ba, feedbackService as bb, fromEngineAddress as bc, fromIdentityAddress as bd, fromSearchDoc as be, galleryService as bf, homeService as bg, initService as bh, mediaUrl as bi, meilisearchService as bj, menuService as bk, minorToMajor as bl, newsletterService as bm, orderService as bn, pageService as bo, paymentMethodService as bp, pluginService as bq, pluginsService as br, popularSearchService as bs, popularityService as bt, priceOf as bu, productImages as bv, productService as bw, profileService as bx, qs as by, reelsService as bz, type Approval as c, variantService as c0, varniCustomDesignService as c1, varniCustomProductService as c2, vendorService as c3, warrantyService as c4, wishlistService as c5, 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-D8lNRhqJ.d.ts → index-DIj1rK1d.d.ts}

@@ -31,6 +31,16 @@ interface Credentials {
      * shared API host. Leave unset when the store has a host of its own.
      */
     store?: string;
+    /**
+     * `PUBLIC_GOCOMMERCE_BASE_DOMAIN` — under `gocommerce platform`, the domain
+     * every store gets a subdomain of, `shopnx.in`. One storefront deployment
+     * then serves them all: a request for `acme.shopnx.in` is sent with
+     * `X-Store: acme`, the same rule the engine applies to its own host. A host
+     * outside the base domain falls back to `store`. Server-side the connector
+     * learns the request's host through `setRequestHost`; in the browser it is
+     * `window.location.hostname`.
+     */
+    baseDomain?: string;
     /**
      * `PUBLIC_GOCOMMERCE_CHANNEL` — the sales channel new carts and the product
      * listing belong to, when the store sells through more than one.
@@ -336,6 +346,13 @@ type Plugin = {
     title: string;
     settings: Record<string, unknown>;
 };
+/** `GET /api/store`: what anyone may read about the shop. */
+type StoreProfile = {
+    name: string;
+    email: string;
+    phone: string;
+    support_url: string;
+};
 type Vendor = {
     id: number;
     slug: string;
@@ -1163,6 +1180,13 @@ declare class BaseService {
     static setCredentials(creds: Partial<Credentials>): void;
     static getCredentials(): Credentials;
     protected get creds(): Credentials;
+    /**
+     * The store this call is for: the request host's subdomain under
+     * `baseDomain`, else the static `store`. Read per call, never stored on the
+     * instance, because the server shares one process (and one credentials
+     * object) across every concurrent request and each may be for a different host.
+     */
+    protected get store(): string | undefined;
     /**
      * The engine's base URL from wherever this code runs. In the browser a
      * configured proxy path wins, because the engine answers no CORS preflight.
@@ -1200,6 +1224,19 @@ declare class BaseService {
     delete<T = any>(path: string): Promise<T>;
     private raw;
 }
+/**
+ * Where the server learns the current request's host, for `baseDomain`. A
+ * SvelteKit storefront registers `() => getRequestEvent().url.hostname` once
+ * at boot; the browser needs nothing, it reads `window.location`.
+ */
+declare function setRequestHost(fn: () => string | undefined): void;
+/**
+ * `acme.shopnx.in` under `shopnx.in` is store `acme`; anything else is nobody's.
+ * The engine's own rule (`Stores.ByHost`): case-insensitive, a port and a
+ * trailing dot ignored, and exactly one label, so `a.b.shopnx.in` and
+ * `shopnx.in` itself name no store.
+ */
+declare function storeForHost(host: string | undefined, baseDomain: string | undefined): string | undefined;
 /** `?a=1&b=2`, dropping what was not asked for. Arrays repeat the key. */
 declare function qs(query?: Query): string;
 /** The family's list shape, from the engine's `{data, meta}`. Totals are the engine's, never invented. */
@@ -1234,6 +1271,8 @@ declare class StoreFacts extends BaseService {
         language: string;
         version: string;
     }>;
+    /** The store's own name and how a buyer reaches it, as set in its panel. */
+    profile(): Promise<StoreProfile>;
     checkoutOptions(): Promise<CheckoutOptions>;
     /**
      * The whole tree, flat and depth-first. Past 500 categories the engine
@@ -5202,12 +5241,16 @@ declare const menuService: MenuService;
 /**
  * The store record every page renders from.
  *
- * Name, logo, theme and the rest are the storefront's own (its static store,
+ * Logo, theme and the rest are the storefront's own (its static store,
  * registered through `setStaticStore`); the engine has no opinion on them.
- * Where the engine does have one, it wins: the settlement currency — every
- * price on the site is formatted with it, and a store record saying USD over
- * an engine charging INR would print the wrong symbol on every price — the
- * modules that back a storefront feature, and the menus.
+ * Where the engine does have one, it wins:
+ * - the store's name and contact, as its owner set them in the panel. One
+ *   storefront serves every store under `baseDomain`, so a name in the static
+ *   record would be every store's name;
+ * - the settlement currency. Every price on the site is formatted with it, and
+ *   a store record saying USD over an engine charging INR would print the
+ *   wrong symbol on every price;
+ * - the modules that back a storefront feature, and the menus.
  *
  * This runs on every request and a throw here takes every page down, so the
  * engine's half is best-effort: unreachable, the storefront still renders
@@ -6459,4 +6502,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type Menu 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, HomeService as T, type IdentityAddress as U, InitService as V, type Invitation as W, type Lead as X, type ListMeta as Y, MeilisearchService as Z, type Member as _, AddressService as a, contactService as a$, type MenuItem as a0, MenuService as a1, type MenuSummary as a2, type Money as a3, NewsletterService as a4, type Offer as a5, type Order as a6, type OrderLine as a7, OrderService as a8, PageService as a9, type StorefrontMenu as aA, type StorefrontOrder as aB, type StorefrontProduct as aC, UploadService as aD, UserService as aE, type Variant as aF, type VariantImage as aG, VariantService as aH, VarniCustomDesignService as aI, VarniCustomProductService as aJ, type Vendor as aK, VendorService as aL, WarrantyService as aM, type Wishlist as aN, type WishlistItem as aO, WishlistService as aP, addressService as aQ, authService as aR, autocompleteService as aS, b2bService as aT, bannerService as aU, blogService as aV, cartService as aW, categoryService as aX, chatService as aY, checkoutService as aZ, collectionService as a_, type PaymentIntent as aa, PaymentMethodService as ab, type Plugin as ac, PluginService as ad, PopularSearchService as ae, PopularityService as af, type Product as ag, type ProductOption as ah, ProductService as ai, ProfileService as aj, type Quote as ak, REDIRECT_GATEWAYS as al, ReelsService as am, RegionService as an, type RejectedLine as ao, type Review as ap, type ReviewPage as aq, ReviewService as ar, type SearchDoc as as, type SearchResult as at, SearchService as au, SettingService as av, type ShippingRate as aw, StateService as ax, StoreService as ay, type StorefrontCategory as az, type AppliedDiscount as b, varniCustomProductService as b$, countryService as b0, couponService as b1, currencyExponent as b2, currencyService as b3, dealService as b4, demoRequestService as b5, emptyCart as b6, emptyPage as b7, enquiryService as b8, faqService as b9, reviewService as bA, searchService as bB, settingService as bC, settingsService as bD, stateService as bE, staticStore as bF, storeService as bG, toCart as bH, toCartLine as bI, toCategory as bJ, toCmsPage as bK, toCollection as bL, toEngineAddress as bM, toIdentityAddress as bN, toMajor as bO, toMinor as bP, toOrder as bQ, toPage as bR, toProduct as bS, toRating as bT, toUser as bU, toVariant as bV, toVendor as bW, uploadService as bX, userService as bY, variantService as bZ, varniCustomDesignService as b_, feedbackService as ba, fromEngineAddress as bb, fromIdentityAddress as bc, fromSearchDoc as bd, galleryService as be, homeService as bf, initService as bg, mediaUrl as bh, meilisearchService as bi, menuService as bj, minorToMajor as bk, newsletterService as bl, orderService as bm, pageService as bn, paymentMethodService as bo, pluginService as bp, pluginsService as bq, popularSearchService as br, popularityService as bs, priceOf as bt, productImages as bu, productService as bv, profileService as bw, qs as bx, reelsService as by, regionService as bz, type Approval as c, vendorService as c0, warrantyService as c1, wishlistService as c2, 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 Menu 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, HomeService as T, type IdentityAddress as U, InitService as V, type Invitation as W, type Lead as X, type ListMeta as Y, MeilisearchService as Z, type Member as _, AddressService as a, collectionService as a$, type MenuItem as a0, MenuService as a1, type MenuSummary as a2, type Money as a3, NewsletterService as a4, type Offer as a5, type Order as a6, type OrderLine as a7, OrderService as a8, PageService as a9, type StorefrontCategory as aA, type StorefrontMenu as aB, type StorefrontOrder as aC, type StorefrontProduct as aD, UploadService as aE, UserService as aF, type Variant as aG, type VariantImage as aH, VariantService as aI, VarniCustomDesignService as aJ, VarniCustomProductService as aK, type Vendor as aL, VendorService as aM, WarrantyService as aN, type Wishlist as aO, type WishlistItem as aP, WishlistService as aQ, addressService as aR, authService as aS, autocompleteService as aT, b2bService as aU, bannerService as aV, blogService as aW, cartService as aX, categoryService as aY, chatService as aZ, checkoutService as a_, type PaymentIntent as aa, PaymentMethodService as ab, type Plugin as ac, PluginService as ad, PopularSearchService as ae, PopularityService as af, type Product as ag, type ProductOption as ah, ProductService as ai, ProfileService as aj, type Quote as ak, REDIRECT_GATEWAYS as al, ReelsService as am, RegionService as an, type RejectedLine as ao, type Review as ap, type ReviewPage as aq, ReviewService as ar, type SearchDoc as as, type SearchResult as at, SearchService as au, SettingService as av, type ShippingRate as aw, StateService as ax, type StoreProfile as ay, StoreService as az, type AppliedDiscount as b, userService as b$, contactService as b0, countryService as b1, couponService as b2, currencyExponent as b3, currencyService as b4, dealService as b5, demoRequestService as b6, emptyCart as b7, emptyPage as b8, enquiryService as b9, regionService as bA, reviewService as bB, searchService as bC, setRequestHost as bD, settingService as bE, settingsService as bF, stateService as bG, staticStore as bH, storeForHost as bI, storeService as bJ, toCart as bK, toCartLine as bL, toCategory as bM, toCmsPage as bN, toCollection as bO, toEngineAddress as bP, toIdentityAddress as bQ, toMajor as bR, toMinor as bS, toOrder as bT, toPage as bU, toProduct as bV, toRating as bW, toUser as bX, toVariant as bY, toVendor as bZ, uploadService as b_, faqService as ba, feedbackService as bb, fromEngineAddress as bc, fromIdentityAddress as bd, fromSearchDoc as be, galleryService as bf, homeService as bg, initService as bh, mediaUrl as bi, meilisearchService as bj, menuService as bk, minorToMajor as bl, newsletterService as bm, orderService as bn, pageService as bo, paymentMethodService as bp, pluginService as bq, pluginsService as br, popularSearchService as bs, popularityService as bt, priceOf as bu, productImages as bv, productService as bw, profileService as bx, qs as by, reelsService as bz, type Approval as c, variantService as c0, varniCustomDesignService as c1, varniCustomProductService as c2, vendorService as c3, warrantyService as c4, wishlistService as c5, 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

@@ -285,6 +285,17 @@ var BaseService = class _BaseService {
   get creds() {
     return _BaseService._credentials;
   }
+  /**
+   * The store this call is for: the request host's subdomain under
+   * `baseDomain`, else the static `store`. Read per call, never stored on the
+   * instance, because the server shares one process (and one credentials
+   * object) across every concurrent request and each may be for a different host.
+   */
+  get store() {
+    const { baseDomain, store } = this.creds;
+    const host = typeof window !== "undefined" ? window.location?.hostname : requestHost?.();
+    return storeForHost(host, baseDomain) ?? store;
+  }
   /**
    * The engine's base URL from wherever this code runs. In the browser a
    * configured proxy path wins, because the engine answers no CORS preflight.
@@ -318,7 +329,8 @@ var BaseService = class _BaseService {
     const url = this.engineURL(path, lang ? { lang, ...req.query } : req.query);
     const headers = { Accept: "application/json", ...req.headers };
     if (req.body !== void 0) headers["Content-Type"] = "application/json";
-    if (this.creds.store) headers["X-Store"] = this.creds.store;
+    const store = this.store;
+    if (store) headers["X-Store"] = store;
     if (req.auth) {
       const token = sessionToken();
       if (!token) throw new GoCommerceError("Please sign in to continue.", 401, "unauthorized");
@@ -420,6 +432,18 @@ var BaseService = class _BaseService {
     return body;
   }
 };
+var requestHost;
+function setRequestHost(fn) {
+  requestHost = fn;
+}
+function storeForHost(host, baseDomain) {
+  if (!host || !baseDomain) return void 0;
+  const h = host.toLowerCase().replace(/\.$/, "").replace(/:\d+$/, "");
+  const suffix = "." + baseDomain.toLowerCase().replace(/^\.+/, "").replace(/\.$/, "");
+  if (!h.endsWith(suffix)) return void 0;
+  const slug = h.slice(0, -suffix.length);
+  return slug && !slug.includes(".") ? slug : void 0;
+}
 var unreachable = (base, cause) => new GoCommerceError(`Could not reach the commerce engine at ${base}: ${cause?.message ?? cause}`, 0);
 function qs(query) {
   if (!query) return "";
@@ -967,7 +991,7 @@ var priceOf = (m) => m ? toMajor(m) : 0;
 // src/services/facts.ts
 var StoreFacts = class extends BaseService {
   key(name) {
-    return `${this.engineBase()}|${this.creds.store ?? ""}|${name}`;
+    return `${this.engineBase()}|${this.store ?? ""}|${name}`;
   }
   /** Enabled plugins by key. A module that is not installed has no key here. */
   plugins() {
@@ -987,6 +1011,10 @@ var StoreFacts = class extends BaseService {
   ready() {
     return remember(this.key("ready"), () => this.data("/health/ready"));
   }
+  /** The store's own name and how a buyer reaches it, as set in its panel. */
+  profile() {
+    return remember(this.key("profile"), () => this.data("/api/store"));
+  }
   checkoutOptions() {
     return remember(this.key("checkout"), () => this.data("/api/checkout"));
   }
@@ -2397,7 +2425,7 @@ var MenuService = class extends BaseService {
   /** The header and footer menus, or `null` when the module is not there. Cached: a menu is store-level. */
   async engineMenus() {
     if (!await this.facts.pluginOn("navigation")) return null;
-    return remember(`${this.engineBase()}|${this.creds.store ?? ""}|menus`, async () => {
+    return remember(`${this.engineBase()}|${this.store ?? ""}|menus`, async () => {
       const out = [];
       for (const handle of ["header", "footer"]) {
         try {
@@ -2431,6 +2459,7 @@ var NewsletterService = class extends BaseService {
 var newsletterService = new NewsletterService();
 
 // src/services/store-service.ts
+var isStoreMissing = (err) => err instanceof GoCommerceError && err.status === 404 && (err.code === "store_not_found" || /store not found|no such store/i.test(err.message));
 function symbolFor(code) {
   try {
     const part = new Intl.NumberFormat("en", { style: "currency", currency: code }).formatToParts(0).find((p) => p.type === "currency");
@@ -2443,6 +2472,14 @@ var StoreService = class extends BaseService {
   facts = new StoreFacts(this._fetch);
   async getStoreByIdOrDomain(_args = {}) {
     const base = await readStaticStore();
+    const store = this.store;
+    if (store) {
+      await this.facts.plugins().catch((err) => {
+        if (isStoreMissing(err)) {
+          throw new GoCommerceError(`store not found: no store "${store}" on this engine`, 404, "store_not_found");
+        }
+      });
+    }
     const live = await this.live().catch(() => ({}));
     return { ...base, ...live, id: base.id || "gocommerce" };
   }
@@ -2480,17 +2517,22 @@ var StoreService = class extends BaseService {
     return super.post(path, data);
   }
   async live() {
-    const [ready, plugins, menus, base] = await Promise.all([
+    const [ready, plugins, menus, base, profile] = await Promise.all([
       this.facts.ready(),
       this.facts.plugins().catch(() => /* @__PURE__ */ new Map()),
       new MenuService(this._fetch).engineMenus(),
-      readStaticStore()
+      readStaticStore(),
+      this.facts.profile().catch(() => null)
     ]);
     const code = ready.currency;
     const sameCurrency = (base.currency?.code ?? base.currencyCode) === code;
     const flag = (on) => ({ ...on ? { active: true } : { active: false } });
     const basePlugins = base.plugins ?? {};
     return {
+      // Only what the owner filled in: an empty name keeps the static one.
+      ...profile?.name ? { name: profile.name } : {},
+      ...profile?.email ? { businessEmail: profile.email } : {},
+      ...profile?.phone ? { businessPhone: profile.phone } : {},
       currencyCode: code,
       currencySymbol: sameCurrency ? base.currencySymbol ?? symbolFor(code) : symbolFor(code),
       currency: {
@@ -3189,11 +3231,13 @@ exports.regionService = regionService;
 exports.reviewService = reviewService;
 exports.searchService = searchService;
 exports.serveRestLocally = serveRestLocally;
+exports.setRequestHost = setRequestHost;
 exports.setStaticStore = setStaticStore;
 exports.settingService = settingService;
 exports.settingsService = settingsService;
 exports.stateService = stateService;
 exports.staticStore = staticStore;
+exports.storeForHost = storeForHost;
 exports.storeService = storeService;
 exports.toCart = toCart;
 exports.toCartLine = toCartLine;