@oyolincc/create 0.0.0-dev-20260513130832 → 0.0.0-dev-20260922064135

package/templates/hono-fullstack/apps/stack/frontend/modules/example/components/ExamplePage.tsx

@@ -0,0 +1,59 @@
+import { useAtom } from 'jotai'
+import type { FormEvent } from 'react'
+import { useCreateExample, useExamples, useProcessExample } from '../hooks/api-hooks'
+import { exampleMessageAtom } from '../stores'
+
+export function ExamplePage() {
+  const [message, setMessage] = useAtom(exampleMessageAtom)
+  const examples = useExamples()
+  const create = useCreateExample()
+  const process = useProcessExample()
+
+  const submit = async (event: FormEvent) => {
+    event.preventDefault()
+    await create.mutateAsync({ message })
+    setMessage('')
+  }
+
+  return (
+    <main className="mx-auto flex min-h-screen max-w-2xl flex-col gap-6 p-8">
+      <header>
+        <h1 className="text-3xl font-bold">Example workspace</h1>
+        <p className="text-zinc-400">Nitro mounts the independent Hono server under /api.</p>
+      </header>
+      <form className="flex gap-2" onSubmit={submit}>
+        <input
+          className="min-w-0 flex-1 rounded border border-zinc-700 bg-zinc-900 px-3 py-2"
+          value={message}
+          onChange={(event) => setMessage(event.target.value)}
+          placeholder="Message"
+        />
+        <button
+          className="rounded bg-blue-600 px-4 py-2"
+          disabled={!message.trim() || create.isPending}>
+          Save
+        </button>
+        <button
+          className="rounded bg-emerald-600 px-4 py-2"
+          type="button"
+          disabled={!message.trim() || process.isPending}
+          onClick={() => process.mutate({ message })}>
+          Process
+        </button>
+      </form>
+      {process.data && (
+        <pre className="rounded bg-zinc-900 p-4">{JSON.stringify(process.data, null, 2)}</pre>
+      )}
+      {(create.error || process.error || examples.error) && (
+        <p className="text-red-400">{String(create.error || process.error || examples.error)}</p>
+      )}
+      <ul className="grid gap-2">
+        {examples.data?.map((example) => (
+          <li className="rounded border border-zinc-800 p-3" key={example.id}>
+            {example.message}
+          </li>
+        ))}
+      </ul>
+    </main>
+  )
+}

package/templates/hono-fullstack/apps/stack/frontend/modules/example/hooks/api-hooks.ts

@@ -0,0 +1,14 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
+import { createExample, listExamples, processExample } from '../api'
+
+export const exampleQueryKey = ['examples'] as const
+
+export const useExamples = () => useQuery({ queryKey: exampleQueryKey, queryFn: listExamples })
+export function useCreateExample() {
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: createExample,
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: exampleQueryKey }),
+  })
+}
+export const useProcessExample = () => useMutation({ mutationFn: processExample })

package/templates/hono-fullstack/apps/stack/frontend/modules/example/stores/index.ts

@@ -0,0 +1,3 @@
+import { atom } from 'jotai'
+
+export const exampleMessageAtom = atom('')

package/templates/hono-fullstack/apps/stack/frontend/routeTree.gen.ts

@@ -0,0 +1,56 @@
+/* eslint-disable */
+// @ts-nocheck
+// This file was automatically generated by TanStack Router.
+import { Route as rootRouteImport } from './routes/__root'
+import { Route as IndexRouteImport } from './routes/index'
+
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+export interface FileRoutesByFullPath {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesByTo {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/': typeof IndexRoute
+}
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths: '/'
+  fileRoutesByTo: FileRoutesByTo
+  to: '/'
+  id: '__root__' | '/'
+  fileRoutesById: FileRoutesById
+}
+export interface RootRouteChildren {
+  IndexRoute: typeof IndexRoute
+}
+declare module '@tanstack/react-router' {
+  interface FileRoutesByPath {
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+  }
+}
+const rootRouteChildren: RootRouteChildren = { IndexRoute }
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()
+
+import type { getRouter } from './router.tsx'
+declare module '@tanstack/react-start' {
+  interface Register {
+    ssr: true
+    router: Awaited<ReturnType<typeof getRouter>>
+  }
+}

package/templates/hono-fullstack/apps/stack/frontend/router.tsx

