@livestore/sync-cf 0.4.0-dev.0 → 0.4.0-dev.10

package/dist/common/http-rpc-schema.d.ts

@@ -0,0 +1,58 @@
+import { InvalidPullError, InvalidPushError, UnexpectedError } from '@livestore/common';
+import { Rpc, RpcGroup, Schema } from '@livestore/utils/effect';
+declare const SyncHttpRpc_base: RpcGroup.RpcGroup<Rpc.Rpc<"SyncHttpRpc.Pull", Schema.Struct<{
+    cursor: Schema.Option<Schema.Struct<{
+        backendId: Schema.SchemaClass<string, string, never>;
+        eventSequenceNumber: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+    }>>;
+    storeId: typeof Schema.String;
+    payload: Schema.optional<Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>;
+}>, import("@effect/rpc/RpcSchema").Stream<Schema.Struct<{
+    batch: Schema.Array$<Schema.Struct<{
+        eventEncoded: Schema.Struct<{
+            name: typeof Schema.String;
+            args: typeof Schema.Any;
+            seqNum: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+            parentSeqNum: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+            clientId: typeof Schema.String;
+            sessionId: typeof Schema.String;
+        }>;
+        metadata: Schema.Option<Schema.Struct<{
+            _tag: Schema.tag<"SyncMessage.SyncMetadata">;
+        } & {
+            createdAt: typeof Schema.String;
+        }>>;
+    }>>;
+    pageInfo: Schema.Union<[Schema.TaggedStruct<"MoreUnknown", {}>, Schema.TaggedStruct<"MoreKnown", {
+        remaining: typeof Schema.Number;
+    }>, Schema.TaggedStruct<"NoMore", {}>]>;
+    backendId: Schema.SchemaClass<string, string, never>;
+}>, typeof InvalidPullError>, typeof Schema.Never, never> | Rpc.Rpc<"SyncHttpRpc.Push", Schema.Struct<{
+    batch: Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        args: typeof Schema.Any;
+        seqNum: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+        parentSeqNum: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+        clientId: typeof Schema.String;
+        sessionId: typeof Schema.String;
+    }>>;
+    backendId: Schema.Option<Schema.SchemaClass<string, string, never>>;
+    storeId: typeof Schema.String;
+    payload: Schema.optional<Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>;
+}>, Schema.Struct<{}>, typeof InvalidPushError, never> | Rpc.Rpc<"SyncHttpRpc.Ping", Schema.Struct<{
+    storeId: typeof Schema.String;
+    payload: Schema.optional<Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>;
+}>, Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.Pong">;
+}>, typeof UnexpectedError, never>>;
+/**
+ * HTTP RPC Schema for LiveStore CF Sync Provider
+ *
+ * This defines the RPC endpoints available over HTTP transport.
+ * Unlike WebSocket transport which maintains persistent connections,
+ * HTTP transport uses request/response patterns for each operation.
+ */
+export declare class SyncHttpRpc extends SyncHttpRpc_base {
+}
+export {};
+//# sourceMappingURL=http-rpc-schema.d.ts.map

package/dist/common/http-rpc-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-rpc-schema.d.ts","sourceRoot":"","sources":["../../src/common/http-rpc-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAG/D;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,gBA4BhC;CAAG"}

package/dist/common/http-rpc-schema.js

