@spree/docs 0.1.4 → 0.1.6

package/dist/developer/admin/admin.md

@@ -4,7 +4,7 @@ sidebarTitle: Overview
 description: Learn how to customize and extend the Spree Admin Dashboard
 ---
 
-The Spree Admin Dashboard is a full-featured administration interface for managing your e-commerce store. It's built with Ruby on Rails and ships as the `spree_admin` gem.
+The Spree Admin Dashboard is a full-featured administration interface for managing your e-commerce store.
 
 <img src="/images/spree_admin_dashboard.png" alt="Spree Admin Dashboard" />
 

package/dist/developer/admin/custom-javascript.md

@@ -6,7 +6,7 @@ description: Learn how to add custom JavaScript to your Spree Admin Dashboard
 
 ## Extending Admin Dashboard with JavaScript
 
-Spree Admin Dashboard can be easily extended with custom JavaScript. Most of the JavaScript in the Admin Dashboard is powered by a framework called [Stimulus.js](https://stimulus.hotwired.dev/) which is the Ruby on Rails default. It's a very simple and minimalistic framework only enhancing our server-side rendered HTML with a bit of interactivity.
+Spree Admin Dashboard can be easily extended with custom JavaScript. Most of the JavaScript in the Admin Dashboard is powered by a framework called [Stimulus.js](https://stimulus.hotwired.dev/). It's a very simple and minimalistic framework only enhancing our server-side rendered HTML with a bit of interactivity.
 
 ### 3rd party JavaScript libraries
 
@@ -29,7 +29,7 @@ You're probably wondering why these libraries are in the `vendor` directory, and
 
 That's because we're not using Node.js at all. So no Yarn or npm. We're using a different approach to manage dependencies.
 
-We're using a tool called [Importmaps](https://github.com/rails/importmap-rails) to manage dependencies which is the Ruby on Rails default.
+We're using a tool called [Importmaps](https://github.com/rails/importmap-rails) to manage dependencies.
 
 > **INFO:** If you want to use a different JavaScript package manager you can do so by using [jsbundling-rails](https://github.com/rails/jsbundling-rails) gem.
 

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/dist/developer/security/security_policy.md

@@ -58,7 +58,7 @@ Published security advisories can be found at [GitHub Security Advisories](https
 
 ## Security Best Practices
 
-Spree is built on **Ruby on Rails** which provides strong security defaults including protection against SQL injection, CSRF, and XSS. For more details on how Spree handles security in production environments, see the [Enterprise Security Overview](/user/security).
+Spree API is built on **Ruby on Rails** which provides strong security defaults including protection against SQL injection, CSRF, and XSS. For more details on how Spree handles security in production environments, see the [Enterprise Security Overview](/user/security).
 
 We recommend:
 

package/dist/integrations/sso-mfa-social-login/admin-dashboard.md

@@ -38,8 +38,8 @@ Each SSO integration needs to be scoped individually. The integration plan depen
   - Each provider has unique configuration details, such as OAuth endpoints, certificates, tenant IDs, and federation settings. You’ll need to gather these to complete integration.
 - **Existing or planned Spree customizations**
   - Custom authentication flows, extended user models, or unique admin permissions may affect how SSO is integrated. These should be reviewed before implementation.
-- **Spree and Ruby on Rails versions**
-  - Compatibility matters. Integration strategies can differ depending on whether you’re on the latest Spree release and which Rails version your project runs on.
+- **Spree version**
+  - Compatibility matters. Integration strategies can differ depending on whether you’re on the latest Spree release.
 - **Use case: single tenant vs. multi-tenant**
   - Single-tenant stores usually need straightforward workforce SSO. Multi-tenant or SaaS-style deployments may require isolated tenant directories and more complex provisioning.
 - **Identity governance requirements** (role-based access, just-in-time provisioning)

package/dist/integrations/sso-mfa-social-login/storefront.md

@@ -39,8 +39,8 @@ Each storefront integration must be scoped individually. Consider the following:
   - Decide whether you only want to add social login on top of Spree’s existing authentication or fully replace it with a unified SSO + social login solution.
 - **Existing or planned Spree customizations**
   - Customized signup flows, checkout flows, or customer segmentation logic may impact integration design. These need to be factored in during scoping.
-- **Spree and Ruby on Rails versions**
-  - Ensure compatibility with your Spree and Rails versions. Older projects may need adjustments to take advantage of newer identity management features.
+- **Spree version**
+  - Ensure compatibility with your Spree version. Older projects may need adjustments to take advantage of newer identity management features.
 - **Identity governance requirements** (segmentation, customer role-based access)
 - **User lifecycle management** (account creation, deactivation, syncing)
 - **Security posture** (MFA for customers, adaptive login, fraud detection)

package/package.json

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