engine/

directory
v0.10.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 20, 2026 License: MIT

Directories

Path Synopsis
Package blob defines how the engine names and stores blobs: the immutable bytes, such as images, PDFs and videos, that rows refer to with a syncplane.v1.BlobRef.
Package blob defines how the engine names and stores blobs: the immutable bytes, such as images, PDFs and videos, that rows refer to with a syncplane.v1.BlobRef.
blobtest
Package blobtest provides a shared Ginkgo behavior suite every blob.Store implementation must pass.
Package blobtest provides a shared Ginkgo behavior suite every blob.Store implementation must pass.
fsstore
Package fsstore is a blob.Store that keeps blobs in a local directory.
Package fsstore is a blob.Store that keeps blobs in a local directory.
memstore
Package memstore is a blob.Store that keeps everything in memory.
Package memstore is a blob.Store that keeps everything in memory.
Package client is a Go client for a remote syncplane server, for code that keeps no local copy of the data: backend jobs, tools and tests.
Package client is a Go client for a remote syncplane server, for code that keeps no local copy of the data: backend jobs, tools and tests.
Package connect binds the sync engine to an external source of truth — an adopter-owned store the engine does not manage (a folder of files, an existing database) — and keeps the two converged bidirectionally.
Package connect binds the sync engine to an external source of truth — an adopter-owned store the engine does not manage (a folder of files, an existing database) — and keeps the two converged bidirectionally.
sqlitestate
Package sqlitestate implements connect.State on SQLite via modernc.org/sqlite (pure Go, no CGO) — the shipped default for connector bookkeeping.
Package sqlitestate implements connect.State on SQLite via modernc.org/sqlite (pure Go, no CGO) — the shipped default for connector bookkeeping.
Package cursorstate stores the bulky membership tail of pull cursors — the subscription set and the windowed/closure key-sets — so the cursor a client carries is a fixed-size reference instead of a restatement of everything it holds.
Package cursorstate stores the bulky membership tail of pull cursors — the subscription set and the windowed/closure key-sets — so the cursor a client carries is a fixed-size reference instead of a restatement of everything it holds.
Package effects runs server-side reactions to committed changes: webhooks, notifications, search indexing, agents — anything that should happen after a row is written and is not itself part of the write.
Package effects runs server-side reactions to committed changes: webhooks, notifications, search indexing, agents — anything that should happen after a row is written and is not itself part of the write.
Package fractional makes order keys: strings that sort a list and that always have room for one more key between any two of them.
Package fractional makes order keys: strings that sort a list and that always have room for one more key between any two of them.
gen
Package id generates time-ordered entity identifiers: a UUIDv7 (RFC 9562) rendered as 26-character Crockford base32.
Package id generates time-ordered entity identifiers: a UUIDv7 (RFC 9562) rendered as 26-character Crockford base32.
internal
lww
Package lww merges PATCH mutations into row snapshots using field masks.
Package lww merges PATCH mutations into row snapshots using field masks.
naming
Package naming holds the naming rules of the sync engine: what an entity may be called, what a workspace may be identified by, which fields may form a row key, how their values render into one, and what the resulting key may contain.
Package naming holds the naming rules of the sync engine: what an entity may be called, what a workspace may be identified by, which fields may form a row key, how their values render into one, and what the resulting key may contain.
pgtest
Package pgtest supplies the live Postgres the pgstore, pglisten, pgnotify and pgpresence suites run against.
Package pgtest supplies the live Postgres the pgstore, pglisten, pgnotify and pgpresence suites run against.
pubsub
Package pubsub provides change-notification fan-out.
Package pubsub provides change-notification fan-out.
pubsub/pubsubtest
Package pubsubtest provides a shared Ginkgo behavior suite every pubsub.Notifier implementation must pass.
Package pubsubtest provides a shared Ginkgo behavior suite every pubsub.Notifier implementation must pass.
telemetry
Package telemetry holds what every instrumented engine package shares: the instrumentation scope, the attribute keys, and the provider resolution that makes telemetry free when nobody has configured it.
Package telemetry holds what every instrumented engine package shares: the instrumentation scope, the attribute keys, and the provider resolution that makes telemetry free when nobody has configured it.
textpath
Package textpath finds the collaborative-text documents of an entity row and reads and writes them by instance path.
Package textpath finds the collaborative-text documents of an entity row and reads and writes them by instance path.
Package lease hands out per-workspace work leases: advisory try-locks that let one holder of a (role, workspace) pair proceed while everyone else skips.
Package lease hands out per-workspace work leases: advisory try-locks that let one holder of a (role, workspace) pair proceed while everyone else skips.
notify
pgnotify
Package pgnotify implements the engine's change-notification fan-out over PostgreSQL LISTEN/NOTIFY, so pokes reach clients connected to any node rather than only the one that took the write.
Package pgnotify implements the engine's change-notification fan-out over PostgreSQL LISTEN/NOTIFY, so pokes reach clients connected to any node rather than only the one that took the write.
Package pglisten is the PostgreSQL LISTEN/NOTIFY transport the engine's cross-node fan-outs are built on: one connection parked on the channels a process listens to, one issuing pg_notify, and the reconnect loop that keeps both alive.
Package pglisten is the PostgreSQL LISTEN/NOTIFY transport the engine's cross-node fan-outs are built on: one connection parked on the channels a process listens to, one issuing pg_notify, and the reconnect loop that keeps both alive.
Package presence carries the sync engine's ephemeral plane: the state that only matters while someone is connected.
Package presence carries the sync engine's ephemeral plane: the state that only matters while someone is connected.
pgpresence
Package pgpresence implements the ephemeral plane's fan-out over PostgreSQL LISTEN/NOTIFY, so rooms reach clients connected to any node rather than only the one holding a given session's stream.
Package pgpresence implements the ephemeral plane's fan-out over PostgreSQL LISTEN/NOTIFY, so rooms reach clients connected to any node rather than only the one holding a given session's stream.
presencetest
Package presencetest provides a shared Ginkgo behavior suite every presence.Bus implementation must pass.
Package presencetest provides a shared Ginkgo behavior suite every presence.Bus implementation must pass.
Package query builds, compiles and evaluates syncplane.v1.Condition predicates against protoreflect messages.
Package query builds, compiles and evaluates syncplane.v1.Condition predicates against protoreflect messages.
Package search implements the text analyzer behind full-text search: the pipeline that turns field text and query strings into the terms the match evaluator and the search index agree on.
Package search implements the text analyzer behind full-text search: the pipeline that turns field text and query strings into the terms the match evaluator and the search index agree on.
Reference-following subscriptions: a subscription's synced set is its base predicate scope UNION a bounded-depth closure reached by walking typed reference relations from the base-visible rows.
Reference-following subscriptions: a subscription's synced set is its base predicate scope UNION a bounded-depth closure reached by walking typed reference relations from the base-visible rows.
Package storage defines the pluggable persistence interface for the sync engine.
Package storage defines the pluggable persistence interface for the sync engine.
otelstore
Package otelstore instruments any storage.Adapter with OpenTelemetry.
Package otelstore instruments any storage.Adapter with OpenTelemetry.
pgstore
Package pgstore implements storage.Adapter on PostgreSQL via pgx v5.
Package pgstore implements storage.Adapter on PostgreSQL via pgx v5.
prefixstore
Package prefixstore partitions one storage adapter between several servers by giving each its own prefix of the workspace-id space.
Package prefixstore partitions one storage adapter between several servers by giving each its own prefix of the workspace-id space.
sqlitestore
Package sqlitestore implements storage.Adapter on SQLite via modernc.org/sqlite (pure Go, no CGO).
Package sqlitestore implements storage.Adapter on SQLite via modernc.org/sqlite (pure Go, no CGO).
storagetest
Package storagetest provides a shared Ginkgo behavior suite every storage.Adapter implementation must pass.
Package storagetest provides a shared Ginkgo behavior suite every storage.Adapter implementation must pass.
Package text implements a convergent (CRDT) text document with Peritext-style marks and stable anchors, designed to live in a `bytes` entity field marked (syncplane.v1.field_behavior).text.
Package text implements a convergent (CRDT) text document with Peritext-style marks and stable anchors, designed to live in a `bytes` entity field marked (syncplane.v1.field_behavior).text.
Package tunnel carries HTTP exchanges over a message channel, so an http.Handler can serve clients that have no socket to it: a webview behind a desktop shell, a process on the other end of stdio, a page across a WebSocket or a MessagePort.
Package tunnel carries HTTP exchanges over a message channel, so an http.Handler can serve clients that have no socket to it: a webview behind a desktop shell, a process on the other end of stdio, a page across a WebSocket or a MessagePort.
Package upstream keeps a local syncplane engine converged with an origin syncplane server, so that a Go process can serve, read and write synced data while offline: a desktop app whose webview syncs against the local engine, a server that syncs with another, or a local engine that forwards an origin to browsers.
Package upstream keeps a local syncplane engine converged with an origin syncplane server, so that a Go process can serve, read and write synced data while offline: a desktop app whose webview syncs against the local engine, a server that syncs with another, or a local engine that forwards an origin to browsers.
blobbridge
Package blobbridge moves blob bytes between a local engine and the origin server it syncs with.
Package blobbridge moves blob bytes between a local engine and the origin server it syncs with.
internal/rebase
Package rebase computes the rows a replica holds from the rows its origin confirmed and the local writes the origin has not confirmed yet.
Package rebase computes the rows a replica holds from the rows its origin confirmed and the local writes the origin has not confirmed yet.
presencebridge
Package presencebridge joins the rooms of a local syncplane engine to the rooms of the origin server it syncs with, so that people connected to the origin and people connected to the local engine see each other's presence and broadcasts.
Package presencebridge joins the rooms of a local syncplane engine to the rooms of the origin server it syncs with, so that people connected to the origin and people connected to the local engine see each other's presence and broadcasts.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL