recurram 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Recurram Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,163 @@
+# Recurram (JS)
+
+JavaScript/TypeScript bindings for `recurram-rust` with two backends:
+
+- Node.js: N-API (`recurram-napi`)
+- Browser/JS runtime: WebAssembly (`recurram-wasm`)
+
+Integers decode as `bigint` by default (i64/u64 safe handling).
+
+## Requirements
+
+- Node.js 24+
+- Rust stable
+- `wasm-pack` for WASM builds
+
+## Build
+
+```bash
+pnpm install
+pnpm build
+```
+
+Build steps:
+
+1. Build N-API addon (`native/recurram_napi.node`)
+2. Build WASM package (`wasm/pkg/*`)
+3. Build TypeScript output (`dist/*`)
+
+## Formatting
+
+```bash
+pnpm format
+pnpm format:check
+```
+
+## Test
+
+```bash
+pnpm test
+```
+
+What it validates:
+
+- Rust bridge tests (`test:rust`)
+- Node API tests (`test:node`) covering `init`, `encode`, `decode`, schema, batch, and session APIs
+- TypeScript API usage against built output
+
+## Usage (Node)
+
+```ts
+import {
+  init,
+  encode,
+  decode,
+  createSessionEncoder,
+  toTransportJson,
+  encodeTransportJson,
+  type RecurramValue,
+} from "recurram";
+
+await init({ prefer: "napi" });
+
+const value: RecurramValue = {
+  id: 1001n,
+  name: "alice",
+  active: true,
+};
+
+const bytes = encode(value);
+const roundtrip = decode(bytes);
+
+const session = createSessionEncoder();
+const first = session.encode(value);
+const patch = session.encodePatch({ ...value, name: "alicia" });
+
+const prepared = toTransportJson(value);
+const fastest = encodeTransportJson(prepared);
+```
+
+## High-throughput transport JSON APIs
+
+For hot paths where you can prepare payloads ahead of time, use transport JSON APIs to reduce JS-side conversion overhead:
+
+- `toTransportJson(value)` / `fromTransportJson(json)`
+- `toTransportJsonBatch(values)`
+- `encodeTransportJson(valueJson)` / `decodeToTransportJson(bytes)`
+- `encodeBatchTransportJson(valuesJson)`
+
+`SessionEncoder` also supports raw methods:
+
+- `encodeTransportJson(valueJson)`
+- `encodeBatchTransportJson(valuesJson)`
+- `encodePatchTransportJson(valueJson)`
+- `encodeMicroBatchTransportJson(valuesJson)`
+
+## Usage (Browser)
+
+```ts
+import { init, encode, decode } from "recurram";
+
+await init({ prefer: "wasm" });
+
+const bytes = encode({ id: 1n, role: "admin" });
+const value = decode(bytes);
+```
+
+If you want to pass a custom WASM source, use `wasmInput`:
+
+```ts
+await init({ prefer: "wasm", wasmInput: "/assets/recurram_wasm_bg.wasm" });
+```
+
+## TypeScript types
+
+Main exported types:
+
+- `RecurramValue`
+- `Schema`, `SchemaField`
+- `SessionOptions`
+
+`RecurramValue` includes `bigint` and `Uint8Array` support:
+
+```ts
+type RecurramValue =
+  | null
+  | boolean
+  | number
+  | bigint
+  | string
+  | Uint8Array
+  | RecurramValue[]
+  | { [key: string]: RecurramValue };
+```
+
+## Publish to npm
+
+The package is configured for npm publish and ships build artifacts from `dist/`, `native/`, and `wasm/pkg/`.
+
+Local dry run:
+
+```bash
+pnpm build
+pnpm pack
+```
+
+GitHub Actions publish:
+
+1. Add repository secret `NPM_TOKEN`.
+2. Bump `version` in `package.json`.
+3. Create and push matching tag `v<version>`.
+
+Example:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+The workflow `.github/workflows/publish-npm.yml` verifies tag/version match and then runs `pnpm publish`.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/crates/recurram-bridge/Cargo.toml

@@ -0,0 +1,13 @@
+[package]
+name = "recurram-bridge"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+base64 = "0.22"
+recurram = { git = "https://github.com/recurram/recurram-rust.git" }
+itoa = "1.0"
+ryu = "1.0"
+serde = { version = "1.0", features = ["derive"] }
+serde_json = { version = "1.0", features = ["raw_value"] }
+simd-json = "0.17"