create-fullstack-scaffold 0.1.1 → 0.2.0

package/template/src/server/db/init.ts

@@ -1,10 +1,7 @@
 import { getDb } from './driver'
 import { permissions, roles, rolePermissions } from './schema'
 import { logger } from '../utils/logger'
-import { seedOrdersIfEmpty } from '../module-order/services/order-service'
-import { seedTicketsIfEmpty } from '../module-ticket/services/ticket-service'
-import { seedDisputesIfEmpty } from '../module-dispute/services/dispute-service'
-import { seedContentsIfEmpty } from '../module-content/services/content-service'
+import { generateUUID } from '../utils/uuid'
 
 const log = logger.db()
 
@@ -355,6 +352,254 @@ const initialRolePermissions = [
   { roleId: 'role_user', permissionId: 'perm_order_view' },
 ]
 
+async function seedPluginsIfEmpty() {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic import for presets that may not have plugin module
+  let plugins: any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let pluginVersions: any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let pluginCategories: any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let pluginCategoryMappings: any
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const schema = (await import('./schema')) as Record<string, any>
+    plugins = schema.plugins
+    pluginVersions = schema.pluginVersions
+    pluginCategories = schema.pluginCategories
+    pluginCategoryMappings = schema.pluginCategoryMappings
+    if (!plugins) return
+  } catch {
+    return
+  }
+
+  const db = await getDb()
+
+  const existing = await db.select().from(plugins)
+  if (existing.length > 0) return
+
+  log.info({}, 'Seeding plugins...')
+
+  const sampleCategories = [
+    {
+      id: generateUUID(),
+      name: 'UI & Design',
+      slug: 'ui-design',
+      description: 'Visual customization and theming',
+      icon: 'palette',
+      sortOrder: 1,
+    },
+    {
+      id: generateUUID(),
+      name: 'Analytics',
+      slug: 'analytics',
+      description: 'Data tracking and reporting',
+      icon: 'chart',
+      sortOrder: 2,
+    },
+    {
+      id: generateUUID(),
+      name: 'SEO & Marketing',
+      slug: 'seo-marketing',
+      description: 'Search optimization and growth tools',
+      icon: 'trending-up',
+      sortOrder: 3,
+    },
+    {
+      id: generateUUID(),
+      name: 'Developer Tools',
+      slug: 'developer-tools',
+      description: 'Utilities for developers',
+      icon: 'code',
+      sortOrder: 4,
+    },
+    {
+      id: generateUUID(),
+      name: 'Integration',
+      slug: 'integration',
+      description: 'Third-party service integrations',
+      icon: 'plug',
+      sortOrder: 5,
+    },
+  ]
+
+  await db.insert(pluginCategories).values(sampleCategories)
+
+  const samplePlugins = [
+    {
+      id: generateUUID(),
+      name: 'Theme Engine',
+      slug: 'theme-engine',
+      description:
+        'Advanced theming system with dark mode, custom color palettes, and responsive layout controls.',
+      readme:
+        '# Theme Engine\n\nA powerful theming plugin for customizing the look and feel of your application.',
+      authorId: '1',
+      authorName: 'superadmin',
+      repositoryUrl: 'https://github.com/example/theme-engine',
+      homepageUrl: 'https://theme-engine.example.com',
+      license: 'MIT',
+      version: '2.1.0',
+      status: 'approved' as const,
+      downloadCount: 1520,
+      viewCount: 4320,
+      featured: true,
+      screenshotUrl: 'https://picsum.photos/seed/theme/800/400',
+      tags: '["theme","dark-mode","customization"]',
+    },
+    {
+      id: generateUUID(),
+      slug: 'analytics-dashboard',
+      name: 'Analytics Dashboard',
+      description:
+        'Real-time analytics dashboard with charts, heatmaps, and user behavior tracking.',
+      readme: '# Analytics Dashboard\n\nTrack user engagement and visualize data in real time.',
+      authorId: '1',
+      authorName: 'superadmin',
+      repositoryUrl: 'https://github.com/example/analytics-dashboard',
+      homepageUrl: 'https://analytics.example.com',
+      license: 'Apache-2.0',
+      version: '1.5.3',
+      status: 'approved' as const,
+      downloadCount: 980,
+      viewCount: 2100,
+      featured: true,
+      screenshotUrl: 'https://picsum.photos/seed/analytics/800/400',
+      tags: '["analytics","dashboard","charts"]',
+    },
+    {
+      id: generateUUID(),
+      slug: 'seo-optimizer',
+      name: 'SEO Optimizer',
+      description:
+        'Automated SEO optimization with meta tags, sitemap generation, and structured data support.',
+      authorId: '2',
+      authorName: 'customerservice',
+      repositoryUrl: 'https://github.com/example/seo-optimizer',
+      license: 'MIT',
+      version: '1.2.0',
+      status: 'approved' as const,
+      downloadCount: 740,
+      viewCount: 1800,
+      featured: false,
+      screenshotUrl: 'https://picsum.photos/seed/seo/800/400',
+      tags: '["seo","meta","sitemap"]',
+    },
+    {
+      id: generateUUID(),
+      slug: 'api-toolkit',
+      name: 'API Toolkit',
+      description:
+        'Developer toolkit for building and testing REST APIs with auto-documentation and mock servers.',
+      authorId: '2',
+      authorName: 'customerservice',
+      repositoryUrl: 'https://github.com/example/api-toolkit',
+      homepageUrl: 'https://api-toolkit.example.com',
+      license: 'MIT',
+      version: '3.0.1',
+      status: 'approved' as const,
+      downloadCount: 2100,
+      viewCount: 5600,
+      featured: true,
+      screenshotUrl: 'https://picsum.photos/seed/apitoolkit/800/400',
+      tags: '["api","developer","testing","documentation"]',
+    },
+    {
+      id: generateUUID(),
+      slug: 'notification-hub',
+      name: 'Notification Hub',
+      description:
+        'Unified notification management supporting email, SMS, push, and in-app notifications.',
+      authorId: '3',
+      authorName: 'user1',
+      repositoryUrl: 'https://github.com/example/notification-hub',
+      license: 'ISC',
+      version: '1.0.0',
+      status: 'pending' as const,
+      downloadCount: 0,
+      viewCount: 50,
+      featured: false,
+      screenshotUrl: 'https://picsum.photos/seed/notify/800/400',
+      tags: '["notification","email","push"]',
+    },
+  ]
+
+  await db.insert(plugins).values(samplePlugins)
+
+  const sampleVersions = [
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[0].id,
+      version: '2.1.0',
+      changelog: 'Added responsive layout controls',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[0].id,
+      version: '2.0.0',
+      changelog: 'Major rewrite with dark mode support',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[1].id,
+      version: '1.5.3',
+      changelog: 'Fixed heatmap rendering',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[1].id,
+      version: '1.5.0',
+      changelog: 'Added real-time tracking',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[2].id,
+      version: '1.2.0',
+      changelog: 'Structured data support',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[3].id,
+      version: '3.0.1',
+      changelog: 'Auto-documentation improvements',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[3].id,
+      version: '3.0.0',
+      changelog: 'Major version with mock server',
+      status: 'approved' as const,
+    },
+    {
+      id: generateUUID(),
+      pluginId: samplePlugins[4].id,
+      version: '1.0.0',
+      changelog: 'Initial release',
+      status: 'pending' as const,
+    },
+  ]
+
+  await db.insert(pluginVersions).values(sampleVersions)
+
+  const sampleMappings = [
+    { pluginId: samplePlugins[0].id, categoryId: sampleCategories[0].id },
+    { pluginId: samplePlugins[1].id, categoryId: sampleCategories[1].id },
+    { pluginId: samplePlugins[2].id, categoryId: sampleCategories[2].id },
+    { pluginId: samplePlugins[3].id, categoryId: sampleCategories[3].id },
+    { pluginId: samplePlugins[4].id, categoryId: sampleCategories[4].id },
+  ]
+
+  await db.insert(pluginCategoryMappings).values(sampleMappings)
+
+  log.info({}, 'Plugin seeding complete!')
+}
+
 export async function initializeDatabase() {
   const db = await getDb()
 
@@ -402,11 +647,13 @@ export async function initializeDatabase() {
   log.info({}, 'Database initialization complete!')
 
   log.info({}, 'Seeding module data...')
-  await Promise.all([
-    seedOrdersIfEmpty(),
-    seedTicketsIfEmpty(),
-    seedDisputesIfEmpty(),
-    seedContentsIfEmpty(),
-  ])
+  const moduleSeeders = [
+    () => import('../module-order/services/order-service').then(m => m.seedOrdersIfEmpty()),
+    () => import('../module-ticket/services/ticket-service').then(m => m.seedTicketsIfEmpty()),
+    () => import('../module-dispute/services/dispute-service').then(m => m.seedDisputesIfEmpty()),
+    () => import('../module-content/services/content-service').then(m => m.seedContentsIfEmpty()),
+    () => seedPluginsIfEmpty(),
+  ]
+  await Promise.all(moduleSeeders.map(fn => fn().catch(() => {})))
   log.info({}, 'Module data seeding complete!')
 }

package/template/src/server/db/schema/developers.ts

@@ -0,0 +1,20 @@
+import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'
+import { sql } from 'drizzle-orm'
+
+export const developers = sqliteTable('developers', {
+  id: text('id').primaryKey(),
+  username: text('username').notNull().unique(),
+  email: text('email').notNull().unique(),
+  passwordHash: text('password_hash').notNull(),
+  role: text('role').notNull().default('developer'),
+  apiKey: text('api_key').notNull().unique(),
+  createdAt: integer('created_at', { mode: 'timestamp' })
+    .notNull()
+    .default(sql`(unixepoch() * 1000)`),
+  updatedAt: integer('updated_at', { mode: 'timestamp' })
+    .notNull()
+    .default(sql`(unixepoch() * 1000)`),
+})
+
+export type DeveloperTable = typeof developers.$inferSelect
+export type NewDeveloper = typeof developers.$inferInsert

package/template/src/server/db/schema/index.ts

@@ -12,3 +12,5 @@ export * from './orders'
 export * from './tickets'
 export * from './disputes'
 export * from './contents'
+export * from './developers'
+export * from './plugins'

package/template/src/server/db/schema/plugins.ts

@@ -0,0 +1,114 @@
+import { sqliteTable, text, integer, uniqueIndex } from 'drizzle-orm/sqlite-core'
+import { sql } from 'drizzle-orm'
+
+export const pluginStatus = ['pending', 'approved', 'rejected'] as const
+export type PluginStatus = (typeof pluginStatus)[number]
+
+export const plugins = sqliteTable('plugins', {
+  id: text('id').primaryKey(),
+  name: text('name').notNull(),
+  slug: text('slug').notNull().unique(),
+  description: text('description').notNull().default(''),
+  readme: text('readme'),
+  authorId: text('author_id').notNull(),
+  authorName: text('author_name').notNull(),
+  repositoryUrl: text('repository_url'),
+  homepageUrl: text('homepage_url'),
+  npmPackage: text('npm_package'),
+  license: text('license'),
+  version: text('version').notNull().default('0.0.1'),
+  status: text('status', { enum: pluginStatus }).notNull().default('pending'),
+  downloadCount: integer('download_count').notNull().default(0),
+  viewCount: integer('view_count').notNull().default(0),
+  featured: integer('featured', { mode: 'boolean' }).notNull().default(false),
+  screenshotUrl: text('screenshot_url'),
+  siteUrls: text('site_urls'),
+  tags: text('tags'),
+  commands: text('commands'),
+  rejectReason: text('reject_reason'),
+  createdAt: integer('created_at', { mode: 'timestamp' })
+    .notNull()
+    .default(sql`(unixepoch() * 1000)`),
+  updatedAt: integer('updated_at', { mode: 'timestamp' })
+    .notNull()
+    .default(sql`(unixepoch() * 1000)`),
+})
+
+export const pluginVersions = sqliteTable(
+  'plugin_versions',
+  {
+    id: text('id').primaryKey(),
+    pluginId: text('plugin_id')
+      .notNull()
+      .references(() => plugins.id, { onDelete: 'cascade' }),
+    version: text('version').notNull(),
+    changelog: text('changelog'),
+    packageUrl: text('package_url'),
+    fileSize: integer('file_size'),
+    checksum: text('checksum'),
+    status: text('status', { enum: pluginStatus }).notNull().default('pending'),
+    publishedAt: integer('published_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    pluginVersionUnique: uniqueIndex('plugin_version_unique').on(table.pluginId, table.version),
+  })
+)
+
+export const pluginReviews = sqliteTable(
+  'plugin_reviews',
+  {
+    id: text('id').primaryKey(),
+    pluginId: text('plugin_id')
+      .notNull()
+      .references(() => plugins.id, { onDelete: 'cascade' }),
+    userId: text('user_id').notNull(),
+    userName: text('user_name').notNull(),
+    rating: integer('rating').notNull(),
+    title: text('title'),
+    content: text('content'),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    pluginUserUnique: uniqueIndex('plugin_review_user_unique').on(table.pluginId, table.userId),
+  })
+)
+
+export const pluginCategories = sqliteTable('plugin_categories', {
+  id: text('id').primaryKey(),
+  name: text('name').notNull().unique(),
+  slug: text('slug').notNull().unique(),
+  description: text('description'),
+  icon: text('icon'),
+  sortOrder: integer('sort_order').notNull().default(0),
+})
+
+export const pluginCategoryMappings = sqliteTable(
+  'plugin_category_mappings',
+  {
+    pluginId: text('plugin_id')
+      .notNull()
+      .references(() => plugins.id, { onDelete: 'cascade' }),
+    categoryId: text('category_id')
+      .notNull()
+      .references(() => pluginCategories.id, { onDelete: 'cascade' }),
+  },
+  table => ({
+    mappingUnique: uniqueIndex('plugin_category_mapping_unique').on(
+      table.pluginId,
+      table.categoryId
+    ),
+  })
+)
+
+export type PluginTable = typeof plugins.$inferSelect
+export type NewPlugin = typeof plugins.$inferInsert
+export type PluginVersionTable = typeof pluginVersions.$inferSelect
+export type NewPluginVersion = typeof pluginVersions.$inferInsert
+export type PluginReviewTable = typeof pluginReviews.$inferSelect
+export type NewPluginReview = typeof pluginReviews.$inferInsert
+export type PluginCategoryTable = typeof pluginCategories.$inferSelect
+export type NewPluginCategory = typeof pluginCategories.$inferInsert

