@gravito/scaffold 3.0.0 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/scaffold",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Project scaffolding engine for Gravito - Generate enterprise-grade architecture templates",
   "type": "module",
   "main": "dist/index.js",
@@ -16,10 +16,12 @@
   "scripts": {
     "build": "bun run build.ts",
     "dev": "bun run --watch src/index.ts",
-    "test": "bun test",
+    "test": "bun test --timeout=10000",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
-    "test:coverage": "bun test --coverage --coverage-threshold=80",
-    "test:ci": "bun test --coverage --coverage-threshold=80"
+    "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
+    "test:ci": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
+    "test:unit": "bun test tests/ --timeout=10000",
+    "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
   "files": [
     "dist",
@@ -48,4 +50,4 @@
     "url": "git+https://github.com/gravito-framework/gravito.git",
     "directory": "packages/scaffold"
   }
-}
+}

package/templates/common/Dockerfile.hbs

@@ -0,0 +1,25 @@
+FROM oven/bun:1.0 AS base
+WORKDIR /usr/src/app
+
+# Install dependencies
+FROM base AS install
+RUN mkdir -p /temp/dev
+COPY package.json bun.lockb /temp/dev/
+RUN cd /temp/dev && bun install --frozen-lockfile
+
+# Build application
+FROM base AS build
+COPY --from=install /temp/dev/node_modules node_modules
+COPY . .
+ENV NODE_ENV=production
+RUN bun run build
+
+# Final production image
+FROM base AS release
+COPY --from=build /usr/src/app/{{entrypoint}} index.js
+COPY --from=build /usr/src/app/package.json .
+
+# Create a non-root user for security
+USER bun
+EXPOSE 3000/tcp
+ENTRYPOINT [ "bun", "run", "index.js" ]

package/templates/common/env.example.hbs

@@ -0,0 +1,13 @@
+# Application Configuration
+APP_NAME={{name}}
+APP_ENV=development
+APP_DEBUG=true
+APP_URL=http://localhost:3000
+APP_KEY=
+
+# Database Configuration
+DB_CONNECTION={{dbConnection}}
+DB_DATABASE=database/database.sqlite
+
+# Logging
+LOG_LEVEL=debug

package/templates/common/gitignore.hbs

@@ -0,0 +1,10 @@
+node_modules
+dist
+.git
+.env
+.env.*
+.idea
+.vscode
+*.log
+*.sqlite
+coverage

package/templates/common/tsconfig.json.hbs

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "types": ["bun-types"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/features/otel/package.json

@@ -1,7 +1,7 @@
 {
-    "dependencies": {
-        "@opentelemetry/sdk-node": "^0.45.0",
-        "@opentelemetry/exporter-trace-otlp-http": "^0.45.0",
-        "@gravito/telemetry": "workspace:*"
-    }
-}
+  "dependencies": {
+    "@opentelemetry/sdk-node": "^0.45.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.45.0",
+    "@gravito/telemetry": "workspace:*"
+  }
+}

package/templates/features/redis/package.json

@@ -1,5 +1,5 @@
 {
-    "dependencies": {
-        "ioredis": "^5.3.0"
-    }
-}
+  "dependencies": {
+    "ioredis": "^5.3.0"
+  }
+}

package/templates/overlays/core/package.json

@@ -1,5 +1,5 @@
 {
-    "dependencies": {
-        "better-sqlite3": "^9.0.0"
-    }
-}
+  "dependencies": {
+    "better-sqlite3": "^9.0.0"
+  }
+}

package/templates/overlays/enterprise/package.json

@@ -1,7 +1,7 @@
 {
-    "dependencies": {
-        "ioredis": "^5.0.0",
-        "pg": "^8.0.0",
-        "@gravito/spectrum": "workspace:*"
-    }
-}
+  "dependencies": {
+    "ioredis": "^5.0.0",
+    "pg": "^8.0.0",
+    "@gravito/spectrum": "workspace:*"
+  }
+}

package/templates/overlays/scale/package.json

