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

package/dist/ConfigError.js

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

package/dist/ConfigWarning.js

@@ -23,17 +23,12 @@
  * @example
  * const warning = new ConfigWarning({ message: 'Deprecated feature used', source: 'config.yaml:10' });
  * console.warn(warning.message);
- */ import formatErrorMessage from './formatErrorMessage.js';
-let ConfigWarning = class ConfigWarning {
-    print() {
-        return formatErrorMessage(this);
-    }
+ */ let ConfigWarning = class ConfigWarning {
     /**
    * @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,15 +28,7 @@
  *   console.error(err.message);
  *   console.error(err.stack);
  * }
- */ 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;
-    }
+ */ let LowdefyError = class LowdefyError extends Error {
     /**
    * Serializes the error for transport (e.g., client to server).
    * @returns {Object} Serialized error data with type marker

package/dist/PluginError.js

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

package/dist/ServiceError.js

@@ -48,8 +48,7 @@
  *   throw new PluginError({ error, ... });
  * }
  * // error.message = "[Service Error] MongoDB: Connection refused. The service may be down..."
- */ import formatErrorMessage from './formatErrorMessage.js';
-let ServiceError = class ServiceError extends Error {
+ */ 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
@@ -96,9 +95,6 @@ let ServiceError = class ServiceError extends Error {
         }
         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/ConfigError.js

@@ -84,22 +84,23 @@ import ConfigMessage from './ConfigMessage.js';
             this.resolved = true;
             return;
         }
-        // Resolve location based on available info, falling through if a method returns null
+        // Resolve location based on available info
         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
             });
-        }
-        if (!location && operatorLocation && context?.refMap) {
+        } else if (operatorLocation && context?.refMap) {
+            // Mode 2: Use operatorLocation directly with refMap (early build stages)
             location = ConfigMessage.resolveOperatorLocation({
                 operatorLocation,
                 context
             });
-        }
-        if (!location && filePath) {
+        } else if (filePath) {
+            // Mode 3: Use raw filePath/lineNumber (YAML parse errors, etc.)
             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,17 +87,16 @@ import resolveConfigLocation from './resolveConfigLocation.js';
    */ static resolveOperatorLocation({ operatorLocation, context }) {
         if (!operatorLocation) return null;
         const refEntry = context?.refMap?.[operatorLocation.ref];
-        if (!refEntry?.path) return null;
-        const filePath = refEntry.path;
+        const filePath = refEntry?.path ?? 'lowdefy.yaml';
         const lineNumber = operatorLocation.line;
-        let resolvedPath = filePath;
+        const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
+        let link = null;
         if (context?.directories?.config) {
-            resolvedPath = path.join(context.directories.config, filePath);
+            link = path.join(context.directories.config, filePath) + (lineNumber ? `:${lineNumber}` : '');
         }
-        const source = lineNumber ? `${resolvedPath}:${lineNumber}` : resolvedPath;
         return {
             source,
-            link: source
+            link
         };
     }
     /**
@@ -109,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 }) {
-        let resolvedPath = filePath;
+        const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
+        let link = null;
         if (configDirectory) {
-            resolvedPath = path.join(configDirectory, filePath);
+            link = path.join(configDirectory, filePath) + (lineNumber ? `:${lineNumber}` : '');
         }
-        const source = lineNumber ? `${resolvedPath}:${lineNumber}` : resolvedPath;
         return {
             source,
-            link: source
+            link
         };
     }
 };

package/dist/build/ConfigWarning.js

@@ -14,7 +14,6 @@
   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.
@@ -32,9 +31,6 @@ import formatErrorMessage from '../formatErrorMessage.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
@@ -61,7 +57,6 @@ import formatErrorMessage from '../formatErrorMessage.js';
             });
         }
         // Store all properties for the logger
-        this.name = 'Config Warning';
         this.configKey = configKey ?? null;
         this.checkSlug = checkSlug;
         this.received = received;
@@ -78,7 +73,7 @@ import formatErrorMessage from '../formatErrorMessage.js';
             this.link = null;
             return;
         }
-        // Resolve location based on available info, falling through if a method returns null
+        // Resolve location based on available info
         let location = null;
         const configDir = configDirectory ?? context?.directories?.config;
         if (configKey && context?.keyMap) {
@@ -86,14 +81,12 @@ import formatErrorMessage from '../formatErrorMessage.js';
                 configKey,
                 context
             });
-        }
-        if (!location && operatorLocation && context?.refMap) {
+        } else if (operatorLocation && context?.refMap) {
             location = ConfigMessage.resolveOperatorLocation({
                 operatorLocation,
                 context
             });
-        }
-        if (!location && filePath) {
+        } else if (filePath) {
             location = ConfigMessage.resolveRawLocation({
                 filePath,
                 lineNumber,

package/dist/build/resolveConfigLocation.js

@@ -31,7 +31,7 @@
  *   configDirectory: '/Users/dev/myapp'
  * });
  * // Returns: {
- * //   source: '/Users/dev/myapp/pages/home.yaml:5',
+ * //   source: 'pages/home.yaml:5',
  * //   config: 'root.pages[0:home].blocks[0:header]',
  * //   link: '/Users/dev/myapp/pages/home.yaml:5'
  * // }
@@ -44,18 +44,20 @@
     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;
-    // Use absolute path when configDirectory is available for clickable terminal links
-    let resolvedPath = filePath;
+    // Absolute path for clickable links in VSCode terminal
+    let link = null;
     if (configDirectory) {
-        resolvedPath = path.resolve(configDirectory, filePath);
+        const absolutePath = path.resolve(configDirectory, filePath);
+        link = lineNumber ? `${absolutePath}:${lineNumber}` : absolutePath;
     }
-    const source = lineNumber ? `${resolvedPath}:${lineNumber}` : resolvedPath;
     return {
         source,
         config,
-        link: source
+        link
     };
 }
 export default resolveConfigLocation;

package/dist/client/index.js

@@ -24,8 +24,7 @@
  * 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';
-import UserError from '../UserError.js';
-export { ConfigError, ConfigWarning, LowdefyError, PluginError, ServiceError, UserError };
+export { ConfigError, ConfigWarning, LowdefyError, PluginError, ServiceError };

package/dist/index.js

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

package/package.json

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

package/dist/UserError.js

@@ -1,28 +0,0 @@
-/*
-  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/client/LowdefyError.js

@@ -1,55 +0,0 @@
-/*
-  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/formatErrorMessage.js

@@ -1,31 +0,0 @@
-/*
-  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;