@misiki/gocommerce-connector 0.3.1 → 0.4.0

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,33 @@ 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)
+```
+
+Store-level facts (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-iPG0fxzc.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.
@@ -1163,6 +1173,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 +1217,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. */
@@ -6459,4 +6489,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, 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, variantService 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, setRequestHost as bC, settingService as bD, settingsService as bE, stateService as bF, staticStore as bG, storeForHost as bH, storeService as bI, toCart as bJ, toCartLine as bK, toCategory as bL, toCmsPage as bM, toCollection as bN, toEngineAddress as bO, toIdentityAddress as bP, toMajor as bQ, toMinor as bR, toOrder as bS, toPage as bT, toProduct as bU, toRating as bV, toUser as bW, toVariant as bX, toVendor as bY, uploadService as bZ, userService 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, varniCustomDesignService as c0, varniCustomProductService as c1, vendorService as c2, warrantyService as c3, wishlistService as c4, 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-iPG0fxzc.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.
@@ -1163,6 +1173,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 +1217,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. */
@@ -6459,4 +6489,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, 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, variantService 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, setRequestHost as bC, settingService as bD, settingsService as bE, stateService as bF, staticStore as bG, storeForHost as bH, storeService as bI, toCart as bJ, toCartLine as bK, toCategory as bL, toCmsPage as bM, toCollection as bN, toEngineAddress as bO, toIdentityAddress as bP, toMajor as bQ, toMinor as bR, toOrder as bS, toPage as bT, toProduct as bU, toRating as bV, toUser as bW, toVariant as bX, toVendor as bY, uploadService as bZ, userService 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, varniCustomDesignService as c0, varniCustomProductService as c1, vendorService as c2, warrantyService as c3, wishlistService as c4, 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() {
@@ -2397,7 +2421,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 +2455,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 +2468,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" };
   }
@@ -3189,11 +3222,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;