@absolutejs/commerce 0.2.1-beta.0 → 0.3.0-beta.0

package/dist/client/cartStore.d.ts

@@ -3,6 +3,8 @@ export type CartStore<T> = {
     write(items: T[]): void;
     add(item: T): void;
     clear(): void;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): T[];
 };
 /**
  * Create a cart store for a localStorage key. Pass `normalize` to migrate or

package/dist/client/index.js

@@ -1,10 +1,9 @@
 // src/client/cartStore.ts
+var EMPTY = [];
 var createCartStore = (key, normalize) => {
-  const read = () => {
-    if (typeof window === "undefined")
-      return [];
+  const eventName = `commerce-cart:${key}`;
+  const parse = (raw) => {
     try {
-      const raw = window.localStorage.getItem(key);
       const parsed = raw ? JSON.parse(raw) : [];
       if (normalize)
         return normalize(parsed);
@@ -13,10 +12,32 @@ var createCartStore = (key, normalize) => {
       return [];
     }
   };
+  const read = () => {
+    if (typeof window === "undefined")
+      return [];
+    return parse(window.localStorage.getItem(key));
+  };
+  let lastRaw = null;
+  let cache = EMPTY;
+  const getSnapshot = () => {
+    if (typeof window === "undefined")
+      return EMPTY;
+    const raw = window.localStorage.getItem(key) ?? "";
+    if (raw !== lastRaw) {
+      lastRaw = raw;
+      cache = parse(raw);
+    }
+    return cache;
+  };
+  const announce = () => {
+    if (typeof window !== "undefined")
+      window.dispatchEvent(new Event(eventName));
+  };
   const write = (items) => {
     if (typeof window === "undefined")
       return;
     window.localStorage.setItem(key, JSON.stringify(items));
+    announce();
   };
   return {
     add(item) {
@@ -26,8 +47,26 @@ var createCartStore = (key, normalize) => {
       if (typeof window === "undefined")
         return;
       window.localStorage.removeItem(key);
+      announce();
     },
+    getSnapshot,
     read,
+    subscribe(listener) {
+      if (typeof window === "undefined")
+        return () => {
+          return;
+        };
+      const onStorage = (event) => {
+        if (event.key === key)
+          listener();
+      };
+      window.addEventListener(eventName, listener);
+      window.addEventListener("storage", onStorage);
+      return () => {
+        window.removeEventListener(eventName, listener);
+        window.removeEventListener("storage", onStorage);
+      };
+    },
     write
   };
 };

package/dist/react/index.d.ts

@@ -0,0 +1,8 @@
+import type { CartStore } from '../client/cartStore';
+/** Live cart items for a store — re-renders on add/clear and cross-tab changes. */
+export declare const useCart: <T>(store: CartStore<T>) => T[];
+/**
+ * Live derived value over the cart (e.g. item count, subtotal). `select` runs
+ * on the current items each render.
+ */
+export declare const useCartValue: <T, V>(store: CartStore<T>, select: (items: T[]) => V) => V;

package/dist/react/index.js

@@ -0,0 +1,10 @@
+// @bun
+// src/react/index.ts
+import { useSyncExternalStore } from "react";
+var EMPTY = [];
+var useCart = (store) => useSyncExternalStore(store.subscribe, store.getSnapshot, () => EMPTY);
+var useCartValue = (store, select) => select(useCart(store));
+export {
+  useCartValue,
+  useCart
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/commerce",
-	"version": "0.2.1-beta.0",
+	"version": "0.3.0-beta.0",
 	"description": "Provider-agnostic commerce primitives (cart, orders, fulfillment, shipping) for AbsoluteJS",
 	"repository": {
 		"type": "git",
@@ -28,6 +28,11 @@
 			"import": "./dist/client/index.js",
 			"types": "./dist/client/index.d.ts"
 		},
+		"./react": {
+			"browser": "./dist/react/index.js",
+			"import": "./dist/react/index.js",
+			"types": "./dist/react/index.d.ts"
+		},
 		"./drizzle": {
 			"import": "./dist/drizzle/index.js",
 			"types": "./dist/drizzle/index.d.ts",
@@ -37,22 +42,28 @@
 	"license": "BSL-1.1",
 	"author": "Alex Kahn",
 	"scripts": {
-		"build": "rm -rf dist && bun build ./src/index.ts ./src/drizzle/index.ts --outdir dist --target bun --external drizzle-orm && bun build ./src/client/index.ts --outdir dist/client --target browser --format esm && tsc --emitDeclarationOnly --project tsconfig.json",
+		"build": "rm -rf dist && bun build ./src/index.ts ./src/drizzle/index.ts ./src/react/index.ts --outdir dist --target bun --external drizzle-orm --external react && bun build ./src/client/index.ts --outdir dist/client --target browser --format esm && tsc --emitDeclarationOnly --project tsconfig.json",
 		"format": "prettier --write \"./**/*.{js,ts,json,md}\"",
 		"release": "bun run build && bun publish --tag beta",
 		"typecheck": "tsc --noEmit"
 	},
 	"peerDependencies": {
-		"drizzle-orm": ">=0.30.0"
+		"drizzle-orm": ">=0.30.0",
+		"react": ">=18.0.0"
 	},
 	"peerDependenciesMeta": {
 		"drizzle-orm": {
 			"optional": true
+		},
+		"react": {
+			"optional": true
 		}
 	},
 	"devDependencies": {
 		"@types/bun": "1.3.9",
+		"@types/react": "^19.0.0",
 		"drizzle-orm": "^0.44.0",
+		"react": "^19.0.0",
 		"typescript": "^5.9.3"
 	}
 }