import { afterEach, describe, expect, test } from 'vitest'
import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
import Actions from '../src/actions'
import { existsSync } from 'node:fs'
import { join } from 'node:path'
import { tmpdir } from 'node:os'
const tempDirs: string[] = []
afterEach(async () => {
await Promise.all(tempDirs.map((dir) => rm(dir, { recursive: true, force: true })))
tempDirs.length = 0
})
/** Build a minimal downloaded-repo layout with the inertia stubs and an express template. */
const scaffold = async () => {
const repo = await mkdtemp(join(tmpdir(), 'create-arkstack-repo-'))
const project = await mkdtemp(join(tmpdir(), 'create-arkstack-proj-'))
tempDirs.push(repo, project)
// Inertia stubs (subset) under the repo's package dir.
const stubs = join(repo, 'packages/inertia/stubs')
await mkdir(join(stubs, 'config'), { recursive: true })
await mkdir(join(stubs, 'views'), { recursive: true })
await mkdir(join(stubs, 'shared/resources/js'), { recursive: true })
await mkdir(join(stubs, 'react/resources/js/Pages'), { recursive: true })
await writeFile(join(stubs, 'config/inertia.ts.stub'), 'export default () => ({ root_view: "app" })\n')
await writeFile(join(stubs, 'config/app.css.stub'), 'body { margin: 0 }\n')
await writeFile(
join(stubs, 'views/app.edge.stub'),
"@inertiaHead\n {{reactRefresh}}@vite(['resources/js/app.{{ext}}', 'resources/css/app.css'])\n",
)
await writeFile(join(stubs, 'shared/resources/js/vite-env.d.ts.stub'), '/// \n')
await writeFile(join(stubs, 'react/resources/js/app.tsx.stub'), 'createInertiaApp({})\n')
await writeFile(join(stubs, 'react/vite.config.ts.stub'), 'export default {}\n')
await writeFile(
join(stubs, 'react/resources/js/Pages/Index.tsx.stub'),
'export default function Index() { return null }\n',
)
// Project files an express template would carry.
await mkdir(join(project, 'src/config'), { recursive: true })
await mkdir(join(project, 'src/routes'), { recursive: true })
await writeFile(
join(project, 'src/config/middleware.ts'),
[
"import { formdata, requestLogger, resora } from '@arkstack/driver-express/middlewares'",
'',
'export default () => ({',
' before: [',
' resora(),',
' ],',
'})',
'',
].join('\n'),
)
await writeFile(
join(project, 'src/routes/web.ts'),
[
"import { Router } from '@arkstack/driver-express'",
"import { view } from '@arkstack/view'",
'',
"Router.get('/', async () => {",
" return await view('welcome', { title: 'hi' })",
'})',
'',
].join('\n'),
)
await writeFile(join(project, 'tsconfig.json'), JSON.stringify({ extends: './.arkstack/tsconfig.json' }, null, 2))
await writeFile(
join(project, 'package.json'),
JSON.stringify(
{
dependencies: { '@arkstack/view': '^0.15.4' },
scripts: { dev: 'ark dev' },
},
null,
2,
),
)
return { repo, project }
}
describe('applyInertia', () => {
test('captures stubs, writes files, injects deps and patches the runtime (react)', async () => {
const { repo, project } = await scaffold()
const actions = new Actions(project)
const captured = await actions.captureInertiaStubs(repo)
expect(captured).toBe(true)
await actions.applyInertia('express', 'react')
// Files written into the project.
expect(existsSync(join(project, 'src/config/inertia.ts'))).toBe(true)
expect(existsSync(join(project, 'resources/css/app.css'))).toBe(true)
expect(existsSync(join(project, 'resources/js/app.tsx'))).toBe(true)
expect(existsSync(join(project, 'resources/js/vite-env.d.ts'))).toBe(true)
expect(existsSync(join(project, 'resources/js/Pages/Index.tsx'))).toBe(true)
expect(existsSync(join(project, 'vite.config.ts'))).toBe(true)
// Root template transforms: react ext + the React Refresh preamble.
const edge = await readFile(join(project, 'src/resources/views/app.edge'), 'utf-8')
expect(edge).toContain('@viteReactRefresh')
expect(edge).toContain('resources/js/app.tsx')
expect(edge).not.toContain('{{ext}}')
expect(edge).not.toContain('{{reactRefresh}}')
// Dependencies + scripts.
const pkg = JSON.parse(await readFile(join(project, 'package.json'), 'utf-8'))
expect(pkg.dependencies['@arkstack/inertia']).toBeDefined()
expect(pkg.dependencies['@inertiajs/react']).toBeDefined()
expect(pkg.dependencies.react).toBeDefined()
expect(pkg.dependencies.vite).toBeDefined()
expect(pkg.devDependencies['@vitejs/plugin-react']).toBeDefined()
expect(pkg.scripts['dev:client']).toBe('vite')
// Middleware registers inertia() after resora().
const mw = await readFile(join(project, 'src/config/middleware.ts'), 'utf-8')
expect(mw).toContain('import { formdata, inertia, requestLogger, resora }')
expect(mw).toMatch(/resora\(\),\s*\n\s*inertia\(\),/)
// Root route renders an Inertia page.
const web = await readFile(join(project, 'src/routes/web.ts'), 'utf-8')
expect(web).toContain("import { inertia } from '@arkstack/inertia'")
expect(web).toContain("inertia('Index'")
expect(web).not.toContain("view('welcome'")
// tsconfig enables JSX and includes resources/.
const ts = JSON.parse(await readFile(join(project, 'tsconfig.json'), 'utf-8'))
expect(ts.compilerOptions.jsx).toBe('react-jsx')
expect(ts.include).toContain('resources')
})
test('vue stack does not enable jsx or the react preamble', async () => {
const { repo, project } = await scaffold()
// Provide the vue stubs the spec references.
const stubs = join(repo, 'packages/inertia/stubs')
await mkdir(join(stubs, 'vue/resources/js/Pages'), { recursive: true })
await writeFile(join(stubs, 'vue/resources/js/app.ts.stub'), 'createInertiaApp({})\n')
await writeFile(join(stubs, 'vue/vite.config.ts.stub'), 'export default {}\n')
await writeFile(join(stubs, 'vue/resources/js/Pages/Index.vue.stub'), '\n')
const actions = new Actions(project)
await actions.captureInertiaStubs(repo)
await actions.applyInertia('express', 'vue')
expect(existsSync(join(project, 'resources/js/app.ts'))).toBe(true)
expect(existsSync(join(project, 'resources/js/Pages/Index.vue'))).toBe(true)
const edge = await readFile(join(project, 'src/resources/views/app.edge'), 'utf-8')
expect(edge).not.toContain('@viteReactRefresh')
expect(edge).toContain('resources/js/app.ts')
const pkg = JSON.parse(await readFile(join(project, 'package.json'), 'utf-8'))
expect(pkg.dependencies['@inertiajs/vue3']).toBeDefined()
expect(pkg.devDependencies['@vitejs/plugin-vue']).toBeDefined()
const ts = JSON.parse(await readFile(join(project, 'tsconfig.json'), 'utf-8'))
expect(ts.compilerOptions.jsx).toBeUndefined()
expect(ts.include).toContain('resources')
})
test('adds the React preamble even when the stub predates the {{reactRefresh}} placeholder', async () => {
const { repo, project } = await scaffold()
// Simulate an older downloaded stub: no placeholder, hardcoded `app.ts`.
const stubs = join(repo, 'packages/inertia/stubs')
await writeFile(join(stubs, 'views/app.edge.stub'), "@inertiaHead\n @vite('resources/js/app.ts')\n")
const actions = new Actions(project)
await actions.captureInertiaStubs(repo)
await actions.applyInertia('express', 'react')
const edge = await readFile(join(project, 'src/resources/views/app.edge'), 'utf-8')
expect(edge).toContain('@viteReactRefresh')
// The preamble must sit immediately before the @vite tag.
expect(edge).toMatch(/@viteReactRefresh\n\s*@vite\(/)
// The entry extension is corrected to React's `tsx`.
expect(edge).toContain('resources/js/app.tsx')
expect(edge).not.toContain("resources/js/app.ts'")
})
test('skips gracefully when stubs were never captured', async () => {
const project = await mkdtemp(join(tmpdir(), 'create-arkstack-proj-'))
tempDirs.push(project)
await writeFile(join(project, 'package.json'), JSON.stringify({ dependencies: {} }))
const actions = new Actions(project)
// No captureInertiaStubs() call → nothing to apply.
await actions.applyInertia('express', 'react')
expect(existsSync(join(project, 'resources/js/app.tsx'))).toBe(false)
})
})