@livestore/livestore 0.4.0-dev.18 → 0.4.0-dev.19

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/console/index.md

@@ -0,0 +1,5 @@
+# console
+
+> `const` **console**: [`Console`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/console/)
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:199

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/crypto/index.md

@@ -0,0 +1,12 @@
+# crypto
+
+> `const` **crypto**: [`Crypto`](/api/sync-cf/livestore/namespaces/cftypes/classes/crypto/)
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:451
+
+The Web Crypto API provides a set of low-level functions for common cryptographic tasks.
+The Workers runtime implements the full surface of this API, but with some differences in
+the [supported algorithms](https://developers.cloudflare.com/workers/runtime-apis/web-crypto/#supported-algorithms)
+compared to those implemented in most browsers.
+
+[Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/web-crypto/)

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/onmessage/index.md

@@ -0,0 +1,5 @@
+# onmessage
+
+> **onmessage**: `never`
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:17

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/origin/index.md

@@ -0,0 +1,5 @@
+# origin
+
+> `const` **origin**: `string`
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:467

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/performance/index.md

@@ -0,0 +1,10 @@
+# performance
+
+> `const` **performance**: [`Performance`](/api/sync-cf/livestore/namespaces/cftypes/classes/performance/)
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:465
+
+The Workers runtime supports a subset of the Performance API, used to measure timing and performance,
+as well as timing of subrequests and other operations.
+
+[Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/)

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/scheduler/index.md

@@ -0,0 +1,5 @@
+# scheduler
+
+> `const` **scheduler**: [`Scheduler`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/scheduler/)
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:458

package/docs/api/sync-cf/@livestore/namespaces/CfTypes/variables/self/index.md

@@ -0,0 +1,5 @@
+# self
+
+> `const` **self**: [`ServiceWorkerGlobalScope`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/serviceworkerglobalscope/)
+
+Defined in: node\_modules/.pnpm/@cloudflare+workers-types@4.20251118.0/node\_modules/@cloudflare/workers-types/index.ts:442

package/docs/api/sync-cf/README/index.md

@@ -0,0 +1,37 @@
+# @livestore/sync-cf
+
+## Namespaces
+
+- [CfDeclare](/api/sync-cf/livestore/namespaces/cfdeclare/readme/)
+- [CfTypes](/api/sync-cf/livestore/namespaces/cftypes/readme/)
+
+## Interfaces
+
+- [SyncBackendRpcInterface](/api/sync-cf/interfaces/syncbackendrpcinterface/)
+
+## Type Aliases
+
+- [CFWorker](/api/sync-cf/type-aliases/cfworker/)
+- [DoObject](/api/sync-cf/type-aliases/doobject/)
+- [DoState](/api/sync-cf/type-aliases/dostate/)
+- [DurableObjectId](/api/sync-cf/type-aliases/durableobjectid/)
+- [Env](/api/sync-cf/type-aliases/env/)
+- [MakeDurableObjectClass](/api/sync-cf/type-aliases/makedurableobjectclass/)
+- [MakeDurableObjectClassOptions](/api/sync-cf/type-aliases/makedurableobjectclassoptions/)
+- [MakeWorkerOptions](/api/sync-cf/type-aliases/makeworkeroptions/)
+- [RpcSubscription](/api/sync-cf/type-aliases/rpcsubscription/)
+- [StoreId](/api/sync-cf/type-aliases/storeid/)
+
+## Variables
+
+- [encodeIncomingMessage](/api/sync-cf/variables/encodeincomingmessage/)
+- [encodeOutgoingMessage](/api/sync-cf/variables/encodeoutgoingmessage/)
+- [makeDurableObject](/api/sync-cf/variables/makedurableobject/)
+- [PERSISTENCE\_FORMAT\_VERSION](/api/sync-cf/variables/persistence_format_version/)
+- [WebSocketAttachmentSchema](/api/sync-cf/variables/websocketattachmentschema/)
+
+## Functions
+
+- [handleSyncRequest](/api/sync-cf/functions/handlesyncrequest/)
+- [makeWorker](/api/sync-cf/functions/makeworker/)
+- [matchSyncRequest](/api/sync-cf/functions/matchsyncrequest/)

package/docs/api/sync-cf/functions/handleSyncRequest/index.md

@@ -0,0 +1,117 @@
+# handleSyncRequest
+
+> **handleSyncRequest**\<`TEnv`, `TDurableObjectRpc`, `CFHostMetada`, `TSyncPayload`\>(`__namedParameters`): `Promise`\<[`Response`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/response/)\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/worker.ts:156](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/worker.ts#L156)
+
+Handles LiveStore sync requests (e.g. with search params `?storeId=...&transport=...`).
+
+## Type Parameters
+
+### TEnv
+
+`TEnv` *extends* [`Env`](/api/sync-cf/type-aliases/env/) = [`Env`](/api/sync-cf/type-aliases/env/)
+
+### TDurableObjectRpc
+
+`TDurableObjectRpc` *extends* `undefined` \| [`DurableObjectBranded`](/api/sync-cf/livestore/namespaces/cftypes/namespaces/rpc/interfaces/durableobjectbranded/) = `undefined`
+
+### CFHostMetada
+
+`CFHostMetada` = `unknown`
+
+### TSyncPayload
+
+`TSyncPayload` = `JsonValue`
+
+## Parameters
+
+### \_\_namedParameters
+
+#### ctx
+
+[`ExecutionContext`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/executioncontext/)
+
+Only there for type-level reasons
+
+#### env?
+
+`TEnv`
+
+#### headers?
+
+[`HeadersInit`](/api/sync-cf/livestore/namespaces/cftypes/type-aliases/headersinit/)
+
+#### request
+
+[`Request`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/request/)\<`CFHostMetada`\>
+
+#### searchParams
+
+\{ `payload`: `undefined` \| `JsonValue`; `storeId`: `string`; `transport`: `"http"` \| `"ws"`; \}
+
+#### searchParams.payload
+
+`undefined` \| `JsonValue` = `...`
+
+#### searchParams.storeId
+
+`string` = `Schema.String`
+
+#### searchParams.transport
+
+`"http"` \| `"ws"` = `...`
+
+#### syncBackendBinding
+
+`ExtractDurableObjectKeys`\<`TEnv`\>
+
+Binding name of the sync backend Durable Object
+
+#### syncPayloadSchema?
+
+`Schema`\<`TSyncPayload`, `TSyncPayload`, `never`\>
+
+#### validatePayload?
+
+(`payload`, `context`) => `void` \| `Promise`\<`void`\>
+
+## Returns
+
+`Promise`\<[`Response`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/response/)\>
+
+## Example
+
+```ts
+const validatePayload = (payload: Schema.JsonValue | undefined, context: { storeId: string }) => {
+  console.log(`Validating connection for store: ${context.storeId}`)
+  if (payload?.authToken !== 'insecure-token-change-me') {
+    throw new Error('Invalid auth token')
+  }
+}
+
+export default {
+  fetch: async (request, env, ctx) => {
+    const searchParams = matchSyncRequest(request)
+
+    // Is LiveStore sync request
+    if (searchParams !== undefined) {
+      return handleSyncRequest({
+        request,
+        searchParams,
+        env,
+        ctx,
+        syncBackendBinding: 'SYNC_BACKEND_DO',
+        headers: {},
+        validatePayload,
+      })
+    }
+
+    return new Response('Invalid path', { status: 400 })
+  }
+}
+```
+
+## Throws
+
+If the payload is invalid

package/docs/api/sync-cf/functions/makeWorker/index.md

@@ -0,0 +1,35 @@
+# makeWorker
+
+> **makeWorker**\<`TEnv`, `TDurableObjectRpc`, `TSyncPayload`\>(`options`): [`CFWorker`](/api/sync-cf/type-aliases/cfworker/)\<`TEnv`, `TDurableObjectRpc`\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/worker.ts:56](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/worker.ts#L56)
+
+Produces a Cloudflare Worker `fetch` handler that delegates sync traffic to the
+Durable Object identified by `syncBackendBinding`.
+
+For more complex setups prefer implementing a custom `fetch` and call [handleSyncRequest](/api/sync-cf/functions/handlesyncrequest/)
+from the branch that handles LiveStore sync requests.
+
+## Type Parameters
+
+### TEnv
+
+`TEnv` *extends* [`Env`](/api/sync-cf/type-aliases/env/) = [`Env`](/api/sync-cf/type-aliases/env/)
+
+### TDurableObjectRpc
+
+`TDurableObjectRpc` *extends* `undefined` \| [`DurableObjectBranded`](/api/sync-cf/livestore/namespaces/cftypes/namespaces/rpc/interfaces/durableobjectbranded/) = `undefined`
+
+### TSyncPayload
+
+`TSyncPayload` = `JsonValue`
+
+## Parameters
+
+### options
+
+[`MakeWorkerOptions`](/api/sync-cf/type-aliases/makeworkeroptions/)\<`TEnv`, `TSyncPayload`\>
+
+## Returns
+
+[`CFWorker`](/api/sync-cf/type-aliases/cfworker/)\<`TEnv`, `TDurableObjectRpc`\>

package/docs/api/sync-cf/functions/matchSyncRequest/index.md

@@ -0,0 +1,19 @@
+# matchSyncRequest
+
+> **matchSyncRequest**(`request`): `undefined` \| \{ `payload`: `undefined` \| `JsonValue`; `storeId`: `string`; `transport`: `"http"` \| `"ws"`; \}
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:100](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L100)
+
+Extracts the LiveStore sync search parameters from a request. Returns
+`undefined` when the request does not carry valid sync metadata so callers
+can fall back to custom routing.
+
+## Parameters
+
+### request
+
+[`Request`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/request/)
+
+## Returns
+
+`undefined` \| \{ `payload`: `undefined` \| `JsonValue`; `storeId`: `string`; `transport`: `"http"` \| `"ws"`; \}

