@doswiftly/storefront-operations 11.5.0 → 12.0.0

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**: 11.5.0
+- **Schema version**: 12.0.0
 - **Queries**: 49
 - **Mutations**: 40
 - **Fragments**: 100

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 12.0.0
+
+### Major Changes
+
+- 2ff6b16: **BREAKING**: `Product.requiresRecipientInfo` field has been removed from the storefront GraphQL schema. Every paid gift card line now guarantees email delivery — to the recipient when your storefront captured one, otherwise to the buyer as fallback.
+
+  ### Why removed
+
+  The field exposed a per-product merchant toggle intended to gate whether your storefront should collect gift card recipient info (email, name, message) at checkout. In practice the toggle did not change actual delivery behaviour — every storefront ended up deciding on its own whether to render a recipient form, and the platform sent emails based solely on whether per-line recipient data was present. Merchants saw an admin control that had no effect downstream, so it has been removed in favour of an explicit storefront-driven model.
+
+  ### New model — storefront-driven recipient mode
+
+  Common e-commerce convention for gift card flow:
+  1. **Your storefront opts in**: render a recipient form on PDP / cart drawer for any cart line where `product.type === 'GIFT_CARD'`. Call `cartUpdateGiftCardRecipient({ cartId, lineItemId, recipientEmail, recipientName?, message? })` per line where the buyer fills it in.
+  2. **Your storefront opts out**: skip the mutation entirely. Gift cards still ship — the platform emails the code to the buyer (the same email used at checkout) as a fallback.
+
+  Every paid gift card is now guaranteed to land in someone's inbox — either the explicit recipient (when collected) or the buyer (fallback). Previously, missing recipient data caused a silent email skip, leaving customers without their codes.
+
+  ### Migration
+
+  If your storefront was reading `Product.requiresRecipientInfo` to conditionally show a recipient form, replace the gate with a simple product type check:
+
+  ```diff
+  - {product.requiresRecipientInfo && (
+  + {product.type === 'GIFT_CARD' && (
+      <GiftRecipientForm cartId={cartId} lineItemId={lineItemId} />
+    )}
+  ```
+
+  If you were not reading the field, no storefront changes are required — the fallback ensures gift card delivery works out of the box.
+
+  See [cart docs — Karty podarunkowe — dostawa kodu](https://docs.doswiftly.pl/storefront-developer/sdk/cart#karty-podarunkowe--dostawa-kodu) for the full delivery semantics, a cart-structuring table (one gift card for self vs N gift cards for N recipients), and a recipient form example.
+
 ## 11.5.0
 
 ### Minor Changes

package/fragments.graphql

@@ -154,7 +154,6 @@ fragment ProductBase on Product {
   descriptionHtml
   stockTotal
   type
-  requiresRecipientInfo
   visibility
   attributeSetId
   createdAt

package/llms-full.txt

@@ -1,6 +1,6 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **11.5.0**
+> Schema version: **12.0.0**
 > 49 queries · 40 mutations · 100 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
@@ -2602,7 +2602,6 @@ fragment ProductBase on Product {
   descriptionHtml
   stockTotal
   type
-  requiresRecipientInfo
   visibility
   attributeSetId
   createdAt

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "11.5.0",
+  "schemaVersion": "12.0.0",
   "queries": [
     {
       "name": "Shop",
@@ -1932,7 +1932,7 @@
       "fragmentRefs": [
         "ProductCard"
       ],
-      "body": "fragment ProductBase on Product {\n  ...ProductCard\n  description\n  descriptionHtml\n  stockTotal\n  type\n  requiresRecipientInfo\n  visibility\n  attributeSetId\n  createdAt\n  updatedAt\n}",
+      "body": "fragment ProductBase on Product {\n  ...ProductCard\n  description\n  descriptionHtml\n  stockTotal\n  type\n  visibility\n  attributeSetId\n  createdAt\n  updatedAt\n}",
       "onType": "Product"
     },
     {

package/package.json

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

package/schema.graphql

@@ -4083,9 +4083,6 @@ type Product implements Node {
   """Similar products recommendations"""
   recommendations(first: Int = 4): ProductRecommendations
 
-  """Whether storefront checkout requires recipient data for this product"""
-  requiresRecipientInfo: Boolean!
-
   """Number of reviews"""
   reviewCount: Int