@@ -1,6 +1,6 @@
 {
-    "dependencies": {
-        "ioredis": "^5.0.0",
-        "pg": "^8.0.0"
-    }
-}
+  "dependencies": {
+    "ioredis": "^5.0.0",
+    "pg": "^8.0.0"
+  }
+}

package/templates/scripts/check-dependencies.ts.hbs

@@ -0,0 +1,142 @@
+/**
+ * 相依套件版本檢查腳本
+ * 
+ * 檢查 package.json 中的套件是否為最新穩定版本
+ * 並提供更新建議
+ */
+
+import { readFileSync } from 'fs'
+import { join } from 'path'
+
+interface PackageJson {
+  dependencies?: Record<string, string>
+  devDependencies?: Record<string, string>
+}
+
+interface PackageInfo {
+  name: string
+  current: string
+  latest: string
+  outdated: boolean
+}
+
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  blue: '\x1b[36m',
+}
+
+function log(message: string, color: keyof typeof colors = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`)
+}
+
+async function getLatestVersion(packageName: string): Promise<string | null> {
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`)
+    if (!response.ok) return null
+    const data = await response.json()
+    return data.version
+  } catch {
+    return null
+  }
+}
+
+function parseVersion(version: string): string {
+  // 移除 ^, ~, >= 等前綴
+  return version.replace(/^[\^~>=<]/, '')
+}
+
+async function checkPackage(
+  name: string,
+  currentVersion: string
+): Promise<PackageInfo | null> {
+  // 跳過本地連結的套件
+  if (currentVersion.startsWith('link:') || currentVersion.startsWith('workspace:')) {
+    return null
+  }
+
+  const current = parseVersion(currentVersion)
+  const latest = await getLatestVersion(name)
+
+  if (!latest) {
+    return null
+  }
+
+  return {
+    name,
+    current,
+    latest,
+    outdated: current !== latest,
+  }
+}
+
+async function main() {
+  log('\n=== 相依套件版本檢查 ===\n', 'blue')
+
+  const packageJsonPath = join(process.cwd(), 'package.json')
+  const packageJson: PackageJson = JSON.parse(
+    readFileSync(packageJsonPath, 'utf-8')
+  )
+
+  const allDependencies = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies,
+  }
+
+  log(`檢查 ${Object.keys(allDependencies).length} 個套件...\n`, 'yellow')
+
+  const results: PackageInfo[] = []
+  const outdated: PackageInfo[] = []
+  const upToDate: PackageInfo[] = []
+
+  // 檢查所有套件
+  for (const [name, version] of Object.entries(allDependencies)) {
+    const info = await checkPackage(name, version)
+    if (info) {
+      results.push(info)
+      if (info.outdated) {
+        outdated.push(info)
+      } else {
+        upToDate.push(info)
+      }
+    }
+  }
+
+  // 顯示結果
+  if (upToDate.length > 0) {
+    log(`\n✓ 已是最新版本 (${upToDate.length}):`, 'green')
+    upToDate.forEach((pkg) => {
+      log(`  ${pkg.name}: ${pkg.current}`, 'green')
+    })
+  }
+
+  if (outdated.length > 0) {
+    log(`\n⚠ 需要更新 (${outdated.length}):`, 'yellow')
+    outdated.forEach((pkg) => {
+      log(`  ${pkg.name}: ${pkg.current} → ${pkg.latest}`, 'yellow')
+    })
+  }
+
+  // 總結
+  log('\n=== 檢查結果 ===', 'blue')
+  log(`總計: ${results.length} 個套件`, 'blue')
+  log(`最新: ${upToDate.length} 個`, 'green')
+  log(`需更新: ${outdated.length} 個`, outdated.length > 0 ? 'yellow' : 'green')
+
+  // 如果有需要更新的套件，返回非零退出碼
+  if (outdated.length > 0) {
+    log('\n建議執行以下命令更新套件：', 'yellow')
+    log('  bun update', 'yellow')
+    process.exit(1)
+  } else {
+    log('\n✓ 所有套件都是最新版本！', 'green')
+    process.exit(0)
+  }
+}
+
+main().catch((error) => {
+  log(`\n錯誤: ${error.message}`, 'red')
+  process.exit(1)
+})

