nvent 1.0.0-alpha.10 → 1.0.0-alpha.11

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "nvent",
-  "version": "1.0.0-alpha.10",
+  "version": "1.0.0-alpha.11",
   "configKey": "nvent",
   "builder": {
     "@nuxt/module-builder": "1.0.2",

package/dist/runtime/app/composables/useIiiStream.d.ts

@@ -1,20 +1,43 @@
 /**
  * useIiiStream — subscribe to an iii stream group via WebSocket.
  *
- * The iii stream module serves WebSocket connections at:
+ * Connects to the iii engine's built-in stream WebSocket endpoint:
  *   ws://host/_iii/stream/{stream_name}/{group_id}/
  *
  * Nitro proxies `/_iii/stream/**` → `ws://iii-engine:3112/`, so connecting
  * to the current page host is sufficient — no hardcoded ports needed.
  *
+ * **Authentication**: The browser WebSocket API does not support custom
+ * headers. The iii engine uses cookie-based auth for WebSocket connections
+ * (same session cookies as the rest of the app), so auth is handled
+ * automatically without any additional configuration.
+ *
+ * **Reconnection**: The composable implements exponential backoff with jitter.
+ * When the connection drops unexpectedly it will retry up to `maxRetries`
+ * times (default: 10) before giving up and setting status to `'error'`.
+ * Calling `subscribe()` again with new arguments or after an intentional
+ * `close()` always resets the retry counter and starts fresh.
+ *
+ * **No unnecessary reconnects**: Calling `subscribe()` with the same
+ * `streamName`/`groupId` while already connected is a no-op.
+ *
+ *
  * ```ts
  * const { messages, status, subscribe, close } = useIiiStream<MyEvent>()
- * subscribe('pipeline', jobId)   // start listening
+ * subscribe('pipeline', jobId)   // start listening; auto-reconnects on drop
  * // messages.value grows as events arrive
  * ```
  */
 export type IiiStreamStatus = 'idle' | 'connecting' | 'connected' | 'closed' | 'error';
-export declare function useIiiStream<TMessage = unknown>(): {
+export interface IiiStreamOptions {
+    /** Maximum number of reconnect attempts before giving up. Default: 10. */
+    maxRetries?: number;
+    /** Base delay in ms for the first reconnect attempt. Default: 500. */
+    baseDelayMs?: number;
+    /** Maximum delay in ms between reconnect attempts. Default: 30_000. */
+    maxDelayMs?: number;
+}
+export declare function useIiiStream<TMessage = unknown>(options?: IiiStreamOptions): {
     messages: import("vue").Ref<import("@vue/reactivity").UnwrapRefSimple<TMessage>[], TMessage[] | import("@vue/reactivity").UnwrapRefSimple<TMessage>[]>;
     status: import("vue").Ref<IiiStreamStatus, IiiStreamStatus>;
     subscribe: (streamName: string, groupId: string) => void;

package/dist/runtime/app/composables/useIiiStream.js

@@ -1,19 +1,39 @@
 import { ref, onUnmounted } from "vue";
-export function useIiiStream() {
+export function useIiiStream(options = {}) {
+  const {
+    maxRetries = 10,
+    baseDelayMs = 500,
+    maxDelayMs = 3e4
+  } = options;
   const messages = ref([]);
   const status = ref("idle");
   let ws = null;
-  function subscribe(streamName, groupId) {
-    close();
-    messages.value = [];
+  let currentStreamName = null;
+  let currentGroupId = null;
+  let retryCount = 0;
+  let retryTimer = null;
+  let intentionalClose = false;
+  function buildUrl(streamName, groupId) {
+    const protocol = window.location.protocol === "https:" ? "wss:" : "ws:";
+    const host = window.location.host;
+    return `${protocol}//${host}/_iii/stream/${encodeURIComponent(streamName)}/${encodeURIComponent(groupId)}/`;
+  }
+  function clearRetryTimer() {
+    if (retryTimer !== null) {
+      clearTimeout(retryTimer);
+      retryTimer = null;
+    }
+  }
+  function connect(streamName, groupId) {
+    if (typeof window === "undefined") return;
     status.value = "connecting";
-    const protocol = typeof window !== "undefined" && window.location.protocol === "https:" ? "wss:" : "ws:";
-    const host = typeof window !== "undefined" ? window.location.host : "localhost";
-    ws = new WebSocket(`${protocol}//${host}/_iii/stream/${streamName}/${groupId}/`);
-    ws.onopen = () => {
+    const socket = new WebSocket(buildUrl(streamName, groupId));
+    ws = socket;
+    socket.onopen = () => {
+      retryCount = 0;
       status.value = "connected";
     };
-    ws.onmessage = (e) => {
+    socket.onmessage = (e) => {
       try {
         const envelope = JSON.parse(e.data);
         let payload;
@@ -33,20 +53,56 @@ export function useIiiStream() {
         messages.value = [...messages.value, e.data];
       }
     };
-    ws.onerror = () => {
-      status.value = "error";
+    socket.onerror = () => {
     };
-    ws.onclose = () => {
-      if (status.value !== "error") status.value = "closed";
+    socket.onclose = (event) => {
       ws = null;
+      if (intentionalClose) {
+        status.value = "closed";
+        return;
+      }
+      if (retryCount >= maxRetries) {
+        status.value = "error";
+        currentStreamName = null;
+        currentGroupId = null;
+        return;
+      }
+      const delay = Math.min(baseDelayMs * 2 ** retryCount, maxDelayMs);
+      const jitter = delay * 0.25 * (Math.random() * 2 - 1);
+      retryCount++;
+      status.value = "connecting";
+      retryTimer = setTimeout(() => {
+        retryTimer = null;
+        if (!intentionalClose && currentStreamName && currentGroupId) {
+          connect(currentStreamName, currentGroupId);
+        }
+      }, Math.max(0, delay + jitter));
     };
   }
+  function subscribe(streamName, groupId) {
+    if (!intentionalClose && ws !== null && ws.readyState === WebSocket.OPEN && currentStreamName === streamName && currentGroupId === groupId) {
+      return;
+    }
+    close();
+    intentionalClose = false;
+    retryCount = 0;
+    messages.value = [];
+    currentStreamName = streamName;
+    currentGroupId = groupId;
+    connect(streamName, groupId);
+  }
   function close() {
+    intentionalClose = true;
+    clearRetryTimer();
     if (ws) {
       ws.close();
       ws = null;
     }
-    if (status.value !== "idle") status.value = "closed";
+    if (status.value !== "idle") {
+      status.value = "closed";
+    }
+    currentStreamName = null;
+    currentGroupId = null;
   }
   onUnmounted(close);
   return { messages, status, subscribe, close };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "nvent",
-  "version": "1.0.0-alpha.10",
+  "version": "1.0.0-alpha.11",
+
   "description": "Event-driven workflows for Nuxt",
   "repository": "nhealthorg/nvent",
   "license": "MIT",