@wapri/gjsbridge 0.0.0-stage → 3.0.0

package/dist/core/bridgeCB.d.ts

@@ -0,0 +1,49 @@
+import type { BridgeApiConfig } from '../registers';
+import type { JSBridgeConfig, NativeEventListener, NativeTransport } from '../types/bridge';
+/** 统一维护 Native 响应回调、请求 ID、pending Map 与订阅事件。 */
+export declare class BridgeCB {
+    private readonly config;
+    constructor(config: JSBridgeConfig);
+    private readonly pendingRequests;
+    private readonly eventListeners;
+    private requestSequence;
+    /** 接收 Native 一次性事务响应的全局回调。 */
+    readonly onNativeMessage: (rawResponse: string) => void;
+    /** 接收 Native 长连接或订阅事件的全局回调。 */
+    readonly onNativeEvent: (eventName: string, data: unknown) => void;
+    /**
+     * 创建一个等待 Native 响应的事务，并通过 transport 发送请求。
+     *
+     * @param options 本次 Native 调用的执行配置。
+     * @returns code 为 0 时解析 data，否则以携带 Native code 的 BridgeError 拒绝。
+     */
+    call<TData = unknown, TParams extends Record<string, unknown> = Record<string, unknown>>(method: string, params: TParams, transport: NativeTransport, options: Omit<BridgeApiConfig, 'nativeMethod' | 'initialParams'>): Promise<TData>;
+    /**
+     * 订阅指定 Native 事件。
+     *
+     * @returns 取消本次订阅的函数。
+     */
+    on<TData = unknown>(eventName: string, listener: NativeEventListener<TData>): () => void;
+    /**
+     * 订阅一次指定 Native 事件，首次触发后自动取消。
+     *
+     * @returns 提前取消本次订阅的函数。
+     */
+    once<TData = unknown>(eventName: string, listener: NativeEventListener<TData>): () => void;
+    /** 移除指定事件的一个监听函数。 */
+    off<TData = unknown>(eventName: string, listener: NativeEventListener<TData>): void;
+    /** 拒绝未完成请求并清空所有事件订阅。 */
+    destroy(): void;
+    /** 生成当前实例内唯一的请求 ID。 */
+    private createRequestId;
+    /** 根据 requestId 清理事务，并将结果交给对应的 Promise。 */
+    private settleRequest;
+    /** 解析 Native 返回的 JSON 响应，并匹配对应的一次性事务。 */
+    private handleNativeResponse;
+    /** 解析并分发指定名称的 Native 订阅事件。 */
+    private handleNativeEvent;
+    /** 尝试将 Native 传入的 JSON 字符串还原为事件数据。 */
+    private parseEventData;
+    /** 仅在当前 JSBridge 实例开启调试时输出 Native 原始数据。 */
+    private debugLog;
+}

package/dist/core/bridgeCB.js

