[godronus]

Summary

fastedge::db::sql: Rust API for the gcore:db/sql-sync interface (customer-owned Postgres bound to the app by name; Neon first).

• src/db.rs: re-exports Database, Value, QueryResult, Error, ...; ToSql + params![...] for plain Rust parameters (bool, i32, i64, f64, &str/String, Vec<u8>, Option<T>)
• With the json feature: QueryAs::query_as::<T>() / rows_as() decode rows into any serde::Deserialize type by column name (non-finite floats stay strings so they fail to decode rather than read as null)
• src/lib.rs: generate! also generates gcore:db/sql-types + sql-sync
• wit submodule → G-Core/FastEdge-wit feat/db-interface
• Example examples/http/wasi/db_sql (wstd), mirrors the JS example (same table, routes, responses)

Calls block (sync interface). Rust stays on sql-sync; the async interface (separate PR in FastEdge-wit / FastEdge / sdk-js) targets JS.

Decisions needed

#	Decision	Proposal
1	Module path	fastedge::db::sql (mirrors gcore:db/sql*); KV later as fastedge::db::kv, apart from fastedge::key_value (Edge Storage)
2	Typed rows	Behind the existing json feature (pulls optional serde), not a new feature
3	Async Rust API	Not now; possible later on wstd's reactor if the async interface ships

Merge / release

• Merge after feat(db): gcore:db package — sql-types + sql-sync (MVP) FastEdge-wit#8 (then point the submodule at main).
• Safe to release once the engine (G-Core/FastEdge#659) is on all edges: Rust components only import gcore:db when they use it.

Testing

• cargo build --all-features; example built for wasm32-wasip2 and run on fastedge-run against Neon (list, by id, 404, missing binding → NoSuchDatabase).

Related: G-Core/FastEdge#659, G-Core/FastEdge-wit#8, G-Core/FastEdge-sdk-js#155

[Copilot]

🟡 Changes recommended

The example’s {} metadata default lacks the required plan field, causing reads of otherwise valid inserts to return 500 errors, and generated documentation for the public API changes is missing.

2 open issues

• Make the default Meta value decodable · New
• Regenerate consumer docs for the new public API · New

What changed in this PR

Adds PostgreSQL access to the FastEdge Rust SDK through named database bindings, with credentials managed by the host.

Changes:

• Exposes fastedge::db::sql, SQL parameter helpers, and typed row decoding behind the json feature.
• Adds a WASI HTTP example with schema, sample data, and setup instructions.
• Updates dependencies and records implementation decisions and follow-up work.

File	Description
src/​lib.rs	Configures SQL bindings and exposes the database module.
src/​db.rs	Adds SQL types, parameter conversion, and typed queries.
examples/​README.md	Lists the new database example.
examples/​http/​wasi/​db_sql/​src/​lib.rs	Demonstrates querying users and returning JSON responses.
examples/​http/​wasi/​db_sql/​schema.sql	Defines the example table and seed data.
examples/​http/​wasi/​db_sql/​README.md	Documents setup, usage, errors, and build commands.
examples/​http/​wasi/​db_sql/​Cargo.toml	Declares the example and its dependencies.
examples/​http/​wasi/​db_sql/​Cargo.lock	Locks example dependencies.
context/​CHANGELOG.md	Records database integration decisions and follow-ups.
Cargo.toml	Adds optional Serde support to the json feature.
Cargo.lock	Records the SDK’s direct Serde dependency.

_{Review effort: Balanced}