Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| b967deb4b1 |
3
.gitignore
vendored
@@ -1,5 +1,8 @@
|
||||
### Custom ###
|
||||
|
||||
# SQLite database
|
||||
data/
|
||||
|
||||
# TanStack
|
||||
.tanstack/
|
||||
|
||||
|
||||
3
.vscode/settings.json
vendored
@@ -37,8 +37,7 @@
|
||||
"files.associations": {
|
||||
".env": "dotenv",
|
||||
".env.*": "dotenv",
|
||||
"**/tsconfig.json": "jsonc",
|
||||
"**/tsconfig.*.json": "jsonc",
|
||||
"**/tsconfig*.json": "jsonc",
|
||||
"**/biome.json": "jsonc",
|
||||
"**/opencode.json": "jsonc"
|
||||
},
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
- **运行时**: Bun
|
||||
- **语言**: TypeScript (strict mode, ESNext)
|
||||
- **样式**: Tailwind CSS v4
|
||||
- **数据库**: PostgreSQL + Drizzle ORM
|
||||
- **数据库**: SQLite (Bun 内置) + Drizzle ORM
|
||||
- **状态管理**: TanStack Query
|
||||
- **路由**: TanStack Router (文件路由)
|
||||
- **RPC**: ORPC (类型安全 RPC,契约优先)
|
||||
@@ -44,9 +44,10 @@ biome format --write . # 仅格式化代码
|
||||
|
||||
### 数据库
|
||||
```bash
|
||||
bun db:init # 初始化 SQLite 数据库 (创建表)
|
||||
bun db:generate # 从 schema 生成迁移文件
|
||||
bun db:migrate # 执行数据库迁移
|
||||
bun db:push # 直接推送 schema 变更 (仅开发环境)
|
||||
bun db:studio # 打开 Drizzle Studio 数据库管理界面
|
||||
```
|
||||
|
||||
### 测试
|
||||
@@ -145,20 +146,25 @@ export const Route = createFileRoute('/')({
|
||||
|
||||
- 在 `src/db/schema/*.ts` 定义 schema
|
||||
- 从 `src/db/schema/index.ts` 导出
|
||||
- 使用 `drizzle-orm/pg-core` 的 PostgreSQL 类型
|
||||
- 主键使用 `uuidv7()` (需要 PostgreSQL 扩展)
|
||||
- 使用 `drizzle-orm/sqlite-core` 的 SQLite 类型
|
||||
- 主键使用 `crypto.randomUUID()` 生成 UUID
|
||||
- 始终包含 `createdAt` 和 `updatedAt` 时间戳
|
||||
|
||||
示例:
|
||||
```typescript
|
||||
import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core'
|
||||
import { sql } from 'drizzle-orm'
|
||||
import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
|
||||
|
||||
export const myTable = pgTable('my_table', {
|
||||
id: uuid().primaryKey().default(sql`uuidv7()`),
|
||||
name: text().notNull(),
|
||||
createdAt: timestamp({ withTimezone: true }).notNull().defaultNow(),
|
||||
updatedAt: timestamp({ withTimezone: true }).notNull().defaultNow().$onUpdateFn(() => new Date()),
|
||||
export const myTable = sqliteTable('my_table', {
|
||||
id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
|
||||
name: text('name').notNull(),
|
||||
createdAt: integer('created_at', { mode: 'timestamp' })
|
||||
.notNull()
|
||||
.default(sql`(unixepoch())`),
|
||||
updatedAt: integer('updated_at', { mode: 'timestamp' })
|
||||
.notNull()
|
||||
.default(sql`(unixepoch())`)
|
||||
.$onUpdateFn(() => new Date()),
|
||||
})
|
||||
```
|
||||
|
||||
@@ -273,5 +279,5 @@ const mutation = useMutation(orpc.myFeature.create.mutationOptions())
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2026-01-18
|
||||
**最后更新**: 2026-01-20
|
||||
**项目版本**: 基于 package.json 依赖版本
|
||||
242
README.md
Normal file
@@ -0,0 +1,242 @@
|
||||
# Fullstack Starter (SQLite)
|
||||
|
||||
一个基于 **TanStack Start + Bun + Tauri + SQLite** 的全栈桌面应用脚手架。
|
||||
|
||||
包含一个完整的 **Todo List** 示例,展示了从前端到后端的完整数据流。
|
||||
|
||||
## 技术栈
|
||||
|
||||
| 层级 | 技术 |
|
||||
|------|------|
|
||||
| 前端框架 | React 19 + TanStack Router (文件路由) |
|
||||
| 状态管理 | TanStack Query |
|
||||
| 样式 | Tailwind CSS v4 |
|
||||
| RPC 通信 | ORPC (类型安全,契约优先) |
|
||||
| 数据库 | SQLite (Bun 内置) + Drizzle ORM |
|
||||
| 桌面壳 | Tauri v2 |
|
||||
| 运行时 | Bun |
|
||||
| 构建 | Vite + Turbo |
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 前置要求
|
||||
|
||||
- [Bun](https://bun.sh/) >= 1.0
|
||||
- [Rust](https://www.rust-lang.org/) (仅 Tauri 桌面应用需要)
|
||||
|
||||
### 安装与运行
|
||||
|
||||
```bash
|
||||
# 1. 克隆项目
|
||||
git clone <your-repo-url>
|
||||
cd fullstack-starter-SQLite
|
||||
|
||||
# 2. 安装依赖
|
||||
bun install
|
||||
|
||||
# 3. 初始化数据库
|
||||
bun run db:init
|
||||
|
||||
# 4. 启动开发服务器
|
||||
bun run dev:vite # 仅 Web (http://localhost:3000)
|
||||
bun run dev # Tauri 桌面应用 + Web
|
||||
```
|
||||
|
||||
### 构建
|
||||
|
||||
```bash
|
||||
bun run build:vite # 构建 Web 版本
|
||||
bun run build # 构建 Tauri 桌面安装包
|
||||
```
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
├── src/
|
||||
│ ├── components/ # 可复用组件
|
||||
│ │ ├── Error.tsx # 错误边界组件
|
||||
│ │ └── NotFound.tsx # 404 页面组件
|
||||
│ │
|
||||
│ ├── db/ # 数据库层
|
||||
│ │ ├── index.ts # 数据库连接
|
||||
│ │ └── schema/ # Drizzle 表定义
|
||||
│ │ ├── index.ts # Schema 导出入口
|
||||
│ │ └── todo.ts # Todo 表定义
|
||||
│ │
|
||||
│ ├── orpc/ # RPC 层 (后端 API)
|
||||
│ │ ├── contracts/ # 契约定义 (输入/输出 Schema)
|
||||
│ │ │ └── todo.ts # Todo API 契约
|
||||
│ │ ├── handlers/ # 业务逻辑实现
|
||||
│ │ │ └── todo.ts # Todo CRUD 处理器
|
||||
│ │ ├── middlewares/ # 中间件
|
||||
│ │ │ └── db.ts # 数据库注入中间件
|
||||
│ │ ├── contract.ts # 契约聚合
|
||||
│ │ ├── router.ts # 路由聚合
|
||||
│ │ ├── client.ts # 同构客户端 (SSR/CSR)
|
||||
│ │ ├── server.ts # 服务端实例
|
||||
│ │ └── index.ts # 导出入口
|
||||
│ │
|
||||
│ ├── routes/ # 页面路由 (文件路由)
|
||||
│ │ ├── __root.tsx # 根布局
|
||||
│ │ ├── index.tsx # 首页 (Todo List)
|
||||
│ │ └── api/
|
||||
│ │ └── rpc.$.ts # RPC HTTP 端点
|
||||
│ │
|
||||
│ ├── integrations/ # 第三方库集成
|
||||
│ ├── lib/ # 工具函数
|
||||
│ ├── env.ts # 环境变量验证
|
||||
│ ├── router.tsx # 路由配置
|
||||
│ └── styles.css # 全局样式
|
||||
│
|
||||
├── scripts/
|
||||
│ └── init-db.ts # 数据库初始化脚本
|
||||
│
|
||||
├── src-tauri/ # Tauri 桌面应用配置
|
||||
├── data/ # SQLite 数据库文件 (gitignore)
|
||||
└── drizzle.config.ts # Drizzle 配置
|
||||
```
|
||||
|
||||
## 开发指南
|
||||
|
||||
### 添加新功能的步骤
|
||||
|
||||
以添加一个 "Note" 功能为例:
|
||||
|
||||
#### 1. 定义数据库 Schema
|
||||
|
||||
```typescript
|
||||
// src/db/schema/note.ts
|
||||
import { sql } from 'drizzle-orm'
|
||||
import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
|
||||
|
||||
export const noteTable = sqliteTable('note', {
|
||||
id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
|
||||
content: text('content').notNull(),
|
||||
createdAt: integer('created_at', { mode: 'timestamp' })
|
||||
.notNull()
|
||||
.default(sql`(unixepoch())`),
|
||||
})
|
||||
```
|
||||
|
||||
```typescript
|
||||
// src/db/schema/index.ts
|
||||
export * from './todo.ts'
|
||||
export * from './note.ts' // 添加导出
|
||||
```
|
||||
|
||||
#### 2. 定义 API 契约
|
||||
|
||||
```typescript
|
||||
// src/orpc/contracts/note.ts
|
||||
import { oc } from '@orpc/contract'
|
||||
import { z } from 'zod'
|
||||
|
||||
export const note = {
|
||||
list: oc.output(z.array(noteSchema)),
|
||||
create: oc.input(z.object({ content: z.string() })).output(noteSchema),
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. 实现业务逻辑
|
||||
|
||||
```typescript
|
||||
// src/orpc/handlers/note.ts
|
||||
import { os } from '@/orpc/server'
|
||||
import { dbProvider } from '@/orpc/middlewares/db'
|
||||
import { noteTable } from '@/db/schema'
|
||||
|
||||
export const list = os.note.list
|
||||
.use(dbProvider)
|
||||
.handler(async ({ context }) => {
|
||||
return context.db.select().from(noteTable)
|
||||
})
|
||||
|
||||
export const create = os.note.create
|
||||
.use(dbProvider)
|
||||
.handler(async ({ context, input }) => {
|
||||
const [note] = await context.db.insert(noteTable).values(input).returning()
|
||||
return note
|
||||
})
|
||||
```
|
||||
|
||||
#### 4. 注册到路由
|
||||
|
||||
```typescript
|
||||
// src/orpc/contract.ts
|
||||
import { note } from './contracts/note'
|
||||
export const contract = { todo, note }
|
||||
|
||||
// src/orpc/router.ts
|
||||
import * as note from './handlers/note'
|
||||
export const router = os.router({ todo, note })
|
||||
```
|
||||
|
||||
#### 5. 在页面中使用
|
||||
|
||||
```typescript
|
||||
// src/routes/notes.tsx
|
||||
import { orpc } from '@/orpc'
|
||||
import { useSuspenseQuery, useMutation } from '@tanstack/react-query'
|
||||
|
||||
const NotesPage = () => {
|
||||
const { data: notes } = useSuspenseQuery(orpc.note.list.queryOptions())
|
||||
const createNote = useMutation(orpc.note.create.mutationOptions())
|
||||
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
|
||||
| 命令 | 说明 |
|
||||
|------|------|
|
||||
| `bun run dev` | 启动 Tauri + Vite 开发服务器 |
|
||||
| `bun run dev:vite` | 仅启动 Vite 开发服务器 |
|
||||
| `bun run build` | 完整构建 (Tauri 桌面应用) |
|
||||
| `bun run build:vite` | 仅构建 Web 版本 |
|
||||
| `bun run db:init` | 初始化/重置数据库 |
|
||||
| `bun run db:studio` | 打开 Drizzle Studio |
|
||||
| `bun run typecheck` | TypeScript 类型检查 |
|
||||
| `bun run fix` | 自动修复格式和 Lint 问题 |
|
||||
|
||||
### 代码规范
|
||||
|
||||
- **格式化**: 使用 Biome,2 空格缩进,单引号
|
||||
- **导入**: 使用 `@/*` 路径别名
|
||||
- **组件**: 箭头函数组件
|
||||
- **命名**: 文件 kebab-case,组件 PascalCase
|
||||
|
||||
## 核心概念
|
||||
|
||||
### ORPC 数据流
|
||||
|
||||
```
|
||||
前端组件
|
||||
↓ useSuspenseQuery / useMutation
|
||||
ORPC 客户端 (src/orpc/client.ts)
|
||||
↓ 自动选择 SSR 直调 / CSR HTTP
|
||||
契约验证 (src/orpc/contracts/)
|
||||
↓ 输入/输出类型安全
|
||||
处理器 (src/orpc/handlers/)
|
||||
↓ 业务逻辑
|
||||
中间件 (src/orpc/middlewares/)
|
||||
↓ 注入数据库连接
|
||||
Drizzle ORM
|
||||
↓ 类型安全查询
|
||||
SQLite 数据库
|
||||
```
|
||||
|
||||
### 同构渲染
|
||||
|
||||
- **SSR**: 服务端直接调用 router,无 HTTP 开销
|
||||
- **CSR**: 客户端通过 `/api/rpc` 端点调用
|
||||
|
||||
### 数据库
|
||||
|
||||
- SQLite 文件存储在 `./data/app.db`
|
||||
- 使用 WAL 模式提高并发性能
|
||||
- 单例模式管理连接
|
||||
|
||||
## 许可证
|
||||
|
||||
MIT
|
||||
24
apps/desktop/.gitignore
vendored
@@ -1,24 +0,0 @@
|
||||
# Logs
|
||||
logs
|
||||
*.log
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
pnpm-debug.log*
|
||||
lerna-debug.log*
|
||||
|
||||
node_modules
|
||||
dist
|
||||
dist-ssr
|
||||
*.local
|
||||
|
||||
# Editor directories and files
|
||||
.vscode/*
|
||||
!.vscode/extensions.json
|
||||
.idea
|
||||
.DS_Store
|
||||
*.suo
|
||||
*.ntvs*
|
||||
*.njsproj
|
||||
*.sln
|
||||
*.sw?
|
||||
@@ -1,470 +0,0 @@
|
||||
import * as path from 'node:path'
|
||||
import { Schema } from '@effect/schema'
|
||||
import { $ } from 'bun'
|
||||
import { Console, Context, Data, Effect, Layer } from 'effect'
|
||||
|
||||
// ============================================================================
|
||||
// Domain Models & Schema
|
||||
// ============================================================================
|
||||
|
||||
/**
|
||||
* Bun 构建目标后缀
|
||||
*/
|
||||
const BunTargetSuffixSchema = Schema.Literal(
|
||||
'windows-x64',
|
||||
'darwin-arm64',
|
||||
'darwin-x64',
|
||||
'linux-x64',
|
||||
'linux-arm64',
|
||||
)
|
||||
|
||||
/**
|
||||
* Tauri sidecar 目标三元组
|
||||
*/
|
||||
const TauriTargetSchema = Schema.Literal(
|
||||
'x86_64-pc-windows-msvc',
|
||||
'aarch64-apple-darwin',
|
||||
'x86_64-apple-darwin',
|
||||
'x86_64-unknown-linux-gnu',
|
||||
'aarch64-unknown-linux-gnu',
|
||||
)
|
||||
|
||||
/**
|
||||
* 目标映射配置
|
||||
*/
|
||||
const TargetMappingSchema = Schema.Struct({
|
||||
bunSuffix: BunTargetSuffixSchema,
|
||||
tauriTarget: TauriTargetSchema,
|
||||
})
|
||||
|
||||
type TargetMapping = Schema.Schema.Type<typeof TargetMappingSchema>
|
||||
|
||||
/**
|
||||
* 复制配置
|
||||
*/
|
||||
const CopyConfigSchema = Schema.Struct({
|
||||
sourceDir: Schema.String.pipe(Schema.nonEmptyString()),
|
||||
targetDir: Schema.String.pipe(Schema.nonEmptyString()),
|
||||
baseName: Schema.String.pipe(Schema.nonEmptyString()),
|
||||
mappings: Schema.Array(TargetMappingSchema).pipe(Schema.minItems(1)),
|
||||
})
|
||||
|
||||
type CopyConfig = Schema.Schema.Type<typeof CopyConfigSchema>
|
||||
|
||||
/**
|
||||
* 复制结果
|
||||
*/
|
||||
const CopyResultSchema = Schema.Struct({
|
||||
bunSuffix: BunTargetSuffixSchema,
|
||||
tauriTarget: TauriTargetSchema,
|
||||
sourceFile: Schema.String,
|
||||
targetFile: Schema.String,
|
||||
success: Schema.Boolean,
|
||||
})
|
||||
|
||||
type CopyResult = Schema.Schema.Type<typeof CopyResultSchema>
|
||||
|
||||
// ============================================================================
|
||||
// Error Models
|
||||
// ============================================================================
|
||||
|
||||
class ConfigError extends Data.TaggedError('ConfigError')<{
|
||||
readonly message: string
|
||||
readonly cause: unknown
|
||||
}> {}
|
||||
|
||||
class FileSystemError extends Data.TaggedError('FileSystemError')<{
|
||||
readonly operation: string
|
||||
readonly path: string
|
||||
readonly cause: unknown
|
||||
}> {}
|
||||
|
||||
class CopyError extends Data.TaggedError('CopyError')<{
|
||||
readonly source: string
|
||||
readonly target: string
|
||||
readonly cause: unknown
|
||||
}> {}
|
||||
|
||||
// ============================================================================
|
||||
// Services
|
||||
// ============================================================================
|
||||
|
||||
/**
|
||||
* 配置服务
|
||||
*/
|
||||
class CopyConfigService extends Context.Tag('CopyConfigService')<
|
||||
CopyConfigService,
|
||||
CopyConfig
|
||||
>() {
|
||||
/**
|
||||
* 从原始数据创建并验证配置
|
||||
*/
|
||||
static fromRaw = (raw: unknown) =>
|
||||
Effect.gen(function* () {
|
||||
const decoded = yield* Schema.decodeUnknown(CopyConfigSchema)(raw)
|
||||
return decoded
|
||||
}).pipe(
|
||||
Effect.catchAll((error) =>
|
||||
Effect.fail(
|
||||
new ConfigError({
|
||||
message: '配置验证失败',
|
||||
cause: error,
|
||||
}),
|
||||
),
|
||||
),
|
||||
)
|
||||
|
||||
/**
|
||||
* 默认配置 Layer
|
||||
*/
|
||||
static readonly Live = Layer.effect(
|
||||
CopyConfigService,
|
||||
CopyConfigService.fromRaw({
|
||||
sourceDir: path.join(__dirname, '..', 'server', 'out'),
|
||||
targetDir: path.join(__dirname, 'src-tauri', 'binaries'),
|
||||
baseName: 'server',
|
||||
mappings: [
|
||||
{
|
||||
bunSuffix: 'windows-x64',
|
||||
tauriTarget: 'x86_64-pc-windows-msvc',
|
||||
},
|
||||
{
|
||||
bunSuffix: 'darwin-arm64',
|
||||
tauriTarget: 'aarch64-apple-darwin',
|
||||
},
|
||||
{
|
||||
bunSuffix: 'darwin-x64',
|
||||
tauriTarget: 'x86_64-apple-darwin',
|
||||
},
|
||||
{
|
||||
bunSuffix: 'linux-x64',
|
||||
tauriTarget: 'x86_64-unknown-linux-gnu',
|
||||
},
|
||||
{
|
||||
bunSuffix: 'linux-arm64',
|
||||
tauriTarget: 'aarch64-unknown-linux-gnu',
|
||||
},
|
||||
],
|
||||
} satisfies CopyConfig),
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 文件系统服务
|
||||
*/
|
||||
class FileSystemService extends Context.Tag('FileSystemService')<
|
||||
FileSystemService,
|
||||
{
|
||||
readonly ensureDir: (dir: string) => Effect.Effect<void, FileSystemError>
|
||||
readonly fileExists: (
|
||||
filePath: string,
|
||||
) => Effect.Effect<boolean, FileSystemError>
|
||||
readonly dirExists: (
|
||||
dirPath: string,
|
||||
) => Effect.Effect<boolean, FileSystemError>
|
||||
readonly copyFile: (
|
||||
source: string,
|
||||
target: string,
|
||||
) => Effect.Effect<void, CopyError>
|
||||
}
|
||||
>() {
|
||||
static readonly Live = Layer.succeed(FileSystemService, {
|
||||
ensureDir: (dir: string) =>
|
||||
Effect.tryPromise({
|
||||
try: async () => {
|
||||
await $`mkdir -p ${dir}`
|
||||
},
|
||||
catch: (cause: unknown) =>
|
||||
new FileSystemError({
|
||||
operation: 'ensureDir',
|
||||
path: dir,
|
||||
cause,
|
||||
}),
|
||||
}),
|
||||
|
||||
fileExists: (filePath: string) =>
|
||||
Effect.tryPromise({
|
||||
try: async () => {
|
||||
const file = Bun.file(filePath)
|
||||
return await file.exists()
|
||||
},
|
||||
catch: (cause: unknown) =>
|
||||
new FileSystemError({
|
||||
operation: 'fileExists',
|
||||
path: filePath,
|
||||
cause,
|
||||
}),
|
||||
}),
|
||||
|
||||
dirExists: (dirPath: string) =>
|
||||
Effect.tryPromise({
|
||||
try: async () => {
|
||||
const { default: fs } = await import('node:fs/promises')
|
||||
try {
|
||||
const stat = await fs.stat(dirPath)
|
||||
return stat.isDirectory()
|
||||
} catch {
|
||||
return false
|
||||
}
|
||||
},
|
||||
catch: (cause: unknown) =>
|
||||
new FileSystemError({
|
||||
operation: 'dirExists',
|
||||
path: dirPath,
|
||||
cause,
|
||||
}),
|
||||
}),
|
||||
|
||||
copyFile: (source: string, target: string) =>
|
||||
Effect.tryPromise({
|
||||
try: async () => {
|
||||
await $`cp ${source} ${target}`
|
||||
},
|
||||
catch: (cause: unknown) =>
|
||||
new CopyError({
|
||||
source,
|
||||
target,
|
||||
cause,
|
||||
}),
|
||||
}),
|
||||
})
|
||||
}
|
||||
|
||||
/**
|
||||
* 复制服务
|
||||
*/
|
||||
class CopyService extends Context.Tag('CopyService')<
|
||||
CopyService,
|
||||
{
|
||||
readonly copyBinary: (
|
||||
config: CopyConfig,
|
||||
mapping: TargetMapping,
|
||||
) => Effect.Effect<CopyResult, CopyError | FileSystemError>
|
||||
readonly copyAllBinaries: (
|
||||
config: CopyConfig,
|
||||
) => Effect.Effect<ReadonlyArray<CopyResult>, CopyError | FileSystemError>
|
||||
}
|
||||
>() {
|
||||
static readonly Live = Layer.effect(
|
||||
CopyService,
|
||||
Effect.gen(function* () {
|
||||
const fs = yield* FileSystemService
|
||||
|
||||
return {
|
||||
copyBinary: (config: CopyConfig, mapping: TargetMapping) =>
|
||||
Effect.gen(function* () {
|
||||
const { sourceDir, targetDir, baseName } = config
|
||||
const { bunSuffix, tauriTarget } = mapping
|
||||
|
||||
// 确定文件扩展名(Windows 需要 .exe)
|
||||
const ext = tauriTarget.includes('windows') ? '.exe' : ''
|
||||
|
||||
// 构建源文件和目标文件路径
|
||||
const sourceFile = path.join(
|
||||
sourceDir,
|
||||
`${baseName}-${bunSuffix}${ext}`,
|
||||
)
|
||||
const targetFile = path.join(
|
||||
targetDir,
|
||||
`${baseName}-${tauriTarget}${ext}`,
|
||||
)
|
||||
|
||||
// 检查源文件是否存在
|
||||
const exists = yield* fs.fileExists(sourceFile)
|
||||
if (!exists) {
|
||||
yield* Console.log(`⚠️ 跳过 ${bunSuffix}: 源文件不存在`)
|
||||
return {
|
||||
bunSuffix,
|
||||
tauriTarget,
|
||||
sourceFile,
|
||||
targetFile,
|
||||
success: false,
|
||||
} satisfies CopyResult
|
||||
}
|
||||
|
||||
// 复制文件
|
||||
yield* fs.copyFile(sourceFile, targetFile)
|
||||
|
||||
yield* Console.log(`✓ ${bunSuffix} → ${tauriTarget}`)
|
||||
yield* Console.log(` ${sourceFile}`)
|
||||
yield* Console.log(` → ${targetFile}\n`)
|
||||
|
||||
return {
|
||||
bunSuffix,
|
||||
tauriTarget,
|
||||
sourceFile,
|
||||
targetFile,
|
||||
success: true,
|
||||
} satisfies CopyResult
|
||||
}),
|
||||
|
||||
copyAllBinaries: (config: CopyConfig) =>
|
||||
Effect.gen(function* () {
|
||||
const effects = config.mappings.map((mapping) =>
|
||||
Effect.gen(function* () {
|
||||
const { sourceDir, targetDir, baseName } = config
|
||||
const { bunSuffix, tauriTarget } = mapping
|
||||
|
||||
const ext = tauriTarget.includes('windows') ? '.exe' : ''
|
||||
const sourceFile = path.join(
|
||||
sourceDir,
|
||||
`${baseName}-${bunSuffix}${ext}`,
|
||||
)
|
||||
const targetFile = path.join(
|
||||
targetDir,
|
||||
`${baseName}-${tauriTarget}${ext}`,
|
||||
)
|
||||
|
||||
const exists = yield* fs.fileExists(sourceFile)
|
||||
if (!exists) {
|
||||
yield* Console.log(`⚠️ 跳过 ${bunSuffix}: 源文件不存在`)
|
||||
return {
|
||||
bunSuffix,
|
||||
tauriTarget,
|
||||
sourceFile,
|
||||
targetFile,
|
||||
success: false,
|
||||
} satisfies CopyResult
|
||||
}
|
||||
|
||||
yield* fs.copyFile(sourceFile, targetFile)
|
||||
|
||||
yield* Console.log(`✓ ${bunSuffix} → ${tauriTarget}`)
|
||||
yield* Console.log(` ${sourceFile}`)
|
||||
yield* Console.log(` → ${targetFile}\n`)
|
||||
|
||||
return {
|
||||
bunSuffix,
|
||||
tauriTarget,
|
||||
sourceFile,
|
||||
targetFile,
|
||||
success: true,
|
||||
} satisfies CopyResult
|
||||
}),
|
||||
)
|
||||
|
||||
return yield* Effect.all(effects, { concurrency: 'unbounded' })
|
||||
}),
|
||||
}
|
||||
}),
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 报告服务
|
||||
*/
|
||||
class ReporterService extends Context.Tag('ReporterService')<
|
||||
ReporterService,
|
||||
{
|
||||
readonly printSummary: (
|
||||
results: ReadonlyArray<CopyResult>,
|
||||
) => Effect.Effect<void>
|
||||
}
|
||||
>() {
|
||||
static readonly Live = Layer.succeed(ReporterService, {
|
||||
printSummary: (results: ReadonlyArray<CopyResult>) =>
|
||||
Effect.gen(function* () {
|
||||
const successful = results.filter((r) => r.success)
|
||||
const failed = results.filter((r) => !r.success)
|
||||
|
||||
yield* Console.log('\n📦 复制摘要:')
|
||||
yield* Console.log(` ✅ 成功: ${successful.length}`)
|
||||
yield* Console.log(` ⚠️ 跳过: ${failed.length}`)
|
||||
|
||||
if (successful.length > 0) {
|
||||
yield* Console.log('\n成功复制的文件:')
|
||||
for (const result of successful) {
|
||||
yield* Console.log(
|
||||
` • ${result.bunSuffix} → ${result.tauriTarget}`,
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
if (failed.length > 0) {
|
||||
yield* Console.log('\n跳过的文件:')
|
||||
for (const result of failed) {
|
||||
yield* Console.log(` • ${result.bunSuffix} (源文件不存在)`)
|
||||
}
|
||||
}
|
||||
}),
|
||||
})
|
||||
}
|
||||
|
||||
// ============================================================================
|
||||
// Main Program
|
||||
// ============================================================================
|
||||
|
||||
const program = Effect.gen(function* () {
|
||||
const config = yield* CopyConfigService
|
||||
const fs = yield* FileSystemService
|
||||
const copier = yield* CopyService
|
||||
const reporter = yield* ReporterService
|
||||
|
||||
yield* Console.log('📦 开始复制二进制文件到 Tauri sidecar 目录...\n')
|
||||
|
||||
// 1. 检查源目录
|
||||
const sourceExists = yield* fs.dirExists(config.sourceDir)
|
||||
if (!sourceExists) {
|
||||
yield* Console.error(`❌ 源目录不存在: ${config.sourceDir}`)
|
||||
yield* Console.log(
|
||||
'💡 提示: 请先在 apps/server 中运行 bun run compile 构建服务器二进制文件',
|
||||
)
|
||||
return yield* Effect.fail(
|
||||
new FileSystemError({
|
||||
operation: 'checkSourceDir',
|
||||
path: config.sourceDir,
|
||||
cause: '源目录不存在',
|
||||
}),
|
||||
)
|
||||
}
|
||||
|
||||
// 2. 创建目标目录
|
||||
yield* fs.ensureDir(config.targetDir)
|
||||
yield* Console.log(`✓ 目标目录: ${config.targetDir}\n`)
|
||||
|
||||
// 3. 并行复制所有二进制文件
|
||||
const results = yield* copier.copyAllBinaries(config)
|
||||
|
||||
// 4. 输出摘要
|
||||
yield* reporter.printSummary(results)
|
||||
|
||||
return results
|
||||
})
|
||||
|
||||
// ============================================================================
|
||||
// Layer Composition
|
||||
// ============================================================================
|
||||
|
||||
const MainLayer = Layer.mergeAll(
|
||||
CopyConfigService.Live,
|
||||
FileSystemService.Live,
|
||||
CopyService.Live.pipe(Layer.provide(FileSystemService.Live)),
|
||||
ReporterService.Live,
|
||||
)
|
||||
|
||||
// ============================================================================
|
||||
// Runner
|
||||
// ============================================================================
|
||||
|
||||
const runnable = program.pipe(
|
||||
Effect.provide(MainLayer),
|
||||
Effect.catchTags({
|
||||
ConfigError: (error) =>
|
||||
Console.error(`❌ 配置错误: ${error.message}`, error.cause),
|
||||
FileSystemError: (error) =>
|
||||
Console.error(
|
||||
`❌ 文件系统错误 [${error.operation}]: ${error.path}`,
|
||||
error.cause,
|
||||
),
|
||||
CopyError: (error) =>
|
||||
Console.error(
|
||||
`❌ 复制失败: ${error.source} → ${error.target}`,
|
||||
error.cause,
|
||||
),
|
||||
}),
|
||||
Effect.tapErrorCause((cause) => Console.error('❌ 未预期的错误:', cause)),
|
||||
)
|
||||
|
||||
Effect.runPromise(runnable).catch(() => {
|
||||
process.exit(1)
|
||||
})
|
||||
@@ -1,19 +0,0 @@
|
||||
{
|
||||
"name": "@furtherverse/desktop",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "bun run copy && tauri build",
|
||||
"copy": "rm -rf binaries && bun --bun copy.ts",
|
||||
"dev": "bun run copy && tauri dev"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@effect/schema": "catalog:",
|
||||
"@furtherverse/tsconfig": "workspace:*",
|
||||
"@tauri-apps/cli": "catalog:",
|
||||
"@types/bun": "catalog:",
|
||||
"effect": "catalog:",
|
||||
"typescript": "catalog:"
|
||||
}
|
||||
}
|
||||
@@ -1,4 +0,0 @@
|
||||
{
|
||||
"extends": "@furtherverse/tsconfig/bun.json",
|
||||
"exclude": ["node_modules", "src-tauri"]
|
||||
}
|
||||
@@ -1,14 +0,0 @@
|
||||
{
|
||||
"$schema": "../../node_modules/turbo/schema.json",
|
||||
"extends": ["//"],
|
||||
"tasks": {
|
||||
"build": {
|
||||
"dependsOn": ["@furtherverse/server#compile"],
|
||||
"outputs": ["src-tauri/target/release/**"]
|
||||
},
|
||||
"dev": {
|
||||
"dependsOn": ["@furtherverse/server#compile"],
|
||||
"with": ["@furtherverse/server#dev"]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,7 +0,0 @@
|
||||
{
|
||||
"$schema": "../../node_modules/@biomejs/biome/configuration_schema.json",
|
||||
"extends": "//",
|
||||
"files": {
|
||||
"includes": ["**", "!**/routeTree.gen.ts"]
|
||||
}
|
||||
}
|
||||
@@ -1,11 +0,0 @@
|
||||
import { defineConfig } from 'drizzle-kit'
|
||||
import { env } from '@/env'
|
||||
|
||||
export default defineConfig({
|
||||
out: './drizzle',
|
||||
schema: './src/server/db/schema/index.ts',
|
||||
dialect: 'postgresql',
|
||||
dbCredentials: {
|
||||
url: env.DATABASE_URL,
|
||||
},
|
||||
})
|
||||
@@ -1,59 +0,0 @@
|
||||
{
|
||||
"name": "@furtherverse/server",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "vite build",
|
||||
"compile": "bun build.ts",
|
||||
"db:generate": "drizzle-kit generate",
|
||||
"db:migrate": "drizzle-kit migrate",
|
||||
"db:push": "drizzle-kit push",
|
||||
"db:studio": "drizzle-kit studio",
|
||||
"dev": "vite dev",
|
||||
"fix": "biome check --write",
|
||||
"typecheck": "tsc --noEmit"
|
||||
},
|
||||
"dependencies": {
|
||||
"@furtherverse/utils": "workspace:*",
|
||||
"@orpc/client": "catalog:",
|
||||
"@orpc/contract": "catalog:",
|
||||
"@orpc/openapi": "catalog:",
|
||||
"@orpc/server": "catalog:",
|
||||
"@orpc/tanstack-query": "catalog:",
|
||||
"@orpc/zod": "catalog:",
|
||||
"@t3-oss/env-core": "catalog:",
|
||||
"@tanstack/react-query": "catalog:",
|
||||
"@tanstack/react-router": "catalog:",
|
||||
"@tanstack/react-router-ssr-query": "catalog:",
|
||||
"@tanstack/react-start": "catalog:",
|
||||
"@tauri-apps/api": "catalog:",
|
||||
"drizzle-orm": "catalog:",
|
||||
"drizzle-zod": "catalog:",
|
||||
"postgres": "catalog:",
|
||||
"react": "catalog:",
|
||||
"react-dom": "catalog:",
|
||||
"uuid": "catalog:",
|
||||
"zod": "catalog:"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@effect/platform": "catalog:",
|
||||
"@effect/schema": "catalog:",
|
||||
"@furtherverse/tsconfig": "workspace:*",
|
||||
"@tailwindcss/vite": "catalog:",
|
||||
"@tanstack/devtools-vite": "catalog:",
|
||||
"@tanstack/react-devtools": "catalog:",
|
||||
"@tanstack/react-query-devtools": "catalog:",
|
||||
"@tanstack/react-router-devtools": "catalog:",
|
||||
"@types/bun": "catalog:",
|
||||
"@vitejs/plugin-react": "catalog:",
|
||||
"babel-plugin-react-compiler": "catalog:",
|
||||
"drizzle-kit": "catalog:",
|
||||
"effect": "catalog:",
|
||||
"nitro": "catalog:",
|
||||
"tailwindcss": "catalog:",
|
||||
"typescript": "catalog:",
|
||||
"vite": "catalog:",
|
||||
"vite-tsconfig-paths": "catalog:"
|
||||
}
|
||||
}
|
||||
@@ -1,24 +0,0 @@
|
||||
import { createORPCClient } from '@orpc/client'
|
||||
import { RPCLink } from '@orpc/client/fetch'
|
||||
import { createRouterClient } from '@orpc/server'
|
||||
import { createIsomorphicFn } from '@tanstack/react-start'
|
||||
import { getRequestHeaders } from '@tanstack/react-start/server'
|
||||
import { router } from '@/server/api/routers'
|
||||
import type { RouterClient } from '@/server/api/types'
|
||||
|
||||
const getORPCClient = createIsomorphicFn()
|
||||
.server(() =>
|
||||
createRouterClient(router, {
|
||||
context: () => ({
|
||||
headers: getRequestHeaders(),
|
||||
}),
|
||||
}),
|
||||
)
|
||||
.client(() => {
|
||||
const link = new RPCLink({
|
||||
url: `${window.location.origin}/api/rpc`,
|
||||
})
|
||||
return createORPCClient<RouterClient>(link)
|
||||
})
|
||||
|
||||
export const orpc: RouterClient = getORPCClient()
|
||||
@@ -1,30 +0,0 @@
|
||||
import { createTanstackQueryUtils } from '@orpc/tanstack-query'
|
||||
import { orpc as orpcClient } from './orpc.client'
|
||||
|
||||
export const orpc = createTanstackQueryUtils(orpcClient, {
|
||||
experimental_defaults: {
|
||||
todo: {
|
||||
create: {
|
||||
mutationOptions: {
|
||||
onSuccess: (_, __, ___, ctx) => {
|
||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||
},
|
||||
},
|
||||
},
|
||||
update: {
|
||||
mutationOptions: {
|
||||
onSuccess: (_, __, ___, ctx) => {
|
||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||
},
|
||||
},
|
||||
},
|
||||
remove: {
|
||||
mutationOptions: {
|
||||
onSuccess: (_, __, ___, ctx) => {
|
||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
})
|
||||
@@ -1,86 +0,0 @@
|
||||
import { OpenAPIHandler } from '@orpc/openapi/fetch'
|
||||
import { OpenAPIReferencePlugin } from '@orpc/openapi/plugins'
|
||||
import { ORPCError, onError, ValidationError } from '@orpc/server'
|
||||
import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
|
||||
import { createFileRoute } from '@tanstack/react-router'
|
||||
import { z } from 'zod'
|
||||
import { name, version } from '@/../package.json'
|
||||
import { router } from '@/server/api/routers'
|
||||
|
||||
const handler = new OpenAPIHandler(router, {
|
||||
plugins: [
|
||||
new OpenAPIReferencePlugin({
|
||||
docsProvider: 'scalar',
|
||||
schemaConverters: [new ZodToJsonSchemaConverter()],
|
||||
specGenerateOptions: {
|
||||
info: {
|
||||
title: name,
|
||||
version,
|
||||
},
|
||||
// components: {
|
||||
// securitySchemes: {
|
||||
// bearerAuth: {
|
||||
// type: 'http',
|
||||
// scheme: 'bearer',
|
||||
// },
|
||||
// },
|
||||
// },
|
||||
},
|
||||
docsPath: '/docs',
|
||||
specPath: '/spec.json',
|
||||
}),
|
||||
],
|
||||
interceptors: [
|
||||
onError((error) => {
|
||||
console.error(error)
|
||||
}),
|
||||
],
|
||||
clientInterceptors: [
|
||||
onError((error) => {
|
||||
if (
|
||||
error instanceof ORPCError &&
|
||||
error.code === 'BAD_REQUEST' &&
|
||||
error.cause instanceof ValidationError
|
||||
) {
|
||||
// If you only use Zod you can safely cast to ZodIssue[]
|
||||
const zodError = new z.ZodError(
|
||||
error.cause.issues as z.core.$ZodIssue[],
|
||||
)
|
||||
|
||||
throw new ORPCError('INPUT_VALIDATION_FAILED', {
|
||||
status: 422,
|
||||
message: z.prettifyError(zodError),
|
||||
data: z.flattenError(zodError),
|
||||
cause: error.cause,
|
||||
})
|
||||
}
|
||||
|
||||
if (
|
||||
error instanceof ORPCError &&
|
||||
error.code === 'INTERNAL_SERVER_ERROR' &&
|
||||
error.cause instanceof ValidationError
|
||||
) {
|
||||
throw new ORPCError('OUTPUT_VALIDATION_FAILED', {
|
||||
cause: error.cause,
|
||||
})
|
||||
}
|
||||
}),
|
||||
],
|
||||
})
|
||||
|
||||
export const Route = createFileRoute('/api/$')({
|
||||
server: {
|
||||
handlers: {
|
||||
ANY: async ({ request }) => {
|
||||
const { response } = await handler.handle(request, {
|
||||
prefix: '/api',
|
||||
context: {
|
||||
headers: request.headers,
|
||||
},
|
||||
})
|
||||
|
||||
return response ?? new Response('Not Found', { status: 404 })
|
||||
},
|
||||
},
|
||||
},
|
||||
})
|
||||
@@ -1,25 +0,0 @@
|
||||
import type { DB } from '@/server/db'
|
||||
|
||||
/**
|
||||
* 基础 Context - 所有请求都包含的上下文
|
||||
*/
|
||||
export interface BaseContext {
|
||||
headers: Headers
|
||||
}
|
||||
|
||||
/**
|
||||
* 数据库 Context - 通过 db middleware 扩展
|
||||
*/
|
||||
export interface DBContext extends BaseContext {
|
||||
db: DB
|
||||
}
|
||||
|
||||
/**
|
||||
* 认证 Context - 通过 auth middleware 扩展(未来使用)
|
||||
*
|
||||
* @example
|
||||
* export interface AuthContext extends DBContext {
|
||||
* userId: string
|
||||
* user: User
|
||||
* }
|
||||
*/
|
||||
@@ -1,7 +0,0 @@
|
||||
import * as todo from './todo.contract'
|
||||
|
||||
export const contract = {
|
||||
todo,
|
||||
}
|
||||
|
||||
export type Contract = typeof contract
|
||||
@@ -1,11 +0,0 @@
|
||||
import { os } from '@orpc/server'
|
||||
import { getDB } from '@/server/db'
|
||||
|
||||
export const db = os.middleware(async ({ context, next }) => {
|
||||
return next({
|
||||
context: {
|
||||
...context,
|
||||
db: getDB(),
|
||||
},
|
||||
})
|
||||
})
|
||||
@@ -1 +0,0 @@
|
||||
export * from './db.middleware'
|
||||
@@ -1,6 +0,0 @@
|
||||
import { os } from '../server'
|
||||
import * as todo from './todo.router'
|
||||
|
||||
export const router = os.router({
|
||||
todo,
|
||||
})
|
||||
@@ -1,5 +0,0 @@
|
||||
import { implement } from '@orpc/server'
|
||||
import type { BaseContext } from './context'
|
||||
import { contract } from './contracts'
|
||||
|
||||
export const os = implement(contract).$context<BaseContext>()
|
||||
@@ -1,27 +0,0 @@
|
||||
import { drizzle } from 'drizzle-orm/postgres-js'
|
||||
import { env } from '@/env'
|
||||
import * as schema from '@/server/db/schema'
|
||||
|
||||
export const createDB = () =>
|
||||
drizzle({
|
||||
connection: {
|
||||
url: env.DATABASE_URL,
|
||||
prepare: true,
|
||||
},
|
||||
schema,
|
||||
})
|
||||
|
||||
export type DB = ReturnType<typeof createDB>
|
||||
|
||||
export const getDB = (() => {
|
||||
let db: DB | null = null
|
||||
|
||||
return (singleton = true): DB => {
|
||||
if (!singleton) {
|
||||
return createDB()
|
||||
}
|
||||
|
||||
db ??= createDB()
|
||||
return db
|
||||
}
|
||||
})()
|
||||
@@ -1,8 +0,0 @@
|
||||
import { boolean, pgTable, text } from 'drizzle-orm/pg-core'
|
||||
import { generatedFields } from './utils/field'
|
||||
|
||||
export const todoTable = pgTable('todo', {
|
||||
...generatedFields,
|
||||
title: text('title').notNull(),
|
||||
completed: boolean('completed').notNull().default(false),
|
||||
})
|
||||
@@ -1,58 +0,0 @@
|
||||
import { sql } from 'drizzle-orm'
|
||||
import { timestamp, uuid } from 'drizzle-orm/pg-core'
|
||||
import { v7 as uuidv7 } from 'uuid'
|
||||
|
||||
// id
|
||||
|
||||
export const id = (name: string) => uuid(name)
|
||||
export const pk = (name: string, strategy?: 'native' | 'extension') => {
|
||||
switch (strategy) {
|
||||
// PG 18+
|
||||
case 'native':
|
||||
return id(name).primaryKey().default(sql`uuidv7()`)
|
||||
|
||||
// PG 13+ with extension
|
||||
case 'extension':
|
||||
return id(name).primaryKey().default(sql`uuid_generate_v7()`)
|
||||
|
||||
// Any PG version
|
||||
default:
|
||||
return id(name)
|
||||
.primaryKey()
|
||||
.$defaultFn(() => uuidv7())
|
||||
}
|
||||
}
|
||||
|
||||
// timestamp
|
||||
|
||||
export const createdAt = (name = 'created_at') =>
|
||||
timestamp(name, { withTimezone: true }).notNull().defaultNow()
|
||||
|
||||
export const updatedAt = (name = 'updated_at') =>
|
||||
timestamp(name, { withTimezone: true })
|
||||
.notNull()
|
||||
.defaultNow()
|
||||
.$onUpdateFn(() => new Date())
|
||||
|
||||
// generated fields
|
||||
|
||||
export const generatedFields = {
|
||||
id: pk('id'),
|
||||
createdAt: createdAt('created_at'),
|
||||
updatedAt: updatedAt('updated_at'),
|
||||
}
|
||||
|
||||
// Helper to create omit keys from generatedFields
|
||||
const createGeneratedFieldKeys = <T extends Record<string, unknown>>(
|
||||
fields: T,
|
||||
): Record<keyof T, true> => {
|
||||
return Object.keys(fields).reduce(
|
||||
(acc, key) => {
|
||||
acc[key as keyof T] = true
|
||||
return acc
|
||||
},
|
||||
{} as Record<keyof T, true>,
|
||||
)
|
||||
}
|
||||
|
||||
export const generatedFieldKeys = createGeneratedFieldKeys(generatedFields)
|
||||
@@ -1,9 +0,0 @@
|
||||
{
|
||||
"extends": "@furtherverse/tsconfig/react.json",
|
||||
"compilerOptions": {
|
||||
"baseUrl": ".",
|
||||
"paths": {
|
||||
"@/*": ["./src/*"]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,10 +0,0 @@
|
||||
{
|
||||
"$schema": "../../node_modules/turbo/schema.json",
|
||||
"extends": ["//"],
|
||||
"tasks": {
|
||||
"compile": {
|
||||
"dependsOn": ["build"],
|
||||
"outputs": ["out/**"]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -6,6 +6,7 @@
|
||||
"useIgnoreFile": true
|
||||
},
|
||||
"files": {
|
||||
"includes": ["**", "!**/routeTree.gen.ts"],
|
||||
"ignoreUnknown": false
|
||||
},
|
||||
"formatter": {
|
||||
|
||||
@@ -6,6 +6,14 @@ import { Console, Context, Data, Effect, Layer } from 'effect'
|
||||
// Domain Models & Schema
|
||||
// ============================================================================
|
||||
|
||||
const targetMap = {
|
||||
'bun-windows-x64': 'x86_64-pc-windows-msvc',
|
||||
'bun-darwin-arm64': 'aarch64-apple-darwin',
|
||||
'bun-darwin-x64': 'x86_64-apple-darwin',
|
||||
'bun-linux-x64': 'x86_64-unknown-linux-gnu',
|
||||
'bun-linux-arm64': 'aarch64-unknown-linux-gnu',
|
||||
} as const
|
||||
|
||||
const BunTargetSchema = Schema.Literal(
|
||||
'bun-windows-x64',
|
||||
'bun-darwin-arm64',
|
||||
@@ -14,19 +22,11 @@ const BunTargetSchema = Schema.Literal(
|
||||
'bun-linux-arm64',
|
||||
)
|
||||
|
||||
/**
|
||||
* 将 bun target 转换为文件后缀 (去掉 'bun-' 前缀)
|
||||
*/
|
||||
const getTargetSuffix = (target: BunTarget): string => {
|
||||
return target.replace('bun-', '')
|
||||
}
|
||||
|
||||
type BunTarget = Schema.Schema.Type<typeof BunTargetSchema>
|
||||
|
||||
const BuildConfigSchema = Schema.Struct({
|
||||
entrypoint: Schema.String.pipe(Schema.nonEmptyString()),
|
||||
outputDir: Schema.String.pipe(Schema.nonEmptyString()),
|
||||
outfile: Schema.String.pipe(Schema.nonEmptyString()),
|
||||
targets: Schema.Array(BunTargetSchema).pipe(Schema.minItems(1)),
|
||||
})
|
||||
|
||||
@@ -94,10 +94,10 @@ class BuildConfigService extends Context.Tag('BuildConfigService')<
|
||||
BuildConfigService,
|
||||
BuildConfigService.fromRaw({
|
||||
entrypoint: '.output/server/index.mjs',
|
||||
outputDir: 'out',
|
||||
outfile: 'server',
|
||||
// outputDir: 'out',
|
||||
outputDir: 'src-tauri/binaries',
|
||||
targets: ['bun-windows-x64', 'bun-darwin-arm64', 'bun-linux-x64'],
|
||||
} satisfies BuildConfig),
|
||||
}),
|
||||
)
|
||||
}
|
||||
|
||||
@@ -150,7 +150,7 @@ class BuildService extends Context.Tag('BuildService')<
|
||||
Bun.build({
|
||||
entrypoints: [config.entrypoint],
|
||||
compile: {
|
||||
outfile: `${config.outfile}-${getTargetSuffix(target)}`,
|
||||
outfile: `app-${targetMap[target]}`,
|
||||
target: target,
|
||||
},
|
||||
outdir: config.outputDir,
|
||||
@@ -181,7 +181,7 @@ class BuildService extends Context.Tag('BuildService')<
|
||||
Bun.build({
|
||||
entrypoints: [config.entrypoint],
|
||||
compile: {
|
||||
outfile: `${config.outfile}-${getTargetSuffix(target)}`,
|
||||
outfile: `app-${targetMap[target]}`,
|
||||
target: target,
|
||||
},
|
||||
outdir: config.outputDir,
|
||||
@@ -1,2 +0,0 @@
|
||||
[install]
|
||||
publicHoistPattern = ["@types/*", "bun-types", "nitro*"]
|
||||
10
drizzle.config.ts
Normal file
@@ -0,0 +1,10 @@
|
||||
import { defineConfig } from 'drizzle-kit'
|
||||
|
||||
export default defineConfig({
|
||||
out: './drizzle',
|
||||
schema: './src/db/schema/index.ts',
|
||||
dialect: 'sqlite',
|
||||
dbCredentials: {
|
||||
url: './data/app.db',
|
||||
},
|
||||
})
|
||||
0
drizzle/.gitkeep
Normal file
74
package.json
@@ -1,65 +1,59 @@
|
||||
{
|
||||
"name": "@furtherverse/monorepo",
|
||||
"version": "1.0.0",
|
||||
"name": "fullstack-starter",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"workspaces": [
|
||||
"apps/*",
|
||||
"packages/*"
|
||||
],
|
||||
"scripts": {
|
||||
"build": "turbo run build",
|
||||
"compile": "turbo run compile",
|
||||
"deploy": "turbo run deploy",
|
||||
"dev": "turbo run dev",
|
||||
"fix": "turbo run fix",
|
||||
"typecheck": "turbo run typecheck"
|
||||
"build": "turbo build:tauri",
|
||||
"build:compile": "bun build.ts",
|
||||
"build:tauri": "tauri build",
|
||||
"build:vite": "vite build",
|
||||
"db:generate": "drizzle-kit generate",
|
||||
"db:init": "bun run scripts/init-db.ts",
|
||||
"db:migrate": "drizzle-kit migrate",
|
||||
"db:push": "drizzle-kit push",
|
||||
"db:studio": "drizzle-kit studio",
|
||||
"dev": "turbo dev:tauri",
|
||||
"dev:tauri": "tauri dev",
|
||||
"dev:vite": "vite dev",
|
||||
"fix": "biome check --write",
|
||||
"typecheck": "tsc -b"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@biomejs/biome": "^2.3.11",
|
||||
"turbo": "^2.7.5"
|
||||
},
|
||||
"catalog": {
|
||||
"@biomejs/biome": "^2.3.11",
|
||||
"@effect/platform": "^0.94.2",
|
||||
"@effect/schema": "^0.75.5",
|
||||
"dependencies": {
|
||||
"@orpc/client": "^1.13.4",
|
||||
"@orpc/contract": "^1.13.4",
|
||||
"@orpc/openapi": "^1.13.4",
|
||||
"@orpc/server": "^1.13.4",
|
||||
"@orpc/tanstack-query": "^1.13.4",
|
||||
"@orpc/zod": "^1.13.4",
|
||||
"@t3-oss/env-core": "^0.13.10",
|
||||
"@tanstack/react-query": "^5.90.18",
|
||||
"@tanstack/react-router": "^1.151.0",
|
||||
"@tanstack/react-router-ssr-query": "^1.151.0",
|
||||
"@tanstack/react-start": "^1.151.0",
|
||||
"@tauri-apps/api": "^2.9.1",
|
||||
"drizzle-orm": "^0.45.1",
|
||||
"drizzle-zod": "^0.8.3",
|
||||
"react": "^19.2.3",
|
||||
"react-dom": "^19.2.3",
|
||||
"zod": "^4.3.5"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@biomejs/biome": "^2.3.11",
|
||||
"@tailwindcss/vite": "^4.1.18",
|
||||
"@tanstack/devtools-vite": "^0.4.1",
|
||||
"@tanstack/react-devtools": "^0.9.2",
|
||||
"@tanstack/react-query": "^5.90.19",
|
||||
"@tanstack/react-query-devtools": "^5.91.2",
|
||||
"@tanstack/react-router": "^1.154.12",
|
||||
"@tanstack/react-router-devtools": "^1.154.12",
|
||||
"@tanstack/react-router-ssr-query": "^1.154.12",
|
||||
"@tanstack/react-start": "^1.154.12",
|
||||
"@tauri-apps/api": "^2.9.1",
|
||||
"@tanstack/react-router-devtools": "^1.151.0",
|
||||
"@tauri-apps/cli": "^2.9.6",
|
||||
"@types/bun": "^1.3.6",
|
||||
"@vitejs/plugin-react": "^5.1.2",
|
||||
"babel-plugin-react-compiler": "^1.0.0",
|
||||
"drizzle-kit": "^0.31.8",
|
||||
"drizzle-orm": "^0.45.1",
|
||||
"drizzle-zod": "^0.8.3",
|
||||
"effect": "^3.19.15",
|
||||
"nitro": "npm:nitro-nightly@3.0.1-20260122-201913-dfdff9e9",
|
||||
"ohash": "^2.0.11",
|
||||
"postgres": "^3.4.8",
|
||||
"react": "^19.2.3",
|
||||
"react-dom": "^19.2.3",
|
||||
"effect": "^3.19.14",
|
||||
"nitro": "npm:nitro-nightly@latest",
|
||||
"tailwindcss": "^4.1.18",
|
||||
"turbo": "^2.7.5",
|
||||
"typescript": "^5.9.3",
|
||||
"uuid": "^13.0.0",
|
||||
"systeminformation": "^5.30.5",
|
||||
"vite": "^8.0.0-beta.9",
|
||||
"vite-tsconfig-paths": "^6.0.4",
|
||||
"zod": "^4.3.6"
|
||||
"vite": "^8.0.0-beta.8",
|
||||
"vite-tsconfig-paths": "^6.0.4"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,26 +0,0 @@
|
||||
{
|
||||
"$schema": "https://json.schemastore.org/tsconfig",
|
||||
"display": "Base",
|
||||
"compilerOptions": {
|
||||
"target": "esnext",
|
||||
"lib": ["ESNext"],
|
||||
"module": "preserve",
|
||||
"skipLibCheck": true,
|
||||
|
||||
"moduleResolution": "bundler",
|
||||
"allowImportingTsExtensions": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"moduleDetection": "force",
|
||||
"noEmit": true,
|
||||
|
||||
"strict": true,
|
||||
"noUnusedLocals": false,
|
||||
"noUnusedParameters": false,
|
||||
"erasableSyntaxOnly": true,
|
||||
"noFallthroughCasesInSwitch": true,
|
||||
"noUncheckedSideEffectImports": true,
|
||||
"noUncheckedIndexedAccess": true,
|
||||
"noImplicitOverride": true
|
||||
},
|
||||
"exclude": ["node_modules"]
|
||||
}
|
||||
@@ -1,8 +0,0 @@
|
||||
{
|
||||
"$schema": "https://json.schemastore.org/tsconfig",
|
||||
"display": "Bun",
|
||||
"extends": "./base.json",
|
||||
"compilerOptions": {
|
||||
"types": ["bun-types"]
|
||||
}
|
||||
}
|
||||
@@ -1,11 +0,0 @@
|
||||
{
|
||||
"name": "@furtherverse/tsconfig",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"exports": {
|
||||
"./base.json": "./base.json",
|
||||
"./bun.json": "./bun.json",
|
||||
"./react.json": "./react.json"
|
||||
}
|
||||
}
|
||||
@@ -1,9 +0,0 @@
|
||||
{
|
||||
"$schema": "https://json.schemastore.org/tsconfig",
|
||||
"display": "React",
|
||||
"extends": "./base.json",
|
||||
"compilerOptions": {
|
||||
"lib": ["ESNext", "DOM", "DOM.Iterable"],
|
||||
"jsx": "react-jsx"
|
||||
}
|
||||
}
|
||||
@@ -1,21 +0,0 @@
|
||||
{
|
||||
"name": "@furtherverse/utils",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"imports": {
|
||||
"#*": "./src/*"
|
||||
},
|
||||
"exports": {
|
||||
".": "./src/index.ts",
|
||||
"./*": "./src/*.ts"
|
||||
},
|
||||
"dependencies": {
|
||||
"ohash": "catalog:",
|
||||
"systeminformation": "catalog:"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@furtherverse/tsconfig": "workspace:*",
|
||||
"typescript": "catalog:"
|
||||
}
|
||||
}
|
||||
@@ -1,29 +0,0 @@
|
||||
import { hash } from 'ohash'
|
||||
import si from 'systeminformation'
|
||||
|
||||
async function getSystemInfo() {
|
||||
const [uuid, baseboard, bios, system, diskLayout, networkInterfaces] =
|
||||
await Promise.all([
|
||||
si.uuid(),
|
||||
si.baseboard(),
|
||||
si.bios(),
|
||||
si.system(),
|
||||
si.diskLayout(),
|
||||
si.networkInterfaces(),
|
||||
])
|
||||
|
||||
return {
|
||||
uuid,
|
||||
baseboard,
|
||||
bios,
|
||||
system,
|
||||
diskLayout,
|
||||
networkInterfaces,
|
||||
}
|
||||
}
|
||||
|
||||
export async function getHardwareFingerprint() {
|
||||
const systemInfo = await getSystemInfo()
|
||||
|
||||
return hash(systemInfo)
|
||||
}
|
||||
@@ -1 +0,0 @@
|
||||
export * from './fingerprint'
|
||||
22
scripts/init-db.ts
Normal file
@@ -0,0 +1,22 @@
|
||||
import { Database } from 'bun:sqlite'
|
||||
import { mkdir } from 'node:fs/promises'
|
||||
|
||||
// Ensure data directory exists
|
||||
await mkdir('./data', { recursive: true })
|
||||
|
||||
const db = new Database('./data/app.db', { create: true })
|
||||
db.exec('PRAGMA journal_mode = WAL;')
|
||||
|
||||
// Create todo table
|
||||
db.exec(`
|
||||
CREATE TABLE IF NOT EXISTS todo (
|
||||
id TEXT PRIMARY KEY,
|
||||
title TEXT NOT NULL,
|
||||
completed INTEGER NOT NULL DEFAULT 0,
|
||||
created_at INTEGER NOT NULL DEFAULT (unixepoch()),
|
||||
updated_at INTEGER NOT NULL DEFAULT (unixepoch())
|
||||
);
|
||||
`)
|
||||
|
||||
console.log('Database initialized successfully!')
|
||||
db.close()
|
||||
@@ -91,7 +91,7 @@ cargo clean
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
server-desktop/
|
||||
app-desktop/
|
||||
├── src/
|
||||
│ ├── main.rs # 入口文件 (仅调用 lib::run)
|
||||
│ ├── lib.rs # 核心应用逻辑 (注册插件、命令、状态)
|
||||
@@ -47,6 +47,17 @@ version = "1.0.100"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61"
|
||||
|
||||
[[package]]
|
||||
name = "app-desktop"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"serde",
|
||||
"tauri",
|
||||
"tauri-build",
|
||||
"tauri-plugin-shell",
|
||||
"tokio",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "atk"
|
||||
version = "0.18.2"
|
||||
@@ -2902,17 +2913,6 @@ dependencies = [
|
||||
"syn 2.0.114",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "server-desktop"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"serde",
|
||||
"tauri",
|
||||
"tauri-build",
|
||||
"tauri-plugin-shell",
|
||||
"tokio",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "servo_arc"
|
||||
version = "0.2.0"
|
||||
@@ -1,5 +1,5 @@
|
||||
[package]
|
||||
name = "server-desktop"
|
||||
name = "app-desktop"
|
||||
version = "0.1.0"
|
||||
description = "A Tauri App"
|
||||
authors = ["imbytecat"]
|
||||
@@ -11,7 +11,7 @@ edition = "2021"
|
||||
# The `_lib` suffix may seem redundant but it is necessary
|
||||
# to make the lib name unique and wouldn't conflict with the bin name.
|
||||
# This seems to be only an issue on Windows, see https://github.com/rust-lang/cargo/issues/8519
|
||||
name = "server_desktop_lib"
|
||||
name = "app_desktop_lib"
|
||||
crate-type = ["staticlib", "cdylib", "rlib"]
|
||||
|
||||
[build-dependencies]
|
||||
|
Before Width: | Height: | Size: 3.4 KiB After Width: | Height: | Size: 3.4 KiB |
|
Before Width: | Height: | Size: 6.8 KiB After Width: | Height: | Size: 6.8 KiB |
|
Before Width: | Height: | Size: 974 B After Width: | Height: | Size: 974 B |
|
Before Width: | Height: | Size: 2.8 KiB After Width: | Height: | Size: 2.8 KiB |
|
Before Width: | Height: | Size: 3.8 KiB After Width: | Height: | Size: 3.8 KiB |
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 3.9 KiB |
|
Before Width: | Height: | Size: 7.6 KiB After Width: | Height: | Size: 7.6 KiB |
|
Before Width: | Height: | Size: 903 B After Width: | Height: | Size: 903 B |
|
Before Width: | Height: | Size: 8.4 KiB After Width: | Height: | Size: 8.4 KiB |
|
Before Width: | Height: | Size: 1.3 KiB After Width: | Height: | Size: 1.3 KiB |
|
Before Width: | Height: | Size: 2.0 KiB After Width: | Height: | Size: 2.0 KiB |
|
Before Width: | Height: | Size: 2.4 KiB After Width: | Height: | Size: 2.4 KiB |
|
Before Width: | Height: | Size: 1.5 KiB After Width: | Height: | Size: 1.5 KiB |
|
Before Width: | Height: | Size: 85 KiB After Width: | Height: | Size: 85 KiB |
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
@@ -2,5 +2,5 @@
|
||||
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
|
||||
|
||||
fn main() {
|
||||
server_desktop_lib::run()
|
||||
app_desktop_lib::run()
|
||||
}
|
||||
@@ -86,7 +86,7 @@ pub fn spawn_sidecar(app_handle: tauri::AppHandle) {
|
||||
// 启动 sidecar
|
||||
let sidecar = app_handle
|
||||
.shell()
|
||||
.sidecar("server")
|
||||
.sidecar("app")
|
||||
.expect("无法找到 app")
|
||||
.env("PORT", port.to_string());
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"$schema": "https://schema.tauri.app/config/2",
|
||||
"productName": "server-desktop",
|
||||
"productName": "app-desktop",
|
||||
"version": "0.1.0",
|
||||
"identifier": "com.imbytecat.server-desktop",
|
||||
"identifier": "com.imbytecat.app-desktop",
|
||||
"app": {
|
||||
"withGlobalTauri": true,
|
||||
"windows": [],
|
||||
@@ -20,6 +20,6 @@
|
||||
"icons/icon.icns",
|
||||
"icons/icon.ico"
|
||||
],
|
||||
"externalBin": ["binaries/server"]
|
||||
"externalBin": ["binaries/app"]
|
||||
}
|
||||
}
|
||||
69
src/db/index.ts
Normal file
@@ -0,0 +1,69 @@
|
||||
/**
|
||||
* 数据库连接模块
|
||||
*
|
||||
* 使用 Bun 内置的 SQLite 驱动,无需额外安装原生模块。
|
||||
* 数据库文件存储在可执行文件同级的 data/app.db
|
||||
*/
|
||||
|
||||
import { Database } from 'bun:sqlite'
|
||||
import { existsSync, mkdirSync } from 'node:fs'
|
||||
import { dirname, join } from 'node:path'
|
||||
import { drizzle } from 'drizzle-orm/bun-sqlite'
|
||||
import * as schema from '@/db/schema'
|
||||
|
||||
/**
|
||||
* 获取数据库路径
|
||||
* - 在打包后的 sidecar 中,使用可执行文件所在目录
|
||||
* - 在开发模式下,使用项目根目录
|
||||
*/
|
||||
function getDbPath(): string {
|
||||
const execPath = process.execPath
|
||||
const isBundled = !execPath.includes('node') && !execPath.includes('bun')
|
||||
|
||||
const baseDir = isBundled ? dirname(execPath) : process.cwd()
|
||||
const dataDir = join(baseDir, 'data')
|
||||
|
||||
// 确保 data 目录存在
|
||||
if (!existsSync(dataDir)) {
|
||||
mkdirSync(dataDir, { recursive: true })
|
||||
}
|
||||
|
||||
return join(dataDir, 'app.db')
|
||||
}
|
||||
|
||||
/** 数据库文件路径 */
|
||||
const DB_PATH = getDbPath()
|
||||
|
||||
/**
|
||||
* 初始化数据库表结构
|
||||
*/
|
||||
function initTables(sqlite: Database) {
|
||||
sqlite.exec(`
|
||||
CREATE TABLE IF NOT EXISTS todo (
|
||||
id TEXT PRIMARY KEY,
|
||||
title TEXT NOT NULL,
|
||||
completed INTEGER NOT NULL DEFAULT 0,
|
||||
created_at INTEGER NOT NULL DEFAULT (unixepoch()),
|
||||
updated_at INTEGER NOT NULL DEFAULT (unixepoch())
|
||||
);
|
||||
`)
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建数据库连接
|
||||
*
|
||||
* 启用 WAL (Write-Ahead Logging) 模式以提高并发读写性能。
|
||||
* 如果数据库文件不存在,会自动创建并初始化表结构。
|
||||
*/
|
||||
export function createDb() {
|
||||
const sqlite = new Database(DB_PATH, { create: true })
|
||||
sqlite.exec('PRAGMA journal_mode = WAL;')
|
||||
|
||||
// 自动初始化表结构
|
||||
initTables(sqlite)
|
||||
|
||||
return drizzle(sqlite, { schema })
|
||||
}
|
||||
|
||||
/** 数据库实例类型 */
|
||||
export type Db = ReturnType<typeof createDb>
|
||||
33
src/db/schema/todo.ts
Normal file
@@ -0,0 +1,33 @@
|
||||
/**
|
||||
* Todo 表 Schema
|
||||
*
|
||||
* 使用 SQLite 数据类型:
|
||||
* - text: 字符串类型
|
||||
* - integer: 整数类型 (可配置为 boolean/timestamp 模式)
|
||||
*/
|
||||
import { sql } from 'drizzle-orm'
|
||||
import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
|
||||
|
||||
export const todoTable = sqliteTable('todo', {
|
||||
/** 主键 UUID */
|
||||
id: text('id')
|
||||
.primaryKey()
|
||||
.$defaultFn(() => crypto.randomUUID()),
|
||||
|
||||
/** 待办事项标题 */
|
||||
title: text('title').notNull(),
|
||||
|
||||
/** 是否已完成 (SQLite 用 0/1 表示布尔值) */
|
||||
completed: integer('completed', { mode: 'boolean' }).notNull().default(false),
|
||||
|
||||
/** 创建时间 (Unix 时间戳) */
|
||||
createdAt: integer('created_at', { mode: 'timestamp' })
|
||||
.notNull()
|
||||
.default(sql`(unixepoch())`),
|
||||
|
||||
/** 更新时间 (Unix 时间戳,自动更新) */
|
||||
updatedAt: integer('updated_at', { mode: 'timestamp' })
|
||||
.notNull()
|
||||
.default(sql`(unixepoch())`)
|
||||
.$onUpdateFn(() => new Date()),
|
||||
})
|
||||
@@ -2,9 +2,7 @@ import { createEnv } from '@t3-oss/env-core'
|
||||
import { z } from 'zod'
|
||||
|
||||
export const env = createEnv({
|
||||
server: {
|
||||
DATABASE_URL: z.url(),
|
||||
},
|
||||
server: {},
|
||||
clientPrefix: 'VITE_',
|
||||
client: {
|
||||
VITE_APP_TITLE: z.string().min(1).optional(),
|
||||
7
src/integrations/tanstack-query/devtools.tsx
Normal file
@@ -0,0 +1,7 @@
|
||||
import type { TanStackDevtoolsReactPlugin } from '@tanstack/react-devtools'
|
||||
import { ReactQueryDevtoolsPanel } from '@tanstack/react-query-devtools'
|
||||
|
||||
export const devtools = {
|
||||
name: 'TanStack Query',
|
||||
render: <ReactQueryDevtoolsPanel />,
|
||||
} satisfies TanStackDevtoolsReactPlugin
|
||||
1
src/integrations/tanstack-query/index.ts
Normal file
@@ -0,0 +1 @@
|
||||
export * from './devtools'
|
||||
7
src/integrations/tanstack-router/devtools.tsx
Normal file
@@ -0,0 +1,7 @@
|
||||
import type { TanStackDevtoolsReactPlugin } from '@tanstack/react-devtools'
|
||||
import { TanStackRouterDevtoolsPanel } from '@tanstack/react-router-devtools'
|
||||
|
||||
export const devtools = {
|
||||
name: 'TanStack Router',
|
||||
render: <TanStackRouterDevtoolsPanel />,
|
||||
} satisfies TanStackDevtoolsReactPlugin
|
||||
1
src/integrations/tanstack-router/index.ts
Normal file
@@ -0,0 +1 @@
|
||||
export * from './devtools'
|
||||
0
src/lib/utils.ts
Normal file
84
src/orpc/client.ts
Normal file
@@ -0,0 +1,84 @@
|
||||
/**
|
||||
* ORPC 同构客户端
|
||||
*
|
||||
* 根据运行环境自动选择最优调用方式:
|
||||
* - SSR (服务端): 直接调用 router,无 HTTP 开销
|
||||
* - CSR (客户端): 通过 /api/rpc 端点 HTTP 调用
|
||||
*
|
||||
* 同时配置了 TanStack Query 集成,mutation 成功后自动刷新相关查询。
|
||||
*/
|
||||
import { createORPCClient } from '@orpc/client'
|
||||
import { RPCLink } from '@orpc/client/fetch'
|
||||
import { createRouterClient } from '@orpc/server'
|
||||
import { createTanstackQueryUtils } from '@orpc/tanstack-query'
|
||||
import { createIsomorphicFn } from '@tanstack/react-start'
|
||||
import { getRequestHeaders } from '@tanstack/react-start/server'
|
||||
import { router } from './router'
|
||||
import type { RouterClient } from './types'
|
||||
|
||||
/**
|
||||
* 创建同构 ORPC 客户端
|
||||
*
|
||||
* 服务端: 直接调用路由处理器
|
||||
* 客户端: 通过 HTTP 调用 /api/rpc 端点
|
||||
*/
|
||||
const getORPCClient = createIsomorphicFn()
|
||||
.server(() =>
|
||||
createRouterClient(router, {
|
||||
context: () => ({
|
||||
headers: getRequestHeaders(),
|
||||
}),
|
||||
}),
|
||||
)
|
||||
.client(() => {
|
||||
const link = new RPCLink({
|
||||
url: `${window.location.origin}/api/rpc`,
|
||||
})
|
||||
return createORPCClient<RouterClient>(link)
|
||||
})
|
||||
|
||||
const client: RouterClient = getORPCClient()
|
||||
|
||||
/**
|
||||
* ORPC + TanStack Query 工具
|
||||
*
|
||||
* 使用方式:
|
||||
* ```tsx
|
||||
* // 查询
|
||||
* const { data } = useSuspenseQuery(orpc.todo.list.queryOptions())
|
||||
*
|
||||
* // 变更
|
||||
* const mutation = useMutation(orpc.todo.create.mutationOptions())
|
||||
* mutation.mutate({ title: '新任务' })
|
||||
* ```
|
||||
*
|
||||
* 配置了自动缓存失效: 创建/更新/删除操作后自动刷新列表
|
||||
*/
|
||||
export const orpc = createTanstackQueryUtils(client, {
|
||||
// 配置 mutation 成功后自动刷新相关查询
|
||||
experimental_defaults: {
|
||||
todo: {
|
||||
create: {
|
||||
mutationOptions: {
|
||||
onSuccess: (_, __, ___, ctx) => {
|
||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||
},
|
||||
},
|
||||
},
|
||||
update: {
|
||||
mutationOptions: {
|
||||
onSuccess: (_, __, ___, ctx) => {
|
||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||
},
|
||||
},
|
||||
},
|
||||
remove: {
|
||||
mutationOptions: {
|
||||
onSuccess: (_, __, ___, ctx) => {
|
||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
})
|
||||
5
src/orpc/contract.ts
Normal file
@@ -0,0 +1,5 @@
|
||||
import * as todo from './contracts/todo'
|
||||
|
||||
export const contract = {
|
||||
todo,
|
||||
}
|
||||
@@ -1,3 +1,9 @@
|
||||
/**
|
||||
* Todo API 契约
|
||||
*
|
||||
* 使用 ORPC 契约定义 API 的输入/输出类型。
|
||||
* drizzle-zod 自动从表 schema 生成验证规则。
|
||||
*/
|
||||
import { oc } from '@orpc/contract'
|
||||
import {
|
||||
createInsertSchema,
|
||||
@@ -5,26 +11,36 @@ import {
|
||||
createUpdateSchema,
|
||||
} from 'drizzle-zod'
|
||||
import { z } from 'zod'
|
||||
import { todoTable } from '@/server/db/schema'
|
||||
import { todoTable } from '@/db/schema'
|
||||
|
||||
/** 查询返回的完整 Todo 类型 */
|
||||
const selectSchema = createSelectSchema(todoTable)
|
||||
|
||||
/** 创建 Todo 时的输入类型 (排除自动生成的字段) */
|
||||
const insertSchema = createInsertSchema(todoTable).omit({
|
||||
id: true,
|
||||
createdAt: true,
|
||||
updatedAt: true,
|
||||
})
|
||||
|
||||
/** 更新 Todo 时的输入类型 (所有字段可选) */
|
||||
const updateSchema = createUpdateSchema(todoTable).omit({
|
||||
id: true,
|
||||
createdAt: true,
|
||||
updatedAt: true,
|
||||
})
|
||||
|
||||
// ============================================================
|
||||
// API 契约定义
|
||||
// ============================================================
|
||||
|
||||
/** 获取所有 Todo */
|
||||
export const list = oc.input(z.void()).output(z.array(selectSchema))
|
||||
|
||||
/** 创建新 Todo */
|
||||
export const create = oc.input(insertSchema).output(selectSchema)
|
||||
|
||||
/** 更新 Todo */
|
||||
export const update = oc
|
||||
.input(
|
||||
z.object({
|
||||
@@ -34,6 +50,7 @@ export const update = oc
|
||||
)
|
||||
.output(selectSchema)
|
||||
|
||||
/** 删除 Todo */
|
||||
export const remove = oc
|
||||
.input(
|
||||
z.object({
|
||||
@@ -1,18 +1,36 @@
|
||||
/**
|
||||
* Todo API 处理器
|
||||
*
|
||||
* 实现 Todo CRUD 操作的业务逻辑。
|
||||
* 每个处理器都使用 dbProvider 中间件获取数据库连接。
|
||||
*/
|
||||
import { ORPCError } from '@orpc/server'
|
||||
import { eq } from 'drizzle-orm'
|
||||
import { todoTable } from '@/server/db/schema'
|
||||
import { db } from '../middlewares'
|
||||
import { os } from '../server'
|
||||
import { todoTable } from '@/db/schema'
|
||||
import { dbProvider } from '@/orpc/middlewares'
|
||||
import { os } from '@/orpc/server'
|
||||
|
||||
export const list = os.todo.list.use(db).handler(async ({ context }) => {
|
||||
/**
|
||||
* 获取所有 Todo
|
||||
*
|
||||
* 按创建时间倒序排列 (最新的在前)
|
||||
*/
|
||||
export const list = os.todo.list
|
||||
.use(dbProvider)
|
||||
.handler(async ({ context }) => {
|
||||
const todos = await context.db.query.todoTable.findMany({
|
||||
orderBy: (todos, { desc }) => [desc(todos.createdAt)],
|
||||
})
|
||||
return todos
|
||||
})
|
||||
|
||||
/**
|
||||
* 创建新 Todo
|
||||
*
|
||||
* @throws ORPCError NOT_FOUND - 创建失败时
|
||||
*/
|
||||
export const create = os.todo.create
|
||||
.use(db)
|
||||
.use(dbProvider)
|
||||
.handler(async ({ context, input }) => {
|
||||
const [newTodo] = await context.db
|
||||
.insert(todoTable)
|
||||
@@ -26,8 +44,13 @@ export const create = os.todo.create
|
||||
return newTodo
|
||||
})
|
||||
|
||||
/**
|
||||
* 更新 Todo
|
||||
*
|
||||
* @throws ORPCError NOT_FOUND - Todo 不存在时
|
||||
*/
|
||||
export const update = os.todo.update
|
||||
.use(db)
|
||||
.use(dbProvider)
|
||||
.handler(async ({ context, input }) => {
|
||||
const [updatedTodo] = await context.db
|
||||
.update(todoTable)
|
||||
@@ -42,8 +65,11 @@ export const update = os.todo.update
|
||||
return updatedTodo
|
||||
})
|
||||
|
||||
/**
|
||||
* 删除 Todo
|
||||
*/
|
||||
export const remove = os.todo.remove
|
||||
.use(db)
|
||||
.use(dbProvider)
|
||||
.handler(async ({ context, input }) => {
|
||||
await context.db.delete(todoTable).where(eq(todoTable.id, input.id))
|
||||
})
|
||||
2
src/orpc/index.ts
Normal file
@@ -0,0 +1,2 @@
|
||||
export { orpc } from './client'
|
||||
export * from './types'
|
||||
48
src/orpc/middlewares/db.ts
Normal file
@@ -0,0 +1,48 @@
|
||||
/**
|
||||
* 数据库中间件
|
||||
*
|
||||
* 为 ORPC 处理器提供数据库连接。使用单例模式管理连接,
|
||||
* 避免每次请求都创建新连接。
|
||||
*/
|
||||
import { os } from '@orpc/server'
|
||||
import { createDb, type Db } from '@/db'
|
||||
|
||||
/** 全局数据库实例 (单例模式) */
|
||||
let globalDb: Db | null = null
|
||||
|
||||
/**
|
||||
* 获取数据库实例
|
||||
*
|
||||
* 首次调用时创建连接,后续调用返回同一实例。
|
||||
* 这种模式适合长时间运行的服务器进程。
|
||||
*/
|
||||
function getDb(): Db {
|
||||
if (!globalDb) {
|
||||
globalDb = createDb()
|
||||
}
|
||||
return globalDb
|
||||
}
|
||||
|
||||
/**
|
||||
* 数据库提供者中间件
|
||||
*
|
||||
* 使用方式:
|
||||
* ```ts
|
||||
* export const list = os.todo.list
|
||||
* .use(dbProvider)
|
||||
* .handler(async ({ context }) => {
|
||||
* // context.db 可用
|
||||
* return context.db.query.todoTable.findMany()
|
||||
* })
|
||||
* ```
|
||||
*/
|
||||
export const dbProvider = os.middleware(async ({ context, next }) => {
|
||||
const db = getDb()
|
||||
|
||||
return next({
|
||||
context: {
|
||||
...context,
|
||||
db,
|
||||
},
|
||||
})
|
||||
})
|
||||
1
src/orpc/middlewares/index.ts
Normal file
@@ -0,0 +1 @@
|
||||
export * from './db'
|
||||
6
src/orpc/router.ts
Normal file
@@ -0,0 +1,6 @@
|
||||
import * as todo from './handlers/todo'
|
||||
import { os } from './server'
|
||||
|
||||
export const router = os.router({
|
||||
todo,
|
||||
})
|
||||
7
src/orpc/server.ts
Normal file
@@ -0,0 +1,7 @@
|
||||
import { implement } from '@orpc/server'
|
||||
import { contract } from './contract'
|
||||
|
||||
// biome-ignore lint/complexity/noBannedTypes: 暂无 context
|
||||
export type ORPCContext = {}
|
||||
|
||||
export const os = implement(contract).$context<ORPCContext>()
|
||||
@@ -3,8 +3,9 @@ import type {
|
||||
InferContractRouterInputs,
|
||||
InferContractRouterOutputs,
|
||||
} from '@orpc/contract'
|
||||
import type { Contract } from './contracts'
|
||||
import type { contract } from './contract'
|
||||
|
||||
export type Contract = typeof contract
|
||||
export type RouterClient = ContractRouterClient<Contract>
|
||||
export type RouterInputs = InferContractRouterInputs<Contract>
|
||||
export type RouterOutputs = InferContractRouterOutputs<Contract>
|
||||
@@ -10,7 +10,6 @@
|
||||
|
||||
import { Route as rootRouteImport } from './routes/__root'
|
||||
import { Route as IndexRouteImport } from './routes/index'
|
||||
import { Route as ApiSplatRouteImport } from './routes/api/$'
|
||||
import { Route as ApiRpcSplatRouteImport } from './routes/api/rpc.$'
|
||||
|
||||
const IndexRoute = IndexRouteImport.update({
|
||||
@@ -18,11 +17,6 @@ const IndexRoute = IndexRouteImport.update({
|
||||
path: '/',
|
||||
getParentRoute: () => rootRouteImport,
|
||||
} as any)
|
||||
const ApiSplatRoute = ApiSplatRouteImport.update({
|
||||
id: '/api/$',
|
||||
path: '/api/$',
|
||||
getParentRoute: () => rootRouteImport,
|
||||
} as any)
|
||||
const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
|
||||
id: '/api/rpc/$',
|
||||
path: '/api/rpc/$',
|
||||
@@ -31,31 +25,27 @@ const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
|
||||
|
||||
export interface FileRoutesByFullPath {
|
||||
'/': typeof IndexRoute
|
||||
'/api/$': typeof ApiSplatRoute
|
||||
'/api/rpc/$': typeof ApiRpcSplatRoute
|
||||
}
|
||||
export interface FileRoutesByTo {
|
||||
'/': typeof IndexRoute
|
||||
'/api/$': typeof ApiSplatRoute
|
||||
'/api/rpc/$': typeof ApiRpcSplatRoute
|
||||
}
|
||||
export interface FileRoutesById {
|
||||
__root__: typeof rootRouteImport
|
||||
'/': typeof IndexRoute
|
||||
'/api/$': typeof ApiSplatRoute
|
||||
'/api/rpc/$': typeof ApiRpcSplatRoute
|
||||
}
|
||||
export interface FileRouteTypes {
|
||||
fileRoutesByFullPath: FileRoutesByFullPath
|
||||
fullPaths: '/' | '/api/$' | '/api/rpc/$'
|
||||
fullPaths: '/' | '/api/rpc/$'
|
||||
fileRoutesByTo: FileRoutesByTo
|
||||
to: '/' | '/api/$' | '/api/rpc/$'
|
||||
id: '__root__' | '/' | '/api/$' | '/api/rpc/$'
|
||||
to: '/' | '/api/rpc/$'
|
||||
id: '__root__' | '/' | '/api/rpc/$'
|
||||
fileRoutesById: FileRoutesById
|
||||
}
|
||||
export interface RootRouteChildren {
|
||||
IndexRoute: typeof IndexRoute
|
||||
ApiSplatRoute: typeof ApiSplatRoute
|
||||
ApiRpcSplatRoute: typeof ApiRpcSplatRoute
|
||||
}
|
||||
|
||||
@@ -68,13 +58,6 @@ declare module '@tanstack/react-router' {
|
||||
preLoaderRoute: typeof IndexRouteImport
|
||||
parentRoute: typeof rootRouteImport
|
||||
}
|
||||
'/api/$': {
|
||||
id: '/api/$'
|
||||
path: '/api/$'
|
||||
fullPath: '/api/$'
|
||||
preLoaderRoute: typeof ApiSplatRouteImport
|
||||
parentRoute: typeof rootRouteImport
|
||||
}
|
||||
'/api/rpc/$': {
|
||||
id: '/api/rpc/$'
|
||||
path: '/api/rpc/$'
|
||||
@@ -87,7 +70,6 @@ declare module '@tanstack/react-router' {
|
||||
|
||||
const rootRouteChildren: RootRouteChildren = {
|
||||
IndexRoute: IndexRoute,
|
||||
ApiSplatRoute: ApiSplatRoute,
|
||||
ApiRpcSplatRoute: ApiRpcSplatRoute,
|
||||
}
|
||||
export const routeTree = rootRouteImport
|
||||
@@ -1,15 +1,15 @@
|
||||
import { TanStackDevtools } from '@tanstack/react-devtools'
|
||||
import type { QueryClient } from '@tanstack/react-query'
|
||||
import { ReactQueryDevtoolsPanel } from '@tanstack/react-query-devtools'
|
||||
import {
|
||||
createRootRouteWithContext,
|
||||
HeadContent,
|
||||
Scripts,
|
||||
} from '@tanstack/react-router'
|
||||
import { TanStackRouterDevtoolsPanel } from '@tanstack/react-router-devtools'
|
||||
import type { ReactNode } from 'react'
|
||||
import { ErrorComponent } from '@/components/Error'
|
||||
import { NotFoundComponent } from '@/components/NotFount'
|
||||
import { devtools as queryDevtools } from '@/integrations/tanstack-query'
|
||||
import { devtools as routerDevtools } from '@/integrations/tanstack-router'
|
||||
import appCss from '@/styles.css?url'
|
||||
|
||||
export interface RouterContext {
|
||||
@@ -27,7 +27,7 @@ export const Route = createRootRouteWithContext<RouterContext>()({
|
||||
content: 'width=device-width, initial-scale=1',
|
||||
},
|
||||
{
|
||||
title: 'Furtherverse',
|
||||
title: 'Fullstack Starter',
|
||||
},
|
||||
],
|
||||
links: [
|
||||
@@ -54,16 +54,7 @@ function RootDocument({ children }: Readonly<{ children: ReactNode }>) {
|
||||
config={{
|
||||
position: 'bottom-right',
|
||||
}}
|
||||
plugins={[
|
||||
{
|
||||
name: 'TanStack Router',
|
||||
render: <TanStackRouterDevtoolsPanel />,
|
||||
},
|
||||
{
|
||||
name: 'TanStack Query',
|
||||
render: <ReactQueryDevtoolsPanel />,
|
||||
},
|
||||
]}
|
||||
plugins={[routerDevtools, queryDevtools]}
|
||||
/>
|
||||
<Scripts />
|
||||
</body>
|
||||
@@ -2,7 +2,7 @@ import { ORPCError, onError, ValidationError } from '@orpc/server'
|
||||
import { RPCHandler } from '@orpc/server/fetch'
|
||||
import { createFileRoute } from '@tanstack/react-router'
|
||||
import { z } from 'zod'
|
||||
import { router } from '@/server/api/routers'
|
||||
import { router } from '@/orpc/router'
|
||||
|
||||
const handler = new RPCHandler(router, {
|
||||
interceptors: [
|
||||
@@ -49,9 +49,7 @@ export const Route = createFileRoute('/api/rpc/$')({
|
||||
ANY: async ({ request }) => {
|
||||
const { response } = await handler.handle(request, {
|
||||
prefix: '/api/rpc',
|
||||
context: {
|
||||
headers: request.headers,
|
||||
},
|
||||
context: {},
|
||||
})
|
||||
|
||||
return response ?? new Response('Not Found', { status: 404 })
|
||||
@@ -4,7 +4,7 @@ import { isTauri } from '@tauri-apps/api/core'
|
||||
import { getCurrentWindow } from '@tauri-apps/api/window'
|
||||
import type { ChangeEventHandler, FormEventHandler } from 'react'
|
||||
import { useEffect, useState } from 'react'
|
||||
import { orpc } from '@/client/query-client'
|
||||
import { orpc } from '@/orpc'
|
||||
|
||||
export const Route = createFileRoute('/')({
|
||||
component: Todos,
|
||||
34
tsconfig.json
Normal file
@@ -0,0 +1,34 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
// Environment setup & latest features
|
||||
"lib": ["ESNext", "DOM", "DOM.Iterable"],
|
||||
"target": "ESNext",
|
||||
"module": "Preserve",
|
||||
"moduleDetection": "force",
|
||||
"jsx": "react-jsx",
|
||||
"allowJs": true,
|
||||
|
||||
// Bundler mode
|
||||
"moduleResolution": "bundler",
|
||||
"allowImportingTsExtensions": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"noEmit": true,
|
||||
|
||||
// Best practices
|
||||
"strict": true,
|
||||
"skipLibCheck": true,
|
||||
"noFallthroughCasesInSwitch": true,
|
||||
"noUncheckedIndexedAccess": true,
|
||||
"noImplicitOverride": true,
|
||||
|
||||
// Some stricter flags (disabled by default)
|
||||
"noUnusedLocals": false,
|
||||
"noUnusedParameters": false,
|
||||
"noPropertyAccessFromIndexSignature": false,
|
||||
|
||||
"baseUrl": ".",
|
||||
"paths": {
|
||||
"@/*": ["./src/*"]
|
||||
}
|
||||
}
|
||||
}
|
||||
34
turbo.json
@@ -1,31 +1,31 @@
|
||||
{
|
||||
"$schema": "./node_modules/turbo/schema.json",
|
||||
"dangerouslyDisablePackageManagerCheck": true,
|
||||
"globalDependencies": [
|
||||
"package.json",
|
||||
"bun.lock",
|
||||
"turbo.json",
|
||||
"biome.json"
|
||||
],
|
||||
"tasks": {
|
||||
"build": {
|
||||
"outputs": ["dist/**", ".output/**"]
|
||||
"build:compile": {
|
||||
"dependsOn": ["build:vite"],
|
||||
"outputs": ["out/**", "src-tauri/binaries/**"]
|
||||
},
|
||||
"compile": {
|
||||
"dependsOn": ["build"],
|
||||
"outputs": ["out/**"]
|
||||
"build:tauri": {
|
||||
"dependsOn": ["build:compile"],
|
||||
"outputs": ["src-tauri/target/release/bundle/**"]
|
||||
},
|
||||
"build:vite": {
|
||||
"outputs": [".output/**"]
|
||||
},
|
||||
"dev": {
|
||||
"cache": false,
|
||||
"persistent": true
|
||||
},
|
||||
"fix": {
|
||||
"outputs": []
|
||||
"dev:tauri": {
|
||||
"cache": false,
|
||||
"dependsOn": ["build:compile"],
|
||||
"persistent": true,
|
||||
"with": ["dev:vite"]
|
||||
},
|
||||
"typecheck": {
|
||||
"dependsOn": ["^typecheck"],
|
||||
"inputs": ["tsconfig.json", "tsconfig.*.json", "**/*.{ts,tsx}"],
|
||||
"outputs": []
|
||||
"dev:vite": {
|
||||
"cache": false,
|
||||
"persistent": true
|
||||
}
|
||||
},
|
||||
"ui": "tui"
|
||||
|
||||