@jasonshimmy/vite-plugin-cer-app 0.23.2 → 0.25.0

package/src/__tests__/cli/adapters/netlify-bridge.integration.test.ts

@@ -1,139 +0,0 @@
-/**
- * Netlify SSR bridge — integration tests.
- *
- * These tests exercise the full request/response pipeline through the generated
- * `netlify/functions/ssr.mjs` bridge: Web API Request → Node.js mock → SSR
- * handler → streaming Web API Response (TransformStream body).
- *
- * Prerequisites (run automatically via `npm run e2e:integration:netlify`):
- *   1. `cer-app build --mode ssr --root e2e/kitchen-sink`   → dist/server/server.js
- *   2. `cer-app adapt --platform netlify --root e2e/kitchen-sink` → netlify/functions/ssr.mjs
- *
- * When the bridge does not exist (e.g. during a normal `npm test` run) the
- * entire suite is skipped — no failures, no noise.
- */
-
-import { describe, it, expect, beforeAll } from 'vitest'
-import { existsSync } from 'node:fs'
-import { resolve } from 'pathe'
-
-// ─── Paths ────────────────────────────────────────────────────────────────────
-
-const KITCHEN_SINK = resolve(import.meta.dirname, '../../../../e2e/kitchen-sink')
-const BRIDGE_PATH = resolve(KITCHEN_SINK, 'netlify/functions/ssr.mjs')
-const SERVER_BUNDLE = resolve(KITCHEN_SINK, 'dist/server/server.js')
-const bridgeExists = existsSync(BRIDGE_PATH) && existsSync(SERVER_BUNDLE)
-
-// ─── Suite ───────────────────────────────────────────────────────────────────
-
-describe.skipIf(!bridgeExists)('Netlify SSR bridge — integration', () => {
-  type BridgeFn = (req: Request) => Promise<Response>
-  let bridge: BridgeFn
-
-  beforeAll(async () => {
-    const mod = await import(BRIDGE_PATH)
-    bridge = mod.default as BridgeFn
-  })
-
-  // ─── HTML rendering ─────────────────────────────────────────────────────────
-
-  it('GET / returns 200 with Content-Type text/html', async () => {
-    const res = await bridge(new Request('http://localhost/'))
-    expect(res.status).toBe(200)
-    expect(res.headers.get('content-type')).toContain('text/html')
-  })
-
-  it('GET / response body is a complete HTML document', async () => {
-    const res = await bridge(new Request('http://localhost/'))
-    // Response body is a ReadableStream (streaming, not pre-buffered).
-    expect(res.body).toBeInstanceOf(ReadableStream)
-    const body = await res.text()
-    expect(body).toContain('<!DOCTYPE html')
-    expect(body).toContain('</html>')
-  })
-
-  it('GET / SSR body includes page-specific content', async () => {
-    const res = await bridge(new Request('http://localhost/'))
-    const body = await res.text()
-    // The kitchen-sink index page renders a heading with data-cy="home-heading".
-    expect(body).toContain('Kitchen Sink')
-  })
-
-  it('GET /about returns 200 HTML', async () => {
-    const res = await bridge(new Request('http://localhost/about'))
-    expect(res.status).toBe(200)
-    const body = await res.text()
-    expect(body).toContain('<!DOCTYPE html')
-  })
-
-  // ─── URL passthrough ────────────────────────────────────────────────────────
-
-  it('passes query string to the handler', async () => {
-    // The SSR handler uses req.url which includes the query string.
-    // We just verify no error is thrown — the handler resolves normally.
-    const res = await bridge(new Request('http://localhost/?ref=test&utm_source=vitest'))
-    expect(res.status).toBe(200)
-  })
-
-  // ─── API routes ─────────────────────────────────────────────────────────────
-
-  it('GET /api/health returns 200 JSON {status:"ok"}', async () => {
-    const res = await bridge(new Request('http://localhost/api/health'))
-    expect(res.status).toBe(200)
-    expect(res.headers.get('content-type')).toContain('application/json')
-    const data = await res.json() as { status: string; service: string }
-    expect(data.status).toBe('ok')
-    expect(data.service).toBe('kitchen-sink')
-  })
-
-  it('GET /api/posts returns 200 JSON array', async () => {
-    const res = await bridge(new Request('http://localhost/api/posts'))
-    expect(res.status).toBe(200)
-    const data = await res.json() as unknown[]
-    expect(Array.isArray(data)).toBe(true)
-    expect(data.length).toBeGreaterThan(0)
-  })
-
-  it('GET /api/posts/:slug returns the matching post', async () => {
-    const res = await bridge(new Request('http://localhost/api/posts/first-post'))
-    expect(res.status).toBe(200)
-    const post = await res.json() as { slug: string; title: string }
-    expect(post.slug).toBe('first-post')
-    expect(post.title).toBe('First Post')
-  })
-
-  it('GET /api/posts/:slug returns 404 for unknown slug', async () => {
-    const res = await bridge(new Request('http://localhost/api/posts/does-not-exist'))
-    expect(res.status).toBe(404)
-  })
-
-  it('GET /api/unknown-route returns 404', async () => {
-    // No handler registered — the bridge exhausts apiRoutes and returns 404.
-    const res = await bridge(new Request('http://localhost/api/unknown-route'))
-    expect(res.status).toBe(404)
-  })
-
-  // ─── Request method routing ──────────────────────────────────────────────────
-
-  it('routes GET and POST independently — POST /api/health (no handler) returns 404', async () => {
-    // The health handler only registers GET. The bridge looks for
-    // handlers['post'] ?? handlers['POST'] ?? handlers['default'] — none exist.
-    const res = await bridge(new Request('http://localhost/api/health', { method: 'POST' }))
-    expect(res.status).toBe(404)
-  })
-
-  // ─── Response integrity ──────────────────────────────────────────────────────
-
-  it('API response body is valid JSON (not truncated)', async () => {
-    const res = await bridge(new Request('http://localhost/api/posts'))
-    const text = await res.text()
-    // Must parse without throwing — proves the buffer was not cut short.
-    expect(() => JSON.parse(text)).not.toThrow()
-  })
-
-  it('HTML response body is not empty', async () => {
-    const res = await bridge(new Request('http://localhost/'))
-    const body = await res.text()
-    expect(body.length).toBeGreaterThan(100)
-  })
-})

