hcloud-sdk 22.46.0 → 22.48.0

package/changelog.md

@@ -1,5 +1,5 @@
-## [22.46.0](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/compare/v22.45.1...v22.46.0) (2026-10-05)
+## [22.48.0](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/compare/v22.47.0...v22.48.0) (2026-10-05)
 
 ### Features
 
-* add method to rerun streams ([7f882fc](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/7f882fca83329f310fafc20b41d796f3f4458c68))
+* reflect changes made in high5 ([af4a2a1](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/af4a2a1a89937f24f72b5e163d099b1fc0c6a1de))

package/lib/interfaces/high5/space/execution/index.d.ts

@@ -1,5 +1,5 @@
 import { HCloud } from "../../../../Hcloud";
-import { ReducedSpace } from "../../../global";
+import { PaginatedResponse, ReducedSpace } from "../../../global";
 import { ReducedOrganization, ReducedUser } from "../../../idp";
 import { WaveCatalog, WaveEngine } from "../../wave";
 import { ReducedEvent } from "../event";
@@ -159,6 +159,27 @@ export interface High5ExecutionStatus {
     startTime?: number;
     currentRetry?: number;
     assignedClient?: string;
+    /**
+     * Plaintext payload data of the execution, only set when searching execution states by payload
+     * (filter keys "payload" or "payload.<path>"). JSON payloads are returned as JSON value, generic payloads as string.
+     */
+    payload?: unknown;
+}
+/**
+ * Response of an execution state search. Searches with payload filters count at most 1000 matches,
+ * a higher number of matches is reported with total = 1000 and totalCapped = true.
+ */
+export interface High5ExecutionStatusSearchResponse extends PaginatedResponse<High5ExecutionStatus> {
+    /** True if total holds the capped count of a payload search instead of the exact number of matches */
+    totalCapped: boolean;
+}
+/**
+ * Response of a full execution state search by payload, which considers all executions but skips the count
+ */
+export interface High5ExecutionStatusFullSearchResponse {
+    items: High5ExecutionStatus[];
+    /** True if a next page exists */
+    hasMore: boolean;
 }
 export interface High5ExecutionLog {
     _id: string;

package/lib/interfaces/nats/index.d.ts

@@ -28,6 +28,7 @@ declare enum NatsSubject {
     HIGH5_SPACES = "hcloud.high5.organization.${base64orgName}.spaces",
     HIGH5_SPACE_PERMISSIONS = "hcloud.high5.organization.${base64orgName}.spaces.${base64spaceName}.permissions",
     HIGH5_STREAM_EXECUTE = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}",
+    HIGH5_STREAM_EXECUTE_POOL = "hcloud.high5.organization.${organizationId}.spaces.${spaceId}.stream.execute.pool.${base64poolName}",
     HIGH5_STREAM_CANCEL = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}",// eslint-disable-line @typescript-eslint/no-duplicate-enum-values
     HIGH5_STREAM_DEBUG_STOPPED = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}.${executionId}.stopped",
     HIGH5_STREAM_DEBUG_COMMAND = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}.${executionSecret}.command",
@@ -154,6 +155,7 @@ interface NatsObject extends NatsNameObject, NatsIdObject, NatsMemberObject, Nat
     [NatsSubject.HIGH5_SPACES]: NatsNameObject;
     [NatsSubject.HIGH5_SPACE_PERMISSIONS]: NatsIdObject;
     [NatsSubject.HIGH5_STREAM_EXECUTE]: High5ExecuteOnAgentRequest | High5ExecutionCancelRequest;
+    [NatsSubject.HIGH5_STREAM_EXECUTE_POOL]: High5ExecuteOnAgentRequest | High5ExecutionCancelRequest;
     [NatsSubject.HIGH5_STREAM_CANCEL]: High5ExecuteOnAgentRequest | High5ExecutionCancelRequest;
     [NatsSubject.HIGH5_EVENTS]: NatsNameObject;
     [NatsSubject.HIGH5_STREAMS]: NatsIdObject;
