@lowdefy/errors 0.0.0-experimental-20260202141107 → 0.0.0-experimental-20260202141952

package/dist/ConfigError.js

@@ -31,7 +31,11 @@
  *   configKey: block['~k'],
  *   location: { source: 'pages/home.yaml:42', link: '/path/to/pages/home.yaml:42' }
  * });
- */ let ConfigError = class ConfigError extends Error {
+ */ import formatErrorMessage from './formatErrorMessage.js';
+let ConfigError = class ConfigError extends Error {
+    print() {
+        return formatErrorMessage(this);
+    }
     /**
    * Serializes the error for transport (e.g., client to server).
    * @returns {Object} Serialized error data with type marker
@@ -68,7 +72,7 @@
         const configKey = isString ? null : messageOrParams.configKey ?? error?.configKey;
         const location = isString ? null : messageOrParams.location;
         const checkSlug = isString ? undefined : messageOrParams.checkSlug;
-        const received = isString ? undefined : messageOrParams.received;
+        const received = isString ? undefined : messageOrParams.received !== undefined ? messageOrParams.received : error?.received;
         const operatorLocation = isString ? null : messageOrParams.operatorLocation;
         // Message without prefix - logger uses error.name for display
         super(message);

package/dist/ConfigWarning.js

@@ -23,12 +23,17 @@
  * @example
  * const warning = new ConfigWarning({ message: 'Deprecated feature used', source: 'config.yaml:10' });
  * console.warn(warning.message);
- */ let ConfigWarning = class ConfigWarning {
+ */ import formatErrorMessage from './formatErrorMessage.js';
+let ConfigWarning = class ConfigWarning {
+    print() {
+        return formatErrorMessage(this);
+    }
     /**
    * @param {Object} params
    * @param {string} params.message - The warning message
    * @param {string} [params.source] - Source file:line
    */ constructor({ message, source }){
+        this.name = 'Config Warning';
         // Message without prefix - logger uses class name for display
         this.message = message;
         this.source = source ?? null;

package/dist/LowdefyError.js

@@ -28,7 +28,11 @@
  *   console.error(err.message);
  *   console.error(err.stack);
  * }
- */ let LowdefyError = class LowdefyError extends Error {
+ */ import formatErrorMessage from './formatErrorMessage.js';
+let LowdefyError = class LowdefyError extends Error {
+    print() {
+        return formatErrorMessage(this);
+    }
     /**
    * Serializes the error for transport (e.g., client to server).
    * @returns {Object} Serialized error data with type marker

package/dist/PluginError.js

@@ -35,7 +35,11 @@
  *   });
  * }
  * // error.message = "[Plugin Error] _if requires boolean test. Received: {...} at blocks.0.properties.visible."
- */ let PluginError = class PluginError extends Error {
+ */ import formatErrorMessage from './formatErrorMessage.js';
+let PluginError = class PluginError extends Error {
+    print() {
+        return formatErrorMessage(this);
+    }
     /**
    * Serializes the error for transport (e.g., client to server).
    * @returns {Object} Serialized error data with type marker
@@ -43,6 +47,7 @@
         return {
             '~err': 'PluginError',
             message: this.message,
+            rawMessage: this.rawMessage,
             pluginType: this.pluginType,
             pluginName: this.pluginName,
             location: this.location,
@@ -57,14 +62,20 @@
    * @param {Object} data - Serialized error data
    * @returns {PluginError}
    */ static deserialize(data) {
+        // Use rawMessage if available, fallback to message
+        const messageToUse = data.rawMessage || data.message;
         const error = new PluginError({
-            error: new Error(data.message),
+            message: messageToUse,
             pluginType: data.pluginType,
             pluginName: data.pluginName,
             configKey: data.configKey
         });
         // Set location separately to preserve it without re-formatting message
         error.location = data.location;
+        // Preserve the formatted message if different from rawMessage
+        if (data.message && data.message !== messageToUse) {
+            error.message = data.message;
+        }
         if (data.stack) {
             error.stack = data.stack;
         }
@@ -85,7 +96,7 @@
         const rawMessage = message ?? error?.message;
         let formattedMessage = rawMessage;
         if (location) {
-            formattedMessage += ` at ${location}.`;
+            formattedMessage = rawMessage != null ? `${rawMessage} at ${location}.` : `at ${location}.`;
         }
         super(formattedMessage, {
             cause: error
@@ -94,7 +105,7 @@
         this.pluginType = pluginType;
         this.pluginName = pluginName;
         this.rawMessage = rawMessage; // Original message without location
-        this.received = received;
+        this.received = received !== undefined ? received : error?.received;
         this.location = location;
         this.configKey = error?.configKey ?? configKey ?? null;
         // Location info (set by server-side resolution)

package/dist/ServiceError.js

@@ -48,7 +48,8 @@
  *   throw new PluginError({ error, ... });
  * }
  * // error.message = "[Service Error] MongoDB: Connection refused. The service may be down..."
- */ let ServiceError = class ServiceError extends Error {
+ */ import formatErrorMessage from './formatErrorMessage.js';
+let ServiceError = class ServiceError extends Error {
     /**
    * Checks if an error is a service error (network issues, timeouts, 5xx).
    * @param {Error} error - The error to check
@@ -95,6 +96,9 @@
         }
         return error.message;
     }
+    print() {
+        return formatErrorMessage(this);
+    }
     /**
    * Serializes the error for transport (e.g., client to server).
    * @returns {Object} Serialized error data with type marker

package/dist/build/ConfigMessage.js

@@ -25,8 +25,8 @@ import resolveConfigLocation from './resolveConfigLocation.js';
     'link-refs': 'Invalid Link action page reference warnings',
     'request-refs': 'Invalid Request action reference warnings',
     'connection-refs': 'Nonexistent connection ID references',
-    types: 'All type validation (blocks, operators, actions, requests, connections)',
-    schema: 'JSON schema validation errors'
+    'types': 'All type validation (blocks, operators, actions, requests, connections)',
+    'schema': 'JSON schema validation errors'
 };
 /**
  * Base class for config message utilities.
@@ -89,14 +89,14 @@ import resolveConfigLocation from './resolveConfigLocation.js';
         const refEntry = context?.refMap?.[operatorLocation.ref];
         const filePath = refEntry?.path ?? 'lowdefy.yaml';
         const lineNumber = operatorLocation.line;
-        const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
-        let link = null;
+        let resolvedPath = filePath;
         if (context?.directories?.config) {
-            link = path.join(context.directories.config, filePath) + (lineNumber ? `:${lineNumber}` : '');
+            resolvedPath = path.join(context.directories.config, filePath);
         }
+        const source = lineNumber ? `${resolvedPath}:${lineNumber}` : resolvedPath;
         return {
             source,
-            link
+            link: source
         };
     }
     /**
@@ -108,14 +108,14 @@ import resolveConfigLocation from './resolveConfigLocation.js';
    * @param {string} [params.configDirectory] - Config directory for link
    * @returns {Object} Location object { source, link }
    */ static resolveRawLocation({ filePath, lineNumber, configDirectory }) {
-        const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
-        let link = null;
+        let resolvedPath = filePath;
         if (configDirectory) {
-            link = path.join(configDirectory, filePath) + (lineNumber ? `:${lineNumber}` : '');
+            resolvedPath = path.join(configDirectory, filePath);
         }
+        const source = lineNumber ? `${resolvedPath}:${lineNumber}` : resolvedPath;
         return {
             source,
-            link
+            link: source
         };
     }
 };

package/dist/build/ConfigWarning.js

@@ -14,6 +14,7 @@
   limitations under the License.
 */ import ConfigError from './ConfigError.js';
 import ConfigMessage from './ConfigMessage.js';
+import formatErrorMessage from '../formatErrorMessage.js';
 /**
  * Build-time configuration warning class.
  * All formatting happens in the constructor - properties are ready for the logger.
@@ -31,6 +32,9 @@ import ConfigMessage from './ConfigMessage.js';
  * // Throws ConfigError in prod mode when prodError is true
  * new ConfigWarning({ message, configKey, context, prodError: true });
  */ let ConfigWarning = class ConfigWarning {
+    print() {
+        return formatErrorMessage(this);
+    }
     /**
    * @param {Object} params
    * @param {string} params.message - The warning message
@@ -57,6 +61,7 @@ import ConfigMessage from './ConfigMessage.js';
             });
         }
         // Store all properties for the logger
+        this.name = 'Config Warning';
         this.configKey = configKey ?? null;
         this.checkSlug = checkSlug;
         this.received = received;

package/dist/build/resolveConfigLocation.js

@@ -31,7 +31,7 @@
  *   configDirectory: '/Users/dev/myapp'
  * });
  * // Returns: {
- * //   source: 'pages/home.yaml:5',
+ * //   source: '/Users/dev/myapp/pages/home.yaml:5',
  * //   config: 'root.pages[0:home].blocks[0:header]',
  * //   link: '/Users/dev/myapp/pages/home.yaml:5'
  * // }
@@ -44,20 +44,18 @@
     const lineNumber = keyEntry['~l'];
     const refEntry = refMap?.[refId];
     const filePath = refEntry?.path || 'lowdefy.yaml';
-    // source: filepath:line (e.g., "lowdefy.yaml:16")
-    const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
     // config: the config path (e.g., "root.pages[0:home].blocks[0:header]")
     const config = keyEntry.key;
-    // Absolute path for clickable links in VSCode terminal
-    let link = null;
+    // Use absolute path when configDirectory is available for clickable terminal links
+    let resolvedPath = filePath;
     if (configDirectory) {
-        const absolutePath = path.resolve(configDirectory, filePath);
-        link = lineNumber ? `${absolutePath}:${lineNumber}` : absolutePath;
+        resolvedPath = path.resolve(configDirectory, filePath);
     }
+    const source = lineNumber ? `${resolvedPath}:${lineNumber}` : resolvedPath;
     return {
         source,
         config,
-        link
+        link: source
     };
 }
 export default resolveConfigLocation;

package/dist/formatErrorMessage.js

@@ -0,0 +1,31 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ function formatErrorMessage(error, { includePrefix = true } = {}) {
+    if (typeof error === 'string') return error;
+    let message = error?.message || error?.rawMessage || error?.cause?.message || 'Unknown error';
+    if (error?.received !== undefined) {
+        try {
+            message = `${message} Received: ${JSON.stringify(error.received)}`;
+        } catch  {
+            message = `${message} Received: [unserializable]`;
+        }
+    }
+    if (includePrefix) {
+        const name = error?.name || 'Error';
+        return `[${name}] ${message}`;
+    }
+    return message;
+}
+export default formatErrorMessage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/errors",
-  "version": "0.0.0-experimental-20260202141107",
+  "version": "0.0.0-experimental-20260202141952",
   "license": "Apache-2.0",
   "description": "Lowdefy error classes for consistent error handling across build, server, and client",
   "homepage": "https://lowdefy.com",