@temporalio/common/lib/converter/serialization-context.d.ts

Common library for code that's used across the Client, Worker, and/or Workflow

/**
 * Context provided to data converters for payloads owned by a workflow.
 *
 * This is used when converting payloads sent to or received from a workflow.
 * If a workflow interacts with a child workflow or an external workflow, this
 * context refers to that target workflow.
 *
 * @experimental Serialization context is an experimental feature and may change.
 */
export interface WorkflowSerializationContext {
    /** Always `'workflow'` for workflow-owned payloads. */
    type: 'workflow';
    /** Namespace of the workflow that owns the payload. */
    namespace: string;
    /** Workflow ID of the workflow that owns the payload. */
    workflowId: string;
}
/**
 * Context provided to data converters for payloads owned by an activity.
 *
 * This is used when converting activity arguments, results, heartbeat details,
 * and activity-related failures.
 *
 * @experimental Serialization context is an experimental feature and may change.
 */
export interface ActivitySerializationContext {
    /** Always `'activity'` for activity-owned payloads. */
    type: 'activity';
    /** Namespace of the activity that owns the payload. */
    namespace: string;
    /**
     * Activity ID of the activity that owns the payload.
     *
     * Workflow-side scheduling contexts use the explicit
     * ActivityOptions.activityId when supplied, otherwise they use the same
     * generated fallback ID sent to the Temporal service. Runtime activity
     * contexts use the activity ID supplied by ActivityInfo or activity task data.
     */
    activityId?: string;
    /** Workflow ID of the workflow that scheduled the activity, when known. */
    workflowId?: string;
    /** Whether the activity is a local activity started from a workflow. */
    isLocal: boolean;
}
/**
 * Context passed to payload and failure converters.
 *
 * The context describes the workflow or activity whose payload is being converted.
 * For example:
 * - `client.workflow.start()` uses the target workflow's context.
 * - `executeChild()` uses the child workflow's context, not the parent's.
 * - `scheduleActivity()` uses the scheduled activity's context.
 *
 * @experimental Serialization context is an experimental feature and may change.
 */
export type SerializationContext = WorkflowSerializationContext | ActivitySerializationContext;