test(zip): ZIP 검증 강화 5차 - extras(robots.txt/manifest) 내용 검증 추가

components/BuilderClientPage.tsx

@@ -6,6 +6,7 @@ import { pageSchema, type Page } from '@/lib/schema/page'
 import { exportPage } from '@/lib/exporter/html'
 import { AssetManager } from '@/lib/assets/assetManager'
 import { buildZip } from '@/lib/exporter/zip'
+import { buildExtrasForPage } from '@/lib/exporter/extras'
 import type { Section } from '@/lib/state/store'
 import { createFormStore, type FormState } from '@/lib/state/formStore'
 import FormBuilderPanel from '@/components/FormBuilderPanel'
@@ -196,7 +197,8 @@ export default function BuilderClientPage() {
       }
     } catch {}
     const assets = am ? am.toZipStructure() : {}
-    const zipBytes = await buildZip({ html: exported.html, css: exported.css, js: exported.js, assets })
+    const extras = buildExtrasForPage(valid)
+    const zipBytes = await buildZip({ html: exported.html, css: exported.css, js: exported.js, assets, extras })
     download('landing.zip', zipBytes)
   }, [pageData, am])
 

lib/exporter/extras.ts

@@ -0,0 +1,62 @@
+import type { Page } from '@/lib/schema/page'
+
+// Sheets 템플릿 등 ZIP 루트/서브 경로에 포함할 추가 파일(extras)을 구성한다.
+// - actionUrl이 비어있을 때만 Google Apps Script 템플릿을 포함한다.
+export function buildExtrasForPage(page: Page): Record<string, Uint8Array> {
+  const extras: Record<string, Uint8Array> = {}
+  const te = new TextEncoder()
+
+  // Always provide a baseline robots.txt
+  const robots = `User-agent: *\nDisallow:`
+  extras['robots.txt'] = te.encode(robots)
+
+  // Provide a minimal site.webmanifest derived from Page
+  try {
+    const name = page.title || 'App'
+    const short = name.length > 12 ? name.slice(0, 12) : name
+    const manifest = {
+      name,
+      short_name: short,
+      start_url: '/',
+      display: 'standalone',
+      theme_color: page.theme?.primaryColor ?? '#000000',
+    }
+    extras['site.webmanifest'] = te.encode(JSON.stringify(manifest))
+  } catch {}
+
+  const hasAction = !!(page.form?.actionUrl && page.form.actionUrl.trim().length > 0)
+  if (!hasAction) {
+    const code = `// Google Apps Script (Code.gs)
+// - Web App 으로 배포 후, 아래 doPost 핸들러가 폼 데이터를 수신합니다.
+// - 시트에 저장하거나 이메일 전송 로직을 추가하세요.
+function doPost(e) {
+  try {
+    var data = e.parameter || {}
+    // TODO: 시트에 저장 예시
+    // var ss = SpreadsheetApp.getActiveSpreadsheet()
+    // var sheet = ss.getSheetByName('Responses') || ss.insertSheet('Responses')
+    // sheet.appendRow([new Date(), JSON.stringify(data)])
+    return ContentService.createTextOutput(JSON.stringify({ ok: true }))
+      .setMimeType(ContentService.MimeType.JSON)
+  } catch (err) {
+    return ContentService.createTextOutput(JSON.stringify({ ok: false, error: String(err) }))
+      .setMimeType(ContentService.MimeType.JSON)
+  }
+}
+`
+    const readme = `README (Google Sheets Apps Script 템플릿)
+
+1) Google Drive에서 새 스크립트(Apps Script) 프로젝트를 생성합니다.
+2) Code.gs 파일 내용을 붙여넣습니다.
+3) Deploy > New deployment > Web app 으로 배포합니다.
+   - Execute as: Me
+   - Who has access: Anyone
+4) 배포 URL을 복사하여 빌더의 Form action URL에 넣습니다.
+5) 필요한 경우 doPost에서 스프레드시트 저장 로직을 추가하세요.
+`
+    extras['sheets/Code.gs'] = te.encode(code)
+    extras['sheets/README.txt'] = te.encode(readme)
+  }
+
+  return extras
+}

lib/exporter/manifest.robots.auto.test.ts

@@ -0,0 +1,37 @@
+import { describe, it, expect } from 'vitest'
+import { pageSchema, type Page } from '@/lib/schema/page'
+import { buildExtrasForPage } from '@/lib/exporter/extras'
+
+function makePage(overrides: Partial<Page> = {}): Page {
+  const base: Page = pageSchema.parse({
+    title: 'My Landing',
+    locale: 'en',
+    theme: { primaryColor: '#2563eb', fontFamily: 'Inter' },
+    sections: [],
+    form: { actionUrl: '', fields: [], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } },
+    seo: { title: 'SEO Title', description: 'desc' },
+  })
+  return { ...base, ...overrides }
+}
+
+describe('extras 자동 생성: site.webmanifest / robots.txt', () => {
+  it('Page에서 파생된 site.webmanifest JSON과 robots.txt를 extras에 포함한다', async () => {
+    const page = makePage({ title: 'Awesome App', theme: { primaryColor: '#123456', fontFamily: 'Inter' } })
+    const extras = buildExtrasForPage(page)
+
+    // robots.txt 존재 및 베이스라인 확인
+    expect(Object.keys(extras)).toContain('robots.txt')
+    const robots = new TextDecoder().decode(extras['robots.txt'])
+    expect(robots).toMatch(/User-agent: \*/)
+
+    // manifest 존재 및 필수 키 확인
+    expect(Object.keys(extras)).toContain('site.webmanifest')
+    const manifestStr = new TextDecoder().decode(extras['site.webmanifest'])
+    const manifest = JSON.parse(manifestStr)
+    expect(manifest.name).toBe('Awesome App')
+    expect(manifest.short_name.length).toBeGreaterThan(0)
+    expect(manifest.start_url).toBe('/')
+    expect(manifest.display).toBe('standalone')
+    expect(manifest.theme_color).toBe('#123456')
+  })
+})

