@schema-element-editor/host-sdk 2.0.2 → 2.1.0

package/dist/core.cjs

@@ -23,10 +23,13 @@ __export(core_exports, {
   createSchemaElementEditorBridge: () => createSchemaElementEditorBridge
 });
 module.exports = __toCommonJS(core_exports);
+
+// src/constants.ts
 var DEFAULT_SOURCE_CONFIG = {
   contentSource: "schema-element-editor-content",
   hostSource: "schema-element-editor-host"
 };
+var SDK_COORDINATOR_SOURCE = "schema-element-editor-sdk-coordinator";
 var DEFAULT_MESSAGE_TYPES = {
   getSchema: "GET_SCHEMA",
   updateSchema: "UPDATE_SCHEMA",
@@ -38,8 +41,239 @@ var DEFAULT_MESSAGE_TYPES = {
   stopRecording: "STOP_RECORDING",
   schemaPush: "SCHEMA_PUSH"
 };
+var SDK_COORDINATION_MESSAGE_TYPES = {
+  register: "SDK_REGISTER",
+  unregister: "SDK_UNREGISTER",
+  query: "SDK_QUERY"
+};
+
+// src/coordinator.ts
+var SdkCoordinator = class {
+  constructor(config) {
+    /**
+     * SDK 销毁标志
+     *
+     * 作用：防止在 cleanup() 执行期间，监听器移除前仍然响应请求
+     *
+     * 场景：cleanup() 中先调用 destroy()（设置 isDestroyed = true），
+     * 然后才移除 handleMessage 监听器。在这个微小的时间窗口内，
+     * 如果插件请求到达，没有 isDestroyed 检查会导致已销毁的 SDK 仍然响应。
+     */
+    this.isDestroyed = false;
+    /**
+     * 存储比当前 SDK 优先级更高的其他 SDK ID
+     * 按方法分类：如果某个方法的集合不为空，说明有更高优先级的 SDK 应该处理该方法
+     *
+     * 优化：只为当前 SDK 实现了的方法维护优先级集合
+     */
+    this.higherLevelSDKs = {};
+    /**
+     * 存储与当前 SDK 优先级相同的其他 SDK ID
+     * 按方法分类：用于判断是否需要在执行失败时跳过响应
+     *
+     * 当有同级竞争者时，SDK在执行失败/无数据时会跳过响应，让其他SDK有机会响应
+     */
+    this.sameLevelSDKs = {};
+    /**
+     * 处理 SDK 协调消息
+     */
+    this.handleCoordinationMessage = (event) => {
+      const isFromSelf = event.source === window;
+      const isFromParent = window !== window.top && event.source === window.parent;
+      if (!isFromSelf && !isFromParent) return;
+      const data = event.data;
+      if (!data || data.source !== SDK_COORDINATOR_SOURCE) return;
+      switch (data.type) {
+        case SDK_COORDINATION_MESSAGE_TYPES.query:
+          this.sendRegister();
+          break;
+        case SDK_COORDINATION_MESSAGE_TYPES.register:
+          this.handleSdkRegister(data.payload);
+          break;
+        case SDK_COORDINATION_MESSAGE_TYPES.unregister:
+          this.handleSdkUnregister(data.payload.sdkId);
+          break;
+      }
+    };
+    this.sdkId = config.sdkId || `sdk-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+    this.messageSource = config.messageSource;
+    this.level = config.level ?? 0;
+    this.methodLevels = config.methodLevels ?? {};
+    this.implementedMethods = config.implementedMethods;
+    this.implementedMethods.forEach((method) => {
+      this.higherLevelSDKs[method] = /* @__PURE__ */ new Set();
+      this.sameLevelSDKs[method] = /* @__PURE__ */ new Set();
+    });
+  }
+  /**
+   * 初始化协调器
+   */
+  init() {
+    window.addEventListener("message", this.handleCoordinationMessage);
+    this.sendQuery();
+    this.sendRegister();
+  }
+  /**
+   * 销毁协调器
+   */
+  destroy() {
+    this.isDestroyed = true;
+    this.sendUnregister();
+    window.removeEventListener("message", this.handleCoordinationMessage);
+    Object.values(this.higherLevelSDKs).forEach((set) => set.clear());
+    Object.values(this.sameLevelSDKs).forEach((set) => set.clear());
+  }
+  /**
+   * 判断是否应该响应某个方法的请求
+   * @param method - 方法名
+   * @returns 是否应该响应
+   */
+  shouldRespond(method) {
+    if (this.isDestroyed) return false;
+    if (!this.implementedMethods.includes(method)) {
+      return false;
+    }
+    const higherSDKs = this.higherLevelSDKs[method];
+    return !higherSDKs || higherSDKs.size === 0;
+  }
+  /**
+   * 判断某个方法是否有相同优先级的竞争者
+   * @param method - 方法名
+   * @returns 是否存在同级竞争者
+   */
+  hasSameLevelCompetitors(method) {
+    const sameSDKs = this.sameLevelSDKs[method];
+    return sameSDKs ? sameSDKs.size > 0 : false;
+  }
+  /**
+   * 获取方法的优先级
+   */
+  getMethodLevel(method) {
+    return this.methodLevels[method] ?? this.level;
+  }
+  /**
+   * 处理其他 SDK 的注册
+   */
+  handleSdkRegister(info) {
+    if (info.sdkId === this.sdkId) return;
+    if (info.messageSource !== this.messageSource) return;
+    this.implementedMethods.forEach((method) => {
+      if (!info.implementedMethods.includes(method)) {
+        return;
+      }
+      const myLevel = this.getMethodLevel(method);
+      const otherLevel = info.methodLevels[method] ?? info.level;
+      if (otherLevel > myLevel) {
+        this.higherLevelSDKs[method].add(info.sdkId);
+        this.sameLevelSDKs[method].delete(info.sdkId);
+      } else if (otherLevel === myLevel) {
+        this.sameLevelSDKs[method].add(info.sdkId);
+        this.higherLevelSDKs[method].delete(info.sdkId);
+      } else {
+        this.higherLevelSDKs[method].delete(info.sdkId);
+        this.sameLevelSDKs[method].delete(info.sdkId);
+      }
+    });
+  }
+  /**
+   * 处理其他 SDK 的注销
+   */
+  handleSdkUnregister(sdkId) {
+    Object.values(this.higherLevelSDKs).forEach((set) => {
+      set.delete(sdkId);
+    });
+    Object.values(this.sameLevelSDKs).forEach((set) => {
+      set.delete(sdkId);
+    });
+  }
+  /**
+   * 发送查询消息
+   */
+  sendQuery() {
+    const message = {
+      source: SDK_COORDINATOR_SOURCE,
+      type: SDK_COORDINATION_MESSAGE_TYPES.query,
+      payload: { sdkId: this.sdkId }
+    };
+    this.postCoordinationMessage(message);
+  }
+  /**
+   * 发送注册消息
+   */
+  sendRegister() {
+    const message = {
+      source: SDK_COORDINATOR_SOURCE,
+      type: SDK_COORDINATION_MESSAGE_TYPES.register,
+      payload: {
+        sdkId: this.sdkId,
+        messageSource: this.messageSource,
+        level: this.level,
+        methodLevels: this.methodLevels,
+        implementedMethods: this.implementedMethods
+      }
+    };
+    this.postCoordinationMessage(message);
+  }
+  /**
+   * 发送注销消息
+   */
+  sendUnregister() {
+    const message = {
+      source: SDK_COORDINATOR_SOURCE,
+      type: SDK_COORDINATION_MESSAGE_TYPES.unregister,
+      payload: { sdkId: this.sdkId }
+    };
+    this.postCoordinationMessage(message);
+  }
+  /**
+   * 发送协调消息
+   */
+  postCoordinationMessage(message) {
+    window.postMessage(message, "*");
+    if (window.top && window.top !== window) {
+      window.top.postMessage(message, "*");
+    }
+  }
+};
+
+// src/bridge.ts
+var METHOD_NAMES = {
+  GET_SCHEMA: "getSchema",
+  UPDATE_SCHEMA: "updateSchema",
+  CHECK_PREVIEW: "checkPreview",
+  RENDER_PREVIEW: "renderPreview",
+  CLEANUP_PREVIEW: "cleanupPreview",
+  START_RECORDING: "startRecording",
+  STOP_RECORDING: "stopRecording"
+};
+function shouldSkipFailedResponse(method, result) {
+  switch (method) {
+    case METHOD_NAMES.GET_SCHEMA:
+      return result.success === true && result.data === void 0;
+    case METHOD_NAMES.UPDATE_SCHEMA:
+      return result.success === false;
+    case METHOD_NAMES.RENDER_PREVIEW:
+    case METHOD_NAMES.CLEANUP_PREVIEW:
+      return result.success === false;
+    case METHOD_NAMES.CHECK_PREVIEW:
+    case METHOD_NAMES.START_RECORDING:
+    case METHOD_NAMES.STOP_RECORDING:
+      return false;
+    default:
+      return false;
+  }
+}
 function createSchemaElementEditorBridge(config) {
-  const { getSchema, updateSchema, renderPreview, sourceConfig, messageTypes } = config;
+  const {
+    getSchema,
+    updateSchema,
+    renderPreview,
+    sourceConfig,
+    messageTypes,
+    sdkId,
+    level,
+    methodLevels
+  } = config;
   const mergedSourceConfig = {
     ...DEFAULT_SOURCE_CONFIG,
     ...sourceConfig
@@ -48,9 +282,40 @@ function createSchemaElementEditorBridge(config) {
     ...DEFAULT_MESSAGE_TYPES,
     ...messageTypes
   };
+  const implementedMethods = [];
+  if (typeof getSchema === "function") implementedMethods.push(METHOD_NAMES.GET_SCHEMA);
+  if (typeof updateSchema === "function") implementedMethods.push(METHOD_NAMES.UPDATE_SCHEMA);
+  if (typeof renderPreview === "function") {
+    implementedMethods.push(
+      METHOD_NAMES.CHECK_PREVIEW,
+      METHOD_NAMES.RENDER_PREVIEW,
+      METHOD_NAMES.CLEANUP_PREVIEW
+    );
+  }
+  implementedMethods.push(METHOD_NAMES.START_RECORDING, METHOD_NAMES.STOP_RECORDING);
+  const coordinator = new SdkCoordinator({
+    sdkId,
+    messageSource: mergedSourceConfig.contentSource,
+    level,
+    methodLevels,
+    implementedMethods
+  });
+  coordinator.init();
   let previewCleanupFn = null;
   const recordingParams = /* @__PURE__ */ new Set();
   const currentConfig = { getSchema, updateSchema, renderPreview };
+  const methodTypeToName = {
+    [mergedMessageTypes.getSchema]: METHOD_NAMES.GET_SCHEMA,
+    [mergedMessageTypes.updateSchema]: METHOD_NAMES.UPDATE_SCHEMA,
+    [mergedMessageTypes.checkPreview]: METHOD_NAMES.CHECK_PREVIEW,
+    [mergedMessageTypes.renderPreview]: METHOD_NAMES.RENDER_PREVIEW,
+    [mergedMessageTypes.cleanupPreview]: METHOD_NAMES.CLEANUP_PREVIEW,
+    [mergedMessageTypes.startRecording]: METHOD_NAMES.START_RECORDING,
+    [mergedMessageTypes.stopRecording]: METHOD_NAMES.STOP_RECORDING
+  };
+  const getMethodNameByType = (type) => {
+    return methodTypeToName[type] ?? null;
+  };
   const sendResponse = (requestId, result) => {
     const message = {
       source: mergedSourceConfig.hostSource,
@@ -83,10 +348,18 @@ function createSchemaElementEditorBridge(config) {
     if (!event.data || event.data.source !== mergedSourceConfig.contentSource) return;
     const { type, payload, requestId } = event.data;
     if (!requestId) return;
+    const methodName = getMethodNameByType(type);
+    if (!methodName) return;
+    if (!coordinator.shouldRespond(methodName)) {
+      return;
+    }
     const { getSchema: getSchema2, updateSchema: updateSchema2, renderPreview: renderPreview2 } = currentConfig;
     let result;
     switch (type) {
       case mergedMessageTypes.getSchema: {
+        if (typeof getSchema2 !== "function") {
+          return;
+        }
         const params = String(payload?.params ?? "");
         try {
           const data = getSchema2(params);
@@ -100,6 +373,9 @@ function createSchemaElementEditorBridge(config) {
         break;
       }
       case mergedMessageTypes.updateSchema: {
+        if (typeof updateSchema2 !== "function") {
+          return;
+        }
         const schema = payload?.schema;
         const params = String(payload?.params ?? "");
         try {
@@ -172,11 +448,16 @@ function createSchemaElementEditorBridge(config) {
       default:
         return;
     }
+    const hasSameLevelSdks = coordinator.hasSameLevelCompetitors(methodName);
+    if (hasSameLevelSdks && shouldSkipFailedResponse(methodName, result)) {
+      return;
+    }
     sendResponse(requestId, result);
   };
   window.addEventListener("message", handleMessage);
   return {
     cleanup: () => {
+      coordinator.destroy();
       window.removeEventListener("message", handleMessage);
       if (previewCleanupFn) {
         previewCleanupFn();

package/dist/core.d.cts

@@ -1,85 +1,16 @@
+import { b as SchemaElementEditorConfig, c as SchemaElementEditorBridge } from './types-D2ZJx8T_.cjs';
+
 /**
- * Schema Element Editor Host SDK - Core
+ * Schema Element Editor Host SDK - Bridge
  * 纯 JS 核心逻辑，无框架依赖
  */
-/**
- * Schema 数据类型
- * 支持所有 JSON.parse 可返回的类型
- */
-type SchemaValue = Record<string, unknown> | unknown[] | string | number | boolean | null;
-/** postMessage 消息标识配置 */
-interface PostMessageSourceConfig {
-    /** 插件端发送消息的 source 标识 */
-    contentSource: string;
-    /** 宿主端响应消息的 source 标识 */
-    hostSource: string;
-}
-/** postMessage 消息类型配置 */
-interface PostMessageTypeConfig {
-    getSchema: string;
-    updateSchema: string;
-    checkPreview: string;
-    renderPreview: string;
-    cleanupPreview: string;
-    startRecording: string;
-    stopRecording: string;
-    schemaPush: string;
-}
-/**
- * Schema Element Editor 配置接口
- */
-interface SchemaElementEditorConfig {
-    /**
-     * 获取 Schema 数据
-     * @param params - 元素参数（通常是 data-id 的值）
-     * @returns Schema 数据（支持所有 JSON 类型）
-     */
-    getSchema: (params: string) => SchemaValue;
-    /**
-     * 更新 Schema 数据
-     * @param schema - 新的 Schema 数据（支持所有 JSON 类型）
-     * @param params - 元素参数
-     * @returns 是否更新成功
-     */
-    updateSchema: (schema: SchemaValue, params: string) => boolean;
-    /**
-     * 渲染预览（可选）
-     * @param schema - Schema 数据（支持所有 JSON 类型）
-     * @param containerId - 预览容器 ID
-     * @returns 清理函数（可选）
-     */
-    renderPreview?: (schema: SchemaValue, containerId: string) => (() => void) | void;
-    /** 消息标识配置（可选，有默认值） */
-    sourceConfig?: Partial<PostMessageSourceConfig>;
-    /** 消息类型配置（可选，有默认值） */
-    messageTypes?: Partial<PostMessageTypeConfig>;
-}
-/**
- * 录制相关方法
- */
-interface SchemaElementEditorRecording {
-    /**
-     * 推送 Schema 数据（SDK 内部判断是否在录制，未录制时静默忽略）
-     * @param params - 元素参数（data-id 的值）
-     * @param data - Schema 数据
-     */
-    push: (params: string, data: SchemaValue) => void;
-}
-/**
- * Schema Element Editor 桥接器返回值
- */
-interface SchemaElementEditorBridge {
-    /** 清理桥接器，移除事件监听 */
-    cleanup: () => void;
-    /** 录制相关方法 */
-    recording: SchemaElementEditorRecording;
-}
+
 /**
  * 创建 Schema Element Editor 桥接器
  * 纯 JS 函数，返回桥接器对象
  *
  * @param config - Schema Element Editor 配置
- * @returns 桥接器对象，包含 cleanup 和 pushSchema 方法
+ * @returns 桥接器对象，包含 cleanup 和 recording 方法
  *
  * @example
  * ```js
@@ -92,16 +23,20 @@ interface SchemaElementEditorBridge {
  *   },
  * })
  *
- * // 数据变化时调用 pushSchema 推送数据（录制功能自动可用）
+ * // 只提供预览功能，让其他 SDK 处理数据管理
+ * const bridge = createSchemaElementEditorBridge({
+ *   level: 100,
+ *   renderPreview: (schema, containerId) => {
+ *     renderMyCustomPreview(schema, containerId)
+ *   },
+ * })
+ *
+ * // 数据变化时调用 recording.push 推送数据（录制功能自动可用）
  * sseHandler.onData = (params, data) => {
- *   bridge.pushSchema(params, data)
+ *   bridge.recording.push(params, data)
  * }
- *
- * // 如需在录制开始/停止时执行额外逻辑，可配置回调（可选）
- * // onStartRecording: (params) => console.log('开始录制:', params),
- * // onStopRecording: (params) => console.log('停止录制:', params),
  * ```
  */
 declare function createSchemaElementEditorBridge(config: SchemaElementEditorConfig): SchemaElementEditorBridge;
 
-export { type PostMessageSourceConfig, type PostMessageTypeConfig, type SchemaElementEditorBridge, type SchemaElementEditorConfig, type SchemaElementEditorRecording, type SchemaValue, createSchemaElementEditorBridge };
+export { createSchemaElementEditorBridge };

package/dist/core.d.ts

@@ -1,85 +1,16 @@
+import { b as SchemaElementEditorConfig, c as SchemaElementEditorBridge } from './types-D2ZJx8T_.js';
+
 /**
- * Schema Element Editor Host SDK - Core
+ * Schema Element Editor Host SDK - Bridge
  * 纯 JS 核心逻辑，无框架依赖
  */
-/**
- * Schema 数据类型
- * 支持所有 JSON.parse 可返回的类型
- */
-type SchemaValue = Record<string, unknown> | unknown[] | string | number | boolean | null;
-/** postMessage 消息标识配置 */
-interface PostMessageSourceConfig {
-    /** 插件端发送消息的 source 标识 */
-    contentSource: string;
-    /** 宿主端响应消息的 source 标识 */
-    hostSource: string;
-}
-/** postMessage 消息类型配置 */
-interface PostMessageTypeConfig {
-    getSchema: string;
-    updateSchema: string;
-    checkPreview: string;
-    renderPreview: string;
-    cleanupPreview: string;
-    startRecording: string;
-    stopRecording: string;
-    schemaPush: string;
-}
-/**
- * Schema Element Editor 配置接口
- */
-interface SchemaElementEditorConfig {
-    /**
-     * 获取 Schema 数据
-     * @param params - 元素参数（通常是 data-id 的值）
-     * @returns Schema 数据（支持所有 JSON 类型）
-     */
-    getSchema: (params: string) => SchemaValue;
-    /**
-     * 更新 Schema 数据
-     * @param schema - 新的 Schema 数据（支持所有 JSON 类型）
-     * @param params - 元素参数
-     * @returns 是否更新成功
-     */
-    updateSchema: (schema: SchemaValue, params: string) => boolean;
-    /**
-     * 渲染预览（可选）
-     * @param schema - Schema 数据（支持所有 JSON 类型）
-     * @param containerId - 预览容器 ID
-     * @returns 清理函数（可选）
-     */
-    renderPreview?: (schema: SchemaValue, containerId: string) => (() => void) | void;
-    /** 消息标识配置（可选，有默认值） */
-    sourceConfig?: Partial<PostMessageSourceConfig>;
-    /** 消息类型配置（可选，有默认值） */
-    messageTypes?: Partial<PostMessageTypeConfig>;
-}
-/**
- * 录制相关方法
- */
-interface SchemaElementEditorRecording {
-    /**
-     * 推送 Schema 数据（SDK 内部判断是否在录制，未录制时静默忽略）
-     * @param params - 元素参数（data-id 的值）
-     * @param data - Schema 数据
-     */
-    push: (params: string, data: SchemaValue) => void;
-}
-/**
- * Schema Element Editor 桥接器返回值
- */
-interface SchemaElementEditorBridge {
-    /** 清理桥接器，移除事件监听 */
-    cleanup: () => void;
-    /** 录制相关方法 */
-    recording: SchemaElementEditorRecording;
-}
+
 /**
  * 创建 Schema Element Editor 桥接器
  * 纯 JS 函数，返回桥接器对象
  *
  * @param config - Schema Element Editor 配置
- * @returns 桥接器对象，包含 cleanup 和 pushSchema 方法
+ * @returns 桥接器对象，包含 cleanup 和 recording 方法
  *
  * @example
  * ```js
@@ -92,16 +23,20 @@ interface SchemaElementEditorBridge {
  *   },
  * })
  *