@@ -0,0 +1,217 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { get, isNumber, isObject, isString } from '@wapri/gbase';
+import { BridgeError } from "../errors";
+var DEFAULT_TIMEOUT = 10000;
+/** 统一维护 Native 响应回调、请求 ID、pending Map 与订阅事件。 */
+export var BridgeCB = /*#__PURE__*/function () {
+  function BridgeCB(config) {
+    var _this = this;
+    _classCallCheck(this, BridgeCB);
+    _defineProperty(this, "pendingRequests", new Map());
+    _defineProperty(this, "eventListeners", new Map());
+    _defineProperty(this, "requestSequence", 0);
+    /** 接收 Native 一次性事务响应的全局回调。 */
+    _defineProperty(this, "onNativeMessage", function (rawResponse) {
+      _this.debugLog('[jsbridge] Native -> JS', rawResponse);
+      _this.handleNativeResponse(rawResponse);
+    });
+    /** 接收 Native 长连接或订阅事件的全局回调。 */
+    _defineProperty(this, "onNativeEvent", function (eventName, data) {
+      _this.debugLog('[jsbridge] Native -> JS event', eventName, data);
+      _this.handleNativeEvent(eventName, data);
+    });
+    this.config = config;
+  }
+  _createClass(BridgeCB, [{
+    key: "call",
+    value:
+    /**
+     * 创建一个等待 Native 响应的事务，并通过 transport 发送请求。
+     *
+     * @param options 本次 Native 调用的执行配置。
+     * @returns code 为 0 时解析 data，否则以携带 Native code 的 BridgeError 拒绝。
+     */
+    function call(method, params, transport, options) {
+      var _this2 = this;
+      var requestId = this.createRequestId();
+      var request = {
+        method: method,
+        params: params,
+        requestId: requestId
+      };
+      return new Promise(function (_resolve, reject) {
+        var timer = window.setTimeout(function () {
+          _this2.settleRequest(requestId, new Error('KMBridge 请求超时'));
+        }, (options === null || options === void 0 ? void 0 : options.timeout) || DEFAULT_TIMEOUT);
+        _this2.pendingRequests.set(requestId, {
+          resolve: function resolve(data) {
+            return _resolve(data);
+          },
+          reject: reject,
+          timer: timer
+        });
+        try {
+          transport(request);
+        } catch (error) {
+          _this2.settleRequest(requestId, error instanceof Error ? error : new Error('KMBridge 调用失败'));
+        }
+      });
+    }
+
+    /**
+     * 订阅指定 Native 事件。
+     *
+     * @returns 取消本次订阅的函数。
+     */
+  }, {
+    key: "on",
+    value: function on(eventName, listener) {
+      var _this$eventListeners$,
+        _this3 = this;
+      var listeners = (_this$eventListeners$ = this.eventListeners.get(eventName)) !== null && _this$eventListeners$ !== void 0 ? _this$eventListeners$ : new Set();
+      var eventListener = listener;
+      listeners.add(eventListener);
+      this.eventListeners.set(eventName, listeners);
+      return function () {
+        return _this3.off(eventName, eventListener);
+      };
+    }
+
+    /**
+     * 订阅一次指定 Native 事件，首次触发后自动取消。
+     *
+     * @returns 提前取消本次订阅的函数。
+     */
+  }, {
+    key: "once",
+    value: function once(eventName, listener) {
+      var remove = this.on(eventName, function (data) {
+        remove();
+        listener(data);
+      });
+      return remove;
+    }
+
+    /** 移除指定事件的一个监听函数。 */
+  }, {
+    key: "off",
+    value: function off(eventName, listener) {
+      var listeners = this.eventListeners.get(eventName);
+      if (!listeners) {
+        return;
+      }
+      listeners.delete(listener);
+      if (listeners.size === 0) {
+        this.eventListeners.delete(eventName);
+      }
+    }
+
+    /** 拒绝未完成请求并清空所有事件订阅。 */
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.pendingRequests.forEach(function (pendingRequest) {
+        clearTimeout(pendingRequest.timer);
+        pendingRequest.reject(new Error('KMBridge 已销毁'));
+      });
+      this.pendingRequests.clear();
+      this.eventListeners.clear();
+    }
+
+    /** 生成当前实例内唯一的请求 ID。 */
+  }, {
+    key: "createRequestId",
+    value: function createRequestId() {
+      this.requestSequence += 1;
+      return "BridgeHandle".concat(Date.now()).concat(this.requestSequence);
+    }
+
+    /** 根据 requestId 清理事务，并将结果交给对应的 Promise。 */
+  }, {
+    key: "settleRequest",
+    value: function settleRequest(requestId, error, data) {
+      var pendingRequest = this.pendingRequests.get(requestId);
+      if (!pendingRequest) {
+        return;
+      }
+      clearTimeout(pendingRequest.timer);
+      this.pendingRequests.delete(requestId);
+      if (error) {
+        pendingRequest.reject(error);
+        return;
+      }
+      pendingRequest.resolve(data);
+    }
+
+    /** 解析 Native 返回的 JSON 响应，并匹配对应的一次性事务。 */
+  }, {
+    key: "handleNativeResponse",
+    value: function handleNativeResponse(rawResponse) {
+      try {
+        var response = JSON.parse(rawResponse);
+        if (!isObject(response)) {
+          return;
+        }
+        var requestId = get(response, 'requestId');
+        var code = get(response, 'code');
+        var message = get(response, 'message');
+        if (!isString(requestId) || !isNumber(code) || !isString(message)) {
+          return;
+        }
+        var nativeCode = Number(code);
+        if (nativeCode === 0) {
+          this.settleRequest(requestId, undefined, get(response, 'data'));
+          return;
+        }
+        this.settleRequest(requestId, new BridgeError(nativeCode, message));
+      } catch (_unused) {
+        // Native 返回非法 JSON 时忽略，不影响仍在等待的其他事务。
+      }
+    }
+
+    /** 解析并分发指定名称的 Native 订阅事件。 */
+  }, {
+    key: "handleNativeEvent",
+    value: function handleNativeEvent(eventName, data) {
+      var listeners = this.eventListeners.get(eventName);
+      if (!listeners) {
+        return;
+      }
+      var eventData = this.parseEventData(data);
+      listeners.forEach(function (listener) {
+        return listener(eventData);
+      });
+    }
+
+    /** 尝试将 Native 传入的 JSON 字符串还原为事件数据。 */
+  }, {
+    key: "parseEventData",
+    value: function parseEventData(data) {
+      if (!isString(data)) {
+        return data;
+      }
+      try {
+        return JSON.parse(data);
+      } catch (_unused2) {
+        return data;
+      }
+    }
+
+    /** 仅在当前 JSBridge 实例开启调试时输出 Native 原始数据。 */
+  }, {
+    key: "debugLog",
+    value: function debugLog() {
+      if (this.config.debug) {
+        var _console;
+        (_console = console).log.apply(_console, arguments);
+      }
+    }
+  }]);
+  return BridgeCB;
+}();

