ph-utils 0.9.4 → 0.9.6

package/lib/file.d.ts

@@ -8,7 +8,7 @@
  * @param defaultValue 文件不存在时默认值, 不传则抛异常, 如果传递的是对象形式则会将结果转换为 JSON
  * @returns 文件内容
  */
-export declare function read<T>(filepath: string, defaultValue?: T): Promise<any>;
+export declare function read<T>(filepath: string, defaultValue?: T): Promise<T>;
 /**
  * 写入 JSON 格式的数据到文件
  * @param file 待写入的文件

package/lib/index.d.ts

@@ -122,4 +122,8 @@ export declare function snakeCaseStyle(name: string, connector?: string): string
  * @returns 返回经过指定方式舍入后的数字
  */
 export declare function round(num: number, precision?: number, roundType?: 0 | 1 | 2): number;
+/**
+ * 反转字符串
+ */
+export declare function reverseStr(str: string): string;
 export {};

package/lib/index.js

@@ -88,11 +88,6 @@ export function random(opts) {
  * 带有错误名称标记的错误类型
  */
 export class BaseError extends Error {
-    /**
-     * 错误名称，类似于 Java 中的不同的 Exception[NullPointerException]；
-     * 增加 name 字段，表明不同的错误，当需要根据不同的错误执行不同的处理的时候，会很有用
-     */
-    name;
     constructor() {
         if (arguments.length === 1) {
             super(arguments[0]);
@@ -172,3 +167,9 @@ export function round(num, precision = 2, roundType = 0) {
             return num;
     }
 }
+/**
+ * 反转字符串
+ */
+export function reverseStr(str) {
+    return str.split("").reverse().join("");
+}

package/lib/logger.js

@@ -3,17 +3,16 @@ import { format } from "./date";
  * 日志记录器
  */
 export class Logger {
-    /** 日志级别 */
-    levels = ["debug", "info", "warn", "error", "fatal"];
-    colors = {
-        debug: "#909399",
-        info: "#1677ff",
-        warn: "#fadb14",
-        error: "#eb2f96",
-    };
-    option;
     /** 构造日志记录器 */
     constructor(option) {
+        /** 日志级别 */
+        this.levels = ["debug", "info", "warn", "error", "fatal"];
+        this.colors = {
+            debug: "#909399",
+            info: "#1677ff",
+            warn: "#fadb14",
+            error: "#eb2f96",
+        };
         this.setOption(option || {});
     }
     setOption(option) {

package/lib/server.d.ts

@@ -8,3 +8,23 @@ import type { SpawnOptions } from "node:child_process";
 export declare function exec(command: string, args?: string[]): Promise<string>;
 export declare function exec(command: string, options?: SpawnOptions): Promise<string>;
 export declare function exec(command: string, args?: string[], options?: SpawnOptions): Promise<string>;
+/**
+ * 解析环境变量;
+ * 同时读取多个环境变量文件: .env, .env.local, .env.[development|test|production];
+ * 根据运行环境变量 `NODE_ENV` 读取不同的环境变量文件;
+ * 同时支持手动通过运行命令指定 `NODE_ENV` 值, 不指定默认为: production
+ *
+ * ```bash
+ * node test.js --NODE_ENV development
+ * // or
+ * node test.js -n development
+ * ```
+ *
+ * ```js
+ * // test.js
+ * await parseEnvs();
+ * ```
+ *
+ * @returns
+ */
+export declare function parseEnvs(): Promise<Record<string, string>>;

package/lib/server.js

@@ -1,4 +1,6 @@
 import { spawn } from "node:child_process";
+import { parseEnv, parseArgs } from "node:util";
+import { read } from "./file.js";
 /**
  * 执行命令
  * @param cmd 执行的命令
@@ -36,7 +38,7 @@ export function exec(command, ...params) {
         prs.on("error", (err) => {
             error = err;
         });
-        prs.on("close", (code, signal) => {
+        prs.on("close", (code, _signal) => {
             if (code === 0) {
                 resolve(msg.join("\n"));
             }
@@ -50,3 +52,56 @@ export function exec(command, ...params) {
         });
     });
 }
+/**
+ * 解析环境变量;
+ * 同时读取多个环境变量文件: .env, .env.local, .env.[development|test|production];
+ * 根据运行环境变量 `NODE_ENV` 读取不同的环境变量文件;
+ * 同时支持手动通过运行命令指定 `NODE_ENV` 值, 不指定默认为: production
+ *
+ * ```bash
+ * node test.js --NODE_ENV development
+ * // or
+ * node test.js -n development
+ * ```
+ *
+ * ```js
+ * // test.js
+ * await parseEnvs();
+ * ```
+ *
+ * @returns
+ */
+export async function parseEnvs() {
+    // development, test, production
+    const files = [".env", ".env.local"];
+    let nodeEnv = process.env.NODE_ENV;
+    const { values } = parseArgs({
+        options: {
+            NODE_ENV: {
+                type: "string",
+                short: "n",
+            },
+        },
+    });
+    if (values.NODE_ENV != null) {
+        nodeEnv = values.NODE_ENV;
+    }
+    else {
+        nodeEnv = "production";
+    }
+    process.env.NODE_ENV = nodeEnv;
+    files.push(`.env.${values.NODE_ENV}`);
+    let envParsed = {};
+    for (let i = 0, len = files.length; i < len; i++) {
+        const file = files[i];
+        const envContent = await read(file, "");
+        if (envContent !== "") {
+            const envValue = parseEnv(envContent);
+            envParsed = { ...envParsed, ...envValue };
+        }
+    }
+    for (const key in envParsed) {
+        process.env[key] = envParsed[key];
+    }
+    return envParsed;
+}

package/lib/storage.d.ts

@@ -13,6 +13,12 @@ interface StorageSetOption {
  * @param value 设置的值
  * @param [option.storage] session 或 local, 默认: session
  * @param [option.expire] 数据有效期, 单位秒, 默认: -1 - 永久存储
+ *
+ * @example <caption>1. 存储到 SessionStorage</caption>
+ * set("key", "value");
+ *
+ * @example <caption>2. 存储到 LocalStorage</caption>
+ * set("key", "value", { storage: "local" });
  */
 export declare function set(key: string, value: any, option?: StorageSetOption): void;
 /**

package/lib/storage.js

@@ -7,6 +7,12 @@ function getStorage(storage = "session") {
  * @param value 设置的值
  * @param [option.storage] session 或 local, 默认: session
  * @param [option.expire] 数据有效期, 单位秒, 默认: -1 - 永久存储
+ *
+ * @example <caption>1. 存储到 SessionStorage</caption>
+ * set("key", "value");
+ *
+ * @example <caption>2. 存储到 LocalStorage</caption>
+ * set("key", "value", { storage: "local" });
  */
 export function set(key, value, option) {
     const opts = {

package/lib/validator.js

@@ -32,8 +32,6 @@ const ruleFns = {
     },
 };
 class ValidateError extends Error {
-    name;
-    key;
     constructor(key, msg) {
         super(msg);
         this.name = "ValidateError";
@@ -44,7 +42,6 @@ class ValidateError extends Error {
  * 数据验证器
  */
 class Validator {
-    rules;
     /**
      * 构造数据验证转换器
      *

package/package.json

@@ -18,6 +18,10 @@
       "types": "./lib/date.d.ts",
       "import": "./lib/date.js"
     },
+    "./server": {
+      "types": "./lib/server.d.ts",
+      "import": "./lib/server.js"
+    },
     "./validator": {
       "types": "./lib/validator.d.ts",
       "import": "./lib/validator.js"
@@ -64,7 +68,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.9.4",
+  "version": "0.9.6",
   "type": "module",
   "repository": {
     "type": "git",