@viu/emporix-sdk 2.23.0 → 2.26.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @viu/emporix-sdk
 
+## 2.26.0
+
+### Patch Changes
+
+- [#184](https://github.com/viuteam/emporix-sdk/pull/184) [`3f81681`](https://github.com/viuteam/emporix-sdk/commit/3f816818d444d9b874044f1fae7b9e82d48679b1) Thanks [@viu-release-bot](https://github.com/apps/viu-release-bot)! - chore(sdk): sync generated types with upstream Emporix API specs
+
+  Updated services: ai-service,indexing-service
+
+## 2.25.0
+
+### Minor Changes
+
+- [#185](https://github.com/viuteam/emporix-sdk/pull/185) [`893d8b1`](https://github.com/viuteam/emporix-sdk/commit/893d8b191f186d7c439b609b295e190aa3ba2ee5) Thanks [@amnael1](https://github.com/amnael1)! - `EmporixConfig.fetch` — replace the global `fetch` used for API requests.
+
+  ```ts
+  const sdk = new EmporixClient({ tenant, credentials, fetch: myFetch });
+  ```
+
+  Useful for tracing, test doubles, custom retry policies, and framework-level
+  caching (`@viu/emporix-sdk-next` uses it to attach Next cache tags).
+
+  Client-level rather than per-request: the 596 `http.request` call sites in
+  `services/` each build their own `RequestOptions` literal, so a per-request
+  `fetchOptions` field would reach none of them.
+
+  Token requests and SSE deliberately keep using the global `fetch`: a cached
+  token response would be a security defect, and caching an event stream is
+  meaningless. Both are therefore structurally uncacheable, not merely uncached by
+  convention.
+
 ## 2.23.0
 
 ### Minor Changes

package/README.md

@@ -34,8 +34,18 @@ const products = await sdk.products.list();
 const { customerToken } = await sdk.customers.login({ email, password });
 const ctx = auth.customer(customerToken);
 const me = await sdk.customers.me(ctx);
+
+// create() returns CartCreated → cart.cartId (getCurrent() returns a Cart → .id)
 const cart = await sdk.carts.create({ currency: "EUR" }, ctx);
-await sdk.carts.addItem(cart.id, { productId: "p_1", quantity: 2 }, ctx);
+await sdk.carts.addItem(
+  cart.cartId,
+  {
+    itemYrn: `urn:yaas:hybris:product:product:${sdk.tenant};p_1`,
+    quantity: 2,
+    price: { priceId: "pr_1", originalAmount: 10, effectiveAmount: 10, currency: "EUR" },
+  },
+  ctx,
+);
 
 // Service account with a custom credential set
 await sdk.products.list(undefined, auth.service("partner"));
@@ -53,17 +63,17 @@ property on the `EmporixClient` instance:
 | --- | --- |
 | Catalog | `products`, `categories`, `prices`, `brands`, `labels`, `catalogs` |
 | Cart & checkout | `carts`, `checkout`, `payments`, `coupons`, `taxes`, `shipping`, `fees` |
-| Orders & fulfilment | `orders`, `salesOrders`, `returns`, `pickPack`, `availability`, `indexing` |
-| Customers & B2B | `customers`, `customerAdmin`, `companies`, `contacts`, `locations`, `customerGroups`, `approvals`, `rewardPoints`, `segments` |
-| Platform & config | `sites`, `sessionContext`, `tenantConfig`, `clientConfig`, `media`, `schemas`, `webhooks`, `sequentialIds`, `units`, `countries`, `currencies`, `vendors`, `shoppingLists`, `sepaExport`, `ai`, `ragIndexer` |
+| Orders & fulfilment | `orders`, `salesOrders`, `quotes`, `invoices`, `returns`, `pickPack`, `availability`, `indexing` |
+| Customers & B2B | `customers`, `customerAdmin`, `companies`, `contacts`, `locations`, `customerGroups`, `approvals`, `rewardPoints`, `segments`, `iam` |
+| Platform & config | `sites`, `sessionContext`, `tenantConfig`, `clientConfig`, `media`, `schemas`, `webhooks`, `sequentialIds`, `units`, `countries`, `currencies`, `vendors`, `shoppingLists`, `sepaExport`, `cloudFunctions`, `ai`, `ragIndexer` |
 
 The sections below highlight the most-used services; per-service guides live in
 [`../../docs/`](../../docs).
 
 ## Searching by mixin (custom) fields
 
-`products.search`, `categories.search`, `orders.listMine({ q })`,
-`customerAdmin.searchCustomers({ q })` and `vendor.searchVendors({ q })` accept a
+`products.search`, `categories.search`, `orders.listMine(auth, { q })`,
+`customerAdmin.searchCustomers({ q })` and `vendors.searchVendors({ q })` accept a
 raw Emporix `q` string **or** a type-safe filter built with `mixinQuery` from
 [`@viu/emporix-mixins`](../mixins). The filter is entity-gated (a filter built for
 one entity is a compile error on another) and an `or()` filter is rejected on

package/dist/availability.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-DC5gSgKK.cjs';
 
 type AvailabilityDto = {
     /**

package/dist/availability.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-DC5gSgKK.js';
 
 type AvailabilityDto = {
     /**

package/dist/cart.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
 
 /**
  * Access control identifier that determines who can view or manage the cart.

package/dist/cart.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.js';
 
 /**
  * Access control identifier that determines who can view or manage the cart.

package/dist/category.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-DC5gSgKK.cjs';
 import { a as QueryFor } from './query-mLQs2WFr.cjs';
 import { Product } from './product.cjs';
 

package/dist/category.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-DC5gSgKK.js';
 import { a as QueryFor } from './query-mLQs2WFr.js';
 import { Product } from './product.js';
 

package/dist/checkout.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
 
 /**
  * Information about the customer's address.

package/dist/checkout.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.js';
 
 /**
  * Information about the customer's address.

package/dist/companies.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
 import { L as LegalEntity, e as LegalEntityCreate, f as LegalEntityUpdate } from './types.gen-C_wOXYZB.cjs';
 export { A as AccountLimit, d as CustomerGroup, g as LegalInfo } from './types.gen-C_wOXYZB.cjs';
 

package/dist/companies.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.js';
 import { L as LegalEntity, e as LegalEntityCreate, f as LegalEntityUpdate } from './types.gen-C_wOXYZB.js';
 export { A as AccountLimit, d as CustomerGroup, g as LegalInfo } from './types.gen-C_wOXYZB.js';
 

package/dist/contacts.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
 import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.cjs';
 
 /**

package/dist/contacts.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.js';
 import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.js';
 
 /**

package/dist/{context-CfXJcYKP.d.cts → context-DC5gSgKK.d.cts}

@@ -124,6 +124,16 @@ interface EmporixConfig {
         maxLifetimeSeconds?: number;
     };
     logger?: LoggerConfig;
+    /**
+     * Replaces the global `fetch` for API requests. Receives the same arguments.
+     *
+     * Deliberately NOT used for token requests (`core/auth.ts`) or SSE
+     * (`HttpClient.stream`): a cached token response would be a security defect,
+     * and caching an event stream is meaningless. Those keep the global `fetch`,
+     * which makes them structurally uncacheable rather than uncached by
+     * convention.
+     */
+    fetch?: typeof globalThis.fetch;
 }
 /** Fully-resolved configuration with defaults applied. */
 interface ResolvedConfig {
@@ -143,6 +153,7 @@ interface ResolvedConfig {
         maxLifetimeSeconds: number;
     };
     logger: LoggerConfig | undefined;
+    fetch: typeof globalThis.fetch | undefined;
 }
 /** Validates user config and applies defaults. Throws on invalid tenant/credentials. */
 declare function validateConfig(input: EmporixConfig): ResolvedConfig;
@@ -364,11 +375,18 @@ interface HttpClientOptions {
     requestContext?: {
         language?: string | undefined;
     };
+    /**
+     * Replaces the global `fetch` for API requests. Not used by token requests
+     * (`core/auth.ts`) or by {@link HttpClient.stream} — see `EmporixConfig.fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
 }
 /** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
 declare class HttpClient {
     private readonly opts;
     private readonly sleep;
+    /** Resolved request fetch. The arrow keeps `globalThis.fetch` correctly bound. */
+    private readonly doFetch;
     constructor(opts: HttpClientOptions);
     private buildHeaders;
     request<T = unknown>(o: RequestOptions): Promise<T>;

package/dist/{context-CfXJcYKP.d.ts → context-DC5gSgKK.d.ts}

@@ -124,6 +124,16 @@ interface EmporixConfig {
         maxLifetimeSeconds?: number;
     };
     logger?: LoggerConfig;
+    /**
+     * Replaces the global `fetch` for API requests. Receives the same arguments.
+     *
+     * Deliberately NOT used for token requests (`core/auth.ts`) or SSE
+     * (`HttpClient.stream`): a cached token response would be a security defect,
+     * and caching an event stream is meaningless. Those keep the global `fetch`,
+     * which makes them structurally uncacheable rather than uncached by
+     * convention.
+     */
+    fetch?: typeof globalThis.fetch;
 }
 /** Fully-resolved configuration with defaults applied. */
 interface ResolvedConfig {
@@ -143,6 +153,7 @@ interface ResolvedConfig {
         maxLifetimeSeconds: number;
     };
     logger: LoggerConfig | undefined;
+    fetch: typeof globalThis.fetch | undefined;
 }
 /** Validates user config and applies defaults. Throws on invalid tenant/credentials. */
 declare function validateConfig(input: EmporixConfig): ResolvedConfig;
@@ -364,11 +375,18 @@ interface HttpClientOptions {
     requestContext?: {
         language?: string | undefined;
     };
+    /**
+     * Replaces the global `fetch` for API requests. Not used by token requests
+     * (`core/auth.ts`) or by {@link HttpClient.stream} — see `EmporixConfig.fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
 }
 /** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
 declare class HttpClient {
     private readonly opts;
     private readonly sleep;
+    /** Resolved request fetch. The arrow keeps `globalThis.fetch` correctly bound. */
+    private readonly doFetch;
     constructor(opts: HttpClientOptions);
     private buildHeaders;
     request<T = unknown>(o: RequestOptions): Promise<T>;

package/dist/{customer-groups-BxSNFHq1.d.cts → customer-groups-BqYsPCA6.d.cts}

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
 
 /**
  * Access control metadata.

package/dist/{customer-groups-GlzWhDsi.d.ts → customer-groups-CLm6Gu9U.d.ts}

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.js';
+import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.js';
 
 /**
  * Access control metadata.

package/dist/customer-groups.d.cts

@@ -1,2 +1,2 @@
-export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-BxSNFHq1.cjs';
-import './context-CfXJcYKP.cjs';
+export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-BqYsPCA6.cjs';
+import './context-DC5gSgKK.cjs';

package/dist/customer-groups.d.ts

@@ -1,2 +1,2 @@
-export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-GlzWhDsi.js';
-import './context-CfXJcYKP.js';
+export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-CLm6Gu9U.js';
+import './context-DC5gSgKK.js';

package/dist/customer.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-DC5gSgKK.cjs';
 
 type AccountId = {
     /**

package/dist/customer.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-CfXJcYKP.js';
+import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-DC5gSgKK.js';
 
 type AccountId = {
     /**

package/dist/index.cjs

@@ -113,7 +113,8 @@ function validateConfig(input) {
       expirationBufferSeconds: input.cache?.expirationBufferSeconds ?? 60,
       maxLifetimeSeconds: input.cache?.maxLifetimeSeconds ?? 3600
     },
-    logger: input.logger
+    logger: input.logger,
+    fetch: input.fetch
   };
 }
 
@@ -645,9 +646,12 @@ var HttpClient = class {
   constructor(opts) {
     this.opts = opts;
     this.sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    this.doFetch = opts.fetch ?? ((...args) => globalThis.fetch(...args));
   }
   opts;
   sleep;
+  /** Resolved request fetch. The arrow keeps `globalThis.fetch` correctly bound. */
+  doFetch;
   buildHeaders(o, token, isFormData) {
     return {
       ...this.opts.requestContext?.language ? { "Accept-Language": this.opts.requestContext.language } : {},
@@ -703,7 +707,7 @@ var HttpClient = class {
       let res;
       let text;
       try {
-        res = await Promise.race([fetch(url, init), overallBudget]);
+        res = await Promise.race([this.doFetch(url, init), overallBudget]);
         clearTimeout(connectTimer);
         connectTimer = void 0;
         const body = res.text();
@@ -807,7 +811,7 @@ var HttpClient = class {
       init.body = isFormData ? o.body : JSON.stringify(o.body);
     }
     try {
-      return await fetch(url, init);
+      return await this.doFetch(url, init);
     } catch (err) {
       if (err.name === "AbortError") {
         throw new EmporixTimeoutError(
@@ -886,7 +890,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "2.23.0";
+var version = "2.26.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -925,7 +929,10 @@ function createCore(config) {
       retry: cfg.retry,
       timeouts: cfg.timeouts,
       customerRefresh,
-      requestContext
+      requestContext,
+      // exactOptionalPropertyTypes: `{ fetch: undefined }` is a type error
+      // against `fetch?: typeof globalThis.fetch`, so spread conditionally.
+      ...cfg.fetch !== void 0 ? { fetch: cfg.fetch } : {}
     })
   });
   return {