@hatchet-dev/typescript-sdk 1.37.0 → 1.39.0

package/clients/rest/generated/Api.d.ts

@@ -1,4 +1,4 @@
-import { APIErrors, APIMeta, AcceptInviteRequest, BulkCreateEventRequest, CancelEventRequest, CreateAPITokenRequest, CreateAPITokenResponse, CreateCronWorkflowTriggerRequest, CreateEventRequest, CreateSNSIntegrationRequest, CreateTenantAlertEmailGroupRequest, CreateTenantInviteRequest, CreateTenantRequest, CronWorkflows, CronWorkflowsList, CronWorkflowsOrderByField, Event, EventData, EventKey, EventKeyList, EventList, EventOrderByDirection, EventOrderByField, EventSearch, Events, FeatureFlagEvaluationResult, FeatureFlagId, ListAPIMetaIntegration, ListAPITokensResponse, ListSNSIntegrations, ListSlackWebhooks, OtelSpanList, RateLimitList, RateLimitOrderByDirection, RateLimitOrderByField, RejectInviteRequest, ReplayEventRequest, ReplayWorkflowRunsRequest, ReplayWorkflowRunsResponse, RerunStepRunRequest, SNSIntegration, ScheduleWorkflowRunRequest, ScheduledRunStatus, ScheduledWorkflows, ScheduledWorkflowsBulkDeleteRequest, ScheduledWorkflowsBulkDeleteResponse, ScheduledWorkflowsBulkUpdateRequest, ScheduledWorkflowsBulkUpdateResponse, ScheduledWorkflowsList, ScheduledWorkflowsOrderByField, StepRun, StepRunArchiveList, StepRunEventList, TaskStats, Tenant, TenantAlertEmailGroup, TenantAlertEmailGroupList, TenantAlertingSettings, TenantInvite, TenantInviteList, TenantMember, TenantMemberList, TenantQueueMetrics, TenantResourcePolicy, TenantStepRunQueueMetrics, TriggerRunResult, TriggerWorkflowRunRequest, UpdateCronWorkflowTriggerRequest, UpdateScheduledWorkflowRunRequest, UpdateTenantAlertEmailGroupRequest, UpdateTenantInviteRequest, UpdateTenantMemberRequest, UpdateTenantRequest, UpdateWorkerRequest, User, UserChangePasswordRequest, UserLoginRequest, UserRegisterRequest, UserTenantMembershipsList, V1AdditionalMetadataOperator, V1BranchDurableTaskRequest, V1BranchDurableTaskResponse, V1CELDebugRequest, V1CELDebugResponse, V1CancelTaskRequest, V1CancelledTasks, V1CreateFilterRequest, V1CreateWebhookRequest, V1DagChildren, V1DurableEventLogList, V1Event, V1EventList, V1Filter, V1FilterList, V1LogLineLevel, V1LogLineList, V1LogLineOrderByDirection, V1LogsPointMetrics, V1ReplayTaskRequest, V1ReplayedTasks, V1RestoreTaskResponse, V1RunningFilter, V1StreamPayloadRef, V1TaskEventList, V1TaskPointMetrics, V1TaskRunMetrics, V1TaskStatus, V1TaskSummary, V1TaskSummaryList, V1TaskTimingList, V1TriggerWorkflowRunRequest, V1UpdateFilterRequest, V1UpdateWebhookRequest, V1Webhook, V1WebhookList, V1WebhookResponse, V1WebhookSourceName, V1WorkflowRunCount, V1WorkflowRunDetails, V1WorkflowRunDisplayNameList, V1WorkflowRunExternalIdList, WebhookWorkerCreateRequest, WebhookWorkerCreated, WebhookWorkerListResponse, WebhookWorkerRequestListResponse, Worker, WorkerList, WorkerStatus, Workflow, WorkflowID, WorkflowKindList, WorkflowList, WorkflowMetrics, WorkflowRun, WorkflowRunList, WorkflowRunOrderByDirection, WorkflowRunOrderByField, WorkflowRunShape, WorkflowRunStatus, WorkflowRunStatusList, WorkflowRunsCancelRequest, WorkflowRunsMetrics, WorkflowUpdateRequest, WorkflowVersion, WorkflowWorkersCount } from './data-contracts';
+import { APIErrors, APIMeta, AcceptInviteRequest, BulkCreateEventRequest, CancelEventRequest, CreateAPITokenRequest, CreateAPITokenResponse, CreateCronWorkflowTriggerRequest, CreateEventRequest, CreateSNSIntegrationRequest, CreateTenantAlertEmailGroupRequest, CreateTenantInviteRequest, CreateTenantRequest, CronWorkflows, CronWorkflowsList, CronWorkflowsOrderByField, Event, EventData, EventKey, EventKeyList, EventList, EventOrderByDirection, EventOrderByField, EventSearch, Events, FeatureFlagEvaluationResult, FeatureFlagId, ListAPIMetaIntegration, ListAPITokensResponse, ListSNSIntegrations, ListSlackWebhooks, OtelSpanList, RateLimitList, RateLimitOrderByDirection, RateLimitOrderByField, RejectInviteRequest, ReplayEventRequest, ReplayWorkflowRunsRequest, ReplayWorkflowRunsResponse, RerunStepRunRequest, SNSIntegration, ScheduleWorkflowRunRequest, ScheduledRunStatus, ScheduledWorkflows, ScheduledWorkflowsBulkDeleteRequest, ScheduledWorkflowsBulkDeleteResponse, ScheduledWorkflowsBulkUpdateRequest, ScheduledWorkflowsBulkUpdateResponse, ScheduledWorkflowsList, ScheduledWorkflowsOrderByField, StepRun, StepRunArchiveList, StepRunEventList, TaskStats, Tenant, TenantAlertEmailGroup, TenantAlertEmailGroupList, TenantAlertingSettings, TenantInvite, TenantInviteList, TenantMember, TenantMemberList, TenantQueueMetrics, TenantResourcePolicy, TenantStepRunQueueMetrics, TriggerRunResult, TriggerWorkflowRunRequest, UpdateCronWorkflowTriggerRequest, UpdateScheduledWorkflowRunRequest, UpdateTenantAlertEmailGroupRequest, UpdateTenantInviteRequest, UpdateTenantMemberRequest, UpdateTenantRequest, UpdateWorkerRequest, User, UserChangePasswordRequest, UserLoginRequest, UserRegisterRequest, UserTenantMembershipsList, V1AdditionalMetadataOperator, V1BranchDurableTaskRequest, V1BranchDurableTaskResponse, V1CELDebugRequest, V1CELDebugResponse, V1CancelTaskRequest, V1CancelledTasks, V1CreateFilterRequest, V1CreateServerlessEndpointRequest, V1CreateWebhookRequest, V1DagChildren, V1DurableEventLogList, V1Event, V1EventList, V1Filter, V1FilterList, V1LogLineLevel, V1LogLineList, V1LogLineOrderByDirection, V1LogsPointMetrics, V1ReplayTaskRequest, V1ReplayedTasks, V1RestoreTaskResponse, V1RunningFilter, V1ServerlessEndpoint, V1ServerlessEndpointList, V1StreamPayloadRef, V1TaskEventList, V1TaskPointMetrics, V1TaskRunMetrics, V1TaskStatus, V1TaskSummary, V1TaskSummaryList, V1TaskTimingList, V1TriggerWorkflowRunRequest, V1UpdateFilterRequest, V1UpdateServerlessEndpointRequest, V1UpdateWebhookRequest, V1Webhook, V1WebhookList, V1WebhookResponse, V1WebhookSourceName, V1WorkflowRunCount, V1WorkflowRunDetails, V1WorkflowRunDisplayNameList, V1WorkflowRunExternalIdList, WebhookWorkerCreateRequest, WebhookWorkerCreated, WebhookWorkerListResponse, WebhookWorkerRequestListResponse, Worker, WorkerList, WorkerStatus, Workflow, WorkflowID, WorkflowKindList, WorkflowList, WorkflowMetrics, WorkflowRun, WorkflowRunList, WorkflowRunOrderByDirection, WorkflowRunOrderByField, WorkflowRunShape, WorkflowRunStatus, WorkflowRunStatusList, WorkflowRunsCancelRequest, WorkflowRunsMetrics, WorkflowUpdateRequest, WorkflowVersion, WorkflowWorkersCount } from './data-contracts';
 import { HttpClient, RequestParams } from './http-client';
 export declare class Api<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {
     /**
@@ -777,6 +777,67 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
      * @secure
      */
     v1WebhookUpdate: (tenant: string, v1Webhook: string, data: V1UpdateWebhookRequest, params?: RequestParams) => Promise<import("axios").AxiosResponse<V1Webhook, any, {}>>;
+    /**
+     * @description Lists the serverless endpoints of a tenant.
+     *
+     * @tags Serverless
+     * @name V1ServerlessEndpointList
+     * @summary List serverless endpoints
+     * @request GET:/api/v1/stable/tenants/{tenant}/serverless/endpoints
+     * @secure
+     */
+    v1ServerlessEndpointList: (tenant: string, query?: {
+        /**
+         * The number to skip
+         * @format int64
+         */
+        offset?: number;
+        /**
+         * The number to limit by
+         * @format int64
+         */
+        limit?: number;
+    }, params?: RequestParams) => Promise<import("axios").AxiosResponse<V1ServerlessEndpointList, any, {}>>;
+    /**
+     * @description Create a serverless endpoint
+     *
+     * @tags Serverless
+     * @name V1ServerlessEndpointCreate
+     * @summary Create a serverless endpoint
+     * @request POST:/api/v1/stable/tenants/{tenant}/serverless/endpoints
+     * @secure
+     */
+    v1ServerlessEndpointCreate: (tenant: string, data: V1CreateServerlessEndpointRequest, params?: RequestParams) => Promise<import("axios").AxiosResponse<V1ServerlessEndpoint, any, {}>>;
+    /**
+     * @description Get a serverless endpoint by its id
+     *
+     * @tags Serverless
+     * @name V1ServerlessEndpointGet
+     * @summary Get a serverless endpoint
+     * @request GET:/api/v1/stable/serverless/endpoints/{v1-serverless-endpoint}
+     * @secure
+     */
+    v1ServerlessEndpointGet: (v1ServerlessEndpoint: string, params?: RequestParams) => Promise<import("axios").AxiosResponse<V1ServerlessEndpoint, any, {}>>;
+    /**
+     * @description Update a serverless endpoint
+     *
+     * @tags Serverless
+     * @name V1ServerlessEndpointUpdate
+     * @summary Update a serverless endpoint
+     * @request PATCH:/api/v1/stable/serverless/endpoints/{v1-serverless-endpoint}
+     * @secure
+     */
+    v1ServerlessEndpointUpdate: (v1ServerlessEndpoint: string, data: V1UpdateServerlessEndpointRequest, params?: RequestParams) => Promise<import("axios").AxiosResponse<V1ServerlessEndpoint, any, {}>>;
+    /**
+     * @description Delete a serverless endpoint
+     *
+     * @tags Serverless
+     * @name V1ServerlessEndpointDelete
+     * @summary Delete a serverless endpoint
+     * @request DELETE:/api/v1/stable/serverless/endpoints/{v1-serverless-endpoint}
+     * @secure
+     */
+    v1ServerlessEndpointDelete: (v1ServerlessEndpoint: string, params?: RequestParams) => Promise<import("axios").AxiosResponse<V1ServerlessEndpoint, any, {}>>;
     /**
      * @description Evaluate a CEL expression against provided input data.
      *

package/clients/rest/generated/Api.js

@@ -405,6 +405,56 @@ class Api extends http_client_1.HttpClient {
          * @secure
          */
         this.v1WebhookUpdate = (tenant, v1Webhook, data, params = {}) => this.request(Object.assign({ path: `/api/v1/stable/tenants/${tenant}/webhooks/${v1Webhook}`, method: 'PATCH', body: data, secure: true, type: http_client_1.ContentType.Json, format: 'json' }, params));
+        /**
+         * @description Lists the serverless endpoints of a tenant.
+         *
+         * @tags Serverless
+         * @name V1ServerlessEndpointList
+         * @summary List serverless endpoints
+         * @request GET:/api/v1/stable/tenants/{tenant}/serverless/endpoints
+         * @secure
+         */
+        this.v1ServerlessEndpointList = (tenant, query, params = {}) => this.request(Object.assign({ path: `/api/v1/stable/tenants/${tenant}/serverless/endpoints`, method: 'GET', query: query, secure: true, format: 'json' }, params));
+        /**
+         * @description Create a serverless endpoint
+         *
+         * @tags Serverless
+         * @name V1ServerlessEndpointCreate
+         * @summary Create a serverless endpoint
+         * @request POST:/api/v1/stable/tenants/{tenant}/serverless/endpoints
+         * @secure
+         */
+        this.v1ServerlessEndpointCreate = (tenant, data, params = {}) => this.request(Object.assign({ path: `/api/v1/stable/tenants/${tenant}/serverless/endpoints`, method: 'POST', body: data, secure: true, type: http_client_1.ContentType.Json, format: 'json' }, params));
+        /**
+         * @description Get a serverless endpoint by its id
+         *
+         * @tags Serverless
+         * @name V1ServerlessEndpointGet
+         * @summary Get a serverless endpoint
+         * @request GET:/api/v1/stable/serverless/endpoints/{v1-serverless-endpoint}
+         * @secure
+         */
+        this.v1ServerlessEndpointGet = (v1ServerlessEndpoint, params = {}) => this.request(Object.assign({ path: `/api/v1/stable/serverless/endpoints/${v1ServerlessEndpoint}`, method: 'GET', secure: true, format: 'json' }, params));
+        /**
+         * @description Update a serverless endpoint
+         *
+         * @tags Serverless
+         * @name V1ServerlessEndpointUpdate
+         * @summary Update a serverless endpoint
+         * @request PATCH:/api/v1/stable/serverless/endpoints/{v1-serverless-endpoint}
+         * @secure
+         */
+        this.v1ServerlessEndpointUpdate = (v1ServerlessEndpoint, data, params = {}) => this.request(Object.assign({ path: `/api/v1/stable/serverless/endpoints/${v1ServerlessEndpoint}`, method: 'PATCH', body: data, secure: true, type: http_client_1.ContentType.Json, format: 'json' }, params));
+        /**
+         * @description Delete a serverless endpoint
+         *
+         * @tags Serverless
+         * @name V1ServerlessEndpointDelete
+         * @summary Delete a serverless endpoint
+         * @request DELETE:/api/v1/stable/serverless/endpoints/{v1-serverless-endpoint}
+         * @secure
+         */
+        this.v1ServerlessEndpointDelete = (v1ServerlessEndpoint, params = {}) => this.request(Object.assign({ path: `/api/v1/stable/serverless/endpoints/${v1ServerlessEndpoint}`, method: 'DELETE', secure: true, format: 'json' }, params));
         /**
          * @description Evaluate a CEL expression against provided input data.
          *

package/clients/rest/generated/data-contracts.d.ts

@@ -191,6 +191,11 @@ export declare enum V1CELDebugResponseStatus {
     SUCCESS = "SUCCESS",
     ERROR = "ERROR"
 }
+/** The kind of serverless endpoint. GENERIC_HTTP is any HTTPS endpoint that implements the serverless endpoint contract; CLOUDFLARE_WORKERS applies the Cloudflare Workers runtime constraints on top of it. */
+export declare enum V1ServerlessEndpointKind {
+    GENERIC_HTTP = "GENERIC_HTTP",
+    CLOUDFLARE_WORKERS = "CLOUDFLARE_WORKERS"
+}
 export declare enum V1WebhookHMACEncoding {
     HEX = "HEX",
     BASE64 = "BASE64",
@@ -1129,6 +1134,130 @@ export interface V1UpdateWebhookRequest {
     /** Whether to return the triggered event as the response payload when this webhook is triggered */
     returnEventAsResponsePayload?: boolean;
 }
+/** The health of the endpoint as last observed by the serverless operator. Written on state transitions only, so changedAt is the time the endpoint last flipped between healthy and unhealthy. */
+export interface V1ServerlessEndpointStatus {
+    /** Whether the last healthcheck succeeded. Absent until the operator has polled the endpoint at least once. */
+    healthy?: boolean;
+    /** The error from the last failed healthcheck, if the endpoint is unhealthy. */
+    error?: string;
+    /**
+     * When the healthy flag last changed.
+     * @format date-time
+     */
+    changedAt?: string;
+    /** The action ids the operator registered for this endpoint from its last healthcheck, as the endpoint declared them. Several endpoints of a tenant may register the same action; each then serves it. */
+    registeredActions: string[];
+}
+export interface V1ServerlessEndpoint {
+    metadata: APIResourceMeta;
+    /**
+     * The ID of the tenant that owns this endpoint.
+     * @format uuid
+     */
+    tenantId: string;
+    /** The name of the endpoint. Unique within the tenant. */
+    name: string;
+    /** The kind of serverless endpoint. GENERIC_HTTP is any HTTPS endpoint that implements the serverless endpoint contract; CLOUDFLARE_WORKERS applies the Cloudflare Workers runtime constraints on top of it. */
+    kind: V1ServerlessEndpointKind;
+    /** The HTTPS URL (port 443) polled periodically to discover the workflows this endpoint serves. */
+    healthcheckUrl: string;
+    /** The HTTPS URL (port 443) that assigned tasks are delivered to. */
+    triggerUrl: string;
+    /**
+     * The per-request timeout backstop for trigger requests, in seconds.
+     * @format int32
+     */
+    requestTimeoutSeconds: number;
+    /**
+     * How often the healthcheck URL is polled, in seconds.
+     * @format int32
+     */
+    pollIntervalSeconds: number;
+    /**
+     * How long a trigger request may block waiting for a durable result before the operator falls back to the websocket durable protocol, in milliseconds.
+     * @format int32
+     */
+    inlineWaitBudgetMs: number;
+    /** Worker labels applied to the connection-backed worker the operator creates for this endpoint. */
+    labels: Record<string, any>;
+    /** Whether the operator polls and dispatches to this endpoint. */
+    enabled: boolean;
+    /** The health of the endpoint as last observed by the serverless operator. Written on state transitions only, so changedAt is the time the endpoint last flipped between healthy and unhealthy. */
+    status: V1ServerlessEndpointStatus;
+}
+export interface V1ServerlessEndpointList {
+    pagination?: PaginationResponse;
+    rows?: V1ServerlessEndpoint[];
+}
+export interface V1CreateServerlessEndpointRequest {
+    /** The name of the endpoint. Unique within the tenant. */
+    name: string;
+    /** The kind of serverless endpoint. GENERIC_HTTP is any HTTPS endpoint that implements the serverless endpoint contract; CLOUDFLARE_WORKERS applies the Cloudflare Workers runtime constraints on top of it. */
+    kind?: V1ServerlessEndpointKind;
+    /** The HTTPS URL (port 443) polled periodically to discover the workflows this endpoint serves. */
+    healthcheckUrl: string;
+    /** The HTTPS URL (port 443) that assigned tasks are delivered to. */
+    triggerUrl: string;
+    /**
+     * The secret used to HMAC-sign requests delivered to the endpoint. At least 32 characters. Write-only: it is stored encrypted and never returned in responses.
+     * @minLength 32
+     */
+    signingSecret: string;
+    /**
+     * The per-request timeout backstop for trigger requests, in seconds. Defaults to 60.
+     * @format int32
+     */
+    requestTimeoutSeconds?: number;
+    /**
+     * How often the healthcheck URL is polled, in seconds. Defaults to 30.
+     * @format int32
+     */
+    pollIntervalSeconds?: number;
+    /**
+     * The inline wait budget for durable results, in milliseconds. Defaults to 5000.
+     * @format int32
+     */
+    inlineWaitBudgetMs?: number;
+    /** Worker labels applied to the worker the operator creates for this endpoint. */
+    labels?: Record<string, any>;
+    /** Whether the operator polls and dispatches to this endpoint. Defaults to true. */
+    enabled?: boolean;
+}
+/** Fields to update on a serverless endpoint. Omitted fields are left unchanged. */
+export interface V1UpdateServerlessEndpointRequest {
+    /** The name of the endpoint. Unique within the tenant. */
+    name?: string;
+    /** The kind of serverless endpoint. GENERIC_HTTP is any HTTPS endpoint that implements the serverless endpoint contract; CLOUDFLARE_WORKERS applies the Cloudflare Workers runtime constraints on top of it. */
+    kind?: V1ServerlessEndpointKind;
+    /** The HTTPS URL (port 443) polled periodically to discover the workflows this endpoint serves. */
+    healthcheckUrl?: string;
+    /** The HTTPS URL (port 443) that assigned tasks are delivered to. */
+    triggerUrl?: string;
+    /**
+     * A new secret used to HMAC-sign requests delivered to the endpoint. At least 32 characters. Provide a value to rotate the secret; it is never returned in responses.
+     * @minLength 32
+     */
+    signingSecret?: string;
+    /**
+     * The per-request timeout backstop for trigger requests, in seconds.
+     * @format int32
+     */
+    requestTimeoutSeconds?: number;
+    /**
+     * How often the healthcheck URL is polled, in seconds.
+     * @format int32
+     */
+    pollIntervalSeconds?: number;
+    /**
+     * The inline wait budget for durable results, in milliseconds.
+     * @format int32
+     */
+    inlineWaitBudgetMs?: number;
+    /** Worker labels applied to the worker the operator creates for this endpoint. Replaces the existing labels. */
+    labels?: Record<string, any>;
+    /** Whether the operator polls and dispatches to this endpoint. */
+    enabled?: boolean;
+}
 export interface V1CELDebugRequest {
     /** The CEL expression to evaluate */
     expression: string;
@@ -1661,6 +1790,8 @@ export interface Workflow {
     jobs?: Job[];
     /** The tenant id of the workflow. */
     tenantId: string;
+    /** The event and cron triggers declared on the latest workflow version. */
+    triggers?: WorkflowTriggers;
 }
 export interface WorkflowVersionMeta {
     metadata: APIResourceMeta;
@@ -1704,6 +1835,21 @@ export interface Job {
     /** The timeout of the job. */
     timeout?: string;
 }
+export interface WorkflowTriggerEventRef {
+    parent_id?: string;
+    event_key?: string;
+}
+export interface WorkflowTriggerCronRef {
+    parent_id?: string;
+    cron?: string;
+}
+export interface WorkflowTriggers {
+    metadata?: APIResourceMeta;
+    workflow_version_id?: string;
+    tenant_id?: string;
+    events?: WorkflowTriggerEventRef[];
+    crons?: WorkflowTriggerCronRef[];
+}
 export interface WorkflowList {
     metadata?: APIResourceMeta;
     rows?: Workflow[];
@@ -1904,21 +2050,6 @@ export interface WorkflowConcurrency {
     /** An action which gets the concurrency group for the WorkflowRun. */
     getConcurrencyGroup: string;
 }
-export interface WorkflowTriggerEventRef {
-    parent_id?: string;
-    event_key?: string;
-}
-export interface WorkflowTriggerCronRef {
-    parent_id?: string;
-    cron?: string;
-}
-export interface WorkflowTriggers {
-    metadata?: APIResourceMeta;
-    workflow_version_id?: string;
-    tenant_id?: string;
-    events?: WorkflowTriggerEventRef[];
-    crons?: WorkflowTriggerCronRef[];
-}
 export interface ConcurrencySetting {
     /**
      * The maximum number of concurrent workflow runs.

package/clients/rest/generated/data-contracts.js

@@ -11,7 +11,8 @@
  * ---------------------------------------------------------------
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1TaskStatus = exports.V1WorkflowType = exports.V1TaskEventType = exports.V1LogLineLevel = exports.V1LogLineOrderByDirection = exports.V1AdditionalMetadataOperator = exports.V1RunningFilter = exports.V1DurableEventLogKind = exports.V1DurableWaitConditionKind = exports.OtelSpanKind = exports.OtelStatusCode = exports.TenantVersion = exports.TenantEnvironment = exports.V1WebhookSourceName = exports.V1WebhookAuthType = exports.V1WebhookHMACAlgorithm = exports.V1WebhookHMACEncoding = exports.V1CELDebugResponseStatus = exports.TenantResource = exports.TenantMemberRole = exports.WorkflowRunStatus = exports.EventOrderByField = exports.EventOrderByDirection = exports.RateLimitOrderByField = exports.RateLimitOrderByDirection = exports.WorkflowPauseScheduledCronRunQueueBehavior = exports.ScheduledWorkflowsMethod = exports.ScheduledWorkflowsOrderByField = exports.WorkflowRunOrderByDirection = exports.ScheduledRunStatus = exports.CronWorkflowsMethod = exports.CronWorkflowsOrderByField = exports.ConcurrencyLimitStrategy = exports.ConcurrencyScope = exports.StepRunStatus = exports.JobRunStatus = exports.StepRunEventReason = exports.StepRunEventSeverity = exports.WorkflowKind = exports.WorkflowRunOrderByField = exports.WorkerStatus = exports.WorkerType = exports.WorkerRuntimeSDKs = exports.WebhookWorkerRequestMethod = exports.FeatureFlagId = exports.PullRequestState = exports.LogLineLevel = exports.LogLineOrderByField = exports.LogLineOrderByDirection = exports.V1TaskRunStatus = void 0;
+exports.V1WorkflowType = exports.V1TaskEventType = exports.V1LogLineLevel = exports.V1LogLineOrderByDirection = exports.V1AdditionalMetadataOperator = exports.V1RunningFilter = exports.V1DurableEventLogKind = exports.V1DurableWaitConditionKind = exports.OtelSpanKind = exports.OtelStatusCode = exports.TenantVersion = exports.TenantEnvironment = exports.V1WebhookSourceName = exports.V1WebhookAuthType = exports.V1WebhookHMACAlgorithm = exports.V1WebhookHMACEncoding = exports.V1ServerlessEndpointKind = exports.V1CELDebugResponseStatus = exports.TenantResource = exports.TenantMemberRole = exports.WorkflowRunStatus = exports.EventOrderByField = exports.EventOrderByDirection = exports.RateLimitOrderByField = exports.RateLimitOrderByDirection = exports.WorkflowPauseScheduledCronRunQueueBehavior = exports.ScheduledWorkflowsMethod = exports.ScheduledWorkflowsOrderByField = exports.WorkflowRunOrderByDirection = exports.ScheduledRunStatus = exports.CronWorkflowsMethod = exports.CronWorkflowsOrderByField = exports.ConcurrencyLimitStrategy = exports.ConcurrencyScope = exports.StepRunStatus = exports.JobRunStatus = exports.StepRunEventReason = exports.StepRunEventSeverity = exports.WorkflowKind = exports.WorkflowRunOrderByField = exports.WorkerStatus = exports.WorkerType = exports.WorkerRuntimeSDKs = exports.WebhookWorkerRequestMethod = exports.FeatureFlagId = exports.PullRequestState = exports.LogLineLevel = exports.LogLineOrderByField = exports.LogLineOrderByDirection = exports.V1TaskRunStatus = void 0;
+exports.V1TaskStatus = void 0;
 var V1TaskRunStatus;
 (function (V1TaskRunStatus) {
     V1TaskRunStatus["PENDING"] = "PENDING";
@@ -238,6 +239,12 @@ var V1CELDebugResponseStatus;
     V1CELDebugResponseStatus["SUCCESS"] = "SUCCESS";
     V1CELDebugResponseStatus["ERROR"] = "ERROR";
 })(V1CELDebugResponseStatus || (exports.V1CELDebugResponseStatus = V1CELDebugResponseStatus = {}));
+/** The kind of serverless endpoint. GENERIC_HTTP is any HTTPS endpoint that implements the serverless endpoint contract; CLOUDFLARE_WORKERS applies the Cloudflare Workers runtime constraints on top of it. */
+var V1ServerlessEndpointKind;
+(function (V1ServerlessEndpointKind) {
+    V1ServerlessEndpointKind["GENERIC_HTTP"] = "GENERIC_HTTP";
+    V1ServerlessEndpointKind["CLOUDFLARE_WORKERS"] = "CLOUDFLARE_WORKERS";
+})(V1ServerlessEndpointKind || (exports.V1ServerlessEndpointKind = V1ServerlessEndpointKind = {}));
 var V1WebhookHMACEncoding;
 (function (V1WebhookHMACEncoding) {
     V1WebhookHMACEncoding["HEX"] = "HEX";

package/clients/streams/rpc.d.ts

@@ -0,0 +1,8 @@
+import { V1StreamsClient } from '../../protoc/v1/streams';
+import type { Transport } from '../transport/transport';
+/**
+ * The v1 `V1Streams` client, every RPC of the generated `V1StreamsClient` interface, served
+ * by a Connect client on the given transport. `Subscribe` is a server stream, which the unary
+ * transport does not serve: calling it throws.
+ */
+export declare function createV1StreamsRpc(transport: Transport): V1StreamsClient;

package/clients/streams/rpc.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createV1StreamsRpc = createV1StreamsRpc;
+const streams_1 = require("../../protoc/v1/streams");
+const streams_pb_1 = require("../../protoc-es/v1/streams_pb");
+const ts_proto_client_1 = require("../transport/ts-proto-client");
+/**
+ * The v1 `V1Streams` client, every RPC of the generated `V1StreamsClient` interface, served
+ * by a Connect client on the given transport. `Subscribe` is a server stream, which the unary
+ * transport does not serve: calling it throws.
+ */
+function createV1StreamsRpc(transport) {
+    return (0, ts_proto_client_1.createTsProtoClient)(streams_1.V1StreamsDefinition, streams_pb_1.V1Streams, transport);
+}

package/clients/transport/fetch-transport.js

@@ -82,7 +82,24 @@ function createFetchTransport(options) {
         baseUrl: resolveServerUrl(options),
         useBinaryFormat: true,
         interceptors: [(0, transport_1.createAuthInterceptor)(options.token)],
-        fetch: limitMessageSizes(send, limits),
+        fetch: limitMessageSizes(withoutRedirects(send), limits),
+    });
+}
+/**
+ * Wraps a `fetch` so a redirect fails the call instead of being followed. connect-web asks
+ * for this with `redirect: 'error'`, which Cloudflare Workers reject outright ("Invalid
+ * redirect value"), so the request goes out with `redirect: 'manual'` and a redirect
+ * response (a 3xx status, or the opaque redirect a browser hands back) is turned into the
+ * error connect-web would have raised. The engine never redirects; one means `serverUrl`
+ * points at something in front of it.
+ */
+function withoutRedirects(send) {
+    return (input, init) => __awaiter(this, void 0, void 0, function* () {
+        const response = yield send(input, Object.assign(Object.assign({}, init), { redirect: 'manual' }));
+        if (response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) {
+            throw new connect_1.ConnectError(`the server answered with a redirect (${response.status || 'opaque'}); serverUrl must point at the engine itself`, connect_1.Code.Unavailable);
+        }
+        return response;
     });
 }
 /**

package/core/client.d.ts

@@ -55,11 +55,12 @@ export declare class HatchetCore {
     readonly rateLimits: RateLimitsClient;
     /** Writes task run log lines. */
     readonly logs: LogsClient;
-    /** Publishes task run stream chunks. */
+    /** Publishes task run stream chunks and durable stream topics. */
     readonly streams: StreamsClient;
     private readonly workflowsRpc;
     private readonly adminRpc;
     private readonly eventsRpc;
+    private readonly streamsRpc;
     constructor(config: CoreClientConfig);
     /** The same as `new HatchetCore(config)`, mirroring the Node client's `init`. */
     static init(config: CoreClientConfig): HatchetCore;

package/core/client.js

@@ -20,6 +20,7 @@ const fetch_transport_1 = require("../clients/transport/fetch-transport");
 const rpc_1 = require("../clients/admin/rpc");
 const trigger_request_1 = require("../clients/admin/trigger-request");
 const rpc_2 = require("../clients/event/rpc");
+const rpc_3 = require("../clients/streams/rpc");
 const workflows_1 = require("../protoc/workflows");
 const token_1 = require("../util/config-loader/token");
 const batch_1 = require("../util/batch");
@@ -81,13 +82,14 @@ class HatchetCore {
         this.workflowsRpc = (0, rpc_1.createWorkflowsRpc)(this.transport);
         this.adminRpc = (0, rpc_1.createV1AdminRpc)(this.transport);
         this.eventsRpc = (0, rpc_2.createEventsRpc)(this.transport);
+        this.streamsRpc = (0, rpc_3.createV1StreamsRpc)(this.transport);
         const shared = { logger: this.logger, namespace, retrier: config.retrier };
         this.events = new events_1.EventsClient(Object.assign({ rpc: this.eventsRpc }, shared));
         this.runs = new runs_1.RunsClient(this.adminRpc);
         this.workflows = new workflows_2.WorkflowsClient(Object.assign({ rpc: this.adminRpc }, shared));
         this.rateLimits = new rate_limits_1.RateLimitsClient(Object.assign({ rpc: this.workflowsRpc }, shared));
         this.logs = new logs_1.LogsClient(this.eventsRpc);
-        this.streams = new streams_1.StreamsClient(this.eventsRpc);
+        this.streams = new streams_1.StreamsClient({ events: this.eventsRpc, streams: this.streamsRpc });
     }
     /** The same as `new HatchetCore(config)`, mirroring the Node client's `init`. */
     static init(config) {

package/core/features/streams.d.ts

@@ -1,11 +1,76 @@
 import type { EventsServiceClient, PutStreamEventResponse } from '../../protoc/events/events';
-/** Publishes stream chunks from a task run, the way `ctx.putStream` does from a worker. */
+import type { V1StreamsClient } from '../../protoc/v1/streams';
+import type { StreamCallOptions, StreamTopicMetadata } from '../types';
+/**
+ * The largest payload one `publish` carries: the engine's limit for a payload sent inline
+ * (`MaxStreamMessagePayloadBytes`). The Node client uploads larger payloads over its REST
+ * client first; this client has none, so it rejects them.
+ */
+export declare const MAX_STREAM_MESSAGE_BYTES: number;
+export interface StreamsClientDeps {
+    events: EventsServiceClient;
+    streams: V1StreamsClient;
+}
+/**
+ * How many (namespace, topic) producers the client remembers. A topic past the cap starts
+ * over with a new producer id, which the engine orders after the old one, so correctness
+ * does not depend on the cap; it only bounds memory for clients that publish to many
+ * short-lived topics.
+ */
+export declare const MAX_TRACKED_TOPICS = 1024;
+/**
+ * Task run streams and durable stream topics.
+ *
+ * `put` publishes a chunk on a task run's stream, the way `ctx.putStream` does from a worker.
+ * `publish`, `reset` and `topicMetadata` are the Node client's durable topic calls
+ * (`hatchet.streams`), with the same names and options. `events()` is not here: it is a
+ * server stream, which the unary transport does not carry. Read a topic with the Node client
+ * (`hatchet.streams.events(topic)`), or from a serverless task over the operator socket once
+ * the operator relays the subscription.
+ */
 export declare class StreamsClient {
-    private readonly rpc;
-    constructor(rpc: EventsServiceClient);
+    /** Per (namespace, topic); the sequence number only advances after a publish succeeds. */
+    private readonly producers;
+    /**
+     * Serializes publishes per (namespace, topic) so two never share a sequence number. The
+     * stored promise always resolves, so one failure does not block later calls.
+     */
+    private readonly publishChains;
+    private readonly events;
+    private readonly streams;
+    /**
+     * Takes the events and durable streams services, or only the events service, which
+     * serves `put` and leaves the durable stream calls unavailable.
+     */
+    constructor(deps: StreamsClientDeps | EventsServiceClient);
+    private durable;
     /**
      * Publishes one chunk on a task run's stream. `index` orders chunks that are published
      * concurrently. Resolves once the engine has the chunk.
      */
     put(taskRunExternalId: string, data: string | Uint8Array, index?: number): Promise<PutStreamEventResponse>;
+    /**
+     * Publishes a message to a durable topic and resolves once it is stored. A client's
+     * messages to a topic are delivered in the order `publish` was called. A payload over
+     * `MAX_STREAM_MESSAGE_BYTES` rejects with a `HatchetError` before anything is sent.
+     * @param topic - the topic to publish to
+     * @param message - the message payload
+     * @param options - optional namespace override and abort signal
+     */
+    publish(topic: string, message: Uint8Array | string, options?: StreamCallOptions): Promise<void>;
+    /**
+     * Describes a topic's retained messages. Rejects with a `ConnectError` of code `NotFound`
+     * for a topic nothing was published to.
+     * @param topic - the topic to describe
+     * @param options - optional namespace override and abort signal
+     */
+    topicMetadata(topic: string, options?: Pick<StreamCallOptions, 'namespace' | 'signal'>): Promise<StreamTopicMetadata>;
+    /**
+     * Makes `events()` calls without a cursor start after the topic's latest message. Readers
+     * already iterating, and any call with a cursor, are unaffected.
+     * @param topic - the topic to reset
+     * @param options - optional namespace override and abort signal
+     */
+    reset(topic: string, options?: Pick<StreamCallOptions, 'namespace' | 'signal'>): Promise<void>;
+    private publishOrdered;
 }