use-sse-vue 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roman3205 <https://github.com/roman3205>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# use-sse-vue
+
+A lightweight, robust Vue and Nuxt composable for managing Server-Sent Events (SSE) connections with auto-reconnect, JSON parsing, and SSR safety. Compatible with both Vue 2 and Vue 3.
+
+## Installation
+
+```bash
+npm install use-sse-vue
+```
+
+_Note: Ensure `vue` is installed in your project._
+
+## Quick Start
+
+```vue
+<script setup lang="ts">
+import { useSse } from 'use-sse-vue'
+
+const { data, status, error, connect, disconnect } = useSse('http://localhost:3000/events', {
+  autoConnect: true,
+  reconnectDelay: 2000,
+  maxReconnectAttempts: 5
+})
+</script>
+
+<template>
+  <div>
+    <p>Status: {{ status }}</p>
+    <div v-if="data">Received: {{ data }}</div>
+    <button @click="connect" :disabled="status !== 'closed'">Connect</button>
+    <button @click="disconnect" :disabled="status === 'closed'">Disconnect</button>
+  </div>
+</template>
+```
+
+## API Reference
+
+### `useSse(url, options)`
+
+#### Parameters
+
+- **`url`**: `string | (() => string) | Ref<string>` - The SSE endpoint URL. Can be a static string, a getter function, or a Vue Ref.
+- **`options`**: `UseSseOptions` (optional)
+  - `autoConnect` (`boolean`, default: `true`): Automatically initiate connection on component mount.
+  - `reconnectDelay` (`number`, default: `3000`): Time to wait (in ms) before attempting a reconnect.
+  - `maxReconnectAttempts` (`number`, default: `5`): Maximum consecutive reconnect attempts.
+  - `onMessage` (`(data: any, event: MessageEvent) => void`): Callback when a message is received.
+  - `onOpen` (`(event: Event) => void`): Callback when connection opens.
+  - `onError` (`(event: Event) => void`): Callback when connection errors occur.
+
+#### Return Value
+
+Returns an object containing:
+
+- **`data`**: `Ref<any | null>` - The parsed event data.
+- **`status`**: `Ref<'connecting' | 'open' | 'closed'>` - Reactive connection state.
+- **`error`**: `Ref<Event | null>` - The latest error event.
+- **`connect`**: `() => void` - Connect manually.
+- **`disconnect`**: `() => void` - Disconnect manually.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { useSse, type UseSseOptions } from './useSse';

package/dist/index.js

