@lowdefy/operators-js 4.5.2 → 4.6.0

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

@@ -0,0 +1,21 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        type: 'boolean',
+        description: 'Boolean value to negate.'
+    }
+};

package/dist/operators/shared/number.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.
@@ -143,4 +143,5 @@ function _number({ params, location, methodName }) {
         params
     });
 }
+_number.dynamic = false;
 export default _number;

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

@@ -0,0 +1,20 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        description: 'Number method params. Accepts a single value or array/object with named args depending on method.'
+    }
+};

package/dist/operators/shared/object.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.
@@ -126,4 +126,5 @@ function _object({ params, location, methodName }) {
         params
     });
 }
+_object.dynamic = false;
 export default _object;

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

@@ -0,0 +1,20 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        description: 'Object method params. Accepts array positional args or object with named args depending on method.'
+    }
+};

package/dist/operators/shared/operator.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.
@@ -16,13 +16,13 @@
 function _operator(options) {
     const { operators, params, location } = options;
     if (!type.isString(params.name)) {
-        throw new Error(`Operator Error: _operator.name must be a valid operator name as string. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_operator.name must be a valid operator name as string.`);
     }
     if (params.name === '_operator') {
-        throw new Error(`Operator Error: _operator.name cannot be set to _operator to infinite avoid loop reference. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_operator.name cannot be set to _operator to avoid infinite loop reference.`);
     }
     if (params.name.includes('experimental')) {
-        throw new Error(`Operator Error: Experimental operators cannot be used with _operator. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`Experimental operators cannot be used with _operator.`);
     }
     const [operator, methodName] = params.name.split('.');
     if (Object.prototype.hasOwnProperty.call(operators, operator)) {
@@ -33,6 +33,7 @@ function _operator(options) {
             methodName
         });
     }
-    throw new Error(`Operator Error: _operator - Invalid operator name. Received: ${JSON.stringify(params)} at ${location}.`);
+    throw new Error(`_operator - Invalid operator name.`);
 }
+_operator.dynamic = true;
 export default _operator;

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

@@ -0,0 +1,33 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        type: 'object',
+        required: [
+            'name'
+        ],
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Name of the operator to call (e.g. "_sum", "_string.concat").'
+            },
+            params: {
+                description: 'Params to pass to the operator.'
+            }
+        },
+        additionalProperties: false
+    }
+};

package/dist/operators/shared/or.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,10 +13,11 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
-function _or({ location, params }) {
+function _or({ params }) {
     if (!type.isArray(params)) {
-        throw new Error(`Operator Error: _or takes an array type. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_or takes an array type.`);
     }
     return !!params.reduce((acc, el)=>acc || el, false);
 }
+_or.dynamic = false;
 export default _or;

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

@@ -0,0 +1,21 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        type: 'array',
+        description: 'Array of values. Returns true if any value is truthy.'
+    }
+};

package/dist/operators/shared/product.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,9 +13,9 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
-function _product({ params, location }) {
+function _product({ params }) {
     if (!type.isArray(params)) {
-        throw new Error(`Operator Error: _product takes an array type as input. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_product takes an array type as input.`);
     }
     return params.reduce((accumulator, value)=>{
         if (type.isNumber(value)) {
@@ -24,4 +24,5 @@ function _product({ params, location }) {
         return accumulator;
     }, 1);
 }
+_product.dynamic = false;
 export default _product;

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

@@ -0,0 +1,24 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        type: 'array',
+        items: {
+            type: 'number'
+        },
+        description: 'Array of numbers to multiply.'
+    }
+};

package/dist/operators/shared/random.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.
@@ -30,17 +30,17 @@ function getRandomInt(min, max) {
 function getRandomFloat(min, max) {
     return Math.random() * (Math.ceil(max) - Math.floor(min)) + Math.floor(min);
 }
-function evaluateDefaultNumber({ key, defaultValue, params, location }) {
+function evaluateDefaultNumber({ key, defaultValue, params }) {
     if (type.isUndefined(params[key])) {
         params[key] = defaultValue;
     }
     if (!type.isNumber(params[key])) {
-        throw new Error(`Operator Error: _random.${key} takes an number type. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_random.${key} takes a number type.`);
     }
 }
-function _random({ location, params }) {
+function _random({ params }) {
     if (!type.isString(params) && !type.isObject(params)) {
-        throw new Error(`Operator Error: _random takes an string or object type. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_random takes a string or object type.`);
     }
     if (!type.isObject(params)) {
         params = {
@@ -48,23 +48,21 @@ function _random({ location, params }) {
         };
     }
     if (!typesEnum.includes(params.type)) {
-        throw new Error(`Operator Error: _random type can be either 'string', 'integer' or 'float'. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_random type can be either 'string', 'integer' or 'float'.`);
     }
     if (params.type === 'float') {
         evaluateDefaultNumber({
             key: 'min',
             defaultValue: 0,
-            params,
-            location
+            params
         });
         evaluateDefaultNumber({
             key: 'max',
             defaultValue: params.min + 1,
-            params,
-            location
+            params
         });
         if (params.max < params.min) {
-            throw new Error(`Operator Error: _random.min must be less than _random.max. Received: ${JSON.stringify(params)} at ${location}.`);
+            throw new Error(`_random.min must be less than _random.max.`);
         }
         return getRandomFloat(params.min, params.max);
     }
@@ -72,26 +70,24 @@ function _random({ location, params }) {
         evaluateDefaultNumber({
             key: 'min',
             defaultValue: 0,
-            params,
-            location
+            params
         });
         evaluateDefaultNumber({
             key: 'max',
             defaultValue: params.min + 100,
-            params,
-            location
+            params
         });
         if (params.max < params.min) {
-            throw new Error(`Operator Error: _random.min must be less than _random.max. Received: ${JSON.stringify(params)} at ${location}.`);
+            throw new Error(`_random.min must be less than _random.max.`);
         }
         return getRandomInt(params.min, params.max);
     }
     evaluateDefaultNumber({
         key: 'length',
         defaultValue: 8,
-        params,
-        location
+        params
     });
     return generateRandomString(params.length);
 }
+_random.dynamic = true;
 export default _random;

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

@@ -0,0 +1,60 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        oneOf: [
+            {
+                type: 'string',
+                enum: [
+                    'string',
+                    'integer',
+                    'float'
+                ],
+                description: 'Type of random value to generate.'
+            },
+            {
+                type: 'object',
+                required: [
+                    'type'
+                ],
+                properties: {
+                    type: {
+                        type: 'string',
+                        enum: [
+                            'string',
+                            'integer',
+                            'float'
+                        ],
+                        description: 'Type of random value to generate.'
+                    },
+                    length: {
+                        type: 'number',
+                        description: 'Length of random string (default 8). Only for type "string".'
+                    },
+                    min: {
+                        type: 'number',
+                        description: 'Minimum value (inclusive). Only for type "integer" or "float".'
+                    },
+                    max: {
+                        type: 'number',
+                        description: 'Maximum value (inclusive). Only for type "integer" or "float".'
+                    }
+                },
+                additionalProperties: false
+            }
+        ]
+    }
+};

package/dist/operators/shared/regex.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.
@@ -16,12 +16,12 @@
 function _regex({ location, params, state }) {
     const pattern = type.isObject(params) ? params.pattern : params;
     if (!type.isString(pattern)) {
-        throw new Error(`Operator Error: _regex.pattern must be a string. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_regex.pattern must be a string.`);
     }
     let on = !type.isUndefined(params.on) ? params.on : get(state, location);
     if (!type.isUndefined(params.key)) {
         if (!type.isString(params.key)) {
-            throw new Error(`Operator Error: _regex.key must be a string. Received: ${JSON.stringify(params)} at ${location}.`);
+            throw new Error(`_regex.key must be a string.`);
         }
         on = get(state, params.key);
     }
@@ -29,14 +29,16 @@ function _regex({ location, params, state }) {
         return false;
     }
     if (!type.isString(on)) {
-        throw new Error(`Operator Error: _regex.on must be a string. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_regex.on must be a string.`);
     }
     try {
         const re = new RegExp(pattern, params.flags || 'gm');
         return re.test(on);
     } catch (e) {
-        // log e to LowdefyError
-        throw new Error(`Operator Error: _regex failed to execute RegExp.test. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error('_regex failed to execute RegExp.test.', {
+            cause: e
+        });
     }
 }
+_regex.dynamic = true;
 export default _regex;

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

@@ -0,0 +1,50 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        oneOf: [
+            {
+                type: 'string',
+                description: 'Regex pattern string to test against the current location value.'
+            },
+            {
+                type: 'object',
+                required: [
+                    'pattern'
+                ],
+                properties: {
+                    pattern: {
+                        type: 'string',
+                        description: 'Regex pattern string.'
+                    },
+                    on: {
+                        type: 'string',
+                        description: 'String to test the pattern against.'
+                    },
+                    key: {
+                        type: 'string',
+                        description: 'State key path to get the string to test against.'
+                    },
+                    flags: {
+                        type: 'string',
+                        description: 'Regex flags (default "gm").'
+                    }
+                },
+                additionalProperties: false
+            }
+        ]
+    }
+};

