@spree/docs 0.1.264 → 0.1.266

package/dist/api-reference/store.yaml

@@ -1615,6 +1615,8 @@ paths:
                     default: true
                     country_codes:
                     - US
+                    country_isos:
+                    - US
                     supported_locales:
                     - en
                 - id: cart_gbHJdmfrXB
@@ -1734,6 +1736,8 @@ paths:
                     default: true
                     country_codes:
                     - US
+                    country_isos:
+                    - US
                     supported_locales:
                     - en
                 meta:
@@ -1885,6 +1889,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -2085,6 +2091,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -2283,6 +2291,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -2611,6 +2621,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -2926,6 +2938,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -3122,6 +3136,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -3321,6 +3337,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -3607,6 +3625,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -3851,6 +3871,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -4084,6 +4106,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -4305,6 +4329,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -4535,6 +4561,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -4688,6 +4716,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -5396,6 +5426,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -5583,6 +5615,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -5890,6 +5924,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -7014,6 +7050,8 @@ paths:
                     default: true
                     country_codes:
                     - US
+                    country_isos:
+                    - US
                     supported_locales:
                     - en
                 meta:
@@ -7336,6 +7374,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
               schema:
@@ -8955,6 +8995,8 @@ paths:
                   default: true
                   country_codes:
                   - US
+                  country_isos:
+                  - US
                   supported_locales:
                   - en
                   - es
@@ -8973,6 +9015,9 @@ paths:
                   country_codes:
                   - DE
                   - FR
+                  country_isos:
+                  - DE
+                  - FR
                   supported_locales:
                   - de
                   - en
@@ -9060,6 +9105,9 @@ paths:
                 country_codes:
                 - DE
                 - FR
+                country_isos:
+                - DE
+                - FR
                 supported_locales:
                 - de
                 - en
@@ -9143,6 +9191,9 @@ paths:
                 country_codes:
                 - DE
                 - FR
+                country_isos:
+                - DE
+                - FR
                 supported_locales:
                 - de
                 - en
@@ -10570,9 +10621,11 @@ paths:
       - api_key: []
         bearer_auth: []
       description: |
-        Adds a person to the node by email. An email that already belongs to a customer of
-        this store becomes a membership immediately (a `cmem_...` id); any other email
-        becomes an invitation (a `cinv_...` id) and the invite email goes out.
+        Invites a person to the node by email (a `cinv_...` id) and sends the invite email.
+        This is an invitation even when the email already belongs to a customer: they join
+        by accepting the emailed token, which proves they own the address and agree to join.
+        The response is the same either way, so it does not reveal whether the email has an
+        account.
       x-codeSamples:
       - lang: javascript
         label: Spree SDK
@@ -10584,9 +10637,8 @@ paths:
             publishableKey: '<api-key>',
           })
 
-          // An existing customer joins immediately (cmem_…); anyone else is emailed an
-          // invitation (cinv_…).
-          const member = await client.companies.members.create(
+          // Always an emailed invitation (cinv_…), even for an existing customer.
+          const invitation = await client.companies.members.create(
             'comp_86Rf07xd4z',
             { customer_email: 'colleague@acme.test' },
             { token: '<token>' },
@@ -10604,14 +10656,15 @@ paths:
           type: string
       responses:
         '201':
-          description: member added or invitation sent
+          description: invitation sent
           content:
             application/json:
               example:
-                id: cmem_gbHJdmfrXB
-                company_id: comp_UkLWZg9DAJ
-                customer_id: cust_gbHJdmfrXB
+                id: cinv_UkLWZg9DAJ
                 email: colleague@acme.test
+                expires_at: '2026-02-14T12:00:00.000Z'
+                company_id: comp_UkLWZg9DAJ
+                status: pending
       requestBody:
         content:
           application/json:
@@ -10936,7 +10989,6 @@ paths:
                     compare_at_amount:
                     thumbnail_url:
                     option_values: []
-                    digital_links: []
                   fulfillments:
                   - id: ful_UkLWZg9DAJ
                     number: R1001-F1
@@ -11080,6 +11132,8 @@ paths:
                     default: true
                     country_codes:
                     - US
+                    country_isos:
+                    - US
                     supported_locales:
                     - en
                 meta:
@@ -13668,7 +13722,6 @@ components:
       - compare_at_amount
       - thumbnail_url
       - option_values
-      - digital_links
       x-typelizer: true
     Locale:
       type: object
@@ -13706,6 +13759,10 @@ components:
           type: array
           items:
             type: string
+        country_isos:
+          type: array
+          items:
+            type: string
         supported_locales:
           type: array
           items:
@@ -13722,6 +13779,7 @@ components:
       - tax_inclusive
       - default
       - country_codes
+      - country_isos
       - supported_locales
       x-typelizer: true
     MediaEvent:

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

@@ -205,7 +205,7 @@ The available rule and action types — including any custom ones you register
 Coupon codes track promotion usage and can be single-use or multi-use.
 
 - **Single code** — set the `code` attribute on the promotion; `usage_limit` controls how many times it can be redeemed.
-- **Multi-code** — bulk-generated codes each track their own state (`unused` / `used`).
+- **Multi-code** — bulk-generated codes each track their own state (`unused` / `used`). A code is used up only when an order is placed with it. Applying it to a cart just holds it there, and a shopper who presents a code held by an abandoned cart takes it over, so an unfinished checkout never burns a code.
 
 Customers apply codes on the cart via the Store API:
 

package/dist/developer/how-to/build-a-b2b-store.md

@@ -125,7 +125,9 @@ A delivery site is an address, not a node. Ten warehouses do not mean ten compan
 
 ### Add the buyers
 
-People join a company by email. An existing customer becomes a member immediately. An unknown email receives an invitation that is valid for 30 days, and accepting it creates their account and their membership in one step. The ID prefix tells you which happened: `cmem_` for a membership, `cinv_` for an invitation.
+People join a company by email. When staff add someone through the Admin API, an existing customer becomes a member immediately, and an unknown email receives an invitation. The ID prefix tells you which happened: `cmem_` for a membership, `cinv_` for an invitation.
+
+When a member adds a colleague from the storefront, the colleague always receives an invitation, even if they already have an account. Anyone can type an email address, so joining requires accepting the emailed invitation, which proves the person owns that address. An invitation is valid for 30 days. Accepting it creates the account and the membership in one step, or links an existing signed-in customer whose email matches.
 
 
 ```typescript Admin SDK
@@ -135,8 +137,8 @@ const result = await adminClient.companies.memberships.create('comp_xxx', {
 ```
 
 ```typescript Store SDK
-// A member can add colleagues from the storefront in the same way
-const result = await client.companies.members.create('comp_xxx', {
+// A member invites colleagues from the storefront; they join by accepting
+const invitation = await client.companies.members.create('comp_xxx', {
   customer_email: 'colleague@acme.example',
 })
 ```

package/package.json

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