feat(cli): M-Tool 1-3 — CLI, templates, Gitea publishing pipeline
Some checks failed
Test / test (push) Has been cancelled
Some checks failed
Test / test (push) Has been cancelled
Phase B complete: Shade now has a full developer tooling story. @shade/cli - shade init with project scaffolding from templates - shade fingerprint (own or peer) - shade publish (re-upload bundle) - shade rotate (--identity for full rotation, otherwise signed prekey) - shade peer add/list/verify/remove - shade dashboard (opens observer in browser) - shade doctor (diagnose config, storage, prekey server reachability) - Config from .shaderc.json or SHADE_* env vars Templates (in packages/shade-cli/templates/) - bun-server — Bun + Hono backend with /send + /receive endpoints - chat-demo — Two-process Alice/Bob chat over HTTP Publishing pipeline (Gitea npm registry) - .gitea/workflows/test.yml — CI on push/PR with PostgreSQL service - .gitea/workflows/publish.yml — publish on git tag v* - scripts/publish-all.ts — local publish helper with DRY_RUN support - scripts/bump-version.ts — lockstep version bump across all packages - Root package.json scripts: version, publish:dry, publish:all Also: /health endpoint now lives in createPrekeyRoutes so doctor can probe it without needing the full standalone setup. Dry-run verified: all 11 packages pack cleanly. 246 tests passing, 0 failures. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
8
packages/shade-cli/templates/bun-server/.env.example
Normal file
8
packages/shade-cli/templates/bun-server/.env.example
Normal file
@@ -0,0 +1,8 @@
|
||||
Override the prekey server URL
|
||||
SHADE_PREKEY_SERVER=http://localhost:3900
|
||||
|
||||
Storage location (SQLite file)
|
||||
SHADE_DB_PATH=sqlite:./.shade/client.db
|
||||
|
||||
Observer dashboard token (min 16 chars)
|
||||
SHADE_OBSERVER_TOKEN=change-me-to-at-least-16-chars
|
||||
5
packages/shade-cli/templates/bun-server/.shaderc.json
Normal file
5
packages/shade-cli/templates/bun-server/.shaderc.json
Normal file
@@ -0,0 +1,5 @@
|
||||
{
|
||||
"prekeyServer": "__PREKEY_SERVER__",
|
||||
"storage": "sqlite:./.shade/client.db",
|
||||
"address": "__PROJECT_NAME__"
|
||||
}
|
||||
46
packages/shade-cli/templates/bun-server/README.md
Normal file
46
packages/shade-cli/templates/bun-server/README.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# __PROJECT_NAME__
|
||||
|
||||
A Shade-enabled Bun + Hono server. Encrypted messages in/out via two HTTP endpoints.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
A running Shade prekey server. The default is `__PREKEY_SERVER__`. You can either:
|
||||
- Run one locally: `docker run -p 3900:3900 shade-prekey-server`
|
||||
- Override with `SHADE_PREKEY_SERVER=...` in `.env`
|
||||
|
||||
## Run
|
||||
|
||||
```bash
|
||||
bun install
|
||||
bun run start
|
||||
```
|
||||
|
||||
The server registers itself with the prekey server on startup.
|
||||
|
||||
## Endpoints
|
||||
|
||||
### Send an encrypted message
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:3000/send \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"to": "peer-name", "message": "hello"}'
|
||||
```
|
||||
|
||||
Returns a `ShadeEnvelope` you can forward to the peer via any transport.
|
||||
|
||||
### Receive an encrypted envelope
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:3000/receive \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"from": "peer-name", "envelope": {...}}'
|
||||
```
|
||||
|
||||
Returns the decrypted plaintext.
|
||||
|
||||
## Next steps
|
||||
|
||||
- Wire a real delivery layer (WebSocket, HTTP push, etc.)
|
||||
- Run `shade dashboard` to watch live activity
|
||||
- Compare fingerprints with peers out-of-band before trusting sessions
|
||||
14
packages/shade-cli/templates/bun-server/package.json
Normal file
14
packages/shade-cli/templates/bun-server/package.json
Normal file
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"name": "__PROJECT_NAME__",
|
||||
"version": "0.0.1",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"start": "bun run src/index.ts",
|
||||
"dev": "bun --watch run src/index.ts",
|
||||
"test": "bun test"
|
||||
},
|
||||
"dependencies": {
|
||||
"@shade/sdk": "^0.1.0",
|
||||
"hono": "^4.12.0"
|
||||
}
|
||||
}
|
||||
46
packages/shade-cli/templates/bun-server/src/index.ts
Normal file
46
packages/shade-cli/templates/bun-server/src/index.ts
Normal file
@@ -0,0 +1,46 @@
|
||||
import { Hono } from 'hono';
|
||||
import { createShade } from '@shade/sdk';
|
||||
|
||||
/**
|
||||
* __PROJECT_NAME__ — Shade-enabled Bun server template.
|
||||
*
|
||||
* Exposes two endpoints:
|
||||
* POST /send — encrypt a message to a peer
|
||||
* POST /receive — decrypt an incoming envelope
|
||||
*/
|
||||
|
||||
const shade = await createShade({
|
||||
prekeyServer: process.env.SHADE_PREKEY_SERVER ?? '__PREKEY_SERVER__',
|
||||
storage: process.env.SHADE_DB_PATH ?? 'sqlite:./.shade/client.db',
|
||||
address: '__PROJECT_NAME__',
|
||||
});
|
||||
|
||||
console.log(`Shade initialized as ${shade.myAddress}`);
|
||||
console.log(`Fingerprint: ${await shade.fingerprint}`);
|
||||
|
||||
shade.onMessage((from, msg) => {
|
||||
console.log(`[${from}] ${msg}`);
|
||||
});
|
||||
|
||||
const app = new Hono();
|
||||
|
||||
app.get('/', (c) => c.text(`__PROJECT_NAME__ — Shade-enabled backend`));
|
||||
|
||||
app.post('/send', async (c) => {
|
||||
const { to, message } = await c.req.json();
|
||||
const envelope = await shade.send(to, message);
|
||||
return c.json({ envelope });
|
||||
});
|
||||
|
||||
app.post('/receive', async (c) => {
|
||||
const { from, envelope } = await c.req.json();
|
||||
const plaintext = await shade.receive(from, envelope);
|
||||
return c.json({ plaintext });
|
||||
});
|
||||
|
||||
export default {
|
||||
port: Number(process.env.PORT ?? 3000),
|
||||
fetch: app.fetch,
|
||||
};
|
||||
|
||||
console.log(`Server listening on :${process.env.PORT ?? 3000}`);
|
||||
Reference in New Issue
Block a user