Crate metaxy_cli 

CLI tool for the metaxy project.

Scans Rust lambda source files for #[rpc_query] / #[rpc_mutation] functions and #[derive(Serialize)] types, then generates TypeScript type definitions and a fully typed RPC client.

Binary

The installed binary is called metaxy and provides three subcommands:

• metaxy scan — parse a directory and print discovered procedures as human-readable text plus a JSON manifest.
• metaxy generate — produce rpc-types.ts (interfaces + Procedures type) and rpc-client.ts (typed RpcClient + createRpcClient factory).
• metaxy watch — same as generate, but re-runs automatically whenever a .rs file changes (configurable debounce).

Architecture

┌─────────────┐  scan   ┌──────────┐  codegen  ┌────────────────────┐
│  api/*.rs   │ ──────► │ Manifest │ ────────► │ rpc-types.ts       │
│  attributes │  (syn)  │          │ (fmt)     │ rpc-client.ts      │
└─────────────┘         └──────────┘           │ rpc.svelte.ts (opt)│
                                               └────────────────────┘

• parser — walks the source directory, parses each .rs file with syn, and builds a model::Manifest.
• codegen::typescript — converts the manifest into a rpc-types.ts file with TypeScript interfaces, enum types, and a Procedures map.
• codegen::client — converts the manifest into a rpc-client.ts file with a typed RpcClient interface and createRpcClient factory.
• codegen::svelte — optionally converts the manifest into a rpc.svelte.ts file with Svelte 5 reactive wrappers (createQuery, createMutation).
• watch — wraps generate in a file-watcher loop with debouncing.

Modules

codegen

TypeScript code generation from a Manifest.

commands

config

model

parser

Rust source code parser.

watch