@viu/emporix-sdk 4.9.4 → 4.10.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @viu/emporix-sdk
 
+## 4.10.0
+
+### Minor Changes
+
+- [#448](https://github.com/viuteam/emporix-sdk/pull/448) [`9805297`](https://github.com/viuteam/emporix-sdk/commit/9805297c8e6e959ecbcae7ece4eb146ef5f189ed) Thanks [@amnael1](https://github.com/amnael1)! - feat(sdk): queue a failed import file again, and document customer and legal-entity search
+  
+  `client.imports.requeueStreamFile(streamId, fileId)` puts a `FAILED` file back at the end of a file-based stream's queue, so the next run reads the content the service already holds. It is not retried on a 5xx: a requeue that went through leaves the file `PENDING`, and a repeat answers `409`. The JSDoc of `triggerRun`, `retryRun` and the file-queue types now describes `lastProcessed` and the new `404` / `400` answers.
+  
+  The Search Service accepts `customer` and `legal-entity` as a type besides custom schema types, with the matching read scopes; the `SearchService` JSDoc and the search docs say so, and describe index `analyzers` and `itemFields`. New type alias `SearchIndexAnalyzer`.
+
+### Patch Changes
+
+- [#447](https://github.com/viuteam/emporix-sdk/pull/447) [`c2703d9`](https://github.com/viuteam/emporix-sdk/commit/c2703d9c8c0ee61ac7230479c83c49439eef7724) Thanks [@viu-release-bot](https://github.com/apps/viu-release-bot)! - chore(sdk): sync generated types with upstream Emporix API specs
+  
+  Updated services: product,returns,schema
+
 ## 4.9.4
 
 ### Patch Changes

package/dist/index.cjs

@@ -1247,7 +1247,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "4.9.4";
+var version = "4.10.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -8523,13 +8523,18 @@ var SearchService = class {
     return `/search/${this.ctx.tenant}`;
   }
   /**
-   * Search the documents of one custom schema type. Paging, `sort` and
-   * `fields` travel as query parameters, not in the body.
+   * Search the documents of one type — a custom schema type, `customer` or
+   * `legal-entity`. Paging, `sort` and `fields` travel as query parameters, not
+   * in the body.
    *
    * Filter and sort fields must be indexed on the index the search uses —
-   * `exact`, or `text: true` for a `CONTAINS` filter — or the call answers `400`. A saved-search call (`{ searchQueryId, query }`) answers
-   * `404` when no saved search has that id for `type`, and `502` means the
-   * Schema Service could not confirm that `type` is a custom entity.
+   * `exact`, or `text: true` for a `CONTAINS` filter — or the call answers
+   * `400`. A `TEXT` or `PHRASE` query may pick the field's `analyzer` or one of
+   * its `additionalAnalyzers`. Conditions joined by `and` on fields of one
+   * `itemFields` list must match the same list item. A saved-search call
+   * (`{ searchQueryId, query }`) answers `404` when no saved search has that id
+   * for `type`, and `502` means the Schema Service could not confirm that a
+   * custom `type` is a custom entity.
    *
    * @example
    * const hits = await client.search.search("VEHICLE", {
@@ -8554,7 +8559,7 @@ var SearchService = class {
       page
     );
   }
-  /** List saved searches of one custom schema type (`opts.type`), or of every type. */
+  /** List saved searches of one type (`opts.type`), or of every type. */
   async listSavedSearches(opts = {}, auth2 = SERVICE29) {
     const { query, page } = pageQuery(opts);
     const t = opts.type;
@@ -8602,7 +8607,7 @@ var SearchService = class {
       auth: auth2
     });
   }
-  /** List search indexes of one custom schema type (`opts.type`), or of every type. */
+  /** List search indexes of one type (`opts.type`), or of every type. */
   async listIndexes(opts = {}, auth2 = SERVICE29) {
     const { query, page } = pageQuery(opts);
     const t = opts.type;
@@ -8896,6 +8901,11 @@ var ImportService = class {
    * streams. Read it back with {@link getRun}, or follow it with
    * {@link streamRun}, before treating a resolved call as a started import.
    *
+   * A configuration that does not exist answers `404` (since 2026-11-06; it used
+   * to be a `500`). A real run with nothing to import answers `400`: every stream
+   * it starts from reads uploaded files, and none has ever had one. Upload a file
+   * with {@link uploadStreamFile} first. A dry run is not refused for this.
+   *
    * Not retried on a 5xx: a POST that timed out may already have queued a run.
    *
    * @example
@@ -9146,7 +9156,7 @@ var ImportService = class {
    * {@link streamRun} exactly as you would a triggered run. Like one, it comes
    * back `QUEUED`, answers `409` while the configuration has a run `QUEUED`,
    * `RUNNING` or `RESUMABLE`, runs the published mappings and can finish
-   * `ABORTED`.
+   * `ABORTED`. A run that does not exist answers `404`.
    *
    * Not retried on a 5xx, for the same reason {@link triggerRun} is not: a POST
    * that timed out may already have queued the retry.
@@ -9257,6 +9267,29 @@ var ImportService = class {
       auth: auth2
     });
   }
+  /**
+   * Put a `FAILED` file back at the end of the stream's queue, so the next run
+   * reads the content the service already holds — no new upload. Use it after
+   * fixing the cause of the failure, a mapping say. Resolves to the file,
+   * `PENDING` again.
+   *
+   * Only a failed file can be queued again; `409` otherwise. A file imported with
+   * some records failing is `PROCESSED`: retry those records with
+   * {@link retryRun} instead. On a `SNAPSHOT` stream a failed file cannot be
+   * queued again once a newer file arrived, since the older snapshot would be
+   * imported over newer data — upload a corrected current file instead. `409`
+   * also when the stored content is gone, and while the job has a run in flight.
+   *
+   * Not retried on a 5xx: if the first attempt went through, the file is no
+   * longer `FAILED` and a repeat answers `409`.
+   */
+  async requeueStreamFile(streamId, fileId, auth2 = SERVICE30) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/streams/${encodeURIComponent(streamId)}/files/${encodeURIComponent(fileId)}/requeue`,
+      auth: auth2
+    });
+  }
 };
 
 // src/services/audit-log.ts