@mana/shared-share-protocol
Föderations-Vertrag des Vereins — Manifest, Share-Envelope, Drag-Payload, Search-Result. Der eine Klasse-A-Vertrag, an dem alle Apps hängen.
@mana/shared-share-protocol ist der Klasse-A-Vertrag des Vereins.
Hier ist das Föderations-Protokoll definiert: wie sieht ein App-
Manifest aus, wie wird ein Share-Envelope gebaut, wie eine Drag-Payload
gesendet, wie ein Search-Result-Format aussehen muss.
Klasse-A heißt: semver-strikt, breaking Changes sind Verein-Beschlüsse, das Protokoll ist öffentlich dokumentiert. Wer auch eine Vereins- föderierte App bauen will (auch von außerhalb), muss nur dieses Paket implementieren — und es funktioniert.
Souveränitäts-Hook: das ist nicht „unser App-Store-Format” — das ist eine öffentliche Spec, an die wir uns binden, damit andere uns nicht ausgesperrt vorfinden. Wenn der Verein morgen verschwindet, bleibt das Protokoll, und andere Initiativen können es weiterführen.
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-share-protocol 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 A — Verein-Vertrag — öffentlich, semver-strikt, Plattform-Pflicht.
- Sprache
- TypeScript
- Version
- v0.4.0
- Registry
- npm.mana.how — eigene Vereins-Registry, kein npmjs.com
- Lizenz
- Quelloffen — Details im Repo.
Was es für den Verein verkörpert
- OffenheitCode und Mittelverwendung öffentlich.
- DatensouveränitätVerwahrer statt Eigentümer.
- EigenbetriebEigene Infrastruktur, quelloffener Stack.
Was läuft, was nicht
Version: v0.4.0.
- 0.5 mit Pre-Signed-Audit-Trails für Compliance-Veto-Override-Pattern.
Weitere Pakete dieser Kategorie
SDK-Pakete, die Apps mit den Services verbinden.
- @mana/shared-schemasEvent-Schemas pro Vereins-App — die Quelle der Wahrheit für mana-sync und Codegen-Quelle für event-kit.
- @mana/event-kitEvent-Sourcing DSL und Codegen — definiert Schemas einmal, generiert TypeScript, Swift und Kotlin daraus.
- @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/shared-share-protocol ist eines von vielen Paketen, die der Verein selbst pflegt — eigene Bauteile auf eigener Registry, frei nachnutzbar.