jinbi-utils 1.0.20 → 1.0.22

package/.babelrc

@@ -0,0 +1,19 @@
+{
+  "presets": [
+    [
+      "@babel/preset-env",
+      {
+        "modules": false,
+        "targets": {
+          "node": "current"
+        }
+      }
+    ],
+    "@babel/preset-typescript"
+  ],
+  "env": {
+    "test": {
+      "plugins": ["@babel/plugin-transform-modules-commonjs"]
+    }
+  }
+}

package/.cz-config.js

@@ -0,0 +1,55 @@
+'use strict';
+
+module.exports = {
+
+  types: [
+    {value: 'feat',     name: 'feat:     新特性或功能'},
+    {value: 'fix',      name: 'fix:      修复Bug'},
+    {value: 'docs',     name: 'docs:     文档的变更'},
+    {value: 'style',    name: 'style:    不影响代码运行的风格更改(空白、格式、缺少分号等)'},
+    {value: 'refactor', name: 'refactor: 代码重构, 注意和feat、fix区分'},
+    {value: 'perf',     name: 'perf:     提高性能'},
+    {value: 'test',     name: 'test:     添加测试'},
+    {value: 'chore',    name: 'chore:    开发工具(构建、脚手架工具等)和库（如文档生成）的更改'},
+    {value: 'revert',   name: 'revert:   代码回滚'},
+    {value: 'WIP',      name: 'WIP:      进行中开发'}
+  ],
+
+  // list of Function Modules
+  scopes: [
+    {name: '模块1'},
+    {name: '模块2'},
+  ],
+
+  // it needs to match the value for field type. Eg.: 'fix'
+  /*
+  scopeOverrides: {
+    fix: [
+      {name: 'merge'},
+      {name: 'style'},
+      {name: 'e2eTest'},
+      {name: 'unitTest'}
+    ]
+  },
+  */
+  // override the messages, defaults are as follows
+  messages: {
+    type: '选择一种提交类型:',
+    scope: '选择一个scope (可选):',
+    // used if allowCustomScopes is true
+    customScope: 'Denote the SCOPE of this change:',
+    subject: '简短说明:\n',
+    body: '长说明，使用"|"换行(可选)：\n',
+    breaking: '非兼容性说明 (可选):\n',
+    footer: '关联关闭的issue，例如：#31, #34(可选):\n',
+    confirmCommit: '确定提交说明?'
+  },
+
+
+  allowCustomScopes: true,
+  allowBreakingChanges: ['feat', 'fix'],
+
+  // limit subject length
+  subjectLimit: 100
+
+};

package/.dockerignore

@@ -0,0 +1,3 @@
+ .git
+ node_modules
+ npm-debug.log

package/.editorconfig

@@ -0,0 +1,12 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

package/.eslintignore

@@ -0,0 +1,15 @@
+/.git
+/.vscode
+node_modules
+dist
+test
+rollup.config.js
+types
+docs
+*
+!src/
+!src/utils/
+!src/utils/curl.ts
+!src/middleware/
+!src/middleware/requestLoggerUnified.ts
+!src/middleware/requestLogger.middware.ts

package/.eslintrc.js