@@ -0,0 +1,22 @@
+import { QueryClient } from '@tanstack/react-query'
+import { createRouter as createTanStackRouter } from '@tanstack/react-router'
+import { createStore } from 'jotai'
+import { routeTree } from './routeTree.gen'
+
+export function getRouter() {
+  const queryClient = new QueryClient()
+  const store = createStore()
+  return createTanStackRouter({
+    routeTree,
+    context: { queryClient, store },
+    scrollRestoration: true,
+    defaultPreload: 'intent',
+    defaultPreloadStaleTime: 0,
+  })
+}
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: ReturnType<typeof getRouter>
+  }
+}

package/templates/hono-fullstack/apps/stack/frontend/routes/__root.tsx

@@ -0,0 +1,61 @@
+import type { QueryClient } from '@tanstack/react-query'
+import { QueryClientProvider } from '@tanstack/react-query'
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools'
+import {
+  HeadContent,
+  Navigate,
+  Outlet,
+  Scripts,
+  createRootRouteWithContext,
+} from '@tanstack/react-router'
+import { TanStackRouterDevtools } from '@tanstack/react-router-devtools'
+import { Provider as JotaiProvider, type createStore } from 'jotai'
+import appCss from '../styles.css?url'
+
+export const Route = createRootRouteWithContext<{
+  queryClient: QueryClient
+  store: ReturnType<typeof createStore>
+}>()({
+  head: () => ({
+    meta: [
+      { charSet: 'utf-8' },
+      { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+      { title: 'Hono fullstack' },
+    ],
+    links: [{ rel: 'stylesheet', href: appCss }],
+  }),
+  component: RootComponent,
+  notFoundComponent: () => <Navigate to="/" />,
+  shellComponent: RootDocument,
+})
+
+function RootComponent() {
+  const { queryClient, store } = Route.useRouteContext()
+  return (
+    <QueryClientProvider client={queryClient}>
+      <JotaiProvider store={store}>
+        <Outlet />
+      </JotaiProvider>
+      {import.meta.env.DEV && (
+        <>
+          <ReactQueryDevtools buttonPosition="bottom-left" />
+          <TanStackRouterDevtools position="bottom-right" />
+        </>
+      )}
+    </QueryClientProvider>
+  )
+}
+
+function RootDocument({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" className="dark">
+      <head>
+        <HeadContent />
+      </head>
+      <body>
+        {children}
+        <Scripts />
+      </body>
+    </html>
+  )
+}

package/templates/hono-fullstack/apps/stack/frontend/routes/index.tsx

@@ -0,0 +1,4 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { ExamplePage } from '#/modules/example/components/ExamplePage'
+
+export const Route = createFileRoute('/')({ component: ExamplePage })

package/templates/hono-fullstack/apps/stack/frontend/shared/network/client.ts

@@ -0,0 +1,19 @@
+import ky, { HTTPError, type Options } from 'ky'
+import { NetworkDefaults } from './constants'
+import { parseApiError } from './errors'
+
+const client = ky.create({
+  prefix: NetworkDefaults.API_PREFIX,
+  timeout: NetworkDefaults.TIMEOUT,
+  retry: 0,
+})
+
+export async function request<T>(path: string, options?: Options) {
+  try {
+    const response = await client(path, options).json<{ data: T }>()
+    return response.data
+  } catch (error) {
+    if (error instanceof HTTPError) throw await parseApiError(error)
+    throw error
+  }
+}

package/templates/hono-fullstack/apps/stack/frontend/shared/network/constants.ts

@@ -0,0 +1 @@
+export const NetworkDefaults = Object.freeze({ API_PREFIX: '/api', TIMEOUT: 15_000 })

package/templates/hono-fullstack/apps/stack/frontend/shared/network/errors.ts

@@ -0,0 +1,33 @@
+import type { HTTPError } from 'ky'
+
+export type ProblemDetails = {
+  type?: string
+  title?: string
+  status?: number
+  detail?: string
+  message?: string
+  extensions?: Record<string, unknown>
+  [key: string]: unknown
+}
+
+export class ApiError extends Error {
+  constructor(
+    public readonly problem: ProblemDetails,
+    options?: ErrorOptions,
+  ) {
+    super(problem.detail || problem.message || problem.title || 'Request failed', options)
+    this.name = 'ApiError'
+  }
+  get status() {
+    return this.problem.status
+  }
+}
+
+export const isApiError = (error: unknown, status?: number): error is ApiError =>
+  error instanceof ApiError && (status === undefined || error.status === status)
+
+export async function parseApiError(error: HTTPError) {
+  const fallback = { title: error.response.statusText }
+  const problem = await error.response.json<ProblemDetails>().catch(() => fallback)
+  return new ApiError({ ...problem, status: error.response.status }, { cause: error })
+}

package/templates/hono-fullstack/apps/stack/frontend/styles.css

@@ -0,0 +1,23 @@
+@import 'tailwindcss';
+@custom-variant dark (&:where(.dark, .dark *));
+
+html,
+body {
+  min-height: 100%;
+  margin: 0;
+}
+html.dark {
+  color-scheme: dark;
+}
+body {
+  background: #18181b;
+  color: #e4e4e7;
+  font-family: ui-sans-serif, system-ui, sans-serif;
+}
+button {
+  cursor: pointer;
+}
+button:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}

