@livestore/sync-cf 0.4.0-dev.2 → 0.4.0-dev.5

package/dist/client/transport/http-rpc-client.d.ts

@@ -0,0 +1,43 @@
+import { SyncBackend } from '@livestore/common';
+import { type Duration } from '@livestore/utils/effect';
+import type { SyncMetadata } from '../../common/sync-message-types.ts';
+export interface HttpSyncOptions {
+    /**
+     * URL of the sync backend
+     *
+     * @example
+     * ```ts
+     * const syncBackend = makeHttpSync({ url: 'https://sync.example.com' })
+     * ```
+     */
+    url: string;
+    headers?: Record<string, string>;
+    livePull?: {
+        /**
+         * How often to poll for new events
+         * @default 5 seconds
+         */
+        pollInterval?: Duration.DurationInput;
+    };
+    ping?: {
+        /**
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * How long to wait for a ping response before timing out
+         * @default 10 seconds
+         */
+        requestTimeout?: Duration.DurationInput;
+        /**
+         * How often to send ping requests
+         * @default 10 seconds
+         */
+        requestInterval?: Duration.DurationInput;
+    };
+}
+/**
+ * Note: This implementation requires the `enable_request_signal` compatibility flag to properly support `pull` streaming responses
+ */
+export declare const makeHttpSync: (options: HttpSyncOptions) => SyncBackend.SyncBackendConstructor<SyncMetadata>;
+//# sourceMappingURL=http-rpc-client.d.ts.map

package/dist/client/transport/http-rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-rpc-client.d.ts","sourceRoot":"","sources":["../../../src/client/transport/http-rpc-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,WAAW,EAAmB,MAAM,mBAAmB,CAAA;AAGpG,OAAO,EAEL,KAAK,QAAQ,EAcd,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE;QACT;;;WAGG;QACH,YAAY,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;KACtC,CAAA;IACD,IAAI,CAAC,EAAE;QACL;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB;;;WAGG;QACH,cAAc,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;QACvC;;;WAGG;QACH,eAAe,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;KACzC,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GACtB,SAAS,eAAe,KAAG,WAAW,CAAC,sBAAsB,CAAC,YAAY,CA4IvE,CAAA"}

package/dist/client/transport/http-rpc-client.js

