This repo contains the common protobuf definitions for all of the streamdal server+SDK related components.

All protobuf is generated via make. Use make help to see all possible targets.

1. Git clone
2. git checkout -b your-branch
3. Make your changes
4. make setup
5. make generate
6. git add . && git commit -m "your message" && git push origin head

The protos expose two gRPC APIs: external_api.proto and internal_api.proto.

Both APIs are implemented by streamdal/server.

• external is intended to be used by non-SDK clients (such as the UI).
• internal is intended to be used by SDK clients.

All gRPC methods require you to insert an authorization k/v into the request context/metadata.

All gRPC requests allow you to insert your own request-id into the context/metadata. This request-id can be used to correlate requests, responses, logs, etc. If a request-id is not specified, streamdal/server will generate one automatically.