@mandujs/core 0.9.39 → 0.9.40

package/src/seo/render/robots.ts

@@ -0,0 +1,116 @@
+/**
+ * Mandu SEO - Robots.txt Rendering
+ *
+ * RobotsFile 객체를 텍스트 문자열로 변환
+ */
+
+import type { RobotsFile, RobotsRule } from '../types'
+
+/**
+ * 값을 배열로 정규화
+ */
+function toArray<T>(value: T | T[] | undefined): T[] {
+  if (!value) return []
+  return Array.isArray(value) ? value : [value]
+}
+
+/**
+ * 단일 규칙을 텍스트로 변환
+ */
+function renderRule(rule: RobotsRule): string {
+  const lines: string[] = []
+
+  // User-agent
+  const userAgents = toArray(rule.userAgent)
+  if (userAgents.length === 0) {
+    userAgents.push('*')
+  }
+
+  for (const ua of userAgents) {
+    lines.push(`User-agent: ${ua}`)
+  }
+
+  // Allow
+  const allows = toArray(rule.allow)
+  for (const allow of allows) {
+    lines.push(`Allow: ${allow}`)
+  }
+
+  // Disallow
+  const disallows = toArray(rule.disallow)
+  for (const disallow of disallows) {
+    lines.push(`Disallow: ${disallow}`)
+  }
+
+  // Crawl-delay
+  if (rule.crawlDelay !== undefined) {
+    lines.push(`Crawl-delay: ${rule.crawlDelay}`)
+  }
+
+  return lines.join('\n')
+}
+
+/**
+ * RobotsFile 객체를 robots.txt 문자열로 렌더링
+ *
+ * @param robots - Robots 설정 객체
+ * @returns robots.txt 문자열
+ *
+ * @example
+ * ```typescript
+ * const txt = renderRobots({
+ *   rules: [
+ *     { userAgent: '*', allow: '/', disallow: '/admin' },
+ *     { userAgent: 'Googlebot', allow: '/' },
+ *   ],
+ *   sitemap: 'https://example.com/sitemap.xml',
+ * })
+ * ```
+ */
+export function renderRobots(robots: RobotsFile): string {
+  const sections: string[] = []
+
+  // 규칙들
+  const rules = toArray(robots.rules)
+  for (const rule of rules) {
+    sections.push(renderRule(rule))
+  }
+
+  // Host (Yandex 전용)
+  if (robots.host) {
+    sections.push(`Host: ${robots.host}`)
+  }
+
+  // Sitemap
+  const sitemaps = toArray(robots.sitemap)
+  for (const sitemap of sitemaps) {
+    sections.push(`Sitemap: ${sitemap}`)
+  }
+
+  return sections.join('\n\n')
+}
+
+/**
+ * 기본 robots.txt 생성 (모든 크롤러 허용)
+ */
+export function createDefaultRobots(sitemapUrl?: string): RobotsFile {
+  return {
+    rules: {
+      userAgent: '*',
+      allow: '/',
+    },
+    sitemap: sitemapUrl,
+  }
+}
+
+/**
+ * 개발 환경용 robots.txt 생성 (모든 크롤러 차단)
+ */
+export function createDevRobots(): RobotsFile {
+  return {
+    rules: {
+      userAgent: '*',
+      disallow: '/',
+    },
+  }
+}

package/src/seo/render/sitemap.ts

