create-fullstack-scaffold 0.1.1 → 0.2.0

package/template/src/client/stores/pluginStore.ts

@@ -0,0 +1,279 @@
+import { create } from 'zustand'
+import { apiClient } from '@client/services/apiClient'
+import type {
+  Plugin,
+  Category,
+  Review,
+  MarketplaceStats,
+  CreatePluginInput,
+  CreateReviewInput,
+  PluginListResponse,
+} from '@shared/schemas'
+
+type Pagination = Pick<PluginListResponse, 'page' | 'limit' | 'total'>
+
+interface PluginState {
+  plugins: Plugin[]
+  currentPlugin: Plugin | null
+  reviews: Review[]
+  myPlugins: Plugin[]
+  categories: Category[]
+  stats: MarketplaceStats | null
+  searchQuery: string
+  selectedCategory: string | null
+  loading: boolean
+  error: string | null
+  pagination: Pagination
+
+  fetchPlugins: (page?: number) => Promise<void>
+  fetchPlugin: (slug: string) => Promise<void>
+  fetchReviews: (slug: string) => Promise<void>
+  searchPlugins: (query: string, page?: number) => Promise<void>
+  fetchCategories: () => Promise<void>
+  fetchStats: () => Promise<void>
+  fetchMyPlugins: () => Promise<void>
+  createPlugin: (data: CreatePluginInput) => Promise<string | null>
+  deletePlugin: (slug: string) => Promise<void>
+  submitReview: (slug: string, data: CreateReviewInput) => Promise<void>
+  trackInstall: (slug: string) => Promise<void>
+  setSearchQuery: (query: string) => void
+  setSelectedCategory: (category: string | null) => void
+  clearError: () => void
+  clearCurrentPlugin: () => void
+}
+
+function getErrorMessage(error: unknown): string {
+  if (error instanceof Error) return error.message
+  return 'Unknown error'
+}
+
+export const usePluginStore = create<PluginState>((set, get) => ({
+  plugins: [],
+  currentPlugin: null,
+  reviews: [],
+  myPlugins: [],
+  categories: [],
+  stats: null,
+  searchQuery: '',
+  selectedCategory: null,
+  loading: false,
+  error: null,
+  pagination: { page: 1, limit: 20, total: 0 },
+
+  fetchPlugins: async (page = 1) => {
+    set({ loading: true, error: null })
+    try {
+      const { selectedCategory } = get()
+      const query: Record<string, string | number | boolean | undefined> = {
+        page,
+        limit: 20,
+        sort: 'newest',
+      }
+      if (selectedCategory) query.category = selectedCategory
+
+      const response = await apiClient.api.plugins.$get({ query })
+      const result = await response.json()
+      if (result.success) {
+        set({
+          plugins: result.data.plugins,
+          pagination: {
+            page: result.data.page,
+            limit: result.data.limit,
+            total: result.data.total,
+          },
+          loading: false,
+        })
+      } else {
+        set({
+          loading: false,
+          error: (result as { error?: string }).error ?? 'Failed to fetch plugins',
+        })
+      }
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+    }
+  },
+
+  fetchPlugin: async (slug: string) => {
+    set({ loading: true, error: null, currentPlugin: null })
+    try {
+      const response = await apiClient.api.plugins[':slug'].$get({ param: { slug } })
+      const result = await response.json()
+      if (result.success) {
+        set({ currentPlugin: result.data, loading: false })
+      } else {
+        set({ loading: false, error: (result as { error?: string }).error ?? 'Plugin not found' })
+      }
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+    }
+  },
+
+  fetchReviews: async (slug: string) => {
+    try {
+      const response = await apiClient.api.plugins[':slug'].reviews.$get({ param: { slug } })
+      const result = await response.json()
+      if (result.success) {
+        set({ reviews: result.data })
+      }
+    } catch (error) {
+      console.error('Failed to fetch reviews:', error)
+    }
+  },
+
+  searchPlugins: async (query: string, page = 1) => {
+    set({ loading: true, error: null })
+    try {
+      const { selectedCategory } = get()
+
+      const response = await apiClient.api.plugins.search.$get({
+        query: {
+          q: query,
+          page,
+          limit: 20,
+          ...(selectedCategory ? { category: selectedCategory } : {}),
+        },
+      })
+      const result = await response.json()
+      if (result.success) {
+        set({
+          plugins: result.data.plugins,
+          pagination: {
+            page: result.data.page,
+            limit: result.data.limit,
+            total: result.data.total,
+          },
+          loading: false,
+        })
+      } else {
+        set({ loading: false, error: (result as { error?: string }).error ?? 'Search failed' })
+      }
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+    }
+  },
+
+  fetchCategories: async () => {
+    try {
+      const response = await apiClient.api.categories.$get()
+      const result = await response.json()
+      if (result.success) {
+        set({ categories: result.data })
+      }
+    } catch (error) {
+      console.error('Failed to fetch categories:', error)
+    }
+  },
+
+  fetchStats: async () => {
+    try {
+      const response = await apiClient.api.stats.$get()
+      const result = await response.json()
+      if (result.success) {
+        set({ stats: result.data })
+      }
+    } catch (error) {
+      console.error('Failed to fetch stats:', error)
+    }
+  },
+
+  fetchMyPlugins: async () => {
+    set({ loading: true, error: null })
+    try {
+      const response = await apiClient.api.plugins.mine.$get()
+      const result = await response.json()
+      if (result.success) {
+        set({ myPlugins: result.data, loading: false })
+      } else {
+        set({
+          loading: false,
+          error: (result as { error?: string }).error ?? 'Failed to fetch your plugins',
+        })
+      }
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+    }
+  },
+
+  createPlugin: async (data: CreatePluginInput): Promise<string | null> => {
+    set({ loading: true, error: null })
+    try {
+      const response = await apiClient.api.plugins.$post({ json: data })
+      const result = await response.json()
+      if (result.success) {
+        set(state => ({
+          myPlugins: [result.data, ...state.myPlugins],
+          loading: false,
+        }))
+        return result.data.slug
+      }
+      set({
+        loading: false,
+        error: (result as { error?: string }).error ?? 'Failed to create plugin',
+      })
+      return null
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+      return null
+    }
+  },
+
+  deletePlugin: async (slug: string) => {
+    set({ loading: true, error: null })
+    try {
+      const response = await apiClient.api.plugins[':slug'].$delete({ param: { slug } })
+      const result = await response.json()
+      if (result.success) {
+        set(state => ({
+          myPlugins: state.myPlugins.filter(p => p.slug !== slug),
+          plugins: state.plugins.filter(p => p.slug !== slug),
+          loading: false,
+        }))
+      } else {
+        set({
+          loading: false,
+          error: (result as { error?: string }).error ?? 'Failed to delete plugin',
+        })
+      }
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+    }
+  },
+
+  submitReview: async (slug: string, data: CreateReviewInput) => {
+    set({ loading: true, error: null })
+    try {
+      const response = await apiClient.api.plugins[':slug'].reviews.$post({
+        param: { slug },
+        json: data,
+      })
+      const result = await response.json()
+      if (result.success) {
+        set(state => ({
+          reviews: [result.data, ...state.reviews],
+          loading: false,
+        }))
+      } else {
+        set({
+          loading: false,
+          error: (result as { error?: string }).error ?? 'Failed to submit review',
+        })
+      }
+    } catch (error) {
+      set({ error: getErrorMessage(error), loading: false })
+    }
+  },
+
+  trackInstall: async (slug: string) => {
+    try {
+      await apiClient.api.plugins[':slug'].install.$post({ param: { slug } })
+    } catch (error) {
+      console.error('Failed to track install:', error)
+    }
+  },
+
+  setSearchQuery: (query: string) => set({ searchQuery: query }),
+  setSelectedCategory: (category: string | null) => set({ selectedCategory: category }),
+  clearError: () => set({ error: null }),
+  clearCurrentPlugin: () => set({ currentPlugin: null, reviews: [] }),
+}))

