feat: add PackageApiDb and PackageApiMemDb

Author: velut

lib/db/package-api-db.ts

@@ -0,0 +1,7 @@
+import type { PackageApi } from "@jsdocs-io/extractor";
+
+export interface PackageApiDb {
+	dbName: string;
+	getPackageApi: (pkgId: string) => Promise<PackageApi>;
+	setPackageApi: (pkgId: string, pkgApi: PackageApi) => Promise<void>;
+}

lib/db/package-api-mem-db.test.ts

@@ -0,0 +1,20 @@
+import { fromAny } from "@total-typescript/shoehorn";
+import { goTry } from "go-go-try";
+import { expect, test } from "vitest";
+import { PackageApiMemDb } from "./package-api-mem-db";
+
+test("PackageApiMemDb", async () => {
+	const db = new PackageApiMemDb();
+	expect(db.dbName).toBe("PackageApiMemDb");
+	const [err1] = await goTry(db.getPackageApi("foo"));
+	const [err2] = await goTry(db.setPackageApi("foo", fromAny({ name: "foo" })));
+	const [err3, pkgApi] = await goTry(db.getPackageApi("foo"));
+	expect(err1).toBeDefined();
+	expect(err2).toBeUndefined();
+	expect(err3).toBeUndefined();
+	expect(pkgApi).toMatchInlineSnapshot(`
+		{
+		  "name": "foo",
+		}
+	`);
+});

lib/db/package-api-mem-db.ts

@@ -0,0 +1,17 @@
+import type { PackageApi } from "@jsdocs-io/extractor";
+import type { PackageApiDb } from "./package-api-db";
+
+export class PackageApiMemDb implements PackageApiDb {
+	dbName = "PackageApiMemDb";
+	#db = new Map<string, PackageApi>();
+
+	async getPackageApi(pkgId: string): Promise<PackageApi> {
+		const pkgApi = this.#db.get(pkgId);
+		if (!pkgApi) throw new Error("package api not found in mem db");
+		return pkgApi;
+	}
+
+	async setPackageApi(pkgId: string, pkgApi: PackageApi) {
+		this.#db.set(pkgId, pkgApi);
+	}
+}