@lowdefy/node-utils 0.0.0-experimental-20260126225618 → 0.0.0-experimental-20260202133532

package/dist/index.js

@@ -13,14 +13,10 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import cleanDirectory from './cleanDirectory.js';
-import ConfigError from './ConfigError.js';
-import ConfigMessage, { VALID_CHECK_SLUGS } from './ConfigMessage.js';
-import ConfigWarning from './ConfigWarning.js';
 import copyFileOrDirectory from './copyFileOrDirectory.js';
 import getFileExtension, { getFileSubExtension } from './getFileExtension.js';
 import getSecretsFromEnv from './getSecretsFromEnv.js';
-import resolveConfigLocation from './resolveConfigLocation.js';
 import spawnProcess from './spawnProcess.js';
 import readFile from './readFile.js';
 import writeFile from './writeFile.js';
-export { cleanDirectory, ConfigError, ConfigMessage, ConfigWarning, copyFileOrDirectory, getFileExtension, getFileSubExtension, getSecretsFromEnv, resolveConfigLocation, spawnProcess, readFile, VALID_CHECK_SLUGS, writeFile };
+export { cleanDirectory, copyFileOrDirectory, getFileExtension, getFileSubExtension, getSecretsFromEnv, spawnProcess, readFile, writeFile };

package/dist/readFile.js

