@lowdefy/operators-js 6.0.0 → 7.0.0

package/dist/operators/shared/function.js

@@ -13,18 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { serializer } from '@lowdefy/helpers';
-function _function({ actions, arrayIndices, event, location, operatorPrefix, params, parser, payload, steps }) {
+// The parser is bound to the calling frame (state, items, payload, event, array indices), so the
+// body only needs its own args and the next operator prefix.
+function _function({ operatorPrefix, params, parser }) {
     return (...args)=>{
         const { output, errors } = parser.parse({
-            actions,
-            arrayIndices,
             args,
-            event,
             input: serializer.copy(params),
-            location,
-            operatorPrefix: `_${operatorPrefix}`,
-            payload,
-            steps
+            operatorPrefix: `_${operatorPrefix}`
         });
         if (errors.length > 0) {
             throw errors[0];
@@ -33,4 +29,8 @@ function _function({ actions, arrayIndices, event, location, operatorPrefix, par
     };
 }
 _function.dynamic = true;
+// What the body reads is only known when it is called, often at render time.
+_function.tracking = {
+    kind: 'untracked'
+};
 export default _function;

package/dist/operators/shared/get.js

@@ -34,4 +34,7 @@ function _get({ arrayIndices, location, params }) {
     });
 }
 _get.dynamic = false;
+_get.tracking = {
+    kind: 'pure'
+};
 export default _get;

package/dist/operators/shared/gt.js

@@ -23,4 +23,7 @@ function _gt({ params }) {
     return params[0] > params[1];
 }
 _gt.dynamic = false;
+_gt.tracking = {
+    kind: 'pure'
+};
 export default _gt;

package/dist/operators/shared/gte.js

@@ -23,4 +23,7 @@ function _gte({ params }) {
     return params[0] >= params[1];
 }
 _gte.dynamic = false;
+_gte.tracking = {
+    kind: 'pure'
+};
 export default _gte;

package/dist/operators/shared/if.check.js

@@ -0,0 +1,25 @@
+/*
+  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 { getOperatorType, type } from '@lowdefy/helpers';
+// _if is not dynamic, so params that are one operator ({ _state: ifParams })
+// are evaluated first and may give a valid object. Array and primitive params
+// are left to the runtime error.
+const ifTest = {
+    id: 'if-test',
+    level: 'error',
+    description: '_if needs its condition under test.',
+    check: ({ params })=>type.isObject(params) && !('test' in params) && getOperatorType(params) === null ? '_if has no test key. Put the condition under test:.' : null
+};
+export default ifTest;

package/dist/operators/shared/if.js

@@ -22,4 +22,7 @@
     throw new Error(`_if takes a boolean type for parameter test.`);
 }
 _if.dynamic = false;
+_if.tracking = {
+    kind: 'pure'
+};
 export default _if;

package/dist/operators/shared/if_none.js

@@ -26,4 +26,7 @@ function _if_none({ params }) {
     return params[0];
 }
 _if_none.dynamic = false;
+_if_none.tracking = {
+    kind: 'pure'
+};
 export default _if_none;

package/dist/operators/shared/intl.js

@@ -12,7 +12,8 @@
   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 { runClass } from '@lowdefy/operators';
+*/ import { type } from '@lowdefy/helpers';
+import { runClass } from '@lowdefy/operators';
 function createFormatter({ IntlClass }) {
     const formatter = (on, options, locale)=>{
         return new IntlClass(locale, options).format(on);
@@ -92,4 +93,16 @@ function intl({ params, location, methodName }) {
     });
 }
 intl.dynamic = true;
+// Intl.DateTimeFormat formats the current time when given no date.
+intl.tracking = ({ methodName, params })=>{
+    if (methodName !== 'dateTimeFormat') {
+        return {
+            kind: 'pure'
+        };
+    }
+    const on = type.isArray(params) ? params[0] : params?.on;
+    return {
+        kind: type.isUndefined(on) ? 'volatile' : 'pure'
+    };
+};
 export default intl;

package/dist/operators/shared/json.js

@@ -59,4 +59,7 @@ function _json({ params, location, methodName }) {
     });
 }
 _json.dynamic = false;