@@ -0,0 +1,87 @@
+import { InvalidPullError, InvalidPushError, SyncBackend, UnexpectedError } from '@livestore/common';
+import { omit } from '@livestore/utils';
+import { Chunk, Effect, HttpClient, HttpClientRequest, identity, Layer, Option, RpcClient, RpcSerialization, Schedule, Schema, Stream, SubscriptionRef, UrlParams, } from '@livestore/utils/effect';
+import { SyncHttpRpc } from "../../common/http-rpc-schema.js";
+import { SearchParamsSchema } from "../../common/mod.js";
+/**
+ * Note: This implementation requires the `enable_request_signal` compatibility flag to properly support `pull` streaming responses
+ */
+export const makeHttpSync = (options) => ({ storeId, payload }) => Effect.gen(function* () {
+    // Based on ping responses
+    const isConnected = yield* SubscriptionRef.make(false);
+    const livePullInterval = options.livePull?.pollInterval ?? 5_000;
+    const urlParamsData = yield* Schema.encode(SearchParamsSchema)({
+        storeId,
+        payload,
+        transport: 'http',
+    }).pipe(UnexpectedError.mapToUnexpectedError);
+    const urlParams = UrlParams.fromInput(urlParamsData);
+    // Setup HTTP RPC Protocol
+    const HttpProtocolLive = RpcClient.layerProtocolHttp({
+        url: `${options.url}?${UrlParams.toString(urlParams)}`,
+        transformClient: HttpClient.mapRequest((request) => request.pipe(HttpClientRequest.setHeaders({
+            ...options.headers,
+            // Used in CF Worker to identify the store (additionally to storeId embedded in the RPC requests)
+            'x-livestore-store-id': storeId,
+        }))),
+    }).pipe(Layer.provide(RpcSerialization.layerJson));
+    const rpcClient = yield* RpcClient.make(SyncHttpRpc).pipe(Effect.provide(HttpProtocolLive));
+    const pingTimeout = options.ping?.requestTimeout ?? 10_000;
+    const ping = Effect.gen(function* () {
+        yield* rpcClient.SyncHttpRpc.Ping({ storeId, payload });
+        yield* SubscriptionRef.set(isConnected, true);
+    }).pipe(UnexpectedError.mapToUnexpectedError, Effect.timeout(pingTimeout), Effect.catchTag('TimeoutException', () => SubscriptionRef.set(isConnected, false)));
+    const pingInterval = options.ping?.requestInterval ?? 10_000;
+    if (options.ping?.enabled !== false) {
+        // Automatically ping the server to keep the connection alive
+        yield* ping.pipe(Effect.repeat(Schedule.spaced(pingInterval)), Effect.tapCauseLogPretty, Effect.forkScoped);
+    }
+    // Helps already establish a TCP connection to the server
+    const connect = ping.pipe(UnexpectedError.mapToUnexpectedError);
+    const backendIdHelper = yield* SyncBackend.makeBackendIdHelper;
+    const mapCursor = (cursor) => cursor.pipe(Option.map((a) => ({
+        eventSequenceNumber: a.eventSequenceNumber,
+        backendId: backendIdHelper.get().pipe(Option.getOrThrow),
+    })));
+    const pull = (cursor, options) => rpcClient.SyncHttpRpc.Pull({
+        storeId,
+        payload,
+        cursor: mapCursor(cursor),
+    }).pipe(options?.live
+        ? // Phase 2: Simulate `live` pull by polling for new events
+            Stream.concatWithLastElement((lastElement) => {
+                const initialPhase2Cursor = lastElement.pipe(Option.flatMap((_) => Option.fromNullable(_.batch.at(-1)?.eventEncoded.seqNum)), Option.map((eventSequenceNumber) => ({ eventSequenceNumber })), Option.orElse(() => cursor), mapCursor);
+                return Stream.unfoldChunkEffect(initialPhase2Cursor, (currentCursor) => Effect.gen(function* () {
+                    yield* Effect.sleep(livePullInterval);
+                    const items = yield* rpcClient.SyncHttpRpc.Pull({ storeId, payload, cursor: currentCursor }).pipe(Stream.runCollect);
+                    const nextCursor = Chunk.last(items).pipe(Option.flatMap((item) => Option.fromNullable(item.batch.at(-1)?.eventEncoded.seqNum)), Option.map((eventSequenceNumber) => ({ eventSequenceNumber })), Option.orElse(() => currentCursor), mapCursor);
+                    return Option.some([items, nextCursor]);
+                }));
+            })
+        : identity, Stream.tap((res) => backendIdHelper.lazySet(res.backendId)), Stream.map((res) => omit(res, ['backendId'])), Stream.mapError((cause) => (cause._tag === 'InvalidPullError' ? cause : InvalidPullError.make({ cause }))), Stream.withSpan('http-sync-client:pull'));
+    const pushSemaphore = yield* Effect.makeSemaphore(1);
+    const push = (batch) => Effect.gen(function* () {
+        if (batch.length === 0) {
+            return;
+        }
+        yield* rpcClient.SyncHttpRpc.Push({ storeId, payload, batch, backendId: backendIdHelper.get() });
+    }).pipe(pushSemaphore.withPermits(1), Effect.mapError((cause) => cause._tag === 'InvalidPushError' ? cause : new InvalidPushError({ cause: new UnexpectedError({ cause }) })), Effect.withSpan('http-sync-client:push'));
+    return SyncBackend.of({
+        connect,
+        isConnected,
+        pull,
+        push,
+        ping,
+        metadata: {
+            name: '@livestore/cf-sync-http',
+            description: 'LiveStore sync backend implementation using HTTP RPC',
+            protocol: 'http',
+            url: options.url,
+        },
+        supports: {
+            pullPageInfoKnown: true,
+            pullLive: true,
+        },
+    });
+});
+//# sourceMappingURL=http-rpc-client.js.map

