udb 0.2.0

Universal Data Broker — a Rust gRPC broker over multiple databases (Postgres, MySQL, SQLite, MongoDB, ClickHouse, Cassandra, MSSQL, Redis, Qdrant, S3, Neo4j, …) with per-tenant RLS, 2PC, sagas, and CDC.
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
68
69
70
71
72

# UDB Proto Module

`buf.build/fahara02/udb` — the UDB-internal broker wire contract.

This directory is a standalone buf module. It contains only protos that define
how clients talk to the UDB broker; **no user/domain types live here**. Project
domain types live in the user's own buf module and import from this one.

## Files

The public broker contract intentionally lives under stable universal import
paths:

| Path | Purpose |
|---|---|
| `udb/entity/v1/context.proto` | Broker request context and routing metadata. |
| `udb/entity/v1/operation.proto` | Backend-neutral resource identity plus operation stats and warnings |
| `udb/entity/v1/relational.proto` | Relational read/write request and response shapes |
| `udb/entity/v1/vector.proto` | Vector and hybrid search/upsert shapes |
| `udb/entity/v1/blob.proto` | Object/blob upload, download, and presigned URL shapes |
| `udb/entity/v1/stores.proto` | Universal cache/KV, document, graph, time-series, and analytical store request shapes |
| `udb/entity/v1/tx.proto` | Cross-backend mutation stream and transaction status |
| `udb/entity/v1/cdc.proto` | CDC subscription and control-plane shapes |
| `udb/entity/v1/outbox.proto` | First-class outbox event enqueue shapes |
| `udb/entity/v1/admin.proto` | Catalog, migration, DLQ, saga, policy, project, health, and admin shapes |
| `udb/entity/v1/types.proto` | Convenience public-import rollup for entity messages |
| `udb/events/v1/udb_events.proto` | Kafka topic payloads: `CDCEnvelope`, `DriftDetectedEvent`, `ProvisioningCompletedEvent` |
| `udb/services/v1/data_broker.proto` | The gRPC `DataBroker` service definition |

## Consuming this module

In your own buf module's `buf.yaml`:

```yaml
version: v2
modules:
  - path: proto
    name: buf.build/your-org/your-app
deps:
  - buf.build/fahara02/udb
```

Then in any of your `.proto` files:

```proto
syntax = "proto3";
package your.app.v1;
import "udb/entity/v1/types.proto";

message YourRequest {
  udb.entity.v1.RequestContext context = 1;
  // ...
}
```

`buf generate` produces stubs for your messages *plus* the UDB messages they reference, no copy-paste required.

## Why a separate module?

Forking the broker contract by copying these files into every consumer
guarantees drift: one team upgrades to v2, another stays on v1, and the broker
eventually receives mixed-version traffic. A published buf module pins the
version per-consumer the same way crates.io or Packagist pin code dependencies.

## Versioning

The package versions inside the protos (`udb.entity.v1`, `udb.events.v1`,
`udb.services.v1`) are wire-protocol versions; breaking changes go to a new
`v2/` directory next to the existing `v1/`. The module itself is published to
BSR on every tag of the parent UDB repo.

Current wire-protocol version: **1.0.0** (see `sdk/UDB_PROTOCOL_VERSION`).