forge-typescript

What problem does it solve?

Prevents TypeScript codebases from silently degrading into unsafe patterns that break in production, especially through misuse of any, unchecked parsing, weak type boundaries, and missing exhaustiveness.

Core Features & Use Cases

• Type-safe boundaries with schema validation: Treats external inputs as unknown and validates them before use (e.g., JSON.parse, env vars, API responses).
• No any, disciplined casting, and banned escape hatches: Enforces rules against any, @ts-ignore/@ts-nocheck, non-null assertions in production paths, and unprincipled as casts.
• Exhaustive discriminated unions and branded domain types: Uses assertNever for complete variant handling and branded primitives to prevent cross-domain identifier bugs.
• Result-first error handling and strict TS configuration: Encourages Result types for expected failures and exceptions for unexpected ones, backed by a strict tsconfig baseline.
• Built-in verification workflow: Provides a verifier script that flags common TS-discipline violations.

Quick Start

Run the TypeScript discipline verifier against a file to catch forbidden patterns like any, @ts-ignore, non-null assertions, and schema-less JSON parsing.