[gjtorikian]

Summary

• Adds @workos/sync-mongodb, a MongoDB 5.0+ destination with the same CLI, container image, and Destination semantics as the SQL packages: workos_* collections in the application's database, _live views that hide tombstones, the single-writer lease, the fenced checkpoint, server-side reconcile, and the quarantine store.
• Every write is one update pipeline with upsert: true, so the staleness gate runs in the same operation that writes; payloads go in as $literal so a string like "$100 plan" is never read as a field path. $mergeObjects gives the shallow merge the contract asks for.
• The lease and every cursor for an environment share one document, which makes setStateIfHeld a single conditional updateOne with no transaction, so a standalone mongod, a replica set, and Atlas all behave the same. Cursors are stored as canonical JSON because document equality in MongoDB is field-order sensitive and the engine's is not.
• Catalog columns become indexes on _raw.<path>; there are no generated fields and so no column drift. Timestamps go through a strict ISO-8601 parser because new Date() accepts 2026-02-30.

Testing

158 tests on an embedded mongod 8.0.4 (mongodb-memory-server, binary downloaded lazily and cached in CI), spot-checked against a mongo:8 container. CI gains a MongoDB job, the Docker workflow gains the mongodb matrix entry, and release-please gains the package. The image builds and streams runs from it.

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no new actionable issues remain.

Summary

Adds @workos/sync-mongodb with MongoDB writes, generated indexes and live views, checkpoints, leases, reconciliation, and quarantine storage.

• MongoDB stores each WorkOS record with its sync metadata.
• MongoDB keeps each listener's lease beside its cursors.
• MongoDB compares mirrored records with the records returned by WorkOS.
• Failed events stay available for review and replay.
• Operators can run and monitor the MongoDB sync from one CLI.
• The MongoDB package is ready to install, test, build, and release.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  E[Sync engine] --> D[MongoDB destination]
  D --> M[Mirror collections]
  M --> V[Live views]
  D --> S[Lease and cursor document]
  D --> Q[Quarantined events]
  D --> R[Reconcile staging collections]
  R --> M

Loading

_{Reviews (7) · Last reviewed commit: "ci(mongodb): publish sync-mongodb releas..." · Reviewed by Greptile}