split scheduled funcs

Author: tannerlinsley

.prettierignore

@@ -6,3 +6,5 @@ routeTree.gen.ts
 src/blog/tanstack-db-0.1-the-embedded-client-database-for-tanstack-query.md
 .content-collections
 .claude
+dist/**
+.output/**

.prettierrc

@@ -0,0 +1,5 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all"
+}

agents/tasks/tanstack-com-task-list.md

@@ -28,6 +28,7 @@
 ### Tasks
 
 - [ ] Implement “Trusted By” on homepage
+
   - Status: Backlog
   - Notes:
     - Reuse `TrustedByMarquee` but upgrade to support logos + links + tooltip proof.
@@ -42,6 +43,7 @@
   - Owner:
 
 - [ ] Add Real-Time Metrics Counters (per-library + org rollup)
+
   - Status: Partial (org rollup live via `OpenSourceStats`)
   - Notes:
     - Extend counters to per-library pages using existing Convex endpoints or add repo-level endpoints via `convex-oss-stats` if needed.
@@ -89,6 +91,7 @@
 ### Tasks
 
 - [ ] Redesign/Create “About” page
+
   - Status: Backlog
   - Notes:
     - Route: `src/routes/about.tsx`.
@@ -98,6 +101,7 @@
   - Links: `src/components/MaintainerCard.tsx`, `src/routes/_libraries/maintainers.tsx`.
 
 - [ ] Speaking Engagements section
+
   - Status: Backlog
   - Notes:
     - Add to About or standalone `src/routes/speaking.tsx`.
@@ -132,6 +136,7 @@
 ### Tasks
 
 - [ ] “Enterprise” page
+
   - Status: Partial
   - Notes:
     - Option 1: Rename and expand `paid-support` into `enterprise` (route alias + updated copy) while keeping legacy route.
@@ -160,6 +165,7 @@
 ### Tasks
 
 - [ ] Public Roadmap page
+
   - Status: Backlog
   - Notes:
     - Route: `src/routes/roadmap.tsx`.
@@ -188,6 +194,7 @@
 ### Tasks
 
 - [ ] Press/Media Kit page
+
   - Status: Backlog
   - Notes:
     - Route: `src/routes/media-kit.tsx`.
@@ -196,6 +203,7 @@
   - Acceptance: Page provides direct downloads and usage rules.
 
 - [ ] In the News page
+
   - Status: Backlog
   - Notes:
     - Route: `src/routes/news.tsx`.

netlify/functions/refresh-github-stats.ts

@@ -0,0 +1,56 @@
+import type { Config } from '@netlify/functions'
+import { refreshGitHubOrgStats } from '~/utils/stats.functions'
+
+/**
+ * Netlify Scheduled Function - Refresh GitHub stats cache
+ *
+ * This function refreshes pre-aggregated GitHub stats for the TanStack organization:
+ * - Organization-level: stars, contributors, dependents, repositories
+ * - Per-library: stars, contributors, dependents for each library repo
+ *
+ * Scheduled: Runs automatically every 6 hours
+ *
+ * Performance Impact:
+ * - Refresh time: ~1-2 minutes for org + all library repos
+ * - After refresh: ~100-200ms per request (served from cache)
+ */
+const handler = async (req: Request) => {
+  const { next_run } = await req.json()
+
+  console.log('[refresh-github-stats] Starting GitHub stats refresh...')
+
+  const startTime = Date.now()
+
+  try {
+    const org = 'tanstack'
+
+    const { orgStats, libraryResults, libraryErrors } =
+      await refreshGitHubOrgStats(org)
+
+    const duration = Date.now() - startTime
+    console.log(
+      `[refresh-github-stats] ✓ Completed in ${duration}ms - GitHub Org: ${orgStats.starCount.toLocaleString()} stars, Libraries: ${
+        libraryResults.length
+      } refreshed, ${libraryErrors.length} failed`,
+    )
+    console.log('[refresh-github-stats] Next invocation at:', next_run)
+  } catch (error) {
+    const duration = Date.now() - startTime
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    const errorStack = error instanceof Error ? error.stack : undefined
+
+    console.error(
+      `[refresh-github-stats] ✗ Failed after ${duration}ms:`,
+      errorMessage,
+    )
+    if (errorStack) {
+      console.error('[refresh-github-stats] Stack:', errorStack)
+    }
+  }
+}
+
+export default handler
+
+export const config: Config = {
+  schedule: '0 */6 * * *', // Every 6 hours
+}

netlify/functions/refresh-npm-stats.ts

@@ -0,0 +1,58 @@
+import type { Config } from '@netlify/functions'
+import { refreshNpmOrgStats } from '~/utils/stats.functions'
+
+/**
+ * Netlify Scheduled Function - Refresh NPM stats cache
+ *
+ * This function refreshes pre-aggregated NPM stats for the TanStack organization:
+ * - Total downloads across all packages (including legacy packages)
+ * - Per-package download counts and rates
+ *
+ * Scheduled: Runs automatically every 6 hours
+ * Concurrency: 8 packages at a time, 500ms delay between packages
+ *
+ * Performance Impact:
+ * - Refresh time: ~10-20 minutes for 203 packages (199 scoped + 4 legacy)
+ * - After refresh: ~100-200ms per request (served from cache)
+ */
+const handler = async (req: Request) => {
+  const { next_run } = await req.json()
+
+  console.log('[refresh-npm-stats] Starting NPM stats refresh...')
+
+  const startTime = Date.now()
+
+  try {
+    const org = 'tanstack'
+
+    // Refresh NPM org stats (fetches all packages, aggregates, and caches)
+    console.log('[refresh-npm-stats] Refreshing NPM org stats...')
+    const npmStats = await refreshNpmOrgStats(org)
+
+    const duration = Date.now() - startTime
+    console.log(
+      `[refresh-npm-stats] ✓ Completed in ${duration}ms - NPM: ${npmStats.totalDownloads.toLocaleString()} downloads (${
+        Object.keys(npmStats.packageStats || {}).length
+      } packages)`,
+    )
+    console.log('[refresh-npm-stats] Next invocation at:', next_run)
+  } catch (error) {
+    const duration = Date.now() - startTime
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    const errorStack = error instanceof Error ? error.stack : undefined
+
+    console.error(
+      `[refresh-npm-stats] ✗ Failed after ${duration}ms:`,
+      errorMessage,
+    )
+    if (errorStack) {
+      console.error('[refresh-npm-stats] Stack:', errorStack)
+    }
+  }
+}
+
+export default handler
+
+export const config: Config = {
+  schedule: '0 */6 * * *', // Every 6 hours
+}