@livestore/adapter-web 0.4.0-dev.9 → 0.5.0-dev.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/README.md +5 -5
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/in-memory/in-memory-adapter.d.ts +50 -8
  4. package/dist/in-memory/in-memory-adapter.d.ts.map +1 -1
  5. package/dist/in-memory/in-memory-adapter.js +100 -39
  6. package/dist/in-memory/in-memory-adapter.js.map +1 -1
  7. package/dist/index.d.ts +11 -1
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.js +11 -1
  10. package/dist/index.js.map +1 -1
  11. package/dist/single-tab/mod.d.ts +15 -0
  12. package/dist/single-tab/mod.d.ts.map +1 -0
  13. package/dist/single-tab/mod.js +15 -0
  14. package/dist/single-tab/mod.js.map +1 -0
  15. package/dist/single-tab/single-tab-adapter.d.ts +108 -0
  16. package/dist/single-tab/single-tab-adapter.d.ts.map +1 -0
  17. package/dist/single-tab/single-tab-adapter.js +252 -0
  18. package/dist/single-tab/single-tab-adapter.js.map +1 -0
  19. package/dist/web-worker/client-session/client-session-devtools.d.ts +4 -5
  20. package/dist/web-worker/client-session/client-session-devtools.d.ts.map +1 -1
  21. package/dist/web-worker/client-session/client-session-devtools.js +27 -14
  22. package/dist/web-worker/client-session/client-session-devtools.js.map +1 -1
  23. package/dist/web-worker/client-session/devtools-web-channel.d.ts +20 -0
  24. package/dist/web-worker/client-session/devtools-web-channel.d.ts.map +1 -0
  25. package/dist/web-worker/client-session/devtools-web-channel.js +34 -0
  26. package/dist/web-worker/client-session/devtools-web-channel.js.map +1 -0
  27. package/dist/web-worker/client-session/persisted-adapter.d.ts +18 -0
  28. package/dist/web-worker/client-session/persisted-adapter.d.ts.map +1 -1
  29. package/dist/web-worker/client-session/persisted-adapter.js +170 -103
  30. package/dist/web-worker/client-session/persisted-adapter.js.map +1 -1
  31. package/dist/web-worker/client-session/sqlite-loader.d.ts +2 -0
  32. package/dist/web-worker/client-session/sqlite-loader.d.ts.map +1 -0
  33. package/dist/web-worker/client-session/sqlite-loader.js +16 -0
  34. package/dist/web-worker/client-session/sqlite-loader.js.map +1 -0
  35. package/dist/web-worker/common/persisted-sqlite.d.ts +15 -35
  36. package/dist/web-worker/common/persisted-sqlite.d.ts.map +1 -1
  37. package/dist/web-worker/common/persisted-sqlite.js +91 -201
  38. package/dist/web-worker/common/persisted-sqlite.js.map +1 -1
  39. package/dist/web-worker/common/rpc-worker.d.ts +14 -0
  40. package/dist/web-worker/common/rpc-worker.d.ts.map +1 -0
  41. package/dist/web-worker/common/rpc-worker.js +8 -0
  42. package/dist/web-worker/common/rpc-worker.js.map +1 -0
  43. package/dist/web-worker/common/shutdown-channel.d.ts +3 -2
  44. package/dist/web-worker/common/shutdown-channel.d.ts.map +1 -1
  45. package/dist/web-worker/common/shutdown-channel.js +2 -2
  46. package/dist/web-worker/common/shutdown-channel.js.map +1 -1
  47. package/dist/web-worker/common/webmesh-node-names.d.ts +4 -0
  48. package/dist/web-worker/common/webmesh-node-names.d.ts.map +1 -0
  49. package/dist/web-worker/common/webmesh-node-names.js +2 -0
  50. package/dist/web-worker/common/webmesh-node-names.js.map +1 -0
  51. package/dist/web-worker/common/worker-disconnect-channel.d.ts +3 -10
  52. package/dist/web-worker/common/worker-disconnect-channel.d.ts.map +1 -1
  53. package/dist/web-worker/common/worker-disconnect-channel.js +4 -4
  54. package/dist/web-worker/common/worker-disconnect-channel.js.map +1 -1
  55. package/dist/web-worker/common/worker-schema.d.ts +295 -146
  56. package/dist/web-worker/common/worker-schema.d.ts.map +1 -1
  57. package/dist/web-worker/common/worker-schema.js +89 -54
  58. package/dist/web-worker/common/worker-schema.js.map +1 -1
  59. package/dist/web-worker/leader-worker/make-leader-worker.d.ts +6 -6
  60. package/dist/web-worker/leader-worker/make-leader-worker.d.ts.map +1 -1
  61. package/dist/web-worker/leader-worker/make-leader-worker.js +191 -80
  62. package/dist/web-worker/leader-worker/make-leader-worker.js.map +1 -1
  63. package/dist/web-worker/shared-worker/make-shared-worker.d.ts +2 -1
  64. package/dist/web-worker/shared-worker/make-shared-worker.d.ts.map +1 -1
  65. package/dist/web-worker/shared-worker/make-shared-worker.js +91 -94
  66. package/dist/web-worker/shared-worker/make-shared-worker.js.map +1 -1
  67. package/dist/web-worker/vite-dev-polyfill.js +1 -2
  68. package/dist/web-worker/vite-dev-polyfill.js.map +1 -1
  69. package/package.json +47 -19
  70. package/src/in-memory/in-memory-adapter.ts +147 -73
  71. package/src/index.ts +15 -1
  72. package/src/single-tab/mod.ts +15 -0
  73. package/src/single-tab/single-tab-adapter.ts +499 -0
  74. package/src/web-worker/ambient.d.ts +7 -24
  75. package/src/web-worker/client-session/client-session-devtools.ts +47 -25
  76. package/src/web-worker/client-session/devtools-web-channel.ts +57 -0
  77. package/src/web-worker/client-session/persisted-adapter.ts +259 -163
  78. package/src/web-worker/client-session/sqlite-loader.ts +19 -0
  79. package/src/web-worker/common/persisted-sqlite.ts +204 -309
  80. package/src/web-worker/common/rpc-worker.ts +39 -0
  81. package/src/web-worker/common/shutdown-channel.ts +10 -3
  82. package/src/web-worker/common/webmesh-node-names.ts +1 -0
  83. package/src/web-worker/common/worker-disconnect-channel.ts +11 -4
  84. package/src/web-worker/common/worker-schema.ts +138 -131
  85. package/src/web-worker/leader-worker/make-leader-worker.ts +396 -194
  86. package/src/web-worker/shared-worker/make-shared-worker.ts +143 -146
  87. package/src/web-worker/vite-dev-polyfill.ts +1 -2
  88. package/dist/opfs-utils.d.ts +0 -7
  89. package/dist/opfs-utils.d.ts.map +0 -1
  90. package/dist/opfs-utils.js +0 -43
  91. package/dist/opfs-utils.js.map +0 -1
  92. package/src/opfs-utils.ts +0 -61
