json-as 1.1.11 → 1.1.13

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Change Log
 
+## 2025-05-29 - 1.1.13
+
+- fix: small issues with schema linking
+- tests: add tests for schema linking and discovery
+
+## 2025-05-29 - 1.1.12
+
+- fix: add helpful warning on unknown or unaccessible types in fields
+- feat: support deserialization of class generics
+- fix: add support for numerical generics
+- tests: add proper testing for generics
+- feat: support type aliases with a custom type resolver/linker
+- chore: add other linkers to tsconfig and clean up
+- feat: add type alias resolving
+
 ## 2025-05-28 - 1.1.11
 
 - fix: class resolving should only search top level statements for class declarations

package/README.md

@@ -6,7 +6,7 @@
 ██   ██      ██ ██    ██ ██  ██ ██       ██   ██      ██
  █████  ███████  ██████  ██   ████       ██   ██ ███████
  </span>
-    AssemblyScript - v1.1.11
+    AssemblyScript - v1.1.13
   </pre>
 </h6>
 

package/assembly/__benches__/large.bench.ts

@@ -2,10 +2,11 @@ import { JSON } from "..";
 import { expect } from "../__tests__/lib";
 import { bench } from "./lib/bench";
 
+
 @json
 class RepoOwner {
   public login!: string;
-  public id!: number;
+  public id!: i32;
   public node_id!: string;
   public avatar_url!: string;
   public gravatar_id!: string;
@@ -25,6 +26,7 @@ class RepoOwner {
   public site_admin!: boolean;
 }
 
+
 @json
 class RepoLicense {
   public key!: string;
@@ -34,9 +36,10 @@ class RepoLicense {
   public node_id!: string;
 }
 
+
 @json
 class Repo {
-  public id!: number;
+  public id!: i32;
   public node_id!: string;
   public name!: string;
   public full_name!: string;
@@ -90,9 +93,9 @@ class Repo {
   public clone_url!: string;
   public svn_url!: string;
   public homepage!: string | null;
-  public size!: number;
-  public stargazers_count!: number;
-  public watchers_count!: number;
+  public size!: i32;
+  public stargazers_count!: i32;
+  public watchers_count!: i32;
   public language!: string | null;
   public has_issues!: boolean;
   public has_projects!: boolean;
@@ -100,24 +103,24 @@ class Repo {
   public has_wiki!: boolean;
   public has_pages!: boolean;
   public has_discussions!: boolean;
-  public forks_count!: number;
+  public forks_count!: i32;
   public mirror_url!: string | null;
   public archived!: boolean;
   public disabled!: boolean;
-  public open_issues_count!: number;
+  public open_issues_count!: i32;
   public license!: RepoLicense | null;
   public allow_forking!: boolean;
   public is_template!: boolean;
   public web_commit_signoff_required!: boolean;
   public topics!: string[];
   public visibility!: string;
-  public forks!: number;
-  public open_issues!: number;
-  public watchers!: number;
+  public forks!: i32;
+  public open_issues!: i32;
+  public watchers!: i32;
   public default_branch!: string;
 }
 
-let v1: Repo = {
+const v1: Repo = {
   id: 132935648,
   node_id: "MDEwOlJlcG9zaXRvcnkxMzI5MzU2NDg=",
   name: "boysenberry-repo-1",
@@ -142,7 +145,7 @@ let v1: Repo = {
     received_events_url: "https://api.github.com/users/octocat/received_events",
     type: "User",
     user_view_type: "public",
-    site_admin: false
+    site_admin: false,
   },
   html_url: "https://github.com/octocat/boysenberry-repo-1",
   description: "Testing",
@@ -216,26 +219,26 @@ let v1: Repo = {
   forks: 20,
   open_issues: 1,
   watchers: 332,
-  default_branch: "master"
-}
+  default_branch: "master",
+};
 
 const v2 = `{"id":132935648,"node_id":"MDEwOlJlcG9zaXRvcnkxMzI5MzU2NDg=","name":"boysenberry-repo-1","full_name":"octocat/boysenberry-repo-1","private":true,"owner":{"login":"octocat","id":583231,"node_id":"MDQ6VXNlcjU4MzIzMQ==","avatar_url":"https://avatars.githubusercontent.com/u/583231?v=4","gravatar_id":"","url":"https://api.github.com/users/octocat","html_url":"https://github.com/octocat","followers_url":"https://api.github.com/users/octocat/followers","following_url":"https://api.github.com/users/octocat/following{/other_user}","gists_url":"https://api.github.com/users/octocat/gists{/gist_id}","starred_url":"https://api.github.com/users/octocat/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/octocat/subscriptions","organizations_url":"https://api.github.com/users/octocat/orgs","repos_url":"https://api.github.com/users/octocat/repos","events_url":"https://api.github.com/users/octocat/events{/privacy}","received_events_url":"https://api.github.com/users/octocat/received_events","type":"User","user_view_type":"public","site_admin":false},"html_url":"https://github.com/octocat/boysenberry-repo-1","description":"Testing","fork":true,"url":"https://api.github.com/repos/octocat/boysenberry-repo-1","forks_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/forks","keys_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/keys{/key_id}","collaborators_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/teams","hooks_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/hooks","issue_events_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/issues/events{/number}","events_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/events","assignees_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/assignees{/user}","branches_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/branches{/branch}","tags_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/tags","blobs_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/refs{/sha}","trees_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/trees{/sha}","statuses_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/statuses/{sha}","languages_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/languages","stargazers_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/stargazers","contributors_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/contributors","subscribers_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/subscribers","subscription_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/subscription","commits_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/commits{/sha}","git_commits_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/commits{/sha}","comments_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/comments{/number}","issue_comment_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/issues/comments{/number}","contents_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/contents/{+path}","compare_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/compare/{base}...{head}","merges_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/merges","archive_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/downloads","issues_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/issues{/number}","pulls_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/pulls{/number}","milestones_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/milestones{/number}","notifications_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/labels{/name}","releases_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/releases{/id}","deployments_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/deployments","created_at":"2018-05-10T17:51:29Z","updated_at":"2025-05-24T02:01:19Z","pushed_at":"2024-05-26T07:02:05Z","git_url":"git://github.com/octocat/boysenberry-repo-1.git","ssh_url":"git@github.com:octocat/boysenberry-repo-1.git","clone_url":"https://github.com/octocat/boysenberry-repo-1.git","svn_url":"https://github.com/octocat/boysenberry-repo-1","homepage":"","size":4,"stargazers_count":332,"watchers_count":332,"language":null,"has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"has_discussions":false,"forks_count":20,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":1,"license":null,"allow_forking":true,"is_template":false,"web_commit_signoff_required":false,"topics":[],"visibility":"public","forks":20,"open_issues":1,"watchers":332,"default_branch":"master"}`;
 
 expect(JSON.stringify(v1)).toBe(v2);
-expect(JSON.stringify(JSON.parse(v2))).toBe(v2);
+expect(JSON.stringify(JSON.parse<Repo>(v2))).toBe(v2);
 
 bench(
   "Serialize Large Object",
   () => {
     JSON.stringify(v1);
   },
-  1_000_000,
+  100_00,
 );
 
 bench(
   "Deserialize Large Object",
   () => {
-    JSON.parse(v2);
+    JSON.parse<Repo>(v2);
   },
-  1_000_000,
-);
+  100_00,
+);

package/assembly/__tests__/generics.spec.ts

@@ -0,0 +1,40 @@
+import { JSON } from "..";
+import { describe, expect } from "./lib";
+
+@json
+class GenericTest<T> {
+    public foo: T;
+
+    constructor(foo: T) {
+        this.foo = foo;
+    }
+}
+
+@json
+class Vec3 {
+    public x!: i32;
+    public y!: i32;
+    public z!: i32;
+}
+
+describe("Should serialize generics", () => {
+    expect(JSON.stringify(new GenericTest<string>("bar"))).toBe('{"foo":"bar"}');
+    expect(JSON.stringify(new GenericTest<i32>(42))).toBe('{"foo":42}');
+    expect(JSON.stringify(new GenericTest<boolean>(true))).toBe('{"foo":true}');
+    expect(JSON.stringify(new GenericTest<Vec3>({ x: 1, y: 2, z: 3 }))).toBe('{"foo":{"x":1,"y":2,"z":3}}');
+    expect(JSON.stringify(new GenericTest<string[]>(["item1", "item2"]))).toBe('{"foo":["item1","item2"]}');
+    expect(JSON.stringify(new GenericTest<Vec3[]>([{ x: 1, y: 2, z: 3 }, { x: 4, y: 5, z: 6 }]))).toBe('{"foo":[{"x":1,"y":2,"z":3},{"x":4,"y":5,"z":6}]}');
+    expect(JSON.stringify(new GenericTest<i32[]>([1, 2, 3]))).toBe('{"foo":[1,2,3]}');
+    expect(JSON.stringify(new GenericTest<boolean[]>([true, false, true]))).toBe('{"foo":[true,false,true]}');
+});
+
+describe("Should deserialize generics", () => {
+    expect(JSON.parse<GenericTest<string>>('{"foo":"bar"}').foo).toBe("bar");
+    expect(JSON.parse<GenericTest<i32>>('{"foo":42}').foo.toString()).toBe("42");
+    expect(JSON.parse<GenericTest<boolean>>('{"foo":true}').foo).toBe(true);
+    expect(JSON.stringify(JSON.parse<GenericTest<Vec3>>('{"foo":{"x":1,"y":2,"z":3}}'))).toBe('{"foo":{"x":1,"y":2,"z":3}}');
+    expect(JSON.stringify(JSON.parse<GenericTest<string[]>>('{"foo":["item1","item2"]}'))).toBe('{"foo":["item1","item2"]}');
+    expect(JSON.stringify(JSON.parse<GenericTest<Vec3[]>>('{"foo":[{"x":1,"y":2,"z":3},{"x":4,"y":5,"z":6}]}'))).toBe('{"foo":[{"x":1,"y":2,"z":3},{"x":4,"y":5,"z":6}]}');
+    expect(JSON.stringify(JSON.parse<GenericTest<i32[]>>('{"foo":[1,2,3]}'))).toBe('{"foo":[1,2,3]}');
+    expect(JSON.stringify(JSON.parse<GenericTest<boolean[]>>('{"foo":[true,false,true]}'))).toBe('{"foo":[true,false,true]}');
+});

package/assembly/__tests__/lib/index.ts

@@ -13,7 +13,7 @@ export function expect<T>(left: T): Expectation {
   // @ts-ignore
   if (!isDefined(left.toString)) throw new Error("Expected left to have a toString method, but it does not.");
   // @ts-ignore
-  return new Expectation(isNull(left) ? "null" : left.toString());
+  return new Expectation(left == null ? "null" : left.toString());
 }
 
 class Expectation {
@@ -26,16 +26,12 @@ class Expectation {
     // @ts-ignore
     if (!isDefined(right.toString)) throw new Error("Expected right to have a toString method, but it does not.");
     // @ts-ignore
-    if (this.left != (isNull(right) ? "null" : right.toString())) {
+    if (this.left != (right == null ? "null" : right.toString())) {
       console.log("  " + currentDescription + "\n");
       // @ts-ignore
-      console.log("  (expected) -> " + (isNull(right) ? "null" : right.toString()));
+      console.log("  (expected) -> " + (right == null ? "null" : right.toString()));
       console.log("  (received) -> " + this.left);
       unreachable();
     }
   }
 }
-
-function isNull<T>(value: T): boolean {
-  return isInteger<T>() && !isSigned<T>() && nameof<T>() == "usize" && value == 0;
-}

package/assembly/__tests__/resolving.spec.ts

@@ -0,0 +1,47 @@
+import { JSON } from "..";
+import { describe, expect } from "./lib";
+import { Vec3 } from "./types";
+
+@json
+class Player {
+  @alias("first name")
+  firstName!: string;
+  lastName!: string;
+  lastActive!: i32[];
+  @omitif((self: Player) => self.age < 18)
+  age!: i32;
+  @omitnull()
+  pos!: Vec3 | null;
+  isVerified!: boolean;
+}
+
+const player: Player = {
+  firstName: "Jairus",
+  lastName: "Tanaka",
+  lastActive: [3, 9, 2025],
+  age: 18,
+  pos: {
+    x: 3.4,
+    y: 1.2,
+    z: 8.3,
+  },
+  isVerified: true,
+};
+
+@json
+class Foo {
+    bar: Bar = new Bar();
+}
+
+@json
+class Bar {
+    baz: string = "buz"
+}
+
+describe("Should resolve imported schemas", () => {
+    expect(JSON.stringify(player)).toBe('{"age":18,"pos":{"x":3.4,"y":1.2,"z":8.3},"first name":"Jairus","lastName":"Tanaka","lastActive":[3,9,2025],"isVerified":true}');
+});
+
+describe("Should resolve local schemas", () => {
+    expect(JSON.stringify(new Foo())).toBe('{"bar":{"baz":"buz"}}');
+});

package/assembly/__tests__/types.spec.ts

@@ -0,0 +1,26 @@
+import { JSON } from "..";
+import { describe, expect } from "./lib";
+
+type StringAlias = string;
+type StringAlias1 = StringAlias;
+type StringAlias2 = StringAlias1;
+type StringAlias3 = StringAlias2;
+type StringAlias4 = StringAlias3;
+
+@json
+class Alias {
+  public foo: StringAlias4 = "";
+  constructor(foo: StringAlias2) {
+    this.foo = foo;
+  }
+}
+
+const alias = new Alias("bar");
+
+describe("Should serialize with type aliases", () => {
+    expect(JSON.stringify(alias)).toBe('{"foo":"bar"}');
+});
+
+describe("Should deserialize with type aliases", () => {
+    expect(JSON.stringify(JSON.parse<Alias>('{"foo":"bar"}'))).toBe('{"foo":"bar"}');
+});