@dinoxx/dinox-cli 1.0.16 → 1.0.18

package/dist/utils/errors.d.ts

@@ -1,10 +1,27 @@
+export type DinoxErrorOptions = {
+    exitCode?: number;
+    cause?: unknown;
+    details?: unknown;
+    code?: string;
+    suggestion?: string;
+    recoverable?: boolean;
+};
+export type StructuredErrorPayload = {
+    name: string;
+    code: string;
+    message: string;
+    recoverable: boolean;
+    suggestion?: string;
+    details?: unknown;
+    stack?: string;
+};
 export declare class DinoxError extends Error {
     readonly exitCode: number;
     readonly details?: unknown;
-    constructor(message: string, options?: {
-        exitCode?: number;
-        cause?: unknown;
-        details?: unknown;
-    });
+    readonly code?: string;
+    readonly suggestion?: string;
+    readonly recoverable: boolean;
+    constructor(message: string, options?: DinoxErrorOptions);
 }
 export declare function isDinoxError(error: unknown): error is DinoxError;
+export declare function buildStructuredErrorPayload(error: unknown, verbose: boolean): StructuredErrorPayload;

package/dist/utils/errors.js

@@ -1,11 +1,17 @@
 export class DinoxError extends Error {
     exitCode;
     details;
+    code;
+    suggestion;
+    recoverable;
     constructor(message, options) {
         super(message);
         this.name = 'DinoxError';
         this.exitCode = options?.exitCode ?? 1;
         this.details = options?.details;
+        this.code = options?.code;
+        this.suggestion = options?.suggestion;
+        this.recoverable = options?.recoverable ?? true;
         if (options?.cause !== undefined) {
             // Node 16+ supports Error.cause.
             this.cause = options.cause;
@@ -15,3 +21,26 @@ export class DinoxError extends Error {
 export function isDinoxError(error) {
     return Boolean(error) && typeof error === 'object' && error.name === 'DinoxError';
 }
+export function buildStructuredErrorPayload(error, verbose) {
+    const message = error instanceof Error ? error.message : String(error);
+    const name = error instanceof Error ? error.name : 'Error';
+    const stack = error instanceof Error ? error.stack : undefined;
+    if (isDinoxError(error)) {
+        return {
+            name,
+            code: error.code ?? 'DINOX_ERROR',
+            message,
+            recoverable: error.recoverable,
+            ...(error.suggestion ? { suggestion: error.suggestion } : {}),
+            ...(error.details !== undefined ? { details: error.details } : {}),
+            ...(verbose && stack ? { stack } : {}),
+        };
+    }
+    return {
+        name,
+        code: 'INTERNAL_ERROR',
+        message,
+        recoverable: false,
+        ...(verbose && stack ? { stack } : {}),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dinoxx/dinox-cli",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "Dinox CLI",
   "main": "dist/dinox.js",
   "scripts": {