lupine.api 1.1.58 → 1.1.60

package/src/lib/utils/deep-merge.ts

@@ -1,37 +1,37 @@
-/**
- * Simple object check.
- * @param item
- * @returns {boolean}
- */
-const needMerge = (item: any) => {
-  return item && typeof item === 'object' && !Array.isArray(item);
-};
-
-/**
- * Deep merge two objects.
- * target must be a object, and array will be replaced
- * @param target
- * @param ...sources
- */
-export const deepMerge = (target: any, ...sources: any[]): any => {
-  if (!sources.length) return target;
-  const source = sources.shift();
-
-  if (needMerge(target) && needMerge(source)) {
-    for (const key in source) {
-      if (needMerge(source[key])) {
-        if (!target[key]) Object.assign(target, { [key]: {} });
-        deepMerge(target[key], source[key]);
-      } else {
-        Object.assign(target, { [key]: source[key] });
-      }
-    }
-  }
-
-  return deepMerge(target, ...sources);
-};
-
-// Clone data object only
-export const cloneJson = (json: any) => {
-  return JSON.parse(JSON.stringify(json));
-};
+/**
+ * Simple object check.
+ * @param item
+ * @returns {boolean}
+ */
+const needMerge = (item: any) => {
+  return item && typeof item === 'object' && !Array.isArray(item);
+};
+
+/**
+ * Deep merge two objects.
+ * target must be a object, and array will be replaced
+ * @param target
+ * @param ...sources
+ */
+export const deepMerge = (target: any, ...sources: any[]): any => {
+  if (!sources.length) return target;
+  const source = sources.shift();
+
+  if (needMerge(target) && needMerge(source)) {
+    for (const key in source) {
+      if (needMerge(source[key])) {
+        if (!target[key]) Object.assign(target, { [key]: {} });
+        deepMerge(target[key], source[key]);
+      } else {
+        Object.assign(target, { [key]: source[key] });
+      }
+    }
+  }
+
+  return deepMerge(target, ...sources);
+};
+
+// Clone data object only
+export const cloneJson = (json: any) => {
+  return JSON.parse(JSON.stringify(json));
+};

package/src/lib/utils/delay.ts

@@ -1,12 +1,12 @@
-/*
-delay(3000).then(() => alert('runs after 3 seconds'));
-or
-await delay(3000);
-*/
-export const delay = (ms: number) => {
-  return new Promise<void>((resolve, reject) => {
-    setTimeout(() => {
-      resolve();
-    }, ms);
-  });
-};
+/*
+delay(3000).then(() => alert('runs after 3 seconds'));
+or
+await delay(3000);
+*/
+export const delay = (ms: number) => {
+  return new Promise<void>((resolve, reject) => {
+    setTimeout(() => {
+      resolve();
+    }, ms);
+  });
+};

package/src/lib/utils/file-setting.ts

@@ -1,55 +1,55 @@
-import { Logger } from '../logger';
-import { FsUtils } from './fs-utils';
-
-const logger = new Logger('setting-file');
-
-export type FileSettingProps = {
-  [key: string]: string | number | boolean | object;
-};
-
-/**
- * A simple settings/config class for storing key/value pairs with persistence.
- */
-export class FileSetting {
-  private settings: FileSettingProps = {};
-
-  constructor() {}
-
-  async load(path: string) {
-    let json;
-    if ((json = await FsUtils.readFile(path))) {
-      try {
-        const jsonObject = JSON.parse(json);
-        Object.assign(this.settings, jsonObject);
-      } catch (e: any) {
-        logger.error('Loading json file failed', e.message);
-      }
-    }
-  }
-
-  async save(path: string) {
-    await FsUtils.writeFile(path, JSON.stringify(this.settings));
-  }
-
-  set(key: string, value: string | number | boolean | object | undefined) {
-    if (value === undefined) {
-      delete this.settings[key];
-    } else {
-      this.settings[key] = value;
-    }
-  }
-
-  setAll(values: FileSettingProps) {
-    for (let k in values) {
-      this.settings[k] = values[k];
-    }
-  }
-
-  get(key: string, defaultValue: string | number | boolean | object): string | number | boolean | object {
-    return key in this.settings ? this.settings[key] : defaultValue;
-  }
-
-  get getAll(): FileSettingProps {
-    return this.settings;
-  }
-}
+import { Logger } from '../logger';
+import { FsUtils } from './fs-utils';
+
+const logger = new Logger('setting-file');
+
+export type FileSettingProps = {
+  [key: string]: string | number | boolean | object;
+};
+
+/**
+ * A simple settings/config class for storing key/value pairs with persistence.
+ */
+export class FileSetting {
+  private settings: FileSettingProps = {};
+
+  constructor() {}
+
+  async load(path: string) {
+    let json;
+    if ((json = await FsUtils.readFile(path))) {
+      try {
+        const jsonObject = JSON.parse(json);
+        Object.assign(this.settings, jsonObject);
+      } catch (e: any) {
+        logger.error('Loading json file failed', e.message);
+      }
+    }
+  }
+
+  async save(path: string) {
+    await FsUtils.writeFile(path, JSON.stringify(this.settings));
+  }
+
+  set(key: string, value: string | number | boolean | object | undefined) {
+    if (value === undefined) {
+      delete this.settings[key];
+    } else {
+      this.settings[key] = value;
+    }
+  }
+
+  setAll(values: FileSettingProps) {
+    for (let k in values) {
+      this.settings[k] = values[k];
+    }
+  }
+
+  get(key: string, defaultValue: string | number | boolean | object): string | number | boolean | object {
+    return key in this.settings ? this.settings[key] : defaultValue;
+  }
+
+  get getAll(): FileSettingProps {
+    return this.settings;
+  }
+}

package/src/lib/utils/format-bytes.ts