package/dist/client/transport/http-rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-rpc-client.js","sourceRoot":"","sources":["../../../src/client/transport/http-rpc-client.ts"],"names":[],"mappings":"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"}

package/dist/client/transport/ws-rpc-client.d.ts

@@ -0,0 +1,45 @@
+import { SyncBackend } from '@livestore/common';
+import { type Duration, Effect, type Scope, type WebSocket } from '@livestore/utils/effect';
+import type { SyncMetadata } from '../../common/sync-message-types.ts';
+export interface WsSyncOptions {
+    /**
+     * URL of the sync backend
+     *
+     * The protocol can either `http`/`https` or `ws`/`wss`
+     *
+     * @example 'https://sync.example.com'
+     */
+    url: string;
+    /**
+     * Optional WebSocket factory for custom WebSocket implementations (e.g., Cloudflare Durable Objects)
+     * If not provided, uses standard WebSocket from @livestore/utils/effect
+     */
+    webSocketFactory?: (wsUrl: string) => Effect.Effect<globalThis.WebSocket, WebSocket.WebSocketError, Scope.Scope>;
+    ping?: {
+        /**
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * How long to wait for a ping response before timing out
+         * @default 10 seconds
+         */
+        requestTimeout?: Duration.DurationInput;
+        /**
+         * How often to send ping requests
+         * @default 10 seconds
+         */
+        requestInterval?: Duration.DurationInput;
+    };
+}
+/**
+ * Creates a sync backend that uses WebSocket to communicate with the sync backend.
+ *
+ * @example
+ * ```ts
+ * import { makeWsSync } from '@livestore/sync-cf/client'
+ *
+ * const syncBackend = makeWsSync({ url: 'wss://sync.example.com' })
+ */
+export declare const makeWsSync: (options: WsSyncOptions) => SyncBackend.SyncBackendConstructor<SyncMetadata>;
+//# sourceMappingURL=ws-rpc-client.d.ts.map

package/dist/client/transport/ws-rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-rpc-client.d.ts","sourceRoot":"","sources":["../../../src/client/transport/ws-rpc-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,WAAW,EAAmB,MAAM,mBAAmB,CAAA;AAEpH,OAAO,EACL,KAAK,QAAQ,EACb,MAAM,EAON,KAAK,KAAK,EAKV,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAGtE,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAChH,IAAI,CAAC,EAAE;QACL;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB;;;WAGG;QACH,cAAc,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;QACvC;;;WAGG;QACH,eAAe,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;KACzC,CAAA;CACF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACpB,SAAS,aAAa,KAAG,WAAW,CAAC,sBAAsB,CAAC,YAAY,CAqHrE,CAAA"}

package/dist/client/transport/ws-rpc-client.js