package/templates/hono-fullstack/apps/stack/frontend/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/templates/hono-fullstack/apps/stack/nitro/handlers/hono.ts

@@ -0,0 +1 @@
+export { default } from '@repo/server/node'

package/templates/hono-fullstack/apps/stack/nitro/plugins/hono.ts

@@ -0,0 +1,9 @@
+import { definePlugin } from 'nitro'
+import { exampleWorkRunner, sqliteClient } from '@repo/server/node'
+
+export default definePlugin((nitro) => {
+  nitro.hooks.hook('close', async () => {
+    await exampleWorkRunner.shutdown()
+    sqliteClient.close()
+  })
+})

package/templates/hono-fullstack/apps/stack/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@repo/stack",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "oyo env server -- vp dev",
+    "dev:chain": "turbo watch dev --filter=@repo/stack",
+    "generate-routes": "tsr generate",
+    "build": "vp build",
+    "preview": "oyo env server -- vp preview",
+    "test": "vp test",
+    "check": "vp check"
+  },
+  "dependencies": {
+    "@repo/definition": "workspace:*",
+    "@repo/server": "workspace:*",
+    "@tanstack/react-query": "catalog:frontend",
+    "@tanstack/react-router": "catalog:frontend",
+    "@tanstack/react-start": "catalog:frontend",
+    "jotai": "catalog:frontend",
+    "ky": "catalog:shared",
+    "nitro": "catalog:",
+    "react": "catalog:frontend",
+    "react-dom": "catalog:frontend"
+  },
+  "devDependencies": {
+    "@oyolincc/cli": "catalog:",
+    "@oyolincc/dev-config": "catalog:",
+    "@rollup/pluginutils": "catalog:",
+    "@tailwindcss/vite": "catalog:frontend",
+    "@tanstack/react-query-devtools": "catalog:frontend",
+    "@tanstack/react-router-devtools": "catalog:frontend",
+    "@tanstack/router-cli": "catalog:frontend",
+    "@types/node": "catalog:",
+    "@types/react": "catalog:frontend",
+    "@types/react-dom": "catalog:frontend",
+    "@vitejs/plugin-react": "catalog:",
+    "fast-glob": "catalog:",
+    "tailwindcss": "catalog:frontend",
+    "typescript": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}

package/templates/hono-fullstack/apps/stack/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "@oyolincc/dev-config/tsconfig.frontend.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "paths": {
+      "#/*": ["./frontend/*"],
+      "@/*": ["./nitro/*"]
+    }
+  },
+  "files": [],
+  "include": ["frontend", "nitro", "./*.ts", "./*.mts"]
+}

package/templates/hono-fullstack/apps/stack/tsr.config.json

@@ -0,0 +1,5 @@
+{
+  "target": "react",
+  "routesDirectory": "./frontend/routes",
+  "generatedRouteTree": "./frontend/routeTree.gen.ts"
+}

package/templates/hono-fullstack/apps/stack/vite.config.ts