package/dist/core/index.d.ts

@@ -0,0 +1,43 @@
+import type { BridgeApiConfig } from '../registers';
+import { BridgeCB } from './bridgeCB';
+import type { JSBridgeConfig } from '../types/bridge';
+/** 只负责三端 Native transport，并复用 BridgeCB 的回调能力。 */
+export declare class JSBNative {
+    /** 当前实例的运行时配置。 */
+    readonly config: JSBridgeConfig;
+    /** 可复用的请求响应与事件回调管理器。 */
+    readonly cb: BridgeCB;
+    /** 挂载供 Native 调用的全局响应与事件回调。 */
+    constructor();
+    /** 设置是否打印当前实例与 Native 通信的原始数据。 */
+    setDebug(debug: boolean): void;
+    /**
+     * 将业务方法及参数交给当前 WebView 容器的 Native 通道。
+     *
+     * @param options 本次 Native 调用的执行配置。
+     * @returns Native 成功响应中的 data。
+     */
+    callNative<TData = unknown, TParams extends Record<string, unknown> = Record<string, unknown>>(method: string, params: TParams, options: Omit<BridgeApiConfig, 'nativeMethod' | 'initialParams'>): Promise<TData>;
+    /** 清理未完成请求、事件订阅以及本实例挂载的全局回调。 */
+    destroy(): void;
+    /**
+     * 检查 Native 通道是否已注入到当前页面。
+     *
+     * @returns `true` 表示 Android/鸿蒙或 iOS 的 Native 通道已挂载。
+     */
+    webReady(): boolean;
+    /** 将 BridgeCB 的处理函数注册为 Native 回调入口。 */
+    private installNativeCallbacks;
+    /**
+     * 按业务方法获取 iOS 消息通道，未注入时回退到 Android/鸿蒙通道。
+     *
+     * iOS 使用 `webkit.messageHandlers[method]`，报文中不重复携带 method；
+     * Android/鸿蒙继续使用 `KMBridge.handle`，报文中携带完整请求。
+     *
+     * @param method 本次调用对应的 Native 方法名。
+     * @returns 可调用的 Native 消息发送函数；容器未注入时返回 undefined。
+     */
+    private getNativeTransport;
+    /** 仅在当前实例开启调试时输出发送给 Native 的原始报文。 */
+    private debugLog;
+}

package/dist/core/index.js

