refactor: Standardize and share store definitions

Author: aklinker1

src/apis/extension-store-apis.ts

@@ -0,0 +1,34 @@
+import { createApp } from "@aklinker1/zeta";
+import { z } from "zod";
+import { contextPlugin } from "../plugins/context-plugin";
+import { NotFoundHttpError } from "@aklinker1/zeta";
+import { HttpStatus } from "@aklinker1/zeta";
+import { ExtensionStoreName } from "../enums";
+
+export const extensionStoreApis = createApp()
+  .use(contextPlugin)
+  .get(
+    "/api/rest/:storeName/:id/screenshots/:index",
+    {
+      operationId: "redirectToScreenshot",
+      tags: ["Chrome Extensions"],
+      description:
+        "Redirect to a screenshot's URL from the Chrome Web Store listing",
+      params: z.object({
+        storeName: z.enum(ExtensionStoreName),
+        id: z.string(),
+        index: z.coerce.number().int().min(0),
+      }),
+    },
+    async ({ params, stores, set }) => {
+      const screenshotUrl = await stores[params.storeName].getScreenshotUrl(
+        params.id,
+        params.index,
+      );
+      if (!screenshotUrl)
+        throw new NotFoundHttpError("Extension or screenshot not found");
+
+      set.status = HttpStatus.Found;
+      set.headers["Location"] = screenshotUrl;
+    },
+  );

src/routes/grpahql-routes.ts src/apis/graphql-apis.tssrc/routes/grpahql-routes.ts renamed to src/apis/graphql-apis.ts

@@ -12,7 +12,7 @@ const PLAYGROUND_HTML = (PLAYGROUND_HTML_TEMPLATE as any as string).replace(
 
 const graphql = createGraphql();
 
-export const graphqlRoutes = createApp()
+export const graphqlApis = createApp()
   .post(
     "/api",
     {

src/apis/system-apis.ts

@@ -0,0 +1,30 @@
+import { createApp } from "@aklinker1/zeta";
+import z from "zod";
+import { version } from "../version";
+
+export const systemApis = createApp()
+  .get(
+    "/",
+    {
+      summary: "API Docs Redirect",
+      tags: ["System"],
+      description: "Redirect to the API reference when visiting the root URL.",
+    },
+    ({ set }) => {
+      set.status = 302;
+      set.headers.Location = "/scalar";
+    },
+  )
+  .get(
+    "/api/health",
+    {
+      summary: "Health Check",
+      tags: ["System"],
+      description: "Used to make sure the API is up and running.",
+      responses: z.object({
+        status: z.literal("ok"),
+        version: z.string(),
+      }),
+    },
+    () => ({ status: "ok" as const, version }),
+  );

src/dependencies.ts

@@ -1,9 +1,23 @@
 import { createIocContainer } from "@aklinker1/zero-ioc";
-import { createChromeService } from "./utils/chrome/chrome-service";
-import { createFirefoxService } from "./utils/firefox/firefox-service";
-import { createEdgeService } from "./utils/edge/edge-service";
+import { createChromeWebStore } from "./services/chrome-web-store";
+import { createFirefoxAddonStore } from "./services/firefox-addon-store";
+import { createEdgeAddonStore } from "./services/edge-addon-store";
+import type { ExtensionStores } from "./services/extension-stores";
+import { ExtensionStoreName } from "./enums";
 
 export const dependencies = createIocContainer()
-  .register("chrome", createChromeService)
-  .register("firefox", createFirefoxService)
-  .register("edge", createEdgeService);
+  .register("chromeWebStore", createChromeWebStore)
+  .register("firefoxAddonStore", createFirefoxAddonStore)
+  .register("edgeAddonStore", createEdgeAddonStore)
+  .register(
+    "stores",
+    (deps) =>
+      ({
+        [ExtensionStoreName.ChromeExtensions]: deps.chromeWebStore,
+        [ExtensionStoreName.ChromeWebStore]: deps.chromeWebStore,
+        [ExtensionStoreName.FirefoxExtensions]: deps.firefoxAddonStore,
+        [ExtensionStoreName.FirefoxAddonStore]: deps.firefoxAddonStore,
+        [ExtensionStoreName.EdgeExtensions]: deps.edgeAddonStore,
+        [ExtensionStoreName.EdgeAddonStore]: deps.edgeAddonStore,
+      }) satisfies ExtensionStores,
+  );

src/enums.ts

@@ -0,0 +1,11 @@
+export enum ExtensionStoreName {
+  /** @deprecated Use {@link ChromeWebStore} instead. */
+  ChromeExtensions = "chrome-extensions",
+  ChromeWebStore = "chrome-web-store",
+  /** @deprecated Use {@link FirefoxAddonStore} instead. */
+  FirefoxExtensions = "firefox-extensions",
+  FirefoxAddonStore = "firefox-addon-store",
+  /** @deprecated Use {@link EdgeAddonStore} instead. */
+  EdgeExtensions = "edge-extensions",
+  EdgeAddonStore = "edge-addon-store",
+}

src/routes/rest-routes.ts

@@ -1,12 +1,12 @@
 import consola from "consola";
 import { createApp } from "@aklinker1/zeta";
 import { corsPlugin } from "./plugins/cors-plugin";
-import { graphqlRoutes } from "./routes/grpahql-routes";
-import { restRoutes } from "./routes/rest-routes";
+import { graphqlApis } from "./apis/graphql-apis";
+import { extensionStoreApis } from "./apis/extension-store-apis";
 import { zodSchemaAdapter } from "@aklinker1/zeta/adapters/zod-schema-adapter";
-import { version } from "../package.json";
-import { z } from "zod";
+import { version } from "./version";
 import dedent from "dedent";
+import { systemApis } from "./apis/system-apis";
 
 const app = createApp({
   schemaAdapter: zodSchemaAdapter,
@@ -49,33 +49,9 @@ const app = createApp({
 })
   .onGlobalError(({ error }) => void consola.error(error))
   .use(corsPlugin)
-  .use(restRoutes)
-  .use(graphqlRoutes)
-  .get(
-    "/",
-    {
-      summary: "API Docs Redirect",
-      tags: ["System"],
-      description: "Redirect to the API reference when visiting the root URL.",
-    },
-    ({ set }) => {
-      set.status = 302;
-      set.headers.Location = "/scalar";
-    },
-  )
-  .get(
-    "/api/health",
-    {
-      summary: "Health Check",
-      tags: ["System"],
-      description: "Used to make sure the API is up and running.",
-      responses: z.object({
-        status: z.literal("ok"),
-        version: z.string(),
-      }),
-    },
-    () => ({ status: "ok" as const, version }),
-  );
+  .use(systemApis)
+  .use(extensionStoreApis)
+  .use(graphqlApis);
 
 export default app;
 export type App = typeof app;