yummies 4.1.1 → 4.2.1

package/errors.d.ts

@@ -0,0 +1,19 @@
+import { Maybe } from './utils/types.js';
+type GetErrorTextEnhancer = (error: any) => string;
+type GetErrorTextFormatErrorFn = (error: Error) => string;
+/**
+ * Universal function for transforming any errors into readable error text
+ *
+ * This function can be enhanced with custom handlers using:
+ * - `getErrorText.unknownErrorText`
+ * - `getErrorText.formatError`
+ * - `getErrorText.enhance`
+ */
+export declare const getErrorText: {
+    (error: unknown): string;
+    unknownErrorText: string;
+    formatError: Maybe<GetErrorTextFormatErrorFn>;
+    enhance: Maybe<GetErrorTextEnhancer>;
+};
+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,oBAAoB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC;AACnD,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;YAAW,OAAO;;;;CAkB1C,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:
+ * - `getErrorText.unknownErrorText`
+ * - `getErrorText.formatError`
+ * - `getErrorText.enhance`
+ */
+export const getErrorText = (error) => {
+    if (!error) {
+        return getErrorText.unknownErrorText;
+    }
+    if (typeGuard.isString(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return getErrorText.formatError?.(error) ?? error.message;
+    }
+    if (getErrorText.enhance) {
+        return getErrorText.enhance(error);
+    }
+    else {
+        return getErrorText.unknownErrorText;
+    }
+};
+getErrorText.unknownErrorText = '';
+getErrorText.formatError = null;
+getErrorText.enhance = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "4.1.1",
+  "version": "4.2.1",
   "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",