@edgenets/utils 0.0.1 → 0.0.3

package/README.md

@@ -1,13 +1,76 @@
-## @edgenets/utils
+# @edgenets/utils
 
-## 该包已经规划好，主要用于存放各种实用工具函数、类型定义和常用的工具方法，如字符串处理、数组操作、日期格式化等。
+Edgenets utilities package containing common types and utilities.
 
-包含内容：
+---
 
+用于存放各种实用工具函数、类型定义和常用的工具方法，如字符串处理、数组操作、日期格式化等。
+
+---
+
+## Installation
+
+```bash
+npm install @edgenets/utils
+```
+
+## Usage
+
+### Import utilities
+
+```typescript
+import { capitalize, trim, unique, User } from "@edgenets/utils";
+
+// 使用工具函数
+console.log(capitalize("hello")); // "Hello"
+console.log(trim("  hello  ")); // "hello"
+console.log(unique([1, 2, 2, 3])); // [1, 2, 3]
+
+// 使用 User 类型定义
+const newUser: User.Profile = {
+  id: 1,
+  name: "John Doe",
+  email: "john.doe@example.com",
+  createdAt: new Date(),
+  updatedAt: new Date(),
+};
 ```
+
+### 构建和发布
+
+1. **构建**：运行 `npm run build`，会生成 `dist` 文件夹，包含编译后的 JavaScript 和类型定义文件。
+
+2. **发布**：发布包到 npm，可以使用以下命令：
+
+```bash
+npm publish --access public
+```
+
+##### 包含内容
+
+```text
+@edgenets/utils
+  ├── src
+  │   ├── types         // 类型定义（如 User、Order 等）
+  │   │   ├── logger.ts
+  │   │   ├── product.ts
+  │   │   ├── order.ts
+  │   │   └── user.ts
+  │   ├── string
+  │   │   ├── capitalize.ts
+  │   │   └── trim.ts
+  │   ├── array
+  │   │   └── unique.ts
+  │   └── index.ts
+  ├── package.json
+  ├── tsconfig.json
+  └── README.md
+```
+
+```text
 •	字符串处理函数
 •	数组处理函数
 •	日期处理函数
 •	通用工具函数（如 debounce、throttle）
-•	类型定义（如 User、Order 等）
+•
 ```

package/dist/array/unique.d.ts

@@ -0,0 +1,2 @@
+export declare function unique<T>(arr: T[]): T[];
+//# sourceMappingURL=unique.d.ts.map

package/dist/array/unique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../src/array/unique.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC"}

package/dist/array/unique.js

@@ -0,0 +1,4 @@
+export function unique(arr) {
+    return [...new Set(arr)];
+}
+//# sourceMappingURL=unique.js.map

package/dist/array/unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.js","sourceRoot":"","sources":["../../src/array/unique.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAI,GAAQ;IAChC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
-export * from "./types/user";
-export * from "./types/product";
-export * from "./types/logger";
-export * from "./types/order";
+export * from "./types/user.js";
+export * from "./types/product.js";
+export * from "./types/logger.js";
+export * from "./types/order.js";
+export { StringUtils } from "./utils/string.util.js";
+export * from "./utils/generate.util.js";
+export * from "./array/unique.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":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,21 +1,12 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types/user"), exports);
-__exportStar(require("./types/product"), exports);
-__exportStar(require("./types/logger"), exports);
-__exportStar(require("./types/order"), exports);
+// 导出类型定义
+export * from "./types/user.js";
+export * from "./types/product.js";
+export * from "./types/logger.js";
+export * from "./types/order.js";
+// 导出字符串处理函数
+export { StringUtils } from "./utils/string.util.js";
+// 导出字符串处理函数
+export * from "./utils/generate.util.js";
+// 导出数组处理函数
+export * from "./array/unique.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC;AAChC,iDAA+B;AAC/B,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,WAAW;AACX,cAAc,mBAAmB,CAAC"}

package/dist/types/logger.d.ts

@@ -1,5 +1,7 @@
 export interface Logger {
+    debug(message: string): void;
     info(message: string): void;
+    warn(message: string): void;
     error(message: string): void;
 }
 //# sourceMappingURL=logger.d.ts.map

package/dist/types/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAE9B"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAE9B"}

package/dist/types/logger.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+// src/interfaces/Logger.ts
+export {};
 //# sourceMappingURL=logger.js.map

package/dist/types/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":""}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":"AAAA,2BAA2B"}

package/dist/types/order.js

