@viu/emporix-sdk 4.2.0 → 4.2.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @viu/emporix-sdk
 
+## 4.2.2
+
+### Patch Changes
+
+- [#372](https://github.com/viuteam/emporix-sdk/pull/372) [`b89a81a`](https://github.com/viuteam/emporix-sdk/commit/b89a81a9eed1cdbf781757d5e5f09820f6cb04af) Thanks [@amnael1](https://github.com/amnael1)! - docs(sdk): document published mappings and aborted import runs
+  
+  The import types and `triggerRun` / `retryRun` now describe the Import Service change of 2026-09-28, which the types already carried: a run executes each stream's published mappings, a dry run checks the drafts with `mappings: "draft"`, and runs report `mappingVersions` and `dryRunPublished`. They also name the trap that came with it — a run refused for never-published mappings still resolves with `200` and only then finishes `ABORTED`, so read the run back before treating it as started.
+
 ## 4.2.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -1242,7 +1242,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "4.2.0";
+var version = "4.2.2";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -8577,6 +8577,19 @@ var ImportService = class {
    * `streamIds` runs a subset — see {@link ImportRunInput} for what is rejected,
    * and note it takes ids where {@link getStreamOrder} reports names.
    *
+   * A run executes each stream's **published** mappings. Publishing needs
+   * `importtool.import_manage` and is not part of the public API, so it happens
+   * in the Management Dashboard's Import Tool rather than through this SDK; a dry
+   * run with `mappings: "draft"` checks unpublished changes first. A stream whose
+   * mappings were never published is `ABORTED` in the run details, and the run
+   * finishes `PARTIAL`.
+   *
+   * **A refused run still resolves.** When `streamIds` names such a stream, or
+   * every enabled stream is in that state, the service answers `200` with the
+   * run anyway, and the run then finishes `ABORTED` with a `message` naming the
+   * streams. Read it back with {@link getRun}, or follow it with
+   * {@link streamRun}, before treating a resolved call as a started import.
+   *
    * Not retried on a 5xx: a POST that timed out may already have queued a run.
    *
    * @example
@@ -8819,7 +8832,8 @@ var ImportService = class {
    *
    * Returns a **new** run — the retry is its own run with `retry: true`, not a
    * mutation of the original. Poll it with {@link getRun} or follow it with
-   * {@link streamRun} exactly as you would a triggered run.
+   * {@link streamRun} exactly as you would a triggered run. Like one, it runs the
+   * published mappings and can finish `ABORTED`.
    *
    * Not retried on a 5xx, for the same reason {@link triggerRun} is not: a POST
    * that timed out may already have queued the retry.