@@ -0,0 +1,85 @@
+import { onUnmounted, ref, watch } from "vue-demi";
+//#region src/useSse.ts
+function useSse(url, options = {}) {
+	const { autoConnect = true, reconnectDelay = 3e3, maxReconnectAttempts = 5, onMessage, onError, onOpen } = options;
+	const data = ref(null);
+	const status = ref("closed");
+	const error = ref(null);
+	let eventSource = null;
+	let reconnectCount = 0;
+	let reconnectTimer = null;
+	const isSSR = typeof window === "undefined";
+	const connect = () => {
+		if (isSSR || eventSource) return;
+		const targetUrl = typeof url === "function" ? url() : typeof url === "object" && "value" in url ? url.value : url;
+		status.value = "connecting";
+		error.value = null;
+		try {
+			eventSource = new EventSource(targetUrl);
+			eventSource.onopen = (event) => {
+				status.value = "open";
+				reconnectCount = 0;
+				onOpen?.(event);
+			};
+			eventSource.onmessage = (event) => {
+				try {
+					const parsed = JSON.parse(event.data);
+					data.value = parsed;
+					onMessage?.(parsed, event);
+				} catch {
+					data.value = event.data;
+					onMessage?.(event.data, event);
+				}
+			};
+			eventSource.onerror = (event) => {
+				error.value = event;
+				onError?.(event);
+				tryReconnect();
+			};
+		} catch (err) {
+			status.value = "closed";
+			error.value = err;
+			tryReconnect();
+		}
+	};
+	const disconnect = () => {
+		if (reconnectTimer) {
+			clearTimeout(reconnectTimer);
+			reconnectTimer = null;
+		}
+		if (eventSource) {
+			eventSource.close();
+			eventSource = null;
+		}
+		status.value = "closed";
+	};
+	const tryReconnect = () => {
+		disconnect();
+		if (reconnectCount < maxReconnectAttempts) {
+			status.value = "connecting";
+			reconnectCount++;
+			reconnectTimer = setTimeout(connect, reconnectDelay);
+		} else status.value = "closed";
+	};
+	if (typeof url === "function" || typeof url === "object" && "value" in url) watch(url, () => {
+		if (status.value !== "closed") {
+			disconnect();
+			connect();
+		}
+	});
+	if (autoConnect) connect();
+	onUnmounted(() => {
+		disconnect();
+	});
+	return {
+		data,
+		status,
+		error,
+		connect,
+		disconnect
+	};
+}
+//#endregion
+export { useSse };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/useSse.ts"],"sourcesContent":["import { ref, onUnmounted, watch, type Ref } from 'vue-demi'\n\nexport interface UseSseOptions<T = any> {\n  autoConnect?: boolean\n  reconnectDelay?: number\n  maxReconnectAttempts?: number\n  onMessage?: (data: T, event: MessageEvent) => void\n  onError?: (event: Event) => void\n  onOpen?: (event: Event) => void\n}\n\nexport function useSse<T = any>(\n  url: string | (() => string) | Ref<string>,\n  options: UseSseOptions<T> = {}\n) {\n  const {\n    autoConnect = true,\n    reconnectDelay = 3000,\n    maxReconnectAttempts = 5,\n    onMessage,\n    onError,\n    onOpen\n  } = options\n\n  const data = ref<T | null>(null) as Ref<T | null>\n  const status = ref<'connecting' | 'open' | 'closed'>('closed')\n  const error = ref<Event | null>(null)\n\n  let eventSource: EventSource | null = null\n  let reconnectCount = 0\n  let reconnectTimer: any = null\n\n  // Environment check\n  const isSSR = typeof window === 'undefined'\n\n  const connect = () => {\n    if (isSSR || eventSource) return\n\n    // Extract target URL from string, ref, or getter function\n    const targetUrl =\n      typeof url === 'function'\n        ? url()\n        : typeof url === 'object' && 'value' in url\n          ? url.value\n          : url\n\n    status.value = 'connecting'\n    error.value = null\n\n    try {\n      eventSource = new EventSource(targetUrl)\n\n      eventSource.onopen = (event) => {\n        status.value = 'open'\n        reconnectCount = 0\n        onOpen?.(event)\n      }\n\n      eventSource.onmessage = (event: MessageEvent) => {\n        // Attempt to parse JSON, fallback to raw string if it fails\n        try {\n          const parsed = JSON.parse(event.data)\n          data.value = parsed\n          onMessage?.(parsed, event)\n        } catch {\n          data.value = event.data as any\n          onMessage?.(event.data, event)\n        }\n      }\n\n      eventSource.onerror = (event) => {\n        error.value = event\n        onError?.(event)\n\n        // Trigger reconnection\n        tryReconnect()\n      }\n    } catch (err) {\n      status.value = 'closed'\n      error.value = err as any\n      tryReconnect()\n    }\n  }\n\n  const disconnect = () => {\n    if (reconnectTimer) {\n      clearTimeout(reconnectTimer)\n      reconnectTimer = null\n    }\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n    status.value = 'closed'\n  }\n\n  const tryReconnect = () => {\n    disconnect()\n\n    if (reconnectCount < maxReconnectAttempts) {\n      status.value = 'connecting'\n      reconnectCount++\n      reconnectTimer = setTimeout(connect, reconnectDelay)\n    } else {\n      status.value = 'closed'\n    }\n  }\n\n  // Monitor URL change if it is reactive\n  if (typeof url === 'function' || (typeof url === 'object' && 'value' in url)) {\n    watch(url, () => {\n      if (status.value !== 'closed') {\n        disconnect()\n        connect()\n      }\n    })\n  }\n\n  if (autoConnect) {\n    connect()\n  }\n\n  onUnmounted(() => {\n    disconnect()\n  })\n\n  return {\n    data,\n    status,\n    error,\n    connect,\n    disconnect\n  }\n}\n"],"mappings":";;AAWA,SAAgB,OACd,KACA,UAA4B,CAAC,GAC7B;CACA,MAAM,EACJ,cAAc,MACd,iBAAiB,KACjB,uBAAuB,GACvB,WACA,SACA,WACE;CAEJ,MAAM,OAAO,IAAc,IAAI;CAC/B,MAAM,SAAS,IAAsC,QAAQ;CAC7D,MAAM,QAAQ,IAAkB,IAAI;CAEpC,IAAI,cAAkC;CACtC,IAAI,iBAAiB;CACrB,IAAI,iBAAsB;CAG1B,MAAM,QAAQ,OAAO,WAAW;CAEhC,MAAM,gBAAgB;EACpB,IAAI,SAAS,aAAa;EAG1B,MAAM,YACJ,OAAO,QAAQ,aACX,IAAI,IACJ,OAAO,QAAQ,YAAY,WAAW,MACpC,IAAI,QACJ;EAER,OAAO,QAAQ;EACf,MAAM,QAAQ;EAEd,IAAI;GACF,cAAc,IAAI,YAAY,SAAS;GAEvC,YAAY,UAAU,UAAU;IAC9B,OAAO,QAAQ;IACf,iBAAiB;IACjB,SAAS,KAAK;GAChB;GAEA,YAAY,aAAa,UAAwB;IAE/C,IAAI;KACF,MAAM,SAAS,KAAK,MAAM,MAAM,IAAI;KACpC,KAAK,QAAQ;KACb,YAAY,QAAQ,KAAK;IAC3B,QAAQ;KACN,KAAK,QAAQ,MAAM;KACnB,YAAY,MAAM,MAAM,KAAK;IAC/B;GACF;GAEA,YAAY,WAAW,UAAU;IAC/B,MAAM,QAAQ;IACd,UAAU,KAAK;IAGf,aAAa;GACf;EACF,SAAS,KAAK;GACZ,OAAO,QAAQ;GACf,MAAM,QAAQ;GACd,aAAa;EACf;CACF;CAEA,MAAM,mBAAmB;EACvB,IAAI,gBAAgB;GAClB,aAAa,cAAc;GAC3B,iBAAiB;EACnB;EACA,IAAI,aAAa;GACf,YAAY,MAAM;GAClB,cAAc;EAChB;EACA,OAAO,QAAQ;CACjB;CAEA,MAAM,qBAAqB;EACzB,WAAW;EAEX,IAAI,iBAAiB,sBAAsB;GACzC,OAAO,QAAQ;GACf;GACA,iBAAiB,WAAW,SAAS,cAAc;EACrD,OACE,OAAO,QAAQ;CAEnB;CAGA,IAAI,OAAO,QAAQ,cAAe,OAAO,QAAQ,YAAY,WAAW,KACtE,MAAM,WAAW;EACf,IAAI,OAAO,UAAU,UAAU;GAC7B,WAAW;GACX,QAAQ;EACV;CACF,CAAC;CAGH,IAAI,aACF,QAAQ;CAGV,kBAAkB;EAChB,WAAW;CACb,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/index.umd.cjs

@@ -0,0 +1,89 @@
+(function(global, factory) {
+	typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("vue-demi")) : typeof define === "function" && define.amd ? define(["exports", "vue-demi"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["use-sse-vue"] = {}, global.VueDemi));
+})(this, function(exports, vue_demi) {
+	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+	//#region src/useSse.ts
+	function useSse(url, options = {}) {
+		const { autoConnect = true, reconnectDelay = 3e3, maxReconnectAttempts = 5, onMessage, onError, onOpen } = options;
+		const data = (0, vue_demi.ref)(null);
+		const status = (0, vue_demi.ref)("closed");
+		const error = (0, vue_demi.ref)(null);
+		let eventSource = null;
+		let reconnectCount = 0;
+		let reconnectTimer = null;
+		const isSSR = typeof window === "undefined";
+		const connect = () => {
+			if (isSSR || eventSource) return;
+			const targetUrl = typeof url === "function" ? url() : typeof url === "object" && "value" in url ? url.value : url;
+			status.value = "connecting";
+			error.value = null;
+			try {
+				eventSource = new EventSource(targetUrl);
+				eventSource.onopen = (event) => {
+					status.value = "open";
+					reconnectCount = 0;
+					onOpen?.(event);
+				};
+				eventSource.onmessage = (event) => {
+					try {
+						const parsed = JSON.parse(event.data);
+						data.value = parsed;
+						onMessage?.(parsed, event);
+					} catch {
+						data.value = event.data;
+						onMessage?.(event.data, event);
+					}
+				};
+				eventSource.onerror = (event) => {
+					error.value = event;
+					onError?.(event);
+					tryReconnect();
+				};
+			} catch (err) {
+				status.value = "closed";
+				error.value = err;
+				tryReconnect();
+			}
+		};
+		const disconnect = () => {
+			if (reconnectTimer) {
+				clearTimeout(reconnectTimer);
+				reconnectTimer = null;
+			}
+			if (eventSource) {
+				eventSource.close();
+				eventSource = null;
+			}
+			status.value = "closed";
+		};
+		const tryReconnect = () => {
+			disconnect();
+			if (reconnectCount < maxReconnectAttempts) {
+				status.value = "connecting";
+				reconnectCount++;
+				reconnectTimer = setTimeout(connect, reconnectDelay);
+			} else status.value = "closed";
+		};
+		if (typeof url === "function" || typeof url === "object" && "value" in url) (0, vue_demi.watch)(url, () => {
+			if (status.value !== "closed") {
+				disconnect();
+				connect();
+			}
+		});
+		if (autoConnect) connect();
+		(0, vue_demi.onUnmounted)(() => {
+			disconnect();
+		});
+		return {
+			data,
+			status,
+			error,
+			connect,
+			disconnect
+		};
+	}
+	//#endregion
+	exports.useSse = useSse;
+});
+
+//# sourceMappingURL=index.umd.cjs.map

