@lowdefy/build 4.5.2 → 4.7.0

package/dist/{test → test-utils}/testContext.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -47,12 +47,22 @@ function testContext({ writeBuildArtifact, configDirectory, readConfigFile, logg
         readConfigFile: readConfigFile || (()=>{}),
         refMap: {},
         keyMap: {},
-        jsMap: {}
+        jsMap: {},
+        connectionIds: new Set()
     };
     context.logger = {
         ...defaultLogger,
         ...logger
     };
+    // handleWarning works like a simplified version of the production handleWarning
+    context.handleWarning = (warning)=>{
+        if (warning.prodError && context.stage === 'prod') {
+            throw new Error(warning.message);
+        }
+        context.logger.warn(warning.message);
+    };
+    // handleError delegates to logger.error
+    context.handleError = context.logger.error;
     return context;
 }
 export default testContext;

package/dist/utils/collectExceptions.js

@@ -0,0 +1,34 @@
+/*
+  Copyright 2020-2026 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 { shouldSuppressBuildCheck } from '@lowdefy/errors';
+/**
+ * Collects an exception (ConfigError or ConfigWarning) instead of throwing immediately.
+ * Allows the build to continue and collect all exceptions before stopping.
+ *
+ * @param {Object} context - Build context
+ * @param {ConfigError|ConfigWarning} exception - Exception instance (already created with all properties)
+ */ function collectExceptions(context, exception) {
+    // Skip suppressed exceptions (from ~ignoreBuildChecks)
+    if (shouldSuppressBuildCheck(exception, context.keyMap)) {
+        return;
+    }
+    if (!context.errors) {
+        // If no error collection array, throw immediately (fallback for tests)
+        throw exception;
+    }
+    // Collect exception object - logging happens at checkpoints in index.js
+    context.errors.push(exception);
+}
+export default collectExceptions;

