feat: Add base Extension interface to GQL schema

Author: aklinker1

scripts/generate-gql-types.ts

@@ -16,6 +16,11 @@ export async function generateGqlTypes(fetch: ServerSideFetch = app.build()) {
   consola.info("Generating GraphQL types...");
   const introspection = await introspect(fetch);
 
+  if (introspection.errors) {
+    console.error("Introspection errors:", introspection.errors);
+    throw Error("Introspection failed", { cause: introspection.errors });
+  }
+
   const {
     queryType,
     mutationType,
@@ -50,6 +55,8 @@ export async function generateGqlTypes(fetch: ServerSideFetch = app.build()) {
           return writeObjectType(code, argTypes, type);
         case "SCALAR":
           return writeScalarType(code, type);
+        case "INTERFACE":
+          return writeObjectType(code, argTypes, type);
         default:
           return consola.warn("Unknown kind:", {
             kind: type.kind,

src/assets/schema.gql

@@ -21,34 +21,68 @@ type Query {
   firefoxAddons(ids: [String!]!): [FirefoxAddon]!
 }
 
-type ChromeExtension {
+interface Extension {
   id: String!
   name: String!
   iconUrl: String!
   storeUrl: String!
   shortDescription: String!
   longDescription: String!
-  weeklyActiveUsers: Int!
+  """
+  Different extension stores report users in different units (e.g., weekly active users, daily active users).
+
+  This field is meant to be used as a generic representation of the number of users. Each type that extends this one has individual fields denoting the unit (`ChromeExtension.weeklyActiveUsers`, `FirefoxAddon.dailyActiveUsers`, etc).
+  """
+  users: Int!
   version: String!
   lastUpdated: String!
   rating: Float
   reviewCount: Int
   screenshots: [Screenshot!]!
 }
 
-type FirefoxAddon {
+type ChromeExtension implements Extension {
+  # Extension fields
+
   id: String!
   name: String!
   iconUrl: String!
   storeUrl: String!
   shortDescription: String!
   longDescription: String!
-  dailyActiveUsers: Int!
+  "Same as weeklyActiveUsers"
+  users: Int!
+  version: String!
+  lastUpdated: String!
+  rating: Float
+  reviewCount: Int
+  screenshots: [Screenshot!]!
+
+  # Additional fields
+
+  weeklyActiveUsers: Int!
+}
+
+type FirefoxAddon implements Extension {
+  # Extension fields
+
+  id: String!
+  name: String!
+  iconUrl: String!
+  storeUrl: String!
+  shortDescription: String!
+  longDescription: String!
+  "Same as dailyActiveUsers"
+  users: Int!
   version: String!
   lastUpdated: String!
   rating: Float
   reviewCount: Int
   screenshots: [Screenshot!]!
+
+  # Additional fields
+
+  dailyActiveUsers: Int!
 }
 
 type Screenshot {

src/utils/chrome/chrome-crawler.ts

@@ -59,7 +59,7 @@ export async function crawlExtension(
 
   // Header
 
-  const weeklyActiveUsers = tryExtract("weeklyActiveUsers", validateInt, [
+  const weeklyActiveUsersText = tryExtract("weeklyActiveUsers", validateInt, [
     () => {
       const userCountRow = document.querySelector(
         "main > * > section:first-child > section > div > div:last-child",
@@ -74,6 +74,7 @@ export async function crawlExtension(
       );
     },
   ]);
+  const weeklyActiveUsers = Number(weeklyActiveUsersText);
 
   const rating = tryExtract("rating", validateFloat, [
     () =>
@@ -149,7 +150,8 @@ export async function crawlExtension(
     name,
     iconUrl,
     storeUrl,
-    weeklyActiveUsers: Number(weeklyActiveUsers),
+    users: weeklyActiveUsers,
+    weeklyActiveUsers,
     lastUpdated,
     version,
     shortDescription,

src/utils/firefox/firefox-api.ts

@@ -29,6 +29,7 @@ export function createFirefoxApiClient() {
         shortDescription: Object.values<string>(json.summary)[0]!,
         storeUrl: json.url,
         version: json.current_version.version,
+        users: json.average_daily_users,
         dailyActiveUsers: json.average_daily_users,
         screenshots: (json.previews as any[]).map<Gql.Screenshot>(
           (preview, i) => ({