@oliversalzburg/js-utils 0.0.59-dev.1 → 0.0.59-dev.3

package/errors/error-serializer.d.ts

@@ -21,6 +21,15 @@ export declare const isError: (subject: unknown) => subject is Error;
  * @group Errors
  */
 export declare const unknownToError: (subject: unknown) => AbstractError;
+/**
+ * Serializes an error into a string.
+ * @param error - The error to stringify.
+ * @returns A string representing the error.
+ * @group Errors
+ */
+export declare const errorToString: (error: Error & {
+    toString?: () => string;
+}) => string;
 /**
  * Serializes an error into a JSON string.
  * @param error - The error to stringify.

package/errors/error-serializer.js

@@ -1,3 +1,4 @@
+import { isNil } from "../data/nil.js";
 import { AbstractError } from "./AbstractError.js";
 import { InternalError } from "./InternalError.js";
 import { UnknownError } from "./UnknownError.js";
@@ -27,6 +28,15 @@ export const unknownToError = (subject) => {
     }
     return new UnknownError(String(subject));
 };
+/**
+ * Serializes an error into a string.
+ * @param error - The error to stringify.
+ * @returns A string representing the error.
+ * @group Errors
+ */
+export const errorToString = (error) => {
+    return isNil(error.toString) ? Object.prototype.toString.call(error) : error.toString();
+};
 /**
  * Serializes an error into a JSON string.
  * @param error - The error to stringify.

package/errors/error-serializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-serializer.js","sourceRoot":"","sources":["../../source/errors/error-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAoB,EAAE;IAC5D,OAAO,OAAO,YAAY,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,gBAAgB,CAAC;AAClG,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAiB,EAAE;IAChE,IAAI,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,OAAO,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAY,EAAU,EAAE;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAY,EAA2B,EAAE;IACrE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,YAAkC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAa,EACI,EAAE;IACnB,MAAM,UAAU,GAAoB;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}
+{"version":3,"file":"error-serializer.js","sourceRoot":"","sources":["../../source/errors/error-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAoB,EAAE;IAC5D,OAAO,OAAO,YAAY,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,gBAAgB,CAAC;AAClG,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAiB,EAAE;IAChE,IAAI,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,OAAO,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAA0C,EAAU,EAAE;IAClF,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1F,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAY,EAAU,EAAE;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAY,EAA2B,EAAE;IACrE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,YAAkC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAa,EACI,EAAE;IACnB,MAAM,UAAU,GAAoB;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}

package/errors/stream.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns a function that will receive errors (or anything else that was `throw`n)
+ * and prints it to a {@linkcode NodeJS.WriteStream}.
+ * @param stream - The stream to print errors to.
+ * @returns A function that will print errors to the stream.
+ * @group Errors
+ */
+export declare const redirectErrorsToStream: (stream: NodeJS.WriteStream) => ((error: unknown) => void);

package/errors/stream.js

@@ -0,0 +1,16 @@
+import { errorToString, unknownToError } from "./error-serializer.js";
+/**
+ * Returns a function that will receive errors (or anything else that was `throw`n)
+ * and prints it to a {@linkcode NodeJS.WriteStream}.
+ * @param stream - The stream to print errors to.
+ * @returns A function that will print errors to the stream.
+ * @group Errors
+ */
+export const redirectErrorsToStream = (stream) => {
+    const printErrorsToStream = (unknownError) => {
+        const error = unknownToError(unknownError);
+        stream.write(errorToString(error) + "\n");
+    };
+    return printErrorsToStream;
+};
+//# sourceMappingURL=stream.js.map

package/errors/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../source/errors/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAA0B,EAA8B,EAAE;IAC/F,MAAM,mBAAmB,GAAG,CAAC,YAAqB,EAAQ,EAAE;QAC1D,MAAM,KAAK,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC;IACF,OAAO,mBAAmB,CAAC;AAC7B,CAAC,CAAC"}

package/errors/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * General error-related tooling that fits no other module.
+ * @module
+ */
+/**
+ * Throws the provided error.
+ * @param error - The error that will be thrown.
+ * @throws The provided error.
+ * @group Errors
+ */
+export declare const rethrow: (error: unknown) => never;

package/errors/tools.js

@@ -0,0 +1,14 @@
+/**
+ * General error-related tooling that fits no other module.
+ * @module
+ */
+/**
+ * Throws the provided error.
+ * @param error - The error that will be thrown.
+ * @throws The provided error.
+ * @group Errors
+ */
+export const rethrow = (error) => {
+    throw error;
+};
+//# sourceMappingURL=tools.js.map

package/errors/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../source/errors/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE;IACxC,MAAM,KAAK,CAAC;AACd,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@oliversalzburg/js-utils",
-  "version": "0.0.59-dev.1",
+  "version": "0.0.59-dev.3",
   "license": "MIT",
   "author": "Oliver Salzburg <oliver.salzburg@gmail.com>",
   "repository": {