TypeScript implementation of the Cap'n Proto serialization.
npm install capnp-es
> [!WARNING]
> This is an alpha-quality software. please use at your own risk (project status).
TypeScript implementation of the Cap'n Proto serialization protocol.
Cap’n Proto is an insanely fast data interchange format and capability-based RPC system. Think JSON, except binary. Or think Protocol Buffers, except faster. Cap’n Proto was built by Kenton Varda to be used in Sandstorm and is now heavily used in Cloudflare.
> [!NOTE]
> Make sure capnpc command is available. You can find install instructions here to install it.
Install capnp-es dependency:
``sh`
npx nypm install capnp-es
You can use capnp-es to compile a schema file into typeScript/javascript source code:
`shell`
npx capnp-es path/to/myschema.capnp -ojs,ts,dts
This will generate path/to/myschema.{js,ts,dts}.
Use npx capnp-es --help for full usage info.
See playground for examples and learn more about .capnp schema in language docs.
Here's a quick usage example:
`ts
import * as capnp from "capnp-es";
import { MyStruct } from "./myschema.js";
const message = capnp.Message.fromArrayBuffer(buffer);
const struct = message.getRoot(MyStruct);
`
Experimental RPC protocol is supported (level 1).
See tests for some examples.
This project is a rework of jdiaz5513/capnp-ts by Julián DĂaz and is under development.
- Internal refactors and simplifications as was playing around.
- Compiler, runtime, and std lib published via a single and compact ESM-only package with subpath exports.
- Compiler updated to use Typescript v5 API
- Output files can be .ts (new), .js (ESM instead of CJS), and .d.ts and has no .capnp suffix.capnp-es/compiler
- Compiler API can be used via the subpath export programmatically.TextEncoder
- Use native and TextDecoder for utf8 encoding.ts
- Enums are typed plain JS objects (this way files work with strip-only ts loaders without enum support.).capnp
- Compiler CLI can directly accept a path to files and internally use capnpc
- Built-in schemas are compiled from source (compiler, compiles itself. so cool right?)
- Use reflection (getter setters) to access structs.
- RPC level-1 merged from jdiaz5513/capnp-ts#169.
- List interface implements object (custom methods removed).
- Pointers had been improved to feel (inspected and serialized) like native JS values as much as possible.
- Basic JSDocs generated for class and getter
Feedback and PRs are more than welcome. 🙏
- Clone this repository
- Install the latest LTS version of Node.js
- Enable Corepack using corepack enable
- Install dependencies using
- Run interactive tests using
🔀 Forked from jdiaz5513/capnp-ts by Julián DĂaz.
đź’› Published under the MIT license.