@dp-bohrium/widget-sdk 0.0.5 → 0.0.6

package/dist/compatibility/testing.js

@@ -1,4 +1,4 @@
-import { n as MemoryTransport, t as ProtocolEndpoint } from "../protocol-endpoint-CHWoXvKN.js";
+import { n as MemoryTransport, t as ProtocolEndpoint } from "../protocol-endpoint-ZmZWaN92.js";
 //#region src/runtime/mock-host.ts
 const widgetMessageTypes = /* @__PURE__ */ new Set([
 	"ready",

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export type { CreateWidgetClientOptions, PresentationFocusDirection, PresentationSurface, SubscribeWidgetEventsOptions, WidgetCapabilityRequestOptions, WidgetClientEvents, WidgetClientFactoryOptions, WidgetClientOptions, WidgetClientState, WidgetDisposeEvent, WidgetEventBatchContext, WidgetEventSubscription, WidgetHostConnectMessage, WidgetMessagePort, WidgetNetworkClient, WidgetNetworkFetchResult, WidgetRuntimeWindow, WidgetSize, WidgetToolHooks, WidgetTransport, } from "./runtime/index.js";
+export type { CreateWidgetClientOptions, PresentationFocusDirection, PresentationSurface, SubscribeWidgetEventsOptions, WidgetCapabilityRequestOptions, WidgetClientEvents, WidgetClientFactoryOptions, WidgetClientOptions, WidgetClientState, WidgetDisposeEvent, WidgetEventBatchContext, WidgetEventSubscription, WidgetHostConnectMessage, WidgetLiveEventContext, WidgetLiveEventHandler, WidgetMessagePort, WidgetNetworkClient, WidgetNetworkFetchResult, WidgetRuntimeWindow, WidgetSize, WidgetToolHooks, WidgetTransport, } from "./runtime/index.js";
 export { createWidgetClient, PRESENTATION_CONFIRMATION_TIMEOUT_MS, } from "./runtime/index.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-import { i as createWidgetClient, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS } from "./runtime-D-xKLIEj.js";
+import { i as createWidgetClient, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS } from "./runtime-Bva0ricl.js";
 export { PRESENTATION_CONFIRMATION_TIMEOUT_MS, createWidgetClient };

package/dist/{protocol-endpoint-CHWoXvKN.js → protocol-endpoint-ZmZWaN92.js}

@@ -3,6 +3,7 @@ const protocolMessageTypes = /* @__PURE__ */ new Set([
 	"init",
 	"render",
 	"update",
+	"event",
 	"capability-result",
 	"error",
 	"dispose",
@@ -38,6 +39,7 @@ function isProtocolPayload(type, payload) {
 			const content = property(payload, "content");
 			return property(payload, "schemaVersion") === 1 && typeof property(payload, "requestId") === "string" && typeof property(payload, "instanceId") === "string" && typeof revision === "number" && Number.isSafeInteger(revision) && revision >= 1 && typeof property(payload, "slot") === "string" && typeof property(payload, "state") === "string" && isRecord(context) && isRecord(content);
 		}
+		case "event": return property(payload, "schemaVersion") === 1 && typeof property(payload, "id") === "string" && typeof property(payload, "occurredAt") === "string" && typeof property(payload, "sessionId") === "string" && typeof property(payload, "workflowId") === "string" && typeof property(payload, "topic") === "string" && typeof property(payload, "type") === "string" && isRecord(property(payload, "payload"));
 		case "capability-result": return typeof property(payload, "requestId") === "string" && isRecord(property(payload, "result"));
 		case "error": return typeof property(payload, "code") === "string" && typeof property(payload, "phase") === "string" && typeof property(payload, "message") === "string" && typeof property(payload, "retryable") === "boolean" && typeof property(payload, "correlationId") === "string";
 		case "dispose": return typeof property(payload, "reason") === "string" && isFiniteNonNegative(property(payload, "deadlineMs"));

package/dist/runtime/bootstrap.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, InitPayload, PresentationCapabilityResult, RenderRequest, WidgetError } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, InitPayload, PresentationCapabilityResult, PublicWidgetEvent, RenderRequest, WidgetError } from "@dp-bohrium/widget-contracts";
 import { type PresentationFocusDirection, type PresentationSurface, type WidgetCapabilityRequestOptions, type WidgetClientEvents, type WidgetClientState } from "./client.js";
 import { type SubscribeWidgetEventsOptions, type WidgetEventSubscription, type WidgetToolHooks } from "./events.js";
 import type { WidgetNetworkClient } from "./network.js";
@@ -21,6 +21,12 @@ export interface WidgetDisposeEvent {
     reason: string;
     deadlineMs?: number;
 }
+/** Widget Runtime 订阅实时 Workflow 事件时收到的上下文。 */
+export interface WidgetLiveEventContext {
+    readonly signal: AbortSignal;
+}
+/** 由 Host 通过当前 MessageChannel 推送的实时 Workflow 事件处理器。 */
+export type WidgetLiveEventHandler = (event: PublicWidgetEvent, context: WidgetLiveEventContext) => void | Promise<void>;
 export interface CreateWidgetClientOptions {
     widgetSdkVersion: string;
     hostApiVersion?: 1;
@@ -34,6 +40,7 @@ export interface CreateWidgetClientOptions {
     onInit?: (payload: InitPayload) => void | PromiseLike<void>;
     onRender?: (request: RenderRequest) => void;
     onUpdate?: (request: RenderRequest) => void;
+    onEvent?: WidgetLiveEventHandler;
     onError?: (error: WidgetError) => void;
     onDispose?: (event: WidgetDisposeEvent) => void;
 }
@@ -66,6 +73,8 @@ export declare class WidgetRuntimeClient {
     private readonly subscriptions;
     private readonly eventReads;
     private readonly eventReadsLifetime;
+    private readonly liveEventLifetime;
+    private readonly liveEventHandlers;
     private presentationKeyboard;
     constructor(options: CreateWidgetClientOptions);
     get currentState(): WidgetClientState;
@@ -78,6 +87,12 @@ export declare class WidgetRuntimeClient {
     changePresentationSurface(surface: PresentationSurface, options?: WidgetCapabilityRequestOptions): Promise<PresentationCapabilityResult>;
     focusPresentationBoundary(direction: PresentationFocusDirection, options?: WidgetCapabilityRequestOptions): Promise<PresentationCapabilityResult>;
     subscribeEvents(options: SubscribeWidgetEventsOptions): WidgetEventSubscription;
+    /**
+     * 订阅 Host 从当前 Workflow 流实时推送的事件。
+     *
+     * Topic 授权由 Host 在发送前按 Manifest 与 Grant 过滤；这里不发起 HTTP 轮询。
+     */
+    onEvent(handler: WidgetLiveEventHandler): () => void;
     onTool(hooks: WidgetToolHooks, options: Pick<SubscribeWidgetEventsOptions, "cursor" | "onError">): WidgetEventSubscription;
     invokeAction(input: Extract<CapabilityRequest, {
         operation: "actions.invoke";

package/dist/runtime/client.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, GrantedCapability, InitPayload, PresentationCapabilityRequest, PresentationCapabilityResult, RenderRequest, WidgetError } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, GrantedCapability, InitPayload, PresentationCapabilityRequest, PresentationCapabilityResult, PublicWidgetEvent, RenderRequest, WidgetError } from "@dp-bohrium/widget-contracts";
 import { type WidgetNetworkClient } from "./network.js";
 import type { WidgetTransport } from "./transport.js";
 export type WidgetClientState = "created" | "waiting-ready" | "ready" | "disposed";
@@ -16,6 +16,8 @@ export interface WidgetClientEvents {
     onInit?: (payload: InitPayload) => void | PromiseLike<void>;
     onRender?: (request: RenderRequest, update: boolean) => void;
     onUpdate?: (request: RenderRequest) => void;
+    /** 接收 Host 从当前 Workflow 流主动推送的公开事件。 */
+    onEvent?: (event: PublicWidgetEvent) => void;
     onError?: (error: WidgetError) => void;
     onDispose?: (reason: string, deadlineMs?: number) => void;
 }

package/dist/runtime/index.d.ts

@@ -1,4 +1,4 @@
-export type { CreateWidgetClientOptions, WidgetClientFactoryOptions, WidgetDisposeEvent, WidgetHostConnectMessage, WidgetRuntimeWindow, WidgetSize, } from "./bootstrap.js";
+export type { CreateWidgetClientOptions, WidgetClientFactoryOptions, WidgetDisposeEvent, WidgetHostConnectMessage, WidgetLiveEventContext, WidgetLiveEventHandler, WidgetRuntimeWindow, WidgetSize, } from "./bootstrap.js";
 export { createWidgetClient, isWidgetHostConnectMessage, WIDGET_BOOTSTRAP_READY, WIDGET_HOST_CONNECT, WidgetRuntimeClient, } from "./bootstrap.js";
 export type { PresentationFocusDirection, PresentationSurface, WidgetCapabilityRequestOptions, WidgetClientEvents, WidgetClientOptions, WidgetClientState, } from "./client.js";
 export { PRESENTATION_CONFIRMATION_TIMEOUT_MS, WidgetClient, } from "./client.js";

package/dist/runtime/index.js

@@ -1,3 +1,3 @@
-import { a as isWidgetHostConnectMessage, i as createWidgetClient, n as WIDGET_HOST_CONNECT, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS, r as WidgetRuntimeClient, s as WidgetClient, t as WIDGET_BOOTSTRAP_READY } from "../runtime-D-xKLIEj.js";
-import { i as isWidgetProtocolMessage, r as MessagePortTransport } from "../protocol-endpoint-CHWoXvKN.js";
+import { a as isWidgetHostConnectMessage, i as createWidgetClient, n as WIDGET_HOST_CONNECT, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS, r as WidgetRuntimeClient, s as WidgetClient, t as WIDGET_BOOTSTRAP_READY } from "../runtime-Bva0ricl.js";
+import { i as isWidgetProtocolMessage, r as MessagePortTransport } from "../protocol-endpoint-ZmZWaN92.js";
 export { MessagePortTransport, PRESENTATION_CONFIRMATION_TIMEOUT_MS, WIDGET_BOOTSTRAP_READY, WIDGET_HOST_CONNECT, WidgetClient, WidgetRuntimeClient, createWidgetClient, isWidgetHostConnectMessage, isWidgetProtocolMessage };

package/dist/{runtime-D-xKLIEj.js → runtime-Bva0ricl.js}

@@ -1,4 +1,4 @@
-import { r as MessagePortTransport, t as ProtocolEndpoint } from "./protocol-endpoint-CHWoXvKN.js";
+import { r as MessagePortTransport, t as ProtocolEndpoint } from "./protocol-endpoint-ZmZWaN92.js";
 //#region src/runtime/network.ts
 const failureReasons = /* @__PURE__ */ new Set([
 	"unsupported",
@@ -251,6 +251,7 @@ const hostMessageTypes = /* @__PURE__ */ new Set([
 	"init",
 	"render",
 	"update",
+	"event",
 	"capability-result",
 	"error",
 	"dispose"
@@ -435,6 +436,9 @@ var WidgetClient = class {
 			const isUpdate = message.type === "update";
 			this.events.onRender?.(message.payload, isUpdate);
 			if (isUpdate) this.events.onUpdate?.(message.payload);
+		} else if (message.type === "event") {
+			if (this.state !== "ready") return;
+			this.events.onEvent?.(message.payload);
 		} else if (message.type === "capability-result") {
 			const pending = this.pending.get(message.payload.requestId);
 			if (!pending) return;
@@ -834,6 +838,7 @@ function defaultWindow() {
 function createEvents(options) {
 	const base = options.events;
 	const events = {};
+	const liveEventLifetime = new AbortController();
 	if (base?.onInit || options.onInit) events.onInit = async (payload) => {
 		await base?.onInit?.(payload);
 		await options.onInit?.(payload);
@@ -849,11 +854,20 @@ function createEvents(options) {
 		}
 	};
 	if (base?.onUpdate) events.onUpdate = base.onUpdate;
+	if (base?.onEvent || options.onEvent) events.onEvent = (event) => {
+		try {
+			base?.onEvent?.(event);
+		} catch {}
+		try {
+			Promise.resolve(options.onEvent?.(event, { signal: liveEventLifetime.signal })).catch(() => void 0);
+		} catch {}
+	};
 	if (base?.onError || options.onError) events.onError = (error) => {
 		base?.onError?.(error);
 		options.onError?.(error);
 	};
-	if (base?.onDispose || options.onDispose) events.onDispose = (reason, deadlineMs) => {
+	if (base?.onDispose || options.onDispose || base?.onEvent || options.onEvent) events.onDispose = (reason, deadlineMs) => {
+		liveEventLifetime.abort();
 		base?.onDispose?.(reason, deadlineMs);
 		options.onDispose?.({
 			reason,
@@ -892,6 +906,8 @@ var WidgetRuntimeClient = class {
 	subscriptions = /* @__PURE__ */ new Set();
 	eventReads = createWidgetEventReadScheduler();
 	eventReadsLifetime = new AbortController();
+	liveEventLifetime = new AbortController();
+	liveEventHandlers = /* @__PURE__ */ new Set();
 	presentationKeyboard;
 	constructor(options) {
 		this.options = options;
@@ -904,6 +920,13 @@ var WidgetRuntimeClient = class {
 				this.capabilities = cloneGrantedCapabilities(payload.capabilities);
 				await userEvents.onInit?.(payload);
 			},
+			onEvent: (event) => {
+				userEvents.onEvent?.(event);
+				const context = { signal: this.liveEventLifetime.signal };
+				for (const handler of this.liveEventHandlers) try {
+					Promise.resolve(handler(event, context)).catch(() => void 0);
+				} catch {}
+			},
 			onDispose: (reason, deadlineMs) => {
 				this.stopSubscriptions();
 				this.stopPresentationKeyboard();
@@ -1000,6 +1023,18 @@ var WidgetRuntimeClient = class {
 		if (this.disposed || this.currentState === "disposed") subscription.unsubscribe();
 		return subscription;
 	}
+	/**
+	* 订阅 Host 从当前 Workflow 流实时推送的事件。
+	*
+	* Topic 授权由 Host 在发送前按 Manifest 与 Grant 过滤；这里不发起 HTTP 轮询。
+	*/
+	onEvent(handler) {
+		if (this.disposed) throw new Error("client is disposed");
+		this.liveEventHandlers.add(handler);
+		return () => {
+			this.liveEventHandlers.delete(handler);
+		};
+	}
 	onTool(hooks, options) {
 		return this.subscribeEvents({
 			...options,
@@ -1017,6 +1052,8 @@ var WidgetRuntimeClient = class {
 	}
 	stopSubscriptions() {
 		this.eventReadsLifetime.abort();
+		this.liveEventLifetime.abort();
+		this.liveEventHandlers.clear();
 		for (const subscription of this.subscriptions) subscription.unsubscribe();
 		this.subscriptions.clear();
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-sdk",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Bohrium Widget 开发者 SDK：在 Widget Bundle 内与 Host 建立 Bridge，并暴露生命周期与能力协议。",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dp-bohrium/widget-contracts": "0.0.5"
+    "@dp-bohrium/widget-contracts": "0.0.6"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.0",