@godaddy/gd-commerce-storefront 0.1.3 → 0.3.0

package/dist/styles.css

@@ -68,12 +68,14 @@
     font-family: inherit;
     line-height: 1.5;
   }
-.commerce-storefront :where(*) {
+.commerce-storefront :where(*:not(.commerce-part)) {
     color: inherit;
     font-family: inherit;
   }
 .commerce-storefront *, .commerce-storefront *::before, .commerce-storefront *::after {
     box-sizing: border-box;
+  }
+.commerce-storefront :where(*:not(.commerce-part)), .commerce-storefront *::before, .commerce-storefront *::after {
     border-width: 0;
     border-style: solid;
   }
@@ -133,6 +135,9 @@
 .commerce-storefront .fixed {
     position: fixed;
   }
+.commerce-storefront .sticky {
+    position: sticky;
+  }
 .commerce-storefront .inset-0 {
     inset: calc(var(--spacing) * 0);
   }
@@ -175,6 +180,9 @@
 .commerce-storefront .mt-auto {
     margin-top: auto;
   }
+.commerce-storefront .mb-0 {
+    margin-bottom: calc(var(--spacing) * 0);
+  }
 .commerce-storefront .mb-2 {
     margin-bottom: calc(var(--spacing) * 2);
   }

package/docs/server-api.md

@@ -101,3 +101,40 @@ The client refreshes the cart before checkout and sends its ID, an absolute cata
 When using `@godaddy/gd-commerce-server`, configure the router's `checkoutReturnUrls.returnUrls` with the absolute catalog return URL and `checkoutReturnUrls.successUrls` with the absolute success-page URL. The package matches these exact destinations and permits an additional `orderId` parameter on success URLs. Missing policy disables HTTP checkout. Public HTTP requests accept only cart or SKU checkout; non-catalog amounts belong in a trusted server handler.
 
 Do not treat `checkoutSuccessPath`, a client-provided URL, the redirect itself, or a draft-order response as proof that payment succeeded. Verify payment using the checkout/payment service or trusted webhook state. Expire or reject paid/closed drafts on subsequent cart reads so returning customers cannot reuse a completed cart.
+
+## Connection state
+
+A host may return one of these uncached config responses:
+
+```json
+{ "state": "unbound" }
+{ "state": "connecting" }
+{ "state": "ready", "cartScope": "opaque-cart-scope", "currencyCode": "USD" }
+```
+
+Only an explicit `unbound` response allows `Catalog sampleProducts`. `connecting` suspends all
+catalog and cart actions. Loading, malformed state, HTTP errors, and missing routes never allow
+samples. A successful `{ cartScope, currencyCode }` response without `state` still means ready.
+
+`@godaddy/gd-commerce-server` accepts an optional synchronous
+`CommerceConfiguration.readConnectionState(): 'unbound' | 'connecting' | 'ready' | undefined`.
+Return `undefined` to keep the existing config behavior. Return `unbound` only when the host has
+confirmed that no store is connected. Throw when the state is unknown or cannot be read.
+`unbound` and `connecting` responses need no credentials. `ready` still requires `read()` to
+succeed. Data and checkout handlers reject any state other than `ready`, even if credentials
+remain. Do not infer `unbound` from missing credentials or configuration.
+
+The host owns the connection lifecycle. Report `ready` only when the store connection is
+complete, and keep failures in a state other than `unbound`. After a store connects, missing
+configuration must never bring samples back. Report `unbound` again only after the store is
+deliberately disconnected. State changes must be visible to the next request. Pages switch to
+live data only when the deployed server reports a new state. If a host's deployments read
+state from deployment configuration, a deployed site keeps showing samples until that
+configuration is updated, for example by publishing again.
+
+The storefront polls every five seconds while the page is visible and the state is `unbound` or
+`connecting`, and refreshes on mount and focus. A failed refresh immediately hides samples, without
+automatic request retries. While the last response was `connecting`, refresh failures keep the
+connecting state for up to 60 seconds, so a host restart during connection does not flash an
+error. Polling continues, and a longer failure reports the error. Aborted configuration requests cannot overwrite newer responses.
+Release server and client support before using the `sampleProducts` prop. No new endpoint is required.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@godaddy/gd-commerce-storefront",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Opinionated React storefront templates for GoDaddy Commerce",
   "type": "module",
   "license": "MIT",