@spree/docs 0.1.263 → 0.1.265

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/webhooks.md

@@ -12,7 +12,7 @@ Webhooks are built on top of Spree's [event system](events.md), providing:
 - **Multi-store support** - Each store has its own webhook endpoints
 - **Event filtering** - Subscribe to specific events or patterns with wildcards
 - **Secure delivery** - HMAC-SHA256 signatures for payload verification
-- **Failure handling** - Failed deliveries are recorded and can be re-sent, and an endpoint that keeps failing is disabled
+- **Failure handling** - Failed deliveries are retried automatically and can be re-sent by hand, and an endpoint that keeps failing is disabled
 - **Full audit trail** - Track every delivery attempt with response codes and timing
 
 ## How Webhooks Work
@@ -269,7 +269,9 @@ end
 
 ### Failed Deliveries
 
-Spree sends each delivery once. Any response other than 2xx — including a timeout or a connection error — marks the delivery as failed, and Spree does not send it again on its own. To send a failed delivery again, re-send it from the delivery log (see below).
+Any response other than 2xx — including a timeout or a connection error — marks the delivery as failed. Spree then sends it again, waiting longer before each try, up to 5 attempts in total over about six minutes. The delivery log shows the outcome of the latest attempt. Retries stop as soon as the endpoint is turned off.
+
+Every attempt carries the same event `id`, so use it to ignore an event your receiver has already processed. To send a delivery again after the retries run out, re-send it from the delivery log (see below).
 
 If an endpoint fails 15 deliveries in a row, Spree disables it and emails the store staff. Fix the endpoint, then turn it back on by marking it active again.
 

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/dist/developer/tutorial/events.md

@@ -63,7 +63,7 @@ When the consumer is a system you do not deploy your own code into, use a webhoo
 
 Each delivery is an HTTP POST carrying the event name and the same serialized payload. The endpoint's **signing secret is shown once when you create it**: store it in the receiving system and verify every request against it, so the receiver can prove the call came from your store.
 
-Deliveries are retried with exponential backoff, and the dashboard shows the attempt history per endpoint, which is where to look when a third party says they never received something.
+Failed deliveries are retried with increasing delays, and the dashboard shows the delivery history per endpoint, which is where to look when a third party says they never received something.
 
 > **TIP:** Webhooks need no code in your app at all. Reach for a subscriber only when the reaction needs application context or credentials you would rather not hand to a third party. See [events](../core-concepts/events.md) and [webhooks](../core-concepts/webhooks.md).
 

package/package.json

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