@chill-institute/contracts 2.0.2 → 2.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,11 +4,37 @@
|
|
|
4
4
|
|
|
5
5
|
Public API contracts for [chill.institute](https://chill.institute), your favorite [put.io](https://put.io) extension since 2018.
|
|
6
6
|
|
|
7
|
+
This repo is the boundary between the backend, web app, CLI, and downstream consumers. It owns protobuf schemas plus generated Go, TypeScript, and OpenAPI artifacts.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
TypeScript consumers:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install @chill-institute/contracts
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Go consumers:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
go get github.com/chill-institute/chill-contracts
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Develop
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
mise install
|
|
27
|
+
mise run generate
|
|
28
|
+
mise run verify
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Regenerate artifacts after changing protobuf definitions and commit schema plus generated output together.
|
|
32
|
+
|
|
7
33
|
## Docs
|
|
8
34
|
|
|
9
|
-
- [API
|
|
10
|
-
- [Architecture](./docs/ARCHITECTURE.md)
|
|
11
|
-
- [Security](./SECURITY.md)
|
|
35
|
+
- [API reference](./docs/API.md): generated contract surface
|
|
36
|
+
- [Architecture](./docs/ARCHITECTURE.md): package layout and generation flow
|
|
37
|
+
- [Security](./SECURITY.md): reporting and contract safety notes
|
|
12
38
|
|
|
13
39
|
## Contributing
|
|
14
40
|
|