@anjianshi/utils 2.1.4 → 2.1.5

package/env-node/env-reader.d.ts

@@ -1,3 +1,9 @@
+type EnvValue = string | number | boolean | unknown[] | Record<string, unknown>;
+type TypeDef = 'string' | 'number' | 'boolean' | unknown[] | Record<string, unknown>;
+type TypeFrom<D extends TypeDef> = D extends 'string' ? string : D extends 'number' ? number : D extends 'boolean' ? boolean : D;
+type ResultFrom<Defs extends Record<string, TypeDef>> = {
+    [K in keyof Defs]: TypeFrom<Defs[K]>;
+};
 /**
  * 读取 .env 文件，并获取格式化后的数据
  * 注意：依赖 dotenv 包
@@ -24,4 +30,21 @@ export declare class EnvReader {
     getByType(key: string, type: 'number'): number;
     getByType(key: string, type: 'boolean'): boolean;
     getByType<T extends unknown[] | Record<string, unknown>>(key: string, type: 'json'): T;
+    /**
+     * 同 envReader.get()，只不过是通过对象指定各 env 的默认值来批量获取
+     * envReader.batchGet({ port: 8000, debug: false, mobiles: ['123', '456'] }
+     */
+    batchGet<Defs extends Record<string, EnvValue>>(definitions: Defs): Defs;
+    /**
+     * 同 envReader.getByType()，只不过是通过对象指定各 env 的类型来批量获取
+     *
+     * envReader.batchGetByType({
+     *   port: 'number',
+     *   debug: 'boolean',
+     *   mobiles: [] as string[],  // 用此格式定义内容是数组的 JSON 值
+     *   obj: {} as { a: number, b: string } // 用此格式定义内容是对象的 JSON 值
+     * }
+     */
+    batchGetByType<Defs extends Record<string, TypeDef>>(definitions: Defs): Partial<ResultFrom<Defs>>;
 }
+export {};

package/env-node/env-reader.js

@@ -52,4 +52,33 @@ export class EnvReader {
             return safeParseJSON(raw);
         return raw;
     }
+    /**
+     * 同 envReader.get()，只不过是通过对象指定各 env 的默认值来批量获取
+     * envReader.batchGet({ port: 8000, debug: false, mobiles: ['123', '456'] }
+     */
+    batchGet(definitions) {
+        const result = {};
+        for (const [key, defaults] of Object.entries(definitions)) {
+            result[key] = this.get(key, defaults);
+        }
+        return result;
+    }
+    /**
+     * 同 envReader.getByType()，只不过是通过对象指定各 env 的类型来批量获取
+     *
+     * envReader.batchGetByType({
+     *   port: 'number',
+     *   debug: 'boolean',
+     *   mobiles: [] as string[],  // 用此格式定义内容是数组的 JSON 值
+     *   obj: {} as { a: number, b: string } // 用此格式定义内容是对象的 JSON 值
+     * }
+     */
+    batchGetByType(definitions) {
+        const result = {};
+        for (const [key, def] of Object.entries(definitions)) {
+            result[key] =
+                typeof def === 'string' ? this.getByType(key, def) : this.getByType(key, 'json');
+        }
+        return result;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anjianshi/utils",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "Common JavaScript Utils",
   "homepage": "https://github.com/anjianshi/js-packages/utils",
   "bugs": {
@@ -28,8 +28,8 @@
     "typescript": "^5.4.4",
     "@anjianshi/presets-eslint-typescript": "4.0.4",
     "@anjianshi/presets-eslint-node": "4.0.4",
-    "@anjianshi/presets-typescript": "3.1.4",
-    "@anjianshi/presets-prettier": "3.0.0"
+    "@anjianshi/presets-prettier": "3.0.0",
+    "@anjianshi/presets-typescript": "3.1.4"
   },
   "peerDependencies": {
     "chalk": "^5.3.0",