@@ -304,6 +306,7 @@ declare class NatsSubjects {
         Execution: {
             new (): {};
             EXECUTE: (organizationId: string, email: string) => string;
+            EXECUTE_POOL: (organizationId: string, spaceId: string, poolName: string) => string;
             CANCEL: (organizationId: string, email: string) => string;
             DEBUG: (organizationId: string, email: string) => {
                 STOPPED: (executionId: string) => string;

package/lib/interfaces/nats/index.js

@@ -31,6 +31,7 @@ var NatsSubject;
     NatsSubject["HIGH5_SPACES"] = "hcloud.high5.organization.${base64orgName}.spaces";
     NatsSubject["HIGH5_SPACE_PERMISSIONS"] = "hcloud.high5.organization.${base64orgName}.spaces.${base64spaceName}.permissions";
     NatsSubject["HIGH5_STREAM_EXECUTE"] = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}";
+    NatsSubject["HIGH5_STREAM_EXECUTE_POOL"] = "hcloud.high5.organization.${organizationId}.spaces.${spaceId}.stream.execute.pool.${base64poolName}";
     NatsSubject["HIGH5_STREAM_CANCEL"] = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}";
     NatsSubject["HIGH5_STREAM_DEBUG_STOPPED"] = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}.${executionId}.stopped";
     NatsSubject["HIGH5_STREAM_DEBUG_COMMAND"] = "hcloud.high5.organization.${organizationId}.stream.execute.${base64email}.${executionSecret}.command";
