Bundled-Features

Bundled-Features sind komplett fertige Features im Framework-Repo, die du mit einer Zeile in deine App ziehst statt sie selbst zu schreiben. Jedes liefert Schema + Handler + Hooks + (oft) UI-Bausteine

Tests — du nutzt sie wie eigene Features, kannst aber Konventionen übersteuern (Tabellen-Namen, Hash-Algorithmen, Channel-Implementations).

Sie leben unter packages/bundled-features/src/<feature>/ und werden über zwei Wege aktiviert:

Auto-Mode: Wenn du auth: { ... } in runDevApp / runProdApp setzt, prepended composeFeatures automatisch das Identity-Quartett (config, user, tenant, auth-email-password). Mehr brauchst du in den meisten Apps nicht.
Manuell: Andere Features (Audit, Secrets, Jobs, Channels …) importierst du explizit und steckst sie in deinen features-Array.

import { runDevApp } from "@kumiko/dev-server";
import { createAuditFeature } from "@kumiko/bundled-features/audit";
import { createSecretsFeature } from "@kumiko/bundled-features/secrets";

await runDevApp({
  features: [
    createAuditFeature(),
    createSecretsFeature(),
    myAppFeature,
  ],
  auth: { /* aktiviert config + user + tenant + auth-email-password */ },
});

Übersicht

Bucket	Features	Wann
Identity-Layer	`auth-email-password`, `sessions`, `user`, `tenant`, `config`	Jede Multi-Tenant-App. Im Auto-Mode automatisch geladen.
Audit & Sicherheit	`audit`, `secrets`, `rate-limiting`	Compliance, externe API-Keys, Throttling von Write-Pfaden.
Operations	`jobs`, `feature-toggles`	Background-Arbeit, gradueller Rollout.
Notifications	`delivery`, `channel-email`, `channel-in-app`, `channel-push`	User benachrichtigen — Channel-agnostisch.
Files & Renderer	`files-provider-s3`, `renderer-simple`	File-Uploads, Email-Templates.

Status-Legende

✅ Stable — wird in Production-Apps eingesetzt (publicstatus), API ist stabil
🚧 Beta — funktioniert, aber API kann sich noch ändern. Use at own risk in Production
⬜ Geplant — auf der Roadmap, noch nicht im Repo

Detail-Pages

🚧 Pro Bundled-Feature ist eine eigene Detail-Page geplant (Setup + volle Options-Liste + Edge-Cases + Migrations-Pfade). Bis dahin ist die Source unter packages/bundled-features/src/<feature>/ die authoritative Referenz — jedes Feature hat einen Header-Kommentar mit Architektur-Überblick.

Siehe auch

Wo finde ich…	Hier
Wie diese Features in die Pipeline passen	Framework
Lauffähige Beispiele (Auth, Audit, Notifications, …)	Recipes
Deployment + Hosting	Platform
Pattern-Reference (`r.config`, `r.secret`, `r.job`, …)	Patterns