package/dist/operators/shared/state.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.
@@ -22,4 +22,5 @@ function _state({ arrayIndices, location, params, state }) {
         params
     });
 }
+_state.dynamic = true;
 export default _state;

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

@@ -0,0 +1,61 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        oneOf: [
+            {
+                type: 'string',
+                description: 'Dot-notation path to value in state.'
+            },
+            {
+                type: 'integer',
+                description: 'Index to access in state.'
+            },
+            {
+                type: 'boolean',
+                enum: [
+                    true
+                ],
+                description: 'Return all state.'
+            },
+            {
+                type: 'object',
+                properties: {
+                    key: {
+                        oneOf: [
+                            {
+                                type: 'string',
+                                description: 'Dot-notation path to value in state.'
+                            },
+                            {
+                                type: 'integer',
+                                description: 'Index to access in state.'
+                            }
+                        ]
+                    },
+                    default: {
+                        description: 'Default value if key does not exist.'
+                    },
+                    all: {
+                        type: 'boolean',
+                        description: 'Return all state.'
+                    }
+                },
+                additionalProperties: false
+            }
+        ]
+    }
+};

package/dist/operators/shared/string.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.
@@ -289,4 +289,5 @@ function _string({ params, location, methodName }) {
         instanceType: 'string'
     });
 }