@@ -0,0 +1,54 @@
+module.exports = {
+  "env": {
+    "browser": true,
+    "commonjs": true,
+    "es6": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint"],
+  "parserOptions": {
+    "ecmaVersion": 2015,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "rules": {
+    'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
+    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
+    'prefer-promise-reject-errors': 'off', // 要求使用 Error 对象作为 Promise 拒绝的原因
+    'linebreak-style': 'off', // 回车换行风格
+    'no-trailing-spaces': 1, // 允许在空行、在注释块中使用空白符
+    'import/prefer-default-export': 'off', // 
+    'object-curly-newline': 'off', // 不强制花括号内换行
+    'import/named': 'off', // 停用 import/named 校验
+    'no-underscore-dangle': 'off', // 禁止标识符中有悬空下划线
+    'import/order': 'off',
+    'prefer-object-spread': 1, // 禁止使用以对象字面量作为第一个参数的 Object.assign，优先使用对象扩展。
+    'arrow-parens': [2, "as-needed", { "requireForBlockBody": true }], // 要求箭头函数的参数使用圆括号
+    "comma-dangle": ["error", "always-multiline"], // 要求或禁止使用拖尾逗号
+    "semi": 2, // 要求或禁止使用分号代替 ASI
+    "keyword-spacing": 2, // 强制关键字周围空格的一致性
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/interface-name-prefix": "off",
+    "@typescript-eslint/no-empty-function": "off",
+    "@typescript-eslint/no-inferrable-types": "off",
+    "@typescript-eslint/no-empty-interface": "off",
+    "@typescript-eslint/no-non-null-assertion": "off",
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/explicit-module-boundary-types": "off",
+    "@typescript-eslint/member-delimiter-style": ["error", {
+      "multiline": {
+        "delimiter": "semi",
+        "requireLast": true
+      },
+      "singleline": {
+        "delimiter": "semi",
+        "requireLast": true
+      }
+    }]
+  }
+};

package/.versionrc.json

@@ -0,0 +1,9 @@
+{
+  "types": [
+    { "type": "feat", "section": "✨ Features" },
+    { "type": "fix", "section": "🐞 Bug Fixes" },
+    { "type": "docs", "section": "📖 Documentation" },
+    { "type": "style", "section": "🎨 Style" }
+  ],
+  "releaseCommitMessageFormat": "chore(release): 发布版本 v{{currentTag}}"
+}

package/CHANGELOG.md

@@ -1,49 +1,49 @@
-# Changelog
-
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
-
-### [1.0.15](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.14...v1.0.15) (2025-12-04)
-
-### [1.0.14](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.13...v1.0.14) (2025-12-04)
-
-### [1.0.13](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.12...v1.0.13) (2025-12-04)
-
-
-### ✨ Features
-
-* 更新-apiBuilder ([5f09e35](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/5f09e357cc8e306daacdd0f33599472cf2375b14))
-* upateAPIbuilder ([482f2e1](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/482f2e100a49d167e4c5129cacd496fc85223567))
-* upateAPIbuilder ([42a1f40](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/42a1f40a0606a3240726b4227155758950b4f722))
-
-### [1.0.12](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.11...v1.0.12) (2025-11-17)
-
-### [1.0.11](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.10...v1.0.11) (2025-11-11)
-
-### [1.0.10](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.9...v1.0.10) (2025-11-11)
-
-### [1.0.9](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.2...v1.0.9) (2025-11-11)
-
-
-### ✨ Features
-
-* **build:** 新增依赖分类与分块优化功能（Chunk Optimizer） ([21c2d1a](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/21c2d1abb41c62b73bb2820a6132b3ffe027c086))
-* **build:** 新增依赖分类与分块优化功能（Chunk Optimizer） ([1a3113d](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/1a3113dee7d8e7f67a7e48d9c6976514fbfd5297))
-* 提交 saas平台项目需要的方法 ([e9bdefd](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/e9bdefd14d8d3006df3ff0e144321b2abf858444))
-* 新增 `ApiBuilder` 工具类 ([62bc47e](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/62bc47eb18f3f54495239ecd0cb40e0a78c3899a))
-
-### [1.0.2](https://e.coding.net/jinbicloud/P8/jbwy-utils/compare/v1.0.1...v1.0.2) (2025-07-31)
-
-### [1.0.1](https://e.coding.net/jinbicloud/P8/jbwy-utils/compare/v1.0.0...v1.0.1) (2025-07-25)
-
-## 1.0.0 (2025-07-25)
-
-
-### ✨ Features
-
-* 1.调整日志中间件 接入的服务地址 ([5bf17c3](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/5bf17c3ada3ec825c7dc8ac1f1cae74e1ea54e76))
-* 1.新增 nodejs 日志中间件工具库 2. 新增iam工具库 ([07a48c8](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/07a48c87cb061401aadca3026a7821ee6f0b8069))
-* 更新版本和依赖项 ([1bcc026](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/1bcc026a8d2c8019180e0418bde7bef485ade566))
-* 删除 wecom 模块及相关文档 ([6ef1215](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/6ef12157d1b7ff4b4bd1217a34fcca5af49bc3e2))
-* 添加版本控制配置和更新依赖项 ([cfecef1](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/cfecef19fff25fb167ae251246ee268d9caaaa22))
-* 添加新模块和配置更新 ([bba4a67](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/bba4a67f1f5094dd89f6e51708aa50f8e1b00b65))
-* 新增分转元方法 ([cc9d640](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/cc9d640d53497c4c7784606538d9a0bf49bd15cb))
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [1.0.15](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.14...v1.0.15) (2025-12-04)
+
+### [1.0.14](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.13...v1.0.14) (2025-12-04)
+
+### [1.0.13](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.12...v1.0.13) (2025-12-04)
+
+
+### ✨ Features
+
+* 更新-apiBuilder ([5f09e35](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/5f09e357cc8e306daacdd0f33599472cf2375b14))
+* upateAPIbuilder ([482f2e1](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/482f2e100a49d167e4c5129cacd496fc85223567))
+* upateAPIbuilder ([42a1f40](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/42a1f40a0606a3240726b4227155758950b4f722))
+
+### [1.0.12](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.11...v1.0.12) (2025-11-17)
+
+### [1.0.11](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.10...v1.0.11) (2025-11-11)
+
+### [1.0.10](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.9...v1.0.10) (2025-11-11)
+
+### [1.0.9](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/compare/v1.0.2...v1.0.9) (2025-11-11)
+
+
+### ✨ Features
+
+* **build:** 新增依赖分类与分块优化功能（Chunk Optimizer） ([21c2d1a](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/21c2d1abb41c62b73bb2820a6132b3ffe027c086))
+* **build:** 新增依赖分类与分块优化功能（Chunk Optimizer） ([1a3113d](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/1a3113dee7d8e7f67a7e48d9c6976514fbfd5297))
+* 提交 saas平台项目需要的方法 ([e9bdefd](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/e9bdefd14d8d3006df3ff0e144321b2abf858444))
+* 新增 `ApiBuilder` 工具类 ([62bc47e](https://cnb.jinbizhihui.com/jinbizhihui/frontend/jbwy-utils/commit/62bc47eb18f3f54495239ecd0cb40e0a78c3899a))
+
+### [1.0.2](https://e.coding.net/jinbicloud/P8/jbwy-utils/compare/v1.0.1...v1.0.2) (2025-07-31)
+
+### [1.0.1](https://e.coding.net/jinbicloud/P8/jbwy-utils/compare/v1.0.0...v1.0.1) (2025-07-25)
+
+## 1.0.0 (2025-07-25)
+
+
+### ✨ Features
+
+* 1.调整日志中间件 接入的服务地址 ([5bf17c3](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/5bf17c3ada3ec825c7dc8ac1f1cae74e1ea54e76))
+* 1.新增 nodejs 日志中间件工具库 2. 新增iam工具库 ([07a48c8](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/07a48c87cb061401aadca3026a7821ee6f0b8069))
+* 更新版本和依赖项 ([1bcc026](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/1bcc026a8d2c8019180e0418bde7bef485ade566))
+* 删除 wecom 模块及相关文档 ([6ef1215](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/6ef12157d1b7ff4b4bd1217a34fcca5af49bc3e2))
+* 添加版本控制配置和更新依赖项 ([cfecef1](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/cfecef19fff25fb167ae251246ee268d9caaaa22))
+* 添加新模块和配置更新 ([bba4a67](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/bba4a67f1f5094dd89f6e51708aa50f8e1b00b65))
+* 新增分转元方法 ([cc9d640](https://e.coding.net/jinbicloud/P8/jbwy-utils/commit/cc9d640d53497c4c7784606538d9a0bf49bd15cb))

package/CHUNK_OPTIMIZER_USAGE.md

@@ -0,0 +1,132 @@
+# Chunk Optimizer 使用说明
+
+## 问题说明
+
+`chunk-optimizer` 是一个**构建时工具**，它依赖 Node.js 内置模块（`fs` 和 `path`），只能在 Node.js 环境中运行（如 `vite.config.ts`）。
+
+从 v1.0.9 版本开始，`chunk-optimizer` 已从主入口文件中移除，以避免将 Node.js 模块打包到浏览器端的 bundle 中。
+
+## 正确的使用方式
+
+### 在消费项目中使用
+
+**方式一：通过单独的导出路径（推荐）**
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import { createChunkOptimizer } from 'jinbi-utils/chunk-optimizer'
+
+const optimizer = createChunkOptimizer({
+  framework: 'vue',
+  debug: true
+})
+
+export default defineConfig({
+  build: {
+    rollupOptions: {
+      output: {
+        manualChunks: optimizer.generate()
+      }
+    }
+  }
+})
+```
+
+**方式二：直接从源码导入**
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import { createChunkOptimizer } from 'jinbi-utils/src/build/chunk-optimizer'
+
+// 使用方式同上
+```
+
+### 在浏览器代码中使用其他工具函数
+
+浏览器代码中可以正常导入其他工具函数，不会受到影响：
+
+```typescript
+// 在 .vue 或 .ts 文件中
+import { formatTime, formatPhone, isEmpty } from 'jinbi-utils'
+
+// 正常使用
+const time = formatTime(Date.now())
+```
+
+## 版本升级指南
+
+如果你的项目之前使用的是 v1.0.8 或更早版本，并且遇到了以下错误：
+
+```
+error during build:
+"resolve" is not exported by "__vite-browser-external"
+```
+
+请按照以下步骤升级：
+
+### 步骤 1: 更新包版本
+
+```bash
+npm install jinbi-utils@latest
+# 或
+pnpm update jinbi-utils
+```
+
+### 步骤 2: 修改 vite.config.ts 中的导入
+
+**修改前：**
+```typescript
+import { createChunkOptimizer } from 'jinbi-utils'
+```
+
+**修改后：**
+```typescript
+import { createChunkOptimizer } from 'jinbi-utils/chunk-optimizer'
+```
+
+### 步骤 3: 重新构建
+
+```bash
+npm run build
+```
+
+## 技术细节
+
+### 为什么要这样做？
+
+1. **chunk-optimizer 依赖 Node.js 模块**：它需要读取 `package.json` 文件来分析依赖
+2. **浏览器环境不支持 Node.js 模块**：`fs` 和 `path` 无法在浏览器中运行
+3. **Vite 的处理方式**：当浏览器代码导入包含 Node.js 模块的文件时，Vite 会尝试用 polyfill 替换，但这会导致错误
+
+### 解决方案的原理
+
+通过将 `chunk-optimizer` 从主入口移除，并提供单独的导出路径：
+
+- **浏览器代码**导入 `jinbi-utils` 时，只会加载不包含 Node.js 模块的代码
+- **构建配置**导入 `jinbi-utils/chunk-optimizer` 时，可以正常使用 Node.js 模块
+
+## 常见问题
+
+### Q: 我的项目没有使用 chunk-optimizer，也遇到了这个错误？
+
+A: 如果你的项目代码中导入了 `jinbi-utils`，但没有使用 `chunk-optimizer`，升级到最新版本即可解决。
+
+### Q: 我可以在浏览器代码中使用 chunk-optimizer 吗？
+
+A: 不可以。`chunk-optimizer` 是构建时工具，只能在 Node.js 环境（如 `vite.config.ts`）中使用。
+
+### Q: 升级后，其他工具函数还能正常使用吗？
+
+A: 可以。其他所有工具函数（如 `formatTime`、`formatPhone` 等）都不受影响，可以在浏览器代码中正常使用。
+
+## 联系支持
+
+如果遇到问题，请提供以下信息：
+
+1. `jinbi-utils` 版本号
+2. 错误信息截图
+3. `vite.config.ts` 中的相关配置
+4. Node.js 和 npm/pnpm 版本
+

package/Dockerfile

@@ -0,0 +1,3 @@
+FROM nginx
+
+COPY docs /usr/share/nginx/html/

package/QUICK_RELEASE.md

@@ -0,0 +1,85 @@
+# 🚀 快速发布参考
+
+## 一键发布命令
+
+```bash
+# 🔧 修复 bug（1.0.8 -> 1.0.9）
+npm run release
+
+# 或明确指定
+npm run release:patch
+
+# ✨ 新功能（1.0.8 -> 1.1.0）
+npm run release:minor
+
+# 💥 破坏性更新（1.0.8 -> 2.0.0）
+npm run release:major
+
+# 🧪 测试版本（1.0.8 -> 1.0.9-beta.0）
+npm run release:beta
+```
+
+## 发布前准备
+
+1. **提交所有更改**
+   ```bash
+   git add .
+   git commit -m "feat: 添加新功能"
+   ```
+
+2. **确保在正确的分支**
+   ```bash
+   git checkout main
+   ```
+
+3. **拉取最新代码**
+   ```bash
+   git pull origin main
+   ```
+
+## Commit 规范速查
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `feat` | 新功能 | `feat: 添加文件上传功能` |
+| `fix` | 修复 bug | `fix: 修复日期格式化问题` |
+| `docs` | 文档 | `docs: 更新 API 文档` |
+| `style` | 格式 | `style: 格式化代码` |
+| `refactor` | 重构 | `refactor: 重构用户模块` |
+| `perf` | 性能 | `perf: 优化列表渲染` |
+| `test` | 测试 | `test: 添加单元测试` |
+| `chore` | 构建 | `chore: 更新依赖` |
+
+## 自动化流程
+
+运行 `npm run release` 会自动：
+
+1. ✅ 运行构建
+2. 📝 更新版本号
+3. 📄 生成 CHANGELOG
+4. 🏷️ 创建 Git Tag
+5. 💾 提交更改
+6. 📤 发布到 npm
+7. ⬆️ 推送到 Git
+
+## 常见问题
+
+**Q: 如何撤销发布？**
+```bash
+npm unpublish jinbi-utils@版本号
+```
+
+**Q: 如何查看当前版本？**
+```bash
+npm view jinbi-utils version
+```
+
+**Q: 发布失败怎么办？**
+- 检查是否已登录：`npm whoami`
+- 检查网络连接
+- 查看错误信息
+
+## 详细文档
+
+查看 [RELEASE_GUIDE.md](./RELEASE_GUIDE.md) 了解完整的发布流程。
+