@doswiftly/storefront-operations 22.5.0 → 22.5.1

package/AGENTS.md

@@ -27,7 +27,7 @@ consumer's `codegen.ts` references this package's `.graphql` files as
 live in the consumer's repo.
 
 <!-- AUTOGEN:STATS:BEGIN — auto-regenerated, do not edit by hand -->
-- **Schema version**: 22.5.0
+- **Schema version**: 22.5.1
 - **Queries**: 52
 - **Mutations**: 44
 - **Fragments**: 105

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 22.5.1
+
+### Patch Changes
+
+- 6ca2a5f: Corrected the GraphQL schema descriptions for the `CartStatus` enum and the `Cart.status` field so they match the cart's actual behaviour: an `ABANDONED` cart is revived in place by any deliberate buyer edit (it is not locked), editing an `EXPIRED` cart returns `CART_NOT_FOUND`, and only `CONVERTED` / completed carts return `ALREADY_COMPLETED`. Documentation only — no type or API changes.
+
 ## 22.5.0
 
 ### Minor Changes

package/llms-full.txt

@@ -1,6 +1,6 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **22.5.0**
+> Schema version: **22.5.1**
 > 52 queries · 44 mutations · 105 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "22.5.0",
+  "schemaVersion": "22.5.1",
   "queries": [
     {
       "name": "Shop",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-operations",
-  "version": "22.5.0",
+  "version": "22.5.1",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {

package/schema.graphql

@@ -1013,7 +1013,7 @@ type Cart implements Node {
   shippingAddress: MailingAddress
 
   """
-  Lifecycle status — `ACTIVE` for the editable working cart, terminal otherwise. Check this on SSR before rendering the checkout form: a non-`ACTIVE` cart should redirect (typically to the order confirmation when `completedOrder` is populated) instead of presenting a form whose first mutation fails with `CartErrorCode.ALREADY_COMPLETED`.
+  Lifecycle status — `ACTIVE` / `RECOVERED` are editable; `ABANDONED` is a recovery flag a deliberate buyer action revives in place; `CONVERTED` / `EXPIRED` are terminal. Check this on SSR before rendering the checkout form: a `CONVERTED` cart should redirect (typically to the order confirmation when `completedOrder` is populated) instead of presenting a form whose first mutation fails with `CartErrorCode.ALREADY_COMPLETED`.
   """
   status: CartStatus!
 
@@ -1831,7 +1831,7 @@ type CartShippingMethod {
 }
 
 """
-Cart lifecycle status. `ACTIVE` is the only editable state — every other value is terminal and rejects mutations with `CartErrorCode.ALREADY_COMPLETED`. `CONVERTED` carries an associated `completedOrder`; query that to redirect the buyer to their order confirmation. `EXPIRED` / `ABANDONED` are cleanup states with no order; create a fresh cart. `RECOVERED` is a previously-abandoned cart that the buyer returned to via a recovery link.
+Cart lifecycle status. `ACTIVE` and `RECOVERED` are editable carts. `ABANDONED` flags a cart the buyer left inactive (used for recovery campaigns) — it is not locked: a deliberate buyer action revives it in place to `RECOVERED` and the mutation proceeds. `RECOVERED` is a previously-abandoned cart the buyer came back to (via a recovery link or by acting on it again). `CONVERTED` carries an associated `completedOrder`; query that to redirect the buyer to their order confirmation, since editing a converted cart returns `CartErrorCode.ALREADY_COMPLETED`. `EXPIRED` is past its lifetime with no order; editing it returns `CartErrorCode.CART_NOT_FOUND` — create a fresh cart.
 """
 enum CartStatus {
   ABANDONED