@mana/event-kit
Event-Sourcing DSL und Codegen — definiert Schemas einmal, generiert TypeScript, Swift und Kotlin daraus.
@mana/event-kit ist die DSL und Codegen-Suite, die shared-schemas
zu konkretem Code macht. Eine Schema-Datei wird einmal geschrieben,
das Kit generiert daraus:
- TypeScript-Typen für Web-Apps und Server,
- Swift-Structs für die nativen iOS/macOS-Apps,
- Kotlin-Data-Classes für Android (perspektivisch),
- Migration-Steps für Schema-Evolutionen.
Damit sind die drei Welten (Web, Native, Plattform-Server) typsicher miteinander verbunden — wenn ein Schema sich ändert, schreien alle drei Compiler.
Das ist eine Wette auf Event-Sourcing als langfristige Architektur. Wenn sie aufgeht, sind Apps offline-fähig, deterministisch reproduzierbar und beliebig in der Zeit zurück-spielbar. Wenn nicht, ist das Kit ein sehr fortgeschrittenes Schema-Validierungs-Werkzeug. In beiden Fällen nicht verloren.
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/event-kit 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.
Worauf es sich bindet
- Klasse
- Klasse B — Foundation — intern-versioniert, große Adoption erwartet.
- Sprache
- TypeScript
- Version
- v0.1.0
- Registry
- npm.mana.how — eigene Vereins-Registry, kein npmjs.com
- Lizenz
- Quelloffen — Details im Repo.
Was es für den Verein verkörpert
- LanglebigkeitBewährte Stacks, gute Doku.
- EigenbetriebEigene Infrastruktur, quelloffener Stack.
Was läuft, was nicht
Version: v0.1.0.
- Swift- und Kotlin-Codegen sind funktional, Polish läuft.
- Migration-Step-Runtime für komplexe Event-Transforms ist Roadmap.
Weitere Pakete dieser Kategorie
SDK-Pakete, die Apps mit den Services verbinden.
- @mana/shared-share-protocolFöderations-Vertrag des Vereins — Manifest, Share-Envelope, Drag-Payload, Search-Result. Der eine Klasse-A-Vertrag, an dem alle Apps hängen.
- @mana/shared-schemasEvent-Schemas pro Vereins-App — die Quelle der Wahrheit für mana-sync und Codegen-Quelle für event-kit.
- @mana/event-syncWeb-Client für die Event-Sourced-Plattform — IndexedDB-Store + HTTP/WebSocket-Sync zu mana-sync.
- @mana/shared-authErste Generation der Auth-Klienten-Utilities. Lebt weiter, neue Apps starten auf shared-auth-sso.
- @mana/shared-auth-ssoSvelte-5-Auth-Klient für das SSO-Cookie-Pattern — createSession, tryRefresh, buildLoginRedirect, AuthCallback.
- @mana/notify-clientClient-SDK für den mana-notify Push-Service — eine Zeile pro App, statt OneSignal-Setup zu pflegen.
@mana/event-kit ist eines von vielen Paketen, die der Verein selbst pflegt — eigene Bauteile auf eigener Registry, frei nachnutzbar.