@@ -0,0 +1,37 @@
+import { InvalidPullError, InvalidPushError, UnexpectedError } from '@livestore/common';
+import { Rpc, RpcGroup, Schema } from '@livestore/utils/effect';
+import * as SyncMessage from "./sync-message-types.js";
+/**
+ * HTTP RPC Schema for LiveStore CF Sync Provider
+ *
+ * This defines the RPC endpoints available over HTTP transport.
+ * Unlike WebSocket transport which maintains persistent connections,
+ * HTTP transport uses request/response patterns for each operation.
+ */
+export class SyncHttpRpc extends RpcGroup.make(Rpc.make('SyncHttpRpc.Pull', {
+    payload: Schema.Struct({
+        storeId: Schema.String,
+        payload: Schema.optional(Schema.JsonValue),
+        ...SyncMessage.PullRequest.fields,
+    }),
+    success: SyncMessage.PullResponse,
+    error: InvalidPullError,
+    stream: true,
+}), Rpc.make('SyncHttpRpc.Push', {
+    payload: Schema.Struct({
+        storeId: Schema.String,
+        payload: Schema.optional(Schema.JsonValue),
+        ...SyncMessage.PushRequest.fields,
+    }),
+    success: SyncMessage.PushAck,
+    error: InvalidPushError,
+}), Rpc.make('SyncHttpRpc.Ping', {
+    payload: Schema.Struct({
+        storeId: Schema.String,
+        payload: Schema.optional(Schema.JsonValue),
+    }),
+    success: SyncMessage.Pong,
+    error: UnexpectedError,
+})) {
+}
+//# sourceMappingURL=http-rpc-schema.js.map

package/dist/common/http-rpc-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-rpc-schema.js","sourceRoot":"","sources":["../../src/common/http-rpc-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ,CAAC,IAAI,CAC5C,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC1C,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM;KAClC,CAAC;IACF,OAAO,EAAE,WAAW,CAAC,YAAY;IACjC,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,IAAI;CACb,CAAC,EACF,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC1C,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM;KAClC,CAAC;IACF,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,KAAK,EAAE,gBAAgB;CACxB,CAAC,EACF,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;KAC3C,CAAC;IACF,OAAO,EAAE,WAAW,CAAC,IAAI;IACzB,KAAK,EAAE,eAAe;CACvB,CAAC,CACH;CAAG"}

package/dist/common/mod.d.ts

@@ -1,7 +1,14 @@
+import { OversizeChunkItemError, splitChunkBySize } from '@livestore/common/sync';
 import { Schema } from '@livestore/utils/effect';
-export * as WSMessage from './ws-message-types.ts';
+export type { CfTypes } from '@livestore/common-cf';
+export * from './constants.ts';
+export { SyncHttpRpc } from './http-rpc-schema.ts';
+export * as SyncMessage from './sync-message-types.ts';
+export { OversizeChunkItemError, splitChunkBySize };
 export declare const SearchParamsSchema: Schema.Struct<{
     storeId: typeof Schema.String;
     payload: Schema.UndefinedOr<Schema.transform<Schema.transformOrFail<Schema.SchemaClass<string, string, never>, typeof Schema.String, never>, Schema.transform<Schema.SchemaClass<unknown, string, never>, Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>>>;
+    transport: Schema.Union<[Schema.Literal<["http"]>, Schema.Literal<["ws"]>]>;
 }>;
+export type SearchParams = typeof SearchParamsSchema.Type;
 //# sourceMappingURL=mod.d.ts.map

package/dist/common/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/common/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAA;AAElD,eAAO,MAAM,kBAAkB;;;EAG7B,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/common/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAA;AAEnD,eAAO,MAAM,kBAAkB;;;;EAK7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA"}

package/dist/common/mod.js

@@ -1,7 +1,13 @@
+import { OversizeChunkItemError, splitChunkBySize } from '@livestore/common/sync';
 import { Schema } from '@livestore/utils/effect';
-export * as WSMessage from "./ws-message-types.js";
+export * from "./constants.js";
+export { SyncHttpRpc } from "./http-rpc-schema.js";
+export * as SyncMessage from "./sync-message-types.js";
+export { OversizeChunkItemError, splitChunkBySize };
 export const SearchParamsSchema = Schema.Struct({
     storeId: Schema.String,
     payload: Schema.compose(Schema.StringFromUriComponent, Schema.parseJson(Schema.JsonValue)).pipe(Schema.UndefinedOr),
+    // NOTE `do-rpc` is handled differently
+    transport: Schema.Union(Schema.Literal('http'), Schema.Literal('ws')),
 });
 //# sourceMappingURL=mod.js.map

package/dist/common/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/common/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAA;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;CACpH,CAAC,CAAA"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/common/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGhD,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAA;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IACnH,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE,CAAC,CAAA"}