- * // 数据变化时调用 pushSchema 推送数据（录制功能自动可用）
+ * // 只提供预览功能，让其他 SDK 处理数据管理
+ * const bridge = createSchemaElementEditorBridge({
+ *   level: 100,
+ *   renderPreview: (schema, containerId) => {
+ *     renderMyCustomPreview(schema, containerId)
+ *   },
+ * })
+ *
+ * // 数据变化时调用 recording.push 推送数据（录制功能自动可用）
  * sseHandler.onData = (params, data) => {
- *   bridge.pushSchema(params, data)
+ *   bridge.recording.push(params, data)
  * }
- *
- * // 如需在录制开始/停止时执行额外逻辑，可配置回调（可选）
- * // onStartRecording: (params) => console.log('开始录制:', params),
- * // onStopRecording: (params) => console.log('停止录制:', params),
  * ```
  */
 declare function createSchemaElementEditorBridge(config: SchemaElementEditorConfig): SchemaElementEditorBridge;
 
-export { type PostMessageSourceConfig, type PostMessageTypeConfig, type SchemaElementEditorBridge, type SchemaElementEditorConfig, type SchemaElementEditorRecording, type SchemaValue, createSchemaElementEditorBridge };
+export { createSchemaElementEditorBridge };

package/dist/core.js

@@ -1,6 +1,7 @@
+import "./chunk-432BCQVI.js";
 import {
   createSchemaElementEditorBridge
-} from "./chunk-52EFKQHQ.js";
+} from "./chunk-LJJYJHOZ.js";
 export {
   createSchemaElementEditorBridge
 };