@wiajs/core 1.2.1 → 1.2.3

package/package.json

@@ -1,52 +1,52 @@
 {
   "name": "@wiajs/core",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "wia app core package",
+  "keywords": [
+    "core",
+    "wia"
+  ],
+  "homepage": "https://www.wia.pub/core",
+  "bugs": {
+    "url": "https://github.com/wiajs/core/issues"
+  },
+  "license": "ELv2",
+  "author": {
+    "name": "Sibyl Yu",
+    "email": "sibyl@wia.pub"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wiajs/wia.git"
+  },
   "main": "./dist/core.cjs",
   "module": "./dist/core.mjs",
   "types": "./types/core.d.ts",
-	"exports": {
- 		".": {
+  "exports": {
+    ".": {
       "types": "./types/core.d.ts",
       "require": "./dist/core.cjs",
       "import": "./dist/core.mjs",
       "default": "./dist/core.mjs"
     },
-    "./jsx-runtime":  "./dist/jsx-runtime.js",
-    "./jsx-dev-runtime": "./dist/jsx-runtime.js",   
+    "./jsx-runtime": "./dist/jsx-runtime.js",
+    "./jsx-dev-runtime": "./dist/jsx-runtime.js",
     "./util/*": [
       "./util/*.js",
       "./util/*.d.ts"
-    ]		
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "scripts": {
     "build": "cross-env NODE_ENV=production gulp build",
     "build-dev": "cross-env NODE_ENV=development gulp build",
     "dev": "cross-env NODE_ENV=development gulp cjs",
-    "dev:umd": "cross-env NODE_ENV=development gulp umd",
     "dev:esm": "cross-env NODE_ENV=development gulp esm",
+    "dev:umd": "cross-env NODE_ENV=development gulp umd",
     "release": "bash release.sh"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wiajs/wia.git"
-  },
-  "keywords": [
-    "wia",
-    "core"
-  ],
-  "author": {
-    "name": "Sibyl Yu",
-    "email": "sibyl@wia.pub"
-  },
-  "license": "ELv2",
-  "bugs": {
-    "url": "https://github.com/wiajs/core/issues"
-  },
-  "homepage": "https://www.wia.pub/core",
-  "publishConfig": {
-    "access": "public"
-  },
   "devDependencies": {
     "@rollup/plugin-babel": "^6.0.3",
     "@rollup/plugin-commonjs": "^25.0.1",

package/util/tool.js

@@ -200,6 +200,220 @@ function serObj(obj) {
     .join('&');
 }
 
+/**
+ * 金额千位分隔符字符串转换为 Number，单位分
+ * 避免运算误差！
+ * @param {String} v 金额千位分隔符金额字符串
+ * @returns Number 整型金额，单位分
+ */
+function toFen(v) {
+  let R = v
+  if (typeof v === 'string') R = Math.round(Number.parseFloat(v.replaceAll(',', '')) * 100)
+  return R
+}
+
+/**
+ * 金额千位分隔符字符串
+ * @param {Number} v 金额，单位分
+ * @returns
+ */
+function toYuan(v) {
+  let R = v
+
+  if (typeof v === 'number') {
+    v = `${(v * 0.01).toFixed(2)}` // 分到元
+    // 千分符的正则
+    const reg = v.includes('.') ? /(\d{1,3})(?=(?:\d{3})+\.)/g : /(\d{1,3})(?=(?:\d{3})+$)/g
+    R = v.replace(reg, '$1,') // 千分位格式化
+  }
+
+  return R
+}
+
+/**
+ * 延迟promise，可以 await 或 then
+ * @param {number} ms - 毫秒
+ */
+function delay(ms) {
+  return new Promise(succ => {
+    setTimeout(succ, ms)
+  })
+}
+
+/**
+ * 简单异步函数转换为promise函数
+ * @param {*} f
+ * @param {*} type
+ * 0：一个回调，一个参数，无失败参数，仅仅返回执行结果
+ * 1: 一个回调函数，第一个参数为 err，第二个参数为成功结果
+ * 2：两个回调函数，第一个为成功回调，第二个为失败回调
+ * 3：两个回调函数，第一个为失败回调，第二个为成功回调
+ * @returns
+ */
+function promisify(f, type = 1) {
+  return (...arg) =>
+    new Promise((res, rej) => {
+      if (type == null || type === 1)
+        f(...arg, (err, rs) => {
+          if (err) rej(err)
+          else res(rs)
+        })
+      else if (type === 0) f(...arg, rs => res(rs))
+      else if (type === 2)
+        f(
+          ...arg,
+          rs => res(rs),
+          rs => rej(rs || new Error('reject'))
+        )
+      else if (type === 3)
+        f(
+          ...arg,
+          rs => res(rs),
+          rs => rej(rs || new Error('reject'))
+        )
+    })
+}
+
+/**
+ * 格式化数字：保留 cnt 位小数并添加千位分隔符
+ * @param {number} num - 需要格式化的数字
+ * @param {number} [cnt] - 小数位数
+ * @returns {string} 格式化后的字符串
+ */
+function formatNum(num, cnt = 2) {
+  if (typeof num !== 'number' || isNaN(num)) {
+    return '0.00' // 如果不是数字，返回默认值
+  }
+  return num.toLocaleString('en-US', {
+    minimumFractionDigits: cnt, // 最少保留 2 位小数
+    maximumFractionDigits: cnt, // 最多保留 2 位小数
+  })
+}
+
+/**
+ * 判断参数是否为空
+ * @param {*} p
+ * @returns {boolean}
+ *  true: undefined/null/''/空对象/空数组/空Map/空Set
+ *  false: false/0/非空对象、非空数组、值
+ */
+function isEmpty(p) {
+  if (p === undefined || p === null || p === '') {
+    return true
+  }
+
+  if (typeof p === 'string' && p.trim() === '') {
+    return true
+  }
+
+  if (Array.isArray(p) && p.length === 0) {
+    return true
+  }
+
+  if (p instanceof Map && p.size === 0) {
+    return true
+  }
+
+  if (p instanceof Set && p.size === 0) {
+    return true
+  }
+
+  // 检查普通空对象
+  if (typeof p === 'object' && p !== null && p.constructor === Object && Object.keys(p).length === 0) {
+    return true
+  }
+
+  return false
+}
+
+/**
+ * 日期判断
+ * @param {*} v
+ * @returns
+ */
+function isDate(v) {
+  return v instanceof Date
+}
+
+/**
+ * 是否为数字
+ * @param {*} value
+ * @returns {boolean}
+ */
+function isNumber(value) {
+  let R = false
+  if (typeof value === 'number') R = true
+  else R = Number.isFinite(Number(value)) && value.trim() !== ''
+
+  return R
+}
+
+/**
+ * 检查参数，不满足条件抛出异常
+ * 1. 非数组：null/undefined/''/空对象
+ * 2. 数组：其中一个元素 null/undefined/''/空对象
+ * @param {*} p 参数
+ * @param {string=} msg
+ */
+function needParam(p, msg) {
+  if (isEmpty(p)) throw new Err(Err.MissParam, msg)
+
+  if (Array.isArray(p)) {
+    if (p.some(m => isEmpty(m))) throw new Err(Err.MissParam, msg)
+  }
+}
+
+/**
+ * 签名，添加 signTime 和 sign 属性
+ * 签名120/30秒内有效，只能使用一次，防止重放攻击或重复提交
+ * signTime：1970/1/1 以来的【毫秒数】，不用秒，避免重复
+ * post 签名，参数需排序，signTime、Sign  不参与排序放最后，其他字段按字母排序
+ * 不同时刻，不同用户pid，不同订单编号，可避免签名重复
+ * 同用户pid的高密集并发重复请求可能导致签名重复
+ * 可在入参中增加一个nonce随机数，避免签名重复
+ * 【注意】日期类型，自动转换字符串为：Sat Jul 08 2023 21:48:24 GMT+0800 (China Standard Time)
+ * 需手动 toISOString 转换为 "2011-10-05T14:48:00.000Z"
+ * @param {*} r 被签名对象
+ * @param {*} secret 签名密钥
+ * @param {{start?: string, nonce?: boolean}} [opts={}] 起始日期，默认 1970
+ * @returns 带签名的字符串
+ */
+async function sign(r, secret, opts = {nonce: true}) {
+  let R = ''
+
+  const {start, nonce} = opts
+  // 签名时刻，默认 1970/1/1 以来的毫秒
+  let signTime = Date.now()
+
+  if (start) signTime = Math.trunc(Date.now() - Date.parse(start))
+
+  // 可选，无实际用途的随机参数，避免签名重复
+  if (nonce && !r.nonce) r.nonce = Math.floor(Math.random() * 1000000) // 6位随机数
+
+  R = Object.keys(r)
+    .sort()
+    .map(k => (isDate(r[k]) ? `${k}=${r[k].toISOString()}` : `${k}=${r[k]}`))
+    .join('&')
+
+  // 兼容 DSC 旧的签名模式（UAir，大写开头）
+  if (start) {
+    R += `&SignTime=${signTime}`
+    r.SignTime = signTime
+    r.Sign = (await sha1(`${R}${secret}`)).toUpperCase()
+    R += `&Sign=${r.Sign}`
+  } else {
+    R += `&signTime=${signTime}`
+    r.signTime = signTime
+    r.sign = (await sha1(`${R}${secret}`)).toUpperCase()
+    R += `&sign=${r.sign}`
+  }
+
+  // 调试时使用，生产务必关闭，避免泄露密码！！！
+  // log.debug(`sign r:${JSON.stringify(r)} R:${R} secret: ${secret}`)
+
+  return R
+}
+
 export {
   StringBuf,
   format,
@@ -211,4 +425,5 @@ export {
   sortObj,
   serObj,
   setTitle,
+  toYuan, toFen, promisify, delay, formatNum, isNumber, isDate, needParam, sign
 };

package/.eslintignore

@@ -1,5 +0,0 @@
-src/assets
-dist
-lib
-log
-public

package/.eslintrc.js

@@ -1,121 +0,0 @@
-const rules = {
-  // Disable for console/alert
-  // 0 关闭 1 警告 2 报错 https://eslint.org/docs/rules/  中文网址：http://eslint.cn/docs/rules/
-  // "arrow-parens": [2, "as-needed"],
-  'arrow-parens': [2, 'as-needed', {requireForBlockBody: false}],
-  'arrow-body-style': [2, 'as-needed'],
-  'global-require': 0,
-  'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-  'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-  quotes: [1, 'single'],
-  'no-alert': 0,
-  'no-trailing-spaces': 0,
-  'nonblock-statement-body-position': 0, // [2, "beside"], // if else 强制单行
-  'block-spacing': 0, // 对象空格
-  'function-paren-newline': 0, // 函数参数换行
-  'linebreak-style': 0,
-  'lines-between-class-members': 0,
-  'class-methods-use-this': 0,
-  'import/no-extraneous-dependencies': 0,
-  indent: [2, 2, {SwitchCase: 1}],
-  'object-curly-spacing': 0,
-  'no-plusplus': 0,
-  'no-multi-spaces': 0,
-  'no-param-reassign': ['warn', {props: false}],
-  'no-use-before-define': [2, {functions: false, classes: true}],
-  'no-unused-expressions': ['error', {allowShortCircuit: true}],
-  'no-underscore-dangle': 0,
-  'no-unused-vars': [1, {vars: 'local', args: 'after-used'}],
-  'no-cond-assign': ['error', 'except-parens'],
-  'no-return-assign': [2, 'except-parens'],
-  'no-await-in-loop': 0,
-  'import/prefer-default-export': 0,
-  'operator-linebreak': 0,
-  'generator-star-spacing': 0,
-  // if while function 后面的{必须与if在同一行，java风格。
-  // "brace-style": [2, "1tbs", { "allowSingleLine": true }]
-
-  // 数组和对象键值对最后一个逗号， never 参数：不能带末尾的逗号, always参数：必须带末尾的逗号，
-  // always-multiline：多行模式必须带逗号，单行模式不能带逗号
-  'comma-dangle': [2, 'only-multiline'],
-  // 控制逗号前后的空格
-  'comma-spacing': [2, {before: false, after: true}],
-  // 控制逗号在行尾出现还是在行首出现
-  // http://eslint.org/docs/rules/comma-style
-  'comma-style': [0, 'last'],
-  'max-len': [2, 120, 2],
-  curly: [0, 'multi'], // 单行无需大括号
-  // 强制方法必须返回值，TypeScript强类型，不配置
-  'consistent-return': 0,
-  'object-curly-newline': 0,
-  semi: 0, // 分号检查
-  'space-before-function-paren': 0, // ["error", "never"]
-  'func-names': ['error', 'never'],
-};
-
-module.exports = {
-  root: true, // 停止父目录查找配置
-  parser: '@babel/eslint-parser', // "typescript-eslint-parser", "babel-eslint",
-  env: {
-    es6: true,
-    es2017: true,
-    es2020: true,
-    es2021: true,
-    browser: true, // 浏览器环境中的全局变量
-    worker: true,
-    node: true,
-    commonjs: true,
-    mongo: true,
-    jest: true,
-    jquery: true,
-  },
-  globals: {
-    XMLHttpRequest: true,
-    Blob: true,
-    Document: true,
-    FormData: true,
-    Dom: true,
-    $: true,
-    document: true,
-    window: true,
-  },
-  parserOptions: {
-    ecmaVersion: 'latest',
-    sourceType: 'module',
-    ecmaFeatures: {
-      jsx: true,
-    },
-  },
-  plugins: [
-    // 插件，需安装好，配置时省略 eslint-plugin-
-    // babel,
-    // react,
-  ],
-  extends: [
-    // 继承规则 // 'airbnb', 'eslint:recommended'
-    'plugin:react/recommended',
-    'airbnb',
-    'plugin:prettier/recommended',
-    'plugin:import/recommended',
-  ],
-  rules: {
-    ...rules,
-  },
-  overrides: [
-    {
-      files: ['src/**/*.js'],
-      extends: [
-        'plugin:react/recommended',
-        'airbnb-base',
-        'plugin:prettier/recommended',
-        'plugin:import/recommended'
-      ],
-      plugins: ['react'],
-      rules: {
-        ...rules,
-         'react/no-unknown-property': ['off'],
-        'react/jsx-key': ['off'],
-},
-    },
-  ],
-};

package/.prettierignore

@@ -1,24 +0,0 @@
-.*
-*.ejs
-*.ico
-*.map
-*.png
-*.svg
-*.xml
-
-.eslintignore
-.eslintrc
-.eslintrc.js
-.prettierignore
-.prettierrc
-prettier.config.js
-wiamap.yml
-
-package.json
-package-lock.json
-yarn.lock
-
-node_modules
-dist
-doc
-.vscode

package/prettier.config.js

@@ -1,13 +0,0 @@
-module.exports = {
-  tabWidth: 2, // 使用 2 个空格缩进
-  useTabs: false, // 不使用缩进符，而使用空格
-  semi: true, // 行尾需要有分号  
-  singleQuote: true, // 使用单引号
-  bracketSpacing: false, // 大括号内的首尾需要空格
-  trailingComma: 'es5', // 末尾是否需要逗号
-  jsxBracketSameLine: true, // jsx 标签的反尖括号不换行
-  arrowParens: 'avoid', // 尽可能省略箭头函数参数括号。 示例：x => x
-  printWidth: 100, // 代码换行长度
-  endOfLine: 'auto',
-  // jsxSingleQuote: false, // jsx 使用双引号
-};