package/dist/common/{ws-message-types.d.ts → sync-message-types.d.ts}

@@ -1,20 +1,25 @@
 import { Schema } from '@livestore/utils/effect';
-export declare const PullReq: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PullReq">;
-} & {
-    requestId: typeof Schema.String;
-    /** Omitting the cursor will start from the beginning */
-    cursor: Schema.optional<typeof Schema.Number>;
-}>;
-export type PullReq = typeof PullReq.Type;
+/**
+ * Common sync message types shared between different transport modes (WS, HTTP, RPC)
+ *
+ * These are the canonical message definitions used across all transport implementations.
+ */
 export declare const SyncMetadata: Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.SyncMetadata">;
+} & {
     /** ISO date format */
     createdAt: typeof Schema.String;
 }>;
 export type SyncMetadata = typeof SyncMetadata.Type;
-export declare const PullRes: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PullRes">;
-} & {
+export declare const PullRequest: Schema.Struct<{
+    /** Omitting the cursor will start from the beginning */
+    cursor: Schema.Option<Schema.Struct<{
+        backendId: Schema.SchemaClass<string, string, never>;
+        eventSequenceNumber: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+    }>>;
+}>;
+export type PullRequest = typeof PullRequest.Type;
+export declare const PullResponse: Schema.Struct<{
     batch: Schema.Array$<Schema.Struct<{
         eventEncoded: Schema.Struct<{
             name: typeof Schema.String;
@@ -25,21 +30,44 @@ export declare const PullRes: Schema.Struct<{
             sessionId: typeof Schema.String;
         }>;
         metadata: Schema.Option<Schema.Struct<{
+            _tag: Schema.tag<"SyncMessage.SyncMetadata">;
+        } & {
             /** ISO date format */
             createdAt: typeof Schema.String;
         }>>;
     }>>;
-    requestId: Schema.Struct<{
-        context: Schema.Literal<["pull", "push"]>;
-        requestId: typeof Schema.String;
-    }>;
-    remaining: typeof Schema.Number;
+    pageInfo: Schema.Union<[Schema.TaggedStruct<"MoreUnknown", {}>, Schema.TaggedStruct<"MoreKnown", {
+        remaining: typeof Schema.Number;
+    }>, Schema.TaggedStruct<"NoMore", {}>]>;
+    backendId: Schema.SchemaClass<string, string, never>;
 }>;
-export type PullRes = typeof PullRes.Type;
-export declare const PushReq: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PushReq">;
-} & {
-    requestId: typeof Schema.String;
+export declare const emptyPullResponse: (backendId: string) => {
+    readonly backendId: string;
+    readonly batch: readonly {
+        readonly metadata: import("effect/Option").Option<{
+            readonly createdAt: string;
+            readonly _tag: "SyncMessage.SyncMetadata";
+        }>;
+        readonly eventEncoded: {
+            readonly name: string;
+            readonly args: any;
+            readonly seqNum: any;
+            readonly parentSeqNum: any;
+            readonly clientId: string;
+            readonly sessionId: string;
+        };
+    }[];
+    readonly pageInfo: {
+        readonly _tag: "MoreUnknown";
+    } | {
+        readonly _tag: "MoreKnown";
+        readonly remaining: number;
+    } | {
+        readonly _tag: "NoMore";
+    };
+};
+export type PullResponse = typeof PullResponse.Type;
+export declare const PushRequest: Schema.Struct<{
     batch: Schema.Array$<Schema.Struct<{
         name: typeof Schema.String;
         args: typeof Schema.Any;
@@ -48,71 +76,44 @@ export declare const PushReq: Schema.Struct<{
         clientId: typeof Schema.String;
         sessionId: typeof Schema.String;
     }>>;
+    backendId: Schema.Option<Schema.SchemaClass<string, string, never>>;
 }>;
-export type PushReq = typeof PushReq.Type;
-export declare const PushAck: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PushAck">;
-} & {
-    requestId: typeof Schema.String;
-}>;
+export type PushRequest = typeof PushRequest.Type;
+export declare const PushAck: Schema.Struct<{}>;
 export type PushAck = typeof PushAck.Type;
-export declare const Error: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Error">;
-} & {
-    requestId: typeof Schema.String;
-    message: typeof Schema.String;
-}>;
-export type Error = typeof Error.Type;
 export declare const Ping: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Ping">;
-} & {
-    requestId: Schema.Literal<["ping"]>;
+    _tag: Schema.tag<"SyncMessage.Ping">;
 }>;
 export type Ping = typeof Ping.Type;
 export declare const Pong: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Pong">;
