yummies 4.1.1 → 4.2.0

package/errors.d.ts

@@ -0,0 +1,19 @@
+import { Maybe } from './utils/types.js';
+type ErrorToTextEnhancer = (error: any) => string;
+type ErrorToTextFormatErrorFn = (error: Error) => string;
+/**
+ * Universal function for transforming any errors into readable error text
+ *
+ * This function can be enhanced with custom handlers using:
+ * - `errorToText.unknownErrorText`
+ * - `errorToText.formatError`
+ * - `errorToText.enhance`
+ */
+export declare const errorToText: {
+    (error: unknown): string;
+    unknownErrorText: string;
+    formatError: Maybe<ErrorToTextFormatErrorFn>;
+    enhance: Maybe<ErrorToTextEnhancer>;
+};
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC;AAClD,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;YAAW,OAAO;;;;CAkBzC,CAAC"}

package/errors.js

@@ -0,0 +1,29 @@
+import { typeGuard } from './type-guard/index.js';
+/**
+ * Universal function for transforming any errors into readable error text
+ *
+ * This function can be enhanced with custom handlers using:
+ * - `errorToText.unknownErrorText`
+ * - `errorToText.formatError`
+ * - `errorToText.enhance`
+ */
+export const errorToText = (error) => {
+    if (!error) {
+        return errorToText.unknownErrorText;
+    }
+    if (typeGuard.isString(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return errorToText.formatError?.(error) ?? error.message;
+    }
+    if (errorToText.enhance) {
+        return errorToText.enhance(error);
+    }
+    else {
+        return errorToText.unknownErrorText;
+    }
+};
+errorToText.unknownErrorText = '';
+errorToText.formatError = null;
+errorToText.enhance = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "keywords": [],
   "author": "js2me",
   "license": "MIT",
@@ -108,6 +108,11 @@
       "default": "./encodings.js",
       "types": "./encodings.d.ts"
     },
+    "./errors": {
+      "import": "./errors.js",
+      "default": "./errors.js",
+      "types": "./errors.d.ts"
+    },
     "./file": {
       "import": "./file.js",
       "default": "./file.js",