@codesoul-co/hypha-harness / execution-context

• 包索引: @codesoul-co/hypha-harness
• 源码: packages/harness/src/execution-context.ts
• 导出数: 3

模块用法

用于执行该边界的运行时行为。Execution context 模块公开 1 函数、2 接口。

从包入口导入

import {
  createRuntimeExecutionContext,
} from '@codesoul-co/hypha-harness';

import type {
  CreateRuntimeExecutionContextOptions,
  RuntimeExecutionContext,
} from '@codesoul-co/hypha-harness';

使用要点

• 2 个类型/接口用于应用代码、Adapter 或测试中的静态契约；请使用 import type，运行时不应依赖它们。
• 1 个函数是该模块的直接操作入口；每个 overload 的必需/可选参数与返回类型均在下方列出。

公共导出

Symbol	种类	签名	说明
createRuntimeExecutionContext	函数	createRuntimeExecutionContext(options: CreateRuntimeExecutionContextOptions): RuntimeExecutionContext	Create Runtime Execution Context 函数，提供 1 个公开调用签名；参数与返回类型见下表。
CreateRuntimeExecutionContextOptions	接口	interface CreateRuntimeExecutionContextOptions	Create Runtime Execution Context Options 接口，共包含 15 个公开字段或方法。
RuntimeExecutionContext	接口	interface RuntimeExecutionContext	Runtime Execution Context 接口，共包含 16 个公开字段或方法。

createRuntimeExecutionContext

Create Runtime Execution Context 函数，提供 1 个公开调用签名；参数与返回类型见下表。

• 种类: 函数
• 导入: import { createRuntimeExecutionContext } from '@codesoul-co/hypha-harness';
• 源码模块: execution-context

声明

export declare function createRuntimeExecutionContext(options: CreateRuntimeExecutionContextOptions): RuntimeExecutionContext;

调用签名

createRuntimeExecutionContext(options: CreateRuntimeExecutionContextOptions): RuntimeExecutionContext

参数

参数	类型	必需	说明
options	CreateRuntimeExecutionContextOptions	是	必需参数；接受的值由类型列定义。

返回值

• 类型: RuntimeExecutionContext
• 说明: 返回值契约由上述类型定义。

CreateRuntimeExecutionContextOptions

Create Runtime Execution Context Options 接口，共包含 15 个公开字段或方法。

• 种类: 接口
• 导入: import type { CreateRuntimeExecutionContextOptions } from '@codesoul-co/hypha-harness';
• 源码模块: execution-context

声明

export interface CreateRuntimeExecutionContextOptions {
    scope: RuntimeScope;
    principal: RuntimePrincipal;
    run: RuntimeRun;
    snapshot: FSMSnapshot;
    process: FSMProcessSpec;
    attempt: number;
    runLease: RunLeaseAuthorization;
    abortSignal: AbortSignal;
    determinismStore: RuntimeDeterminismStore;
    eventCommitPort: RuntimeEventCommitPort;
    activityDispatchPort: RuntimeActivityDispatchPort;
    resourceCoordinator: RuntimeResourceCoordinator;
    causationId?: string;
    now?: () => string;
    nextId?: (namespace: string) => string;
}

契约成员

