@hostwebhook/node 1.6.1 → 1.6.2

package/README.md

@@ -113,7 +113,7 @@ const result = await hw.send(
   { waitForResult: true },
 );
 
-console.log(result.syncStatus);  // 200 = delivered, 422 = validation failed, 502 = failed, 408 = timeout
+console.log(result.syncStatus);  // 200 = delivered, 202 = paused, 422 = validation failed, 500 = failed, 408 = timeout
 console.log(result.steps);       // array of pipeline steps with nodeType, status, durationMs
 console.log(result.response);    // response body from target URL
 ```
@@ -187,7 +187,7 @@ Your endpoint has a **Response Mode** setting (None or Sync) that affects how `s
 |----------|--------------|------------|----------|
 | **Forms / UIs** | None | `onResult` | `send()` returns instantly. Pipeline result arrives in background callback. **UI never blocks.** |
 | **Backend scripts** | None | `waitForResult` | `send()` blocks until pipeline completes via SSE (~120s max). |
-| **API proxy / Stripe** | Sync | *(none)* | `send()` blocks until pipeline completes via HTTP (~120s max). Result is inline in the response. |
+| **API proxy / Stripe** | Sync | *(none)* | `send()` blocks until a Schema Validator or an AI Node in the flow answers (20s at most, 55s with an AI Node; `timeoutMs` is 60s by default, enough for both). A 2xx is the result; a 422, 500 or 408 throws `SendError` with the JSON body in `responseBody`. |
 | **Testing (Postman)** | Sync | *(none)* | Single request, response includes full pipeline result. |
 
 > **Warning: Never use Sync mode for user-facing forms or UIs.** Sync mode holds the HTTP connection open on the server, which blocks `send()` and freezes the UI until the pipeline completes. If the pipeline has approval nodes, merge nodes, or long delays, the SDK will timeout. Use **None** mode with `onResult` instead — the user sees "Sent!" immediately and the pipeline result arrives in the background.
