@lowdefy/operators 5.6.0 → 6.1.0

package/dist/evaluateOperators.js

@@ -45,7 +45,14 @@ function hasDynamicMarker(value) {
     if ((type.isArray(value) || type.isObject(value)) && value['~dyn'] === true) return true;
     return hasDynChild(value);
 }
-function evaluateOperators({ input, operators, operatorPrefix = '_', env, dynamicIdentifiers, typeNames, args }) {
+// Build-time prefixes are '_build.' and its escaped forms ('__build.', '___build.', …)
+// produced when _function re-parses its body with `_${operatorPrefix}`. Runtime
+// prefixes ('_', '__', '___', …) never match. Escape depth does not change the
+// evaluation mode: any build prefix means the author asked for build-time evaluation.
+function isBuildPrefix(operatorPrefix) {
+    return /^_+build\.$/.test(operatorPrefix);
+}
+function evaluateOperators({ input, operators, operatorPrefix = '_', env, lowdefyApp, dynamicIdentifiers, typeNames, args }) {
     if (type.isUndefined(input)) {
         return {
             output: input,
@@ -57,6 +64,7 @@ function evaluateOperators({ input, operators, operatorPrefix = '_', env, dynami
     }
     const resolvedDynamicIdentifiers = dynamicIdentifiers ?? new Set();
     const resolvedTypeNames = typeNames ?? new Set();
+    const isBuildTimePrefix = isBuildPrefix(operatorPrefix);
     const errors = [];
     const parser = {
         parse: ({ args: callArgs, input: callInput, operatorPrefix: callPrefix })=>evaluateOperators({
@@ -64,6 +72,7 @@ function evaluateOperators({ input, operators, operatorPrefix = '_', env, dynami
                 operators,
                 operatorPrefix: callPrefix ?? operatorPrefix,
                 env,
+                lowdefyApp,
                 dynamicIdentifiers: resolvedDynamicIdentifiers,
                 typeNames: resolvedTypeNames,
                 args: callArgs
@@ -100,7 +109,7 @@ function evaluateOperators({ input, operators, operatorPrefix = '_', env, dynami
         }
         // Bubble up ~dyn from children (but not at type boundaries).
         // _build.* operators always evaluate even with dynamic params, so skip bubble-up for them.
-        const isBuildOperator = isOperatorObject && operatorPrefix === '_build.';
+        const isBuildOperator = isOperatorObject && isBuildTimePrefix;
         if (!isTypeBoundary && !isBuildOperator && hasDynamicMarker(node)) {
             return setDynamicMarker(node);
         }
@@ -111,17 +120,32 @@ function evaluateOperators({ input, operators, operatorPrefix = '_', env, dynami
         const [op, methodName] = `_${key.substring(operatorPrefix.length)}`.split('.');
         // Dynamic identifier check — skip for _build.* operators
         const fullIdentifier = methodName ? `${op}.${methodName}` : op;
-        if (operatorPrefix !== '_build.') {
+        if (!isBuildTimePrefix) {
             if (resolvedDynamicIdentifiers.has(fullIdentifier) || resolvedDynamicIdentifiers.has(op)) {
                 return setDynamicMarker(node);
             }
         }
-        // Unknown operator — mark as dynamic
+        // Unknown operator. Under a runtime prefix an operator may be runtime-only,
+        // so it is deferred by marking it dynamic. Under a build prefix (at any escape
+        // depth) the author asked for build-time evaluation, so an unknown operator
+        // (typo, or a runtime-only operator misused at build time) is a config error.
         if (type.isUndefined(operators[op])) {
+            if (isBuildTimePrefix) {
+                const error = new ConfigError(`Operator "${key}" is not a valid _build operator.`, {
+                    configKey: node['~k'],
+                    received: {
+                        [key]: node[key]
+                    }
+                });
+                error.lineNumber = node['~l'];
+                error.refId = node['~r'];
+                errors.push(error);
+                return null;
+            }
             return setDynamicMarker(node);
         }
         // Dynamic params check — skip for _build.* operators (they always evaluate)
-        if (operatorPrefix !== '_build.') {
+        if (!isBuildTimePrefix) {
             if (hasDynamicMarker(node[key])) {
                 return setDynamicMarker(node);
             }
@@ -135,6 +159,7 @@ function evaluateOperators({ input, operators, operatorPrefix = '_', env, dynami
                 args,
                 arrayIndices: [],
                 env,
+                lowdefyApp,
                 methodName,
                 operators,
                 params,

package/dist/serverParser.js

@@ -15,7 +15,7 @@
 */ import { ConfigError, OperatorError } from '@lowdefy/errors';
 import { serializer, type } from '@lowdefy/helpers';
 let ServerParser = class ServerParser {
-    parse({ args, input, items, location, operatorPrefix = '_', payload, state, steps }) {
+    parse({ args, arrayIndices = [], error, input, items, location, operatorPrefix = '_', payload, state, steps }) {
         if (type.isUndefined(input)) {
             return {
                 output: input,
@@ -29,6 +29,20 @@ let ServerParser = class ServerParser {
             throw new Error('Operator parser location must be a string.');
         }
         const errors = [];
+        // Operators that evaluate nested config (_function) re-enter the parser. Binding the frame here
+        // means they only pass what they change, so no frame field can be dropped on the way in.
+        const parser = {
+            parse: (callOptions)=>this.parse({
+                    arrayIndices,
+                    error,
+                    items,
+                    location,
+                    payload,
+                    state,
+                    steps,
+                    ...callOptions
+                })
+        };
         const reviver = (_, value)=>{
             if (!type.isObject(value)) return value;
             if (Object.keys(value).length !== 1) return value;
@@ -41,8 +55,9 @@ let ServerParser = class ServerParser {
             try {
                 const res = this.operators[op]({
                     args,
-                    arrayIndices: [],
+                    arrayIndices,
                     env: this.env,
+                    error,
                     i18n: this.i18n,
                     items,
                     jsMap: this.jsMap,
@@ -52,7 +67,7 @@ let ServerParser = class ServerParser {
                     operatorPrefix,
                     operators: this.operators,
                     params,
-                    parser: this,
+                    parser,
                     payload,
                     runtime: 'node',
                     secrets: this.secrets,

package/dist/webParser.js

@@ -15,7 +15,7 @@
 */ import { ConfigError, OperatorError } from '@lowdefy/errors';
 import { applyArrayIndices, serializer, type } from '@lowdefy/helpers';
 let WebParser = class WebParser {
-    parse({ actions, args, arrayIndices, event, input, location, operatorPrefix = '_' }) {
+    parse({ actions, args, arrayIndices, error, event, input, location, operatorPrefix = '_' }) {
         if (type.isUndefined(input)) {
             return {
                 output: input,
@@ -32,6 +32,18 @@ let WebParser = class WebParser {
             throw new Error('Operator parser location must be a string.');
         }
         const errors = [];
+        // Operators that evaluate nested config (_function) re-enter the parser. Binding the frame here
+        // means they only pass what they change, so no frame field can be dropped on the way in.
+        const parser = {
+            parse: (callOptions)=>this.parse({
+                    actions,
+                    arrayIndices,
+                    error,
+                    event,
+                    location,
+                    ...callOptions
+                })
+        };
         const { apiResponses, basePath, home, i18n, inputs, lowdefyApp, lowdefyGlobal, menus, pageId, theme, user, _internal } = this.context._internal.lowdefy;
         const reviver = (_, value)=>{
             if (!type.isObject(value)) return value;
@@ -50,6 +62,7 @@ let WebParser = class WebParser {
                     arrayIndices,
                     apiResponses,
                     basePath,
+                    error,
                     event,
                     eventLog: this.context.eventLog,
                     globals: _internal.globals,
@@ -66,12 +79,13 @@ let WebParser = class WebParser {
                     operators: this.operators,
                     pageId,
                     params,
-                    parser: this,
+                    parser,
                     requests: this.context.requests,
                     runtime: 'browser',
                     state: this.context.state,
                     theme,
-                    user
+                    user,
+                    websockets: this.context.websockets
                 });
                 return res;
             } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/operators",
-  "version": "5.6.0",
+  "version": "6.1.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -34,13 +34,13 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/errors": "5.6.0",
-    "@lowdefy/helpers": "5.6.0"
+    "@lowdefy/errors": "6.1.0",
+    "@lowdefy/helpers": "6.1.0"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@swc/cli": "0.8.0",
-    "@swc/core": "1.15.18",
+    "@swc/cli": "0.8.1",
+    "@swc/core": "1.15.32",
     "@swc/jest": "0.2.39",
     "jest": "28.1.3",
     "jest-environment-jsdom": "28.1.3"