43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
|
# HiveCast API-Key Login Demo
|
||
|
|
|
||
|
|
This demo proves the SDK-side HiveCast credential shape without committing a
|
||
|
|
secret.
|
||
|
|
|
||
|
|
It validates a user-supplied HiveCast API key against the configured HiveCast
|
||
|
|
cloud, then writes the same package-local `.matrix` config/credential files that
|
||
|
|
`matrix configure` writes. This is the current API-key login shape.
|
||
|
|
|
||
|
|
It does **not** prove hosted broker execution yet. The SDK still needs a
|
||
|
|
provider-owned credential exchange/login command before a package can use a
|
||
|
|
HiveCast-issued broker JWT directly from this repo.
|
||
|
|
|
||
|
|
## Run
|
||
|
|
|
||
|
|
```bash
|
||
|
|
export MATRIX_CLOUD=https://dev.hivecast.ai
|
||
|
|
export MATRIX_SPACE=<your-space-root>
|
||
|
|
export MATRIX_API_KEY=<your-api-key>
|
||
|
|
|
||
|
|
pnpm demo:hivecast-login
|
||
|
|
```
|
||
|
|
|
||
|
|
Optional:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
MATRIX_DEMO_HOME=/tmp/my-sdk-hivecast-demo pnpm demo:hivecast-login
|
||
|
|
MATRIX_DEMO_KEEP=1 pnpm demo:hivecast-login
|
||
|
|
```
|
||
|
|
|
||
|
|
The key is never printed. By default the temporary demo home is deleted after a
|
||
|
|
successful run. Set `MATRIX_DEMO_KEEP=1` to inspect the generated `.matrix`
|
||
|
|
files locally.
|
||
|
|
|
||
|
|
## Check Script Wiring Without A Key
|
||
|
|
|
||
|
|
```bash
|
||
|
|
pnpm demo:hivecast-login -- --check
|
||
|
|
```
|
||
|
|
|
||
|
|
This only verifies that the demo is installed and intentionally refuses to run
|
||
|
|
without credentials.
|