create-fullstack-scaffold 0.4.25 → 0.5.0

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

@@ -2,16 +2,12 @@
  * @framework-baseline a124c5bce28416ca
  *
  * @framework-modify
- * @reason 自动生成的基准更新
- * @impact 无功能影响
- */
-
-/**
- * ISR cache invalidation utilities.
- * Call these from service layer when content changes.
+ * @reason 模块化改造：purgeAllPages 改为遍历注册表
+ * @impact 不再硬编码路由列表
  */
 
 import type { ISRCache } from './isr-cache'
+import { isrRegistry } from './isr-registry'
 
 let _cache: ISRCache | null = null
 
@@ -36,10 +32,8 @@ export async function purgeContentPages(): Promise<void> {
 
 export async function purgeAllPages(): Promise<void> {
   if (!_cache) return
-  await _cache.purge('/')
-  await _cache.purge('/todos')
-  await _cache.purge('/content')
-  await _cache.purge('/notifications')
-  await _cache.purge('/websocket')
+  for (const path of isrRegistry.getExactPaths()) {
+    await _cache.purge(path)
+  }
   await _cache.purgePattern('isr:/content/*')
 }

package/template/src/server/core/isr-registry.ts

@@ -0,0 +1,104 @@
+/**
+ * @framework-baseline faa47d8c6e71847d
+ *
+ *
+ * @framework-modify
+ * @reason prettier 格式化与注释结构整理（无逻辑改动）
+ * @impact 框架文件维护性修改，行为见测试
+ */
+
+/**
+ * ISR Route Registry — modules register their ISR routes here.
+ * Full SSG mode: fetches data for meta tags AND pre-populates stores for React SSR.
+ * The CF entry and ISR cache use this to discover which routes need ISR.
+ */
+
+export type ISRMatcher = string | ((pathname: string) => boolean)
+
+export interface ISRRouterContext {
+  /** D1 database binding (Cloudflare) or null (Node.js / test) */
+  db?: unknown
+  /** Raw env object (for module-specific needs) */
+  env?: unknown
+}
+
+export interface ISRRouteEntry {
+  /** Module name that owns this route */
+  module: string
+  /**
+   * Path matcher: exact string or function.
+   * String starting with '/' and ending with '/' = prefix match.
+   * String starting with '/' = exact match.
+   * Function = custom matcher.
+   */
+  match: ISRMatcher
+  /** Fetch data needed for SSR rendering and meta tags */
+  fetch: (pathname: string, ctx: ISRRouterContext) => Promise<unknown>
+  /** Generate meta tags from fetched data */
+  meta: (data: unknown, pathname: string) => { title: string; description: string }
+  /** Max age in seconds (optional, per-route override) */
+  maxAge?: number
+}
+
+class ISRRegistry {
+  private entries: ISRRouteEntry[] = []
+
+  register(entry: ISRRouteEntry): void {
+    const idx = this.entries.findIndex(e => e.module === entry.module && e.match === entry.match)
+    if (idx >= 0) {
+      this.entries[idx] = entry
+    } else {
+      this.entries.push(entry)
+    }
+  }
+
+  registerMany(entries: ISRRouteEntry[]): void {
+    for (const entry of entries) {
+      this.register(entry)
+    }
+  }
+
+  match(pathname: string): ISRRouteEntry | null {
+    for (const entry of this.entries) {
+      if (typeof entry.match === 'string' && !entry.match.endsWith('/')) {
+        if (pathname === entry.match) return entry
+      }
+    }
+    for (const entry of this.entries) {
+      if (typeof entry.match === 'string' && entry.match.endsWith('/') && entry.match !== '/') {
+        if (pathname.startsWith(entry.match)) return entry
+      }
+    }
+    for (const entry of this.entries) {
+      if (typeof entry.match === 'function') {
+        if (entry.match(pathname)) return entry
+      }
+    }
+    for (const entry of this.entries) {
+      if (entry.match === '/' && pathname === '/') return entry
+    }
+    return null
+  }
+
+  isISRRoute(pathname: string): boolean {
+    return this.match(pathname) !== null
+  }
+
+  getExactPaths(): string[] {
+    return this.entries.filter(e => typeof e.match === 'string').map(e => e.match as string)
+  }
+
+  getAll(): ISRRouteEntry[] {
+    return [...this.entries]
+  }
+
+  clear(): void {
+    this.entries = []
+  }
+}
+
+export const isrRegistry = new ISRRegistry()
+
+export function createISRRegistry(): ISRRegistry {
+  return new ISRRegistry()
+}

package/template/src/server/core/isr-renderer.ts

@@ -0,0 +1,75 @@
+/**
+ * @framework-baseline cec621fae360ba2b
+ *
+ *
+ * @framework-modify
+ * @reason prettier 格式化与注释结构整理；body 改为可选字段
+ * @impact 框架文件维护性修改，行为见测试
+ */
+
+/**
+ * ISR HTML renderer — injects SSR body content AND meta tags into HTML template.
+ * Full SSG mode: combines React SSR output with SEO meta tags.
+ */
+
+export function escapeHtml(str: string): string {
+  return str
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+}
+
+export interface ISRPageMeta {
+  title: string
+  description: string
+}
+
+export interface ISRRenderOptions {
+  /** Pre-built HTML template (from ASSETS or readFileSync) */
+  template: string | null
+  /** SSR body content (React renderToString output); omitted in meta-only mode */
+  body?: string
+  /** Meta tags */
+  meta: ISRPageMeta
+}
+
+/**
+ * Inject ISR content (SSR body + meta tags) into an HTML template.
+ * If template is null, generates a minimal standalone HTML.
+ */
+export function renderISRPage(opts: ISRRenderOptions): string {
+  const { template, body = '', meta } = opts
+  const safeTitle = escapeHtml(meta.title)
+  const safeDesc = escapeHtml(meta.description)
+
+  if (template) {
+    let html = template
+    html = html.replace(/<title>[^<]*<\/title>/, `<title>${safeTitle}</title>`)
+    html = html.replace(/<meta\s+name="description"[^>]*>/, '')
+    html = html.replace(/<meta\s+property="og:title"[^>]*>/, '')
+    html = html.replace(/<meta\s+property="og:description"[^>]*>/, '')
+    html = html.replace(
+      '</head>',
+      `    <meta name="description" content="${safeDesc}" />\n    <meta property="og:title" content="${safeTitle}" />\n    <meta property="og:description" content="${safeDesc}" />\n    <meta name="generator" content="ISR-SSG" />\n  </head>`
+    )
+    html = html.replace('<div id="root"></div>', `<div id="root">${body}</div>`)
+    return html
+  }
+
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${safeTitle}</title>
+    <meta name="description" content="${safeDesc}" />
+    <meta property="og:title" content="${safeTitle}" />
+    <meta property="og:description" content="${safeDesc}" />
+    <meta name="generator" content="ISR-SSG" />
+  </head>
+  <body>
+    <div id="root">${body}</div>
+  </body>
+</html>`
+}

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

@@ -1,4 +1,4 @@
-import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'
+import { sqliteTable, integer, text, index } from 'drizzle-orm/sqlite-core'
 import { sql } from 'drizzle-orm'
 
 export const contentStatuses = ['draft', 'published', 'archived'] as const
@@ -7,25 +7,33 @@ export type ContentStatus = (typeof contentStatuses)[number]
 export const contentCategories = ['article', 'announcement', 'tutorial', 'news', 'policy'] as const
 export type ContentCategory = (typeof contentCategories)[number]
 
-export const contents = sqliteTable('contents', {
-  id: integer('id').primaryKey({ autoIncrement: true }),
-  title: text('title').notNull(),
-  body: text('body').notNull(),
-  excerpt: text('excerpt'),
-  category: text('category', { enum: contentCategories }).notNull(),
-  tags: text('tags'),
-  status: text('status', { enum: contentStatuses }).notNull().default('draft'),
-  author: text('author').notNull(),
-  viewCount: integer('view_count').notNull().default(0),
-  likeCount: integer('like_count').notNull().default(0),
-  publishedAt: integer('published_at', { mode: 'timestamp' }),
-  createdAt: integer('created_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-  updatedAt: integer('updated_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-})
+export const contents = sqliteTable(
+  'contents',
+  {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    title: text('title').notNull(),
+    body: text('body').notNull(),
+    excerpt: text('excerpt'),
+    category: text('category', { enum: contentCategories }).notNull(),
+    tags: text('tags'),
+    status: text('status', { enum: contentStatuses }).notNull().default('draft'),
+    author: text('author').notNull(),
+    viewCount: integer('view_count').notNull().default(0),
+    likeCount: integer('like_count').notNull().default(0),
+    publishedAt: integer('published_at', { mode: 'timestamp' }),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+    updatedAt: integer('updated_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    statusIdx: index('contents_status_idx').on(table.status),
+    categoryIdx: index('contents_category_idx').on(table.category),
+    createdAtIdx: index('contents_created_at_idx').on(table.createdAt),
+  })
+)
 
 export type ContentTable = typeof contents.$inferSelect
 export type NewContent = typeof contents.$inferInsert

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

@@ -1,4 +1,4 @@
-import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'
+import { sqliteTable, integer, text, index } from 'drizzle-orm/sqlite-core'
 import { sql } from 'drizzle-orm'
 
 export const disputeTypes = [
@@ -13,27 +13,35 @@ export type DisputeType = (typeof disputeTypes)[number]
 export const disputeStatuses = ['pending', 'investigating', 'resolved', 'rejected'] as const
 export type DisputeStatus = (typeof disputeStatuses)[number]
 
-export const disputes = sqliteTable('disputes', {
-  id: integer('id').primaryKey({ autoIncrement: true }),
-  disputeNo: text('dispute_no').notNull(),
-  orderId: text('order_id').notNull(),
-  orderNo: text('order_no').notNull(),
-  customerName: text('customer_name').notNull(),
-  customerEmail: text('customer_email').notNull(),
-  type: text('type', { enum: disputeTypes }).notNull(),
-  status: text('status', { enum: disputeStatuses }).notNull().default('pending'),
-  description: text('description').notNull(),
-  resolution: text('resolution'),
-  amount: integer('amount').notNull(),
-  resolvedAt: integer('resolved_at', { mode: 'timestamp' }),
-  resolvedBy: text('resolved_by'),
-  createdAt: integer('created_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-  updatedAt: integer('updated_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-})
+export const disputes = sqliteTable(
+  'disputes',
+  {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    disputeNo: text('dispute_no').notNull(),
+    orderId: text('order_id').notNull(),
+    orderNo: text('order_no').notNull(),
+    customerName: text('customer_name').notNull(),
+    customerEmail: text('customer_email').notNull(),
+    type: text('type', { enum: disputeTypes }).notNull(),
+    status: text('status', { enum: disputeStatuses }).notNull().default('pending'),
+    description: text('description').notNull(),
+    resolution: text('resolution'),
+    amount: integer('amount').notNull(),
+    resolvedAt: integer('resolved_at', { mode: 'timestamp' }),
+    resolvedBy: text('resolved_by'),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+    updatedAt: integer('updated_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    statusIdx: index('disputes_status_idx').on(table.status),
+    orderIdIdx: index('disputes_order_id_idx').on(table.orderId),
+    createdAtIdx: index('disputes_created_at_idx').on(table.createdAt),
+  })
+)
 
 export type DisputeTable = typeof disputes.$inferSelect
 export type NewDispute = typeof disputes.$inferInsert

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

@@ -1,16 +1,22 @@
-import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core';
-import { sql } from 'drizzle-orm';
+import { sqliteTable, integer, text, index } from 'drizzle-orm/sqlite-core'
+import { sql } from 'drizzle-orm'
 
-export const notifications = sqliteTable('notifications', {
-  id: text('id').primaryKey(),
-  type: text('type').notNull(),
-  title: text('title').notNull(),
-  message: text('message').notNull(),
-  read: integer('read', { mode: 'boolean' }).notNull().default(false),
-  createdAt: integer('created_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-});
+export const notifications = sqliteTable(
+  'notifications',
+  {
+    id: text('id').primaryKey(),
+    type: text('type').notNull(),
+    title: text('title').notNull(),
+    message: text('message').notNull(),
+    read: integer('read', { mode: 'boolean' }).notNull().default(false),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    createdAtIdx: index('notifications_created_at_idx').on(table.createdAt),
+  })
+)
 
-export type NotificationTable = typeof notifications.$inferSelect;
-export type NewNotification = typeof notifications.$inferInsert;
+export type NotificationTable = typeof notifications.$inferSelect
+export type NewNotification = typeof notifications.$inferInsert

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

@@ -1,4 +1,4 @@
-import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'
+import { sqliteTable, integer, text, index } from 'drizzle-orm/sqlite-core'
 import { sql } from 'drizzle-orm'
 
 export const orderStatuses = [
@@ -10,21 +10,28 @@ export const orderStatuses = [
 ] as const
 export type OrderStatus = (typeof orderStatuses)[number]
 
-export const orders = sqliteTable('orders', {
-  id: integer('id').primaryKey({ autoIncrement: true }),
-  orderNo: text('order_no').notNull(),
-  customerName: text('customer_name').notNull(),
-  customerEmail: text('customer_email').notNull(),
-  productName: text('product_name').notNull(),
-  amount: integer('amount').notNull(),
-  status: text('status', { enum: orderStatuses }).notNull().default('pending'),
-  createdAt: integer('created_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-  updatedAt: integer('updated_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-})
+export const orders = sqliteTable(
+  'orders',
+  {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    orderNo: text('order_no').notNull(),
+    customerName: text('customer_name').notNull(),
+    customerEmail: text('customer_email').notNull(),
+    productName: text('product_name').notNull(),
+    amount: integer('amount').notNull(),
+    status: text('status', { enum: orderStatuses }).notNull().default('pending'),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+    updatedAt: integer('updated_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    statusIdx: index('orders_status_idx').on(table.status),
+    createdAtIdx: index('orders_created_at_idx').on(table.createdAt),
+  })
+)
 
 export type OrderTable = typeof orders.$inferSelect
 export type NewOrder = typeof orders.$inferInsert

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

@@ -1,38 +1,47 @@
-import { sqliteTable, text, integer, uniqueIndex } from 'drizzle-orm/sqlite-core'
+import { sqliteTable, text, integer, uniqueIndex, index } 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 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)`),
+  },
+  table => ({
+    statusIdx: index('plugins_status_idx').on(table.status),
+    slugIdx: index('plugins_slug_idx').on(table.slug),
+    authorIdIdx: index('plugins_author_id_idx').on(table.authorId),
+    createdAtIdx: index('plugins_created_at_idx').on(table.createdAt),
+  })
+)
 
 export const pluginVersions = sqliteTable(
   'plugin_versions',
@@ -53,6 +62,7 @@ export const pluginVersions = sqliteTable(
   },
   table => ({
     pluginVersionUnique: uniqueIndex('plugin_version_unique').on(table.pluginId, table.version),
+    pluginIdIdx: index('plugin_versions_plugin_id_idx').on(table.pluginId),
   })
 )
 
