@spree/docs 0.1.6 → 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/pricing.md

@@ -155,6 +155,81 @@ Price Lists are managed in the Admin Panel under **Products → Price Lists**, o
 
 Each Price List contains prices for specific variants and currencies. Products can be added to a Price List, and individual variant prices set within it.
 
+## Price History (EU Omnibus Directive)
+
+Spree automatically records price changes for EU Omnibus Directive compliance. When a product goes on sale, EU regulations require displaying the lowest price in the preceding 30 days alongside the discounted price.
+
+### How It Works
+
+Every time a base price amount changes, a `PriceHistory` record is created automatically. Price list prices are not tracked — only the base price visible to all customers.
+
+### Fetching Prior Price via API
+
+The prior price is available as an expandable field on product and variant endpoints:
+
+
+```typescript SDK
+const product = await client.products.get('spree-tote', {
+  expand: ['prior_price'],
+})
+
+if (product.prior_price) {
+  console.log(product.prior_price.amount)         // "9.99"
+  console.log(product.prior_price.display_amount)  // "$9.99"
+  console.log(product.prior_price.currency)        // "USD"
+  console.log(product.prior_price.recorded_at)     // "2026-03-10T..."
+}
+```
+
+```bash cURL
+curl 'https://api.mystore.com/api/v3/store/products/spree-tote?expand=prior_price' \
+  -H 'X-Spree-API-Key: spree_pk_xxx'
+```
+
+
+The response includes a `prior_price` object when expanded:
+
+```json
+{
+  "id": "prod_xxx",
+  "name": "Spree Tote",
+  "price": { "amount": "15.99", "currency": "USD", "display_amount": "$15.99" },
+  "prior_price": {
+    "amount": "9.99",
+    "amount_in_cents": 999,
+    "currency": "USD",
+    "display_amount": "$9.99",
+    "recorded_at": "2026-03-10T14:30:00Z"
+  }
+}
+```
+
+### Configuration
+
+Price history tracking is enabled by default. To disable it (e.g., for non-EU stores):
+
+```ruby
+# config/initializers/spree.rb
+Spree.config do |config|
+  config.track_price_history = false
+  config.price_history_retention_days = 30 # default
+end
+```
+
+Price history retention defaults to 30 days and can be configured globally. A Rake task is provided for cleanup:
+
+```bash
+bundle exec rake spree:price_history:prune
+```
+
+### Seeding Existing Prices
+
+After enabling price history on an existing store, seed the current prices as a baseline:
+
+```bash
+bundle exec rake spree:price_history:seed
+```
+
 ## Related Documentation
 
 - [Products](products.md) — Products, Variants, and base prices

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/sdk/store/products.md

@@ -84,6 +84,25 @@ const product = await client.products.get('spree-tote', {
 });
 ```
 
+### Prior Price (EU Omnibus Directive)
+
+When a product is on sale, EU regulations require displaying the lowest price in the last 30 days. Use the `prior_price` expand to fetch this:
+
+```typescript
+const product = await client.products.get('spree-tote', {
+  expand: ['prior_price'],
+});
+
+if (product.prior_price) {
+  console.log(product.prior_price.amount);         // "9.99"
+  console.log(product.prior_price.display_amount);  // "$9.99"
+  console.log(product.prior_price.currency);        // "USD"
+  console.log(product.prior_price.recorded_at);     // "2026-03-10T..."
+}
+```
+
+> **INFO:** Prior price is only relevant on product detail pages (PDP), not on listings. It returns `null` if no price history exists within the 30-day window. Price history tracking can be disabled globally via `Spree::Config[:track_price_history] = false`.
+
 ### Product Filters
 
 Get available filters (price range, availability, options, categories) and sort options for building filter UIs:

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.6",
+  "version": "0.1.8",
   "description": "Spree Commerce developer documentation for AI agents and local reference",
   "type": "module",
   "license": "CC-BY-4.0",