@@ -0,0 +1,33 @@
+import { defineConfig } from 'vite-plus'
+import { tanstackStart } from '@tanstack/react-start/plugin/vite'
+import tailwindcss from '@tailwindcss/vite'
+import viteReact from '@vitejs/plugin-react'
+import { nitro } from 'nitro/vite'
+
+export default defineConfig({
+  server: {
+    port: 3000,
+    warmup: {
+      clientFiles: ['./frontend/router.tsx'],
+      ssrFiles: ['./frontend/router.tsx'],
+    },
+  },
+  resolve: { tsconfigPaths: true },
+  optimizeDeps: { include: ['@repo/definition/frontend'] },
+  plugins: [
+    nitro({
+      serverDir: './nitro',
+      handlers: [
+        {
+          route: '/api/**',
+          handler: './nitro/handlers/hono.ts',
+          middleware: false,
+          lazy: false,
+        },
+      ],
+    }),
+    tanstackStart({ srcDirectory: './frontend' }),
+    tailwindcss(),
+    viteReact(),
+  ],
+})

package/templates/hono-fullstack/docs/agents/domain.md

@@ -0,0 +1,41 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT-MAP.md`** at the repo root. It points at the `CONTEXT.md` file for each relevant app or library context; read the entries relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in.
+- Context-specific `docs/adr/` directories — check the ADR directory alongside the relevant context when one exists.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The `/domain-modeling` skill (reached via `/grill-with-docs` and `/improve-codebase-architecture`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+This repo uses a multi-context layout:
+
+```text
+/
+├── CONTEXT-MAP.md                  ← index of all contexts
+├── docs/adr/                       ← system-wide decisions
+├── apps/
+│   └── <app>/
+│       ├── CONTEXT.md
+│       └── docs/adr/               ← app-specific decisions
+└── libs/
+    └── <library>/
+        ├── CONTEXT.md
+        └── docs/adr/               ← library-specific decisions
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in the relevant context's `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the relevant glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/domain-modeling`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_

package/templates/hono-fullstack/docs/agents/issue-tracker.md

@@ -0,0 +1,30 @@
+# Issue tracker: Local Markdown
+
+Issues and specs for this repo live as markdown files in `.scratch/`.
+
+## Conventions
+
+- One feature per directory: `.scratch/<feature-slug>/`
+- The spec is `.scratch/<feature-slug>/spec.md`
+- Implementation issues are one file per ticket at `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01` — never a single combined tickets file
+- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
+- Comments and conversation history append to the bottom of the file under a `## Comments` heading
+
+## When a skill says "publish to the issue tracker"
+
+Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).
+
+## When a skill says "fetch the relevant ticket"
+
+Read the file at the referenced path. The user will normally pass the path or the issue number directly.
+
+## Wayfinding operations
+
+Used by `/wayfinder`. The **map** is a file with one **child** file per ticket.
+
+- **Map**: `.scratch/<effort>/map.md` — the Notes / Decisions-so-far / Fog body.
+- **Child ticket**: `.scratch/<effort>/issues/NN-<slug>.md`, numbered from `01`, with the question in the body. A `Type:` line records the ticket type (`research`/`prototype`/`grilling`/`task`); a `Status:` line records `claimed`/`resolved`.
+- **Blocking**: a `Blocked by: NN, NN` line near the top. A ticket is unblocked when every file it lists is `resolved`.
+- **Frontier**: scan `.scratch/<effort>/issues/` for files that are open, unblocked, and unclaimed; first by number wins.
+- **Claim**: set `Status: claimed` and save before any work.
+- **Resolve**: append the answer under an `## Answer` heading, set `Status: resolved`, then append a context pointer (gist + link) to the map's Decisions-so-far in `map.md`.

package/templates/hono-fullstack/docs/agents/triage-labels.md

@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.

package/templates/hono-fullstack/envs/.env.example.server

@@ -0,0 +1,12 @@
+NODE_PORT=6464
+SERVER_ENV=local
+LOGGER_DIR=./logs
+LOGGER_FILE_BASE=app
+# LOGGER_LEVEL=debug
+CORS_DOMAINS='*'
+# MIN_THREADS=1
+# MAX_THREADS=4
+# CONCURRENT_TASKS_PER_WORKER=1
+# MAX_QUEUE=12
+# WORKER_TASK_TIMEOUT_MS=30000
+

package/templates/hono-fullstack/envs/.env.example.sqlite

@@ -0,0 +1 @@
+DB_PATH=/absolute/path/to/repo.sqlite

package/templates/hono-fullstack/libs/db/drizzle-kit/sqlite.config.ts

