svelte-realtime 0.4.8 → 0.4.10

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

@@ -1513,7 +1513,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 +1531,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.8",
+  "version": "0.4.10",
   "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/vite.js

@@ -552,13 +552,14 @@ function _generateSsrStubs(filePath, modulePath) {
 
 	for (const name of storeNames) {
 		if (dynamicNames.has(name)) {
-			// Dynamic stream: return a readable store from a function so name(args) works during SSR
-			lines.push(`const _${name} = (...args) => readable(undefined);`);
+			// Dynamic stream: factory returns a readable with .hydrate() for SSR rendering
+			lines.push(`const _${name} = (...args) => { const s = readable(undefined); s.hydrate = (d) => readable(d); return s; };`);
 			lines.push(`_${name}.load = (platform, options) => __directCall(${safeModulePath(name)}, options?.args || [], platform, options);`);
 			lines.push(`export { _${name} as ${name} };`);
 		} else {
-			// Static stream: plain readable store
+			// Static stream: readable with .hydrate() for SSR rendering
 			lines.push(`const _${name} = readable(undefined);`);
+			lines.push(`_${name}.hydrate = (d) => readable(d);`);
 			lines.push(`_${name}.load = (platform, options) => __directCall(${safeModulePath(name)}, options?.args || [], platform, options);`);
 			lines.push(`export { _${name} as ${name} };`);
 		}