@lowdefy/operators-js 6.0.0 → 6.1.0

package/dist/operators/client/js.js

@@ -18,7 +18,7 @@ function js(operatorContext) {
     const hash = type.isString(params) ? params : params?.fn;
     const args = type.isObject(params) ? params.args : undefined;
     if (!jsMap[hash]) {
-        throw new Error(`_js function not found. The function may not have been built yet. Received hash: ${hash}`);
+        throw new Error(`_js function not found. The function may not have been built yet, or the page is running a client bundle from an older build - reload the page to update. Received hash: ${hash}`);
     }
     try {
         return jsMap[hash]({

package/dist/operators/server/item.js

@@ -13,8 +13,9 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { getFromObject } from '@lowdefy/operators';
-function _item({ location, params, items }) {
+function _item({ arrayIndices, location, params, items }) {
     return getFromObject({
+        arrayIndices,
         location,
         object: items,
         operator: '_item',

package/dist/operators/server/payload.js

@@ -13,8 +13,9 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { getFromObject } from '@lowdefy/operators';
-function _payload({ location, params, payload }) {
+function _payload({ arrayIndices, location, params, payload }) {
     return getFromObject({
+        arrayIndices,
         location,
         object: payload,
         operator: '_payload',

package/dist/operators/server/step.js

@@ -13,8 +13,9 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { getFromObject } from '@lowdefy/operators';
-function _step({ location, params, steps }) {
+function _step({ arrayIndices, location, params, steps }) {
     return getFromObject({
+        arrayIndices,
         location,
         object: steps,
         operator: '_step',

package/dist/operators/shared/error.js

@@ -0,0 +1,37 @@
+/*
+  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 { getFromObject } from '@lowdefy/operators';
+// The same operator on server and client: the routine or event runner puts the error a server
+// `:catch` or a client `catch` list caught into scope. Outside a catch there is no error, and
+// every read resolves to null or its default, the way `_item` does outside a :for.
+function _error({ arrayIndices, error, location, params }) {
+    // The whole error is returned as is, not through getFromObject: its `all` branch copies the
+    // value through the serializer, which revives the Error with an enumerable message, so the
+    // message would then travel in any plugin payload the error is placed in. Returning the Error
+    // itself also keeps the wire policy on it wherever it is sent.
+    if (params === true || type.isObject(params) && params.all === true) {
+        return error ?? null;
+    }
+    return getFromObject({
+        arrayIndices,
+        location,
+        object: error ?? {},
+        operator: '_error',
+        params
+    });
+}
+_error.dynamic = true;
+export default _error;

package/dist/operators/shared/error.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 a field of the caught error, such as message or statusCode.'
+            },
+            {
+                type: 'integer',
+                description: 'Index to access in the caught error.'
+            },
+            {
+                type: 'boolean',
+                enum: [
+                    true
+                ],
+                description: 'Return the whole caught error, or null outside a catch.'
+            },
+            {
+                type: 'object',
+                properties: {
+                    key: {
+                        oneOf: [
+                            {
+                                type: 'string',
+                                description: 'Dot-notation path to a field of the caught error, such as message or statusCode.'
+                            },
+                            {
+                                type: 'integer',
+                                description: 'Index to access in the caught error.'
+                            }
+                        ]
+                    },
+                    default: {
+                        description: 'Default value if key does not exist.'
+                    },
+                    all: {
+                        type: 'boolean',
+                        description: 'Return the whole caught error, or null outside a catch.'
+                    }
+                },
+                additionalProperties: false
+            }
+        ]
+    }
+};

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];

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';

package/dist/operatorsServer.js

@@ -52,6 +52,7 @@ 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 _base64 } from './operators/server/base64.js';
+export { default as _error } from './operators/shared/error.js';
 export { default as _hash } from './operators/server/hash.js';
 export { default as _item } from './operators/server/item.js';
 export { default as _js } from './operators/server/js.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';

package/dist/types.js

@@ -26,6 +26,7 @@
             '_date',
             '_divide',
             '_eq',
+            '_error',
             '_event',
             '_event_log',
             '_function',
@@ -82,6 +83,7 @@
             '_date',
             '_divide',
             '_eq',
+            '_error',
             '_function',
             '_get',
             '_gt',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/operators-js",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -43,14 +43,14 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/errors": "6.0.0",
-    "@lowdefy/helpers": "6.0.0",
-    "@lowdefy/operators": "6.0.0",
+    "@lowdefy/errors": "6.1.0",
+    "@lowdefy/helpers": "6.1.0",
+    "@lowdefy/operators": "6.1.0",
     "intl-messageformat": "11.2.7"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@lowdefy/node-utils": "6.0.0",
+    "@lowdefy/node-utils": "6.1.0",
     "@swc/cli": "0.8.1",
     "@swc/core": "1.15.32",
     "@swc/jest": "0.2.39",