@spree/docs 0.1.3 → 0.1.5

package/dist/developer/sdk/store/account.md

@@ -10,6 +10,7 @@ const options = { token: jwtToken };
 
 // Get profile
 const profile = await client.customer.get(options);
+// profile includes `available_store_credit_total` and `display_available_store_credit_total`
 
 // Update profile
 await client.customer.update({
@@ -38,17 +39,31 @@ await client.customer.addresses.create({
   postal_code: '10001',
   country_iso: 'US',
   state_abbr: 'NY',
+  is_default_billing: true,   // Optional — set as default billing address
+  is_default_shipping: true,  // Optional — set as default shipping address
 }, options);
 
 // Update address
-await client.customer.addresses.update('addr_xxx', { city: 'Brooklyn' }, options);
+await client.customer.addresses.update('addr_xxx', {
+  city: 'Brooklyn',
+  is_default_billing: true,   // Optional — set as default billing address
+  is_default_shipping: false,  // Optional — set as default shipping address
+}, options);
 
 // Delete address
 await client.customer.addresses.delete('addr_xxx', options);
+```
+
+## Store Credits
+
+```typescript
+const options = { token: jwtToken };
+
+// List store credits
+const { data: credits } = await client.customer.storeCredits.list({}, options);
 
-// Mark as default billing or shipping address
-await client.customer.addresses.markAsDefault('addr_xxx', 'billing', options);
-await client.customer.addresses.markAsDefault('addr_xxx', 'shipping', options);
+// Get a specific store credit
+const credit = await client.customer.storeCredits.get('sc_xxx', options);
 ```
 
 ## Credit Cards

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

@@ -96,11 +96,14 @@ await client.carts.complete(cartId, { spreeToken: cart.token });
 
 ### Fulfillments
 
+Fulfillments are included in the cart response — there is no separate list endpoint.
+
 ```typescript
 const options = { spreeToken: cart.token };
 
-// List fulfillments
-const fulfillments = await client.carts.fulfillments.list(cartId, options);
+// Access fulfillments from the cart response
+const cart = await client.carts.get(cartId, options);
+const fulfillments = cart.fulfillments;
 
 // Select a delivery rate
 await client.carts.fulfillments.update(cartId, fulfillmentId, {
@@ -123,6 +126,13 @@ await client.carts.storeCredits.apply(cartId, 25.00, options);
 await client.carts.storeCredits.remove(cartId, options);
 ```
 
+The cart/order response includes store credit and gift card totals:
+
+- `store_credit_total` / `display_store_credit_total` — total store credit applied
+- `gift_card_total` / `display_gift_card_total` — total gift card value applied
+- `covered_by_store_credit` — boolean, whether the order is fully covered by store credit
+- `gift_card` — associated gift card (if applicable)
+
 ## Orders
 
 ### Get a Completed Order

package/dist/developer/sdk/store/payments.md

@@ -7,13 +7,18 @@ All payment and delivery endpoints require a `cartId` as the first argument.
 
 ## Payment Methods
 
+Payment methods, payments, and fulfillments are included in the cart response -- there are no separate list or get endpoints for these resources.
+
 ```typescript
 const options = { spreeToken: cart.token };
 
-// Get available payment methods for the current cart
-const methods = await client.carts.paymentMethods.list(cartId, options);
+// Access payment methods, payments, and fulfillments from the cart response
+const cart = await client.carts.get(cartId, options);
+const paymentMethods = cart.payment_methods;
+const payments = cart.payments;
+const fulfillments = cart.fulfillments;
 
-// Each method includes a `session_required` flag:
+// Each payment method includes a `session_required` flag:
 // - true  → use Payment Sessions (Stripe, Adyen, PayPal, etc.)
 // - false → use direct payment creation (Check, Cash on Delivery, Bank Transfer, etc.)
 ```
@@ -23,12 +28,6 @@ const methods = await client.carts.paymentMethods.list(cartId, options);
 ```typescript
 const options = { spreeToken: cart.token };
 
-// List payments on the current cart
-const payments = await client.carts.payments.list(cartId, options);
-
-// Get a specific payment
-const payment = await client.carts.payments.get(cartId, paymentId, options);
-
 // Create a payment for a non-session payment method
 // (e.g. Check, Cash on Delivery, Bank Transfer, Purchase Order)
 const payment = await client.carts.payments.create(cartId, {
@@ -86,8 +85,9 @@ console.log(completed.status); // 'completed'
 ```typescript
 const options = { spreeToken: cart.token };
 
-// List fulfillments for the current cart
-const fulfillments = await client.carts.fulfillments.list(cartId, options);
+// Fulfillments are included in the cart response
+const cart = await client.carts.get(cartId, options);
+const fulfillments = cart.fulfillments;
 
 // Select a delivery rate
 await client.carts.fulfillments.update(cartId, fulfillmentId, {

package/package.json

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