@@ -1,50 +1,47 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ShippingStatus = exports.ShippingMethod = exports.RefundStatus = exports.PaymentStatus = exports.PaymentMethod = exports.OrderStatus = void 0;
 // 订单状态枚举
-var OrderStatus;
+export var OrderStatus;
 (function (OrderStatus) {
     OrderStatus["Pending"] = "pending";
     OrderStatus["Confirmed"] = "confirmed";
     OrderStatus["Completed"] = "completed";
     OrderStatus["Canceled"] = "canceled";
     OrderStatus["Refunded"] = "refunded";
-})(OrderStatus || (exports.OrderStatus = OrderStatus = {}));
+})(OrderStatus || (OrderStatus = {}));
 // 支付方式枚举
-var PaymentMethod;
+export var PaymentMethod;
 (function (PaymentMethod) {
     PaymentMethod["Online"] = "Online";
     PaymentMethod["Credit"] = "Credit";
     PaymentMethod["Points"] = "Points";
     PaymentMethod["Crypto"] = "Crypto";
-})(PaymentMethod || (exports.PaymentMethod = PaymentMethod = {}));
+})(PaymentMethod || (PaymentMethod = {}));
 // 支付状态枚举
-var PaymentStatus;
+export var PaymentStatus;
 (function (PaymentStatus) {
     PaymentStatus["Pending"] = "pending";
     PaymentStatus["Paid"] = "paid";
     PaymentStatus["Failed"] = "failed";
-})(PaymentStatus || (exports.PaymentStatus = PaymentStatus = {}));
+})(PaymentStatus || (PaymentStatus = {}));
 // 退款状态枚举
-var RefundStatus;
+export var RefundStatus;
 (function (RefundStatus) {
     RefundStatus["Requested"] = "requested";
     RefundStatus["Processing"] = "processing";
     RefundStatus["Completed"] = "completed";
     RefundStatus["Rejected"] = "rejected";
-})(RefundStatus || (exports.RefundStatus = RefundStatus = {}));
+})(RefundStatus || (RefundStatus = {}));
 // 配送方式枚举
-var ShippingMethod;
+export var ShippingMethod;
 (function (ShippingMethod) {
     ShippingMethod["Standard"] = "standard";
     ShippingMethod["Express"] = "express";
     ShippingMethod["Pickup"] = "pickup";
-})(ShippingMethod || (exports.ShippingMethod = ShippingMethod = {}));
+})(ShippingMethod || (ShippingMethod = {}));
 // 配送状态枚举
-var ShippingStatus;
+export var ShippingStatus;
 (function (ShippingStatus) {
     ShippingStatus["NotShipped"] = "not_shipped";
     ShippingStatus["Shipped"] = "shipped";
     ShippingStatus["Delivered"] = "delivered";
-})(ShippingStatus || (exports.ShippingStatus = ShippingStatus = {}));
+})(ShippingStatus || (ShippingStatus = {}));
 //# sourceMappingURL=order.js.map

package/dist/types/order.js.map

