@io-orkes/conductor-javascript 2.2.1 → 2.3.0

package/README.md

@@ -62,6 +62,14 @@ Show support for the Conductor OSS.  Please help spread the awareness by starrin
     - [Step 1: Create a MetadataClient](#step-1-create-a-metadataclient)
     - [Step 2: Define and Register a Task](#step-2-define-and-register-a-task)
     - [Step 3: Define and Register a Workflow](#step-3-define-and-register-a-workflow)
+- [Events](#events)
+  - [The EventClient](#the-eventclient)
+  - [Quick Start: Using Event Handlers](#quick-start-using-event-handlers)
+    - [Step 1: Create an EventClient](#step-1-create-an-eventclient)
+    - [Step 2: Register an Event Handler](#step-2-register-an-event-handler)
+    - [Step 3: Publish Events](#step-3-publish-events)
+    - [Step 4: Monitor Event Processing](#step-4-monitor-event-processing)
+    - [Step 5: Manage Event Handlers](#step-5-manage-event-handlers)
 - [Human Tasks](#human-tasks)
   - [The HumanExecutor and TemplateClient](#the-humanexecutor-and-templateclient)
   - [Quick Start: Creating and Managing a Human Task](#quick-start-creating-and-managing-a-human-task)
@@ -716,6 +724,110 @@ await metadataClient.registerWorkflowDef(wf);
 
 For a complete method reference, see the [MetadataClient API Reference](docs/api-reference/metadata-client.md).
 
+## Events
+
+Event handlers in Conductor allow you to automatically trigger actions (like starting workflows) when events are received. This enables event-driven workflows and integrations with external systems.
+
+### The EventClient
+
+The `EventClient` manages event handlers and event processing. For a complete method reference, see the [EventClient API Reference](docs/api-reference/event-client.md).
+
+### Quick Start: Using Event Handlers
+
+Here's how to set up event-driven workflows:
+
+#### Step 1: Create an EventClient
+
+First, create an instance of the `EventClient`:
+
+```typescript
+import { EventClient } from "@io-orkes/conductor-javascript";
+
+const eventClient = new EventClient(client);
+```
+
+#### Step 2: Register an Event Handler
+
+Create an event handler that defines what action to take when an event is received. In this example, we'll start a workflow when an order is created:
+
+```typescript
+await eventClient.addEventHandler({
+  name: "order_created_handler",
+  event: "order.created",
+  active: true,
+  description: "Starts fulfillment workflow when order is created",
+  actions: [
+    {
+      action: "start_workflow",
+      start_workflow: {
+        name: "fulfill_order",
+        version: 1,
+        input: {
+          orderId: "${event.orderId}",
+          customerId: "${event.customerId}",
+        },
+      },
+    },
+  ],
+});
+```
+
+#### Step 3: Publish Events
+
+When an event occurs, publish it to Conductor. All active handlers registered for that event will be triggered:
+
+```typescript
+await eventClient.handleIncomingEvent({
+  event: "order.created",
+  orderId: "ORDER-123",
+  customerId: "CUST-456",
+  amount: "99.99",
+  timestamp: Date.now().toString(),
+});
+```
+
+#### Step 4: Monitor Event Processing
+
+You can monitor event handlers and their execution history:
+
+```typescript
+// Get all handlers for a specific event
+const handlers = await eventClient.getEventHandlersForEvent("order.created");
+
+// Get execution history for a handler
+const executions = await eventClient.getEventExecutions("order_created_handler");
+
+// Get event messages
+const messages = await eventClient.getEventMessages("order.created");
+```
+
+#### Step 5: Manage Event Handlers
+
+Update, deactivate, or remove event handlers as needed:
+
+```typescript
+// Update a handler
+await eventClient.updateEventHandler({
+  name: "order_created_handler",
+  active: false, // Deactivate
+  // ... other fields
+});
+
+// Remove a handler
+await eventClient.removeEventHandler("order_created_handler");
+```
+
+**Event Handler Actions:**
+
+Event handlers support various actions:
+- `start_workflow` - Start a workflow execution
+- `complete_task` - Complete a specific task
+- `fail_task` - Fail a specific task
+- `terminate_workflow` - Terminate a workflow
+- `update_workflow_variables` - Update workflow variables
+
+For a complete method reference, see the [EventClient API Reference](docs/api-reference/event-client.md).
+
 ## Human Tasks
 
 Human tasks integrate human interaction into your automated workflows. They pause a workflow until a person provides input, such as an approval, a correction, or additional information.

package/dist/index.d.mts

@@ -74,6 +74,17 @@ type CircuitBreakerTransitionResponse = {
 type Config$2 = {
     circuitBreakerConfig?: OrkesCircuitBreakerConfig;
 };
+type ConnectivityTestInput = {
+    input?: {
+        [key: string]: unknown;
+    };
+    sink: string;
+};
+type ConnectivityTestResult = {
+    reason?: string;
+    successful?: boolean;
+    workflowId?: string;
+};
 type Declaration = {
     allFields?: {
         [key: string]: unknown;
@@ -452,6 +463,41 @@ type EventHandler = {
     orgId?: string;
     tags?: Array<Tag>;
 };
+type EventMessage = {
+    createdAt?: number;
+    eventExecutions?: Array<ExtendedEventExecution>;
+    eventTarget?: string;
+    eventType?: 'WEBHOOK' | 'MESSAGE';
+    fullPayload?: {
+        [key: string]: unknown;
+    };
+    id?: string;
+    orgId?: string;
+    payload?: string;
+    status?: 'RECEIVED' | 'HANDLED' | 'REJECTED';
+    statusDescription?: string;
+};
+type ExtendedEventExecution = {
+    action?: 'start_workflow' | 'complete_task' | 'fail_task' | 'terminate_workflow' | 'update_workflow_variables';
+    created?: number;
+    event?: string;
+    eventHandler?: EventHandler;
+    fullMessagePayload?: {
+        [key: string]: unknown;
+    };
+    id?: string;
+    messageId?: string;
+    name?: string;
+    orgId?: string;
+    output?: {
+        [key: string]: unknown;
+    };
+    payload?: {
+        [key: string]: unknown;
+    };
+    status?: 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'SKIPPED';
+    statusDescription?: string;
+};
 type ExtendedTaskDef$1 = {
     backoffScaleFactor?: number;
     baseType?: string;
@@ -953,6 +999,13 @@ type GenerateTokenRequest = {
     keyId: string;
     keySecret: string;
 };
+type HandledEventResponse = {
+    active?: boolean;
+    event?: string;
+    name?: string;
+    numberOfActions?: number;
+    numberOfMessages?: number;
+};
 type HumanTaskAssignment = {
     assignee?: HumanTaskUser;
     slaMinutes?: number;
@@ -1553,6 +1606,10 @@ type ScrollableSearchResultWorkflowSummary = {
     results?: Array<WorkflowSummary>;
     totalHits?: number;
 };
+type SearchResultHandledEventResponse = {
+    results?: Array<HandledEventResponse>;
+    totalHits?: number;
+};
 type SearchResultTaskSummary = {
     results?: Array<TaskSummary>;
     totalHits?: number;
@@ -3608,6 +3665,172 @@ declare class MetadataClient {
     unregisterWorkflow(workflowName: string, version?: number): Promise<void>;
 }
 
+declare class EventClient {
+    readonly _client: Client;
+    constructor(client: Client);
+    /**
+     * Get all the event handlers
+     * @returns {Promise<EventHandler[]>}
+     * @throws {ConductorSdkError}
+     */
+    getAllEventHandlers(): Promise<EventHandler[]>;
+    /**
+     * Add event handlers
+     * @param {EventHandler[]} eventHandlers
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    addEventHandlers(eventHandlers: EventHandler[]): Promise<void>;
+    /**
+     * Add an event handler
+     * @param {EventHandler} eventHandler
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    addEventHandler(eventHandler: EventHandler): Promise<void>;
+    /**
+     * Update an event handler
+     * @param {EventHandler} eventHandler
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    updateEventHandler(eventHandler: EventHandler): Promise<void>;
+    /**
+     * Handle an incoming event
+     * @param {Record<string, string>} data
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    handleIncomingEvent(data: Record<string, string>): Promise<void>;
+    /**
+     * Get an event handler by name
+     * @param {string} eventHandlerName
+     * @returns {Promise<EventHandler>}
+     * @throws {ConductorSdkError}
+     */
+    getEventHandlerByName(eventHandlerName: string): Promise<EventHandler>;
+    /**
+     * Get all queue configs
+     * @returns {Promise<Record<string, string>>}
+     * @throws {ConductorSdkError}
+     */
+    getAllQueueConfigs(): Promise<Record<string, string>>;
+    /**
+     * Delete queue config
+     * @param {string} queueType
+     * @param {string} queueName
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    deleteQueueConfig(queueType: string, queueName: string): Promise<void>;
+    /**
+     * Get queue config
+     * @param {string} queueType
+     * @param {string} queueName
+     * @returns {Promise<Record<string, unknown>>}
+     * @throws {ConductorSdkError}
+     */
+    getQueueConfig(queueType: string, queueName: string): Promise<Record<string, unknown>>;
+    /**
+     * Get event handlers for a given event
+     * @param {string} event
+     * @param {boolean} [activeOnly=false] Only return active handlers.
+     * @returns {Promise<EventHandler[]>}
+     * @throws {ConductorSdkError}
+     */
+    getEventHandlersForEvent(event: string, activeOnly?: boolean): Promise<EventHandler[]>;
+    /**
+     * Remove an event handler by name
+     * @param {string} name
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    removeEventHandler(name: string): Promise<void>;
+    /**
+     * Get tags for an event handler
+     * @param {string} name
+     * @returns {Promise<Tag[]>}
+     * @throws {ConductorSdkError}
+     */
+    getTagsForEventHandler(name: string): Promise<Tag[]>;
+    /**
+     * Put tags for an event handler
+     * @param {string} name
+     * @param {Tag[]} tags
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    putTagForEventHandler(name: string, tags: Tag[]): Promise<void>;
+    /**
+     * Delete tags for an event handler
+     * @param {string} name
+     * @param {Tag[]} tags
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    deleteTagsForEventHandler(name: string, tags: Tag[]): Promise<void>;
+    /**
+     * Delete a tag for an event handler
+     * @param {string} name
+     * @param {Tag} tag
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    deleteTagForEventHandler(name: string, tag: Tag): Promise<void>;
+    /**
+     * Test connectivity for a given queue using a workflow with EVENT task and an EventHandler
+     * @param {ConnectivityTestInput} input
+     * @returns {Promise<ConnectivityTestResult>}
+     * @throws {ConductorSdkError}
+     */
+    testConnectivity(input: ConnectivityTestInput): Promise<ConnectivityTestResult>;
+    /**
+     * Create or update queue config by name
+     * @deprecated Prefer server's newer endpoints if available
+     * @param {string} queueType
+     * @param {string} queueName
+     * @param {string} config
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    putQueueConfig(queueType: string, queueName: string, config: string): Promise<void>;
+    /**
+     * Test endpoint (as exposed by API)
+     * @returns {Promise<EventHandler>}
+     * @throws {ConductorSdkError}
+     */
+    test(): Promise<EventHandler>;
+    /**
+     * Get all active event handlers (execution view)
+     * @returns {Promise<SearchResultHandledEventResponse>}
+     * @throws {ConductorSdkError}
+     */
+    getAllActiveEventHandlers(): Promise<SearchResultHandledEventResponse>;
+    /**
+     * Get event executions for a specific handler
+     * @param {string} eventHandlerName
+     * @param {number} [from] Pagination cursor
+     * @returns {Promise<ExtendedEventExecution[]>}
+     * @throws {ConductorSdkError}
+     */
+    getEventExecutions(eventHandlerName: string, from?: number): Promise<ExtendedEventExecution[]>;
+    /**
+     * Get all event handlers with statistics (messages view)
+     * @param {number} [from] Pagination cursor
+     * @returns {Promise<SearchResultHandledEventResponse>}
+     * @throws {ConductorSdkError}
+     */
+    getEventHandlersWithStats(from?: number): Promise<SearchResultHandledEventResponse>;
+    /**
+     * Get event messages for a given event
+     * @param {string} event
+     * @param {number} [from] Pagination cursor
+     * @returns {Promise<EventMessage[]>}
+     * @throws {ConductorSdkError}
+     */
+    getEventMessages(event: string, from?: number): Promise<EventMessage[]>;
+}
+
 interface OrkesApiConfig {
     serverUrl?: string;
     keyId?: string;
@@ -3827,4 +4050,4 @@ declare const orkesConductorClient: (config?: OrkesApiConfig, customFetch?: type
     interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
 }>;
 
-export { type Action, ApiError, type ApiRequestOptions, type ApiResult, type Auth, BaseHttpRequest, CancelError, CancelablePromise, type CircuitBreakerTransitionResponse, type Client, type ClientOptions, type CommonTaskDef, type ConductorClient, type ConductorLogLevel, type ConductorLogger, ConductorSdkError, type ConductorWorker, type Config, Consistency, DefaultLogger, type DefaultLoggerConfig, type DoWhileTaskDef, type EnhancedSignalResponse, type EventHandler, type EventTaskDef, type ExtendedTaskDef, type ExtendedWorkflowDef, type ExternalStorageLocation, type ForkJoinDynamicDef, type ForkJoinTaskDef, type GenerateTokenRequest, type HTScrollableSearchResultHumanTaskEntry, type HttpInputParameters, type HttpTaskDef, HumanExecutor, type HumanTaskAssignment, type HumanTaskDefinition, type HumanTaskEntry, type HumanTaskSearch, type HumanTaskSearchResult, type HumanTaskTemplate, type HumanTaskTrigger, type HumanTaskUser, type InlineTaskDef, type InlineTaskInputParameters, type JoinTaskDef, type JsonJQTransformTaskDef, type KafkaPublishInputParameters, type KafkaPublishTaskDef, MAX_RETRIES, MetadataClient, type Middleware, type OnCancel, type OpenAPIConfig, type OrkesApiConfig, type PollData, type ProtoRegistryEntry, type QuerySerializerOptions, type RequestOptions, type RerunWorkflowRequest, type ResolvedRequestOptions, type Response$1 as Response, ReturnStrategy, type RunnerArgs, type SaveScheduleRequest, SchedulerClient, type ScrollableSearchResultWorkflowSummary, type SearchResultTask, type SearchResultTaskSummary, type SearchResultWorkflow, type SearchResultWorkflowScheduleExecutionModel, type SearchResultWorkflowSummary, type ServiceMethod, type ServiceRegistry, ServiceType, type SetVariableTaskDef, type SignalResponse, type SimpleTaskDef, type SkipTaskRequest, type StartWorkflow, type StartWorkflowRequest, type StreamEvent, type SubWorkflowParams, type SubWorkflowTaskDef, type SwitchTaskDef, type Task, TaskClient, type TaskDef, type TaskDefTypes, type TaskDetails, type TaskErrorHandler, type TaskExecLog, type TaskFinderPredicate, type TaskListSearchResultSummary, TaskManager, type TaskManagerConfig, type TaskManagerOptions, type TaskResult, type TaskResultOutputData, type TaskResultStatus, TaskResultStatusEnum, TaskRunner, type TaskRunnerOptions, type TaskSummary, TaskType, TemplateClient, type Terminate, type TerminateTaskDef, type TimeoutPolicy, type UserFormTemplate, type WaitTaskDef, type Workflow, type WorkflowDef$1 as WorkflowDef, WorkflowExecutor, type WorkflowRun, type WorkflowSchedule, type WorkflowScheduleExecutionModel, type WorkflowScheduleModel, type WorkflowStatus, type WorkflowSummary, type WorkflowTask, completedTaskMatchingType, conductorEventTask, doWhileTask, dynamicForkTask, eventTask, forkTask, forkTaskJoin, generate, generateDoWhileTask, generateEventTask, generateForkJoinTask, generateHTTPTask, generateInlineTask, generateJQTransformTask, generateJoinTask, generateKafkaPublishTask, generateSetVariableTask, generateSimpleTask, generateSubWorkflowTask, generateSwitchTask, generateTerminateTask, generateWaitTask, httpTask, inlineTask, joinTask, jsonJqTask, kafkaPublishTask, newLoopTask, noopErrorHandler, noopLogger, orkesConductorClient, setVariableTask, simpleTask, sqsEventTask, subWorkflowTask, switchTask, taskDefinition, taskGenMapper, terminateTask, waitTaskDuration, waitTaskUntil, workflow };
+export { type Action, ApiError, type ApiRequestOptions, type ApiResult, type Auth, BaseHttpRequest, CancelError, CancelablePromise, type CircuitBreakerTransitionResponse, type Client, type ClientOptions, type CommonTaskDef, type ConductorClient, type ConductorLogLevel, type ConductorLogger, ConductorSdkError, type ConductorWorker, type Config, type ConnectivityTestInput, type ConnectivityTestResult, Consistency, DefaultLogger, type DefaultLoggerConfig, type DoWhileTaskDef, type EnhancedSignalResponse, EventClient, type EventHandler, type EventMessage, type EventTaskDef, type ExtendedEventExecution, type ExtendedTaskDef, type ExtendedWorkflowDef, type ExternalStorageLocation, type ForkJoinDynamicDef, type ForkJoinTaskDef, type GenerateTokenRequest, type HTScrollableSearchResultHumanTaskEntry, type HttpInputParameters, type HttpTaskDef, HumanExecutor, type HumanTaskAssignment, type HumanTaskDefinition, type HumanTaskEntry, type HumanTaskSearch, type HumanTaskSearchResult, type HumanTaskTemplate, type HumanTaskTrigger, type HumanTaskUser, type InlineTaskDef, type InlineTaskInputParameters, type JoinTaskDef, type JsonJQTransformTaskDef, type KafkaPublishInputParameters, type KafkaPublishTaskDef, MAX_RETRIES, MetadataClient, type Middleware, type OnCancel, type OpenAPIConfig, type OrkesApiConfig, type PollData, type ProtoRegistryEntry, type QuerySerializerOptions, type RequestOptions, type RerunWorkflowRequest, type ResolvedRequestOptions, type Response$1 as Response, ReturnStrategy, type RunnerArgs, type SaveScheduleRequest, SchedulerClient, type ScrollableSearchResultWorkflowSummary, type SearchResultHandledEventResponse, type SearchResultTask, type SearchResultTaskSummary, type SearchResultWorkflow, type SearchResultWorkflowScheduleExecutionModel, type SearchResultWorkflowSummary, type ServiceMethod, type ServiceRegistry, ServiceType, type SetVariableTaskDef, type SignalResponse, type SimpleTaskDef, type SkipTaskRequest, type StartWorkflow, type StartWorkflowRequest, type StreamEvent, type SubWorkflowParams, type SubWorkflowTaskDef, type SwitchTaskDef, type Tag, type Task, TaskClient, type TaskDef, type TaskDefTypes, type TaskDetails, type TaskErrorHandler, type TaskExecLog, type TaskFinderPredicate, type TaskListSearchResultSummary, TaskManager, type TaskManagerConfig, type TaskManagerOptions, type TaskResult, type TaskResultOutputData, type TaskResultStatus, TaskResultStatusEnum, TaskRunner, type TaskRunnerOptions, type TaskSummary, TaskType, TemplateClient, type Terminate, type TerminateTaskDef, type TimeoutPolicy, type UserFormTemplate, type WaitTaskDef, type Workflow, type WorkflowDef$1 as WorkflowDef, WorkflowExecutor, type WorkflowRun, type WorkflowSchedule, type WorkflowScheduleExecutionModel, type WorkflowScheduleModel, type WorkflowStatus, type WorkflowSummary, type WorkflowTask, completedTaskMatchingType, conductorEventTask, doWhileTask, dynamicForkTask, eventTask, forkTask, forkTaskJoin, generate, generateDoWhileTask, generateEventTask, generateForkJoinTask, generateHTTPTask, generateInlineTask, generateJQTransformTask, generateJoinTask, generateKafkaPublishTask, generateSetVariableTask, generateSimpleTask, generateSubWorkflowTask, generateSwitchTask, generateTerminateTask, generateWaitTask, httpTask, inlineTask, joinTask, jsonJqTask, kafkaPublishTask, newLoopTask, noopErrorHandler, noopLogger, orkesConductorClient, setVariableTask, simpleTask, sqsEventTask, subWorkflowTask, switchTask, taskDefinition, taskGenMapper, terminateTask, waitTaskDuration, waitTaskUntil, workflow };

package/dist/index.d.ts

@@ -74,6 +74,17 @@ type CircuitBreakerTransitionResponse = {
 type Config$2 = {
     circuitBreakerConfig?: OrkesCircuitBreakerConfig;
 };
+type ConnectivityTestInput = {
+    input?: {
+        [key: string]: unknown;
+    };
+    sink: string;
+};
+type ConnectivityTestResult = {
+    reason?: string;
+    successful?: boolean;
+    workflowId?: string;
+};
 type Declaration = {
     allFields?: {
         [key: string]: unknown;
@@ -452,6 +463,41 @@ type EventHandler = {
     orgId?: string;
     tags?: Array<Tag>;
 };
+type EventMessage = {
+    createdAt?: number;
+    eventExecutions?: Array<ExtendedEventExecution>;
+    eventTarget?: string;
+    eventType?: 'WEBHOOK' | 'MESSAGE';
+    fullPayload?: {
+        [key: string]: unknown;
+    };
+    id?: string;
+    orgId?: string;
+    payload?: string;
+    status?: 'RECEIVED' | 'HANDLED' | 'REJECTED';
+    statusDescription?: string;
+};
+type ExtendedEventExecution = {
+    action?: 'start_workflow' | 'complete_task' | 'fail_task' | 'terminate_workflow' | 'update_workflow_variables';
+    created?: number;
+    event?: string;
+    eventHandler?: EventHandler;
+    fullMessagePayload?: {
+        [key: string]: unknown;
+    };
+    id?: string;
+    messageId?: string;
+    name?: string;
+    orgId?: string;
+    output?: {
+        [key: string]: unknown;
+    };
+    payload?: {
+        [key: string]: unknown;
+    };
+    status?: 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'SKIPPED';
+    statusDescription?: string;
+};
 type ExtendedTaskDef$1 = {
     backoffScaleFactor?: number;
     baseType?: string;
@@ -953,6 +999,13 @@ type GenerateTokenRequest = {
     keyId: string;
     keySecret: string;
 };
+type HandledEventResponse = {
+    active?: boolean;
+    event?: string;
+    name?: string;
+    numberOfActions?: number;
+    numberOfMessages?: number;
+};
 type HumanTaskAssignment = {
     assignee?: HumanTaskUser;
     slaMinutes?: number;
@@ -1553,6 +1606,10 @@ type ScrollableSearchResultWorkflowSummary = {
     results?: Array<WorkflowSummary>;
     totalHits?: number;
 };
+type SearchResultHandledEventResponse = {
+    results?: Array<HandledEventResponse>;
+    totalHits?: number;
+};
 type SearchResultTaskSummary = {
     results?: Array<TaskSummary>;
     totalHits?: number;
@@ -3608,6 +3665,172 @@ declare class MetadataClient {
     unregisterWorkflow(workflowName: string, version?: number): Promise<void>;
 }
 
+declare class EventClient {
+    readonly _client: Client;
+    constructor(client: Client);
+    /**
+     * Get all the event handlers
+     * @returns {Promise<EventHandler[]>}
+     * @throws {ConductorSdkError}
+     */
+    getAllEventHandlers(): Promise<EventHandler[]>;
+    /**
+     * Add event handlers
+     * @param {EventHandler[]} eventHandlers
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    addEventHandlers(eventHandlers: EventHandler[]): Promise<void>;
+    /**
+     * Add an event handler
+     * @param {EventHandler} eventHandler
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    addEventHandler(eventHandler: EventHandler): Promise<void>;
+    /**
+     * Update an event handler
+     * @param {EventHandler} eventHandler
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    updateEventHandler(eventHandler: EventHandler): Promise<void>;
+    /**
+     * Handle an incoming event
+     * @param {Record<string, string>} data
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    handleIncomingEvent(data: Record<string, string>): Promise<void>;
+    /**
+     * Get an event handler by name
+     * @param {string} eventHandlerName
+     * @returns {Promise<EventHandler>}
+     * @throws {ConductorSdkError}
+     */
+    getEventHandlerByName(eventHandlerName: string): Promise<EventHandler>;
+    /**
+     * Get all queue configs
+     * @returns {Promise<Record<string, string>>}
+     * @throws {ConductorSdkError}
+     */
+    getAllQueueConfigs(): Promise<Record<string, string>>;
+    /**
+     * Delete queue config
+     * @param {string} queueType
+     * @param {string} queueName
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    deleteQueueConfig(queueType: string, queueName: string): Promise<void>;
+    /**
+     * Get queue config
+     * @param {string} queueType
+     * @param {string} queueName
+     * @returns {Promise<Record<string, unknown>>}
+     * @throws {ConductorSdkError}
+     */
+    getQueueConfig(queueType: string, queueName: string): Promise<Record<string, unknown>>;
+    /**
+     * Get event handlers for a given event
+     * @param {string} event
+     * @param {boolean} [activeOnly=false] Only return active handlers.
+     * @returns {Promise<EventHandler[]>}
+     * @throws {ConductorSdkError}
+     */
+    getEventHandlersForEvent(event: string, activeOnly?: boolean): Promise<EventHandler[]>;
+    /**
+     * Remove an event handler by name
+     * @param {string} name
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    removeEventHandler(name: string): Promise<void>;
+    /**
+     * Get tags for an event handler
+     * @param {string} name
+     * @returns {Promise<Tag[]>}
+     * @throws {ConductorSdkError}
+     */
+    getTagsForEventHandler(name: string): Promise<Tag[]>;
+    /**
+     * Put tags for an event handler
+     * @param {string} name
+     * @param {Tag[]} tags
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    putTagForEventHandler(name: string, tags: Tag[]): Promise<void>;
+    /**
+     * Delete tags for an event handler
+     * @param {string} name
+     * @param {Tag[]} tags
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    deleteTagsForEventHandler(name: string, tags: Tag[]): Promise<void>;
+    /**
+     * Delete a tag for an event handler
+     * @param {string} name
+     * @param {Tag} tag
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    deleteTagForEventHandler(name: string, tag: Tag): Promise<void>;
+    /**
+     * Test connectivity for a given queue using a workflow with EVENT task and an EventHandler
+     * @param {ConnectivityTestInput} input
+     * @returns {Promise<ConnectivityTestResult>}
+     * @throws {ConductorSdkError}
+     */
+    testConnectivity(input: ConnectivityTestInput): Promise<ConnectivityTestResult>;
+    /**
+     * Create or update queue config by name
+     * @deprecated Prefer server's newer endpoints if available
+     * @param {string} queueType
+     * @param {string} queueName
+     * @param {string} config
+     * @returns {Promise<void>}
+     * @throws {ConductorSdkError}
+     */
+    putQueueConfig(queueType: string, queueName: string, config: string): Promise<void>;
+    /**
+     * Test endpoint (as exposed by API)
+     * @returns {Promise<EventHandler>}
+     * @throws {ConductorSdkError}
+     */
+    test(): Promise<EventHandler>;
+    /**
+     * Get all active event handlers (execution view)
+     * @returns {Promise<SearchResultHandledEventResponse>}
+     * @throws {ConductorSdkError}
+     */
+    getAllActiveEventHandlers(): Promise<SearchResultHandledEventResponse>;
+    /**
+     * Get event executions for a specific handler
+     * @param {string} eventHandlerName
+     * @param {number} [from] Pagination cursor
+     * @returns {Promise<ExtendedEventExecution[]>}
+     * @throws {ConductorSdkError}
+     */
+    getEventExecutions(eventHandlerName: string, from?: number): Promise<ExtendedEventExecution[]>;
+    /**
+     * Get all event handlers with statistics (messages view)
+     * @param {number} [from] Pagination cursor
+     * @returns {Promise<SearchResultHandledEventResponse>}
+     * @throws {ConductorSdkError}
+     */
+    getEventHandlersWithStats(from?: number): Promise<SearchResultHandledEventResponse>;
+    /**
+     * Get event messages for a given event
+     * @param {string} event
+     * @param {number} [from] Pagination cursor
+     * @returns {Promise<EventMessage[]>}
+     * @throws {ConductorSdkError}
+     */
+    getEventMessages(event: string, from?: number): Promise<EventMessage[]>;
+}
+
 interface OrkesApiConfig {
     serverUrl?: string;
     keyId?: string;
@@ -3827,4 +4050,4 @@ declare const orkesConductorClient: (config?: OrkesApiConfig, customFetch?: type
     interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
 }>;
 
-export { type Action, ApiError, type ApiRequestOptions, type ApiResult, type Auth, BaseHttpRequest, CancelError, CancelablePromise, type CircuitBreakerTransitionResponse, type Client, type ClientOptions, type CommonTaskDef, type ConductorClient, type ConductorLogLevel, type ConductorLogger, ConductorSdkError, type ConductorWorker, type Config, Consistency, DefaultLogger, type DefaultLoggerConfig, type DoWhileTaskDef, type EnhancedSignalResponse, type EventHandler, type EventTaskDef, type ExtendedTaskDef, type ExtendedWorkflowDef, type ExternalStorageLocation, type ForkJoinDynamicDef, type ForkJoinTaskDef, type GenerateTokenRequest, type HTScrollableSearchResultHumanTaskEntry, type HttpInputParameters, type HttpTaskDef, HumanExecutor, type HumanTaskAssignment, type HumanTaskDefinition, type HumanTaskEntry, type HumanTaskSearch, type HumanTaskSearchResult, type HumanTaskTemplate, type HumanTaskTrigger, type HumanTaskUser, type InlineTaskDef, type InlineTaskInputParameters, type JoinTaskDef, type JsonJQTransformTaskDef, type KafkaPublishInputParameters, type KafkaPublishTaskDef, MAX_RETRIES, MetadataClient, type Middleware, type OnCancel, type OpenAPIConfig, type OrkesApiConfig, type PollData, type ProtoRegistryEntry, type QuerySerializerOptions, type RequestOptions, type RerunWorkflowRequest, type ResolvedRequestOptions, type Response$1 as Response, ReturnStrategy, type RunnerArgs, type SaveScheduleRequest, SchedulerClient, type ScrollableSearchResultWorkflowSummary, type SearchResultTask, type SearchResultTaskSummary, type SearchResultWorkflow, type SearchResultWorkflowScheduleExecutionModel, type SearchResultWorkflowSummary, type ServiceMethod, type ServiceRegistry, ServiceType, type SetVariableTaskDef, type SignalResponse, type SimpleTaskDef, type SkipTaskRequest, type StartWorkflow, type StartWorkflowRequest, type StreamEvent, type SubWorkflowParams, type SubWorkflowTaskDef, type SwitchTaskDef, type Task, TaskClient, type TaskDef, type TaskDefTypes, type TaskDetails, type TaskErrorHandler, type TaskExecLog, type TaskFinderPredicate, type TaskListSearchResultSummary, TaskManager, type TaskManagerConfig, type TaskManagerOptions, type TaskResult, type TaskResultOutputData, type TaskResultStatus, TaskResultStatusEnum, TaskRunner, type TaskRunnerOptions, type TaskSummary, TaskType, TemplateClient, type Terminate, type TerminateTaskDef, type TimeoutPolicy, type UserFormTemplate, type WaitTaskDef, type Workflow, type WorkflowDef$1 as WorkflowDef, WorkflowExecutor, type WorkflowRun, type WorkflowSchedule, type WorkflowScheduleExecutionModel, type WorkflowScheduleModel, type WorkflowStatus, type WorkflowSummary, type WorkflowTask, completedTaskMatchingType, conductorEventTask, doWhileTask, dynamicForkTask, eventTask, forkTask, forkTaskJoin, generate, generateDoWhileTask, generateEventTask, generateForkJoinTask, generateHTTPTask, generateInlineTask, generateJQTransformTask, generateJoinTask, generateKafkaPublishTask, generateSetVariableTask, generateSimpleTask, generateSubWorkflowTask, generateSwitchTask, generateTerminateTask, generateWaitTask, httpTask, inlineTask, joinTask, jsonJqTask, kafkaPublishTask, newLoopTask, noopErrorHandler, noopLogger, orkesConductorClient, setVariableTask, simpleTask, sqsEventTask, subWorkflowTask, switchTask, taskDefinition, taskGenMapper, terminateTask, waitTaskDuration, waitTaskUntil, workflow };
+export { type Action, ApiError, type ApiRequestOptions, type ApiResult, type Auth, BaseHttpRequest, CancelError, CancelablePromise, type CircuitBreakerTransitionResponse, type Client, type ClientOptions, type CommonTaskDef, type ConductorClient, type ConductorLogLevel, type ConductorLogger, ConductorSdkError, type ConductorWorker, type Config, type ConnectivityTestInput, type ConnectivityTestResult, Consistency, DefaultLogger, type DefaultLoggerConfig, type DoWhileTaskDef, type EnhancedSignalResponse, EventClient, type EventHandler, type EventMessage, type EventTaskDef, type ExtendedEventExecution, type ExtendedTaskDef, type ExtendedWorkflowDef, type ExternalStorageLocation, type ForkJoinDynamicDef, type ForkJoinTaskDef, type GenerateTokenRequest, type HTScrollableSearchResultHumanTaskEntry, type HttpInputParameters, type HttpTaskDef, HumanExecutor, type HumanTaskAssignment, type HumanTaskDefinition, type HumanTaskEntry, type HumanTaskSearch, type HumanTaskSearchResult, type HumanTaskTemplate, type HumanTaskTrigger, type HumanTaskUser, type InlineTaskDef, type InlineTaskInputParameters, type JoinTaskDef, type JsonJQTransformTaskDef, type KafkaPublishInputParameters, type KafkaPublishTaskDef, MAX_RETRIES, MetadataClient, type Middleware, type OnCancel, type OpenAPIConfig, type OrkesApiConfig, type PollData, type ProtoRegistryEntry, type QuerySerializerOptions, type RequestOptions, type RerunWorkflowRequest, type ResolvedRequestOptions, type Response$1 as Response, ReturnStrategy, type RunnerArgs, type SaveScheduleRequest, SchedulerClient, type ScrollableSearchResultWorkflowSummary, type SearchResultHandledEventResponse, type SearchResultTask, type SearchResultTaskSummary, type SearchResultWorkflow, type SearchResultWorkflowScheduleExecutionModel, type SearchResultWorkflowSummary, type ServiceMethod, type ServiceRegistry, ServiceType, type SetVariableTaskDef, type SignalResponse, type SimpleTaskDef, type SkipTaskRequest, type StartWorkflow, type StartWorkflowRequest, type StreamEvent, type SubWorkflowParams, type SubWorkflowTaskDef, type SwitchTaskDef, type Tag, type Task, TaskClient, type TaskDef, type TaskDefTypes, type TaskDetails, type TaskErrorHandler, type TaskExecLog, type TaskFinderPredicate, type TaskListSearchResultSummary, TaskManager, type TaskManagerConfig, type TaskManagerOptions, type TaskResult, type TaskResultOutputData, type TaskResultStatus, TaskResultStatusEnum, TaskRunner, type TaskRunnerOptions, type TaskSummary, TaskType, TemplateClient, type Terminate, type TerminateTaskDef, type TimeoutPolicy, type UserFormTemplate, type WaitTaskDef, type Workflow, type WorkflowDef$1 as WorkflowDef, WorkflowExecutor, type WorkflowRun, type WorkflowSchedule, type WorkflowScheduleExecutionModel, type WorkflowScheduleModel, type WorkflowStatus, type WorkflowSummary, type WorkflowTask, completedTaskMatchingType, conductorEventTask, doWhileTask, dynamicForkTask, eventTask, forkTask, forkTaskJoin, generate, generateDoWhileTask, generateEventTask, generateForkJoinTask, generateHTTPTask, generateInlineTask, generateJQTransformTask, generateJoinTask, generateKafkaPublishTask, generateSetVariableTask, generateSimpleTask, generateSubWorkflowTask, generateSwitchTask, generateTerminateTask, generateWaitTask, httpTask, inlineTask, joinTask, jsonJqTask, kafkaPublishTask, newLoopTask, noopErrorHandler, noopLogger, orkesConductorClient, setVariableTask, simpleTask, sqsEventTask, subWorkflowTask, switchTask, taskDefinition, taskGenMapper, terminateTask, waitTaskDuration, waitTaskUntil, workflow };