Skip to main content

Crate ff_backend_postgres

Crate ff_backend_postgres 

Source
Expand description

EngineBackend implementation backed by Postgres.

RFC-v0.7 Wave 0 — scaffold. This crate lands the PostgresBackend struct + the impl EngineBackend block with every method stubbed to return EngineError::Unavailable. Subsequent waves fill in bodies:

  • Wave 1: cross-cutting error/helpers.
  • Wave 2: describe / list / resolve (read surface).
  • Wave 3: schema migrations (replaces the Wave 0 placeholder).
  • Wave 4: LISTEN/NOTIFY wiring + stream reads/tails.
  • Wave 5-7: hot-path write methods.
  • Wave 8: ff-server wire-up + dual-backend running.

The trait stays object-safe; consumers can hold Arc<dyn EngineBackend>. No ferriskey dep — this crate’s transport is sqlx.

Re-exports§

pub use completion::PostgresCompletionStream;
pub use completion::COMPLETION_CHANNEL;
pub use error::map_sqlx_error;
pub use error::PostgresTransportError;
pub use listener::StreamNotifier;
pub use migrate::apply_migrations;
pub use migrate::MigrationError;
pub use scanner_supervisor::PostgresScannerConfig;
pub use scanner_supervisor::PostgresScannerHandle;
pub use version::check_schema_version;

Modules§

attempt
Attempt trait-method family — Postgres implementation.
budget
Budget family — Postgres impl.
completion
CompletionBackend implementation for Postgres (Wave 4h / Q1).
dispatch
Post-completion dependency-resolution cascade (Wave 5a).
error
sqlx::ErrorEngineError mapping for the Postgres backend.
exec_core
exec_core trait-method family — Postgres impls.
flow
Postgres flow-family EngineBackend implementations (Wave 4c).
flow_staging
Postgres flow-staging inherent methods (Wave 4i).
handle_codec
Postgres-side thin wrapper over ff_core::handle_codec.
listener
Shared LISTEN connection + in-memory stream notifier.
migrate
Schema-migration application.
operator
RFC-020 Wave 9 Spine-A pt.1 — operator-control mutating methods (cancel_execution + revoke_lease).
pool
PgPool construction helper.
reconcilers
Postgres-backend scanner reconcilers (RFC-v0.7 Wave 6).
scanner_supervisor
Postgres scanner supervisor (RFC-017 Wave 8 Stage E3).
scheduler
Admission-pipeline for the Postgres backend (RFC-v0.7 Wave 5b).
signal
Signal delivery + HMAC secret rotation for the Postgres backend.
stream
Stream-family trait methods on the Postgres backend (RFC-015).
suspend
Suspend + resume plumbing for the Postgres backend.
suspend_ops
Suspend / deliver_signal / claim_resumed / observe_signals SQL bodies.
version
Boot-time schema-version check.

Structs§

PostgresBackend
PostgresConnection
Postgres-specific connection parameters (RFC-v0.7 Wave 0).

Type Aliases§

PgPool
An alias for Pool, specialized for Postgres.