@ybgnb/utils 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hzhilong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @ybgnb/utils
+
+自用工具库

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types/error';
+export * from './types/extended-type';
+export * from './utils/base-utils';
+export * from './utils/biz-result';

package/dist/index.mjs

@@ -0,0 +1,117 @@
+import dayjs from "dayjs";
+class CommonError {
+  message;
+  constructor(message) {
+    this.message = message;
+  }
+}
+class AbortedError extends CommonError {
+  constructor() {
+    super("操作已取消");
+  }
+}
+class BaseUtils {
+  /**
+   * 判断是否为通用异常
+   * @param error 需要判断的异常
+   */
+  static isCommonError(error) {
+    return error instanceof CommonError;
+  }
+  /**
+   * 获取错误信息
+   * @param error
+   */
+  static getErrorMessage(error) {
+    return this.convertToCommonError(error).message;
+  }
+  /**
+   * 设置异常信息的前置提示
+   * @param error 异常
+   * @param preMsg  前置信息  `${preMsg}${error.message}`
+   */
+  static prependErrorMessage(error, preMsg) {
+    if (preMsg) {
+      error.message = `${preMsg}${error.message}`;
+    }
+    return error;
+  }
+  /**
+   * 转换到通用异常
+   * @param error 异常
+   * @param preMsg  前置提示 `${preMsg}${error.message}`
+   */
+  static convertToCommonError(error, preMsg) {
+    if (this.isCommonError(error)) {
+      return this.prependErrorMessage(error, preMsg);
+    }
+    if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
+      const newError = error;
+      return this.prependErrorMessage(new CommonError(newError.message), preMsg);
+    } else {
+      return this.prependErrorMessage(new CommonError(String(error)), preMsg);
+    }
+  }
+  /**
+   * 格式化时间为 2020-02-02 20:20:20 的字符串
+   * @param date 需要格式化的时间，为空则获取当前时间
+   */
+  static getFormatedDateTime(date) {
+    return dayjs(date).format("YYYY-MM-DD HH:mm:ss");
+  }
+  /**
+   * 格式化时间为 2020-02-02 的字符串
+   * @param date 需要格式化的时间，为空则获取当前时间
+   */
+  static getFormatedDate(date) {
+    return dayjs(date).format("YYYY-MM-DD");
+  }
+  /**
+   * 格式化时间为 20:20:20 的字符串
+   * @param date 需要格式化的时间，为空则获取当前时间
+   */
+  static getFormatedTime(date) {
+    return dayjs(date).format("HH:mm:ss");
+  }
+}
+class BizResult {
+  success;
+  msg;
+  data;
+  constructor(success, msg, data) {
+    this.success = success;
+    this.msg = msg;
+    this.data = data;
+  }
+  static createSuccess(data) {
+    return new BizResult(true, "操作成功", data);
+  }
+  static createFail(msg = "操作失败", data) {
+    return new BizResult(false, msg, data);
+  }
+  static createError(e) {
+    return new BizResult(false, BaseUtils.getErrorMessage(e));
+  }
+  async toPromise() {
+    if (this.success) {
+      return this.data;
+    } else {
+      throw new CommonError(this.msg);
+    }
+  }
+}
+const execBiz = async (run) => {
+  try {
+    return BizResult.createSuccess(await run());
+  } catch (e) {
+    return BizResult.createError(e);
+  }
+};
+export {
+  AbortedError,
+  BaseUtils,
+  BizResult,
+  CommonError,
+  execBiz
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/types/error.ts","../src/utils/base-utils.ts","../src/utils/biz-result.ts"],"sourcesContent":["/**\n * 通用异常\n */\nexport class CommonError {\n  message: string;\n\n  constructor(message: string) {\n    this.message = message;\n  }\n}\n\n/**\n * 终止异常\n */\nexport class AbortedError extends CommonError {\n  constructor() {\n    super(\"操作已取消\");\n  }\n}\n","import dayjs from 'dayjs';\nimport { CommonError } from '../types/error';\n\n/**\n * 基础工具集\n */\nexport class BaseUtils {\n  /**\n   * 判断是否为通用异常\n   * @param error 需要判断的异常\n   */\n  static isCommonError(error: unknown): error is CommonError {\n    return error instanceof CommonError\n  }\n\n  /**\n   * 获取错误信息\n   * @param error\n   */\n  static getErrorMessage(error: unknown): string {\n    return this.convertToCommonError(error).message\n  }\n\n  /**\n   * 设置异常信息的前置提示\n   * @param error 异常\n   * @param preMsg  前置信息  `${preMsg}${error.message}`\n   */\n  static prependErrorMessage(error: CommonError, preMsg?: string): CommonError {\n    if (preMsg) {\n      error.message = `${preMsg}${error.message}`\n    }\n    return error\n  }\n\n  /**\n   * 转换到通用异常\n   * @param error 异常\n   * @param preMsg  前置提示 `${preMsg}${error.message}`\n   */\n  static convertToCommonError(error: unknown, preMsg?: string): CommonError {\n    if (this.isCommonError(error)) {\n      return this.prependErrorMessage(error, preMsg)\n    }\n    if (\n      typeof error === 'object' &&\n      error !== null &&\n      'message' in error &&\n      typeof (error as Record<string, unknown>).message === 'string'\n    ) {\n      const newError = error as { message: string }\n      return this.prependErrorMessage(new CommonError(newError.message), preMsg)\n    } else {\n      // 如果抛出的异常不是object\n      return this.prependErrorMessage(new CommonError(String(error)), preMsg)\n    }\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDateTime(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD HH:mm:ss')\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDate(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD')\n  }\n\n  /**\n   * 格式化时间为 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedTime(date?: Date): string {\n    return dayjs(date).format('HH:mm:ss')\n  }\n}\n","import { CommonError } from '../types/error'\nimport { BaseUtils } from './base-utils'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, BaseUtils.getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n"],"names":[],"mappings":";AAGO,MAAM,YAAY;AAAA,EACvB;AAAA,EAEA,YAAY,SAAiB;AAC3B,SAAK,UAAU;AAAA,EACjB;AACF;AAKO,MAAM,qBAAqB,YAAY;AAAA,EAC5C,cAAc;AACZ,UAAM,OAAO;AAAA,EACf;AACF;ACZO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA,EAKrB,OAAO,cAAc,OAAsC;AACzD,WAAO,iBAAiB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,gBAAgB,OAAwB;AAC7C,WAAO,KAAK,qBAAqB,KAAK,EAAE;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,oBAAoB,OAAoB,QAA8B;AAC3E,QAAI,QAAQ;AACV,YAAM,UAAU,GAAG,MAAM,GAAG,MAAM,OAAO;AAAA,IAC3C;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,qBAAqB,OAAgB,QAA8B;AACxE,QAAI,KAAK,cAAc,KAAK,GAAG;AAC7B,aAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,IAC/C;AACA,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAQ,MAAkC,YAAY,UACtD;AACA,YAAM,WAAW;AACjB,aAAO,KAAK,oBAAoB,IAAI,YAAY,SAAS,OAAO,GAAG,MAAM;AAAA,IAC3E,OAAO;AAEL,aAAO,KAAK,oBAAoB,IAAI,YAAY,OAAO,KAAK,CAAC,GAAG,MAAM;AAAA,IACxE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,oBAAoB,MAAqB;AAC9C,WAAO,MAAM,IAAI,EAAE,OAAO,qBAAqB;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,gBAAgB,MAAqB;AAC1C,WAAO,MAAM,IAAI,EAAE,OAAO,YAAY;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,gBAAgB,MAAqB;AAC1C,WAAO,MAAM,IAAI,EAAE,OAAO,UAAU;AAAA,EACtC;AACF;AC3EO,MAAM,UAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAkB,KAAa,MAAU;AACnD,SAAK,UAAU;AACf,SAAK,MAAM;AACX,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,OAAO,cAAiB,MAAS;AAC/B,WAAO,IAAI,UAAU,MAAM,QAAQ,IAAI;AAAA,EACzC;AAAA,EAEA,OAAO,WAAc,MAAc,QAAQ,MAAU;AACnD,WAAO,IAAI,UAAU,OAAO,KAAK,IAAI;AAAA,EACvC;AAAA,EAEA,OAAO,YAAe,GAAY;AAChC,WAAO,IAAI,UAAa,OAAO,UAAU,gBAAgB,CAAC,CAAC;AAAA,EAC7D;AAAA,EAOA,MAAM,YAAkC;AACtC,QAAI,KAAK,SAAS;AAChB,aAAO,KAAK;AAAA,IACd,OAAO;AACL,YAAM,IAAI,YAAY,KAAK,GAAG;AAAA,IAChC;AAAA,EACF;AACF;AAMO,MAAM,UAAU,OAAU,QAAiD;AAChF,MAAI;AACF,WAAO,UAAU,cAAiB,MAAM,KAAK;AAAA,EAC/C,SAAS,GAAG;AACV,WAAO,UAAU,YAAY,CAAC;AAAA,EAChC;AACF;"}

package/dist/index.umd.js

@@ -0,0 +1,120 @@
+(function(global, factory) {
+  typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("dayjs")) : typeof define === "function" && define.amd ? define(["exports", "dayjs"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["ybgnb-js-utils"] = {}, global.dayjs));
+})(this, (function(exports2, dayjs) {
+  "use strict";
+  class CommonError {
+    message;
+    constructor(message) {
+      this.message = message;
+    }
+  }
+  class AbortedError extends CommonError {
+    constructor() {
+      super("操作已取消");
+    }
+  }
+  class BaseUtils {
+    /**
+     * 判断是否为通用异常
+     * @param error 需要判断的异常
+     */
+    static isCommonError(error) {
+      return error instanceof CommonError;
+    }
+    /**
+     * 获取错误信息
+     * @param error
+     */
+    static getErrorMessage(error) {
+      return this.convertToCommonError(error).message;
+    }
+    /**
+     * 设置异常信息的前置提示
+     * @param error 异常
+     * @param preMsg  前置信息  `${preMsg}${error.message}`
+     */
+    static prependErrorMessage(error, preMsg) {
+      if (preMsg) {
+        error.message = `${preMsg}${error.message}`;
+      }
+      return error;
+    }
+    /**
+     * 转换到通用异常
+     * @param error 异常
+     * @param preMsg  前置提示 `${preMsg}${error.message}`
+     */
+    static convertToCommonError(error, preMsg) {
+      if (this.isCommonError(error)) {
+        return this.prependErrorMessage(error, preMsg);
+      }
+      if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
+        const newError = error;
+        return this.prependErrorMessage(new CommonError(newError.message), preMsg);
+      } else {
+        return this.prependErrorMessage(new CommonError(String(error)), preMsg);
+      }
+    }
+    /**
+     * 格式化时间为 2020-02-02 20:20:20 的字符串
+     * @param date 需要格式化的时间，为空则获取当前时间
+     */
+    static getFormatedDateTime(date) {
+      return dayjs(date).format("YYYY-MM-DD HH:mm:ss");
+    }
+    /**
+     * 格式化时间为 2020-02-02 的字符串
+     * @param date 需要格式化的时间，为空则获取当前时间
+     */
+    static getFormatedDate(date) {
+      return dayjs(date).format("YYYY-MM-DD");
+    }
+    /**
+     * 格式化时间为 20:20:20 的字符串
+     * @param date 需要格式化的时间，为空则获取当前时间
+     */
+    static getFormatedTime(date) {
+      return dayjs(date).format("HH:mm:ss");
+    }
+  }
+  class BizResult {
+    success;
+    msg;
+    data;
+    constructor(success, msg, data) {
+      this.success = success;
+      this.msg = msg;
+      this.data = data;
+    }
+    static createSuccess(data) {
+      return new BizResult(true, "操作成功", data);
+    }
+    static createFail(msg = "操作失败", data) {
+      return new BizResult(false, msg, data);
+    }
+    static createError(e) {
+      return new BizResult(false, BaseUtils.getErrorMessage(e));
+    }
+    async toPromise() {
+      if (this.success) {
+        return this.data;
+      } else {
+        throw new CommonError(this.msg);
+      }
+    }
+  }
+  const execBiz = async (run) => {
+    try {
+      return BizResult.createSuccess(await run());
+    } catch (e) {
+      return BizResult.createError(e);
+    }
+  };
+  exports2.AbortedError = AbortedError;
+  exports2.BaseUtils = BaseUtils;
+  exports2.BizResult = BizResult;
+  exports2.CommonError = CommonError;
+  exports2.execBiz = execBiz;
+  Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
+}));
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/types/error.ts","../src/utils/base-utils.ts","../src/utils/biz-result.ts"],"sourcesContent":["/**\n * 通用异常\n */\nexport class CommonError {\n  message: string;\n\n  constructor(message: string) {\n    this.message = message;\n  }\n}\n\n/**\n * 终止异常\n */\nexport class AbortedError extends CommonError {\n  constructor() {\n    super(\"操作已取消\");\n  }\n}\n","import dayjs from 'dayjs';\nimport { CommonError } from '../types/error';\n\n/**\n * 基础工具集\n */\nexport class BaseUtils {\n  /**\n   * 判断是否为通用异常\n   * @param error 需要判断的异常\n   */\n  static isCommonError(error: unknown): error is CommonError {\n    return error instanceof CommonError\n  }\n\n  /**\n   * 获取错误信息\n   * @param error\n   */\n  static getErrorMessage(error: unknown): string {\n    return this.convertToCommonError(error).message\n  }\n\n  /**\n   * 设置异常信息的前置提示\n   * @param error 异常\n   * @param preMsg  前置信息  `${preMsg}${error.message}`\n   */\n  static prependErrorMessage(error: CommonError, preMsg?: string): CommonError {\n    if (preMsg) {\n      error.message = `${preMsg}${error.message}`\n    }\n    return error\n  }\n\n  /**\n   * 转换到通用异常\n   * @param error 异常\n   * @param preMsg  前置提示 `${preMsg}${error.message}`\n   */\n  static convertToCommonError(error: unknown, preMsg?: string): CommonError {\n    if (this.isCommonError(error)) {\n      return this.prependErrorMessage(error, preMsg)\n    }\n    if (\n      typeof error === 'object' &&\n      error !== null &&\n      'message' in error &&\n      typeof (error as Record<string, unknown>).message === 'string'\n    ) {\n      const newError = error as { message: string }\n      return this.prependErrorMessage(new CommonError(newError.message), preMsg)\n    } else {\n      // 如果抛出的异常不是object\n      return this.prependErrorMessage(new CommonError(String(error)), preMsg)\n    }\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDateTime(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD HH:mm:ss')\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDate(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD')\n  }\n\n  /**\n   * 格式化时间为 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedTime(date?: Date): string {\n    return dayjs(date).format('HH:mm:ss')\n  }\n}\n","import { CommonError } from '../types/error'\nimport { BaseUtils } from './base-utils'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, BaseUtils.getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n"],"names":[],"mappings":";;;;EAGO,MAAM,YAAY;AAAA,IACvB;AAAA,IAEA,YAAY,SAAiB;AAC3B,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA,EAKO,MAAM,qBAAqB,YAAY;AAAA,IAC5C,cAAc;AACZ,YAAM,OAAO;AAAA,IACf;AAAA,EACF;AAAA,ECZO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA,IAKrB,OAAO,cAAc,OAAsC;AACzD,aAAO,iBAAiB;AAAA,IAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,gBAAgB,OAAwB;AAC7C,aAAO,KAAK,qBAAqB,KAAK,EAAE;AAAA,IAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,OAAO,oBAAoB,OAAoB,QAA8B;AAC3E,UAAI,QAAQ;AACV,cAAM,UAAU,GAAG,MAAM,GAAG,MAAM,OAAO;AAAA,MAC3C;AACA,aAAO;AAAA,IACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,OAAO,qBAAqB,OAAgB,QAA8B;AACxE,UAAI,KAAK,cAAc,KAAK,GAAG;AAC7B,eAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,MAC/C;AACA,UACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAQ,MAAkC,YAAY,UACtD;AACA,cAAM,WAAW;AACjB,eAAO,KAAK,oBAAoB,IAAI,YAAY,SAAS,OAAO,GAAG,MAAM;AAAA,MAC3E,OAAO;AAEL,eAAO,KAAK,oBAAoB,IAAI,YAAY,OAAO,KAAK,CAAC,GAAG,MAAM;AAAA,MACxE;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,oBAAoB,MAAqB;AAC9C,aAAO,MAAM,IAAI,EAAE,OAAO,qBAAqB;AAAA,IACjD;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,gBAAgB,MAAqB;AAC1C,aAAO,MAAM,IAAI,EAAE,OAAO,YAAY;AAAA,IACxC;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,gBAAgB,MAAqB;AAC1C,aAAO,MAAM,IAAI,EAAE,OAAO,UAAU;AAAA,IACtC;AAAA,EACF;AAAA,EC3EO,MAAM,UAAa;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IAEA,YAAY,SAAkB,KAAa,MAAU;AACnD,WAAK,UAAU;AACf,WAAK,MAAM;AACX,WAAK,OAAO;AAAA,IACd;AAAA,IAEA,OAAO,cAAiB,MAAS;AAC/B,aAAO,IAAI,UAAU,MAAM,QAAQ,IAAI;AAAA,IACzC;AAAA,IAEA,OAAO,WAAc,MAAc,QAAQ,MAAU;AACnD,aAAO,IAAI,UAAU,OAAO,KAAK,IAAI;AAAA,IACvC;AAAA,IAEA,OAAO,YAAe,GAAY;AAChC,aAAO,IAAI,UAAa,OAAO,UAAU,gBAAgB,CAAC,CAAC;AAAA,IAC7D;AAAA,IAOA,MAAM,YAAkC;AACtC,UAAI,KAAK,SAAS;AAChB,eAAO,KAAK;AAAA,MACd,OAAO;AACL,cAAM,IAAI,YAAY,KAAK,GAAG;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AAMO,QAAM,UAAU,OAAU,QAAiD;AAChF,QAAI;AACF,aAAO,UAAU,cAAiB,MAAM,KAAK;AAAA,IAC/C,SAAS,GAAG;AACV,aAAO,UAAU,YAAY,CAAC;AAAA,IAChC;AAAA,EACF;;;;;;;;"}

package/dist/types/error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 通用异常
+ */
+export declare class CommonError {
+    message: string;
+    constructor(message: string);
+}
+/**
+ * 终止异常
+ */
+export declare class AbortedError extends CommonError {
+    constructor();
+}

package/dist/types/extended-type.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 提取getter属性
+ */
+export type ExtractGetterProperties<T> = {
+    [K in keyof T as K extends `get${infer Rest}` ? Uncapitalize<Rest> : never]: T[K] extends (...args: any[]) => Promise<infer R> ? R : never;
+};

package/dist/utils/base-utils.d.ts

@@ -0,0 +1,43 @@
+import { CommonError } from '../types/error';
+/**
+ * 基础工具集
+ */
+export declare class BaseUtils {
+    /**
+     * 判断是否为通用异常
+     * @param error 需要判断的异常
+     */
+    static isCommonError(error: unknown): error is CommonError;
+    /**
+     * 获取错误信息
+     * @param error
+     */
+    static getErrorMessage(error: unknown): string;
+    /**
+     * 设置异常信息的前置提示
+     * @param error 异常
+     * @param preMsg  前置信息  `${preMsg}${error.message}`
+     */
+    static prependErrorMessage(error: CommonError, preMsg?: string): CommonError;
+    /**
+     * 转换到通用异常
+     * @param error 异常
+     * @param preMsg  前置提示 `${preMsg}${error.message}`
+     */
+    static convertToCommonError(error: unknown, preMsg?: string): CommonError;
+    /**
+     * 格式化时间为 2020-02-02 20:20:20 的字符串
+     * @param date 需要格式化的时间，为空则获取当前时间
+     */
+    static getFormatedDateTime(date?: Date): string;
+    /**
+     * 格式化时间为 2020-02-02 的字符串
+     * @param date 需要格式化的时间，为空则获取当前时间
+     */
+    static getFormatedDate(date?: Date): string;
+    /**
+     * 格式化时间为 20:20:20 的字符串
+     * @param date 需要格式化的时间，为空则获取当前时间
+     */
+    static getFormatedTime(date?: Date): string;
+}

package/dist/utils/biz-result.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 业务执行结果
+ */
+export declare class BizResult<T> {
+    success: boolean;
+    msg: string;
+    data?: T;
+    constructor(success: boolean, msg: string, data?: T);
+    static createSuccess<T>(data: T): BizResult<T>;
+    static createFail<T>(msg?: string, data?: T): BizResult<T>;
+    static createError<T>(e: unknown): BizResult<T>;
+    /**
+     * 展开成Promise
+     */
+    toPromise(): Promise<void>;
+    toPromise<T>(): Promise<T>;
+}
+/**
+ * 执行业务（自动包裹BuResult）
+ * @param run 执行方法
+ */
+export declare const execBiz: <T>(run: () => Promise<T>) => Promise<BizResult<T>>;

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ybgnb/utils",
+  "version": "0.0.1",
+  "author": "hzhilong",
+  "private": false,
+  "description": "自用工具库",
+  "main": "dist/index.umd.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.umd.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "barrelsby -c barrelsby.json --delete --noHeader && vite build",
+    "npm login": " npm login",
+    "npm publish": " npm publish --access public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hzhilong/ybgnb-js",
+    "directory": "utils"
+  },
+  "keywords": [
+    "ybgnb"
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/hzhilong/ybgnb-js/issues"
+  },
+  "homepage": "https://github.com/hzhilong/ybgnb-js#readme",
+  "devDependencies": {
+    "barrelsby": "^2.8.1",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.8.3",
+    "vite": "^7.1.5",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "peerDependencies": {
+    "dayjs": "^1.11.13",
+    "nanoid": "^5.1.5"
+  }
+}