capnweb-core 0.1.0

# capnweb-core

Core protocol implementation for Cap'n Web RPC - capability-based security with promise pipelining.

## Overview

`capnweb-core` provides the foundational types and protocol implementation for the Cap'n Web RPC system. It includes:

- Wire protocol types (Messages, Calls, Results, Errors)
- Capability ID management
- Session and connection handling
- Protocol validation and error handling
- Intermediate Language (IL) for complex operations

## Features

- **Capability-based security**: Unforgeable references with explicit lifetime management
- **Promise pipelining**: Chain operations on results before they complete
- **Type-safe IDs**: Strongly-typed identifiers for capabilities, calls, and sessions
- **Structured errors**: Rich error model with proper context propagation
- **Optional validation**: Schema validation support via feature flag

## Usage

Add to your `Cargo.toml`:

```toml
[dependencies]
capnweb-core = "0.1.0"
```

Basic usage:

```rust
use capnweb_core::{CapId, Message, CallId, RpcError};
use serde_json::json;

// Create a capability ID
let cap_id = CapId::new(1);

// Example: create a message
let message = Message::Call {
    id: CallId::new(1),
    target: cap_id,
    method: "echo".to_string(),
    args: vec![json!("hello")],
};

// Handle protocol messages
match message {
    Message::Call { target, method, args, .. } => {
        // Process RPC call
        println!("Call to {}: {}", target, method);
    }
    Message::Result { value, .. } => {
        // Handle result
        println!("Result: {:?}", value);
    }
    Message::Error { error, .. } => {
        // Handle error
        println!("Error: {}", error);
    }
}
```

## Feature Flags

- `validation` (default): Enable JSON schema validation
- `simd`: Use SIMD-accelerated JSON parsing

## License

This project is licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](https://github.com/currentspace/capn-rs/blob/main/LICENSE-APACHE) or https://www.apache.org/licenses/LICENSE-2.0)
 * MIT license ([LICENSE-MIT](https://github.com/currentspace/capn-rs/blob/main/LICENSE-MIT) or https://opensource.org/licenses/MIT)

at your option.