# danielc49/seam-rpc architecture

> Architecture diagram of the GitHub repository danielc49/seam-rpc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/danielc49/seam-rpc
- Repository: https://github.com/danielc49/seam-rpc

## Overview

SeamRPC is a TypeScript RPC library: callers invoke typed client procedures, which encode requests for an Express server to dispatch to registered procedures and return results. Its runtime also supports schema validation, middleware, error events, and transferring files and dates. The client and server use shared core serialization and error utilities. Source excerpts show the client/server implementations and shared core; broader documented capabilities are included where useful, but unsampled examples and integrations are not mapped as implementation components.

Main entry points: [`packages/server/src/index.ts`](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts) (Procedure Dispatch), [`packages/client/src/index.ts`](https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts) (Request Dispatcher), [`packages/core/src/index.ts`](https://github.com/danielc49/seam-rpc/blob/main/packages/core/src/index.ts) (Result and Errors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client Runtime"]
  node_client_proxy["Typed API Proxy<br/>[index.ts]"]
  node_client_call["Request Dispatcher<br/>[index.ts]"]
  node_client_middleware["Client Middleware<br/>[index.ts]"]
  node_client_codec["Client Codec<br/>[index.ts]"]
end

subgraph group_server["Server Runtime"]
  node_server_routes["Router Registration<br/>[index.ts]"]
  node_server_dispatch["Procedure Dispatch<br/>[index.ts]"]
  node_server_validation["Schema Validation<br/>[index.ts]"]
  node_procedure_handler["Procedure Handler<br/>[index.ts]"]
  node_server_errors["Error Events<br/>[index.ts]"]
  node_server_codec["Response Codec<br/>[index.ts]"]
end

subgraph group_core["Shared Core"]
  node_core_results["Result and Errors<br/>[index.ts]"]
  node_core_codec["File and Date Codec<br/>[index.ts]"]
end

node_caller(("API Caller"))
node_express["Express Server"]

node_caller -->|"invokes"| node_client_proxy
node_client_proxy -->|"dispatches to"| node_client_call
node_client_call -->|"runs"| node_client_middleware
node_client_call -->|"encodes with"| node_client_codec
node_client_call -->|"HTTP request"| node_server_dispatch
node_server_routes -->|"mounts routes"| node_express
node_server_dispatch -->|"validates input"| node_server_validation
node_server_dispatch -->|"calls handler"| node_procedure_handler
node_server_dispatch -->|"emits errors"| node_server_errors
node_server_dispatch -->|"encodes response"| node_server_codec
node_client_codec -->|"uses"| node_core_codec
node_server_codec -->|"uses"| node_core_codec
node_client_call -->|"uses"| node_core_results
node_server_dispatch -->|"uses"| node_core_results
node_server_routes -->|"registers dispatch"| node_server_dispatch
node_server_validation -.->|"validates output"| node_procedure_handler

click node_client_proxy "https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts"
click node_client_call "https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts"
click node_client_middleware "https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts"
click node_client_codec "https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts"
click node_server_routes "https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts"
click node_server_dispatch "https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts"
click node_server_validation "https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts"
click node_procedure_handler "https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts"
click node_server_errors "https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts"
click node_server_codec "https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts"
click node_core_results "https://github.com/danielc49/seam-rpc/blob/main/packages/core/src/index.ts"
click node_core_codec "https://github.com/danielc49/seam-rpc/blob/main/packages/core/src/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client_proxy,node_client_call,node_client_middleware,node_client_codec toneBlue
class node_server_routes,node_server_dispatch,node_server_validation,node_procedure_handler,node_server_errors,node_server_codec toneAmber
class node_core_results,node_core_codec,node_caller,node_express toneMint
```

## Components

### Client Runtime

- [Typed API Proxy](https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts): `packages/client/src/index.ts`
- [Request Dispatcher](https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts): `packages/client/src/index.ts`
- [Client Middleware](https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts): `packages/client/src/index.ts`
- [Client Codec](https://github.com/danielc49/seam-rpc/blob/main/packages/client/src/index.ts): `packages/client/src/index.ts`

### Server Runtime

- [Router Registration](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`
- [Procedure Dispatch](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`
- [Schema Validation](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`
- [Procedure Handler](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`
- [Error Events](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`
- [Response Codec](https://github.com/danielc49/seam-rpc/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`

### Shared Core

- [Result and Errors](https://github.com/danielc49/seam-rpc/blob/main/packages/core/src/index.ts): `packages/core/src/index.ts`
- [File and Date Codec](https://github.com/danielc49/seam-rpc/blob/main/packages/core/src/index.ts): `packages/core/src/index.ts`

### Other components

- **API Caller**
- **Express Server**

## Connections

- API Caller → Typed API Proxy: invokes (evidence: `README.md`)
- Typed API Proxy → Request Dispatcher: dispatches to (evidence: `packages/client/src/index.ts`)
- Request Dispatcher → Client Middleware: runs (evidence: `packages/client/src/index.ts`)
- Request Dispatcher → Client Codec: encodes with (evidence: `packages/client/src/index.ts`)
- Request Dispatcher → Procedure Dispatch: HTTP request (evidence: `README.md`)
- Router Registration → Express Server: mounts routes (evidence: `packages/server/src/index.ts`)
- Procedure Dispatch → Schema Validation: validates input (evidence: `packages/server/src/index.ts`)
- Procedure Dispatch → Procedure Handler: calls handler (evidence: `packages/server/src/index.ts`)
- Procedure Dispatch → Error Events: emits errors (evidence: `packages/server/src/index.ts`)
- Procedure Dispatch → Response Codec: encodes response (evidence: `packages/server/src/index.ts`)
- Client Codec → File and Date Codec: uses (evidence: `packages/client/src/index.ts`)
- Response Codec → File and Date Codec: uses (evidence: `packages/server/src/index.ts`)
- Request Dispatcher → Result and Errors: uses (evidence: `packages/client/src/index.ts`)
- Procedure Dispatch → Result and Errors: uses (evidence: `packages/server/src/index.ts`)
- Router Registration → Procedure Dispatch: registers dispatch (evidence: `packages/server/src/index.ts`)
- Schema Validation → Procedure Handler: validates output (evidence: `packages/server/src/index.ts`)
