docs: add sponsors

docs/.vitepress/components/AsideSponsors.vue

@@ -0,0 +1,117 @@
+<script setup lang="ts">
+import { useLocalStorage } from '@vueuse/core';
+import type { Sponsor } from 'vitepress/dist/client/theme-default/components/VPSponsorsGrid.vue';
+import { VPDocAsideSponsors } from 'vitepress/theme';
+import { computed, onMounted } from 'vue';
+
+/**
+ * @see https://graphql-docs-v2.opencollective.com/types/Member
+ */
+interface Backer {
+  account: {
+    name: string | null;
+    slug: string;
+    imageUrl: string | null;
+  };
+  since: string;
+  isActive: boolean;
+  totalDonations: {
+    value: number | null;
+    currency: string | null;
+    valueInCents: number | null;
+  };
+}
+
+const backersStorage = useLocalStorage<{
+  lastUpdated: number;
+  backers: Backer[];
+}>('fakerjs-backers', {
+  lastUpdated: 0,
+  backers: [],
+});
+
+const sponsors = computed<Sponsor[]>(
+  () =>
+    backersStorage.value?.backers
+      .filter((backer) => backer.account.imageUrl)
+      .map((backer) => ({
+        name: backer.account.name ?? backer.account.slug,
+        img: backer.account.imageUrl!,
+        url: `https://opencollective.com/${backer.account.slug}`,
+      }))
+      .slice(0, 10) || []
+);
+
+async function fetchBackers(): Promise<Backer[]> {
+  const response = await fetch('https://api.opencollective.com/graphql/v2', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      operationName: 'GetFakerJSDonations',
+      query: `query GetFakerJSDonations {
+  account(slug: "fakerjs") {
+    name
+    slug
+    members(role: BACKER, limit: 1000) {
+      totalCount
+      nodes {
+        account {
+          name
+          slug
+          imageUrl
+        }
+        since
+        isActive
+        totalDonations {
+          value
+          currency
+          valueInCents
+        }
+      }
+    }
+  }
+}
+`,
+      variables: {},
+    }),
+  }).then((res) => res.json());
+
+  return (response.data.account.members.nodes as Backer[]).toSorted(
+    (a, b) =>
+      (b.totalDonations.valueInCents ?? 0) -
+      (a.totalDonations.valueInCents ?? 0)
+  );
+}
+
+onMounted(async () => {
+  // Refresh every start of the month
+  const now = new Date();
+  const lastUpdated = new Date(backersStorage.value.lastUpdated);
+  if (
+    backersStorage.value.backers.length === 0 ||
+    now.getFullYear() !== lastUpdated.getFullYear() ||
+    now.getMonth() !== lastUpdated.getMonth()
+  ) {
+    try {
+      const backers = await fetchBackers();
+      backersStorage.value = {
+        lastUpdated: Date.now(),
+        backers,
+      };
+    } catch {
+      // Silently ignore fetch errors; the section will hide itself when empty.
+    }
+  }
+});
+</script>
+
+<template>
+  <VPDocAsideSponsors
+    v-if="sponsors.length > 0"
+    tier="Top 10 Sponsors"
+    size="xmini"
+    :data="sponsors"
+  />
+</template>

docs/.vitepress/theme/index.ts

@@ -1,22 +1,20 @@
 import DefaultTheme from 'vitepress/theme';
 import { defineAsyncComponent, h } from 'vue';
+import AsideSponsors from '../components/AsideSponsors.vue';
 import './index.css';
 
 export default {
-  ...DefaultTheme,
+  extends: DefaultTheme,
   Layout() {
-    return h(
-      DefaultTheme.Layout,
-      null,
-      __BANNER__
-        ? {
-            'layout-top': () =>
-              h(
-                defineAsyncComponent(() => import('../components/Banner.vue')),
-                { version: __BANNER__ }
-              ),
-          }
-        : null
-    );
+    return h(DefaultTheme.Layout, null, {
+      'layout-top': __BANNER__
+        ? () =>
+            h(
+              defineAsyncComponent(() => import('../components/Banner.vue')),
+              { version: __BANNER__ }
+            )
+        : null,
+      'aside-ads-before': () => h(AsideSponsors),
+    });
   },
 };