@twin.org/core 0.0.1-next.59 → 0.0.1-next.60

package/dist/cjs/index.cjs

@@ -709,7 +709,7 @@ class BaseError extends Error {
      */
     static flatten(err) {
         const flattened = [];
-        let e = BaseError.fromError(err).toJsonObject();
+        let e = BaseError.fromError(err).toJsonObject(true);
         while (e) {
             const inner = e.inner;
             e.inner = undefined;
@@ -3132,10 +3132,23 @@ class ErrorHelper {
     /**
      * Format Errors and returns just their messages.
      * @param error The error to format.
+     * @param includeDetails Whether to include error details, defaults to false.
      * @returns The error formatted including any inner errors.
      */
-    static formatErrors(error) {
-        return ErrorHelper.localizeErrors(error).map(e => e.message);
+    static formatErrors(error, includeDetails) {
+        const localizedErrors = ErrorHelper.localizeErrors(error);
+        if (includeDetails ?? false) {
+            const output = [];
+            for (const err of localizedErrors) {
+                let detailedError = err.message;
+                if (Is.stringValue(err.stack)) {
+                    detailedError += `\n${err.stack}`;
+                }
+                output.push(detailedError);
+            }
+            return output;
+        }
+        return localizedErrors.map(e => e.message);
     }
     /**
      * Localize the content of an error and any inner errors.

package/dist/esm/index.mjs

@@ -707,7 +707,7 @@ class BaseError extends Error {
      */
     static flatten(err) {
         const flattened = [];
-        let e = BaseError.fromError(err).toJsonObject();
+        let e = BaseError.fromError(err).toJsonObject(true);
         while (e) {
             const inner = e.inner;
             e.inner = undefined;
@@ -3130,10 +3130,23 @@ class ErrorHelper {
     /**
      * Format Errors and returns just their messages.
      * @param error The error to format.
+     * @param includeDetails Whether to include error details, defaults to false.
      * @returns The error formatted including any inner errors.
      */
-    static formatErrors(error) {
-        return ErrorHelper.localizeErrors(error).map(e => e.message);
+    static formatErrors(error, includeDetails) {
+        const localizedErrors = ErrorHelper.localizeErrors(error);
+        if (includeDetails ?? false) {
+            const output = [];
+            for (const err of localizedErrors) {
+                let detailedError = err.message;
+                if (Is.stringValue(err.stack)) {
+                    detailedError += `\n${err.stack}`;
+                }
+                output.push(detailedError);
+            }
+            return output;
+        }
+        return localizedErrors.map(e => e.message);
     }
     /**
      * Localize the content of an error and any inner errors.

package/dist/types/helpers/errorHelper.d.ts

@@ -6,9 +6,10 @@ export declare class ErrorHelper {
     /**
      * Format Errors and returns just their messages.
      * @param error The error to format.
+     * @param includeDetails Whether to include error details, defaults to false.
      * @returns The error formatted including any inner errors.
      */
-    static formatErrors(error: unknown): string[];
+    static formatErrors(error: unknown, includeDetails?: boolean): string[];
     /**
      * Localize the content of an error and any inner errors.
      * @param error The error to format.

package/docs/changelog.md

@@ -1,5 +1,12 @@
 # @twin.org/core - Changelog
 
+## [0.0.1-next.60](https://github.com/twinfoundation/framework/compare/core-v0.0.1-next.59...core-v0.0.1-next.60) (2025-06-17)
+
+
+### Features
+
+* improve error display in CLI ([94b6ca8](https://github.com/twinfoundation/framework/commit/94b6ca8bdcfe3ca7671c4095b436ea7bddaae98e))
+
 ## [0.0.1-next.59](https://github.com/twinfoundation/framework/compare/core-v0.0.1-next.58...core-v0.0.1-next.59) (2025-06-17)
 
 

package/docs/reference/classes/ErrorHelper.md

@@ -16,7 +16,7 @@ Error helper functions.
 
 ### formatErrors()
 
-> `static` **formatErrors**(`error`): `string`[]
+> `static` **formatErrors**(`error`, `includeDetails?`): `string`[]
 
 Format Errors and returns just their messages.
 
@@ -28,6 +28,12 @@ Format Errors and returns just their messages.
 
 The error to format.
 
+##### includeDetails?
+
+`boolean`
+
+Whether to include error details, defaults to false.
+
 #### Returns
 
 `string`[]

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.1-next.59",
+	"version": "0.0.1-next.60",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",