@edgenets/utils 0.3.12 → 0.4.1

package/README.md

@@ -1,125 +1,74 @@
 # @edgenets/utils
 
-Edgenets utilities package containing common types and utilities.
+A shared TypeScript utility library for the Edgenets ecosystem.  
+Provides logging, type helpers, environment config, validation, and other reusable tools.
 
-## Features
+> Designed for Firebase Cloud Functions and pnpm monorepo projects.
 
-- Logger
-- Queue
-- Config
-- Services
-- Repositories
-- Utilities
-- Models
-
-## Installation
+## Table of contents
 
 ```bash
-npm install @edgenets/utils
+edgenets-utils/
+├── src/
+│   ├── assert/        → 运行时断言，辅助强制类型收窄
+│   ├── env/           → 环境变量获取、校验、缓存
+│   ├── logger/        → 日志封装，默认 pino，支持 mockLogger
+│   ├── date/          → 时间封装（基于 Intl + dayjs adapter）
+│   │   ├── format.ts         # 格式化相关函数
+│   │   ├── diff.ts           # 时间差计算
+│   │   └── index.ts          # 模块导出
+│   ├── errors/        → 异常封装
+│   │   ├── codes.ts          # 错误枚举 ErrorCode
+│   │   ├── messages.ts       # 可选：错误码 → 默认提示
+│   │   ├── app-error.ts      # 错误基类 AppError
+│   │   └── index.ts          # 统一导出
+│   ├── validation/    → 基于 zod，但可插拔（保持 adapter 模式）
+│   ├── constants/     → 项目常量、枚举（跨模块复用）
+│   ├── types/         → 基础类型工具（如 DeepPartial、Awaitable）
+│   ├── string/        → 字符串工具，如 slug、uuid 等
+│   ├── array/         → 数组处理，如 groupBy、uniqueBy
+│   ├── object/        → 对象深拷贝、merge 等
+│   └── index.ts       → 仅 re-export，核心 API 明确暴露
+├── .gitignore
+├── package.json       # name: @edgenets/utils
+├── tsconfig.json
+└── README.md
 ```
 
 ## Usage
 
-### Importing Modules
+### Error handling
 
 ```typescript
-import { ConsoleLogger, Queue, defaultConfig, ExampleService, ExampleRepository, Utils, User, Order } from '@edgenets/utils';
-
-// Logger
-const logger = ConsoleLogger.getInstance();
-logger.info('Library initialized');
-
-// Queue
-const queue = new Queue(defaultConfig.maxConcurrent, defaultConfig.requestRate);
-queue.addTask(async () => {
-  // Your task here
-});
-
-// Service
-const service = new ExampleService();
-service.execute();
-
-// Repository
-const repository = new ExampleRepository();
-repository.save({ id: '1', name: 'Example' });
-
-// Utilities
-console.log(Utils.formatDate(new Date(), 'yyyy-MM-dd'));
-
-// Models
-const newUser: User = {
-  id: '1',
-  name: 'John Doe',
-  email: 'john.doe@example.com',
-  password: 'securepassword',
-  createdAt: new Date(),
-  updatedAt: new Date(),
-};
-
-const newOrder: Order = {
-  id: '1',
-  userId: '1',
-  productIds: ['100001', '100002'],
-  totalAmount: 450,
-  status: 'pending',
-  createdAt: new Date(),
-  updatedAt: new Date(),
-};
+import { AppError, ErrorCode } from '@edgenets/utils'
+
+function checkToken(token?: string) {
+  if (!token) {
+    throw new AppError(ErrorCode.AUTH_VAL_TOKEN_INVALID)
+  }
+}
 ```
 
-### Project Structure
+### Logging handling
 
