@temporalio/client 1.8.5 → 1.9.0-rc.0

package/lib/base-client.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+import 'abort-controller/polyfill';
 import { DataConverter, LoadedDataConverter } from '@temporalio/common';
 import { ConnectionLike, Metadata } from './types';
 export interface BaseClientOptions {
@@ -41,6 +43,15 @@ export declare class BaseClient {
      * Set the deadline for any service requests executed in `fn`'s scope.
      */
     withDeadline<R>(deadline: number | Date, fn: () => Promise<R>): Promise<R>;
+    /**
+     * Set an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} that, when aborted,
+     * cancels any ongoing service requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
+     *
+     * @see {@link Connection.withAbortSignal}
+     */
+    withAbortSignal<R>(abortSignal: AbortSignal, fn: () => Promise<R>): Promise<R>;
     /**
      * Set metadata for any service requests executed in `fn`'s scope.
      *

package/lib/base-client.js

@@ -4,6 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseClient = exports.defaultBaseClientOptions = void 0;
+// Keep this around until we drop support for Node 14.
+require("abort-controller/polyfill"); // eslint-disable-line import/no-unassigned-import
 const node_os_1 = __importDefault(require("node:os"));
 const internal_non_workflow_1 = require("@temporalio/common/lib/internal-non-workflow");
 const connection_1 = require("./connection");
@@ -27,6 +29,17 @@ class BaseClient {
     async withDeadline(deadline, fn) {
         return await this.connection.withDeadline(deadline, fn);
     }
+    /**
+     * Set an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} that, when aborted,
+     * cancels any ongoing service requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
+     *
+     * @see {@link Connection.withAbortSignal}
+     */
+    async withAbortSignal(abortSignal, fn) {
+        return await this.connection.withAbortSignal(abortSignal, fn);
+    }
     /**
      * Set metadata for any service requests executed in `fn`'s scope.
      *

package/lib/base-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAEzB,wFAAwG;AACxG,6CAA0C;AAyC1C,SAAgB,wBAAwB;IACtC,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,iBAAE,CAAC,QAAQ,EAAE,EAAE;QAC3C,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC;AAND,4DAMC;AAED,MAAa,UAAU;IAIrB,YAAsB,OAA2B;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,uBAAU,CAAC,IAAI,EAAE,CAAC;QAC3D,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,mBAAmB,GAAG,IAAA,6CAAqB,EAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAA,yCAAiB,EAAC,aAAa,CAAC,CAAC;IACrH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CAAI,QAAuB,EAAE,EAAoB;QACxE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,YAAY,CAAI,QAAkB,EAAE,EAAoB;QACnE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAc,aAAa;QACzB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;CACF;AA/BD,gCA+BC"}
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAsD;AACtD,qCAAmC,CAAC,kDAAkD;AACtF,sDAAyB;AAEzB,wFAAwG;AACxG,6CAA0C;AAyC1C,SAAgB,wBAAwB;IACtC,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,iBAAE,CAAC,QAAQ,EAAE,EAAE;QAC3C,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC;AAND,4DAMC;AAED,MAAa,UAAU;IAIrB,YAAsB,OAA2B;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,uBAAU,CAAC,IAAI,EAAE,CAAC;QAC3D,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,mBAAmB,GAAG,IAAA,6CAAqB,EAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAA,yCAAiB,EAAC,aAAa,CAAC,CAAC;IACrH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CAAI,QAAuB,EAAE,EAAoB;QACxE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CAAI,WAAwB,EAAE,EAAoB;QACrE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,YAAY,CAAI,QAAkB,EAAE,EAAoB;QACnE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAc,aAAa;QACzB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;CACF;AA3CD,gCA2CC"}

package/lib/connection.d.ts

@@ -1,4 +1,6 @@
 /// <reference types="node" />
+/// <reference types="node" />
+import 'abort-controller/polyfill';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import * as grpc from '@grpc/grpc-js';
 import type { RPCImpl } from 'protobufjs';
@@ -17,19 +19,44 @@ export interface ConnectionOptions {
      */
     address?: string;
     /**
-     * TLS configuration.
-     * Pass a falsy value to use a non-encrypted connection or `true` or `{}` to
-     * connect with TLS without any customization.
+     * TLS configuration. Pass a falsy value to use a non-encrypted connection,
+     * or `true` or `{}` to connect with TLS without any customization.
+     *
+     * For advanced scenario, a prebuilt {@link grpc.ChannelCredentials} object
+     * may instead be specified using the {@link credentials} property.
      *
      * Either {@link credentials} or this may be specified for configuring TLS
+     *
+     * @default TLS is disabled
      */
     tls?: TLSConfig | boolean | null;
     /**
-     * Channel credentials, create using the factory methods defined {@link https://grpc.github.io/grpc/node/grpc.credentials.html | here}
+     * gRPC channel credentials.
+     *
+     * `ChannelCredentials` are things like SSL credentials that can be used to secure a connection.
+     * There may be only one `ChannelCredentials`. They can be created using some of the factory
+     * methods defined {@link https://grpc.github.io/grpc/node/grpc.credentials.html | here}
+     *
+     * Specifying a prebuilt `ChannelCredentials` should only be required for advanced use cases.
+     * For simple TLS use cases, using the {@link tls} property is recommended. To register
+     * `CallCredentials` (eg. metadata-based authentication), use the {@link callCredentials} property.
      *
      * Either {@link tls} or this may be specified for configuring TLS
      */
     credentials?: grpc.ChannelCredentials;
+    /**
+     * gRPC call credentials.
+     *
+     * `CallCredentials` generaly modify metadata; they can be attached to a connection to affect all method
+     * calls made using that connection. They can be created using some of the factory methods defined
+     * {@link https://grpc.github.io/grpc/node/grpc.credentials.html | here}
+     *
+     * If `callCredentials` are specified, they will be composed with channel credentials
+     * (either the one created implicitely by using the {@link tls} option, or the one specified
+     * explicitly through {@link credentials}). Notice that gRPC doesn't allow registering
+     * `callCredentials` on insecure connections.
+     */
+    callCredentials?: grpc.CallCredentials[];
     /**
      * GRPC Channel arguments
      *
@@ -74,7 +101,7 @@ export interface ConnectionOptions {
      */
     connectTimeout?: Duration;
 }
-export type ConnectionOptionsWithDefaults = Required<Omit<ConnectionOptions, 'tls' | 'connectTimeout'>> & {
+export type ConnectionOptionsWithDefaults = Required<Omit<ConnectionOptions, 'tls' | 'connectTimeout' | 'callCredentials'>> & {
     connectTimeoutMs: number;
 };
 export declare const LOCAL_TARGET = "127.0.0.1:7233";
@@ -129,6 +156,12 @@ export declare class Connection {
     /**
      * Raw gRPC access to Temporal Server's
      * {@link https://github.com/temporalio/api/blob/master/temporal/api/operatorservice/v1/service.proto | Operator service}
+     *
+     * The Operator Service API defines how Temporal SDKs and other clients interact with the Temporal
+     * server to perform administrative functions like registering a search attribute or a namespace.
+     *
+     * This Service API is NOT compatible with Temporal Cloud. Attempt to use it against a Temporal
+     * Cloud namespace will result in gRPC `unauthorized` error.
      */
     readonly operatorService: OperatorService;
     readonly healthService: HealthService;
@@ -165,6 +198,22 @@ export declare class Connection {
      * @returns value returned from `fn`
      */
     withDeadline<ReturnType>(deadline: number | Date, fn: () => Promise<ReturnType>): Promise<ReturnType>;
+    /**
+     * Set an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} that, when aborted,
+     * cancels any ongoing requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
+     *
+     * @example
+     *
+     * ```ts
+     * const ctrl = new AbortController();
+     * setTimeout(() => ctrl.abort(), 10_000);
+     * // 👇 throws if incomplete by the timeout.
+     * await conn.withAbortSignal(ctrl.signal, () => client.workflow.execute(myWorkflow, options));
+     * ```
+     */
+    withAbortSignal<ReturnType>(abortSignal: AbortSignal, fn: () => Promise<ReturnType>): Promise<ReturnType>;
     /**
      * Set metadata for any service requests executed in `fn`'s scope.
      *
@@ -175,11 +224,11 @@ export declare class Connection {
      *
      * @example
      *
-     *```ts
-     *const workflowHandle = await conn.withMetadata({ apiKey: 'secret' }, () =>
-     *  conn.withMetadata({ otherKey: 'set' }, () => client.start(options)))
-     *);
-     *```
+     * ```ts
+     * const workflowHandle = await conn.withMetadata({ apiKey: 'secret' }, () =>
+     *   conn.withMetadata({ otherKey: 'set' }, () => client.start(options)))
+     * );
+     * ```
      */
     withMetadata<ReturnType>(metadata: Metadata, fn: () => Promise<ReturnType>): Promise<ReturnType>;
     /**

package/lib/connection.js

@@ -27,6 +27,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Connection = exports.LOCAL_TARGET = void 0;
+// Keep this around until we drop support for Node 14.
+require("abort-controller/polyfill"); // eslint-disable-line import/no-unassigned-import
 const node_async_hooks_1 = require("node:async_hooks");
 const grpc = __importStar(require("@grpc/grpc-js"));
 const internal_non_workflow_1 = require("@temporalio/common/lib/internal-non-workflow");
@@ -59,7 +61,7 @@ function addDefaults(options) {
  * - Add default port to address if port not specified
  */
 function normalizeGRPCConfig(options) {
-    const { tls: tlsFromConfig, credentials, ...rest } = options || {};
+    const { tls: tlsFromConfig, credentials, callCredentials, ...rest } = options || {};
     if (rest.address) {
         // eslint-disable-next-line prefer-const
         let [host, port] = rest.address.split(':', 2);
@@ -73,7 +75,7 @@ function normalizeGRPCConfig(options) {
         }
         return {
             ...rest,
-            credentials: grpc.credentials.createSsl(tls.serverRootCACertificate, tls.clientCertPair?.key, tls.clientCertPair?.crt),
+            credentials: grpc.credentials.combineChannelCredentials(grpc.credentials.createSsl(tls.serverRootCACertificate, tls.clientCertPair?.key, tls.clientCertPair?.crt), ...(callCredentials ?? [])),
             channelArgs: {
                 ...rest.channelArgs,
                 ...(tls.serverNameOverride
@@ -86,7 +88,10 @@ function normalizeGRPCConfig(options) {
         };
     }
     else {
-        return rest;
+        return {
+            ...rest,
+            credentials: grpc.credentials.combineChannelCredentials(credentials ?? grpc.credentials.createInsecure(), ...(callCredentials ?? [])),
+        };
     }
 }
 /**
@@ -199,7 +204,7 @@ class Connection {
     static generateRPCImplementation({ serviceName, client, callContextStorage, interceptors, staticMetadata, }) {
         return (method, requestData, callback) => {
             const metadataContainer = new grpc.Metadata();
-            const { metadata, deadline } = callContextStorage.getStore() ?? {};
+            const { metadata, deadline, abortSignal } = callContextStorage.getStore() ?? {};
             for (const [k, v] of Object.entries(staticMetadata)) {
                 metadataContainer.set(k, v);
             }
@@ -208,7 +213,11 @@ class Connection {
                     metadataContainer.set(k, v);
                 }
             }
-            return client.makeUnaryRequest(`/${serviceName}/${method.name}`, (arg) => arg, (arg) => arg, requestData, metadataContainer, { interceptors, deadline }, callback);
+            const call = client.makeUnaryRequest(`/${serviceName}/${method.name}`, (arg) => arg, (arg) => arg, requestData, metadataContainer, { interceptors, deadline }, callback);
+            if (abortSignal != null) {
+                abortSignal.addEventListener('abort', () => call.cancel());
+            }
+            return call;
         };
     }
     /**
@@ -218,7 +227,26 @@ class Connection {
      */
     async withDeadline(deadline, fn) {
         const cc = this.callContextStorage.getStore();
-        return await this.callContextStorage.run({ deadline, metadata: cc?.metadata }, fn);
+        return await this.callContextStorage.run({ ...cc, deadline }, fn);
+    }
+    /**
+     * Set an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} that, when aborted,
+     * cancels any ongoing requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
+     *
+     * @example
+     *
+     * ```ts
+     * const ctrl = new AbortController();
+     * setTimeout(() => ctrl.abort(), 10_000);
+     * // 👇 throws if incomplete by the timeout.
+     * await conn.withAbortSignal(ctrl.signal, () => client.workflow.execute(myWorkflow, options));
+     * ```
+     */
+    async withAbortSignal(abortSignal, fn) {
+        const cc = this.callContextStorage.getStore();
+        return await this.callContextStorage.run({ ...cc, abortSignal }, fn);
     }
     /**
      * Set metadata for any service requests executed in `fn`'s scope.
@@ -230,16 +258,15 @@ class Connection {
      *
      * @example
      *
-     *```ts
-     *const workflowHandle = await conn.withMetadata({ apiKey: 'secret' }, () =>
-     *  conn.withMetadata({ otherKey: 'set' }, () => client.start(options)))
-     *);
-     *```
+     * ```ts
+     * const workflowHandle = await conn.withMetadata({ apiKey: 'secret' }, () =>
+     *   conn.withMetadata({ otherKey: 'set' }, () => client.start(options)))
+     * );
+     * ```
      */
     async withMetadata(metadata, fn) {
         const cc = this.callContextStorage.getStore();
-        metadata = { ...cc?.metadata, ...metadata };
-        return await this.callContextStorage.run({ metadata, deadline: cc?.deadline }, fn);
+        return await this.callContextStorage.run({ ...cc, metadata: { ...cc?.metadata, ...metadata } }, fn);
     }
     /**
      * Wait for successful connection to the server.

package/lib/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sDAAsD;AACtD,qCAAmC,CAAC,kDAAkD;AACtF,uDAAqD;AACrD,oDAAsC;AAEtC,wFAAqH;AACrH,sDAA2E;AAC3E,qCAA4D;AAC5D,6CAAiF;AACjF,gDAAwB;AACxB,mCAAiG;AA8GpF,QAAA,YAAY,GAAG,gBAAgB,CAAC;AAE7C,SAAS,WAAW,CAAC,OAA0B;IAC7C,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACvE,OAAO;QACL,OAAO,EAAE,oBAAY;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE;QAC9C,WAAW,EAAE;YACX,qCAAqC,EAAE,CAAC;YACxC,wBAAwB,EAAE,KAAM;YAChC,2BAA2B,EAAE,KAAM;YACnC,GAAG,WAAW;SACf;QACD,YAAY,EAAE,YAAY,IAAI,CAAC,IAAA,qCAAwB,EAAC,IAAA,oCAAuB,GAAE,CAAC,CAAC;QACnF,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,IAAA,yBAAkB,EAAC,cAAc,CAAC,IAAI,KAAM;QAC9D,GAAG,IAAA,8CAAsB,EAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,OAA2B;IACtD,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACpF,IAAI,IAAI,CAAC,OAAO,EAAE;QAChB,wCAAwC;QACxC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,IAAI,GAAG,IAAI,IAAI,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;KAClC;IACD,MAAM,GAAG,GAAG,IAAA,0CAAkB,EAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,GAAG,EAAE;QACP,IAAI,WAAW,EAAE;YACf,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;SACrF;QACD,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,yBAAyB,CACrD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAuB,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,EACzG,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAC3B;YACD,WAAW,EAAE;gBACX,GAAG,IAAI,CAAC,WAAW;gBACnB,GAAG,CAAC,GAAG,CAAC,kBAAkB;oBACxB,CAAC,CAAC;wBACE,+BAA+B,EAAE,GAAG,CAAC,kBAAkB;wBACvD,wBAAwB,EAAE,GAAG,CAAC,kBAAkB;qBACjD;oBACH,CAAC,CAAC,SAAS,CAAC;aACf;SACF,CAAC;KACH;SAAM;QACL,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,yBAAyB,CACrD,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,EAChD,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAC3B;SACF,CAAC;KACH;AACH,CAAC;AA8BD;;;;;GAKG;AACH,MAAa,UAAU;IAkCX,MAAM,CAAC,iBAAiB,CAAC,OAA2B;;QAC5D,MAAM,mBAAmB,GAAG,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,wBAAwB;QACxB,MAAA,mBAAmB,CAAC,QAAQ,EAAC,aAAa,SAAb,aAAa,IAAM,qBAAqB,EAAC;QACtE,MAAA,mBAAmB,CAAC,QAAQ,EAAC,gBAAgB,SAAhB,gBAAgB,IAAM,aAAG,CAAC,OAAO,EAAC;QAE/D,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAC5B,mBAAmB,CAAC,OAAO,EAC3B,mBAAmB,CAAC,WAAW,EAC/B,mBAAmB,CAAC,WAAW,CAChC,CAAC;QACF,MAAM,kBAAkB,GAAG,IAAI,oCAAiB,EAAe,CAAC;QAEhE,MAAM,eAAe,GAAG,IAAI,CAAC,yBAAyB,CAAC;YACrD,WAAW,EAAE,iDAAiD;YAC9D,MAAM;YACN,kBAAkB;YAClB,YAAY,EAAE,mBAAmB,EAAE,YAAY;YAC/C,cAAc,EAAE,mBAAmB,CAAC,QAAQ;SAC7C,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,uBAAe,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9E,MAAM,eAAe,GAAG,IAAI,CAAC,yBAAyB,CAAC;YACrD,WAAW,EAAE,iDAAiD;YAC9D,MAAM;YACN,kBAAkB;YAClB,YAAY,EAAE,mBAAmB,EAAE,YAAY;YAC/C,cAAc,EAAE,mBAAmB,CAAC,QAAQ;SAC7C,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,uBAAe,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,yBAAyB,CAAC;YACnD,WAAW,EAAE,uBAAuB;YACpC,MAAM;YACN,kBAAkB;YAClB,YAAY,EAAE,mBAAmB,EAAE,YAAY;YAC/C,cAAc,EAAE,mBAAmB,CAAC,QAAQ;SAC7C,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,qBAAa,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAExE,OAAO;YACL,MAAM;YACN,kBAAkB;YAClB,eAAe;YACf,eAAe;YACf,aAAa;YACb,OAAO,EAAE,mBAAmB;SAC7B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,EAAE;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC5D,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;gBAChC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAEhC,IAAI;oBACF,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;iBACjF;gBAAC,OAAO,GAAG,EAAE;oBACZ,IAAI,IAAA,2BAAkB,EAAC,GAAG,CAAC,EAAE;wBAC3B,qBAAqB;wBACrB,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;4BAC1C,MAAM,IAAI,qBAAY,CAAC,sCAAsC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;yBAChF;qBACF;yBAAM;wBACL,MAAM,GAAG,CAAC;qBACX;iBACF;YACH,CAAC,CAAC,EAAE,CAAC;SACN;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,OAA2B;QACrC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAA2B;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAsB,EACpB,OAAO,EACP,MAAM,EACN,eAAe,EACf,eAAe,EACf,aAAa,EACb,kBAAkB,GACI;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAES,MAAM,CAAC,yBAAyB,CAAC,EACzC,WAAW,EACX,MAAM,EACN,kBAAkB,EAClB,YAAY,EACZ,cAAc,GACC;QACf,OAAO,CAAC,MAAwB,EAAE,WAAgB,EAAE,QAAmC,EAAE,EAAE;YACzF,MAAM,iBAAiB,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAChF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;gBACnD,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aAC7B;YACD,IAAI,QAAQ,IAAI,IAAI,EAAE;gBACpB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;oBAC7C,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;iBAC7B;aACF;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAClC,IAAI,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,EAChC,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,EACjB,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,EACjB,WAAW,EACX,iBAAiB,EACjB,EAAE,YAAY,EAAE,QAAQ,EAAE,EAC1B,QAAQ,CACT,CAAC;YACF,IAAI,WAAW,IAAI,IAAI,EAAE;gBACvB,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;aAC5D;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAa,QAAuB,EAAE,EAA6B;QACnF,MAAM,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,eAAe,CAAa,WAAwB,EAAE,EAA6B;QACvF,MAAM,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,YAAY,CAAa,QAAkB,EAAE,EAA6B;QAC9E,MAAM,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,UAAU,CAAC,QAAgB;QACzC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzC,IAAI,GAAG,EAAE;oBACP,MAAM,CAAC,GAAG,CAAC,CAAC;iBACb;qBAAM;oBACL,OAAO,EAAE,CAAC;iBACX;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+GAA+G;IAC/G;;;;OAIG;IACI,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;;AAtQH,gCAuQC;AAtQC;;GAEG;AACoB,iBAAM,GAAG,IAAI,CAAC,4BAA4B,CAAC,EAAE,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC"}

package/lib/errors.d.ts

@@ -23,6 +23,14 @@ export declare class WorkflowFailedError extends Error {
     readonly retryState: RetryState;
     constructor(message: string, cause: TemporalFailure | undefined, retryState: RetryState);
 }
+/**
+ * Thrown by the client while waiting on Workflow Update result if Update
+ * completes with failure.
+ */
+export declare class WorkflowUpdateFailedError extends Error {
+    readonly cause: TemporalFailure | undefined;
+    constructor(message: string, cause: TemporalFailure | undefined);
+}
 /**
  * Thrown the by client while waiting on Workflow execution result if Workflow
  * continues as new.

package/lib/errors.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isServerErrorResponse = exports.isGrpcServiceError = exports.WorkflowContinuedAsNewError = exports.WorkflowFailedError = exports.ServiceError = void 0;
+exports.isServerErrorResponse = exports.isGrpcServiceError = exports.WorkflowContinuedAsNewError = exports.WorkflowUpdateFailedError = exports.WorkflowFailedError = exports.ServiceError = void 0;
 const type_helpers_1 = require("@temporalio/common/lib/type-helpers");
 /**
  * Generic Error class for errors coming from the service
@@ -41,6 +41,20 @@ WorkflowFailedError = __decorate([
     (0, type_helpers_1.SymbolBasedInstanceOfError)('WorkflowFailedError')
 ], WorkflowFailedError);
 exports.WorkflowFailedError = WorkflowFailedError;
+/**
+ * Thrown by the client while waiting on Workflow Update result if Update
+ * completes with failure.
+ */
+let WorkflowUpdateFailedError = class WorkflowUpdateFailedError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+};
+WorkflowUpdateFailedError = __decorate([
+    (0, type_helpers_1.SymbolBasedInstanceOfError)('WorkflowUpdateFailedError')
+], WorkflowUpdateFailedError);
+exports.WorkflowUpdateFailedError = WorkflowUpdateFailedError;
 /**
  * Thrown the by client while waiting on Workflow execution result if Workflow
  * continues as new.

package/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;;;;;;;AAEA,sEAAoG;AAEpG;;GAEG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,KAAK;IAGrC,YAAY,OAAe,EAAE,IAAuB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC;IAC3B,CAAC;CACF,CAAA;AAPY,YAAY;IADxB,IAAA,yCAA0B,EAAC,cAAc,CAAC;GAC9B,YAAY,CAOxB;AAPY,oCAAY;AASzB;;;;;;;;GAQG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,KAAkC,EAClC,UAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,UAAK,GAAL,KAAK,CAA6B;QAClC,eAAU,GAAV,UAAU,CAAY;IAGxC,CAAC;CACF,CAAA;AARY,mBAAmB;IAD/B,IAAA,yCAA0B,EAAC,qBAAqB,CAAC;GACrC,mBAAmB,CAQ/B;AARY,kDAAmB;AAUhC;;;;;GAKG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,KAAK;IACpD,YAAmB,OAAe,EAAkB,iBAAyB;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QADmC,sBAAiB,GAAjB,iBAAiB,CAAQ;IAE7E,CAAC;CACF,CAAA;AAJY,2BAA2B;IADvC,IAAA,yCAA0B,EAAC,sCAAsC,CAAC;GACtD,2BAA2B,CAIvC;AAJY,kEAA2B;AAMxC,SAAgB,kBAAkB,CAAC,GAAY;IAC7C,OAAO,CACL,IAAA,sBAAO,EAAC,GAAG,CAAC;QACZ,OAAQ,GAAwB,EAAE,OAAO,KAAK,QAAQ;QACtD,IAAA,uBAAQ,EAAE,GAAwB,CAAC,QAAQ,CAAC,CAC7C,CAAC;AACJ,CAAC;AAND,gDAMC;AAED;;GAEG;AACU,QAAA,qBAAqB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;;;;;;;AAEA,sEAAoG;AAEpG;;GAEG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,KAAK;IAGrC,YAAY,OAAe,EAAE,IAAuB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC;IAC3B,CAAC;CACF,CAAA;AAPY,YAAY;IADxB,IAAA,yCAA0B,EAAC,cAAc,CAAC;GAC9B,YAAY,CAOxB;AAPY,oCAAY;AASzB;;;;;;;;GAQG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,KAAkC,EAClC,UAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,UAAK,GAAL,KAAK,CAA6B;QAClC,eAAU,GAAV,UAAU,CAAY;IAGxC,CAAC;CACF,CAAA;AARY,mBAAmB;IAD/B,IAAA,yCAA0B,EAAC,qBAAqB,CAAC;GACrC,mBAAmB,CAQ/B;AARY,kDAAmB;AAUhC;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,KAAK;IAClD,YAAmB,OAAe,EAAkB,KAAkC;QACpF,KAAK,CAAC,OAAO,CAAC,CAAC;QADmC,UAAK,GAAL,KAAK,CAA6B;IAEtF,CAAC;CACF,CAAA;AAJY,yBAAyB;IADrC,IAAA,yCAA0B,EAAC,2BAA2B,CAAC;GAC3C,yBAAyB,CAIrC;AAJY,8DAAyB;AAMtC;;;;;GAKG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,KAAK;IACpD,YAAmB,OAAe,EAAkB,iBAAyB;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QADmC,sBAAiB,GAAjB,iBAAiB,CAAQ;IAE7E,CAAC;CACF,CAAA;AAJY,2BAA2B;IADvC,IAAA,yCAA0B,EAAC,sCAAsC,CAAC;GACtD,2BAA2B,CAIvC;AAJY,kEAA2B;AAMxC,SAAgB,kBAAkB,CAAC,GAAY;IAC7C,OAAO,CACL,IAAA,sBAAO,EAAC,GAAG,CAAC;QACZ,OAAQ,GAAwB,EAAE,OAAO,KAAK,QAAQ;QACtD,IAAA,uBAAQ,EAAE,GAAwB,CAAC,QAAQ,CAAC,CAC7C,CAAC;AACJ,CAAC;AAND,gDAMC;AAED;;GAEG;AACU,QAAA,qBAAqB,GAAG,kBAAkB,CAAC"}

package/lib/interceptors.d.ts

@@ -7,8 +7,8 @@ import { Headers, Next } from '@temporalio/common';
 import { temporal } from '@temporalio/proto';
 import { CompiledScheduleOptions } from './schedule-types';
 import { DescribeWorkflowExecutionResponse, RequestCancelWorkflowExecutionResponse, TerminateWorkflowExecutionResponse, WorkflowExecution } from './types';
-import { CompiledWorkflowOptions } from './workflow-options';
-export { Next, Headers };
+import { CompiledWorkflowOptions, WorkflowUpdateOptions } from './workflow-options';
+export { Headers, Next };
 /** Input for WorkflowClientInterceptor.start */
 export interface WorkflowStartInput {
     /** Name of Workflow to start */
@@ -16,6 +16,21 @@ export interface WorkflowStartInput {
     readonly headers: Headers;
     readonly options: CompiledWorkflowOptions;
 }
+/** Input for WorkflowClientInterceptor.update */
+export interface WorkflowStartUpdateInput {
+    readonly updateName: string;
+    readonly args: unknown[];
+    readonly workflowExecution: WorkflowExecution;
+    readonly firstExecutionRunId?: string;
+    readonly headers: Headers;
+    readonly options: WorkflowUpdateOptions;
+}
+/** Output for WorkflowClientInterceptor.startUpdate */
+export interface WorkflowStartUpdateOutput {
+    readonly updateId: string;
+    readonly workflowRunId: string;
+    readonly outcome?: temporal.api.update.v1.IOutcome;
+}
 /** Input for WorkflowClientInterceptor.signal */
 export interface WorkflowSignalInput {
     readonly signalName: string;
@@ -66,6 +81,12 @@ export interface WorkflowClientInterceptor {
      * {@link signalWithStart} most likely needs to be implemented too
      */
     start?: (input: WorkflowStartInput, next: Next<this, 'start'>) => Promise<string>;
+    /**
+     * Intercept a service call to updateWorkflowExecution
+     *
+     * @experimental Update is an experimental feature.
+     */
+    startUpdate?: (input: WorkflowStartUpdateInput, next: Next<this, 'startUpdate'>) => Promise<WorkflowStartUpdateOutput>;
     /**
      * Intercept a service call to signalWorkflowExecution
      *

package/lib/types.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import type * as grpc from '@grpc/grpc-js';
 import type { SearchAttributes } from '@temporalio/common';
 import * as proto from '@temporalio/proto';
@@ -62,6 +63,7 @@ export interface CallContext {
      * Metadata to set on gRPC requests
      */
     metadata?: Metadata;
+    abortSignal?: AbortSignal;
 }
 /**
  * Connection interface used by high level SDK clients.
@@ -83,4 +85,11 @@ export interface ConnectionLike {
      * @returns returned value of `fn`
      */
     withMetadata<R>(metadata: Metadata, fn: () => Promise<R>): Promise<R>;
+    /**
+     * Set an {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} that, when aborted,
+     * cancels any ongoing requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
+     */
+    withAbortSignal<R>(abortSignal: AbortSignal, fn: () => Promise<R>): Promise<R>;
 }

package/lib/workflow-client.d.ts

@@ -1,10 +1,10 @@
 import { status as grpcStatus } from '@grpc/grpc-js';
-import { BaseWorkflowHandle, HistoryAndWorkflowId, QueryDefinition, WithWorkflowArgs, Workflow, WorkflowResultType } from '@temporalio/common';
+import { BaseWorkflowHandle, HistoryAndWorkflowId, QueryDefinition, UpdateDefinition, WithWorkflowArgs, Workflow, WorkflowResultType } from '@temporalio/common';
 import { History } from '@temporalio/common/lib/proto-utils';
 import { temporal } from '@temporalio/proto';
-import { WorkflowCancelInput, WorkflowClientInterceptor, WorkflowClientInterceptors, WorkflowDescribeInput, WorkflowQueryInput, WorkflowSignalInput, WorkflowSignalWithStartInput, WorkflowStartInput, WorkflowTerminateInput } from './interceptors';
+import { WorkflowCancelInput, WorkflowClientInterceptor, WorkflowClientInterceptors, WorkflowDescribeInput, WorkflowQueryInput, WorkflowSignalInput, WorkflowSignalWithStartInput, WorkflowStartInput, WorkflowTerminateInput, WorkflowStartUpdateInput, WorkflowStartUpdateOutput } from './interceptors';
 import { DescribeWorkflowExecutionResponse, RequestCancelWorkflowExecutionResponse, TerminateWorkflowExecutionResponse, WorkflowExecution, WorkflowExecutionDescription, WorkflowExecutionInfo, WorkflowService } from './types';
-import { WorkflowOptions, WorkflowSignalWithStartOptions, WorkflowStartOptions } from './workflow-options';
+import { WorkflowOptions, WorkflowSignalWithStartOptions, WorkflowStartOptions, WorkflowUpdateOptions } from './workflow-options';
 import { BaseClient, BaseClientOptions, LoadedWithDefaults } from './base-client';
 /**
  * A client side handle to a single Workflow instance.
@@ -12,8 +12,9 @@ import { BaseClient, BaseClientOptions, LoadedWithDefaults } from './base-client
  *
  * Given the following Workflow definition:
  * ```ts
- * export const incrementSignal = defineSignal('increment');
+ * export const incrementSignal = defineSignal<[number]>('increment');
  * export const getValueQuery = defineQuery<number>('getValue');
+ * export const incrementAndGetValueUpdate = defineUpdate<number, [number]>('incrementAndGetValue');
  * export async function counterWorkflow(initialValue: number): Promise<void>;
  * ```
  *
@@ -27,12 +28,63 @@ import { BaseClient, BaseClientOptions, LoadedWithDefaults } from './base-client
  *   taskQueue: 'tutorial',
  * });
  * await handle.signal(incrementSignal, 2);
- * await handle.query(getValueQuery); // 4
+ * const queryResult = await handle.query(getValueQuery); // 4
+ * const firstUpdateResult = await handle.executeUpdate(incrementAndGetValueUpdate, { args: [2] }); // 6
+ * const secondUpdateHandle = await handle.startUpdate(incrementAndGetValueUpdate, { args: [2] });
+ * const secondUpdateResult = await secondUpdateHandle.result(); // 8
  * await handle.cancel();
- * await handle.result(); // throws WorkflowExecutionCancelledError
+ * await handle.result(); // throws a WorkflowFailedError with `cause` set to a CancelledFailure.
  * ```
  */
 export interface WorkflowHandle<T extends Workflow = Workflow> extends BaseWorkflowHandle<T> {
+    /**
+     * Start an Update and wait for the result.
+     *
+     * @experimental Update is an experimental feature.
+     *
+     * @throws {@link WorkflowUpdateFailedError} if Update validation fails or if ApplicationFailure is thrown in the Update handler.
+     *
+     * @param def an Update definition as returned from {@link defineUpdate}
+     * @param options Update arguments
+     *
+     * @example
+     * ```ts
+     * const updateResult = await handle.executeUpdate(incrementAndGetValueUpdate, { args: [2] });
+     * ```
+     */
+    executeUpdate<Ret, Args extends [any, ...any[]], Name extends string = string>(def: UpdateDefinition<Ret, Args, Name> | string, options: WorkflowUpdateOptions & {
+        args: Args;
+    }): Promise<Ret>;
+    executeUpdate<Ret, Args extends [], Name extends string = string>(def: UpdateDefinition<Ret, Args, Name> | string, options?: WorkflowUpdateOptions & {
+        args?: Args;
+    }): Promise<Ret>;
+    /**
+     * Start an Update and receive a handle to the Update.
+     * The Update validator (if present) is run before the handle is returned.
+     *
+     * @experimental Update is an experimental feature.
+     *
+     * @throws {@link WorkflowUpdateFailedError} if Update validation fails.
+     *
+     * @param def an Update definition as returned from {@link defineUpdate}
+     * @param options Update arguments
+     *
+     * @example
+     * ```ts
+     * const updateHandle = await handle.startUpdate(incrementAndGetValueUpdate, { args: [2] });
+     * const updateResult = await updateHandle.result();
+     * ```
+     */
+    startUpdate<Ret, Args extends [any, ...any[]], Name extends string = string>(def: UpdateDefinition<Ret, Args, Name> | string, options: WorkflowUpdateOptions & {
+        args: Args;
+    }): Promise<WorkflowUpdateHandle<Ret>>;
+    startUpdate<Ret, Args extends [], Name extends string = string>(def: UpdateDefinition<Ret, Args, Name> | string, options?: WorkflowUpdateOptions & {
+        args?: Args;
+    }): Promise<WorkflowUpdateHandle<Ret>>;
+    /**
+     * Get a handle to an Update.
+     */
+    getUpdateHandle<Ret>(updateId: string, workflowId: string, options?: GetWorkflowUpdateHandleOptions): WorkflowUpdateHandle<Ret>;
     /**
      * Query a running or completed Workflow.
      *
@@ -128,6 +180,9 @@ export interface WorkflowResultOptions {
      */
     followRuns?: boolean;
 }
+/**
+ * Options for {@link WorkflowClient.getHandle}
+ */
 export interface GetWorkflowHandleOptions extends WorkflowResultOptions {
     /**
      * ID of the first execution in the Workflow execution chain.
@@ -163,6 +218,37 @@ export interface AsyncWorkflowListIterable extends AsyncIterable<WorkflowExecuti
      */
     intoHistories: (intoHistoriesOptions?: IntoHistoriesOptions) => AsyncIterable<HistoryAndWorkflowId>;
 }
+/**
+ * A client-side handle to an Update.
+ */
+export interface WorkflowUpdateHandle<Ret> {
+    /**
+     * The ID of this Update request.
+     */
+    updateId: string;
+    /**
+     * The ID of the Workflow being targeted by this Update request.
+     */
+    workflowId: string;
+    /**
+     * The ID of the Run of the Workflow being targeted by this Update request.
+     */
+    workflowRunId?: string;
+    /**
+     * Return the result of the Update.
+     * @throws {@link WorkflowUpdateFailedError} if ApplicationFailure is thrown in the Update handler.
+     */
+    result(): Promise<Ret>;
+}
+/**
+ * Options for {@link WorkflowHandle.getUpdateHandle}
+ */
+export interface GetWorkflowUpdateHandleOptions {
+    /**
+     * The ID of the Run of the Workflow targeted by the Update.
+     */
+    workflowRunId?: string;
+}
 /**
  * Options for {@link WorkflowClient.list}
  */
@@ -262,6 +348,18 @@ export declare class WorkflowClient extends BaseClient {
      * Used as the final function of the query interceptor chain
      */
     protected _queryWorkflowHandler(input: WorkflowQueryInput): Promise<unknown>;
+    /**
+     * Start the Update.
+     *
+     * Used as the final function of the interceptor chain during startUpdate and executeUpdate.
+     */
+    protected _startUpdateHandler(waitForStage: temporal.api.enums.v1.UpdateWorkflowExecutionLifecycleStage, input: WorkflowStartUpdateInput): Promise<WorkflowStartUpdateOutput>;
+    protected createWorkflowUpdateHandle<Ret>(updateId: string, workflowId: string, options?: GetWorkflowUpdateHandleOptions, outcome?: temporal.api.update.v1.IOutcome): WorkflowUpdateHandle<Ret>;
+    /**
+     * Poll Update until a response with an outcome is received; return that outcome.
+     * This is used directly; no interceptor is available.
+     */
+    protected _pollForUpdateOutcome(updateId: string, workflowExecution: temporal.api.common.v1.IWorkflowExecution): Promise<temporal.api.update.v1.IOutcome>;
     /**
      * Uses given input to make a signalWorkflowExecution call to the service
      *