lib/exporter/sheets.template.test.ts

@@ -0,0 +1,47 @@
+import { describe, it, expect } from 'vitest'
+import { buildZip } from '@/lib/exporter/zip'
+import { exportPage } from '@/lib/exporter/html'
+import { pageSchema, type Page } from '@/lib/schema/page'
+import { buildExtrasForPage } from '@/lib/exporter/extras'
+
+function makePageNoAction(): Page {
+  return pageSchema.parse({
+    title: 'Sheets Tpl',
+    locale: 'en',
+    theme: { primaryColor: '#2563eb', fontFamily: 'Inter' },
+    sections: [ { type: 'hero', props: { heading: 'Hello', subheading: 'World', imageUrl: 'https://img/h.png' } } ],
+    form: { actionUrl: '', fields: [ { type: 'text', name: 'email', label: 'Email', required: true } ], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } },
+    seo: { title: 't', description: 'd' },
+  })
+}
+
+function makePageWithAction(): Page {
+  return pageSchema.parse({
+    title: 'Sheets Off',
+    locale: 'en',
+    theme: { primaryColor: '#2563eb', fontFamily: 'Inter' },
+    sections: [ { type: 'hero', props: { heading: 'Hello', subheading: 'World', imageUrl: 'https://img/h.png' } } ],
+    form: { actionUrl: 'https://example.com/submit', fields: [], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } },
+    seo: { title: 't', description: 'd' },
+  })
+}
+
+describe('Sheets 템플릿 Export', () => {
+  it('actionUrl 미지정 시 extras에 Sheets 템플릿 파일을 포함한다', async () => {
+    const page = makePageNoAction()
+    const extras = buildExtrasForPage(page)
+    expect(Object.keys(extras)).toContain('sheets/Code.gs')
+    expect(Object.keys(extras)).toContain('sheets/README.txt')
+
+    const out = exportPage(page)
+    const zipBytes = await buildZip({ html: out.html, css: out.css, js: out.js, assets: {}, extras })
+    expect(zipBytes.byteLength).toBeGreaterThan(0)
+  })
+
+  it('actionUrl 지정 시 extras에는 Sheets 템플릿이 포함되지 않는다', () => {
+    const page = makePageWithAction()
+    const extras = buildExtrasForPage(page)
+    expect(Object.keys(extras)).not.toContain('sheets/Code.gs')
+    expect(Object.keys(extras)).not.toContain('sheets/README.txt')
+  })
+})

lib/exporter/zip.validation.phase5.test.ts

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest'
+import JSZip from 'jszip'
+import { exportPage } from '@/lib/exporter/html'
+import { buildZip } from '@/lib/exporter/zip'
+import { buildExtrasForPage } from '@/lib/exporter/extras'
+import { pageSchema, type Page } from '@/lib/schema/page'
+
+function makePage(): Page {
+  return pageSchema.parse({
+    title: 'Phase5',
+    locale: 'en',
+    theme: { primaryColor: '#2563eb', fontFamily: 'Inter' },
+    sections: [],
+    form: { actionUrl: '', fields: [], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } },
+    seo: { title: 't', description: 'd' },
+  })
+}
+
+describe('Export ZIP 검증 강화 5차: extras MIME/내용 검증', () => {
+  it('robots.txt는 텍스트이고, site.webmanifest는 유효한 JSON이다', async () => {
+    const page = makePage()
+    const out = exportPage(page)
+    const extras = buildExtrasForPage(page)
+
+    const zipBytes = await buildZip({ html: out.html, css: out.css, js: out.js, assets: {}, extras })
+    const zip = await JSZip.loadAsync(zipBytes)
+
+    // robots.txt 존재 및 텍스트 확인
+    expect(Object.keys(zip.files)).toContain('robots.txt')
+    const robots = await zip.files['robots.txt'].async('string')
+    expect(robots).toMatch(/User-agent: \*/) // baseline
+
+    // site.webmanifest 존재 및 JSON 파싱 가능
+    expect(Object.keys(zip.files)).toContain('site.webmanifest')
+    const manifestStr = await zip.files['site.webmanifest'].async('string')
+    const parsed = JSON.parse(manifestStr)
+    expect(parsed.start_url).toBe('/')
+    expect(parsed.display).toBe('standalone')
+  })
+})