@shoppexio/storefront 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.1
+
+- Add `program_enabled` to affiliate validation responses.
+- Clarify disabled affiliate program handling for headless storefronts.
+
 ## 0.3.0
 
 - Publish the active Storefront SDK runtime under `@shoppexio/storefront`.

package/README.md

@@ -42,7 +42,29 @@ const result = await shoppex.validateCoupon('SAVE10', {
 });
 ```
 
-Calling `validateCoupon(code)` without options validates against the current SDK cart. Affiliate/referral codes are separate and should use `validateAffiliateCode` or `applyAffiliateCode`.
+Calling `validateCoupon(code)` without options validates against the current SDK cart. Affiliate/referral codes are separate and should use `validateAffiliateCode` or `applyAffiliateCode`. If `program_enabled` is false in an affiliate validation response, the shop-level affiliate program is disabled even if individual links exist.
+
+## Live online users
+
+The SDK can power a custom live online visitor counter. It provides the data; your storefront renders the badge.
+
+```ts
+import shoppex from '@shoppexio/storefront';
+
+shoppex.init('my-store');
+
+async function refreshLiveUsers() {
+  await shoppex.touchStorefrontPresence();
+
+  const result = await shoppex.getStorefrontOnlineUsers();
+  if (result.success && result.data) {
+    console.log(`${result.data.count} online`);
+  }
+}
+
+await refreshLiveUsers();
+setInterval(refreshLiveUsers, 30_000);
+```
 
 ## Not this package