arky-sdk 0.10.0 → 0.11.0

package/README.md

@@ -137,7 +137,7 @@ console.log(setup.languages.default, setup.markets.default);
 Payment configuration belongs to Arky. Mounting card payment waits for setup internally and accepts no Stripe publishable key or connected Account ID:
 
 ```typescript
-await arky.eshop.cart.payment.mountStripe("#payment", {
+await arky.eshop.cart.payment.mount("#payment", {
   appearance: { theme: "stripe" },
 });
 ```
@@ -145,12 +145,16 @@ await arky.eshop.cart.payment.mountStripe("#payment", {
 For a paid flow outside the cart, pass only customer-facing amount and currency:
 
 ```typescript
-await arky.eshop.cart.payment.mountStripe("#payment", {
+await arky.eshop.cart.payment.mount("#payment", {
   amount: 2500,
   currency: "EUR",
+  setupFutureUsage: "off_session",
 });
 ```
 
+`setupFutureUsage` is optional. Use `"off_session"` when the paid flow will
+reuse the payment method later, such as a subscription.
+
 ## SSR and static generation
 
 Anonymous reads work without browser storage. Stateful SSR requires an explicit request-local adapter so a server module cannot retain one visitor across requests:
@@ -175,7 +179,8 @@ The module facade exposes its low-level client as `arky.client`:
 
 ```typescript
 await arky.client.eshop.product.find({ limit: 20 });
-await arky.client.eshop.cart.current();
+const cart = await arky.client.eshop.cart.current();
+await arky.client.eshop.cart.get({ id: cart.id, token: cart.token });
 await arky.client.cms.entry.find({
   collection_id: "pages",
   key: "homepage",
@@ -192,6 +197,9 @@ X-Arky-Market: ita
 Authorization: Bearer arky_vst_...
 ```
 
+For cart recovery, `cart.get({ id, token })` sends the recovery credential as
+`X-Arky-Cart-Token`. It is never placed in the request URL or body.
+
 Locale and market headers are omitted when no explicit context is set, allowing the server to use Store defaults.
 
 ## Configuration