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

package/templates/hono-fullstack/apps/server/src/modules/example/work-task/tasks.ts

@@ -1,9 +1,15 @@
 import type { ProcessExampleInput, ProcessExampleOutput } from '@repo/definition/backend'
 import { type WorkSubject } from '@/infra/work-runner/constants'
-import type { DefineRunnerTaskModel, RunnerTaskResult } from '@/infra/work-runner/types'
-import { WorkerTaskBusinessError } from '@/infra/work-runner/utils/business-error'
+import type {
+  DefineRunnerTaskModel,
+  RunnerTaskResult,
+  WorkerMessagePort,
+} from '@/infra/work-runner/types'
+import {
+  isWorkerTaskBusinessError,
+  WorkerTaskBusinessError,
+} from '@/infra/work-runner/utils/business-error'
 import { workerLog, workerProgress } from '@/infra/work-runner/utils/message'
-import type { MessagePort } from 'node:worker_threads'
 
 export type ExampleTaskErrorCode = 'EXAMPLE_PROCESS_FAILED'
 
@@ -16,20 +22,37 @@ export type ExampleRunnerTaskModel = DefineRunnerTaskModel<
 
 export async function executeExampleTask(
   input: ExampleRunnerTaskModel['input'],
-  messagePort: MessagePort,
+  messagePort: WorkerMessagePort,
 ): Promise<RunnerTaskResult<ProcessExampleOutput, ExampleTaskErrorCode>> {
-  workerLog(messagePort, 'debug', 'Example task started')
-  workerProgress(messagePort, 0, 'Validating input')
+  try {
+    workerLog(messagePort, 'debug', 'Example task started')
+    workerProgress(messagePort, 0, 'Validating input')
 
-  const original = input.message
-  const normalized = original.trim().replace(/\s+/g, ' ')
-  if (!normalized) {
-    throw new WorkerTaskBusinessError('Message must not be empty', { field: 'message' })
-  }
+    const original = input.message
+    const normalized = original.trim().replace(/\s+/g, ' ')
+    if (!normalized) {
+      throw new WorkerTaskBusinessError('Message must not be empty', { field: 'message' })
+    }
+
+    workerProgress(messagePort, 100, 'Example task completed')
+    const result = {
+      ok: true,
+      data: { original, normalized, length: normalized.length },
+    } as const
+    messagePort.postMessage({ type: 'result', data: result.data })
+    return result
+  } catch (error) {
+    if (!isWorkerTaskBusinessError(error)) throw error
 
-  workerProgress(messagePort, 100, 'Example task completed')
-  return {
-    ok: true,
-    data: { original, normalized, length: normalized.length },
+    const result: RunnerTaskResult<ProcessExampleOutput, ExampleTaskErrorCode> = {
+      ok: false,
+      error: {
+        code: 'EXAMPLE_PROCESS_FAILED',
+        message: error.message,
+        ...(error.details ? { details: error.details } : {}),
+      },
+    }
+    messagePort.postMessage({ type: 'error', error: result.error })
+    return result
   }
 }

package/templates/hono-fullstack/apps/server/src/shared/app/types.ts

@@ -30,9 +30,8 @@ export type AppConfig = {
 export type AppDependencies = {
   appConfig: AppConfig
   loggerHandler: MiddlewareHandler<{ Variables: { logger: AppLogger } }>
-  exampleWorkRunner: AppWorkRunner
-  /** Fullstack injects its SQLite database; standalone intentionally leaves this absent. */
-  db?: unknown
+  workRunner: AppWorkRunner
+  db: unknown
 }
 
 export type AppEnv = {
@@ -40,6 +39,6 @@ export type AppEnv = {
 }
 
 export type CreateAppOptions = {
-  basePath?: string
+  serverBasePath: string
   makeDependencies: (c: Context<AppEnv>) => Promise<AppDependencies> | AppDependencies
 }

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

@@ -1,6 +1,7 @@
 {
   "extends": "@oyolincc/dev-config/tsconfig.bundler.json",
   "compilerOptions": {
+    "types": ["node", "./worker-configuration.d.ts"],
     "verbatimModuleSyntax": true,
     "jsx": "react-jsx",
     "jsxImportSource": "hono/jsx",

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

@@ -52,14 +52,19 @@ export default defineConfig(() => {
     pack: {
       ...packConfig,
       plugins: [virtualWorkers('pack')],
+      deps: {
+        neverBundle: ['cloudflare:workers'],
+      },
       entry: {
         ...(isServe
           ? {}
           : {
-              nodeMain: './src/adapters/nodejs/bootstrap.ts',
+              nodejsMain: './src/adapters/nodejs/bootstrap.ts',
             }),
-        nodeEntry: './src/adapters/nodejs/entry.ts',
-        'workers/example-worker': './src/infra/work-runner/example/worker-entry.ts',
+        nodejsEntry: './src/adapters/nodejs/entry.ts',
+        cloudflareEntry: './src/adapters/cloudflare/entry.ts',
+        // Enable this entry together with PiscinaWorkRunner in the Node.js adapter.
+        // 'workers/example-worker': './src/infra/work-runner/example/worker-entry.ts',
       },
       // deps: {
       //   neverBundle: [...builtinModules],

package/templates/hono-fullstack/apps/server/wrangler.jsonc

@@ -0,0 +1,29 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "repo-server-dev",
+  "main": "./src/adapters/cloudflare/entry.ts",
+  "compatibility_date": "2026-09-23",
+  "compatibility_flags": ["nodejs_compat"],
+  "dev": {
+    "port": 6464,
+    "inspector_port": 19230,
+  },
+  "observability": {
+    "logs": {
+      "enabled": true,
+      "invocation_logs": true,
+    },
+    "traces": {
+      "enabled": false,
+    },
+  },
+  "d1_databases": [
+    {
+      "binding": "DB",
+      "database_name": "repo-db",
+      "database_id": "00000000-0000-0000-0000-000000000000",
+      "migrations_dir": "../../libs/db/migrations/sqlite-d1",
+      "migrations_pattern": "../../libs/db/migrations/sqlite-d1/*/migration.sql",
+    },
+  ],
+}

package/templates/hono-fullstack/apps/stack/backend/cloudflare.ts

@@ -0,0 +1,5 @@
+import app from '@repo/server/cloudflare'
+import { env } from 'cloudflare:workers'
+
+export const handleApiRequest = async (request: Request): Promise<Response> =>
+  app.fetch(request, env)

package/templates/hono-fullstack/apps/stack/backend/node.ts

@@ -0,0 +1,3 @@
+import app from '@repo/server/nodejs'
+
+export const handleApiRequest = async (request: Request): Promise<Response> => app.fetch(request)

package/templates/hono-fullstack/apps/stack/frontend/components/general/ErrorMessage.tsx

@@ -0,0 +1,4 @@
+export function ErrorMessage({ error }: { error: unknown }) {
+  if (!error) return null
+  return <p className="text-red-400">{String(error)}</p>
+}

package/templates/hono-fullstack/apps/stack/frontend/components/layouts/AppLayout.tsx

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react'
+import { Header } from './Header'
+
+export function AppLayout({ children }: { children: ReactNode }) {
+  return (
+    <div className="min-h-screen bg-zinc-950 text-zinc-100">
+      <Header />
+      {children}
+    </div>
+  )
+}

package/templates/hono-fullstack/apps/stack/frontend/components/layouts/Header.tsx

@@ -0,0 +1,7 @@
+export function Header() {
+  return (
+    <header className="border-b border-zinc-800 px-8 py-4">
+      <strong>Hono fullstack</strong>
+    </header>
+  )
+}

package/templates/hono-fullstack/apps/stack/frontend/components/layouts/Page.tsx

@@ -0,0 +1,5 @@
+import type { ReactNode } from 'react'
+
+export function Page({ children }: { children: ReactNode }) {
+  return <section className="flex flex-col gap-6">{children}</section>
+}

package/templates/hono-fullstack/apps/stack/frontend/components/layouts/PageContainer.tsx

@@ -0,0 +1,5 @@
+import type { ReactNode } from 'react'
+
+export function PageContainer({ children }: { children: ReactNode }) {
+  return <main className="mx-auto max-w-2xl p-8">{children}</main>
+}

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

@@ -0,0 +1,45 @@
+import type { FormEvent } from 'react'
+
+interface ExampleFormProps {
+  message: string
+  saving: boolean
+  processing: boolean
+  onMessageChange: (message: string) => void
+  onSave: () => Promise<void>
+  onProcess: () => void
+}
+
+export function ExampleForm({
+  message,
+  saving,
+  processing,
+  onMessageChange,
+  onSave,
+  onProcess,
+}: ExampleFormProps) {
+  const submit = async (event: FormEvent) => {
+    event.preventDefault()
+    await onSave()
+  }
+
+  return (
+    <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) => onMessageChange(event.target.value)}
+        placeholder="Message"
+      />
+      <button className="rounded bg-blue-600 px-4 py-2" disabled={!message.trim() || saving}>
+        Save
+      </button>
+      <button
+        className="rounded bg-emerald-600 px-4 py-2"
+        type="button"
+        disabled={!message.trim() || processing}
+        onClick={onProcess}>
+        Process
+      </button>
+    </form>
+  )
+}

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

@@ -0,0 +1,13 @@
+import type { Example } from '@repo/definition/frontend'
+
+export function ExampleList({ examples }: { examples?: Example[] }) {
+  return (
+    <ul className="grid gap-2">
+      {examples?.map((example) => (
+        <li className="rounded border border-zinc-800 p-3" key={example.id}>
+          {example.message}
+        </li>
+      ))}
+    </ul>
+  )
+}

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

@@ -3,33 +3,43 @@
 // This file was automatically generated by TanStack Router.
 import { Route as rootRouteImport } from './routes/__root'
 import { Route as IndexRouteImport } from './routes/index'
+import { Route as ApiSplatRouteImport } from './routes/api/$'
 
 const IndexRoute = IndexRouteImport.update({
   id: '/',
   path: '/',
   getParentRoute: () => rootRouteImport,
 } as any)
+const ApiSplatRoute = ApiSplatRouteImport.update({
+  id: '/api/$',
+  path: '/api/$',
+  getParentRoute: () => rootRouteImport,
+} as any)
 
 export interface FileRoutesByFullPath {
   '/': typeof IndexRoute
+  '/api/$': typeof ApiSplatRoute
 }
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
+  '/api/$': typeof ApiSplatRoute
 }
 export interface FileRoutesById {
   __root__: typeof rootRouteImport
   '/': typeof IndexRoute
+  '/api/$': typeof ApiSplatRoute
 }
 export interface FileRouteTypes {
   fileRoutesByFullPath: FileRoutesByFullPath
-  fullPaths: '/'
+  fullPaths: '/' | '/api/$'
   fileRoutesByTo: FileRoutesByTo
-  to: '/'
-  id: '__root__' | '/'
+  to: '/' | '/api/$'
+  id: '__root__' | '/' | '/api/$'
   fileRoutesById: FileRoutesById
 }
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
+  ApiSplatRoute: typeof ApiSplatRoute
 }
 declare module '@tanstack/react-router' {
   interface FileRoutesByPath {
@@ -40,9 +50,16 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof IndexRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/api/$': {
+      id: '/api/$'
+      path: '/api/$'
+      fullPath: '/api/$'
+      preLoaderRoute: typeof ApiSplatRouteImport
+      parentRoute: typeof rootRouteImport
+    }
   }
 }
-const rootRouteChildren: RootRouteChildren = { IndexRoute }
+const rootRouteChildren: RootRouteChildren = { IndexRoute, ApiSplatRoute }
 export const routeTree = rootRouteImport
   ._addFileChildren(rootRouteChildren)
   ._addFileTypes<FileRouteTypes>()

package/templates/hono-fullstack/apps/stack/frontend/routes/api/$.ts

@@ -0,0 +1,18 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { handleApiRequest } from '#server-runtime'
+
+const serve = async ({ request }: { request: Request }) => handleApiRequest(request)
+
+export const Route = createFileRoute('/api/$')({
+  server: {
+    handlers: {
+      GET: serve,
+      POST: serve,
+      PUT: serve,
+      PATCH: serve,
+      DELETE: serve,
+      OPTIONS: serve,
+      HEAD: serve,
+    },
+  },
+})

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

@@ -1,4 +1,50 @@
 import { createFileRoute } from '@tanstack/react-router'
-import { ExamplePage } from '#/modules/example/components/ExamplePage'
+import { useAtom } from 'jotai'
+import { ErrorMessage } from '#/components/general/ErrorMessage'
+import { AppLayout } from '#/components/layouts/AppLayout'
+import { Page } from '#/components/layouts/Page'
+import { PageContainer } from '#/components/layouts/PageContainer'
+import { ExampleForm } from '#/modules/example/components/ExampleForm'
+import { ExampleList } from '#/modules/example/components/ExampleList'
+import { useCreateExample, useExamples, useProcessExample } from '#/modules/example/hooks/api-hooks'
+import { exampleMessageAtom } from '#/modules/example/stores'
 
-export const Route = createFileRoute('/')({ component: ExamplePage })
+export const Route = createFileRoute('/')({ component: Home })
+
+function Home() {
+  const [message, setMessage] = useAtom(exampleMessageAtom)
+  const examples = useExamples()
+  const create = useCreateExample()
+  const process = useProcessExample()
+
+  const save = async () => {
+    await create.mutateAsync({ message })
+    setMessage('')
+  }
+
+  return (
+    <AppLayout>
+      <PageContainer>
+        <Page>
+          <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>
+          <ExampleForm
+            message={message}
+            saving={create.isPending}
+            processing={process.isPending}
+            onMessageChange={setMessage}
+            onSave={save}
+            onProcess={() => process.mutate({ message })}
+          />
+          {process.data && (
+            <pre className="rounded bg-zinc-900 p-4">{JSON.stringify(process.data, null, 2)}</pre>
+          )}
+          <ErrorMessage error={create.error || process.error || examples.error} />
+          <ExampleList examples={examples.data} />
+        </Page>
+      </PageContainer>
+    </AppLayout>
+  )
+}

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

@@ -1 +1,6 @@
 /// <reference types="vite/client" />
+/// <reference types="@tanstack/react-start" />
+
+declare module '#server-runtime' {
+  export const handleApiRequest: (request: Request) => Promise<Response>
+}

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

@@ -4,11 +4,24 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "oyo env server -- vp dev",
-    "dev:chain": "turbo watch dev --filter=@repo/stack",
+    "dev": "pnpm dev:node",
+    "build": "pnpm build:node",
+    "preview": "pnpm preview:node",
+    "dev:node-chain": "turbo watch dev:node --filter=@repo/stack",
+    "dev:node": "DEPLOY_TARGET=node SERVER_BASE_PATH=/api oyo env server -- vp dev",
+    "build:node-chain": "turbo build:node --filter=@repo/stack",
+    "build:node": "DEPLOY_TARGET=node SERVER_BASE_PATH=/api oyo env server -- vp build",
+    "preview:node": "DEPLOY_TARGET=node SERVER_BASE_PATH=/api oyo env server -- vp preview",
+    "dev:cloudflare-chain": "turbo watch dev:cloudflare --filter=@repo/stack",
+    "dev:cloudflare": "DEPLOY_TARGET=cloudflare vp dev",
+    "build:cloudflare-chain": "turbo build:cloudflare --filter=@repo/stack",
+    "build:cloudflare": "DEPLOY_TARGET=cloudflare vp build",
+    "preview:cloudflare": "DEPLOY_TARGET=cloudflare vp preview",
+    "deploy:cloudflare": "pnpm build:cloudflare-chain && wrangler deploy",
+    "db:migrate:cloudflare:local": "wrangler d1 migrations apply DB --local --config wrangler.jsonc --persist-to ../../.wrangler/state",
+    "cf:typegen": "wrangler types",
+    "cf:typecheck": "wrangler types --check",
     "generate-routes": "tsr generate",
-    "build": "vp build",
-    "preview": "oyo env server -- vp preview",
     "test": "vp test",
     "check": "vp check"
   },
@@ -25,6 +38,7 @@
     "react-dom": "catalog:frontend"
   },
   "devDependencies": {
+    "@cloudflare/vite-plugin": "catalog:",
     "@oyolincc/cli": "catalog:",
     "@oyolincc/dev-config": "catalog:",
     "@rollup/pluginutils": "catalog:",
@@ -39,6 +53,7 @@
     "fast-glob": "catalog:",
     "tailwindcss": "catalog:frontend",
     "typescript": "catalog:",
-    "vite-plus": "catalog:"
+    "vite-plus": "catalog:",
+    "wrangler": "catalog:"
   }
 }

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

