@monque/core 1.3.0 → 1.4.0

package/src/shared/index.ts

@@ -14,5 +14,6 @@ export {
 	DEFAULT_BASE_INTERVAL,
 	DEFAULT_MAX_BACKOFF_DELAY,
 	getNextCronDate,
+	toError,
 	validateCronExpression,
 } from './utils/index.js';

package/src/shared/utils/error.ts

@@ -0,0 +1,33 @@
+/**
+ * Normalize an unknown caught value into a proper `Error` instance.
+ *
+ * In JavaScript, any value can be thrown — strings, numbers, objects, `undefined`, etc.
+ * This function ensures we always have a real `Error` with a proper stack trace and message.
+ *
+ * @param value - The caught value (typically from a `catch` block typed as `unknown`).
+ * @returns The original value if already an `Error`, otherwise a new `Error` wrapping `String(value)`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   riskyOperation();
+ * } catch (error: unknown) {
+ *   const normalized = toError(error);
+ *   console.error(normalized.message);
+ * }
+ * ```
+ *
+ * @internal
+ */
+export function toError(value: unknown): Error {
+	if (value instanceof Error) return value;
+
+	try {
+		return new Error(String(value));
+	} catch (conversionError: unknown) {
+		const detail =
+			conversionError instanceof Error ? conversionError.message : 'unknown conversion failure';
+
+		return new Error(`Unserializable value (${detail})`);
+	}
+}

package/src/shared/utils/index.ts

@@ -5,3 +5,4 @@ export {
 	DEFAULT_MAX_BACKOFF_DELAY,
 } from './backoff.js';
 export { getNextCronDate, validateCronExpression } from './cron.js';
+export { toError } from './error.js';