Perf, deduplication, tsc passing, discord

Author: tannerlinsley

.gitignore

@@ -28,3 +28,4 @@ dist
 # Content Collections generated files
 .content-collections
 
+test-results

AGENTS.md

@@ -40,6 +40,38 @@ const value = getValue() // Type inferred from function implementation
 
 If types need to be fixed, fix them at the source (schema, API definition, function signature) rather than casting at the point of use.
 
+### Generic Type Parameter Naming
+
+**All generic type parameters must be prefixed with `T`.**
+
+This convention makes it immediately clear that a name refers to a type parameter rather than a concrete type or value.
+
+❌ **Bad:**
+
+```typescript
+function withCapability<Args extends unknown[], R>(
+  handler: (user: AuthUser, ...args: Args) => R,
+) { ... }
+```
+
+✅ **Good:**
+
+```typescript
+function withCapability<TArgs extends unknown[], TReturn>(
+  handler: (user: AuthUser, ...args: TArgs) => TReturn,
+) { ... }
+```
+
+Common examples:
+
+- `T` for a single generic type
+- `TArgs` for argument types
+- `TReturn` for return types
+- `TData` for data types
+- `TError` for error types
+- `TKey` for key types
+- `TValue` for value types
+
 ## Route Loaders
 
 ### loaderDeps Must Be Specific

package.json

@@ -17,7 +17,9 @@
     "db:generate": "drizzle-kit generate",
     "db:migrate": "drizzle-kit migrate",
     "db:push": "drizzle-kit push",
-    "db:studio": "drizzle-kit studio"
+    "db:studio": "drizzle-kit studio",
+    "test": "pnpm run test:smoke",
+    "test:smoke": "playwright test"
   },
   "dependencies": {
     "@auth/core": "0.37.0",
@@ -53,6 +55,7 @@
     "cmdk": "^1.1.1",
     "d3": "^7.9.0",
     "date-fns": "^2.30.0",
+    "discord-interactions": "^4.4.0",
     "drizzle-orm": "^0.44.7",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "gray-matter": "^4.0.3",
@@ -93,6 +96,7 @@
     "@content-collections/core": "^0.8.2",
     "@content-collections/vite": "^0.2.4",
     "@eslint/js": "^9.39.1",
+    "@playwright/test": "^1.57.0",
     "@shikijs/transformers": "^1.10.3",
     "@types/node": "^24.3.0",
     "@types/pg": "^8.15.6",

playwright.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig } from '@playwright/test'
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: 0,
+  workers: 1,
+  reporter: 'list',
+  timeout: 30000,
+  use: {
+    baseURL: 'http://localhost:3000',
+    trace: 'off',
+    video: 'off',
+    screenshot: 'off',
+  },
+  webServer: {
+    command: 'pnpm dev',
+    url: 'http://localhost:3000',
+    reuseExistingServer: !process.env.CI,
+    timeout: 120000,
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { browserName: 'chromium', headless: true },
+    },
+  ],
+})

pnpm-lock.yaml

