@revenexx/integrations-node-sdk 1.2.0 → 1.3.0

package/dist/index.cjs

@@ -54,11 +54,14 @@ __export(index_exports, {
   backoffDelay: () => backoffDelay,
   buildManifest: () => buildManifest,
   clampResponseBytes: () => clampResponseBytes,
+  errorPort: () => errorPort,
+  errorResult: () => errorResult,
   evaluate: () => evaluate,
   extractCredentialManifest: () => extractCredentialManifest,
   extractCredentialManifests: () => extractCredentialManifests,
   extractManifest: () => extractManifest,
   extractManifests: () => extractManifests,
+  httpErrorResult: () => httpErrorResult,
   isBlockedAddress: () => isBlockedAddress,
   isNodeWithIteration: () => isNodeWithIteration,
   isOAuthAuthorizeCredential: () => isOAuthAuthorizeCredential,
@@ -76,6 +79,8 @@ __export(index_exports, {
   sleepWithSignal: () => sleepWithSignal,
   takesValue: () => takesValue,
   timeoutConfigField: () => timeoutConfigField,
+  toErrorOutput: () => toErrorOutput,
+  toErrorResult: () => toErrorResult,
   withRetry: () => withRetry
 });
 module.exports = __toCommonJS(index_exports);
@@ -203,6 +208,76 @@ var NodeError = class extends Error {
   }
 };
 
+// src/nodeErrors.ts
+function toErrorOutput(err) {
+  if (err instanceof NodeError) {
+    const raw = err.meta?.["status"];
+    const status = typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+    return { code: err.code, message: err.message, status };
+  }
+  if (err instanceof Error && err.name === "AbortError") {
+    return { code: "TIMEOUT", message: "Request timed out", status: 0 };
+  }
+  if (err instanceof Error) {
+    return { code: "REQUEST_FAILED", message: err.message, status: 0 };
+  }
+  return { code: "REQUEST_FAILED", message: String(err), status: 0 };
+}
+function errorResult(output, port = "error") {
+  return { outputs: { [port]: output }, branch: port };
+}
+function toErrorResult(err, port = "error") {
+  return errorResult(toErrorOutput(err), port);
+}
+function httpErrorResult(err, port = "error") {
+  const body = err instanceof NodeError ? err.meta?.["body"] ?? null : null;
+  return errorResult({ ...toErrorOutput(err), body }, port);
+}
+function errorPort(opts = {}) {
+  return {
+    name: "error",
+    kind: "error",
+    dataType: "object",
+    label: { en: "Error", de: "Fehler" },
+    description: {
+      en: "Taken when the attempt fails in a way the workflow can carry on from. A node that cannot run as configured fails the run instead of taking this path.",
+      de: "Wird genommen, wenn der Versuch auf eine Weise fehlschl\xE4gt, mit der der Workflow weiterarbeiten kann. Ein Node, der so konfiguriert nicht laufen kann, l\xE4sst den Run scheitern, statt diesen Pfad zu nehmen."
+    },
+    fields: {
+      code: {
+        dataType: "string",
+        description: {
+          en: "Machine-readable name of the failure \u2014 branch on this rather than on the message. A node that talks to a remote system shares `TIMEOUT` and `REQUEST_FAILED` with every other one; the remaining codes belong to this node alone.",
+          de: "Maschinenlesbarer Name des Fehlers \u2014 hierauf verzweigen, nicht auf die Meldung. Ein Node, der mit einem Fremdsystem spricht, teilt `TIMEOUT` und `REQUEST_FAILED` mit allen anderen; die \xFCbrigen Codes geh\xF6ren allein zu diesem Node."
+        }
+      },
+      message: {
+        dataType: "string",
+        description: {
+          en: "Wording for whoever reads the run afterwards, frequently the wording the far end used. It is not a stable value to branch on.",
+          de: "Wortlaut f\xFCr den, der den Run sp\xE4ter liest, h\xE4ufig der des Gegen\xFCbers. Kein stabiler Wert, auf den sich Verzweigungen st\xFCtzen sollten."
+        }
+      },
+      status: {
+        dataType: "number",
+        description: {
+          en: "How the far end answered, as an HTTP status code, where one answered with a status at all. `0` otherwise \u2014 a timeout, a refused connection, an input the node could not use, a node that never leaves the workflow, or a failure the far end reported in its own answer rather than in a status, as a bulk job that ends as failed does. So `0` means there is no status to read, not that nothing was reached.",
+          de: "Wie das Gegen\xFCber geantwortet hat, als HTTP-Statuscode \u2014 sofern eines \xFCberhaupt mit einem Status geantwortet hat. Sonst `0`: Timeout, abgelehnte Verbindung, eine unbrauchbare Eingabe, ein Node, der den Workflow nicht verl\xE4sst, oder ein Fehler, den das Gegen\xFCber in seiner Antwort statt im Status gemeldet hat \u2014 wie ein Bulk-Job, der als fehlgeschlagen endet. `0` hei\xDFt also: kein Status zu lesen, nicht: nichts erreicht."
+        }
+      },
+      ...opts.body ? {
+        body: {
+          dataType: "any",
+          description: {
+            en: "The answer the far end gave, where the failure got far enough to have one: the response body, or the job the platform reported as failed.",
+            de: "Die Antwort des Gegen\xFCbers, sofern der Fehler weit genug kam, um eine zu haben: der Response-Body oder der von der Plattform als fehlgeschlagen gemeldete Job."
+          }
+        }
+      } : {}
+    }
+  };
+}
+
 // src/extract.ts
 function extractManifest(node) {
   return node.description;
@@ -980,11 +1055,14 @@ function base64Url(buf) {
   backoffDelay,
   buildManifest,
   clampResponseBytes,
+  errorPort,
+  errorResult,
   evaluate,
   extractCredentialManifest,
   extractCredentialManifests,
   extractManifest,
   extractManifests,
+  httpErrorResult,
   isBlockedAddress,
   isNodeWithIteration,
   isOAuthAuthorizeCredential,
@@ -1002,5 +1080,7 @@ function base64Url(buf) {
   sleepWithSignal,
   takesValue,
   timeoutConfigField,
+  toErrorOutput,
+  toErrorResult,
   withRetry
 });

package/dist/index.d.cts

@@ -650,6 +650,67 @@ declare class NodeError extends Error {
     constructor(code: string, message: string, meta?: Record<string, unknown>);
 }
 
+/**
+ * Canonical error-output shape emitted on a node's `error` port. It lives here
+ * rather than in a node package because all four of them were building it
+ * separately — `integrations-nodes-core` in an internal module, `deepl` in a
+ * copy of that module, Business Central in `bc-fetch.ts` and Pipedrive in
+ * `pipedrive-client.ts` — so the workflow editor's guarantee of one
+ * `{ code, message, status }` payload rested on four files agreeing by hand
+ * (PO-442; asked for by PO-134 in June and not done then).
+ */
+interface NodeErrorOutput {
+    /** Machine-readable error code, e.g. `HTTP_ERROR`, `TIMEOUT`, `REQUEST_FAILED`. */
+    code: string;
+    message: string;
+    /** HTTP status code, or `0` for timeouts / network / non-HTTP errors. */
+    status: number;
+    /** Optional response body — HTTP-specific. */
+    body?: unknown;
+}
+/**
+ * Normalize any caught value into the canonical {@link NodeErrorOutput} shape.
+ * Use this in a node's `catch` block before routing to the `error` port.
+ */
+declare function toErrorOutput(err: unknown): NodeErrorOutput;
+/** Wrap an error output into an `INodeResult` routed to the `error` port. */
+declare function errorResult(output: NodeErrorOutput, port?: string): INodeResult;
+/**
+ * Catch-block shortcut: normalize any thrown value and route it to the failure
+ * output. The one helper every node's `catch` funnels into, so the
+ * `{ code, message, status }` mapping lives in a single place instead of being
+ * re-implemented per protocol (FTP/SFTP) or per package.
+ *
+ * `port` is the output taken, `error` unless the node declares its failure
+ * output under another name (`{ ...errorPort(), name: 'failed' }`) — pass the
+ * same name here, or the branch names a port that node does not have.
+ */
+declare function toErrorResult(err: unknown, port?: string): INodeResult;
+/**
+ * Catch-block shortcut for the HTTP-style nodes whose failure output additionally
+ * declares `body`: the canonical `{ code, message, status }` mapping plus the
+ * response body a {@link NodeError} carries in `meta.body` (`null` when the
+ * failure never reached a response). `port` names the output as above.
+ */
+declare function httpErrorResult(err: unknown, port?: string): INodeResult;
+/**
+ * Shared `error` output port — the uniform `{ code, message, status }` triple
+ * declared on every node that has an `error` branch. Pass `body: true` for
+ * HTTP-style nodes that additionally emit a response body on the port.
+ *
+ * The sentences travel with the port. The three values mean the same thing
+ * behind every node, so they are written here once instead of per node; a node
+ * whose failures are worth naming more precisely spreads the port and replaces
+ * only its `description` (`{ ...errorPort(), description: … }`).
+ *
+ * The second sentence of the description is the rule this port exists under,
+ * and it is promised in `specs/error-handling.md`: a fault in the author's own
+ * configuration ends the run, a fault met while running is offered here.
+ */
+declare function errorPort(opts?: {
+    body?: boolean;
+}): IOutputPort;
+
 declare function extractManifest(node: INode): INodeDescription;
 declare function extractManifests(nodes: INode[]): INodeDescription[];
 declare function extractCredentialManifest(credential: ICredential): ICredentialDescription;
@@ -1046,4 +1107,4 @@ declare abstract class OAuth2AuthCodeCredential extends BaseCredential implement
     test(_ctx: ICredentialContext, config: Config): Promise<ICredentialTestResult>;
 }
 
-export { ApiKeyCredential, BaseCredential, BasicAuthCredential, type ConfigType, type CredentialAuthKind, type CredentialFieldType, DEFAULT_MAX_RESPONSE_BYTES, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY_MS, DEFAULT_RETRY_POLICY, DEFAULT_TIMEOUT_MS, type DataType, type IConfigField, type IConfigFieldBase, type IConfigOption, type IConfigValidation, type ICredential, type ICredentialContext, type ICredentialDescription, type ICredentialField, type ICredentialOAuthAuthorize, type ICredentialResolveResult, type ICredentialTestResult, type IImage, type IInputPort, type INode, type INodeAuthorContext, type INodeContext, type INodeDescription, type INodeResult, type INodeState, type INodeWithIteration, type IOutputField, type IOutputPort, type IShowIfCondition, type ITemplateDescription, type ITemplateTrigger, type ImageCategory, type LocalizedString, type LookupAddress, type LookupFn, MANIFEST_VERSION, MAX_REDIRECTS, MAX_RESPONSE_BYTES, MAX_RETRY_ATTEMPTS, MAX_TIMEOUT_MS, type NodeCategory, NodeError, type NodeManifest, type NodePackageMeta, OAuth2AuthCodeCredential, OAuth2ClientCredentialsCredential, type OAuthTokenResponse, OPERATORS, type Operator, type OutputKind, type RetryHooks, type RetryPolicy, RetryableError, type SafeFetchOptions, type SafeFetchRetry, SimpleValueCredential, type TemplateLevel, type TemplateTriggerType, VALUELESS_OPERATORS, assertPublicUrl, backoffDelay, buildManifest, clampResponseBytes, evaluate, extractCredentialManifest, extractCredentialManifests, extractManifest, extractManifests, isBlockedAddress, isNodeWithIteration, isOAuthAuthorizeCredential, isOperator, maxBytesConfigField, normalizeCredentialType, normalizeLocalized, parsePackageMeta, readArrayBuffer, readJsonOrText, readText, retryConfigFields, safeFetch, settingApplies, sleepWithSignal, takesValue, timeoutConfigField, withRetry };
+export { ApiKeyCredential, BaseCredential, BasicAuthCredential, type ConfigType, type CredentialAuthKind, type CredentialFieldType, DEFAULT_MAX_RESPONSE_BYTES, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY_MS, DEFAULT_RETRY_POLICY, DEFAULT_TIMEOUT_MS, type DataType, type IConfigField, type IConfigFieldBase, type IConfigOption, type IConfigValidation, type ICredential, type ICredentialContext, type ICredentialDescription, type ICredentialField, type ICredentialOAuthAuthorize, type ICredentialResolveResult, type ICredentialTestResult, type IImage, type IInputPort, type INode, type INodeAuthorContext, type INodeContext, type INodeDescription, type INodeResult, type INodeState, type INodeWithIteration, type IOutputField, type IOutputPort, type IShowIfCondition, type ITemplateDescription, type ITemplateTrigger, type ImageCategory, type LocalizedString, type LookupAddress, type LookupFn, MANIFEST_VERSION, MAX_REDIRECTS, MAX_RESPONSE_BYTES, MAX_RETRY_ATTEMPTS, MAX_TIMEOUT_MS, type NodeCategory, NodeError, type NodeErrorOutput, type NodeManifest, type NodePackageMeta, OAuth2AuthCodeCredential, OAuth2ClientCredentialsCredential, type OAuthTokenResponse, OPERATORS, type Operator, type OutputKind, type RetryHooks, type RetryPolicy, RetryableError, type SafeFetchOptions, type SafeFetchRetry, SimpleValueCredential, type TemplateLevel, type TemplateTriggerType, VALUELESS_OPERATORS, assertPublicUrl, backoffDelay, buildManifest, clampResponseBytes, errorPort, errorResult, evaluate, extractCredentialManifest, extractCredentialManifests, extractManifest, extractManifests, httpErrorResult, isBlockedAddress, isNodeWithIteration, isOAuthAuthorizeCredential, isOperator, maxBytesConfigField, normalizeCredentialType, normalizeLocalized, parsePackageMeta, readArrayBuffer, readJsonOrText, readText, retryConfigFields, safeFetch, settingApplies, sleepWithSignal, takesValue, timeoutConfigField, toErrorOutput, toErrorResult, withRetry };

package/dist/index.d.ts

@@ -650,6 +650,67 @@ declare class NodeError extends Error {
     constructor(code: string, message: string, meta?: Record<string, unknown>);
 }
 
+/**
+ * Canonical error-output shape emitted on a node's `error` port. It lives here
+ * rather than in a node package because all four of them were building it
+ * separately — `integrations-nodes-core` in an internal module, `deepl` in a
+ * copy of that module, Business Central in `bc-fetch.ts` and Pipedrive in
+ * `pipedrive-client.ts` — so the workflow editor's guarantee of one
+ * `{ code, message, status }` payload rested on four files agreeing by hand
+ * (PO-442; asked for by PO-134 in June and not done then).
+ */
+interface NodeErrorOutput {
+    /** Machine-readable error code, e.g. `HTTP_ERROR`, `TIMEOUT`, `REQUEST_FAILED`. */
+    code: string;
+    message: string;
+    /** HTTP status code, or `0` for timeouts / network / non-HTTP errors. */
+    status: number;
+    /** Optional response body — HTTP-specific. */
+    body?: unknown;
+}
+/**
+ * Normalize any caught value into the canonical {@link NodeErrorOutput} shape.
+ * Use this in a node's `catch` block before routing to the `error` port.
+ */
+declare function toErrorOutput(err: unknown): NodeErrorOutput;
+/** Wrap an error output into an `INodeResult` routed to the `error` port. */
+declare function errorResult(output: NodeErrorOutput, port?: string): INodeResult;
+/**
+ * Catch-block shortcut: normalize any thrown value and route it to the failure
+ * output. The one helper every node's `catch` funnels into, so the
+ * `{ code, message, status }` mapping lives in a single place instead of being
+ * re-implemented per protocol (FTP/SFTP) or per package.
+ *
+ * `port` is the output taken, `error` unless the node declares its failure
+ * output under another name (`{ ...errorPort(), name: 'failed' }`) — pass the
+ * same name here, or the branch names a port that node does not have.
+ */
+declare function toErrorResult(err: unknown, port?: string): INodeResult;
+/**
+ * Catch-block shortcut for the HTTP-style nodes whose failure output additionally
+ * declares `body`: the canonical `{ code, message, status }` mapping plus the
+ * response body a {@link NodeError} carries in `meta.body` (`null` when the
+ * failure never reached a response). `port` names the output as above.
+ */
+declare function httpErrorResult(err: unknown, port?: string): INodeResult;
+/**
+ * Shared `error` output port — the uniform `{ code, message, status }` triple
+ * declared on every node that has an `error` branch. Pass `body: true` for
+ * HTTP-style nodes that additionally emit a response body on the port.
+ *
+ * The sentences travel with the port. The three values mean the same thing
+ * behind every node, so they are written here once instead of per node; a node
+ * whose failures are worth naming more precisely spreads the port and replaces
+ * only its `description` (`{ ...errorPort(), description: … }`).
+ *
+ * The second sentence of the description is the rule this port exists under,
+ * and it is promised in `specs/error-handling.md`: a fault in the author's own
+ * configuration ends the run, a fault met while running is offered here.
+ */
+declare function errorPort(opts?: {
+    body?: boolean;
+}): IOutputPort;
+
 declare function extractManifest(node: INode): INodeDescription;
 declare function extractManifests(nodes: INode[]): INodeDescription[];
 declare function extractCredentialManifest(credential: ICredential): ICredentialDescription;
@@ -1046,4 +1107,4 @@ declare abstract class OAuth2AuthCodeCredential extends BaseCredential implement
     test(_ctx: ICredentialContext, config: Config): Promise<ICredentialTestResult>;
 }
 
