refactor: migrate ClientSessionSyncProcessor’s materializeEvent() to Effect

[IGassmann]

This migrates ClientSessionSyncProcessor’s materializeEvent() to Effect to make it easier to instrument it with OpenTelemetry.

Caution

DO NOT MERGE!

This is a stacked PR. To preserve logical order, and a clean commit history, these must be merged from the bottom upwards. I'll handle the merges and rebases myself, as it can be tricky to do properly.

Merge order:

1. refactor: migrate ClientSessionSyncProcessor.push() to Effect #375 (base)
2. refactor: migrate ClientSessionSyncProcessor’s materializeEvent() to Effect #376
3. refactor: migrate store.commit to Effect #381 (top)

Checklist

• I grant to recipients of this Project distribution a perpetual,
  non-exclusive, royalty-free, irrevocable copyright license to reproduce, prepare
  derivative works of, publicly display, sublicense, and distribute this
  Contribution and such derivative works.
• I certify that I am legally entitled to grant this license, and that this
  Contribution contains no content requiring a license from any third party.

[CLAassistant]

All committers have signed the CLA.

[Copilot]

Pull Request Overview

This PR refactors the ClientSessionSyncProcessor’s materializeEvent implementation to use Effect for improved instrumentability with OpenTelemetry. Key changes include:

• Updating snapshot files to include a new children field for materialize-event.
• Refactoring materializeEvent in store.ts to use Effect.fn and Effect.gen.
• Updating ClientSessionSyncProcessor to yield* the new materializeEvent effect.

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
packages/@livestore/react/src/snapshots/useClientDocument.test.tsx.snap	Updated snapshots with the new children property for materialize-event.
packages/@livestore/livestore/src/store/store.ts	Transformed materializeEvent to use Effect, with changes to error handling and asynchronous behavior.
packages/@livestore/livestore/src/live-queries/snapshots/db-query.test.ts.snap	Updated snapshots to include new children for materialize-event.
packages/@livestore/common/src/sync/ClientSessionSyncProcessor.ts	Adjusted the materializeEvent signature and added yield* calls to invoke the new effect.

Comments suppressed due to low confidence (1)

packages/@livestore/livestore/src/store/store.ts:155

• Consider wrapping the sqliteDbWrapper.cachedExecute call within a try-catch block inside the Effect.sync callback to preserve the error context from the previous implementation. If relying solely on the effect's error channel, ensure that the absence of a custom error wrapper does not impact debugging or error tracing.

this.sqliteDbWrapper.cachedExecute(statementSql, bindValues, { otelContext, writeTables })