package/docs/api/sync-cf/interfaces/SyncBackendRpcInterface/index.md

@@ -0,0 +1,31 @@
+# SyncBackendRpcInterface
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:128](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L128)
+
+Durable Object interface supporting the DO RPC protocol for DO <> DO syncing.
+
+## Properties
+
+### \_\_DURABLE\_OBJECT\_BRAND
+
+> **\_\_DURABLE\_OBJECT\_BRAND**: `never`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:129](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L129)
+
+## Methods
+
+### rpc()
+
+> **rpc**(`payload`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| [`ReadableStream`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/readablestream/)\<`any`\>\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:130](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L130)
+
+#### Parameters
+
+##### payload
+
+`Uint8Array`
+
+#### Returns
+
+`Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| [`ReadableStream`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/readablestream/)\<`any`\>\>

package/docs/api/sync-cf/type-aliases/CFWorker/index.md

@@ -0,0 +1,47 @@
+# CFWorker
+
+> **CFWorker**\<`TEnv`, `_T`\> = `object`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/worker.ts:13](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/worker.ts#L13)
+
+## Type Parameters
+
+### TEnv
+
+`TEnv` *extends* [`Env`](/api/sync-cf/type-aliases/env/) = [`Env`](/api/sync-cf/type-aliases/env/)
+
+### _T
+
+`_T` *extends* [`DurableObjectBranded`](/api/sync-cf/livestore/namespaces/cftypes/namespaces/rpc/interfaces/durableobjectbranded/) \| `undefined` = `undefined`
+
+## Properties
+
+### fetch()
+
+> **fetch**: \<`CFHostMetada`\>(`request`, `env`, `ctx`) => `Promise`\<[`Response`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/response/)\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/worker.ts:14](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/worker.ts#L14)
+
+#### Type Parameters
+
+##### CFHostMetada
+
+`CFHostMetada` = `unknown`
+
+#### Parameters
+
+##### request
+
+[`Request`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/request/)\<`CFHostMetada`\>
+
+##### env
+
+`TEnv`
+
+##### ctx
+
+[`ExecutionContext`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/executioncontext/)
+
+#### Returns
+
+`Promise`\<[`Response`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/response/)\>

package/docs/api/sync-cf/type-aliases/DoObject/index.md

@@ -0,0 +1,11 @@
+# DoObject
+
+> **DoObject**\<`T`\> = [`DurableObject`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/durableobject/) & `T`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/do/durable-object.ts:43](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/do/durable-object.ts#L43)
+
+## Type Parameters
+
+### T
+
+`T`

package/docs/api/sync-cf/type-aliases/DoState/index.md

@@ -0,0 +1,5 @@
+# DoState
+
+> **DoState** = [`DurableObjectState`](/api/sync-cf/livestore/namespaces/cftypes/interfaces/durableobjectstate/)
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/do/durable-object.ts:42](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/do/durable-object.ts#L42)

package/docs/api/sync-cf/type-aliases/DurableObjectId/index.md

@@ -0,0 +1,5 @@
+# DurableObjectId
+
+> **DurableObjectId** = `string`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:72](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L72)

package/docs/api/sync-cf/type-aliases/Env/index.md

@@ -0,0 +1,5 @@
+# Env
+
+> **Env** = `object`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:8](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L8)

package/docs/api/sync-cf/type-aliases/MakeDurableObjectClass/index.md

@@ -0,0 +1,29 @@
+# MakeDurableObjectClass
+
+> **MakeDurableObjectClass** = (`options?`) => (`ctx`, `env`) => [`DoObject`](/api/sync-cf/type-aliases/doobject/)\<[`SyncBackendRpcInterface`](/api/sync-cf/interfaces/syncbackendrpcinterface/)\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/do/durable-object.ts:45](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/do/durable-object.ts#L45)
+
+## Parameters
+
+### options?
+
+[`MakeDurableObjectClassOptions`](/api/sync-cf/type-aliases/makedurableobjectclassoptions/)
+
+## Returns
+
+> (`ctx`, `env`): [`DoObject`](/api/sync-cf/type-aliases/doobject/)\<[`SyncBackendRpcInterface`](/api/sync-cf/interfaces/syncbackendrpcinterface/)\>
+
+### Parameters
+
+#### ctx
+
+[`DoState`](/api/sync-cf/type-aliases/dostate/)
+
+#### env
+
+[`Env`](/api/sync-cf/type-aliases/env/)
+
+### Returns
+
+[`DoObject`](/api/sync-cf/type-aliases/doobject/)\<[`SyncBackendRpcInterface`](/api/sync-cf/interfaces/syncbackendrpcinterface/)\>

package/docs/api/sync-cf/type-aliases/MakeDurableObjectClassOptions/index.md

@@ -0,0 +1,179 @@
+# MakeDurableObjectClassOptions
+
+> **MakeDurableObjectClassOptions** = `object`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:10](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L10)
+
+## Properties
+
+### enabledTransports?
+
+> `optional` **enabledTransports**: `Set`\<`"http"` \| `"ws"` \| `"do-rpc"`\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:43](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L43)
+
+Enabled transports for sync backend
+- `http`: HTTP JSON-RPC
+- `ws`: WebSocket
+- `do-rpc`: Durable Object RPC calls (only works in combination with `@livestore/adapter-cf`)
+
+#### Default
+
+```ts
+Set(['http', 'ws', 'do-rpc'])
+```
+
+***
+
+### http?
+
+> `optional` **http**: `object`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:61](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L61)
+
+Custom HTTP response headers for HTTP transport
+These headers will be added to all HTTP RPC responses (Pull, Push, Ping)
+
+#### responseHeaders?
+
+> `optional` **responseHeaders**: `Record`\<`string`, `string`\>
+
+#### Example
+
+```ts
+{
+  http: {
+    responseHeaders: {
+      'Access-Control-Allow-Origin': '*',
+      'Cache-Control': 'no-cache'
+    }
+  }
+}
+```
+
+***
+
+### onPull()?
+
+> `optional` **onPull**: (`message`, `context`) => `Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:16](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L16)
+
+#### Parameters
+
+##### message
+
+`SyncMessage.PullRequest`
+
+##### context
+
+###### payload?
+
+`Schema.JsonValue`
+
+###### storeId
+
+[`StoreId`](/api/sync-cf/type-aliases/storeid/)
+
+#### Returns
+
+`Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+***
+
+### onPullRes()?
+
+> `optional` **onPullRes**: (`message`) => `Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:20](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L20)
+
+#### Parameters
+
+##### message
+
+`SyncMessage.PullResponse` | `InvalidPullError`
+
+#### Returns
+
+`Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+***
+
+### onPush()?
+
+> `optional` **onPush**: (`message`, `context`) => `Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:11](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L11)
+
+#### Parameters
+
+##### message
+
+`SyncMessage.PushRequest`
+
+##### context
+
+###### payload?
+
+`Schema.JsonValue`
+
+###### storeId
+
+[`StoreId`](/api/sync-cf/type-aliases/storeid/)
+
+#### Returns
+
+`Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+***
+
+### onPushRes()?
+
+> `optional` **onPushRes**: (`message`) => `Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:15](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L15)
+
+#### Parameters
+
+##### message
+
+`SyncMessage.PushAck` | `InvalidPushError`
+
+#### Returns
+
+`Effect.SyncOrPromiseOrEffect`\<`void`\>
+
+***
+
+### otel?
+
+> `optional` **otel**: `object`
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:65](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L65)
+
+#### baseUrl?
+
+> `optional` **baseUrl**: `string`
+
+#### serviceName?
+
+> `optional` **serviceName**: `string`
+
+***
+
+### storage?
+
+> `optional` **storage**: \{ `_tag`: `"do-sqlite"`; \} \| \{ `_tag`: `"d1"`; `binding`: `string`; \}
+
+Defined in: [submodules/livestore/packages/@livestore/sync-cf/src/cf-worker/shared.ts:33](https://github.com/livestorejs/livestore/blob/e27f6dd63400fece0f2344d09d3e47f57ecc98e7/packages/@livestore/sync-cf/src/cf-worker/shared.ts#L33)
+
+Storage engine for event persistence.
+- Default: `{ _tag: 'do-sqlite' }` (Durable Object SQLite)
+- D1: `{ _tag: 'd1', binding: string }` where `binding` is the D1 binding name in wrangler.toml.
+
+If omitted, the runtime defaults to DO SQLite. For backwards-compatibility, if an env binding named
+`DB` exists and looks like a D1Database, D1 will be used.
+
+Trade-offs:
+- DO SQLite: simpler deploy, data co-located with DO, not externally queryable
+- D1: centralized DB, inspectable with DB tools, extra network hop and JSON size limits