+_string.dynamic = false;
 export default _string;

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

@@ -0,0 +1,20 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        description: 'String method params. Accepts array positional args or object with named args depending on method.'
+    }
+};

package/dist/operators/shared/subtract.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,16 +13,17 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { type } from '@lowdefy/helpers';
-function _subtract({ params, location }) {
+function _subtract({ params }) {
     if (!type.isArray(params)) {
-        throw new Error(`Operator Error: _subtract takes an array type as input. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_subtract takes an array type as input.`);
     }
     if (params.length !== 2) {
-        throw new Error(`Operator Error: _subtract takes an array of length 2 as input. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_subtract takes an array of length 2 as input.`);
     }
     if (!type.isNumber(params[0]) || !type.isNumber(params[1])) {
-        throw new Error(`Operator Error: _subtract takes an array of 2 numbers. Received: ${JSON.stringify(params)} at ${location}.`);
+        throw new Error(`_subtract takes an array of 2 numbers.`);
     }
     return params[0] - params[1];
 }
+_subtract.dynamic = false;
 export default _subtract;

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

@@ -0,0 +1,26 @@
+/*
+  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.
+*/ export default {
+    type: 'object',
+    params: {
+        type: 'array',
+        items: {
+            type: 'number'
+        },
+        minItems: 2,
+        maxItems: 2,
+        description: 'Array of two numbers. Returns the first minus the second.'
+    }
+};