qsh-webview-sdk 2.3.6 → 2.3.7

package/dist/index.d.ts

@@ -228,36 +228,49 @@ declare namespace UniWebView {
     type: "weixin" | "plus" | "nvue" | "uvue" | "UniApp" | "webview" | "h5" | "offline";
   }
 
-  /** 定向分享：去向 */
+  /** 定向分享：去向。chat=聊天框，timeline=朋友圈 */
   type ShareUniversalScene = "chat" | "timeline";
 
-  /** 各 kind 对应的 payload（按需传字段） */
+  /**
+   * 图文分享参数。
+   * - 微信小程序环境：target 必须是 /pages/... 页面路径
+   * - App 环境：优先使用 target；若 target 不合法，再使用 webTarget 兜底
+   */
   interface ShareUniversalPayloadWeb {
     title: string;
     description: string;
     imageUrl: string;
-    /** 分享点击后进入的最终业务页面路径 */
-    targetPath: string;
-    /** App 微信图文卡片点击使用的公网链接 */
-    shareLink: string;
+    /** 当前环境下的主目标：小程序传 /pages/...；App 传 https://... */
+    target: string;
+    /** 仅 App 环境使用：当 target 不存在或不合法时，使用该公网链接兜底 */
+    webTarget?: string;
   }
 
+  /**
+   * 文字分享参数。
+   * - App 环境下会自动降级为图文分享
+   * - target / webTarget 的校验规则与图文分享一致
+   */
   interface ShareUniversalPayloadText {
     title?: string;
     description: string;
     imageUrl?: string;
-    /** 分享点击后进入的最终业务页面路径 */
-    targetPath: string;
-    /** App 微信图文卡片点击使用的公网链接 */
-    shareLink: string;
+    /** 当前环境下的主目标：小程序传 /pages/...；App 传 https://... */
+    target: string;
+    /** 仅 App 环境使用：当 target 不存在或不合法时，使用该公网链接兜底 */
+    webTarget?: string;
   }
 
+  /**
+   * 图片分享参数。
+   * - target / webTarget 的校验规则与图文分享一致
+   */
   interface ShareUniversalPayloadImage {
     imageUrl: string;
-    /** 分享点击后进入的最终业务页面路径 */
-    targetPath: string;
-    /** App 微信图文卡片点击使用的公网链接 */
-    shareLink: string;
+    /** 当前环境下的主目标：小程序传 /pages/...；App 传 https://... */
+    target: string;
+    /** 仅 App 环境使用：当 target 不存在或不合法时，使用该公网链接兜底 */
+    webTarget?: string;
     title?: string;
   }
 
@@ -279,7 +292,11 @@ declare namespace UniWebView {
     [key: string]: any;
   }
 
-  /** 定向分享模块参数（仅 H5 嵌入宿主 WebView 场景） */
+  /**
+   * 定向分享模块参数（仅 H5 嵌入宿主 WebView 场景）。
+   * - 微信小程序环境：只校验 payload.target，且必须是 /pages/...
+   * - App 环境：优先校验 payload.target 是否为公网链接；若不合法，再校验 payload.webTarget
+   */
   interface ShareDirectedOptions {
     kind: "web" | "text" | "image";
     scene?: 0 | 1 | ShareUniversalScene;
@@ -289,6 +306,11 @@ declare namespace UniWebView {
     complete?: () => void;
   }
 
+  /**
+   * 小程序卡片分享参数。
+   * - targetPath 始终表示小程序落地页路径
+   * - webUrl 只在 App 环境下参与校验和配参，小程序环境不会使用该字段决定落地页
+   */
   interface ShareMiniProgramCardPayload {
     title: string;
     imageUrl: string;
@@ -298,12 +320,10 @@ declare namespace UniWebView {
     appid: string;
     /** 小程序环境版本 */
     envVersion?: "release" | "trial" | "develop";
-    /** 兜底网页链接，供 App 微信通道必要时使用 */
-    fallbackWebUrl?: string;
+    /** App 环境分享时使用的网页兜底链接，必须是公网 https/http 链接 */
+    webUrl?: string;
     /** 小程序卡片描述 */
     description?: string;
-    /** 预留：若宿主 App 通道需要，也可传 shareLink */
-    shareLink?: string;
   }
 
   interface ShareMiniProgramCardOptions {
@@ -520,21 +540,5 @@ declare namespace UniWebView {
  * 全局 qsh/uni 对象（默认导出为模块默认值）
  */
 declare const qsh: UniWebView.Uni;
-declare const uni: UniWebView.Uni;
-
-/**
- * 模块导出
- */
 export default qsh;
-
-/**
- * 全局声明
- */
-declare global {
-  interface Window {
-    qsh: UniWebView.Uni;
-    UniAppJSBridge?: boolean;
-  }
-}
-
 export as namespace qsh;