webloom-framework 0.4.0 → 0.4.2

package/dist/messagePortServiceTransport-B0FyJr43.d.ts

@@ -1,264 +0,0 @@
-import { T as PluginSetup, K as Capability, bj as RuntimeUnitImplementationRegistry, aH as PluginIntentSnapshot, aF as PluginIntentController, a$ as ResourceRegistry, aZ as ResourceDefinition, bd as RuntimeSnapshot, R as RuntimeKind, aN as PluginStateKind, Y as CapabilityBridge } from './runtimeTypes-DquUCHz-.js';
-import { R as ReceivePortLedger, a as RuntimeLimitsInput, b as RuntimeBudget } from './sharedWorkerHost-Cb2a1_KD.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;
-
-declare const RUNTIME_PROTOCOL_VERSION: "webloom.runtime.v1";
-declare const RUNTIME_SNAPSHOT_TYPE: "webloom.runtime.v1.snapshot";
-declare const RUNTIME_ERROR_TYPE: "webloom.runtime.v1.runtime-error";
-declare const RUNTIME_CALL_TYPE: "webloom.runtime.v1.call";
-declare const RUNTIME_RESULT_TYPE: "webloom.runtime.v1.result";
-declare const RUNTIME_ERROR_MESSAGE_TYPE: "webloom.runtime.v1.error";
-declare const RUNTIME_CANCEL_TYPE: "webloom.runtime.v1.cancel";
-declare const RUNTIME_NEXT_TYPE: "webloom.runtime.v1.next";
-declare const RUNTIME_CREDIT_TYPE: "webloom.runtime.v1.credit";
-interface RuntimeSnapshotUnit {
-    /** 插件标识。 */
-    readonly pluginId: string;
-    /** 单元标识。 */
-    readonly unitId: string;
-    /** Runtime。 */
-    readonly runtime: RuntimeKind;
-    /** 实例标识。 */
-    readonly instanceId?: string;
-    /** 状态。 */
-    readonly state: PluginStateKind;
-}
-type RuntimeSnapshotMessage = RuntimeSnapshot & {
-    readonly type: typeof RUNTIME_SNAPSHOT_TYPE;
-};
-interface RuntimeErrorMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_ERROR_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** 结构化错误码。 */
-    readonly code: string;
-    /** 脱敏消息。 */
-    readonly message: string;
-    /** 失败阶段。 */
-    readonly phase: "validate" | "wait" | "dispatch" | "execute" | "receive" | "dispose";
-    /** 可选插件标识。 */
-    readonly pluginId?: string;
-    /** 可选单元标识。 */
-    readonly unitId?: string;
-}
-interface RuntimeCallMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_CALL_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** 方向内唯一 call id。 */
-    readonly callId: string;
-    /** capability 标识。 */
-    readonly capabilityId: string;
-    /** 契约版本。 */
-    readonly contractVersion: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** 调用模式。 */
-    readonly mode: "unary" | "stream";
-    /** 本次派发的剩余预算。 */
-    readonly timeoutMs: number;
-    /** 已 parser 验证的请求。 */
-    readonly request: unknown;
-    /** 产品操作标识。 */
-    readonly operationId?: string;
-    /** 领域授权标识。 */
-    readonly grantId?: string;
-    /** stream 初始 credit。 */
-    readonly initialCredit?: number;
-}
-interface RuntimeUnaryResultMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_RESULT_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** unary 结果。 */
-    readonly result: unknown;
-}
-interface RuntimeStreamReadyMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_RESULT_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** stream 建立确认。 */
-    readonly streamReady: true;
-}
-interface RuntimeStreamDoneMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_RESULT_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** stream 正常结束。 */
-    readonly done: true;
-}
-type RuntimeResultMessage = RuntimeUnaryResultMessage | RuntimeStreamReadyMessage | RuntimeStreamDoneMessage;
-interface RuntimeErrorResponseMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_ERROR_MESSAGE_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** 结构化错误。 */
-    readonly error: {
-        readonly code: string;
-        readonly message: string;
-        readonly phase: RuntimeErrorMessage["phase"];
-        readonly details?: Readonly<Record<string, unknown>>;
-    };
-}
-interface RuntimeCancelMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_CANCEL_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-}
-interface RuntimeNextMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_NEXT_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** 连续序号。 */
-    readonly sequence: number;
-    /** parser 验证的 item。 */
-    readonly item: unknown;
-}
-interface RuntimeCreditMessage {
-    /** 消息类型。 */
-    readonly type: typeof RUNTIME_CREDIT_TYPE;
-    /** 协议版本。 */
-    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
-    /** call id。 */
-    readonly callId: string;
-    /** exposure 身份。 */
-    readonly serviceInstanceId: string;
-    /** 新增 credit。 */
-    readonly count: number;
-}
-type RuntimeWireMessage = RuntimeSnapshotMessage | RuntimeErrorMessage | RuntimeCallMessage | RuntimeResultMessage | RuntimeErrorResponseMessage | RuntimeCancelMessage | RuntimeNextMessage | RuntimeCreditMessage;
-interface RuntimeMessageCodec {
-    /** 严格验证并冻结 v4 message。 */
-    encode(message: RuntimeWireMessage): RuntimeWireMessage;
-    /** 严格解析 v4 message；旧协议直接拒绝。 */
-    decode(value: unknown): RuntimeWireMessage;
-}
-declare function createRuntimeMessageCodec(): RuntimeMessageCodec;
-declare function isRuntimeSnapshot(value: RuntimeWireMessage): value is RuntimeSnapshotMessage;
-
-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;
-}
-/** 创建按 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 { createCapabilityBridge as A, createMessagePortRuntimeTransport as B, type CreateCapabilityBridgeOptions as C, createPluginIntentController as D, createResourceRegistry as E, createRuntimeMessageCodec as F, createRuntimeUnitImplementationRegistry as G, isRuntimeSnapshot as H, registerOwnedResource as I, validateTransferables as J, type MessagePortLike as M, type RuntimeCallMessage as R, type RuntimeTransport as a, type CreatePluginIntentControllerOptions as b, RUNTIME_CALL_TYPE as c, RUNTIME_CANCEL_TYPE as d, RUNTIME_CREDIT_TYPE as e, RUNTIME_ERROR_MESSAGE_TYPE as f, RUNTIME_ERROR_TYPE as g, RUNTIME_NEXT_TYPE as h, RUNTIME_PROTOCOL_VERSION as i, RUNTIME_RESULT_TYPE as j, RUNTIME_SNAPSHOT_TYPE as k, type RuntimeCancelMessage as l, type RuntimeCreditMessage as m, type RuntimeErrorMessage as n, type RuntimeErrorResponseMessage as o, type RuntimeMessageCodec as p, type RuntimeNextMessage as q, type RuntimeReceiveMetadata as r, type RuntimeResultMessage as s, type RuntimeSnapshotMessage as t, type RuntimeSnapshotUnit as u, type RuntimeStreamDoneMessage as v, type RuntimeStreamReadyMessage as w, type RuntimeUnaryResultMessage as x, type RuntimeUnitImplementation as y, type RuntimeWireMessage as z };