@temporalio/workflow 1.11.7 → 1.12.0-rc.0

package/lib/worker-interface.js

@@ -36,51 +36,65 @@ function initRuntime(options) {
     // We do this before importing any user code so user code can statically reference @temporalio/workflow functions
     // as well as Date and Math.random.
     (0, global_attributes_1.setActivatorUntyped)(activator);
-    // webpack alias to payloadConverterPath
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const customPayloadConverter = require('__temporal_custom_payload_converter').payloadConverter;
-    // The `payloadConverter` export is validated in the Worker
-    if (customPayloadConverter != null) {
-        activator.payloadConverter = customPayloadConverter;
-    }
-    // webpack alias to failureConverterPath
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const customFailureConverter = require('__temporal_custom_failure_converter').failureConverter;
-    // The `failureConverter` export is validated in the Worker
-    if (customFailureConverter != null) {
-        activator.failureConverter = customFailureConverter;
-    }
-    const { importWorkflows, importInterceptors } = global.__TEMPORAL__;
-    if (importWorkflows === undefined || importInterceptors === undefined) {
-        throw new common_1.IllegalStateError('Workflow bundle did not register import hooks');
-    }
-    const interceptors = importInterceptors();
-    for (const mod of interceptors) {
-        const factory = mod.interceptors;
-        if (factory !== undefined) {
-            if (typeof factory !== 'function') {
-                throw new TypeError(`Failed to initialize workflows interceptors: expected a function, but got: '${factory}'`);
+    activator.rethrowSynchronously = true;
+    try {
+        // webpack alias to payloadConverterPath
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const customPayloadConverter = require('__temporal_custom_payload_converter').payloadConverter;
+        // The `payloadConverter` export is validated in the Worker
+        if (customPayloadConverter != null) {
+            activator.payloadConverter = customPayloadConverter;
+        }
+        // webpack alias to failureConverterPath
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const customFailureConverter = require('__temporal_custom_failure_converter').failureConverter;
+        // The `failureConverter` export is validated in the Worker
+        if (customFailureConverter != null) {
+            activator.failureConverter = customFailureConverter;
+        }
+        const { importWorkflows, importInterceptors } = global.__TEMPORAL__;
+        if (importWorkflows === undefined || importInterceptors === undefined) {
+            throw new common_1.IllegalStateError('Workflow bundle did not register import hooks');
+        }
+        const interceptors = importInterceptors();
+        for (const mod of interceptors) {
+            const factory = mod.interceptors;
+            if (factory !== undefined) {
+                if (typeof factory !== 'function') {
+                    throw new TypeError(`Failed to initialize workflows interceptors: expected a function, but got: '${factory}'`);
+                }
+                const interceptors = factory();
+                activator.interceptors.inbound.push(...(interceptors.inbound ?? []));
+                activator.interceptors.outbound.push(...(interceptors.outbound ?? []));
+                activator.interceptors.internals.push(...(interceptors.internals ?? []));
+            }
+        }
+        const mod = importWorkflows();
+        const workflowFn = mod[activator.info.workflowType];
+        const defaultWorkflowFn = mod['default'];
+        if (typeof workflowFn === 'function') {
+            activator.workflow = workflowFn;
+        }
+        else if (typeof defaultWorkflowFn === 'function') {
+            activator.workflow = defaultWorkflowFn;
+        }
+        else {
+            const details = workflowFn === undefined
+                ? 'no such function is exported by the workflow bundle'
+                : `expected a function, but got: '${typeof workflowFn}'`;
+            throw new TypeError(`Failed to initialize workflow of type '${activator.info.workflowType}': ${details}`);
+        }
+        if (isWorkflowFunctionWithOptions(activator.workflow)) {
+            if (typeof activator.workflow.workflowDefinitionOptions === 'object') {
+                activator.versioningBehavior = activator.workflow.workflowDefinitionOptions.versioningBehavior;
+            }
+            else {
+                activator.workflowDefinitionOptionsGetter = activator.workflow.workflowDefinitionOptions;
             }
-            const interceptors = factory();
-            activator.interceptors.inbound.push(...(interceptors.inbound ?? []));
-            activator.interceptors.outbound.push(...(interceptors.outbound ?? []));
-            activator.interceptors.internals.push(...(interceptors.internals ?? []));
         }
     }
-    const mod = importWorkflows();
-    const workflowFn = mod[activator.info.workflowType];
-    const defaultWorkflowFn = mod['default'];
-    if (typeof workflowFn === 'function') {
-        activator.workflow = workflowFn;
-    }
-    else if (typeof defaultWorkflowFn === 'function') {
-        activator.workflow = defaultWorkflowFn;
-    }
-    else {
-        const details = workflowFn === undefined
-            ? 'no such function is exported by the workflow bundle'
-            : `expected a function, but got: '${typeof workflowFn}'`;
-        throw new TypeError(`Failed to initialize workflow of type '${activator.info.workflowType}': ${details}`);
+    finally {
+        activator.rethrowSynchronously = false;
     }
 }
 /**
@@ -107,46 +121,64 @@ function fixPrototypes(obj) {
  * Initialize the workflow. Or to be exact, _complete_ initialization, as most part has been done in constructor).
  */
 function initialize(initializeWorkflowJob) {
-    (0, global_attributes_1.getActivator)().initializeWorkflow(initializeWorkflowJob);
+    const activator = (0, global_attributes_1.getActivator)();
+    activator.rethrowSynchronously = true;
+    try {
+        activator.initializeWorkflow(initializeWorkflowJob);
+    }
+    finally {
+        activator.rethrowSynchronously = false;
+    }
 }
 /**
- * Run a chunk of activation jobs
+ * Run a chunk of activation jobs.
+ *
+ * Notice that this function is not async and runs _inside_ the VM context. Therefore, no microtask
+ * will get executed _while_ this function is active; they will however get executed _after_ this
+ * function returns (i.e. all outstanding microtasks in the VM will get executed before execution
+ * resumes out of the VM, in `vm-shared.ts:activate()`).
  */
 function activate(activation, batchIndex = 0) {
     const activator = (0, global_attributes_1.getActivator)();
-    const intercept = (0, interceptors_1.composeInterceptors)(activator.interceptors.internals, 'activate', ({ activation }) => {
-        // Cast from the interface to the class which has the `variant` attribute.
-        // This is safe because we know that activation is a proto class.
-        const jobs = activation.jobs;
-        // Initialization will have been handled already, but we might still need to start the workflow function
-        const startWorkflowJob = jobs[0].variant === 'initializeWorkflow' ? jobs.shift()?.initializeWorkflow : undefined;
-        for (const job of jobs) {
-            if (job.variant === undefined)
-                throw new TypeError('Expected job.variant to be defined');
-            const variant = job[job.variant];
-            if (!variant)
-                throw new TypeError(`Expected job.${job.variant} to be set`);
-            activator[job.variant](variant /* TS can't infer this type */);
-            if (job.variant !== 'queryWorkflow')
+    activator.rethrowSynchronously = true;
+    try {
+        const intercept = (0, interceptors_1.composeInterceptors)(activator.interceptors.internals, 'activate', ({ activation }) => {
+            // Cast from the interface to the class which has the `variant` attribute.
+            // This is safe because we know that activation is a proto class.
+            const jobs = activation.jobs;
+            // Initialization will have been handled already, but we might still need to start the workflow function
+            const startWorkflowJob = jobs[0].variant === 'initializeWorkflow' ? jobs.shift()?.initializeWorkflow : undefined;
+            for (const job of jobs) {
+                if (job.variant === undefined)
+                    throw new TypeError('Expected job.variant to be defined');
+                const variant = job[job.variant];
+                if (!variant)
+                    throw new TypeError(`Expected job.${job.variant} to be set`);
+                activator[job.variant](variant /* TS can't infer this type */);
+                if (job.variant !== 'queryWorkflow')
+                    tryUnblockConditions();
+            }
+            if (startWorkflowJob) {
+                const safeJobTypes = [
+                    'initializeWorkflow',
+                    'signalWorkflow',
+                    'doUpdate',
+                    'cancelWorkflow',
+                    'updateRandomSeed',
+                ];
+                if (jobs.some((job) => !safeJobTypes.includes(job.variant))) {
+                    throw new TypeError('Received both initializeWorkflow and non-signal/non-update jobs in the same activation: ' +
+                        JSON.stringify(jobs.map((job) => job.variant)));
+                }
+                activator.startWorkflow(startWorkflowJob);
                 tryUnblockConditions();
-        }
-        if (startWorkflowJob) {
-            const safeJobTypes = [
-                'initializeWorkflow',
-                'signalWorkflow',
-                'doUpdate',
-                'cancelWorkflow',
-                'updateRandomSeed',
-            ];
-            if (jobs.some((job) => !safeJobTypes.includes(job.variant))) {
-                throw new TypeError('Received both initializeWorkflow and non-signal/non-update jobs in the same activation: ' +
-                    JSON.stringify(jobs.map((job) => job.variant)));
             }
-            activator.startWorkflow(startWorkflowJob);
-            tryUnblockConditions();
-        }
-    });
-    intercept({ activation, batchIndex });
+        });
+        intercept({ activation, batchIndex });
+    }
+    finally {
+        activator.rethrowSynchronously = false;
+    }
 }
 /**
  * Conclude a single activation.
@@ -156,17 +188,27 @@ function activate(activation, batchIndex = 0) {
  */
 function concludeActivation() {
     const activator = (0, global_attributes_1.getActivator)();
-    activator.rejectBufferedUpdates();
-    const intercept = (0, interceptors_1.composeInterceptors)(activator.interceptors.internals, 'concludeActivation', (input) => input);
-    const activationCompletion = activator.concludeActivation();
-    const { commands } = intercept({ commands: activationCompletion.commands });
-    if (activator.completed) {
-        activator.warnIfUnfinishedHandlers();
+    activator.rethrowSynchronously = true;
+    try {
+        activator.rejectBufferedUpdates();
+        const intercept = (0, interceptors_1.composeInterceptors)(activator.interceptors.internals, 'concludeActivation', (input) => input);
+        const activationCompletion = activator.concludeActivation();
+        const { commands } = intercept({ commands: activationCompletion.commands });
+        if (activator.completed) {
+            activator.warnIfUnfinishedHandlers();
+        }
+        return {
+            runId: activator.info.runId,
+            successful: {
+                ...activationCompletion,
+                commands,
+                versioningBehavior: (0, common_1.encodeVersioningBehavior)(activationCompletion.versioningBehavior),
+            },
+        };
+    }
+    finally {
+        activator.rethrowSynchronously = false;
     }
-    return {
-        runId: activator.info.runId,
-        successful: { ...activationCompletion, commands },
-    };
 }
 /**
  * Loop through all blocked conditions, evaluate and unblock if possible.
@@ -174,28 +216,48 @@ function concludeActivation() {
  * @returns number of unblocked conditions.
  */
 function tryUnblockConditions() {
-    let numUnblocked = 0;
-    for (;;) {
-        const prevUnblocked = numUnblocked;
-        for (const [seq, cond] of (0, global_attributes_1.getActivator)().blockedConditions.entries()) {
-            if (cond.fn()) {
-                cond.resolve();
-                numUnblocked++;
-                // It is safe to delete elements during map iteration
-                (0, global_attributes_1.getActivator)().blockedConditions.delete(seq);
+    const activator = (0, global_attributes_1.getActivator)();
+    activator.rethrowSynchronously = true;
+    try {
+        let numUnblocked = 0;
+        for (;;) {
+            activator.maybeRethrowWorkflowTaskError();
+            const prevUnblocked = numUnblocked;
+            for (const [seq, cond] of activator.blockedConditions.entries()) {
+                if (cond.fn()) {
+                    cond.resolve();
+                    numUnblocked++;
+                    // It is safe to delete elements during map iteration
+                    activator.blockedConditions.delete(seq);
+                }
+            }
+            if (prevUnblocked === numUnblocked) {
+                break;
             }
         }
-        if (prevUnblocked === numUnblocked) {
-            break;
-        }
+        return numUnblocked;
+    }
+    finally {
+        activator.rethrowSynchronously = false;
     }
-    return numUnblocked;
 }
 function dispose() {
-    const dispose = (0, interceptors_1.composeInterceptors)((0, global_attributes_1.getActivator)().interceptors.internals, 'dispose', async () => {
-        (0, cancellation_scope_1.disableStorage)();
-        (0, update_scope_1.disableUpdateStorage)();
-    });
-    dispose({});
+    const activator = (0, global_attributes_1.getActivator)();
+    activator.rethrowSynchronously = true;
+    try {
+        const dispose = (0, interceptors_1.composeInterceptors)(activator.interceptors.internals, 'dispose', async () => {
+            (0, cancellation_scope_1.disableStorage)();
+            (0, update_scope_1.disableUpdateStorage)();
+        });
+        dispose({});
+    }
+    finally {
+        activator.rethrowSynchronously = false;
+    }
+}
+function isWorkflowFunctionWithOptions(obj) {
+    if (obj == null)
+        return false;
+    return Object.hasOwn(obj, 'workflowDefinitionOptions');
 }
 //# sourceMappingURL=worker-interface.js.map

package/lib/worker-interface.js.map

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

package/lib/workflow.d.ts

@@ -1,7 +1,7 @@
-import { ActivityFunction, ActivityOptions, LocalActivityOptions, QueryDefinition, SearchAttributes, SignalDefinition, UntypedActivities, UpdateDefinition, WithWorkflowArgs, Workflow, WorkflowResultType, WorkflowReturnType } from '@temporalio/common';
+import { ActivityFunction, ActivityOptions, LocalActivityOptions, QueryDefinition, SearchAttributes, SignalDefinition, UntypedActivities, UpdateDefinition, WithWorkflowArgs, Workflow, WorkflowResultType, WorkflowReturnType, SearchAttributeUpdatePair, WorkflowDefinitionOptionsOrGetter } from '@temporalio/common';
 import { Duration } from '@temporalio/common/lib/time';
 import { temporal } from '@temporalio/proto';
-import { ChildWorkflowOptions, ChildWorkflowOptionsWithDefaults, ContinueAsNewOptions, DefaultSignalHandler, EnhancedStackTrace, Handler, QueryHandlerOptions, SignalHandlerOptions, UpdateHandlerOptions, WorkflowInfo, UpdateInfo } from './interfaces';
+import { ChildWorkflowOptions, ChildWorkflowOptionsWithDefaults, ContinueAsNewOptions, DefaultSignalHandler, EnhancedStackTrace, Handler, QueryHandlerOptions, SignalHandlerOptions, UpdateHandlerOptions, WorkflowInfo, UpdateInfo, DefaultUpdateHandler, DefaultQueryHandler } from './interfaces';
 import { ChildWorkflowHandle, ExternalWorkflowHandle } from './workflow-handle';
 /**
  * Adds default values of `workflowId` and `cancellationType` to given workflow options.
@@ -262,14 +262,15 @@ export declare function makeContinueAsNewFunc<F extends Workflow>(options?: Cont
  *
  * @example
  *
- *```ts
+ * ```ts
  *import { continueAsNew } from '@temporalio/workflow';
+import { SearchAttributeType } from '@temporalio/common';
  *
  *export async function myWorkflow(n: number): Promise<void> {
  *  // ... Workflow logic
  *  await continueAsNew<typeof myWorkflow>(n + 1);
  *}
- *```
+ * ```
  */
 export declare function continueAsNew<F extends Workflow>(...args: Parameters<F>): Promise<never>;
 /**
@@ -365,29 +366,55 @@ export declare function setHandler<Ret, Args extends any[], T extends UpdateDefi
  *
  * Signals are dispatched to the default signal handler in the order that they were accepted by the server.
  *
- * If this function is called multiple times for a given signal or query name the last handler will overwrite any previous calls.
+ * If this function is called multiple times for a given signal name the last handler will overwrite any previous calls.
  *
  * @param handler a function that will handle signals for non-registered signal names, or `undefined` to unset the handler.
  */
 export declare function setDefaultSignalHandler(handler: DefaultSignalHandler | undefined): void;
+/**
+ * Set a update handler function that will handle updates calls for non-registered update names.
+ *
+ * Updates are dispatched to the default update handler in the order that they were accepted by the server.
+ *
+ * If this function is called multiple times for a given update name the last handler will overwrite any previous calls.
+ *
+ * @param handler a function that will handle updates for non-registered update names, or `undefined` to unset the handler.
+ */
+export declare function setDefaultUpdateHandler(handler: DefaultUpdateHandler | undefined): void;
+/**
+ * Set a query handler function that will handle query calls for non-registered query names.
+ *
+ * Queries are dispatched to the default query handler in the order that they were accepted by the server.
+ *
+ * If this function is called multiple times for a given query name the last handler will overwrite any previous calls.
+ *
+ * @param handler a function that will handle queries for non-registered query names, or `undefined` to unset the handler.
+ */
+export declare function setDefaultQueryHandler(handler: DefaultQueryHandler | undefined): void;
 /**
  * Updates this Workflow's Search Attributes by merging the provided `searchAttributes` with the existing Search
  * Attributes, `workflowInfo().searchAttributes`.
  *
- * For example, this Workflow code:
+ * Search attributes can be upserted using either SearchAttributes (deprecated) or SearchAttributeUpdatePair[] (preferred)
+ *
+ * Upserting a workflow's search attributes using SearchAttributeUpdatePair[]:
  *
  * ```ts
- * upsertSearchAttributes({
- *   CustomIntField: [1],
- *   CustomBoolField: [true]
- * });
- * upsertSearchAttributes({
- *   CustomIntField: [42],
- *   CustomKeywordField: ['durable code', 'is great']
- * });
+ * const intKey = defineSearchKey('CustomIntField', 'INT');
+ * const boolKey = defineSearchKey('CustomBoolField', 'BOOL');
+ * const keywordListKey = defineSearchKey('CustomKeywordField', 'KEYWORD_LIST');
+ *
+ * upsertSearchAttributes([
+ *  defineSearchAttribute(intKey, 1),
+ *  defineSearchAttribute(boolKey, true)
+ * ]);
+ * upsertSearchAttributes([
+ *  defineSearchAttribute(intKey, 42),
+ *  defineSearchAttribute(keywordListKey, ['durable code', 'is great'])
+ * ]);
  * ```
  *
- * would result in the Workflow having these Search Attributes:
+ * Would result in the Workflow having these Search Attributes:
  *
  * ```ts
  * {
@@ -397,9 +424,11 @@ export declare function setDefaultSignalHandler(handler: DefaultSignalHandler |
  * }
  * ```
  *
- * @param searchAttributes The Record to merge. Use a value of `[]` to clear a Search Attribute.
+ * @param searchAttributes The Record to merge.
+ * If using SearchAttributeUpdatePair[] (preferred), set a value to null to remove the search attribute.
+ * If using SearchAttributes (deprecated), set a value to undefined or an empty list to remove the search attribute.
  */
-export declare function upsertSearchAttributes(searchAttributes: SearchAttributes): void;
+export declare function upsertSearchAttributes(searchAttributes: SearchAttributes | SearchAttributeUpdatePair[]): void;
 /**
  * Updates this Workflow's Memos by merging the provided `memo` with existing
  * Memos (as returned by `workflowInfo().memo`).
@@ -450,6 +479,35 @@ export declare function upsertMemo(memo: Record<string, unknown>): void;
  * @returns true if there are no in-progress update or signal handler executions.
  */
 export declare function allHandlersFinished(): boolean;
+/**
+ * Can be used to alter workflow functions with certain options specified at definition time.
+ *
+ * @example
+ * For example:
+ * ```ts
+ * setWorkflowOptions({ versioningBehavior: 'PINNED' }, myWorkflow);
+ * export async function myWorkflow(): Promise<string> {
+ *   // Workflow code here
+ *   return "hi";
+ * }
+ * ```
+ *
+ * @example
+ * To annotate a default or dynamic workflow:
+ * ```ts
+ * export default async function (): Promise<string> {
+ *   // Workflow code here
+ *   return "hi";
+ * }
+ * setWorkflowOptions({ versioningBehavior: 'PINNED' }, module.exports.default);
+ * ```
+ *
+ * @param options Options for the workflow defintion, or a function that returns options. If a
+ * function is provided, it will be called once just before the workflow function is called for the
+ * first time. It is safe to call {@link workflowInfo} inside such a function.
+ * @param fn The workflow function.
+ */
+export declare function setWorkflowOptions<A extends any[], RT>(options: WorkflowDefinitionOptionsOrGetter, fn: (...args: A) => Promise<RT>): void;
 export declare const stackTraceQuery: QueryDefinition<string, [], string>;
 export declare const enhancedStackTraceQuery: QueryDefinition<EnhancedStackTrace, [], string>;
 export declare const workflowMetadataQuery: QueryDefinition<temporal.api.sdk.v1.IWorkflowMetadata, [], string>;