@viu/emporix-sdk 2.3.0 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,112 @@
 # @viu/emporix-sdk
 
+## 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
+
+- [#82](https://github.com/viuteam/emporix-sdk/pull/82) [`4b55f1d`](https://github.com/viuteam/emporix-sdk/commit/4b55f1d3cd482b6a233a6e7a1ac7de063de89526) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix SEPA Export (`client.sepaExport`), Indexing (`client.indexing`), and
+  Unit Handling (`client.units`) bindings: SEPA export jobs + file retrieval;
+  search-index provider configurations + reindex; unit CRUD, unit types, and
+  conversion commands. Server-side only — these use the service (clientCredentials)
+  token.
+
+- [#77](https://github.com/viuteam/emporix-sdk/pull/77) [`7adb16a`](https://github.com/viuteam/emporix-sdk/commit/7adb16a289f8480bb87f8d9d271b8502c957239c) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Brand and Label Service bindings via `client.brands` and
+  `client.labels`: full CRUD (`listBrands`/`getBrand`/`createBrand`/`updateBrand`/
+  `patchBrand`/`deleteBrand` and the label equivalents). Server-side only — these
+  use the service (clientCredentials) token; brand reads also work anonymously.
+
+- [#78](https://github.com/viuteam/emporix-sdk/pull/78) [`83ed37e`](https://github.com/viuteam/emporix-sdk/commit/83ed37e4e38767358e06208e64cb87004b261744) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Country and Currency Service bindings via `client.countries`
+  (countries + regions: `listCountries`/`getCountry`/`patchCountry`/`listRegions`/
+  `getRegion`) and `client.currencies` (currencies + exchange rates: full CRUD on
+  both). Server-side only — these use the service (clientCredentials) token.
+
+- [#75](https://github.com/viuteam/emporix-sdk/pull/75) [`2174664`](https://github.com/viuteam/emporix-sdk/commit/21746648f890410a46c95c37b218bb6bbc98ebe7) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Coupon Service bindings via `client.coupons`: coupon CRUD
+  (`listCoupons`, `getCoupon`, `createCoupon`, `updateCoupon`, `patchCoupon`,
+  `deleteCoupon`), validation (`validateCoupon`), redemptions (`listRedemptions`,
+  `redeemCoupon`, `getRedemption`, `deleteRedemption`), and referral coupons
+  (`getReferralCoupon`, `createReferralCoupon`). Methods default to the service
+  token and are auth-overridable. Adds React hooks `useValidateCoupon` and
+  `useRedeemCoupon` for storefront validate/redeem (browser auth context).
+
+- [#81](https://github.com/viuteam/emporix-sdk/pull/81) [`f626ef6`](https://github.com/viuteam/emporix-sdk/commit/f626ef6ef25c6856c027402b854bf81bb14fe864) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Returns Service bindings via `client.returns`: CRUD over returns
+  (`listReturns`, `getReturn`, `createReturn`, `updateReturn`, `patchReturn`,
+  `deleteReturn`). Methods default to the service token and are auth-overridable;
+  `patchReturn` takes a JSON-Patch op-array. Adds React hooks `useMyReturns`,
+  `useReturn`, and `useCreateReturn` for customer self-service (browser customer
+  token).
+
+- [#76](https://github.com/viuteam/emporix-sdk/pull/76) [`2dddd6a`](https://github.com/viuteam/emporix-sdk/commit/2dddd6a213fa9d70bbaf0acc790eee51a7d813a8) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Reward Points Service bindings via `client.rewardPoints`: admin
+  customer-points management (`listAllSummaries`, `getCustomerPoints`,
+  `createCustomerPoints`, `deleteCustomerPoints`, `getCustomerSummary`,
+  `addPoints`, `redeemPoints`), the signed-in customer's own points
+  (`getMyPoints`, `getMySummary`, `redeemMyPoints` → coupon code), and redeem
+  options (`listRedeemOptions`, `createRedeemOption`, `updateRedeemOption`,
+  `deleteRedeemOption`). Admin methods default to the service token; the
+  `/public/*` methods require a customer token. Adds React hooks
+  `useMyRewardPoints`, `useMyRewardPointsSummary`, `useRedeemRewardPoints` and
+  `useRedeemOptions`.
+
+- [#80](https://github.com/viuteam/emporix-sdk/pull/80) [`46ddb50`](https://github.com/viuteam/emporix-sdk/commit/46ddb50f7fcf3f59269e60b5535db533cf984949) Thanks [@amnael1](https://github.com/amnael1)! - Extend `client.shipping` with delivery scheduling: delivery windows
+  (`getAreaDeliveryWindows`, `getCartDeliveryWindows`, `incrementDeliveryWindowCounter`,
+  `validateDeliveryWindow`), delivery times (`listDeliveryTimes`, `getDeliveryTime`,
+  `createDeliveryTime`, `createDeliveryTimesBulk`, `updateDeliveryTime`,
+  `patchDeliveryTime`, `deleteDeliveryTime`), delivery time slots (`listSlots`,
+  `getSlot`, `createSlot`, `updateSlot`, `patchSlot`, `deleteSlot`, `deleteAllSlots`),
+  and delivery cycles (`generateDeliveryCycle`). Server-side only.
+
+- [#79](https://github.com/viuteam/emporix-sdk/pull/79) [`04b138e`](https://github.com/viuteam/emporix-sdk/commit/04b138e4c3df69786e9bcdccc9a6ce0f1c329214) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Shipping Service bindings (Phase 1 — config) via `client.shipping`:
+  sites (`findSites`), zones and methods (full CRUD), cost/quote (`quote`,
+  `quoteMinimum`, `quoteSlot`), shipping groups, and customer-group relations.
+  Server-side only — these use the service (clientCredentials) token. Delivery
+  scheduling (windows, times, slots, cycles) is not yet bound.
+
+- [#73](https://github.com/viuteam/emporix-sdk/pull/73) [`ce6d3c1`](https://github.com/viuteam/emporix-sdk/commit/ce6d3c1d096e5f521b3d59dad9fb266fd1d743a3) Thanks [@amnael1](https://github.com/amnael1)! - Add Emporix Tax Service bindings via `client.taxes`: CRUD over per-location tax
+  configurations (`listTaxConfigs`, `getTaxConfig`, `createTaxConfig`,
+  `updateTaxConfig`, `deleteTaxConfig`) and net/gross tax calculation
+  (`calculateTax`). Server-side only — these use the service (clientCredentials)
+  token and must not be called from a browser.
+
 ## 2.3.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-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CgUWXqEt.js';
 import { Product } from './product.js';
 
 /**

package/dist/checkout.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.d.cts → context-CgUWXqEt.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" | "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;

package/dist/{context-CQFcPZnt.d.ts → context-CgUWXqEt.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" | "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;

package/dist/customer-groups.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CQFcPZnt.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext } from './context-CgUWXqEt.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-CQFcPZnt.cjs';
+import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-CgUWXqEt.cjs';
 
 type AccountId = {
     /**

package/dist/customer.d.ts

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