@docoi/mys-sdk 1.0.0-beta.0 → 1.0.0

package/dist/index.mjs

@@ -1,51 +1,382 @@
-import { a } from "./basic-C58euoyc.js";
-import { c as n, b as h, g as f, d as l, e as w, h as c, f as v, n as u, o as C, i as T, j as x, k as y, p as S, l as k, s as A, m as I, q as B, r as D, t as K, u as R, v as V, w as W, x as j } from "./basic-C58euoyc.js";
-import { a as e } from "./biz-BbTdssY5.js";
-import { g as H, b as J, l as P, o as q, s as G, c as L, t as M } from "./biz-BbTdssY5.js";
-import { b as s, s as o } from "./bridge-BsyNF-2c.js";
-import r from "@docoi/jsbridge-sdk";
-import { default as $ } from "@docoi/jsbridge-sdk";
-const g = {
-  ...a,
-  ...e,
-  setDebug: o,
+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) {
+  return {
+    code: q,
+    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";
+  return {
+    code: b,
+    msg: `${e}:fail ${r}`,
+    result: c(t) && "result" in t ? t.result : t
+  };
+}
+const s = v.init({
+  debug: !1,
+  timeout: 6e4
+}), A = (e) => s.setDebug(e);
+function M(e, t) {
+  return s.register(e, async (r) => {
+    try {
+      const o = await t(r);
+      return R(o);
+    } catch (o) {
+      return I(e, o);
+    }
+  });
+}
+function i(e, t, r) {
+  const o = {
+    errMsg: `${e}:fail parameter error: ${t}`,
+    errCode: E
+  };
+  return P(o, r == null ? void 0 : r.fail, r == null ? void 0 : r.complete), 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 c(e) {
+  return typeof e == "object" && e !== null && !Array.isArray(e);
+}
+function a(e) {
+  return c(e) && typeof e.code == "number";
+}
+function D(e) {
+  if (typeof e != "string") return e;
+  try {
+    return JSON.parse(e);
+  } catch {
+    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 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;
+    }
+    throw y(d, u);
+  }, C = (g) => {
+    const u = y(d, g);
+    throw P(u, S, l), u;
+  };
+  return s.callAsync(d, N(t), o).then(T).catch(C);
+}
+var w = /* @__PURE__ */ ((e) => (e[e.Short = 0] = "Short", e[e.Long = 1] = "Long", e))(w || {});
+function k(e) {
+  return e.text ? n(
+    "showToast",
+    {
+      text: e.text,
+      duration: e.duration ?? w.Short
+    },
+    e
+  ) : i("showToast", "text is required", e);
+}
+function x(e = {}) {
+  return n("triggerVibrate", {
+    duration: e.duration,
+    intensity: e.intensity ?? 1,
+    steps: e.steps,
+    repeat: e.repeat ?? !1
+  }, e, { queue: "serial" });
+}
+function O(e) {
+  return n("stopVibrate", {}, e, { queue: "serial" });
+}
+function _(e) {
+  return n("hideKeyboard", {}, e);
+}
+function V() {
+  return typeof window > "u" ? 1 : window.devicePixelRatio || 1;
+}
+function j(e) {
+  s.on("keyboardHeightChange", (t) => {
+    const r = t ? t / V() : 0;
+    e(r);
+  });
+}
+function $() {
+  s.off("keyboardHeightChange");
+}
+function B(e) {
+  var r;
+  if (!((r = e.urls) != null && r.length))
+    return i("previewImage", "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",
+    {
+      type: "image",
+      urls: e.urls,
+      current: t
+    },
+    e
+  );
+}
+function W(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",
+    {
+      type: "video",
+      urls: e.urls,
+      current: t
+    },
+    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(
+    "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"
+    },
+    e,
+    { queue: "serial", timeout: 6e4 }
+  );
+}
+function G(e) {
+  return e.filePath ? n(
+    "uploadFile",
+    {
+      filePath: e.filePath
+    },
+    e,
+    { queue: "serial", timeout: 12e4 }
+  ) : i("uploadFile", "filePath is required", e);
+}
+function F(e) {
+  return e.filePath ? n("saveMediaToPhotosAlbum", { type: "image", file: e.filePath }, e, { queue: "serial" }) : i("saveImageToPhotosAlbum", "filePath is required", e);
+}
+function K(e) {
+  return e.filePath ? n("saveMediaToPhotosAlbum", { type: "video", file: e.filePath }, e, { queue: "serial" }) : i("saveVideoToPhotosAlbum", "filePath is required", e);
+}
+function z(e) {
+  return n("startRecord", e || {}, e, { queue: "serial" });
+}
+function J(e) {
+  return n("stopRecord", {}, e, { queue: "serial" });
+}
+function L(e) {
+  return n("getSystemInfo", {}, e);
+}
+function U(e) {
+  return n("getNetworkType", {}, e);
+}
+function X(e) {
+  return e.data === void 0 ? i("setClipboardData", "data is required", e) : n("setClipboardData", { data: e.data }, e);
+}
+function Y(e) {
+  return n("getClipboardData", {}, e);
+}
+function Q(e) {
+  return e.permission ? n(
+    "checkPermission",
+    {
+      permission: e.permission
+    },
+    e
+  ) : i("checkPermission", "permission is required", e);
+}
+function Z(e) {
+  return e.type ? n(
+    "openPhoneSetting",
+    {
+      type: e.type
+    },
+    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) {
+  return n("closeWebView", {}, e, { queue: "serial" });
+}
+function re(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({
+  __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
+}, Symbol.toStringTag, { value: "Module" }));
+function ie(e) {
+  return n("login", {}, e, { queue: "serial" });
+}
+function oe(e) {
+  return n("getToken", {}, e);
+}
+function ue(e) {
+  return n("getCurrentCircleInfo", {}, e);
+}
+function ce(e) {
+  return e.title ? n(
+    "shareWebCard",
+    {
+      ...e,
+      shareTypes: e.shareTypes ?? [1, 2, 3]
+    },
+    e,
+    { queue: "serial" }
+  ) : i("shareWebCard", "title is required", e);
+}
+function se(e) {
+  return n("openAddCustomEmoji", {}, e, { queue: "serial" });
+}
+function le(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) {
+  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({
+  __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: r
+  JSBridgeSdk: v
 };
 export {
-  $ as JSBridgeSdk,
+  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,
-  n as chooseMedia,
-  h as closeWebView,
-  g as default,
-  f as getClipboardData,
-  H as getCurrentCircleInfo,
-  l as getNetworkType,
-  w as getSystemInfo,
-  J as getToken,
-  c as hideKeyboard,
-  v as hideToast,
-  P as login,
-  u as navigateToApp,
-  C as offKeyboardHeightChange,
-  T as onKeyboardHeightChange,
-  q as openAddCustomEmoji,
-  x as openInExternalBrowser,
-  y as openWebview,
-  S as previewImage,
-  k as previewVideo,
-  A as saveImageToPhotosAlbum,
-  I as saveVideoToPhotosAlbum,
-  B as setClipboardData,
-  o as setDebug,
-  G as shareWebCard,
-  L as showAd,
-  D as showToast,
-  K as startRecord,
-  R as stopRecord,
-  V as switchTab,
-  M as toBindGameRole,
-  W as vibrateLong,
-  j as vibrateShort
+  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
 };
-//# sourceMappingURL=index.mjs.map

package/dist/types/base.d.ts

@@ -0,0 +1,54 @@
+/**
+ * mys-sdk 基础协议类型
+ *
+ * 定义 Native 与 SDK 对外暴露的统一数据格式。
+ *
+ * @module types/base
+ */
+/**
+ * Native 返回的统一响应格式。
+ *
+ * SDK 成功时 Promise resolve、success 回调、complete 回调均返回该完整结构，
+ * 不拆包返回 result。
+ *
+ * @typeParam TResult - result 字段的业务数据类型
+ */
+export interface NativeResponse<TResult = void> {
+    /** 状态码，0 表示成功 */
+    readonly code: number;
+    /** 业务数据 */
+    readonly result: TResult;
+    /** 提示信息 */
+    readonly msg: string;
+}
+/**
+ * API 调用错误对象。
+ *
+ * SDK 失败时 Promise reject、fail 回调、complete 回调均返回该结构。
+ */
+export interface ApiError {
+    /** 错误描述，格式：`fnName:fail ...` */
+    readonly errMsg: string;
+    /** 错误码，-1 表示参数校验失败或未知错误 */
+    readonly errCode: number;
+    /** Native result 或额外错误详情 */
+    readonly errDetail?: unknown;
+    /** Native 原始响应，便于排查联调问题 */
+    readonly raw?: NativeResponse<unknown>;
+}
+/**
+ * API 回调接口。
+ *
+ * 所有 API 参数类型都 extends 此接口，以兼容 success/fail/complete 回调风格。
+ * 泛型表示 NativeResponse.result 的业务数据类型，而不是 success 的完整参数类型。
+ *
+ * @typeParam TResult - NativeResponse.result 字段的业务数据类型
+ */
+export interface Callbacks<TResult = void> {
+    /** 成功回调，返回完整 NativeResponse */
+    success?: (res: NativeResponse<TResult>) => void;
+    /** 失败回调，返回标准 ApiError */
+    fail?: (err: ApiError) => void;
+    /** 完成回调，成功时返回 NativeResponse，失败时返回 ApiError */
+    complete?: (res?: NativeResponse<TResult> | ApiError) => void;
+}

package/dist/types/enums.d.ts

@@ -0,0 +1,44 @@
+/**
+ * mys-sdk 枚举类型别名
+ *
+ * 为 API 参数提供精确的字符串/数字字面量联合类型，
+ * 替代传统的 TypeScript enum，实现更好的 IDE 自动补全和文档站精确解析
+ *
+ * @module types/enums
+ */
+/** Toast 显示时长 */
+export declare enum ToastDuration {
+    /** 短时显示 */
+    Short = 0,
+    /** 长时显示 */
+    Long = 1
+}
+/** 媒体预览类型 */
+export type PreviewMediaType = "image" | "video";
+/** 媒体文件类型 */
+export type MediaFileType = "image" | "video";
+/** 媒体来源 */
+export type MediaSourceType = "album" | "camera" | "all";
+/** 系统设置页类型。当前仅支持通知设置页 */
+export type SettingType = "notice";
+/** 权限类型 */
+export type PermissionType = "camera" | "microphone" | "location" | "storage" | "notification";
+/** 权限状态 */
+export type PermissionStatus = "granted" | "denied" | "permanentlyDenied";
+/** 摄像头方向 */
+export type CameraDirection = "back" | "front";
+/** Webview 容器类型 */
+export type WebviewType = "immersive" | "normal" | "mini";
+/** 平台 */
+export type Platform = "android" | "ios";
+/** 网络类型 */
+export type NetworkTypeStr = "wifi" | "2g" | "3g" | "4g" | "5g" | "unknown" | "none";
+/**
+ * 分享渠道
+ * - 1: 微信好友
+ * - 2: 朋友圈
+ * - 3: QQ
+ */
+export type ShareChannelType = 1 | 2 | 3;
+/** 文件类型标签 */
+export type FileTypeTag = "image" | "video";

package/dist/types/index.d.ts

@@ -1,141 +1,11 @@
 /**
- * mysJs-sdk v2.0.0 类型定义
+ * mys-sdk 类型定义
  *
- * 统一模块导出：基础协议类型 + 各 API 参数/返回值类型
+ * barrel re-export，按需从拆分后的子模块导出
+ *
+ * @module types
  */
-/** Native 返回的统一格式 */
-export interface NativeResponse<T = any> {
-    code: number;
-    msg: string;
-    result: T;
-}
-/** API 错误 */
-export interface ApiError {
-    errMsg: string;
-    errCode: number;
-    [key: string]: any;
-}
-/** 通用回调接口 */
-export interface Callbacks<T = any> {
-    success?: (res: T) => void;
-    fail?: (err: ApiError) => void;
-    complete?: (res?: T | ApiError) => void;
-}
-export interface ShowToastParams extends Callbacks<void> {
-    title: string;
-    icon?: 'success' | 'error' | 'loading' | 'none';
-    duration?: number;
-    mask?: boolean;
-}
-export interface HideToastParams extends Callbacks<void> {
-}
-export interface PlayMediaParams extends Callbacks<void> {
-    urls: string[];
-    url: string;
-}
-export interface ChooseMediaParams extends Callbacks<ChooseMediaResult> {
-    count?: number;
-    mediaType?: ('image' | 'video' | 'mix')[];
-    sourceType?: ('album' | 'camera')[];
-    maxDuration?: number;
-    sizeType?: ('original' | 'compressed')[];
-    camera?: 'back' | 'front';
-}
-export interface ChooseMediaResult {
-    tempFiles: Array<{
-        tempFilePath: string;
-        size: number;
-        duration?: number;
-        height?: number;
-        width?: number;
-        thumbTempFilePath?: string;
-        fileType: 'image' | 'video';
-    }>;
-    type: 'image' | 'video' | 'mix';
-}
-export interface SaveImageToPhotosAlbumParams extends Callbacks<void> {
-    filePath: string;
-}
-export interface SaveVideoToPhotosAlbumParams extends Callbacks<void> {
-    filePath: string;
-}
-export interface StartRecordParams extends Callbacks<void> {
-    maxDuration?: number;
-}
-export interface SetClipboardDataParams extends Callbacks<void> {
-    data: string;
-}
-export interface GetClipboardDataResult {
-    data: string;
-}
-export interface OpenInExternalBrowserParams extends Callbacks<void> {
-    url: string;
-}
-export interface NavigateToAppParams extends Callbacks<void> {
-    url: string;
-}
-export interface SwitchTabParams extends Callbacks<void> {
-    url: string;
-}
-export interface OpenWebviewParams extends Callbacks<void> {
-    url: string;
-    type?: 'immersive' | 'normal' | 'mini';
-    replace?: boolean;
-}
-export interface VibrateShortParams extends Callbacks<void> {
-    type: 'heavy' | 'medium' | 'light';
-}
-export interface SystemInfoResult {
-    brand: string;
-    model: string;
-    pixelRatio: number;
-    screenWidth: number;
-    screenHeight: number;
-    windowWidth: number;
-    windowHeight: number;
-    statusBarHeight: number;
-    version: string;
-    system: string;
-    platform: 'android' | 'ios';
-}
-export interface NetworkTypeResult {
-    networkType: 'wifi' | '2g' | '3g' | '4g' | '5g' | 'unknown' | 'none';
-}
-export interface ShareWebCardParams extends Callbacks<void> {
-    title: string;
-    content?: string;
-    icon?: string;
-    shareUrl?: string;
-    externalContent?: string;
-    shareTypes?: (1 | 2 | 3)[];
-    isSharePic?: boolean;
-    serverId?: string;
-    trackData?: string;
-    daokeUrl?: string;
-    channelIds?: string;
-    contentType?: string;
-}
-export interface ShowAdParams extends Callbacks<void> {
-    type: number;
-    circle_id?: string;
-    cycle_day?: string | number;
-    module?: string | number;
-    cycle_id?: string;
-    wheel_lottery_id?: string | number;
-}
-export interface BindGameRoleParams extends Callbacks<void> {
-    gameName: string;
-    serverId: string;
-}
-export interface LoginResult {
-    code: string;
-    userInfo?: any;
-}
-export interface GetTokenResult {
-    token: string;
-}
-export interface GetCircleInfoResult {
-    serverId: string;
-    name: string;
-    icon: string;
-}
+export * from './base';
+export * from './enums';
+export * from './params';
+export * from './results';