@@ -5,29 +5,48 @@ import {
5
5
  type LockStatus,
6
6
  makeClientSession,
7
7
  migrateDb,
8
+ StateHead,
8
9
  type SyncOptions,
9
- UnexpectedError,
10
+ UnknownError,
10
11
  } from '@livestore/common'
11
12
  import type { DevtoolsOptions, LeaderSqliteDb } from '@livestore/common/leader-thread'
12
- import { configureConnection, Eventlog, LeaderThreadCtx, makeLeaderThreadLayer } from '@livestore/common/leader-thread'
13
+ import {
14
+ configureConnection,
15
+ Eventlog,
16
+ LeaderThreadCtx,
17
+ makeLeaderThreadLayer,
18
+ streamEventsWithSyncState,
19
+ } from '@livestore/common/leader-thread'
13
20
  import type { LiveStoreSchema } from '@livestore/common/schema'
14
21
  import { LiveStoreEvent } from '@livestore/common/schema'
15
- import * as DevtoolsWeb from '@livestore/devtools-web-common/web-channel'
16
- import type * as WebmeshWorker from '@livestore/devtools-web-common/worker'
17
22
  import type { MakeWebSqliteDb } from '@livestore/sqlite-wasm/browser'
18
23
  import { sqliteDbFactory } from '@livestore/sqlite-wasm/browser'