-} & {
-    requestId: Schema.Literal<["ping"]>;
+    _tag: Schema.tag<"SyncMessage.Pong">;
 }>;
 export type Pong = typeof Pong.Type;
-export declare const AdminResetRoomReq: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminResetRoomReq">;
+export declare const AdminResetRoomRequest: Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.AdminResetRoomRequest">;
 } & {
-    requestId: typeof Schema.String;
     adminSecret: typeof Schema.String;
 }>;
-export type AdminResetRoomReq = typeof AdminResetRoomReq.Type;
-export declare const AdminResetRoomRes: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminResetRoomRes">;
-} & {
-    requestId: typeof Schema.String;
+export type AdminResetRoomRequest = typeof AdminResetRoomRequest.Type;
+export declare const AdminResetRoomResponse: Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.AdminResetRoomResponse">;
 }>;
-export type AdminResetRoomRes = typeof AdminResetRoomRes.Type;
-export declare const AdminInfoReq: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminInfoReq">;
+export type AdminResetRoomResponse = typeof AdminResetRoomResponse.Type;
+export declare const AdminInfoRequest: Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.AdminInfoRequest">;
 } & {
-    requestId: typeof Schema.String;
     adminSecret: typeof Schema.String;
 }>;
-export type AdminInfoReq = typeof AdminInfoReq.Type;
-export declare const AdminInfoRes: Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminInfoRes">;
+export type AdminInfoRequest = typeof AdminInfoRequest.Type;
+export declare const AdminInfoResponse: Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.AdminInfoResponse">;
 } & {
-    requestId: typeof Schema.String;
     info: Schema.Struct<{
         durableObjectId: typeof Schema.String;
     }>;
 }>;