@@ -248,6 +249,9 @@ NatsSubjects.High5 = (_f = class {
         _g.EXECUTE = (organizationId, email) => {
             return NatsSubjects.replace(NatsSubject.HIGH5_STREAM_EXECUTE, { organizationId, email });
         },
+        _g.EXECUTE_POOL = (organizationId, spaceId, poolName) => {
+            return NatsSubjects.replace(NatsSubject.HIGH5_STREAM_EXECUTE_POOL, { organizationId, spaceId, poolName });
+        },
         _g.CANCEL = (organizationId, email) => {
             return NatsSubjects.replace(NatsSubject.HIGH5_STREAM_CANCEL, { organizationId, email });
         },

package/lib/service/high5/execution/status/index.d.ts

@@ -1,20 +1,46 @@
 import Base, { MaybeRaw } from "../../../../Base";
-import { PaginatedResponse, SearchParams } from "../../../../interfaces/global";
-import { High5ExecutionStatus } from "../../../../interfaces/high5/space/execution";
+import { SearchParams } from "../../../../interfaces/global";
+import { High5ExecutionStatusFullSearchResponse, High5ExecutionStatusSearchResponse } from "../../../../interfaces/high5/space/execution";
 export declare class High5OrganizationExecutionStates extends Base {
     /**
-     * Retrieves all stream execution logs for a given execution inside an organization.
+     * Retrieves the stream execution states of an organization.
+     *
+     * Besides the fields of the execution state, filters can target the payload of the execution:
+     * - `payload.<path>` filters JSON payloads by the value at the given property path, e.g. `payload.user.id`.
+     *   `is` matches the exact value (numbers and booleans keep their type), `starts with` is case-sensitive, `contains` and `ends with` are case-insensitive.
+     * - `payload` with `contains` is a case-insensitive text search over all string values of the payload. A single word only matches
+     *   whole words, values with separators are searched as phrase. Only the newest 10000 matching executions are considered,
+     *   use {@link fullSearchExecutionStates} to consider all of them.
+     *
+     * When filtering by payload, each state contains the `payload` of its execution and the total is capped at 1000 (see `totalCapped`).
      * @param orgName Name of the Organization
      * @param filters (optional) Array of search filters
      * @param sorting (optional) Sorting object
      * @param limit (optional) Max number of results (1-100; defaults to 25)
      * @param page (optional) Page number: Skip the first (page * limit) results (defaults to 0)
-     * @returns Object containing an array of Stream execution logs as well as the total number of results
+     * @returns Object containing an array of Stream execution states, the total number of results and whether the total is capped
      */
     searchExecutionStates<R extends boolean = false>({ orgName, filters, sorting, limit, page }: SearchParams & {
         orgName: string;
     }, raw?: {
         raw: R;
-    }): Promise<MaybeRaw<R, PaginatedResponse<High5ExecutionStatus>>>;
+    }): Promise<MaybeRaw<R, High5ExecutionStatusSearchResponse>>;
+    /**
+     * Retrieves the stream execution states of an organization by payload, considering all executions without limits.
+     * The count is skipped, so instead of a total the response tells whether a next page exists. Takes the same filters as
+     * {@link searchExecutionStates}, but can take considerably longer for payload filters matching many executions.
+     * Searches without payload filters behave like {@link searchExecutionStates}.
+     * @param orgName Name of the Organization
+     * @param filters (optional) Array of search filters
+     * @param sorting (optional) Sorting object
+     * @param limit (optional) Max number of results (1-100; defaults to 25)
+     * @param page (optional) Page number: Skip the first (page * limit) results (defaults to 0)
+     * @returns Object containing an array of Stream execution states and whether a next page exists
+     */
+    fullSearchExecutionStates<R extends boolean = false>({ orgName, filters, sorting, limit, page }: SearchParams & {
+        orgName: string;
+    }, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, High5ExecutionStatusFullSearchResponse>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/high5/execution/status/index.js

@@ -18,13 +18,22 @@ const paginatedResponseHelper_1 = require("../../../../helper/paginatedResponseH
 const searchFilter_1 = require("../../../../helper/searchFilter");
 class High5OrganizationExecutionStates extends Base_1.default {
     /**
-     * Retrieves all stream execution logs for a given execution inside an organization.
+     * Retrieves the stream execution states of an organization.
+     *
+     * Besides the fields of the execution state, filters can target the payload of the execution:
+     * - `payload.<path>` filters JSON payloads by the value at the given property path, e.g. `payload.user.id`.
+     *   `is` matches the exact value (numbers and booleans keep their type), `starts with` is case-sensitive, `contains` and `ends with` are case-insensitive.
+     * - `payload` with `contains` is a case-insensitive text search over all string values of the payload. A single word only matches
+     *   whole words, values with separators are searched as phrase. Only the newest 10000 matching executions are considered,
+     *   use {@link fullSearchExecutionStates} to consider all of them.
+     *
+     * When filtering by payload, each state contains the `payload` of its execution and the total is capped at 1000 (see `totalCapped`).
      * @param orgName Name of the Organization
      * @param filters (optional) Array of search filters
      * @param sorting (optional) Sorting object
      * @param limit (optional) Max number of results (1-100; defaults to 25)
      * @param page (optional) Page number: Skip the first (page * limit) results (defaults to 0)
-     * @returns Object containing an array of Stream execution logs as well as the total number of results
+     * @returns Object containing an array of Stream execution states, the total number of results and whether the total is capped
      */
     searchExecutionStates(_a, raw_1) {
         return __awaiter(this, arguments, void 0, function* ({ orgName, filters, sorting, limit = 25, page = 0 }, raw) {
@@ -33,7 +42,34 @@ class High5OrganizationExecutionStates extends Base_1.default {
                 filters: filtersDTO,
                 sorting: sorting,
             });
-            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? Object.assign(Object.assign({}, resp), { data: (0, paginatedResponseHelper_1.createPaginatedResponse)(resp) }) : (0, paginatedResponseHelper_1.createPaginatedResponse)(resp));
+            const data = Object.assign(Object.assign({}, (0, paginatedResponseHelper_1.createPaginatedResponse)(resp)), { totalCapped: resp.headers["total-capped"] === "true" });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? Object.assign(Object.assign({}, resp), { data }) : data);
+        });
+    }
+    /**
+     * Retrieves the stream execution states of an organization by payload, considering all executions without limits.
+     * The count is skipped, so instead of a total the response tells whether a next page exists. Takes the same filters as
+     * {@link searchExecutionStates}, but can take considerably longer for payload filters matching many executions.
+     * Searches without payload filters behave like {@link searchExecutionStates}.
+     * @param orgName Name of the Organization
+     * @param filters (optional) Array of search filters
+     * @param sorting (optional) Sorting object
+     * @param limit (optional) Max number of results (1-100; defaults to 25)
+     * @param page (optional) Page number: Skip the first (page * limit) results (defaults to 0)
+     * @returns Object containing an array of Stream execution states and whether a next page exists
+     */
+    fullSearchExecutionStates(_a, raw_1) {
+        return __awaiter(this, arguments, void 0, function* ({ orgName, filters, sorting, limit = 25, page = 0 }, raw) {
+            const filtersDTO = filters === null || filters === void 0 ? void 0 : filters.map((f) => new searchFilter_1.SearchFilterDTO(f));
+            const resp = yield this.axios.post(this.getEndpoint(`/v1/org/${orgName}/execution/status/search?page=${page}&limit=${limit}&fullSearch=true`), {
+                filters: filtersDTO,
+                sorting: sorting,
+            });
+            // searches without payload filters are not full searches and report a total instead
+            const hasMoreHeader = resp.headers["has-more"];
+            const hasMore = hasMoreHeader !== undefined ? hasMoreHeader === "true" : (page + 1) * limit < parseInt(String(resp.headers["total"]), 10);
+            const data = { items: resp.data, hasMore };
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? Object.assign(Object.assign({}, resp), { data }) : data);
         });
     }
     getEndpoint(endpoint) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hcloud-sdk",
-  "version": "22.46.0",
+  "version": "22.48.0",
   "description": "hcloud platform sdk",
   "main": "index.js",
   "types": "index.d.ts",
@@ -52,7 +52,7 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "axios": "^1.13.2",
+    "axios": "^1.20.0",
     "nats": "^2.29.3",
     "nats.ws": "^1.30.3"
   }