@viu/emporix-sdk 2.33.5 → 2.34.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @viu/emporix-sdk
 
+## 2.34.0
+
+### Minor Changes
+
+- [#269](https://github.com/viuteam/emporix-sdk/pull/269) [`1cc5094`](https://github.com/viuteam/emporix-sdk/commit/1cc5094f092529494c166fbf8e5a315adac127b2) Thanks [@amnael1](https://github.com/amnael1)! - Fix the JSON-Patch `op` enum for the Approval service. The upstream spec ships
+  `ADD`/`REMOVE`/`REPLACE`, which the live API rejects with 400; `ApprovalPatch['op']`
+  is now `'add' | 'remove' | 'replace'`. Callers that worked around the wrong type
+  with a cast can drop it. Measured against tenant `viu` on 2026-08-18.
+
+- [#269](https://github.com/viuteam/emporix-sdk/pull/269) [`c2e9993`](https://github.com/viuteam/emporix-sdk/commit/c2e999351b0ca99ae96b8615957cb2d168c2ee34) Thanks [@amnael1](https://github.com/amnael1)! - Add `approvalStatusPatch(status, approverComment?)`, which builds the JSON-Patch for
+  an approval decision. It encodes two measured quirks: the op is lowercase, and the
+  approver comment needs `add` rather than `replace` — `replace` on the absent
+  `approverComment` field answers APPROVAL-400010 and, because PATCH is atomic, drops
+  the status change with it.
+
+- [#269](https://github.com/viuteam/emporix-sdk/pull/269) [`071cb9c`](https://github.com/viuteam/emporix-sdk/commit/071cb9c6022c3dc4cd1f99f114c208fc057344f1) Thanks [@amnael1](https://github.com/amnael1)! - Add `productYrn(tenant, productId)`, the inverse of `productIdFromYrn` and the form
+  `carts.addItem` requires. Also notes in `productIdFromYrn` that approval resource
+  items carry a bare product id rather than a YRN, so callers need the `itemId` fallback.
+
+### Patch Changes
+
+- [#269](https://github.com/viuteam/emporix-sdk/pull/269) [`ab8c607`](https://github.com/viuteam/emporix-sdk/commit/ab8c6078349738867877c3600f3ef52880c82439) Thanks [@amnael1](https://github.com/amnael1)! - Document measured Approval-service behaviour: `createApproval` consumes the cart
+  (404 from the Cart API, not restored by decline or withdrawal), `checkPermitted`
+  answers `true` for the approver as well as the requester, and the approver comment
+  needs `add`. Also corrects the `useCreateApproval` example, which showed the payload
+  nested under `resource` and omitted the mandatory `action`, `approver` and `details`.
+
+- [#269](https://github.com/viuteam/emporix-sdk/pull/269) [`75bf3ef`](https://github.com/viuteam/emporix-sdk/commit/75bf3efae89dbcd19283dc9ac8f6cc609e72ee7b) Thanks [@amnael1](https://github.com/amnael1)! - Warn when `context` is passed at the top level of `EmporixConfig` instead of inside
+  `credentials.storefront`. It was silently dropped, after which `matchByContext`
+  returns an empty list with no error because the anonymous token carries no site,
+  currency or country. `logger: false` is honoured as a request for silence.
+
 ## 2.33.5
 
 ### Patch Changes

package/dist/index.cjs

@@ -90,6 +90,17 @@ function errorFromResponse(status, message, body) {
 // src/core/config.ts
 var DEFAULT_HOST = "https://api.emporix.io";
 var TENANT_RE = /^[a-z][a-z0-9]{2,15}$/;
+function warnOnMisplacedContext(input) {
+  if (!("context" in input)) return;
+  const logger = input.logger;
+  if (logger === false) return;
+  const message = "EmporixConfig has no top-level `context` \u2014 it is being ignored. Move it into `credentials.storefront.context`, otherwise the anonymous token carries no site/currency/country and price matching returns an empty list without erroring.";
+  if (logger && typeof logger.warn === "function") {
+    logger.warn(message);
+    return;
+  }
+  console.warn(`[emporix] ${message}`);
+}
 function validateConfig(input) {
   if (!TENANT_RE.test(input.tenant)) {
     throw new Error(
@@ -99,6 +110,7 @@ function validateConfig(input) {
   if (!input.credentials) {
     throw new Error("credentials is required (provide at least one of backend/storefront/custom)");
   }
+  warnOnMisplacedContext(input);
   return {
     tenant: input.tenant,
     host: input.host ?? DEFAULT_HOST,
@@ -983,7 +995,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "2.33.5";
+var version = "2.34.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -8543,6 +8555,15 @@ var ApprovalService = class {
     });
   }
 };
+function approvalStatusPatch(status, approverComment) {
+  const comment = approverComment?.trim() ?? "";
+  return [
+    { op: "replace", path: "/status", value: status },
+    // `as const` on both fields: the generated type narrows `path` to an enum too, so
+    // a widened `string` from the spread would not be assignable.
+    ...comment !== "" ? [{ op: "add", path: "/approverComment", value: comment }] : []
+  ];
+}
 
 // src/client.ts
 var EmporixClient = class {
@@ -8733,6 +8754,9 @@ function productIdFromYrn(yrn) {
   const semi = yrn.lastIndexOf(";");
   return semi >= 0 ? yrn.slice(semi + 1) : "";
 }
+function productYrn(tenant, productId) {
+  return `urn:yaas:hybris:product:product:${tenant};${productId}`;
+}
 
 exports.AiService = AiService;
 exports.ApprovalService = ApprovalService;
@@ -8800,6 +8824,7 @@ exports.TenantConfigService = TenantConfigService;
 exports.UnitHandlingService = UnitHandlingService;
 exports.VendorService = VendorService;
 exports.WebhookService = WebhookService;
+exports.approvalStatusPatch = approvalStatusPatch;
 exports.auth = auth;
 exports.createConsoleLogger = createConsoleLogger;
 exports.createCookieBackedStorage = createCookieBackedStorage;
@@ -8812,6 +8837,7 @@ exports.iterateAll = iterateAll;
 exports.parseAnonymousSession = parseAnonymousSession;
 exports.pickFee = pickFee;
 exports.productIdFromYrn = productIdFromYrn;
+exports.productYrn = productYrn;
 exports.redact = redact;
 exports.resolveQuery = resolveQuery;
 exports.resolveToken = resolveToken;