@vope/utils 1.0.0

package/README.md

@@ -0,0 +1,29 @@
+### build
+```
+发布构建
+```
+
+### cjs
+```
+构建cjs版本
+```
+
+### esm
+```
+构建esm版本
+```
+
+### trove
+```
+构建统一导出入口(即生成src/index.ts文件)
+```
+
+### devs
+```
+构建开发环境工具代码
+```
+
+### test
+```
+运行测试用例
+```

package/cjs/api.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiGet = exports.apiPost = void 0;
+const params_1 = __importDefault(require("./url/params"));
+const cut = (config, key) => {
+    if (key in config) {
+        const value = config[key];
+        delete config[key];
+        return value;
+    }
+};
+const apiPost = (axios, handle) => {
+    function post(url, options, config) {
+        let twist;
+        let rejectValue = false;
+        if (config) {
+            twist = cut(config, 'twist');
+            const rejectValue0 = cut(config, 'rejectValue');
+            rejectValue0 !== void 0 && (rejectValue = rejectValue0);
+        }
+        return new Promise((resolve) => {
+            axios.post(url, options, config).then(
+            // @ts-ignore
+            resolve, (e) => {
+                twist ? twist(e) : handle(e);
+                resolve(rejectValue);
+            });
+        });
+    }
+    return post;
+};
+exports.apiPost = apiPost;
+const apiGet = (axios, handle) => {
+    function get(url, options, config) {
+        let twist;
+        let rejectValue = false;
+        if (config) {
+            twist = cut(config, 'twist');
+            const rejectValue0 = cut(config, 'rejectValue');
+            rejectValue0 !== void 0 && (rejectValue = rejectValue0);
+        }
+        return new Promise((resolve) => {
+            axios.get((0, params_1.default)(url, options), config).then(
+            // @ts-ignore
+            resolve, (e) => {
+                twist ? twist(e) : handle(e);
+                resolve(rejectValue);
+            });
+        });
+    }
+    return get;
+};
+exports.apiGet = apiGet;

package/cjs/compare/value.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 值比较(深度浅比较)
+ */
+const compareValue = (from, to) => {
+    if (typeof from !== 'object'
+        || from === null
+        || typeof to !== 'object'
+        || to === null)
+        return from === to;
+    if (Array.isArray(from) && Array.isArray(to)) {
+        if (from.length !== to.length)
+            return false;
+        return !from.some((t1, index) => {
+            if (!compareValue(t1, to[index])) {
+                return true;
+            }
+        });
+    }
+    else {
+        const caches = {};
+        for (const key in from) {
+            if (!compareValue(from[key], to[key])) {
+                return false;
+            }
+            else {
+                caches[key] = key;
+            }
+        }
+        for (const key in to) {
+            if (key in caches)
+                continue;
+            if (!compareValue(from[key], to[key])) {
+                return false;
+            }
+        }
+    }
+    return true;
+};
+exports.default = compareValue;

package/cjs/convert/json.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 对象数组转hash(要求主键值为string类型)
+ * @example
+ *  hash8json(
+ *    [
+ *      { key: 'a', value: 1 },
+ *      { key: 'b', value: 2 }
+ *    ],
+ *    'key'
+ *  ).a.value // 1
+ */
+const hash8json = (list, key) => list.reduce((caches, data) => {
+    caches[data[key]] = data;
+    return caches;
+}, {});
+exports.default = hash8json;

package/cjs/convert/object.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 对象数组转hash
+ * @example
+ *  hash8object(
+ *    [
+ *      { key: String, value: 1 },
+ *      { key: Object, value: 2 }
+ *    ],
+ *    'key'
+ *  ).get(Object).value // 2
+ */
+const hash8object = (list, key) => list.reduce((caches, data) => {
+    caches.set(data[key], data);
+    return caches;
+}, new Map());
+exports.default = hash8object;

package/cjs/convert/strings.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 字符数组转hash
+ * @example
+ *  hash8strings(['a', 'b']).a // 0
+ */
+const hash8strings = (list) => list.reduce((caches, data, index) => {
+    caches[data] = index;
+    return caches;
+}, {});
+exports.default = hash8strings;

