JavaScript / TypeScript implementation of the Apache Fory™ cross-language serialization protocol. Serialize JavaScript objects to bytes and deserialize them back — including across services written in Java, Python, Go, Rust, C++, and other Fory-supported languages.

• Cross-language — serialize in JavaScript, deserialize in Java, Python, Go, Rust, C++, and more without writing glue code
• Fast — serializer code is generated and cached at registration time; optimized for V8 JIT
• Reference-aware — shared references and circular object graphs are supported
• Schema-driven — field types, nullability, and polymorphism are declared once with Type.* builders
• Schema evolution — optional forward/backward compatibility for independent service deployments
• Modern types — bigint, typed arrays, Map, Set, Date, float16, bfloat16 supported

npm install @apache-fory/core

For optional Node.js string-detection acceleration:

npm install @apache-fory/hps

@apache-fory/hps uses V8's fast-call API to detect string encoding efficiently. It requires Node.js 20+ and is completely optional — if installation fails or your environment does not support it, @apache-fory/core works perfectly on its own.

import Fory, { Type } from "@apache-fory/core";

// Optional: import hps for Node.js string performance boost
// import hps from "@apache-fory/hps";

const userType = Type.struct(
  { typeName: "example.user" },
  {
    id: Type.int64(),
    name: Type.string(),
    age: Type.int32(),
  },
);

const fory = new Fory();
// With hps: const fory = new Fory({ hps });
const { serialize, deserialize } = fory.register(userType);

const bytes = serialize({ id: 1n, name: "Alice", age: 30 });
const user = deserialize(bytes);
console.log(user);
// { id: 1n, name: 'Alice', age: 30 }

Fory JavaScript serializes to the same binary format as the Java, Python, Go, Rust, C++, and Swift runtimes. A message written in JavaScript can be read in any other supported language without any conversion layer.

// JavaScript side
const messageType = Type.struct(
  { typeName: "example.message" },
  {
    id: Type.int64(),
    content: Type.string(),
  },
);

const fory = new Fory();
const { serialize } = fory.register(messageType);
const bytes = serialize({ id: 1n, content: "hello from JavaScript" });
// Send bytes to a Java/Python/Go/Rust service

Register the same example.message type on the other side using the peer runtime's API.

Enable compatible mode for independent service deployments:

const fory = new Fory({ compatible: true });

Readers can skip unknown fields and tolerate missing ones, supporting rolling upgrades and schema changes across services.

Full documentation is available at fory.apache.org:

• JavaScript Serialization Guide
• Cross-Language Serialization
• Supported Types
• Schema Evolution
• Xlang Serialization Spec

Apache License 2.0 — see LICENSE for details.