@@ -1 +1 @@
-{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/types/order.ts"],"names":[],"mappings":";;;AAsBA,SAAS;AACT,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;IACvB,sCAAuB,CAAA;IACvB,oCAAqB,CAAA;IACrB,oCAAqB,CAAA;AACvB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AA+BD,SAAS;AACT,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AAED,SAAS;AACT,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,8BAAa,CAAA;IACb,kCAAiB,CAAA;AACnB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED,SAAS;AACT,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,uCAAuB,CAAA;IACvB,yCAAyB,CAAA;IACzB,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;AACvB,CAAC,EALW,YAAY,4BAAZ,YAAY,QAKvB;AAoBD,SAAS;AACT,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB;AAED,SAAS;AACT,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,4CAA0B,CAAA;IAC1B,qCAAmB,CAAA;IACnB,yCAAuB,CAAA;AACzB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/types/order.ts"],"names":[],"mappings":"AAsBA,SAAS;AACT,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;IACvB,sCAAuB,CAAA;IACvB,oCAAqB,CAAA;IACrB,oCAAqB,CAAA;AACvB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AA+BD,SAAS;AACT,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,SAAS;AACT,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,8BAAa,CAAA;IACb,kCAAiB,CAAA;AACnB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,SAAS;AACT,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,uCAAuB,CAAA;IACvB,yCAAyB,CAAA;IACzB,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;AACvB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAoBD,SAAS;AACT,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED,SAAS;AACT,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,4CAA0B,CAAA;IAC1B,qCAAmB,CAAA;IACnB,yCAAuB,CAAA;AACzB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB"}

package/dist/types/product.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=product.js.map

package/dist/types/user.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=user.js.map

package/dist/utils/generate.util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 生成一个随机且安全的 orderNumber
+ * @param length - orderNumber 的位数
+ * @returns 生成的随机数字字符串
+ */
+export declare function generateOrderNumber(orderSequence?: number): number;
+//# sourceMappingURL=generate.util.d.ts.map

package/dist/utils/generate.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.util.d.ts","sourceRoot":"","sources":["../../src/utils/generate.util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,GAAE,MAAU,GAAG,MAAM,CAqBrE"}

package/dist/utils/generate.util.js

@@ -0,0 +1,30 @@
+/**
+ * 生成一个随机且安全的 orderNumber
+ * @param length - orderNumber 的位数
+ * @returns 生成的随机数字字符串
+ */
+export function generateOrderNumber(orderSequence = 0) {
+    const now = new Date();
+    // 获取年份的后两位
+    const year = now.getFullYear().toString().slice(-2);
+    // 获取今年第几天
+    const start = new Date(now.getFullYear(), 0, 0);
+    const diff = now.getTime() - start.getTime();
+    const dayOfYear = Math.floor(diff / (1000 * 60 * 60 * 24))
+        .toString()
+        .padStart(3, "0");
+    // 序列号递增，并重置为三位
+    if (orderSequence === 0)
+        orderSequence = generateRandomNumber(3);
+    orderSequence = (orderSequence + 1) % 1000;
+    const sequence = orderSequence.toString().padStart(3, "0");
+    // 生成 8 位的随机数，保证不重复
+    const randomPart = Math.random().toString().slice(2, 10); // 生成8位随机数字
+    return Number(`${year}${dayOfYear}${sequence}${randomPart}`);
+}
+function generateRandomNumber(length) {
+    const min = Math.pow(10, length - 1); // 最小值，例如：6位数的最小值为100000
+    const max = Math.pow(10, length) - 1; // 最大值，例如：6位数的最大值为999999
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+//# sourceMappingURL=generate.util.js.map

package/dist/utils/generate.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.util.js","sourceRoot":"","sources":["../../src/utils/generate.util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,gBAAwB,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,WAAW;IACX,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,UAAU;IACV,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;SACvD,QAAQ,EAAE;SACV,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEpB,eAAe;IACf,IAAI,aAAa,KAAK,CAAC;QAAE,aAAa,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjE,aAAa,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE3D,mBAAmB;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW;IAErE,OAAO,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC"}

package/dist/utils/generate.utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 生成一个随机且安全的 orderNumber
+ * @param length - orderNumber 的位数
+ * @returns 生成的随机数字字符串
+ */
+export declare function generateOrderNumber(orderSequence?: number): number;
+//# sourceMappingURL=generate.utils.d.ts.map

package/dist/utils/generate.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.utils.d.ts","sourceRoot":"","sources":["../../src/utils/generate.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,GAAE,MAAU,GAAG,MAAM,CAqBrE"}

package/dist/utils/generate.utils.js

@@ -0,0 +1,30 @@
+/**
+ * 生成一个随机且安全的 orderNumber
+ * @param length - orderNumber 的位数
+ * @returns 生成的随机数字字符串
+ */
+export function generateOrderNumber(orderSequence = 0) {
+    const now = new Date();
+    // 获取年份的后两位
+    const year = now.getFullYear().toString().slice(-2);
+    // 获取今年第几天
+    const start = new Date(now.getFullYear(), 0, 0);
+    const diff = now.getTime() - start.getTime();
+    const dayOfYear = Math.floor(diff / (1000 * 60 * 60 * 24))
+        .toString()
+        .padStart(3, "0");
+    // 序列号递增，并重置为三位
+    if (orderSequence === 0)
+        orderSequence = generateRandomNumber(3);
+    orderSequence = (orderSequence + 1) % 1000;
+    const sequence = orderSequence.toString().padStart(3, "0");
+    // 生成 8 位的随机数，保证不重复
+    const randomPart = Math.random().toString().slice(2, 10); // 生成8位随机数字
+    return Number(`${year}${dayOfYear}${sequence}${randomPart}`);
+}
+function generateRandomNumber(length) {
+    const min = Math.pow(10, length - 1); // 最小值，例如：6位数的最小值为100000
+    const max = Math.pow(10, length) - 1; // 最大值，例如：6位数的最大值为999999
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+//# sourceMappingURL=generate.utils.js.map

package/dist/utils/generate.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.utils.js","sourceRoot":"","sources":["../../src/utils/generate.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,gBAAwB,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,WAAW;IACX,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,UAAU;IACV,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;SACvD,QAAQ,EAAE;SACV,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEpB,eAAe;IACf,IAAI,aAAa,KAAK,CAAC;QAAE,aAAa,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjE,aAAa,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE3D,mBAAmB;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW;IAErE,OAAO,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC"}

package/dist/utils/logger.util.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from "../types/logger.js";
+export declare class ConsoleLogger implements Logger {
+    debug(message: string): void;
+    warn(message: string): void;
+    info(message: string): void;
+    error(message: string): void;
+}
+//# sourceMappingURL=logger.util.d.ts.map

package/dist/utils/logger.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.util.d.ts","sourceRoot":"","sources":["../../src/utils/logger.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,qBAAa,aAAc,YAAW,MAAM;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAG5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAG3B,IAAI,CAAC,OAAO,EAAE,MAAM;IAGpB,KAAK,CAAC,OAAO,EAAE,MAAM;CAGtB"}

package/dist/utils/logger.util.js

@@ -0,0 +1,15 @@
+export class ConsoleLogger {
+    debug(message) {
+        console.debug(`[DEBUG] ${message}`);
+    }
+    warn(message) {
+        console.warn(`[WARN] ${message}`);
+    }
+    info(message) {
+        console.log(`[INFO] ${message}`);
+    }
+    error(message) {
+        console.error(`[ERROR] ${message}`);
+    }
+}
+//# sourceMappingURL=logger.util.js.map

package/dist/utils/logger.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.util.js","sourceRoot":"","sources":["../../src/utils/logger.util.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/utils/scheduler.util.d.ts

@@ -0,0 +1,19 @@
+type Task = () => Promise<boolean>;
+export interface SchedulerOptions {
+    interval?: number;
+    taskTimeout?: number;
+    logInterval?: number;
+    maxRecursions: number;
+    maxRetries?: number;
+    maxTotalTime?: number;
+}
+export declare class Scheduler {
+    private tasks;
+    schedule(task: Task, options: SchedulerOptions): void;
+    private handleTaskError;
+    private timeout;
+    private delay;
+    cancelAll(): void;
+}
+export {};
+//# sourceMappingURL=scheduler.util.d.ts.map

package/dist/utils/scheduler.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.util.d.ts","sourceRoot":"","sources":["../../src/utils/scheduler.util.ts"],"names":[],"mappings":"AAAA,KAAK,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAA2D;IAEjE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;YA0D9C,eAAe;IAmB7B,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,KAAK;IAIN,SAAS,IAAI,IAAI;CAMzB"}

package/dist/utils/scheduler.util.js

@@ -0,0 +1,82 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export class Scheduler {
+    constructor() {
+        this.tasks = new Map();
+    }
+    schedule(task, options) {
+        const { interval = 1000, // 默认 1000 毫秒
+        maxRecursions = 0, // 默认 不 迭代
+        maxRetries = 0, // 默认 不 重试
+        logInterval = 1, // 默认 完整输出 Log
+        taskTimeout = 30000, // 默认 单次执行时间30秒
+        maxTotalTime = 60000, // 默认 最大执行时间60秒
+         } = options || {};
+        let counter = 0;
+        let retries = 0;
+        const startTime = Date.now();
+        const executeTask = () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (maxTotalTime && Date.now() - startTime > maxTotalTime) {
+                    console.log("达到总的最大执行时间，停止任务。");
+                    this.cancelAll();
+                    return;
+                }
+                const shouldContinue = yield Promise.race([
+                    task(),
+                    this.timeout(taskTimeout),
+                ]);
+                counter++;
+                if (shouldContinue && counter < maxRecursions) {
+                    if (counter % logInterval === 0) {
+                        console.log(`递归执行, 第 ${counter} 次, 已执行 ${(Date.now() - startTime) / 1000} 秒`);
+                    }
+                    this.tasks.set(setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+                        yield executeTask();
+                    }), interval), setTimeout(() => { }, interval));
+                }
+                else {
+                    this.cancelAll();
+                }
+            }
+            catch (error) {
+                yield this.handleTaskError(error, retries, maxRetries, executeTask, interval);
+                retries++;
+            }
+        });
+        executeTask();
+    }
+    handleTaskError(error, retries, maxRetries, retryTask, interval) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (retries < maxRetries) {
+                console.error(`Retry attempt ${retries + 1} due to error: ${error}`);
+                yield this.delay(interval * (retries + 1)); // 指数退避
+                yield retryTask(); // 重新执行任务
+            }
+            else {
+                console.error("Max retries reached. Task execution stopped due to persistent errors.");
+                this.cancelAll();
+            }
+        });
+    }
+    timeout(ms) {
+        return new Promise((_, reject) => setTimeout(() => reject("Task timed out"), ms));
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    cancelAll() {
+        this.tasks.forEach((_, taskId) => {
+            clearTimeout(taskId);
+        });
+        this.tasks.clear();
+    }
+}
+//# sourceMappingURL=scheduler.util.js.map