@@ -1,6 +1,7 @@
 {
   "extends": "@oyolincc/dev-config/tsconfig.frontend.json",
   "compilerOptions": {
+    "types": ["./worker-configuration.d.ts"],
     "jsx": "react-jsx",
     "paths": {
       "#/*": ["./frontend/*"],
@@ -8,5 +9,5 @@
     }
   },
   "files": [],
-  "include": ["frontend", "nitro", "./*.ts", "./*.mts"]
+  "include": ["frontend", "backend", "nitro", "./*.ts", "./*.mts"]
 }

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

@@ -1,33 +1,82 @@
-import { defineConfig } from 'vite-plus'
+import { defineConfig, lazyPlugins, type PluginOption } 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'
+import path from 'node:path'
 
-export default defineConfig({
-  server: {
-    port: 3000,
-    warmup: {
-      clientFiles: ['./frontend/router.tsx'],
-      ssrFiles: ['./frontend/router.tsx'],
+export default defineConfig(() => {
+  const deployTarget = process.env.DEPLOY_TARGET || 'node'
+  if (deployTarget !== 'node' && deployTarget !== 'cloudflare') {
+    throw new Error(`DEPLOY_TARGET must be "node" or "cloudflare", received: ${deployTarget}`)
+  }
+  const serverExternal = /^@repo\/server(?:\/|$)/
+
+  return {
+    ...(deployTarget === 'node'
+      ? {
+          environments: {
+            ssr: {
+              resolve: {
+                // 拦住第一次：Vite/TanStack SSR bundle
+                external: ['@repo/server/nodejs'],
+              },
+            },
+          },
+        }
+      : {
+          environments: {
+            ssr: {
+              resolve: {
+                mainFields: ['browser', 'module', 'jsnext:main', 'jsnext'],
+              },
+            },
+          },
+        }),
+    server: {
+      port: 3000,
+      warmup: {
+        clientFiles: ['./frontend/router.tsx'],
+        ssrFiles: ['./frontend/router.tsx'],
+      },
+    },
+    preview: {
+      port: 3000,
+      strictPort: true,
     },
-  },
-  resolve: { tsconfigPaths: true },
-  optimizeDeps: { include: ['@repo/definition/frontend'] },
-  plugins: [
-    nitro({
-      serverDir: './nitro',
-      handlers: [
-        {
-          route: '/api/**',
-          handler: './nitro/handlers/hono.ts',
-          middleware: false,
-          lazy: false,
-        },
-      ],
+    resolve: {
+      tsconfigPaths: true,
+      alias: {
+        '#server-runtime': path.resolve(import.meta.dirname, `./backend/${deployTarget}.ts`),
+      },
+    },
+    optimizeDeps: { include: ['@repo/definition/frontend'] },
+    plugins: lazyPlugins(async () => {
+      const runtimePlugins =
+        deployTarget === 'cloudflare'
+          ? [
+              (await import('@cloudflare/vite-plugin')).cloudflare({
+                viteEnvironment: { name: 'ssr' },
+                persistState: {
+                  path: path.resolve(import.meta.dirname, '../../.wrangler/state'),
+                },
+              }),
+            ]
+          : (await import('nitro/vite')).nitro({
+              preset: 'node_server',
+              serverDir: './nitro',
+              // 拦住第二次：Nitro 最终 server bundle
+              rollupConfig: {
+                external: [serverExternal],
+              },
+            })
+
+      const pluginOptions = [
+        ...runtimePlugins,
+        ...tanstackStart({ srcDirectory: './frontend' }),
+        ...tailwindcss(),
+        ...viteReact(),
+      ] as PluginOption[]
+      return pluginOptions
     }),
-    tanstackStart({ srcDirectory: './frontend' }),
-    tailwindcss(),
-    viteReact(),
-  ],
+  }
 })

package/templates/hono-fullstack/apps/stack/wrangler.jsonc

@@ -0,0 +1,20 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "repo-stack",
+  "main": "@tanstack/react-start/server-entry",
+  "compatibility_date": "2026-09-23",
+  "compatibility_flags": ["nodejs_compat"],
+  "observability": {
+    "logs": { "enabled": true, "invocation_logs": true },
+    "traces": { "enabled": false },
+  },
+  "d1_databases": [
+    {
+      "binding": "DB",
+      "database_name": "repo-db",
+      "database_id": "00000000-0000-0000-0000-000000000000",
+      "migrations_dir": "../../libs/db/migrations/sqlite-d1",
+      "migrations_pattern": "../../libs/db/migrations/sqlite-d1/*/migration.sql",
+    },
+  ],
+}

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

@@ -1,4 +1,5 @@
 NODE_PORT=6464
+SERVER_BASE_PATH=/api
 SERVER_ENV=local
 LOGGER_DIR=./logs
 LOGGER_FILE_BASE=app
@@ -9,4 +10,3 @@ CORS_DOMAINS='*'
 # CONCURRENT_TASKS_PER_WORKER=1
 # MAX_QUEUE=12
 # WORKER_TASK_TIMEOUT_MS=30000
-

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

@@ -0,0 +1,3 @@
+CLOUDFLARE_ACCOUNT_ID=
+CLOUDFLARE_DATABASE_ID=
+CLOUDFLARE_TOKEN=

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

@@ -0,0 +1,22 @@
+import path from 'node:path'
+import { defineConfig } from 'drizzle-kit'
+import { d1SchemaConfig } from '@repo/definition/backend'
+
+const configDir = import.meta.dirname
+
+const { cloudflareAccountId, cloudflareDatabaseId, cloudflareToken } = d1SchemaConfig.resolve({
+  context: process.env,
+  matchContextKey: 'constantCase',
+})
+
+export default defineConfig({
+  dialect: 'sqlite',
+  driver: 'd1-http',
+  schema: path.join(configDir, '../src/dialects/sqlite/schema/tables.ts'),
+  out: path.join(configDir, '../migrations/sqlite-d1'),
+  dbCredentials: {
+    accountId: cloudflareAccountId,
+    databaseId: cloudflareDatabaseId,
+    token: cloudflareToken,
+  },
+})