@lowdefy/errors 5.6.0 → 6.1.0

package/dist/AuthenticationError.js

@@ -0,0 +1,28 @@
+/*
+  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.
+*/ // Thrown when a request to a protected endpoint carries no successful
+// authentication - the caller should fix its credentials (401). The server
+// error handlers branch on the name before the structured-log and Sentry
+// pipeline, so probing traffic produces a one-line warning, not error logs.
+let AuthenticationError = class AuthenticationError extends Error {
+    constructor(message = 'Authentication required.', { cause } = {}){
+        super(message, {
+            cause
+        });
+        this.name = 'AuthenticationError';
+        this.isLowdefyError = true;
+    }
+};
+export default AuthenticationError;

package/dist/PluginError.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 readErrorCodes from './readErrorCodes.js';
+/**
  * Base error class for plugin failures (operators, actions, blocks, requests).
  *
  * Plugins throw plain Error objects with simple messages.
@@ -59,6 +60,12 @@
         this.received = received !== undefined ? received : cause?.received;
         this.location = location;
         this.configKey = configKey ?? cause?.configKey ?? null;
+        // Config branches on `code`/`statusCode` of the top-level error, which is
+        // this wrapper, so lift them from the plugin's error. One level only: each
+        // deeper cause is a node of its own and keeps its own codes.
+        const { code, statusCode } = readErrorCodes(cause);
+        if (code !== undefined) this.code = code;
+        if (statusCode !== undefined) this.statusCode = statusCode;
         // Location outputs (set by server-side resolution)
         this.source = null;
         this.config = null;

package/dist/index.js

@@ -47,20 +47,34 @@
  *    - Caught: Caller of the action/resolver; signals "the called routine deliberately failed" as distinct from a system fault
  *    - Format: [User Error] message
  *
+ * 7. AuthenticationError - Unauthenticated request to a protected endpoint
+ *    - Thrown: API/request authorization when no caller resolved
+ *    - Caught: Server error handlers, before structured logging and Sentry (401)
+ *    - Format: [AuthenticationError] message
+ *
  * Location Resolution Utilities:
  *   resolveConfigLocation     - Sync: configKey → {source, config} via keyMap/refMap
  *   resolveErrorLocation      - Sync: unified resolver (configKey or filePath/lineNumber)
  *   loadAndResolveErrorLocation - Async: reads keyMap/refMap files at runtime
  *   shouldSuppressBuildCheck   - Check ~ignoreBuildChecks in parent chain
+ *
+ * Error Field Utilities:
+ *   readErrorCodes            - {code, statusCode} from one error node's own fields
+ *   lowdefyErrorNames         - Set of Lowdefy error class names
+ *   lowdefyErrorTypes         - Lowdefy error class by name, for reviving and reshaping errors
  */ import ActionError from './ActionError.js';
+import AuthenticationError from './AuthenticationError.js';
 import BlockError from './BlockError.js';
 import BuildError from './BuildError.js';
 import ConfigError from './ConfigError.js';
 import ConfigWarning from './ConfigWarning.js';
 import errorToDisplayString from './errorToDisplayString.js';
 import LowdefyInternalError from './LowdefyInternalError.js';
+import lowdefyErrorNames from './lowdefyErrorNames.js';
+import lowdefyErrorTypes from './lowdefyErrorTypes.js';
 import OperatorError from './OperatorError.js';
 import PluginError from './PluginError.js';
+import readErrorCodes from './readErrorCodes.js';
 import RequestError from './RequestError.js';
 import resolveConfigLocation from './resolveConfigLocation.js';
 import loadAndResolveErrorLocation from './loadAndResolveErrorLocation.js';
@@ -68,4 +82,4 @@ import resolveErrorLocation from './resolveErrorLocation.js';
 import ServiceError from './ServiceError.js';
 import shouldSuppressBuildCheck, { VALID_CHECK_SLUGS } from './shouldSuppressBuildCheck.js';
 import UserError from './UserError.js';
-export { ActionError, BlockError, BuildError, ConfigError, ConfigWarning, errorToDisplayString, LowdefyInternalError, OperatorError, PluginError, RequestError, resolveConfigLocation, loadAndResolveErrorLocation, resolveErrorLocation, ServiceError, shouldSuppressBuildCheck, UserError, VALID_CHECK_SLUGS };
+export { ActionError, AuthenticationError, BlockError, BuildError, ConfigError, ConfigWarning, errorToDisplayString, LowdefyInternalError, lowdefyErrorNames, lowdefyErrorTypes, OperatorError, PluginError, readErrorCodes, RequestError, resolveConfigLocation, loadAndResolveErrorLocation, resolveErrorLocation, ServiceError, shouldSuppressBuildCheck, UserError, VALID_CHECK_SLUGS };

