webloom-framework 0.3.0 → 0.4.1

package/dist/resourceRegistry-BFnjmeGE.d.ts

@@ -1,267 +0,0 @@
-import { i as PluginSetup, aL as RuntimeUnitImplementationRegistry, R as RuntimeKind, ae as PluginStateKind, r as RemoteServiceReference, s as RemoteServiceMessageCodec, ah as PluginUnitState, au as RemoteServiceProxy, m as PluginHost, L as LifecycleDisposeResult, M as MessageBus, K as LifecycleScopeKind, o as LifecycleScopeIdentity, n as LifecycleScope, a9 as PluginIntentSnapshot, a7 as PluginIntentController, ax as RemoteServiceTransport, am as RemoteServiceBridge, ao as RemoteServiceCallContext, aC as ResourceRegistry, aA as ResourceDefinition } from './createPluginHost-BVsUCDKN.js';
-
-interface RuntimeUnitImplementation {
-    /** 产品标识。 */
-    pluginId: string;
-    /** 稳定运行单元标识。 */
-    unitId: string;
-    /** 当前环境的可执行入口。 */
-    setup: PluginSetup;
-}
-/** 创建一个拒绝重复注册、按产品和单元查找实现的运行时注册表。 */
-declare function createRuntimeUnitImplementationRegistry(implementations?: readonly RuntimeUnitImplementation[]): RuntimeUnitImplementationRegistry & {
-    register(implementation: RuntimeUnitImplementation): void;
-    unregister(pluginId: string, unitId: string): void;
-};
-
-declare const RUNTIME_PROTOCOL_VERSION = "webloom.runtime.v2";
-declare const RUNTIME_SNAPSHOT_TYPE = "webloom.runtime.snapshot";
-declare const RUNTIME_ERROR_TYPE = "webloom.runtime.error";
-interface RuntimeErrorMessage {
-    type: typeof RUNTIME_ERROR_TYPE;
-    protocolVersion: string;
-    code: "runtime_initialization_failed" | "protocol_mismatch" | "transport_unavailable";
-    message: string;
-    pluginId?: string;
-    unitId?: string;
-    phase?: "startup" | "snapshot";
-}
-interface RuntimeSnapshot {
-    type: typeof RUNTIME_SNAPSHOT_TYPE;
-    protocolVersion: string;
-    runtimeId: string;
-    runtimeKind: RuntimeKind;
-    runtimeInstanceId: string;
-    revision: number;
-    state: "starting" | "ready" | "stopping" | "failed" | "disposed";
-    units: readonly RuntimeSnapshotUnit[];
-    services: readonly RemoteServiceReference[];
-}
-interface RuntimeSnapshotUnit {
-    pluginId: string;
-    unitId: string;
-    runtime: RuntimeKind;
-    instanceId?: string;
-    state: PluginStateKind;
-}
-declare function createRuntimeMessageCodec(): RemoteServiceMessageCodec;
-/** 只验证外层结构；协议版本接受由 RuntimeHandle 单独处理。 */
-declare function isRuntimeSnapshot(input: unknown): input is RuntimeSnapshot;
-declare function isRuntimeSnapshotProtocol(input: RuntimeSnapshot): boolean;
-declare function isRuntimeError(input: unknown): input is RuntimeErrorMessage;
-/** 将 Host 的 PluginUnitState 映射成不会泄露领域配置的运行时快照。 */
-declare function unitSnapshotFromState(state: PluginUnitState, runtime: RuntimeKind): RuntimeSnapshotUnit;
-
-type RuntimeAppState = "starting" | "ready" | "stopping" | "failed" | "disposed" | "disconnected";
-interface RuntimeStatusSnapshot {
-    runtimeId: string;
-    runtimeKind: RuntimeKind;
-    runtimeInstanceId: string;
-    state: RuntimeAppState;
-    revision: number;
-    units: readonly RuntimeSnapshotUnit[];
-    services: readonly RemoteServiceReference[];
-    error?: string;
-}
-type RuntimeStatusListener = (snapshot: RuntimeStatusSnapshot) => void;
-interface WindowApp {
-    readonly runtimeKind: "window-main";
-    readonly runtimeId: string;
-    readonly runtimeInstanceId: string;
-    /** 已由 createWindowApp 装配并注册完成的本地 Host。 */
-    readonly host: PluginHost;
-    state(): RuntimeStatusSnapshot;
-    /** 获取当前本地 capability；停止或销毁后同步抛错。 */
-    capability<T>(capabilityId: string): T;
-    subscribe(listener: RuntimeStatusListener): () => void;
-    dispose(reason?: string): Promise<LifecycleDisposeResult>;
-}
-interface RuntimeHandle {
-    readonly runtimeKind: "shared-worker";
-    readonly runtimeId: string;
-    /** 当前已观察到的 Worker 启动身份；首份快照前为 undefined。 */
-    readonly runtimeInstanceId?: string;
-    state(): RuntimeStatusSnapshot;
-    capability<T = unknown>(capabilityId: string, options?: {
-        contractVersion?: string;
-    }): RemoteServiceProxy & {
-        readonly serviceType?: T;
-    };
-    subscribe(listener: RuntimeStatusListener): () => void;
-    dispose(reason?: string): Promise<void>;
-}
-/** 跨 realm 初始化失败；不把 required 插件错误包装成成功状态。 */
-interface RuntimeInitializationErrorDetails {
-    pluginId?: string;
-    unitId?: string;
-    phase: "validate" | "register" | "startup" | "snapshot";
-    error: string;
-}
-declare class RuntimeInitializationError extends Error {
-    readonly code: "runtime_initialization_failed";
-    readonly details: RuntimeInitializationErrorDetails;
-    constructor(details: RuntimeInitializationErrorDetails);
-}
-declare class RuntimeUnavailableError extends Error {
-    readonly code: "transport_unavailable";
-    constructor(message?: string);
-}
-
-interface SharedWorkerLike {
-    readonly port: MessagePort;
-    onerror?: (event: Event) => void;
-    addEventListener?(type: "error", listener: (event: Event) => void): void;
-    removeEventListener?(type: "error", listener: (event: Event) => void): void;
-}
-type SharedWorkerFactory = (url: string | URL, options: {
-    type: "module";
-    name?: string;
-    credentials?: RequestCredentials;
-}) => SharedWorkerLike;
-/**
- * 临时迁移接缝：下游 typed transfer API 完成前允许领域代码在同一
- * 物理端口安装 listener。它不参与 Runtime 授权，也不传 connectionId。
- */
-interface SharedWorkerConnectionContext {
-    readonly worker: SharedWorkerLike;
-    readonly port: MessagePort;
-}
-interface ConnectSharedWorkerOptions {
-    id: string;
-    url: string | URL;
-    name?: string;
-    credentials?: RequestCredentials;
-    defaultCallTimeoutMs?: number;
-    /** SWCF-009 完成前的临时同端口迁移接缝。 */
-    onConnection?: (context: SharedWorkerConnectionContext) => void;
-}
-/** 创建生产 RuntimeHandle；测试工厂不属于生产公共选项。 */
-declare function connectSharedWorker(options: ConnectSharedWorkerOptions): RuntimeHandle;
-/** 仅由 `webloom-framework/testing` 暴露的 SharedWorker 工厂注入入口。 */
-declare function connectSharedWorkerForTesting(options: ConnectSharedWorkerOptions, workerFactory: SharedWorkerFactory): RuntimeHandle;
-
-declare function createMessageBus(): MessageBus;
-
-interface CreateResourceScopeOptions {
-    /** 可选固定作用域标识；生产代码通常省略，让实现生成不可复用 ID。 */
-    scopeId?: string;
-    /** 运行实例标识；省略时与 scopeId 同源生成。 */
-    instanceId?: string;
-    /** 作用域类型。 */
-    kind: LifecycleScopeKind;
-    /** 绑定插件和宿主只读属性。 */
-    metadata?: Omit<Partial<LifecycleScopeIdentity>, "scopeId" | "instanceId" | "kind">;
-    /** 测试或宿主诊断使用的状态变更回调。 */
-    onChange?: (scope: LifecycleScope) => void;
-    /** 子作用域生成最终清理结果后的内部通知；用于更新父级登记。 */
-    onDisposeResult?: (result: LifecycleDisposeResult) => void;
-}
-/**
- * 创建一个可嵌套的生命周期作用域。
- *
- * `createResourceScope` 是 `createLifecycleScope` 的同义入口，方便不同
- * 模块按“作用域”或“资源”语义调用；两者不代表两套实现。
- */
-declare function createLifecycleScope(options: CreateResourceScopeOptions): LifecycleScope;
-/** 语义别名：资源管理代码通常以 ResourceScope 称呼同一原语。 */
-declare const createResourceScope: typeof createLifecycleScope;
-type ResourceScopeOptions = CreateResourceScopeOptions;
-
-interface CreatePluginIntentControllerOptions {
-    /** 当前控制面启动身份；Worker 重启时应传入新值。 */
-    authorityInstanceId?: string;
-    /** Worker 恢复后读取的平台意图。 */
-    initial?: Partial<PluginIntentSnapshot>;
-    /** 将候选快照原子写入平台存储；缺省表示内存控制面（测试用）。 */
-    persist?: (snapshot: PluginIntentSnapshot) => Promise<void>;
-    /** 有界去重记录数量，避免 commandId 永久增长。 */
-    maxCommandRecords?: number;
-}
-/** 创建单一控制面上的插件意图控制器。 */
-declare function createPluginIntentController(options?: CreatePluginIntentControllerOptions): PluginIntentController;
-
-interface CreateServiceBridgeOptions {
-    /** 要接受的精确服务协议版本。 */
-    protocolVersion: string;
-    /** 实际端口 RPC 传输；桥不负责重放请求。 */
-    transport: RemoteServiceTransport;
-    /** 默认总 deadline；必须有限且大于零。 */
-    defaultCallTimeoutMs?: number;
-}
-/** 创建一个无连接握手、无增量 revision 状态机的服务桥。 */
-declare function createServiceBridge(options: CreateServiceBridgeOptions): RemoteServiceBridge;
-
-interface RemoteServicePortCallMessage {
-    type: string;
-    protocolVersion: string;
-    callId: string;
-    capabilityId: string;
-    contractVersion: string;
-    serviceInstanceId: string;
-    operationId?: string;
-    grantId?: string;
-    request: unknown;
-}
-interface RemoteServicePortResultMessage {
-    type: string;
-    protocolVersion: string;
-    callId: string;
-    serviceInstanceId: string;
-    result: unknown;
-}
-interface RemoteServicePortErrorMessage {
-    type: string;
-    protocolVersion: string;
-    callId: string;
-    serviceInstanceId: string;
-    error: {
-        name?: string;
-        message: string;
-        code: string;
-        details?: Readonly<Record<string, unknown>>;
-    };
-}
-interface RemoteServicePortCancelMessage {
-    type: string;
-    protocolVersion: string;
-    callId: string;
-    serviceInstanceId: string;
-}
-type RemoteServicePortResponseMessage = RemoteServicePortResultMessage | RemoteServicePortErrorMessage;
-interface CreateMessagePortServiceTransportOptions {
-    /** 已由实际 Worker / Window 连接产生的双工端口。 */
-    port: MessagePort;
-    /** 可选 transferable 提取器；默认只发送结构化克隆数据。 */
-    transferForRequest?: (request: unknown, context: RemoteServiceCallContext) => readonly Transferable[];
-    /** dispose 时是否关闭端口；默认不关闭，由端口所有者决定。 */
-    closeOnDispose?: boolean;
-    /** wire 消息 codec；默认 webloom.remote-service.v2。 */
-    codec?: RemoteServiceMessageCodec;
-    /** 直接使用 transport 时的默认总 deadline。 */
-    defaultCallTimeoutMs?: number;
-}
-/** 创建一条不携带连接身份、不会自动重放的 MessagePort transport。 */
-declare function createMessagePortServiceTransport(options: CreateMessagePortServiceTransportOptions): RemoteServiceTransport & {
-    dispose(): void;
-};
-/** Provider 侧调用消息的结构化输入。 */
-interface MessagePortServiceCallInput {
-    message: RemoteServicePortCallMessage;
-    /** Provider 的权威目录命中的服务引用。 */
-    reference: RemoteServiceReference;
-    signal: AbortSignal;
-}
-
-/**
- * 资源注册表实现
- *
- * 设计缘由：管理资源定义的注册和查询，支持 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;
-
-export { createMessageBus as A, createMessagePortServiceTransport as B, type ConnectSharedWorkerOptions as C, createPluginIntentController as D, createResourceRegistry as E, createResourceScope as F, createRuntimeMessageCodec as G, createRuntimeUnitImplementationRegistry as H, createServiceBridge as I, isRuntimeError as J, isRuntimeSnapshot as K, isRuntimeSnapshotProtocol as L, type MessagePortServiceCallInput as M, registerOwnedResource as N, unitSnapshotFromState as O, type SharedWorkerFactory as P, connectSharedWorkerForTesting as Q, type RuntimeHandle as R, type SharedWorkerConnectionContext as S, type WindowApp as W, type RuntimeStatusSnapshot as a, type RuntimeStatusListener as b, type CreateMessagePortServiceTransportOptions as c, type CreatePluginIntentControllerOptions as d, type CreateResourceScopeOptions as e, type CreateServiceBridgeOptions as f, RUNTIME_ERROR_TYPE as g, RUNTIME_PROTOCOL_VERSION as h, RUNTIME_SNAPSHOT_TYPE as i, type RemoteServicePortCallMessage as j, type RemoteServicePortCancelMessage as k, type RemoteServicePortErrorMessage as l, type RemoteServicePortResponseMessage as m, type RemoteServicePortResultMessage as n, type ResourceScopeOptions as o, type RuntimeAppState as p, type RuntimeErrorMessage as q, RuntimeInitializationError as r, type RuntimeInitializationErrorDetails as s, type RuntimeSnapshot as t, type RuntimeSnapshotUnit as u, RuntimeUnavailableError as v, type RuntimeUnitImplementation as w, type SharedWorkerLike as x, connectSharedWorker as y, createLifecycleScope as z };