arky-sdk 0.7.119 → 0.7.121

package/README.md

@@ -76,22 +76,56 @@ const formatted = arky.utils.formatPrice(product.variants[0].prices); // "$29.99
 ### 3. Shop & Checkout
 
 ```typescript
-// Add to cart and checkout (like arky.io/cart)
-const order = await arky.eshop.checkout({
-  items: [{
-    productId: 'prod_123',
-    variantId: 'var_456',
-    quantity: 2
-  }],
-  paymentMethod: 'CREDIT_CARD',
-  shippingMethodId: 'standard',
-  blocks: [  // Customer info
-    { key: 'email', values: ['customer@example.com'] },
-    { key: 'shipping_address', values: ['123 Main St'] }
-  ]
+const cart = await arky.eshop.cart.current();
+
+await arky.eshop.cart.addItem({
+  id: cart.id,
+  item: {
+    type: 'product',
+    product_id: 'prod_123',
+    variant_id: 'var_456',
+    quantity: 2,
+  },
+});
+
+const order = await arky.eshop.cart.checkout({
+  id: cart.id,
+  payment_method_id: 'credit_card',
 });
 ```
 
+### 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
@@ -106,10 +140,12 @@ const availability = await arky.eshop.service.getAvailability({
   to: Math.floor(Date.now() / 1000) + 86400,
 });
 
-// Create an order with a service line
-const order = await arky.eshop.order.checkout({
+const cart = await arky.eshop.cart.current();
+
+await arky.eshop.cart.update({
+  id: cart.id,
   items: [{
-    type: 'service',
+    type: 'booking',
     service_id: 'service_haircut',
     provider_id: 'provider_jane',
     slots: [{
@@ -117,9 +153,13 @@ const order = await arky.eshop.order.checkout({
       to: availability.available_slots[0].to,
     }],
   }],
-  payment_method: 'cash',
   forms: [],
 });
+
+const order = await arky.eshop.cart.checkout({
+  id: cart.id,
+  payment_method_id: 'cash',
+});
 ```
 
 ### 5. Subscribe to Newsletter
@@ -215,8 +255,10 @@ await arky.eshop.getProducts({ limit: 20, cursor: null })
 await arky.eshop.getProduct({ id })
 await arky.eshop.updateProduct({ id, name })
 
-// Orders
-await arky.eshop.checkout({ items, paymentMethod, shippingMethodId })
+// Carts and orders
+const cart = await arky.eshop.cart.current()
+await arky.eshop.cart.update({ id: cart.id, items, shipping_method_id })
+await arky.eshop.cart.checkout({ id: cart.id, payment_method_id })
 await arky.eshop.getOrders({})
 await arky.eshop.getOrder({ id })
 await arky.eshop.updateOrderStatus({ id, status: 'SHIPPED' })
@@ -240,9 +282,9 @@ await arky.eshop.service.getAvailability({ service_id, provider_id, from, to })
 await arky.eshop.provider.create({ name })
 await arky.eshop.provider.find({})
 
-// Service orders
+// Service cart checkout
 await arky.eshop.order.getQuote({ items, payment_method })
-await arky.eshop.order.checkout({ items, payment_method })
+await arky.eshop.cart.checkout({ id: cart.id, payment_method_id })
 await arky.eshop.order.find({})
 ```
 

package/dist/admin.cjs

@@ -1042,35 +1042,6 @@ var createEshopApi = (apiConfig) => {
         options
       );
     },
-    async createOrder(params, options) {
-      const { store_id, items, ...rest } = params;
-      const target_store_id = store_id || apiConfig.storeId;
-      const payload = {
-        ...rest,
-        market: rest.market || apiConfig.market,
-        items: normalizeOrderCheckoutItems(items)
-      };
-      return apiConfig.httpClient.post(
-        `/v1/stores/${target_store_id}/orders`,
-        payload,
-        options
-      );
-    },
-    async checkoutOrder(params, options) {
-      const { store_id, items, ...rest } = params;
-      const target_store_id = store_id || apiConfig.storeId;
-      const payload = {
-        ...rest,
-        store_id: target_store_id,
-        market: rest.market || apiConfig.market,
-        items: normalizeOrderCheckoutItems(items)
-      };
-      return apiConfig.httpClient.post(
-        `/v1/stores/${target_store_id}/orders/checkout`,
-        payload,
-        options
-      );
-    },
     async updateOrder(params, options) {
       const { store_id, items, ...rest } = params;
       const target_store_id = store_id || apiConfig.storeId;
@@ -1102,6 +1073,91 @@ var createEshopApi = (apiConfig) => {
         }
       );
     },
+    async getCarts(params = {}, options) {
+      const { store_id, ...queryParams } = params;
+      const target_store_id = store_id || apiConfig.storeId;
+      return apiConfig.httpClient.get(
+        `/v1/stores/${target_store_id}/carts`,
+        {
+          ...options,
+          params: queryParams
+        }
+      );
+    },
+    async getCart(params, options) {
+      const target_store_id = params.store_id || apiConfig.storeId;
+      return apiConfig.httpClient.get(
+        `/v1/stores/${target_store_id}/carts/${params.id}`,
+        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;
@@ -1271,6 +1327,8 @@ var createCustomerApi = (apiConfig) => {
       if (params?.query) queryParams.query = params.query;
       if (params?.taxonomy_query) queryParams.taxonomy_query = params.taxonomy_query;
       if (params?.status) queryParams.status = params.status;
+      if (params?.has_activity !== void 0) queryParams.has_activity = params.has_activity;
+      if (params?.has_cart !== void 0) queryParams.has_cart = params.has_cart;
       if (params?.sort_field) queryParams.sort_field = params.sort_field;
       if (params?.sort_direction) queryParams.sort_direction = params.sort_direction;
       return apiConfig.httpClient.get(
@@ -2286,14 +2344,23 @@ function createAdmin(config) {
         find: eshopApi.getProducts
       },
       order: {
-        create: eshopApi.createOrder,
         update: eshopApi.updateOrder,
         get: eshopApi.getOrder,
         find: eshopApi.getOrders,
         getQuote: eshopApi.getQuote,
-        checkout: eshopApi.checkoutOrder,
         processRefund: eshopApi.processRefund
       },
+      cart: {
+        create: eshopApi.createCart,
+        update: eshopApi.updateCart,
+        get: eshopApi.getCart,
+        find: eshopApi.getCarts,
+        addItem: eshopApi.addCartItem,
+        removeItem: eshopApi.removeCartItem,
+        clear: eshopApi.clearCart,
+        quote: eshopApi.quoteCart,
+        checkout: eshopApi.checkoutCart
+      },
       service: {
         create: eshopApi.createService,
         update: eshopApi.updateService,