@@ -0,0 +1,22 @@
+import path from 'node:path'
+import { defineConfig } from 'drizzle-kit'
+import { ensureDatabaseDirectory } from '../src/dialects/sqlite/utils'
+import { sqliteSchemaConfig } from '@repo/definition/backend'
+
+const configDir = import.meta.dirname
+
+const { dbPath } = sqliteSchemaConfig.resolve({
+  context: process.env,
+  matchContextKey: 'constantCase',
+})
+
+ensureDatabaseDirectory(dbPath)
+
+export default defineConfig({
+  dialect: 'sqlite',
+  schema: path.join(configDir, '../src/dialects/sqlite/schema/tables.ts'),
+  out: path.join(configDir, '../migrations/sqlite'),
+  dbCredentials: {
+    url: dbPath,
+  },
+})

package/templates/hono-fullstack/libs/db/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@repo/db",
+  "version": "0.0.0",
+  "private": true,
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./sqlite/schema": "./dist/sqlite/schema.mjs",
+    "./sqlite/sqlite": "./dist/sqlite/sqlite.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check",
+    "sqlite:export": "oyo env sqlite -- drizzle-kit export --config=drizzle-kit/sqlite.config.ts",
+    "dev:sqlite:push": "oyo env sqlite -- drizzle-kit push --config=drizzle-kit/sqlite.config.ts",
+    "dev:sqlite:gen": "oyo env sqlite -- drizzle-kit generate --config=drizzle-kit/sqlite.config.ts",
+    "dev:sqlite:migrate": "oyo env sqlite -- drizzle-kit migrate --config=drizzle-kit/sqlite.config.ts"
+  },
+  "dependencies": {
+    "@repo/definition": "workspace:*",
+    "better-sqlite3": "catalog:drizzle",
+    "drizzle-orm": "catalog:drizzle"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "catalog:drizzle",
+    "@oyolincc/cli": "catalog:",
+    "@oyolincc/dev-config": "catalog:",
+    "@types/better-sqlite3": "catalog:drizzle",
+    "@types/node": "catalog:",
+    "drizzle-kit": "catalog:drizzle",
+    "tsx": "catalog:",
+    "typescript": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}

package/templates/hono-fullstack/libs/db/src/dialects/sqlite/client.ts

@@ -0,0 +1,35 @@
+import Database from 'better-sqlite3'
+import { drizzle } from 'drizzle-orm/better-sqlite3'
+import { relations, type SqliteDBType } from './schema'
+import { ensureDatabaseDirectory } from './utils'
+
+export type SqliteDatabase = SqliteDBType
+
+export interface SqliteClient {
+  db: SqliteDatabase
+  close(): void
+}
+
+export function createSqliteClient(databaseFile: string): SqliteClient {
+  if (!databaseFile) throw new Error('databaseFile must not be empty')
+
+  ensureDatabaseDirectory(databaseFile)
+
+  const client = new Database(databaseFile)
+  client.pragma('foreign_keys = ON')
+  if (databaseFile !== ':memory:') client.pragma('journal_mode = WAL')
+
+  const db = drizzle({ client, relations })
+
+  let closed = false
+
+  return {
+    db,
+    close() {
+      if (!closed) {
+        client.close()
+        closed = true
+      }
+    },
+  }
+}

package/templates/hono-fullstack/libs/db/src/dialects/sqlite/schema/columns.ts

@@ -0,0 +1,32 @@
+import { sql } from 'drizzle-orm'
+import { customType, integer, text } from 'drizzle-orm/sqlite-core'
+
+export const idType = customType<{ data: string; driverData: number | bigint }>({
+  dataType() {
+    return 'integer'
+  },
+  fromDriver(value) {
+    return String(value)
+  },
+})
+
+export function timestampMsColumn(name: string) {
+  return integer(name, { mode: 'timestamp_ms' })
+    .notNull()
+    .default(sql`(unixepoch('subsec') * 1000)`)
+}
+
+export const updatedAtCol = () => timestampMsColumn('updated_at').$onUpdateFn(() => new Date())
+
+/**
+ * createdAt 和 updatedAt 是数据库行的创建/修改时间，SQLite 保存毫秒时间戳，代码里使用 Date。
+ * syncState.updatedTime 是客户端同步版本号，和这两个时间不是一回事，不要混用。
+ */
+export const modifiedTimeCols = () => ({
+  createdAt: timestampMsColumn('created_at'),
+  updatedAt: updatedAtCol(),
+})
+
+export function jsonColumn<T>(name: string) {
+  return text(name, { mode: 'json' }).$type<T>()
+}