svelte-realtime 0.4.14 → 0.4.15

package/README.md

@@ -261,7 +261,7 @@ The `merge` option on `live.stream()` controls how live pub/sub events are appli
 
 ### crud (default)
 
-Handles `created`, `updated`, `deleted` events. The store maintains an array, keyed by `id` (configurable with `key`).
+Handles `created`, `updated`, `deleted` events. The store maintains an array, keyed by `id` (configurable with `key`). Set `max` to cap the buffer size and drop the oldest items when exceeded (useful for live feeds with `prepend: true`).
 
 ```js
 // Server
@@ -361,7 +361,7 @@ Events: `update` (add/update by key), `remove` (remove by key), `set` (replace a
 | `merge` | `'crud'` | Merge strategy: `'crud'`, `'latest'`, `'set'`, `'presence'`, `'cursor'` |
 | `key` | `'id'` | Key field for `crud` mode |
 | `prepend` | `false` | Prepend new items instead of appending (`crud` mode) |
-| `max` | `50` | Max items to keep (`latest` mode) |
+| `max` | `50` / `0` | Max items to keep. Defaults to 50 for `latest`, 0 (unlimited) for `crud`. Oldest items are dropped when exceeded |
 | `replay` | `false` | Enable seq-based replay for gap-free reconnection |
 | `onSubscribe` | -- | Callback `(ctx, topic)` fired when a client subscribes |
 | `onUnsubscribe` | -- | Callback `(ctx, topic)` fired when a client disconnects |

package/client.d.ts

@@ -1,6 +1,17 @@
 import type { Readable } from 'svelte/store';
 import type { WSEvent } from 'svelte-adapter-uws/client';
 
+/**
+ * A store that always holds `undefined`. Use as a fallback for conditional
+ * streams so you don't need to import `readable` from `svelte/store`:
+ *
+ * ```svelte
+ * import { todos, empty } from '$live/todos';
+ * const items = $derived(user ? todos(orgId) : empty);
+ * ```
+ */
+export const empty: Readable<undefined>;
+
 /**
  * Typed error for RPC failures.
  * Contains a `code` field for programmatic handling.

package/client.js

@@ -1,6 +1,9 @@
 // @ts-check
 import { connect as _connect, on, status } from 'svelte-adapter-uws/client';
-import { writable } from 'svelte/store';
+import { writable, readable } from 'svelte/store';
+
+/** @type {import('svelte/store').Readable<undefined>} */
+export const empty = readable(undefined);
 
 const _textEncoder = new TextEncoder();
 
@@ -499,7 +502,7 @@ function _createStream(path, options, dynamicArgs) {
 	let merge = options?.merge || 'crud';
 	let key = options?.key || 'id';
 	let prepend = options?.prepend || false;
-	let max = options?.max || 50;
+	let max = options?.max || (merge === 'latest' ? 50 : 0);
 
 	/** @type {any} */
 	let currentValue;
@@ -637,9 +640,18 @@ function _createStream(path, options, dynamicArgs) {
 					currentValue.unshift(data);
 					for (const [k, i] of _index) _index.set(k, i + 1);
 					_index.set(data[key], 0);
+					if (max && currentValue.length > max) {
+						const removed = currentValue.splice(max);
+						for (const item of removed) _index.delete(item[key]);
+					}
 				} else {
 					_index.set(data[key], currentValue.length);
 					currentValue.push(data);
+					if (max && currentValue.length > max) {
+						const removed = currentValue.splice(0, currentValue.length - max);
+						for (const item of removed) _index.delete(item[key]);
+						_rebuildIndex();
+					}
 				}
 			} else if (event === 'updated') {
 				const idx = _index.get(data[key]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-realtime",
-  "version": "0.4.14",
+  "version": "0.4.15",
   "description": "Realtime RPC and reactive subscriptions for SvelteKit, built on svelte-adapter-uws",
   "author": "Kevin Radziszewski",
   "license": "MIT",

package/server.d.ts

@@ -67,8 +67,10 @@ export interface StreamOptions {
 	prepend?: boolean;
 
 	/**
-	 * Maximum items to keep (latest mode only).
-	 * @default 50
+	 * Maximum items to keep. When the buffer exceeds this size, the oldest
+	 * items are dropped. Works with `crud` and `latest` merge strategies.
+	 *
+	 * For `latest`, defaults to 50. For `crud`, defaults to 0 (unlimited).
 	 */
 	max?: number;
 

package/vite.js

@@ -785,7 +785,9 @@ function _generateClientStubs(filePath, modulePath, dir) {
 		? `import { ${[...imports].join(', ')} } from 'svelte-realtime/client';\n`
 		: '';
 
-	return importLine + lines.join('\n') + '\n';
+	const reexport = `export { empty } from 'svelte-realtime/client';\n`;
+
+	return importLine + reexport + lines.join('\n') + '\n';
 }
 
 /**
@@ -1712,10 +1714,12 @@ function _generateTypeDeclarations(liveDir, dir) {
 				if (needsRpcError) clientImports.push('RpcError');
 				declarations.push(`  import type { ${clientImports.join(', ')} } from 'svelte-realtime/client';`);
 			}
+			declarations.push(`  import type { Readable } from 'svelte/store';`);
 			if (needsStreamStore || needsRpcError) {
 				declarations.push('');
 			}
 			declarations.push(...exports);
+			declarations.push(`  export const empty: Readable<undefined>;`);
 			declarations.push('}');
 			declarations.push('');
 		}