-```
-enterprise-node-lib
-├── src
-│   ├── index.ts
-│   ├── config
-│   │   ├── default.ts
-│   │   ├── product.config.ts
-│   │   └── index.ts
-│   ├── interfaces
-│   │   ├── service.ts
-│   │   ├── repository.ts
-│   │   └── index.ts
-│   ├── logger
-│   │   ├── default.ts
-│   │   └── index.ts
-│   ├── models
-│   │   ├── user.ts
-│   │   ├── order.ts
-│   │   └── index.ts
-│   ├── queue
-│   │   ├── queue.ts
-│   │   └── index.ts
-│   ├── services
-│   │   ├── exampleService.ts
-│   │   └── index.ts
-│   ├── repositories
-│   │   ├── exampleRepository.ts
-│   │   └── index.ts
-│   ├── utils
-│   │   └── index.ts
-├── tests
-│   ├── logger.test.ts
-│   ├── queue.test.ts
-│   ├── config.test.ts
-│   ├── service.test.ts
-│   ├── repository.test.ts
-│   ├── user.test.ts
-│   └── order.test.ts
-├── package.json
-├── tsconfig.json
-└── README.md
-```
+```typescript
+import { getLogger, setGlobalLogger, createConsoleLogger } from '@edgenets/utils'
 
-### Running Tests
+// 设置全局等级
+setGlobalLogger(createConsoleLogger('debug'))
 
-To run the tests, use the following command:
+const logger = getLogger()
 
-```bash
-npm test
+logger.info('App started')
+logger.debug('Debug message')
 ```
 
-### License
+### ID generation
+
+```typescript
+import { NanoIdUtil } from '@edgenets/utils'
 
