@temporalio/client 1.4.3 → 1.5.0

package/lib/schedule-types.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduleOverlapPolicy = exports.DAYS_OF_WEEK = exports.MONTHS = void 0;
+const type_helpers_1 = require("@temporalio/common/lib/type-helpers");
+// Invariant: An existing ScheduleDescription can be used as template to create a new Schedule
+(0, type_helpers_1.checkExtends)();
+// Invariant: An existing ScheduleDescription can be used as template to update that Schedule
+(0, type_helpers_1.checkExtends)();
+// Invariant: An existing ScheduleSpec can be used as is to create or update a Schedule
+(0, type_helpers_1.checkExtends)();
+/** @experimental */
+exports.MONTHS = [
+    'JANUARY',
+    'FEBRUARY',
+    'MARCH',
+    'APRIL',
+    'MAY',
+    'JUNE',
+    'JULY',
+    'AUGUST',
+    'SEPTEMBER',
+    'OCTOBER',
+    'NOVEMBER',
+    'DECEMBER',
+];
+/** @experimental */
+exports.DAYS_OF_WEEK = ['SUNDAY', 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY'];
+// Invariant: an existing ScheduleDescriptionAction can be used as is to create or update a schedule
+(0, type_helpers_1.checkExtends)();
+/**
+ * Policy for overlapping Actions.
+ *
+ * @experimental
+ */
+var ScheduleOverlapPolicy;
+(function (ScheduleOverlapPolicy) {
+    /**
+     * Use server default (currently SKIP).
+     *
+     * FIXME: remove this field if this issue is implemented: https://github.com/temporalio/temporal/issues/3240
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Don't start a new Action.
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["SKIP"] = 1] = "SKIP";
+    /**
+     * Start another Action as soon as the current Action completes, but only buffer one Action in this way. If another
+     * Action is supposed to start, but one Action is running and one is already buffered, then only the buffered one will
+     * be started after the running Action finishes.
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["BUFFER_ONE"] = 2] = "BUFFER_ONE";
+    /**
+     * Allows an unlimited number of Actions to buffer. They are started sequentially.
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["BUFFER_ALL"] = 3] = "BUFFER_ALL";
+    /**
+     * Cancels the running Action, and then starts the new Action once the cancelled one completes.
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["CANCEL_OTHER"] = 4] = "CANCEL_OTHER";
+    /**
+     * Terminate the running Action and start the new Action immediately.
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["TERMINATE_OTHER"] = 5] = "TERMINATE_OTHER";
+    /**
+     * Allow any number of Actions to start immediately.
+     *
+     * This is the only policy under which multiple Actions can run concurrently.
+     */
+    ScheduleOverlapPolicy[ScheduleOverlapPolicy["ALLOW_ALL"] = 6] = "ALLOW_ALL";
+})(ScheduleOverlapPolicy = exports.ScheduleOverlapPolicy || (exports.ScheduleOverlapPolicy = {}));
+(0, type_helpers_1.checkExtends)();
+(0, type_helpers_1.checkExtends)();
+//# sourceMappingURL=schedule-types.js.map

package/lib/schedule-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-types.js","sourceRoot":"","sources":["../src/schedule-types.ts"],"names":[],"mappings":";;;AAAA,sEAA+F;AAoU/F,8FAA8F;AAC9F,IAAA,2BAAY,GAAwC,CAAC;AAErD,6FAA6F;AAC7F,IAAA,2BAAY,GAA8C,CAAC;AAyI3D,uFAAuF;AACvF,IAAA,2BAAY,GAAyC,CAAC;AAwOtD,oBAAoB;AACP,QAAA,MAAM,GAAG;IACpB,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;CACF,CAAC;AAKX,oBAAoB;AACP,QAAA,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AA0DpH,oGAAoG;AACpG,IAAA,2BAAY,GAAoD,CAAC;AAWjE;;;;GAIG;AACH,IAAY,qBAyCX;AAzCD,WAAY,qBAAqB;IAC/B;;;;OAIG;IACH,+EAAe,CAAA;IAEf;;OAEG;IACH,iEAAI,CAAA;IAEJ;;;;OAIG;IACH,6EAAU,CAAA;IAEV;;OAEG;IACH,6EAAU,CAAA;IAEV;;OAEG;IACH,iFAAY,CAAA;IAEZ;;OAEG;IACH,uFAAe,CAAA;IAEf;;;;OAIG;IACH,2EAAS,CAAA;AACX,CAAC,EAzCW,qBAAqB,GAArB,6BAAqB,KAArB,6BAAqB,QAyChC;AAID,IAAA,2BAAY,GAGT,CAAC;AACJ,IAAA,2BAAY,GAGT,CAAC"}

package/lib/types.d.ts

@@ -1,6 +1,7 @@
+import type * as grpc from '@grpc/grpc-js';
 import type { SearchAttributes } from '@temporalio/common';
 import * as proto from '@temporalio/proto';
-import type * as grpc from '@grpc/grpc-js';
+import { Replace } from '@temporalio/common/lib/type-helpers';
 export interface WorkflowExecution {
     workflowId: string;
     runId?: string;
@@ -8,10 +9,11 @@ export interface WorkflowExecution {
 export declare type StartWorkflowExecutionRequest = proto.temporal.api.workflowservice.v1.IStartWorkflowExecutionRequest;
 export declare type GetWorkflowExecutionHistoryRequest = proto.temporal.api.workflowservice.v1.IGetWorkflowExecutionHistoryRequest;
 export declare type DescribeWorkflowExecutionResponse = proto.temporal.api.workflowservice.v1.IDescribeWorkflowExecutionResponse;
+export declare type RawWorkflowExecutionInfo = proto.temporal.api.workflow.v1.IWorkflowExecutionInfo;
 export declare type TerminateWorkflowExecutionResponse = proto.temporal.api.workflowservice.v1.ITerminateWorkflowExecutionResponse;
 export declare type RequestCancelWorkflowExecutionResponse = proto.temporal.api.workflowservice.v1.IRequestCancelWorkflowExecutionResponse;
 export declare type WorkflowExecutionStatusName = 'UNSPECIFIED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'UNKNOWN';
-export interface WorkflowExecutionDescription {
+export interface WorkflowExecutionInfo {
     type: string;
     workflowId: string;
     runId: string;
@@ -27,8 +29,11 @@ export interface WorkflowExecutionDescription {
     memo?: Record<string, unknown>;
     searchAttributes: SearchAttributes;
     parentExecution?: Required<proto.temporal.api.common.v1.IWorkflowExecution>;
-    raw: DescribeWorkflowExecutionResponse;
+    raw: RawWorkflowExecutionInfo;
 }
+export declare type WorkflowExecutionDescription = Replace<WorkflowExecutionInfo, {
+    raw: DescribeWorkflowExecutionResponse;
+}>;
 export declare type WorkflowService = proto.temporal.api.workflowservice.v1.WorkflowService;
 export declare const WorkflowService: typeof proto.temporal.api.workflowservice.v1.WorkflowService;
 export declare type OperatorService = proto.temporal.api.operatorservice.v1.OperatorService;

package/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,yDAA2C;AA6C5B,uBAAe,GAAK,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,iBAAC;AAE1D,uBAAe,GAAK,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,iBAAC;AAElD,qBAAa,GAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yDAA2C;AAqD5B,uBAAe,GAAK,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,iBAAC;AAE1D,uBAAe,GAAK,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,iBAAC;AAElD,qBAAa,GAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAC"}

package/lib/workflow-client.d.ts

@@ -1,11 +1,11 @@
 import { status as grpcStatus } from '@grpc/grpc-js';
-import { DataConverter, LoadedDataConverter } from '@temporalio/common';
-import { BaseWorkflowHandle, QueryDefinition, WithWorkflowArgs, Workflow, WorkflowResultType } from '@temporalio/common';
-import { Replace } from '@temporalio/common/lib/type-helpers';
+import { BaseWorkflowHandle, HistoryAndWorkflowId, QueryDefinition, WithWorkflowArgs, Workflow, WorkflowResultType } from '@temporalio/common';
+import { History } from '@temporalio/common/lib/proto-utils';
 import { temporal } from '@temporalio/proto';
-import { WorkflowCancelInput, WorkflowClientCallsInterceptor, WorkflowClientInterceptors, WorkflowDescribeInput, WorkflowQueryInput, WorkflowSignalInput, WorkflowSignalWithStartInput, WorkflowStartInput, WorkflowTerminateInput } from './interceptors';
-import { ConnectionLike, DescribeWorkflowExecutionResponse, Metadata, RequestCancelWorkflowExecutionResponse, TerminateWorkflowExecutionResponse, WorkflowExecution, WorkflowExecutionDescription, WorkflowService } from './types';
-import { WorkflowOptions, WorkflowSignalWithStartOptions } from './workflow-options';
+import { WorkflowCancelInput, WorkflowClientInterceptor, WorkflowClientInterceptors, WorkflowDescribeInput, WorkflowQueryInput, WorkflowSignalInput, WorkflowSignalWithStartInput, WorkflowStartInput, WorkflowTerminateInput } from './interceptors';
+import { DescribeWorkflowExecutionResponse, RequestCancelWorkflowExecutionResponse, TerminateWorkflowExecutionResponse, WorkflowExecution, WorkflowExecutionDescription, WorkflowExecutionInfo, WorkflowService } from './types';
+import { WorkflowOptions, WorkflowSignalWithStartOptions, WorkflowStartOptions } from './workflow-options';
+import { BaseClient, BaseClientOptions, LoadedWithDefaults } from './base-client';
 /**
  * A client side handle to a single Workflow instance.
  * It can be used to start, signal, query, wait for completion, terminate and cancel a Workflow execution.
@@ -67,6 +67,10 @@ export interface WorkflowHandle<T extends Workflow = Workflow> extends BaseWorkf
      * Describe the current workflow execution
      */
     describe(): Promise<WorkflowExecutionDescription>;
+    /**
+     * Return a workflow execution's history
+     */
+    fetchHistory(): Promise<History>;
     /**
      * Readonly accessor to the underlying WorkflowClient
      */
@@ -95,37 +99,13 @@ export interface WorkflowHandleWithSignaledRunId<T extends Workflow = Workflow>
      */
     readonly signaledRunId: string;
 }
-export interface WorkflowClientOptions {
-    /**
-     * {@link DataConverter} or {@link LoadedDataConverter} to use for serializing and deserializing payloads
-     */
-    dataConverter?: DataConverter | LoadedDataConverter;
+export interface WorkflowClientOptions extends BaseClientOptions {
     /**
      * Used to override and extend default Connection functionality
      *
      * Useful for injecting auth headers and tracing Workflow executions
      */
-    interceptors?: WorkflowClientInterceptors;
-    /**
-     * Identity to report to the server
-     *
-     * @default `${process.pid}@${os.hostname()}`
-     */
-    identity?: string;
-    /**
-     * Connection to use to communicate with the server.
-     *
-     * By default `WorkflowClient` connects to localhost.
-     *
-     * Connections are expensive to construct and should be reused.
-     */
-    connection?: ConnectionLike;
-    /**
-     * Server namespace
-     *
-     * @default default
-     */
-    namespace?: string;
+    interceptors?: WorkflowClientInterceptors | WorkflowClientInterceptor[];
     /**
      * Should a query be rejected by closed and failed workflows
      *
@@ -133,13 +113,7 @@ export interface WorkflowClientOptions {
      */
     queryRejectCondition?: temporal.api.enums.v1.QueryRejectCondition;
 }
-export declare type WorkflowClientOptionsWithDefaults = Replace<Required<WorkflowClientOptions>, {
-    connection?: ConnectionLike;
-}>;
-export declare type LoadedWorkflowClientOptions = WorkflowClientOptionsWithDefaults & {
-    loadedDataConverter: LoadedDataConverter;
-};
-export declare function defaultWorkflowClientOptions(): WorkflowClientOptionsWithDefaults;
+export declare type LoadedWorkflowClientOptions = LoadedWithDefaults<WorkflowClientOptions>;
 /**
  * Options for getting a result of a Workflow execution.
  */
@@ -167,7 +141,7 @@ export interface GetWorkflowHandleOptions extends WorkflowResultOptions {
 interface WorkflowHandleOptions extends GetWorkflowHandleOptions {
     workflowId: string;
     runId?: string;
-    interceptors: WorkflowClientCallsInterceptor[];
+    interceptors: WorkflowClientInterceptor[];
     /**
      * A runId to use for getting the workflow's result.
      *
@@ -178,18 +152,63 @@ interface WorkflowHandleOptions extends GetWorkflowHandleOptions {
     runIdForResult?: string;
 }
 /**
- * Options for starting a Workflow
+ * An iterable list of WorkflowExecution, as returned by {@link WorkflowClient.list}.
  */
-export declare type WorkflowStartOptions<T extends Workflow = Workflow> = WithWorkflowArgs<T, WorkflowOptions>;
+interface AsyncWorkflowListIterable extends AsyncIterable<WorkflowExecutionInfo> {
+    /**
+     * Return an iterable of histories corresponding to this iterable's WorkflowExecutions.
+     * Workflow histories will be fetched concurrently.
+     *
+     * Useful in batch replaying
+     */
+    intoHistories: (intoHistoriesOptions?: IntoHistoriesOptions) => AsyncIterable<HistoryAndWorkflowId>;
+}
+/**
+ * Options for {@link WorkflowClient.list}
+ */
+export interface ListOptions {
+    /**
+     * Maximum number of results to fetch per page.
+     *
+     * @default depends on server config, typically 1000
+     */
+    pageSize?: number;
+    /**
+     * Query string for matching and ordering the results
+     */
+    query?: string;
+}
+/**
+ * Options for {@link WorkflowClient.list().intoHistories()}
+ */
+export interface IntoHistoriesOptions {
+    /**
+     * Maximum number of workflow histories to download concurrently.
+     *
+     * @default 5
+     */
+    concurrency?: number;
+    /**
+     * Maximum number of workflow histories to buffer ahead, ready for consumption.
+     *
+     * It is recommended to set `bufferLimit` to a rasonnably low number if it is expected that the
+     * iterable may be stopped before reaching completion (for example, when implementing a fail fast
+     * bach replay test).
+     *
+     * Ignored unless `concurrency > 1`. No limit applies if set to `undefined`.
+     *
+     * @default unlimited
+     */
+    bufferLimit?: number;
+}
 /**
  * Client for starting Workflow executions and creating Workflow handles.
  *
  * Typically this client should not be instantiated directly, instead create the high level {@link Client} and use
  * {@link Client.workflow} to interact with Workflows.
  */
-export declare class WorkflowClient {
+export declare class WorkflowClient extends BaseClient {
     readonly options: LoadedWorkflowClientOptions;
-    readonly connection: ConnectionLike;
     constructor(options?: WorkflowClientOptions);
     /**
      * Raw gRPC access to the Temporal service.
@@ -198,32 +217,19 @@ export declare class WorkflowClient {
      * object.
      */
     get workflowService(): WorkflowService;
-    protected get dataConverter(): LoadedDataConverter;
-    /**
-     * Set the deadline for any service requests executed in `fn`'s scope.
-     */
-    withDeadline<R>(deadline: number | Date, fn: () => Promise<R>): Promise<R>;
-    /**
-     * Set metadata for any service requests executed in `fn`'s scope.
-     *
-     * @returns returned value of `fn`
-     *
-     * @see {@link Connection.withMetadata}
-     */
-    withMetadata<R>(metadata: Metadata, fn: () => Promise<R>): Promise<R>;
     /**
      * Start a new Workflow execution.
      *
      * @returns the execution's `runId`.
      */
-    protected _start<T extends Workflow>(workflowTypeOrFunc: string | T, options: WithWorkflowArgs<T, WorkflowOptions>, interceptors: WorkflowClientCallsInterceptor[]): Promise<string>;
+    protected _start<T extends Workflow>(workflowTypeOrFunc: string | T, options: WithWorkflowArgs<T, WorkflowOptions>, interceptors: WorkflowClientInterceptor[]): Promise<string>;
     /**
      * Sends a signal to a running Workflow or starts a new one if not already running and immediately signals it.
      * Useful when you're unsure of the Workflows' run state.
      *
      * @returns the runId of the Workflow
      */
-    protected _signalWithStart<T extends Workflow, SA extends any[]>(workflowTypeOrFunc: string | T, options: WithWorkflowArgs<T, WorkflowSignalWithStartOptions<SA>>, interceptors: WorkflowClientCallsInterceptor[]): Promise<string>;
+    protected _signalWithStart<T extends Workflow, SA extends any[]>(workflowTypeOrFunc: string | T, options: WithWorkflowArgs<T, WorkflowSignalWithStartOptions<SA>>, interceptors: WorkflowClientInterceptor[]): Promise<string>;
     /**
      * Start a new Workflow execution.
      *
@@ -315,6 +321,17 @@ export declare class WorkflowClient {
      * methods like `handle.describe()` will throw a {@link WorkflowNotFoundError} error.
      */
     getHandle<T extends Workflow>(workflowId: string, runId?: string, options?: GetWorkflowHandleOptions): WorkflowHandle<T>;
+    protected _list(options?: ListOptions): AsyncIterable<WorkflowExecutionInfo>;
+    /**
+     * List workflows by given `query`.
+     *
+     * ⚠️ To use advanced query functionality, as of the 1.18 server release, you must use Elasticsearch based visibility.
+     *
+     * More info on the concept of "visibility" and the query syntax on the Temporal documentation site:
+     * https://docs.temporal.io/visibility
+     */
+    list(options?: ListOptions): AsyncWorkflowListIterable;
+    protected getOrMakeInterceptors(workflowId: string, runId?: string): WorkflowClientInterceptor[];
 }
 export declare class QueryRejectedError extends Error {
     readonly status: temporal.api.enums.v1.WorkflowExecutionStatus;

package/lib/workflow-client.js

@@ -1,32 +1,24 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryNotRegisteredError = exports.QueryRejectedError = exports.WorkflowClient = exports.defaultWorkflowClientOptions = void 0;
+exports.QueryNotRegisteredError = exports.QueryRejectedError = exports.WorkflowClient = void 0;
 const grpc_js_1 = require("@grpc/grpc-js");
+const uuid_1 = require("uuid");
 const common_1 = require("@temporalio/common");
-const internal_non_workflow_1 = require("@temporalio/common/lib/internal-non-workflow");
-const common_2 = require("@temporalio/common");
-const time_1 = require("@temporalio/common/lib/time");
 const interceptors_1 = require("@temporalio/common/lib/interceptors");
+const internal_non_workflow_1 = require("@temporalio/common/lib/internal-non-workflow");
 const proto_1 = require("@temporalio/proto");
-const os_1 = __importDefault(require("os"));
-const uuid_1 = require("uuid");
-const connection_1 = require("./connection");
 const errors_1 = require("./errors");
 const workflow_options_1 = require("./workflow-options");
+const helpers_1 = require("./helpers");
+const base_client_1 = require("./base-client");
+const iterators_utils_1 = require("./iterators-utils");
 function defaultWorkflowClientOptions() {
     return {
-        dataConverter: {},
-        // The equivalent in Java is ManagementFactory.getRuntimeMXBean().getName()
-        identity: `${process.pid}@${os_1.default.hostname()}`,
-        interceptors: {},
-        namespace: 'default',
+        ...(0, base_client_1.defaultBaseClientOptions)(),
+        interceptors: [],
         queryRejectCondition: proto_1.temporal.api.enums.v1.QueryRejectCondition.QUERY_REJECT_CONDITION_UNSPECIFIED,
     };
 }
-exports.defaultWorkflowClientOptions = defaultWorkflowClientOptions;
 function assertRequiredWorkflowOptions(opts) {
     if (!opts.taskQueue) {
         throw new TypeError('Missing WorkflowOptions.taskQueue');
@@ -45,15 +37,13 @@ function ensureArgs(opts) {
  * Typically this client should not be instantiated directly, instead create the high level {@link Client} and use
  * {@link Client.workflow} to interact with Workflows.
  */
-class WorkflowClient {
+class WorkflowClient extends base_client_1.BaseClient {
     constructor(options) {
-        this.connection = options?.connection ?? connection_1.Connection.lazy();
-        const dataConverter = options?.dataConverter;
-        const loadedDataConverter = (0, internal_non_workflow_1.isLoadedDataConverter)(dataConverter) ? dataConverter : (0, internal_non_workflow_1.loadDataConverter)(dataConverter);
+        super(options);
         this.options = {
             ...defaultWorkflowClientOptions(),
             ...(0, internal_non_workflow_1.filterNullAndUndefined)(options ?? {}),
-            loadedDataConverter,
+            loadedDataConverter: this.dataConverter,
         };
     }
     /**
@@ -65,25 +55,6 @@ class WorkflowClient {
     get workflowService() {
         return this.connection.workflowService;
     }
-    get dataConverter() {
-        return this.options.loadedDataConverter;
-    }
-    /**
-     * Set the deadline for any service requests executed in `fn`'s scope.
-     */
-    async withDeadline(deadline, fn) {
-        return await this.connection.withDeadline(deadline, fn);
-    }
-    /**
-     * Set metadata for any service requests executed in `fn`'s scope.
-     *
-     * @returns returned value of `fn`
-     *
-     * @see {@link Connection.withMetadata}
-     */
-    async withMetadata(metadata, fn) {
-        return await this.connection.withMetadata(metadata, fn);
-    }
     /**
      * Start a new Workflow execution.
      *
@@ -127,8 +98,7 @@ class WorkflowClient {
      */
     async start(workflowTypeOrFunc, options) {
         const { workflowId } = options;
-        // Cast is needed because it's impossible to deduce the type in this situation
-        const interceptors = (this.options.interceptors.calls ?? []).map((ctor) => ctor({ workflowId }));
+        const interceptors = this.getOrMakeInterceptors(workflowId);
         const runId = await this._start(workflowTypeOrFunc, { ...options, workflowId }, interceptors);
         // runId is not used in handles created with `start*` calls because these
         // handles should allow interacting with the workflow if it continues as new.
@@ -151,7 +121,7 @@ class WorkflowClient {
      */
     async signalWithStart(workflowTypeOrFunc, options) {
         const { workflowId } = options;
-        const interceptors = (this.options.interceptors.calls ?? []).map((ctor) => ctor({ workflowId }));
+        const interceptors = this.getOrMakeInterceptors(workflowId);
         const runId = await this._signalWithStart(workflowTypeOrFunc, options, interceptors);
         // runId is not used in handles created with `start*` calls because these
         // handles should allow interacting with the workflow if it continues as new.
@@ -173,7 +143,7 @@ class WorkflowClient {
      */
     async execute(workflowTypeOrFunc, options) {
         const { workflowId } = options;
-        const interceptors = (this.options.interceptors.calls ?? []).map((ctor) => ctor({ workflowId }));
+        const interceptors = this.getOrMakeInterceptors(workflowId);
         await this._start(workflowTypeOrFunc, options, interceptors);
         return await this.result(workflowId, undefined, {
             ...options,
@@ -270,7 +240,7 @@ class WorkflowClient {
     rethrowGrpcError(err, workflowExecution, fallbackMessage) {
         if ((0, errors_1.isServerErrorResponse)(err)) {
             if (err.code === grpc_js_1.status.NOT_FOUND) {
-                throw new common_2.WorkflowNotFoundError(err.details ?? 'Workflow not found', workflowExecution.workflowId, workflowExecution.runId);
+                throw new common_1.WorkflowNotFoundError(err.details ?? 'Workflow not found', workflowExecution.workflowId, workflowExecution.runId);
             }
             throw new errors_1.ServiceError(fallbackMessage, { cause: err });
         }
@@ -361,7 +331,7 @@ class WorkflowClient {
                 workflowExecutionTimeout: options.workflowExecutionTimeout,
                 workflowRunTimeout: options.workflowRunTimeout,
                 workflowTaskTimeout: options.workflowTaskTimeout,
-                retryPolicy: options.retry ? (0, common_2.compileRetryPolicy)(options.retry) : undefined,
+                retryPolicy: options.retry ? (0, common_1.compileRetryPolicy)(options.retry) : undefined,
                 memo: options.memo ? { fields: await (0, internal_non_workflow_1.encodeMapToPayloads)(this.dataConverter, options.memo) } : undefined,
                 searchAttributes: options.searchAttributes
                     ? {
@@ -400,7 +370,7 @@ class WorkflowClient {
             workflowExecutionTimeout: opts.workflowExecutionTimeout,
             workflowRunTimeout: opts.workflowRunTimeout,
             workflowTaskTimeout: opts.workflowTaskTimeout,
-            retryPolicy: opts.retry ? (0, common_2.compileRetryPolicy)(opts.retry) : undefined,
+            retryPolicy: opts.retry ? (0, common_1.compileRetryPolicy)(opts.retry) : undefined,
             memo: opts.memo ? { fields: await (0, internal_non_workflow_1.encodeMapToPayloads)(this.dataConverter, opts.memo) } : undefined,
             searchAttributes: opts.searchAttributes
                 ? {
@@ -416,7 +386,7 @@ class WorkflowClient {
         }
         catch (err) {
             if (err.code === grpc_js_1.status.ALREADY_EXISTS) {
-                throw new errors_1.WorkflowExecutionAlreadyStartedError('Workflow execution already started', opts.workflowId, workflowType);
+                throw new common_1.WorkflowExecutionAlreadyStartedError('Workflow execution already started', opts.workflowId, workflowType);
             }
             this.rethrowGrpcError(err, { workflowId: opts.workflowId }, 'Failed to start Workflow');
         }
@@ -510,32 +480,25 @@ class WorkflowClient {
                 const raw = await fn({
                     workflowExecution: { workflowId, runId },
                 });
-                return {
-                    /* eslint-disable @typescript-eslint/no-non-null-assertion */
-                    type: raw.workflowExecutionInfo.type.name,
-                    workflowId: raw.workflowExecutionInfo.execution.workflowId,
-                    runId: raw.workflowExecutionInfo.execution.runId,
-                    taskQueue: raw.workflowExecutionInfo.taskQueue,
-                    status: {
-                        code: raw.workflowExecutionInfo.status,
-                        name: workflowStatusCodeToName(raw.workflowExecutionInfo.status),
-                    },
-                    // Safe to convert to number, max history length is 50k, which is much less than Number.MAX_SAFE_INTEGER
-                    historyLength: raw.workflowExecutionInfo.historyLength.toNumber(),
-                    startTime: (0, time_1.tsToDate)(raw.workflowExecutionInfo.startTime),
-                    executionTime: (0, time_1.optionalTsToDate)(raw.workflowExecutionInfo.executionTime),
-                    closeTime: (0, time_1.optionalTsToDate)(raw.workflowExecutionInfo.closeTime),
-                    memo: await (0, internal_non_workflow_1.decodeMapFromPayloads)(this.client.dataConverter, raw.workflowExecutionInfo.memo?.fields),
-                    searchAttributes: Object.fromEntries(Object.entries((0, common_1.mapFromPayloads)(common_1.searchAttributePayloadConverter, raw.workflowExecutionInfo.searchAttributes?.indexedFields ?? {})).filter(([_, v]) => v && v.length > 0) // Filter out empty arrays returned by pre 1.18 servers
-                    ),
-                    parentExecution: raw.workflowExecutionInfo?.parentExecution
-                        ? {
-                            workflowId: raw.workflowExecutionInfo.parentExecution.workflowId,
-                            runId: raw.workflowExecutionInfo.parentExecution.runId,
-                        }
-                        : undefined,
-                    raw,
-                };
+                const info = await (0, helpers_1.executionInfoFromRaw)(raw.workflowExecutionInfo ?? {}, this.client.dataConverter);
+                info.raw = raw;
+                return info;
+            },
+            async fetchHistory() {
+                let nextPageToken = undefined;
+                const events = Array();
+                for (;;) {
+                    const response = await this.client.workflowService.getWorkflowExecutionHistory({
+                        nextPageToken,
+                        namespace: this.client.options.namespace,
+                        execution: { workflowId, runId },
+                    });
+                    events.push(...(response.history?.events ?? []));
+                    nextPageToken = response.nextPageToken;
+                    if (nextPageToken == null || nextPageToken.length === 0)
+                        break;
+                }
+                return proto_1.temporal.api.history.v1.History.create({ events });
             },
             async signal(def, ...args) {
                 const next = this.client._signalWorkflowHandler.bind(this.client);
@@ -579,7 +542,7 @@ class WorkflowClient {
      * methods like `handle.describe()` will throw a {@link WorkflowNotFoundError} error.
      */
     getHandle(workflowId, runId, options) {
-        const interceptors = (this.options.interceptors.calls ?? []).map((ctor) => ctor({ workflowId, runId }));
+        const interceptors = this.getOrMakeInterceptors(workflowId, runId);
         return this._createWorkflowHandle({
             workflowId,
             runId,
@@ -589,6 +552,55 @@ class WorkflowClient {
             followRuns: options?.followRuns ?? true,
         });
     }
+    async *_list(options) {
+        let nextPageToken = Buffer.alloc(0);
+        for (;;) {
+            const response = await this.workflowService.listWorkflowExecutions({
+                namespace: this.options.namespace,
+                query: options?.query,
+                nextPageToken,
+                pageSize: options?.pageSize,
+            });
+            // Not decoding memo payloads concurrently even though we could have to keep the lazy nature of this iterator.
+            // Decoding is done for `memo` fields which tend to be small.
+            // We might decide to change that based on user feedback.
+            for (const raw of response.executions) {
+                yield await (0, helpers_1.executionInfoFromRaw)(raw, this.dataConverter);
+            }
+            nextPageToken = response.nextPageToken;
+            if (nextPageToken == null || nextPageToken.length === 0)
+                break;
+        }
+    }
+    /**
+     * List workflows by given `query`.
+     *
+     * ⚠️ To use advanced query functionality, as of the 1.18 server release, you must use Elasticsearch based visibility.
+     *
+     * More info on the concept of "visibility" and the query syntax on the Temporal documentation site:
+     * https://docs.temporal.io/visibility
+     */
+    list(options) {
+        return {
+            [Symbol.asyncIterator]: () => this._list(options)[Symbol.asyncIterator](),
+            intoHistories: (intoHistoriesOptions) => {
+                return (0, iterators_utils_1.mapAsyncIterable)(this._list(options), async ({ workflowId, runId }) => ({
+                    workflowId,
+                    history: await this.getHandle(workflowId, runId)
+                        .fetchHistory()
+                        .catch((_) => undefined),
+                }), { concurrency: intoHistoriesOptions?.concurrency ?? 5 });
+            },
+        };
+    }
+    getOrMakeInterceptors(workflowId, runId) {
+        if (typeof this.options.interceptors === 'object' && 'calls' in this.options.interceptors) {
+            // eslint-disable-next-line deprecation/deprecation
+            const factories = this.options.interceptors.calls ?? [];
+            return factories.map((ctor) => ctor({ workflowId, runId }));
+        }
+        return Array.isArray(this.options.interceptors) ? this.options.interceptors : [];
+    }
 }
 exports.WorkflowClient = WorkflowClient;
 class QueryRejectedError extends Error {
@@ -607,30 +619,4 @@ class QueryNotRegisteredError extends Error {
     }
 }
 exports.QueryNotRegisteredError = QueryNotRegisteredError;
-function workflowStatusCodeToName(code) {
-    return workflowStatusCodeToNameInternal(code) ?? 'UNKNOWN';
-}
-/**
- * Intentionally leave out `default` branch to get compilation errors when new values are added
- */
-function workflowStatusCodeToNameInternal(code) {
-    switch (code) {
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_UNSPECIFIED:
-            return 'UNSPECIFIED';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_RUNNING:
-            return 'RUNNING';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_FAILED:
-            return 'FAILED';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_TIMED_OUT:
-            return 'TIMED_OUT';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_CANCELED:
-            return 'CANCELLED';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_TERMINATED:
-            return 'TERMINATED';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_COMPLETED:
-            return 'COMPLETED';
-        case proto_1.temporal.api.enums.v1.WorkflowExecutionStatus.WORKFLOW_EXECUTION_STATUS_CONTINUED_AS_NEW:
-            return 'CONTINUED_AS_NEW';
-    }
-}
 //# sourceMappingURL=workflow-client.js.map