@@ -0,0 +1,145 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { isFunction, isUndefined } from '@wapri/gbase';
+import { BridgeCB } from "./bridgeCB";
+import { getBridgeWindow } from "../utils";
+
+/** 只负责三端 Native transport，并复用 BridgeCB 的回调能力。 */
+export var JSBNative = /*#__PURE__*/function () {
+  /** 挂载供 Native 调用的全局响应与事件回调。 */
+  function JSBNative() {
+    _classCallCheck(this, JSBNative);
+    /** 当前实例的运行时配置。 */
+    _defineProperty(this, "config", {
+      debug: false
+    });
+    /** 可复用的请求响应与事件回调管理器。 */
+    _defineProperty(this, "cb", new BridgeCB(this.config));
+    this.installNativeCallbacks();
+  }
+
+  /** 设置是否打印当前实例与 Native 通信的原始数据。 */
+  _createClass(JSBNative, [{
+    key: "setDebug",
+    value: function setDebug(debug) {
+      this.config.debug = debug;
+    }
+
+    /**
+     * 将业务方法及参数交给当前 WebView 容器的 Native 通道。
+     *
+     * @param options 本次 Native 调用的执行配置。
+     * @returns Native 成功响应中的 data。
+     */
+  }, {
+    key: "callNative",
+    value: function callNative(method, params, options) {
+      var transport = this.getNativeTransport(method);
+      if (isUndefined(transport)) {
+        console.log('KMBridge 当前未就绪');
+        console.dir({
+          method: method,
+          params: params
+        });
+        return Promise.reject(new Error('KMBridge 当前未就绪'));
+      }
+      return this.cb.call(method, params, transport, options);
+    }
+
+    /** 清理未完成请求、事件订阅以及本实例挂载的全局回调。 */
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.cb.destroy();
+      var bridgeWindow = getBridgeWindow();
+      if ((bridgeWindow === null || bridgeWindow === void 0 ? void 0 : bridgeWindow.onNativeMessage) === this.cb.onNativeMessage) {
+        delete bridgeWindow.onNativeMessage;
+      }
+      if ((bridgeWindow === null || bridgeWindow === void 0 ? void 0 : bridgeWindow.onNativeEvent) === this.cb.onNativeEvent) {
+        delete bridgeWindow.onNativeEvent;
+      }
+    }
+
+    /**
+     * 检查 Native 通道是否已注入到当前页面。
+     *
+     * @returns `true` 表示 Android/鸿蒙或 iOS 的 Native 通道已挂载。
+     */
+  }, {
+    key: "webReady",
+    value: function webReady() {
+      var _bridgeWindow$webkit;
+      var bridgeWindow = getBridgeWindow();
+      return !isUndefined(bridgeWindow === null || bridgeWindow === void 0 ? void 0 : bridgeWindow.KMBridge) || !isUndefined(bridgeWindow === null || bridgeWindow === void 0 || (_bridgeWindow$webkit = bridgeWindow.webkit) === null || _bridgeWindow$webkit === void 0 ? void 0 : _bridgeWindow$webkit.messageHandlers);
+    }
+
+    /** 将 BridgeCB 的处理函数注册为 Native 回调入口。 */
+  }, {
+    key: "installNativeCallbacks",
+    value: function installNativeCallbacks() {
+      var bridgeWindow = getBridgeWindow();
+      if (isUndefined(bridgeWindow)) {
+        return;
+      }
+      bridgeWindow.onNativeMessage = this.cb.onNativeMessage;
+      bridgeWindow.onNativeEvent = this.cb.onNativeEvent;
+    }
+
+    /**
+     * 按业务方法获取 iOS 消息通道，未注入时回退到 Android/鸿蒙通道。
+     *
+     * iOS 使用 `webkit.messageHandlers[method]`，报文中不重复携带 method；
+     * Android/鸿蒙继续使用 `KMBridge.handle`，报文中携带完整请求。
+     *
+     * @param method 本次调用对应的 Native 方法名。
+     * @returns 可调用的 Native 消息发送函数；容器未注入时返回 undefined。
+     */
+  }, {
+    key: "getNativeTransport",
+    value: function getNativeTransport(method) {
+      var _bridgeWindow$webkit2,
+        _this = this;
+      var bridgeWindow = getBridgeWindow();
+      var iOSHandler = bridgeWindow === null || bridgeWindow === void 0 || (_bridgeWindow$webkit2 = bridgeWindow.webkit) === null || _bridgeWindow$webkit2 === void 0 || (_bridgeWindow$webkit2 = _bridgeWindow$webkit2.messageHandlers) === null || _bridgeWindow$webkit2 === void 0 ? void 0 : _bridgeWindow$webkit2[method];
+      if (isFunction(iOSHandler === null || iOSHandler === void 0 ? void 0 : iOSHandler.postMessage)) {
+        var postMessage = iOSHandler.postMessage.bind(iOSHandler);
+        return function (_ref) {
+          var params = _ref.params,
+            requestId = _ref.requestId;
+          var message = JSON.stringify({
+            params: params,
+            requestId: requestId
+          });
+          _this.debugLog('[jsbridge] JS -> Native', message);
+          postMessage(message);
+        };
+      }
+      var nativeBridge = bridgeWindow === null || bridgeWindow === void 0 ? void 0 : bridgeWindow.KMBridge;
+      if (isFunction(nativeBridge === null || nativeBridge === void 0 ? void 0 : nativeBridge.handle)) {
+        var handle = nativeBridge.handle.bind(nativeBridge);
+        return function (request) {
+          var message = JSON.stringify(request);
+          _this.debugLog('[jsbridge] JS -> Native', message);
+          handle(message);
+        };
+      }
+      return undefined;
+    }
+
+    /** 仅在当前实例开启调试时输出发送给 Native 的原始报文。 */
+  }, {
+    key: "debugLog",
+    value: function debugLog() {
+      if (this.config.debug) {
+        var _console;
+        (_console = console).log.apply(_console, arguments);
+      }
+    }
+  }]);
+  return JSBNative;
+}();

