@viu/emporix-sdk 3.2.1 → 3.3.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @viu/emporix-sdk
 
+## 3.3.0
+
+### Minor Changes
+
+- [#314](https://github.com/viuteam/emporix-sdk/pull/314) [`f877f94`](https://github.com/viuteam/emporix-sdk/commit/f877f949ffea4ccf5242ecea34bf9e0596bef4a5) Thanks [@amnael1](https://github.com/amnael1)! - feat(sdk): add the audit log (changelog) service
+
+  Emporix's **Audit Logs (Changelog) Service** was never in the spec registry.
+  It is now vendored, generated and wrapped as `client.auditLogs` — tenant-wide
+  change history for platform entities: who changed what, when, and from which
+  value to which.
+
+  ```ts
+  const page = await client.auditLogs.list({ q: `entity:order entityId:${orderId}` });
+  for (const entry of page.items) {
+    console.log(entry.at, entry.actor, entry.paths); // { status: { before, after } }
+  }
+  ```
+
+  The whole upstream surface is **one paginated read**
+  (`GET /changelog/{tenant}/changelogs`), so the facade is one method.
+
+  **Service-account only**, on the `changelog.changelog_read` scope
+  (`changelog.changelog_manage` also grants it). There is no customer or anonymous
+  variant, so `@viu/emporix-sdk-react` and `@viu/emporix-sdk-angular` ship no
+  bindings for it — call it from a server.
+
+  Two behaviours the spec documents in prose rather than in its schema, and which
+  the JSDoc and [`docs/audit-logs.md`](https://github.com/viuteam/emporix-sdk/blob/main/docs/audit-logs.md)
+  now repeat where you will actually read them:
+  - **The window defaults to the last 30 days.** A query with no conjunctive
+    `occurredAt` lower bound gets a silent trailing 30-day window, so an
+    unfiltered `list()` is «the last month», not «everything ever». An
+    `occurredAt` that appears only inside an `OR` arm does not lift it.
+  - **`entityId` requires `entity`.** Filtering by id alone is a `400`, not an
+    empty page — and there is no path-based history endpoint, so scoping to one
+    document means naming both in `q`.
+
+  Paging is one-based and arrives in the response body rather than in
+  `X-Total-Count` headers, so `AuditLogPage` carries `totalElements` and
+  `totalPages` on top of the usual `PaginatedItems` shape — the same treatment
+  `ImportPage` gets. `pageSize` maxes out at 100; the service answers a larger
+  value with a `400` instead of clamping it.
+
+  `q` is a plain `string` here, deliberately not a `QueryFor<E>` mixin filter: a
+  `MixinFilter` targets an entity's own fields, and this endpoint indexes change
+  metadata rather than the document.
+
+  Upstream marks the service as preview — the contract may change without a major
+  version bump, and nearly every field of an entry is optional in the spec.
+
 ## 3.2.1
 
 ### Patch Changes

package/README.md

@@ -65,7 +65,7 @@ property on the `EmporixClient` instance:
 | Cart & checkout | `carts`, `checkout`, `payments`, `coupons`, `taxes`, `shipping`, `fees` |
 | 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`, `cloudFunctions`, `ai`, `ragIndexer`, `imports` |
+| Platform & config | `sites`, `sessionContext`, `tenantConfig`, `clientConfig`, `media`, `schemas`, `webhooks`, `sequentialIds`, `units`, `countries`, `currencies`, `vendors`, `shoppingLists`, `cloudFunctions`, `ai`, `ragIndexer`, `imports`, `auditLogs` |
 
 The sections below highlight the most-used services; per-service guides live in
 [`../../docs/`](../../docs).

package/dist/availability.d.cts

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

package/dist/availability.d.ts

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

package/dist/cart.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CcU93eAL.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CZdtWgQO.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-CcU93eAL.js';
+import { C as ClientContext, b as AuthContext } from './context-CZdtWgQO.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-CcU93eAL.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CZdtWgQO.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-CcU93eAL.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CZdtWgQO.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-CcU93eAL.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CZdtWgQO.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-CcU93eAL.js';
+import { C as ClientContext, b as AuthContext } from './context-CZdtWgQO.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-CcU93eAL.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CZdtWgQO.cjs';
 import { L as LegalEntity, e as LegalEntityCreate, f as LegalEntityUpdate } from './types.gen-fWB4nrso.cjs';
 export { A as AccountLimit, d as CustomerGroup, g as LegalInfo } from './types.gen-fWB4nrso.cjs';
 

package/dist/companies.d.ts

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

package/dist/contacts.d.cts

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

package/dist/contacts.d.ts

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

package/dist/{context-CcU93eAL.d.cts → context-CZdtWgQO.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" | "indexing" | "import" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "invoice" | "quote" | "cloud-functions" | "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" | "indexing" | "import" | "audit-log" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "invoice" | "quote" | "cloud-functions" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;

package/dist/{context-CcU93eAL.d.ts → context-CZdtWgQO.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" | "indexing" | "import" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "invoice" | "quote" | "cloud-functions" | "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" | "indexing" | "import" | "audit-log" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "invoice" | "quote" | "cloud-functions" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;

package/dist/{customer-groups-wmO0f-vj.d.ts → customer-groups-DhrOoC8M.d.ts}

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

package/dist/{customer-groups-Tt9VIA-m.d.cts → customer-groups-OEnqHFsX.d.cts}

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CcU93eAL.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CZdtWgQO.cjs';
 
 /**
  * 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-Tt9VIA-m.cjs';
-import './context-CcU93eAL.cjs';
+export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-OEnqHFsX.cjs';
+import './context-CZdtWgQO.cjs';

package/dist/customer-groups.d.ts

@@ -1,2 +1,2 @@
-export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-wmO0f-vj.js';
-import './context-CcU93eAL.js';
+export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-DhrOoC8M.js';
+import './context-CZdtWgQO.js';

package/dist/customer.d.cts

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

package/dist/customer.d.ts

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