@@ -0,0 +1,94 @@
+import { InvalidPullError, InvalidPushError, IsOfflineError, SyncBackend, UnexpectedError } from '@livestore/common';
+import { omit } from '@livestore/utils';
+import { Effect, Layer, Option, RpcClient, RpcSerialization, Schedule, Schema, Socket, Stream, SubscriptionRef, UrlParams, } from '@livestore/utils/effect';
+import { SearchParamsSchema } from "../../common/mod.js";
+import { SyncWsRpc } from "../../common/ws-rpc-schema.js";
+/**
+ * Creates a sync backend that uses WebSocket to communicate with the sync backend.
+ *
+ * @example
+ * ```ts
+ * import { makeWsSync } from '@livestore/sync-cf/client'
+ *
+ * const syncBackend = makeWsSync({ url: 'wss://sync.example.com' })
+ */
+export const makeWsSync = (options) => ({ storeId, payload }) => Effect.gen(function* () {
+    const urlParamsData = yield* Schema.encode(SearchParamsSchema)({
+        storeId,
+        payload,
+        transport: 'ws',
+    }).pipe(UnexpectedError.mapToUnexpectedError);
+    const urlParams = UrlParams.fromInput(urlParamsData);
+    const wsUrl = `${options.url}?${UrlParams.toString(urlParams)}`;
+    const isConnected = yield* SubscriptionRef.make(false);
+    // TODO bring this back in a cross-platform way
+    // If the browser already tells us we're offline, then we'll at least wait until the browser
+    // thinks we're online again. (We'll only know for sure once the WS conneciton is established.)
+    // while (typeof navigator !== 'undefined' && navigator.onLine === false) {
+    //   yield* Effect.sleep(1000)
+    // }
+    // TODO bring this back in a cross-platform way
+    // if (navigator.onLine === false) {
+    //   yield* Effect.async((cb) => self.addEventListener('online', () => cb(Effect.void)))
+    // }
+    const pingInterval = options.ping?.requestInterval ?? 10_000;
+    const ProtocolLive = RpcClient.layerProtocolSocketWithIsConnected({
+        isConnected,
+        retryTransientErrors: Schedule.fixed(1000),
+        pingSchedule: Schedule.once.pipe(Schedule.andThen(Schedule.fixed(pingInterval))),
+        url: wsUrl,
+    }).pipe(Layer.provide(Socket.layerWebSocket(wsUrl)), Layer.provide(Socket.layerWebSocketConstructorGlobal), Layer.provide(RpcSerialization.layerJson));
+    // Warning: we need to build the layer here eagerly to tie it to the scope
+    // instead of using `Effect.provide(ProtocolLive)` which would close the layer scope too early
+    const ctx = yield* Layer.build(ProtocolLive);
+    const rpcClient = yield* RpcClient.make(SyncWsRpc).pipe(Effect.provide(ctx));
+    const pingTimeout = options.ping?.requestTimeout ?? 10_000;
+    const ping = Effect.gen(function* () {
+        const pinger = yield* RpcClient.SocketPinger.pipe(Effect.provide(ctx));
+        yield* pinger.ping;
+        yield* SubscriptionRef.set(isConnected, true);
+    }).pipe(Effect.timeout(pingTimeout), Effect.catchTag('TimeoutException', () => SubscriptionRef.set(isConnected, false)), UnexpectedError.mapToUnexpectedError, Effect.withSpan('ping'));
+    const backendIdHelper = yield* SyncBackend.makeBackendIdHelper;
+    return SyncBackend.of({
+        isConnected,
+        connect: ping,
+        pull: (cursor, options) => rpcClient.SyncWsRpc.Pull({
+            storeId,
+            payload,
+            cursor: cursor.pipe(Option.map((a) => ({
+                eventSequenceNumber: a.eventSequenceNumber,
+                backendId: backendIdHelper.get().pipe(Option.getOrThrow),
+            }))),
+            live: options?.live ?? false,
+        }).pipe(Stream.tap((res) => backendIdHelper.lazySet(res.backendId)), Stream.map((res) => omit(res, ['backendId'])), Stream.mapError((cause) => cause._tag === 'RpcClientError' && Socket.isSocketError(cause.cause)
+            ? new IsOfflineError({ cause: cause.cause })
+            : cause._tag === 'InvalidPullError'
+                ? cause
+                : InvalidPullError.make({ cause })), Stream.withSpan('pull')),
+        push: (batch) => Effect.gen(function* () {
+            if (batch.length === 0) {
+                return;
+            }
+            return yield* rpcClient.SyncWsRpc.Push({
+                storeId,
+                payload,
+                batch,
+                backendId: backendIdHelper.get(),
+            }).pipe(Effect.mapError((cause) => cause._tag === 'InvalidPushError'
+                ? cause
+                : new InvalidPushError({ cause: new UnexpectedError({ cause }) })));
+        }).pipe(Effect.withSpan('push')),
+        ping,
+        metadata: {
+            name: '@livestore/cf-sync',
+            description: 'LiveStore sync backend implementation using Cloudflare Workers & Durable Objects',
+            protocol: 'ws',
+            url: options.url,
+        },
+        supports: {
+            pullPageInfoKnown: true,
+            pullLive: true,
+        },
+    });
+});
+//# sourceMappingURL=ws-rpc-client.js.map

