@temporalio/testing 1.0.0-rc.0 → 1.0.1

package/lib/child-process.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { ChildProcess } from 'child_process';
 export declare class ChildProcessError extends Error {
     readonly code: number | null;

package/lib/index.d.ts

@@ -1,3 +1,13 @@
+/**
+ * `npm i @temporalio/testing`
+ *
+ * Testing library for the SDK.
+ *
+ * [Documentation](https://docs.temporal.io/typescript/testing)
+ *
+ * @module
+ */
+/// <reference types="node" />
 /// <reference types="node" />
 import * as activity from '@temporalio/activity';
 import { AsyncCompletionClient, WorkflowClient as BaseWorkflowClient, WorkflowClientOptions as BaseWorkflowClientOptions, WorkflowResultOptions as BaseWorkflowResultOptions, WorkflowStartOptions as BaseWorkflowStartOptions } from '@temporalio/client';

package/lib/index.js

@@ -1,4 +1,13 @@
 "use strict";
+/**
+ * `npm i @temporalio/testing`
+ *
+ * Testing library for the SDK.
+ *
+ * [Documentation](https://docs.temporal.io/typescript/testing)
+ *
+ * @module
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -202,6 +211,7 @@ exports.TestWorkflowEnvironment = TestWorkflowEnvironment;
  */
 exports.defaultActivityInfo = {
     attempt: 1,
+    taskQueue: 'test',
     isLocal: false,
     taskToken: Buffer.from('test'),
     activityId: 'test',
@@ -235,6 +245,9 @@ class MockActivityEnvironment extends events_1.default.EventEmitter {
         });
         const heartbeatCallback = (details) => this.emit('heartbeat', details);
         this.context = new activity.Context({ ...exports.defaultActivityInfo, ...info }, promise, abortController.signal, heartbeatCallback);
+        promise.catch(() => {
+            /* avoid unhandled rejection */
+        });
     }
     /**
      * Run a function in Activity Context

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temporalio/testing",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.1",
   "description": "Temporal.io SDK Testing sub-package",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -17,17 +17,17 @@
   "author": "Temporal Technologies Inc. <sdk@temporal.io>",
   "license": "MIT",
   "dependencies": {
-    "@grpc/grpc-js": "^1.5.7",
-    "@temporalio/activity": "^1.0.0-rc.0",
-    "@temporalio/client": "^1.0.0-rc.0",
-    "@temporalio/common": "^1.0.0-rc.0",
-    "@temporalio/worker": "^1.0.0-rc.0",
-    "@types/long": "^4.0.1",
+    "@grpc/grpc-js": "^1.6.7",
+    "@temporalio/activity": "^1.0.1",
+    "@temporalio/client": "^1.0.1",
+    "@temporalio/common": "^1.0.1",
+    "@temporalio/worker": "^1.0.1",
+    "@types/long": "^4.0.2",
     "abort-controller": "^3.0.0",
     "get-port": "^6.1.2",
-    "got": "^12.0.1",
-    "long": "^4.0.0",
-    "protobufjs": "^6.11.2",
+    "got": "^12.1.0",
+    "long": "^5.2.0",
+    "protobufjs": "^7.0.0",
     "tar-stream": "^2.2.0",
     "unzipper": "^0.10.11"
   },
@@ -37,11 +37,12 @@
   "homepage": "https://github.com/temporalio/sdk-typescript/tree/main/packages/testing",
   "files": [
     "lib",
+    "src",
     "generated-protos",
     "scripts"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "c25e91309b980f2118df4048d760306982019871"
+  "gitHead": "a1dae539e72b6b088b400998d7bef482e8ed52f1"
 }

package/scripts/compile-proto.mjs

@@ -1,12 +1,14 @@
+import { createRequire } from 'module';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { promisify } from 'util';
 import dedent from 'dedent';
 import glob from 'glob';
 import { statSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
-import pbjs from 'protobufjs/cli/pbjs.js';
-import pbts from 'protobufjs/cli/pbts.js';
+import pbjs from 'protobufjs-cli/pbjs.js';
+import pbts from 'protobufjs-cli/pbts.js';
 
+const require = createRequire(import.meta.url);
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const outputDir = resolve(__dirname, '../generated-protos');
 const outputFile = resolve(outputDir, 'index.js');
@@ -40,6 +42,7 @@ async function compileProtos(protoPath, jsOutputFile, dtsOutputFile, ...args) {
     '__temporal_testing',
     '--out',
     jsOutputFile,
+    resolve(require.resolve('protobufjs'), '../google/protobuf/descriptor.proto'),
     protoPath,
   ];
   await promisify(pbjs.main)(pbjsArgs);
@@ -58,24 +61,17 @@ async function compileProtos(protoPath, jsOutputFile, dtsOutputFile, ...args) {
   );
 }
 
-async function main() {
-  mkdirSync(outputDir, { recursive: true });
+mkdirSync(outputDir, { recursive: true });
 
-  const protoFiles = glob.sync(resolve(protoBaseDir, '**/*.proto'));
-  const protosMTime = Math.max(...protoFiles.map(mtime));
-  const genMTime = mtime(outputFile);
+const protoFiles = glob.sync(resolve(protoBaseDir, '**/*.proto'));
+const protosMTime = Math.max(...protoFiles.map(mtime));
+const genMTime = mtime(outputFile);
 
