@hlw-uni/mp-vue 2.1.52 → 2.1.55

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hlw-uni/mp-vue",
-    "version": "2.1.52",
+    "version": "2.1.55",
     "description": "hlw-uni 小程序运行时 — Vue 组件 + composables + theme + http + 工具集（合并自原 mp-core）",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -32,6 +32,7 @@
     },
     "devDependencies": {
         "@dcloudio/types": "^3.4.30",
+        "@dcloudio/uni-app": "3.0.0-5000720260410001",
         "@types/md5": "^2.3.6",
         "@types/node": "^20.19.39",
         "@vitejs/plugin-vue": "^5.2.4",

package/src/app.ts

@@ -1,34 +1,12 @@
 /**
  * useApp - 应用根上下文
- * 生命周期、Pinia、拦截器、hlw 注入全部收敛在此。
+ * 生命周期、Pinia、hlw 注入收敛在此。
  */
 import { createSSRApp, type App, type Component } from 'vue';
 import { hlw } from '@/hlw';
-import { http } from '@/composables/http';
-import { useDevice } from '@/composables/device';
-import md5 from 'md5';
-import type { ApiResponse, RequestConfig } from '@/composables/http/types';
+import { useRequest } from '@/composables/request';
 
 let _installed = false;
-let _interceptorCleanup: Array<() => void> = [];
-
-export interface InterceptorOptions {
-    /** API 基础地址 */
-    baseURL?: string;
-    /** 自动注入 Token 的 header 键名 */
-    tokenHeader?: string;
-    /** Token 来源函数 */
-    getToken?: () => string;
-    /** 登录失效时的处理函数 */
-    onLogout?: () => void;
-    /** 接口业务错误码是否自动 toast */
-    autoToastError?: boolean;
-}
-
-const _defaultOpts: InterceptorOptions = {
-    tokenHeader: 'x-token',
-    autoToastError: true,
-};
 
 /**
  * 创建 uni-app 应用入口工具。
@@ -66,123 +44,5 @@ export function useApp() {
         return createApp;
     }
 
-    return { install, use, hlw, http };
-}
-
-/**
- * 提取 URL 中的 query 参数，排序后拼接为签名字符串。
- */
-function buildSignString(url: string): string {
-    try {
-        const [path, query] = url.split('?');
-        if (!query) return path + '&';
-        const params = query.split('&').filter(Boolean);
-        params.sort();
-        return params.join('&') + '&';
-    } catch {
-        return url;
-    }
-}
-
-/** sig 签名密钥。 */
-let _sigSecret = '';
-
-/**
- * 注册默认请求、响应和错误拦截器。
- */
-export function setupInterceptors(options: InterceptorOptions & { sigSecret?: string } = {}) {
-    const opts = { ..._defaultOpts, ...options };
-    if (opts.sigSecret) _sigSecret = opts.sigSecret;
-    if (opts.baseURL) http.setBaseURL(opts.baseURL);
-
-    _interceptorCleanup.forEach((dispose) => dispose());
-    _interceptorCleanup = [];
-
-    /**
-     * 请求拦截：注入设备信息、签名和 token。
-     */
-    const offRequest = http.onRequest((config: RequestConfig) => {
-        // GET 请求：把 cfg.data 合并到 url query，并清空 cfg.data。
-        // 否则 uni.request 会在 sig 之后再把 data 自动拼到 URL，导致后端 raw query
-        // 多了未参与签名的字段（如 id/cate_id），sig 校验必然失败。
-        const method = (config.method ?? 'GET').toUpperCase();
-        if (method === 'GET' && config.data && typeof config.data === 'object') {
-            const qs = Object.entries(config.data as Record<string, unknown>)
-                .filter(([, v]) => v !== undefined && v !== null)
-                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
-                .join('&');
-            if (qs) {
-                config.url = config.url + (config.url.includes('?') ? '&' : '?') + qs;
-            }
-            config.data = undefined;
-        }
-
-        const device = useDevice();
-        if (device.value) {
-            const d = device.value;
-            const query = [
-                ['appid', d.appid],
-                ['device_brand', d.device_brand],
-                ['device_model', d.device_model],
-                ['device_id', d.device_id],
-                ['device_type', d.device_type],
-                ['device_orientation', d.device_orientation],
-                ['platform', d.platform],
-                ['system', d.system],
-                ['os', d.os],
-                ['version', d.version],
-                ['sdk_version', d.sdk_version],
-                ['host_name', d.host_name],
-                ['host_version', d.host_version],
-                ['host_language', d.host_language],
-                ['language', d.language],
-                ['app_version', d.app_version],
-                ['app_version_code', d.app_version_code],
-                ['screen_width', String(d.screen_width)],
-                ['screen_height', String(d.screen_height)],
-            ]
-                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v ?? '')}`)
-                .join('&');
-            config.url = config.url + (config.url.includes('?') ? '&' : '?') + query;
-            config.headers = { ...config.headers, 'X-Appid': d.appid };
-        }
-
-        if (_sigSecret) {
-            const signStr = buildSignString(config.url);
-            const sig = md5(signStr + _sigSecret);
-            config.url = config.url + '&sig=' + sig;
-        }
-
-        if (opts.getToken) {
-            const token = opts.getToken();
-            if (token) {
-                config.headers = {
-                    ...config.headers,
-                    [opts.tokenHeader!]: token,
-                };
-            }
-        }
-        return config;
-    });
-
-    /**
-     * 响应拦截：处理业务错误提示。
-     */
-    const offResponse = http.onResponse((res: ApiResponse<unknown>) => {
-        if (opts.autoToastError && res.code !== 1) {
-            uni.showToast({ title: res.info || '请求失败', icon: 'none' });
-        }
-        return res;
-    });
-
-    /**
-     * 错误拦截：处理未授权场景。
-     */
-    const offError = http.onError((err: Error) => {
-        if (err.message.includes('401')) {
-            opts.onLogout?.();
-        }
-    });
-
-    _interceptorCleanup = [offRequest, offResponse, offError];
+    return { install, use, hlw, request: useRequest() };
 }

package/src/components/hlw-ad/index.vue

@@ -1,7 +1,7 @@
 <!--
     HlwAd — 小程序展示型广告原子组件
     ------------------------------------------------------------------
-    用法（业务方从 mp-core useAd().config 取对应 unit_id 传入）：
+    用法（业务方从自己的接口配置取对应 unit_id 传入）：
         hlw-ad type="banner" :unit-id="config.banner_unit_id"
         hlw-ad type="grid"   :unit-id="config.grid_unit_id"
         hlw-ad type="custom" :unit-id="config.custom_unit_id"
@@ -11,7 +11,7 @@
       - grid / custom → ad-custom unit-id="..."（原生模板广告）
 
     video / reward / popup 不走这个组件：
-      - reward / popup → useAd().showReward() / showPopup()
+      - reward / popup → 业务方自行调用小程序广告 API
       - video（贴片）须嵌在 video 标签内，业务侧自己用 <ad type="video">
 -->
 <template>
@@ -81,12 +81,13 @@ function onError(event: any) {
     background: var(--surface-card, #ffffff);
 }
 
-/* 格子广告：默认右下悬浮；微信硬性规则要求 wrapper 透明无圆角，customStyle 可覆盖 */
+/* 格子广告：默认右侧居中悬浮；微信硬性规则要求 wrapper 透明无圆角，customStyle 可覆盖 */
 .hlw-ad--grid {
     position: fixed;
-    right: 20rpx;
-    bottom: 200rpx;
+    top: 50%;
+    right: 0;
     z-index: 99;
+    transform: translateY(-50%);
     border-radius: 0;
     overflow: visible;
     background: transparent;

package/src/components/hlw-page/index.vue

@@ -35,7 +35,7 @@
 <script setup lang="ts">
 /**
  * hlw-page 不再负责主题 style 注入。
- * 业务页面请在 template 顶部放 `<page-meta :page-style="themePageStyle" />`（配合 useThemePageStyle）
+ * 业务项目可通过 @hlw-uni/mp-vite-plugin 的 themePageMeta 自动注入 page-meta。
  * —— 这样才能把 CSS 变量注入到 page 根，scroll-view 等小程序原生组件内部也能继承。
  *
  * provide("hlwPageScroll") —— 给 hlw-back-top 等子组件用：

package/src/composables/ad/README.md

@@ -0,0 +1,58 @@
+# ad 调用文档
+
+`useHlwAd` 封装微信小程序插屏广告和激励视频广告。仅在存在 `wx` 且对应广告 API 可用时生效。
+
+## 引入
+
+```ts
+import { useHlwAd } from "@hlw-uni/mp-vue";
+```
+
+## 插屏广告
+
+```ts
+const ad = useHlwAd();
+
+ad.setAdPopup("adunit-popup-id", (ok) => {
+    console.log("插屏广告关闭", ok);
+});
+
+await ad.showAdPopup(1000);
+```
+
+## 激励视频
+
+```ts
+const ad = useHlwAd();
+
+ad.setAdReward("adunit-reward-id", (res) => {
+    if (res.ok) {
+        // 用户完整看完激励视频
+    }
+});
+
+const result = await ad.showAdReward();
+
+if (result.ok) {
+    // 发放奖励
+}
+```
+
+## API
+
+| 方法 | 说明 |
+| --- | --- |
+| `setAdPopup(adId, done?)` | 创建插屏广告实例 |
+| `showAdPopup(delay?)` | 延迟展示插屏广告，默认 3000ms |
+| `setAdReward(adId, done?)` | 创建激励视频实例 |
+| `showAdReward()` | 展示激励视频，失败时会尝试 load 后再 show |
+
+## 类型
+
+```ts
+interface AdRes {
+    ok: boolean;
+    isEnded?: boolean;
+    err?: unknown;
+}
+```