udb 0.3.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 TypeScript SDK

Package: `@udb_plus/sdk`

Current release: `0.3.0`

Runtime: Node 18+

The TypeScript SDK is a Node gRPC wrapper for the UDB DataBroker plus native
Authn/Authz control-plane helpers. It loads bundled `.proto` files at runtime
through `@grpc/proto-loader`, so application code should import the package
entry points instead of `gen/` files.

## Install

```bash
npm i @udb_plus/sdk@0.3.0
```

`@grpc/grpc-js` and `@grpc/proto-loader` are package dependencies.

## Usage

```ts
import { dataBrokerClient, metadata, UdbMetadata } from "@udb_plus/sdk/client";
import { UdbAuthClient } from "@udb_plus/sdk/auth";

const meta: UdbMetadata = {
  tenantId: "acme",
  userId: "user-1",
  purpose: "web.request",
  scopes: ["udb:read", "udb:write"],
  serviceIdentity: "billing.api",
  projectId: "default",
};

const broker = dataBrokerClient("localhost:50051");
broker.Select(
  { message_type: "acme.billing.v1.Invoice", limit: 50 },
  metadata(meta),
  (err: unknown, rs: any) => {
    if (err) throw err;
    console.log(rs?.records);
  },
);

const auth = new UdbAuthClient("localhost:50051", meta);
const [allowed, decision] = await auth.can(
  { message_type: "acme.billing.v1.Invoice" },
  "read",
);
```

## Generated Files

The committed `gen/` directory is a drift-parity artifact kept in sync with the
repo protos. It is not the package runtime surface. Published consumers should
use:

- `@udb_plus/sdk`
- `@udb_plus/sdk/client`
- `@udb_plus/sdk/auth`

Regenerate from the repo root after proto changes:

```bash
./scripts/gen_sdk.sh
```

```powershell
.\scripts\gen_sdk.ps1
```