+_json.tracking = {
+    kind: 'pure'
+};
 export default _json;

package/dist/operators/shared/locale.js

@@ -29,4 +29,11 @@ function _locale({ arrayIndices, location, params, i18n }) {
     });
 }
 _locale.dynamic = true;
+// i18n changes reach the engine through the full render-time pass, which evaluates every block.
+_locale.tracking = {
+    kind: 'read',
+    keys: ()=>[
+            'i18n'
+        ]
+};
 export default _locale;

package/dist/operators/shared/log.js

@@ -18,4 +18,8 @@
     return params;
 }
 _log.dynamic = true;
+// Pure for its output. Its console output only happens on the passes that evaluate its block.
+_log.tracking = {
+    kind: 'pure'
+};
 export default _log;

package/dist/operators/shared/lt.js

@@ -23,4 +23,7 @@ function _lt({ params }) {
     return params[0] < params[1];
 }
 _lt.dynamic = false;
+_lt.tracking = {
+    kind: 'pure'
+};
 export default _lt;

package/dist/operators/shared/lte.js

@@ -23,4 +23,7 @@ function _lte({ params }) {
     return params[0] <= params[1];
 }
 _lte.dynamic = false;
+_lte.tracking = {
+    kind: 'pure'
+};
 export default _lte;

package/dist/operators/shared/math.js

@@ -282,5 +282,11 @@ function _math({ params, location, methodName }) {
     });
 }
 _math.dynamic = false;
+_math.tracking = ({ methodName, params })=>{
+    const method = methodName ?? params;
+    return {
+        kind: method === 'random' ? 'volatile' : 'pure'
+    };
+};
 _math.meta = meta;
 export default _math;

package/dist/operators/shared/ne.js

@@ -23,4 +23,7 @@ function _ne({ params }) {
     return params[0] !== params[1];
 }
 _ne.dynamic = false;
+_ne.tracking = {
+    kind: 'pure'
+};
 export default _ne;

package/dist/operators/shared/not.js

@@ -16,4 +16,7 @@
     return !params;
 }
 _not.dynamic = false;
+_not.tracking = {
+    kind: 'pure'
+};
 export default _not;

package/dist/operators/shared/number.js

@@ -145,5 +145,8 @@ function _number({ params, location, methodName }) {
     });
 }
 _number.dynamic = false;
+_number.tracking = {
+    kind: 'pure'
+};
 _number.meta = meta;
 export default _number;

package/dist/operators/shared/object.js

@@ -127,4 +127,7 @@ function _object({ params, location, methodName }) {
     });
 }
 _object.dynamic = false;
+_object.tracking = {
+    kind: 'pure'
+};
 export default _object;

package/dist/operators/shared/operator.js

@@ -18,13 +18,24 @@ function _operator(options) {
     if (!type.isString(params.name)) {
         throw new Error(`_operator.name must be a valid operator name as string.`);
     }
-    if (params.name === '_operator') {
+    const [operator, methodName] = params.name.split('.');
+    if (operator === '_operator') {
         throw new Error(`_operator.name cannot be set to _operator to avoid infinite loop reference.`);
     }
     if (params.name.includes('experimental')) {
         throw new Error(`Experimental operators cannot be used with _operator.`);
     }
-    const [operator, methodName] = params.name.split('.');
+    // A name read at runtime comes with the operators it may call (the build
+    // requires the list and bundles exactly those). A listed operator allows
+    // every method; a listed method allows only itself.
+    if (!type.isNone(params.operators)) {
+        if (!type.isArray(params.operators)) {
+            throw new Error(`_operator.operators must be an array of operator names.`);
+        }
+        if (!params.operators.some((name)=>name === operator || name === params.name)) {
+            throw new Error(`_operator - "${params.name}" is not in _operator.operators.`);
+        }
+    }
     if (Object.prototype.hasOwnProperty.call(operators, operator)) {
         return operators[operator]({
             ...options,
@@ -36,4 +47,8 @@ function _operator(options) {
     throw new Error(`_operator - Invalid operator name.`);
 }
 _operator.dynamic = true;
+// The operator it dispatches to is called through the tracked registry view, so it records itself.
+_operator.tracking = {
+    kind: 'pure'
+};
 export default _operator;

package/dist/operators/shared/operator.schema.js

@@ -26,6 +26,13 @@
             },
             params: {
                 description: 'Params to pass to the operator.'
+            },
+            operators: {
+                type: 'array',
+                items: {
+                    type: 'string'
+                },
+                description: 'The operators the call may evaluate. Required when name is read at runtime; any other name is refused.'
             }
         },
         additionalProperties: false

package/dist/operators/shared/or.js

@@ -20,4 +20,7 @@ function _or({ params }) {
     return !!params.reduce((acc, el)=>acc || el, false);
 }
 _or.dynamic = false;
+_or.tracking = {
+    kind: 'pure'
+};
 export default _or;

package/dist/operators/shared/product.js

@@ -25,4 +25,7 @@ function _product({ params }) {
     }, 1);
 }
 _product.dynamic = false;
+_product.tracking = {
+    kind: 'pure'
+};
 export default _product;

package/dist/operators/shared/random.js

@@ -90,4 +90,7 @@ function _random({ params }) {
     return generateRandomString(params.length);
 }
 _random.dynamic = true;
+_random.tracking = {
+    kind: 'volatile'
+};
 export default _random;

package/dist/operators/shared/regex.js

@@ -59,4 +59,32 @@ function _regex({ location, params, state }) {
     }
 }
 _regex.dynamic = true;