package/cjs/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectURLParams = exports.joinURLs = exports.isNull = exports.isEmpty = exports.isClass = exports.hash8strings = exports.hash8object = exports.hash8json = exports.compareValue = exports.apiGet = exports.apiPost = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "apiPost", { enumerable: true, get: function () { return api_1.apiPost; } });
+Object.defineProperty(exports, "apiGet", { enumerable: true, get: function () { return api_1.apiGet; } });
+var value_1 = require("./compare/value");
+Object.defineProperty(exports, "compareValue", { enumerable: true, get: function () { return __importDefault(value_1).default; } });
+var json_1 = require("./convert/json");
+Object.defineProperty(exports, "hash8json", { enumerable: true, get: function () { return __importDefault(json_1).default; } });
+var object_1 = require("./convert/object");
+Object.defineProperty(exports, "hash8object", { enumerable: true, get: function () { return __importDefault(object_1).default; } });
+var strings_1 = require("./convert/strings");
+Object.defineProperty(exports, "hash8strings", { enumerable: true, get: function () { return __importDefault(strings_1).default; } });
+var class_1 = require("./is/class");
+Object.defineProperty(exports, "isClass", { enumerable: true, get: function () { return class_1.isClass; } });
+var empty_1 = require("./is/empty");
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return __importDefault(empty_1).default; } });
+var null_1 = require("./is/null");
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return __importDefault(null_1).default; } });
+var join_1 = require("./url/join");
+Object.defineProperty(exports, "joinURLs", { enumerable: true, get: function () { return join_1.joinURLs; } });
+var params_1 = require("./url/params");
+Object.defineProperty(exports, "connectURLParams", { enumerable: true, get: function () { return __importDefault(params_1).default; } });

