@viu/emporix-sdk 4.1.0 → 4.2.2

package/dist/index.d.cts

@@ -8,7 +8,7 @@ export { Media, Product, ProductBulkCreateInput, ProductBulkResult, ProductBulkU
 import { CategoryService } from './category.cjs';
 export { Category, CategoryAssignment, CategoryAssignmentBulkInput, CategoryAssignmentBulkResult, CategoryAssignmentCreated, CategoryAssignmentInput, CategoryAssignmentRefBulkInput, CategoryCreateInput, CategoryCreated, CategoryNode, CategoryPatchInput, CategoryTreeSearchInput, CategoryUpdateInput } from './category.cjs';
 import { CartService } from './cart.cjs';
-export { Cart, CartAddress, CartCreated, CartDeliveryRestrictions, CartDiscount, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.cjs';
+export { Cart, CartAddress, CartCommand, CartCommandBodies, CartCommandResult, CartCreated, CartDeliveryRestrictions, CartDiscount, CartDiscountInput, CartExecuteOptions, CartExecuteResult, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.cjs';
 import { CheckoutService } from './checkout.cjs';
 export { CheckoutInput, CheckoutOptions, CheckoutResult, QuoteCheckoutInput } from './checkout.cjs';
 import { PaymentGatewayService } from './payment.cjs';
@@ -483,13 +483,13 @@ type SiteDto = {
      */
     includesTax?: boolean;
     /**
-     * Site's default language, compliant with the ISO 639-1 standard.
+     * Site's default language, compliant with the IETF BCP-47 standard. Regional variants such as `fr-ca` are supported.
      */
     defaultLanguage: string;
     /**
      * Languages supported by the site.
      *
-     * **Note**: The languages must be compliant with the ISO 639-1 standard.
+     * **Note**: The languages must be compliant with the IETF BCP-47 standard. Regional variants such as `fr-ca` are supported.
      */
     languages: Array<string>;
     currency: CurrencyDto;
@@ -3881,7 +3881,12 @@ type AgentRequest = BaseForAgentRequestAndResponse & {
     nativeTools?: Array<NativeToolReferenceRequest>;
     llmConfig: EmporixLlm | ApiKeyLlmRequest | SelfHostedLlmRequest;
     mcpServers: AgentMcpServersRequest;
-    metadata?: MetadataRequest;
+    metadata?: MetadataRequest & {
+        /**
+         * Optional note stored on this version. A blank value clears the live note. The next successful update archives the note with this version.
+         */
+        changeNote?: string;
+    };
 };
 type AgentResponse = BaseForAgentRequestAndResponse & {
     /**
@@ -3900,7 +3905,58 @@ type AgentResponse = BaseForAgentRequestAndResponse & {
      * Prompt which is inherited from the template (if agent is created based on the template). The prompt provided by the user is then concatenated with this prompt.
      */
     templatePrompt?: string;
-    metadata?: MetadataResponse$1;
+    metadata?: AgentMetadataResponse;
+    /**
+     * Stored history of previous agent configurations. Present only when the request sets `allVersions=true`. Omitted otherwise.
+     */
+    versions?: Array<AgentVersion>;
+};
+type AgentVersion = BaseForAgentRequestAndResponse & {
+    /**
+     * Prompt inherited from the template at the time of this version.
+     */
+    templatePrompt?: string;
+    nativeTools?: NativeToolsResponse;
+    llmConfig?: EmporixLlm | ApiKeyLlmResponse | SelfHostedLlmResponse;
+    mcpServers?: AgentMcpServersResponse;
+    metadata: AgentVersionMetadata;
+};
+type AgentVersionMetadata = {
+    /**
+     * Version number of this archived snapshot.
+     */
+    version: number;
+    /**
+     * Date and time when this version was stored. The value is an ISO-8601 instant. For example: `2022-04-30T13:18:02.379Z`
+     */
+    modifiedAt?: string;
+    modifiedBy?: ModifiedBy;
+    /**
+     * Note stored with this snapshot.
+     */
+    changeNote?: string;
+};
+/**
+ * Who last changed the agent.
+ */
+type ModifiedBy = {
+    /**
+     * Identity recorded for the change. `EXTERNAL` is assigned when the request authenticates with an API token. `SYSTEM` is used for automatic updates.
+     *
+     */
+    type: 'CUSTOMER' | 'EMPLOYEE' | 'EXTERNAL' | 'SYSTEM';
+    /**
+     * Identifier of the customer or employee. Omitted for `EXTERNAL` and `SYSTEM`. `id` is the `Hybris-User-Id` header value when `CUSTOMER` or `EMPLOYEE`.
+     */
+    id?: string;
+    /**
+     * First name of the customer or employee.
+     */
+    firstName?: string;
+    /**
+     * Last name of the customer or employee.
+     */
+    lastName?: string;
 };
 type MetadataRequest = {
     /**
@@ -3910,14 +3966,21 @@ type MetadataRequest = {
 };
 type MetadataResponse$1 = MetadataRequest & {
     /**
-     * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
      */
     createdAt: string;
     /**
-     * Date and time when the object was last modified. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     * Date and time when the object was last modified. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
      */
     modifiedAt: string;
 };
+type AgentMetadataResponse = MetadataResponse$1 & {
+    modifiedBy?: ModifiedBy;
+    /**
+     * Note stored for this live version.
+     */
+    changeNote?: string;
+};
 /**
  * Status of the job.
  */
@@ -4045,6 +4108,10 @@ type AgentLogMessageResponse = {
      * Unique identifier of the agent that generated the log.
      */
     agentId?: string;
+    /**
+     * Version of the agent that wrote this log message.
+     */
+    agentVersion?: number;
     /**
      * Unique identifier of the request associated with the log.
      */
@@ -4092,6 +4159,10 @@ type AgentRequestResponse = {
      * Cumulative LLM completion token count for this request.
      */
     completionTokens?: number;
+    /**
+     * Version of the agent which triggered the request.
+     */
+    agentVersion?: number;
     metadata?: MetadataResponse$1;
 };
 type AgentSessionResponse = {
@@ -10155,9 +10226,18 @@ type ImportSchedule = Schedule;
  * `dryRunSample` carries the previewed records on a dry run and is absent on a
  * normal one. `origin` echoes what asked for the run, and is absent on runs
  * recorded before that field existed.
+ *
+ * `mappingVersions` lists the published mapping version each stream runs with,
+ * fixed when the run starts — version `0` means the stream has no published
+ * mappings. It is absent on a dry run of the draft mappings and on runs recorded
+ * before 2026-09-28. `dryRunPublished` says which mappings a dry run used.
  */
 type ImportRun = ImportRun$1;
-/** Per-stream progress within a run. */
+/**
+ * Per-stream progress within a run. A stream `ABORTED` was not run because of
+ * its configuration — typically mappings that were never published — and its
+ * `message` says why.
+ */
 type ImportRunStream = ImportRunStream$1;
 /** A run together with its per-stream progress — what `getRun` resolves to. */
 type ImportRunDetail = RunDetail;
@@ -10186,7 +10266,7 @@ type ImportDiagnosticKind = TraitDiagnosticsKind;
 /** Filters for `listRunDiagnostics` / `downloadRunDiagnosticsCsv`: `{ streamId?, kind?, limit? }`. */
 type ImportRunDiagnosticsQuery = NonNullable<GetImporttoolListRunDiagnosticsData["query"]>;
 /**
- * Body for `triggerRun`: `{ mode?, dryRun?, force?, sampleSize?, origin?, streamIds? }`.
+ * Body for `triggerRun`: `{ mode?, dryRun?, force?, sampleSize?, origin?, streamIds?, mappings? }`.
  *
  * - `mode` defaults to `DELTA` server-side.
  * - `streamIds` runs only those streams — **ids, not names** (`getStreamOrder`
@@ -10197,6 +10277,10 @@ type ImportRunDiagnosticsQuery = NonNullable<GetImporttoolListRunDiagnosticsData
  *   idempotency.
  * - `sampleSize` is **dry-run only**: how many mapped records to sample per
  *   stream into the run's `dryRunSample`. Clamped to 1–100, defaults to 25.
+ * - `mappings` is **dry-run only** too: `"published"` (the default) checks what
+ *   a real run would execute, `"draft"` checks saved mapping changes before they
+ *   are published. A real run always uses the published mappings, so the field
+ *   has no effect there.
  * - `origin` is free text naming *what* asked for the run (`"Dashboard"`, an
  *   integration scenario, your own scheduler), as opposed to `trigger`, which
  *   only ever records `MANUAL` or `SCHEDULED`. Omitted or blank, the service
@@ -10205,7 +10289,11 @@ type ImportRunDiagnosticsQuery = NonNullable<GetImporttoolListRunDiagnosticsData
  *   audit trail is worse than a refused request.
  */
 type ImportRunInput = NonNullable<PostImporttoolTriggerRunData["body"]>;
-/** Lifecycle status of an {@link ImportRun}. */
+/**
+ * Lifecycle status of an {@link ImportRun}. `ABORTED` means the service refused
+ * to start the run because of its configuration — mappings that were never
+ * published, or a changed target schema — and nothing was read or written.
+ */
 type ImportRunStatus = NonNullable<ImportRun["status"]>;
 /** Run mode — `FULL` re-reads everything, `DELTA` only what changed. */
 type ImportRunMode = NonNullable<ImportRunInput["mode"]>;
@@ -10395,6 +10483,19 @@ declare class ImportService {
      * `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
@@ -10515,7 +10616,8 @@ declare class ImportService {
      *
      * 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.

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { Media, Product, ProductBulkCreateInput, ProductBulkResult, ProductBulkU
 import { CategoryService } from './category.js';
 export { Category, CategoryAssignment, CategoryAssignmentBulkInput, CategoryAssignmentBulkResult, CategoryAssignmentCreated, CategoryAssignmentInput, CategoryAssignmentRefBulkInput, CategoryCreateInput, CategoryCreated, CategoryNode, CategoryPatchInput, CategoryTreeSearchInput, CategoryUpdateInput } from './category.js';
 import { CartService } from './cart.js';
-export { Cart, CartAddress, CartCreated, CartDeliveryRestrictions, CartDiscount, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.js';
+export { Cart, CartAddress, CartCommand, CartCommandBodies, CartCommandResult, CartCreated, CartDeliveryRestrictions, CartDiscount, CartDiscountInput, CartExecuteOptions, CartExecuteResult, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.js';
 import { CheckoutService } from './checkout.js';
 export { CheckoutInput, CheckoutOptions, CheckoutResult, QuoteCheckoutInput } from './checkout.js';
 import { PaymentGatewayService } from './payment.js';
@@ -483,13 +483,13 @@ type SiteDto = {
      */
     includesTax?: boolean;
     /**
-     * Site's default language, compliant with the ISO 639-1 standard.
+     * Site's default language, compliant with the IETF BCP-47 standard. Regional variants such as `fr-ca` are supported.
      */
     defaultLanguage: string;
     /**
      * Languages supported by the site.
      *
-     * **Note**: The languages must be compliant with the ISO 639-1 standard.
+     * **Note**: The languages must be compliant with the IETF BCP-47 standard. Regional variants such as `fr-ca` are supported.
      */
     languages: Array<string>;
     currency: CurrencyDto;
@@ -3881,7 +3881,12 @@ type AgentRequest = BaseForAgentRequestAndResponse & {
     nativeTools?: Array<NativeToolReferenceRequest>;
     llmConfig: EmporixLlm | ApiKeyLlmRequest | SelfHostedLlmRequest;
     mcpServers: AgentMcpServersRequest;
-    metadata?: MetadataRequest;
+    metadata?: MetadataRequest & {
+        /**
+         * Optional note stored on this version. A blank value clears the live note. The next successful update archives the note with this version.
+         */
+        changeNote?: string;
+    };
 };
 type AgentResponse = BaseForAgentRequestAndResponse & {
     /**
@@ -3900,7 +3905,58 @@ type AgentResponse = BaseForAgentRequestAndResponse & {
      * Prompt which is inherited from the template (if agent is created based on the template). The prompt provided by the user is then concatenated with this prompt.
      */
     templatePrompt?: string;
-    metadata?: MetadataResponse$1;
+    metadata?: AgentMetadataResponse;
+    /**
+     * Stored history of previous agent configurations. Present only when the request sets `allVersions=true`. Omitted otherwise.
+     */
+    versions?: Array<AgentVersion>;
+};
+type AgentVersion = BaseForAgentRequestAndResponse & {
+    /**
+     * Prompt inherited from the template at the time of this version.
+     */
+    templatePrompt?: string;
+    nativeTools?: NativeToolsResponse;
+    llmConfig?: EmporixLlm | ApiKeyLlmResponse | SelfHostedLlmResponse;
+    mcpServers?: AgentMcpServersResponse;
+    metadata: AgentVersionMetadata;
+};
+type AgentVersionMetadata = {
+    /**
+     * Version number of this archived snapshot.
+     */
+    version: number;
+    /**
+     * Date and time when this version was stored. The value is an ISO-8601 instant. For example: `2022-04-30T13:18:02.379Z`
+     */
+    modifiedAt?: string;
+    modifiedBy?: ModifiedBy;
+    /**
+     * Note stored with this snapshot.
+     */
+    changeNote?: string;
+};
+/**
+ * Who last changed the agent.
+ */
+type ModifiedBy = {
+    /**
+     * Identity recorded for the change. `EXTERNAL` is assigned when the request authenticates with an API token. `SYSTEM` is used for automatic updates.
+     *
+     */
+    type: 'CUSTOMER' | 'EMPLOYEE' | 'EXTERNAL' | 'SYSTEM';
+    /**
+     * Identifier of the customer or employee. Omitted for `EXTERNAL` and `SYSTEM`. `id` is the `Hybris-User-Id` header value when `CUSTOMER` or `EMPLOYEE`.
+     */
+    id?: string;
+    /**
+     * First name of the customer or employee.
+     */
+    firstName?: string;
+    /**
+     * Last name of the customer or employee.
+     */
+    lastName?: string;
 };
 type MetadataRequest = {
     /**
@@ -3910,14 +3966,21 @@ type MetadataRequest = {
 };
 type MetadataResponse$1 = MetadataRequest & {
     /**
-     * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
      */
     createdAt: string;
     /**
-     * Date and time when the object was last modified. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     * Date and time when the object was last modified. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
      */
     modifiedAt: string;
 };
+type AgentMetadataResponse = MetadataResponse$1 & {
+    modifiedBy?: ModifiedBy;
+    /**
+     * Note stored for this live version.
+     */
+    changeNote?: string;
+};
 /**
  * Status of the job.
  */
@@ -4045,6 +4108,10 @@ type AgentLogMessageResponse = {
      * Unique identifier of the agent that generated the log.
      */
     agentId?: string;
+    /**
+     * Version of the agent that wrote this log message.
+     */
+    agentVersion?: number;
     /**
      * Unique identifier of the request associated with the log.
      */
@@ -4092,6 +4159,10 @@ type AgentRequestResponse = {
      * Cumulative LLM completion token count for this request.
      */
     completionTokens?: number;
+    /**
+     * Version of the agent which triggered the request.
+     */
+    agentVersion?: number;
     metadata?: MetadataResponse$1;
 };
 type AgentSessionResponse = {
@@ -10155,9 +10226,18 @@ type ImportSchedule = Schedule;
  * `dryRunSample` carries the previewed records on a dry run and is absent on a
  * normal one. `origin` echoes what asked for the run, and is absent on runs
  * recorded before that field existed.
+ *
+ * `mappingVersions` lists the published mapping version each stream runs with,
+ * fixed when the run starts — version `0` means the stream has no published
+ * mappings. It is absent on a dry run of the draft mappings and on runs recorded
+ * before 2026-09-28. `dryRunPublished` says which mappings a dry run used.
  */
 type ImportRun = ImportRun$1;
-/** Per-stream progress within a run. */
+/**
+ * Per-stream progress within a run. A stream `ABORTED` was not run because of
+ * its configuration — typically mappings that were never published — and its
+ * `message` says why.
+ */
 type ImportRunStream = ImportRunStream$1;
 /** A run together with its per-stream progress — what `getRun` resolves to. */
 type ImportRunDetail = RunDetail;
@@ -10186,7 +10266,7 @@ type ImportDiagnosticKind = TraitDiagnosticsKind;
 /** Filters for `listRunDiagnostics` / `downloadRunDiagnosticsCsv`: `{ streamId?, kind?, limit? }`. */
 type ImportRunDiagnosticsQuery = NonNullable<GetImporttoolListRunDiagnosticsData["query"]>;
 /**
- * Body for `triggerRun`: `{ mode?, dryRun?, force?, sampleSize?, origin?, streamIds? }`.
+ * Body for `triggerRun`: `{ mode?, dryRun?, force?, sampleSize?, origin?, streamIds?, mappings? }`.
  *
  * - `mode` defaults to `DELTA` server-side.
  * - `streamIds` runs only those streams — **ids, not names** (`getStreamOrder`
@@ -10197,6 +10277,10 @@ type ImportRunDiagnosticsQuery = NonNullable<GetImporttoolListRunDiagnosticsData
  *   idempotency.
  * - `sampleSize` is **dry-run only**: how many mapped records to sample per
  *   stream into the run's `dryRunSample`. Clamped to 1–100, defaults to 25.
+ * - `mappings` is **dry-run only** too: `"published"` (the default) checks what
+ *   a real run would execute, `"draft"` checks saved mapping changes before they
+ *   are published. A real run always uses the published mappings, so the field
+ *   has no effect there.
  * - `origin` is free text naming *what* asked for the run (`"Dashboard"`, an
  *   integration scenario, your own scheduler), as opposed to `trigger`, which
  *   only ever records `MANUAL` or `SCHEDULED`. Omitted or blank, the service
@@ -10205,7 +10289,11 @@ type ImportRunDiagnosticsQuery = NonNullable<GetImporttoolListRunDiagnosticsData
  *   audit trail is worse than a refused request.
  */
 type ImportRunInput = NonNullable<PostImporttoolTriggerRunData["body"]>;
-/** Lifecycle status of an {@link ImportRun}. */
+/**
+ * Lifecycle status of an {@link ImportRun}. `ABORTED` means the service refused
+ * to start the run because of its configuration — mappings that were never
+ * published, or a changed target schema — and nothing was read or written.
+ */
 type ImportRunStatus = NonNullable<ImportRun["status"]>;
 /** Run mode — `FULL` re-reads everything, `DELTA` only what changed. */
 type ImportRunMode = NonNullable<ImportRunInput["mode"]>;
@@ -10395,6 +10483,19 @@ declare class ImportService {
      * `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
@@ -10515,7 +10616,8 @@ declare class ImportService {
      *
      * 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.

package/dist/index.js

@@ -14,8 +14,8 @@ import { SegmentService } from './chunk-N2CE3J4M.js';
 export { SegmentService } from './chunk-N2CE3J4M.js';
 import { AvailabilityService } from './chunk-XQAOHHXL.js';
 export { AvailabilityService } from './chunk-XQAOHHXL.js';
-import { CartService } from './chunk-YVZ6GOLE.js';
-export { CartService } from './chunk-YVZ6GOLE.js';
+import { CartService } from './chunk-S2ERKGYL.js';
+export { CartService } from './chunk-S2ERKGYL.js';
 import { CategoryService } from './chunk-MSQ3GEIW.js';
 export { CategoryService } from './chunk-MSQ3GEIW.js';
 export { iterateAll } from './chunk-W6SLZNRX.js';
@@ -946,7 +946,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "4.1.0";
+var version = "4.2.2";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -4487,6 +4487,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
@@ -4729,7 +4742,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.