@viu/emporix-sdk 2.28.2 → 2.29.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @viu/emporix-sdk
 
+## 2.29.0
+
+### Minor Changes
+
+- [#208](https://github.com/viuteam/emporix-sdk/pull/208) [`b58ca35`](https://github.com/viuteam/emporix-sdk/commit/b58ca35230b08db1c42f1e58874f8ea2d82684da) Thanks [@amnael1](https://github.com/amnael1)! - Add `client.imports` — bindings for the Emporix Import Service
+  (`/importtool/{tenant}/…`), covering all 15 operations of the new spec: import
+  configurations and streams, cron schedules, run control, run errors, and the
+  imported records.
+
+  Server-side only: every operation needs the service token with the
+  `importtool.import_trigger` scope. There is no customer or anonymous variant,
+  which is why `@viu/emporix-sdk-react` ships no hooks for it — a hook would mean
+  a client-credentials secret in the browser bundle. Full guide in
+  [`docs/import.md`](https://github.com/viuteam/emporix-sdk/blob/main/docs/import.md).
+
+  Three shapes worth knowing before you call it:
+  - `getSchedule(configId)` resolves to `null`, not a throw, when no schedule is
+    configured — the service answers `204`, so an unscheduled configuration is a
+    normal result.
+  - The four paginated methods return `ImportPage<T>`, which is `PaginatedItems<T>`
+    plus `totalElements` / `totalPages`. This is the first paginated SDK surface
+    where `hasNextPage` is exact rather than guessed from `items.length ===
+pageSize`, and the reported `pageNumber` / `pageSize` echo what the service
+    used, because it clamps `size`. The facade stays one-based.
+  - `streamRun(runId)` yields a discriminated union
+    (`snapshot` / `stream` / `run` / `unknown`) over Server-Sent Events. The
+    `unknown` arm is deliberate: the service is in preview, so a new event name or
+    an unreadable payload must neither abort a running import nor vanish silently.
+
+  Upstream marks all 15 operations as preview and makes nearly every response field
+  optional. The tests pin URL, method, query, body and auth kind; the response
+  shapes come from the spec and have not been seen on the wire — verifying them
+  needs a service account with the import scope, which this repo has no credentials
+  for.
+
 ## 2.28.2
 
 ### 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`, `sepaExport`, `cloudFunctions`, `ai`, `ragIndexer` |
+| Platform & config | `sites`, `sessionContext`, `tenantConfig`, `clientConfig`, `media`, `schemas`, `webhooks`, `sequentialIds`, `units`, `countries`, `currencies`, `vendors`, `shoppingLists`, `sepaExport`, `cloudFunctions`, `ai`, `ragIndexer`, `imports` |
 
 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-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-B5rWL6QD.cjs';
 
 type AvailabilityDto = {
     /**

package/dist/availability.d.ts

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

package/dist/cart.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.js';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-B5rWL6QD.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-DC5gSgKK.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-B5rWL6QD.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-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.js';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.js';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-DC5gSgKK.js';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.js';
 import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.js';
 
 /**

package/dist/{context-DC5gSgKK.d.cts → context-B5rWL6QD.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" | "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" | "sepa-export" | "indexing" | "import" | "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-DC5gSgKK.d.ts → context-B5rWL6QD.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" | "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" | "sepa-export" | "indexing" | "import" | "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-CLm6Gu9U.d.ts → customer-groups-BRN6I23C.d.ts}

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

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

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-DC5gSgKK.cjs';
+import { C as ClientContext, b as AuthContext } from './context-B5rWL6QD.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-BqYsPCA6.cjs';
-import './context-DC5gSgKK.cjs';
+export { g as CustomerGroupsService, j as IamGroup, c as IamGroupMemberAssignment } from './customer-groups-_czUdHab.cjs';
+import './context-B5rWL6QD.cjs';

package/dist/customer-groups.d.ts

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

package/dist/customer.d.cts

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

package/dist/customer.d.ts

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