package/cjs/is/class.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isClass = void 0;
+const re_anonymous = /^function\s+\(|^function\s+anonymous\(/;
+const re_function = /^function\s+[A-Z]/;
+const re_this = /\b\(this\b|\bthis[\.\[]\b/;
+const re_check = /classCallCheck\(this/;
+const re_default = /^function\sdefault_\d+\s*\(/;
+/**
+ * 检测是否为class
+ */
+const isClass = (value, strict = true) => {
+    if (typeof value !== 'function')
+        return false;
+    const proto = value.prototype;
+    if (!proto || proto.constructor !== value)
+        return false;
+    const str = value.toString();
+    if (str.slice(0, 5) === 'class'
+        || Object.getOwnPropertyNames(proto).length >= 2)
+        return true;
+    if (re_anonymous.test(str))
+        return false;
+    if (strict && re_function.test(str))
+        return true;
+    if (re_this.test(str)) {
+        if (!strict || re_check.test(str))
+            return true;
+        return re_default.test(str);
+    }
+    return false;
+};
+exports.isClass = isClass;

package/cjs/is/empty.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const null_1 = __importDefault(require("./null"));
+/**
+ * 检测是否为空(undefined/null/'')
+ */
+const isEmpty = (value) => (0, null_1.default)(value)
+    || value === '';
+exports.default = isEmpty;

package/cjs/is/null.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 检测是否无值(undefined/null)
+ */
+const isNull = (value) => value === void 0
+    || value === null;
+exports.default = isNull;

package/cjs/url/join.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinURLs = void 0;
+const re = /(^|[^:/])\/{2,}/g;
+/**
+ * 实现多个路径拼接
+ */
+const joinURLs = (...list) => {
+    const { length } = list;
+    if (length === 0)
+        return '';
+    return length === 1
+        ? list[0]
+        : list.join('/').replace(re, ($0, $1) => `${$1}/`);
+};
+exports.joinURLs = joinURLs;

package/cjs/url/params.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * url拼接参数
+ * @param url
+ * @param params 需要让url携带的参数
+ * @param isOpenType 是否开启类型处理
+ * @description 开始类型处理的情况下，undefined会被转成null
+ */
+const connectURLParams = (url, params, isOpenType) => {
+    if (!params)
+        return url;
+    const list = [];
+    for (const key in params) {
+        const value = params[key];
+        if (value === void 0) {
+            list.push(key);
+        }
+        else if (Array.isArray(value)) {
+            list.push(key
+                + '='
+                + (isOpenType
+                    ? JSON.stringify(value).slice(1, -1)
+                    : value.join(',')));
+        }
+        else {
+            list.push(key + '=' + (isOpenType ? JSON.stringify(value) : value.toString()));
+        }
+    }
+    if (!list.length)
+        return url;
+    const caches = list.join('&');
+    return url.includes('?')
+        ? url + '&' + caches
+        : url + '?' + caches;
+};
+exports.default = connectURLParams;

package/lib/api.js

@@ -0,0 +1,48 @@
+import connectURLParams from './url/params';
+const cut = (config, key) => {
+    if (key in config) {
+        const value = config[key];
+        delete config[key];
+        return value;
+    }
+};
+export const apiPost = (axios, handle) => {
+    function post(url, options, config) {
+        let twist;
+        let rejectValue = false;
+        if (config) {
+            twist = cut(config, 'twist');
+            const rejectValue0 = cut(config, 'rejectValue');
+            rejectValue0 !== void 0 && (rejectValue = rejectValue0);
+        }
+        return new Promise((resolve) => {
+            axios.post(url, options, config).then(
+            // @ts-ignore
+            resolve, (e) => {
+                twist ? twist(e) : handle(e);
+                resolve(rejectValue);
+            });
+        });
+    }
+    return post;
+};
+export const apiGet = (axios, handle) => {
+    function get(url, options, config) {
+        let twist;
+        let rejectValue = false;
+        if (config) {
+            twist = cut(config, 'twist');
+            const rejectValue0 = cut(config, 'rejectValue');
+            rejectValue0 !== void 0 && (rejectValue = rejectValue0);
+        }
+        return new Promise((resolve) => {
+            axios.get(connectURLParams(url, options), config).then(
+            // @ts-ignore
+            resolve, (e) => {
+                twist ? twist(e) : handle(e);
+                resolve(rejectValue);
+            });
+        });
+    }
+    return get;
+};

package/lib/compare/value.js

@@ -0,0 +1,39 @@
+/**
+ * 值比较(深度浅比较)
+ */
+const compareValue = (from, to) => {
+    if (typeof from !== 'object'
+        || from === null
+        || typeof to !== 'object'
+        || to === null)
+        return from === to;
+    if (Array.isArray(from) && Array.isArray(to)) {
+        if (from.length !== to.length)
+            return false;
+        return !from.some((t1, index) => {
+            if (!compareValue(t1, to[index])) {
+                return true;
+            }
+        });
+    }
+    else {
+        const caches = {};
+        for (const key in from) {
+            if (!compareValue(from[key], to[key])) {
+                return false;
+            }
+            else {
+                caches[key] = key;
+            }
+        }
+        for (const key in to) {
+            if (key in caches)
+                continue;
+            if (!compareValue(from[key], to[key])) {
+                return false;
+            }
+        }
+    }
+    return true;
+};
+export default compareValue;

package/lib/convert/json.js

@@ -0,0 +1,16 @@
+/**
+ * 对象数组转hash(要求主键值为string类型)
+ * @example
+ *  hash8json(
+ *    [
+ *      { key: 'a', value: 1 },
+ *      { key: 'b', value: 2 }
+ *    ],
+ *    'key'
+ *  ).a.value // 1
+ */
+const hash8json = (list, key) => list.reduce((caches, data) => {
+    caches[data[key]] = data;
+    return caches;
+}, {});
+export default hash8json;

package/lib/convert/object.js

@@ -0,0 +1,16 @@
+/**
+ * 对象数组转hash
+ * @example
+ *  hash8object(
+ *    [
+ *      { key: String, value: 1 },
+ *      { key: Object, value: 2 }
+ *    ],
+ *    'key'
+ *  ).get(Object).value // 2
+ */
+const hash8object = (list, key) => list.reduce((caches, data) => {
+    caches.set(data[key], data);
+    return caches;
+}, new Map());
+export default hash8object;

package/lib/convert/strings.js

@@ -0,0 +1,10 @@
+/**
+ * 字符数组转hash
+ * @example
+ *  hash8strings(['a', 'b']).a // 0
+ */
+const hash8strings = (list) => list.reduce((caches, data, index) => {
+    caches[data] = index;
+    return caches;
+}, {});
+export default hash8strings;

package/lib/index.js

@@ -0,0 +1,10 @@
+export { apiPost, apiGet } from './api';
+export { default as compareValue } from './compare/value';
+export { default as hash8json } from './convert/json';
+export { default as hash8object } from './convert/object';
+export { default as hash8strings } from './convert/strings';
+export { isClass } from './is/class';
+export { default as isEmpty } from './is/empty';
+export { default as isNull } from './is/null';
+export { joinURLs } from './url/join';
+export { default as connectURLParams } from './url/params';

package/lib/is/class.js

@@ -0,0 +1,29 @@
+const re_anonymous = /^function\s+\(|^function\s+anonymous\(/;
+const re_function = /^function\s+[A-Z]/;
+const re_this = /\b\(this\b|\bthis[\.\[]\b/;
+const re_check = /classCallCheck\(this/;
+const re_default = /^function\sdefault_\d+\s*\(/;
+/**
+ * 检测是否为class
+ */
+export const isClass = (value, strict = true) => {
+    if (typeof value !== 'function')
+        return false;
+    const proto = value.prototype;
+    if (!proto || proto.constructor !== value)
+        return false;
+    const str = value.toString();
+    if (str.slice(0, 5) === 'class'
+        || Object.getOwnPropertyNames(proto).length >= 2)
+        return true;
+    if (re_anonymous.test(str))
+        return false;
+    if (strict && re_function.test(str))
+        return true;
+    if (re_this.test(str)) {
+        if (!strict || re_check.test(str))
+            return true;
+        return re_default.test(str);
+    }
+    return false;
+};

package/lib/is/empty.js

@@ -0,0 +1,7 @@
+import isNull from './null';
+/**
+ * 检测是否为空(undefined/null/'')
+ */
+const isEmpty = (value) => isNull(value)
+    || value === '';
+export default isEmpty;

package/lib/is/null.js

@@ -0,0 +1,6 @@
+/**
+ * 检测是否无值(undefined/null)
+ */
+const isNull = (value) => value === void 0
+    || value === null;
+export default isNull;

package/lib/url/join.js

@@ -0,0 +1,12 @@
+const re = /(^|[^:/])\/{2,}/g;
+/**
+ * 实现多个路径拼接
+ */
+export const joinURLs = (...list) => {
+    const { length } = list;
+    if (length === 0)
+        return '';
+    return length === 1
+        ? list[0]
+        : list.join('/').replace(re, ($0, $1) => `${$1}/`);
+};

package/lib/url/params.js

@@ -0,0 +1,35 @@
+/**
+ * url拼接参数
+ * @param url
+ * @param params 需要让url携带的参数
+ * @param isOpenType 是否开启类型处理
+ * @description 开始类型处理的情况下，undefined会被转成null
+ */
+const connectURLParams = (url, params, isOpenType) => {
+    if (!params)
+        return url;
+    const list = [];
+    for (const key in params) {
+        const value = params[key];
+        if (value === void 0) {
+            list.push(key);
+        }
+        else if (Array.isArray(value)) {
+            list.push(key
+                + '='
+                + (isOpenType
+                    ? JSON.stringify(value).slice(1, -1)
+                    : value.join(',')));
+        }
+        else {
+            list.push(key + '=' + (isOpenType ? JSON.stringify(value) : value.toString()));
+        }
+    }
+    if (!list.length)
+        return url;
+    const caches = list.join('&');
+    return url.includes('?')
+        ? url + '&' + caches
+        : url + '?' + caches;
+};
+export default connectURLParams;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@vope/utils",
+  "version": "1.0.0",
+  "description": "",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "types": "./types/index.d.ts",
+  "module": "./lib/index.js",
+  "main": "./cjs/index.js",
+  "scripts": {
+    "build": "rimraf types & npm run cjs | npm run esm",
+    "cjs": "rimraf cjs & npx tsc -p ./tsconfig.cjs.json",
+    "esm": "rimraf lib & npx tsc -p ./tsconfig.esm.json",
+    "trove": "node ./__devs/trove.cjs",
+    "trove:build": "npm run devs & npm run trove",
+    "devs": "rimraf __devs & npx tsc -p ./tsconfig.devs.json",
+    "test": "mocha __tests/**/*.js",
+    "test:dev": "npm run test:build & npm run test",
+    "test:build": "rimraf __tests & rimraf lib  & node ./__devs/test.cjs",
+    "test:all": "npm run devs & npm run test:build & npm run test",
+    "postinstall": "npm run devs & npm run trove & npm run test:build",
+    "prepublishOnly": "npm run devs & npm run trove & npm run build"
+  },
+  "exports": {
+    ".": {
+      "import": "./lib/index.js",
+      "require": "./cjs/index.js"
+    }
+  },
+  "author": "vope",
+  "license": "ISC",
+  "devDependencies": {
+    "@babel/core": "^7.22.9",
+    "@babel/generator": "^7.22.9",
+    "@babel/parser": "^7.22.7",
+    "@babel/traverse": "^7.22.8",
+    "@babel/types": "^7.22.5",
+    "@rollup/plugin-alias": "^5.0.0",
+    "@rollup/plugin-typescript": "^11.1.2",
+    "@types/babel__generator": "^7.6.4",
+    "@types/babel__traverse": "^7.20.1",
+    "@types/mocha": "^10.0.1",
+    "@types/node": "^20.4.5",
+    "@vope/types": "^1.0.0",
+    "mocha": "^10.2.0",
+    "rimraf": "^5.0.1",
+    "rollup": "^3.27.1",
+    "tslib": "^2.6.1",
+    "typescript": "^5.1.6"
+  },
+  "dependencies": {
+    "axios": "^1.4.0"
+  },
+  "files": [
+    "cjs",
+    "lib",
+    "types"
+  ]
+}

package/types/api.d.ts

@@ -0,0 +1,19 @@
+import { ReviseRequired } from '@vope/types';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import connectURLParams from './url/params';
+interface Config<V> extends AxiosRequestConfig {
+    /** 变更默认错误返回值 */
+    rejectValue?: V;
+    /** 错误拦截 */
+    twist?: (e: Error) => void;
+}
+type Options = NonNullable<Parameters<typeof connectURLParams>[1]>;
+export declare const apiPost: (axios: AxiosInstance, handle: (e: Error) => void) => {
+    <T, V extends false = false>(url: string, options?: Options, config?: Config<V> | undefined): Promise<T | V>;
+    <T_1, V_1 extends string | symbol>(url: string, options: Options | undefined, config: ReviseRequired<Config<V_1>, "rejectValue">): Promise<T_1 | V_1>;
+};
+export declare const apiGet: (axios: AxiosInstance, handle: (e: Error) => void) => {
+    <T, V extends false = false>(url: string, options?: Options, config?: Config<V> | undefined): Promise<T | V>;
+    <T_1, V_1 extends string | symbol>(url: string, options: Options | undefined, config: ReviseRequired<Config<V_1>, "rejectValue">): Promise<T_1 | V_1>;
+};
+export {};

package/types/compare/value.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 值比较(深度浅比较)
+ */
+declare const compareValue: (from: any, to: any) => boolean;
+export default compareValue;

package/types/convert/json.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 对象数组转hash(要求主键值为string类型)
+ * @example
+ *  hash8json(
+ *    [
+ *      { key: 'a', value: 1 },
+ *      { key: 'b', value: 2 }
+ *    ],
+ *    'key'
+ *  ).a.value // 1
+ */
+declare const hash8json: <K extends string | symbol, T extends Record<K, string>>(list: T[], key: K) => Record<T[K], T>;
+export default hash8json;

package/types/convert/object.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 对象数组转hash
+ * @example
+ *  hash8object(
+ *    [
+ *      { key: String, value: 1 },
+ *      { key: Object, value: 2 }
+ *    ],
+ *    'key'
+ *  ).get(Object).value // 2
+ */
+declare const hash8object: <K extends string | symbol, T extends Record<K, unknown>>(list: T[], key: K) => Map<T[K], T>;
+export default hash8object;

package/types/convert/strings.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 字符数组转hash
+ * @example
+ *  hash8strings(['a', 'b']).a // 0
+ */
+declare const hash8strings: <T extends string | number>(list: T[]) => { [P in T]: number; };
+export default hash8strings;

package/types/index.d.ts

@@ -0,0 +1,10 @@
+export { apiPost, apiGet } from './api';
+export { default as compareValue } from './compare/value';
+export { default as hash8json } from './convert/json';
+export { default as hash8object } from './convert/object';
+export { default as hash8strings } from './convert/strings';
+export { isClass } from './is/class';
+export { default as isEmpty } from './is/empty';
+export { default as isNull } from './is/null';
+export { joinURLs } from './url/join';
+export { default as connectURLParams } from './url/params';

package/types/is/class.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 检测是否为class
+ */
+export declare const isClass: (value: any, strict?: boolean) => value is new (...args: any) => any;

package/types/is/empty.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 检测是否为空(undefined/null/'')
+ */
+declare const isEmpty: (value: any) => value is "" | null | undefined;
+export default isEmpty;

package/types/is/null.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 检测是否无值(undefined/null)
+ */
+declare const isNull: (value: any) => value is null | undefined;
+export default isNull;

package/types/url/join.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 实现多个路径拼接
+ */
+export declare const joinURLs: (...list: string[]) => string;

package/types/url/params.d.ts

@@ -0,0 +1,11 @@
+type Param = string | number | boolean | undefined;
+type Params = Param | Param[];
+/**
+ * url拼接参数
+ * @param url
+ * @param params 需要让url携带的参数
+ * @param isOpenType 是否开启类型处理
+ * @description 开始类型处理的情况下，undefined会被转成null
+ */
+declare const connectURLParams: (url: string, params?: Record<string, Params>, isOpenType?: boolean) => string;
+export default connectURLParams;