befly-shared 2.0.7 → 2.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly-shared",
-    "version": "2.0.7",
+    "version": "2.0.8",
     "private": false,
     "description": "Befly Shared - 通用工具函数库",
     "type": "module",
@@ -21,5 +21,5 @@
     "engines": {
         "bun": ">=1.3.0"
     },
-    "gitHead": "c98b9286276d0f73a0b0894d21c10baa76db5343"
+    "gitHead": "a6aba466befdacde57c4b45c9cd003d52e2cb531"
 }

package/utils/createStore.js

@@ -50,6 +50,37 @@ function createStorageApi(storage) {
             }
 
             return parseValue(storage.getItem(key), defaultValue);
+        },
+        remove(key) {
+            if (typeof key !== "string" || key.trim() === "") {
+                return false;
+            }
+
+            if (!storage || typeof storage.removeItem !== "function") {
+                return false;
+            }
+
+            storage.removeItem(key);
+            return true;
+        },
+        has(key) {
+            if (typeof key !== "string" || key.trim() === "") {
+                return false;
+            }
+
+            if (!storage) {
+                return false;
+            }
+
+            return storage.getItem(key) !== null;
+        },
+        clear() {
+            if (!storage || typeof storage.clear !== "function") {
+                return false;
+            }
+
+            storage.clear();
+            return true;
         }
     };
 }

package/utils/createHttp.md

@@ -1,123 +0,0 @@
-# createHttp
-
-## 功能说明
-
-`createHttp(options)` 用于创建一个通用 POST 请求函数，支持：
-
-- JSON 请求体自动序列化
-- `FormData` 自动直传
-- 默认值/按字段值过滤（`dropValues`、`dropKeyValue`）
-- 自动附带 Bearer Token
-- 统一响应与错误结构处理
-
-创建后返回的请求函数签名为：
-
-- `requestPost(url, data, dropValues, dropKeyValue)`
-
----
-
-## 入参
-
-### createHttp(options)
-
-- `options.apiPath`：`string`
-    - 接口前缀，例如：`http://localhost:3000/api`
-- `options.getToken`：`() => string`
-    - 获取 token 的函数
-    - 返回空字符串时不会添加 `Authorization`
-
-### requestPost(url, data, dropValues, dropKeyValue)
-
-- `url`：`string`
-    - 业务接口路径，例如：`/core/login`
-- `data`：`object | FormData`
-    - 普通对象会按 JSON 发送
-    - `FormData` 会按表单发送
-- `dropValues`：`Array<any>`（可选）
-    - 全局过滤值列表
-    - 默认：`[null, undefined]`
-- `dropKeyValue`：`Record<string, Array<any>>`（可选）
-    - 按字段过滤值
-    - 例如：`{ page: [0], keyword: [""] }`
-
----
-
-## 返回值
-
-### 成功
-
-返回后端 JSON 对象（要求后端 `code === 0`）。
-
-### 失败
-
-Promise reject 对象结构：
-
-- `msg`: 错误消息
-- `code`: 后端业务码（可选）
-- `detail`: 后端明细（可选）
-
-特殊情况：
-
-- 响应可读但 JSON 解析失败：`{ msg: "响应解析失败" }`
-- 非 2xx 且无法按业务格式解析：`{ code: HTTP状态码, msg: "请求失败：HTTP xxx" }`
-- 网络异常：`{ msg: "网络连接失败" }`
-
----
-
-## 使用示例
-
-### 1）创建实例
-
-```javascript
-import { createHttp } from "befly-shared/createHttp";
-
-const $Http = createHttp({
-    apiPath: "http://localhost:3000/api",
-    getToken: () => localStorage.getItem("befly-admin-token") ?? ""
-});
-```
-
-### 2）JSON 请求
-
-```javascript
-const res = await $Http("/core/user/list", {
-    page: 1,
-    limit: 30,
-    keyword: ""
-});
-```
-
-### 3）FormData 请求
-
-```javascript
-const form = new FormData();
-form.append("file", file);
-form.append("remark", "头像");
-
-const res = await $Http("/core/upload/file", form);
-```
-
-### 4）过滤默认值
-
-```javascript
-const res = await $Http("/core/user/list", { page: 1, limit: 30, keyword: "", state: null }, [null, undefined, ""], { page: [0] });
-```
-
-## 行为细节
-
-- 当 `data instanceof FormData` 时：
-    - 不设置 `Content-Type`（由浏览器自动带 boundary）
-    - `body` 直接传 `FormData`
-- 当 `data` 是普通对象时：
-    - 设置 `Content-Type: application/json`
-    - `body` 为 `JSON.stringify(data)`
-- 有 token 时自动设置：
-    - `Authorization: Bearer <token>`
-
----
-
-## 注意事项
-
-- 后端响应格式建议统一为 `{ code, msg, data, detail }`
-- 仅当 `code === 0` 视为成功
-- 该实现固定为 `POST` 请求