create-cartbase 0.1.17 → 0.1.18

package/package.json

@@ -1,24 +1,24 @@
-{
-  "name": "create-cartbase",
-  "version": "0.1.17",
-  "description": "Scaffold a Cartbase storefront: npm create cartbase my-store",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "create-cartbase": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "template"
-  ],
-  "scripts": {
-    "build": "bun scripts/build-template.mjs && tsc -p tsconfig.json",
-    "prepack": "bun scripts/build-template.mjs && tsc -p tsconfig.json"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "devDependencies": {
-    "typescript": "^5"
-  }
-}
+{
+  "name": "create-cartbase",
+  "version": "0.1.18",
+  "description": "Scaffold a Cartbase storefront: npm create cartbase my-store",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-cartbase": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "bun scripts/build-template.mjs && tsc -p tsconfig.json",
+    "prepack": "bun scripts/build-template.mjs && tsc -p tsconfig.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "typescript": "^5"
+  }
+}

package/template/app/docs/components.md

@@ -612,12 +612,22 @@ Domain doc for every call: [carts.md](carts.md); gift-card tender:
   added a moment ago carries `pending: true` and a placeholder id
   (`isPendingLine(line)`); its quantity and removal work at once and are
   sent to the real line when the platform has confirmed it.
+- **A completed cart is no cart (since 0.18.1)** — Medusa's rule: the
+  platform still answers a completed cart and refuses every change to it
+  (`409 cart_completed`), so the drawer never holds one. Reading one, or
+  being told the stored cart is gone (`cart_not_found`), empties the drawer
+  and calls `onCartEnd`; an add aimed at such a cart starts a new cart with
+  the item. The checkout clears the cookie (`clearCartCookie`,
+  `lib/cookie-names`) and calls `forget()` the moment the order is placed,
+  Medusa's `removeCartId()`.
 - **Props contract** — `cart?: Cart|null` (server-fetched snapshot; prop
   updates win unless a change of the provider's own is on its way; leave it
   out and pass `cartId` so the page never waits for the cart),
   `client?: StorefrontClient` (enables `addLine`/`addItem`/
   `updateQuantity`/`removeItem`/`refresh`), `cartId?` (read in the browser
-  on mount, through the queue, when no snapshot), `onCartChange?(cart)` (fires on every confirmed
+  on mount, through the queue, when no snapshot), `onCartEnd?()` (the cart
+  is over: clear the stored id; `onCartEnd={clearCartCookie}` for the
+  cookie), `onCartChange?(cart)` (fires on every confirmed
   change INCLUDING first-add cart creation — persist `cart.id` here),
   `onOptimisticError?(failure)` (the ops funnel for every failed
   optimistic mutation — wire to store logging; replaces the source's
@@ -628,7 +638,8 @@ Domain doc for every call: [carts.md](carts.md); gift-card tender:
   addLine(variantId, qty?, display?)` (answers `{ok: true, cart}` or
   `{ok: false, error}`, the platform's refusal with its `code`),
   `addItem(variantId, qty?, display?)` (the same, answering a boolean),
-  `updateQuantity(lineId, qty), removeItem(lineId), refresh, canMutate,
+  `updateQuantity(lineId, qty), removeItem(lineId), refresh, forget`
+  (empties the drawer and calls `onCartEnd`), `canMutate,
   applyOptimistic, dispatchOptimistic, labels, hrefs}`.
   `applyOptimistic(action, serverAction)` stays for store-owned server
   actions; the SDK methods are the fast path.

package/template/app/package.json

@@ -9,7 +9,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@cartbase/storefront": "^0.18.0",
+    "@cartbase/storefront": "^0.18.1",
     "next": "16.2.4",
     "react": "19.2.4",
     "react-dom": "19.2.4"

package/template/app/src/app/providers.tsx

@@ -10,6 +10,7 @@ import {
   type ConsentSettings,
 } from "@cartbase/storefront/tracking/consent"
 import { StorefrontLocaleProvider } from "@cartbase/storefront/locales"
+import { clearCartCookie } from "@cartbase/storefront/lib/cookie-names"
 import { CART_COOKIE, CART_COOKIE_MAX_AGE, STORE_LOCALE } from "@/lib/config"
 import { browserClient } from "@/lib/browser-client"
 
@@ -47,6 +48,9 @@ export function Providers({
             next.id
           )};path=/;max-age=${CART_COOKIE_MAX_AGE};samesite=lax`
         }}
+        // The cart is over (ordered, or gone): forget the stored id, so the
+        // next add starts a new cart.
+        onCartEnd={clearCartCookie}
       >
         {children}
         <CartDrawerTemplate />