@base44/app-plugin-commerce 0.1.12 → 0.1.14

package/src/commerce/utils/storefront.js

@@ -9,7 +9,7 @@
  *   import { base44 } from "@/api/base44Client";
  *   export const store = createStorefront(base44);
  *
- * It owns the two things hand-rolled clients keep getting wrong:
+ * It owns the things hand-rolled clients keep getting wrong:
  *
  * - The cart_token lifecycle: the token is sent with every cart/checkout call
  *   and re-persisted from every response (a stale token silently starts a
@@ -17,6 +17,11 @@
  * - The store-info split: payment_gateways, currency, countries/currencies
  *   live ONLY on get-store-info — the cart view never carries them.
  *   getStoreInfo() caches the call; read them from there, never off a cart.
+ * - Envelope unwrapping: every method resolves straight to the data you use.
+ *   listCategories() and listRibbons() resolve to ARRAYS — the raw actions'
+ *   { categories } / { ribbons } wrappers are unwrapped here, so never dig
+ *   for `.categories` on the result. Only the raw escape hatch inv(fn,
+ *   payload) returns an action's payload as-is.
  */
 
 /** The stable error code a failed storefront call carries, if any. */
@@ -65,11 +70,13 @@ export function createStorefront(base44, { storageKey = "cart_token", storage }
       const by = typeof ref === "string" ? { slug: ref } : ref;
       return inv("commerce/storefront-catalog", { action: "get-product", ...by });
     },
+    /** ARRAY of root categories, subcategories nested under `children`. */
     listCategories() {
-      return inv("commerce/storefront-catalog", { action: "list-categories" });
+      return inv("commerce/storefront-catalog", { action: "list-categories" }).then((d) => d.categories);
     },
+    /** ARRAY of { id, name, count }. */
     listRibbons() {
-      return inv("commerce/storefront-catalog", { action: "list-ribbons" });
+      return inv("commerce/storefront-catalog", { action: "list-ribbons" }).then((d) => d.ribbons);
     },
 
     // ── cart (token handled internally; every call returns the full view) ─