package/dist/errors/bridgeError.d.ts

@@ -0,0 +1,6 @@
+/** Native 业务方法返回失败时抛出的错误，保留原始错误码与错误信息。 */
+export declare class BridgeError extends Error {
+    /** Native 响应中的 code。 */
+    readonly code: number;
+    constructor(code: number, message: string);
+}

package/dist/errors/bridgeError.js

@@ -0,0 +1,33 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
+function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct.bind(); } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _isNativeFunction(fn) { try { return Function.toString.call(fn).indexOf("[native code]") !== -1; } catch (e) { return typeof fn === "function"; } }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/** Native 业务方法返回失败时抛出的错误，保留原始错误码与错误信息。 */
+export var BridgeError = /*#__PURE__*/function (_Error) {
+  _inherits(BridgeError, _Error);
+  var _super = _createSuper(BridgeError);
+  function BridgeError(code, message) {
+    var _this;
+    _classCallCheck(this, BridgeError);
+    _this = _super.call(this, message);
+    /** Native 响应中的 code。 */
+    _defineProperty(_assertThisInitialized(_this), "code", void 0);
+    _this.name = 'BridgeError';
+    _this.code = code;
+    return _this;
+  }
+  return _createClass(BridgeError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));

package/dist/errors/index.d.ts

@@ -0,0 +1 @@
+export { BridgeError } from './bridgeError';

package/dist/errors/index.js

@@ -0,0 +1 @@
+export { BridgeError } from "./bridgeError";

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { JSBridge } from './types/bridge';
+export { BridgeError } from './errors';
+export type { JSBridgeConfig } from './types/bridge';
+/** 业务侧唯一入口：使用 jsbridge.<具体 Native 方法名>(params)。 */
+export declare const jsbridge: JSBridge;
+export default jsbridge;

package/dist/index.js