@@ -77,14 +87,20 @@ export const pluginReviews = sqliteTable(
   })
 )
 
-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 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),
+  },
+  table => ({
+    slugIdx: index('plugin_categories_slug_idx').on(table.slug),
+  })
+)
 
 export const pluginCategoryMappings = sqliteTable(
   'plugin_category_mappings',
@@ -101,6 +117,8 @@ export const pluginCategoryMappings = sqliteTable(
       table.pluginId,
       table.categoryId
     ),
+    categoryIdIdx: index('plugin_category_mappings_category_id_idx').on(table.categoryId),
+    pluginIdIdx: index('plugin_category_mappings_plugin_id_idx').on(table.pluginId),
   })
 )
 

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

@@ -1,25 +1,32 @@
-import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'
+import { sqliteTable, integer, text, index } from 'drizzle-orm/sqlite-core'
 import { sql } from 'drizzle-orm'
 
 export const productStatuses = ['active', 'inactive', 'out_of_stock'] as const
 export type ProductStatus = (typeof productStatuses)[number]
 
-export const products = sqliteTable('products', {
-  id: text('id').primaryKey(),
-  name: text('name').notNull(),
-  description: text('description'),
-  price: integer('price').notNull(), // 单位：分
-  status: text('status', { enum: productStatuses }).notNull().default('active'),
-  stock: integer('stock').notNull().default(0),
-  imageUrl: text('image_url'),
-  merchantId: integer('merchant_id').notNull(), // Changed to integer to match merchants.id
-  createdAt: integer('created_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-  updatedAt: integer('updated_at', { mode: 'timestamp' })
-    .notNull()
-    .default(sql`(unixepoch() * 1000)`),
-})
+export const products = sqliteTable(
+  'products',
+  {
+    id: text('id').primaryKey(),
+    name: text('name').notNull(),
+    description: text('description'),
+    price: integer('price').notNull(), // 单位：分
+    status: text('status', { enum: productStatuses }).notNull().default('active'),
+    stock: integer('stock').notNull().default(0),
+    imageUrl: text('image_url'),
+    merchantId: integer('merchant_id').notNull(), // Changed to integer to match merchants.id
+    createdAt: integer('created_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+    updatedAt: integer('updated_at', { mode: 'timestamp' })
+      .notNull()
+      .default(sql`(unixepoch() * 1000)`),
+  },
+  table => ({
+    statusIdx: index('products_status_idx').on(table.status),
+    merchantIdIdx: index('products_merchant_id_idx').on(table.merchantId),
+  })
+)
 
 export type Product = typeof products.$inferSelect
 export type NewProduct = typeof products.$inferInsert