@hostwebhook/node 1.1.1 → 1.2.0

package/dist/index.d.mts

@@ -208,12 +208,33 @@ interface SendOptions {
      */
     rawBody?: string | Buffer;
     /**
-     * Wait for the full pipeline result via SSE streaming.
+     * Wait for the full pipeline result via SSE streaming (blocking).
      * The SDK will POST the payload, then open an SSE stream to receive
      * pipeline steps and the final result. Returns when the pipeline completes.
      * Timeout: ~125s (slightly above the server's 120s SSE timeout).
      */
     waitForResult?: boolean;
+    /**
+     * Non-blocking pipeline result callback. `send()` returns immediately with
+     * the eventId, and the callback fires in the background when the pipeline
+     * completes (via SSE stream). Perfect for UIs that shouldn't block.
+     *
+     * Requires the endpoint to be in `none` response mode (async).
+     *
+     * @example
+     * ```ts
+     * const { eventId } = await hw.send(payload, {
+     *   onResult: (result) => console.log('Pipeline done:', result.syncStatus),
+     * });
+     * // UI shows "Sent!" immediately here
+     * ```
+     */
+    onResult?: (result: SendResult) => void;
+    /**
+     * Called for each pipeline step during SSE streaming.
+     * Only fires when `onResult` or `waitForResult` is used.
+     */
+    onStep?: (step: PipelineStep) => void;
 }
 /** Result returned after a successful send. */
 interface SendResult {

package/dist/index.d.ts

@@ -208,12 +208,33 @@ interface SendOptions {
      */
     rawBody?: string | Buffer;
     /**
-     * Wait for the full pipeline result via SSE streaming.
+     * Wait for the full pipeline result via SSE streaming (blocking).
      * The SDK will POST the payload, then open an SSE stream to receive
      * pipeline steps and the final result. Returns when the pipeline completes.
      * Timeout: ~125s (slightly above the server's 120s SSE timeout).
      */
     waitForResult?: boolean;
+    /**
+     * Non-blocking pipeline result callback. `send()` returns immediately with
+     * the eventId, and the callback fires in the background when the pipeline
+     * completes (via SSE stream). Perfect for UIs that shouldn't block.
+     *
+     * Requires the endpoint to be in `none` response mode (async).
+     *
+     * @example
+     * ```ts
+     * const { eventId } = await hw.send(payload, {
+     *   onResult: (result) => console.log('Pipeline done:', result.syncStatus),
+     * });
+     * // UI shows "Sent!" immediately here
+     * ```
+     */
+    onResult?: (result: SendResult) => void;
+    /**
+     * Called for each pipeline step during SSE streaming.
+     * Only fires when `onResult` or `waitForResult` is used.
+     */
+    onStep?: (step: PipelineStep) => void;
 }
 /** Result returned after a successful send. */
 interface SendResult {

package/dist/index.js

@@ -253,7 +253,7 @@ var HostWebhook = class {
     }
     const headers = {
       "Content-Type": options?.contentType ?? "application/json",
-      "User-Agent": `HostWebhook-SDK/${"1.1.0"}`,
+      "User-Agent": `HostWebhook-SDK/${"1.2.0"}`,
       "X-HostWebhook-Sent-At": (/* @__PURE__ */ new Date()).toISOString(),
       ...tz ? { "X-HostWebhook-Timezone": tz } : {},
       ...__privateGet(this, _defaultHeaders),
@@ -308,9 +308,16 @@ var HostWebhook = class {
     } finally {
       clearTimeout(timer);
     }
-    if (ingressResult.syncStatus !== void 0) return ingressResult;
+    if (ingressResult.syncStatus !== void 0) {
+      if (options?.onResult) options.onResult(ingressResult);
+      return ingressResult;
+    }
     if (options?.waitForResult && ingressResult.streamToken) {
-      return __privateMethod(this, _HostWebhook_instances, waitForStream_fn).call(this, ingressResult);
+      return __privateMethod(this, _HostWebhook_instances, waitForStream_fn).call(this, ingressResult, options?.onStep);
+    }
+    if (options?.onResult && ingressResult.streamToken) {
+      __privateMethod(this, _HostWebhook_instances, waitForStream_fn).call(this, ingressResult, options?.onStep).then((result) => options.onResult(result)).catch(() => {
+      });
     }
     return ingressResult;
   }
@@ -332,7 +339,7 @@ _signature = new WeakMap();
 _defaultHeaders = new WeakMap();
 _timeoutMs = new WeakMap();
 _HostWebhook_instances = new WeakSet();
-waitForStream_fn = async function(ingressResult) {
+waitForStream_fn = async function(ingressResult, onStep) {
   const { eventId, streamToken } = ingressResult;
   const streamUrl = `${__privateGet(this, _baseUrl)}/api/events/${eventId}/stream?token=${streamToken}`;
   const controller = new AbortController();
@@ -364,6 +371,7 @@ waitForStream_fn = async function(ingressResult) {
             const parsed = JSON.parse(data);
             if (currentEvent === "step") {
               steps.push(parsed);
+              if (onStep) onStep(parsed);
             } else if (currentEvent === "done") {
               doneResult = parsed;
             } else if (currentEvent === "timeout") {

package/dist/index.mjs

@@ -220,7 +220,7 @@ var HostWebhook = class {
     }
     const headers = {
       "Content-Type": options?.contentType ?? "application/json",
-      "User-Agent": `HostWebhook-SDK/${"1.1.0"}`,
+      "User-Agent": `HostWebhook-SDK/${"1.2.0"}`,
       "X-HostWebhook-Sent-At": (/* @__PURE__ */ new Date()).toISOString(),
       ...tz ? { "X-HostWebhook-Timezone": tz } : {},
       ...__privateGet(this, _defaultHeaders),
@@ -275,9 +275,16 @@ var HostWebhook = class {
     } finally {
       clearTimeout(timer);
     }
-    if (ingressResult.syncStatus !== void 0) return ingressResult;
+    if (ingressResult.syncStatus !== void 0) {
+      if (options?.onResult) options.onResult(ingressResult);
+      return ingressResult;
+    }
     if (options?.waitForResult && ingressResult.streamToken) {
-      return __privateMethod(this, _HostWebhook_instances, waitForStream_fn).call(this, ingressResult);
+      return __privateMethod(this, _HostWebhook_instances, waitForStream_fn).call(this, ingressResult, options?.onStep);
+    }
+    if (options?.onResult && ingressResult.streamToken) {
+      __privateMethod(this, _HostWebhook_instances, waitForStream_fn).call(this, ingressResult, options?.onStep).then((result) => options.onResult(result)).catch(() => {
+      });
     }
     return ingressResult;
   }
@@ -299,7 +306,7 @@ _signature = new WeakMap();
 _defaultHeaders = new WeakMap();
 _timeoutMs = new WeakMap();
 _HostWebhook_instances = new WeakSet();
-waitForStream_fn = async function(ingressResult) {
+waitForStream_fn = async function(ingressResult, onStep) {
   const { eventId, streamToken } = ingressResult;
   const streamUrl = `${__privateGet(this, _baseUrl)}/api/events/${eventId}/stream?token=${streamToken}`;
   const controller = new AbortController();
@@ -331,6 +338,7 @@ waitForStream_fn = async function(ingressResult) {
             const parsed = JSON.parse(data);
             if (currentEvent === "step") {
               steps.push(parsed);
+              if (onStep) onStep(parsed);
             } else if (currentEvent === "done") {
               doneResult = parsed;
             } else if (currentEvent === "timeout") {

package/package.json

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