-This project is licensed under the MIT License.
+const id = NanoIdUtil.generateDefault(12)         // ab8X0kTzG7Q9
+const custom = NanoIdUtil.generateCustom(6, 'xyz') // xyyzyz
+const numericId = NanoIdUtil.generateNumberId()    // 1073132153242091
+```

package/dist/constants/env.d.ts

@@ -0,0 +1,3 @@
+export declare const ENVIRONMENTS: readonly ["development", "staging", "production"];
+export type Env = (typeof ENVIRONMENTS)[number];
+//# sourceMappingURL=env.d.ts.map

package/dist/constants/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,mDAAoD,CAAC;AAC9E,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants/env.js

@@ -0,0 +1,2 @@
+export const ENVIRONMENTS = ["development", "staging", "production"];
+//# sourceMappingURL=env.js.map

package/dist/constants/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./env.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,2 @@
+export * from "./env.js";
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/date/diff.d.ts

@@ -0,0 +1,2 @@
+export declare function diffInSeconds(from: Date, to: Date): number;
+//# sourceMappingURL=diff.d.ts.map

package/dist/date/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/date/diff.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,MAAM,CAE1D"}

package/dist/date/diff.js

@@ -0,0 +1,4 @@
+export function diffInSeconds(from, to) {
+    return Math.floor((to.getTime() - from.getTime()) / 1000);
+}
+//# sourceMappingURL=diff.js.map

package/dist/date/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/date/diff.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,EAAQ;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5D,CAAC"}

package/dist/date/format.d.ts

@@ -0,0 +1,2 @@
+export declare function formatDate(date: Date | string, locale?: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/date/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/date/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAUxE"}

package/dist/date/format.js

@@ -0,0 +1,12 @@
+export function formatDate(date, locale = "en-US") {
+    const d = typeof date === "string" ? new Date(date) : date;
+    return new Intl.DateTimeFormat(locale, {
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    }).format(d);
+}
+//# sourceMappingURL=format.js.map

package/dist/date/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/date/format.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAmB,EAAE,MAAM,GAAG,OAAO;IAC9D,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QACrC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACf,CAAC"}

package/dist/date/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./format.js";
+export * from "./diff.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/date/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/date/index.js

@@ -0,0 +1,3 @@
+export * from "./format.js";
+export * from "./diff.js";
+//# sourceMappingURL=index.js.map

package/dist/date/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/env/index.d.ts

@@ -0,0 +1,2 @@
+export declare function getEnv(name: string, fallback?: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9D"}

package/dist/env/index.js

@@ -0,0 +1,8 @@
+export function getEnv(name, fallback) {
+    const val = process.env[name];
+    if (!val && fallback === undefined) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return val ?? fallback;
+}
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,QAAiB;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,IAAI,QAAS,CAAC;AAC1B,CAAC"}

package/dist/errors/app-error.d.ts

@@ -0,0 +1,12 @@
+import { ErrorCode } from "./codes.js";
+export declare class AppError extends Error {
+    readonly code: ErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: ErrorCode, message?: string, cause?: unknown | undefined);
+    toJSON(): {
+        error: string;
+        code: ErrorCode;
+        message: string;
+    };
+}
+//# sourceMappingURL=app-error.d.ts.map

package/dist/errors/app-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,SAAS;aAEf,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,SAAS,EAC/B,OAAO,CAAC,EAAE,MAAM,EACA,KAAK,CAAC,EAAE,OAAO,YAAA;IAMjC,MAAM;;;;;CAOP"}

package/dist/errors/app-error.js

@@ -0,0 +1,19 @@
+import { ErrorMessages } from "./messages.js";
+export class AppError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message || ErrorMessages[code]);
+        this.code = code;
+        this.cause = cause;
+        this.name = "AppError";
+    }
+    toJSON() {
+        return {
+            error: this.name,
+            code: this.code,
+            message: this.message,
+        };
+    }
+}
+//# sourceMappingURL=app-error.js.map

package/dist/errors/app-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IAEA;IAHlB,YACkB,IAAe,EAC/B,OAAgB,EACA,KAAe;QAE/B,KAAK,CAAC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAJtB,SAAI,GAAJ,IAAI,CAAW;QAEf,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/errors/{code.d.ts → codes.d.ts}

@@ -17,4 +17,4 @@ export declare enum ErrorCode {
     API_CONN_FAILED = "API-SYS-001",
     API_RATE_LIMIT_EXCEEDED = "API-SYS-002"
 }
-//# sourceMappingURL=code.d.ts.map
+//# sourceMappingURL=codes.d.ts.map

package/dist/errors/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IAEnB,sBAAsB,gBAAgB;IACtC,qBAAqB,gBAAgB;IACrC,kBAAkB,iBAAiB;IACnC,kBAAkB,iBAAiB;IAGnC,0BAA0B,iBAAiB;IAC3C,sBAAsB,iBAAiB;IACvC,sBAAsB,iBAAiB;IACvC,sBAAsB,kBAAkB;IAGxC,cAAc,eAAe;IAC7B,eAAe,eAAe;IAC9B,gBAAgB,gBAAgB;IAGhC,WAAW,gBAAgB;IAC3B,kBAAkB,gBAAgB;IAClC,WAAW,gBAAgB;IAG3B,wBAAwB,gBAAgB;IACxC,eAAe,gBAAgB;IAC/B,uBAAuB,gBAAgB;CACxC"}

package/dist/errors/{code.js → codes.js}

@@ -18,4 +18,4 @@ export var ErrorCode;
     ErrorCode["API_CONN_FAILED"] = "API-SYS-001";
     ErrorCode["API_RATE_LIMIT_EXCEEDED"] = "API-SYS-002";
 })(ErrorCode || (ErrorCode = {}));
-//# sourceMappingURL=code.js.map
+//# sourceMappingURL=codes.js.map

package/dist/errors/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SA2BX;AA3BD,WAAY,SAAS;IAEnB,mDAAsC,CAAA;IACtC,kDAAqC,CAAA;IACrC,gDAAmC,CAAA;IACnC,gDAAmC,CAAA;IAGnC,wDAA2C,CAAA;IAC3C,oDAAuC,CAAA;IACvC,oDAAuC,CAAA;IACvC,qDAAwC,CAAA;IAGxC,0CAA6B,CAAA;IAC7B,2CAA8B,CAAA;IAC9B,6CAAgC,CAAA;IAGhC,wCAA2B,CAAA;IAC3B,+CAAkC,CAAA;IAClC,wCAA2B,CAAA;IAG3B,qDAAwC,CAAA;IACxC,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;AACzC,CAAC,EA3BW,SAAS,KAAT,SAAS,QA2BpB"}

package/dist/errors/index.d.ts

@@ -1,14 +1,4 @@
-import { ErrorCode } from "./code.js";
-export { ErrorCode };
-export declare const ErrorDetails: {
-    [key in ErrorCode]: {
-        message: string;
-        httpStatus: number;
-    };
-};
-export declare function handleError(errorCode: ErrorCode): {
-    code: string;
-    message: string;
-    httpStatus: number;
-};
+export * from "./codes.js";
+export * from "./messages.js";
+export * from "./app-error.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,eAAO,MAAM,YAAY,EAAE;KACxB,GAAG,IAAI,SAAS,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CA+E5D,CAAC;AAEF,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAOA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/errors/index.js

@@ -1,81 +1,4 @@
-import { ErrorCode } from "./code.js";
-export { ErrorCode };
-export const ErrorDetails = {
-    [ErrorCode.USR_VAL_MISSING_FIELDS]: {
-        message: "Required fields are missing.",
-        httpStatus: 400,
-    },
-    [ErrorCode.USR_VAL_INVALID_INPUT]: {
-        message: "Invalid input provided.",
-        httpStatus: 400,
-    },
-    [ErrorCode.USR_DATA_NOT_FOUND]: {
-        message: "User data not found.",
-        httpStatus: 404,
-    },
-    [ErrorCode.USR_DATA_DUPLICATE]: {
-        message: "Duplicate user data found.",
-        httpStatus: 409,
-    },
-    [ErrorCode.AUTH_VAL_SIGNATURE_INVALID]: {
-        message: "Signature is invalid.",
-        httpStatus: 401,
-    },
-    [ErrorCode.AUTH_VAL_TOKEN_EXPIRED]: {
-        message: "Authentication token has expired.",
-        httpStatus: 401,
-    },
-    [ErrorCode.AUTH_VAL_TOKEN_INVALID]: {
-        message: "Invalid authentication token.",
-        httpStatus: 401,
-    },
-    [ErrorCode.AUTH_AUTH_UNAUTHORIZED]: {
-        message: "User is unauthorized.",
-        httpStatus: 403,
-    },
-    [ErrorCode.DB_CONN_FAILED]: {
-        message: "Database connection failed.",
-        httpStatus: 500,
-    },
-    [ErrorCode.DB_QUERY_FAILED]: {
-        message: "Database query failed.",
-        httpStatus: 500,
-    },
-    [ErrorCode.DB_DATA_CONFLICT]: {
-        message: "Data conflict in database.",
-        httpStatus: 409,
-    },
-    [ErrorCode.SYS_UNKNOWN]: {
-        message: "Unknown system error.",
-        httpStatus: 500,
-    },
-    [ErrorCode.SYS_INTERNAL_ERROR]: {
-        message: "Internal server error.",
-        httpStatus: 500,
-    },
-    [ErrorCode.SYS_TIMEOUT]: {
-        message: "System request timed out.",
-        httpStatus: 504,
-    },
-    [ErrorCode.API_VAL_RESPONSE_INVALID]: {
-        message: "Invalid response from external API.",
-        httpStatus: 502,
-    },
-    [ErrorCode.API_CONN_FAILED]: {
-        message: "Failed to connect to external API.",
-        httpStatus: 502,
-    },
-    [ErrorCode.API_RATE_LIMIT_EXCEEDED]: {
-        message: "External API rate limit exceeded.",
-        httpStatus: 429,
-    },
-};
-export function handleError(errorCode) {
-    const errorDetail = ErrorDetails[errorCode];
-    return {
-        code: errorCode,
-        message: errorDetail.message,
-        httpStatus: errorDetail.httpStatus,
-    };
-}
+export * from "./codes.js";
+export * from "./messages.js";
+export * from "./app-error.js";
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,MAAM,CAAC,MAAM,YAAY,GAErB;IAEF,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE;QAClC,OAAO,EAAE,8BAA8B;QACvC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE;QACjC,OAAO,EAAE,yBAAyB;QAClC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE;QAC9B,OAAO,EAAE,sBAAsB;QAC/B,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE;QAC9B,OAAO,EAAE,4BAA4B;QACrC,UAAU,EAAE,GAAG;KAChB;IAGD,CAAC,SAAS,CAAC,0BAA0B,CAAC,EAAE;QACtC,OAAO,EAAE,uBAAuB;QAChC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE;QAClC,OAAO,EAAE,mCAAmC;QAC5C,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE;QAClC,OAAO,EAAE,+BAA+B;QACxC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE;QAClC,OAAO,EAAE,uBAAuB;QAChC,UAAU,EAAE,GAAG;KAChB;IAGD,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE;QAC1B,OAAO,EAAE,6BAA6B;QACtC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE;QAC3B,OAAO,EAAE,wBAAwB;QACjC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE;QAC5B,OAAO,EAAE,4BAA4B;QACrC,UAAU,EAAE,GAAG;KAChB;IAGD,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE;QACvB,OAAO,EAAE,uBAAuB;QAChC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE;QAC9B,OAAO,EAAE,wBAAwB;QACjC,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE;QACvB,OAAO,EAAE,2BAA2B;QACpC,UAAU,EAAE,GAAG;KAChB;IAGD,CAAC,SAAS,CAAC,wBAAwB,CAAC,EAAE;QACpC,OAAO,EAAE,qCAAqC;QAC9C,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE;QAC3B,OAAO,EAAE,oCAAoC;QAC7C,UAAU,EAAE,GAAG;KAChB;IACD,CAAC,SAAS,CAAC,uBAAuB,CAAC,EAAE;QACnC,OAAO,EAAE,mCAAmC;QAC5C,UAAU,EAAE,GAAG;KAChB;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,SAAoB;IAK9C,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;KACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/errors/messages.d.ts

@@ -0,0 +1,3 @@
+import { ErrorCode } from "./codes.js";
+export declare const ErrorMessages: Record<ErrorCode, string>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/errors/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/errors/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAsBnD,CAAC"}

package/dist/errors/messages.js

@@ -0,0 +1,21 @@
+import { ErrorCode } from "./codes.js";
+export const ErrorMessages = {
+    [ErrorCode.USR_VAL_MISSING_FIELDS]: "缺少必要字段",
+    [ErrorCode.USR_VAL_INVALID_INPUT]: "用户输入不合法",
+    [ErrorCode.USR_DATA_NOT_FOUND]: "用户不存在",
+    [ErrorCode.USR_DATA_DUPLICATE]: "用户数据重复",
+    [ErrorCode.AUTH_VAL_SIGNATURE_INVALID]: "签名不合法",
+    [ErrorCode.AUTH_VAL_TOKEN_EXPIRED]: "令牌已过期",
+    [ErrorCode.AUTH_VAL_TOKEN_INVALID]: "令牌无效",
+    [ErrorCode.AUTH_AUTH_UNAUTHORIZED]: "未授权访问",
+    [ErrorCode.DB_CONN_FAILED]: "数据库连接失败",
+    [ErrorCode.DB_QUERY_FAILED]: "数据库查询失败",
+    [ErrorCode.DB_DATA_CONFLICT]: "数据冲突",
+    [ErrorCode.SYS_UNKNOWN]: "未知错误",
+    [ErrorCode.SYS_INTERNAL_ERROR]: "内部错误",
+    [ErrorCode.SYS_TIMEOUT]: "请求超时",
+    [ErrorCode.API_VAL_RESPONSE_INVALID]: "外部接口响应无效",
+    [ErrorCode.API_CONN_FAILED]: "外部接口连接失败",
+    [ErrorCode.API_RATE_LIMIT_EXCEEDED]: "API 调用频率超出限制",
+};
+//# sourceMappingURL=messages.js.map

package/dist/errors/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/errors/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,QAAQ;IAC5C,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,SAAS;IAC5C,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,OAAO;IACvC,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,QAAQ;IAExC,CAAC,SAAS,CAAC,0BAA0B,CAAC,EAAE,OAAO;IAC/C,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,OAAO;IAC3C,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,MAAM;IAC1C,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,OAAO;IAE3C,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,SAAS;IACrC,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,SAAS;IACtC,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM;IAEpC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM;IAC/B,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,MAAM;IACtC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM;IAE/B,CAAC,SAAS,CAAC,wBAAwB,CAAC,EAAE,UAAU;IAChD,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,UAAU;IACvC,CAAC,SAAS,CAAC,uBAAuB,CAAC,EAAE,cAAc;CACpD,CAAC"}

package/dist/id/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./nano-id.util.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/id/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/id/index.js

@@ -0,0 +1,2 @@
+export * from "./nano-id.util.js";
+//# sourceMappingURL=index.js.map

package/dist/id/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/id/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/{utils/nanoid.util.d.ts → id/nano-id.util.d.ts}

@@ -2,7 +2,7 @@ export declare class NanoIdUtil {
     private static readonly DEFAULT_CHARS;
     static generate(length: number, chars?: string): string;
     static generateDefault(length: number): string;
-    static generateCustom(length: number, customChars: string): string;
+    static generateCustom(length: number, chars: string): string;
     static generateNumberId(length?: number): number;
 }
-//# sourceMappingURL=nanoid.util.d.ts.map
+//# sourceMappingURL=nano-id.util.d.ts.map

package/dist/id/nano-id.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nano-id.util.d.ts","sourceRoot":"","sources":["../../src/id/nano-id.util.ts"],"names":[],"mappings":"AAKA,qBAAa,UAAU;IAIrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAC8B;WAOrD,QAAQ,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAiC,GACvC,MAAM;WAaK,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAKvC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;WAWrD,gBAAgB,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM;CAiB3D"}

package/dist/id/nano-id.util.js

@@ -0,0 +1,34 @@
+import crypto from "crypto";
+export class NanoIdUtil {
+    static DEFAULT_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+    static generate(length, chars = NanoIdUtil.DEFAULT_CHARS) {
+        if (length <= 0) {
+            throw new Error("Length must be greater than 0");
+        }
+        const bytes = crypto.randomBytes(length);
+        return Array.from({ length }, (_, i) => {
+            const index = bytes[i] % chars.length;
+            return chars[index];
+        }).join("");
+    }
+    static generateDefault(length) {
+        return this.generate(length);
+    }
+    static generateCustom(length, chars) {
+        return this.generate(length, chars);
+    }
+    static generateNumberId(length = 8) {
+        const now = new Date();
+        const start = new Date("2025-01-01T00:00:00Z");
+        const daysSince = Math.floor((now.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+        const minutesOfDay = now.getHours() * 60 + now.getMinutes();
+        const dayPart = daysSince.toString().slice(-4).padStart(4, "0");
+        const minutePart = minutesOfDay.toString().padStart(4, "0");
+        const randomPart = this.generate(length, "0123456789");
+        let id = `${dayPart}${minutePart}${randomPart}`;
+        if (id.startsWith("0"))
+            id = "1" + id.slice(1);
+        return Number(id);
+    }
+}
+//# sourceMappingURL=nano-id.util.js.map

package/dist/id/nano-id.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nano-id.util.js","sourceRoot":"","sources":["../../src/id/nano-id.util.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAK5B,MAAM,OAAO,UAAU;IAIb,MAAM,CAAU,aAAa,GACnC,gEAAgE,CAAC;IAO5D,MAAM,CAAC,QAAQ,CACpB,MAAc,EACd,QAAgB,UAAU,CAAC,aAAa;QAExC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;YACtC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAGM,MAAM,CAAC,eAAe,CAAC,MAAc;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAGM,MAAM,CAAC,cAAc,CAAC,MAAc,EAAE,KAAa;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IASM,MAAM,CAAC,gBAAgB,CAAC,SAAiB,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC1D,CAAC;QACF,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAE5D,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAEvD,IAAI,EAAE,GAAG,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;QAChD,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC"}

package/dist/index.d.ts

@@ -1,15 +1,9 @@
-export * from "./models/user.js";
-export * from "./models/product.js";
-export * from "./models/logger.js";
-export * from "./models/order.js";
-export * from "./models/broadcast.js";
-export * from "./models/point.js";
-export * from "./models/transaction.js";
-export { StringUtils } from "./utils/string.util.js";
-export { SimpleStateMachine, OrderStateMachine, } from "./utils/statemachine.util.js";
-export { SignatureUtils } from "./utils/signature.util.js";
-export * from "./queue/queue.js";
-export * from "./utils/nanoid.util.js";
-export * from "./logger/default.js";
+export * from "./logger/index.js";
+export * from "./types/index.js";
+export * from "./date/index.js";
+export * from "./constants/index.js";
+export * from "./validation/index.js";
 export * from "./errors/index.js";
+export * from "./env/index.js";
+export * from "./id/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,cAAc,kBAAkB,CAAC;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}