An open API service indexing awesome lists of open source software.

https://github.com/aserto-dev/ts-authorizer

Aserto Authorizer TypeScript type definitions.
https://github.com/aserto-dev/ts-authorizer

Last synced: about 1 year ago
JSON representation

Aserto Authorizer TypeScript type definitions.

Awesome Lists containing this project

README

          

# ts-authorizer
Automated generation of Aserto Authorizer TypeScript type definitions.

## Consuming the definitions
These definitions can be consumed by `yarn` from npm:
```
"devDependencies": {
"@aserto/ts-authorizer": "^v0.0.1",
```

or directly from `git` using the following reference:
```
"devDependencies": {
"@aserto/ts-authorizer": "git+https://github.com/aserto-dev/ts-authorizer.git#v0.0.1",
```

Replace `v0.0.1` with the tag you would like to use.

## Generation Process
- `OPENAPI_SAH=main yarn generate`

## GitHub Workflow
The GitHub Workflow is triggered as a workflow_dispatch. It expects to be provided with two required parameters:
- PROTO_REF: The version tag of `aserto-dev/pb-authorizer` that is represented by the `OPENAPI_SHA`. This is used to tag the `ts-authorizer` commit with the same proto version.
- OPENAPI_SHA: The `aserto-dev/openapi-authorizer` commit hash for which type definitions should be created.

Using these variables the GitHub Workflow runs the same `./generate.sh` script, commits, and tags its results for downstream consumption. Run results are deterministic as explicit commit hash and version numbers are taken as explicit input parameters.