How ptol/typed-json-rpc works
Main Components
a) Core Library Components:
• JSON-RPC Client Factory
• Request Handler Factory
• Request Creator
• Type System Interface
b) Transport Layer Abstractions:
• HTTP Transport
• Worker Transport
• EventEmitter Transport
┌─ Application Layer ─────────────────────┐
• Client Applications │
• ┬─────────────────────────┘
┌─ API Layer ────▼────────────────────────┐
• TypeScript Interface Definitions │
• ┬─────────────────────────┘
┌─ Core Layer ───▼────────────────────────┐
• ┌─────────────────────┐ ┌────────────┐ │
• JSON-RPC Client │ │ Request │ │
• Factory │ │ Handler │ │
• ┘ └────────────┘ │
• ┬─────────────────────────┘
┌─ Transport ───▼────────────────────────┐
• ┌─────┐ ┌──────┐ ┌───────────────┐ │
• HTTP │ │Worker│ │EventEmitter │ │
• ┘ └──────┘ └───────────────┘ │
• ┘
Important Elements to Highlight
a) Type System:
• How TypeScript interfaces (Api) flow through the system
• Demonstrate type safety between client and server
b) Request/Response Flow:
• JSON-RPC message flow
• How requests are transformed and handled
Component Relationships
• How createJsonRpcClient connects to transport senders
• How createRequestHandler processes incoming requests
• How type definitions ensure end-to-end type safety
Implementation Details
Notes about:
• Type-safe request/response handling
• Transport layer abstraction
• Error handling flow