reflectdb 0.1.0 → 0.1.2

package/dist/shared/esm-g0marxk7.js

@@ -0,0 +1,134 @@
+// src/server/ephemeral/memory.ts
+var DEFAULT_MAX_ENTRIES = 1e4;
+function indexKey(room, key, clientId) {
+  return `${room}\x00${key}\x00${clientId}`;
+}
+function parseIndexKey(packed) {
+  const [room, key, clientId] = packed.split("\x00");
+  return { room, key, clientId };
+}
+
+class EphemeralManager {
+  store = new Map;
+  clientIndex = new Map;
+  entryCount = 0;
+  maxEntries;
+  constructor(maxEntries) {
+    this.maxEntries = maxEntries ?? DEFAULT_MAX_ENTRIES;
+  }
+  set(room, key, clientId, userId, data, ttlMs) {
+    const roomMap = this.store.get(room) ?? new Map;
+    const keyMap = roomMap.get(key) ?? new Map;
+    const existing = keyMap.get(clientId);
+    if (!existing && this.entryCount >= this.maxEntries) {
+      return false;
+    }
+    const state = {
+      clientId,
+      userId,
+      key,
+      data,
+      updatedAt: Date.now(),
+      ttlMs
+    };
+    keyMap.set(clientId, state);
+    roomMap.set(key, keyMap);
+    this.store.set(room, roomMap);
+    if (!existing) {
+      this.entryCount++;
+      this.addToClientIndex(clientId, indexKey(room, key, clientId));
+    }
+    return true;
+  }
+  addToClientIndex(clientId, packed) {
+    const clientSet = this.clientIndex.get(clientId) ?? new Set;
+    clientSet.add(packed);
+    this.clientIndex.set(clientId, clientSet);
+  }
+  removeFromClientIndex(clientId, packed) {
+    const clientSet = this.clientIndex.get(clientId);
+    if (!clientSet)
+      return;
+    clientSet.delete(packed);
+    if (clientSet.size === 0)
+      this.clientIndex.delete(clientId);
+  }
+  get(room, key) {
+    const roomMap = this.store.get(room);
+    if (!roomMap)
+      return {};
+    const keyMap = roomMap.get(key);
+    if (!keyMap)
+      return {};
+    return Object.fromEntries(keyMap.entries());
+  }
+  getRoom(room) {
+    const roomMap = this.store.get(room);
+    if (!roomMap)
+      return {};
+    const out = {};
+    for (const [key, keyMap] of roomMap) {
+      out[key] = Object.fromEntries(keyMap.entries());
+    }
+    return out;
+  }
+  remove(room, key, clientId) {
+    const roomMap = this.store.get(room);
+    if (!roomMap)
+      return;
+    const keyMap = roomMap.get(key);
+    if (!keyMap)
+      return;
+    if (keyMap.has(clientId)) {
+      keyMap.delete(clientId);
+      this.entryCount--;
+      this.removeFromClientIndex(clientId, indexKey(room, key, clientId));
+    }
+    if (keyMap.size === 0) {
+      roomMap.delete(key);
+    }
+    if (roomMap.size === 0) {
+      this.store.delete(room);
+    }
+  }
+  removeClient(clientId) {
+    const indices = this.clientIndex.get(clientId);
+    if (!indices)
+      return;
+    const entries = [...indices];
+    for (const packed of entries) {
+      const { room, key, clientId: owner } = parseIndexKey(packed);
+      this.remove(room, key, owner);
+    }
+    this.clientIndex.delete(clientId);
+  }
+  cleanupExpired() {
+    const now = Date.now();
+    const toRemove = [];
+    for (const [room, roomMap] of this.store) {
+      for (const [key, keyMap] of roomMap) {
+        for (const [clientId, state] of keyMap) {
+          if (state.ttlMs && now - state.updatedAt > state.ttlMs) {
+            toRemove.push({ room, key, clientId });
+          }
+        }
+      }
+    }
+    for (const { room, key, clientId } of toRemove) {
+      this.remove(room, key, clientId);
+    }
+  }
+  size() {
+    return this.entryCount;
+  }
+  destroy() {
+    this.store.clear();
+    this.clientIndex.clear();
+    this.entryCount = 0;
+  }
+}
+function createMemoryEphemeral(maxEntries) {
+  return new EphemeralManager(maxEntries);
+}
+
+export { EphemeralManager, createMemoryEphemeral };

package/dist/svelte/index.d.ts

