@sveltebase/sync 1.0.5 → 1.0.7

package/README.md

@@ -484,92 +484,37 @@ This approach keeps WebSocket URLs clean of private IDs and ensures all active s
 
 ---
 
-## 5. Developer Experience (DX) & Client Enhancements
+## 5. Type-Safe Backend Event Publishing (`createPublisher`)
 
-The package features several DX improvements to simplify real-world application building:
+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:
 
-### 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
-  });
-}
-```
+import { createPublisher } from "@sveltebase/sync";
+import type { Todo } from "$lib/server/db/schema";
 
-### 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: { ... }
-});
-```
+// Define schema matching channel names to model types
+type AppSyncSchema = {
+  todos: Todo;
+};
 
-### 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>
-```
+// Create typed publish function (Option A: Explicit Schema)
+const publish = createPublisher<AppSyncSchema>();
 
-### 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");
+// Create typed publish function (Option B: Automatically inferred from Sync Handlers)
+import { handlers } from "./lib/server/sync-handlers.js";
+const publish = createPublisher(handlers);
 
-// 1. Get a single row directly (non-reactive Promise)
-const todo = await todosTable.get("todo-id");
+// 1. Publish a create event (expects full Todo payload)
+await publish("todos", "create", todo.id, todo);
 
-// 2. Fetch all rows as a live query
-const allTodos = todosTable.list();
+// 2. Publish an update event (expects Partial<Todo> payload)
+await publish("todos", "update", todo.id, { completed: true });
 
-// 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();
-```
+// 3. Publish a delete event (expects optional { updatedAt: string } metadata)
+await publish("todos", "delete", todo.id, undefined);
 
-### 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);
-  }
-}
+// 4. Supports scoped/dynamic channels (e.g. "channelName:scopeId")
+await publish("todos:user_123", "update", todo.id, { title: "New Title" });
 ```
 
 

package/dist/client/index.d.ts

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

package/dist/client/index.js

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

package/dist/client/live.svelte.js

@@ -1,27 +1,26 @@
+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") {
-        $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();
-            };
+        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();
         });
     }
     return {

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { SyncClient, useLiveQuery } from "./client/index.js";
 export { defineSync } from "./server/index.js";
-export { handleUpgrade, publishEvent } from "./server/handler.js";
+export { handleUpgrade, publishEvent, createPublisher } 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,MAAM,qBAAqB,CAAC;AAClE,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,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,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 { defineSync } from "./server/index.js";
-export { handleUpgrade, publishEvent } from "./server/handler.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,3 +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 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,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,3 +1,9 @@
+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) {
     const envId = "$app/environment";
     let isDev = false;

package/package.json

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