@docoi/mys-sdk 1.0.2 → 1.0.3

package/dist/api/biz.d.ts

@@ -1,4 +1,4 @@
-import { Callbacks, NativeResponse, ShareWebCardParams, ShowAdParams, BindGameRoleParams, LoginResult, GetTokenResult, GetCircleInfoResult } from '../types';
+import { Callbacks, NativeResponse, ShareWebCardParams, ShareImageParams, ShareImageResult, ShowAdParams, BindGameRoleParams, LoginResult, GetTokenResult, GetCircleInfoResult } from '../types';
 /**
  * 登录授权，获取用户信息。
  *
@@ -44,6 +44,20 @@ export declare function getCurrentCircleInfo(params?: Callbacks<GetCircleInfoRes
  * })
  */
 export declare function shareWebCard(params: ShareWebCardParams): Promise<NativeResponse<void>>;
+/**
+ * 唤起客户端图片分享弹窗，分享网络图片。
+ *
+ * 弹窗提供微信好友、微信朋友圈、QQ 好友、保存图片、取消五个操作，用户点击后通过 result.action 返回所选操作。
+ *
+ * @note
+ * url 不能为空，且必须为 http(s) 网络地址。
+ * 点击取消按钮属于成功响应，result.action 为 cancel。
+ *
+ * @example
+ * const res = await mys.shareImage({ url: 'https://example.com/poster.png' })
+ * console.log(res.result.action) // 'wechat' | 'moment' | 'qq' | 'save' | 'cancel'
+ */
+export declare function shareImage(params: ShareImageParams): Promise<NativeResponse<ShareImageResult>>;
 /**
  * 打开添加自定义表情页面。
  *

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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';
+import { Callbacks, LoginResult, NativeResponse, GetTokenResult, GetCircleInfoResult, ShareWebCardParams, ShareImageParams, ShareImageResult, 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, options?: Partial< DebugOptions>) => JSBridgeInterface;
     registerNativeHandler: typeof registerNativeHandler;
@@ -8,6 +8,7 @@ declare const mys: {
     getToken(params?: Callbacks<GetTokenResult>): Promise< NativeResponse<GetTokenResult>>;
     getCurrentCircleInfo(params?: Callbacks<GetCircleInfoResult>): Promise< NativeResponse<GetCircleInfoResult>>;
     shareWebCard(params: ShareWebCardParams): Promise< NativeResponse<void>>;
+    shareImage(params: ShareImageParams): Promise< NativeResponse<ShareImageResult>>;
     openAddCustomEmoji(params?: Callbacks): Promise< NativeResponse<void>>;
     toBindGameRole(params: BindGameRoleParams): Promise< NativeResponse<void>>;
     showAd(params: ShowAdParams): Promise< NativeResponse<void>>;

package/dist/index.mjs

@@ -1,9 +1,9 @@
-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;
+import T from "@docoi/jsbridge-sdk";
+import { default as Ie } from "@docoi/jsbridge-sdk";
+const v = 0, S = -1, Pe = 1001, A = 1002, be = 2002, qe = 3002, ve = 4002, Se = 9002;
 function N(e) {
   return {
-    code: S,
+    code: v,
     msg: "ok",
     result: e
   };
@@ -20,12 +20,12 @@ function w(e) {
 }
 function O(e, t) {
   return {
-    code: v,
+    code: S,
     msg: `${e}:fail ${w(t)}`,
     result: h(t) && "result" in t ? t.result : t
   };
 }
-const u = A.init({
+const u = T.init({
   debug: !1,
   timeout: 9e4
 }), H = (e, t) => u.setDebug(e, t);
@@ -40,12 +40,12 @@ function _(e, t) {
   });
 }
 function i(e, t, r) {
-  var f, s;
+  var s, f;
   const o = {
     errMsg: `${e}:fail parameter error: ${t}`,
-    errCode: I
+    errCode: A
   };
-  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);
+  return (s = r == null ? void 0 : r.fail) == null || s.call(r, o), (f = r == null ? void 0 : r.complete) == null || f.call(r, o), Promise.reject(o);
 }
 function D(e) {
   return Object.fromEntries(
@@ -73,22 +73,22 @@ function q(e, t) {
     raw: t
   } : {
     errMsg: `${e}:fail ${w(t)}`,
-    errCode: v
+    errCode: S
   };
 }
 function n(e, t = {}, r, o) {
-  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;
+  const s = String(e), { success: f, fail: y, complete: d } = r || {}, I = (a) => {
+    const l = m(a);
+    if (M(l) && l.code === v) {
+      const C = l;
+      return f == null || f(C), d == null || d(C), C;
     }
-    throw q(f, d);
-  }, T = (a) => {
-    const d = q(f, a);
-    throw y == null || y(d), l == null || l(d), d;
+    throw q(s, l);
+  }, R = (a) => {
+    const l = q(s, a);
+    throw y == null || y(l), d == null || d(l), l;
   };
-  return u.callAsync(f, D(t), o).then(R).catch(T);
+  return u.callAsync(s, D(t), o).then(I).catch(R);
 }
 var E = /* @__PURE__ */ ((e) => (e[e.Short = 0] = "Short", e[e.Long = 1] = "Long", e))(E || {});
 function x(e) {
@@ -122,9 +122,9 @@ 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);
+  const o = (s) => {
+    const f = s ? s / B() : 0;
+    e(f), t != null && t.once && c.delete(e);
   };
   if (c.set(e, o), t != null && t.once) {
     u.once("keyboardHeightChange", o);
@@ -143,8 +143,8 @@ function k(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);
+  const o = (s) => {
+    e(s), t != null && t.once && g.delete(e);
   };
   if (g.set(e, o), t != null && t.once) {
     u.once("onCommentPanelChange", o);
@@ -299,16 +299,16 @@ const ue = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   triggerVibrate: V,
   uploadFiles: L
 }, Symbol.toStringTag, { value: "Module" }));