package/dist/utils/scheduler.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.util.js","sourceRoot":"","sources":["../../src/utils/scheduler.util.ts"],"names":[],"mappings":"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"}

package/dist/utils/string.util.d.ts

@@ -0,0 +1,6 @@
+export declare class StringUtils {
+    static capitalize(str: string): string;
+    static trim(str: string): string;
+    static toNumber(value: string): number | null;
+}
+//# sourceMappingURL=string.util.d.ts.map

package/dist/utils/string.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.util.d.ts","sourceRoot":"","sources":["../../src/utils/string.util.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IAEtB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKtC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKhC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAI9C"}

package/dist/utils/string.util.js

@@ -0,0 +1,16 @@
+export class StringUtils {
+    // 首字母大写
+    static capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    // 去除空白字符
+    static trim(str) {
+        return str.trim();
+    }
+    // 将字符串转换为数字
+    static toNumber(value) {
+        const num = Number(value);
+        return isNaN(num) ? null : num;
+    }
+}
+//# sourceMappingURL=string.util.js.map

package/dist/utils/string.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.util.js","sourceRoot":"","sources":["../../src/utils/string.util.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACtB,QAAQ;IACR,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,SAAS;IACT,MAAM,CAAC,IAAI,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,YAAY;IACZ,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;CACF"}

