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

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

@@ -18,19 +18,31 @@ describe('Example worker task', () => {
       expect.arrayContaining([
         expect.objectContaining({ type: 'log' }),
         expect.objectContaining({ type: 'progress', value: 100 }),
+        expect.objectContaining({ type: 'result' }),
       ]),
     )
     port1.close()
     port2.close()
   })
 
-  it('preserves a business exception model', async () => {
+  it('serializes a business exception and reports it', async () => {
     const { port1, port2 } = new MessageChannel()
-    await expect(executeExampleTask({ message: '  ' }, port2)).rejects.toMatchObject({
-      name: 'WorkerTaskBusinessError',
-      message: 'Message must not be empty',
-      details: { field: 'message' },
+    const messages: unknown[] = []
+    port1.on('message', (message) => messages.push(message))
+    const result = await executeExampleTask({ message: '  ' }, port2)
+    await new Promise<void>((resolve) => setImmediate(resolve))
+
+    expect(result).toEqual({
+      ok: false,
+      error: {
+        code: 'EXAMPLE_PROCESS_FAILED',
+        message: 'Message must not be empty',
+        details: { field: 'message' },
+      },
     })
+    expect(messages).toEqual(
+      expect.arrayContaining([expect.objectContaining({ type: 'error' })]),
+    )
     port1.close()
     port2.close()
   })

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

@@ -8,7 +8,7 @@ import type {
   WorkerConfig,
 } from '@repo/definition/backend'
 import type { AppWorkRunner } from '@/infra/work-runner/types'
-import type { MiddlewareHandler } from 'hono'
+import type { MiddlewareHandler, Context } from 'hono'
 import type { PinoLogger as HonoPinoLogger } from 'hono-pino'
 import type { RequestIdVariables } from 'hono/request-id'
 
@@ -30,11 +30,15 @@ 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 = {
   Variables: RequestIdVariables & AppDependencies & { logger?: AppLogger }
 }
+
+export type CreateAppOptions = {
+  serverBasePath: string
+  makeDependencies: (c: Context<AppEnv>) => Promise<AppDependencies> | AppDependencies
+}

package/templates/hono-fullstack/apps/server/src/shared/network/validator.ts

@@ -1,6 +1,6 @@
-import type { ValidationTargets } from 'hono'
+import type { Env, MiddlewareHandler, ValidationTargets } from 'hono'
 import { validator } from 'hono-openapi'
-import { flatten, type GenericSchema } from 'valibot'
+import { flatten, type GenericSchema, type InferInput, type InferOutput } from 'valibot'
 import { E } from '@/shared/errors/defs'
 
 export const generalValidator = <
@@ -9,7 +9,14 @@ export const generalValidator = <
 >(
   target: TTarget,
   schema: TSchema,
-) =>
+): MiddlewareHandler<
+  Env,
+  string,
+  {
+    in: { [K in TTarget]: InferInput<TSchema> }
+    out: { [K in TTarget]: InferOutput<TSchema> }
+  }
+> =>
   validator(target, schema, (result, _c) => {
     if (!result.success) {
       throw E.NORMAL.VALIDATION.create({

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/modules/example/{hooks.ts → hooks/api-hooks.ts}

@@ -1,7 +1,8 @@
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
-import { createExample, listExamples, processExample } from './api'
+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()

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

@@ -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/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,10 +4,24 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "oyo env server -- vp dev",
+    "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": "oyo env server -- vp build",
-    "preview": "oyo env server -- vp preview",
     "test": "vp test",
     "check": "vp check"
   },
@@ -24,6 +38,7 @@
     "react-dom": "catalog:frontend"
   },
   "devDependencies": {
+    "@cloudflare/vite-plugin": "catalog:",
     "@oyolincc/cli": "catalog:",
     "@oyolincc/dev-config": "catalog:",
     "@rollup/pluginutils": "catalog:",
@@ -38,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,10 +1,13 @@
 {
-  "extends": "@oyolincc/dev-config/tsconfig.app.json",
+  "extends": "@oyolincc/dev-config/tsconfig.frontend.json",
   "compilerOptions": {
-    "baseUrl": ".",
+    "types": ["./worker-configuration.d.ts"],
+    "jsx": "react-jsx",
     "paths": {
-      "#/*": ["./frontend/*"]
+      "#/*": ["./frontend/*"],
+      "@/*": ["./nitro/*"]
     }
   },
-  "include": ["frontend", "nitro", "vite.config.ts"]
+  "files": [],
+  "include": ["frontend", "backend", "nitro", "./*.ts", "./*.mts"]
 }

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

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