@lowdefy/errors 6.2.0 → 6.2.1

package/dist/errorSummaryForLog.js

@@ -0,0 +1,65 @@
+/*
+  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 readErrorCodes from './readErrorCodes.js';
+// What a log may say about an error. Chat text and other inputs can hold personal information,
+// and logs have their own retention and access, so a log carries no prompt, request property,
+// tool input or document. An error carries them where a plain `{ err }` log would write them: a
+// driver's error embeds the document it rejected, an AI SDK TypeValidationError's or
+// JSONParseError's message embeds the value it rejected (the whole conversation, a tool's
+// input), InvalidToolInputError, ToolCallRepairError and RetryError repeat their cause's
+// message, and every stack opens with its message. So an AI SDK error is summarised by name
+// and code alone, except APICallError, whose message is the provider's reply; any other error
+// keeps its name, code, status code and message, cut to 500 characters, and none of its other
+// fields. Causes are followed the same way, three deep.
+const MESSAGE_LIMIT = 500;
+const CAUSE_DEPTH = 3;
+// AISDKError.isInstance reads this marker; the error classes themselves are not imported so
+// any copy of the AI SDK in the app is recognised.
+const aiSdkErrorMarker = Symbol.for('vercel.ai.error');
+function isAiSdkError(error) {
+    return error[aiSdkErrorMarker] === true;
+}
+// An error from another realm, such as a DOMException in a VM context, fails instanceof Error.
+function isError(value) {
+    if (value instanceof Error) return true;
+    return typeof value === 'object' && value !== null && typeof value.stack === 'string' && typeof value.message === 'string';
+}
+function truncate(text) {
+    if (text.length <= MESSAGE_LIMIT) return text;
+    return `${text.slice(0, MESSAGE_LIMIT - 1)}…`;
+}
+function errorSummaryForLog(error, depth = 0) {
+    if (!isError(error)) {
+        return {
+            name: typeof error
+        };
+    }
+    const summary = {
+        name: error.name
+    };
+    if (!isAiSdkError(error) || error.name === 'AI_APICallError') {
+        summary.message = truncate(String(error.message));
+    }
+    const { code, statusCode } = readErrorCodes(error);
+    if (code !== undefined) summary.code = code;
+    if (statusCode !== undefined) summary.statusCode = statusCode;
+    // A RetryError holds the attempt that failed last as lastError rather than as its cause.
+    const cause = error.lastError ?? error.cause;
+    if (cause !== undefined && depth < CAUSE_DEPTH) {
+        summary.cause = errorSummaryForLog(cause, depth + 1);
+    }
+    return summary;
+}
+export default errorSummaryForLog;

package/dist/index.js

@@ -59,6 +59,7 @@
  *   shouldSuppressBuildCheck   - Check ~ignoreBuildChecks in parent chain
  *
  * Error Field Utilities:
+ *   errorSummaryForLog        - {name, message, code, statusCode, cause} an error may log
  *   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
@@ -68,6 +69,7 @@ import BlockError from './BlockError.js';
 import BuildError from './BuildError.js';
 import ConfigError from './ConfigError.js';
 import ConfigWarning from './ConfigWarning.js';
+import errorSummaryForLog from './errorSummaryForLog.js';
 import errorToDisplayString from './errorToDisplayString.js';
 import LowdefyInternalError from './LowdefyInternalError.js';
 import lowdefyErrorNames from './lowdefyErrorNames.js';
@@ -82,4 +84,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, AuthenticationError, BlockError, BuildError, ConfigError, ConfigWarning, errorToDisplayString, LowdefyInternalError, lowdefyErrorNames, lowdefyErrorTypes, OperatorError, PluginError, readErrorCodes, RequestError, resolveConfigLocation, loadAndResolveErrorLocation, resolveErrorLocation, ServiceError, shouldSuppressBuildCheck, UserError, VALID_CHECK_SLUGS };
+export { ActionError, AuthenticationError, BlockError, BuildError, ConfigError, ConfigWarning, errorSummaryForLog, errorToDisplayString, LowdefyInternalError, lowdefyErrorNames, lowdefyErrorTypes, OperatorError, PluginError, readErrorCodes, RequestError, resolveConfigLocation, loadAndResolveErrorLocation, resolveErrorLocation, ServiceError, shouldSuppressBuildCheck, UserError, VALID_CHECK_SLUGS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/errors",
-  "version": "6.2.0",
+  "version": "6.2.1",
   "license": "Apache-2.0",
   "description": "Lowdefy error classes for consistent error handling across build, server, and client",
   "homepage": "https://lowdefy.com",