@viu/emporix-sdk 2.6.0 → 2.8.0

package/dist/index.cjs

@@ -1124,26 +1124,67 @@ var CategoryService = class {
     const pageSize = params.pageSize ?? 50;
     return iterateAll((pageNumber) => this.list({ pageNumber, pageSize }, auth2));
   }
-  /** Fetches the category tree, optionally rooted at `rootId`. */
-  async tree(rootId, auth2 = ANON2) {
+  /**
+   * The catalogue's **root categories** — the published category trees
+   * (`GET /category-trees`). Use these for top-level storefront navigation;
+   * drill into a node's children with {@link subcategories}.
+   */
+  async tree(auth2 = ANON2) {
     return this.ctx.http.request({
       method: "GET",
-      path: `/category/${this.ctx.tenant}/categories/tree`,
-      query: rootId ? { rootId } : {},
+      path: `/category/${this.ctx.tenant}/category-trees`,
+      auth: auth2
+    });
+  }
+  /**
+   * Direct child categories of a category (for hierarchy drill-down). Mirrors
+   * {@link productsIn}: reads the category's **assignments** and keeps the
+   * `CATEGORY` references, resolving them to full categories. Returns an empty
+   * array when the category has no child categories.
+   */
+  async subcategories(categoryId, params = {}, auth2 = ANON2) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const assignments = await this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/${categoryId}/assignments`,
+      query: { pageNumber, pageSize },
       auth: auth2
     });
+    const categoryIds = assignments.map((a) => a.ref?.type?.toUpperCase() === "CATEGORY" ? a.ref.id : void 0).filter((id) => Boolean(id));
+    if (categoryIds.length === 0) return [];
+    return this.searchByIds(categoryIds, {}, auth2);
   }
-  /** One page of products in a category. */
+  /**
+   * One page of products in a category. The category service exposes products
+   * as **assignments** (`/categories/{id}/assignments`) — references, not full
+   * products — so this fetches a page of assignments, keeps the `PRODUCT`
+   * references, and resolves them to full products via `/products/search`.
+   * `hasNextPage` reflects the assignments page (the source of truth for
+   * pagination).
+   */
   async productsIn(categoryId, params = {}, auth2 = ANON2) {
     const pageNumber = params.pageNumber ?? 1;
     const pageSize = params.pageSize ?? 50;
-    const items = await this.ctx.http.request({
+    const assignments = await this.ctx.http.request({
       method: "GET",
-      path: `/category/${this.ctx.tenant}/categories/${categoryId}/products`,
+      path: `/category/${this.ctx.tenant}/categories/${categoryId}/assignments`,
       query: { pageNumber, pageSize },
       auth: auth2
     });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    const hasNextPage = assignments.length === pageSize;
+    const productIds = assignments.map((a) => a.ref?.type?.toUpperCase() === "PRODUCT" ? a.ref.id : void 0).filter((id) => Boolean(id));
+    if (productIds.length === 0) {
+      return { items: [], pageNumber, pageSize, hasNextPage };
+    }
+    const items = await this.ctx.http.request({
+      method: "POST",
+      path: `/product/${this.ctx.tenant}/products/search`,
+      query: { pageSize: productIds.length },
+      auth: auth2,
+      body: { q: `id:(${productIds.join(",")})` }
+    });
+    return { items, pageNumber, pageSize, hasNextPage };
   }
   /**
    * Bulk fetch by id. POSTs `/categories/search` with `q="id:(id1,id2,…)"`,
@@ -1261,13 +1302,19 @@ var CartService = class {
       body: items
     });
   }
-  /** Updates an item. */
-  async updateItem(cartId, itemId, patch, auth2) {
+  /**
+   * Updates an item. By default this is a **full replace** — the server expects
+   * the complete item (e.g. `itemYrn` + the `price` row). Pass
+   * `{ partial: true }` to send a **partial update** (`?partial=true`), e.g. a
+   * quantity-only change with just `{ quantity }`.
+   */
+  async updateItem(cartId, itemId, patch, auth2, opts = {}) {
     return this.ctx.http.request({
       method: "PUT",
       path: `${this.base()}/${cartId}/items/${itemId}`,
       auth: requireCartAuth(auth2),
-      body: patch
+      body: patch,
+      ...opts.partial ? { query: { partial: "true" } } : {}
     });
   }
   /** Removes an item. */
@@ -4973,7 +5020,7 @@ var ApprovalService = class {
 };
 
 // package.json
-var version = "2.6.0";
+var version = "2.8.0";
 
 // src/version.ts
 var SDK_VERSION = version;