@@ -267,6 +267,17 @@ declare class ClientStore {
 	clearTable(table: string): void;
 	applySnapshot(table: string, rows: Record<string, unknown>[], colClocks: Record<string, Record<string, string>>, append?: boolean, pk?: string): void;
 	applyDelta(table: string, op: string, rowId: string, payload: Record<string, unknown> | null, hlc: string, colClocks?: Record<string, string>): void;
+	/**
+	* Guarantee a materialized row carries its own primary key.
+	*
+	* A delta's payload is not always a whole row: eager broadcasts forward the
+	* writer's payload verbatim, and the typed API omits the pk from what a
+	* client may write — so an eagerly-broadcast insert describes a row with no
+	* id in it. Rows are addressed by `rowId` everywhere in the protocol, so the
+	* key is never in doubt; only the materialized object was missing it, and
+	* `rows.map(r => r.id)` came back undefined.
+	*/
+	private withPk;
 	revertOp(opId: string, serverRow: Record<string, unknown> | null | undefined): void;
 	setTableMeta(meta: Record<string, {
 		serverSet: string[];
@@ -496,11 +507,15 @@ interface DrizzleTableLike {
 /**
 * Value supplied per serverSet field in the schema's object form.
 * Either a static value or a function that receives the request context.
+*
+* The static arm is enumerated rather than written as `unknown`: a union with
+* `unknown` collapses to `unknown`, which strips the contextual type from the
+* callback arm and makes every `(ctx) => …` an implicit `any` under `strict`.
 */
-type ServerSetSchemaValue = unknown | ((ctx: {
+type ServerSetSchemaValue = ((ctx: {
 	auth: unknown;
 	params: unknown;
-}) => unknown);
+}) => unknown) | string | number | bigint | boolean | symbol | null | undefined | Date | readonly unknown[] | Record<string, unknown>;
 /**
 * Schema-side `serverSet` declaration. Two shapes:
 *  - `string[]` — keys only; values are supplied at `implement(...)` time.
@@ -642,4 +657,4 @@ interface SyncSvelteHooks<TQueries extends SyncQueryMap> {
 	createStore: (config: SyncStoreConfig) => TypedSyncStore<TQueries>;
 }
 declare function createSyncSvelte<TQueries extends SyncQueryMap>(): SyncSvelteHooks<TQueries>;
-export { createSyncSvelte, createSyncStore, createBrowserWsTransport, TypedSyncStore, SyncSvelteHooks, SyncStoreConfig, SyncStore, Readable };
+export { Readable, SyncStore, SyncStoreConfig, SyncSvelteHooks, TypedSyncStore, createBrowserWsTransport, createSyncStore, createSyncSvelte };

package/dist/svelte/index.js

@@ -1,10 +1,10 @@
 import {
   SyncClient,
   pushSafely
-} from "../shared/esm-ytrd3hbq.js";
+} from "../shared/esm-8qbr4y0d.js";
 import"../shared/esm-rw7jjtrv.js";
 import"../shared/esm-3tkwvysa.js";
-import"../shared/esm-b7xs9cde.js";
+import"../shared/esm-k7kedp3y.js";
 
 // src/svelte/stores.ts
 function createBrowserWsTransport(url) {
@@ -166,21 +166,21 @@ function createSyncStore(config) {
       }
     }
     const unsub = client.subscribeEphemeral(cfg.key, (event) => {
-      current = { ...current, [event.userId]: event.data };
+      current = { ...current, [event.clientId]: event.data };
       notifySubscribers();
       if (cfg.ttlMs) {
-        const existing = timers.get(event.userId);
+        const existing = timers.get(event.clientId);
         if (existing) {
           clearTimeout(existing);
         }
         const timer = setTimeout(() => {
           const next = { ...current };
-          delete next[event.userId];
+          delete next[event.clientId];
           current = next;
-          timers.delete(event.userId);
+          timers.delete(event.clientId);
           notifySubscribers();
         }, cfg.ttlMs);
-        timers.set(event.userId, timer);
+        timers.set(event.clientId, timer);
       }
     });
     const events = {
@@ -256,7 +256,7 @@ function createSyncSvelte() {
   return { createStore };
 }
 export {
-  createSyncSvelte,
+  createBrowserWsTransport,
   createSyncStore,
-  createBrowserWsTransport
+  createSyncSvelte
 };

package/dist/transport/bun-ws.d.ts

@@ -212,4 +212,4 @@ declare function createBunWsServerTransport(cfg?: BunWsServerConfig): {
 		pong?(ws: BunServerWebSocket<BunWsTransportData>): void;
 	};
 };
-export { createBunWsServerTransport, BunWsTransportData, BunWsServerConfig };
+export { BunWsServerConfig, BunWsTransportData, createBunWsServerTransport };

package/dist/transport/bun-ws.js

@@ -1,7 +1,7 @@
 import {
   TransportSendError
 } from "../shared/esm-3tkwvysa.js";
-import"../shared/esm-b7xs9cde.js";
+import"../shared/esm-k7kedp3y.js";
 
 // src/transport/bun-ws.ts
 function trySend(clientId, ws, data, maxBufferedBytes) {

package/dist/transport/polling.d.ts

@@ -207,4 +207,4 @@ interface PollingClientConfig {
 	headers?: Record<string, string>;
 }
 declare function createPollingClientTransport(config: PollingClientConfig): ClientTransport;
-export { pollingBodyTooLarge, createPollingServerTransport, createPollingClientTransport, PollingServerConfig, PollingClientConfig };
+export { PollingClientConfig, PollingServerConfig, createPollingClientTransport, createPollingServerTransport, pollingBodyTooLarge };

package/dist/transport/polling.js

@@ -1,7 +1,7 @@
 import {
   TransportSendError
 } from "../shared/esm-3tkwvysa.js";
-import"../shared/esm-b7xs9cde.js";
+import"../shared/esm-k7kedp3y.js";
 
 // src/transport/polling.ts
 function pollingBodyTooLarge(body, limit = 1e6) {
@@ -175,7 +175,7 @@ function createPollingClientTransport(config) {
   };
 }
 export {
-  pollingBodyTooLarge,
+  createPollingClientTransport,
   createPollingServerTransport,
-  createPollingClientTransport
+  pollingBodyTooLarge
 };

package/dist/transport/sse.d.ts

@@ -202,4 +202,4 @@ interface SseClientConfig {
 	headers?: Record<string, string>;
 }
 declare function createSseClientTransport(config: SseClientConfig): ClientTransport;
-export { createSseServerTransport, createSseClientTransport, SseServerConfig, SseClientConfig };
+export { SseClientConfig, SseServerConfig, createSseClientTransport, createSseServerTransport };

package/dist/transport/sse.js

@@ -1,7 +1,7 @@
 import {
   TransportSendError
 } from "../shared/esm-3tkwvysa.js";
-import"../shared/esm-b7xs9cde.js";
+import"../shared/esm-k7kedp3y.js";
 
 // src/transport/sse.ts
 function createSseServerTransport(cfg = {}) {
@@ -203,6 +203,6 @@ function createSseClientTransport(config) {
   };
 }
 export {
-  createSseServerTransport,
-  createSseClientTransport
+  createSseClientTransport,
+  createSseServerTransport
 };

package/dist/transport/ws.d.ts

@@ -233,4 +233,4 @@ interface WebSocketLike {
 	/** Bytes queued but not yet flushed. Used for outbound backpressure. */
 	bufferedAmount?: number;
 }
-export { isOriginAllowed, createWsServerTransport, createWsClientTransport, WsServerTransportConfig, WsServerConfig, WsClientConfig, WebSocketLike };
+export { WebSocketLike, WsClientConfig, WsServerConfig, WsServerTransportConfig, createWsClientTransport, createWsServerTransport, isOriginAllowed };

package/dist/transport/ws.js

@@ -1,7 +1,7 @@
 import {
   TransportSendError
 } from "../shared/esm-3tkwvysa.js";
-import"../shared/esm-b7xs9cde.js";
+import"../shared/esm-k7kedp3y.js";
 
 // src/transport/ws.ts
 function trySend(clientId, ws, data, maxBufferedBytes) {
@@ -220,7 +220,7 @@ function createWsClientTransport(config) {
   };
 }
 export {
-  isOriginAllowed,
+  createWsClientTransport,
   createWsServerTransport,
-  createWsClientTransport
+  isOriginAllowed
 };

package/dist/vanilla/index.d.ts

@@ -267,6 +267,17 @@ declare class ClientStore {
 	clearTable(table: string): void;
 	applySnapshot(table: string, rows: Record<string, unknown>[], colClocks: Record<string, Record<string, string>>, append?: boolean, pk?: string): void;
 	applyDelta(table: string, op: string, rowId: string, payload: Record<string, unknown> | null, hlc: string, colClocks?: Record<string, string>): void;
+	/**
+	* Guarantee a materialized row carries its own primary key.
+	*
+	* A delta's payload is not always a whole row: eager broadcasts forward the
+	* writer's payload verbatim, and the typed API omits the pk from what a
+	* client may write — so an eagerly-broadcast insert describes a row with no
+	* id in it. Rows are addressed by `rowId` everywhere in the protocol, so the
+	* key is never in doubt; only the materialized object was missing it, and
+	* `rows.map(r => r.id)` came back undefined.
+	*/
+	private withPk;
 	revertOp(opId: string, serverRow: Record<string, unknown> | null | undefined): void;
 	setTableMeta(meta: Record<string, {
 		serverSet: string[];
@@ -504,11 +515,15 @@ interface DrizzleTableLike {
 /**
 * Value supplied per serverSet field in the schema's object form.
 * Either a static value or a function that receives the request context.
+*
+* The static arm is enumerated rather than written as `unknown`: a union with
+* `unknown` collapses to `unknown`, which strips the contextual type from the
+* callback arm and makes every `(ctx) => …` an implicit `any` under `strict`.
 */
-type ServerSetSchemaValue = unknown | ((ctx: {
+type ServerSetSchemaValue = ((ctx: {
 	auth: unknown;
 	params: unknown;
-}) => unknown);
+}) => unknown) | string | number | bigint | boolean | symbol | null | undefined | Date | readonly unknown[] | Record<string, unknown>;
 /**
 * Schema-side `serverSet` declaration. Two shapes:
 *  - `string[]` — keys only; values are supplied at `implement(...)` time.
@@ -654,4 +669,4 @@ interface SyncVanillaHooks<TQueries extends SyncQueryMap> {
 	createSync: (config: VanillaSyncConfig) => TypedVanillaSync<TQueries>;
 }
 declare function createSyncVanilla<TQueries extends SyncQueryMap>(): SyncVanillaHooks<TQueries>;
-export { createSyncVanilla, createSync2 as createSync, createBrowserWsTransport, VanillaSyncConfig, VanillaSync, TypedVanillaSync, TableBinding, SyncVanillaHooks, EphemeralBinding };
+export { EphemeralBinding, SyncVanillaHooks, TableBinding, TypedVanillaSync, VanillaSync, VanillaSyncConfig, createBrowserWsTransport, createSync2 as createSync, createSyncVanilla };

package/dist/vanilla/index.js

@@ -1,10 +1,10 @@
 import {
   SyncClient,
   pushSafely
-} from "../shared/esm-ytrd3hbq.js";
+} from "../shared/esm-8qbr4y0d.js";
 import"../shared/esm-rw7jjtrv.js";
 import"../shared/esm-3tkwvysa.js";
-import"../shared/esm-b7xs9cde.js";
+import"../shared/esm-k7kedp3y.js";
 
 // src/vanilla/sync.ts
 function createBrowserWsTransport(url) {
@@ -184,20 +184,20 @@ function createSync(config) {
       }
     }
     const unsub = client.subscribeEphemeral(ephConfig.key, (event) => {
-      events = { ...events, [event.userId]: event.data };
+      events = { ...events, [event.clientId]: event.data };
       if (ephConfig.ttlMs) {
-        const existing = timers.get(event.userId);
+        const existing = timers.get(event.clientId);
         if (existing) {
           clearTimeout(existing);
         }
         const timer = setTimeout(() => {
           const next = { ...events };
-          delete next[event.userId];
+          delete next[event.clientId];
           events = next;
-          timers.delete(event.userId);
+          timers.delete(event.clientId);
           notifyChange();
         }, ephConfig.ttlMs);
-        timers.set(event.userId, timer);
+        timers.set(event.clientId, timer);
       }
       notifyChange();
     });
@@ -272,7 +272,7 @@ function createSyncVanilla() {
   };
 }
 export {
-  createSyncVanilla,
+  createBrowserWsTransport,
   createSync,
-  createBrowserWsTransport
+  createSyncVanilla
 };

package/package.json

@@ -1,70 +1,63 @@
 {
 	"name": "reflectdb",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Real-time sync engine for TypeScript — a server database and offline-first browser clients stay in sync, with optimistic writes and typed queries.",
 	"keywords": [
-		"sync",
-		"sync-engine",
-		"sync-server",
-		"data-sync",
-		"state-sync",
-		"real-time",
-		"realtime",
-		"replication",
-		"live-query",
-		"local-first",
-		"offline-first",
-		"offline",
-		"optimistic-updates",
+		"bun",
+		"collaborative",
+		"collaborative-editing",
 		"conflict-resolution",
-		"last-write-wins",
+		"data-sync",
+		"drizzle",
+		"drizzle-orm",
 		"eventual-consistency",
-		"hybrid-logical-clock",
 		"hlc",
-		"op-log",
-		"websocket",
-		"sse",
-		"server-sent-events",
+		"hybrid-logical-clock",
+		"indexeddb",
+		"kysely",
+		"last-write-wins",
+		"live-query",
+		"local-first",
 		"long-polling",
 		"multiplayer",
-		"collaborative",
-		"collaborative-editing",
+		"offline",
+		"offline-first",
+		"op-log",
+		"optimistic-updates",
+		"postgres",
 		"presence",
-		"typescript",
-		"type-safe",
 		"react",
 		"react-hooks",
-		"svelte",
-		"drizzle",
-		"drizzle-orm",
-		"kysely",
-		"indexeddb",
-		"postgres",
+		"real-time",
+		"realtime",
+		"replication",
+		"server-sent-events",
 		"sqlite",
-		"bun"
+		"sse",
+		"state-sync",
+		"svelte",
+		"sync",
+		"sync-engine",
+		"sync-server",
+		"type-safe",
+		"typescript",
+		"websocket"
 	],
 	"homepage": "https://github.com/TimMikeladze/reflectdb#readme",
 	"bugs": {
 		"url": "https://github.com/TimMikeladze/reflectdb/issues"
 	},
+	"license": "MIT",
+	"author": "Tim Mikeladze <tim.mikeladze@gmail.com> (https://github.com/TimMikeladze)",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/TimMikeladze/reflectdb.git"
 	},
 	"funding": "https://github.com/sponsors/TimMikeladze",
-	"license": "MIT",
-	"author": "Tim Mikeladze <tim.mikeladze@gmail.com> (https://github.com/TimMikeladze)",
-	"type": "module",
-	"sideEffects": false,
-	"engines": {
-		"node": ">=22"
-	},
 	"files": [
 		"dist"
 	],
-	"publishConfig": {
-		"access": "public"
-	},
+	"type": "module",
 	"main": "./dist/cjs/core/index.cjs",
 	"module": "./dist/core/index.js",
 	"types": "./dist/core/index.d.ts",
@@ -199,25 +192,50 @@
 				"default": "./dist/cjs/client/storage/indexeddb.cjs"
 			}
 		},
+		"./server/ephemeral": {
+			"import": {
+				"types": "./dist/server/ephemeral/index.d.ts",
+				"default": "./dist/server/ephemeral/index.js"
+			},
+			"require": {
+				"types": "./dist/cjs/server/ephemeral/index.d.cts",
+				"default": "./dist/cjs/server/ephemeral/index.cjs"
+			}
+		},
+		"./server/ephemeral/redis": {
+			"import": {
+				"types": "./dist/server/ephemeral/redis.d.ts",
+				"default": "./dist/server/ephemeral/redis.js"
+			},
+			"require": {
+				"types": "./dist/cjs/server/ephemeral/redis.d.cts",
+				"default": "./dist/cjs/server/ephemeral/redis.cjs"
+			}
+		},
 		"./package.json": "./package.json"
 	},
+	"publishConfig": {
+		"access": "public"
+	},
 	"scripts": {
-		"build": "bunup --filter esm && bunup --filter cjs",
+		"build": "NODE_ENV=production bunup --filter esm && NODE_ENV=production bunup --filter cjs && bun run verify:jsx",
 		"format": "oxfmt",
 		"lint": "oxlint",
 		"prepare": "bun simple-git-hooks",
 		"release": "bumpp --commit --push --tag",
 		"test": "bun test",
 		"test:coverage": "bun test --coverage",
-		"test:watch": "bun test --watch",
-		"test:ui": "bun test/ui/server.tsx",
 		"test:sync": "bun test/ui/test-sync.ts",
+		"test:ui": "bun test/ui/server.tsx",
+		"test:watch": "bun test --watch",
 		"type-check": "tsc --noEmit",
 		"verify:exports": "bun scripts/verify-exports.ts",
+		"verify:jsx": "bun scripts/verify-jsx.ts",
 		"verify:node": "bun scripts/verify-node-consumer.ts"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.10",
+		"@types/pg": "^8.21.0",
 		"@types/react": "^19.2.14",
 		"@types/react-dom": "^19.2.3",
 		"bumpp": "^10.4.1",
@@ -227,6 +245,7 @@
 		"kysely": "^0.28.12",
 		"oxfmt": "^0.36.0",
 		"oxlint": "^1.51.0",
+		"pg": "^8.23.0",
 		"react-dom": "^19.2.4",
 		"simple-git-hooks": "^2.13.1",
 		"typescript": "^5.9.3"
@@ -249,5 +268,8 @@
 	},
 	"simple-git-hooks": {
 		"pre-commit": "bun run lint && bun run type-check"
+	},
+	"engines": {
+		"node": ">=22"
 	}
 }