@viu/emporix-sdk 2.31.1 → 2.32.0

package/dist/index.js

@@ -1,26 +1,27 @@
 import { LocationsService } from './chunk-IAOWDMTA.js';
 export { LocationsService } from './chunk-IAOWDMTA.js';
-import { MediaService } from './chunk-OTG2S2L4.js';
-export { MediaService } from './chunk-OTG2S2L4.js';
-import { OrdersService, SalesOrdersService } from './chunk-P7G4LOOV.js';
-export { OrdersService, SalesOrdersService } from './chunk-P7G4LOOV.js';
+import { MediaService } from './chunk-TI56QENX.js';
+export { MediaService } from './chunk-TI56QENX.js';
+import { OrdersService, SalesOrdersService } from './chunk-P3RANRGB.js';
+export { OrdersService, SalesOrdersService } from './chunk-P3RANRGB.js';
 import { auth, resolveToken, DefaultTokenProvider, CustomerRefreshRegistry, PaymentGatewayService } from './chunk-4VRUMCS2.js';
 export { CustomerRefreshRegistry, DefaultTokenProvider, PaymentGatewayService, auth, resolveToken } from './chunk-4VRUMCS2.js';
 import { PriceService } from './chunk-ZOFGDNSX.js';
 export { PriceService } from './chunk-ZOFGDNSX.js';
-import { ProductService } from './chunk-7W22KLUL.js';
-export { ProductService } from './chunk-7W22KLUL.js';
-import { SegmentService } from './chunk-W2KBVWJ2.js';
-export { SegmentService } from './chunk-W2KBVWJ2.js';
-import { AvailabilityService } from './chunk-V3275BA7.js';
-export { AvailabilityService } from './chunk-V3275BA7.js';
+import { ProductService } from './chunk-JQWUGGRV.js';
+export { ProductService } from './chunk-JQWUGGRV.js';
+import { SegmentService } from './chunk-3G5KROEC.js';
+export { SegmentService } from './chunk-3G5KROEC.js';
+import { AvailabilityService } from './chunk-XQAOHHXL.js';
+export { AvailabilityService } from './chunk-XQAOHHXL.js';
 import { CartService } from './chunk-YVZ6GOLE.js';
 export { CartService } from './chunk-YVZ6GOLE.js';
-import { CategoryService } from './chunk-D7HBM2DQ.js';
-export { CategoryService } from './chunk-D7HBM2DQ.js';
-export { iterateAll } from './chunk-GWJ2U2CP.js';
+import { CategoryService } from './chunk-MSQ3GEIW.js';
+export { CategoryService } from './chunk-MSQ3GEIW.js';
+export { iterateAll } from './chunk-W6SLZNRX.js';
 import { resolveQuery } from './chunk-S5HEIQDK.js';
 export { resolveQuery } from './chunk-S5HEIQDK.js';
+import { requestPage } from './chunk-LKHKFF7B.js';
 import { CheckoutService } from './chunk-RYQVMR26.js';
 export { CheckoutService } from './chunk-RYQVMR26.js';
 import { CompaniesService } from './chunk-QQMLN76U.js';
@@ -439,7 +440,25 @@ var HttpClient = class {
       ...o.body !== void 0 && !isFormData ? { "Content-Type": "application/json" } : {}
     };
   }
