arky-sdk 0.7.120 → 0.7.122

package/README.md

@@ -94,6 +94,38 @@ const order = await arky.eshop.cart.checkout({
 });
 ```
 
+### Framework-agnostic Cart Controller
+
+For storefront UI state, use the headless cart controller instead of wiring cart API calls directly into a framework store:
+
+```typescript
+const storefront = createStorefront({
+  baseUrl: 'https://api.arky.io',
+  storeId: 'your-store-id',
+  market: 'us',
+})
+
+const unsubscribe = storefront.cart.subscribe((state) => {
+  console.log(state.cart, state.quote, state.loading, state.error)
+})
+
+await storefront.cart.init()
+await storefront.cart.addItem({
+  item: {
+    type: 'product',
+    product_id: 'prod_123',
+    variant_id: 'var_456',
+    quantity: 1,
+  },
+})
+await storefront.cart.quote()
+await storefront.cart.checkout({ payment_method_id: 'credit_card' })
+
+unsubscribe()
+```
+
+The controller exposes `subscribe`, `getState`, `init`, `refresh`, `addItem`, `update`, `removeItem`, `clear`, `quote`, and `checkout`. It is framework-agnostic and uses the existing storefront cart API methods under the hood.
+
 ### 4. Sell Scheduled Services
 
 ```typescript

package/dist/admin.cjs

@@ -1091,6 +1091,73 @@ var createEshopApi = (apiConfig) => {
         options
       );
     },
+    async createCart(params, options) {
+      const { store_id, ...payload } = params;
+      const target_store_id = store_id || apiConfig.storeId;
+      return apiConfig.httpClient.post(
+        `/v1/stores/${target_store_id}/carts`,
+        {
+          ...payload,
+          items: normalizeOrderCheckoutItems(payload.items || [])
+        },
+        options
+      );
+    },
+    async updateCart(params, options) {
+      const { id, store_id, items, ...payload } = params;
+      const target_store_id = store_id || apiConfig.storeId;
+      return apiConfig.httpClient.put(
+        `/v1/stores/${target_store_id}/carts/${id}`,
+        {
+          ...payload,
+          ...items ? { items: normalizeOrderCheckoutItems(items) } : {}
+        },
+        options
+      );
+    },
+    async addCartItem(params, options) {
+      const { id, store_id, item } = params;
+      const target_store_id = store_id || apiConfig.storeId;
+      return apiConfig.httpClient.post(
+        `/v1/stores/${target_store_id}/carts/${id}/items`,
+        { item: normalizeOrderCheckoutItems([item])[0] },
+        options
+      );
+    },
+    async removeCartItem(params, options) {
+      const { id, store_id, ...payload } = params;
+      const target_store_id = store_id || apiConfig.storeId;
+      return apiConfig.httpClient.post(
+        `/v1/stores/${target_store_id}/carts/${id}/items/remove`,
+        payload,
+        options
+      );
+    },
+    async clearCart(params, options) {
+      const target_store_id = params.store_id || apiConfig.storeId;
+      return apiConfig.httpClient.post(
+        `/v1/stores/${target_store_id}/carts/${params.id}/clear`,
+        {},
+        options
+      );
+    },
+    async quoteCart(params, options) {
+      const target_store_id = params.store_id || apiConfig.storeId;
+      return apiConfig.httpClient.post(
+        `/v1/stores/${target_store_id}/carts/${params.id}/quote`,
+        {},
+        options
+      );
+    },
+    async checkoutCart(params, options) {
+      const { id, store_id, ...payload } = params;
+      const target_store_id = store_id || apiConfig.storeId;
+      return apiConfig.httpClient.post(
+        `/v1/stores/${target_store_id}/carts/${id}/checkout`,
+        payload,
+        options
+      );
+    },
     async getQuote(params, options) {
       const { location, store_id, items, ...rest } = params;
       const target_store_id = store_id || apiConfig.storeId;
@@ -2284,8 +2351,15 @@ function createAdmin(config) {
         processRefund: eshopApi.processRefund
       },
       cart: {
+        create: eshopApi.createCart,
+        update: eshopApi.updateCart,
         get: eshopApi.getCart,
-        find: eshopApi.getCarts
+        find: eshopApi.getCarts,
+        addItem: eshopApi.addCartItem,
+        removeItem: eshopApi.removeCartItem,
+        clear: eshopApi.clearCart,
+        quote: eshopApi.quoteCart,
+        checkout: eshopApi.checkoutCart
       },
       service: {
         create: eshopApi.createService,