package/src/__tests__/cli/adapters/netlify.test.ts

@@ -1,286 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from 'node:fs'
-import { join } from 'pathe'
-import { tmpdir } from 'node:os'
-import { runNetlifyAdapter } from '../../../cli/adapters/netlify.js'
-
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
-function createTempRoot(): string {
-  const dir = join(tmpdir(), `cer-netlify-test-${Date.now()}-${Math.random().toString(36).slice(2)}`)
-  mkdirSync(dir, { recursive: true })
-  return dir
-}
-
-function writeFile(root: string, rel: string, content = 'content'): void {
-  const full = join(root, rel)
-  mkdirSync(join(full, '..'), { recursive: true })
-  writeFileSync(full, content)
-}
-
-function readText(root: string, rel: string): string {
-  return readFileSync(join(root, rel), 'utf-8')
-}
-
-// ─── SSR mode ────────────────────────────────────────────────────────────────
-
-describe('runNetlifyAdapter — SSR mode', () => {
-  let root: string
-
-  beforeEach(() => {
-    root = createTempRoot()
-    writeFile(root, 'dist/server/server.js', '// server bundle')
-    writeFile(root, 'dist/client/index.html', '<html></html>')
-    writeFile(root, 'dist/client/assets/main-abc.js', '// asset')
-    writeFile(root, 'dist/client/favicon.ico', 'ico')
-    // No ssg-manifest.json → SSR mode
-  })
-
-  afterEach(() => {
-    rmSync(root, { recursive: true, force: true })
-  })
-
-  it('writes netlify/functions/ssr.mjs', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, 'netlify/functions/ssr.mjs'))).toBe(true)
-  })
-
-  it('bridge imports from dist/server/server.js (relative from function location)', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain("from '../../dist/server/server.js'")
-  })
-
-  it('bridge imports isrHandler and uses it for SSR fallback (enables ISR stale-while-revalidate)', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('isrHandler')
-    expect(bridge).toContain('isrHandler(nodeReq, res)')
-  })
-
-  it('bridge does not import unused handler export (only isrHandler is needed)', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    // isrHandler wraps handler internally — the bridge only needs isrHandler
-    expect(bridge).not.toMatch(/import\s*\{[^}]*\bhandler\b[^}]*\}/)
-  })
-
-  it('bridge exports a default async function', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('export default async')
-  })
-
-  it('bridge converts Web Request to Node.js-style request (toNodeRequest)', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('toNodeRequest')
-    expect(bridge).toContain("from 'node:stream'")
-  })
-
-  it('bridge returns a streaming Web API Response (TransformStream body)', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('new Response(readable,')
-    expect(bridge).toContain('TransformStream')
-    expect(bridge).not.toContain('Buffer.concat')
-  })
-
-  it('streaming Response carries status code and accumulated response headers', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    // end() resolves with new Response(readable, { status: res.statusCode, headers })
-    expect(bridge).toContain('res.statusCode')
-    expect(bridge).toContain('{ status: res.statusCode, headers }')
-  })
-
-  it('bridge streams chunks via writer.write() instead of buffering', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('writer.write(')
-    expect(bridge).toContain('writer.close()')
-  })
-
-  it('bridge uses TextEncoder to convert string chunks to Uint8Array', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('encoder.encode(chunk)')
-    expect(bridge).toContain('new TextEncoder()')
-  })
-
-  it('bridge silently swallows writer rejections to prevent UnhandledPromiseRejection on client disconnect', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('.catch(() => {})')
-    expect(bridge).toContain('writer.close().catch(() => {})')
-  })
-
-  it('bridge handles /api/* routing', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain("urlPath.startsWith('/api/')")
-    expect(bridge).toContain('matchApiPattern')
-    expect(bridge).toContain('apiRoutes')
-  })
-
-  it('bridge wraps API handlers in runWithRequestContext for cookie/session access', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('runWithRequestContext')
-    expect(bridge).toContain('runWithRequestContext(nodeReq, res, () => Promise.resolve(fn(nodeReq, res)))')
-  })
-
-  it('bridge attaches req.query (parsed query string) in toNodeRequest', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('parseQuery')
-    expect(bridge).toContain('req.query = parseQuery(')
-  })
-
-  it('bridge attaches req.body (parsed JSON body) in toNodeRequest', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('req.body =')
-    expect(bridge).toContain("'application/json'")
-    expect(bridge).toContain('JSON.parse(')
-  })
-
-  it('bridge mock res has writableEnded guard to prevent double end()', async () => {
-    await runNetlifyAdapter(root)
-    const bridge = readText(root, 'netlify/functions/ssr.mjs')
-    expect(bridge).toContain('writableEnded')
-    expect(bridge).toContain('if (_ended) return')
-  })
-
-  it('writes netlify.toml', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, 'netlify.toml'))).toBe(true)
-  })
-
-  it('netlify.toml publish points to .netlify/publish', async () => {
-    await runNetlifyAdapter(root)
-    const toml = readText(root, 'netlify.toml')
-    expect(toml).toContain('publish = ".netlify/publish"')
-  })
-
-  it('netlify.toml has catch-all redirect to /.netlify/functions/ssr', async () => {
-    await runNetlifyAdapter(root)
-    const toml = readText(root, 'netlify.toml')
-    expect(toml).toContain('to = "/.netlify/functions/ssr"')
-    expect(toml).toContain('status = 200')
-  })
-
-  it('netlify.toml sets immutable Cache-Control header for /assets/*', async () => {
-    await runNetlifyAdapter(root)
-    const toml = readText(root, 'netlify.toml')
-    expect(toml).toContain('for = "/assets/*"')
-    expect(toml).toContain('public, max-age=31536000, immutable')
-  })
-
-  it('copies content-hashed assets to .netlify/publish/assets/', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/assets/main-abc.js'))).toBe(true)
-  })
-
-  it('copies other public files (favicon.ico) to .netlify/publish/', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/favicon.ico'))).toBe(true)
-  })
-
-  it('does NOT copy index.html to .netlify/publish/ (handled by SSR function)', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/index.html'))).toBe(false)
-  })
-
-  it('cleans existing .netlify/publish/ before writing', async () => {
-    writeFile(root, '.netlify/publish/stale.txt', 'old')
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/stale.txt'))).toBe(false)
-  })
-
-  it('throws if dist/ does not exist', async () => {
-    rmSync(join(root, 'dist'), { recursive: true, force: true })
-    await expect(runNetlifyAdapter(root)).rejects.toThrow("Run 'cer-app build' first")
-  })
-})
-
-// ─── SPA mode ────────────────────────────────────────────────────────────────
-
-describe('runNetlifyAdapter — SPA mode', () => {
-  let root: string
-
-  beforeEach(() => {
-    root = createTempRoot()
-    writeFile(root, 'dist/index.html', '<html></html>')
-    writeFile(root, 'dist/assets/app-abc.js', '// app')
-  })
-
-  afterEach(() => {
-    rmSync(root, { recursive: true, force: true })
-  })
-
-  it('does NOT write netlify/functions/ssr.mjs', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, 'netlify/functions/ssr.mjs'))).toBe(false)
-  })
-
-  it('writes netlify.toml with publish = "dist"', async () => {
-    await runNetlifyAdapter(root)
-    const toml = readText(root, 'netlify.toml')
-    expect(toml).toContain('publish = "dist"')
-  })
-
-  it('netlify.toml has SPA fallback redirect to /index.html', async () => {
-    await runNetlifyAdapter(root)
-    const toml = readText(root, 'netlify.toml')
-    expect(toml).toContain('to = "/index.html"')
-    expect(toml).toContain('status = 200')
-  })
-})
-
-// ─── SSG mode ────────────────────────────────────────────────────────────────
-
-describe('runNetlifyAdapter — SSG mode', () => {
-  let root: string
-
-  beforeEach(() => {
-    root = createTempRoot()
-    writeFile(root, 'dist/server/server.js', '// server bundle')
-    writeFile(root, 'dist/ssg-manifest.json', '{}')
-    writeFile(root, 'dist/index.html', '<html>root</html>')
-    writeFile(root, 'dist/about/index.html', '<html>about</html>')
-    writeFile(root, 'dist/client/index.html', '<html>shell</html>')
-    writeFile(root, 'dist/client/assets/main-abc.js', '// asset')
-  })
-
-  afterEach(() => {
-    rmSync(root, { recursive: true, force: true })
-  })
-
-  it('does NOT write netlify/functions/ssr.mjs', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, 'netlify/functions/ssr.mjs'))).toBe(false)
-  })
-
-  it('copies pre-rendered HTML to .netlify/publish/', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/index.html'))).toBe(true)
-    expect(existsSync(join(root, '.netlify/publish/about/index.html'))).toBe(true)
-  })
-
-  it('copies assets to .netlify/publish/assets/', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/assets/main-abc.js'))).toBe(true)
-  })
-
-  it('does NOT copy ssg-manifest.json to publish dir', async () => {
-    await runNetlifyAdapter(root)
-    expect(existsSync(join(root, '.netlify/publish/ssg-manifest.json'))).toBe(false)
-  })
-
-  it('netlify.toml has SPA fallback redirect', async () => {
-    await runNetlifyAdapter(root)
-    const toml = readText(root, 'netlify.toml')
-    expect(toml).toContain('to = "/index.html"')
-  })
-})

