imbytecat/fullstack-starter
1
1
Fork 3
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
368 Commits 2 Branches 0 Tags
76854fe23b9a8c1e8b08ccc8ad0b6dd628382adb
Commit Graph

10 Commits

Author SHA1 Message Date
imbytecat 3040608959 refactor(db): 移除嵌入式迁移链路 2026-05-11 20:51:43 +08:00
imbytecat 9073e38238 chore: gitignore瘦身154->21行 + migrate onnotice改logger.debug 
gitignore: 删社区模板倒灌的死分支 (bower/jspm/snowpack/parcel/fusebox
/dynamodb/firebase/yarn-v3/sveltekit/vuepress/docusaurus/gatsby/next
/nuxt/grunt/eslintcache 等)，只留实际命中的 ~20 行。KISS。

migrate: onnotice 从空函数改成 logger.debug，消除最后一处 silent
black hole。pg NOTICE 现在会出现在 LOG_LEVEL=debug 下。
 2026-04-25 17:29:18 +08:00
imbytecat fafe02bdbd refactor: 主动审计修复多处可观测性、依赖、代码质量缺口 
通过并行 explore + librarian + 自查发现并修复：

代码缺陷
- shutdown.ts: db.$client.end().finally(...) 静默吞错——关闭失败会
  谎报 "DB pool closed" 后照常 exit 0。改用 await + try/catch
  分别记录成功/失败，setTimeout 也换成 Bun.sleep。
- interceptors.ts: 两条 instanceof ORPCError && instanceof
  ValidationError 重复检查，改用 early return + 单 if 分支区分 code。
- types.ts: 移除从未被引用的 RouterInputs 死代码（仅 RouterOutputs
  被 TodoItem 用到）。

Bun 原生 API（删/换 Node 兼容层）
- fields.ts: uuid v7 → Bun.randomUUIDv7()，删除 uuid 依赖
- migrate.ts: node:crypto.createHash → Bun.CryptoHasher.hash，
  少一个 Promise.all 项 + 一个 import
- shutdown.ts: setTimeout → Bun.sleep（顺带）

Biome 2.4 规则补强
- domains.types: "all"——开启类型感知规则集（noFloatingPromises /
  noMisusedPromises / useAwaitThenable / noUnnecessaryConditions
  等 Promise/异步陷阱）
- domains.drizzle: "recommended"、domains.react: "recommended"
- 显式开启 suspicious.noImportCycles（2.4 已 promote）

文档
- AGENTS.md 在 Stack & runtime 段加 "Prefer Bun-native APIs"
  原则，列出 UUIDv7/SHA-256/sleep/Bun.file 的优先路径
- AGENTS.md 在 Code style (Biome) 段记录本次启用的 lint domain
  与 noImportCycles 规则

验证：fix / typecheck / test 3/3 / build 568ms / compile 117M /
docker compose 全套（migrate JSON 日志 ✓、UUIDv7 写入 ✓、SIGTERM
shutdown 正确序列化 ✓）
 2026-04-25 17:06:22 +08:00
imbytecat cc3a5dc5ad feat(logging): 引入 LogTape 替换 console.* 为结构化日志 
为什么选 LogTape（2026 实测）：
- pino 在 bun build --compile 编译产物里因 worker_threads + 动态 require 在
  /\$bunfs/ 虚拟文件系统中崩溃，与单二进制部署核心目标冲突；
- LogTape 零依赖（5.3KB）、零 worker、纯 ESM、原生 Bun 导出条件，runtime
  agnostic，配合 configureSync 完美兼容 --bytecode 模式（无裸 top-level await）；
- 一等公民集成：@logtape/drizzle-orm（SQL 查询日志）、@logtape/otel（后续
  OpenTelemetry sink 留扩展点）。

变更：
- src/server/logger.ts: configureSync 引导 + getLogger 重导出。format 默认
  process.stdout.isTTY ? pretty : json，可经 LOG_FORMAT 显式覆盖（绕开 Bun
  bundler 把 process.env.NODE_ENV 在 --minify 时 inline 成字面量的特殊处理）。
- src/server/api/interceptors.ts: logError 改用 getLogger(['api']).error(...) +
  结构化 properties，弃 logger.error 顶层 API。
- src/cli/migrate.ts: 所有 console.log 改走 getLogger(['cli','migrate'])，logger
  在 run() 内 lazy-import 以保持 citty subcommand 模块体 side-effect-free。
- src/server/db/index.ts: env.LOG_DB=true 时挂 DrizzleLogger 适配器，SQL 查询
  按类别 ['db'] 在 debug 级输出（含 query/params/formattedQuery 三字段）。

新增 env 旋钮（t3-oss 校验）：
- LOG_LEVEL: trace|debug|info|warning|error|fatal，默认 info
- LOG_FORMAT: pretty|json，默认 TTY 自动选
- LOG_DB: stringbool，默认 false

端到端验证（compose + Postgres 18-alpine）：
- TTY 终端：pretty 输出含 ✨ 图标 + ANSI 彩色 + 类别·路径 ✓
- 管道/Docker：JSON Lines 一行一条，含 @timestamp/level/logger/properties ✓
- LOG_FORMAT=pretty 强制覆盖 ✓
- ./server migrate 应用 migration 并经 logger 输出 ✓
- ./server serve + RPC round-trip：interceptor logError 与 drizzle SQL 日志
  在生产 JSON 模式下结构化输出 ✓
- fix / typecheck / test 3/3 / build / compile 117M 二进制全绿
 2026-04-25 16:04:31 +08:00