19
- import { loadSqlite3Wasm } from '@livestore/sqlite-wasm/load-wasm'
20
24
  import { tryAsFunctionAndNew } from '@livestore/utils'
21
- import type { Schema, Scope } from '@livestore/utils/effect'
22
- import { BrowserWorker, Effect, FetchHttpClient, Fiber, Layer, SubscriptionRef, Worker } from '@livestore/utils/effect'
25
+ import {
26
+ type Scope,
27
+ Effect,
28
+ FetchHttpClient,
29
+ Layer,
30
+ Queue,
31
+ RpcClient,
32
+ type Schema,
33
+ SubscriptionRef,
34
+ } from '@livestore/utils/effect'
35
+ import { BrowserWorker } from '@livestore/utils/effect/browser'
23
36
  import { nanoid } from '@livestore/utils/nanoid'
24
37
  import * as Webmesh from '@livestore/webmesh'
38
+ import * as WebmeshWorker from '@livestore/webmesh/worker'
25
39
 
26
40
  import { connectWebmeshNodeClientSession } from '../web-worker/client-session/client-session-devtools.ts'
41
+ import { loadSqlite3 } from '../web-worker/client-session/sqlite-loader.ts'
42
+ import {
43
+ dieOnRpcClientError,
44
+ makeWebmeshWorkerProxy,
45
+ type WebmeshWorkerProxy,
46
+ } from '../web-worker/common/rpc-worker.ts'
27
47
  import { makeShutdownChannel } from '../web-worker/common/shutdown-channel.ts'
28
-
29
- // NOTE we're starting to initialize the sqlite wasm binary here to speed things up
30
- const sqlite3Promise = loadSqlite3Wasm()
48
+ import { makeSharedWorkerNodeName } from '../web-worker/common/webmesh-node-names.ts'
49
+ import * as WorkerSchema from '../web-worker/common/worker-schema.ts'
31
50
 
