webloom-framework 0.2.0 → 0.4.0

package/dist/resourceRegistry-MNM1c7od.d.ts

@@ -1,157 +0,0 @@
-import { i as PluginSetup, aL as RuntimeUnitImplementationRegistry, M as MessageBus, W as LifecycleScopeKind, u as LifecycleScopeIdentity, t as LifecycleScope, L as LifecycleDisposeResult, af as PluginIntentSnapshot, ad as PluginIntentController, aw as RemoteServiceTransport, q as RemoteServiceBridge, n as RemoteServiceReference, ar as RemoteServiceCallContext, o as RemoteServiceMessageCodec, aC as ResourceRegistry, aA as ResourceDefinition } from './createPluginHost-ChJNBTsX.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 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;
-}
-/**
- * 创建一个绑定端口的服务桥。
- *
- * 快照规则：必须先接受 baseline；后续 revision 必须连续递增。发现缺口后
- * 立即清空代理，等待新 baseline，不能拿旧服务继续运行。
- */
-declare function createServiceBridge(options: CreateServiceBridgeOptions): RemoteServiceBridge;
-/** 兼容“服务桥 / 远程服务桥”两种调用语义；实现仍只有一套。 */
-declare const createRemoteServiceBridge: typeof createServiceBridge;
-
-/** MessagePort 上的调用请求；request 内容由具体服务契约定义。 */
-interface RemoteServicePortCallMessage {
-    /** 固定协议类型，避免与业务 MessageBus 事件混用。 */
-    /** codec 绑定的调用消息类型。 */
-    type: string;
-    /** 由传输层生成的唯一关联键；不接受调用方提供的业务 ID。 */
-    callId: string;
-    /** 实际端口连接标识。 */
-    connectionId: string;
-    /** 提供者运行实例；响应必须原样回显。 */
-    providerInstanceId: string;
-    /** 调用方可复用的业务操作标识；不参与 pending 映射。 */
-    operationId?: string;
-    /** 外部授权标识；Provider 最终边界必须核验。 */
-    grantId?: string;
-    /** Provider 必须在最终边界重新核验的服务引用。 */
-    reference: RemoteServiceReference;
-    /** 具体服务请求体；桥不解释也不重放。 */
-    request: unknown;
-}
-/** MessagePort 上的成功响应。 */
-interface RemoteServicePortResultMessage {
-    /** codec 绑定的成功消息类型。 */
-    type: string;
-    callId: string;
-    connectionId: string;
-    providerInstanceId: string;
-    result: unknown;
-}
-/** MessagePort 上的失败响应；只传可序列化错误信息。 */
-interface RemoteServicePortErrorMessage {
-    /** codec 绑定的失败消息类型。 */
-    type: string;
-    callId: string;
-    connectionId: string;
-    providerInstanceId: string;
-    error: {
-        name?: string;
-        message: string;
-        code?: string;
-    };
-}
-/** 请求取消通知；Provider 仍需在最终提交前做自己的世代校验。 */
-interface RemoteServicePortCancelMessage {
-    /** codec 绑定的取消消息类型。 */
-    type: string;
-    callId: string;
-    connectionId: string;
-    providerInstanceId: 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.*。 */
-    codec?: RemoteServiceMessageCodec;
-}
-/**
- * 创建一个真实 MessagePort 传输。
- *
- * 返回对象的 `dispose()` 只关闭本端请求表和监听器；默认不关闭端口，
- * 以免误伤同一端口上的握手 / 快照订阅。需要独占端口时可显式设置
- * `closeOnDispose: true`。
- */
-declare function createMessagePortServiceTransport(options: CreateMessagePortServiceTransportOptions): RemoteServiceTransport & {
-    dispose(): void;
-};
-
-/**
- * 资源注册表实现
- *
- * 设计缘由：管理资源定义的注册和查询，支持 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 { type CreateMessagePortServiceTransportOptions as C, type RemoteServicePortCallMessage as R, type CreatePluginIntentControllerOptions as a, type CreateResourceScopeOptions as b, type CreateServiceBridgeOptions as c, type RemoteServicePortCancelMessage as d, type RemoteServicePortErrorMessage as e, type RemoteServicePortResponseMessage as f, type RemoteServicePortResultMessage as g, type ResourceScopeOptions as h, type RuntimeUnitImplementation as i, createLifecycleScope as j, createMessageBus as k, createMessagePortServiceTransport as l, createPluginIntentController as m, createRemoteServiceBridge as n, createResourceRegistry as o, createResourceScope as p, createRuntimeUnitImplementationRegistry as q, createServiceBridge as r, registerOwnedResource as s };