@viu/emporix-sdk 2.5.0 → 2.7.0

package/dist/index.cjs

@@ -366,6 +366,26 @@ async function resolveToken(ctx, provider) {
       return ctx.token;
   }
 }
+var CustomerRefreshRegistry = class {
+  refresher = null;
+  inflight = null;
+  set(refresher) {
+    this.refresher = refresher;
+  }
+  get enabled() {
+    return this.refresher !== null;
+  }
+  /** Concurrent callers share one in-flight refresh. */
+  refresh(expiredToken) {
+    if (!this.refresher) return Promise.resolve(null);
+    if (this.inflight) return this.inflight;
+    const p = Promise.resolve(this.refresher.refresh(expiredToken)).finally(() => {
+      this.inflight = null;
+    });
+    this.inflight = p;
+    return p;
+  }
+};
 var DefaultTokenProvider = class {
   constructor(cfg) {
     this.cfg = cfg;
@@ -567,8 +587,10 @@ var HttpClient = class {
     const sdkManaged = o.auth.kind === "service" || o.auth.kind === "anonymous";
     const maxAttempts = this.opts.retry.maxAttempts;
     let reauthed = false;
+    let customerToken = o.auth.kind === "customer" ? o.auth.token : void 0;
+    let customerReauthed = false;
     for (let attempt = 1; ; attempt++) {
-      const token = await resolveToken(o.auth, this.opts.provider);
+      const token = customerToken ?? await resolveToken(o.auth, this.opts.provider);
       log.debug("http request", {
         authKind: o.auth.kind,
         method: o.method,
@@ -620,6 +642,15 @@ var HttpClient = class {
           log.warn("sdk-managed 401, re-authing once", { authKind: o.auth.kind });
           continue;
         }
+        if (o.auth.kind === "customer" && !customerReauthed && this.opts.customerRefresh?.enabled) {
+          customerReauthed = true;
+          const fresh = await this.opts.customerRefresh.refresh(customerToken);
+          if (fresh) {
+            customerToken = fresh;
+            log.warn("customer 401, refreshed once", { authKind: o.auth.kind });
+            continue;
+          }
+        }
         throw errorFromResponse(res.status, `${o.method} ${o.path} \u2192 401`, parsed);
       }
       const retryable = res.status >= 500 || res.status === 429;
@@ -1093,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,…)"`,
@@ -4942,7 +5014,7 @@ var ApprovalService = class {
 };
 
 // package.json
-var version = "2.5.0";
+var version = "2.7.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -5009,6 +5081,7 @@ var EmporixClient = class {
    */
   config;
   resolver;
+  customerRefresh;
   constructor(config) {
     const cfg = validateConfig(config);
     this.tenant = cfg.tenant;
@@ -5030,6 +5103,8 @@ var EmporixClient = class {
     });
     const tokenProvider = cfg.tokenProvider ?? new DefaultTokenProvider(cfg);
     this.tokenProvider = tokenProvider;
+    const customerRefresh = new CustomerRefreshRegistry();
+    this.customerRefresh = customerRefresh;
     const mk = (service) => ({
       tenant: cfg.tenant,
       tokenProvider,
@@ -5039,7 +5114,8 @@ var EmporixClient = class {
         provider: tokenProvider,
         logger: root.child({ service: "http" }),
         retry: cfg.retry,
-        timeouts: cfg.timeouts
+        timeouts: cfg.timeouts,
+        customerRefresh
       })
     });
     this.customers = new CustomerService(mk("customer"));
@@ -5098,6 +5174,15 @@ var EmporixClient = class {
   getLogLevel(service) {
     return this.resolver.get(service);
   }
+  /**
+   * Registers (or clears with `null`) a customer-token refresher. When set, a
+   * `customer`-kind 401 triggers one refresh-and-retry. Off by default — the
+   * customer token stays caller-owned. The React `EmporixProvider` wires this
+   * automatically via `autoRefreshCustomerToken`.
+   */
+  setCustomerTokenRefresher(refresher) {
+    this.customerRefresh.set(refresher);
+  }
 };
 
 exports.AiService = AiService;
@@ -5116,6 +5201,7 @@ exports.CouponService = CouponService;
 exports.CurrencyService = CurrencyService;
 exports.CustomerAdminService = CustomerAdminService;
 exports.CustomerGroupsService = CustomerGroupsService;
+exports.CustomerRefreshRegistry = CustomerRefreshRegistry;
 exports.CustomerService = CustomerService;
 exports.DEFAULT_HOST = DEFAULT_HOST;
 exports.DefaultTokenProvider = DefaultTokenProvider;