-export { ApiKeyCredential, BaseCredential, BasicAuthCredential, type ConfigType, type CredentialAuthKind, type CredentialFieldType, DEFAULT_MAX_RESPONSE_BYTES, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY_MS, DEFAULT_RETRY_POLICY, DEFAULT_TIMEOUT_MS, type DataType, type IConfigField, type IConfigFieldBase, type IConfigOption, type IConfigValidation, type ICredential, type ICredentialContext, type ICredentialDescription, type ICredentialField, type ICredentialOAuthAuthorize, type ICredentialResolveResult, type ICredentialTestResult, type IImage, type IInputPort, type INode, type INodeAuthorContext, type INodeContext, type INodeDescription, type INodeResult, type INodeState, type INodeWithIteration, type IOutputField, type IOutputPort, type IShowIfCondition, type ITemplateDescription, type ITemplateTrigger, type ImageCategory, type LocalizedString, type LookupAddress, type LookupFn, MANIFEST_VERSION, MAX_REDIRECTS, MAX_RESPONSE_BYTES, MAX_RETRY_ATTEMPTS, MAX_TIMEOUT_MS, type NodeCategory, NodeError, type NodeManifest, type NodePackageMeta, OAuth2AuthCodeCredential, OAuth2ClientCredentialsCredential, type OAuthTokenResponse, OPERATORS, type Operator, type OutputKind, type RetryHooks, type RetryPolicy, RetryableError, type SafeFetchOptions, type SafeFetchRetry, SimpleValueCredential, type TemplateLevel, type TemplateTriggerType, VALUELESS_OPERATORS, assertPublicUrl, backoffDelay, buildManifest, clampResponseBytes, evaluate, extractCredentialManifest, extractCredentialManifests, extractManifest, extractManifests, isBlockedAddress, isNodeWithIteration, isOAuthAuthorizeCredential, isOperator, maxBytesConfigField, normalizeCredentialType, normalizeLocalized, parsePackageMeta, readArrayBuffer, readJsonOrText, readText, retryConfigFields, safeFetch, settingApplies, sleepWithSignal, takesValue, timeoutConfigField, withRetry };
+export { ApiKeyCredential, BaseCredential, BasicAuthCredential, type ConfigType, type CredentialAuthKind, type CredentialFieldType, DEFAULT_MAX_RESPONSE_BYTES, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY_MS, DEFAULT_RETRY_POLICY, DEFAULT_TIMEOUT_MS, type DataType, type IConfigField, type IConfigFieldBase, type IConfigOption, type IConfigValidation, type ICredential, type ICredentialContext, type ICredentialDescription, type ICredentialField, type ICredentialOAuthAuthorize, type ICredentialResolveResult, type ICredentialTestResult, type IImage, type IInputPort, type INode, type INodeAuthorContext, type INodeContext, type INodeDescription, type INodeResult, type INodeState, type INodeWithIteration, type IOutputField, type IOutputPort, type IShowIfCondition, type ITemplateDescription, type ITemplateTrigger, type ImageCategory, type LocalizedString, type LookupAddress, type LookupFn, MANIFEST_VERSION, MAX_REDIRECTS, MAX_RESPONSE_BYTES, MAX_RETRY_ATTEMPTS, MAX_TIMEOUT_MS, type NodeCategory, NodeError, type NodeErrorOutput, type NodeManifest, type NodePackageMeta, OAuth2AuthCodeCredential, OAuth2ClientCredentialsCredential, type OAuthTokenResponse, OPERATORS, type Operator, type OutputKind, type RetryHooks, type RetryPolicy, RetryableError, type SafeFetchOptions, type SafeFetchRetry, SimpleValueCredential, type TemplateLevel, type TemplateTriggerType, VALUELESS_OPERATORS, assertPublicUrl, backoffDelay, buildManifest, clampResponseBytes, errorPort, errorResult, evaluate, extractCredentialManifest, extractCredentialManifests, extractManifest, extractManifests, httpErrorResult, isBlockedAddress, isNodeWithIteration, isOAuthAuthorizeCredential, isOperator, maxBytesConfigField, normalizeCredentialType, normalizeLocalized, parsePackageMeta, readArrayBuffer, readJsonOrText, readText, retryConfigFields, safeFetch, settingApplies, sleepWithSignal, takesValue, timeoutConfigField, toErrorOutput, toErrorResult, withRetry };