-export type AdminInfoRes = typeof AdminInfoRes.Type;
-export declare const Message: Schema.Union<[Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PullReq">;
-} & {
-    requestId: typeof Schema.String;
-    /** Omitting the cursor will start from the beginning */
-    cursor: Schema.optional<typeof Schema.Number>;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PullRes">;
-} & {
+export type AdminInfoResponse = typeof AdminInfoResponse.Type;
+export declare const BackendToClientMessage: Schema.Union<[Schema.Struct<{
     batch: Schema.Array$<Schema.Struct<{
         eventEncoded: Schema.Struct<{
             name: typeof Schema.String;
@@ -123,19 +124,35 @@ export declare const Message: Schema.Union<[Schema.Struct<{
             sessionId: typeof Schema.String;
         }>;
         metadata: Schema.Option<Schema.Struct<{
+            _tag: Schema.tag<"SyncMessage.SyncMetadata">;
+        } & {
             /** ISO date format */
             createdAt: typeof Schema.String;
         }>>;
     }>>;
-    requestId: Schema.Struct<{
-        context: Schema.Literal<["pull", "push"]>;
-        requestId: typeof Schema.String;
-    }>;
-    remaining: typeof Schema.Number;
+    pageInfo: Schema.Union<[Schema.TaggedStruct<"MoreUnknown", {}>, Schema.TaggedStruct<"MoreKnown", {
+        remaining: typeof Schema.Number;
+    }>, Schema.TaggedStruct<"NoMore", {}>]>;
+    backendId: Schema.SchemaClass<string, string, never>;
+}>, Schema.Struct<{}>, Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.Pong">;
+}>, Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.AdminResetRoomResponse">;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PushReq">;
+    _tag: Schema.tag<"SyncMessage.AdminInfoResponse">;
 } & {
-    requestId: typeof Schema.String;
+    info: Schema.Struct<{
+        durableObjectId: typeof Schema.String;
+    }>;
+}>]>;
+export type BackendToClientMessage = typeof BackendToClientMessage.Type;
+export declare const ClientToBackendMessage: Schema.Union<[Schema.Struct<{
+    /** Omitting the cursor will start from the beginning */
+    cursor: Schema.Option<Schema.Struct<{
+        backendId: Schema.SchemaClass<string, string, never>;
+        eventSequenceNumber: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+    }>>;
+}>, Schema.Struct<{
     batch: Schema.Array$<Schema.Struct<{
         name: typeof Schema.String;
         args: typeof Schema.Any;
@@ -144,50 +161,20 @@ export declare const Message: Schema.Union<[Schema.Struct<{
         clientId: typeof Schema.String;
         sessionId: typeof Schema.String;
     }>>;
+    backendId: Schema.Option<Schema.SchemaClass<string, string, never>>;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PushAck">;
-} & {
-    requestId: typeof Schema.String;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Error">;
-} & {
-    requestId: typeof Schema.String;
-    message: typeof Schema.String;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Ping">;
-} & {
-    requestId: Schema.Literal<["ping"]>;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Pong">;
-} & {
-    requestId: Schema.Literal<["ping"]>;
+    _tag: Schema.tag<"SyncMessage.Ping">;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminResetRoomReq">;
+    _tag: Schema.tag<"SyncMessage.AdminResetRoomRequest">;
 } & {
-    requestId: typeof Schema.String;
     adminSecret: typeof Schema.String;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminResetRoomRes">;
+    _tag: Schema.tag<"SyncMessage.AdminInfoRequest">;
 } & {
-    requestId: typeof Schema.String;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminInfoReq">;
-} & {
-    requestId: typeof Schema.String;
     adminSecret: typeof Schema.String;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminInfoRes">;
-} & {
-    requestId: typeof Schema.String;
-    info: Schema.Struct<{
-        durableObjectId: typeof Schema.String;
-    }>;
 }>]>;
-export type Message = typeof Message.Type;
-export type MessageEncoded = typeof Message.Encoded;
-export declare const BackendToClientMessage: Schema.Union<[Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PullRes">;
-} & {
+export type ClientToBackendMessage = typeof ClientToBackendMessage.Type;
+export declare const Message: Schema.Union<[Schema.Union<[Schema.Struct<{
     batch: Schema.Array$<Schema.Struct<{
         eventEncoded: Schema.Struct<{
             name: typeof Schema.String;
@@ -198,51 +185,33 @@ export declare const BackendToClientMessage: Schema.Union<[Schema.Struct<{
             sessionId: typeof Schema.String;
         }>;
         metadata: Schema.Option<Schema.Struct<{
+            _tag: Schema.tag<"SyncMessage.SyncMetadata">;
+        } & {
             /** ISO date format */
             createdAt: typeof Schema.String;
         }>>;
     }>>;
-    requestId: Schema.Struct<{
-        context: Schema.Literal<["pull", "push"]>;
-        requestId: typeof Schema.String;
-    }>;
-    remaining: typeof Schema.Number;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PushAck">;
-} & {
-    requestId: typeof Schema.String;
+    pageInfo: Schema.Union<[Schema.TaggedStruct<"MoreUnknown", {}>, Schema.TaggedStruct<"MoreKnown", {
+        remaining: typeof Schema.Number;
+    }>, Schema.TaggedStruct<"NoMore", {}>]>;
+    backendId: Schema.SchemaClass<string, string, never>;
+}>, Schema.Struct<{}>, Schema.Struct<{
+    _tag: Schema.tag<"SyncMessage.Pong">;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminResetRoomRes">;
-} & {
-    requestId: typeof Schema.String;
+    _tag: Schema.tag<"SyncMessage.AdminResetRoomResponse">;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminInfoRes">;
+    _tag: Schema.tag<"SyncMessage.AdminInfoResponse">;
 } & {
-    requestId: typeof Schema.String;
     info: Schema.Struct<{
         durableObjectId: typeof Schema.String;
     }>;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Error">;
-} & {
-    requestId: typeof Schema.String;
-    message: typeof Schema.String;
-}>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Pong">;
-} & {
-    requestId: Schema.Literal<["ping"]>;
-}>]>;
-export type BackendToClientMessage = typeof BackendToClientMessage.Type;
-export declare const ClientToBackendMessage: Schema.Union<[Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PullReq">;
-} & {
-    requestId: typeof Schema.String;
+}>]>, Schema.Union<[Schema.Struct<{
     /** Omitting the cursor will start from the beginning */
-    cursor: Schema.optional<typeof Schema.Number>;
+    cursor: Schema.Option<Schema.Struct<{
+        backendId: Schema.SchemaClass<string, string, never>;
+        eventSequenceNumber: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+    }>>;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.PushReq">;
-} & {
-    requestId: typeof Schema.String;
     batch: Schema.Array$<Schema.Struct<{
         name: typeof Schema.String;
         args: typeof Schema.Any;
@@ -251,20 +220,17 @@ export declare const ClientToBackendMessage: Schema.Union<[Schema.Struct<{
         clientId: typeof Schema.String;
         sessionId: typeof Schema.String;
     }>>;
+    backendId: Schema.Option<Schema.SchemaClass<string, string, never>>;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminResetRoomReq">;
-} & {
-    requestId: typeof Schema.String;
-    adminSecret: typeof Schema.String;
+    _tag: Schema.tag<"SyncMessage.Ping">;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.AdminInfoReq">;
+    _tag: Schema.tag<"SyncMessage.AdminResetRoomRequest">;
 } & {
-    requestId: typeof Schema.String;
     adminSecret: typeof Schema.String;
 }>, Schema.Struct<{
-    _tag: Schema.tag<"WSMessage.Ping">;
+    _tag: Schema.tag<"SyncMessage.AdminInfoRequest">;
 } & {
-    requestId: Schema.Literal<["ping"]>;
-}>]>;
-export type ClientToBackendMessage = typeof ClientToBackendMessage.Type;
-//# sourceMappingURL=ws-message-types.d.ts.map
+    adminSecret: typeof Schema.String;
+}>]>]>;
+export type Message = typeof Message.Type;
+//# sourceMappingURL=sync-message-types.d.ts.map

package/dist/common/sync-message-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-message-types.d.ts","sourceRoot":"","sources":["../../src/common/sync-message-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD;;;;GAIG;AAEH,eAAO,MAAM,YAAY;;;IACvB,sBAAsB;;EAEoC,CAAA;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,eAAO,MAAM,WAAW;IACtB,wDAAwD;;;;;EAOC,CAAA;AAE3D,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,eAAO,MAAM,YAAY;;;;;;;;;;;;;YAlBvB,sBAAsB;;;;;;;;EA2BoC,CAAA;AAE5D,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CAK/C,CAAA;AAEJ,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,eAAO,MAAM,WAAW;;;;;;;;;;EAGmC,CAAA;AAE3D,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,eAAO,MAAM,OAAO,mBAElB,CAAA;AAEF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC,eAAO,MAAM,IAAI;;EAAgG,CAAA;AAEjH,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAEnC,eAAO,MAAM,IAAI;;EAAgG,CAAA;AAEjH,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAGnC,eAAO,MAAM,qBAAqB;;;;EAEmC,CAAA;AAErE,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAErE,eAAO,MAAM,sBAAsB;;EAEjC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,gBAAgB;;;;EAEmC,CAAA;AAEhE,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAE3D,eAAO,MAAM,iBAAiB;;;;;;EAImC,CAAA;AAEjE,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;YAtFjC,sBAAsB;;;;;;;;;;;;;;;;;;IA4FvB,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,sBAAsB;IAxFjC,wDAAwD;;;;;;;;;;;;;;;;;;;;;;;;;IA8FzD,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,OAAO;;;;;;;;;;;;;YAxGlB,sBAAsB;;;;;;;;;;;;;;;;;;;IAOtB,wDAAwD;;;;;;;;;;;;;;;;;;;;;;;;;MAiGyB,CAAA;AACnF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA"}

package/dist/common/sync-message-types.js

@@ -0,0 +1,60 @@
+import { BackendId, SyncBackend } from '@livestore/common';
+import { EventSequenceNumber, LiveStoreEvent } from '@livestore/common/schema';
+import { Schema } from '@livestore/utils/effect';
+/**
+ * Common sync message types shared between different transport modes (WS, HTTP, RPC)
+ *
+ * These are the canonical message definitions used across all transport implementations.
+ */
+export const SyncMetadata = Schema.TaggedStruct('SyncMessage.SyncMetadata', {
+    /** ISO date format */
+    createdAt: Schema.String,
+}).annotations({ title: '@livestore/sync-cf:SyncMetadata' });
+export const PullRequest = Schema.Struct({
+    /** Omitting the cursor will start from the beginning */
+    cursor: Schema.Option(Schema.Struct({
+        backendId: BackendId,
+        eventSequenceNumber: EventSequenceNumber.GlobalEventSequenceNumber,
+    })),
+}).annotations({ title: '@livestore/sync-cf:PullRequest' });
+export const PullResponse = Schema.Struct({
+    batch: Schema.Array(Schema.Struct({
+        eventEncoded: LiveStoreEvent.AnyEncodedGlobal,
+        metadata: Schema.Option(SyncMetadata),
+    })),
+    pageInfo: SyncBackend.PullResPageInfo,
+    backendId: BackendId,
+}).annotations({ title: '@livestore/sync-cf:PullResponse' });
+export const emptyPullResponse = (backendId) => PullResponse.make({
+    batch: [],
+    pageInfo: SyncBackend.pageInfoNoMore,
+    backendId,
+});
+export const PushRequest = Schema.Struct({
+    batch: Schema.Array(LiveStoreEvent.AnyEncodedGlobal),
+    backendId: Schema.Option(BackendId),
+}).annotations({ title: '@livestore/sync-cf:PushRequest' });
+export const PushAck = Schema.Struct({}).annotations({
+    title: '@livestore/sync-cf:PushAck',
+});
+export const Ping = Schema.TaggedStruct('SyncMessage.Ping', {}).annotations({ title: '@livestore/sync-cf:Ping' });
+export const Pong = Schema.TaggedStruct('SyncMessage.Pong', {}).annotations({ title: '@livestore/sync-cf:Pong' });
+// Admin operations
+export const AdminResetRoomRequest = Schema.TaggedStruct('SyncMessage.AdminResetRoomRequest', {
+    adminSecret: Schema.String,
+}).annotations({ title: '@livestore/sync-cf:AdminResetRoomRequest' });
+export const AdminResetRoomResponse = Schema.TaggedStruct('SyncMessage.AdminResetRoomResponse', {}).annotations({
+    title: '@livestore/sync-cf:AdminResetRoomResponse',
+});
+export const AdminInfoRequest = Schema.TaggedStruct('SyncMessage.AdminInfoRequest', {
+    adminSecret: Schema.String,
+}).annotations({ title: '@livestore/sync-cf:AdminInfoRequest' });
+export const AdminInfoResponse = Schema.TaggedStruct('SyncMessage.AdminInfoResponse', {
+    info: Schema.Struct({
+        durableObjectId: Schema.String,
+    }),
+}).annotations({ title: '@livestore/sync-cf:AdminInfoResponse' });
+export const BackendToClientMessage = Schema.Union(PullResponse, PushAck, Pong, AdminResetRoomResponse, AdminInfoResponse);
+export const ClientToBackendMessage = Schema.Union(PullRequest, PushRequest, Ping, AdminResetRoomRequest, AdminInfoRequest);
+export const Message = Schema.Union(BackendToClientMessage, ClientToBackendMessage);
+//# sourceMappingURL=sync-message-types.js.map

package/dist/common/sync-message-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-message-types.js","sourceRoot":"","sources":["../../src/common/sync-message-types.ts"],"names":[],"mappings":"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"}