package/dist/utils/countOperators.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -13,18 +13,37 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
-function countOperators(obj, { counter }) {
-    function getOperatorsReviver(_, value) {
-        if (type.isObject(value) && Object.keys(value).length === 1) {
-            const key = Object.keys(value)[0];
-            const [op] = key.split('.');
-            const operator = op.replace(/^(_+)/gm, '_');
-            if (operator.length > 1 && operator[0] === '_') {
-                counter.increment(operator);
-            }
+// Keys that look like operators (single key starting with _) but are not.
+const KNOWN_NON_OPERATORS = new Set([
+    '_id'
+]);
+function walkAndCount(value, counter, parentConfigKey) {
+    if (type.isArray(value)) {
+        value.forEach((item)=>walkAndCount(item, counter, parentConfigKey));
+        return;
+    }
+    if (!type.isObject(value)) {
+        return;
+    }
+    const configKey = value['~k'] || parentConfigKey;
+    const keys = Object.keys(value);
+    // Check if this object is an operator (single key starting with _, ignoring ~ prefixed keys)
+    // This allows ~ignoreBuildCheck to be on the same object as an operator
+    const nonTildeKeys = keys.filter((k)=>!k.startsWith('~'));
+    if (nonTildeKeys.length === 1) {
+        const key = nonTildeKeys[0];
+        const [op] = key.split('.');
+        const operator = op.replace(/^(_+)/gm, '_');
+        if (operator.length > 1 && operator[0] === '_' && !KNOWN_NON_OPERATORS.has(operator)) {
+            counter.increment(operator, configKey);
         }
-        return value;
     }
-    JSON.parse(JSON.stringify(obj), getOperatorsReviver);
+    // Recurse into all values
+    keys.forEach((key)=>{
+        walkAndCount(value[key], counter, configKey);
+    });
+}
+function countOperators(obj, { counter }) {
+    walkAndCount(obj, counter, null);
 }
 export default countOperators;

package/dist/utils/createBuildHandleError.js

@@ -0,0 +1,38 @@
+/*
+  Copyright 2020-2026 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 { resolveErrorLocation } from '@lowdefy/errors';
+function createBuildHandleError({ context }) {
+    return function handleError(error) {
+        try {
+            const location = resolveErrorLocation(error, {
+                keyMap: context.keyMap,
+                refMap: context.refMap,
+                configDirectory: context.directories?.config
+            });
+            if (location) {
+                error.source = location.source;
+                error.config = location.config;
+            }
+            context.logger.error(error);
+        } catch  {
+            try {
+                context.logger.error(error);
+            } catch  {
+                console.error(error);
+            }
+        }
+    };
+}
+export default createBuildHandleError;

package/dist/utils/createCheckDuplicateId.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -13,17 +13,23 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { nunjucksFunction } from '@lowdefy/nunjucks';
+import { ConfigError } from '@lowdefy/errors';
 function createCheckDuplicateId({ message }) {
     const template = nunjucksFunction(message);
     const ids = new Set();
-    function checkDuplicateId({ id, blockId, eventId, menuId, pageId }) {
-        if (ids.has(id.toLowerCase())) throw new Error(template({
-            id,
-            blockId,
-            eventId,
-            menuId,
-            pageId
-        }));
+    function checkDuplicateId({ id, blockId, configKey, eventId, menuId, pageId }) {
+        if (ids.has(id.toLowerCase())) {
+            const errorMessage = template({
+                id,
+                blockId,
+                eventId,
+                menuId,
+                pageId
+            });
+            throw new ConfigError(errorMessage, {
+                configKey
+            });
+        }
         ids.add(id.toLowerCase());
     }
     return checkDuplicateId;

package/dist/utils/createCounter.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -14,9 +14,14 @@
   limitations under the License.
 */ function createCounter() {
     const counts = new Map();
-    function increment(key) {
+    const locations = new Map();
+    function increment(key, configKey) {
         const count = counts.get(key) || 0;
         counts.set(key, count + 1);
+        // Store first occurrence location for error reporting
+        if (configKey && !locations.has(key)) {
+            locations.set(key, configKey);
+        }
     }
     function getCount(key) {
         return counts.get(key) || 0;
@@ -24,10 +29,18 @@
     function getCounts() {
         return Object.fromEntries(counts);
     }
+    function getLocation(key) {
+        return locations.get(key) || null;
+    }
+    function getLocations() {
+        return Object.fromEntries(locations);
+    }
     return {
         increment,
         getCount,
-        getCounts
+        getCounts,
+        getLocation,
+        getLocations
     };
 }
 export default createCounter;

package/dist/utils/createHandleWarning.js

@@ -0,0 +1,41 @@
+/*
+  Copyright 2020-2026 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 { resolveErrorLocation, shouldSuppressBuildCheck } from '@lowdefy/errors';
+import collectExceptions from './collectExceptions.js';
+function createHandleWarning({ context }) {
+    return function handleWarning(warning) {
+        if (shouldSuppressBuildCheck(warning, context.keyMap)) {
+            return;
+        }
+        if (warning.prodError && context.stage === 'prod') {
+            collectExceptions(context, warning);
+            return;
+        }
+        const location = resolveErrorLocation(warning, {
+            keyMap: context.keyMap,
+            refMap: context.refMap,
+            configDirectory: context.directories?.config
+        });
+        if (location) {
+            warning.source = location.source;
+            warning.config = location.config;
+        }
+        const dedupKey = warning.source ?? warning.message;
+        if (context.seenSourceLines?.has(dedupKey)) return;
+        context.seenSourceLines?.add(dedupKey);
+        context.logger.warn(warning);
+    };
+}
+export default createHandleWarning;

package/dist/utils/createPluginTypesMap.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/utils/extractOperatorKey.js

@@ -0,0 +1,36 @@
+/*
+  Copyright 2020-2026 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 { type } from '@lowdefy/helpers';
+/**
+ * Extracts the top-level key from an operator reference value.
+ *
+ * Handles both string and object forms of operator references:
+ * - String: "_state: 'user.name'" -> 'user'
+ * - Object: "_state: { key: 'user.name' }" -> 'user'
+ * - Object: "_state: { path: 'user[0].name' }" -> 'user'
+ *
+ * @param {Object} params
+ * @param {string|Object} params.operatorValue - The value of the operator (e.g., obj._state)
+ * @returns {string|null} The top-level key, or null if not extractable
+ */ function extractOperatorKey({ operatorValue }) {
+    const value = type.isString(operatorValue) ? operatorValue : type.isObject(operatorValue) ? operatorValue.key || operatorValue.path : null;
+    if (!value) {
+        return null;
+    }
+    // Extract first segment before any '.' or '['
+    const topLevelKey = value.split(/[.[]/)[0];
+    return topLevelKey || null;
+}
+export default extractOperatorKey;

package/dist/utils/findConfigKey.js

@@ -0,0 +1,37 @@
+/*
+  Copyright 2020-2026 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 { type } from '@lowdefy/helpers';
+/**
+ * Finds the configKey (~k) for an object at a given instance path.
+ * Navigates through the components following the path and returns
+ * the deepest ~k value found.
+ *
+ * @param {Object} params
+ * @param {Object} params.components - The components object with ~k markers
+ * @param {string[]} params.instancePath - Array of path segments (e.g., ['pages', '0', 'blocks', '0'])
+ * @returns {string|undefined} The configKey (~k) value or undefined if not found
+ */ function findConfigKey({ components, instancePath }) {
+    let current = components;
+    let configKey = components['~k'];
+    for (const part of instancePath){
+        if (type.isNone(current)) break;
+        current = type.isArray(current) ? current[parseInt(part, 10)] : current[part];
+        if (current?.['~k']) {
+            configKey = current['~k'];
+        }
+    }
+    return configKey;
+}
+export default findConfigKey;

package/dist/utils/findSimilarString.js

@@ -0,0 +1,53 @@
+/*
+  Copyright 2020-2026 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 levenshteinDistance(a, b) {
+    const matrix = [];
+    for(let i = 0; i <= b.length; i++){
+        matrix[i] = [
+            i
+        ];
+    }
+    for(let j = 0; j <= a.length; j++){
+        matrix[0][j] = j;
+    }
+    for(let i = 1; i <= b.length; i++){
+        for(let j = 1; j <= a.length; j++){
+            if (b[i - 1] === a[j - 1]) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            } else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+function findSimilarString({ input, candidates, maxDistance = 3 }) {
+    if (!input || !candidates || candidates.length === 0) {
+        return null;
+    }
+    const inputLower = input.toLowerCase();
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    for (const candidate of candidates){
+        const candidateLower = candidate.toLowerCase();
+        const distance = levenshteinDistance(inputLower, candidateLower);
+        if (distance < bestDistance && distance <= maxDistance) {
+            bestDistance = distance;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+export default findSimilarString;

package/dist/utils/logCollectedErrors.js

@@ -0,0 +1,30 @@
+/*
+  Copyright 2020-2026 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 { BuildError, LowdefyInternalError } from '@lowdefy/errors';
+function logCollectedErrors(context) {
+    if (context.errors.length === 0) return;
+    context.errors.forEach((err)=>{
+        if (err.isLowdefyError) {
+            context.handleError(err);
+        } else {
+            const lowdefyErr = new LowdefyInternalError(err.message, {
+                cause: err
+            });
+            context.handleError(lowdefyErr);
+        }
+    });
+    throw new BuildError(`Build failed with ${context.errors.length} error(s). See above for details.`);
+}
+export default logCollectedErrors;

package/dist/utils/makeId.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -12,12 +12,20 @@
   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.
-*/ let id_counter = 0;
-function makeId(reset) {
-    if (reset) {
-        id_counter = 0;
+*/ let MakeId = class MakeId {
+    next() {
+        this.counter++;
+        return this.counter.toString(36);
     }
-    id_counter++;
-    return id_counter.toString(36);
-}
+    reset() {
+        this.counter = 0;
+    }
+    setCounter(value) {
+        this.counter = value;
+    }
+    constructor(){
+        this.counter = 0;
+    }
+};
+const makeId = new MakeId();
 export default makeId;

package/dist/utils/preserveMetaProperties.js

@@ -0,0 +1,27 @@
+/*
+  Copyright 2020-2026 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 setNonEnumerableProperty from './setNonEnumerableProperty.js';
+function preserveMetaProperties(target, source, props = [
+    '~r',
+    '~l',
+    '~k'
+]) {
+    for (const prop of props){
+        if (source[prop] !== undefined) {
+            setNonEnumerableProperty(target, prop, source[prop]);
+        }
+    }
+}
+export default preserveMetaProperties;

package/dist/utils/readConfigFile.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/utils/setNonEnumerableProperty.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 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 setNonEnumerableProperty(obj, prop, value) {
+    Object.defineProperty(obj, prop, {
+        value,
+        enumerable: false,
+        writable: true,
+        configurable: true
+    });
+}
+export default setNonEnumerableProperty;

package/dist/utils/traverseConfig.js

@@ -0,0 +1,43 @@
+/*
+  Copyright 2020-2026 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 { type } from '@lowdefy/helpers';
+/**
+ * Generic depth-first traversal of Lowdefy config objects.
+ * Visits every object and array in the tree, calling the visitor function for each.
+ *
+ * @param {Object} options
+ * @param {any} options.config - The config object to traverse
+ * @param {Function} options.visitor - Called for each object: visitor(obj) => void
+ */ function traverseConfig({ config, visitor }) {
+    if (!type.isObject(config) && !type.isArray(config)) return;
+    if (type.isObject(config)) {
+        visitor(config);
+        for (const value of Object.values(config)){
+            traverseConfig({
+                config: value,
+                visitor
+            });
+        }
+    }
+    if (type.isArray(config)) {
+        for (const item of config){
+            traverseConfig({
+                config: item,
+                visitor
+            });
+        }
+    }
+}
+export default traverseConfig;

package/dist/utils/tryBuildStep.js

@@ -0,0 +1,46 @@
+/*
+  Copyright 2020-2026 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, shouldSuppressBuildCheck } from '@lowdefy/errors';
+/**
+ * Wraps a build step to collect errors instead of stopping immediately.
+ * Errors are collected in context.errors[], allowing the build to continue
+ * and report all errors at once. Errors are logged together at checkpoints
+ * in index.js to ensure proper ordering before the summary message.
+ *
+ * ConfigErrors suppressed via ~ignoreBuildChecks are ignored.
+ *
+ * @param {Function} stepFn - Build step function to execute
+ * @param {string} stepName - Name of the build step (for debugging)
+ * @param {Object} params - Parameters object
+ * @param {Object} params.components - Build components
+ * @param {Object} params.context - Build context with errors array
+ * @returns {*} Result of the build step function
+ */ function tryBuildStep(stepFn, stepName, { components, context }) {
+    try {
+        return stepFn({
+            components,
+            context
+        });
+    } catch (error) {
+        // Skip suppressed ConfigErrors (via ~ignoreBuildChecks)
+        if (error instanceof ConfigError && shouldSuppressBuildCheck(error, context.keyMap)) {
+            return;
+        }
+        // Collect error object - logging happens at checkpoints in index.js
+        // ConfigError instances have source and message properties
+        context.errors.push(error);
+    }
+}
+export default tryBuildStep;

package/dist/utils/writeBuildArtifact.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.