+  /**
+   * Issues a request and returns the parsed body. Retries 5xx/429 on idempotent
+   * methods and re-auths once on a 401 — see {@link send}.
+   */
   async request(o) {
+    return (await this.send(o)).data;
+  }
+  /**
+   * Like {@link request}, but also hands back the response headers.
+   *
+   * Emporix puts pagination metadata there — `X-Total-Count` and, on the schema
+   * service's custom instances, `X-Next-Cursor` / `X-Prev-Cursor`. Facades
+   * should reach for `core/paged.ts`'s `requestPage` rather than calling this
+   * directly; it exists for metadata that does not fit the paginated shape.
+   */
+  async requestWithMeta(o) {
+    return this.send(o);
+  }
+  async send(o) {
     const requestId = `req-${++requestSeq}`;
     const log = this.opts.logger.child({ requestId });
     const url = new URL(this.opts.host + o.path);
@@ -506,7 +525,7 @@ var HttpClient = class {
       const parsed = text ? safeJson(text) : void 0;
       if (res.ok) {
         log.debug("http ok", { status: res.status });
-        return parsed;
+        return { data: parsed, headers: res.headers };
       }
       if (res.status === 401) {
         if (sdkManaged && !reauthed) {
@@ -667,7 +686,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "2.31.1";
+var version = "2.32.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -1364,13 +1383,17 @@ var FeeService = class {
   async list(query = {}, auth2 = SERVICE6) {
     const pageNumber = query.pageNumber ?? 1;
     const pageSize = query.pageSize ?? 60;
-    const items = await this.ctx.http.request({
-      method: "GET",
-      path: this.feesBase(),
-      auth: auth2,
-      query: { ...query, pageNumber, pageSize }
-    });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    const { totalCount, ...rest } = query;
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "GET",
+        path: this.feesBase(),
+        auth: auth2,
+        query: { ...rest, pageNumber, pageSize }
+      },
+      { pageNumber, pageSize, ...totalCount === void 0 ? {} : { totalCount } }
+    );
   }
   /** Retrieve one fee definition by id. */
   async get(id, auth2 = SERVICE6) {
@@ -1711,13 +1734,20 @@ var SchemaService = class {
     const q = { pageNumber, pageSize };
     if (query.q) q.q = query.q;
     if (query.type) q.type = query.type;
-    const items = await this.ctx.http.request({
-      method: "GET",
-      path: this.schemasBase(),
-      auth: auth2,
-      query: q
-    });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "GET",
+        path: this.schemasBase(),
+        auth: auth2,
+        query: q
+      },
+      {
+        pageNumber,
+        pageSize,
+        ...query.totalCount === void 0 ? {} : { totalCount: query.totalCount }
+      }
+    );
   }
   /** Retrieve one schema by id. */
   async getSchema(id, auth2 = SERVICE8) {
@@ -1843,13 +1873,41 @@ var SchemaService = class {
   async listInstances(type, query = {}, auth2 = SERVICE8) {
     const pageNumber = query.pageNumber ?? 1;
     const pageSize = query.pageSize ?? 60;
-    const items = await this.ctx.http.request({
-      method: "GET",
-      path: this.instancesBase(type),
-      auth: auth2,
-      query: { ...query, pageNumber, pageSize }
-    });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    const { totalCount, ...rest } = query;
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "GET",
+        path: this.instancesBase(type),
+        auth: auth2,
+        query: { ...rest, pageNumber, pageSize }
+      },
+      { pageNumber, pageSize, ...totalCount === void 0 ? {} : { totalCount } }
+    );
+  }
+  /**
+   * Async-iterates every instance of a type.
+   *
+   * Not built on `iterateAll`: that helper drives pagination by page number, and
+   * the server ignores `pageNumber` the moment a cursor is in play. This follows
+   * `nextCursor` while the server offers one and falls back to `pageNumber + 1`
+   * when it does not — so it is correct whether or not the tenant's deployment
+   * emits cursor headers on a request that carries no cursor.
+   */
+  async *listAllInstances(type, query = {}, auth2 = SERVICE8) {
+    let cursor;
+    let pageNumber = 1;
+    for (; ; ) {
+      const page = await this.listInstances(
+        type,
+        { ...query, pageNumber, ...cursor === void 0 ? {} : { next: cursor } },
+        auth2
+      );
+      for (const item of page.items) yield item;
+      if (!page.hasNextPage) return;
+      cursor = page.nextCursor;
+      if (cursor === void 0) pageNumber += 1;
+    }
   }
   /** Retrieve one instance by id. */
   async getInstance(type, id, auth2 = SERVICE8) {
@@ -1983,15 +2041,26 @@ var SchemaService = class {
   /**
    * Structured search over a custom entity's instances
    * (`POST /instances/search`), wrapped in {@link PaginatedItems}.
+   *
+   * The `query` parameter is third and `auth` fourth. This used to forward no
+   * query parameters at all and report a hard-coded `hasNextPage: false`, so a
+   * search could only ever return the server's default first page.
    */
-  async searchInstances(type, body, auth2 = SERVICE8) {
-    const items = await this.ctx.http.request({
-      method: "POST",
-      path: `${this.instancesBase(type)}/search`,
-      auth: auth2,
-      body
-    });
-    return { items, pageNumber: 1, pageSize: items.length, hasNextPage: false };
+  async searchInstances(type, body, query = {}, auth2 = SERVICE8) {
+    const pageNumber = query.pageNumber ?? 1;
+    const pageSize = query.pageSize ?? 60;
+    const { totalCount, ...rest } = query;
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "POST",
+        path: `${this.instancesBase(type)}/search`,
+        auth: auth2,
+        body,
+        query: { ...rest, pageNumber, pageSize }
+      },
+      { pageNumber, pageSize, ...totalCount === void 0 ? {} : { totalCount } }
+    );
   }
   // --- (E) References ------------------------------------------------------
   /**
@@ -2012,13 +2081,20 @@ var SchemaService = class {
       if (query.q) q.q = query.q;
       if (query.fields) q.fields = query.fields;
       if (query.type) q.type = query.type;
-      const items = await this.ctx.http.request({
-        method: "GET",
-        path: this.referencesBase(),
-        auth: auth2,
-        query: q
-      });
-      return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+      return requestPage(
+        this.ctx.http,
+        {
+          method: "GET",
+          path: this.referencesBase(),
+          auth: auth2,
+          query: q
+        },
+        {
+          pageNumber,
+          pageSize,
+          ...query.totalCount === void 0 ? {} : { totalCount: query.totalCount }
+        }
+      );
     },
     /** Retrieve one reference by id. */
     get: async (id, auth2 = SERVICE8) => this.ctx.http.request({
@@ -3583,13 +3659,20 @@ var QuoteService = class {
     const q = { pageNumber, pageSize };
     if (query.q) q.q = query.q;
     if (query.sort) q.sort = query.sort;
-    const items = await this.ctx.http.request({
-      method: "GET",
-      path: this.quotesBase(),
-      auth: auth2,
-      query: q
-    });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "GET",
+        path: this.quotesBase(),
+        auth: auth2,
+        query: q
+      },
+      {
+        pageNumber,
+        pageSize,
+        ...query.totalCount === void 0 ? {} : { totalCount: query.totalCount }
+      }
+    );
   }
   /** Create a quote (`POST /quotes`, 201). */
   async create(draft, auth2) {
@@ -3659,13 +3742,20 @@ var QuoteReasonsResource = class {
   async list(query, auth2) {
     const pageNumber = query.pageNumber ?? 1;
     const pageSize = query.pageSize ?? 60;
-    const items = await this.ctx.http.request({
-      method: "GET",
-      path: this.base(),
-      auth: auth2,
-      query: { pageNumber, pageSize }
-    });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "GET",
+        path: this.base(),
+        auth: auth2,
+        query: { pageNumber, pageSize }
+      },
+      {
+        pageNumber,
+        pageSize,
+        ...query.totalCount === void 0 ? {} : { totalCount: query.totalCount }
+      }
+    );
   }
   /** Retrieve one reason by id. */
   async get(reasonId, auth2) {
@@ -3893,13 +3983,20 @@ var IndexingService = class {
     const pageSize = opts.pageSize ?? 50;
     const query = { pageNumber, pageSize };
     if (opts.q !== void 0) query.q = opts.q;
-    const items = await this.ctx.http.request({
-      method: "GET",
-      path: `${this.base()}/reindex-jobs`,
-      query,
-      auth: auth2
-    });
-    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+    return requestPage(
+      this.ctx.http,
+      {
+        method: "GET",
+        path: `${this.base()}/reindex-jobs`,
+        query,
+        auth: auth2
+      },
+      {
+        pageNumber,
+        pageSize,
+        ...opts.totalCount === void 0 ? {} : { totalCount: opts.totalCount }
+      }
+    );
   }
   /** Fetch one reindex job by id. */
   async getReindexJob(reindexJobId, auth2 = SERVICE22) {