32
51
  export interface InMemoryAdapterOptions {
33
52
  importSnapshot?: Uint8Array<ArrayBuffer>
@@ -49,41 +68,86 @@ export interface InMemoryAdapterOptions {
49
68
  devtools?: {
50
69
  sharedWorker:
51
70
  | ((options: { name: string }) => globalThis.SharedWorker)
52
- | (new (options: {
53
- name: string
54
- }) => globalThis.SharedWorker)
71
+ | (new (options: { name: string }) => globalThis.SharedWorker)
55
72
  }
56
73
  }
57
74
 
75
+ /**
76
+ * Creates a web-only in-memory LiveStore adapter.
77
+ *
78
+ * This adapter runs entirely in memory with no persistence. Ideal for:
79
+ * - Unit tests and integration tests
80
+ * - Sandboxes and demos
81
+ * - Ephemeral sessions where persistence isn't needed
82
+ *
83
+ * **Characteristics:**
84
+ * - Fast, zero I/O overhead
85
+ * - Works in all browser contexts: Window, WebWorker, SharedWorker, ServiceWorker
86
+ * - Supports optional sync backends for real-time collaboration
87
+ * - No data persists after page reload
88
+ *
89
+ * For persistent storage, use `makePersistedAdapter` instead.
90
+ *
91
+ * @example
92
+ * ```ts
93
+ * import { makeInMemoryAdapter } from '@livestore/adapter-web'
94
+ *
95
+ * const adapter = makeInMemoryAdapter()
96
+ * ```
97
+ *
98
+ * @example
99
+ * ```ts
100
+ * // With sync backend for real-time collaboration
101
+ * import { makeInMemoryAdapter } from '@livestore/adapter-web'
102
+ * import { makeWsSync } from '@livestore/sync-cf/client'
103
+ *
104
+ * const adapter = makeInMemoryAdapter({
105
+ * sync: {
106
+ * backend: makeWsSync({ url: 'wss://api.example.com/sync' }),
107
+ * },
108
+ * })
109
+ * ```
110
+ *
111
+ * @example
112
+ * ```ts
113
+ * // Pre-populate with existing data
114
+ * const adapter = makeInMemoryAdapter({
115
+ * importSnapshot: existingDbSnapshot,
116
+ * })
117
+ * ```
118
+ */
58
119
  export const makeInMemoryAdapter =
59
120
  (options: InMemoryAdapterOptions = {}): Adapter =>
60
121
  (adapterArgs) =>
61
122
  Effect.gen(function* () {
62
- const { schema, shutdown, syncPayload, storeId, devtoolsEnabled } = adapterArgs
63
- const sqlite3 = yield* Effect.promise(() => sqlite3Promise)
123
+ const { schema, shutdown, syncPayloadEncoded, syncPayloadSchema, storeId, devtoolsEnabled } = adapterArgs
124
+ const sqlite3 = yield* Effect.promise(() => loadSqlite3())
64
125
 
65
126
  const sqliteDb = yield* sqliteDbFactory({ sqlite3 })({ _tag: 'in-memory' })
66
127
 
67
128
  const clientId = options.clientId ?? nanoid(6)
68
129
  const sessionId = options.sessionId ?? nanoid(6)
69
130
 
70
- const sharedWebWorker = options.devtools?.sharedWorker
71
- ? tryAsFunctionAndNew(options.devtools.sharedWorker, {
72
- name: `livestore-shared-worker-${storeId}`,
73
- })
74
- : undefined
75
-
76
- const sharedWorkerFiber = sharedWebWorker
77
- ? yield* Worker.makePoolSerialized<typeof WebmeshWorker.Schema.Request.Type>({
78
- size: 1,
79
- concurrency: 100,
80
- }).pipe(
81
- Effect.provide(BrowserWorker.layer(() => sharedWebWorker)),
82
- Effect.tapCauseLogPretty,
83
- UnexpectedError.mapToUnexpectedError,
84
- Effect.forkScoped,
85
- )
86
- : undefined
131
+ const sharedWebWorker =
132
+ options.devtools?.sharedWorker !== undefined
133
+ ? tryAsFunctionAndNew(options.devtools.sharedWorker, {
134
+ name: `livestore-shared-worker-${storeId}`,
135
+ })
136
+ : undefined
137
+
138
+ const sharedWorkerClient =
139
+ sharedWebWorker !== undefined
140
+ ? yield* RpcClient.make(WorkerSchema.SharedWorkerRpcs).pipe(
141
+ Effect.provide(
142
+ Layer.provideMerge(
143
+ RpcClient.layerProtocolWorker({ size: 1, concurrency: 100 }),
144
+ BrowserWorker.layer(() => sharedWebWorker),
145
+ ),
146
+ ),
147
+ Effect.tapCauseLogPretty,
148
+ UnknownError.mapToUnknownError,
149
+ )
150
+ : undefined
87
151
 
88
152
  const { leaderThread, initialSnapshot } = yield* makeLeaderThread({
89
153
  schema,
@@ -91,10 +155,11 @@ export const makeInMemoryAdapter =
91
155
  clientId,
92
156
  makeSqliteDb: sqliteDbFactory({ sqlite3 }),
93
157
  syncOptions: options.sync,
94
- syncPayload,
158
+ syncPayloadEncoded,
159
+ syncPayloadSchema,
95
160
  importSnapshot: options.importSnapshot,
96
161
  devtoolsEnabled,
97
- sharedWorkerFiber,
162
+ sharedWorker: sharedWorkerClient === undefined ? undefined : makeWebmeshWorkerProxy(sharedWorkerClient),
98
163
  })
99
164
 
100
165
  sqliteDb.import(initialSnapshot)
@@ -111,15 +176,21 @@ export const makeInMemoryAdapter =
111
176
  lockStatus,
112
177
  shutdown,
113
178
  webmeshMode: 'direct',
179
+ // Can be undefined in Node.js
180
+ origin: globalThis.location?.origin,
114
181
  connectWebmeshNode: ({ sessionInfo, webmeshNode }) =>
115
182
  Effect.gen(function* () {
116
- if (sharedWorkerFiber === undefined || devtoolsEnabled === false) {
183
+ if (sharedWorkerClient === undefined || devtoolsEnabled === false) {
117
184
  return
118
185
  }
119
186
 
120
- const sharedWorker = yield* sharedWorkerFiber.pipe(Fiber.join)
121
-
122
- yield* connectWebmeshNodeClientSession({ webmeshNode, sessionInfo, sharedWorker, devtoolsEnabled, schema })
187
+ yield* connectWebmeshNodeClientSession({
188
+ webmeshNode,
189
+ sessionInfo,
190
+ sharedWorker: makeWebmeshWorkerProxy(sharedWorkerClient),
191
+ devtoolsEnabled,
192
+ schema,
193
+ })
123
194
  }),
124
195
  registerBeforeUnload: (onBeforeUnload) => {
125
196
  if (typeof window !== 'undefined' && typeof window.addEventListener === 'function') {
@@ -132,7 +203,7 @@ export const makeInMemoryAdapter =
132
203
  })
133
204
 
134
205
  return clientSession
135
- }).pipe(UnexpectedError.mapToUnexpectedError, Effect.provide(FetchHttpClient.layer))
206
+ }).pipe(UnknownError.mapToUnknownError, Effect.provide(FetchHttpClient.layer))
136
207
 