+// With no `on`, _regex reads state at `key`, or at its own location.
+_regex.tracking = ({ location, params })=>{
+    const pattern = type.isObject(params) ? params.pattern : params;
+    if (!type.isString(pattern)) {
+        return {
+            kind: 'pure'
+        };
+    }
+    if (!type.isUndefined(params.key)) {
+        return {
+            kind: 'read',
+            keys: [
+                type.isString(params.key) ? `state:${params.key}` : 'state:*'
+            ]
+        };
+    }
+    if (type.isUndefined(params.on)) {
+        return {
+            kind: 'read',
+            keys: [
+                `state:${location}`
+            ]
+        };
+    }
+    return {
+        kind: 'pure'
+    };
+};
 export default _regex;

package/dist/operators/shared/state.js

@@ -12,7 +12,7 @@
   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 { getFromObject } from '@lowdefy/operators';
+*/ import { getFromObject, getObjectReadKeys } from '@lowdefy/operators';
 function _state({ arrayIndices, location, params, state }) {
     return getFromObject({
         arrayIndices,
@@ -23,4 +23,12 @@ function _state({ arrayIndices, location, params, state }) {
     });
 }
 _state.dynamic = true;
+_state.tracking = {
+    kind: 'read',
+    keys: ({ arrayIndices, params })=>getObjectReadKeys({
+            arrayIndices,
+            namespace: 'state',
+            params
+        })
+};
 export default _state;

package/dist/operators/shared/string.js

@@ -321,4 +321,7 @@ function _string({ params, location, methodName }) {
     });
 }
 _string.dynamic = false;
+_string.tracking = {
+    kind: 'pure'
+};
 export default _string;

package/dist/operators/shared/subtract.js

@@ -26,4 +26,7 @@ function _subtract({ params }) {
     return params[0] - params[1];
 }
 _subtract.dynamic = false;
+_subtract.tracking = {
+    kind: 'pure'
+};
 export default _subtract;

package/dist/operators/shared/sum.js

@@ -25,4 +25,7 @@ function _sum({ params }) {
     }, 0);
 }
 _sum.dynamic = false;
+_sum.tracking = {
+    kind: 'pure'
+};
 export default _sum;

package/dist/operators/shared/switch.js

@@ -28,4 +28,7 @@ function _switch({ params }) {
     return params.default;
 }
 _switch.dynamic = false;
+_switch.tracking = {
+    kind: 'pure'
+};
 export default _switch;

package/dist/operators/shared/t.js

@@ -31,4 +31,11 @@ function _t({ params, i18n }) {
     throw new Error('_t takes a string key or an object { key, values, locale } — received ' + JSON.stringify(params));
 }
 _t.dynamic = true;
+// i18n changes reach the engine through the full render-time pass, which evaluates every block.
+_t.tracking = {
+    kind: 'read',
+    keys: ()=>[
+            'i18n'
+        ]
+};
 export default _t;

