e.V.
Packages · Backbone · Klasse B · v0.1.1
H

@mana/shared-hono

Hono-Server-Foundation — JWT-Auth-Middleware, Health-Endpoints, Admin-Routen, Fehlerbehandlung. Jeder Server-Service nutzt das.

Ersetzt
Express-Boilerplate, NestJS-Decorators, eigene Auth-Middleware pro Service
Was es tut

@mana/shared-hono ist die Server-Foundation für alle TypeScript- Hono-Services der Plattform. Wer einen neuen Service anlegt, bekommt mit pnpm add @mana/shared-hono:

  • JWT-Verifikation gegen mana-auth-JWKS, lokal gecached
  • /health-, /ready-Endpunkte mit DB-Probes
  • Service-Key-Authentifikation für Service-zu-Service
  • Strukturierte Fehlerbehandlung mit Vereins-konformen Error-Codes
  • Standard-Logger-Brücke zu @mana/shared-logger

Das ist das stille Fundament unter elf Plattform-Services. Wenn morgen ein neuer Service entsteht, beginnt er mit fünf Zeilen Konfiguration statt mit zwei Tagen Auth-Middleware-Bau. Foundations sollen Bauteile liefern, nicht zu Geschmacks-Diskussionen einladen.

Installation

Mitnehmen

Vereins-Pakete liegen auf der Vereins-eigenen Verdaccio-Registry. Apps und Services-Repos haben dort ein .npmrc, das den @mana/-Scope auf npm.mana.how routet.

pnpm add @mana/shared-hono

Auch nutzbar mit npm oder yarn — der Scope-Mechanismus ist Standard-npm-Verhalten. Wer den Verein nicht-mitgliedlich nutzen will, kann die Registry frei konfigurieren.

Klasse & Technik

Worauf es sich bindet

Klasse
Klasse B — Foundation — intern-versioniert, große Adoption erwartet.
Sprache
TypeScript
Version
v0.1.1
Registry
npm.mana.how — eigene Vereins-Registry, kein npmjs.com
Lizenz
Quelloffen — Details im Repo.
Grundsätze

Was es für den Verein verkörpert

  • Eigenbetrieb
    Eigene Infrastruktur, quelloffener Stack.
  • Langlebigkeit
    Bewährte Stacks, gute Doku.
  • Offenheit
    Code und Mittelverwendung öffentlich.
Stand

Was läuft, was nicht

Version: v0.1.1.

Offene Punkte
  • Rate-Limiting-Middleware als Plattform-Default ergänzen.

@mana/shared-hono ist eines von vielen Paketen, die der Verein selbst pflegt — eigene Bauteile auf eigener Registry, frei nachnutzbar.