package/dist/index.js

@@ -131,6 +131,76 @@ var NodeError = class extends Error {
   }
 };
 
+// src/nodeErrors.ts
+function toErrorOutput(err) {
+  if (err instanceof NodeError) {
+    const raw = err.meta?.["status"];
+    const status = typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+    return { code: err.code, message: err.message, status };
+  }
+  if (err instanceof Error && err.name === "AbortError") {
+    return { code: "TIMEOUT", message: "Request timed out", status: 0 };
+  }
+  if (err instanceof Error) {
+    return { code: "REQUEST_FAILED", message: err.message, status: 0 };
+  }
+  return { code: "REQUEST_FAILED", message: String(err), status: 0 };
+}
+function errorResult(output, port = "error") {
+  return { outputs: { [port]: output }, branch: port };
+}
+function toErrorResult(err, port = "error") {
+  return errorResult(toErrorOutput(err), port);
+}
+function httpErrorResult(err, port = "error") {
+  const body = err instanceof NodeError ? err.meta?.["body"] ?? null : null;
+  return errorResult({ ...toErrorOutput(err), body }, port);
+}
+function errorPort(opts = {}) {
+  return {
+    name: "error",
+    kind: "error",
+    dataType: "object",
+    label: { en: "Error", de: "Fehler" },
+    description: {
+      en: "Taken when the attempt fails in a way the workflow can carry on from. A node that cannot run as configured fails the run instead of taking this path.",
+      de: "Wird genommen, wenn der Versuch auf eine Weise fehlschl\xE4gt, mit der der Workflow weiterarbeiten kann. Ein Node, der so konfiguriert nicht laufen kann, l\xE4sst den Run scheitern, statt diesen Pfad zu nehmen."
+    },
+    fields: {
+      code: {
+        dataType: "string",
+        description: {
+          en: "Machine-readable name of the failure \u2014 branch on this rather than on the message. A node that talks to a remote system shares `TIMEOUT` and `REQUEST_FAILED` with every other one; the remaining codes belong to this node alone.",
+          de: "Maschinenlesbarer Name des Fehlers \u2014 hierauf verzweigen, nicht auf die Meldung. Ein Node, der mit einem Fremdsystem spricht, teilt `TIMEOUT` und `REQUEST_FAILED` mit allen anderen; die \xFCbrigen Codes geh\xF6ren allein zu diesem Node."
+        }
+      },
+      message: {
+        dataType: "string",
+        description: {
+          en: "Wording for whoever reads the run afterwards, frequently the wording the far end used. It is not a stable value to branch on.",
+          de: "Wortlaut f\xFCr den, der den Run sp\xE4ter liest, h\xE4ufig der des Gegen\xFCbers. Kein stabiler Wert, auf den sich Verzweigungen st\xFCtzen sollten."
+        }
+      },
+      status: {
+        dataType: "number",
+        description: {
+          en: "How the far end answered, as an HTTP status code, where one answered with a status at all. `0` otherwise \u2014 a timeout, a refused connection, an input the node could not use, a node that never leaves the workflow, or a failure the far end reported in its own answer rather than in a status, as a bulk job that ends as failed does. So `0` means there is no status to read, not that nothing was reached.",
+          de: "Wie das Gegen\xFCber geantwortet hat, als HTTP-Statuscode \u2014 sofern eines \xFCberhaupt mit einem Status geantwortet hat. Sonst `0`: Timeout, abgelehnte Verbindung, eine unbrauchbare Eingabe, ein Node, der den Workflow nicht verl\xE4sst, oder ein Fehler, den das Gegen\xFCber in seiner Antwort statt im Status gemeldet hat \u2014 wie ein Bulk-Job, der als fehlgeschlagen endet. `0` hei\xDFt also: kein Status zu lesen, nicht: nichts erreicht."
+        }
+      },
+      ...opts.body ? {
+        body: {
+          dataType: "any",
+          description: {
+            en: "The answer the far end gave, where the failure got far enough to have one: the response body, or the job the platform reported as failed.",
+            de: "Die Antwort des Gegen\xFCbers, sofern der Fehler weit genug kam, um eine zu haben: der Response-Body oder der von der Plattform als fehlgeschlagen gemeldete Job."
+          }
+        }
+      } : {}
+    }
+  };
+}
+
 // src/ssrf.ts
 import { subscribe } from "diagnostics_channel";
 import { isIP } from "net";
@@ -866,11 +936,14 @@ export {
   backoffDelay,
   buildManifest,
   clampResponseBytes,
+  errorPort,
+  errorResult,
   evaluate,
   extractCredentialManifest,
   extractCredentialManifests,
   extractManifest,
   extractManifests,
+  httpErrorResult,
   isBlockedAddress,
   isNodeWithIteration,
   isOAuthAuthorizeCredential,
@@ -888,5 +961,7 @@ export {
   sleepWithSignal,
   takesValue,
   timeoutConfigField,
+  toErrorOutput,
+  toErrorResult,
   withRetry
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revenexx/integrations-node-sdk",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "TypeScript interfaces and utilities for Revenexx integration nodes",
   "license": "MIT",
   "author": "revenexx GmbH",