tosijs-schema: Schnelle, schema-basierte Typvalidierung für TypeScript
tosijs-schema ist eine moderne, schema-first-Bibliothek für TypeScript und JavaScript, die auf JSON-Schema basiert und als einheitlicher, standardskonformer Quelle für Datenstrukturen dient. Sie ermöglicht die Definition von Typen einmalig im Schema, aus dem automatisch TypeScript-Typen abgeleitet werden. Die Validierung erfolgt extrem schnell dank eines „prime-jump“-Sampling-Ansatzes: Bei großen Arrays und Dictionaries werden nur etwa 1 % der Elemente geprüft – was O(1)-Leistung garantiert, ohne die Fehlererkennung wesentlich zu beeinträchtigen. Für kritische Anwendungen lässt sich diese Optimierung deaktivieren, um eine vollständige Prüfung sicherzustellen. Benchmarktests zeigen, dass tosijs-schema gegenüber Zod bis zu 1124-fach schneller ist, besonders bei wiederholten Aufrufen im JIT-optimierten Zustand. Selbst bei einer einzelnen Ausführung (Cold Start) übertrifft es Zod deutlich. Die Bibliothek verwendet eine funktionale, property-basierte Syntax mit Methodenketten wie .email, .optional, .min(1) oder .pattern(), die klar und kompakt sind. Metadata wie title, description oder default können an beliebige Schema-Knoten angehängt werden – ideal für die automatische Generierung von API-Dokumentationen wie Swagger/OpenAPI. Die Validierung trennt klar zwischen Typsicherheit („ist gültig?“) und Debugging („warum nicht?“): Standardmäßig liefert sie ein boolesches Ergebnis für maximale Geschwindigkeit. Für detaillierte Fehlermeldungen kann ein onError-Callback verwendet werden, der das erste Fehlerereignis stoppt – „Fail Fast“-Prinzip zur CPU-Optimierung. tosijs-schema ist besonders für die Nutzung mit KI-Modellen wie OpenAI oder Anthropic ausgelegt: Da sie direkt JSON-Schema-Objekte ausgibt (über .schema), passt sie perfekt zu response_format: { type: "json_schema" }, ohne zusätzliche Adapter oder übermäßige Token-Verbrauch durch verschachtelte $defs. Im Gegensatz zu Zod, das eine OOP-Struktur und schlechte Tree-Shaking-Eigenschaften hat, ist tosijs-schema funktional, abhängigkeitsfrei und extrem leichtgewichtig. Die Bibliothek ist MIT-licenziert und eignet sich ideal für serverless, CLI-Tools, API-Backends und LLM-Integrationen, wo Leistung, Konsistenz und Token-Effizienz entscheidend sind. Industry-Experten schätzen tosijs-schema als eine signifikante Weiterentwicklung im Bereich der Schema-Validierung, besonders im Kontext von KI-Systemen. Die Kombination aus O(1)-Leistung, LLM-Optimierung und sauberer, flacher JSON-Schema-Ausgabe macht sie zu einer attraktiven Alternative zu Zod, das trotz seiner Beliebtheit aufgrund seiner Architektur bei Skalierung und Bundle-Größe Nachteile aufweist. tosijs-schema ist ideal für Teams, die Wert auf Performance, Konsistenz und Dokumentationsqualität legen – besonders in modernen, datengetriebenen Anwendungen.
