@temporalio/client 1.0.0-rc.0 → 1.0.0-rc.1

package/lib/async-completion-client.d.ts

@@ -2,15 +2,15 @@ import { DataConverter, LoadedDataConverter } from '@temporalio/common';
 import { Replace } from '@temporalio/internal-workflow-common';
 import { ConnectionLike, WorkflowService } from './types';
 /**
- * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat
- * an Activity which does not exist in the system.
+ * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat an Activity that does not exist in the
+ * system.
  */
 export declare class ActivityNotFoundError extends Error {
     readonly name = "ActivityNotFoundError";
 }
 /**
  * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat
- * an Activity for any reason apart from "not found".
+ * an Activity for any reason apart from {@link ActivityNotFoundError}.
  */
 export declare class ActivityCompletionError extends Error {
     readonly name = "ActivityCompletionError";

package/lib/async-completion-client.js

@@ -11,8 +11,8 @@ const os_1 = __importDefault(require("os"));
 const connection_1 = require("./connection");
 const errors_1 = require("./errors");
 /**
- * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat
- * an Activity which does not exist in the system.
+ * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat an Activity that does not exist in the
+ * system.
  */
 class ActivityNotFoundError extends Error {
     constructor() {
@@ -23,7 +23,7 @@ class ActivityNotFoundError extends Error {
 exports.ActivityNotFoundError = ActivityNotFoundError;
 /**
  * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat
- * an Activity for any reason apart from "not found".
+ * an Activity for any reason apart from {@link ActivityNotFoundError}.
  */
 class ActivityCompletionError extends Error {
     constructor() {

package/lib/connection.d.ts

@@ -5,7 +5,7 @@ import { AsyncLocalStorage } from 'async_hooks';
 import type { RPCImpl } from 'protobufjs';
 import { CallContext, Metadata, OperatorService, WorkflowService } from './types';
 /**
- * GRPC + Temporal server connection options
+ * gRPC and Temporal Server connection options
  */
 export interface ConnectionOptions {
     /**
@@ -83,12 +83,15 @@ export interface ConnectionCtorOptions {
     readonly callContextStorage: AsyncLocalStorage<CallContext>;
 }
 /**
- * Client connection to the Temporal Service
+ * Client connection to the Temporal Server
  *
- * NOTE: Connections are expensive to construct and should be reused.
- * Make sure to `close()` any unused connections to avoid leaking resources.
+ * ⚠️ Connections are expensive to construct and should be reused. Make sure to {@link close} any unused connections to
+ * avoid leaking resources.
  */
 export declare class Connection {
+    /**
+     * @internal
+     */
     static readonly Client: grpc.ServiceClientConstructor;
     readonly options: ConnectionOptionsWithDefaults;
     protected readonly client: grpc.Client;
@@ -97,56 +100,65 @@ export declare class Connection {
      */
     protected connectPromise?: Promise<void>;
     /**
-     * Raw gRPC access to the Temporal service.
+     * Raw gRPC access to Temporal Server's {@link
+     * https://github.com/temporalio/api/blob/master/temporal/api/workflowservice/v1/service.proto | Workflow service}
      */
     readonly workflowService: WorkflowService;
+    /**
+     * Raw gRPC access to Temporal Server's
+     * {@link https://github.com/temporalio/api/blob/master/temporal/api/operatorservice/v1/service.proto | Operator service}
+     */
     readonly operatorService: OperatorService;
     readonly callContextStorage: AsyncLocalStorage<CallContext>;
     protected static createCtorOptions(options?: ConnectionOptions): ConnectionCtorOptions;
     /**
      * Ensure connection can be established.
      *
+     * Does not need to be called if you use {@link connect}.
+     *
      * This method's result is memoized to ensure it runs only once.
      *
-     * Calls WorkflowService.getSystemInfo internally.
+     * Calls {@link proto.temporal.api.workflowservice.v1.WorkflowService.getSystemInfo} internally.
      */
     ensureConnected(): Promise<void>;
     /**
-     * Create a lazy Connection instance.
+     * Create a lazy `Connection` instance.
      *
-     * This method does not verify connectivity with the server, it is recommended to use
-     * {@link connect} instead.
+     * This method does not verify connectivity with the server. We recommend using {@link connect} instead.
      */
     static lazy(options?: ConnectionOptions): Connection;
     /**
-     * Establish a connection with the server and return a Connection instance.
+     * Establish a connection with the server and return a `Connection` instance.
      *
-     * This is the preferred method of creating connections as it verifies connectivity.
+     * This is the preferred method of creating connections as it verifies connectivity by calling
+     * {@link ensureConnected}.
      */
     static connect(options?: ConnectionOptions): Promise<Connection>;
     protected constructor({ options, client, workflowService, operatorService, callContextStorage, }: ConnectionCtorOptions);
     protected static generateRPCImplementation({ serviceName, client, callContextStorage, interceptors, }: RPCImplOptions): RPCImpl;
     /**
      * Set the deadline for any service requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
      */
-    withDeadline<R>(deadline: number | Date, fn: () => Promise<R>): Promise<R>;
+    withDeadline<ReturnType>(deadline: number | Date, fn: () => Promise<ReturnType>): Promise<ReturnType>;
     /**
      * Set metadata for any service requests executed in `fn`'s scope.
      *
-     * The provided metadata is merged on top of any existing metadata in current scope
-     * including metadata provided in {@link ConnectionOptions.metadata}
+     * The provided metadata is merged on top of any existing metadata in current scope, including metadata provided in
+     * {@link ConnectionOptions.metadata}.
      *
-     * @returns returned value of `fn`
+     * @returns value returned from `fn`
      *
      * @example
      *
-     * ```ts
-     * 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<R>(metadata: Metadata, fn: () => Promise<R>): Promise<R>;
+    withMetadata<ReturnType>(metadata: Metadata, fn: () => Promise<ReturnType>): Promise<ReturnType>;
     /**
      * Wait for successful connection to the server.
      *

package/lib/connection.js

@@ -83,10 +83,10 @@ function normalizeGRPCConfig(options) {
     }
 }
 /**
- * Client connection to the Temporal Service
+ * Client connection to the Temporal Server
  *
- * NOTE: Connections are expensive to construct and should be reused.
- * Make sure to `close()` any unused connections to avoid leaking resources.
+ * ⚠️ Connections are expensive to construct and should be reused. Make sure to {@link close} any unused connections to
+ * avoid leaking resources.
  */
 class Connection {
     constructor({ options, client, workflowService, operatorService, callContextStorage, }) {
@@ -133,9 +133,11 @@ class Connection {
     /**
      * Ensure connection can be established.
      *
+     * Does not need to be called if you use {@link connect}.
+     *
      * This method's result is memoized to ensure it runs only once.
      *
-     * Calls WorkflowService.getSystemInfo internally.
+     * Calls {@link proto.temporal.api.workflowservice.v1.WorkflowService.getSystemInfo} internally.
      */
     async ensureConnected() {
         if (this.connectPromise == null) {
@@ -161,18 +163,18 @@ class Connection {
         return this.connectPromise;
     }
     /**
-     * Create a lazy Connection instance.
+     * Create a lazy `Connection` instance.
      *
-     * This method does not verify connectivity with the server, it is recommended to use
-     * {@link connect} instead.
+     * This method does not verify connectivity with the server. We recommend using {@link connect} instead.
      */
     static lazy(options) {
         return new this(this.createCtorOptions(options));
     }
     /**
-     * Establish a connection with the server and return a Connection instance.
+     * Establish a connection with the server and return a `Connection` instance.
      *
-     * This is the preferred method of creating connections as it verifies connectivity.
+     * This is the preferred method of creating connections as it verifies connectivity by calling
+     * {@link ensureConnected}.
      */
     static async connect(options) {
         const conn = this.lazy(options);
@@ -193,6 +195,8 @@ class Connection {
     }
     /**
      * Set the deadline for any service requests executed in `fn`'s scope.
+     *
+     * @returns value returned from `fn`
      */
     async withDeadline(deadline, fn) {
         const cc = this.callContextStorage.getStore();
@@ -201,18 +205,18 @@ class Connection {
     /**
      * Set metadata for any service requests executed in `fn`'s scope.
      *
-     * The provided metadata is merged on top of any existing metadata in current scope
-     * including metadata provided in {@link ConnectionOptions.metadata}
+     * The provided metadata is merged on top of any existing metadata in current scope, including metadata provided in
+     * {@link ConnectionOptions.metadata}.
      *
-     * @returns returned value of `fn`
+     * @returns value returned from `fn`
      *
      * @example
      *
-     * ```ts
-     * 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();
@@ -247,5 +251,8 @@ class Connection {
     }
 }
 exports.Connection = Connection;
+/**
+ * @internal
+ */
 Connection.Client = grpc.makeGenericClientConstructor({}, 'WorkflowService', {});
 //# sourceMappingURL=connection.js.map

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":"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"}

package/lib/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * Client for communicating with the Temporal service.
+ * Client for communicating with Temporal Server.
  *
- * Interact with workflows using {@link WorkflowClient} or call GRPC methods directly using {@link Connection.workflowService}.
+ * Most functionality is available through {@link WorkflowClient}, but you can also call gRPC methods directly using {@link Connection.workflowService} and {@link Connection.operatorService}.
  *
  * ### Usage
  * <!--SNIPSTART typescript-hello-client-->
@@ -11,7 +11,9 @@
 export { ActivityFailure, ApplicationFailure, CancelledFailure, ChildWorkflowFailure, DataConverter, defaultPayloadConverter, ProtoFailure, ServerFailure, TemporalFailure, TerminatedFailure, TimeoutFailure, } from '@temporalio/common';
 export { TLSConfig } from '@temporalio/internal-non-workflow-common';
 export { RetryPolicy } from '@temporalio/internal-workflow-common';
+export * from '@temporalio/internal-workflow-common/lib/errors';
 export * from '@temporalio/internal-workflow-common/lib/interfaces';
+export * from '@temporalio/internal-workflow-common/lib/workflow-handle';
 export * from './async-completion-client';
 export { Connection, ConnectionOptions, ConnectionOptionsWithDefaults, LOCAL_TARGET } from './connection';
 export * from './errors';

package/lib/index.js

@@ -1,8 +1,8 @@
 "use strict";
 /**
- * Client for communicating with the Temporal service.
+ * Client for communicating with Temporal Server.
  *
- * Interact with workflows using {@link WorkflowClient} or call GRPC methods directly using {@link Connection.workflowService}.
+ * Most functionality is available through {@link WorkflowClient}, but you can also call gRPC methods directly using {@link Connection.workflowService} and {@link Connection.operatorService}.
  *
  * ### Usage
  * <!--SNIPSTART typescript-hello-client-->
@@ -35,7 +35,9 @@ Object.defineProperty(exports, "ServerFailure", { enumerable: true, get: functio
 Object.defineProperty(exports, "TemporalFailure", { enumerable: true, get: function () { return common_1.TemporalFailure; } });
 Object.defineProperty(exports, "TerminatedFailure", { enumerable: true, get: function () { return common_1.TerminatedFailure; } });
 Object.defineProperty(exports, "TimeoutFailure", { enumerable: true, get: function () { return common_1.TimeoutFailure; } });
+__exportStar(require("@temporalio/internal-workflow-common/lib/errors"), exports);
 __exportStar(require("@temporalio/internal-workflow-common/lib/interfaces"), exports);
+__exportStar(require("@temporalio/internal-workflow-common/lib/workflow-handle"), exports);
 __exportStar(require("./async-completion-client"), exports);
 var connection_1 = require("./connection");
 Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return connection_1.Connection; } });

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,6CAY4B;AAX1B,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AAEpB,iHAAA,uBAAuB,OAAA;AAEvB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,wGAAA,cAAc,OAAA;AAIhB,sFAAoE;AACpE,4DAA0C;AAC1C,2CAA0G;AAAjG,wGAAA,UAAU,OAAA;AAAoD,0GAAA,YAAY,OAAA;AACnF,2CAAyB;AACzB,+CAA6B;AAC7B,iDAA+B;AAC/B,0CAAwB;AACxB,oDAAkC;AAClC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,6CAY4B;AAX1B,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AAEpB,iHAAA,uBAAuB,OAAA;AAEvB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,wGAAA,cAAc,OAAA;AAIhB,kFAAgE;AAChE,sFAAoE;AACpE,2FAAyE;AACzE,4DAA0C;AAC1C,2CAA0G;AAAjG,wGAAA,UAAU,OAAA;AAAoD,0GAAA,YAAY,OAAA;AACnF,2CAAyB;AACzB,+CAA6B;AAC7B,iDAA+B;AAC/B,0CAAwB;AACxB,oDAAkC;AAClC,qDAAmC"}

package/lib/workflow-client.d.ts

@@ -290,9 +290,9 @@ export declare class WorkflowClient {
      *   most recent Workflow Execution in the *Chain* that started with `firstExecutionRunId`.
      *
      * A *Chain* is a series of Workflow Executions that share the same Workflow ID and are connected by:
-     * - Being part of the same [Cron](https://docs.temporal.io/typescript/clients#scheduling-cron-workflows)
-     * - [Continue As New](https://docs.temporal.io/typescript/workflows#continueasnew)
-     * - [Retries](https://typescript.temporal.io/api/interfaces/client.workflowoptions/#retry)
+     * - Being part of the same {@link https://docs.temporal.io/typescript/clients#scheduling-cron-workflows | Cron}
+     * - {@link https://docs.temporal.io/typescript/workflows#continueasnew | Continue As New}
+     * - {@link https://typescript.temporal.io/api/interfaces/client.workflowoptions/#retry | Retries}
      *
      * This method does not validate `workflowId`. If there is no Workflow Execution with the given `workflowId`, handle
      * methods like `handle.describe()` will throw a {@link WorkflowNotFoundError} error.

package/lib/workflow-client.js

@@ -565,9 +565,9 @@ class WorkflowClient {
      *   most recent Workflow Execution in the *Chain* that started with `firstExecutionRunId`.
      *
      * A *Chain* is a series of Workflow Executions that share the same Workflow ID and are connected by:
-     * - Being part of the same [Cron](https://docs.temporal.io/typescript/clients#scheduling-cron-workflows)
-     * - [Continue As New](https://docs.temporal.io/typescript/workflows#continueasnew)
-     * - [Retries](https://typescript.temporal.io/api/interfaces/client.workflowoptions/#retry)
+     * - Being part of the same {@link https://docs.temporal.io/typescript/clients#scheduling-cron-workflows | Cron}
+     * - {@link https://docs.temporal.io/typescript/workflows#continueasnew | Continue As New}
+     * - {@link https://typescript.temporal.io/api/interfaces/client.workflowoptions/#retry | Retries}
      *
      * This method does not validate `workflowId`. If there is no Workflow Execution with the given `workflowId`, handle
      * methods like `handle.describe()` will throw a {@link WorkflowNotFoundError} error.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temporalio/client",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.0-rc.1",
   "description": "Temporal.io SDK Client sub-package",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -13,24 +13,25 @@
   "author": "Roey Berman <roey@temporal.io>",
   "license": "MIT",
   "dependencies": {
-    "@grpc/grpc-js": "^1.5.7",
-    "@temporalio/common": "^1.0.0-rc.0",
-    "@temporalio/internal-non-workflow-common": "^1.0.0-rc.0",
-    "@temporalio/internal-workflow-common": "^1.0.0-rc.0",
-    "@temporalio/proto": "^1.0.0-rc.0",
+    "@grpc/grpc-js": "^1.6.7",
+    "@temporalio/common": "^1.0.0-rc.1",
+    "@temporalio/internal-non-workflow-common": "^1.0.0-rc.1",
+    "@temporalio/internal-workflow-common": "^1.0.0-rc.1",
+    "@temporalio/proto": "^1.0.0-rc.1",
     "ms": "^2.1.3",
-    "protobufjs": "^6.11.2",
+    "protobufjs": "6.11.2",
     "uuid": "^8.3.2"
   },
   "bugs": {
     "url": "https://github.com/temporalio/sdk-typescript/issues"
   },
   "homepage": "https://github.com/temporalio/sdk-typescript/tree/main/packages/client",
-  "files": [
-    "lib"
-  ],
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "c25e91309b980f2118df4048d760306982019871"
+  "files": [
+    "src",
+    "lib"
+  ],
+  "gitHead": "723de0fbc7a04e68084ec99453578e7027eb3803"
 }

package/src/async-completion-client.ts

@@ -0,0 +1,256 @@
+import { Status } from '@grpc/grpc-js/build/src/constants';
+import { DataConverter, ensureTemporalFailure, LoadedDataConverter } from '@temporalio/common';
+import {
+  encodeErrorToFailure,
+  encodeToPayloads,
+  filterNullAndUndefined,
+  loadDataConverter,
+} from '@temporalio/internal-non-workflow-common';
+import { Replace } from '@temporalio/internal-workflow-common';
+import os from 'os';
+import { Connection } from './connection';
+import { isServerErrorResponse } from './errors';
+import { ConnectionLike, WorkflowService } from './types';
+
+/**
+ * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat an Activity that does not exist in the
+ * system.
+ */
+export class ActivityNotFoundError extends Error {
+  public readonly name = 'ActivityNotFoundError';
+}
+
+/**
+ * Thrown by {@link AsyncCompletionClient} when trying to complete or heartbeat
+ * an Activity for any reason apart from {@link ActivityNotFoundError}.
+ */
+export class ActivityCompletionError extends Error {
+  public readonly name = 'ActivityCompletionError';
+}
+
+/**
+ * Thrown by {@link AsyncCompletionClient.heartbeat} when the Workflow has
+ * requested to cancel the reporting Activity.
+ */
+export class ActivityCancelledError extends Error {
+  public readonly name = 'ActivityCancelledError';
+}
+
+/**
+ * Options used to configure {@link AsyncCompletionClient}
+ */
+export interface AsyncCompletionClientOptions {
+  /**
+   * {@link DataConverter} to use for serializing and deserializing payloads
+   */
+  dataConverter?: DataConverter;
+
+  /**
+   * Identity to report to the server
+   *
+   * @default `${process.pid}@${os.hostname()}`
+   */
+  identity?: string;
+
+  connection?: ConnectionLike;
+
+  /**
+   * Server namespace
+   *
+   * @default default
+   */
+  namespace?: string;
+}
+
+export type AsyncCompletionClientOptionsWithDefaults = Replace<
+  Required<AsyncCompletionClientOptions>,
+  {
+    connection?: ConnectionLike;
+  }
+>;
+
+export function defaultAsyncCompletionClientOptions(): AsyncCompletionClientOptionsWithDefaults {
+  return {
+    dataConverter: {},
+    identity: `${process.pid}@${os.hostname()}`,
+    namespace: 'default',
+  };
+}
+
+/**
+ * A mostly unique Activity identifier including its scheduling workflow's ID
+ * and an optional runId.
+ *
+ * Activity IDs may be reused in a single Workflow run as long as a previous
+ * Activity with the same ID has completed already.
+ */
+export interface FullActivityId {
+  workflowId: string;
+  runId?: string;
+  activityId: string;
+}
+
+/**
+ * A client for asynchronous completion and heartbeating of Activities.
+ */
+export class AsyncCompletionClient {
+  public readonly options: AsyncCompletionClientOptionsWithDefaults;
+  protected readonly dataConverter: LoadedDataConverter;
+  public readonly connection: ConnectionLike;
+
+  constructor(options?: AsyncCompletionClientOptions) {
+    this.connection = options?.connection ?? Connection.lazy();
+    this.dataConverter = loadDataConverter(options?.dataConverter);
+    this.options = { ...defaultAsyncCompletionClientOptions(), ...filterNullAndUndefined(options ?? {}) };
+  }
+
+  get workflowService(): WorkflowService {
+    return this.connection.workflowService;
+  }
+
+  /**
+   * Transforms grpc errors into well defined TS errors.
+   */
+  protected handleError(err: unknown): never {
+    if (isServerErrorResponse(err)) {
+      if (err.code === Status.NOT_FOUND) {
+        throw new ActivityNotFoundError('Not found');
+      }
+      throw new ActivityCompletionError(err.details || err.message);
+    }
+    throw new ActivityCompletionError('Unexpected failure');
+  }
+
+  /**
+   * Complete an Activity by task token
+   */
+  async complete(taskToken: Uint8Array, result: unknown): Promise<void>;
+  /**
+   * Complete an Activity by full ID
+   */
+  async complete(fullActivityId: FullActivityId, result: unknown): Promise<void>;
+
+  async complete(taskTokenOrFullActivityId: Uint8Array | FullActivityId, result: unknown): Promise<void> {
+    try {
+      if (taskTokenOrFullActivityId instanceof Uint8Array) {
+        await this.workflowService.respondActivityTaskCompleted({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          taskToken: taskTokenOrFullActivityId,
+          result: { payloads: await encodeToPayloads(this.dataConverter, result) },
+        });
+      } else {
+        await this.workflowService.respondActivityTaskCompletedById({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          ...taskTokenOrFullActivityId,
+          result: { payloads: await encodeToPayloads(this.dataConverter, result) },
+        });
+      }
+    } catch (err) {
+      this.handleError(err);
+    }
+  }
+
+  /**
+   * Fail an Activity by task token
+   */
+  async fail(taskToken: Uint8Array, err: unknown): Promise<void>;
+  /**
+   * Fail an Activity by full ID
+   */
+  async fail(fullActivityId: FullActivityId, err: unknown): Promise<void>;
+
+  async fail(taskTokenOrFullActivityId: Uint8Array | FullActivityId, err: unknown): Promise<void> {
+    try {
+      if (taskTokenOrFullActivityId instanceof Uint8Array) {
+        await this.workflowService.respondActivityTaskFailed({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          taskToken: taskTokenOrFullActivityId,
+          failure: await encodeErrorToFailure(this.dataConverter, ensureTemporalFailure(err)),
+        });
+      } else {
+        await this.workflowService.respondActivityTaskFailedById({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          ...taskTokenOrFullActivityId,
+          failure: await encodeErrorToFailure(this.dataConverter, err),
+        });
+      }
+    } catch (err) {
+      this.handleError(err);
+    }
+  }
+
+  /**
+   * Report Activity cancellation by task token
+   */
+  reportCancellation(taskToken: Uint8Array, details?: unknown): Promise<void>;
+  /**
+   * Report Activity cancellation by full ID
+   */
+  reportCancellation(fullActivityId: FullActivityId, details?: unknown): Promise<void>;
+
+  async reportCancellation(taskTokenOrFullActivityId: Uint8Array | FullActivityId, details?: unknown): Promise<void> {
+    try {
+      if (taskTokenOrFullActivityId instanceof Uint8Array) {
+        await this.workflowService.respondActivityTaskCanceled({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          taskToken: taskTokenOrFullActivityId,
+          details: { payloads: await encodeToPayloads(this.dataConverter, details) },
+        });
+      } else {
+        await this.workflowService.respondActivityTaskCanceledById({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          ...taskTokenOrFullActivityId,
+          details: { payloads: await encodeToPayloads(this.dataConverter, details) },
+        });
+      }
+    } catch (err) {
+      this.handleError(err);
+    }
+  }
+
+  /**
+   * Send Activity heartbeat by task token
+   */
+  heartbeat(taskToken: Uint8Array, details?: unknown): Promise<void>;
+  /**
+   * Send Activity heartbeat by full ID
+   */
+  heartbeat(fullActivityId: FullActivityId, details?: unknown): Promise<void>;
+
+  async heartbeat(taskTokenOrFullActivityId: Uint8Array | FullActivityId, details?: unknown): Promise<void> {
+    try {
+      if (taskTokenOrFullActivityId instanceof Uint8Array) {
+        const { cancelRequested } = await this.workflowService.recordActivityTaskHeartbeat({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          taskToken: taskTokenOrFullActivityId,
+          details: { payloads: await encodeToPayloads(this.dataConverter, details) },
+        });
+        if (cancelRequested) {
+          throw new ActivityCancelledError('cancelled');
+        }
+      } else {
+        const { cancelRequested } = await this.workflowService.recordActivityTaskHeartbeatById({
+          identity: this.options.identity,
+          namespace: this.options.namespace,
+          ...taskTokenOrFullActivityId,
+          details: { payloads: await encodeToPayloads(this.dataConverter, details) },
+        });
+        if (cancelRequested) {
+          throw new ActivityCancelledError('cancelled');
+        }
+      }
+    } catch (err) {
+      if (err instanceof ActivityCancelledError) {
+        throw err;
+      }
+      this.handleError(err);
+    }
+  }
+}