package/dist/client/transport/ws-rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-rpc-client.js","sourceRoot":"","sources":["../../../src/client/transport/ws-rpc-client.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,76 @@
+import { InvalidPullError, InvalidPushError } from '@livestore/common';
+import { Rpc, RpcGroup, Schema } from '@livestore/utils/effect';
+declare const SyncDoRpc_base: RpcGroup.RpcGroup<Rpc.Rpc<"SyncDoRpc.Pull", Schema.Struct<{
+    /**
+     * While the storeId is already implied by the durable object, we still need the explicit storeId
+     * since a DO doesn't know its own id.name value. 🫠
+     * https://community.cloudflare.com/t/how-can-i-get-the-name-of-a-durable-object-from-itself/505961/8
+     */
+    storeId: typeof Schema.String;
+    /** Needed for various reasons (e.g. auth) */
+    payload: Schema.optional<Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>;
+    /** 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>;
+    }>>;
+    /** Whether to keep the pull stream alive and wait for more events */
+    rpcContext: Schema.optional<Schema.Struct<{
+        callerContext: Schema.Struct<{
+            bindingName: typeof Schema.String;
+            durableObjectId: typeof Schema.String;
+        }>;
+    }>>;
+}>, 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>;
+    rpcRequestId: typeof Schema.String;
+}>, typeof InvalidPullError>, typeof Schema.Never, never> | Rpc.Rpc<"SyncDoRpc.Push", Schema.Struct<{
+    /**
+     * While the storeId is already implied by the durable object, we still need the explicit storeId
+     * since a DO doesn't know its own id.name value. 🫠
+     * https://community.cloudflare.com/t/how-can-i-get-the-name-of-a-durable-object-from-itself/505961/8
+     */
+    storeId: typeof Schema.String;
+    /** Needed for various reasons (e.g. auth) */
+    payload: Schema.optional<Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>;
+    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>>;
+}>, Schema.Struct<{}>, typeof InvalidPushError, never> | Rpc.Rpc<"SyncDoRpc.Ping", Schema.Struct<{
+    /**
+     * While the storeId is already implied by the durable object, we still need the explicit storeId
+     * since a DO doesn't know its own id.name value. 🫠
+     * https://community.cloudflare.com/t/how-can-i-get-the-name-of-a-durable-object-from-itself/505961/8
+     */
+    storeId: typeof Schema.String;
+    /** Needed for various reasons (e.g. auth) */
+    payload: Schema.optional<Schema.Schema<Schema.JsonValue, Schema.JsonValue, never>>;
+}>, typeof Schema.Void, typeof Schema.Never, never>>;
+export declare class SyncDoRpc extends SyncDoRpc_base {
+}
+export {};
+//# sourceMappingURL=do-rpc-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"do-rpc-schema.d.ts","sourceRoot":"","sources":["../../src/common/do-rpc-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;;IAI7D;;;;OAIG;;IAEH,6CAA6C;;IAOzC,wDAAwD;;;;;IAGxD,qEAAqE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAhBzE;;;;OAIG;;IAEH,6CAA6C;;;;;;;;;;;;IAN7C;;;;OAIG;;IAEH,6CAA6C;;;AAI/C,qBAAa,SAAU,SAAQ,cAsC9B;CAAG"}

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