@@ -214,7 +214,7 @@ Your endpoint has a **Response Mode** setting (None or Sync) that affects how `s
 | `signingSecret` | `string` | — | Signs outgoing requests with HMAC-SHA256 |
 | `signature` | `StaticSignature` | — | Static secret signature (alternative to HMAC) |
 | `defaultHeaders` | `Record<string, string>` | — | Headers added to every request |
-| `timeoutMs` | `number` | `10000` | Request timeout in ms |
+| `timeoutMs` | `number` | `60000` | Request timeout in ms (long enough for a Sync webhook) |
 
 ### SendOptions
 

package/dist/index.d.mts

@@ -220,7 +220,7 @@ interface HostWebhookConfig {
     signature?: StaticSignature;
     /** Custom headers to include in every request. */
     defaultHeaders?: Record<string, string>;
-    /** Request timeout in milliseconds. Default: 10000 (10s). */
+    /** Request timeout in milliseconds. Default: 60000 (60s), long enough for a Sync webhook with an AI Node (55s at most). */
     timeoutMs?: number;
 }
 /** A single pipeline execution step received via SSE stream. */
@@ -295,7 +295,13 @@ interface SendResult {
     eventId: string;
     /** Short-lived token for SSE stream auth (returned by ingress, used internally by waitForResult). */
     streamToken?: string;
-    /** Sync/stream: pipeline result status (200=delivered, 422=validation failed, 502=delivery failed, 408=timeout) */
+    /**
+     * Stream (`waitForResult`, `onResult`, `stream()`): pipeline result status —
+     * 200=delivered, 202=paused (approval, merge or a long delay), 422=validation
+     * failed, 500=delivery failed, 408=timeout. A webhook in Sync response mode
+     * answers with the real HTTP status instead: a non-2xx (422, 500, 408) throws
+     * `SendError` with the JSON body in `responseBody`.
+     */
     syncStatus?: number;
     /** Sync/stream: delivery status ('delivered') */
     deliveryStatus?: string;

package/dist/index.d.ts

@@ -220,7 +220,7 @@ interface HostWebhookConfig {
     signature?: StaticSignature;
     /** Custom headers to include in every request. */
     defaultHeaders?: Record<string, string>;
-    /** Request timeout in milliseconds. Default: 10000 (10s). */
+    /** Request timeout in milliseconds. Default: 60000 (60s), long enough for a Sync webhook with an AI Node (55s at most). */
     timeoutMs?: number;
 }
 /** A single pipeline execution step received via SSE stream. */
@@ -295,7 +295,13 @@ interface SendResult {
     eventId: string;
     /** Short-lived token for SSE stream auth (returned by ingress, used internally by waitForResult). */
     streamToken?: string;
-    /** Sync/stream: pipeline result status (200=delivered, 422=validation failed, 502=delivery failed, 408=timeout) */
+    /**
+     * Stream (`waitForResult`, `onResult`, `stream()`): pipeline result status —
+     * 200=delivered, 202=paused (approval, merge or a long delay), 422=validation
+     * failed, 500=delivery failed, 408=timeout. A webhook in Sync response mode
+     * answers with the real HTTP status instead: a non-2xx (422, 500, 408) throws
+     * `SendError` with the JSON body in `responseBody`.
+     */
     syncStatus?: number;
     /** Sync/stream: delivery status ('delivered') */
     deliveryStatus?: string;

package/dist/index.js

@@ -213,7 +213,7 @@ var SendError = class extends Error {
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.hostwebhook.com";
-var DEFAULT_TIMEOUT = 1e4;
+var DEFAULT_TIMEOUT = 6e4;
 var _apiKey, _token, _baseUrl, _signingSecret, _signature, _defaultHeaders, _timeoutMs, _HostWebhook_instances, doSend_fn, waitForStream_fn;
 var HostWebhook = class {
   constructor(config) {
@@ -410,7 +410,7 @@ doSend_fn = async function(token, payload, options) {
   }
   const headers = {
     "Content-Type": options?.contentType ?? "application/json",
-    "User-Agent": `HostWebhook-SDK/${"1.6.1"}`,
+    "User-Agent": `HostWebhook-SDK/${"1.6.2"}`,
     "X-HostWebhook-Sent-At": (/* @__PURE__ */ new Date()).toISOString(),
     ...tz ? { "X-HostWebhook-Timezone": tz } : {},
     ...__privateGet(this, _defaultHeaders),
@@ -457,6 +457,10 @@ doSend_fn = async function(token, payload, options) {
     } catch {
       ingressResult = { eventId: text };
     }
+    if (!ingressResult.eventId) {
+      const deCabecera = res.headers.get("x-hostwebhook-event-id");
+      if (deCabecera) ingressResult = { ...ingressResult, eventId: deCabecera };
+    }
   } catch (err) {
     if (err instanceof SendError) throw err;
     if (err instanceof DOMException && err.name === "AbortError") {

package/dist/index.mjs

@@ -179,7 +179,7 @@ var SendError = class extends Error {
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.hostwebhook.com";
-var DEFAULT_TIMEOUT = 1e4;
+var DEFAULT_TIMEOUT = 6e4;
 var _apiKey, _token, _baseUrl, _signingSecret, _signature, _defaultHeaders, _timeoutMs, _HostWebhook_instances, doSend_fn, waitForStream_fn;
 var HostWebhook = class {
   constructor(config) {
@@ -376,7 +376,7 @@ doSend_fn = async function(token, payload, options) {
   }
   const headers = {
     "Content-Type": options?.contentType ?? "application/json",
-    "User-Agent": `HostWebhook-SDK/${"1.6.1"}`,
+    "User-Agent": `HostWebhook-SDK/${"1.6.2"}`,
     "X-HostWebhook-Sent-At": (/* @__PURE__ */ new Date()).toISOString(),
     ...tz ? { "X-HostWebhook-Timezone": tz } : {},
     ...__privateGet(this, _defaultHeaders),
@@ -423,6 +423,10 @@ doSend_fn = async function(token, payload, options) {
     } catch {
       ingressResult = { eventId: text };
     }
+    if (!ingressResult.eventId) {
+      const deCabecera = res.headers.get("x-hostwebhook-event-id");
+      if (deCabecera) ingressResult = { ...ingressResult, eventId: deCabecera };
+    }
   } catch (err) {
     if (err instanceof SendError) throw err;
     if (err instanceof DOMException && err.name === "AbortError") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "Official HostWebhook SDK — verify signatures, parse headers, and send webhooks",
   "main": "dist/index.js",
   "module": "dist/index.mjs",