@docoi/mys-sdk 1.0.3 → 1.1.0

package/dist/types/results.d.ts

@@ -1,4 +1,4 @@
-import { Platform, NetworkTypeStr, PermissionStatus, PermissionType, ShareImageAction } from './enums';
+import { PermissionStatus, PermissionType, ShareImageAction } from './enums';
 /** chooseMedia 返回值 */
 export interface ChooseMediaResult {
     /** 本地临时媒体文件列表 */
@@ -6,7 +6,7 @@ export interface ChooseMediaResult {
 }
 /** chooseMedia 临时媒体文件 */
 export interface ChooseMediaFile {
-    /** 临时文件路径，可用于 img / video 预览，也可传给 uploadFiles 上传 */
+    /** 临时文件路径，如 mysFile://temp/xxxx.png，可用于 img / video 预览，也可传给 uploadFiles 上传 */
     tempFilePath: string;
     /** 文件大小，单位 KB */
     size?: number;
@@ -49,40 +49,67 @@ export interface UploadFilesProgressFile {
     /** 当前文件进度，范围 0-100 */
     progress: number;
 }
+/**
+ * uploadFiles 上传进度回调，仅 H5 侧生效。
+ *
+ * @param progress 本次上传各文件的进度
+ */
+export type UploadFilesProgressCallback = (progress: UploadFilesProgress) => void;
 /** getClipboardData 返回值 */
 export interface GetClipboardDataResult {
     /** 剪贴板内容 */
     data: string;
 }
-/** getSystemInfo 返回值 */
-export interface SystemInfoResult {
-    /** 设备品牌 */
-    brand: string;
-    /** 设备型号 */
-    model: string;
-    /** 设备像素比 */
-    pixelRatio: number;
-    /** 屏幕宽度（px） */
-    screenWidth: number;
-    /** 屏幕高度（px） */
-    screenHeight: number;
-    /** 可使用窗口宽度（px） */
-    windowWidth: number;
-    /** 可使用窗口高度（px） */
-    windowHeight: number;
-    /** 状态栏高度（px） */
-    statusBarHeight: number;
-    /** App 版本号 */
-    version: string;
+/**
+ * App 基础信息，即 UA 中 #webBaseInfo{...}# 规整后的结果，getAppBaseInfo 的返回类型。
+ *
+ * 字段名和取值以 Native 上报的 UA 为准，原样保留 snake_case，不另起一套命名。
+ * app_version 必填（缺失或格式不对时 getAppBaseInfo 整体返回 null），其余字段 UA 里缺失时为空，读取时按需判空。
+ */
+export interface AppBaseInfo {
+    /** App 版本号，含构建号，如 4.4.0.452 */
+    app_version: string;
+    /** 渠道，如 docoi、Appstore */
+    channel?: string;
+    /** 设备 ID */
+    device_id?: string;
+    /** 设备型号，如 V2453A、iPhone16,1 */
+    device_model?: string;
+    /** 设备类型，如 Phone、iPhone */
+    device_type?: string;
+    /** 当前环境标识，如 test，App 4.2.0 起支持 */
+    env?: string;
+    /** 页面类型：1 普通 H5，2 小程序，4 沉浸式 */
+    h5Type?: number;
+    /** 安卓是否为加速版：'0' 为普通版，其他为加速版，仅 Android 上报，App 4.2.0 起支持 */
+    jsNum?: string;
+    /** 网络类型，Android 为 NETWORK_WIFI 形式，iOS 为 WiFi 形式 */
+    network_type?: string;
+    /** 操作系统，Android 或 iOS */
+    os?: string;
     /** 操作系统版本 */
-    system: string;
-    /** 平台 */
-    platform: Platform;
+    os_version?: string;
+    /** 状态栏高度（px），iOS 为 CSS 逻辑像素，Android 为物理像素 */
+    status_bar_height?: number;
+    /** WebView 类型：0 默认 H5，1 首页，App 4.1.0 起支持 */
+    webviewType?: number;
 }
-/** getNetworkType 返回值 */
-export interface NetworkTypeResult {
-    /** 网络类型 */
-    networkType: NetworkTypeStr;
+/**
+ * getSystemInfo 返回值：UA 的 App 基础信息，再加 H5 侧从 window 补充的字段。
+ *
+ * 浏览器里（不在 App 内）没有 UA 信息，只有 H5 侧补充的字段，所以 app_version 在这里是可选的。
+ */
+export interface SystemInfoResult extends Partial<AppBaseInfo> {
+    /** 设备像素比，H5 侧补充，UA 里没有 */
+    pixelRatio?: number;
+    /** 屏幕宽度（px），H5 侧补充，UA 里没有 */
+    screenWidth?: number;
+    /** 屏幕高度（px），H5 侧补充，UA 里没有 */
+    screenHeight?: number;
+    /** 可使用窗口宽度（px），H5 侧补充，UA 里没有 */
+    windowWidth?: number;
+    /** 可使用窗口高度（px），H5 侧补充，UA 里没有 */
+    windowHeight?: number;
 }
 /** checkPermission 返回值 */
 export interface CheckPermissionResult {
@@ -91,47 +118,73 @@ export interface CheckPermissionResult {
     /** 权限检查结果 */
     result: PermissionStatus;
 }
+/** openApp 返回值 */
+export interface OpenAppResult {
+    /** 处理结果：1 未安装，已触发下载；2 已打开 App */
+    type?: 1 | 2;
+}
+/** getBeforeInfo 返回值：上一个页面的埋点信息，字段由 Native 决定 */
+export type BeforeInfoResult = Record<string, unknown>;
+/** 页面显示/可见性事件回调，无 payload */
+export type PageEventCallback = () => void;
 /**
  * 键盘高度变化回调。
  *
- * 事件监听直接返回 CSS 逻辑像素高度，不包装 code/msg/result。
+ * @param height 键盘高度，单位为 CSS 逻辑像素，可直接用于页面布局
  */
 export type KeyboardHeightChangeCallback = (height: number) => void;
-/**
- * 评论区面板状态变化事件 payload。
- *
- * 事件监听直接返回该业务对象，不包装 code/msg/result。
- */
+/** 评论区面板状态变化事件的数据 */
 export interface CommentPanelChangeResult {
     /** 评论区面板是否可见 */
     visible: boolean;
     /** 评论区面板状态变化原因 */
     reason: string;
 }
-/** 评论区面板状态变化回调 */
+/**
+ * 评论区面板状态变化回调。
+ *
+ * @param res 评论区面板的状态
+ */
 export type CommentPanelChangeCallback = (res: CommentPanelChangeResult) => void;
-/** 用户基本信息 */
-export interface UserInfo {
-    /** 用户昵称 */
-    nickName?: string;
-    /** 头像 URL */
-    avatarUrl?: string;
-    /** 用户 ID */
-    userId?: string;
-    /** 性别 0:未知 1:男 2:女 */
-    gender?: number;
+/** startRecordAudio 的 onEnd 回调的数据 */
+export interface RecordAudioEndResult {
+    /** 录音文件的临时路径，如 mysFile://temp/xxxx，可用于 audio 播放，也可传给 uploadFiles 上传 */
+    tempFilePath: string;
+    /** 录音时长，单位秒 */
+    duration: number;
+    /** 文件大小，单位 KB */
+    size: number;
+    /** 录音文件格式，由宿主 App 决定，如 m4a */
+    fileType: string;
 }
+/** startRecordAudio 的 onProgress 回调的数据 */
+export interface RecordAudioProgressResult {
+    /** 当前音量，单位分贝 0-100 */
+    decibel: number;
+}
+/**
+ * 录音结束回调。
+ *
+ * @param res 录音文件信息
+ */
+export type RecordAudioEndCallback = (res: RecordAudioEndResult) => void;
+/**
+ * 录音音量回调。
+ *
+ * @param res 当前音量，不包含录音文件
+ */
+export type RecordAudioProgressCallback = (res: RecordAudioProgressResult) => void;
 /** login 返回值 */
 export interface LoginResult {
-    /** 授权码 */
-    readonly code: string;
-    /** 用户信息 */
-    readonly userInfo?: UserInfo;
+    /** 是否已登录；App 4.4.0 以下 Native 只保证登录动作被处理，该字段不一定返回 */
+    readonly isLogin?: boolean;
 }
 /** getToken 返回值 */
 export interface GetTokenResult {
-    /** 登录 Token */
+    /** 登录 Token，未登录时为空字符串 */
     readonly token: string;
+    /** 游客 Token */
+    readonly visitor_token?: string;
 }
 /** shareImage 返回值 */
 export interface ShareImageResult {
@@ -142,8 +195,100 @@ export interface ShareImageResult {
 export interface GetCircleInfoResult {
     /** 服务器 ID */
     readonly serverId: string;
-    /** 社群/圈子名称 */
-    readonly name: string;
-    /** 社群/圈子图标 URL */
-    readonly icon: string;
 }
+/** 投票选项 */
+export interface VoteItem {
+    /** 选项 ID */
+    vote_id?: string;
+    /** 选项内容，文字选项为文案，图片选项为图片地址 */
+    content?: string;
+    /** 选项名称 */
+    name?: string;
+    /** 1:文字 2:图片 */
+    content_type?: number;
+    /** 投票数量 */
+    count?: number;
+    /** 是否已投票 */
+    is_vote?: boolean;
+    /** 0:正常 1:已删除 */
+    status?: number;
+    /** 得票占比 */
+    percent?: number;
+}
+/** 投票数据，voteAction 的入参与返回值共用 */
+export interface VoteData {
+    /** 投票模式 1:单选 2:多选 */
+    vote_mode?: number;
+    /** 投票状态 1:未开始 2:进行中 3:已结束 */
+    vote_status?: number;
+    /** 用户参与投票数量 */
+    user_vote_count?: number;
+    /** 投票开始时间 */
+    start_time?: number;
+    /** 投票结束时间 */
+    end_time?: number;
+    /** 总票数 */
+    vote_total?: number;
+    /** 投票选项 */
+    votes?: VoteItem[];
+}
+/** 动态操作信息 */
+export interface DynamicHandle {
+    /** 操作类型：1 置顶/取消置顶，2 精华/取消精华，3 推流/取消推流，4 推荐/取消推荐，5 修改板块，6 评论权限，7 可见性，8 删除 */
+    type: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+    /** 操作附带数据，结构随 type 变化 */
+    data?: unknown;
+}
+/** onShared 事件 payload */
+export interface SharedResult {
+    /**
+     * 分享渠道：1 微信，2 朋友圈，3 QQ，4 QQ 空间，5 链接，6 好友，7 最近聊天，8 文字频道
+     */
+    shareChannel?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+    /** IM 群聊 ID，群聊时赋值 */
+    imGroupId?: string;
+    /** 分享对象用户 ID，私聊最近联系人时赋值 */
+    toUserId?: string;
+    /** 动态操作 */
+    dynamichandle?: DynamicHandle;
+}
+/** onAdFinished 事件 payload */
+export interface AdFinishedResult {
+    /** 广告模块 */
+    module: number;
+}
+/** openFriendsList 选中的好友 */
+export interface SelectedFriend {
+    /** 用户 ID */
+    uid: string;
+    /** 用户昵称 */
+    uname: string;
+    /** 用户头像地址 */
+    avatar: string;
+}
+/** openFriendsList 的业务数据 */
+export interface OpenFriendsListResult {
+    /** 选中的好友列表；用户取消或页面被关闭时为空数组 */
+    selectedList: SelectedFriend[];
+}
+/** getSharePictureUrl 处理函数返回值 */
+export interface SharePictureUrlResult {
+    /** 分享图片地址；截图或上传失败时不返回 */
+    pictureUrl?: string;
+}
+/**
+ * 分享完成回调。
+ *
+ * @param res Native 回传的分享信息，部分场景下 Native 不携带数据，此时为 undefined
+ */
+export type SharedCallback = (res?: SharedResult) => void;
+/**
+ * 广告播放完成回调。
+ *
+ * @param res 播放完成的广告信息
+ */
+export type AdFinishedCallback = (res: AdFinishedResult) => void;
+/** 提供分享图片地址的处理函数，返回 { pictureUrl }，可以返回 Promise */
+export type SharePictureUrlHandler = () => SharePictureUrlResult | Promise<SharePictureUrlResult>;
+/** 会员激活通知的处理函数，Native 通知 H5 会员已激活时调用，可以返回 Promise */
+export type MemberActivateHandler = () => void | Promise<void>;

package/dist/types/router.d.ts

@@ -0,0 +1,231 @@
+import { Callbacks } from './base';
+import { ActivityCenterTab, CircleRelationType, DiscoverSubTab, HomeTab, NavigatePage, ReportObjectType, TabBarType, WebviewExtType, WebviewType } from './enums';
+/**
+ * 页面跳转类 API 的公共回调：在 Callbacks 之上增加唤起 App 失败的通知。
+ *
+ * 这几个 API 在 App 外统一走 launch.ts 唤起，失败检测规则相同，回调只声明一份。
+ */
+export interface LaunchCallbacks extends Callbacks {
+    /** 不在 App 内时，唤起失败（超时仍停留在当前页，大概率未安装）的回调，用于业务侧引导下载 */
+    onLaunchFail?: () => void;
+}
+/** switchTab 参数 */
+export interface SwitchTabParams extends LaunchCallbacks {
+    /** 目标底部 tab */
+    tab: TabBarType;
+    /** 附加参数 */
+    params?: SwitchTabExtraParams;
+}
+/** switchTab 附加参数 */
+export interface SwitchTabExtraParams {
+    /** 发现页二级 tab，仅 tab 为 discover 时有效 */
+    subTab?: DiscoverSubTab;
+    /** 是否来自 MBTI 分享页 */
+    fromMbtiShare?: boolean;
+}
+/** openWebview 参数 */
+export interface OpenWebviewParams extends LaunchCallbacks {
+    /** 目标 URL */
+    url: string;
+    /**
+     * 容器类型，用外部浏览器打开请用 openInExternalBrowser。
+     *
+     * @default 'normal'
+     */
+    type?: WebviewType | WebviewExtType;
+    /** 附加参数 */
+    params?: OpenWebviewExtraParams;
+}
+/** openWebview 附加参数 */
+export interface OpenWebviewExtraParams {
+    /** 是否是升级 App 的链接（iOS 使用） */
+    isUpdateApp?: boolean;
+}
+/** 无参数页面 */
+export type EmptyPageParams = Record<string, never>;
+/** 动态详情 */
+export interface DynamicDetailPageParams {
+    /** 动态 ID */
+    dynamicId: string | number;
+    /** 定位到的评论 ID */
+    commentId?: string | number;
+}
+/** 动态话题 */
+export interface TopicPageParams {
+    /** 话题 ID */
+    topicId: string | number;
+}
+/** 点赞列表 */
+export interface LikeListPageParams {
+    /** 动态 ID */
+    dynamicId: string | number;
+    /** 发布类型 */
+    publishType: string | number;
+}
+/** 圈子主页 */
+export interface CircleHomePageParams {
+    /** 圈子（服务器）ID */
+    serverId: string | number;
+    /** 进入后执行的操作：publish 为发布动态 */
+    action?: "publish";
+    /** 关系操作 */
+    relationType?: CircleRelationType;
+    /** 图片链接 */
+    imageUrl?: string;
+}
+/** 查询圈子并加入 */
+export interface JoinCirclePageParams {
+    /** 圈子（服务器）ID */
+    serverId: string | number;
+    /** 邀请码 */
+    inviteCode: string;
+}
+/** 新版首页 */
+export interface HomePageParams {
+    /** 顶部 tab，不传则不指定 */
+    tab?: HomeTab;
+    /** 圈子（服务器）ID，不传则停留在当前首页圈子，App 4.4.0 起支持 */
+    serverId?: string | number;
+    /** 圈子频道 ID，App 4.4.0 起支持 */
+    channelId?: string | number;
+}
+/** 攻略一级分类 */
+export interface GuideCatalogPageParams {
+    /** 圈子（服务器）ID */
+    serverId: string | number;
+    /** 圈子频道 ID */
+    channelId: string | number;
+    /** 攻略分类 ID */
+    catalogId: string | number;
+}
+/** 游戏离线推送开关 */
+export interface GamePushSettingPageParams {
+    /** 圈子（服务器）ID */
+    serverId: string | number;
+}
+/** 用户主页 */
+export interface UserHomePageParams {
+    /** 用户 ID */
+    userId: string | number;
+    /** 礼物 ID，传入后会拉起送礼弹窗 */
+    giftId?: string | number;
+}
+/** 群聊 */
+export interface GroupChatPageParams {
+    /** 圈子（服务器）ID */
+    serverId: string | number;
+    /** 群 ID，例如 @TGS#_[circle_50311]5 */
+    groupId: string;
+    /** 群名称 */
+    groupName?: string;
+}
+/** 查询小群并加入 */
+export interface JoinGroupPageParams {
+    /** 邀请码 */
+    inviteCode: string;
+}
+/** 私聊 */
+export interface PrivateChatPageParams {
+    /** 对方用户 ID */
+    userId: string | number;
+    /** 对方昵称 */
+    nickName: string;
+}
+/** 活动中心 */
+export interface ActivityCenterPageParams {
+    /** 默认选中的 tab */
+    tab?: ActivityCenterTab;
+}
+/** 广告 SDK 页面 */
+export interface AdPageParams {
+    /** 广告页地址 */
+    url: string;
+}
+/** 绑定游戏角色 */
+export interface BindGamePageParams {
+    /** 圈子（服务器）ID */
+    serverId: string | number;
+    /** 游戏名称 */
+    gameName: string;
+}
+/** 玩家举报 */
+export interface PlayerReportPageParams {
+    /** 被举报对象的 ID，随 objectType 变化：用户 ID、评论 ID、动态 ID 等 */
+    objectId: string | number;
+    /** 被举报对象的类型 */
+    objectType: ReportObjectType;
+    /** 会话 ID，举报会话时需要 */
+    conversationId?: string | number;
+    /** 服务器 ID，举报服务器时需要 */
+    serverId?: string | number;
+}
+/** navigateTo 各页面对应的 params，页面名与 enums.ts 的 NavigatePage 一一对应 */
+export interface NavigatePageParamsMap {
+    dynamicDetailPage: DynamicDetailPageParams;
+    topicPage: TopicPageParams;
+    likeListPage: LikeListPageParams;
+    circleHomePage: CircleHomePageParams;
+    joinCirclePage: JoinCirclePageParams;
+    homePage: HomePageParams;
+    guideCatalogPage: GuideCatalogPageParams;
+    gamePushSettingPage: GamePushSettingPageParams;
+    userHomePage: UserHomePageParams;
+    groupChatPage: GroupChatPageParams;
+    joinGroupPage: JoinGroupPageParams;
+    privateChatPage: PrivateChatPageParams;
+    myPublishPage: EmptyPageParams;
+    myFavoritePage: EmptyPageParams;
+    browseHistoryPage: EmptyPageParams;
+    profileEditPage: EmptyPageParams;
+    coinRechargePage: EmptyPageParams;
+    gameSubscribePage: EmptyPageParams;
+    douyinMallPage: EmptyPageParams;
+    activityCenterPage: ActivityCenterPageParams;
+    adPage: AdPageParams;
+    coinDetailPage: EmptyPageParams;
+    miniGamesPage: EmptyPageParams;
+    bindGamePage: BindGamePageParams;
+    playerReportPage: PlayerReportPageParams;
+    addCustomEmojiPage: EmptyPageParams;
+}
+/** 有必填字段的页面必须传 params，其余页面 params 可省略 */
+type PageParamsField<K extends NavigatePage> = {} extends NavigatePageParamsMap[K] ? {
+    params?: NavigatePageParamsMap[K];
+} : {
+    params: NavigatePageParamsMap[K];
+};
+/** navigateTo 按页面跳转的参数，type 决定 params 的结构 */
+export type NavigateToPageParams<K extends NavigatePage = NavigatePage> = K extends NavigatePage ? LaunchCallbacks & {
+    type: K;
+} & PageParamsField<K> : never;
+/** navigateTo 按 daoke:// 链接跳转的参数，用于服务端下发的存量链接 */
+export interface NavigateToUrlParams extends LaunchCallbacks {
+    /** daoke://page?type=... 链接 */
+    url: string;
+}
+/** navigateTo 参数 */
+export type NavigateToParams = NavigateToPageParams | NavigateToUrlParams;
+/** openScheme 参数 */
+export interface OpenSchemeParams extends LaunchCallbacks {
+    /** daoke://page?type=... 链接，与服务端下发的存量链接格式一致，原样处理 */
+    url: string;
+    /** 额外的结构化数据，随链接一起交给 Native。App 4.4.0 以下不支持，会被忽略 */
+    params?: Record<string, unknown>;
+}
+/** openInExternalBrowser 参数 */
+export interface OpenInExternalBrowserParams extends Callbacks {
+    /** 要在外部浏览器打开的地址，http(s) 链接或 weixin:// 等 scheme 均可 */
+    url: string;
+}
+/** 一次跳转调用，仅 SDK 内部使用 */
+export type NavigationCall = {
+    api: "navigateTo";
+    params: NavigateToParams;
+} | {
+    api: "switchTab";
+    params: SwitchTabParams;
+} | {
+    api: "openWebview";
+    params: OpenWebviewParams;
+};
+export {};

package/dist/utils/app.d.ts

@@ -0,0 +1,30 @@
+import { AppBaseInfo, SystemInfoResult } from '../types';
+/**
+ * 获取 App 基础信息（UA 中的 webBaseInfo），不在 App 内（或解析失败）返回 null。
+ * 结果会缓存，页面生命周期内只解析一次。
+ */
+export declare function getAppBaseInfo(): AppBaseInfo | null;
+/** 是否在 App 的 WebView 内。 */
+export declare function isInApp(): boolean;
+/** 当前 App 版本低于 since（compareVersions 返回 -1 表示 since 更大），不判断是否在 App 内 */
+export declare function isAppVersionBelow(since?: string): boolean;
+/** 设备像素比，非浏览器环境（SSR）按 1 处理 */
+export declare function getDevicePixelRatio(): number;
+/**
+ * 版本号对比，语义与业务侧 compareVersions 一致。
+ * targetVersion 不传时使用当前 App 版本。
+ * - sourceVersion > targetVersion 返回 -1
+ * - sourceVersion = targetVersion 返回 0
+ * - sourceVersion < targetVersion 返回 1
+ */
+export declare function compareVersions(sourceVersion: string, targetVersion?: string): -1 | 0 | 1;
+/** 设备平台，判断规则与业务侧 device.ts 一致（Linux 也算 Android） */
+export declare function getPlatform(): 'ios' | 'android' | 'unknown';
+/** 是否被 web 版社区以 iframe 内嵌，依赖 community 壳在 iframe 上声明的 name */
+export declare function isInWebCommunity(): boolean;
+/**
+ * 4.4.0 以下旧 Native 没有 getSystemInfo，用 UA 里的 webBaseInfo 合成，字段名和取值保持 UA 原样。
+ * 屏幕、窗口和像素比 UA 里没有，从 window 补上。
+ * 状态栏高度保持 UA 原值，不做单位换算：iOS 上报的是 CSS 逻辑像素，Android 上报的是物理像素。
+ */
+export declare function collectSystemInfo(): SystemInfoResult;

package/dist/utils/data.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 数据处理工具：类型判断、容错解析、错误原因提取，以及发往 Native 前的数据规整。
+ * 原生已有的（Array.isArray、Number.isFinite、Number.isInteger）不再包装；仅 SDK 内部使用，不从 index.ts 导出。
+ *
+ * 规整的背景：iOS 的 postMessage 对消息体做结构化克隆，Vue 响应式 Proxy 无法克隆（抛 DataCloneError），
+ * 而 Android 先 JSON.stringify，同一份响应式参数就会 iOS 收不到、Android 正常。
+ * 因此在 SDK 出口统一做一次 JSON 往返：Android 本就是这个语义，iOS 对齐到同一语义。
+ *
+ * @module utils/data
+ */
+export declare function isString(value: unknown): value is string;
+/** NaN 也是 number，需要有限数用 Number.isFinite */
+export declare function isNumber(value: unknown): value is number;
+/** 非 null 的对象，数组、Error 实例等都算。类型收窄为 Record 是为了方便读属性 */
+export declare function isObjectLike(value: unknown): value is Record<string, unknown>;
+/** 纯对象：字面量、JSON.parse 的结果、Object.create(null)、Vue 响应式 Proxy；数组、Error、class 实例不算 */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** App 版本号：x.y.z 或 x.y.z.w（Native 真实上报含构建号，如 4.4.0.452） */
+export declare function isVersion(value: unknown): value is string;
+/** 图片的 base64 数据：data URL 或纯 base64；网络地址、本地路径不算 */
+export declare function isBase64Source(value: unknown): value is string;
+/** JSON.parse 遇到非法文本会抛错，这里返回 fallback（默认 null） */
+export declare function safeParse(text: string, fallback?: unknown): unknown;
+/** decodeURIComponent 遇到非法编码会抛错，这里原样返回 */
+export declare function safeDecode(value: string): string;
+/**
+ * 从任意错误值里取一句可读的原因：字符串原样，Error 取 message，对象取 errMsg / msg / message。
+ *
+ * 两个通道的失败都要转成 errMsg，只此一份实现，避免同一类失败在两个通道上说法不同。
+ */
+export declare function getErrorReason(err: unknown): string;
+/** 规整失败时抛出，带上字段名，由调用方转成参数错误 */
+export declare class PlainDataError extends Error {
+}
+/**
+ * 把参数规整成纯 JSON 数据（去掉 Proxy、函数、undefined、symbol）。
+ * 循环引用、BigInt、Map、Set、二进制数据会抛 PlainDataError。
+ */
+export declare function toPlainData(data: unknown): unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docoi/mys-sdk",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "基于 JSBridge 封装的H5 SDK，统一 Native 通信与业务 API 封装",
   "author": "tanyangkang",
   "license": "MIT",
@@ -28,18 +28,18 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
   "dependencies": {
-    "@docoi/jsbridge-sdk": "2.0.2"
+    "@docoi/jsbridge-sdk": "2.0.3"
   },
   "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"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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.