package/dist/index.umd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.cjs","names":[],"sources":["../src/useSse.ts"],"sourcesContent":["import { ref, onUnmounted, watch, type Ref } from 'vue-demi'\n\nexport interface UseSseOptions<T = any> {\n  autoConnect?: boolean\n  reconnectDelay?: number\n  maxReconnectAttempts?: number\n  onMessage?: (data: T, event: MessageEvent) => void\n  onError?: (event: Event) => void\n  onOpen?: (event: Event) => void\n}\n\nexport function useSse<T = any>(\n  url: string | (() => string) | Ref<string>,\n  options: UseSseOptions<T> = {}\n) {\n  const {\n    autoConnect = true,\n    reconnectDelay = 3000,\n    maxReconnectAttempts = 5,\n    onMessage,\n    onError,\n    onOpen\n  } = options\n\n  const data = ref<T | null>(null) as Ref<T | null>\n  const status = ref<'connecting' | 'open' | 'closed'>('closed')\n  const error = ref<Event | null>(null)\n\n  let eventSource: EventSource | null = null\n  let reconnectCount = 0\n  let reconnectTimer: any = null\n\n  // Environment check\n  const isSSR = typeof window === 'undefined'\n\n  const connect = () => {\n    if (isSSR || eventSource) return\n\n    // Extract target URL from string, ref, or getter function\n    const targetUrl =\n      typeof url === 'function'\n        ? url()\n        : typeof url === 'object' && 'value' in url\n          ? url.value\n          : url\n\n    status.value = 'connecting'\n    error.value = null\n\n    try {\n      eventSource = new EventSource(targetUrl)\n\n      eventSource.onopen = (event) => {\n        status.value = 'open'\n        reconnectCount = 0\n        onOpen?.(event)\n      }\n\n      eventSource.onmessage = (event: MessageEvent) => {\n        // Attempt to parse JSON, fallback to raw string if it fails\n        try {\n          const parsed = JSON.parse(event.data)\n          data.value = parsed\n          onMessage?.(parsed, event)\n        } catch {\n          data.value = event.data as any\n          onMessage?.(event.data, event)\n        }\n      }\n\n      eventSource.onerror = (event) => {\n        error.value = event\n        onError?.(event)\n\n        // Trigger reconnection\n        tryReconnect()\n      }\n    } catch (err) {\n      status.value = 'closed'\n      error.value = err as any\n      tryReconnect()\n    }\n  }\n\n  const disconnect = () => {\n    if (reconnectTimer) {\n      clearTimeout(reconnectTimer)\n      reconnectTimer = null\n    }\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n    status.value = 'closed'\n  }\n\n  const tryReconnect = () => {\n    disconnect()\n\n    if (reconnectCount < maxReconnectAttempts) {\n      status.value = 'connecting'\n      reconnectCount++\n      reconnectTimer = setTimeout(connect, reconnectDelay)\n    } else {\n      status.value = 'closed'\n    }\n  }\n\n  // Monitor URL change if it is reactive\n  if (typeof url === 'function' || (typeof url === 'object' && 'value' in url)) {\n    watch(url, () => {\n      if (status.value !== 'closed') {\n        disconnect()\n        connect()\n      }\n    })\n  }\n\n  if (autoConnect) {\n    connect()\n  }\n\n  onUnmounted(() => {\n    disconnect()\n  })\n\n  return {\n    data,\n    status,\n    error,\n    connect,\n    disconnect\n  }\n}\n"],"mappings":";;;;;CAWA,SAAgB,OACd,KACA,UAA4B,CAAC,GAC7B;EACA,MAAM,EACJ,cAAc,MACd,iBAAiB,KACjB,uBAAuB,GACvB,WACA,SACA,WACE;EAEJ,MAAM,QAAA,GAAA,SAAA,IAAA,CAAqB,IAAI;EAC/B,MAAM,UAAA,GAAA,SAAA,IAAA,CAA+C,QAAQ;EAC7D,MAAM,SAAA,GAAA,SAAA,IAAA,CAA0B,IAAI;EAEpC,IAAI,cAAkC;EACtC,IAAI,iBAAiB;EACrB,IAAI,iBAAsB;EAG1B,MAAM,QAAQ,OAAO,WAAW;EAEhC,MAAM,gBAAgB;GACpB,IAAI,SAAS,aAAa;GAG1B,MAAM,YACJ,OAAO,QAAQ,aACX,IAAI,IACJ,OAAO,QAAQ,YAAY,WAAW,MACpC,IAAI,QACJ;GAER,OAAO,QAAQ;GACf,MAAM,QAAQ;GAEd,IAAI;IACF,cAAc,IAAI,YAAY,SAAS;IAEvC,YAAY,UAAU,UAAU;KAC9B,OAAO,QAAQ;KACf,iBAAiB;KACjB,SAAS,KAAK;IAChB;IAEA,YAAY,aAAa,UAAwB;KAE/C,IAAI;MACF,MAAM,SAAS,KAAK,MAAM,MAAM,IAAI;MACpC,KAAK,QAAQ;MACb,YAAY,QAAQ,KAAK;KAC3B,QAAQ;MACN,KAAK,QAAQ,MAAM;MACnB,YAAY,MAAM,MAAM,KAAK;KAC/B;IACF;IAEA,YAAY,WAAW,UAAU;KAC/B,MAAM,QAAQ;KACd,UAAU,KAAK;KAGf,aAAa;IACf;GACF,SAAS,KAAK;IACZ,OAAO,QAAQ;IACf,MAAM,QAAQ;IACd,aAAa;GACf;EACF;EAEA,MAAM,mBAAmB;GACvB,IAAI,gBAAgB;IAClB,aAAa,cAAc;IAC3B,iBAAiB;GACnB;GACA,IAAI,aAAa;IACf,YAAY,MAAM;IAClB,cAAc;GAChB;GACA,OAAO,QAAQ;EACjB;EAEA,MAAM,qBAAqB;GACzB,WAAW;GAEX,IAAI,iBAAiB,sBAAsB;IACzC,OAAO,QAAQ;IACf;IACA,iBAAiB,WAAW,SAAS,cAAc;GACrD,OACE,OAAO,QAAQ;EAEnB;EAGA,IAAI,OAAO,QAAQ,cAAe,OAAO,QAAQ,YAAY,WAAW,KACtE,CAAA,GAAA,SAAA,MAAA,CAAM,WAAW;GACf,IAAI,OAAO,UAAU,UAAU;IAC7B,WAAW;IACX,QAAQ;GACV;EACF,CAAC;EAGH,IAAI,aACF,QAAQ;EAGV,CAAA,GAAA,SAAA,YAAA,OAAkB;GAChB,WAAW;EACb,CAAC;EAED,OAAO;GACL;GACA;GACA;GACA;GACA;EACF;CACF"}

package/dist/useSse.d.ts

@@ -0,0 +1,51 @@
+import { type Ref } from 'vue-demi';
+export interface UseSseOptions<T = any> {
+    autoConnect?: boolean;
+    reconnectDelay?: number;
+    maxReconnectAttempts?: number;
+    onMessage?: (data: T, event: MessageEvent) => void;
+    onError?: (event: Event) => void;
+    onOpen?: (event: Event) => void;
+}
+export declare function useSse<T = any>(url: string | (() => string) | Ref<string>, options?: UseSseOptions<T>): {
+    data: Ref<T | null>;
+    status: Ref<"connecting" | "open" | "closed">;
+    error: Ref<{
+        readonly bubbles: boolean;
+        cancelBubble: boolean;
+        readonly cancelable: boolean;
+        readonly composed: boolean;
+        readonly currentTarget: {
+            addEventListener: (type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean) => void;
+            dispatchEvent: (event: Event) => boolean;
+            removeEventListener: (type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean) => void;
+        } | null;
+        readonly defaultPrevented: boolean;
+        readonly eventPhase: number;
+        readonly isTrusted: boolean;
+        returnValue: boolean;
+        readonly srcElement: {
+            addEventListener: (type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean) => void;
+            dispatchEvent: (event: Event) => boolean;
+            removeEventListener: (type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean) => void;
+        } | null;
+        readonly target: {
+            addEventListener: (type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean) => void;
+            dispatchEvent: (event: Event) => boolean;
+            removeEventListener: (type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean) => void;
+        } | null;
+        readonly timeStamp: DOMHighResTimeStamp;
+        readonly type: string;
+        composedPath: () => EventTarget[];
+        initEvent: (type: string, bubbles?: boolean, cancelable?: boolean) => void;
+        preventDefault: () => void;
+        stopImmediatePropagation: () => void;
+        stopPropagation: () => void;
+        readonly NONE: 0;
+        readonly CAPTURING_PHASE: 1;
+        readonly AT_TARGET: 2;
+        readonly BUBBLING_PHASE: 3;
+    } | null>;
+    connect: () => void;
+    disconnect: () => void;
+};

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "use-sse-vue",
+  "private": false,
+  "version": "0.0.1",
+  "description": "A lightweight, robust Vue and Nuxt composable for managing Server-Sent Events (SSE) connections with auto-reconnect, JSON parsing, and SSR safety",
+  "type": "module",
+  "license": "MIT",
+  "author": "Roman",
+  "homepage": "https://github.com/roman3205/use-sse-vue#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/roman3205/use-sse-vue.git"
+  },
+  "bugs": {
+    "url": "https://github.com/roman3205/use-sse-vue/issues"
+  },
+  "keywords": [
+    "vue",
+    "vue3",
+    "vue2",
+    "nuxt",
+    "nuxt3",
+    "sse",
+    "server-sent-events",
+    "composable",
+    "useSse",
+    "reconnect"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.umd.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.umd.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "node playground/server.js & vite playground --config vite.config.ts",
+    "playground": "vite playground --config vite.config.ts",
+    "server": "node playground/server.js",
+    "build": "vite build && vue-tsc",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --noEmit && vue-tsc -p playground/tsconfig.json",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@tailwindcss/vite": "^4.3.1",
+    "@vitejs/plugin-vue": "^6.0.7",
+    "eslint": "^10.5.0",
+    "eslint-plugin-vue": "^10.9.2",
+    "globals": "^17.7.0",
+    "prettier": "^3.8.5",
+    "tailwindcss": "^4.3.1",
+    "typescript": "~6.0.2",
+    "typescript-eslint": "^8.62.0",
+    "vite": "^8.1.0",
+    "vue": "^3.4.5",
+    "vue-tsc": "^3.3.5"
+  },
+  "peerDependencies": {
+    "vue": "^2.7.0 || ^3.0.0"
+  },
+  "dependencies": {
+    "vue-demi": "^0.14.10"
+  }
+}