@sveltebase/sync 1.0.3 → 1.0.5

package/README.md

@@ -482,4 +482,95 @@ export const GET: RequestHandler = (event: RequestEvent) => {
 ```
 This approach keeps WebSocket URLs clean of private IDs and ensures all active sockets are automatically authenticated with their verified session roles/IDs.
 
+---
+
+## 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();
+
+// 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);
+  }
+}
+```
+
+
 

package/dist/client/index.d.ts

@@ -7,7 +7,7 @@ export type TableConfig = {
 };
 export type SyncClientOptions = {
     name: string;
-    url: string;
+    url: string | (() => string | Promise<string>);
     tables: Record<string, TableConfig>;
 };
 export declare class SyncClient<TSchema extends Record<string, any> = Record<string, any>> {
@@ -19,14 +19,17 @@ export declare class SyncClient<TSchema extends Record<string, any> = Record<str
     private pingInterval;
     private closedByClient;
     private activeChannels;
+    private _status;
     private pendingMutations;
     private mutationQueue;
     constructor(options: {
         name: string;
-        url: string;
+        url: string | (() => string | Promise<string>);
         tables: Record<keyof TSchema & string, TableConfig>;
     });
+    get status(): "connecting" | "connected" | "disconnected";
     private connect;
+    reconnect(): void;
     private startHeartbeat;
     private stopHeartbeat;
     private subscribeToChannel;
@@ -36,7 +39,10 @@ export declare class SyncClient<TSchema extends Record<string, any> = Record<str
     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>;

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,CAAC;IACZ,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,CAAS;IACtB,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,gBAAgB,CAAsC;IAE9D,OAAO,CAAC,aAAa,CAMb;gBAEI,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;KACrD;IAiBD,OAAO,CAAC,OAAO;IA+Df,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;YAOP,kBAAkB;IAoBhC,OAAO,CAAC,kBAAkB;YAkBZ,UAAU;YAgBV,aAAa;YAoBb,mBAAmB;IAkEjC,OAAO,CAAC,kBAAkB;IAOnB,KAAK,CAAC,IAAI,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI;oBASjD,OAAO,6BACR,CAAC,KAAK,EAAE,KAAK,gBAAO,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;qCAK7C,OAAO,eAAM;kBAsBrB,MAAM,WAAW,OAAO,eAAM,KAAG,OAAO,eAAM;qBAyB3C,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;;IAuB7C,OAAO,CAAC,eAAe;IAqChB,UAAU;CAYlB"}
+{"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"}

package/dist/client/index.js

@@ -11,6 +11,8 @@ export class SyncClient {
     pingInterval;
     closedByClient = false;
     activeChannels = new Set();
+    // Reactive connection status
+    _status = $state("connecting");
     // Mutations waiting for ack/reject from server
     pendingMutations = new Map();
     // Mutations queued to be sent when connection is established
@@ -29,17 +31,37 @@ export class SyncClient {
             this.connect();
         }
     }
-    connect() {
+    get status() {
+        return this._status;
+    }
+    async connect() {
         if (this.closedByClient)
             return;
+        this._status = "connecting";
         const protocol = window.location.protocol === "https:" ? "wss:" : "ws:";
         const host = window.location.host;
-        const fullUrl = this.wsUrl.startsWith("ws://") || this.wsUrl.startsWith("wss://")
-            ? this.wsUrl
-            : `${protocol}//${host}${this.wsUrl}`;
-        this.socket = new WebSocket(fullUrl);
-        this.socket.addEventListener("open", async () => {
+        let resolvedUrl;
+        try {
+            resolvedUrl = typeof this.wsUrl === "function" ? await this.wsUrl() : this.wsUrl;
+        }
+        catch (err) {
+            console.error("SyncClient: Failed to resolve wsUrl", err);
+            this._status = "disconnected";
+            if (!this.closedByClient) {
+                this.reconnectTimer = setTimeout(() => this.connect(), 2000);
+            }
+            return;
+        }
+        const fullUrl = resolvedUrl.startsWith("ws://") || resolvedUrl.startsWith("wss://")
+            ? resolvedUrl
+            : `${protocol}//${host}${resolvedUrl}`;
+        const socket = new WebSocket(fullUrl);
+        this.socket = socket;
+        socket.addEventListener("open", async () => {
+            if (this.socket !== socket)
+                return;
             console.log("SyncClient: WebSocket connected");
+            this._status = "connected";
             this.activeChannels.clear();
             this.startHeartbeat();
             // Re-subscribe to all tables (delta-sync aware)
@@ -48,7 +70,7 @@ export class SyncClient {
             }
             // Re-send all pending unacknowledged mutations
             for (const mut of this.pendingMutations.values()) {
-                this.socket?.send(JSON.stringify({
+                socket.send(JSON.stringify({
                     type: "mutate",
                     id: mut.id,
                     channel: mut.channel,
@@ -60,7 +82,9 @@ export class SyncClient {
             // Flush queued mutations
             this.flushMutationQueue();
         });
-        this.socket.addEventListener("message", async (message) => {
+        socket.addEventListener("message", async (message) => {
+            if (this.socket !== socket)
+                return;
             if (typeof message.data !== "string")
                 return;
             if (message.data === "pong")
@@ -70,17 +94,38 @@ export class SyncClient {
                 return;
             await this.handleServerMessage(msg);
         });
-        this.socket.addEventListener("close", () => {
-            this.socket = undefined;
-            this.stopHeartbeat();
-            if (!this.closedByClient) {
-                this.reconnectTimer = setTimeout(() => this.connect(), 2000);
+        socket.addEventListener("close", () => {
+            if (this.socket === socket) {
+                this.socket = undefined;
+                this._status = "disconnected";
+                this.stopHeartbeat();
+                if (!this.closedByClient) {
+                    this.reconnectTimer = setTimeout(() => this.connect(), 2000);
+                }
             }
         });
-        this.socket.addEventListener("error", (err) => {
-            console.error("SyncClient: WebSocket error", err);
+        socket.addEventListener("error", (err) => {
+            if (this.socket === socket) {
+                console.error("SyncClient: WebSocket error", err);
+            }
         });
     }
+    reconnect() {
+        this.closedByClient = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.socket) {
+            try {
+                this.socket.close();
+            }
+            catch { }
+            this.socket = undefined;
+            this._status = "disconnected";
+        }
+        this.connect();
+    }
     startHeartbeat() {
         this.stopHeartbeat();
         this.pingInterval = setInterval(() => {
@@ -202,7 +247,11 @@ export class SyncClient {
                 if (pending) {
                     console.warn(`Mutation ${msg.id} rejected by server: ${msg.error}`);
                     await pending.rollback();
-                    pending.reject(new Error(msg.error));
+                    const errorObj = new Error(msg.error);
+                    if (msg.validationErrors) {
+                        errorObj.validationErrors = msg.validationErrors;
+                    }
+                    pending.reject(errorObj);
                     this.pendingMutations.delete(msg.id);
                 }
                 break;
@@ -240,9 +289,16 @@ export class SyncClient {
             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();
@@ -313,13 +369,17 @@ export class SyncClient {
     }
     disconnect() {
         this.closedByClient = true;
+        this._status = "disconnected";
         this.stopHeartbeat();
         if (this.reconnectTimer) {
             clearTimeout(this.reconnectTimer);
             this.reconnectTimer = undefined;
         }
         if (this.socket) {
-            this.socket.close();
+            try {
+                this.socket.close();
+            }
+            catch { }
             this.socket = undefined;
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"live.svelte.d.ts","sourceRoot":"","sources":["../../src/client/live.svelte.ts"],"names":[],"mappings":"AAGA,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,CAuCjF"}
+{"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,26 +1,27 @@
-import { onDestroy } from "svelte";
 import { liveQuery } from "dexie";
 export function useLiveQuery(queryFn) {
     let data = $state(undefined);
     let error = $state(undefined);
     let status = $state("loading");
     if (typeof window !== "undefined") {
-        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);
-            },
-        });
-        onDestroy(() => {
-            subscription.unsubscribe();
+        $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 {

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;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"}
+{"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"}

package/dist/server/broker.js

@@ -160,10 +160,21 @@ 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: err.message || "Server error",
+                    error: errorMessage,
+                    validationErrors,
                 }));
             }
         }

package/package.json

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