@@ -0,0 +1,63 @@
+/**
+ * Register Discord slash commands with the Discord API.
+ *
+ * Run this script after adding new commands or modifying existing ones:
+ *   pnpm tsx scripts/register-discord-commands.ts
+ *
+ * Required environment variables:
+ *   DISCORD_APPLICATION_ID - Your Discord application ID
+ *   DISCORD_BOT_TOKEN - Your Discord bot token
+ */
+
+const DISCORD_APPLICATION_ID = process.env.DISCORD_APPLICATION_ID
+const DISCORD_BOT_TOKEN = process.env.DISCORD_BOT_TOKEN
+
+if (!DISCORD_APPLICATION_ID || !DISCORD_BOT_TOKEN) {
+  console.error('Missing required environment variables:')
+  if (!DISCORD_APPLICATION_ID) console.error('  - DISCORD_APPLICATION_ID')
+  if (!DISCORD_BOT_TOKEN) console.error('  - DISCORD_BOT_TOKEN')
+  process.exit(1)
+}
+
+const commands = [
+  {
+    name: 'tanstack',
+    description: 'Check TanStack Bot status',
+    type: 1, // CHAT_INPUT
+  },
+]
+
+async function registerCommands() {
+  const url = `https://discord.com/api/v10/applications/${DISCORD_APPLICATION_ID}/commands`
+
+  console.log('Registering commands with Discord API...')
+  console.log(`Application ID: ${DISCORD_APPLICATION_ID}`)
+  console.log(`Commands to register: ${commands.map((c) => c.name).join(', ')}`)
+
+  const response = await fetch(url, {
+    method: 'PUT',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bot ${DISCORD_BOT_TOKEN}`,
+    },
+    body: JSON.stringify(commands),
+  })
+
+  if (!response.ok) {
+    const error = await response.text()
+    console.error(`Failed to register commands: ${response.status}`)
+    console.error(error)
+    process.exit(1)
+  }
+
+  const registered = await response.json()
+  console.log('\nSuccessfully registered commands:')
+  for (const cmd of registered) {
+    console.log(`  - /${cmd.name} (ID: ${cmd.id})`)
+  }
+}
+
+registerCommands().catch((error) => {
+  console.error('Failed to register commands:', error)
+  process.exit(1)
+})

public/blog-assets/tanstack-ai-why-we-split-the-adapters/header.jpeg

@@ -117,30 +117,30 @@ export type AuthGuards = ReturnType<typeof createAuthGuards>
 /**
  * Create a guard that wraps a handler with capability check
  */
-export function withCapability<T extends (...args: unknown[]) => unknown>(
+export function withCapability<TArgs extends unknown[], TReturn>(
   guards: AuthGuards,
   capability: Capability,
   getRequest: () => Request,
-  handler: (user: AuthUser, ...args: Parameters<T>) => ReturnType<T>,
-): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>> {
-  return async (...args: Parameters<T>) => {
+  handler: (user: AuthUser, ...args: TArgs) => TReturn,
+) {
+  return async (...args: TArgs): Promise<Awaited<TReturn>> => {
     const request = getRequest()
     const user = await guards.requireCapability(request, capability)
-    return handler(user, ...args) as Awaited<ReturnType<T>>
+    return (await handler(user, ...args)) as Awaited<TReturn>
   }
 }
 
 /**
  * Create a guard that wraps a handler with auth check
  */
-export function withAuth<T extends (...args: unknown[]) => unknown>(
+export function withAuth<TArgs extends unknown[], TReturn>(
   guards: AuthGuards,
   getRequest: () => Request,
-  handler: (user: AuthUser, ...args: Parameters<T>) => ReturnType<T>,
-): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>> {
-  return async (...args: Parameters<T>) => {
+  handler: (user: AuthUser, ...args: TArgs) => TReturn,
+) {
+  return async (...args: TArgs): Promise<Awaited<TReturn>> => {
     const request = getRequest()
     const user = await guards.requireAuth(request)
-    return handler(user, ...args) as Awaited<ReturnType<T>>
+    return (await handler(user, ...args)) as Awaited<TReturn>
   }
 }

scripts/register-discord-commands.ts

@@ -6,32 +6,11 @@
  * server and client code.
  */
 
-// ============================================================================
-// Capability Types
-// ============================================================================
-
-export type Capability =
-  | 'admin'
-  | 'disableAds'
-  | 'builder'
-  | 'feed'
-  | 'moderate-feedback'
-  | 'moderate-showcases'
-
-export const VALID_CAPABILITIES: readonly Capability[] = [
-  'admin',
-  'disableAds',
-  'builder',
-  'feed',
-  'moderate-feedback',
-  'moderate-showcases',
-] as const
-
-// ============================================================================
-// OAuth Types
-// ============================================================================
+// Re-export shared types from db/types.ts (single source of truth)
+export type { Capability, OAuthProvider } from '~/db/types'
+export { CAPABILITIES as VALID_CAPABILITIES } from '~/db/types'
 
-export type OAuthProvider = 'github' | 'google'
+import type { Capability, OAuthProvider } from '~/db/types'
 
 export interface OAuthProfile {
   id: string

src/auth/guards.server.ts

@@ -1,10 +1,12 @@
 ---
-title: 'Why We Split the Adapters'
+title: 'TanStack AI: Why We Split the Adapters'
 published: 2026-01-02
 authors:
   - Alem Tuzlak
 ---
 
+![TanStack AI: Why We Split the Adapters](/blog-assets/tanstack-ai-why-we-split-the-adapters/header.jpeg)
+
 With the latest release we brought a major architectural change to how we do adapters. Instead of one monolithic adapter that does everything, we split into smaller adapters. Each in charge of a single functionality.
 
 Here's why.