package/template/src/client/stores/todoStore.ts

@@ -30,9 +30,7 @@ export const useTodoStore = create<TodoState>(set => ({
       const response = await apiClient.api.todos.$get()
       const result = await response.json()
       if (result.success) {
-        const data = result.data as Todo[] | { items: Todo[] }
-        const items = Array.isArray(data) ? data : data.items || []
-        set({ todos: items, loading: false })
+        set({ todos: result.data, loading: false })
       } else {
         set({ error: result.error, loading: false })
       }
@@ -162,9 +160,7 @@ export const useTodoStore = create<TodoState>(set => ({
       if (result.success) {
         set(state => {
           const newAttachments = new Map(state.attachments)
-          const data = result.data as TodoAttachment[] | { items: TodoAttachment[] }
-          const items = Array.isArray(data) ? data : data.items || []
-          newAttachments.set(todoId, items)
+          newAttachments.set(todoId, result.data)
           return { attachments: newAttachments }
         })
       }

package/template/src/server/core/__tests__/isr-cache.test.ts

@@ -0,0 +1,117 @@
+/**
+ * @framework-baseline dd5cd4fe46320b03
+ * @framework-modify
+ * @reason 移除未使用的 vi import，修复 TypeScript strict 检查
+ * @impact 不影响功能，仅清理代码
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest'
+import { isISRRoute, generateCacheKey, createISRCache, type ISRCache } from '@server/core/isr-cache'
+
+describe('isISRRoute', () => {
+  it('matches static ISR routes', () => {
+    expect(isISRRoute('/')).toBe(true)
+    expect(isISRRoute('/todos')).toBe(true)
+    expect(isISRRoute('/content')).toBe(true)
+    expect(isISRRoute('/notifications')).toBe(true)
+    expect(isISRRoute('/websocket')).toBe(true)
+  })
+
+  it('matches dynamic content routes', () => {
+    expect(isISRRoute('/content/123')).toBe(true)
+    expect(isISRRoute('/content/content-456')).toBe(true)
+    expect(isISRRoute('/content/abc-def')).toBe(true)
+  })
+
+  it('does not match non-ISR routes', () => {
+    expect(isISRRoute('/api/todos')).toBe(false)
+    expect(isISRRoute('/api/health')).toBe(false)
+    expect(isISRRoute('/assets/main.js')).toBe(false)
+    expect(isISRRoute('/admin/dashboard')).toBe(false)
+    expect(isISRRoute('/health')).toBe(false)
+    expect(isISRRoute('/vite.svg')).toBe(false)
+  })
+})
+
+describe('generateCacheKey', () => {
+  it('normalizes root path', () => {
+    expect(generateCacheKey('/')).toBe('isr:/index')
+  })
+
+  it('generates keys for regular paths', () => {
+    expect(generateCacheKey('/todos')).toBe('isr:/todos')
+    expect(generateCacheKey('/content/123')).toBe('isr:/content/123')
+  })
+
+  it('removes trailing slash', () => {
+    expect(generateCacheKey('/todos/')).toBe('isr:/todos')
+  })
+})
+
+describe('ISRCache (memory)', () => {
+  let cache: ISRCache
+
+  beforeEach(() => {
+    cache = createISRCache({ maxAge: 1, staleWhileRevalidate: 1 })
+  })
+
+  it('returns miss for uncached routes', async () => {
+    const result = await cache.lookup('/todos')
+    expect(result.status).toBe('miss')
+    expect(result.html).toBeNull()
+  })
+
+  it('stores and retrieves pages', async () => {
+    await cache.store('/todos', '<html>todos</html>')
+    const result = await cache.lookup('/todos')
+    expect(result.status).toBe('fresh')
+    expect(result.html).toBe('<html>todos</html>')
+  })
+
+  it('serves stale content after maxAge', async () => {
+    cache = createISRCache({ maxAge: 0, staleWhileRevalidate: 60 })
+
+    await cache.store('/todos', '<html>todos</html>')
+
+    await new Promise(resolve => setTimeout(resolve, 10))
+
+    const result = await cache.lookup('/todos')
+    expect(result.status).toBe('stale')
+    expect(result.html).toBe('<html>todos</html>')
+  })
+
+  it('returns miss after maxAge + staleWhileRevalidate', async () => {
+    cache = createISRCache({ maxAge: 0, staleWhileRevalidate: 0 })
+
+    await cache.store('/todos', '<html>todos</html>')
+
+    await new Promise(resolve => setTimeout(resolve, 10))
+
+    const result = await cache.lookup('/todos')
+    expect(result.status).toBe('miss')
+  })
+
+  it('purges specific pages', async () => {
+    await cache.store('/todos', '<html>todos</html>')
+    await cache.store('/content', '<html>content</html>')
+
+    await cache.purge('/todos')
+
+    expect((await cache.lookup('/todos')).status).toBe('miss')
+    expect((await cache.lookup('/content')).status).toBe('fresh')
+  })
+
+  it('purges by pattern', async () => {
+    await cache.store('/content', '<html>list</html>')
+    await cache.store('/content/123', '<html>detail 123</html>')
+    await cache.store('/content/456', '<html>detail 456</html>')
+    await cache.store('/todos', '<html>todos</html>')
+
+    await cache.purgePattern('isr:/content/*')
+
+    expect((await cache.lookup('/content')).status).toBe('fresh')
+    expect((await cache.lookup('/content/123')).status).toBe('miss')
+    expect((await cache.lookup('/content/456')).status).toBe('miss')
+    expect((await cache.lookup('/todos')).status).toBe('fresh')
+  })
+})

package/template/src/server/core/__tests__/isr-invalidation.test.ts

@@ -0,0 +1,72 @@
+/**
+ * @framework-baseline 202ba4a1c53d59e3
+ * @framework-modify
+ * @reason 移除未使用的 vi import，修复 TypeScript strict 检查
+ * @impact 不影响功能，仅清理代码
+ */
+
+import { describe, it, expect } from 'vitest'
+import {
+  purgePage,
+  purgeContentPages,
+  purgeAllPages,
+  setISRCache,
+  getISRCache,
+} from '@server/core/isr-invalidation'
+import { createISRCache } from '@server/core/isr-cache'
+
+describe('isr-invalidation', () => {
+  it('returns null cache when not set', () => {
+    expect(getISRCache()).toBeNull()
+  })
+
+  it('sets and gets cache', () => {
+    const cache = createISRCache()
+    setISRCache(cache)
+    expect(getISRCache()).toBe(cache)
+  })
+
+  describe('with cache set', () => {
+    beforeEach(() => {
+      const cache = createISRCache()
+      setISRCache(cache)
+    })
+
+    it('purgePage purges specific page', async () => {
+      const cache = getISRCache()!
+      await cache.store('/todos', '<html>todos</html>')
+      expect((await cache.lookup('/todos')).status).toBe('fresh')
+
+      await purgePage('/todos')
+      expect((await cache.lookup('/todos')).status).toBe('miss')
+    })
+
+    it('purgeContentPages purges content list and details', async () => {
+      const cache = getISRCache()!
+      await cache.store('/content', '<html>list</html>')
+      await cache.store('/content/123', '<html>detail</html>')
+      await cache.store('/todos', '<html>todos</html>')
+
+      await purgeContentPages()
+
+      expect((await cache.lookup('/content')).status).toBe('miss')
+      expect((await cache.lookup('/content/123')).status).toBe('miss')
+      expect((await cache.lookup('/todos')).status).toBe('fresh')
+    })
+
+    it('purgeAllPages purges everything', async () => {
+      const cache = getISRCache()!
+      await cache.store('/', '<html>home</html>')
+      await cache.store('/todos', '<html>todos</html>')
+      await cache.store('/content', '<html>content</html>')
+      await cache.store('/content/123', '<html>detail</html>')
+
+      await purgeAllPages()
+
+      expect((await cache.lookup('/')).status).toBe('miss')
+      expect((await cache.lookup('/todos')).status).toBe('miss')
+      expect((await cache.lookup('/content')).status).toBe('miss')
+      expect((await cache.lookup('/content/123')).status).toBe('miss')
+    })
+  })
+})

package/template/src/server/core/__tests__/ssr-renderer.test.ts

@@ -0,0 +1,89 @@
+/**
+ * @framework-baseline 351df7aadf410369
+ */
+
+import { describe, it, expect } from 'vitest'
+import { renderPage, matchRoute } from '@server/core/ssr-renderer'
+
+describe('matchRoute', () => {
+  it('matches static routes', () => {
+    expect(matchRoute('/')).not.toBeNull()
+    expect(matchRoute('/todos')).not.toBeNull()
+    expect(matchRoute('/notifications')).not.toBeNull()
+    expect(matchRoute('/websocket')).not.toBeNull()
+    expect(matchRoute('/content')).not.toBeNull()
+  })
+
+  it('matches dynamic content routes', () => {
+    const result = matchRoute('/content/123')
+    expect(result).not.toBeNull()
+    expect(result!.params.id).toBe('123')
+  })
+
+  it('extracts params from dynamic routes', () => {
+    const result = matchRoute('/content/content-42')
+    expect(result).not.toBeNull()
+    expect(result!.params.id).toBe('content-42')
+  })
+
+  it('returns null for non-matching routes', () => {
+    expect(matchRoute('/api/todos')).toBeNull()
+    expect(matchRoute('/admin')).toBeNull()
+    expect(matchRoute('/unknown')).toBeNull()
+  })
+})
+
+describe('renderPage', () => {
+  it('renders todos page with correct meta', async () => {
+    const result = await renderPage('/todos')
+    expect(result.status).toBe(200)
+    expect(result.html).toContain('<title>Todo List - Biomimic App</title>')
+    expect(result.html).toContain('meta name="description"')
+    expect(result.html).toContain('meta property="og:title"')
+    expect(result.html).toContain('<div id="root"></div>')
+    expect(result.html).toContain('window.__SSR_DATA__')
+    expect(result.headers['X-ISR-Rendered']).toBe('true')
+  })
+
+  it('renders root path', async () => {
+    const result = await renderPage('/')
+    expect(result.status).toBe(200)
+    expect(result.html).toContain('<title>')
+  })
+
+  it('renders content list page', async () => {
+    const result = await renderPage('/content')
+    expect(result.status).toBe(200)
+    expect(result.html).toContain('内容中心')
+  })
+
+  it('renders content detail page', async () => {
+    const result = await renderPage('/content/123')
+    expect(result.status).toBe(200)
+    expect(result.html).toContain('window.__SSR_DATA__')
+  })
+
+  it('renders fallback for unknown routes', async () => {
+    const result = await renderPage('/unknown-page')
+    expect(result.status).toBe(200)
+    expect(result.html).toContain('<div id="root"></div>')
+    expect(result.html).toContain('Biomimic App')
+    expect(result.headers['X-ISR-Rendered']).toBeUndefined()
+  })
+
+  it('produces valid HTML structure', async () => {
+    const result = await renderPage('/todos')
+    expect(result.html).toContain('<!DOCTYPE html>')
+    expect(result.html).toContain('<html lang="en">')
+    expect(result.html).toContain('</html>')
+    expect(result.html).toContain('<head>')
+    expect(result.html).toContain('</head>')
+    expect(result.html).toContain('<body>')
+    expect(result.html).toContain('</body>')
+  })
+
+  it('includes generator meta tag', async () => {
+    const result = await renderPage('/todos')
+    expect(result.html).toContain('name="generator" content="ISR"')
+  })
+})