01 · Framework
The open-source core for modular Node.js services.
Versioned interfaces define what a service does. You write — or generate — the implementation. Swap it tomorrow without touching consumers.
- Interfaces over implementations. Strict contracts, hot-swappable modules, no breaking changes when you upgrade.
- TypeScript end-to-end. From contract to runtime — errors caught at compile time, not on a Friday afternoon.
- AI-native architecture. Agents only need the interface and its tests. Less context, fewer tokens, zero hallucinated coupling.
interfaces/[email protected]
TypeScript1// the contract — versioned, frozen
2export interfaceAuthService {
3 login(email: string, pass: string):
4 Promise<Session>;
5 verify(token: string): Promise<User>;
6}
7
8// the implementation — swappable
9@Module("auth-jwt")
10export classJwtAuth implementsAuthService {
11 @Inject("database") db!: Database;
12 asynclogin(email, pass) { /* … */ }
13}
14
15$ajs module test ./modules/auth-jwt
16✓ 8/8 contract tests passed