@nannygoose-utils/async-handler 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 处理异步 Promise 操作的错误
+ * @param promise 要执行的异步 Promise 操作
+ * @returns 数组 [error, result]：成功时 error 为 null，失败时 result 为 undefined
+ */
+export declare function to<T>(promise: Promise<T>): Promise<[Error | null, T | undefined]>;
+/**
+ * 扩展：处理同步函数的错误（保持和 to 函数一致的返回格式）
+ * @param fn 要执行的同步函数
+ * @returns 数组 [error, result]
+ * @example
+ * const [err, parsedData] = toSync(() => JSON.parse('{"name":"test"}'));
+ */
+export declare function toSync<T>(fn: () => T): [Error | null, T | undefined];
+export type AsyncResult<T> = [Error | null, T | undefined];
+export type SyncResult<T> = [Error | null, T | undefined];

package/dist/index.mjs

@@ -0,0 +1,60 @@
+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());
+    });
+};
+/**
+ * 标准化错误对象
+ * @param error 捕获到的任意类型错误
+ * @returns 标准 Error 对象
+ */
+function normalizeError(error) {
+    // 如果已经是 Error 实例，直接返回
+    if (error instanceof Error) {
+        return error;
+    }
+    // 处理对象类型的错误（如 { message: 'xxx' }）
+    if (error instanceof Object) {
+        return new Error(JSON.stringify(error));
+    }
+    // 处理字符串/数字等基础类型错误
+    return new Error(String(error));
+}
+/**
+ * 处理异步 Promise 操作的错误
+ * @param promise 要执行的异步 Promise 操作
+ * @returns 数组 [error, result]：成功时 error 为 null，失败时 result 为 undefined
+ */
+export function to(promise) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const result = yield promise;
+            return [null, result];
+        }
+        catch (error) {
+            const normalizedError = normalizeError(error);
+            return [normalizedError, undefined];
+        }
+    });
+}
+/**
+ * 扩展：处理同步函数的错误（保持和 to 函数一致的返回格式）
+ * @param fn 要执行的同步函数
+ * @returns 数组 [error, result]
+ * @example
+ * const [err, parsedData] = toSync(() => JSON.parse('{"name":"test"}'));
+ */
+export function toSync(fn) {
+    try {
+        const result = fn();
+        return [null, result];
+    }
+    catch (error) {
+        const normalizedError = normalizeError(error);
+        return [normalizedError, undefined];
+    }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+"name": "@nannygoose-utils/async-handler",
+  "version": "1.0.0",
+  "description": "异步/同步错误处理工具，统一返回 [error, result] 格式",
+  "main": "./dist/index.js",           
+  "module": "./dist/index.mjs",  
+  "types": "./dist/index.d.ts",
+
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+     "build": "tsc && node -e \"require('fs').renameSync('dist/index.js', 'dist/index.mjs')\"",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "<tandongyang@1ceng.com>",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "typescript": "^5.9.3"
+  }
+}