@docoi/mys-sdk 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 docoi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/api/basic.d.ts

@@ -1,4 +1,4 @@
-import { ShowToastParams, PlayMediaParams, ChooseMediaParams, ChooseMediaResult, UploadFileParams, UploadFileResult, SaveImageToPhotosAlbumParams, SaveVideoToPhotosAlbumParams, StartRecordParams, SetClipboardDataParams, GetClipboardDataResult, OpenInExternalBrowserParams, NavigateToAppParams, SwitchTabParams, OpenWebviewParams, TriggerVibrateParams, Callbacks, NativeResponse, SystemInfoResult, NetworkTypeResult, OpenPhoneSettingParams, CheckPermissionParams, CheckPermissionResult } from '../types';
+import { ShowToastParams, PlayMediaParams, ChooseMediaParams, ChooseMediaResult, UploadFilesParams, UploadFilesResult, SaveImageToPhotosAlbumParams, SaveVideoToPhotosAlbumParams, StartRecordParams, SetClipboardDataParams, GetClipboardDataResult, OpenInExternalBrowserParams, TriggerVibrateParams, Callbacks, NativeResponse, SystemInfoResult, NetworkTypeResult, OpenPhoneSettingParams, CheckPermissionParams, CheckPermissionResult, KeyboardHeightChangeCallback, CommentPanelChangeCallback, EventListenOptions } from '../types';
 /**
  * 显示消息提示框。
  *
@@ -20,7 +20,7 @@ export declare function showToast(params: ShowToastParams): Promise<NativeRespon
  * iOS 如果不支持自定义力度和精确时长，intensity 和 duration 会被忽略，退化为系统默认触感节奏。
  * repeat 为 true 时会无限循环，需调用 stopVibrate 停止。
  *
- * @app 1.2.3
+ * @app 4.1.0
  * @example
  * await mys.triggerVibrate({ duration: 30, intensity: 0.5 })
  *
@@ -38,7 +38,7 @@ export declare function triggerVibrate(params?: TriggerVibrateParams): Promise<N
  *
  * 用于停止 triggerVibrate 发起的循环震动。
  *
- * @app 1.2.3
+ * @app 4.1.0
  * @example
  * await mys.stopVibrate()
  */
@@ -61,22 +61,64 @@ export declare function hideKeyboard(params?: Callbacks): Promise<NativeResponse
  *
  * @note
  * 回调参数 height 单位为 CSS 逻辑像素，可直接用于页面布局。
+ * 事件监听类型直接返回原始 payload，不包装 code/msg/result。
+ * options.once 为 true 时只触发一次，触发后由 jsbridge 自动取消监听。
  *
- * @app 1.2.3
+ * @app 3.9.0
  * @example
  * mys.onKeyboardHeightChange((height) => {
  *   console.log('键盘高度:', height)
  * })
+ *
+ * mys.onKeyboardHeightChange((height) => {
+ *   console.log('只监听一次键盘高度:', height)
+ * }, { once: true })
+ *
+ * mys.offKeyboardHeightChange()
  */
-export declare function onKeyboardHeightChange(callback: (height: number) => void): void;
+export declare function onKeyboardHeightChange(callback: KeyboardHeightChangeCallback, options?: EventListenOptions): void;
 /**
  * 取消监听键盘高度变化。
  *
+ * 不传 callback 时取消全部键盘高度监听；传入 callback 时只取消指定监听。
+ *
  * @app 1.2.3
  * @example
  * mys.offKeyboardHeightChange()
  */
-export declare function offKeyboardHeightChange(): void;
+export declare function offKeyboardHeightChange(callback?: KeyboardHeightChangeCallback): void;
+/**
+ * 监听评论区面板状态变化。
+ *
+ * 当 Native 评论区面板打开、关闭或状态变化时触发。
+ *
+ * @note
+ * 事件监听类型直接返回原始 payload，不包装 code/msg/result。
+ * options.once 为 true 时只触发一次，触发后由 jsbridge 自动取消监听。
+ *
+ * @app 4.2.0
+ * @example
+ * mys.onCommentPanelChange((res) => {
+ *   console.log('评论区面板状态:', res.visible, res.reason)
+ * })
+ *
+ * mys.onCommentPanelChange((res) => {
+ *   console.log('只监听一次:', res.visible, res.reason)
+ * }, { once: true })
+ *
+ * mys.offCommentPanelChange()
+ */
+export declare function onCommentPanelChange(callback: CommentPanelChangeCallback, options?: EventListenOptions): void;
+/**
+ * 取消监听评论区面板状态变化。
+ *
+ * 不传 callback 时取消全部评论区面板监听；传入 callback 时只取消指定监听。
+ *
+ * @app 4.2.0
+ * @example
+ * mys.offCommentPanelChange()
+ */
+export declare function offCommentPanelChange(callback?: CommentPanelChangeCallback): void;
 /**
  * 预览图片。
  *
@@ -84,10 +126,10 @@ export declare function offKeyboardHeightChange(): void;
  * urls 不能为空。
  * current 为当前预览图片在 urls 中的数组下标，默认 0。
  *
- * @app 1.2.3
+ * @app 4.3.0
  * @example
  * await mys.previewImage({
- *   urls: ['https://example.com/1.jpg', 'https://example.com/2.jpg'],
+ *   urls: ['https://example.com/1.jpg', 'mysFile://temp/files/xxx.jpg'],
  *   current: 0,
  * })
  */
@@ -111,15 +153,14 @@ export declare function previewVideo(params: PlayMediaParams): Promise<NativeRes
  *
  * @note
  * 成功返回的 files[].tempFilePath 为临时文件路径，例如 mysFile://temp/xxxx.png。