package/dist/lowdefyErrorNames.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.
+*/ // Keyed on the class name rather than `isLowdefyError`, because an error rebuilt
+// from a caught value can drop `isLowdefyError` yet must keep its class name.
+const lowdefyErrorNames = new Set([
+    'ActionError',
+    'AuthenticationError',
+    'AuthorizationError',
+    'BlockError',
+    'BuildError',
+    'ConfigError',
+    'ConfigWarning',
+    'LowdefyInternalError',
+    'OperatorError',
+    'PluginError',
+    'RequestError',
+    'ServiceError',
+    'TwoFactorEnrolmentRequiredError',
+    'UserError'
+]);
+export default lowdefyErrorNames;

package/dist/lowdefyErrorTypes.js

@@ -0,0 +1,41 @@
+/*
+  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 ActionError from './ActionError.js';
+import BlockError from './BlockError.js';
+import BuildError from './BuildError.js';
+import ConfigError from './ConfigError.js';
+import ConfigWarning from './ConfigWarning.js';
+import LowdefyInternalError from './LowdefyInternalError.js';
+import OperatorError from './OperatorError.js';
+import PluginError from './PluginError.js';
+import RequestError from './RequestError.js';
+import ServiceError from './ServiceError.js';
+import UserError from './UserError.js';
+// Name to class, for rebuilding an error whose class identity is gone but whose
+// name survived - a serializer round trip, or a caught error being reshaped.
+const lowdefyErrorTypes = {
+    ActionError,
+    BlockError,
+    BuildError,
+    ConfigError,
+    ConfigWarning,
+    LowdefyInternalError,
+    OperatorError,
+    PluginError,
+    RequestError,
+    ServiceError,
+    UserError
+};
+export default lowdefyErrorTypes;

package/dist/readErrorCodes.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.
+*/ // One rule over the conventions libraries already follow, instead of a
+// per-driver table that goes stale: Node system errors, Postgres and Mongo set
+// `code`; axios and most HTTP SDKs set `statusCode`, `status` or
+// `response.status`. Non-number statuses are skipped so config branching on
+// `statusCode` only ever compares against a number.
+function readErrorCodes(node) {
+    if (node === null || typeof node !== 'object') {
+        return {
+            code: undefined,
+            statusCode: undefined
+        };
+    }
+    const statusCode = [
+        node.statusCode,
+        node.status,
+        node.response?.status
+    ].find((value)=>typeof value === 'number');
+    return {
+        code: node.code,
+        statusCode
+    };
+}
+export default readErrorCodes;

package/dist/resolveConfigLocation.js

@@ -34,15 +34,34 @@
  * //   source: '/Users/dev/myapp/pages/home.yaml:5',
  * //   config: 'root.pages[0:home].blocks[0:header]',
  * // }
- */ function resolveConfigLocation({ configKey, keyMap, refMap, configDirectory }) {
+ */ // Not every ref is a file — a module invocation's ref has no path of its own
+// (its content came from the invoking file's vars, and ~l line numbers point
+// into that file). Walk the refMap parent chain to the nearest ref that is a
+// real file; the root ref with no parent is lowdefy.yaml itself.
+function resolveRefPath({ refId, refMap }) {
+    let currentId = refId;
+    const seen = new Set();
+    while(currentId && refMap?.[currentId] && !seen.has(currentId)){
+        seen.add(currentId);
+        const refEntry = refMap[currentId];
+        if (refEntry.path) {
+            return refEntry.path;
+        }
+        currentId = refEntry.parent;
+    }
+    return 'lowdefy.yaml';
+}
+function resolveConfigLocation({ configKey, keyMap, refMap, configDirectory }) {
     if (!configKey || !keyMap || !keyMap[configKey]) {
         return null;
     }
     const keyEntry = keyMap[configKey];
     const refId = keyEntry['~r'];
     const lineNumber = keyEntry['~l'];
-    const refEntry = refMap?.[refId];
-    const filePath = refEntry?.path || 'lowdefy.yaml';
+    const filePath = resolveRefPath({
+        refId,
+        refMap
+    });
     // config: the config path (e.g., "root.pages[0:home].blocks[0:header]")
     const config = keyEntry.key;
     // Use absolute path when configDirectory is available for clickable terminal links

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/errors",
-  "version": "5.6.0",
+  "version": "6.1.0",
   "license": "Apache-2.0",
   "description": "Lowdefy error classes for consistent error handling across build, server, and client",
   "homepage": "https://lowdefy.com",
@@ -35,8 +35,8 @@
   ],
   "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"
   },