@zfqh/uniapp-x 0.0.7 → 0.0.9

package/README.md

@@ -58,4 +58,3 @@ onAppShow((options) => handleShow(options)); // 经典 uni-app 使用 onShow
 
 - 开发约定、完整 API、平台差异与验证：[AGENTS.md](AGENTS.md)
 - 示例工程：`examples/uniapp-vapor`（蒸汽模式）、`examples/uniapp-nvue`（经典 Vue3 nvue）
-- 变更记录：[CHANGELOG.md](CHANGELOG.md)

package/lib/apis/core.d.ts

@@ -1,11 +1,5 @@
-/** 发送短信验证码 */
-export declare const sendSmsCode: (...args: any[]) => any;
-/** 获取腾讯上传临时Token */
-export declare const getTencentToken: (...args: any[]) => any;
 /** 获取最新版本 */
 export declare const getLastVersion: (...args: any[]) => any;
-/** 获取cos签名后的地址 */
-export declare const getCosUrls: (...args: any[]) => any;
 /** 刷新token */
 export declare const postRefreshToken: (...args: any[]) => any;
 /** 获取字典数据 */

package/lib/apis/core.js

@@ -1,12 +1,6 @@
 import { GET, POST } from './request';
-/** 发送短信验证码 */
-export const sendSmsCode = (...args) => POST('/admin-api/system/auth/send-checkCode', ...args);
-/** 获取腾讯上传临时Token */
-export const getTencentToken = (...args) => GET('/app-api/infra/file/getTencentToken', ...args);
 /** 获取最新版本 */
 export const getLastVersion = (...args) => POST('/app-api/system/app/version/get-last-version-v2', ...args);
-/** 获取cos签名后的地址 */
-export const getCosUrls = (...args) => POST('/app-api/infra/cos/getUrls', ...args);
 /** 刷新token */
 export const postRefreshToken = (...args) => POST('/app-api/robot/store/auth/refreshToken?refreshToken=:refreshToken', ...args);
 /** 获取字典数据 */

package/lib/configs/upload.d.ts

@@ -22,9 +22,9 @@ type UploadParams = {
 };
 /** 上传配置 */
 export type UploadConfig = {
-    /** 上传请求，例如获取Token */
+    /** 上传请求（获取临时凭证等），需由业务通过 defineConfig({ upload: { request } }) 配置 */
     request: (params?: UploadParams) => Promise<UploadResponceData>;
 };
-/** 上传配置 */
+/** 上传配置：内置凭证接口已移除，未配置时调用会抛错 */
 declare const Upload: UploadConfig;
 export default Upload;

package/lib/configs/upload.js

@@ -1,19 +1,7 @@
-import { getTencentToken } from '../apis/core';
-import cdn from './cdn';
-/** 上传配置 */
+/** 上传配置：内置凭证接口已移除，未配置时调用会抛错 */
 const Upload = {
-    /** 上传请求，默认调用 getTencentToken 获取腾讯云临时密钥 */
     request: async () => {
-        const { data } = await getTencentToken();
-        return {
-            secret_id: data.tmpSecretId,
-            secret_key: data.tmpSecretKey,
-            session_token: data.sessionToken,
-            create_time: data.createTime,
-            expire_time: data.expirationTime,
-            bucket: data.bucket,
-            region: cdn.isAccelerate ? 'accelerate' : data.region,
-        };
+        throw new Error('未配置上传凭证请求：请通过 defineConfig({ upload: { request } }) 配置 upload.request');
     },
 };
 export default Upload;

package/lib/utils/cos.d.ts