137
208
  export interface MakeLeaderThreadArgs {
138
209
  schema: LiveStoreSchema
@@ -140,10 +211,11 @@ export interface MakeLeaderThreadArgs {
140
211
  clientId: string
141
212
  makeSqliteDb: MakeWebSqliteDb
142
213
  syncOptions: SyncOptions | undefined
143
- syncPayload: Schema.JsonValue | undefined
214
+ syncPayloadEncoded: Schema.Json | undefined
215
+ syncPayloadSchema: Schema.Top | undefined
144
216
  importSnapshot: Uint8Array<ArrayBuffer> | undefined
145
217
  devtoolsEnabled: boolean
146
- sharedWorkerFiber: SharedWorkerFiber | undefined
218
+ sharedWorker: WebmeshWorkerProxy | undefined
147
219
  }
148
220
 
149
221
  const makeLeaderThread = ({
@@ -152,19 +224,19 @@ const makeLeaderThread = ({
152
224
  clientId,
153
225
  makeSqliteDb,
154
226
  syncOptions,
155
- syncPayload,
227
+ syncPayloadEncoded,
228
+ syncPayloadSchema,
156
229
  importSnapshot,
157
230
  devtoolsEnabled,
158
- sharedWorkerFiber,
231
+ sharedWorker,
159
232
  }: MakeLeaderThreadArgs) =>
160
233
  Effect.gen(function* () {
161
- const runtime = yield* Effect.runtime<never>()
234
+ const services = yield* Effect.context()
162
235
 
163
236
  const makeDb = (_kind: 'state' | 'eventlog') => {
164
237
  return makeSqliteDb({
165
238
  _tag: 'in-memory',
166
- configureDb: (db) =>
167
- configureConnection(db, { foreignKeys: true }).pipe(Effect.provide(runtime), Effect.runSync),
239
+ configureDb: (db) => configureConnection(db, { foreignKeys: true }).pipe(Effect.runSyncWith(services)),
168
240
  })
169
241
  }
170
242
 
@@ -173,7 +245,7 @@ const makeLeaderThread = ({
173
245
  // Might involve some async work, so we're running them concurrently
174
246
  const [dbState, dbEventlog] = yield* Effect.all([makeDb('state'), makeDb('eventlog')], { concurrency: 2 })
175
247
 
176
- if (importSnapshot) {
248
+ if (importSnapshot !== undefined) {
177
249
  dbState.import(importSnapshot)
178
250
 
179
251
  const _migrationsReport = yield* migrateDb({ db: dbState, schema })
@@ -181,7 +253,7 @@ const makeLeaderThread = ({
181
253
 
182
254
  const devtoolsOptions = yield* makeDevtoolsOptions({
183
255
  devtoolsEnabled,
184
- sharedWorkerFiber,
256
+ sharedWorker,
185
257
  dbState,
186
258
  dbEventlog,
187
259
  storeId,
@@ -199,29 +271,38 @@ const makeLeaderThread = ({
199
271
  dbEventlog,
200
272
  devtoolsOptions,
201
273
  shutdownChannel,
202
- syncPayload,
203
- }),
274
+ syncPayloadEncoded,
275
+ syncPayloadSchema: syncPayloadSchema as Schema.Decoder<Schema.Json, never> | undefined,
276
+ }).pipe(Layer.provide(StateHead.layer({ dbState }))),
204
277
  )
205
278
 
206
279
  return yield* Effect.gen(function* () {
207
- const { dbState, dbEventlog, syncProcessor, extraIncomingMessagesQueue, initialState } = yield* LeaderThreadCtx
280
+ const { dbState, dbEventlog, syncProcessor, extraIncomingMessagesQueue, initialState, networkStatus } =
281
+ yield* LeaderThreadCtx
208
282
 
209
283
  const initialLeaderHead = Eventlog.getClientHeadFromDb(dbEventlog)
210
284
 
211
285
  const leaderThread = ClientSessionLeaderThreadProxy.of({
212
286
  events: {
213
287
  pull: ({ cursor }) => syncProcessor.pull({ cursor }),
214
- push: (batch) =>
215
- syncProcessor.push(
216
- batch.map((item) => new LiveStoreEvent.EncodedWithMeta(item)),
217
- { waitForProcessing: true },
218
- ),
288
+ push: (batch) => syncProcessor.push(batch.map((item) => new LiveStoreEvent.Client.EncodedWithMeta(item))),
289
+ stream: (options) =>
290
+ streamEventsWithSyncState({
291
+ dbEventlog,
292
+ syncState: syncProcessor.syncState,
293
+ options,
294
+ }),
295
+ },
296
+ initialState: {
297
+ leaderHead: initialLeaderHead,
298
+ migrationsReport: initialState.migrationsReport,
299
+ storageMode: 'in-memory',
219
300
  },
220
- initialState: { leaderHead: initialLeaderHead, migrationsReport: initialState.migrationsReport },
221
301
  export: Effect.sync(() => dbState.export()),
222
302
  getEventlogData: Effect.sync(() => dbEventlog.export()),
223
- getSyncState: syncProcessor.syncState,
224
- sendDevtoolsMessage: (message) => extraIncomingMessagesQueue.offer(message),
303
+ syncState: syncProcessor.syncState,
304
+ sendDevtoolsMessage: (message) => Queue.offer(extraIncomingMessagesQueue, message),
305
+ networkStatus,
225
306
  })
226
307
 
227
308
  const initialSnapshot = dbState.export()
@@ -230,28 +311,23 @@ const makeLeaderThread = ({
230
311
  }).pipe(Effect.provide(layer))
231
312
  })
232
313
 
233
- type SharedWorkerFiber = Fiber.Fiber<
234
- Worker.SerializedWorkerPool<typeof WebmeshWorker.Schema.Request.Type>,
235
- UnexpectedError
236
- >
237
-
238
314
  const makeDevtoolsOptions = ({
239
315
  devtoolsEnabled,
240
- sharedWorkerFiber,
316
+ sharedWorker,
241
317
  dbState,
242
318
  dbEventlog,
243
319
  storeId,
244
320
  clientId,
245
321
  }: {
246
322
  devtoolsEnabled: boolean
247
- sharedWorkerFiber: SharedWorkerFiber | undefined
323
+ sharedWorker: WebmeshWorkerProxy | undefined
248
324
  dbState: LeaderSqliteDb
249
325
  dbEventlog: LeaderSqliteDb
250
326
  storeId: string
251
327
  clientId: string
252
- }): Effect.Effect<DevtoolsOptions, UnexpectedError, Scope.Scope> =>
328
+ }): Effect.Effect<DevtoolsOptions, UnknownError, Scope.Scope> =>
253
329
  Effect.gen(function* () {
254
- if (devtoolsEnabled === false || sharedWorkerFiber === undefined) {
330
+ if (devtoolsEnabled === false || sharedWorker === undefined) {
255
331
  return { enabled: false }
256
332
  }
257
333
 
@@ -267,17 +343,15 @@ const makeDevtoolsOptions = ({
267
343
  // @ts-expect-error TODO type this
268
344
  globalThis.__debugWebmeshNodeLeader = node
269
345
 
270
- const sharedWorker = yield* sharedWorkerFiber.pipe(Fiber.join)
271
-
272
346
  // TODO also make this work with the browser extension
273
347
  // basic idea: instead of also connecting to the shared worker,
274
348
  // connect to the client session node above which will already connect to the shared worker + browser extension
275
349
 
276
- yield* DevtoolsWeb.connectViaWorker({
350
+ yield* WebmeshWorker.connectViaWorker({
277
351
  node,
278
352
  worker: sharedWorker,
279
- target: DevtoolsWeb.makeNodeName.sharedWorker({ storeId }),
280
- }).pipe(Effect.tapCauseLogPretty, Effect.forkScoped)
353
+ target: makeSharedWorkerNodeName({ storeId }),
354
+ }).pipe(Effect.tapCauseLogPretty, dieOnRpcClientError, Effect.forkScoped)
281
355
 
282
356
  return { node, persistenceInfo, mode: 'direct' }
283
357
  }),
package/src/index.ts CHANGED
@@ -1,3 +1,17 @@
1
1
  export { makeInMemoryAdapter } from './in-memory/in-memory-adapter.ts'
2
- export { makePersistedAdapter, type WebAdapterOptions } from './web-worker/client-session/persisted-adapter.ts'
2
+ /**
3
+ * Single-tab adapter for browsers without SharedWorker support (e.g. Android Chrome).
4
+ *
5
+ * In most cases, you should use `makePersistedAdapter` instead, which automatically
6
+ * falls back to single-tab mode when SharedWorker is unavailable.
7
+ *
8
+ * @see https://github.com/livestorejs/livestore/issues/321
9
+ * @see https://issues.chromium.org/issues/40290702
10
+ */
11
+ export { makeSingleTabAdapter, type SingleTabAdapterOptions } from './single-tab/mod.ts'
12
+ export {
13
+ canUseSharedWorker,
14
+ makePersistedAdapter,
15
+ type WebAdapterOptions,
16
+ } from './web-worker/client-session/persisted-adapter.ts'
3
17
  export * as WorkerSchema from './web-worker/common/worker-schema.ts'
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Single-tab adapter module for browsers without SharedWorker support.
3
+ *
4
+ * **NOTE**: This module exists as a fallback for Android Chrome and similar browsers
5
+ * that don't support SharedWorker. It is intended to be deprecated and removed once
6
+ * SharedWorker support is available in these browsers.
7
+ *
8
+ * Track progress:
9
+ * - LiveStore issue: https://github.com/livestorejs/livestore/issues/321
10
+ * - Chromium bug: https://issues.chromium.org/issues/40290702
11
+ *
12
+ * @module
13
+ */
14
+
15
+ export { makeSingleTabAdapter, type SingleTabAdapterOptions } from './single-tab-adapter.ts'