WMHillock
  • Joined on 2026-05-26

@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
npm
2026-11-10 18:21:17 +03:00
13
UNLICENSED
latest
24 KiB
Assets (1)
Versions (1) View all
1.0.0 2026-11-10