@@ -3,7 +3,7 @@ export declare function checkRefreshToken(): Promise<boolean>;
 export interface UploadFileOptions {
     key?: string;
     path?: string;
-    /** 获取上传任务实例，可用于 task.abort() 取消上传；token 过期重试时会再次回调 */
+    /** 获取上传任务实例，可用于 task.abort() 取消上传；H5 宿主 webview 走 plus.uploader 时为含 abort / onProgressUpdate / offProgressUpdate 的适配对象；token 过期重试时会再次回调 */
     getTask?: ((task: UniNamespace.UploadTask) => void) | ((task: any) => void);
 }
 export declare function uploadFile(file: any, opts?: UploadFileOptions): Promise<{

package/lib/utils/cos.js

@@ -1,6 +1,7 @@
 import { Base64, Hex, HmacSHA1, SHA1, Utf8 } from 'crypto-es';
 import { guid, timeFormat } from '@zfqh/uview-x/utils/function';
 import upload from '../configs/upload';
+import { IS_WEBVIEW_ENV } from './consts';
 import { cosCompress } from './index';
 const data = {};
 let promise = null;
@@ -18,81 +19,196 @@ export async function checkRefreshToken() {
     }
     return promise;
 }
+/**
+ * 是否使用 HTML5+ Uploader：
+ * H5 页面被宿主 web-view 嵌入（IS_WEBVIEW_ENV）、plus.uploader 可用，且存在文件路径。
+ */
+function canUsePlusUploader(filePath) {
+    let available = false;
+    // #ifdef WEB || H5
+    available =
+        IS_WEBVIEW_ENV && typeof filePath === 'string' && !!filePath && typeof plus !== 'undefined' && !!plus.uploader;
+    // #endif
+    return available;
+}
 class COS {
+    /** 生成 COS 上传签名表单 */
+    getFormData(Bucket, Key) {
+        const now = data.create_time || Math.round(Date.now() / 1000);
+        const exp = now + 1800; // 30分钟过期
+        const qKeyTime = now + ';' + exp;
+        const qSignAlgorithm = 'sha1';
+        const qAk = data.secret_id;
+        const policyData = {
+            expiration: new Date(exp * 1000).toISOString(),
+            conditions: [
+                { 'q-sign-algorithm': qSignAlgorithm },
+                { 'q-ak': qAk },
+                { 'q-sign-time': qKeyTime },
+                { bucket: Bucket },
+                { key: Key },
+            ],
+        };
+        const policy = JSON.stringify(policyData);
+        const signKey = HmacSHA1(qKeyTime, data.secret_key).toString(Hex);
+        const stringToSign = SHA1(policy).toString(Hex);
+        const qSignature = HmacSHA1(stringToSign, signKey).toString(Hex);
+        return {
+            key: Key,
+            policy: Base64.stringify(Utf8.parse(policy)),
+            success_action_status: 200,
+            'x-cos-security-token': data.session_token,
+            'q-sign-algorithm': qSignAlgorithm,
+            'q-ak': qAk,
+            'q-key-time': qKeyTime,
+            'q-signature': qSignature,
+        };
+    }
+    /**
+     * 统一上传入口：内部按运行环境选择 plus.uploader 或 uni.uploadFile，
+     * 两条链路的 success / fail / getTask 回调形态一致。
+     */
+    uploadHandler(options) {
+        const { url, filePath, file, name = 'file', formData = {}, getTask, success, fail } = options;
+        // 链路 1：H5 宿主 webview + plus.uploader + 文件路径（canUsePlusUploader 内部判断，命中后不再走 uni.uploadFile）
+        // #ifdef WEB || H5
+        if (canUsePlusUploader(filePath)) {
+            let plusTask;
+            let settled = false;
+            const progressCallbacks = new Set();
+            const plusSuccess = (res) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                success?.(res);
+            };
+            const plusFail = (err) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                fail?.(err);
+            };
+            try {
+                plusTask = plus.uploader.createUpload(url, { method: 'POST' }, (upload, status) => {
+                    const statusCode = Number(status) || 0;
+                    if (statusCode > 0) {
+                        plusSuccess({ statusCode, data: String(upload.responseText || '') });
+                    }
+                    else {
+                        // 网络失败，未取得 HTTP 状态码
+                        plusFail({ errMsg: 'uploadFile:fail' });
+                    }
+                });
+                plusTask.addEventListener('statechanged', (upload) => {
+                    const total = Number(upload.totalSize) || 0;
+                    const sent = Number(upload.uploadedSize) || 0;
+                    const progress = total > 0 ? Math.round((sent / total) * 100) : 0;
+                    progressCallbacks.forEach((cb) => cb({ progress, totalBytesSent: sent, totalBytesExpectedToSend: total }));
+                });
+                Object.keys(formData).forEach((key) => {
+                    const value = formData[key];
+                    if (value !== undefined && value !== null) {
+                        plusTask.addData(key, String(value));
+                    }
+                });
+                if (plusTask.addFile(filePath, { key: name })) {
+                    const taskLike = {
+                        abort: () => {
+                            if (settled) {
+                                return;
+                            }
+                            settled = true;
+                            plusTask.abort();
+                            fail?.({ errMsg: 'uploadFile:fail abort' });
+                        },
+                        onProgressUpdate: (cb) => {
+                            progressCallbacks.add(cb);
+                        },
+                        offProgressUpdate: (cb) => {
+                            progressCallbacks.delete(cb);
+                        },
+                    };
+                    getTask?.(taskLike);
+                    plusTask.start();
+                    return;
+                }
+                // 已确定走 plus 链路：路径无法被 HTML5+ 读取（如 blob/content）时直接失败，不再回退 uni.uploadFile
+                plusFail({ errMsg: 'uploadFile:fail' });
+                plusTask.abort();
+            }
+            catch (e) {
+                plusFail({ errMsg: 'uploadFile:fail' });
+                plusTask?.abort();
+            }
+            return;
+        }
+        // #endif
+        // 链路 2：uni.uploadFile（默认链路）
+        const task = uni.uploadFile({
+            url,
+            filePath,
+            file,
+            name,
+            formData,
+            success: (res) => {
+                success?.({ statusCode: res.statusCode, data: String(res.data ?? '') });
+            },
+            fail: (err) => {
+                fail?.(err);
+            },
+        });
+        getTask?.(task);
+    }
+    /** 处理上传结果：成功 / token 过期重试 / 失败 */
+    handleUploadResult(params, cosHost, statusCode, body, resolve, reject) {
+        if (statusCode === 200) {
+            resolve({ Location: `${cosHost}/${params.Key}` });
+            return;
+        }
+        const resBody = String(body || '');
+        const codeMatch = resBody.match(/<Code>([^<>]+)<\/Code>/);
+        if (codeMatch && codeMatch[1] === 'ExpiredToken' && data.expire_time !== 0) {
+            data.expire_time = 0;
+            checkRefreshToken()
+                .then(() => {
+                this.uploadFile(params)
+                    .then((e) => {
+                    resolve(e);
+                })
+                    .catch((e) => {
+                    reject(e);
+                });
+            })
+                .catch((e) => {
+                reject(e);
+            });
+            return;
+        }
+        const err = {
+            code: statusCode,
+            msg: 'Upload Fail',
+        };
+        const msgMatch = resBody.match(/<Message>([^<>]+)<\/Message>/);
+        if (msgMatch) {
+            err.msg = msgMatch[1];
+        }
+        reject(err);
+    }
     async uploadFile(params) {
         const { Bucket, Region, Key, FilePath, File } = params;
+        const cosHost = `${Bucket}.cos.${Region}.myqcloud.com`;
         return new Promise((resolve, reject) => {
-            const cosHost = `${Bucket}.cos.${Region}.myqcloud.com`;
-            const now = data.create_time || Math.round(Date.now() / 1000);
-            const exp = now + 1800; // 30分钟过期
-            const qKeyTime = now + ';' + exp;
-            const qSignAlgorithm = 'sha1';
-            const qAk = data.secret_id;
-            const policyData = {
-                expiration: new Date(exp * 1000).toISOString(),
-                conditions: [
-                    { 'q-sign-algorithm': qSignAlgorithm },
-                    { 'q-ak': qAk },
-                    { 'q-sign-time': qKeyTime },
-                    { bucket: Bucket },
-                    { key: Key },
-                ],
-            };
-            const policy = JSON.stringify(policyData);
-            const signKey = HmacSHA1(qKeyTime, data.secret_key).toString(Hex);
-            const stringToSign = SHA1(policy).toString(Hex);
-            const qSignature = HmacSHA1(stringToSign, signKey).toString(Hex);
-            const FormData = {
-                key: Key,
-                policy: Base64.stringify(Utf8.parse(policy)),
-                success_action_status: 200,
-                'x-cos-security-token': data.session_token,
-                'q-sign-algorithm': qSignAlgorithm,
-                'q-ak': qAk,
-                'q-key-time': qKeyTime,
-                'q-signature': qSignature,
-            };
-            const task = uni.uploadFile({
+            this.uploadHandler({
                 url: `https://${cosHost}`,
                 filePath: FilePath,
                 file: File,
                 name: 'file',
-                formData: FormData,
+                formData: this.getFormData(Bucket, Key),
+                getTask: params.getTask,
                 success: (res) => {
-                    if (res.statusCode === 200) {
-                        resolve({ Location: `${cosHost}/${Key}` });
-                    }
-                    else {
-                        const { data: e, statusCode } = res;
-                        const codeMatch = e.match(/<Code>([^<>]+)<\/Code>/);
-                        if (codeMatch && codeMatch[1] === 'ExpiredToken' && data.expire_time !== 0) {
-                            data.expire_time = 0;
-                            checkRefreshToken()
-                                .then(() => {
-                                this.uploadFile(params)
-                                    .then((e) => {
-                                    resolve(e);
-                                })
-                                    .catch((e) => {
-                                    reject(e);
-                                });
-                            })
-                                .catch((e) => {
-                                reject(e);
-                            });
-                        }
-                        else {
-                            const err = {
-                                code: statusCode,
-                                msg: 'Upload Fail',
-                            };
-                            const msgMatch = e.match(/<Message>([^<>]+)<\/Message>/);
-                            if (msgMatch) {
-                                err.msg = msgMatch[1];
-                            }
-                            reject(err);
-                        }
-                    }
+                    this.handleUploadResult(params, cosHost, res.statusCode, res.data, resolve, reject);
                 },
                 fail: (err) => {
                     reject({
@@ -100,7 +216,6 @@ class COS {
                     });
                 },
             });
-            params.getTask?.(task);
         });
     }
 }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@zfqh/uniapp-x",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "uniapp x 公共模块",
   "author": "yinjiazeng@163.com",
-  "license": "MIT",
+  "license": "UNLICENSED",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "publishConfig": {
@@ -20,11 +20,10 @@
   "files": [
     "lib",
     "types",
-    "CHANGELOG.md",
     "README.md"
   ],
   "dependencies": {
-    "@zfqh/uview-x": "0.0.7",
+    "@zfqh/uview-x": "0.0.9",
     "crypto-es": "^3.1.3",
     "pinia": "2.1.7",
     "qs": "^6.13.0",
@@ -36,5 +35,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "59595760375b8c8c71d6abe4e860d4ba8ca915a1"
+  "gitHead": "5dbc4d414ca9c84f7b65abbf92f8ce0f3750a1f3"
 }

package/CHANGELOG.md

@@ -1,84 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-## [0.0.7](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uniapp-x@0.0.6...@zfqh/uniapp-x@0.0.7) (2026-11-11)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-## [0.0.6](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uniapp-x@0.0.5...@zfqh/uniapp-x@0.0.6) (2026-11-11)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-## [0.0.5](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uniapp-x@0.0.4...@zfqh/uniapp-x@0.0.5) (2026-11-11)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-## [0.0.4](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uniapp-x@0.0.3...@zfqh/uniapp-x@0.0.4) (2026-11-10)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-## [0.0.3](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uniapp-x@0.0.2...@zfqh/uniapp-x@0.0.3) (2026-11-10)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-## [0.0.2](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uniapp-x@0.0.1...@zfqh/uniapp-x@0.0.2) (2026-11-09)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-## 0.0.1 (2026-11-09)
-
-**Note:** Version bump only for package @zfqh/uniapp-x
-
-
-
-
-
-# Change Log
-
-## Unreleased
-
-- `cleanEnv` 新增 `combine` 选项（默认 `false`）。`combine: true` 时在构建期为 `src|lib/configs/env` 提供虚拟模块 `virtual:env`（不写文件），结构保持 glob 的 `{ 路径: { default: config } }`；生产裁剪仍然生效，无关环境在索引中为 `{ default: {} }` 且不 import；`.env.*` 变化时刷新虚拟模块；`defineConfig` 对用户已提供的 `cleanEnv` 不再重复追加。
-- env 文件扩展名支持 `.js`、`.ts`、`.mjs`、`.mts`、`.uts`，`cleanEnv` 生产裁剪、`getEnvHash`、`configs/env.ts` 解析同步支持 `.uts`。
-- **BREAKING**：env 模块移除 App 条件编译，恢复为 `const modules = import.meta.glob('@env/.env.*.*', { eager: true })`；App 工程需在 `@gmcb/vite` 中显式配置 `cleanEnv({ combine: true })`。
-- 修复 App 蒸汽模式下的 CJS 依赖互操作：`qs`、`url-parse` 在 App Vapor 打包时无法以 ESM 方式解析，`useWebview` / `useRedirect` 改为使用包内 `utils/query.ts`（`parseQuery` / `stringifyQuery`）与新增 `utils/url.ts`（`SimpleUrl`），H5/MP 行为保持一致。
-- `tsc` 构建后的 `lib` 需要配合 `pnpm copy:build` 复制 `src/styles/**` 等非 TS 资源（`var.module.scss`），否则 App 编译会报 `Could not resolve "../styles/var.module.scss"`。
-- Pinia store id 统一为模块名（`app`、`dict`、`im`、`launch`、`location`、`login`、`network`、`system`），移除 `uniapp-x-` 前缀，与文件名、`TYPES.STORAGE` key 的命名保持一致。
-- 移除 `docs/` 文档站点与 `.vitepress/`，删除 `docs:dev` / `docs:build` 脚本（暂时不维护）；`package.json` 的 `files` 不再包含 `docs`。
-
-## 0.0.0
-
-- 从 `@zfqh/uniapp` fork 的 uni-app x 分支。
-- **BREAKING**：移除 Vuex 兼容层（`uni.$store`、`this.$store`、`commit`、`dispatch`、`getters`、`rootState`、`useStore(name)` 等），状态管理统一为 Pinia setup store。插件安装时执行 `app.use(pinia)` 安装包内唯一实例；普通 TS 模块使用 `useXxxStore(pinia)`，不要创建第二个 Pinia。
-- **BREAKING**：移除全部 mixin（app、badge、login、redirect、share、show、webview、model、deep、debounce），替换为组合式 hooks：`useAppLifecycle`、`useBadge` / `useAppBadge`、`useNeedLogin`、`useRedirect`、`useShare`、`usePageShow`、`useWebview`。`model` 改用原生 `v-model`，`deep` 改用 `:deep()` / `styleIsolation`，`debounce` 改用 `Debounce` 工具类。
-- **BREAKING**：移除全部 `g-*` 公共组件，同步下线组件文档和 easycom 配置；业务侧改用 `@zfqh/uview-x` 的 `uv-*` 组件或业务自定义组件。
-- 新增 8 个 Pinia setup store：`useAppStore`、`useDictStore`、`useImStore`、`useLaunchStore`、`useLocationStore`、`useLoginStore`、`useNetworkStore`、`useSystemStore`；状态统一放在 `info`（`useLaunchStore` 额外有 `key`），提供 `setXxxInfo` / `getXxxInfo` 等 action 与 `isLogin`、`isConnected` computed。
-- 新增 hooks：`usePageShow`、`useBadge`、`useAppBadge`、`useAppLifecycle`、`useShare`、`useWebview`、`useRedirect`，与既有 `useNeedLogin`、`useOverlay`、`usePopup`、`useVersion`、`useI18n`、`useReferrer` 一并从根入口导出。
-- COS 签名依赖由 `crypto-js` 替换为 `crypto-es`（ESM）。
-- 环境文件默认在 H5 / 小程序通过 `import.meta.glob` 加载；App 端需配合 `@gmcb/vite` 的 `cleanEnv({ combine: true })` 使用虚拟 env 索引。
-- 文档重构：导航与侧边栏移除组件、混入；样式文档迁移到「指南 / 样式」；新增「从 Vuex/mixin 迁移」页，API 侧边栏改为状态管理与 Hooks。

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 aniu
-
-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.