json-as 1.0.0-beta.16 → 1.0.0-beta.18

package/{CHANGELOG → CHANGELOG.md}

@@ -1,5 +1,15 @@
 # Change Log
 
+## 2025-03-06 - 1.0.0
+
+- fix: object with an object as a value containing a rhs bracket or brace would exit early [3b33e94](https://github.com/JairusSW/json-as/commit/3b33e9414dc04779d22d65272863372fcd7af4a6)
+- fix: objects containing properties with type Obj | null did not deserialize when using \_\_deserialize
+- chore: clean up
+
+## 2025-03-04 - 1.0.0-beta.17
+
+- fix: forgot to build transform
+
 ## 2025-03-04 - 1.0.0-beta.16
 
 - fix: isPrimitive should only trigger on actual primitives
@@ -128,4 +138,4 @@
 - feat: reduce memory usage so that it is viable for low-memory environments
 - feat: write to a central buffer and reduce memory overhead
 - feat: rewrite the transform to properly resolve schemas and link them together
-- feat: pre-allocate and compute the minimum size of a schema to avoid memory out of range errors
+- feat: pre-allocate and compute the minimum size of a schema to avoid memory out of range errors

package/README.md

@@ -6,7 +6,7 @@
 ██   ██      ██ ██    ██ ██  ██ ██       ██   ██      ██
  █████  ███████  ██████  ██   ████       ██   ██ ███████
  </span>
-    AssemblyScript - v1.0.0-beta.16
+    AssemblyScript - v1.0.0-beta.18
   </pre>
 </h5>
 
@@ -14,6 +14,22 @@
 
 JSON is the de-facto serialization format of modern web applications, but its serialization and deserialization remain a significant performance bottleneck, especially at scale. Traditional parsing approaches are computationally expensive, adding unnecessary overhead to both clients and servers. This library is designed to mitigate this by leveraging SIMD acceleration and highly optimized transformations.
 
+## 🚨 What's new in v1.0.0
+
+🔹First release of `v1.0.0`
+
+🔹Breaking changes to the way custom serializers/deserializers function (See Custom Serializers below)
+
+🔹Major performance improvements and addition of SIMD
+
+🔹Extremely low memory overhead compared to pre-1.x.x versions (great for serverless workloads)
+
+🔹Fixes to many major issues and newly discovered bugs
+
+🔹Full support for dynamic objects, arrays, and values
+
+🔹Full support for `JSON.Raw` type everywhere
+
 ## 📚 Contents
 
 - [Installation](#-installation)
@@ -31,7 +47,7 @@ JSON is the de-facto serialization format of modern web applications, but its se
 ## 💾 Installation
 
 ```bash
-npm install json-as@1.0.0-beta.16
+npm install json-as@1.0.0-beta.18
 ```
 
 Add the `--transform` to your `asc` command (e.g. in package.json)
@@ -42,7 +58,7 @@ Add the `--transform` to your `asc` command (e.g. in package.json)
 
 Alternatively, add it to your `asconfig.json`
 
-```json
+```typescripton
 {
   "options": {
     "transform": ["json-as/transform"],
@@ -55,9 +71,10 @@ If you'd like to see the code that the transform generates, run with `JSON_DEBUG
 
 ## 🪄 Usage
 
-```js
+```typescript
 import { JSON } from "json-as";
 
+
 @json
 class Vec3 {
   x: f32 = 0.0;
@@ -65,8 +82,10 @@ class Vec3 {
   z: f32 = 0.0;
 }
 
+
 @json
 class Player {
+
   @alias("first name")
   firstName!: string;
   lastName!: string;
@@ -74,6 +93,7 @@ class Player {
   // Drop in a code block, function, or expression that evaluates to a boolean
   @omitif((self: Player) => self.age < 18)
   age!: i32;
+
   @omitnull()
   pos!: Vec3 | null;
   isVerified!: boolean;
@@ -87,9 +107,9 @@ const player: Player = {
   pos: {
     x: 3.4,
     y: 1.2,
-    z: 8.3
+    z: 8.3,
   },
-  isVerified: true
+  isVerified: true,
 };
 
 const serialized = JSON.stringify<Player>(player);
@@ -109,10 +129,12 @@ This library allows selective omission of fields during serialization using the
 
 This decorator excludes a field from serialization entirely.
 
-```js
+```typescript
+
 @json
 class Example {
   name!: string;
+
   @omit
   secret!: string;
 }
@@ -128,10 +150,12 @@ console.log(JSON.stringify(obj)); // { "name": "Visible" }
 
 This decorator omits a field only if its value is null.
 
-```js
+```typescript
+
 @json
 class Example {
   name!: string;
+
   @omitnull()
   optionalField!: string | null;
 }
@@ -141,14 +165,18 @@ obj.name = "Present";
 obj.optionalField = null;
 
 console.log(JSON.stringify(obj)); // { "name": "Present" }
+```
 
-@omitif((self: this) => condition)
+**@omitif((self: this) => condition)**
 
 This decorator omits a field based on a custom predicate function.
 
+```typescript
+
 @json
 class Example {
   name!: string;
+
   @omitif((self: Example) => self.age < 18)
   age!: number;
 }
@@ -168,7 +196,8 @@ AssemblyScript doesn't support using nullable primitive types, so instead, json-
 
 For example, this schema won't compile in AssemblyScript:
 
-```js
+```typescript
+
 @json
 class Person {
   name!: string;
@@ -178,7 +207,8 @@ class Person {
 
 Instead, use `JSON.Box` to allow nullable primitives:
 
-```js
+```typescript
+
 @json
 class Person {
   name: string;
@@ -207,7 +237,7 @@ Here's a few examples:
 
 When dealing with arrays that have multiple types within them, eg. `["string",true,null,["array"]]`, use `JSON.Value[]`
 
-```js
+```typescript
 const a1 = JSON.parse<JSON.Value[]>('["string",true,null,["array"]]');
 console.log(JSON.stringify(a[0])); // "string"
 console.log(JSON.stringify(a[1])); // true
@@ -219,14 +249,15 @@ console.log(JSON.stringify(a[3])); // ["array"]
 
 When dealing with an object with an unknown structure, use the `JSON.Obj` type
 
-```js
+```typescript
 const o1 = JSON.parse<JSON.Obj>('{"a":3.14,"b":true,"c":[1,2,3],"d":{"x":1,"y":2,"z":3}}');
 
 console.log(o1.keys().join(" ")); // a b c d
 console.log(
-  o1.values()
-  .map<string>((v) => JSON.stringify(v))
-  .join(" ")
+  o1
+    .values()
+    .map<string>((v) => JSON.stringify(v))
+    .join(" "),
 ); // 3.14 true [1,2,3] {"x":1,"y":2,"z":3}
 
 const y = o1.get("d").get<JSON.Obj>().get<i32>();
@@ -239,7 +270,8 @@ More often, objects will be completely statically typed except for one or two va
 
 In such cases, `JSON.Value` can be used to handle fields that may hold different types at runtime.
 
-```js
+```typescript
+
 @json
 class DynamicObj {
   id: i32 = 0;
@@ -267,9 +299,9 @@ Sometimes its necessary to simply copy a string instead of serializing it.
 
 For example, the following data would typically be serialized as:
 
-```js
+```typescript
 const m1 = new Map<string, string>();
-m1.set('pos', '{"x":1.0,"y":2.0,"z":3.0}');
+m1.set("pos", '{"x":1.0,"y":2.0,"z":3.0}');
 
 const a1 = JSON.stringify(m1);
 console.log("a1: " + a1);
@@ -279,9 +311,9 @@ console.log("a1: " + a1);
 
 If, instead, one wanted to insert Raw JSON into an existing schema/data structure, they could make use of the JSON.Raw type to do so:
 
-```js
+```typescript
 const m1 = new Map<string, JSON.Raw>();
-m1.set('pos', new JSON.Raw('{"x":1.0,"y":2.0,"z":3.0}'));
+m1.set("pos", new JSON.Raw('{"x":1.0,"y":2.0,"z":3.0}'));
 
 const a1 = JSON.stringify(m1);
 console.log("a1: " + a1);
@@ -295,7 +327,8 @@ This library supports custom serialization and deserialization methods, which ca
 
 Here's an example of creating a custom data type called `Point` which serializes to `(x,y)`
 
-```js
+```typescript
+
 @json
 class Point {
   x: f64 = 0.0;
@@ -305,11 +338,13 @@ class Point {
     this.y = y;
   }
 
+
   @serializer
   serializer(self: Point): string {
     return `(${self.x},${self.y})`;
   }
 
+
   @deserializer
   deserializer(data: string): Point {
     const dataSize = bytes(data);
@@ -319,10 +354,7 @@ class Point {
     const x = data.slice(1, c);
     const y = data.slice(c + 1, data.length - 1);
 
-    return new Point(
-      f64.parse(x),
-      f64.parse(y)
-    );
+    return new Point(f64.parse(x), f64.parse(y));
   }
 }
 ```
@@ -333,7 +365,7 @@ The deserializer function parses the string `(x,y)` back into a `Point` instance
 
 These functions are then wrapped before being consumed by the json-as library:
 
-```js
+```typescript
 @inline __SERIALIZE_CUSTOM(ptr: usize): void {
   const data = this.serializer(changetype<Point>(ptr));
   const dataSize = data.length << 1;
@@ -352,45 +384,27 @@ This allows custom serialization while maintaining a generic interface for the l
 
 The `json-as` library has been optimized to achieve near-gigabyte-per-second JSON processing speeds through SIMD acceleration and highly efficient transformations. Below are some key performance benchmarks to give you an idea of how it performs.
 
-### Raw Performance
-
-Simple
-
-| Test Case          | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
-| ------------------ | --------------------- | ----------------------- | -------------------- | ---------------------- |
-| Vector3 Object     | 32,642,320 ops/s      | 9,736,272 ops/s         | 1,240 MB/s           | 369 MB/s               |
-| Alphabet String    | 4,928,856 ops/s       | 7,567,360 ops/s         | 975 MB/s             | 1,498 MB/s             |
-| Small JSON Object  | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-| Medium JSON Object | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-| Large JSON Object  | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-
-SIMD
-
-| Test Case          | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
-| ------------------ | --------------------- | ----------------------- | -------------------- | ---------------------- |
-| Vector3 Object     | 32,642,320 ops/s      | 9,736,272 ops/s         | 1,240 MB/s           | 369 MB/s               |
-| Alphabet String    | 20,368,584 ops/s      | 28,467,424 ops/s        | 3,910 MB/s           | 5,636 MB/s             |
-| Small JSON Object  | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-| Medium JSON Object | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-| Large JSON Object  | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-
-JavaScript
-
-| Test Case          | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
-| ------------------ | --------------------- | ----------------------- | -------------------- | ---------------------- |
-| Vector3 Object     | 2,548,013 ops/s       | 1,942,440 ops/s         | 97 MB/s              | 73 MB/s                |
-| Alphabet String    | 3,221,556 ops/s       | 2,716,617 ops/s         | 624 MB/s             | 537 MB/s               |
-| Small JSON Object  | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-| Medium JSON Object | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-| Large JSON Object  | [Fill Value]          | [Fill Value]            | [Fill Value]         | [Fill Value]           |
-
-### Real-World Usage
-
-| Scenario         | JSON Size (kb) | Serialization Time (ops/s) | Deserialization Time (ops/s) | Throughput (GB/s) |
-| ---------------- | -------------- | -------------------------- | ---------------------------- | ----------------- |
-| Web API Response | [Fill Value]   | [Fill Value]               | [Fill Value]                 | [Fill Value]      |
-| Database Entry   | [Fill Value]   | [Fill Value]               | [Fill Value]                 | [Fill Value]      |
-| File Parsing     | [Fill Value]   | [Fill Value]               | [Fill Value]                 | [Fill Value]      |
+Note: the AssemblyScript benches are run using a _bump allocator_ so that Garbage Collection does not interfere with results. Also note that ideally, I would use [d8](https://v8.dev/docs/d8), but until that is done, these results serve as a temporary performance comparison.
+
+**Table 1** - _AssemblyScript_
+
+| Test Case       | Size       | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
+| --------------- | ---------- | --------------------- | ----------------------- | -------------------- | ---------------------- |
+| Vector3 Object  | 38 bytes   | 35,714,285 ops/s      | 35,435,552 ops/s        | 1,357 MB/s           | 1,348 MB/s             |
+| Alphabet String | 104 bytes  | 13,617,021 ops/s      | 18,390,804 ops/s        | 1,416 MB/s           | 1,986 MB/s             |
+| Small Object    | 88 bytes   | 24,242,424 ops/s      | 12,307,692 ops/s        | 2,133 MB/s           | 1,083 MB/s             |
+| Medium Object   | 494 bytes  | 4,060,913 ops/s       | 1,396,160 ops/s         | 2,006 MB/s           | 689.7 MB/s             |
+| Large Object    | 3374 bytes | 614,754 ops/s         | 132,802 ops/s           | 2,074 MB/s           | 448.0 MB/s             |
+
+**Table 2** - _JavaScript_
+
+| Test Case       | Size       | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
+| --------------- | ---------- | --------------------- | ----------------------- | -------------------- | ---------------------- |
+| Vector3 Object  | 38 bytes   | 8,791,209 ops/s       | 5,369,12 ops/s          | 357.4 MB/s           | 204.3 MB/s             |
+| Alphabet String | 104 bytes  | 13,793,103 ops/s      | 14,746,544 ops/s        | 1,416 MB/s           | 1,592 MB/s             |
+| Small Object    | 88 bytes   | 8,376,963 ops/s       | 4,968,944 ops/s         | 737.1 MB/s           | 437.2 MB/s             |
+| Medium Object   | 494 bytes  | 2,395,210 ops/s       | 1,381,693 ops/s         | 1,183 MB/s           | 682.5 MB/s             |
+| Large Object    | 3374 bytes | 222,222 ops/s         | 117,233 ops/s           | 749.7 MB/s           | 395.5 MB/s             |
 
 ## 📃 License
 

package/assembly/__benches__/abc.bench.ts

@@ -0,0 +1,22 @@
+import { JSON } from "..";
+import { bs } from "../../modules/as-bs";
+import { bench } from "../custom/bench";
+
+const v1 = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+const v2 = '"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"';
+
+bench(
+  "Serialize Alphabet",
+  () => {
+    JSON.stringify(v1);
+  },
+  64_000_00,
+);
+
+bench(
+  "Deserialize Alphabet",
+  () => {
+    JSON.parse<string>(v2);
+  },
+  64_000_00,
+);

package/assembly/__benches__/large.bench.ts

@@ -0,0 +1,174 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class Vec3 {
+  public x!: i32;
+  public y!: i32;
+  public z!: i32;
+
+  @inline __SERIALIZE(ptr: usize): void {
+    bs.proposeSize(98);
+    store<u64>(bs.offset, 9570664606466171, 0); // {"x"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("x")));
+    store<u64>(bs.offset, 9570668901433388, 0); // ,"y"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("y")));
+    store<u64>(bs.offset, 9570673196400684, 0); // ,"z"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("z")));
+    store<u16>(bs.offset, 125, 0); // }
+    bs.offset += 2;
+  }
+
+  @inline __INITIALIZE(): this {
+    return this;
+  }
+
+  @inline __DESERIALIZE(keyStart: usize, keyEnd: usize, valStart: usize, valEnd: usize, ptr: usize): void {
+    switch (load<u16>(keyStart)) {
+      case 120: {
+        // x
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("x"));
+        return;
+      }
+      case 121: {
+        // y
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("y"));
+        return;
+      }
+      case 122: {
+        // z
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("z"));
+        return;
+      }
+    }
+    return;
+  }
+}
+
+
+@json
+class LargeJSON {
+  public id!: i32;
+  public name!: string;
+  public age!: i32;
+  public email!: string;
+  public street!: string;
+  public city!: string;
+  public state!: string;
+  public zip!: string;
+  public tags!: string[];
+  public theme!: string;
+  public notifications!: boolean;
+  public language!: string;
+  public movement!: Vec3[];
+}
+
+const v1: LargeJSON = {
+  id: 2,
+  name: "Medium Object",
+  age: 18,
+  email: "me@jairus.dev",
+  street: "I don't want to say my street",
+  city: "I don't want to say this either",
+  state: "It really depends",
+  zip: "I forget what it is",
+  tags: ["me", "dogs", "mountains", "bar", "foo"],
+  theme: "Hyper Term Black",
+  notifications: true,
+  language: "en-US",
+  movement: [
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+  ],
+};
+
+const v2 = `{"id":2,"name":"Medium Object","age":18,"email":"me@jairus.dev","street":"I don't want to say my street","city":"I don't want to say this either","state":"It really depends","zip":"I forget what it is","tags":["me","dogs","mountains","bar","foo"],"theme":"Hyper Term Black","notifications":true,"language":"en-US","movement":[{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3}]}`;
+
+bench(
+  "Serialize Medium Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  3_000_00,
+);
+
+bench(
+  "Deserialize Medium Object",
+  () => {
+    JSON.parse<LargeJSON>(v2);
+  },
+  3_000_00,
+);

package/assembly/__benches__/medium.bench.ts

@@ -0,0 +1,46 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class MediumJSON {
+  public id!: i32;
+  public name!: string;
+  public age!: i32;
+  public email!: string;
+  public street!: string;
+  public city!: string;
+  public state!: string;
+  public zip!: string;
+  public tags!: string[];
+}
+
+const v1: MediumJSON = {
+  id: 2,
+  name: "Medium Object",
+  age: 18,
+  email: "me@jairus.dev",
+  street: "I don't want to say my street",
+  city: "I don't want to say this either",
+  state: "It really depends",
+  zip: "I forget what it is",
+  tags: ["me", "dogs", "mountains", "bar", "foo"],
+};
+
+const v2 = `{"id":2,"name":"Medium Object","age":18,"email":"me@jairus.dev","street":"I don't want to say my street","city":"I don't want to say this either","state":"It really depends","zip":"I forget what it is","tags":["me","dogs","mountains","bar","foo"]}`;
+
+bench(
+  "Serialize Medium Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  8_000_00,
+);
+
+bench(
+  "Deserialize Medium Object",
+  () => {
+    JSON.parse<MediumJSON>(v2);
+  },
+  8_000_00,
+);

package/assembly/__benches__/small.bench.ts

@@ -0,0 +1,33 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class SmallJSON {
+  public id!: i32;
+  public name!: string;
+  public active!: boolean;
+}
+
+const v1: SmallJSON = {
+  id: 1,
+  name: "Small Object",
+  active: true,
+};
+const v2 = '{"id":1,"name":"Small Object","active":true}';
+
+bench(
+  "Serialize Small Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  16_000_00,
+);
+
+bench(
+  "Deserialize Small Object",
+  () => {
+    JSON.parse<SmallJSON>(v2);
+  },
+  16_000_00,
+);