svelte-realtime 0.4.9 → 0.4.11

package/README.md

@@ -874,10 +874,25 @@ Call `configure()` once at app startup. The hooks fire on state transitions only
 
 | Option | Description |
 |---|---|
+| `url` | Full WebSocket URL for cross-origin or native app usage (e.g. `'wss://api.example.com/ws'`) |
 | `onConnect()` | Called when the WebSocket connection opens after a reconnect |
 | `onDisconnect()` | Called when the WebSocket connection closes |
 | `beforeReconnect()` | Called before each reconnection attempt (can be async) |
 
+### Cross-origin and native app usage
+
+When using svelte-realtime from a client that runs on a different origin (Svelte Native, React Native, or any standalone app), pass the `url` option to point at your SvelteKit backend:
+
+```js
+import { configure } from 'svelte-realtime/client';
+
+configure({
+  url: 'wss://my-sveltekit-app.com/ws'
+});
+```
+
+When `url` is set, the default same-origin WebSocket URL is bypassed entirely. All RPC calls, streams, and pub/sub work the same way. Requires `svelte-adapter-uws` 0.4.8+.
+
 ---
 
 ## Combine stores

package/client.d.ts

@@ -157,6 +157,13 @@ export interface OfflineEntry {
 }
 
 export function configure(config: {
+	/**
+	 * Full WebSocket URL to connect to. Enables cross-origin and native app usage
+	 * (Svelte Native, React Native, standalone clients). When set, the default
+	 * same-origin URL is bypassed entirely.
+	 * @example 'wss://my-app.com/ws'
+	 */
+	url?: string;
 	/** Called when the WebSocket connection opens (not on initial connect, only reconnects). */
 	onConnect?(): void;
 	/** Called when the WebSocket connection closes. */

package/client.js

@@ -526,8 +526,6 @@ function _createStream(path, options, dynamicArgs) {
 	let subCount = 0;
 	let pendingId = null;
 
-	/** @type {boolean} */
-	let _hydrated = false;
 
 	/** @type {number | null} Last known sequence number for replay */
 	let _lastSeq = null;
@@ -928,6 +926,10 @@ function _createStream(path, options, dynamicArgs) {
 					for (const evt of response.data) {
 						_applyMerge(evt);
 					}
+				} else if (response.channel && currentValue !== undefined) {
+					// Channel fast-path returns an empty placeholder (null or []).
+					// Keep the existing value (hydrated SSR data or previously
+					// accumulated events) so the store never flashes to empty.
 				} else {
 					currentValue = response.data;
 				}
@@ -1223,7 +1225,6 @@ function _createStream(path, options, dynamicArgs) {
 			currentValue = initialData;
 			_rebuildIndex();
 			store.set(currentValue);
-			_hydrated = true;
 			return this;
 		},
 
@@ -1513,7 +1514,7 @@ function _checkArgs(path, args) {
  * @typedef {{ path: string, args: any[], queuedAt: number, resolve: Function, reject: Function }} OfflineEntry
  */
 
-/** @type {{ onConnect?: () => void, onDisconnect?: () => void, timeout?: number, offline?: { queue?: boolean, maxQueue?: number, maxAge?: number, replay?: 'sequential' | 'batch' | ((queue: OfflineEntry[]) => OfflineEntry[]), beforeReplay?: (call: { path: string, args: any[], queuedAt: number }) => boolean, onReplayError?: (call: { path: string, args: any[], queuedAt: number }, error: any) => void } }} */
+/** @type {{ url?: string, onConnect?: () => void, onDisconnect?: () => void, timeout?: number, offline?: { queue?: boolean, maxQueue?: number, maxAge?: number, replay?: 'sequential' | 'batch' | ((queue: OfflineEntry[]) => OfflineEntry[]), beforeReplay?: (call: { path: string, args: any[], queuedAt: number }) => boolean, onReplayError?: (call: { path: string, args: any[], queuedAt: number }, error: any) => void } }} */
 let _clientConfig = {};
 
 /** @type {boolean} */
@@ -1531,11 +1532,15 @@ let _replayingQueue = false;
 /**
  * Configure client-side connection hooks and offline queue.
  *
- * @param {{ onConnect?: () => void, onDisconnect?: () => void, offline?: { queue?: boolean, maxQueue?: number, maxAge?: number, replay?: 'sequential' | 'batch' | ((queue: OfflineEntry[]) => OfflineEntry[]), beforeReplay?: (call: { path: string, args: any[], queuedAt: number }) => boolean, onReplayError?: (call: { path: string, args: any[], queuedAt: number }, error: any) => void } }} config
+ * @param {{ url?: string, onConnect?: () => void, onDisconnect?: () => void, offline?: { queue?: boolean, maxQueue?: number, maxAge?: number, replay?: 'sequential' | 'batch' | ((queue: OfflineEntry[]) => OfflineEntry[]), beforeReplay?: (call: { path: string, args: any[], queuedAt: number }) => boolean, onReplayError?: (call: { path: string, args: any[], queuedAt: number }, error: any) => void } }} config
  */
 export function configure(config) {
 	_clientConfig = config;
 
+	if (config.url) {
+		_connect({ url: config.url });
+	}
+
 	if (!_configListenerAttached) {
 		_configListenerAttached = true;
 		let isFirst = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-realtime",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "Realtime RPC and reactive subscriptions for SvelteKit, built on svelte-adapter-uws",
   "author": "Kevin Radziszewski",
   "license": "MIT",
@@ -69,7 +69,7 @@
   "peerDependencies": {
     "@sveltejs/kit": "^2.0.0",
     "svelte": "^4.0.0 || ^5.0.0",
-    "svelte-adapter-uws": ">=0.4.1"
+    "svelte-adapter-uws": ">=0.4.8"
   },
   "devDependencies": {
     "vitest": "^4.0.18"

package/server.js

@@ -2102,7 +2102,7 @@ async function _executeSingleRpc(ws, msg, platform, options) {
 			// Channel fast-path
 			if (/** @type {any} */ (fn).__isChannel) {
 				const emptyValue = streamOpts.merge === 'set' ? null : [];
-				return { id, ok: true, data: emptyValue, topic, merge: streamOpts.merge, key: streamOpts.key, max: streamOpts.max };
+				return { id, ok: true, data: emptyValue, topic, merge: streamOpts.merge, key: streamOpts.key, max: streamOpts.max, channel: true };
 			}
 
 			// Delta sync