-  if (protosMTime < genMTime) {
-    console.log('Assuming protos are up to date');
-    return;
-  }
-
-  await compileProtos(serviceProtoPath, outputFile, resolve(outputDir, 'index.d.ts'), '--path', resolve(protoBaseDir));
-
-  console.log('Done');
+if (protosMTime < genMTime) {
+  console.log('Assuming protos are up to date');
+  process.exit(0);
 }
 
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
+await compileProtos(serviceProtoPath, outputFile, resolve(outputDir, 'index.d.ts'), '--path', resolve(protoBaseDir));
+
+console.log('Done');

package/src/assert-to-failure-interceptor.ts

@@ -0,0 +1,38 @@
+import assert from 'assert';
+import { ApplicationFailure, WorkflowInterceptors } from '@temporalio/workflow';
+
+/**
+ * Simple interceptor that transforms {@link assert.AssertionError} into non retryable failures.
+ *
+ * This allows conveniently using `assert` directly from Workflows.
+ */
+export function interceptors(): WorkflowInterceptors {
+  return {
+    inbound: [
+      {
+        async handleSignal(input, next) {
+          try {
+            return await next(input);
+          } catch (err) {
+            if (err instanceof assert.AssertionError) {
+              const appErr = ApplicationFailure.nonRetryable(err.message);
+              appErr.stack = err.stack;
+              throw appErr;
+            }
+          }
+        },
+        async execute(input, next) {
+          try {
+            return await next(input);
+          } catch (err) {
+            if (err instanceof assert.AssertionError) {
+              const appErr = ApplicationFailure.nonRetryable(err.message);
+              appErr.stack = err.stack;
+              throw appErr;
+            }
+          }
+        },
+      },
+    ],
+  };
+}

package/src/child-process.ts

@@ -0,0 +1,60 @@
+// TODO: this code is duplicated in the scripts directory, consider moving to external dependency
+import { ChildProcess } from 'child_process';
+
+export class ChildProcessError extends Error {
+  public readonly name = 'ChildProcessError';
+
+  constructor(message: string, public readonly code: number | null, public readonly signal: NodeJS.Signals | null) {
+    super(message);
+  }
+}
+
+export interface WaitOptions {
+  validReturnCodes: number[];
+}
+
+export async function waitOnChild(child: ChildProcess, opts?: WaitOptions): Promise<void> {
+  return new Promise((resolve, reject) => {
+    child.on('exit', (code, signal) => {
+      if (code !== null && (opts?.validReturnCodes ?? [0]).includes(code)) {
+        resolve();
+      } else {
+        reject(new ChildProcessError('Process failed', code, signal));
+      }
+    });
+    child.on('error', reject);
+  });
+}
+
+export async function kill(child: ChildProcess, signal: NodeJS.Signals = 'SIGINT', opts?: WaitOptions): Promise<void> {
+  if (child.pid === undefined) {
+    throw new TypeError('Expected child with pid');
+  }
+  process.kill(child.pid, signal);
+  try {
+    await waitOnChild(child, opts);
+  } catch (err) {
+    // Should error if the error is not a child process error or it is a child
+    // process and either the platform is Windows or the signal matches.
+    const shouldError = !(err instanceof ChildProcessError) || (process.platform !== 'win32' && err.signal !== signal);
+    if (shouldError) {
+      throw err;
+    }
+  }
+}
+
+export async function killIfExists(
+  child: ChildProcess,
+  signal: NodeJS.Signals = 'SIGINT',
+  opts?: WaitOptions
+): Promise<void> {
+  try {
+    await kill(child, signal, opts);
+  } catch (err: any) {
+    if (err.code !== 'ESRCH') {
+      throw err;
+    }
+  }
+}
+
+export const shell = process.platform === 'win32';

