@sveltebase/sync 1.0.6 → 1.1.0

package/README.md

@@ -90,25 +90,23 @@ export const sync = new SyncClient<AppDatabaseSchema>({
     },
   },
 });
-
-// Export typed table wrapper
-export const todosTable = sync.table("todos");
 ```
 
-Use it in your Svelte 5 components:
+Use it in your Svelte 5 components (using your preferred Dexie reactivity hook, such as `liveQuery` from `dexie` or `dexie-svelte-query`):
 ```svelte
 <script lang="ts">
-  import { todosTable } from "$lib/sync-client";
+  import { sync } from "$lib/sync-client";
+  import { liveQuery } from "dexie";
   import { Check, Trash } from "lucide-svelte";
 
-  // Reactive liveQuery updates instantly on local mutations & remote syncs
-  const todos = todosTable.liveQuery((t) => t.orderBy("createdAt").reverse().toArray());
+  // Standard Dexie liveQuery updates instantly on mutations & remote syncs
+  const todos = liveQuery(() => sync.todos.orderBy("createdAt").reverse().toArray());
 
   let title = "";
 
   async function addTodo() {
     if (!title.trim()) return;
-    await todosTable.add({
+    await sync.todos.add({
       id: crypto.randomUUID(),
       title,
       completed: false,
@@ -121,21 +119,15 @@ Use it in your Svelte 5 components:
 
 <input bind:value={title} onkeydown={(e) => e.key === 'Enter' && addTodo()} />
 
-{#if todos.isLoading}
-  <div>Loading todos...</div>
-{:else if todos.status === "error"}
-  <div>Error loading database: {todos.error?.message || todos.error}</div>
-{:else}
-  {#each todos.data as todo (todo.id)}
-    <div>
-      <button onclick={() => todosTable.put(todo.id, { completed: !todo.completed })}>
-        <Check class={todo.completed ? "text-emerald-500" : ""} />
-      </button>
-      <span>{todo.title}</span>
-      <button onclick={() => todosTable.delete(todo.id)}><Trash /></button>
-    </div>
-  {/each}
-{/if}
+{#each ($todos || []) as todo (todo.id)}
+  <div>
+    <button onclick={() => sync.todos.update(todo.id, { completed: !todo.completed })}>
+      <Check class={todo.completed ? "text-emerald-500" : ""} />
+    </button>
+    <span>{todo.title}</span>
+    <button onclick={() => sync.todos.delete(todo.id)}><Trash /></button>
+  </div>
+{/each}
 ```
 
 ---
@@ -484,95 +476,8 @@ This approach keeps WebSocket URLs clean of private IDs and ensures all active s
 
 ---
 
-## 5. Developer Experience (DX) & Client Enhancements
-
-The package features several DX improvements to simplify real-world application building:
-
-### A. Reactive Connection Status
-You can track the WebSocket's connection state in Svelte 5 reactively using `sync.status`:
-```svelte
-<script lang="ts">
-  import { sync } from "$lib/sync-client";
-</script>
-
-{#if sync.status === "connecting"}
-  <p class="text-amber-500">Connecting to real-time engine...</p>
-{:else if sync.status === "disconnected"}
-  <p class="text-rose-500">Offline. Reconnecting...</p>
-{:else}
-  <p class="text-emerald-500">Connected and Synced</p>
-{/if}
-```
-
-### B. Manual Instant Reconnection
-To instantly reconnect when the browser detects it has regained network access, you can call `sync.reconnect()`:
-```typescript
-if (typeof window !== "undefined") {
-  window.addEventListener("online", () => {
-    sync.reconnect(); // Instantly reconnects without waiting for the 2-second backoff
-  });
-}
-```
-
-### C. Dynamic & Async Connection URLs (e.g., JWT Auth)
-You can configure `url` as a function (optionally returning a Promise) to retrieve a fresh URL or append parameters (like dynamic access tokens) on every reconnection attempt:
-```typescript
-export const sync = new SyncClient<AppDatabaseSchema>({
-  name: "sveltebase-sync",
-  url: async () => {
-    const token = await getFreshJWTToken();
-    return `/api/sync?token=${token}`;
-  },
-  tables: { ... }
-});
-```
-
-### D. Automatic Svelte 5 Parameter Reactivity
-`useLiveQuery` is built using Svelte 5 `$effect` under the hood. Any Svelte 5 `$state` or `$derived` variables referenced synchronously within the query function will automatically re-subscribe with the updated query boundaries when they change:
-```svelte
-<script lang="ts">
-  let queryTerm = $state("");
-  
-  // Re-subscribes and updates the live query automatically when `queryTerm` changes
-  const results = todosTable.liveQuery((t) => {
-    const term = queryTerm;
-    return t.where("title").startsWith(term).toArray();
-  });
-</script>
-```
-
-### E. Table Wrapper Utilities & Direct Dexie Access
-The `.table()` wrapper returns helpers to minimize boilerplate and exposes direct typed access to the underlying Dexie table:
-```typescript
-const todosTable = sync.table("todos");
-
-// 1. Get a single row directly (non-reactive Promise)
-const todo = await todosTable.get("todo-id");
-
-// 2. Fetch all rows as a live query
-const allTodos = todosTable.list();
+## 5. Type-Safe Backend Event Publishing (`createPublisher`)
 
-// 3. Direct access to the raw Dexie table for advanced queries
-const count = await todosTable.rawTable.count();
-const active = await todosTable.rawTable.where("completed").equals(0).toArray();
-```
-
-### F. Structured Zod Validation Rejections
-When Zod validations (`validate.create` or `validate.update`) fail on the server, the server returns a formatted validation error. The client-side Promise is rejected with an Error that contains a `.validationErrors` array:
-```typescript
-try {
-  await todosTable.add({ title: "" });
-} catch (err: any) {
-  if (err.validationErrors) {
-    // validationErrors = [{ path: "title", message: "Required" }]
-    console.error("Validation issues:", err.validationErrors);
-  } else {
-    console.error("General error:", err.message);
-  }
-}
-```
-
-### G. Type-Safe Backend Event Publishing (`createPublisher`)
 When publishing backend events (e.g. from standard API routes, message queues, or cron triggers) to push updates to connected clients, you can create a type-safe publisher matched to your application's database schema. This checks channels (including dynamic channel patterns like `"todos:user_123"`), actions, and payloads at compile-time:
 
 ```typescript
@@ -584,22 +489,25 @@ type AppSyncSchema = {
   todos: Todo;
 };
 
-// Create typed publisher instance
-const publisher = createPublisher<AppSyncSchema>();
+// Create typed publish function (Option A: Explicit Schema)
+const publish = createPublisher<AppSyncSchema>();
+
+// Create typed publish function (Option B: Automatically inferred from Sync Handlers)
+import { handlers } from "./lib/server/sync-handlers.js";
+const publish = createPublisher(handlers);
 
 // 1. Publish a create event (expects full Todo payload)
-await publisher.publish("todos", "create", todo.id, todo);
+await publish("todos", "create", todo.id, todo);
 
 // 2. Publish an update event (expects Partial<Todo> payload)
-await publisher.publish("todos", "update", todo.id, { completed: true });
+await publish("todos", "update", todo.id, { completed: true });
 
 // 3. Publish a delete event (expects optional { updatedAt: string } metadata)
-await publisher.publish("todos", "delete", todo.id, undefined);
+await publish("todos", "delete", todo.id, undefined);
 
 // 4. Supports scoped/dynamic channels (e.g. "channelName:scopeId")
-await publisher.publish("todos:user_123", "update", todo.id, { title: "New Title" });
+await publish("todos:user_123", "update", todo.id, { title: "New Title" });
 ```
 
 
 
-

package/dist/client/index.d.ts

@@ -1,6 +1,4 @@
 import Dexie, { type Table } from "dexie";
-import { useLiveQuery, type LiveQueryResult } from "./live.svelte.js";
-export { useLiveQuery, type LiveQueryResult };
 export type TableConfig = {
     indexes: string;
     channel: string;
@@ -10,8 +8,7 @@ export type SyncClientOptions = {
     url: string | (() => string | Promise<string>);
     tables: Record<string, TableConfig>;
 };
-export declare class SyncClient<TSchema extends Record<string, any> = Record<string, any>> {
-    db: Dexie;
+declare class SyncClientClass<TSchema extends Record<string, any> = Record<string, any>> extends Dexie {
     private wsUrl;
     private socket;
     private tableConfigs;
@@ -28,6 +25,7 @@ export declare class SyncClient<TSchema extends Record<string, any> = Record<str
         tables: Record<keyof TSchema & string, TableConfig>;
     });
     get status(): "connecting" | "connected" | "disconnected";
+    private decorateTables;
     private connect;
     reconnect(): void;
     private startHeartbeat;
@@ -38,16 +36,16 @@ export declare class SyncClient<TSchema extends Record<string, any> = Record<str
     private safeDeleteRow;
     private handleServerMessage;
     private findTableByChannel;
-    table<TKey extends keyof TSchema & string>(tableName: TKey): {
-        rawTable: Table<TSchema[TKey], string, TSchema[TKey]>;
-        liveQuery: <TResult = TSchema[TKey][]>(queryFn: (table: Table<TSchema[TKey], string>) => Promise<TResult> | TResult) => LiveQueryResult<TResult>;
-        list: () => LiveQueryResult<TSchema[TKey][]>;
-        get: (id: string) => Promise<TSchema[TKey] | undefined>;
-        add: (row: TSchema[TKey]) => Promise<TSchema[TKey]>;
-        put: (id: string, changes: Partial<TSchema[TKey]>) => Promise<TSchema[TKey]>;
-        delete: (id: string) => Promise<void>;
-    };
     private enqueueMutation;
     disconnect(): void;
 }
+export type SyncClient<TSchema extends Record<string, any> = Record<string, any>> = SyncClientClass<TSchema> & {
+    [K in keyof TSchema]: Table<TSchema[K]>;
+};
+export declare const SyncClient: new <TSchema extends Record<string, any> = Record<string, any>>(options: {
+    name: string;
+    url: string | (() => string | Promise<string>);
+    tables: Record<keyof TSchema & string, TableConfig>;
+}) => SyncClient<TSchema>;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC,CAAC;AAaF,qBAAa,UAAU,CACrB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAElD,EAAE,EAAE,KAAK,CAAC;IACjB,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,OAAO,CAAqE;IAGpF,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,OAAO,CAAC,aAAa,CAMb;gBAEI,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;KACrD;IAiBD,IAAW,MAAM,gDAEhB;YAEa,OAAO;IAuFd,SAAS;IAgBhB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;YAOP,kBAAkB;IAoBhC,OAAO,CAAC,kBAAkB;YAkBZ,UAAU;YAgBV,aAAa;YAoBb,mBAAmB;IAwEjC,OAAO,CAAC,kBAAkB;IAOnB,KAAK,CAAC,IAAI,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI;;oBAWjD,OAAO,6BACR,CAAC,KAAK,EAAE,KAAK,gBAAO,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;oBAK3D,eAAe,CAAC,eAAM,CAAC;kBAIjB,MAAM,KAAG,OAAO,CAAC,gBAAO,SAAS,CAAC;qCAI1B,OAAO,eAAM;kBAsBrB,MAAM,WAAW,OAAO,eAAM,KAAG,OAAO,eAAM;qBAyB3C,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;;IAuB7C,OAAO,CAAC,eAAe;IAqChB,UAAU;CAelB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAwB,MAAM,OAAO,CAAC;AAGhE,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC,CAAC;AAaF,cAAM,eAAe,CACnB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACzD,SAAQ,KAAK;IACb,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,OAAO,CAAqE;IAGpF,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,OAAO,CAAC,aAAa,CAMb;gBAEI,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;KACrD;IAoBD,IAAW,MAAM,gDAEhB;IAED,OAAO,CAAC,cAAc;YAiJR,OAAO;IAuFd,SAAS;IAgBhB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;YAOP,kBAAkB;IAoBhC,OAAO,CAAC,kBAAkB;YAkBZ,UAAU;YAiBV,aAAa;YAqBb,mBAAmB;IAwEjC,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,eAAe;IAqChB,UAAU;CAelB;AAED,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG;KAC5G,CAAC,IAAI,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KACvB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,OAAO,EAAE;IACT,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;CACrD,KAAK,UAAU,CAAC,OAAO,CAA0B,CAAC"}

package/dist/client/index.js

@@ -1,9 +1,6 @@
 import Dexie, {} from "dexie";
 import { parseSyncMessage } from "../protocol.js";
-import { useLiveQuery } from "./live.svelte.js";
-export { useLiveQuery };
-export class SyncClient {
-    db;
+class SyncClientClass extends Dexie {
     wsUrl;
     socket;
     tableConfigs;
@@ -18,15 +15,17 @@ export class SyncClient {
     // Mutations queued to be sent when connection is established
     mutationQueue = [];
     constructor(options) {
+        super(options.name);
         this.wsUrl = options.url;
         this.tableConfigs = options.tables;
         // Initialize Dexie database
-        this.db = new Dexie(options.name);
         const schema = {};
         for (const [tableName, config] of Object.entries(options.tables)) {
             schema[tableName] = config.indexes;
         }
-        this.db.version(1).stores(schema);
+        this.version(1).stores(schema);
+        // Decorate tables to intercept native Dexie write operations
+        this.decorateTables();
         if (typeof window !== "undefined") {
             this.connect();
         }
@@ -34,6 +33,96 @@ export class SyncClient {
     get status() {
         return this._status;
     }
+    decorateTables() {
+        for (const [tableName, config] of Object.entries(this.tableConfigs)) {
+            const table = this.table(tableName);
+            const originalAdd = table.add.bind(table);
+            const originalPut = table.put.bind(table);
+            const originalUpdate = table.update.bind(table);
+            const originalDelete = table.delete.bind(table);
+            // Save original methods to bypass sync trigger loops when updating from WebSocket
+            table._originalMethods = {
+                add: originalAdd,
+                put: originalPut,
+                update: originalUpdate,
+                delete: originalDelete,
+            };
+            table.add = (async (row) => {
+                const id = row.id || crypto.randomUUID();
+                const fullRow = { ...row, id };
+                const rollback = async () => {
+                    await originalDelete(id);
+                };
+                await originalAdd(fullRow);
+                return this.enqueueMutation(config.channel, "create", id, fullRow, rollback);
+            });
+            table.put = (async (rowOrId, changes) => {
+                // Overload 1: put(id, changes) - Partial Update
+                if (changes !== undefined) {
+                    const id = rowOrId;
+                    const existing = await table.get(id);
+                    if (!existing) {
+                        throw new Error(`Cannot update item ${id}: not found locally.`);
+                    }
+                    const rollback = async () => {
+                        await originalPut(existing);
+                    };
+                    const updatedRow = { ...existing, ...changes };
+                    await originalPut(updatedRow);
+                    const diff = {};
+                    for (const [k, v] of Object.entries(changes)) {
+                        if (existing[k] !== v) {
+                            diff[k] = v;
+                        }
+                    }
+                    return this.enqueueMutation(config.channel, "update", id, diff, rollback);
+                }
+                // Overload 2: put(row) - Insert/Replace
+                const row = rowOrId;
+                const id = row.id;
+                if (!id) {
+                    throw new Error("put operation requires an inline 'id' property.");
+                }
+                const existing = await table.get(id);
+                if (!existing) {
+                    return table.add(row);
+                }
+                const rollback = async () => {
+                    await originalPut(existing);
+                };
+                const updatedRow = { ...existing, ...row };
+                await originalPut(updatedRow);
+                const diff = {};
+                for (const [k, v] of Object.entries(row)) {
+                    if (existing[k] !== v) {
+                        diff[k] = v;
+                    }
+                }
+                return this.enqueueMutation(config.channel, "update", id, diff, rollback);
+            });
+            table.update = (async (id, changes) => {
+                const existing = await table.get(id);
+                if (!existing) {
+                    throw new Error(`Cannot update item ${id}: not found locally.`);
+                }
+                const rollback = async () => {
+                    await originalPut(existing);
+                };
+                await originalUpdate(id, changes);
+                return this.enqueueMutation(config.channel, "update", id, changes, rollback);
+            });
+            table.delete = (async (id) => {
+                const existing = await table.get(id);
+                if (!existing)
+                    return;
+                const rollback = async () => {
+                    await originalPut(existing);
+                };
+                await originalDelete(id);
+                return this.enqueueMutation(config.channel, "delete", id, undefined, rollback);
+            });
+        }
+    }
     async connect() {
         if (this.closedByClient)
             return;
@@ -146,7 +235,7 @@ export class SyncClient {
             let since;
             if (tableName) {
                 try {
-                    const table = this.db.table(tableName);
+                    const table = this.table(tableName);
                     const latestRow = await table.orderBy("updatedAt").last();
                     if (latestRow && latestRow.updatedAt) {
                         since = latestRow.updatedAt;
@@ -176,7 +265,7 @@ export class SyncClient {
         }
     }
     async safePutRow(tableName, data) {
-        const table = this.db.table(tableName);
+        const table = this.table(tableName);
         if (!data || !data.id)
             return;
         const existing = await table.get(data.id);
@@ -188,10 +277,11 @@ export class SyncClient {
                 return;
             }
         }
-        await table.put(data);
+        const originalPut = table._originalMethods?.put || table.put.bind(table);
+        await originalPut(data);
     }
     async safeDeleteRow(tableName, key, incomingTimeStr) {
-        const table = this.db.table(tableName);
+        const table = this.table(tableName);
         if (incomingTimeStr) {
             const existing = await table.get(key);
             if (existing && existing.updatedAt) {
@@ -203,14 +293,15 @@ export class SyncClient {
                 }
             }
         }
-        await table.delete(key);
+        const originalDelete = table._originalMethods?.delete || table.delete.bind(table);
+        await originalDelete(key);
     }
     async handleServerMessage(msg) {
         switch (msg.type) {
             case "snapshot": {
                 const tableName = this.findTableByChannel(msg.channel);
                 if (tableName) {
-                    const table = this.db.table(tableName);
+                    const table = this.table(tableName);
                     if (msg.isDelta) {
                         // Delta Sync: put changes using Last-Write-Wins
                         for (const row of msg.data) {
@@ -219,7 +310,7 @@ export class SyncClient {
                     }
                     else {
                         // Full Snapshot: clear and replace
-                        await this.db.transaction("rw", table, async () => {
+                        await this.transaction("rw", table, async () => {
                             await table.clear();
                             await table.bulkPut(msg.data);
                         });
@@ -282,63 +373,6 @@ export class SyncClient {
         }
         return undefined;
     }
-    table(tableName) {
-        const dexieTable = this.db.table(tableName);
-        const config = this.tableConfigs[tableName];
-        if (!config) {
-            throw new Error(`Table ${tableName} not defined in SyncClient config.`);
-        }
-        return {
-            rawTable: dexieTable,
-            liveQuery: (queryFn) => {
-                return useLiveQuery(() => queryFn(dexieTable));
-            },
-            list: () => {
-                return useLiveQuery(() => dexieTable.toArray());
-            },
-            get: async (id) => {
-                return dexieTable.get(id);
-            },
-            add: async (row) => {
-                const rowData = row;
-                const id = rowData.id || crypto.randomUUID();
-                const fullRow = { ...rowData, id };
-                // Rollback function
-                const rollback = async () => {
-                    await dexieTable.delete(id);
-                };
-                // Apply optimistic update
-                await dexieTable.put(fullRow);
-                return this.enqueueMutation(config.channel, "create", id, fullRow, rollback);
-            },
-            put: async (id, changes) => {
-                const existing = await dexieTable.get(id);
-                if (!existing) {
-                    throw new Error(`Cannot update item ${id}: not found locally.`);
-                }
-                // Rollback function
-                const rollback = async () => {
-                    await dexieTable.put(existing);
-                };
-                const updatedRow = { ...existing, ...changes };
-                // Apply optimistic update
-                await dexieTable.put(updatedRow);
-                return this.enqueueMutation(config.channel, "update", id, changes, rollback);
-            },
-            delete: async (id) => {
-                const existing = await dexieTable.get(id);
-                if (!existing)
-                    return; // Already deleted
-                // Rollback function
-                const rollback = async () => {
-                    await dexieTable.put(existing);
-                };
-                // Apply optimistic update
-                await dexieTable.delete(id);
-                return this.enqueueMutation(config.channel, "delete", id, undefined, rollback);
-            },
-        };
-    }
     enqueueMutation(channel, action, key, data, rollback) {
         const mutationId = crypto.randomUUID();
         return new Promise((resolve, reject) => {
@@ -384,3 +418,4 @@ export class SyncClient {
         }
     }
 }
+export const SyncClient = SyncClientClass;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { SyncClient, useLiveQuery } from "./client/index.js";
+export { SyncClient } from "./client/index.js";
 export { defineSync } from "./server/index.js";
 export { handleUpgrade, publishEvent, createPublisher } from "./server/handler.js";
-export type { PublishEventData } from "./server/handler.js";
+export type { PublishEventData, InferSchemaFromHandlers } from "./server/handler.js";
 export type { SyncContext, SyncHandler } from "./server/index.js";
 export type { SyncMessage } from "./protocol.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACrF,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { SyncClient, useLiveQuery } from "./client/index.js";
+export { SyncClient } from "./client/index.js";
 export { defineSync } from "./server/index.js";
 export { handleUpgrade, publishEvent, createPublisher } from "./server/handler.js";

package/dist/server/broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/server/broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,GAAG,CAAC;IACf,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,mBAAmB,CAAC,CAGV;gBAGhB,QAAQ,EAAE,WAAW,EAAE,EACvB,mBAAmB,CAAC,EAAE,CACpB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,KAC/B,OAAO,CAAC,GAAG,CAAC;IAOZ,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE;IAanC,kBAAkB,CAAC,IAAI,EAAE,eAAe;IAIxC,gBAAgB,CAAC,IAAI,EAAE,eAAe;IAI7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCN,aAAa,CACxB,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO;YAuJJ,eAAe;IAoDhB,oBAAoB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG;CAoBZ"}
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/server/broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,GAAG,CAAC;IACf,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,mBAAmB,CAAC,CAGV;gBAGhB,QAAQ,EAAE,WAAW,EAAE,EACvB,mBAAmB,CAAC,EAAE,CACpB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,KAC/B,OAAO,CAAC,GAAG,CAAC;IAOZ,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE;IAanC,kBAAkB,CAAC,IAAI,EAAE,eAAe;IAIxC,gBAAgB,CAAC,IAAI,EAAE,eAAe;IAI7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCN,aAAa,CACxB,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO;YA0IJ,eAAe;IAoDhB,oBAAoB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG;CAoBZ"}

package/dist/server/broker.js

@@ -160,21 +160,10 @@ export class SyncBroker {
         catch (err) {
             console.error(`SyncBroker: error handling message type=${msg.type}:`, err);
             if (msg.type === "mutate") {
-                let errorMessage = err.message || "Server error";
-                let validationErrors = undefined;
-                // Formats Zod validation errors for structured client rejection
-                if (err && err.name === "ZodError" && Array.isArray(err.issues)) {
-                    validationErrors = err.issues.map((issue) => ({
-                        path: issue.path.join("."),
-                        message: issue.message,
-                    }));
-                    errorMessage = `Validation failed: ${err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ")}`;
-                }
                 conn.send(JSON.stringify({
                     type: "reject",
                     id: msg.id,
-                    error: errorMessage,
-                    validationErrors,
+                    error: err.message || "Server error",
                 }));
             }
         }

package/dist/server/handler.d.ts

@@ -1,9 +1,12 @@
+import type { SyncHandler } from "./index.js";
 export type PublishEventData<TRecord, TAction extends "create" | "update" | "delete"> = TAction extends "create" ? TRecord : TAction extends "update" ? Partial<TRecord> : {
     updatedAt?: string;
 } | undefined;
-export declare function createPublisher<TSchema extends Record<string, any>>(): {
-    publish: <TChannel extends keyof TSchema & string, TAction extends "create" | "update" | "delete">(channel: TChannel | `${TChannel}:${string}`, action: TAction, key: string | undefined, data: PublishEventData<TSchema[TChannel], TAction>) => Promise<void>;
+export type InferSchemaFromHandlers<T extends SyncHandler[]> = {
+    [K in T[number] as K["config"]["channel"] extends string ? K["config"]["channel"] : K["config"]["channel"] extends (...args: any[]) => infer R ? R extends string ? R : string : string]: K extends SyncHandler<infer TRow> ? TRow : never;
 };
+export declare function createPublisher<TSchema extends Record<string, any>>(): <TChannel extends keyof TSchema & string, TAction extends "create" | "update" | "delete">(channel: TChannel | `${TChannel}:${string}`, action: TAction, key: string | undefined, data: PublishEventData<TSchema[TChannel], TAction>) => Promise<void>;
+export declare function createPublisher<THandlers extends SyncHandler[]>(handlers: THandlers): <TChannel extends keyof InferSchemaFromHandlers<THandlers> & string, TAction extends "create" | "update" | "delete">(channel: TChannel | `${TChannel}:${string}`, action: TAction, key: string | undefined, data: PublishEventData<InferSchemaFromHandlers<THandlers>[TChannel], TAction>) => Promise<void>;
 export declare function publishEvent(channel: string, action: "create" | "update" | "delete", key: string | undefined, data: any): Promise<void>;
 export declare function handleUpgrade(request: Request, platform: App.Platform | undefined): Promise<Response>;
 //# sourceMappingURL=handler.d.ts.map

package/dist/server/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/server/handler.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAClF,OAAO,SAAS,QAAQ,GACpB,OAAO,GACP,OAAO,SAAS,QAAQ,GACtB,OAAO,CAAC,OAAO,CAAC,GAChB;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAE3C,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;cAG7D,QAAQ,SAAS,MAAM,OAAO,GAAG,MAAM,EACvC,OAAO,SAAS,QAAQ,GAAG,QAAQ,GAAG,QAAQ,WAErC,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,UACnC,OAAO,OACV,MAAM,GAAG,SAAS,QACjB,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,KACjD,OAAO,CAAC,IAAI,CAAC;EAKnB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG,iBAgCV;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,GACjC,OAAO,CAAC,QAAQ,CAAC,CAqBnB"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/server/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAClF,OAAO,SAAS,QAAQ,GACpB,OAAO,GACP,OAAO,SAAS,QAAQ,GACtB,OAAO,CAAC,OAAO,CAAC,GAChB;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAE3C,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI;KAC5D,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,GACpD,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,GACtB,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACxD,CAAC,SAAS,MAAM,GACd,CAAC,GACD,MAAM,GACR,MAAM,GAAG,CAAC,SAAS,WAAW,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK;CAChE,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CACtE,QAAQ,SAAS,MAAM,OAAO,GAAG,MAAM,EACvC,OAAO,SAAS,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAE9C,OAAO,EAAE,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,EAC3C,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,KAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,wBAAgB,eAAe,CAAC,SAAS,SAAS,WAAW,EAAE,EAC7D,QAAQ,EAAE,SAAS,GAClB,CACD,QAAQ,SAAS,MAAM,uBAAuB,CAAC,SAAS,CAAC,GAAG,MAAM,EAClE,OAAO,SAAS,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAE9C,OAAO,EAAE,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,EAC3C,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,KAC1E,OAAO,CAAC,IAAI,CAAC,CAAC;AAcnB,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG,iBAgCV;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,GACjC,OAAO,CAAC,QAAQ,CAAC,CAqBnB"}

package/dist/server/handler.js

@@ -1,9 +1,7 @@
-export function createPublisher() {
-    return {
-        publish: async (channel, action, key, data) => {
-            const resolvedChannel = String(channel);
-            return publishEvent(resolvedChannel, action, key, data);
-        },
+export function createPublisher(handlers) {
+    return async (channel, action, key, data) => {
+        const resolvedChannel = String(channel);
+        return publishEvent(resolvedChannel, action, key, data);
     };
 }
 export async function publishEvent(channel, action, key, data) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sveltebase/sync",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/dist/client/live.svelte.d.ts

@@ -1,18 +0,0 @@
-export type LiveQueryResult<T> = {
-    status: "loading";
-    data: undefined;
-    error: undefined;
-    isLoading: true;
-} | {
-    status: "success";
-    data: T;
-    error: undefined;
-    isLoading: false;
-} | {
-    status: "error";
-    data: undefined;
-    error: any;
-    isLoading: false;
-};
-export declare function useLiveQuery<T>(queryFn: () => Promise<T> | T): LiveQueryResult<T>;
-//# sourceMappingURL=live.svelte.d.ts.map

package/dist/client/live.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"live.svelte.d.ts","sourceRoot":"","sources":["../../src/client/live.svelte.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GACzE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,KAAK,CAAA;CAAE,GAClE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CA0CjF"}

package/dist/client/live.svelte.js

@@ -1,41 +0,0 @@
-import { liveQuery } from "dexie";
-export function useLiveQuery(queryFn) {
-    let data = $state(undefined);
-    let error = $state(undefined);
-    let status = $state("loading");
-    if (typeof window !== "undefined") {
-        $effect(() => {
-            const observable = liveQuery(queryFn);
-            const subscription = observable.subscribe({
-                next: (val) => {
-                    data = val;
-                    error = undefined;
-                    status = "success";
-                },
-                error: (err) => {
-                    data = undefined;
-                    error = err;
-                    status = "error";
-                    console.error("liveQuery error:", err);
-                },
-            });
-            return () => {
-                subscription.unsubscribe();
-            };
-        });
-    }
-    return {
-        get data() {
-            return data;
-        },
-        get error() {
-            return error;
-        },
-        get status() {
-            return status;
-        },
-        get isLoading() {
-            return status === "loading";
-        },
-    };
-}