ff-backend-postgres 0.14.0

FlowFabric EngineBackend impl — Postgres backend (RFC-v0.7, Wave 0 scaffold)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

[package]
name = "ff-backend-postgres"
version.workspace = true
edition.workspace = true
license.workspace = true
authors.workspace = true
repository.workspace = true
homepage.workspace = true
keywords.workspace = true
categories.workspace = true
description = "FlowFabric EngineBackend impl — Postgres backend (RFC-v0.7, Wave 0 scaffold)"

[features]
# Mirror ff-core's `core` + `streaming` features so the backend's
# method-gate `#[cfg]`s line up with the trait surface. `core` is
# default-on (ff-core's `core` is always-needed for the minimal
# write surface; ff-backend-valkey takes the same stance via its
# hard ff-core feature activation). `streaming` tracks ff-core's
# `streaming` default.
default = ["core", "streaming", "suspension"]
core = ["ff-core/core"]
streaming = ["ff-core/streaming"]
# RFC-025 Phase 3: `list_expired_leases` trait method rides `ff-core`'s
# `suspension` gate (the method reads lease/attempt state coupled with
# suspend). Default-on so the in-tree release feature-set keeps parity
# with Valkey + SQLite; downstream consumers can disable via
# `default-features = false`.
suspension = ["ff-core/suspension"]
# Issue #154 — enable real OTEL metric emission via `ff-observability`.
# Off by default; mirrors `ff-backend-valkey`.
observability = ["ff-observability/enabled"]

[dependencies]
# Wave 0: `core`, `suspension`, `budget` match ff-backend-valkey's
# ff-core feature set so the Postgres backend honours the same
# `EngineBackend` method surface.
ff-core = { version = "0.14.0", path = "../ff-core", default-features = false, features = ["core", "suspension"] }
# Always-present observability shim (no-op unless `observability`
# feature flips the shim to real OTEL). Mirrors ff-backend-valkey.
ff-observability = { workspace = true }

# Postgres transport. sqlx with tokio-rustls + the macros feature
# (enables `sqlx::migrate!` compile-time migration loading).
sqlx = { workspace = true, features = ["postgres", "runtime-tokio-rustls", "macros", "migrate", "uuid", "chrono", "json"] }

async-trait = { workspace = true }
tokio = { workspace = true }
tracing = { workspace = true }
futures-core = { workspace = true }
thiserror = { workspace = true }
serde_json = { workspace = true }
uuid = { workspace = true }

# RFC-023 Phase 2b.2.1: HMAC primitives moved to `ff_core::crypto::hmac`
# and consumed as a re-export in `signal.rs`. `hex` stays — still used
# by `suspend_ops.rs` for opaque-handle / payload hex codec.
hex = "0.4"

# RFC-024 PR-D: SHA256 for the deterministic `ff_claim_grant.grant_id`
# (sha256 of the HMAC-signed `grant_key` string — stable, collision-
# resistant, same primitive already in transit via `ff-core::crypto::hmac`).
sha2 = "0.10"

[dev-dependencies]
tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }
futures = { workspace = true }
uuid = { workspace = true, features = ["v4"] }