@@ -1,11 +1,11 @@
-export const formatBytes = (bytes: number, decimals = 2) => {
-  if (!+bytes) return '0 Bytes';
-
-  const k = 1024;
-  const dm = decimals < 0 ? 0 : decimals;
-  const sizes = ['Bytes', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
-
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-
-  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
-};
+export const formatBytes = (bytes: number, decimals = 2) => {
+  if (!+bytes) return '0 Bytes';
+
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ['Bytes', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+};

package/src/lib/utils/fs-utils.ts

@@ -1,158 +1,158 @@
-import { Dirent } from 'fs';
-import * as fs from 'fs/promises';
-import path from 'path';
-
-export type FileInfoProps = {
-  size: number;
-  mtime: number;
-  isFile: boolean;
-  isDir: boolean;
-};
-export class FsUtils {
-  static readFile = async (filePath: string): Promise<string | undefined> => {
-    try {
-      const text = await fs.readFile(filePath, 'utf-8');
-      return text;
-    } catch (e) {
-      console.log('writeFile failed', e);
-      return undefined;
-    }
-  };
-
-  static fileInfo = async (filePath: string): Promise<FileInfoProps | undefined> => {
-    try {
-      const stats = await fs.stat(filePath);
-      return { size: stats.size, mtime: stats.mtime.getTime(), isFile: stats.isFile(), isDir: stats.isDirectory() };
-    } catch {
-      return undefined;
-    }
-  };
-
-  static writeFile = async (
-    filePath: string,
-    content:
-      | string
-      | NodeJS.ArrayBufferView
-      | Iterable<string | NodeJS.ArrayBufferView>
-      | AsyncIterable<string | NodeJS.ArrayBufferView>
-  ): Promise<boolean> => {
-    try {
-      await fs.writeFile(filePath, content, 'utf-8');
-      return true;
-    } catch (e) {
-      console.log('writeFile failed', e);
-      return false;
-    }
-  };
-
-  static appendFile = async (filePath: string, content: string | Uint8Array): Promise<boolean> => {
-    try {
-      await fs.appendFile(filePath, content, 'utf-8');
-      return true;
-    } catch (e) {
-      console.log('appendFile failed', e);
-      return false;
-    }
-  };
-
-  static pathExist = async (filePath: string) => {
-    try {
-      await fs.access(filePath);
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  static mkdir = async (dirPath: string) => {
-    try {
-      await fs.mkdir(dirPath, { recursive: true });
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  static unlinkFile = async (filePath: string) => {
-    try {
-      await fs.unlink(filePath);
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  static unlinkFolderEmpty = async (filePath: string) => {
-    try {
-      await fs.rmdir(filePath);
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  static unlinkFolderForce = async (filePath: string, recursive: boolean, force: boolean) => {
-    try {
-      await fs.rm(filePath, { recursive: recursive, force: force });
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  static rename = async (filePath: string, newPath: string) => {
-    try {
-      await fs.rename(filePath, newPath);
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  static getDirAndFiles = async (dirPath: string): Promise<string[]> => {
-    try {
-      const files = await fs.readdir(dirPath, { recursive: false });
-      return files;
-    } catch {
-      return [];
-    }
-  };
-
-  // return with fullpath list of Dirent
-  static getDirsFullpath = async (dirPath: string, maxDepth = 1): Promise<Dirent[]> => {
-    return this.getDirsFullpathDepthSub(dirPath, 0, maxDepth);
-  };
-  private static getDirsFullpathDepthSub = async (dirPath: string, depth = 0, maxDepth = 1): Promise<Dirent[]> => {
-    try {
-      const ret = [];
-      const files = await fs.readdir(dirPath, {
-        recursive: false,
-        withFileTypes: true,
-      });
-      ret.push(...files);
-      if (depth + 1 < maxDepth) {
-        for (const entry of files) {
-          if (entry.isDirectory()) {
-            const fullPath = path.join(dirPath, entry.name);
-            ret.push(...(await this.getDirsFullpathDepthSub(fullPath, depth + 1, maxDepth)));
-          }
-        }
-      }
-      return ret;
-    } catch {
-      return [];
-    }
-  };
-
-  static async readPartOfFile(path: string, start: number, length: number) {
-    try {
-      const fileHandle = await fs.open(path, 'r');
-      const buffer = Buffer.alloc(length);
-      const { bytesRead } = await fileHandle.read(buffer, 0, length, start);
-      await fileHandle.close();
-      return buffer.slice(0, bytesRead);
-    } catch {
-      return null;
-    }
-  }
-}
+import { Dirent } from 'fs';
+import * as fs from 'fs/promises';
+import path from 'path';
+
+export type FileInfoProps = {
+  size: number;
+  mtime: number;
+  isFile: boolean;
+  isDir: boolean;
+};
+export class FsUtils {
+  static readFile = async (filePath: string): Promise<string | undefined> => {
+    try {
+      const text = await fs.readFile(filePath, 'utf-8');
+      return text;
+    } catch (e) {
+      console.log('writeFile failed', e);
+      return undefined;
+    }
+  };
+
+  static fileInfo = async (filePath: string): Promise<FileInfoProps | undefined> => {
+    try {
+      const stats = await fs.stat(filePath);
+      return { size: stats.size, mtime: stats.mtime.getTime(), isFile: stats.isFile(), isDir: stats.isDirectory() };
+    } catch {
+      return undefined;
+    }
+  };
+
+  static writeFile = async (
+    filePath: string,
+    content:
+      | string
+      | NodeJS.ArrayBufferView
+      | Iterable<string | NodeJS.ArrayBufferView>
+      | AsyncIterable<string | NodeJS.ArrayBufferView>
+  ): Promise<boolean> => {
+    try {
+      await fs.writeFile(filePath, content, 'utf-8');
+      return true;
+    } catch (e) {
+      console.log('writeFile failed', e);
+      return false;
+    }
+  };
+
+  static appendFile = async (filePath: string, content: string | Uint8Array): Promise<boolean> => {
+    try {
+      await fs.appendFile(filePath, content, 'utf-8');
+      return true;
+    } catch (e) {
+      console.log('appendFile failed', e);
+      return false;
+    }
+  };
+
+  static pathExist = async (filePath: string) => {
+    try {
+      await fs.access(filePath);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  static mkdir = async (dirPath: string) => {
+    try {
+      await fs.mkdir(dirPath, { recursive: true });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  static unlinkFile = async (filePath: string) => {
+    try {
+      await fs.unlink(filePath);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  static unlinkFolderEmpty = async (filePath: string) => {
+    try {
+      await fs.rmdir(filePath);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  static unlinkFolderForce = async (filePath: string, recursive: boolean, force: boolean) => {
+    try {
+      await fs.rm(filePath, { recursive: recursive, force: force });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  static rename = async (filePath: string, newPath: string) => {
+    try {
+      await fs.rename(filePath, newPath);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  static getDirAndFiles = async (dirPath: string): Promise<string[]> => {
+    try {
+      const files = await fs.readdir(dirPath, { recursive: false });
+      return files;
+    } catch {
+      return [];
+    }
+  };
+
+  // return with fullpath list of Dirent
+  static getDirentFullpath = async (dirPath: string, maxDepth = 1): Promise<Dirent[]> => {
+    return this.getDirentFullpathDepthSub(dirPath, 0, maxDepth);
+  };
+  private static getDirentFullpathDepthSub = async (dirPath: string, depth = 0, maxDepth = 1): Promise<Dirent[]> => {
+    try {
+      const ret = [];
+      const files = await fs.readdir(dirPath, {
+        recursive: false,
+        withFileTypes: true,
+      });
+      ret.push(...files);
+      if (depth + 1 < maxDepth) {
+        for (const entry of files) {
+          if (entry.isDirectory()) {
+            const fullPath = path.join(dirPath, entry.name);
+            ret.push(...(await this.getDirentFullpathDepthSub(fullPath, depth + 1, maxDepth)));
+          }
+        }
+      }
+      return ret;
+    } catch {
+      return [];
+    }
+  };
+
+  static async readPartOfFile(path: string, start: number, length: number) {
+    try {
+      const fileHandle = await fs.open(path, 'r');
+      const buffer = Buffer.alloc(length);
+      const { bytesRead } = await fileHandle.read(buffer, 0, length, start);
+      await fileHandle.close();
+      return buffer.slice(0, bytesRead);
+    } catch {
+      return null;
+    }
+  }
+}

package/src/lib/utils/get-env.ts

@@ -1,27 +1,27 @@
-function getEnv(key: string, defaultValue: number): number;
-function getEnv(key: string, defaultValue: string): string;
-function getEnv(key: string, defaultValue: boolean): boolean;
-function getEnv(key: string, defaultValue: object): object;
-function getEnv(key: string, defaultValue: any): any {
-  if (typeof process.env[key] === 'undefined') {
-    return defaultValue;
-  }
-
-  if (typeof defaultValue === 'number') {
-    return Number.parseInt(process.env[key]!);
-  }
-  if (typeof defaultValue === 'boolean') {
-    return process.env[key]!.toLocaleLowerCase() === 'true' || process.env[key] === '1';
-  }
-  if (typeof defaultValue === 'object') {
-    try {
-      return JSON.parse(process.env[key]!);
-    } catch (error) {}
-    return defaultValue;
-  }
-  // if (typeof defaultValue === 'string') {
-  //   return process.env[key];
-  // }
-  return process.env[key];
-}
-export { getEnv };
+function getEnv(key: string, defaultValue: number): number;
+function getEnv(key: string, defaultValue: string): string;
+function getEnv(key: string, defaultValue: boolean): boolean;
+function getEnv(key: string, defaultValue: object): object;
+function getEnv(key: string, defaultValue: any): any {
+  if (typeof process.env[key] === 'undefined') {
+    return defaultValue;
+  }
+
+  if (typeof defaultValue === 'number') {
+    return Number.parseInt(process.env[key]!);
+  }
+  if (typeof defaultValue === 'boolean') {
+    return process.env[key]!.toLocaleLowerCase() === 'true' || process.env[key] === '1';
+  }
+  if (typeof defaultValue === 'object') {
+    try {
+      return JSON.parse(process.env[key]!);
+    } catch (error) {}
+    return defaultValue;
+  }
+  // if (typeof defaultValue === 'string') {
+  //   return process.env[key];
+  // }
+  return process.env[key];
+}
+export { getEnv };

package/src/lib/utils/index.ts

@@ -1,12 +1,12 @@
-export * from './crypto';
-export * from './date-utils';
-export * from './deep-merge';
-export * from './delay';
-export * from './file-setting';
-export * from './format-bytes';
-export * from './get-env';
-export * from './is-type';
-export * from './load-env';
-export * from './pad';
-export * from './cookie-util';
-export * from './fs-utils';
+export * from './crypto';
+export * from './date-utils';
+export * from './deep-merge';
+export * from './delay';
+export * from './file-setting';
+export * from './format-bytes';
+export * from './get-env';
+export * from './is-type';
+export * from './load-env';
+export * from './pad';
+export * from './cookie-util';
+export * from './fs-utils';