Add SyncedDocumentOptions

[peachbits]

CHANGELOG

Does this branch warrant an entry to the CHANGELOG?

• Yes
• No

Dependencies

none

Description

none

---

Note

Medium Risk
Changes how syncedDocument.sync behaves when the cleaner throws, which can affect what gets written back to CouchDB and what in-memory state is retained. Risk is mitigated by new unit tests but could impact consumers relying on previous failure semantics.

Overview
Adds optional SyncedDocumentOptions to syncedDocument, allowing callers to control cleaner failure behavior via cleanFailStrategy (reset to defaults or preserve last good value) and an onCleanFail callback.

Updates syncedDocument.sync to catch cleaner exceptions, invoke onCleanFail, and choose the fallback document based on the configured strategy before continuing the usual repair/writeback flow. Includes a new test suite covering creation, dirty repair, change notifications, and both failure strategies, and documents the change in CHANGELOG.md.

^{Written by Cursor Bugbot for commit 20b3564. This will update automatically on new commits. Configure here.}

[peachbits]

This PR replaces #36 which was merged before cleaning up