@lowdefy/operators-js 6.1.0 → 7.0.0

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

@@ -64,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,11 +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

@@ -66,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

@@ -55,6 +55,7 @@
             '_object',
             '_operator',
             '_or',
+            '_path_params',
             '_product',
             '_random',
             '_regex',
@@ -74,12 +75,14 @@
             '_websocket'
         ],
         server: [
+            '_agent',
             '_and',
             '_app',
             '_args',
             '_array',
             '_base64',
             '_boolean',
+            '_credential',
             '_date',
             '_divide',
             '_eq',
@@ -89,6 +92,7 @@
             '_gt',
             '_gte',
             '_hash',
+            '_hmac',
             '_if',
             '_if_none',
             '_intl',
@@ -106,6 +110,7 @@
             '_object',
             '_operator',
             '_or',
+            '_organization',
             '_payload',
             '_product',
             '_random',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/operators-js",
-  "version": "6.1.0",
+  "version": "7.0.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -31,11 +31,16 @@
     "url": "https://github.com/lowdefy/lowdefy.git"
   },
   "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
   "exports": {
     ".": "./dist/index.js",
     "./operators/build": "./dist/operatorsBuild.js",
     "./operators/client": "./dist/operatorsClient.js",
     "./operators/server": "./dist/operatorsServer.js",
+    "./metas": "./dist/metas.js",
+    "./checks": "./dist/checks.js",
     "./schemas": "./dist/schemas.js",
     "./types": "./dist/types.js"
   },
@@ -43,14 +48,14 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/errors": "6.1.0",
-    "@lowdefy/helpers": "6.1.0",
-    "@lowdefy/operators": "6.1.0",
+    "@lowdefy/errors": "7.0.0",
+    "@lowdefy/helpers": "7.0.0",
+    "@lowdefy/operators": "7.0.0",
     "intl-messageformat": "11.2.7"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@lowdefy/node-utils": "6.1.0",
+    "@lowdefy/node-utils": "7.0.0",
     "@swc/cli": "0.8.1",
     "@swc/core": "1.15.32",
     "@swc/jest": "0.2.39",
@@ -63,6 +68,6 @@
   "scripts": {
     "build": "swc src --out-dir dist --config-file ../../../../.swcrc --cli-config-file ../../../../.swc-cli.json --copy-files",
     "clean": "rm -rf dist",
-    "test": "TZ=UTC node --experimental-vm-modules node_modules/jest/bin/jest.js"
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js"
   }
 }