arky-sdk 0.7.118 → 0.7.120

package/README.md

@@ -76,19 +76,21 @@ 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',
 });
 ```
 
@@ -106,10 +108,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 +121,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 +223,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 +250,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({})
 ```
 
@@ -342,7 +352,7 @@ await arky.utils.injectSvgIntoElement(mediaBlock, element, 'custom-class')
 
 - 🏪 **E-commerce shops** - Product catalogs, shopping carts, checkout
 - 📰 **Content websites** - Blogs, documentation, marketing sites
-- 📅 **Booking platforms** - Appointment scheduling, service bookings
+- 📅 **Service businesses** - Appointment scheduling, service orders
 - 📬 **Newsletter platforms** - Subscriber management, email campaigns
 - 🏢 **SaaS products** - Multi-tenant apps with user auth and billing
 - 🛍️ **Marketplaces** - Multi-vendor platforms with payments
@@ -393,7 +403,7 @@ When adding a new SDK method, follow this checklist so the API surface stays typ
 2. **Define the request params** in `src/types/api.ts`. Mirror the Rust DTO in `server/core/src/{module}/types/commands.rs` field-for-field. Two exceptions: `store_id?: string` and `market?: string` are optional in TS (the SDK auto-fills both from `apiConfig.storeId` and `apiConfig.market`). Do **not** use `[key: string]: any` index signatures.
 3. **Annotate the SDK method's return type** using the matching entity from `src/types/index.ts`.
 4. **Pass the response generic to the HTTP call**: `apiConfig.httpClient.post<EntityType>(...)`, `apiConfig.httpClient.get<PaginatedResponse<EntityType>>(...)`, etc. Never rely on inference.
-5. **Inject `market` from `apiConfig`**: when a body needs a `market` field, write `{ market: apiConfig.market, ...payload }`. Never hardcode `"booking"`, `"eshop"`, or any other market string in `src/api/*.ts`.
+5. **Inject `market` from `apiConfig`**: when a body needs a `market` field, write `{ market: apiConfig.market, ...payload }`. Never hardcode `"default"`, `"eshop"`, or any other market string in `src/api/*.ts`.
 6. **Re-export the entity** from `src/index.ts` if consumers (admin, storefront) will import it.
 7. **Bump `SDK_VERSION`** in `src/index.ts` and the `version` in `package.json`. Patch only.
 

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,24 @@ 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 getQuote(params, options) {
       const { location, store_id, items, ...rest } = params;
       const target_store_id = store_id || apiConfig.storeId;
@@ -1271,6 +1260,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 +2277,16 @@ 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: {
+        get: eshopApi.getCart,
+        find: eshopApi.getCarts
+      },
       service: {
         create: eshopApi.createService,
         update: eshopApi.updateService,