成员	种类	签名	说明
abortSignal	属性	abortSignal: AbortSignal	公开属性；类型、只读和可选状态以签名列为准。
activityDispatchPort	属性	activityDispatchPort: RuntimeActivityDispatchPort	公开属性；类型、只读和可选状态以签名列为准。
attempt	属性	attempt: number	公开属性；类型、只读和可选状态以签名列为准。
causationId	属性	causationId?: string	公开属性；类型、只读和可选状态以签名列为准。
determinismStore	属性	determinismStore: RuntimeDeterminismStore	公开属性；类型、只读和可选状态以签名列为准。
eventCommitPort	属性	eventCommitPort: RuntimeEventCommitPort	公开属性；类型、只读和可选状态以签名列为准。
nextId	方法	nextId?(namespace: string): string	公开方法；参数与返回类型以签名列为准。
now	方法	now?(): string	公开方法；参数与返回类型以签名列为准。
principal	属性	principal: RuntimePrincipal	公开属性；类型、只读和可选状态以签名列为准。
process	属性	process: FSMProcessSpec	公开属性；类型、只读和可选状态以签名列为准。
resourceCoordinator	属性	resourceCoordinator: RuntimeResourceCoordinator	公开属性；类型、只读和可选状态以签名列为准。
run	属性	run: RuntimeRun	公开属性；类型、只读和可选状态以签名列为准。
runLease	属性	runLease: RunLeaseAuthorization	公开属性；类型、只读和可选状态以签名列为准。
scope	属性	scope: RuntimeScope	公开属性；类型、只读和可选状态以签名列为准。
snapshot	属性	snapshot: FSMSnapshot	公开属性；类型、只读和可选状态以签名列为准。

RuntimeExecutionContext

Runtime Execution Context 接口，共包含 16 个公开字段或方法。

• 种类: 接口
• 导入: import type { RuntimeExecutionContext } from '@codesoul-co/hypha-harness';
• 源码模块: execution-context

声明

export interface RuntimeExecutionContext {
    readonly scope: Readonly<RuntimeScope>;
    readonly principal: Readonly<RuntimePrincipal>;
    readonly run: Readonly<RuntimeRun>;
    readonly snapshot: Readonly<FSMSnapshot>;
    readonly process: Readonly<FSMProcessSpec>;
    readonly state: Readonly<FSMStateSpec>;
    readonly attempt: number;
    readonly fencingToken: number;
    readonly abortSignal: AbortSignal;
    readonly events: RuntimeEventHelper;
    readonly activities: RuntimeActivityHelper;
    readonly transitions: RuntimeTransitionHelper;
    readonly waits: RuntimeWaitHelper;
    readonly resources: RuntimeResourceHelper;
    readonly clock: RuntimeClockHelper;
    readonly ids: RuntimeIdHelper;
}

契约成员

成员	种类	签名	说明
abortSignal	属性	readonly abortSignal: AbortSignal	公开属性；类型、只读和可选状态以签名列为准。
activities	属性	readonly activities: RuntimeActivityHelper	公开属性；类型、只读和可选状态以签名列为准。
attempt	属性	readonly attempt: number	公开属性；类型、只读和可选状态以签名列为准。
clock	属性	readonly clock: RuntimeClockHelper	公开属性；类型、只读和可选状态以签名列为准。
events	属性	readonly events: RuntimeEventHelper	公开属性；类型、只读和可选状态以签名列为准。
fencingToken	属性	readonly fencingToken: number	公开属性；类型、只读和可选状态以签名列为准。
ids	属性	readonly ids: RuntimeIdHelper	公开属性；类型、只读和可选状态以签名列为准。
principal	属性	readonly principal: Readonly<RuntimePrincipal>	公开属性；类型、只读和可选状态以签名列为准。
process	属性	readonly process: Readonly<FSMProcessSpec>	公开属性；类型、只读和可选状态以签名列为准。
resources	属性	readonly resources: RuntimeResourceHelper	公开属性；类型、只读和可选状态以签名列为准。
run	属性	readonly run: Readonly<RuntimeRun>	公开属性；类型、只读和可选状态以签名列为准。
scope	属性	readonly scope: Readonly<RuntimeScope>	公开属性；类型、只读和可选状态以签名列为准。
snapshot	属性	readonly snapshot: Readonly<FSMSnapshot>	公开属性；类型、只读和可选状态以签名列为准。
state	属性	readonly state: Readonly<FSMStateSpec>	公开属性；类型、只读和可选状态以签名列为准。
transitions	属性	readonly transitions: RuntimeTransitionHelper	公开属性；类型、只读和可选状态以签名列为准。
waits	属性	readonly waits: RuntimeWaitHelper	公开属性；类型、只读和可选状态以签名列为准。