imbytecat dd1facd240 refactor(imports): #nitro 重命名为 #server，imports 字段 ASCII 排序 
命名上避开实现耦合：被指向的 .output/server/index.mjs 本质是"编译后的 HTTP 服务器入口"，与 nitro（构建器）无关；包装器 _serve-nitro.mjs 仍持"nitro"。未来即便切换至 hono / vite-ssr / h3，#server 名字仍准确。

字段排序改为 ASCII 升序：#drizzle/*.sql < #package < #server，便于 sort-package-json 与人眼对账。

端到端验证（compose + Postgres 18）：
- ./server migrate ✓ (embedded SQL)
- /health = ok ✓
- /api/spec.json title=fullstack-starter version=1.0.0 ✓ (#package)
- RPC todo create+list 完整 round-trip ✓ (#server 解析 nitro 产物)
- biome/typecheck/test/build/compile 全绿
 2026-04-25 15:28:04 +08:00
imbytecat 5174cff3c5 refactor(cli): _serve-nitro 改用 #nitro subpath import 
src/cli/_serve-nitro.mjs 原本用 ../../.output/server/index.mjs 跨边界导入 nitro 构建产物，与 #package / #drizzle/* 同属 "src/ 跳出根目录" 场景。统一改为 #nitro。

新增 package.json#imports:
  "#nitro": "./.output/server/index.mjs"

端到端验证（compose + Postgres 18）：
- 编译二进制内嵌 nitro serve() 入口 ✓
- ./server migrate：embedded SQL 应用成功 ✓
- ./server 运行：/health、/api/spec.json (title/version)、RPC create+list 全 OK ✓
- Stack trace 印证 #nitro 由 Bun 正确解析到 .output/server/index.mjs ✓
- biome/typecheck/test/build/compile 全绿
 2026-04-25 15:23:05 +08:00
imbytecat ed257fe4e6 refactor: 应用 Oracle round-4 复核，硬化 migrator 与默认安全值 
- migrate: 校验已应用 migration 的 SHA-256，拒绝 schema drift；
  split 后 trim + skip empty，避免空 statement 触发 SQL 错误
- todo.contract: update 拒绝空 patch
- env: DATABASE_URL 限定 postgres(ql):// scheme，配置错误更早失败
- compile: autoloadDotenv: false，二进制部署不再吞 cwd 的 .env
- Error.tsx: 生产环境隐藏 error.message，避免内部错误泄露
- AGENTS: 同步 generatedFieldKeys / migrator 行为新描述
 2026-04-25 14:38:44 +08:00
imbytecat 7e27640a26 feat(deploy): migrations 嵌入二进制，实现真单文件部署 
- embed-migrations.ts：扫 ./drizzle/meta/_journal.json，生成 src/server/db/migrations.gen.ts，每条 SQL 通过 `import sql_<idx> from '../../../drizzle/<tag>.sql' with { type: 'text' }` 在 bun build --compile 时被静态嵌入二进制
- migrate.ts 重写：runtime 用 createHash('sha256') 计算迁移哈希，仅用 db.execute(sql) + db.transaction() 公开 API 写入 drizzle.__drizzle_migrations 簿记表（不依赖 @internal 的 db.dialect/db.session）
- db:generate 链 db:embed，保证 SQL 改动总是同步到 migrations.gen.ts
- Dockerfile 删 COPY drizzle/，binary 是部署唯一 artifact
- 同步 README / AGENTS / biome.json
 2026-04-25 14:05:58 +08:00
imbytecat 2c5bceb826 fix(deploy): 端到端跑通编译二进制 + docker compose 
端到端验证时发现 4 处细节，一起补上：

1. bin.ts 漏了 default: 'serve'——CMD ["./server"] 会直接吐 help 而
   不是起服务（在 compose 里 app 立刻 exit）。citty 原生支持 default
2. Dockerfile 在 bun install 之前就要 COPY patches/，否则 package.json
   的 patchedDependencies 找不到补丁文件，install 失败
3. drizzle/ 目录在仓库里必须存在（带 .gitkeep），否则 Dockerfile 末尾
   COPY drizzle/ 到运行镜像会失败
4. migrate.ts 之前只检查 ./drizzle 目录是否存在就跳过——空目录时仍会
   进到 drizzle 的 readMigrationFiles，报 Can't find meta/_journal.json。
   改成检查 meta/_journal.json 是否存在，更准确地区分"还没生成过迁移"
   与"有迁移待应用"

验证路径：
- docker compose up -d --build → migrate 完成退出 → app 健康
- curl /api/spec.json → 200，OpenAPI 文档含 todo.{list,create,update,remove}
 2026-04-24 20:43:36 +08:00
imbytecat 19e60d358f feat(cli): 引入 citty CLI，迁移改为显式 ./server migrate 
- 顶层新增 bin.ts 作为编译入口，citty 懒加载 src/cli/ 下子命令
- src/cli/serve.ts 通过 _serve-nitro.mjs 桥接启动 Nitro（规避
  .output/server/index.mjs 顶层 serve(...) 的副作用导入）
- src/cli/migrate.ts 显式跑 drizzle migrate；env / drizzle 都在 run()
  里 await import，避免 citty --help 遍历 subCommands 时触发 env 校验
- compile.ts 入口切到 bin.ts；移除 src/server/plugins/migrate.ts
  与 vite.config.ts 中的启动时自动迁移
- compose.yaml 新增一次性 migrate 服务，app depends_on
  service_completed_successfully，保证迁移先行再起服
- tsconfig 排除 .output / out；AGENTS.md 补充 CLI 与部署规约
 2026-04-24 20:32:32 +08:00