package/dist/utils/string.utils.d.ts

@@ -0,0 +1,6 @@
+export declare class StringUtils {
+    static capitalize(str: string): string;
+    static trim(str: string): string;
+    static toNumber(value: string): number | null;
+}
+//# sourceMappingURL=string.utils.d.ts.map

package/dist/utils/string.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.d.ts","sourceRoot":"","sources":["../../src/utils/string.utils.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IAEtB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKtC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKhC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAI9C"}

package/dist/utils/string.utils.js

@@ -0,0 +1,16 @@
+export class StringUtils {
+    // 首字母大写
+    static capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    // 去除空白字符
+    static trim(str) {
+        return str.trim();
+    }
+    // 将字符串转换为数字
+    static toNumber(value) {
+        const num = Number(value);
+        return isNaN(num) ? null : num;
+    }
+}
+//# sourceMappingURL=string.utils.js.map

package/dist/utils/string.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../src/utils/string.utils.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACtB,QAAQ;IACR,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,SAAS;IACT,MAAM,CAAC,IAAI,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,YAAY;IACZ,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;CACF"}

package/package.json

@@ -1,13 +1,20 @@
 {
   "name": "@edgenets/utils",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Edgenets utilities package containing common types and utilities.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "Edgenets",
+  "license": "MIT",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "eslint --fix && tsc -p tsconfig.json",
-    "test": "tsx ../../node_modules/tap/dist/esm/run.mjs 'test/**/*.spec.ts' || true"
+    "test": "echo 'Skip Tests'",
+    "publish": "pnpm build && npm version patch && npm publish --access public"
   }
 }

package/eslint.config.js

@@ -1,16 +0,0 @@
-import eslint from "@eslint/js";
-import tseslint from "typescript-eslint";
-import prettierConfig from "eslint-config-prettier";
-
-export default tseslint.config({
-  files: ["src/**/*.ts"],
-  extends: [
-    eslint.configs.recommended,
-    ...tseslint.configs.recommended,
-    prettierConfig,
-  ],
-  rules: {
-    "@typescript-eslint/array-type": "error",
-    "@typescript-eslint/consistent-type-imports": "error",
-  },
-});

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "sourceMap": true,
-    "declaration": true,
-    "declarationMap": true,
-    "strict": true
-  },
-  "compileOnSave": true,
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}