@viu/emporix-sdk 2.4.0 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # @viu/emporix-sdk
 
+## 2.6.0
+
+### Minor Changes
+
+- [#92](https://github.com/viuteam/emporix-sdk/pull/92) [`45a2bd8`](https://github.com/viuteam/emporix-sdk/commit/45a2bd8d83cb46d775301790cb2efc60805efc90) Thanks [@amnael1](https://github.com/amnael1)! - Add opt-in reactive customer-token auto-refresh.
+
+  Core: `EmporixClient.setCustomerTokenRefresher(refresher)` registers a
+  single-flight `CustomerTokenRefresher`; on a `customer`-kind 401 the HTTP layer
+  refreshes once and retries. Off by default — the customer token stays
+  caller-owned.
+
+  React: `EmporixProvider` gains `autoRefreshCustomerToken` and
+  `onCustomerSessionExpired`. When enabled, a customer 401 is transparently
+  refreshed via the stored refresh token (anonymous-authorized
+  `GET /refreshauthtoken`) and the request is retried; B2B `legalEntityId` is
+  preserved.
+
+## 2.5.0
+
+### Minor Changes
+
+- [#87](https://github.com/viuteam/emporix-sdk/pull/87) [`83f5797`](https://github.com/viuteam/emporix-sdk/commit/83f5797ed8f38b63d67b9d392c0410be7a75997b) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Approval Service bindings for B2B cart/quote approval workflows.
+
+  Core `client.approvals` (`ApprovalService`): `listApprovals`, `getApproval`,
+  `createApproval`, `updateApproval` (JSON-Patch approve/reject), `deleteApproval`,
+  `checkPermitted`, and `searchApprovers`. Every endpoint is customer-token-only.
+
+  React: `useApprovals`, `useApproval`, `useCreateApproval`, and `useUpdateApproval`
+  (customer-only) for B2B approval self-service.
+
+- [#83](https://github.com/viuteam/emporix-sdk/pull/83) [`1e473ad`](https://github.com/viuteam/emporix-sdk/commit/1e473ad0abe057450abcb777d0e29312cda37530) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Catalog Management (`client.catalogs`) and Vendor Service
+  (`client.vendors`) bindings: catalog CRUD (incl. catalogs-for-category) and
+  vendor + vendor-location CRUD with vendor search. Server-side only — these use
+  the service (clientCredentials) token.
+
+- [#86](https://github.com/viuteam/emporix-sdk/pull/86) [`38c2510`](https://github.com/viuteam/emporix-sdk/commit/38c2510eefef3a69a941761d412163535cb6aad9) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix tenant-managed Customer Service bindings via `client.customerAdmin`:
+  admin/seller CRUD over customer profiles (`listCustomers`, `searchCustomers`,
+  `getCustomer`, `createCustomer`, `upsertCustomer`, `patchCustomer`,
+  `deleteCustomer`) and their addresses (`listAddresses`, `getAddress`,
+  `addAddress`, `upsertAddress`, `patchAddress`, `deleteAddress`, `addAddressTags`,
+  `removeAddressTags`). Server-side only — distinct from the storefront
+  `client.customers`.
+
+- [#85](https://github.com/viuteam/emporix-sdk/pull/85) [`c874141`](https://github.com/viuteam/emporix-sdk/commit/c874141484731d383e5732b7b358062d412460e4) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Pick-Pack Service bindings via `client.pickPack`: packlist orders
+  (`listOrders`, `getOrder`, `updateOrder`, `finishOrder`, `listOrderCycles`),
+  assignees (`addAssignee`, `removeAssignee`), packaging (`updatePackaging`),
+  packing events (`createEvent`, `listEvents`), and recalculation jobs
+  (`triggerRecalculation`, `getRecalculationJob`). Server-side only.
+
+### Patch Changes
+
+- [#88](https://github.com/viuteam/emporix-sdk/pull/88) [`ea9fc34`](https://github.com/viuteam/emporix-sdk/commit/ea9fc34c78e4620f3da2bf17040739f3dfd19669) Thanks [@amnael1](https://github.com/amnael1)! - Refresh package READMEs to reflect the full service and hook surface. The
+  `@viu/emporix-sdk` README now lists all 44 services (grouped by area) and the
+  correct published subpath exports; the `@viu/emporix-sdk-react` README documents
+  every exported hook (orders, availability, coupon, reward-points, returns,
+  approvals, shopping-lists, and the chunked price hook). Docs-only — no API
+  changes.
+
 ## 2.4.0
 
 ### Minor Changes

package/README.md

@@ -44,6 +44,22 @@ await sdk.products.list(undefined, auth.service("partner"));
 await sdk.customers.me(auth.raw(externalJwt));
 ```
 
+## Services
+
+The client exposes the full Emporix surface as namespaced services. Each is a
+property on the `EmporixClient` instance:
+
+| Area | Services |
+| --- | --- |
+| 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` |
+
+The sections below highlight the most-used services; per-service guides live in
+[`../../docs/`](../../docs).
+
 ## Configuration
 
 | Option | Default | Notes |
@@ -125,9 +141,13 @@ stock record. There is no restock-date field. See [`../../docs/availability.md`]
 
 ## Subpath exports
 
-`@viu/emporix-sdk` (everything) plus `./customer`, `./product`, `./category`,
-`./cart`, `./checkout`, `./payment`, `./price`, `./media`, `./segment`,
-`./companies`, `./contacts`, `./locations`, `./customer-groups`, `./availability` for tree-shaking.
+`@viu/emporix-sdk` (the package root) re-exports **everything** — every service,
+type, and helper. Tree-shakeable subpaths are published for the high-traffic
+services: `./customer`, `./product`, `./category`, `./cart`, `./checkout`,
+`./payment`, `./price`, `./media`, `./segment`, `./companies`, `./contacts`,
+`./locations`, `./customer-groups`, `./orders`, `./availability`. All other
+services (Tax, Coupon, RewardPoints, Shipping, Returns, Catalog, Vendor,
+PickPack, CustomerAdmin, Approval, …) are reached from the package root.
 
 ## Authors
 

package/dist/availability.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.cjs';
 
 type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 type Availability$1 = {

package/dist/availability.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.js';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.js';
 
 type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 type Availability$1 = {

package/dist/cart.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.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-hksRbb95.js';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.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-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-DJDTlhLW.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-hksRbb95.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-DJDTlhLW.js';
 import { Product } from './product.js';
 
 /**

package/dist/checkout.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.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-hksRbb95.js';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.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-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.cjs';
 import { L as LegalEntity, f as LegalEntityCreate, h as LegalEntityUpdate } from './types.gen-D1QuqPLs.cjs';
 export { A as AccountLimit, e as CustomerGroupRef, g as LegalEntityType, i as LegalInfo } from './types.gen-D1QuqPLs.cjs';
 

package/dist/companies.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.js';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.js';
 import { L as LegalEntity, f as LegalEntityCreate, h as LegalEntityUpdate } from './types.gen-D1QuqPLs.js';
 export { A as AccountLimit, e as CustomerGroupRef, g as LegalEntityType, i as LegalInfo } from './types.gen-D1QuqPLs.js';
 

package/dist/contacts.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.cjs';
 import { C as ContactAssignment, a as ContactAssignmentCreate, c as ContactAssignmentUpdate } from './types.gen-D1QuqPLs.cjs';
 export { b as ContactAssignmentType } from './types.gen-D1QuqPLs.cjs';
 

package/dist/contacts.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.js';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.js';
 import { C as ContactAssignment, a as ContactAssignmentCreate, c as ContactAssignmentUpdate } from './types.gen-D1QuqPLs.js';
 export { b as ContactAssignmentType } from './types.gen-D1QuqPLs.js';
 

package/dist/{context-hksRbb95.d.cts → context-DJDTlhLW.d.cts}

@@ -3,7 +3,7 @@ type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
 /** Numeric ordering used for fast comparison. */
 declare const LEVEL: Record<LogLevel, number>;
 /** Services that bind their own logger and are independently level-controllable. */
-type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "http" | "auth";
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;
@@ -161,6 +161,19 @@ type AuthContext = {
     kind: "raw";
     token: string;
 };
+/**
+ * Supplies a fresh customer token when a `customer`-kind request 401s. The host
+ * (e.g. EmporixProvider) implements this; the SDK never refreshes the
+ * caller-owned customer token unless a refresher is registered.
+ */
+interface CustomerTokenRefresher {
+    /**
+     * Called on a `customer`-kind 401. Receives the token that just failed;
+     * returns a fresh customer token to retry with, or `null` to give up (the
+     * 401 then propagates as EmporixAuthError).
+     */
+    refresh(expiredToken: string): Promise<string | null>;
+}
 /** An obtained anonymous storefront session. */
 interface AnonymousSession {
     accessToken: string;
@@ -232,6 +245,20 @@ declare const auth: {
 };
 /** Resolves an {@link AuthContext} to a concrete bearer token. */
 declare function resolveToken(ctx: AuthContext, provider: TokenProvider): Promise<string>;
+/**
+ * Late-bindable, single-flight holder for an optional
+ * {@link CustomerTokenRefresher}. Single-flight is required because Emporix
+ * rotates the refresh token on each refresh — concurrent refreshes would
+ * invalidate each other. Off (returns `null`) until a refresher is set.
+ */
+declare class CustomerRefreshRegistry {
+    private refresher;
+    private inflight;
+    set(refresher: CustomerTokenRefresher | null): void;
+    get enabled(): boolean;
+    /** Concurrent callers share one in-flight refresh. */
+    refresh(expiredToken: string): Promise<string | null>;
+}
 /** SDK-owned token provider: client-credentials service tokens + anonymous session. */
 declare class DefaultTokenProvider implements TokenProvider {
     private readonly cfg;
@@ -290,6 +317,8 @@ interface HttpClientOptions {
     };
     /** Override the retry backoff delay (ms → Promise). Defaults to a real timer. */
     sleep?: (ms: number) => Promise<void>;
+    /** Opt-in customer-token refresher registry (off unless a refresher is set). */
+    customerRefresh?: CustomerRefreshRegistry;
 }
 /** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
 declare class HttpClient {
@@ -341,4 +370,4 @@ interface PaginatedItems<T> {
  */
 declare function iterateAll<T>(fetchPage: (pageNumber: number) => Promise<PaginatedItems<T>>, start?: number): AsyncIterable<T>;
 
-export { type AnonymousSession as A, type ClientContext as C, DEFAULT_HOST as D, type EmporixConfig as E, HttpClient as H, LEVEL as L, type PaginatedItems as P, type RequestOptions as R, type ServiceCredentials as S, type TokenProvider as T, type AnonymousSessionStore as a, type AuthContext as b, type AuthKind as c, DefaultTokenProvider as d, type HttpClientOptions as e, LevelResolver as f, type LogFields as g, type LogLevel as h, type Logger as i, type LoggerConfig as j, type LoggerObjectConfig as k, type ResolvedConfig as l, type ServiceName as m, type StorefrontCredentials as n, auth as o, createConsoleLogger as p, createNoopLogger as q, iterateAll as r, redact as s, resolveToken as t, validateConfig as v };
+export { type AnonymousSession as A, type ClientContext as C, DEFAULT_HOST as D, type EmporixConfig as E, HttpClient as H, LEVEL as L, type PaginatedItems as P, type RequestOptions as R, type ServiceCredentials as S, type TokenProvider as T, type AnonymousSessionStore as a, type AuthContext as b, type AuthKind as c, CustomerRefreshRegistry as d, type CustomerTokenRefresher as e, DefaultTokenProvider as f, type HttpClientOptions as g, LevelResolver as h, type LogFields as i, type LogLevel as j, type Logger as k, type LoggerConfig as l, type LoggerObjectConfig as m, type ResolvedConfig as n, type ServiceName as o, type StorefrontCredentials as p, auth as q, createConsoleLogger as r, createNoopLogger as s, iterateAll as t, redact as u, resolveToken as v, validateConfig as w };

package/dist/{context-hksRbb95.d.ts → context-DJDTlhLW.d.ts}

@@ -3,7 +3,7 @@ type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
 /** Numeric ordering used for fast comparison. */
 declare const LEVEL: Record<LogLevel, number>;
 /** Services that bind their own logger and are independently level-controllable. */
-type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "http" | "auth";
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;
@@ -161,6 +161,19 @@ type AuthContext = {
     kind: "raw";
     token: string;
 };
+/**
+ * Supplies a fresh customer token when a `customer`-kind request 401s. The host
+ * (e.g. EmporixProvider) implements this; the SDK never refreshes the
+ * caller-owned customer token unless a refresher is registered.
+ */
+interface CustomerTokenRefresher {
+    /**
+     * Called on a `customer`-kind 401. Receives the token that just failed;
+     * returns a fresh customer token to retry with, or `null` to give up (the
+     * 401 then propagates as EmporixAuthError).
+     */
+    refresh(expiredToken: string): Promise<string | null>;
+}
 /** An obtained anonymous storefront session. */
 interface AnonymousSession {
     accessToken: string;
@@ -232,6 +245,20 @@ declare const auth: {
 };
 /** Resolves an {@link AuthContext} to a concrete bearer token. */
 declare function resolveToken(ctx: AuthContext, provider: TokenProvider): Promise<string>;
+/**
+ * Late-bindable, single-flight holder for an optional
+ * {@link CustomerTokenRefresher}. Single-flight is required because Emporix
+ * rotates the refresh token on each refresh — concurrent refreshes would
+ * invalidate each other. Off (returns `null`) until a refresher is set.
+ */
+declare class CustomerRefreshRegistry {
+    private refresher;
+    private inflight;
+    set(refresher: CustomerTokenRefresher | null): void;
+    get enabled(): boolean;
+    /** Concurrent callers share one in-flight refresh. */
+    refresh(expiredToken: string): Promise<string | null>;
+}
 /** SDK-owned token provider: client-credentials service tokens + anonymous session. */
 declare class DefaultTokenProvider implements TokenProvider {
     private readonly cfg;
@@ -290,6 +317,8 @@ interface HttpClientOptions {
     };
     /** Override the retry backoff delay (ms → Promise). Defaults to a real timer. */
     sleep?: (ms: number) => Promise<void>;
+    /** Opt-in customer-token refresher registry (off unless a refresher is set). */
+    customerRefresh?: CustomerRefreshRegistry;
 }
 /** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
 declare class HttpClient {
@@ -341,4 +370,4 @@ interface PaginatedItems<T> {
  */
 declare function iterateAll<T>(fetchPage: (pageNumber: number) => Promise<PaginatedItems<T>>, start?: number): AsyncIterable<T>;
 
-export { type AnonymousSession as A, type ClientContext as C, DEFAULT_HOST as D, type EmporixConfig as E, HttpClient as H, LEVEL as L, type PaginatedItems as P, type RequestOptions as R, type ServiceCredentials as S, type TokenProvider as T, type AnonymousSessionStore as a, type AuthContext as b, type AuthKind as c, DefaultTokenProvider as d, type HttpClientOptions as e, LevelResolver as f, type LogFields as g, type LogLevel as h, type Logger as i, type LoggerConfig as j, type LoggerObjectConfig as k, type ResolvedConfig as l, type ServiceName as m, type StorefrontCredentials as n, auth as o, createConsoleLogger as p, createNoopLogger as q, iterateAll as r, redact as s, resolveToken as t, validateConfig as v };
+export { type AnonymousSession as A, type ClientContext as C, DEFAULT_HOST as D, type EmporixConfig as E, HttpClient as H, LEVEL as L, type PaginatedItems as P, type RequestOptions as R, type ServiceCredentials as S, type TokenProvider as T, type AnonymousSessionStore as a, type AuthContext as b, type AuthKind as c, CustomerRefreshRegistry as d, type CustomerTokenRefresher as e, DefaultTokenProvider as f, type HttpClientOptions as g, LevelResolver as h, type LogFields as i, type LogLevel as j, type Logger as k, type LoggerConfig as l, type LoggerObjectConfig as m, type ResolvedConfig as n, type ServiceName as o, type StorefrontCredentials as p, auth as q, createConsoleLogger as r, createNoopLogger as s, iterateAll as t, redact as u, resolveToken as v, validateConfig as w };

package/dist/customer-groups.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.cjs';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.cjs';
 
 /**
  * Hand-written mirror of the minimal IAM Service group shape needed for

package/dist/customer-groups.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-hksRbb95.js';
+import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.js';
 
 /**
  * Hand-written mirror of the minimal IAM Service group shape needed for

package/dist/customer.d.cts

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

package/dist/customer.d.ts

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