- * tempFilePath 可用于 img / video 预览，也可传给 uploadFile 上传。
+ * tempFilePath 可用于 img / video 预览，也可传给 uploadFiles 上传。
  * 临时文件不应作为长期业务资源保存。
  *
- * @app 1.2.3
+ * @app 4.3.0
  * @example
  * const res = await mys.chooseMedia({
  *   count: 1,
  *   mediaType: 'image',
- *   sourceType: 'all',
  * })
  * console.log(res.result.files[0].tempFilePath)
  */
@@ -127,19 +168,20 @@ export declare function chooseMedia(params?: ChooseMediaParams): Promise<NativeR
 /**
  * 上传本地临时文件。
  *
- * 上传 chooseMedia 返回的临时文件路径，成功后返回网络 URL。
+ * 批量串行上传 chooseMedia 返回的临时文件路径，成功后返回网络 URL。
  *
  * @note
- * filePath 应为 chooseMedia 返回的临时文件路径，例如 mysFile://temp/xxxx.png。
+ * filePath 应为 chooseMedia 返回的临时文件路径，例如 mysFiles://temp/xxxx.png。
+ * cosDirPath 默认 multipleSource/common/。
  *
- * @app 1.2.3
+ * @app 4.3.0
  * @example
- * const uploadRes = await mys.uploadFile({
- *   filePath: chooseRes.result.files[0].tempFilePath,
+ * const uploadRes = await mys.uploadFiles({
+ *   files: [chooseRes.result.files[0].tempFilePath],
  * })
- * console.log(uploadRes.result.url)
+ * console.log(uploadRes.result.files[0].url)
  */
-export declare function uploadFile(params: UploadFileParams): Promise<NativeResponse<UploadFileResult>>;
+export declare function uploadFiles(params: UploadFilesParams): Promise<NativeResponse<UploadFilesResult>>;
 /**
  * 保存图片到系统相册。
  *
@@ -241,37 +283,6 @@ export declare function checkPermission(params: CheckPermissionParams): Promise<
  * await mys.openPhoneSetting({ type: 'notice' })
  */
 export declare function openPhoneSetting(params: OpenPhoneSettingParams): Promise<NativeResponse<void>>;