@@ -19,7 +19,7 @@ import { type } from '@lowdefy/helpers';
 const readFilePromise = promisify(fs.readFile);
 async function readFile(filePath) {
     if (!type.isString(filePath)) {
-        throw new Error(`Could not read file, file path should be a string, received ${JSON.stringify(filePath)}.`);
+        throw new Error('Could not read file, file path should be a string.');
     }
     try {
         // By specifying encoding, readFile returns a string instead of a buffer.

package/dist/writeFile.js

@@ -20,7 +20,7 @@ const mkdirPromise = promisify(fs.mkdir);
 const writeFilePromise = promisify(fs.writeFile);
 async function writeFile(filePath, content) {
     if (!type.isString(filePath)) {
-        throw new Error(`Could not write file, file path should be a string, received ${JSON.stringify(filePath)}.`);
+        throw new Error('Could not write file, file path should be a string.');
     }
     try {
         await writeFilePromise(path.resolve(filePath), content);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/node-utils",
-  "version": "0.0.0-experimental-20260126225618",
+  "version": "0.0.0-experimental-20260202133532",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -34,7 +34,8 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/helpers": "0.0.0-experimental-20260126225618",
+    "@lowdefy/errors": "0.0.0-experimental-20260202133532",
+    "@lowdefy/helpers": "0.0.0-experimental-20260202133532",
     "fs-extra": "11.1.1"
   },
   "devDependencies": {

package/dist/ConfigError.js

@@ -1,80 +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 ConfigMessage from './ConfigMessage.js';
-/**
- * Custom error class for configuration errors.
- *
- * @example
- * // Standard usage with message
- * throw new ConfigError({
- *   message: 'Connection id missing.',
- *   configKey: block['~k'],
- *   context,
- * });
- *
- * @example
- * // YAML parse error - pass error object instead of message
- * throw new ConfigError({
- *   error: yamlParseError,
- *   filePath: 'lowdefy.yaml',
- *   configDirectory,
- * });
- */ let ConfigError = class ConfigError extends Error {
-    /**
-   * Format an error message with [Config Error] prefix.
-   * @param {Object} params - Same as ConfigMessage.format() but without prefix
-   * @returns {string} Formatted error message or empty string if suppressed
-   */ static format(params) {
-        return ConfigMessage.format({
-            ...params,
-            prefix: '[Config Error]'
-        });
-    }
-    /**
-   * Creates a ConfigError instance.
-   * @param {Object} params
-   * @param {string} [params.message] - The error message (or use params.error for YAML errors)
-   * @param {Error} [params.error] - Original error (for YAML parse errors - extracts line number)
-   * @param {string} [params.configKey] - Config key (~k) for keyMap lookup
-   * @param {Object} [params.operatorLocation] - { ref, line } for direct refMap lookup
-   * @param {string} [params.filePath] - Direct file path (for raw mode)
-   * @param {number|string} [params.lineNumber] - Direct line number (for raw mode)
-   * @param {Object} [params.context] - Build context with keyMap, refMap, directories
-   * @param {string} [params.configDirectory] - Config directory (for raw mode without context)
-   */ constructor({ message, error, configKey, operatorLocation, filePath, lineNumber, context, configDirectory, checkSlug }){
-        // Handle YAML parse errors - extract line number from error message
-        let finalMessage = message;
-        let finalLineNumber = lineNumber;
-        if (error instanceof Error) {
-            finalMessage = `Could not parse YAML. ${error.message}`;
-            const lineMatch = error.message.match(/at line (\d+)/);
-            finalLineNumber = lineMatch ? lineMatch[1] : null;
-        }
-        const formattedMessage = ConfigError.format({
-            message: finalMessage,
-            configKey,
-            operatorLocation,
-            filePath,
-            lineNumber: finalLineNumber,
-            context,
-            configDirectory,
-            checkSlug
-        });
-        super(formattedMessage);
-        this.name = 'ConfigError';
-        this.suppressed = formattedMessage === '';
-    }
-};
-export default ConfigError;

package/dist/ConfigMessage.js

@@ -1,157 +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 path from 'path';
-import resolveConfigLocation from './resolveConfigLocation.js';
-/**
- * Valid check slugs for ~ignoreBuildChecks.
- * Keys are the slug names, values are descriptions for error messages.
- * These suppress BUILD-TIME validation only - runtime errors still occur.
- */ export const VALID_CHECK_SLUGS = {
-    'state-refs': 'Undefined _state reference warnings',
-    'payload-refs': 'Undefined _payload reference warnings',
-    'step-refs': 'Undefined _step reference warnings',
-    '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'
-};
-/**
- * Base class for config message formatting.
- * Provides shared utilities for ConfigError and ConfigWarning.
- */ let ConfigMessage = class ConfigMessage {
-    /**
-   * Checks if a message should be suppressed based on ~ignoreBuildChecks.
-   * Walks up the parent chain looking for suppressions that cover this check.
-   * This walk happens ONLY when an error/warning is about to be logged.
-   *
-   * @param {Object} params
-   * @param {string} params.configKey - Config key (~k) of the error location
-   * @param {Object} params.keyMap - The keyMap from build context
-   * @param {string} [params.checkSlug] - The specific check being performed (e.g., 'state-refs')
-   * @returns {boolean} True if message should be suppressed
-   */ static shouldSuppress({ configKey, keyMap, checkSlug }) {
-        if (!configKey || !keyMap) return false;
-        let currentKey = configKey;
-        let depth = 0;
-        const MAX_DEPTH = 100; // Guard against circular parents
-        while(currentKey && depth < MAX_DEPTH){
-            const entry = keyMap[currentKey];
-            if (!entry) break;
-            const ignoredChecks = entry['~ignoreBuildChecks'];
-            if (ignoredChecks === true) {
-                return true;
-            }
-            if (Array.isArray(ignoredChecks) && checkSlug && ignoredChecks.includes(checkSlug)) {
-                return true;
-            }
-            currentKey = entry['~k_parent'];
-            depth++;
-        }
-        return false;
-    }
-    /**
-   * Resolves location directly from operatorLocation (ref + line) without keyMap.
-   * Used during early build stages (buildRefs) when keyMap doesn't exist yet.
-   * @private
-   */ static _resolveOperatorLocation({ operatorLocation, refMap, configDirectory }) {
-        const refEntry = refMap?.[operatorLocation.ref];
-        const filePath = refEntry?.path ?? 'lowdefy.yaml';
-        const lineNumber = operatorLocation.line;
-        const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
-        let link = '';
-        if (configDirectory) {
-            link = path.join(configDirectory, filePath) + (lineNumber ? `:${lineNumber}` : '');
-        }
-        return {
-            source,
-            link
-        };
-    }
-    /**
-   * Resolves location from raw filePath and lineNumber.
-   * Used for YAML parse errors and other cases without config context.
-   * @private
-   */ static _resolveRawLocation({ filePath, lineNumber, configDirectory }) {
-        const source = lineNumber ? `${filePath}:${lineNumber}` : filePath;
-        let link = '';
-        if (configDirectory) {
-            link = path.join(configDirectory, filePath) + (lineNumber ? `:${lineNumber}` : '');
-        }
-        return {
-            source,
-            link
-        };
-    }
-    /**
-   * Core formatting method for config messages.
-   *
-   * Supports three modes:
-   * 1. configKey mode: Uses keyMap to resolve location (standard case after addKeys)
-   * 2. operatorLocation mode: Uses refMap directly (early build stages like buildRefs)
-   * 3. Raw mode: Uses filePath/lineNumber directly (YAML parse errors)
-   *
-   * @param {Object} params
-   * @param {string} params.prefix - Message prefix like '[Config Error]' or '[Config Warning]'
-   * @param {string} params.message - The error/warning message
-   * @param {string} [params.configKey] - Config key (~k) for keyMap lookup
-   * @param {Object} [params.operatorLocation] - { ref, line } for direct refMap lookup
-   * @param {string} [params.filePath] - Direct file path (for raw mode)
-   * @param {number|string} [params.lineNumber] - Direct line number (for raw mode)
-   * @param {Object} [params.context] - Build context with keyMap, refMap, directories
-   * @param {string} [params.configDirectory] - Config directory (for raw mode without context)
-   * @param {string} [params.checkSlug] - The specific check being performed (e.g., 'state-refs')
-   * @returns {string} Formatted message or empty string if suppressed
-   */ static format({ prefix, message, configKey, operatorLocation, filePath, lineNumber, context, configDirectory, checkSlug }) {
-        // Check for ~ignoreBuildChecks suppression
-        if (ConfigMessage.shouldSuppress({
-            configKey,
-            keyMap: context?.keyMap,
-            checkSlug
-        })) {
-            return '';
-        }
-        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 = resolveConfigLocation({
-                configKey,
-                keyMap: context.keyMap,
-                refMap: context.refMap,
-                configDirectory: configDir
-            });
-        } else if (operatorLocation && context?.refMap) {
-            // Mode 2: Use operatorLocation directly with refMap (early build stages)
-            location = ConfigMessage._resolveOperatorLocation({
-                operatorLocation,
-                refMap: context.refMap,
-                configDirectory: configDir
-            });
-        } else if (filePath) {
-            // Mode 3: Use raw filePath/lineNumber (YAML parse errors, etc.)
-            location = ConfigMessage._resolveRawLocation({
-                filePath,
-                lineNumber,
-                configDirectory: configDir
-            });
-        }
-        if (!location) {
-            return `${prefix} ${message}`;
-        }
-        return `${location.source}\n${prefix} ${message}`;
-    }
-};
-export default ConfigMessage;

package/dist/ConfigWarning.js

@@ -1,47 +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 ConfigError from './ConfigError.js';
-import ConfigMessage from './ConfigMessage.js';
-/**
- * Utility class for configuration warnings.
- *
- * @example
- * const formatted = ConfigWarning.format({ message, configKey, context });
- * if (formatted) logger.warn(formatted);
- *
- * @example
- * // Throws ConfigError in prod mode when prodError is true
- * ConfigWarning.format({ message, configKey, context, prodError: true });
- */ let ConfigWarning = class ConfigWarning {
-    /**
-   * Format a warning message with [Config Warning] prefix.
-   * In prod mode with prodError: true, throws ConfigError instead.
-   *
-   * @param {Object} params - Same as ConfigMessage.format() plus prodError
-   * @param {boolean} [params.prodError] - If true, throw ConfigError in prod mode
-   * @returns {string} Formatted warning message or empty string if suppressed
-   * @throws {ConfigError} When prodError is true and context.stage is 'prod'
-   */ static format({ prodError, ...params }) {
-        // In prod, throw error instead of warning if prodError flag is set
-        if (prodError && params.context?.stage === 'prod') {
-            throw new ConfigError(params);
-        }
-        return ConfigMessage.format({
-            ...params,
-            prefix: '[Config Warning]'
-        });
-    }
-};
-export default ConfigWarning;

package/dist/resolveConfigLocation.js

@@ -1,63 +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 path from 'path';
-/**
- * Resolves a config key (~k) to source and config location.
- *
- * @param {Object} params
- * @param {string} params.configKey - The ~k value from the config object
- * @param {Object} params.keyMap - The keyMap from build output
- * @param {Object} params.refMap - The refMap from build output
- * @param {string} [params.configDirectory] - Absolute path to config directory for clickable links
- * @returns {Object|null} Location object with source, config, and link, or null if not resolvable
- *
- * @example
- * const location = resolveConfigLocation({
- *   configKey: 'abc123',
- *   keyMap: { 'abc123': { key: 'root.pages[0:home].blocks[0:header]', '~r': 'ref1', '~l': 5 } },
- *   refMap: { 'ref1': { path: 'pages/home.yaml' } },
- *   configDirectory: '/Users/dev/myapp'
- * });
- * // Returns: {
- * //   source: 'pages/home.yaml:5',
- * //   config: 'root.pages[0:home].blocks[0:header]',
- * //   link: '/Users/dev/myapp/pages/home.yaml:5'
- * // }
- */ function resolveConfigLocation({ configKey, keyMap, refMap, configDirectory }) {
-    if (!configKey || !keyMap || !keyMap[configKey]) {
-        return null;
-    }
-    const keyEntry = keyMap[configKey];
-    const refId = keyEntry['~r'];
-    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;
-    if (configDirectory) {
-        const absolutePath = path.resolve(configDirectory, filePath);
-        link = lineNumber ? `${absolutePath}:${lineNumber}` : absolutePath;
-    }
-    return {
-        source,
-        config,
-        link
-    };
-}
-export default resolveConfigLocation;