@lowdefy/build 4.5.2 → 4.6.0

package/dist/build/addDefaultPages/404.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/build/addDefaultPages/addDefaultPages.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,8 +13,9 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
+import { ConfigError } from '@lowdefy/errors';
 import page404 from './404.js';
-function addDefaultPages({ components }) {
+function addDefaultPages({ components, context }) {
     // If not copied, the same object is mutated by build every time
     // build runs for dev server. See #647
     const defaultPages = [
@@ -24,11 +25,16 @@ function addDefaultPages({ components }) {
         components.pages = [];
     }
     if (!type.isArray(components.pages)) {
-        throw new Error('lowdefy.pages is not an array.');
+        throw new ConfigError('lowdefy.pages is not an array.', {
+            received: components.pages
+        });
     }
     const pageIds = components.pages.map((page, index)=>{
         if (!type.isObject(page)) {
-            throw new Error(`pages[${index}] is not an object. Received ${JSON.stringify(page)}`);
+            throw new ConfigError(`pages[${index}] is not an object.`, {
+                received: page,
+                configKey: page?.['~k']
+            });
         }
         return page.id;
     });

package/dist/build/addKeys.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,13 +13,37 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
+import { ConfigError, VALID_CHECK_SLUGS } from '@lowdefy/errors';
+import collectExceptions from '../utils/collectExceptions.js';
 import makeId from '../utils/makeId.js';
-function recArray({ array, nextKey, key, keyMap, keyMapId }) {
+import setNonEnumerableProperty from '../utils/setNonEnumerableProperty.js';
+function recArray({ array, arrayKey, keyMap, parentKeyMapId, context }) {
+    let arrayKeyMapId;
+    if (array['~k']) {
+        arrayKeyMapId = array['~k'];
+    } else {
+        arrayKeyMapId = makeId.next();
+        const entry = {
+            key: arrayKey,
+            '~k_parent': parentKeyMapId
+        };
+        if (array['~r'] !== undefined) entry['~r'] = array['~r'];
+        if (array['~l'] !== undefined) entry['~l'] = array['~l'];
+        keyMap[arrayKeyMapId] = entry;
+        Object.defineProperty(array, '~k', {
+            value: arrayKeyMapId,
+            enumerable: false,
+            writable: true,
+            configurable: true
+        });
+        delete array['~r'];
+        delete array['~l'];
+    }
     array.forEach((item, index)=>{
         if (type.isObject(item)) {
-            let path = `${key}.${nextKey}[${index}]`;
+            let path = `${arrayKey}[${index}]`;
             // TODO: Convert all artifacts to not modify id.
-            const id = item.blockId ?? item.menuId ?? item.menuItemId ?? item.requestId ?? item.connectionId ?? item.connectionId ?? item.id;
+            const id = item.blockId ?? item.menuId ?? item.menuItemId ?? item.requestId ?? item.connectionId ?? item.id;
             if (id) {
                 path = `${path.slice(0, -1)}:${id}]`;
             }
@@ -30,61 +54,93 @@ function recArray({ array, nextKey, key, keyMap, keyMapId }) {
                 object: item,
                 key: path,
                 keyMap: keyMap,
-                parentKeyMapId: keyMapId
+                parentKeyMapId: arrayKeyMapId,
+                context
             });
         }
         if (type.isArray(item)) {
             recArray({
                 array: item,
-                nextKey,
-                key,
+                arrayKey: `${arrayKey}[${index}]`,
                 keyMap,
-                keyMapId
+                parentKeyMapId: arrayKeyMapId,
+                context
             });
         }
     });
 }
-function recAddKeys({ object, key, keyMap, parentKeyMapId }) {
-    const keyMapId = makeId();
-    keyMap[keyMapId] = {
-        key,
-        '~r': object['~r'],
-        '~k_parent': parentKeyMapId
-    };
-    Object.defineProperty(object, '~k', {
-        value: keyMapId,
-        enumerable: false,
-        writable: true,
-        configurable: true
-    });
-    delete object['~r'];
+function recAddKeys({ object, key, keyMap, parentKeyMapId, context }) {
+    let keyMapId;
+    let storedKey = key;
+    // Skip objects that already have a ~k (already processed)
+    if (object['~k']) {
+        keyMapId = object['~k'];
+        // Use the stored key from keyMap for correct child paths
+        storedKey = keyMap[keyMapId]?.key ?? key;
+    } else {
+        keyMapId = makeId.next();
+        const entry = {
+            key,
+            '~k_parent': parentKeyMapId
+        };
+        if (object['~r'] !== undefined) entry['~r'] = object['~r'];
+        if (object['~l'] !== undefined) entry['~l'] = object['~l'];
+        // Add entry to keyMap BEFORE validation so errors can resolve location
+        keyMap[keyMapId] = entry;
+        // Handle ~ignoreBuildChecks property
+        if (object['~ignoreBuildChecks'] !== undefined) {
+            const checks = object['~ignoreBuildChecks'];
+            if (Array.isArray(checks)) {
+                const validSlugs = Object.keys(VALID_CHECK_SLUGS);
+                const invalid = checks.filter((slug)=>!validSlugs.includes(slug));
+                if (invalid.length > 0) {
+                    collectExceptions(context, new ConfigError(`Invalid check slug(s): "${invalid.join('", "')}". Valid slugs: ${validSlugs.join(', ')}`, {
+                        configKey: keyMapId
+                    }));
+                }
+            } else if (checks !== true) {
+                collectExceptions(context, new ConfigError('~ignoreBuildChecks must be true or an array of check slugs.', {
+                    received: checks,
+                    configKey: keyMapId
+                }));
+            }
+            entry['~ignoreBuildChecks'] = checks;
+        }
+        setNonEnumerableProperty(object, '~k', keyMapId);
+        delete object['~r'];
+        delete object['~l'];
+        delete object['~ignoreBuildChecks'];
+    }
+    // Always recurse into children (they may be new objects without keys)
     Object.keys(object).forEach((nextKey)=>{
         if (type.isObject(object[nextKey])) {
             recAddKeys({
                 object: object[nextKey],
-                key: `${key}.${nextKey}`,
+                key: `${storedKey}.${nextKey}`,
                 keyMap: keyMap,
-                parentKeyMapId: keyMapId
+                parentKeyMapId: keyMapId,
+                context
             });
         }
         if (type.isArray(object[nextKey])) {
             recArray({
                 array: object[nextKey],
-                nextKey,
-                key,
+                arrayKey: `${storedKey}.${nextKey}`,
                 keyMap,
-                keyMapId
+                parentKeyMapId: keyMapId,
+                context
             });
         }
     });
 }
 function addKeys({ components, context }) {
-    const keyMapId = makeId(true);
+    const keyMapId = makeId.next();
     recAddKeys({
         object: components,
         key: 'root',
         keyMap: context.keyMap,
-        parentKeyMapId: keyMapId
+        parentKeyMapId: keyMapId,
+        context
     });
 }
 export default addKeys;

package/dist/build/buildApi/buildApi.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,22 +13,41 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
+import { ConfigError, shouldSuppressBuildCheck } from '@lowdefy/errors';
 import createCheckDuplicateId from '../../utils/createCheckDuplicateId.js';
 import buildEndpoint from './buildEndpoint.js';
 function buildApi({ components, context }) {
     if (components.api && !type.isArray(components.api)) {
-        throw new Error(`Api is not an array. Received ${JSON.stringify(components.api)}.`);
+        throw new ConfigError('Api is not an array.', {
+            received: components.api
+        });
     }
     const api = type.isArray(components.api) ? components.api : [];
     const checkDuplicateEndpointId = createCheckDuplicateId({
         message: 'Duplicate endpointId "{{ id }}".'
     });
-    api.map((endpoint, index)=>buildEndpoint({
-            endpoint,
-            index,
-            context,
-            checkDuplicateEndpointId
-        }));
+    // Wrap each endpoint build to collect errors instead of stopping on first error
+    api.forEach((endpoint, index)=>{
+        try {
+            buildEndpoint({
+                endpoint,
+                index,
+                context,
+                checkDuplicateEndpointId
+            });
+        } catch (error) {
+            // Skip suppressed ConfigErrors (via ~ignoreBuildChecks)
+            if (error instanceof ConfigError && shouldSuppressBuildCheck(error, context.keyMap)) {
+                return;
+            }
+            // Collect error object if context.errors exists, otherwise throw (for backward compat with tests)
+            if (context?.errors) {
+                context.errors.push(error);
+            } else {
+                throw error;
+            }
+        }
+    });
     return components;
 }
 export default buildApi;

package/dist/build/buildApi/buildEndpoint.js

@@ -1,5 +1,5 @@
 /* eslint-disable no-param-reassign */ /*
-  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,6 +14,7 @@
   limitations under the License.
 */ import buildRoutine from './buildRoutine/buildRoutine.js';
 import validateEndpoint from './validateEndpoint.js';
+import validateStepReferences from './validateStepReferences.js';
 function buildEndpoint({ endpoint, index, context, checkDuplicateEndpointId }) {
     validateEndpoint({
         endpoint,
@@ -25,6 +26,11 @@ function buildEndpoint({ endpoint, index, context, checkDuplicateEndpointId }) {
         endpointId: endpoint.endpointId,
         typeCounters: context.typeCounters
     });
+    // Validate that _step references point to defined step IDs
+    validateStepReferences({
+        endpoint,
+        context
+    });
     endpoint.id = `endpoint:${endpoint.endpointId}`;
 }
 export default buildEndpoint;

package/dist/build/buildApi/buildRoutine/buildControl.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/build/buildApi/buildRoutine/buildRoutine.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/build/buildApi/buildRoutine/buildStep.js

@@ -1,5 +1,5 @@
 /* eslint-disable no-param-reassign */ /*
-  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/build/buildApi/buildRoutine/controlTypes.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,6 +13,7 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
+import { ConfigError } from '@lowdefy/errors';
 import buildRoutine from './buildRoutine.js';
 import countControl from './countControl.js';
 import countOperators from '../../../utils/countOperators.js';
@@ -144,23 +145,35 @@ const controlTypes = {
 function getAdditionalKeys(controlType, keys) {
     return keys.filter((item)=>!controlTypes[controlType].required.includes(item));
 }
-function checkMissingRequiredControls({ controlType, keys }, { endpointId }) {
+function checkMissingRequiredControls({ controlType, keys, control }, endpointContext) {
+    const { endpointId } = endpointContext;
     const missingControls = controlTypes[controlType].required.filter((item)=>!keys.includes(item));
     if (missingControls.length > 0) {
-        throw new Error(`Missing required control type(s) for endpoint ${endpointId}. Missing ${JSON.stringify(missingControls)}`);
+        throw new ConfigError(`Missing required control type(s) for endpoint ${endpointId}.`, {
+            received: missingControls,
+            configKey: control?.['~k']
+        });
     }
 }
-function checkInvalidControls({ controlType, keys }, { endpointId }) {
+function checkInvalidControls({ controlType, keys, control }, endpointContext) {
+    const { endpointId } = endpointContext;
     const additionalControls = getAdditionalKeys(controlType, keys);
     const invalidControls = additionalControls.filter((item)=>!controlTypes[controlType].optional.includes(item));
     if (invalidControls.length > 0) {
-        throw new Error(`Invalid control type(s) for endpoint ${endpointId}. Received ${JSON.stringify(invalidControls)}`);
+        throw new ConfigError(`Invalid control type(s) for endpoint ${endpointId}.`, {
+            received: invalidControls,
+            configKey: control?.['~k']
+        });
     }
 }
 function handleSwitch(control, endpointContext) {
+    const { endpointId } = endpointContext;
     const switchArray = control[':switch'];
     if (!type.isArray(control[':switch'])) {
-        throw new Error(`Type given for :switch control is invalid at endpoint ${endpointContext.endpointId}. Received ${JSON.stringify(control[':switch'])}`);
+        throw new ConfigError(`Type given for :switch control is invalid at endpoint ${endpointId}.`, {
+            received: control[':switch'],
+            configKey: control['~k']
+        });
     }
     switchArray.forEach((caseObj)=>{
         const input = {
@@ -168,7 +181,8 @@ function handleSwitch(control, endpointContext) {
             keys: [
                 ':switch',
                 ...Object.keys(caseObj)
-            ]
+            ],
+            control: caseObj
         };
         checkMissingRequiredControls(input, endpointContext);
         checkInvalidControls(input, endpointContext);
@@ -185,13 +199,20 @@ function handleSwitch(control, endpointContext) {
     });
 }
 function validateControl(control, endpointContext) {
+    const { endpointId } = endpointContext;
     const keys = Object.keys(control);
     const intersection = keys.filter((item)=>Object.keys(controlTypes).includes(item));
     if (intersection.length === 0) {
-        throw new Error(`Invalid control type(s) for endpoint ${endpointContext.endpointId}. Received "${JSON.stringify(keys)}"`);
+        throw new ConfigError(`Invalid control type(s) for endpoint ${endpointId}.`, {
+            received: keys,
+            configKey: control['~k']
+        });
     }
     if (intersection.length > 1) {
-        throw new Error(`More than one control type found for endpoint ${endpointContext.endpointId}. Received ${JSON.stringify(intersection)}`);
+        throw new ConfigError(`More than one control type found for endpoint ${endpointId}.`, {
+            received: intersection,
+            configKey: control['~k']
+        });
     }
     const controlType = intersection[0];
     if (controlType === ':switch') {
@@ -200,11 +221,13 @@ function validateControl(control, endpointContext) {
     }
     checkMissingRequiredControls({
         controlType,
-        keys
+        keys,
+        control
     }, endpointContext);
     checkInvalidControls({
         controlType,
-        keys
+        keys,
+        control
     }, endpointContext);
     return controlType;
 }

package/dist/build/buildApi/buildRoutine/countControl.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/build/buildApi/buildRoutine/countStepTypes.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,6 +13,6 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ function countStepTypes(step, { typeCounters }) {
-    typeCounters.requests.increment(step.type);
+    typeCounters.requests.increment(step.type, step['~k']);
 }
 export default countStepTypes;

package/dist/build/buildApi/buildRoutine/setStepId.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/build/buildApi/buildRoutine/validateStep.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,30 +13,51 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
+import { ConfigError } from '@lowdefy/errors';
 function validateStep(step, { endpointId }) {
+    const configKey = step['~k'];
     if (Object.keys(step).length === 0) {
-        throw new Error(`Step is not defined at endpoint "${endpointId}"`);
+        throw new ConfigError(`Step is not defined at endpoint "${endpointId}".`, {
+            configKey
+        });
     }
     if (type.isUndefined(step.id)) {
-        throw new Error(`Step id missing at endpoint "${endpointId}".`);
+        throw new ConfigError(`Step id missing at endpoint "${endpointId}".`, {
+            configKey
+        });
     }
     if (!type.isString(step.id)) {
-        throw new Error(`Step id is not a string at endpoint "${endpointId}". Received ${JSON.stringify(step.id)}.`);
+        throw new ConfigError(`Step id is not a string at endpoint "${endpointId}".`, {
+            received: step.id,
+            configKey
+        });
     }
     if (step.id.includes('.')) {
-        throw new Error(`Step id "${step.id}" at api "${endpointId}" should not include a period (".").`);
+        throw new ConfigError(`Step id "${step.id}" at endpoint "${endpointId}" should not include a period (".").`, {
+            configKey
+        });
     }
     if (type.isNone(step.type)) {
-        throw new Error(`Step type is not defined at "${step.id}" on endpoint "${endpointId}".`);
+        throw new ConfigError(`Step type is not defined at "${step.id}" on endpoint "${endpointId}".`, {
+            configKey
+        });
     }
     if (!type.isString(step.type)) {
-        throw new Error(`Step type is not a string at "${step.id}" on endpoint "${endpointId}". Received ${JSON.stringify(step.type)}.`);
+        throw new ConfigError(`Step type is not a string at "${step.id}" on endpoint "${endpointId}".`, {
+            received: step.type,
+            configKey
+        });
     }
     if (type.isUndefined(step.connectionId)) {
-        throw new Error(`Step connectionId missing at endpoint "${endpointId}".`);
+        throw new ConfigError(`Step connectionId missing at endpoint "${endpointId}".`, {
+            configKey
+        });
     }
     if (!type.isString(step.connectionId)) {
-        throw new Error(`Step connectionId is not a string at endpoint "${endpointId}". Received ${JSON.stringify(step.connectionId)}.`);
+        throw new ConfigError(`Step connectionId is not a string at endpoint "${endpointId}".`, {
+            received: step.connectionId,
+            configKey
+        });
     }
 }
 export default validateStep;

package/dist/build/buildApi/validateEndpoint.js

@@ -1,22 +1,51 @@
-import { type } from '@lowdefy/helpers';
+/*
+  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';
+import { ConfigError } from '@lowdefy/errors';
 function validateEndpoint({ endpoint, index, checkDuplicateEndpointId }) {
+    const configKey = endpoint['~k'];
     if (type.isUndefined(endpoint.id)) {
-        throw new Error(`Endpoint id missing at endpoint ${index}.`);
+        throw new ConfigError(`Endpoint id missing at endpoint ${index}.`, {
+            configKey
+        });
     }
     if (!type.isString(endpoint.id)) {
-        throw new Error(`Endpoint id is not a string at endpoint ${index}. Received ${JSON.stringify(endpoint.id)}.`);
+        throw new ConfigError(`Endpoint id is not a string at endpoint ${index}.`, {
+            received: endpoint.id,
+            configKey
+        });
     }
     if (endpoint.id.includes('.')) {
-        throw new Error(`Endpoint id "${endpoint.id}" at endpoint "${endpoint.id}" should not include a period (".").`);
+        throw new ConfigError(`Endpoint id "${endpoint.id}" should not include a period (".").`, {
+            configKey
+        });
     }
     if (type.isUndefined(endpoint.type)) {
-        throw new Error(`Endpoint type is not defined at "${endpoint.id}" on endpoint "${endpoint.id}".`);
+        throw new ConfigError(`Endpoint type is not defined at "${endpoint.id}".`, {
+            configKey
+        });
     }
     if (!type.isString(endpoint.type)) {
-        throw new Error(`Endpoint type is not a string at "${endpoint.id}" on endpoint "${endpoint.id}". Received ${JSON.stringify(endpoint.type)}.`);
+        throw new ConfigError(`Endpoint type is not a string at "${endpoint.id}".`, {
+            received: endpoint.type,
+            configKey
+        });
     }
     checkDuplicateEndpointId({
-        id: endpoint.id
+        id: endpoint.id,
+        configKey
     });
 }
 export default validateEndpoint;

package/dist/build/buildApi/validateStepReferences.js

@@ -0,0 +1,65 @@
+/*
+  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 { ConfigWarning } from '@lowdefy/errors';
+import { type } from '@lowdefy/helpers';
+import extractOperatorKey from '../../utils/extractOperatorKey.js';
+import traverseConfig from '../../utils/traverseConfig.js';
+// Collect all step IDs from a routine (including nested control structures)
+// Note: After buildRoutine, steps have requestId (original id) and id is modified
+function collectStepIds(routine, stepIds) {
+    if (type.isArray(routine)) {
+        routine.forEach((item)=>collectStepIds(item, stepIds));
+        return;
+    }
+    if (type.isObject(routine)) {
+        // Check if this is a step (has requestId after build, or id before build)
+        if (routine.requestId) {
+            stepIds.add(routine.requestId);
+        }
+        // Recurse into all values (handles control structures like :then, :else, :try, :catch)
+        Object.values(routine).forEach((value)=>collectStepIds(value, stepIds));
+    }
+}
+function validateStepReferences({ endpoint, context }) {
+    // Collect all step IDs defined in the routine
+    const stepIds = new Set();
+    collectStepIds(endpoint.routine, stepIds);
+    // Find _step references in the routine
+    const stepRefs = new Map(); // topLevelKey -> configKey (first occurrence)
+    traverseConfig({
+        config: endpoint.routine,
+        visitor: (obj)=>{
+            if (obj._step !== undefined) {
+                const stepId = extractOperatorKey({
+                    operatorValue: obj._step
+                });
+                if (stepId && !stepRefs.has(stepId)) {
+                    stepRefs.set(stepId, obj['~k']);
+                }
+            }
+        }
+    });
+    // Warn for undefined step references
+    stepRefs.forEach((configKey, stepId)=>{
+        if (stepIds.has(stepId)) return;
+        const message = `_step references "${stepId}" in endpoint "${endpoint.endpointId}", ` + `but no step with id "${stepId}" exists in the routine. ` + `Step IDs are defined by the "id" property of each step. ` + `Check for typos or add a step with this id.`;
+        context.handleWarning(new ConfigWarning(message, {
+            configKey,
+            prodError: true,
+            checkSlug: 'step-refs'
+        }));
+    });
+}
+export default validateStepReferences;

package/dist/build/buildApp.js

@@ -1,5 +1,5 @@
 /* eslint-disable no-param-reassign */ /*
-  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.