webloom-framework 0.4.2 → 0.4.3

package/dist/messagePortServiceTransport-DyNmdgoa.d.ts

@@ -1,150 +0,0 @@
-import { ap as PluginSetup, ak as Capability, bQ as RuntimeUnitImplementationRegistry, bb as PluginIntentSnapshot, b9 as PluginIntentController, bv as ResourceRegistry, bt as ResourceDefinition, k as RuntimeEndpointBinding, bG as RuntimeEndpointState, m as RuntimeDrainResult, ab as RuntimeWireMessage, R as RuntimeKind, as as CapabilityBridge } from './runtimeTypes-CleHMFaq.js';
-import { R as ReceivePortLedger, a as RuntimeLimitsInput, b as RuntimeBudget } from './sharedWorkerHost-BNMUW-8v.js';
-
-interface RuntimeUnitImplementation {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 稳定运行单元标识。 */
-    unitId: string;
-    /** 当前环境的可执行入口。 */
-    setup: PluginSetup;
-    /** 当前 realm 的 typed capability 定义。 */
-    capabilities?: readonly Capability[];
-}
-/** 创建一个拒绝重复注册、按产品和单元查找实现的运行时注册表。 */
-declare function createRuntimeUnitImplementationRegistry(implementations?: readonly RuntimeUnitImplementation[]): RuntimeUnitImplementationRegistry & {
-    register(implementation: RuntimeUnitImplementation): void;
-    unregister(pluginId: string, unitId: string): void;
-};
-
-interface CreatePluginIntentControllerOptions {
-    /** 当前控制面启动身份；Worker 重启时应传入新值。 */
-    authorityInstanceId?: string;
-    /** Worker 恢复后读取的平台意图。 */
-    initial?: Partial<PluginIntentSnapshot>;
-    /** 将候选快照原子写入平台存储；缺省表示内存控制面（测试用）。 */
-    persist?: (snapshot: PluginIntentSnapshot) => Promise<void>;
-    /** 有界去重记录数量，避免 commandId 永久增长。 */
-    maxCommandRecords?: number;
-}
-/** 创建单一控制面上的插件意图控制器。 */
-declare function createPluginIntentController(options?: CreatePluginIntentControllerOptions): PluginIntentController;
-
-/**
- * 资源注册表实现
- *
- * 设计缘由：管理资源定义的注册和查询，支持 owner-aware 生命周期。
- * 重复 id 抛错，disable 时可回收。
- */
-
-/** 资源注册表实现 */
-declare function createResourceRegistry(): ResourceRegistry;
-/** Internal runtime hook; deliberately absent from ResourceRegistry's public type. */
-declare function registerOwnedResource(registry: ResourceRegistry, ownerId: string, definition: ResourceDefinition<any, any>): void;
-
-/** 关闭握手默认等待时间；调用方可以传入更严格的 deadline。 */
-declare const DEFAULT_RUNTIME_DRAIN_TIMEOUT_MS = 2000;
-/** 一个需要等待真实执行槽结束的框架参与者。 */
-interface RuntimeDrainParticipant {
-    /** 等待该参与者自己的真实执行槽结束。 */
-    readonly drain: () => Promise<void>;
-    /** deadline 到达时报告仍未结束的真实执行槽数量。 */
-    readonly pending: () => number;
-}
-interface RuntimeEndpointSession {
-    /** 本端由框架生成、不可复用的 endpoint 身份。 */
-    readonly binding: RuntimeEndpointBinding;
-    /** 已由对端首条合法框架消息建立的身份；尚未建立时为空。 */
-    readonly remoteBinding?: RuntimeEndpointBinding;
-    /** active -> closing -> closed。 */
-    readonly state: RuntimeEndpointState;
-    /** 最近一次同步关闭原因；只用于本地诊断。 */
-    readonly closeReason?: string;
-    /** 本端允许的最大 drain 时间；远端只能进一步收紧，不能扩大。 */
-    readonly maxDrainTimeoutMs: number;
-    /** 精确比较并建立对端 binding；不接受后续替换。 */
-    acceptRemoteBinding(binding: unknown): boolean;
-    /** 同步停止准入、触发撤权和 abort；幂等。 */
-    beginClose(reason?: string): void;
-    /** 等待全部参与者排空，始终受 bounded deadline 限制。 */
-    drain(timeoutMs?: number): Promise<RuntimeDrainResult>;
-    /** 物理 transport 即将关闭时标记终态；幂等。 */
-    close(): void;
-    /** 注册同步关闭回调。 */
-    onBeginClose(listener: (reason: string) => void): () => void;
-    /** 注册物理关闭回调。 */
-    onClosed(listener: () => void): () => void;
-    /** 注册一个真实执行排空参与者。 */
-    registerDrainParticipant(participant: RuntimeDrainParticipant): () => void;
-}
-/** 判断值是否为完整的框架 endpoint binding。 */
-declare function isRuntimeEndpointBinding(value: unknown): value is RuntimeEndpointBinding;
-/** 只比较框架 binding，不比较任何产品领域字段。 */
-declare function sameRuntimeEndpointBinding(left: RuntimeEndpointBinding | undefined, right: RuntimeEndpointBinding | undefined): boolean;
-/** 为一个 Runtime endpoint 生成不可复用的连接身份。 */
-declare function createRuntimeEndpointBinding(runtimeInstanceId: string): RuntimeEndpointBinding;
-/** 创建一条由 Runtime/transport 共用的 endpoint session。 */
-declare function createRuntimeEndpointSession(binding: RuntimeEndpointBinding, options?: {
-    readonly defaultDrainTimeoutMs?: number;
-}): RuntimeEndpointSession;
-
-interface RuntimeReceiveMetadata {
-    /** 本次 MessageEvent 实际携带的业务 MessagePort；仅 transport 本地使用。 */
-    readonly ports?: readonly MessagePort[];
-    /** 由物理 endpoint transport 创建的一次性接收资源账本。 */
-    readonly ledger?: ReceivePortLedger;
-    /** 物理 endpoint 已完成一次 codec decode。 */
-    readonly decoded?: boolean;
-}
-interface RuntimeTransport {
-    /** 发送已验证 v4 message；transfer 由契约 extractor 提供。 */
-    send(message: RuntimeWireMessage, transfer?: readonly Transferable[]): void;
-    /** 订阅接收 message 及本次事件的本地 transfer 元数据。 */
-    subscribe(listener: (message: RuntimeWireMessage, metadata?: RuntimeReceiveMetadata) => void): () => void;
-    /** 关闭本端传输。 */
-    close?(): void;
-    /** 物理 endpoint 对 decode/接收账本错误的统一通知。 */
-    subscribeError?(listener: (error: unknown, metadata?: RuntimeReceiveMetadata) => void): () => void;
-}
-interface CreateCapabilityBridgeOptions {
-    /** 底层双向 transport。 */
-    readonly transport: RuntimeTransport;
-    /** 预期的对端 Runtime 类型。 */
-    readonly remoteRuntimeKind?: RuntimeKind;
-    /** 预期的对端逻辑 Runtime id。 */
-    readonly remoteRuntimeId?: string;
-    /** 默认调用预算。 */
-    readonly defaultCallTimeoutMs?: number;
-    /** 可信 Runtime/advanced 装配提供的预算；只能收紧 v4 默认值。 */
-    readonly limits?: RuntimeLimitsInput;
-    /** 可选的 Runtime 方向共享计数器。 */
-    readonly budget?: RuntimeBudget;
-    /** 当前物理 endpoint 的框架 binding；省略时由 bridge 生成。 */
-    readonly binding?: RuntimeEndpointBinding;
-    /** 与反向 provider 共用的 endpoint session。 */
-    readonly session?: RuntimeEndpointSession;
-    /** 关闭握手默认 drain deadline。 */
-    readonly drainTimeoutMs?: number;
-}
-/** 创建按 peer 绑定、可撤销且支持 typed stream 的 bridge。 */
-declare function createCapabilityBridge(options: CreateCapabilityBridgeOptions): CapabilityBridge & {
-    readonly pendingCallCount: number;
-    readonly activeStreamCount: number;
-    readonly retainedPayloadBytes: number;
-};
-/** 内部 typed transfer 校验 helper；不接受 call 级临时 transfer 数组。 */
-declare function validateTransferables(value: unknown, transfer: readonly Transferable[] | undefined, limits?: RuntimeLimitsInput): readonly Transferable[];
-
-interface MessagePortLike {
-    addEventListener(type: "message" | "messageerror", listener: (event: MessageEvent) => void): void;
-    removeEventListener(type: "message" | "messageerror", listener: (event: MessageEvent) => void): void;
-    postMessage(message: unknown, transfer?: readonly Transferable[]): void;
-    start?(): void;
-    close?(): void;
-}
-/** 将一个真实 MessagePort 绑定为双向 v4 transport。 */
-declare function createMessagePortRuntimeTransport(port: MessagePortLike, options?: {
-    readonly limits?: RuntimeLimitsInput;
-}): RuntimeTransport;
-
-export { type CreateCapabilityBridgeOptions as C, DEFAULT_RUNTIME_DRAIN_TIMEOUT_MS as D, type MessagePortLike as M, type RuntimeTransport as R, type RuntimeEndpointSession as a, type CreatePluginIntentControllerOptions as b, type RuntimeDrainParticipant as c, type RuntimeReceiveMetadata as d, type RuntimeUnitImplementation as e, createCapabilityBridge as f, createMessagePortRuntimeTransport as g, createPluginIntentController as h, createResourceRegistry as i, createRuntimeEndpointBinding as j, createRuntimeEndpointSession as k, createRuntimeUnitImplementationRegistry as l, isRuntimeEndpointBinding as m, registerOwnedResource as r, sameRuntimeEndpointBinding as s, validateTransferables as v };