package/src/__tests__/cli/adapters/vercel-launcher.integration.test.ts

@@ -1,129 +0,0 @@
-/**
- * Vercel SSR launcher — integration tests.
- *
- * These tests exercise the full request/response pipeline through the generated
- * `.vercel/output/functions/index.func/index.js` launcher: Node.js req/res →
- * server middleware → API route handler / SSR handler.
- *
- * Prerequisites (run automatically via `npm run e2e:integration:vercel`):
- *   1. `cer-app build --mode ssr --root e2e/kitchen-sink`
- *   2. `cer-app adapt --platform vercel --root e2e/kitchen-sink`
- *
- * When the launcher does not exist (e.g. during a normal `npm test` run) the
- * entire suite is skipped — no failures, no noise.
- */
-
-import { describe, it, expect, beforeAll } from 'vitest'
-import { existsSync } from 'node:fs'
-import { resolve } from 'pathe'
-import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'
-import { AddressInfo } from 'node:net'
-
-// ─── Paths ────────────────────────────────────────────────────────────────────
-
-const KITCHEN_SINK = resolve(import.meta.dirname, '../../../../e2e/kitchen-sink')
-const LAUNCHER_PATH = resolve(KITCHEN_SINK, '.vercel/output/functions/index.func/index.js')
-const SERVER_BUNDLE = resolve(KITCHEN_SINK, 'dist/server/server.js')
-const launcherExists = existsSync(LAUNCHER_PATH) && existsSync(SERVER_BUNDLE)
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-type LauncherFn = (req: IncomingMessage, res: ServerResponse) => Promise<void>
-
-/** Starts a real HTTP server backed by the Vercel launcher and returns its base URL. */
-async function startServer(launcher: LauncherFn): Promise<{ url: string; close: () => Promise<void> }> {
-  const server = createServer((req, res) => {
-    Promise.resolve(launcher(req, res)).catch((err) => {
-      if (!res.headersSent) res.writeHead(500)
-      res.end(String(err))
-    })
-  })
-  await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve))
-  const { port } = server.address() as AddressInfo
-  return {
-    url: `http://127.0.0.1:${port}`,
-    close: () => new Promise((resolve, reject) => server.close((err) => (err ? reject(err) : resolve()))),
-  }
-}
-
-// ─── Suite ───────────────────────────────────────────────────────────────────
-
-describe.skipIf(!launcherExists)('Vercel SSR launcher — integration', () => {
-  let launcher: LauncherFn
-  let baseUrl: string
-  let closeServer: () => Promise<void>
-
-  beforeAll(async () => {
-    const mod = await import(LAUNCHER_PATH)
-    launcher = mod.default as LauncherFn
-    const srv = await startServer(launcher)
-    baseUrl = srv.url
-    closeServer = srv.close
-  })
-
-  // afterAll not available at top level — server runs for suite duration
-
-  // ─── HTML rendering ────────────────────────────────────────────────────────
-
-  it('GET / returns 200 with Content-Type text/html', async () => {
-    const res = await fetch(`${baseUrl}/`)
-    expect(res.status).toBe(200)
-    expect(res.headers.get('content-type')).toContain('text/html')
-    await closeServer()
-  })
-
-  it('GET / response is a complete HTML document', async () => {
-    const srv = await startServer(launcher)
-    const res = await fetch(`${srv.url}/`)
-    const body = await res.text()
-    expect(body).toContain('<!DOCTYPE html')
-    expect(body).toContain('</html>')
-    await srv.close()
-  })
-
-  it('GET / SSR body includes kitchen-sink content', async () => {
-    const srv = await startServer(launcher)
-    const res = await fetch(`${srv.url}/`)
-    const body = await res.text()
-    expect(body).toContain('Kitchen Sink')
-    await srv.close()
-  })
-
-  // ─── API routes ───────────────────────────────────────────────────────────
-
-  it('GET /api/health returns 200 JSON {status:"ok"}', async () => {
-    const srv = await startServer(launcher)
-    const res = await fetch(`${srv.url}/api/health`)
-    expect(res.status).toBe(200)
-    const data = await res.json() as { status: string; service: string }
-    expect(data.status).toBe('ok')
-    expect(data.service).toBe('kitchen-sink')
-    await srv.close()
-  })
-
-  it('GET /api/posts returns 200 JSON array', async () => {
-    const srv = await startServer(launcher)
-    const res = await fetch(`${srv.url}/api/posts`)
-    expect(res.status).toBe(200)
-    const data = await res.json() as unknown[]
-    expect(Array.isArray(data)).toBe(true)
-    expect(data.length).toBeGreaterThan(0)
-    await srv.close()
-  })
-
-  it('GET /api/unknown-route returns 404', async () => {
-    const srv = await startServer(launcher)
-    const res = await fetch(`${srv.url}/api/unknown-route`)
-    expect(res.status).toBe(404)
-    await srv.close()
-  })
-
-  // ─── Server middleware ────────────────────────────────────────────────────
-
-  it('server middleware injects X-CER-Middleware header', async () => {
-    const srv = await startServer(launcher)
-    const res = await fetch(`${srv.url}/`)
-    expect(res.headers.get('x-cer-middleware')).toBe('active')
-    await srv.close()
-  })
-})