@@ -0,0 +1,137 @@
+/**
+ * Mandu SEO - Sitemap XML Rendering
+ *
+ * Sitemap 배열을 XML 문자열로 변환
+ */
+
+import type { Sitemap, SitemapEntry } from '../types'
+
+/**
+ * XML 이스케이프
+ */
+function escapeXml(str: string): string {
+  return str
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+}
+
+/**
+ * Date를 ISO 문자열로 변환
+ */
+function formatDate(date: string | Date): string {
+  if (date instanceof Date) {
+    return date.toISOString()
+  }
+  return date
+}
+
+/**
+ * 단일 sitemap 항목을 XML로 변환
+ */
+function renderSitemapEntry(entry: SitemapEntry): string {
+  const lines: string[] = ['  <url>']
+
+  lines.push(`    <loc>${escapeXml(entry.url)}</loc>`)
+
+  if (entry.lastModified) {
+    lines.push(`    <lastmod>${formatDate(entry.lastModified)}</lastmod>`)
+  }
+
+  if (entry.changeFrequency) {
+    lines.push(`    <changefreq>${entry.changeFrequency}</changefreq>`)
+  }
+
+  if (entry.priority !== undefined) {
+    lines.push(`    <priority>${entry.priority.toFixed(1)}</priority>`)
+  }
+
+  // 이미지 sitemap 확장
+  if (entry.images && entry.images.length > 0) {
+    for (const image of entry.images) {
+      lines.push('    <image:image>')
+      lines.push(`      <image:loc>${escapeXml(image)}</image:loc>`)
+      lines.push('    </image:image>')
+    }
+  }
+
+  // 다국어 alternate 링크 (xhtml:link)
+  if (entry.alternates?.languages) {
+    for (const [lang, url] of Object.entries(entry.alternates.languages)) {
+      lines.push(`    <xhtml:link rel="alternate" hreflang="${lang}" href="${escapeXml(url)}" />`)
+    }
+  }
+
+  lines.push('  </url>')
+
+  return lines.join('\n')
+}
+
+/**
+ * Sitemap 배열을 XML 문자열로 렌더링
+ *
+ * @param sitemap - Sitemap 항목 배열
+ * @returns XML 문자열
+ *
+ * @example
+ * ```typescript
+ * const xml = renderSitemap([
+ *   { url: 'https://example.com', lastModified: new Date(), priority: 1.0 },
+ *   { url: 'https://example.com/about', changeFrequency: 'monthly' },
+ * ])
+ * ```
+ */
+export function renderSitemap(sitemap: Sitemap): string {
+  const hasImages = sitemap.some(entry => entry.images && entry.images.length > 0)
+  const hasAlternates = sitemap.some(entry => entry.alternates?.languages)
+
+  // XML 네임스페이스 구성
+  const namespaces = ['xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"']
+
+  if (hasImages) {
+    namespaces.push('xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"')
+  }
+
+  if (hasAlternates) {
+    namespaces.push('xmlns:xhtml="http://www.w3.org/1999/xhtml"')
+  }
+
+  const lines: string[] = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<urlset ${namespaces.join(' ')}>`,
+    ...sitemap.map(renderSitemapEntry),
+    '</urlset>',
+  ]
+
+  return lines.join('\n')
+}
+
+/**
+ * Sitemap Index 렌더링 (대규모 사이트용)
+ *
+ * @param sitemaps - 개별 sitemap URL 배열
+ * @returns XML 문자열
+ */
+export function renderSitemapIndex(
+  sitemaps: Array<{ url: string; lastModified?: string | Date }>
+): string {
+  const lines: string[] = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+  ]
+
+  for (const sitemap of sitemaps) {
+    lines.push('  <sitemap>')
+    lines.push(`    <loc>${escapeXml(sitemap.url)}</loc>`)
+    if (sitemap.lastModified) {
+      lines.push(`    <lastmod>${formatDate(sitemap.lastModified)}</lastmod>`)
+    }
+    lines.push('  </sitemap>')
+  }
+
+  lines.push('</sitemapindex>')
+
+  return lines.join('\n')
+}

package/src/seo/render/twitter.ts

@@ -0,0 +1,126 @@
+/**
+ * Mandu SEO - Twitter Card Meta Tags Rendering
+ */
+
+import type { ResolvedMetadata } from '../types'
+import { urlToString } from '../resolve/url'
+
+/**
+ * HTML 이스케이프
+ */
+function escapeHtml(str: string): string {
+  return str
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;')
+}
+
+/**
+ * Twitter 메타 태그 생성 헬퍼
+ */
+function twitter(name: string, content: string | number): string {
+  return `<meta name="twitter:${name}" content="${escapeHtml(String(content))}" />`
+}
+
+/**
+ * Twitter Card 메타 태그 렌더링
+ */
+export function renderTwitter(metadata: ResolvedMetadata): string {
+  const tw = metadata.twitter
+  if (!tw) return ''
+
+  const tags: string[] = []
+
+  // Card type
+  tags.push(twitter('card', tw.card))
+
+  // Site
+  if (tw.site) {
+    tags.push(twitter('site', tw.site))
+  }
+  if (tw.siteId) {
+    tags.push(twitter('site:id', tw.siteId))
+  }
+
+  // Creator
+  if (tw.creator) {
+    tags.push(twitter('creator', tw.creator))
+  }
+  if (tw.creatorId) {
+    tags.push(twitter('creator:id', tw.creatorId))
+  }
+
+  // Title - fallback to OG or metadata title
+  const title = tw.title || metadata.openGraph?.title || metadata.title?.absolute
+  if (title) {
+    tags.push(twitter('title', title))
+  }
+
+  // Description - fallback to OG or metadata description
+  const description = tw.description || metadata.openGraph?.description || metadata.description
+  if (description) {
+    tags.push(twitter('description', description))
+  }
+
+  // Images
+  if (tw.images) {
+    for (let i = 0; i < tw.images.length; i++) {
+      const image = tw.images[i]
+      if (i === 0) {
+        tags.push(twitter('image', urlToString(image.url)))
+        if (image.alt) {
+          tags.push(twitter('image:alt', image.alt))
+        }
+      } else {
+        // Multiple images (for galleries)
+        tags.push(twitter(`image${i}`, urlToString(image.url)))
+        if (image.alt) {
+          tags.push(twitter(`image${i}:alt`, image.alt))
+        }
+      }
+    }
+  }
+
+  // Player card
+  if (tw.players) {
+    for (const player of tw.players) {
+      tags.push(twitter('player', String(player.playerUrl)))
+      if (player.streamUrl) {
+        tags.push(twitter('player:stream', String(player.streamUrl)))
+      }
+      tags.push(twitter('player:width', player.width))
+      tags.push(twitter('player:height', player.height))
+    }
+  }
+
+  // App card
+  if (tw.app) {
+    if (tw.app.name) {
+      tags.push(twitter('app:name:iphone', tw.app.name))
+      tags.push(twitter('app:name:ipad', tw.app.name))
+      tags.push(twitter('app:name:googleplay', tw.app.name))
+    }
+    if (tw.app.id?.iphone) {
+      tags.push(twitter('app:id:iphone', String(tw.app.id.iphone)))
+    }
+    if (tw.app.id?.ipad) {
+      tags.push(twitter('app:id:ipad', String(tw.app.id.ipad)))
+    }
+    if (tw.app.id?.googleplay) {
+      tags.push(twitter('app:id:googleplay', tw.app.id.googleplay))
+    }
+    if (tw.app.url?.iphone) {
+      tags.push(twitter('app:url:iphone', String(tw.app.url.iphone)))
+    }
+    if (tw.app.url?.ipad) {
+      tags.push(twitter('app:url:ipad', String(tw.app.url.ipad)))
+    }
+    if (tw.app.url?.googleplay) {
+      tags.push(twitter('app:url:googleplay', String(tw.app.url.googleplay)))
+    }
+  }
+
+  return tags.join('\n')
+}