package/templates/scripts/check.sh.hbs

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+# 專案檢查腳本
+# 執行所有必要的檢查：類型檢查、測試、依賴檢查等
+
+set -e
+
+# 顏色定義
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}=== 專案檢查 ===${NC}\n"
+
+# 檢查是否在正確的目錄
+if [ ! -f "package.json" ]; then
+  echo -e "${RED}錯誤: 請在專案根目錄執行此腳本${NC}"
+  exit 1
+fi
+
+# 檢查 Bun 是否安裝
+if ! command -v bun &> /dev/null; then
+  echo -e "${RED}錯誤: 未找到 bun，請先安裝 Bun${NC}"
+  exit 1
+fi
+
+# 1. 類型檢查
+echo -e "${YELLOW}[1/3] 執行類型檢查...${NC}"
+if bun run typecheck; then
+  echo -e "${GREEN}✓ 類型檢查通過${NC}\n"
+else
+  echo -e "${RED}✗ 類型檢查失敗${NC}"
+  exit 1
+fi
+
+# 2. 執行測試
+echo -e "${YELLOW}[2/3] 執行測試...${NC}"
+if bun test; then
+  echo -e "${GREEN}✓ 測試通過${NC}\n"
+else
+  echo -e "${RED}✗ 測試失敗${NC}"
+  exit 1
+fi
+
+# 3. 檢查依賴版本（可選，因為需要網路連線）
+echo -e "${YELLOW}[3/3] 檢查依賴版本...${NC}"
+if bun run check:deps; then
+  echo -e "${GREEN}✓ 依賴檢查完成${NC}\n"
+else
+  echo -e "${YELLOW}⚠ 依賴檢查有警告（某些套件可能需要更新）${NC}\n"
+fi
+
+echo -e "${GREEN}=== 所有檢查完成 ===${NC}"

package/templates/scripts/pre-commit.sh.hbs

@@ -0,0 +1,58 @@
+#!/bin/bash
+
+# Pre-commit Hook
+# 在 git commit 前自動執行檢查
+# 
+# 安裝方式：
+#   ln -s ../../scripts/pre-commit.sh .git/hooks/pre-commit
+#   或
+#   cp scripts/pre-commit.sh .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+
+set -e
+
+# 顏色定義
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}=== Pre-commit 檢查 ===${NC}\n"
+
+# 切換到專案根目錄
+cd "$(git rev-parse --show-toplevel)"
+
+# 檢查是否在正確的目錄
+if [ ! -f "package.json" ]; then
+  echo -e "${RED}錯誤: 找不到 package.json${NC}"
+  exit 1
+fi
+
+# 檢查 Bun 是否安裝
+if ! command -v bun &> /dev/null; then
+  echo -e "${RED}錯誤: 未找到 bun，請先安裝 Bun${NC}"
+  exit 1
+fi
+
+# 1. 類型檢查（快速檢查）
+echo -e "${YELLOW}[1/2] 執行類型檢查...${NC}"
+if bun run typecheck; then
+  echo -e "${GREEN}✓ 類型檢查通過${NC}\n"
+else
+  echo -e "${RED}✗ 類型檢查失敗${NC}"
+  echo -e "${YELLOW}提示: 請修正類型錯誤後再提交${NC}"
+  exit 1
+fi
+
+# 2. 執行測試（可選，如果測試時間較長可以註解掉）
+echo -e "${YELLOW}[2/2] 執行測試...${NC}"
+if bun test; then
+  echo -e "${GREEN}✓ 測試通過${NC}\n"
+else
+  echo -e "${RED}✗ 測試失敗${NC}"
+  echo -e "${YELLOW}提示: 請修正測試錯誤後再提交${NC}"
+  exit 1
+fi
+
+echo -e "${GREEN}=== Pre-commit 檢查通過 ===${NC}\n"