@spree/docs 0.1.7 → 0.1.8

package/dist/developer/core-concepts/orders.md

@@ -238,23 +238,23 @@ Apply or remove promotional coupon codes during checkout:
 
 
 ```typescript SDK
-// Apply a coupon
-await client.carts.couponCodes.apply(cartId, 'SAVE20')
+// Apply a discount code
+await client.carts.discountCodes.apply(cartId, 'SAVE20')
 
-// Remove a coupon
-await client.carts.couponCodes.remove(cartId, 'SAVE20')
+// Remove a discount code
+await client.carts.discountCodes.remove(cartId, 'SAVE20')
 ```
 
 ```bash cURL
-# Apply a coupon
-curl -X POST 'https://api.mystore.com/api/v3/store/carts/cart_xxx/coupon_codes' \
+# Apply a discount code
+curl -X POST 'https://api.mystore.com/api/v3/store/carts/cart_xxx/discount_codes' \
   -H 'Authorization: Bearer spree_pk_xxx' \
   -H 'X-Spree-Token: abc123' \
   -H 'Content-Type: application/json' \
   -d '{ "code": "SAVE20" }'
 
-# Remove a coupon
-curl -X DELETE 'https://api.mystore.com/api/v3/store/carts/cart_xxx/coupon_codes/SAVE20' \
+# Remove a discount code
+curl -X DELETE 'https://api.mystore.com/api/v3/store/carts/cart_xxx/discount_codes/SAVE20' \
   -H 'Authorization: Bearer spree_pk_xxx' \
   -H 'X-Spree-Token: abc123'
 ```

package/dist/developer/core-concepts/promotions.md

@@ -278,13 +278,13 @@ Customers apply coupon codes during checkout via the Store API:
 
 
 ```typescript SDK
-// Apply a coupon code to the cart
-const cart = await client.carts.couponCodes.apply('cart_abc123', 'SUMMER20', {
+// Apply a discount code to the cart
+const cart = await client.carts.discountCodes.apply('cart_abc123', 'SUMMER20', {
   spreeToken: '<token>',
 })
 
-// Remove a coupon code from the cart
-await client.carts.couponCodes.remove('cart_abc123', 'SUMMER20', {
+// Remove a discount code from the cart
+await client.carts.discountCodes.remove('cart_abc123', 'SUMMER20', {
   spreeToken: '<token>',
 })
 ```

package/dist/developer/core-concepts/store-credits-gift-cards.md

@@ -248,15 +248,21 @@ Gift cards are applied using the same coupon codes endpoint as promotion codes.
 
 ```typescript SDK
 // Apply gift card code to cart (works for guests and registered customers)
-const cart = await client.carts.couponCodes.apply('cart_abc123', 'abc1234def', {
+// Gift cards use a dedicated endpoint — they reduce amount_due, not total
+const cart = await client.carts.giftCards.apply('cart_abc123', 'abc1234def', {
+  spreeToken: '<token>',
+})
+
+// Remove gift card (ID from cart.gift_card.id)
+await client.carts.giftCards.remove('cart_abc123', cart.gift_card.id, {
   spreeToken: '<token>',
 })
 ```
 
 ```bash cURL
 # Apply gift card to cart (works for guests and registered customers)
-curl -X POST 'https://api.mystore.com/api/v3/store/carts/cart_abc123/coupon_codes' \
-  -H 'Authorization: Bearer spree_pk_xxx' \
+curl -X POST 'https://api.mystore.com/api/v3/store/carts/cart_abc123/gift_cards' \
+  -H 'X-Spree-Api-Key: pk_xxx' \
   -H 'X-Spree-Token: <token>' \
   -H 'Content-Type: application/json' \
   -d '{ "code": "abc1234def" }'

package/dist/developer/sdk/quickstart.md

@@ -61,13 +61,15 @@ The SDK uses a resource builder pattern for nested resources:
 | `carts` | `paymentMethods` | `list` |
 | `carts` | `paymentSessions` | `create`, `get`, `update`, `complete` |
 | `carts` | `fulfillments` | `list`, `update` |
-| `carts` | `couponCodes` | `apply`, `remove` |
+| `carts` | `discountCodes` | `apply`, `remove` |
+| `carts` | `giftCards` | `apply`, `remove` |
 | `carts` | `storeCredits` | `apply`, `remove` |
 | `customer` | `addresses` | `list`, `get`, `create`, `update`, `delete`, `markAsDefault` |
 | `customer` | `creditCards` | `list`, `get`, `delete` |
 | `customer` | `giftCards` | `list`, `get` |
 | `customer` | `orders` | `list` |
 | `customer` | `paymentSetupSessions` | `create`, `get`, `complete` |
+| `policies` | — | `list`, `get` |
 | `categories` | `products` | `list` |
 | `wishlists` | `items` | `create`, `update`, `delete` |
 

package/dist/developer/sdk/store/cart-checkout.md

@@ -55,16 +55,26 @@ await client.carts.items.update(cartId, lineItemId, {
 await client.carts.items.delete(cartId, lineItemId, options);
 ```
 
-### Coupon Codes
+### Discount Codes
 
 ```typescript
 const options = { spreeToken: cart.token };
 
-// Apply a coupon code
-await client.carts.couponCodes.apply(cartId, 'SAVE20', options);
+// Apply a discount code
+await client.carts.discountCodes.apply(cartId, 'SAVE20', options);
 
-// Remove a coupon code
-await client.carts.couponCodes.remove(cartId, 'SUMMER20', options);
+// Remove a discount code
+await client.carts.discountCodes.remove(cartId, 'SAVE20', options);
+```
+
+### Gift Cards
+
+```typescript
+// Apply a gift card (reduces amount_due, not total)
+const cart = await client.carts.giftCards.apply(cartId, 'GC-ABCD-1234', options);
+
+// Remove a gift card (ID from cart.gift_card.id)
+await client.carts.giftCards.remove(cartId, 'gc_abc123', options);
 ```
 
 ## Checkout

package/dist/developer/storefront/nextjs/spree-next-package.md

@@ -120,19 +120,21 @@ Checkout functions use the implicit cart resolved from cookies. No `orderId` is
 import {
   getCheckout,
   updateCheckout,
-  getFulfillments,
   selectDeliveryRate,
-  applyCoupon,
-  removeCoupon,
+  applyDiscountCode,
+  removeDiscountCode,
+  applyGiftCard,
+  removeGiftCard,
   complete,
 } from '@spree/next';
 
 const checkout = await getCheckout();
 await updateCheckout({ shipping_address: { ... }, billing_address: { ... } });
-const fulfillments = await getFulfillments();
 await selectDeliveryRate(fulfillmentId, deliveryRateId);
-await applyCoupon('SAVE20');
-await removeCoupon(promotionId);
+await applyDiscountCode('SAVE20');
+await removeDiscountCode('SAVE20');
+await applyGiftCard('GC-ABCD-1234');
+await removeGiftCard('gc_abc123');
 await complete();
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spree/docs",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Spree Commerce developer documentation for AI agents and local reference",
   "type": "module",
   "license": "CC-BY-4.0",