Project Clarity: Parsing Rewrite

deno.json

@@ -2,6 +2,7 @@
   "tasks": {
     "example": "deno run --allow-net --allow-read --allow-write --allow-env=DEBUG ./examples/authentication.ts",
     "test": "deno test --allow-net --allow-read --allow-write --allow-env=DEBUG --fail-fast ./tests/",
+    "test2": "deno test src",
     "npm": "deno run -A ./scripts/npm.ts"
   },
   "lint": {

examples/authentication.ts

@@ -43,10 +43,9 @@ auth.addEventListener("requires-login", (event) => {
   resolve(auth_flow);
 });
 
-muse.get_library()
-  .then((data) => {
-    return Deno.writeTextFile(
-      "store/library.json",
-      JSON.stringify(data, null, 2),
-    );
-  });
+const data = await muse.get_home();
+
+await Deno.writeTextFile(
+  "store/home.json",
+  JSON.stringify(data, null, 2),
+);

src/mixins2/browse/home.ts

@@ -0,0 +1,45 @@
+import { request_json } from "../../mixins/_request.ts";
+
+import { RawJSON } from "../../parsers2/types.d.ts";
+import { parse_single_column_browse_results_renderer } from "../../parsers2/tabs/mod.ts";
+import { parse_background, Thumbnail } from "../../parsers2/thumbnail/mod.ts";
+import { parse_mood_chips } from "../../parsers2/chips/mod.ts";
+import { ParseMoodChipResult } from "../../parsers2/chips/mood.ts";
+import { parse_section_list } from "../../parsers2/list/mod.ts";
+import { parse_music_carousel_shelf_renderers } from "../../parsers2/music_carousel/mod.ts";
+import { parse_music_two_row_item_renderer } from "../../parsers2/items/mod.ts";
+
+export type MoodChip = ParseMoodChipResult;
+
+export interface Home {
+  moods: MoodChip[];
+  thumbnails: Thumbnail[];
+  continuation: string | null;
+  content: RawJSON;
+}
+
+export async function get_home(): Promise<Home> {
+  const json = await request_json("browse", {
+    data: { browseId: "FEmusic_home" },
+  });
+
+  const background = parse_background(json);
+  const tab = parse_single_column_browse_results_renderer(json.contents).tab;
+  const section_list = parse_section_list(tab.content);
+  const moods = parse_mood_chips(section_list.header);
+
+  const contents = parse_music_carousel_shelf_renderers(section_list.contents)
+    .map((content) => {
+      return {
+        ...content,
+        contents: content.contents.map(parse_music_two_row_item_renderer),
+      };
+    });
+
+  return {
+    moods,
+    thumbnails: background.thumbnails,
+    continuation: section_list.nextContinuation,
+    content: contents,
+  };
+}

src/mixins2/browse/mod.ts

@@ -0,0 +1 @@
+export * from "./home.ts";

src/mixins2/mod.ts

@@ -0,0 +1 @@
+export * from "./browse/mod.ts";

src/mod.ts

@@ -5,12 +5,4 @@ export * from "./errors.ts";
 export * from "./request.ts";
 export * from "./auth.ts";
 
-export * from "./mixins/browsing.ts";
-export * from "./mixins/explore.ts";
-export * from "./mixins/library.ts";
-export * from "./mixins/playlist.ts";
-export * from "./mixins/queue.ts";
-export * from "./mixins/search.ts";
-export * from "./mixins/uploads.ts";
-
-export type * from "./mixins/utils.ts";
+export * from "./mixins2/mod.ts";

src/parsers2/chips/_chip_list.test.ts

@@ -0,0 +1,26 @@
+import { expect } from "jsr:@std/expect";
+import { describe, it } from "jsr:@std/testing/bdd";
+
+import { _parse_chips_list } from "./_chip_list.ts";
+
+describe("_parse_chips_list", () => {
+  const stub_parser = (t: string) => t;
+
+  it("parses chips", () => {
+    expect(
+      _parse_chips_list(
+        { chipCloudRenderer: { chips: ["hello"] } },
+        stub_parser,
+      )[0],
+    ).toBe("hello");
+  });
+
+  it("produces expected amount of chips", () => {
+    expect(
+      _parse_chips_list(
+        { chipCloudRenderer: { chips: ["hello", "world", "!"] } },
+        stub_parser,
+      ),
+    ).toHaveLength(3);
+  });
+});

src/parsers2/chips/_chip_list.ts

@@ -0,0 +1,7 @@
+import { Parser, RawJSON } from "../types.d.ts";
+
+export function _parse_chips_list<T>(content: RawJSON, parser: Parser<T>): T[] {
+  const chips = content.chipCloudRenderer.chips;
+
+  return chips.map(parser);
+}

src/parsers2/chips/chip.test.ts

@@ -0,0 +1,59 @@
+import { assert } from "jsr:@std/assert/assert";
+import { expect } from "jsr:@std/expect";
+import { describe, it } from "jsr:@std/testing/bdd";
+
+import { EndpointType } from "../endpoint/mod.ts";
+import { parse_chip } from "./chip.ts";
+import { RawJSON } from "../types.d.ts";
+
+describe("parse_text_runs_simple", () => {
+  const text = { runs: [{ text: "Chip Title" }] };
+
+  function getChip(overrides: RawJSON) {
+    return {
+      chipCloudChipRenderer: {
+        text,
+        isSelected: false,
+        navigationEndpoint: {},
+        ...overrides,
+      },
+    };
+  }
+
+  describe("parses selected", () => {
+    it("parses selected false", () => {
+      expect(
+        parse_chip(getChip({ isSelected: false })).selected,
+      ).toBe(false);
+    });
+
+    it("parses selected false", () => {
+      expect(
+        parse_chip(getChip({ isSelected: true })).selected,
+      ).toBe(true);
+    });
+  });
+
+  it("parses text", () => {
+    expect(
+      parse_chip(getChip({ text: { runs: [{ text: "Hello, World!" }] } })).text,
+    ).toBe("Hello, World!");
+  });
+
+  it("parses navigation", () => {
+    const chip = parse_chip(getChip({
+      navigationEndpoint: {
+        browseEndpoint: {
+          browseId: "BROWSE_ID",
+          params: "PARAMS",
+        },
+      },
+    }));
+
+    assert(chip.navigation.browse, "must parse a browse endpoint");
+
+    expect(
+      chip.navigation.browse.type,
+    ).toBe(EndpointType.BROWSE);
+  });
+});