-/**
- * 跳转到应用内的某个页面（非 Tab 页面）。
- *
- * @app 1.2.3
- * @example
- * await mys.navigateToApp({ url: '/pages/detail/index' })
- */
-export declare function navigateToApp(params: NavigateToAppParams): Promise<NativeResponse<void>>;
-/**
- * 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面。
- *
- * @app 1.2.3
- * @example
- * await mys.switchTab({ url: '/pages/index/index' })
- */
-export declare function switchTab(params: SwitchTabParams): Promise<NativeResponse<void>>;
-/**
- * 打开 Webview 容器。
- *
- * 支持 immersive、normal、mini 三种容器类型。
- *
- * @note
- * 当 replace 为 true 时直接替换当前页面。
- *
- * @app 1.2.3
- * @example
- * await mys.openWebview({ url: 'https://example.com', type: 'immersive' })
- *
- * await mys.openWebview({ url: 'https://example.com', replace: true })
- */
-export declare function openWebview(params: OpenWebviewParams): Promise<NativeResponse<void>>;
 /**
  * 关闭当前网页视图。
  *

package/dist/bridge.d.ts

@@ -1,9 +1,9 @@
-import { default as JSBridgeSdk, CallOptions, JSBridgeInterface } from '@docoi/jsbridge-sdk';
+import { default as JSBridgeSdk, CallOptions, DebugOptions, JSBridgeInterface } from '@docoi/jsbridge-sdk';
 import { Callbacks, NativeResponse } from './types';
 export { JSBridgeSdk };
 export type NativeHandler<TData = unknown, TResult = unknown> = (data: TData) => TResult | Promise<TResult>;
 declare const bridge: JSBridgeInterface;
-export declare const setDebug: (enabled: boolean) => JSBridgeInterface;
+export declare const setDebug: (enabled: boolean, options?: Partial<DebugOptions>) => JSBridgeInterface;
 export default bridge;
 export declare function registerNativeHandler<TData = unknown, TResult = unknown>(name: string, handler: NativeHandler<TData, TResult>): JSBridgeInterface;
 export declare function rejectParamError<T = void>(fnName: string, msg: string, options?: Callbacks<T>): Promise<never>;

package/dist/index.d.ts

@@ -1,11 +1,9 @@
-import { registerNativeHandler, setDebug, JSBridgeSdk, default as defaultBridge } from './bridge';
-import { JSBridgeInterface } from '@docoi/jsbridge-sdk';
-import { Callbacks, LoginResult, NativeResponse, GetTokenResult, GetCircleInfoResult, ShareWebCardParams, BindGameRoleParams, ShowAdParams, ShowToastParams, TriggerVibrateParams, PlayMediaParams, ChooseMediaParams, ChooseMediaResult, UploadFileParams, UploadFileResult, SaveImageToPhotosAlbumParams, SaveVideoToPhotosAlbumParams, StartRecordParams, SystemInfoResult, NetworkTypeResult, SetClipboardDataParams, GetClipboardDataResult, CheckPermissionParams, CheckPermissionResult, OpenPhoneSettingParams, NavigateToAppParams, SwitchTabParams, OpenWebviewParams, OpenInExternalBrowserParams } from './types';
+import { default as bridge, registerNativeHandler, setDebug, JSBridgeSdk } from './bridge';
+import { DebugOptions, JSBridgeInterface } from '@docoi/jsbridge-sdk';
+import { Callbacks, LoginResult, NativeResponse, GetTokenResult, GetCircleInfoResult, ShareWebCardParams, BindGameRoleParams, ShowAdParams, ShowToastParams, TriggerVibrateParams, KeyboardHeightChangeCallback, EventListenOptions, CommentPanelChangeCallback, PlayMediaParams, ChooseMediaParams, ChooseMediaResult, UploadFilesParams, UploadFilesResult, SaveImageToPhotosAlbumParams, SaveVideoToPhotosAlbumParams, StartRecordParams, SystemInfoResult, NetworkTypeResult, SetClipboardDataParams, GetClipboardDataResult, CheckPermissionParams, CheckPermissionResult, OpenPhoneSettingParams, OpenInExternalBrowserParams } from './types';
 declare const mys: {
-    setDebug: (enabled: boolean) => JSBridgeInterface;
+    setDebug: (enabled: boolean, options?: Partial< DebugOptions>) => JSBridgeInterface;
     registerNativeHandler: typeof registerNativeHandler;
-    bridge: JSBridgeInterface;
-    JSBridgeSdk: JSBridgeInterface;
     login(params?: Callbacks<LoginResult>): Promise< NativeResponse<LoginResult>>;
     getToken(params?: Callbacks<GetTokenResult>): Promise< NativeResponse<GetTokenResult>>;
     getCurrentCircleInfo(params?: Callbacks<GetCircleInfoResult>): Promise< NativeResponse<GetCircleInfoResult>>;
@@ -17,12 +15,14 @@ declare const mys: {
     triggerVibrate(params?: TriggerVibrateParams): Promise< NativeResponse<void>>;
     stopVibrate(params?: Callbacks): Promise< NativeResponse<void>>;
     hideKeyboard(params?: Callbacks): Promise< NativeResponse<void>>;
-    onKeyboardHeightChange(callback: (height: number) => void): void;
-    offKeyboardHeightChange(): void;
+    onKeyboardHeightChange(callback: KeyboardHeightChangeCallback, options?: EventListenOptions): void;
+    offKeyboardHeightChange(callback?: KeyboardHeightChangeCallback): void;
+    onCommentPanelChange(callback: CommentPanelChangeCallback, options?: EventListenOptions): void;
+    offCommentPanelChange(callback?: CommentPanelChangeCallback): void;
     previewImage(params: PlayMediaParams): Promise< NativeResponse<void>>;
     previewVideo(params: PlayMediaParams): Promise< NativeResponse<void>>;
     chooseMedia(params?: ChooseMediaParams): Promise< NativeResponse<ChooseMediaResult>>;
-    uploadFile(params: UploadFileParams): Promise< NativeResponse<UploadFileResult>>;
+    uploadFiles(params: UploadFilesParams): Promise< NativeResponse<UploadFilesResult>>;
     saveImageToPhotosAlbum(params: SaveImageToPhotosAlbumParams): Promise< NativeResponse<void>>;
     saveVideoToPhotosAlbum(params: SaveVideoToPhotosAlbumParams): Promise< NativeResponse<void>>;
     startRecord(params?: StartRecordParams): Promise< NativeResponse<void>>;
@@ -33,16 +33,13 @@ declare const mys: {
     getClipboardData(params?: Callbacks<GetClipboardDataResult>): Promise< NativeResponse<GetClipboardDataResult>>;
     checkPermission(params: CheckPermissionParams): Promise< NativeResponse<CheckPermissionResult>>;
     openPhoneSetting(params: OpenPhoneSettingParams): Promise< NativeResponse<void>>;
-    navigateToApp(params: NavigateToAppParams): Promise< NativeResponse<void>>;
-    switchTab(params: SwitchTabParams): Promise< NativeResponse<void>>;
-    openWebview(params: OpenWebviewParams): Promise< NativeResponse<void>>;
     closeWebView(params?: Callbacks): Promise< NativeResponse<void>>;
     openInExternalBrowser(params: OpenInExternalBrowserParams): Promise< NativeResponse<void>>;
 };
 export default mys;
 export * from './api/basic';
 export * from './api/biz';
-export { setDebug, registerNativeHandler, defaultBridge as bridge };
+export { setDebug, registerNativeHandler, bridge };
 export { JSBridgeSdk };
 export { ToastDuration } from './types';
 export * from './constants/code';

package/dist/index.mjs

@@ -1,55 +1,64 @@
-import v from "@docoi/jsbridge-sdk";
-import { default as Se } from "@docoi/jsbridge-sdk";
-const q = 0, b = -1, he = 1001, E = 1002, be = 2002, ye = 3002, ve = 4002, qe = 9002;
-function R(e) {
+import A from "@docoi/jsbridge-sdk";
+import { default as Ee } from "@docoi/jsbridge-sdk";
+const S = 0, v = -1, Ce = 1001, I = 1002, Pe = 2002, be = 3002, qe = 4002, Se = 9002;
+function N(e) {
   return {
-    code: q,
+    code: S,
     msg: "ok",
     result: e
   };
 }
-function I(e, t) {
-  const r = c(t) && typeof t.message == "string" || t instanceof Error ? t.message : c(t) && typeof t.msg == "string" ? t.msg : "fail";
+function w(e) {
+  if (typeof e == "string") return e;
+  if (e instanceof Error) return e.message || "system error";
+  if (h(e)) {
+    if (typeof e.errMsg == "string") return e.errMsg;
+    if (typeof e.msg == "string") return e.msg;
+    if (typeof e.message == "string") return e.message;
+  }
+  return "system error";
+}
+function O(e, t) {
   return {
-    code: b,
-    msg: `${e}:fail ${r}`,
-    result: c(t) && "result" in t ? t.result : t
+    code: v,
+    msg: `${e}:fail ${w(t)}`,
+    result: h(t) && "result" in t ? t.result : t
   };
 }
-const s = v.init({
+const u = A.init({
   debug: !1,
-  timeout: 6e4
-}), A = (e) => s.setDebug(e);
-function M(e, t) {
-  return s.register(e, async (r) => {
+  timeout: 9e4
+}), H = (e, t) => u.setDebug(e, t);
+function _(e, t) {
+  return u.register(e, async (r) => {
     try {
       const o = await t(r);
-      return R(o);
+      return N(o);
     } catch (o) {
-      return I(e, o);
+      return O(e, o);
     }
   });
 }
 function i(e, t, r) {
+  var f, s;
   const o = {
     errMsg: `${e}:fail parameter error: ${t}`,
-    errCode: E
+    errCode: I
   };
-  return P(o, r == null ? void 0 : r.fail, r == null ? void 0 : r.complete), Promise.reject(o);
+  return (f = r == null ? void 0 : r.fail) == null || f.call(r, o), (s = r == null ? void 0 : r.complete) == null || s.call(r, o), Promise.reject(o);
 }
-function N(e) {
-  const t = e, r = {};
-  for (const o of Object.keys(t))
-    o !== "success" && o !== "fail" && o !== "complete" && (r[o] = t[o]);
-  return r;
+function D(e) {
+  return Object.fromEntries(
+    Object.entries(e).filter(([, r]) => typeof r != "function")
+  );
 }
-function c(e) {
+function h(e) {
   return typeof e == "object" && e !== null && !Array.isArray(e);
 }
-function a(e) {
-  return c(e) && typeof e.code == "number";
+function M(e) {
+  return h(e) && typeof e.code == "number";
 }
-function D(e) {
+function m(e) {
   if (typeof e != "string") return e;
   try {
     return JSON.parse(e);
@@ -57,57 +66,42 @@ function D(e) {
     return e;
   }
 }
-function P(e, t, r) {
-  t == null || t(e), r == null || r(e);
-}
-function y(e, t) {
-  if (c(t) && typeof t.errMsg == "string" && typeof t.errCode == "number")
-    return t;
-  if (a(t))
-    return {
-      errMsg: `${e}:fail ${t.msg || "fail"}`,
-      errCode: t.code,
-      errDetail: t.result,
-      raw: t
-    };
-  if (t instanceof Error)
-    return {
-      errMsg: `${e}:fail ${t.message || "fail"}`,
-      errCode: b
-    };
-  const r = c(t) && t.msg !== void 0 ? String(t.msg) : "fail";
-  return {
-    errMsg: `${e}:fail ${r}`,
-    errCode: b,
-    errDetail: t
+function q(e, t) {
+  return h(t) && typeof t.errMsg == "string" && typeof t.errCode == "number" ? t : M(t) ? {
+    errMsg: `${e}:fail ${t.msg || "fail"}`,
+    errCode: t.code,
+    raw: t
+  } : {
+    errMsg: `${e}:fail ${w(t)}`,
+    errCode: v
   };
 }
 function n(e, t = {}, r, o) {
-  const d = String(e), { success: f, fail: S, complete: l } = r || {}, T = (g) => {
-    const u = D(g);
-    if (a(u) && u.code === q) {
-      const h = u;
-      return f == null || f(h), l == null || l(h), h;
+  const f = String(e), { success: s, fail: y, complete: l } = r || {}, R = (a) => {
+    const d = m(a);
+    if (M(d) && d.code === S) {
+      const C = d;
+      return s == null || s(C), l == null || l(C), C;
     }
-    throw y(d, u);
-  }, C = (g) => {
-    const u = y(d, g);
-    throw P(u, S, l), u;
+    throw q(f, d);
+  }, T = (a) => {
+    const d = q(f, a);
+    throw y == null || y(d), l == null || l(d), d;
   };
-  return s.callAsync(d, N(t), o).then(T).catch(C);
+  return u.callAsync(f, D(t), o).then(R).catch(T);
 }
-var w = /* @__PURE__ */ ((e) => (e[e.Short = 0] = "Short", e[e.Long = 1] = "Long", e))(w || {});
-function k(e) {
+var E = /* @__PURE__ */ ((e) => (e[e.Short = 0] = "Short", e[e.Long = 1] = "Long", e))(E || {});
+function x(e) {
   return e.text ? n(
     "showToast",
     {
       text: e.text,
-      duration: e.duration ?? w.Short
+      duration: e.duration ?? E.Short
     },
     e
   ) : i("showToast", "text is required", e);
 }
-function x(e = {}) {
+function V(e = {}) {
   return n("triggerVibrate", {
     duration: e.duration,
     intensity: e.intensity ?? 1,
@@ -115,31 +109,64 @@ function x(e = {}) {
     repeat: e.repeat ?? !1
   }, e, { queue: "serial" });
 }
-function O(e) {
+function j(e) {
   return n("stopVibrate", {}, e, { queue: "serial" });
 }
-function _(e) {
+function F(e) {
   return n("hideKeyboard", {}, e);
 }
-function V() {
+function B() {
   return typeof window > "u" ? 1 : window.devicePixelRatio || 1;
 }
-function j(e) {
-  s.on("keyboardHeightChange", (t) => {
-    const r = t ? t / V() : 0;
-    e(r);
-  });
+const c = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map();
+function $(e, t) {
+  const r = c.get(e);
+  r && u.off("keyboardHeightChange", r);
+  const o = (f) => {
+    const s = f ? f / B() : 0;
+    e(s), t != null && t.once && c.delete(e);
+  };
+  if (c.set(e, o), t != null && t.once) {
+    u.once("keyboardHeightChange", o);
+    return;
+  }
+  u.on("keyboardHeightChange", o);
 }
-function $() {
-  s.off("keyboardHeightChange");
+function k(e) {
+  if (!e) {
+    c.clear(), u.off("keyboardHeightChange");
+    return;
+  }
+  const t = c.get(e);
+  c.delete(e), u.off("keyboardHeightChange", t || e);
+}
+function G(e, t) {
+  const r = g.get(e);
+  r && u.off("onCommentPanelChange", r);
+  const o = (f) => {
+    e(f), t != null && t.once && g.delete(e);
+  };
+  if (g.set(e, o), t != null && t.once) {
+    u.once("onCommentPanelChange", o);
+    return;
+  }
+  u.on("onCommentPanelChange", o);
+}
+function W(e) {
+  if (!e) {
+    g.clear(), u.off("onCommentPanelChange");
+    return;
+  }
+  const t = g.get(e);
+  g.delete(e), u.off("onCommentPanelChange", t || e);
 }
-function B(e) {
+function K(e) {
   var r;
   if (!((r = e.urls) != null && r.length))
-    return i("previewImage", "urls is required", e);
+    return i("previewMedia", "urls is required", e);
   const t = e.current ?? 0;
-  return !Number.isInteger(t) || t < 0 || t >= e.urls.length ? i("previewImage", "current is out of range", e) : n(
-    "playMedia",
+  return !Number.isInteger(t) || t < 0 || t >= e.urls.length ? i("previewMedia", "current is out of range", e) : n(
+    "previewMedia",
     {
       type: "image",
       urls: e.urls,
@@ -148,13 +175,13 @@ function B(e) {
     e
   );
 }
-function W(e) {
+function z(e) {
   var r;
   if (!((r = e.urls) != null && r.length))
     return i("previewVideo", "urls is required", e);
   const t = e.current ?? 0;
   return !Number.isInteger(t) || t < 0 || t >= e.urls.length ? i("previewVideo", "current is out of range", e) : n(
-    "playMedia",
+    "previewMedia",
     {
       type: "video",
       urls: e.urls,
@@ -163,13 +190,12 @@ function W(e) {
     e
   );
 }
-function H(e = {}) {
-  return e.count !== void 0 && (!Number.isInteger(e.count) || e.count <= 0) ? i("chooseMedia", "count must be a positive integer", e) : e.maxDuration !== void 0 && (!Number.isFinite(e.maxDuration) || e.maxDuration <= 0) ? i("chooseMedia", "maxDuration must be greater than 0", e) : n(
+function J(e = {}) {
+  return e.count !== void 0 && (!Number.isInteger(e.count) || e.count <= 0) ? i("chooseMedia", "可选择照片数量范围为1-9张", e) : n(
     "chooseMedia",
     {
       count: e.count ?? 9,
       mediaType: e.mediaType ?? "image",
-      sourceType: e.sourceType ?? "all",
       compressed: e.compressed ?? !0,
       maxDuration: e.maxDuration ?? 60,
       camera: e.camera ?? "back"
@@ -178,41 +204,50 @@ function H(e = {}) {
     { queue: "serial", timeout: 6e4 }
   );
 }
-function G(e) {
-  return e.filePath ? n(
-    "uploadFile",
+const b = /* @__PURE__ */ new Set();
+let P = !1;
+u.on("uploadFilesProgress", (e) => {
+  for (const t of b)
+    t(e);
+});
+function L(e) {
+  return !Array.isArray(e.files) || e.files.length === 0 ? i("uploadFiles", "files is required", e) : e.files.some((t) => !t) ? i("uploadFiles", "files[] is required", e) : P ? i("uploadFiles", "another uploadFiles request is in progress", e) : (P = !0, e.onProgress && b.add(e.onProgress), n(
+    "uploadFiles",
     {
-      filePath: e.filePath
+      files: e.files,
+      cosDirPath: e.cosDirPath ?? "multipleSource/common/"
     },
     e,
     { queue: "serial", timeout: 12e4 }
-  ) : i("uploadFile", "filePath is required", e);
+  ).finally(() => {
+    P = !1, e.onProgress && b.delete(e.onProgress);
+  }));
 }
-function F(e) {
+function U(e) {
   return e.filePath ? n("saveMediaToPhotosAlbum", { type: "image", file: e.filePath }, e, { queue: "serial" }) : i("saveImageToPhotosAlbum", "filePath is required", e);
 }
-function K(e) {
+function X(e) {
   return e.filePath ? n("saveMediaToPhotosAlbum", { type: "video", file: e.filePath }, e, { queue: "serial" }) : i("saveVideoToPhotosAlbum", "filePath is required", e);
 }
-function z(e) {
+function Y(e) {
   return n("startRecord", e || {}, e, { queue: "serial" });
 }
-function J(e) {
+function Q(e) {
   return n("stopRecord", {}, e, { queue: "serial" });
 }
-function L(e) {
+function Z(e) {
   return n("getSystemInfo", {}, e);
 }
-function U(e) {
+function p(e) {
   return n("getNetworkType", {}, e);
 }
-function X(e) {
+function ee(e) {
   return e.data === void 0 ? i("setClipboardData", "data is required", e) : n("setClipboardData", { data: e.data }, e);
 }
-function Y(e) {
+function te(e) {
   return n("getClipboardData", {}, e);
 }
-function Q(e) {
+function re(e) {
   return e.permission ? n(
     "checkPermission",
     {
@@ -221,7 +256,7 @@ function Q(e) {
     e
   ) : i("checkPermission", "permission is required", e);
 }
-function Z(e) {
+function ne(e) {
   return e.type ? n(
     "openPhoneSetting",
     {
@@ -231,71 +266,49 @@ function Z(e) {
     { queue: "serial" }
   ) : i("openPhoneSetting", "type is required", e);
 }
-function p(e) {
-  return e.url ? n("redirectPage", { page: 11, params: { url: e.url } }, e, { queue: "serial" }) : i("navigateToApp", "url is required", e);
-}
-function m(e) {
-  return e.url ? n("redirectPage", { page: 1, params: { url: e.url } }, e, { queue: "serial" }) : i("switchTab", "url is required", e);
-}
-function ee(e) {
-  var t, r;
-  if (!e.url)
-    return i("openWebview", "url is required", e);
-  if (e.replace) {
-    window.location.replace(e.url);
-    const o = {
-      code: 0,
-      msg: "success",
-      result: void 0
-    };
-    return (t = e.success) == null || t.call(e, o), (r = e.complete) == null || r.call(e, o), Promise.resolve(o);
-  }
-  return n("openWebview", { link: e.url, type: e.type || "normal" }, e, { queue: "serial" });
-}
-function te(e) {
+function ie(e) {
   return n("closeWebView", {}, e, { queue: "serial" });
 }
-function re(e) {
+function oe(e) {
   return e.url ? n("openInExternalBrowser", { url: e.url }, e, { queue: "serial" }) : i("openInExternalBrowser", "url is required", e);
 }
-const ne = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const ue = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  checkPermission: Q,
-  chooseMedia: H,
-  closeWebView: te,
-  getClipboardData: Y,
-  getNetworkType: U,
-  getSystemInfo: L,
-  hideKeyboard: _,
-  navigateToApp: p,
-  offKeyboardHeightChange: $,
-  onKeyboardHeightChange: j,
-  openInExternalBrowser: re,
-  openPhoneSetting: Z,
-  openWebview: ee,
-  previewImage: B,
-  previewVideo: W,
-  saveImageToPhotosAlbum: F,
-  saveVideoToPhotosAlbum: K,
-  setClipboardData: X,
-  showToast: k,
-  startRecord: z,
-  stopRecord: J,
-  stopVibrate: O,
-  switchTab: m,
-  triggerVibrate: x,
-  uploadFile: G
+  checkPermission: re,
+  chooseMedia: J,
+  closeWebView: ie,
+  getClipboardData: te,
+  getNetworkType: p,
+  getSystemInfo: Z,
+  hideKeyboard: F,
+  offCommentPanelChange: W,
+  offKeyboardHeightChange: k,
+  onCommentPanelChange: G,
+  onKeyboardHeightChange: $,
+  openInExternalBrowser: oe,
+  openPhoneSetting: ne,
+  previewImage: K,
+  previewVideo: z,
+  saveImageToPhotosAlbum: U,
+  saveVideoToPhotosAlbum: X,
+  setClipboardData: ee,
+  showToast: x,
+  startRecord: Y,
+  stopRecord: Q,
+  stopVibrate: j,
+  triggerVibrate: V,
+  uploadFiles: L
 }, Symbol.toStringTag, { value: "Module" }));
-function ie(e) {
+function fe(e) {
   return n("login", {}, e, { queue: "serial" });
 }
-function oe(e) {
+function se(e) {
   return n("getToken", {}, e);
 }
-function ue(e) {
+function de(e) {
   return n("getCurrentCircleInfo", {}, e);
 }
-function ce(e) {
+function le(e) {
   return e.title ? n(
     "shareWebCard",
     {
@@ -306,77 +319,74 @@ function ce(e) {
     { queue: "serial" }
   ) : i("shareWebCard", "title is required", e);
 }
-function se(e) {
+function ce(e) {
   return n("openAddCustomEmoji", {}, e, { queue: "serial" });
 }
-function le(e) {
+function ge(e) {
   return e.gameName ? e.serverId ? n("pointsMallBindGame", e, e, { queue: "serial" }) : i("toBindGameRole", "serverId is required", e) : i("toBindGameRole", "gameName is required", e);
 }
-function de(e) {
+function he(e) {
   return e.type === void 0 ? i("showAd", "type is required", e) : n("showAdVideo", e, e, { queue: "serial" });
 }
-const fe = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const ye = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  getCurrentCircleInfo: ue,
-  getToken: oe,
-  login: ie,
-  openAddCustomEmoji: se,
-  shareWebCard: ce,
-  showAd: de,
-  toBindGameRole: le
-}, Symbol.toStringTag, { value: "Module" })), ae = {
-  ...ne,
-  ...fe,
-  setDebug: A,
-  registerNativeHandler: M,
-  bridge: s,
-  JSBridgeSdk: v
+  getCurrentCircleInfo: de,
+  getToken: se,
+  login: fe,
+  openAddCustomEmoji: ce,
+  shareWebCard: le,
+  showAd: he,
+  toBindGameRole: ge
+}, Symbol.toStringTag, { value: "Module" })), ve = {
+  ...ue,
+  ...ye,
+  setDebug: H,
+  registerNativeHandler: _
 };
 export {
-  qe as CUSTOM,
-  Se as JSBridgeSdk,
-  he as METHOD_NOT_FOUND,
-  ve as NETWORK_ERROR,
-  be as NOT_LOGGED_IN,
-  E as PARAMS_ERROR,
-  ye as PERMISSION_DENIED,
-  q as SUCCESS,
-  b as SYSTEM_EXCEPTION,
-  w as ToastDuration,
-  s as bridge,
-  Q as checkPermission,
-  H as chooseMedia,
-  te as closeWebView,
-  ae as default,
-  Y as getClipboardData,
-  ue as getCurrentCircleInfo,
-  U as getNetworkType,
-  L as getSystemInfo,
-  oe as getToken,
-  _ as hideKeyboard,
-  ie as login,
-  p as navigateToApp,
-  $ as offKeyboardHeightChange,
-  j as onKeyboardHeightChange,
-  se as openAddCustomEmoji,
-  re as openInExternalBrowser,
-  Z as openPhoneSetting,
-  ee as openWebview,
-  B as previewImage,
-  W as previewVideo,
-  M as registerNativeHandler,
-  F as saveImageToPhotosAlbum,
-  K as saveVideoToPhotosAlbum,
-  X as setClipboardData,
-  A as setDebug,
-  ce as shareWebCard,
-  de as showAd,
-  k as showToast,
-  z as startRecord,
-  J as stopRecord,
-  O as stopVibrate,
-  m as switchTab,
-  le as toBindGameRole,
-  x as triggerVibrate,
-  G as uploadFile
+  Se as CUSTOM,
+  Ee as JSBridgeSdk,
+  Ce as METHOD_NOT_FOUND,
+  qe as NETWORK_ERROR,
+  Pe as NOT_LOGGED_IN,
+  I as PARAMS_ERROR,
+  be as PERMISSION_DENIED,
+  S as SUCCESS,
+  v as SYSTEM_EXCEPTION,
+  E as ToastDuration,
+  u as bridge,
+  re as checkPermission,
+  J as chooseMedia,
+  ie as closeWebView,
+  ve as default,
+  te as getClipboardData,
+  de as getCurrentCircleInfo,
+  p as getNetworkType,
+  Z as getSystemInfo,
+  se as getToken,
+  F as hideKeyboard,
+  fe as login,
+  W as offCommentPanelChange,
+  k as offKeyboardHeightChange,
+  G as onCommentPanelChange,
+  $ as onKeyboardHeightChange,
+  ce as openAddCustomEmoji,
+  oe as openInExternalBrowser,
+  ne as openPhoneSetting,
+  K as previewImage,
+  z as previewVideo,
+  _ as registerNativeHandler,
+  U as saveImageToPhotosAlbum,
+  X as saveVideoToPhotosAlbum,
+  ee as setClipboardData,
+  H as setDebug,
+  le as shareWebCard,
+  he as showAd,
+  x as showToast,
+  Y as startRecord,
+  Q as stopRecord,
+  j as stopVibrate,
+  ge as toBindGameRole,
+  V as triggerVibrate,
+  L as uploadFiles
 };

package/dist/types/enums.d.ts

@@ -17,8 +17,6 @@ export declare enum ToastDuration {
 export type PreviewMediaType = "image" | "video";
 /** 媒体文件类型 */
 export type MediaFileType = "image" | "video";
-/** 媒体来源 */
-export type MediaSourceType = "album" | "camera" | "all";
 /** 系统设置页类型。当前仅支持通知设置页 */
 export type SettingType = "notice";
 /** 权限类型 */

package/dist/types/params.d.ts

@@ -1,6 +1,16 @@
 import { Callbacks } from './base';
-import { MediaFileType, SettingType, MediaSourceType, CameraDirection, WebviewType, ShareChannelType, PermissionType, PreviewMediaType, ToastDuration } from './enums';
-import { ChooseMediaResult, CheckPermissionResult, UploadFileResult } from './results';
+import { MediaFileType, SettingType, CameraDirection, ShareChannelType, PermissionType, PreviewMediaType, ToastDuration } from './enums';
+import { ChooseMediaResult, CheckPermissionResult, UploadFilesProgress, UploadFilesResult } from './results';
+/**
+ * 事件监听选项。
+ *
+ * 事件监听属于 native-event 通道，回调直接接收 Native 原始 payload，
+ * 不包装 code/msg/result。
+ */
+export interface EventListenOptions {
+    /** 是否只监听一次，触发后自动取消监听 */
+    once?: boolean;
+}
 /**
  * showToast 参数
  *
@@ -65,16 +75,6 @@ export interface ChooseMediaParams extends Callbacks<ChooseMediaResult> {
      * @default 'image'
      */
     mediaType?: MediaFileType;
-    /**
-     * 媒体来源。
-     *
-     * - album: 只打开相册
-     * - camera: 只打开相机
-     * - all: 由 Native 提供拍摄/相册选择入口
-     *
-     * @default 'all'
-     */
-    sourceType?: MediaSourceType;
     /**
      * 是否压缩后生成临时文件。
      *
@@ -94,10 +94,14 @@ export interface ChooseMediaParams extends Callbacks<ChooseMediaResult> {
      */
     camera?: CameraDirection;
 }
-/** uploadFile 参数 */
-export interface UploadFileParams extends Callbacks<UploadFileResult> {
-    /** chooseMedia 返回的临时文件路径 */
-    filePath: string;
+/** uploadFiles 参数 */
+export interface UploadFilesParams extends Callbacks<UploadFilesResult> {
+    /** 待上传文件列表，单个文件也需要放在数组中 */
+    files: string[];
+    /** 腾讯云 COS 目录前缀，默认 multipleSource/common/ */
+    cosDirPath?: string;
+    /** 上传进度回调，仅 H5 侧生效 */
+    onProgress?: (progress: UploadFilesProgress) => void;
 }
 /** 保存媒体文件到系统相册的通用参数 */
 export interface SaveImageToPhotosAlbumParams extends Callbacks {
@@ -116,35 +120,10 @@ export interface SetClipboardDataParams extends Callbacks {
     /** 剪贴板内容 */
     data: string;
 }
-/** 导航跳转通用参数（url 必填） */
-export interface NavigateToAppParams extends Callbacks {
-    /** 目标 URL */
-    url: string;
-}
 /** 外部浏览器打开参数 */
-export type OpenInExternalBrowserParams = NavigateToAppParams;
-/** switchTab 参数 */
-export type SwitchTabParams = NavigateToAppParams;
-/**
- * openWebview 参数
- *
- * @example
- * ```ts
- * mys.openWebview({ url: 'https://example.com', type: 'immersive' })
- * mys.openWebview({ url: 'https://example.com', replace: true }) // 直接替换当前页面
- * ```
- */
-export interface OpenWebviewParams extends Callbacks {
-    /** 页面链接 */
+export interface OpenInExternalBrowserParams extends Callbacks {
+    /** 目标 URL */
     url: string;
-    /**
-     * Webview 类型
-     *
-     * @default 'normal'
-     */
-    type?: WebviewType;
-    /** 是否直接替换当前页面（不走 bridge） */
-    replace?: boolean;
 }
 /** triggerVibrate 多段震动序列项 */
 export interface VibrateStep {

package/dist/types/results.d.ts

@@ -2,13 +2,13 @@ import { Platform, NetworkTypeStr, PermissionStatus, PermissionType } from './en
 /** chooseMedia 返回值 */
 export interface ChooseMediaResult {
     /** 本地临时媒体文件列表 */
-    files: ChooseMediaFile[];
+    tempFiles: ChooseMediaFile[];
 }
 /** chooseMedia 临时媒体文件 */
 export interface ChooseMediaFile {
-    /** 临时文件路径，可用于 img / video 预览，也可传给 uploadFile 上传 */
+    /** 临时文件路径，可用于 img / video 预览，也可传给 uploadFiles 上传 */
     tempFilePath: string;
-    /** 文件大小，单位 byte */
+    /** 文件大小，单位 KB */
     size?: number;
     /** 宽度，单位 px */
     width?: number;
@@ -16,16 +16,39 @@ export interface ChooseMediaFile {
     height?: number;
     /** 视频时长，单位秒，仅视频文件返回 */
     duration?: number;
-    /** 缩略图临时路径 */
+    /** 缩略图临时路径 仅视频 */
     thumbTempFilePath?: string;
 }
-/** uploadFile 返回值 */
-export interface UploadFileResult {
-    /** 上传后的网络 URL */
-    url: string;
-    /** 上传后的缩略图网络 URL */
+/** uploadFiles 单个文件上传结果 */
+export interface UploadFilesResultItem {
+    /** 原始本地文件路径 */
+    filePath: string;
+    /** 当前文件是否上传成功 */
+    success: boolean;
+    /** 上传后的网络 URL，成功时返回 */
+    url?: string;
+    /** 上传后的缩略图网络 URL，图片/视频可选 */
     thumbUrl?: string;
 }
+/** uploadFiles 返回值 */
+export interface UploadFilesResult {
+    /** 上传结果文件列表 */
+    files: UploadFilesResultItem[];
+}
+/** uploadFiles 进度 */
+export interface UploadFilesProgress {
+    /** 每个文件的上传进度 */
+    files: UploadFilesProgressFile[];
+}
+/** uploadFiles 单个文件进度 */
+export interface UploadFilesProgressFile {
+    /** 当前文件下标，从 0 开始 */
+    index: number;
+    /** 当前临时文件路径 */
+    filePath: string;
+    /** 当前文件进度，范围 0-100 */
+    progress: number;
+}
 /** getClipboardData 返回值 */
 export interface GetClipboardDataResult {
     /** 剪贴板内容 */
@@ -68,6 +91,25 @@ export interface CheckPermissionResult {
     /** 权限检查结果 */
     result: PermissionStatus;
 }
+/**
+ * 键盘高度变化回调。
+ *
+ * 事件监听直接返回 CSS 逻辑像素高度，不包装 code/msg/result。
+ */
+export type KeyboardHeightChangeCallback = (height: number) => void;
+/**
+ * 评论区面板状态变化事件 payload。
+ *
+ * 事件监听直接返回该业务对象，不包装 code/msg/result。
+ */
+export interface CommentPanelChangeResult {
+    /** 评论区面板是否可见 */
+    visible: boolean;
+    /** 评论区面板状态变化原因 */
+    reason: string;
+}
+/** 评论区面板状态变化回调 */
+export type CommentPanelChangeCallback = (res: CommentPanelChangeResult) => void;
 /** 用户基本信息 */
 export interface UserInfo {
     /** 用户昵称 */

package/package.json

@@ -1,46 +1,45 @@
-{
-  "name": "@docoi/mys-sdk",
-  "version": "1.0.0",
-  "description": "基于 JSBridge 封装的H5 SDK，统一 Native 通信与业务 API 封装",
-  "author": "tanyangkang",
-  "license": "MIT",
-  "sideEffects": false,
-  "homepage": "https://gitlab.docoi.cc/tanyangkang/mys-sdk",
-  "repository": {
-    "type": "git",
-    "url": "git+https://gitlab.docoi.cc/tanyangkang/mys-sdk.git"
-  },
-  "bugs": {
-    "url": "https://gitlab.docoi.cc/tanyangkang/mys-sdk/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "type": "module",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "vite build --watch",
-    "build": "vite build",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
-  "dependencies": {
-    "@docoi/jsbridge-sdk": "2.0.1"
-  },
-  "devDependencies": {
-    "@changesets/cli": "^2.31.1",
-    "typescript": "^5.9.3",
-    "vite": "^5.4.21",
-    "vite-plugin-dts": "^5.0.3"
-  }
-}
+{
+  "name": "@docoi/mys-sdk",
+  "version": "1.0.2",
+  "description": "基于 JSBridge 封装的H5 SDK，统一 Native 通信与业务 API 封装",
+  "author": "tanyangkang",
+  "license": "MIT",
+  "sideEffects": false,
+  "homepage": "https://gitlab.docoi.cc/tanyangkang/mys-sdk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.docoi.cc/tanyangkang/mys-sdk.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.docoi.cc/tanyangkang/mys-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@docoi/jsbridge-sdk": "2.0.2"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.1",
+    "typescript": "^5.9.3",
+    "vite": "^5.4.21",
+    "vite-plugin-dts": "^5.0.3"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "type-check": "tsc --noEmit"
+  }
+}