package/template/src/server/db/test-setup.ts

@@ -191,6 +191,87 @@ export async function setupTestDatabase(): Promise<void> {
       created_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL,
       updated_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL
     );
+
+    CREATE TABLE IF NOT EXISTS developers (
+      id TEXT PRIMARY KEY NOT NULL,
+      username TEXT NOT NULL UNIQUE,
+      email TEXT NOT NULL UNIQUE,
+      password_hash TEXT NOT NULL,
+      role TEXT DEFAULT 'developer' NOT NULL,
+      api_key TEXT NOT NULL UNIQUE,
+      created_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL,
+      updated_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS plugins (
+      id TEXT PRIMARY KEY NOT NULL,
+      name TEXT NOT NULL,
+      slug TEXT NOT NULL UNIQUE,
+      description TEXT NOT NULL DEFAULT '',
+      readme TEXT,
+      author_id TEXT NOT NULL,
+      author_name TEXT NOT NULL,
+      repository_url TEXT,
+      homepage_url TEXT,
+      npm_package TEXT,
+      license TEXT,
+      version TEXT NOT NULL DEFAULT '0.0.1',
+      status TEXT NOT NULL DEFAULT 'pending',
+      download_count INTEGER NOT NULL DEFAULT 0,
+      view_count INTEGER NOT NULL DEFAULT 0,
+      featured INTEGER NOT NULL DEFAULT 0,
+      screenshot_url TEXT,
+      site_urls TEXT,
+      tags TEXT,
+      commands TEXT,
+      reject_reason TEXT,
+      created_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL,
+      updated_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS plugin_versions (
+      id TEXT PRIMARY KEY NOT NULL,
+      plugin_id TEXT NOT NULL,
+      version TEXT NOT NULL,
+      changelog TEXT,
+      package_url TEXT,
+      file_size INTEGER,
+      checksum TEXT,
+      status TEXT NOT NULL DEFAULT 'pending',
+      published_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL,
+      FOREIGN KEY (plugin_id) REFERENCES plugins(id) ON DELETE CASCADE,
+      UNIQUE(plugin_id, version)
+    );
+
+    CREATE TABLE IF NOT EXISTS plugin_reviews (
+      id TEXT PRIMARY KEY NOT NULL,
+      plugin_id TEXT NOT NULL,
+      user_id TEXT NOT NULL,
+      user_name TEXT NOT NULL,
+      rating INTEGER NOT NULL,
+      title TEXT,
+      content TEXT,
+      created_at INTEGER DEFAULT (unixepoch() * 1000) NOT NULL,
+      FOREIGN KEY (plugin_id) REFERENCES plugins(id) ON DELETE CASCADE,
+      UNIQUE(plugin_id, user_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS plugin_categories (
+      id TEXT PRIMARY KEY NOT NULL,
+      name TEXT NOT NULL UNIQUE,
+      slug TEXT NOT NULL UNIQUE,
+      description TEXT,
+      icon TEXT,
+      sort_order INTEGER NOT NULL DEFAULT 0
+    );
+
+    CREATE TABLE IF NOT EXISTS plugin_category_mappings (
+      plugin_id TEXT NOT NULL,
+      category_id TEXT NOT NULL,
+      FOREIGN KEY (plugin_id) REFERENCES plugins(id) ON DELETE CASCADE,
+      FOREIGN KEY (category_id) REFERENCES plugin_categories(id) ON DELETE CASCADE,
+      UNIQUE(plugin_id, category_id)
+    );
   `
 
   const statements = migrationSQL.split(';').filter(s => s.trim())
@@ -643,5 +724,15 @@ export async function cleanupTestDatabase(): Promise<void> {
     await client.execute('DELETE FROM orders')
     await client.execute('DELETE FROM disputes')
     await client.execute('DELETE FROM contents')
+    try {
+      await client.execute('DELETE FROM plugin_category_mappings')
+      await client.execute('DELETE FROM plugin_reviews')
+      await client.execute('DELETE FROM plugin_versions')
+      await client.execute('DELETE FROM plugins')
+      await client.execute('DELETE FROM plugin_categories')
+      await client.execute('DELETE FROM developers')
+    } catch {
+      // Plugin tables may not exist in all test environments
+    }
   }
 }

package/template/src/server/entries/cloudflare.ts

@@ -1,8 +1,8 @@
 /**
  * @framework-baseline e350401421193896
  * @framework-modify
- * @reason 统一错误响应格式为 JSON，确保所有错误都返回结构化数据；移除冗余的 globalThis 设置
- * @impact 影响 Cloudflare Workers 环境的错误响应格式
+ * @reason 集成 ISR 缓存层，为页面路由提供增量静态再生能力
+ * @impact 影响 Cloudflare Workers 环境的页面响应流程，新增 ISR 缓存查找/存储/失效逻辑
  *
  * Note: In Cloudflare Workers, each request runs in its own isolate,
  * so globalThis is request-scoped and there's no race condition risk.
@@ -15,6 +15,9 @@ import { getDb } from '../db/driver-cloudflare'
 import { RealtimeDurableObject } from '@server/core'
 import { setRuntimeAdapter } from '@server/core/runtime'
 import { getCloudflareRuntimeAdapter } from '@server/core/runtime-cloudflare'
+import { createISRCache, isISRRoute } from '@server/core/isr-cache'
+import { renderPage } from '@server/core/ssr-renderer'
+import { setISRCache } from '@server/core/isr-invalidation'
 
 export interface CloudflareBindings extends AppBindings {
   DB: D1Database
@@ -24,8 +27,15 @@ export interface CloudflareBindings extends AppBindings {
 const runtimeAdapter = getCloudflareRuntimeAdapter()
 setRuntimeAdapter(runtimeAdapter)
 
+runtimeAdapter.handleWS('/api/chat/ws')
+runtimeAdapter.handleSSE('/api/notifications/stream')
+runtimeAdapter.handleSSE('/api/admin/notifications/stream')
+
 const app = createApp<CloudflareBindings>()
 
+const isrCache = createISRCache()
+setISRCache(isrCache)
+
 const wrappedApp = app
   .use('*', async (c, next) => {
     ;(globalThis as unknown as { DB: D1Database }).DB = c.env.DB
@@ -41,21 +51,73 @@ const wrappedApp = app
   .onError((err, c) => {
     console.error('Server error:', err)
     c.res.headers.set('Content-Type', 'application/json')
-    const statusCode =
-      err instanceof Error && 'status' in err ? (err as { status: number }).status : 500
+    let statusCode = 500
+    if ('statusCode' in err && typeof (err as { statusCode: unknown }).statusCode === 'number') {
+      statusCode = (err as { statusCode: number }).statusCode
+    } else if ('status' in err && typeof (err as { status: unknown }).status === 'number') {
+      statusCode = (err as { status: number }).status
+    }
     const message = err.message || 'Internal server error'
-    const responseStatus = statusCode || 500
-    return c.json({ success: false as const, error: message, status: responseStatus }, responseStatus as 500)
+    return c.json(
+      { success: false as const, error: message, status: statusCode },
+      statusCode as 500
+    )
   })
 
 export default {
   fetch: async (request: Request, env: CloudflareBindings, ctx: ExecutionContext) => {
+    ;(globalThis as unknown as { DB: D1Database }).DB = env.DB
+
     const url = new URL(request.url)
+    const pathname = url.pathname
 
-    if (url.pathname.startsWith('/api/') || url.pathname === '/health') {
+    if (pathname.startsWith('/api/') || pathname === '/health') {
       return wrappedApp.fetch(request, env, ctx)
     }
 
+    if (env.ASSETS) {
+      if (
+        pathname.startsWith('/assets/') ||
+        pathname.endsWith('.js') ||
+        pathname.endsWith('.css') ||
+        pathname.endsWith('.svg') ||
+        pathname.endsWith('.png') ||
+        pathname.endsWith('.ico') ||
+        pathname === '/vite.svg'
+      ) {
+        const assetResponse = await env.ASSETS.fetch(request)
+        if (assetResponse.status !== 404) {
+          return assetResponse
+        }
+      }
+    }
+
+    if (isISRRoute(pathname)) {
+      const result = await isrCache.lookup(pathname)
+
+      if (result.status === 'fresh' && result.html) {
+        return new Response(result.html, {
+          headers: { 'Content-Type': 'text/html;charset=UTF-8', 'X-ISR-Status': 'fresh' },
+        })
+      }
+
+      if (result.status === 'stale' && result.html) {
+        ctx.waitUntil(regeneratePage(pathname, env))
+        return new Response(result.html, {
+          headers: { 'Content-Type': 'text/html;charset=UTF-8', 'X-ISR-Status': 'stale' },
+        })
+      }
+
+      const rendered = await renderPage(pathname)
+
+      ctx.waitUntil(isrCache.store(pathname, rendered.html))
+
+      return new Response(rendered.html, {
+        status: rendered.status,
+        headers: { ...rendered.headers, 'X-ISR-Status': 'miss' },
+      })
+    }
+
     if (env.ASSETS) {
       const assetResponse = await env.ASSETS.fetch(request)
       if (assetResponse.status !== 404) {
@@ -67,5 +129,15 @@ export default {
   },
 }
 
+async function regeneratePage(pathname: string, _env: CloudflareBindings): Promise<void> {
+  try {
+    const rendered = await renderPage(pathname)
+    await isrCache.store(pathname, rendered.html)
+  } catch (error) {
+    console.error('ISR regeneration failed:', error)
+  }
+}
+
+export { isrCache }
 export { RealtimeDurableObject, getDb }
 export type AppType = typeof wrappedApp