@@ -0,0 +1,48 @@
+import { InvalidPullError, InvalidPushError } from '@livestore/common';
+import { Rpc, RpcGroup, Schema } from '@livestore/utils/effect';
+import * as SyncMessage from "./sync-message-types.js";
+const commonPayloadFields = {
+    /**
+     * While the storeId is already implied by the durable object, we still need the explicit storeId
+     * since a DO doesn't know its own id.name value. 🫠
+     * https://community.cloudflare.com/t/how-can-i-get-the-name-of-a-durable-object-from-itself/505961/8
+     */
+    storeId: Schema.String,
+    /** Needed for various reasons (e.g. auth) */
+    payload: Schema.optional(Schema.JsonValue),
+};
+export class SyncDoRpc extends RpcGroup.make(Rpc.make('SyncDoRpc.Pull', {
+    payload: {
+        /** Omitting the cursor will start from the beginning */
+        cursor: SyncMessage.PullRequest.fields.cursor,
+        // TODO rename
+        /** Whether to keep the pull stream alive and wait for more events */
+        rpcContext: Schema.optional(Schema.Struct({
+            callerContext: Schema.Struct({
+                bindingName: Schema.String,
+                durableObjectId: Schema.String,
+            }),
+        })),
+        ...commonPayloadFields,
+    },
+    success: Schema.Struct({
+        rpcRequestId: Schema.String,
+        ...SyncMessage.PullResponse.fields,
+    }),
+    error: InvalidPullError,
+    stream: true,
+}), Rpc.make('SyncDoRpc.Push', {
+    payload: {
+        ...SyncMessage.PushRequest.fields,
+        ...commonPayloadFields,
+    },
+    success: SyncMessage.PushAck,
+    error: InvalidPushError,
+}), Rpc.make('SyncDoRpc.Ping', {
+    payload: {
+        ...commonPayloadFields,
+    },
+    success: Schema.Void,
+})) {
+}
+//# sourceMappingURL=do-rpc-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"do-rpc-schema.js","sourceRoot":"","sources":["../../src/common/do-rpc-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AAEtD,MAAM,mBAAmB,GAAG;IAC1B;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;CAC3C,CAAA;AAED,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,IAAI,CAC1C,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE;IACzB,OAAO,EAAE;QACP,wDAAwD;QACxD,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM;QAC7C,cAAc;QACd,qEAAqE;QACrE,UAAU,EAAE,MAAM,CAAC,QAAQ,CACzB,MAAM,CAAC,MAAM,CAAC;YACZ,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC3B,WAAW,EAAE,MAAM,CAAC,MAAM;gBAC1B,eAAe,EAAE,MAAM,CAAC,MAAM;aAC/B,CAAC;SACH,CAAC,CACH;QACD,GAAG,mBAAmB;KACvB;IACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,GAAG,WAAW,CAAC,YAAY,CAAC,MAAM;KACnC,CAAC;IACF,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,IAAI;CACb,CAAC,EACF,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE;IACzB,OAAO,EAAE;QACP,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM;QACjC,GAAG,mBAAmB;KACvB;IACD,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,KAAK,EAAE,gBAAgB;CACxB,CAAC,EACF,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE;IACzB,OAAO,EAAE;QACP,GAAG,mBAAmB;KACvB;IACD,OAAO,EAAE,MAAM,CAAC,IAAI;CACrB,CAAC,CACH;CAAG"}

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,11 @@
 import { Schema } from '@livestore/utils/effect';
-export * as WSMessage from './ws-message-types.ts';
+export type { CfTypes } from '@livestore/common-cf';
+export { SyncHttpRpc } from './http-rpc-schema.ts';
+export * as SyncMessage from './sync-message-types.ts';
 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,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AAEtD,eAAO,MAAM,kBAAkB;;;;EAK7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA"}

package/dist/common/mod.js

@@ -1,7 +1,10 @@
 import { Schema } from '@livestore/utils/effect';
-export * as WSMessage from "./ws-message-types.js";
+export { SyncHttpRpc } from "./http-rpc-schema.js";
+export * as SyncMessage from "./sync-message-types.js";
 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,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAIhD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AAEtD,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"}