package/dist/operators/shared/type.js

@@ -54,6 +54,10 @@ function _type({ location, params, state }) {
             return type.isUndefined(on);
         case 'none':
             return type.isNone(on);
+        // `empty` is what a form author means by "no value" - null, undefined, '' and [];
+        // 0, false and {} are values.
+        case 'empty':
+            return type.isNone(on) || on === '' || type.isArray(on) && on.length === 0;
         case 'primitive':
             return type.isPrimitive(on);
         default:
@@ -61,4 +65,23 @@ function _type({ location, params, state }) {
     }
 }
 _type.dynamic = true;
+// With no `on`, _type reads state at `key`, or at its own location: the engine's required check
+// is a _type on the input's own value.
+_type.tracking = ({ location, params })=>{
+    const typeName = type.isObject(params) ? params.type : params;
+    if (!type.isString(typeName) || Object.prototype.hasOwnProperty.call(params, 'on')) {
+        return {
+            kind: 'pure'
+        };
+    }
+    const key = get(params, 'key', {
+        default: location
+    });
+    return {
+        kind: 'read',
+        keys: [
+            type.isString(key) ? `state:${key}` : 'state:*'
+        ]
+    };
+};
 export default _type;

package/dist/operators/shared/type.schema.js

@@ -29,9 +29,10 @@
                     'null',
                     'undefined',
                     'none',
+                    'empty',
                     'primitive'
                 ],
-                description: 'Type name to test against state value at current location.'
+                description: 'Type name to test against state value at current location. The "empty" test is true for null, undefined, \'\' and [], and false for 0, false and {}.'
             },
             {
                 type: 'object',
@@ -52,6 +53,7 @@
                             'null',
                             'undefined',
                             'none',
+                            'empty',
                             'primitive'
                         ],
                         description: 'Type name to test.'

package/dist/operators/shared/uri.js

@@ -48,4 +48,7 @@ function _uri({ params, location, methodName }) {
     });
 }
 _uri.dynamic = false;
+_uri.tracking = {
+    kind: 'pure'
+};
 export default _uri;

package/dist/operators/shared/user.js

@@ -13,7 +13,7 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
-import { getFromObject } from '@lowdefy/operators';
+import { getFromObject, getObjectReadKeys } from '@lowdefy/operators';
 const roleMethods = [
     'hasRole',
     'hasSomeRoles',
@@ -85,4 +85,22 @@ function _user({ arrayIndices, location, methodName, params, user }) {
     });
 }
 _user.dynamic = true;
+_user.tracking = ({ arrayIndices, methodName, params })=>{
+    if (roleMethods.includes(methodName)) {
+        return {
+            kind: 'read',
+            keys: [
+                'user:roles'
+            ]
+        };
+    }
+    return {
+        kind: 'read',
+        keys: getObjectReadKeys({
+            arrayIndices,
+            namespace: 'user',
+            params
+        })
+    };
+};
 export default _user;

package/dist/operatorsBuild.js

@@ -49,12 +49,15 @@ import _type from './operators/shared/type.js';
 import _uri from './operators/shared/uri.js';
 import _base64 from './operators/server/base64.js';
 import _hash from './operators/server/hash.js';
