Block a user
@harpus/gateway (1.0.0)
Published 2026-11-10 18:21:17 +03:00 by WMHillock
Installation
@harpus:registry=https://git.devbay.ru/api/packages/WMHillock/npm/npm install @harpus/gateway@1.0.0"@harpus/gateway": "1.0.0"About this package
Harpus Gateway — untrusted relay between the desktop Host and Android/PWA/Telegram clients, plus signed release distribution (ADR-043)
Harpus Gateway
Недоверенный relay между desktop-Host и клиентами (Android, PWA, Telegram) и раздача подписанных релизов. Модель доверия — ADR-043: gateway не может подделать команду (подпись устройства проверяет Host) или релиз (подпись издателя проверяет клиент).
- Стек: Node 24 (Docker) / ≥ 22.12,
node:http+ws+node:sqlite, TypeScript без сборки (strip-types). - Контракт:
packages/contracts(JSON Schema, OpenAPI, сгенерированные TS/Kotlin модели).
Запуск локально
npm ci
GATEWAY_PUBLIC_URL=http://localhost:8080 GATEWAY_ALLOW_HTTP=true \
GATEWAY_DB_PATH=./.data/gw.db GATEWAY_RELEASES_DIR=./.data/releases \
GATEWAY_RELEASE_TRUST_KEYS='{"publisher-2026-v2":"-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAmj3FcvkdROggVzWSh4shmMbhjYqEqohRQqe6YjatSHg=\n-----END PUBLIC KEY-----"}' \
npm start
npm test
Деплой
DevBay: deploy/RUNBOOK.md (/mnt/data/projects/harpus-gateway, общий Caddy, деплой n8n → deploy-app.sh с автооткатом — deploy/devbay/deploy-app.sh). Все переменные — CONFIG.md.
Администрирование
docker exec harpus-gateway node src/admin.ts host-code # одноразовый код регистрации Host
docker exec harpus-gateway node src/admin.ts hosts | devices | releases | audit
docker exec harpus-gateway node src/admin.ts revoke-host <hostId>
docker exec harpus-gateway node src/admin.ts revoke-device <deviceId>
docker exec harpus-gateway node src/admin.ts revoke-release <releaseId>
docker exec harpus-gateway node src/admin.ts ci-token # токен Jenkins + хеш для .env
docker exec harpus-gateway node src/admin.ts backup /data/backup.db
API (кратко, полностью — packages/contracts/openapi.yaml)
| Маршрут | Кто |
|---|---|
GET /healthz, /readyz, /version |
мониторинг |
WSS /v2/host/tunnel |
Host (Ed25519 challenge) |
POST /v2/pairing/claim |
клиент, код из QR |
POST /v2/commands |
клиент, Bearer grant + подписанный envelope |
GET /v2/widget/snapshot |
клиент, Bearer grant |
DELETE /v2/devices/me |
клиент |
POST /v2/releases/{kind}/{channel} |
Jenkins, Bearer CI-токен |
GET /v2/releases/{kind}/{channel}/latest.json, /{fileName}, /v2/releases/{id}/artifact |
клиенты обновлений |
POST /telegram/webhook |
Telegram |
/app/ |
PWA |
Dependencies
Dependencies
| ID | Version |
|---|---|
| @harpus/contracts | ^2.0.0 |
| ws | 8.18.3 |
Development Dependencies
| ID | Version |
|---|---|
| @types/node | ^22.20.5 |
| @types/ws | ^8.18.2 |
Details
2026-11-10 18:21:17 +03:00
Assets (1)
Versions (1)
View all
npm
13
UNLICENSED
latest
24 KiB
gateway-1.0.0.tgz
24 KiB
1.0.0
2026-11-10