-function fe(e) {
+function se(e) {
   return n("login", {}, e, { queue: "serial" });
 }
-function se(e) {
+function fe(e) {
   return n("getToken", {}, e);
 }
-function de(e) {
+function le(e) {
   return n("getCurrentCircleInfo", {}, e);
 }
-function le(e) {
+function de(e) {
   return e.title ? n(
     "shareWebCard",
     {
@@ -320,57 +320,61 @@ function le(e) {
   ) : i("shareWebCard", "title is required", e);
 }
 function ce(e) {
-  return n("openAddCustomEmoji", {}, e, { queue: "serial" });
+  return !e.url || !/^https?:\/\//i.test(e.url) ? i("shareImage", "url must be a valid http(s) url", e) : n("shareImage", { url: e.url }, e, { queue: "serial" });
 }
 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);
+  return n("openAddCustomEmoji", {}, e, { queue: "serial" });
 }
 function he(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 ye(e) {
   return e.type === void 0 ? i("showAd", "type is required", e) : n("showAdVideo", e, e, { queue: "serial" });
 }
-const ye = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const ae = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  getCurrentCircleInfo: de,
-  getToken: se,
-  login: fe,
-  openAddCustomEmoji: ce,
-  shareWebCard: le,
-  showAd: he,
-  toBindGameRole: ge
-}, Symbol.toStringTag, { value: "Module" })), ve = {
+  getCurrentCircleInfo: le,
+  getToken: fe,
+  login: se,
+  openAddCustomEmoji: ge,
+  shareImage: ce,
+  shareWebCard: de,
+  showAd: ye,
+  toBindGameRole: he
+}, Symbol.toStringTag, { value: "Module" })), we = {
   ...ue,
-  ...ye,
+  ...ae,
   setDebug: H,
   registerNativeHandler: _
 };
 export {
   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,
+  Ie as JSBridgeSdk,
+  Pe as METHOD_NOT_FOUND,
+  ve as NETWORK_ERROR,
+  be as NOT_LOGGED_IN,
+  A as PARAMS_ERROR,
+  qe as PERMISSION_DENIED,
+  v as SUCCESS,
+  S as SYSTEM_EXCEPTION,
   E as ToastDuration,
   u as bridge,
   re as checkPermission,
   J as chooseMedia,
   ie as closeWebView,
-  ve as default,
+  we as default,
   te as getClipboardData,
-  de as getCurrentCircleInfo,
+  le as getCurrentCircleInfo,
   p as getNetworkType,
   Z as getSystemInfo,
-  se as getToken,
+  fe as getToken,
   F as hideKeyboard,
-  fe as login,
+  se as login,
   W as offCommentPanelChange,
   k as offKeyboardHeightChange,
   G as onCommentPanelChange,
   $ as onKeyboardHeightChange,
-  ce as openAddCustomEmoji,
+  ge as openAddCustomEmoji,
   oe as openInExternalBrowser,
   ne as openPhoneSetting,
   K as previewImage,
@@ -380,13 +384,14 @@ export {
   X as saveVideoToPhotosAlbum,
   ee as setClipboardData,
   H as setDebug,
-  le as shareWebCard,
-  he as showAd,
+  ce as shareImage,
+  de as shareWebCard,
+  ye as showAd,
   x as showToast,
   Y as startRecord,
   Q as stopRecord,
   j as stopVibrate,
-  ge as toBindGameRole,
+  he as toBindGameRole,
   V as triggerVibrate,
   L as uploadFiles
 };

package/dist/types/enums.d.ts

@@ -38,5 +38,14 @@ export type NetworkTypeStr = "wifi" | "2g" | "3g" | "4g" | "5g" | "unknown" | "n
  * - 3: QQ
  */
 export type ShareChannelType = 1 | 2 | 3;
+/**
+ * 图片分享弹窗操作
+ * - wechat: 微信好友
+ * - moment: 微信朋友圈
+ * - qq: QQ 好友
+ * - save: 保存图片
+ * - cancel: 取消
+ */
+export type ShareImageAction = "wechat" | "moment" | "qq" | "save" | "cancel";
 /** 文件类型标签 */
 export type FileTypeTag = "image" | "video";

package/dist/types/params.d.ts

@@ -1,6 +1,6 @@
 import { Callbacks } from './base';
 import { MediaFileType, SettingType, CameraDirection, ShareChannelType, PermissionType, PreviewMediaType, ToastDuration } from './enums';
-import { ChooseMediaResult, CheckPermissionResult, UploadFilesProgress, UploadFilesResult } from './results';
+import { ChooseMediaResult, CheckPermissionResult, ShareImageResult, UploadFilesProgress, UploadFilesResult } from './results';
 /**
  * 事件监听选项。
  *
@@ -195,6 +195,20 @@ export interface ShareWebCardParams extends Callbacks {
     /** 内容类型 */
     contentType?: string;
 }