+import _hmac from './operators/server/hmac.js';
+import _authConfig from './operators/build/authConfig.js';
 import _env from './operators/build/env.js';
 export default {
     _and,
     _app,
     _args,
     _array,
+    _authConfig,
     _base64,
     _boolean,
     _date,
@@ -66,6 +69,7 @@ export default {
     _gt,
     _gte,
     _hash,
+    _hmac,
     _if_none,
     _if,
     _intl,

package/dist/operatorsClient.js

@@ -55,6 +55,7 @@ export { default as _api } from './operators/client/api.js';
 export { default as _index } from './operators/client/_index.js';
 export { default as _actions } from './operators/client/actions.js';
 export { default as _base64 } from './operators/client/base64.js';
+export { default as _error } from './operators/shared/error.js';
 export { default as _event_log } from './operators/client/event_log.js';
 export { default as _event } from './operators/client/event.js';
 export { default as _global } from './operators/client/global.js';
@@ -63,6 +64,7 @@ export { default as _js } from './operators/client/js.js';
 export { default as _location } from './operators/client/location.js';
 export { default as _media } from './operators/client/media.js';
 export { default as _menu } from './operators/client/menu.js';
+export { default as _path_params } from './operators/client/path_params.js';
 export { default as _request_details } from './operators/client/request_details.js';
 export { default as _request } from './operators/client/request.js';
 export { default as _theme } from './operators/client/theme.js';

package/dist/operatorsServer.js

@@ -51,10 +51,15 @@ export { default as _t } from './operators/shared/t.js';
 export { default as _type } from './operators/shared/type.js';
 export { default as _uri } from './operators/shared/uri.js';
 export { default as _user } from './operators/shared/user.js';
+export { default as _agent } from './operators/server/agent.js';
 export { default as _base64 } from './operators/server/base64.js';
+export { default as _credential } from './operators/server/credential.js';
+export { default as _error } from './operators/shared/error.js';
 export { default as _hash } from './operators/server/hash.js';
+export { default as _hmac } from './operators/server/hmac.js';
 export { default as _item } from './operators/server/item.js';
 export { default as _js } from './operators/server/js.js';
+export { default as _organization } from './operators/server/organization.js';
 export { default as _payload } from './operators/server/payload.js';
 export { default as _secret } from './operators/server/secret.js';
 export { default as _step } from './operators/server/step.js';

package/dist/schemas.js

@@ -21,6 +21,7 @@ export { default as _boolean } from './operators/shared/boolean.schema.js';
 export { default as _date } from './operators/shared/date.schema.js';
 export { default as _divide } from './operators/shared/divide.schema.js';
 export { default as _eq } from './operators/shared/eq.schema.js';
+export { default as _error } from './operators/shared/error.schema.js';
 export { default as _function } from './operators/shared/function.schema.js';
 export { default as _get } from './operators/shared/get.schema.js';
 export { default as _gt } from './operators/shared/gt.schema.js';
@@ -65,14 +66,20 @@ export { default as _js } from './operators/client/js.schema.js';
 export { default as _location } from './operators/client/location.schema.js';
 export { default as _media } from './operators/client/media.schema.js';
 export { default as _menu } from './operators/client/menu.schema.js';
+export { default as _path_params } from './operators/client/path_params.schema.js';
 export { default as _request } from './operators/client/request.schema.js';
 export { default as _request_details } from './operators/client/request_details.schema.js';
 export { default as _url_query } from './operators/client/url_query.schema.js';
 // Server operators
+export { default as _agent } from './operators/server/agent.schema.js';
+export { default as _credential } from './operators/server/credential.schema.js';
 export { default as _hash } from './operators/server/hash.schema.js';
+export { default as _hmac } from './operators/server/hmac.schema.js';
 export { default as _item } from './operators/server/item.schema.js';
+export { default as _organization } from './operators/server/organization.schema.js';
 export { default as _payload } from './operators/server/payload.schema.js';
 export { default as _secret } from './operators/server/secret.schema.js';
 export { default as _step } from './operators/server/step.schema.js';
 // Build operators
+export { default as _authConfig } from './operators/build/authConfig.schema.js';
 export { default as _env } from './operators/build/env.schema.js';

package/dist/types.js

@@ -26,6 +26,7 @@
             '_date',
             '_divide',
             '_eq',
+            '_error',
             '_event',
             '_event_log',
             '_function',
@@ -54,6 +55,7 @@
             '_object',
             '_operator',
             '_or',
+            '_path_params',
             '_product',
             '_random',
             '_regex',
@@ -73,20 +75,24 @@
             '_websocket'
         ],
         server: [
+            '_agent',
             '_and',
             '_app',
             '_args',
             '_array',
             '_base64',
             '_boolean',
+            '_credential',
             '_date',
             '_divide',
             '_eq',
+            '_error',
             '_function',
             '_get',
             '_gt',
             '_gte',
             '_hash',
+            '_hmac',
             '_if',
             '_if_none',
             '_intl',
@@ -104,6 +110,7 @@
             '_object',
             '_operator',
             '_or',
+            '_organization',
             '_payload',
             '_product',
             '_random',