@@ -0,0 +1,77 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["nativeMethod", "initialParams"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import { isFunction, isObject, isString, isUndefined } from '@wapri/gbase';
+import { JSBNative } from "./core";
+import { getBridgeWindow } from "./utils";
+import { apiRegistry } from "./registers";
+export { BridgeError } from "./errors";
+var EVENT_METHODS = new Set(['on', 'once', 'off']);
+var INTERNAL_METHODS = new Set(['handle', 'ready', 'request', 'callNative', 'onNativeMessage', 'onNativeEvent', 'installNativeCallbacks', 'cb']);
+
+/**
+ * 创建并缓存业务侧唯一的 Bridge 代理。
+ *
+ * 代理会将未注册的属性访问转换为 Native 方法调用，同时屏蔽底层通道与回调实现。
+ */
+var createJSB = function createJSB() {
+  var bridgeWindow = getBridgeWindow();
+  if (!isUndefined(bridgeWindow === null || bridgeWindow === void 0 ? void 0 : bridgeWindow.__kaimaiJSBridge)) {
+    return bridgeWindow.__kaimaiJSBridge;
+  }
+  var nativeBridge = new JSBNative();
+  var bridge = new Proxy(nativeBridge, {
+    /** 根据属性名分发事件订阅、销毁方法或 Native 业务方法。 */get: function get(target, property) {
+      if (!isString(property)) {
+        return undefined;
+      }
+      if (EVENT_METHODS.has(property)) {
+        var eventMethod = Reflect.get(target.cb, property);
+        return isFunction(eventMethod) ? eventMethod.bind(target.cb) : undefined;
+      }
+      if (property === 'config') {
+        return target.config;
+      }
+      if (property === 'setDebug') {
+        return target.setDebug.bind(target);
+      }
+      if (property === 'destroy') {
+        return target.destroy.bind(target);
+      }
+      if (property === 'webReady') {
+        return target.webReady.bind(target);
+      }
+      if (property === 'then' || INTERNAL_METHODS.has(property)) {
+        return undefined;
+      }
+      return function () {
+        var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+        if (!isObject(params)) {
+          return Promise.reject(new Error('jsbridge 参数必须是对象'));
+        }
+        var config = apiRegistry === null || apiRegistry === void 0 ? void 0 : apiRegistry[property];
+        var _ref = config || {},
+          nativeMethod = _ref.nativeMethod,
+          _ref$initialParams = _ref.initialParams,
+          initialParams = _ref$initialParams === void 0 ? {} : _ref$initialParams,
+          other = _objectWithoutProperties(_ref, _excluded);
+        var methodName = nativeMethod || property;
+        return target.callNative(methodName, _objectSpread(_objectSpread({}, initialParams), params), other);
+      };
+    }
+  });
+  if (!isUndefined(bridgeWindow)) {
+    bridgeWindow.__kaimaiJSBridge = bridge;
+  }
+  return bridge;
+};
+
+/** 业务侧唯一入口：使用 jsbridge.<具体 Native 方法名>(params)。 */
+export var jsbridge = createJSB();
+export default jsbridge;

package/dist/registers/canIUse/demo/index.vue

@@ -0,0 +1,36 @@
+<script lang="tsx">
+import { defineComponent, ref } from 'vue'
+import { jsbridge } from '@wapri/gjsbridge'
+
+export default defineComponent({
+  setup(props) {
+    const result = ref('')
+    const errors = ref('')
+    const handleClick = () => {
+      jsbridge
+        .canIUse({ api: 'debug.demp' })
+        .then((res) => {
+          result.value = JSON.stringify(res)
+        })
+        .catch((error) => {
+          errors.value = error.message
+        })
+    }
+    return () => {
+      return (
+        <div>
+          <div>
+            <strong>result:</strong>
+            {result.value}
+          </div>
+          <div>
+            <strong>error:</strong>
+            {errors.value}
+          </div>
+          <button onClick={handleClick}>点击</button>
+        </div>
+      )
+    }
+  },
+})
+</script>

package/dist/registers/index.d.ts

@@ -0,0 +1,12 @@
+import type { BridgeRegister } from '../types/register';
+/** 单个业务 Bridge 方法的 Native 调用配置。 */
+export type BridgeApiConfig = {
+    /** Native 方法未响应时的超时，单位毫秒。 */
+    nativeMethod?: string;
+    timeout?: number;
+    initialParams?: Record<string, unknown>;
+};
+/**
+ * 对业务暴露api转换为调用原生的api
+ * */
+export declare const apiRegistry: Partial<Record<keyof BridgeRegister, BridgeApiConfig>>;

package/dist/registers/index.js

@@ -0,0 +1,22 @@
+/** 单个业务 Bridge 方法的 Native 调用配置。 */
+
+/**
+ * 对业务暴露api转换为调用原生的api
+ * */
+export var apiRegistry = {
+  canIUse: {
+    nativeMethod: 'permission.caniuse',
+    initialParams: {
+      userType: 'kaimai'
+    }
+  },
+  getSafeArea: {
+    nativeMethod: 'getSafeArea'
+  },
+  close: {
+    nativeMethod: 'closeWebview'
+  },
+  makePhoneCall: {
+    nativeMethod: 'makePhoneCall'
+  }
+};

package/dist/types/apis.d.ts

@@ -0,0 +1 @@
+export type ApiKeys = 'debug.demp';

package/dist/types/apis.js

@@ -0,0 +1 @@
+export {};

package/dist/types/bridge.d.ts

@@ -0,0 +1,41 @@
+import { BridgeRegister } from './register';
+export interface JSBridgeConfig {
+    /** 是否在控制台打印 JS 与 Native 通信的原始数据。 */
+    debug: boolean;
+}
+export interface NativeRequest<TParams = Record<string, unknown>> {
+    method: string;
+    params: TParams;
+    requestId: string;
+}
+export type NativeTransport = (request: NativeRequest) => void;
+export interface NativeBridge {
+    handle?: (message: string) => void;
+}
+export interface IOSBridgeHandler {
+    postMessage?: (message: string) => void;
+}
+export type NativeEventListener<TData = unknown> = (data: TData) => void;
+export interface PendingRequest {
+    reject: (reason: Error) => void;
+    resolve: (data: unknown) => void;
+    timer: number;
+}
+export interface JSBridge extends BridgeRegister {
+    config: JSBridgeConfig;
+    setDebug(debug: boolean): void;
+    on<TData = unknown>(eventName: string, listener: NativeEventListener<TData>): () => void;
+    once<TData = unknown>(eventName: string, listener: NativeEventListener<TData>): () => void;
+    off<TData = unknown>(eventName: string, listener: NativeEventListener<TData>): void;
+    webReady(): boolean;
+    destroy(): void;
+}
+export interface BridgeWindow extends Window {
+    KMBridge?: NativeBridge;
+    webkit?: {
+        messageHandlers?: Record<string, IOSBridgeHandler | undefined>;
+    };
+    onNativeMessage?: (message: string) => void;
+    onNativeEvent?: (eventName: string, data: unknown) => void;
+    __kaimaiJSBridge?: JSBridge;
+}

package/dist/types/bridge.js

@@ -0,0 +1 @@
+export {};

package/dist/types/register.d.ts

@@ -0,0 +1,24 @@
+import { ApiKeys } from './apis';
+interface BridgeMethod<P, R> {
+    params: P;
+    reponse: R;
+    entity: P extends undefined ? () => Promise<R> : (args: P) => Promise<R>;
+}
+type BridgeMethodCanIUse = BridgeMethod<{
+    /** api名称 */
+    api: ApiKeys;
+}, {
+    /** 0 失败 1 成功 */
+    result: '0' | '1';
+}>;
+type SafeAreaInfo = Record<'safeAreaTop' | 'safeAreaBottom' | 'safeAreaLeft' | 'safeAreaRight', number>;
+type BridgeMethodGetSafeArea = BridgeMethod<undefined, SafeAreaInfo>;
+export interface BridgeRegister {
+    canIUse: BridgeMethodCanIUse['entity'];
+    getSafeArea: BridgeMethodGetSafeArea['entity'];
+    close: BridgeMethod<undefined, undefined>['entity'];
+    makePhoneCall: BridgeMethod<{
+        phoneNumber: string;
+    }, undefined>['entity'];
+}
+export {};

package/dist/types/register.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+import type { BridgeWindow } from '../types/bridge';
+/** 获取当前浏览器环境的 window；非浏览器环境返回 undefined。 */
+export declare function getBridgeWindow(): BridgeWindow | undefined;

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+import { isUndefined } from '@wapri/gbase';
+/** 获取当前浏览器环境的 window；非浏览器环境返回 undefined。 */
+export function getBridgeWindow() {
+  var bridgeWindow = globalThis.window;
+  return isUndefined(bridgeWindow) ? undefined : bridgeWindow;
+}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@wapri/gjsbridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "3.0.0",
+  "description": "麦仓 App WebView JSBridge",
+  "keywords": [
+    "jsbridge",
+    "ios",
+    "android",
+    "harmonyos"
+  ],
+  "license": "UNLICENSED",
+  "author": "wa",
+  "sideEffects": true,
+  "type": "module",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@wapri/gbase": "^1.0.0"
+  },
+  "devDependencies": {
+    "@wapri/gbase": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependenciesMeta": {},
+  "peerDependencies": {
+    "@wapri/gbase": "*"
+  },
+  "scripts": {
+    "build": "father build",
+    "dev": "father dev"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.