@lowdefy/errors 0.0.0-experimental-20260204091424 → 0.0.0-experimental-20260204101136

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,15 @@
  *   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() {
+        const message = formatErrorMessage(this);
+        if (this.stack) {
+            return `${message}\n${this.stack}`;
+        }
+        return message;
+    }
     /**
    * 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/UserError.js

@@ -0,0 +1,28 @@
+/*
+  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.
+*/ import formatErrorMessage from './formatErrorMessage.js';
+let UserError = class UserError extends Error {
+    print() {
+        return formatErrorMessage(this);
+    }
+    constructor(message, { blockId, metaData, pageId } = {}){
+        super(message);
+        this.name = 'UserError';
+        this.blockId = blockId;
+        this.metaData = metaData;
+        this.pageId = pageId;
+    }
+};
+export default UserError;

package/dist/build/ConfigError.js

@@ -84,23 +84,22 @@ import ConfigMessage from './ConfigMessage.js';
             this.resolved = true;
             return;
         }
-        // Resolve location based on available info
+        // Resolve location based on available info, falling through if a method returns null
         let location = null;
         const configDir = configDirectory ?? context?.directories?.config;
         if (configKey && context?.keyMap) {
-            // Mode 1: Use configKey -> keyMap -> refMap path (standard case after addKeys)
             location = ConfigMessage.resolveLocation({
                 configKey,
                 context
             });
-        } else if (operatorLocation && context?.refMap) {
-            // Mode 2: Use operatorLocation directly with refMap (early build stages)
+        }
+        if (!location && operatorLocation && context?.refMap) {
             location = ConfigMessage.resolveOperatorLocation({
                 operatorLocation,
                 context
             });
-        } else if (filePath) {
-            // Mode 3: Use raw filePath/lineNumber (YAML parse errors, etc.)
+        }
+        if (!location && filePath) {
             location = ConfigMessage.resolveRawLocation({
                 filePath,
                 lineNumber: finalLineNumber,

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.
@@ -87,16 +87,17 @@ import resolveConfigLocation from './resolveConfigLocation.js';
    */ static resolveOperatorLocation({ operatorLocation, context }) {
         if (!operatorLocation) return null;
         const refEntry = context?.refMap?.[operatorLocation.ref];
-        const filePath = refEntry?.path ?? 'lowdefy.yaml';
+        if (!refEntry?.path) return null;
+        const filePath = refEntry.path;
         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 +109,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;
@@ -73,7 +78,7 @@ import ConfigMessage from './ConfigMessage.js';
             this.link = null;
             return;
         }
-        // Resolve location based on available info
+        // Resolve location based on available info, falling through if a method returns null
         let location = null;
         const configDir = configDirectory ?? context?.directories?.config;
         if (configKey && context?.keyMap) {
@@ -81,12 +86,14 @@ import ConfigMessage from './ConfigMessage.js';
                 configKey,
                 context
             });
-        } else if (operatorLocation && context?.refMap) {
+        }
+        if (!location && operatorLocation && context?.refMap) {
             location = ConfigMessage.resolveOperatorLocation({
                 operatorLocation,
                 context
             });
-        } else if (filePath) {
+        }
+        if (!location && filePath) {
             location = ConfigMessage.resolveRawLocation({
                 filePath,
                 lineNumber,

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/client/LowdefyError.js

@@ -0,0 +1,55 @@
+/*
+  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.
+*/ import BaseLowdefyError from '../LowdefyError.js';
+/**
+ * Client-side LowdefyError with server logging via API.
+ *
+ * Extends the base LowdefyError to add a log() method that sends
+ * the error to /api/client-error for terminal logging, then logs
+ * to the browser console.
+ *
+ * @example
+ * const error = new LowdefyError('Unexpected condition');
+ * await error.log(lowdefy);
+ */ let LowdefyError = class LowdefyError extends BaseLowdefyError {
+    /**
+   * Sends the error to the server for terminal logging and logs to console.
+   * @param {Object} [lowdefy] - Lowdefy context with basePath
+   * @param {Object} [options]
+   * @param {number} [options.timeout=1000] - Fetch timeout in ms
+   * @returns {Promise<void>}
+   */ async log(lowdefy, { timeout = 1000 } = {}) {
+        const basePath = lowdefy?.basePath ?? '';
+        const controller = new AbortController();
+        const timeoutId = setTimeout(()=>controller.abort(), timeout);
+        try {
+            await fetch(`${basePath}/api/client-error`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(this.serialize()),
+                signal: controller.signal,
+                credentials: 'same-origin'
+            });
+            clearTimeout(timeoutId);
+        } catch  {
+            clearTimeout(timeoutId);
+        // Server logging failed - continue with local console
+        }
+        console.error(this.print());
+    }
+};
+export default LowdefyError;

package/dist/client/index.js

@@ -24,7 +24,8 @@
  * await error.resolve(lowdefy);
  */ import ConfigError from './ConfigError.js';
 import ConfigWarning from '../ConfigWarning.js';
-import LowdefyError from '../LowdefyError.js';
+import LowdefyError from './LowdefyError.js';
 import PluginError from '../PluginError.js';
 import ServiceError from '../ServiceError.js';
-export { ConfigError, ConfigWarning, LowdefyError, PluginError, ServiceError };
+import UserError from '../UserError.js';
+export { ConfigError, ConfigWarning, LowdefyError, PluginError, ServiceError, UserError };

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/dist/index.js

@@ -45,4 +45,5 @@ import ConfigWarning from './ConfigWarning.js';
 import LowdefyError from './LowdefyError.js';
 import PluginError from './PluginError.js';
 import ServiceError from './ServiceError.js';
-export { ConfigError, ConfigWarning, LowdefyError, PluginError, ServiceError };
+import UserError from './UserError.js';
+export { ConfigError, ConfigWarning, LowdefyError, PluginError, ServiceError, UserError };

package/package.json

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