package/src/index-for-docs.ts

@@ -0,0 +1,2 @@
+// Reexports the contents of this package under the "testing" namespace for better docs generation
+export * as testing from './index';

package/src/index.ts

@@ -0,0 +1,358 @@
+/**
+ * `npm i @temporalio/testing`
+ *
+ * Testing library for the SDK.
+ *
+ * [Documentation](https://docs.temporal.io/typescript/testing)
+ *
+ * @module
+ */
+
+import * as activity from '@temporalio/activity';
+import {
+  AsyncCompletionClient,
+  WorkflowClient as BaseWorkflowClient,
+  WorkflowClientOptions as BaseWorkflowClientOptions,
+  WorkflowResultOptions as BaseWorkflowResultOptions,
+  WorkflowStartOptions as BaseWorkflowStartOptions,
+} from '@temporalio/client';
+import { ActivityFunction, CancelledFailure, msToTs, Workflow, WorkflowResultType } from '@temporalio/common';
+import { NativeConnection, Logger, DefaultLogger } from '@temporalio/worker';
+import path from 'path';
+import os from 'os';
+import { AbortController } from 'abort-controller';
+import { ChildProcess, spawn, StdioOptions } from 'child_process';
+import events from 'events';
+import { kill, waitOnChild } from './child-process';
+import type getPortType from 'get-port';
+import { Connection, TestService } from './test-service-client';
+
+const TEST_SERVER_EXECUTABLE_NAME = os.platform() === 'win32' ? 'test-server.exe' : 'test-server';
+
+export const DEFAULT_TEST_SERVER_PATH = path.join(__dirname, `../${TEST_SERVER_EXECUTABLE_NAME}`);
+
+/**
+ * Options passed to {@link WorkflowClient.result}, these are the same as the
+ * {@link BaseWorkflowResultOptions} with an additional option that controls
+ * whether to toggle time skipping in the Test server while waiting on a
+ * Workflow's result.
+ */
+export interface WorkflowResultOptions extends BaseWorkflowResultOptions {
+  /**
+   * If set to `true`, waiting for the result does not enable time skipping
+   */
+  runInNormalTime?: boolean;
+}
+
+/**
+ * Options passed to {@link WorkflowClient.execute}, these are the same as the
+ * {@link BaseWorkflowStartOptions} with an additional option that controls
+ * whether to toggle time skipping in the Test server while waiting on a
+ * Workflow's result.
+ */
+export type WorkflowStartOptions<T extends Workflow> = BaseWorkflowStartOptions<T> & {
+  /**
+   * If set to `true`, waiting for the result does not enable time skipping
+   */
+  runInNormalTime?: boolean;
+};
+
+export interface WorkflowClientOptions extends BaseWorkflowClientOptions {
+  connection: Connection;
+}
+
+/**
+ * A client with the exact same API as the "normal" client with 1 exception,
+ * When this client waits on a Workflow's result, it will enable time skipping
+ * in the test server.
+ */
+export class WorkflowClient extends BaseWorkflowClient {
+  protected readonly testService: TestService;
+
+  constructor(options: WorkflowClientOptions) {
+    super(options);
+    this.testService = options.connection.testService;
+  }
+
+  /**
+   * Execute a Workflow and wait for completion.
+   *
+   * @see {@link BaseWorkflowClient.execute}
+   */
+  public async execute<T extends Workflow>(
+    workflowTypeOrFunc: string | T,
+    options: WorkflowStartOptions<T>
+  ): Promise<WorkflowResultType<T>> {
+    return super.execute(workflowTypeOrFunc, options);
+  }
+
+  /**
+   * Gets the result of a Workflow execution.
+   *
+   * @see {@link BaseWorkflowClient.result}
+   */
+  override async result<T>(
+    workflowId: string,
+    runId?: string | undefined,
+    opts?: WorkflowResultOptions | undefined
+  ): Promise<T> {
+    if (opts?.runInNormalTime) {
+      return await super.result(workflowId, runId, opts);
+    }
+    await this.testService.unlockTimeSkipping({});
+    try {
+      return await super.result(workflowId, runId, opts);
+    } finally {
+      await this.testService.lockTimeSkipping({});
+    }
+  }
+}
+
+/**
+ * Convenience workflow interceptors
+ *
+ * Contains a single interceptor for transforming `AssertionError`s into non
+ * retryable `ApplicationFailure`s.
+ */
+export const workflowInterceptorModules = [path.join(__dirname, 'assert-to-failure-interceptor')];
+
+export interface TestServerSpawnerOptions {
+  /**
+   * @default {@link DEFAULT_TEST_SERVER_PATH}
+   */
+  path?: string;
+  /**
+   * @default ignore
+   */
+  stdio?: StdioOptions;
+}
+
+/**
+ * A generic callback that returns a child process
+ */
+export type TestServerSpawner = (port: number) => ChildProcess;
+
+/**
+ * Options for {@link TestWorkflowEnvironment.create}
+ */
+export interface TestWorkflowEnvironmentOptions {
+  testServer?: TestServerSpawner | TestServerSpawnerOptions;
+  logger?: Logger;
+}
+
+interface TestWorkflowEnvironmentOptionsWithDefaults {
+  testServerSpawner: TestServerSpawner;
+  logger: Logger;
+}
+
+function addDefaults({
+  testServer,
+  logger,
+}: TestWorkflowEnvironmentOptions): TestWorkflowEnvironmentOptionsWithDefaults {
+  return {
+    testServerSpawner:
+      typeof testServer === 'function'
+        ? testServer
+        : (port: number) =>
+            spawn(testServer?.path || DEFAULT_TEST_SERVER_PATH, [`${port}`], {
+              stdio: testServer?.stdio || 'ignore',
+            }),
+    logger: logger ?? new DefaultLogger('INFO'),
+  };
+}
+
+// TS transforms `import` statements into `require`s, this is a workaround until
+// tsconfig module nodenext is stable.
+const _importDynamic = new Function('modulePath', 'return import(modulePath)');
+
+/**
+ * An execution environment for running Workflow integration tests.
+ *
+ * Runs an external server.
+ * By default, the Java test server is used which supports time skipping.
+ */
+export class TestWorkflowEnvironment {
+  /**
+   * Get an extablished {@link Connection} to the test server
+   */
+  public readonly connection: Connection;
+
+  /**
+   * An {@link AsyncCompletionClient} for interacting with the test server
+   */
+  public readonly asyncCompletionClient: AsyncCompletionClient;
+
+  /**
+   * A {@link WorkflowClient} for interacting with the test server
+   */
+  public readonly workflowClient: WorkflowClient;
+
+  /**
+   * A {@link NativeConnection} for interacting with the test server.
+   *
+   * Use this connection when creating Workers for testing.
+   */
+  public readonly nativeConnection: NativeConnection;
+
+  protected constructor(
+    protected readonly serverProc: ChildProcess,
+    connection: Connection,
+    nativeConnection: NativeConnection
+  ) {
+    this.connection = connection;
+    this.nativeConnection = nativeConnection;
+    this.workflowClient = new WorkflowClient({ connection });
+    this.asyncCompletionClient = new AsyncCompletionClient({ connection });
+  }
+
+  /**
+   * Create a new test environment
+   */
+  static async create(opts?: TestWorkflowEnvironmentOptions): Promise<TestWorkflowEnvironment> {
+    // No, we're not going to compile this to ESM for one dependency
+    const getPort = (await _importDynamic('get-port')).default as typeof getPortType;
+    const port = await getPort();
+
+    const { testServerSpawner, logger } = addDefaults(opts ?? {});
+
+    const child = testServerSpawner(port);
+
+    const address = `127.0.0.1:${port}`;
+    const connPromise = Connection.connect({ address });
+
+    try {
+      await Promise.race([
+        connPromise,
+        waitOnChild(child).then(() => {
+          throw new Error('Test server child process exited prematurely');
+        }),
+      ]);
+    } catch (err) {
+      try {
+        await kill(child);
+      } catch (error) {
+        logger.error('Failed to kill test server child process', { error });
+      }
+      throw err;
+    }
+
+    const conn = await connPromise;
+    const nativeConnection = await NativeConnection.connect({ address });
+
+    return new this(child, conn, nativeConnection);
+  }
+
+  /**
+   * Kill the test server process and close the connection to it
+   */
+  async teardown(): Promise<void> {
+    await this.connection.close();
+    await this.nativeConnection.close();
+    // TODO: the server should return exit code 0
+    await kill(this.serverProc, 'SIGINT', { validReturnCodes: [0, 130] });
+  }
+
+  /**
+   * Wait for `durationMs` in "test server time".
+   *
+   * The test server toggles between skipped time and normal time depending on what it needs to execute.
+   *
+   * This method is likely to resolve in less than `durationMs` of "real time".
+   *
+   * Useful for simulating events far into the future like completion of long running activities.
+   *
+   * @param durationMs {@link https://www.npmjs.com/package/ms | ms} formatted string or number of milliseconds
+   *
+   * @example
+   *
+   * `workflow.ts`
+   *
+   * ```ts
+   * const activities = proxyActivities({ startToCloseTimeout: 2_000_000 });
+   *
+   * export async function raceActivityAndTimer(): Promise<string> {
+   *   return await Promise.race([
+   *     wf.sleep(500_000).then(() => 'timer'),
+   *     activities.longRunning().then(() => 'activity'),
+   *   ]);
+   * }
+   * ```
+   *
+   * `test.ts`
+   *
+   * ```ts
+   * const worker = await Worker.create({
+   *   connection: testEnv.nativeConnection,
+   *   activities: {
+   *     async longRunning() {
+   *       await testEnv.sleep(1_000_000); // <-- sleep called here
+   *     },
+   *   },
+   *   // ...
+   * });
+   * ```
+   */
+  sleep = async (durationMs: number | string): Promise<void> => {
+    await this.connection.testService.unlockTimeSkippingWithSleep({ duration: msToTs(durationMs) });
+  };
+}
+
+/**
+ * Used as the default activity info for Activities executed in the {@link MockActivityEnvironment}
+ */
+export const defaultActivityInfo: activity.Info = {
+  attempt: 1,
+  taskQueue: 'test',
+  isLocal: false,
+  taskToken: Buffer.from('test'),
+  activityId: 'test',
+  activityType: 'unknown',
+  workflowType: 'test',
+  base64TaskToken: Buffer.from('test').toString('base64'),
+  heartbeatDetails: undefined,
+  activityNamespace: 'default',
+  workflowNamespace: 'default',
+  workflowExecution: { workflowId: 'test', runId: 'dead-beef' },
+  scheduledTimestampMs: 1,
+  startToCloseTimeoutMs: 1000,
+  scheduleToCloseTimeoutMs: 1000,
+};
+
+/**
+ * An execution environment for testing Activities.
+ *
+ * Mocks Activity {@link Context | activity.Context} and exposes hooks for
+ * cancellation and heartbeats.
+ */
+export class MockActivityEnvironment extends events.EventEmitter {
+  public cancel: (reason?: any) => void = () => undefined;
+  public readonly context: activity.Context;
+
+  constructor(info?: Partial<activity.Info>) {
+    super();
+    const abortController = new AbortController();
+    const promise = new Promise<never>((_, reject) => {
+      this.cancel = (reason?: any) => {
+        abortController.abort();
+        reject(new CancelledFailure(reason));
+      };
+    });
+    const heartbeatCallback = (details?: unknown) => this.emit('heartbeat', details);
+    this.context = new activity.Context(
+      { ...defaultActivityInfo, ...info },
+      promise,
+      abortController.signal,
+      heartbeatCallback
+    );
+    promise.catch(() => {
+      /* avoid unhandled rejection */
+    });
+  }
+
+  /**
+   * Run a function in Activity Context
+   */
+  public run<P extends any[], R, F extends ActivityFunction<P, R>>(fn: F, ...args: P): Promise<R> {
+    return activity.asyncLocalStorage.run(this.context, fn, ...args);
+  }
+}