+/**
+ * shareImage 参数
+ *
+ * 唤起客户端图片分享弹窗
+ *
+ * @example
+ * ```ts
+ * mys.shareImage({ url: 'https://example.com/poster.png' })
+ * ```
+ */
+export interface ShareImageParams extends Callbacks<ShareImageResult> {
+    /** 待分享图片的网络地址，需为 http(s) URL */
+    url: string;
+}
 /**
  * showAd 参数
  *

package/dist/types/results.d.ts

@@ -1,4 +1,4 @@
-import { Platform, NetworkTypeStr, PermissionStatus, PermissionType } from './enums';
+import { Platform, NetworkTypeStr, PermissionStatus, PermissionType, ShareImageAction } from './enums';
 /** chooseMedia 返回值 */
 export interface ChooseMediaResult {
     /** 本地临时媒体文件列表 */
@@ -133,6 +133,11 @@ export interface GetTokenResult {
     /** 登录 Token */
     readonly token: string;
 }
+/** shareImage 返回值 */
+export interface ShareImageResult {
+    /** 用户在分享弹窗中点击的操作 */
+    readonly action: ShareImageAction;
+}
 /** getCurrentCircleInfo 返回值 */
 export interface GetCircleInfoResult {
     /** 服务器 ID */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docoi/mys-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "基于 JSBridge 封装的H5 SDK，统一 Native 通信与业务 API 封装",
   "author": "tanyangkang",
   "license": "MIT",