@heripo/research-radar 2.0.0 → 2.2.0

package/dist/index.cjs

@@ -5,6 +5,10 @@ var openai = require('@ai-sdk/openai');
 var core = require('@llm-newsletter-kit/core');
 var cheerio = require('cheerio');
 var TurndownService = require('turndown');
+var jsdom = require('jsdom');
+var safeMarkdown2Html = require('safe-markdown2html');
+var DOMPurify = require('dompurify');
+var juice = require('juice');
 
 function _interopNamespaceDefault(e) {
   var n = Object.create(null);
@@ -1727,6 +1731,74 @@ class AnalysisProvider {
     }
 }
 
+/**
+ * Shared HTML fragments used by both newsletter and welcome email templates.
+ *
+ * These helpers extract identical HTML blocks to avoid duplication
+ * while keeping template-specific styling separate.
+ */
+const purify = DOMPurify(new jsdom.JSDOM('').window);
+/**
+ * Sanitize user-supplied strings for safe HTML insertion.
+ * Strips all HTML tags, leaving only plain text.
+ */
+const sanitizeText = (str) => purify.sanitize(str, { ALLOWED_TAGS: [] });
+/**
+ * Heripo light/dark logo block.
+ * @param imgMarginBottom - Margin below the logo image (e.g., '8px', '12px')
+ */
+const heripoLogoHtml = (imgMarginBottom) => `
+            <div style="margin-bottom: 32px;">
+              <div style="text-align: left; display: block;" class="light-logo">
+                <img src="https://heripo.com/heripo-logo.png" width="150" alt="로고" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; line-height: 100%; outline: none; text-decoration: none; display: block; margin-bottom: ${imgMarginBottom};" height="auto">
+              </div>
+              <!--[if !mso]><!-->
+              <div style="text-align: left; display: none;" class="dark-logo">
+                <img src="https://heripo.com/heripo-logo-dark.png" width="150" alt="다크모드 로고" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; line-height: 100%; outline: none; text-decoration: none; display: block; margin-bottom: ${imgMarginBottom};" height="auto">
+              </div>
+              <!--<![endif]-->
+            </div>`;
+/**
+ * KRAS dual-logo header block.
+ * Left: KRAS logo, Right: heripo lab logo (light/dark) + "제공" text.
+ */
+const krasHeaderHtml = () => `
+            <table cellpadding="0" cellspacing="0" width="100%" role="presentation" style="width: 100%; border-collapse: collapse; margin: 0 0 18px 0; mso-table-lspace: 0pt; mso-table-rspace: 0pt; margin-bottom: 20px; border: none;">
+              <tr>
+                <td align="left" valign="middle" width="50%" style="text-align: left; font-size: 15px; font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; padding: 0; border: none;">
+                  <img src="https://heripo.com/kras-logo.jpeg" width="200" alt="한국고고학회" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; line-height: 100%; outline: none; text-decoration: none; display: block;" height="auto">
+                </td>
+                <td align="right" valign="middle" width="50%" style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; padding: 0; border: none; text-align: right; font-size: 0; line-height: 0; white-space: nowrap;">
+                  <div style="text-align: left; display: inline-block; vertical-align: middle; line-height: 0;" class="light-logo">
+                    <img src="https://heripo.com/heripolab-logo.png" width="120" alt="heripo lab" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; outline: none; text-decoration: none; display: inline-block; vertical-align: middle;" height="auto">
+                  </div><!--[if !mso]><!--><div style="text-align: left; display: none; vertical-align: middle; line-height: 0;" class="dark-logo dark-logo-inline">
+                    <img src="https://heripo.com/heripolab-logo-dark.png" width="120" alt="heripo lab" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; outline: none; text-decoration: none; display: inline-block; vertical-align: middle;" height="auto">
+                  </div><!--<![endif]--><span class="header-dark-text" style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 20px; font-weight: normal; color: #666666; line-height: 1; vertical-align: middle; padding-left: 4px;">제공</span>
+                </td>
+              </tr>
+            </table>`;
+/**
+ * Heripo platform introduction section.
+ * Shared between newsletter and welcome email templates.
+ *
+ * Note: Each template may append its own additional paragraph after this block
+ * (e.g., newsletter adds a line about source requests via GitHub Issues).
+ */
+const platformIntroHtml = () => `
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">heripo는 고고학 연구 환경의 실질적인 디지털 전환을 지향하는 연구 플랫폼입니다.</p>
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">발굴조사보고서(PDF) 속에 갇힌 텍스트와 도면을 분석 가능한 구조화된 데이터로 전환하여, 연구자가 자료를 보다 체계적으로 탐색하고 재사용할 수 있는 인프라를 구축하고 있습니다.</p>
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7;
+             color: #444444; margin: 0 0 18px 0;">현재는 소프트웨어 엔지니어와 고고학 연구자가 함께하는 <strong><a href="https://github.com/heripo-lab" target="_blank">heripo lab</a></strong>으로 운영 중이며, 2026년 1월 28일 핵심 엔진을 <strong><a href="https://github.com/heripo-lab/heripo-engine" target="_blank">오픈소스로 공개</a></strong>했습니다.</p>
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">오픈소스로 공개된 핵심 기능은 <strong><a href="https://engine-demo.heripo.com" target="_blank">데모 사이트</a></strong>에서 직접 체험해 보실 수 있으며, 플랫폼 프로토타입 출시 시 구독자분들께 우선 안내해 드리겠습니다.</p>`;
+/**
+ * "Powered by LLM Newsletter Kit · View Source" footer line.
+ */
+const poweredByFooterHtml = () => `
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 14px; line-height: 1.5; color: #999999; margin: 0 0 12px 0;" class="footer-text">
+                Powered by <a href="https://github.com/heripo-lab/llm-newsletter-kit-core" target="_blank" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; transition: color 0.2s; color: #999999; text-decoration: underline;" class="footer-link">LLM Newsletter Kit</a> ·
+                <a href="https://github.com/heripo-lab/heripo-research-radar" target="_blank" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; transition: color 0.2s; color: #999999; text-decoration: underline;" class="footer-link">View Source</a>
+              </p>`;
+
 /**
  * Creates an HTML template for the newsletter email
  *
@@ -1739,16 +1811,18 @@ class AnalysisProvider {
  * - Platform introduction
  *
  * @param targets - Array of crawling targets to be listed in the newsletter footer
+ * @param options - Optional template customization options
  * @returns Complete HTML string for the newsletter email
  *
  * @example
  * ```typescript
- * const html = createNewsletterHtmlTemplate([
- *   { id: '1', name: 'Source 1', url: 'https://example.com', ... }
- * ]);
+ * const html = createNewsletterHtmlTemplate(
+ *   [{ id: '1', name: 'Source 1', url: 'https://example.com', ... }],
+ *   { isKrasNewsletter: true, krasNewsMarkdown: '## News...' },
+ * );
  * ```
  */
-const createNewsletterHtmlTemplate = (targets) => `<!DOCTYPE html>
+const createNewsletterHtmlTemplate = (targets, options) => `<!DOCTYPE html>
 <html lang="ko" style="color-scheme: light dark; supported-color-schemes: light dark;">
 <head>
   <meta charset="UTF-8">
@@ -2126,6 +2200,18 @@ const createNewsletterHtmlTemplate = (targets) => `<!DOCTYPE html>
               background-color: #23201c !important;
           }
 
+
+          .header-dark-text {
+            color: #eeeeee !important;
+          }
+    
+          .header-title-border {
+            border-bottom-color: #E59866 !important;
+          }
+    
+          .dark-logo-inline {
+            display: inline-block !important;
+          }
       }
   </style>
 </head>
@@ -2141,16 +2227,50 @@ const createNewsletterHtmlTemplate = (targets) => `<!DOCTYPE html>
       <table border="0" cellpadding="0" cellspacing="0" width="100%" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt; max-width: 800px;" class="container" role="presentation">
         <tr>
           <td bgcolor="#ffffff" align="left" class="content-cell dark-mode-content-bg" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt; padding: 44px 44px 36px 44px; border-radius: 12px; box-shadow: 0 4px 18px rgba(0,0,0,0.07);">
-            <div style="margin-bottom: 32px;">
-              <div style="text-align: left; display: block;" class="light-logo">
-                <img src="https://heripo.com/heripo-logo.png" width="150" alt="로고" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; line-height: 100%; outline: none; text-decoration: none; display: block; margin-bottom: 12px;" height="auto">
-              </div>
-              <!--[if !mso]><!-->
-              <div style="text-align: left; display: none;" class="dark-logo">
-                <img src="https://heripo.com/heripo-logo-dark.png" width="150" alt="다크모드 로고" style="-ms-interpolation-mode: bicubic; border: 0; height: auto; line-height: 100%; outline: none; text-decoration: none; display: block; margin-bottom: 12px;" height="auto">
-              </div>
-              <!--<![endif]-->
-            </div>
+            ${options?.isKrasNewsletter
+    ? `${krasHeaderHtml()}
+            <!-- 헤더: 제목/날짜 행 -->
+            <table cellpadding="0" cellspacing="0" width="100%" role="presentation" class="header-title-border" style="width: 100%; border-collapse: collapse; margin: 0 0 18px 0; mso-table-lspace: 0pt; mso-table-rspace: 0pt; margin-bottom: 32px; border: none; border-bottom: 3px solid #D2691E;">
+              <tr>
+                <td align="left" valign="baseline" class="header-dark-text" style="text-align: left; padding: 0 0 14px 0; font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 26px; font-weight: bold; color: #111111; line-height: 1.2; border: none;">
+                  한국고고학회 뉴스레터
+                </td>
+                <td align="left" valign="baseline" class="header-dark-text" style="text-align: left; padding: 0 0 14px 0; font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 24px; color: #333333; white-space: nowrap; border: none; width: 1px;" width="1">
+                  ${options?.displayDate ?? ''}
+                </td>
+              </tr>
+            </table>            
+            `
+    : `${heripoLogoHtml('12px')}
+                `}
+
+            ${options?.krasNewsMarkdown
+    ? safeMarkdown2Html(`## 학회 소식
+${options.krasNewsMarkdown}
+
+---
+`, {
+        window: new jsdom.JSDOM('').window,
+        linkTargetBlank: true,
+        fixMalformedUrls: true,
+        fixBoldSyntax: true,
+        convertStrikethrough: true,
+    })
+    : ''}
+            
+            ${options?.heripolabNewsMarkdown
+    ? safeMarkdown2Html(`## heripo lab 소식
+${options.heripolabNewsMarkdown}
+
+---
+`, {
+        window: new jsdom.JSDOM('').window,
+        linkTargetBlank: true,
+        fixMalformedUrls: true,
+        fixBoldSyntax: true,
+        convertStrikethrough: true,
+    })
+    : ''}
 
             {{NEWSLETTER_CONTENT}}
 
@@ -2166,7 +2286,7 @@ const createNewsletterHtmlTemplate = (targets) => `<!DOCTYPE html>
             </ul>
             <hr style="border: 0; border-top: 2px solid #D2691E; margin: 32px 0;">
             <h2 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 24px; font-weight: bold; line-height: 1.3; color: #D2691E; margin: 0 0 16px 0; letter-spacing: -0.2px; border-left: 5px solid #D2691E; padding-left: 12px; background: none;">📅 발행 정책</h2>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;"><strong>heripo 리서치 레이더</strong>는 매일 발행을 원칙으로 하되, 독자분들께 의미 있는 정보를 제공하기 위해 다음과 같은 발행 기준을 적용합니다:</p>
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;"><strong>${options?.isKrasNewsletter ? '한국고고학회' : 'heripo 리서치 레이더'}</strong>는 매일 발행을 원칙으로 하되, 독자분들께 의미 있는 정보를 제공하기 위해 다음과 같은 발행 기준을 적용합니다:</p>
             <ul style="padding-left: 24px; margin: 0 0 18px 0;">
               <li style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0; margin-bottom: 8px;"><strong>정상 발행</strong>: 새로운 소식이 ${newsletterConfig.publicationCriteria.minimumArticleCountForIssue + 1}개 이상이거나, ${newsletterConfig.publicationCriteria.minimumArticleCountForIssue}개 이하여도 중요도 ${newsletterConfig.publicationCriteria.priorityArticleScoreThreshold}점 이상의 핵심 소식이 포함된 경우</li>
               <li style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0; margin-bottom: 8px;"><strong>이월 발행</strong>: 새로운 소식이 ${newsletterConfig.publicationCriteria.minimumArticleCountForIssue}개 이하이면서 중요한 내용(${newsletterConfig.publicationCriteria.priorityArticleScoreThreshold}점 이상)이 없을 경우, 다음 호로 이월하여 더 풍성한 내용으로 제공</li>
@@ -2175,11 +2295,7 @@ const createNewsletterHtmlTemplate = (targets) => `<!DOCTYPE html>
             <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">이러한 정책을 통해 매일 의미 없는 소식으로 독자분들의 시간을 낭비하지 않고, 정말 중요한 정보를 적절한 타이밍에 제공하고자 합니다.</p>
             <hr style="border: 0; border-top: 2px solid #D2691E; margin: 32px 0;">
             <h2 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 24px; font-weight: bold; line-height: 1.3; color: #D2691E; margin: 0 0 16px 0; letter-spacing: -0.2px; border-left: 5px solid #D2691E; padding-left: 12px; background: none;">🔍 heripo(헤리포) 플랫폼 소개</h2>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">heripo는 고고학 연구 환경의 실질적인 디지털 전환을 지향하는 연구 플랫폼입니다.</p>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">발굴조사보고서(PDF) 속에 갇힌 텍스트와 도면을 분석 가능한 구조화된 데이터로 전환하여, 연구자가 자료를 보다 체계적으로 탐색하고 재사용할 수 있는 인프라를 구축하고 있습니다.</p>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7;
-             color: #444444; margin: 0 0 18px 0;">현재는 소프트웨어 엔지니어와 고고학 연구자가 함께하는 <strong><a href="https://github.com/heripo-lab" target="_blank">heripo lab</a></strong>으로 운영 중이며, 2026년 1월 28일 핵심 엔진을 <strong><a href="https://github.com/heripo-lab/heripo-engine" target="_blank">오픈소스로 공개</a></strong>했습니다.</p>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">오픈소스로 공개된 핵심 기능은 <strong><a href="https://engine-demo.heripo.com" target="_blank">데모 사이트</a></strong>에서 직접 체험해 보실 수 있으며, 플랫폼 프로토타입 출시 시 구독자분들께 우선 안내해 드리겠습니다.</p>
+${platformIntroHtml()}
             <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7;
              color: #444444; margin: 0 0 18px 0;">보고 계신 뉴스레터(리서치 레이더)는 heripo의 초기 선행 기능 중 하나입니다. 뉴스레터 소스 추가 요청은 <a href="https://github.com/heripo-lab/heripo-research-radar/issues" target="_blank">GitHub 이슈</a>를 통해 언제든 환영합니다.</p>
             <hr style="border: 0; border-top: 2px solid #D2691E; margin: 32px 0;">
@@ -2192,12 +2308,9 @@ const createNewsletterHtmlTemplate = (targets) => `<!DOCTYPE html>
         <tr>
           <td align="center" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt; padding: 30px 20px; font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 12px; line-height: 1.5; color: #888888;">
             <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 10px 0;" class="footer-text">heripo lab | newsletter@heripo.com</p>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 10px 0;" class="footer-text">이 메일은 heripo.com에서 리서치 레이더를 구독하신 분들에게 발송됩니다.<br>
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 10px 0;" class="footer-text">${options?.isKrasNewsletter ? '이 메일은 heripo.com에서 뉴스레터를 구독하신 분들과 한국고고학회 회원에게 발송됩니다.' : '이 메일은 heripo.com에서 리서치 레이더를 구독하신 분들에게 발송됩니다.'}<br>
               더 이상 이메일을 받고 싶지 않으시면 <a href="{{{RESEND_UNSUBSCRIBE_URL}}}" target="_blank" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; font-weight: bold; transition: color 0.2s; color: #888888; text-decoration: underline;" class="footer-link">여기에서 수신 거부</a>하세요.</p>
-            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 14px; line-height: 1.5; color: #999999; margin: 0;" class="footer-text">
-              Powered by <a href="https://github.com/heripo-lab/llm-newsletter-kit-core" target="_blank" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; transition: color 0.2s; color: #999999; text-decoration: underline;" class="footer-link">LLM Newsletter Kit</a> ·
-              <a href="https://github.com/heripo-lab/heripo-research-radar" target="_blank" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; transition: color 0.2s; color: #999999; text-decoration: underline;" class="footer-link">View Source</a>
-            </p>
+${poweredByFooterHtml()}
           </td>
         </tr>
       </table>
@@ -2224,16 +2337,26 @@ class ContentGenerateProvider {
     newsletterRepository;
     _issueOrder = null;
     model;
-    constructor(google, articleRepository, newsletterRepository) {
+    /** HTML template with markers for title and content injection */
+    htmlTemplate;
+    /** Newsletter brand name (defaults to config, can be overridden via constructor) */
+    newsletterBrandName;
+    constructor(google, articleRepository, newsletterRepository, templateOptions, brandName) {
         this.google = google;
         this.articleRepository = articleRepository;
         this.newsletterRepository = newsletterRepository;
         this.model = this.google('gemini-3-pro-preview');
+        this.newsletterBrandName = brandName ?? newsletterConfig.brandName;
+        this.htmlTemplate = {
+            html: createNewsletterHtmlTemplate(crawlingTargetGroups.flatMap((group) => group.targets), templateOptions),
+            markers: {
+                title: 'NEWSLETTER_TITLE',
+                content: 'NEWSLETTER_CONTENT',
+            },
+        };
     }
     /** LLM temperature setting for content generation */
     temperature = llmConfig.generation.temperature;
-    /** Newsletter brand name */
-    newsletterBrandName = newsletterConfig.brandName;
     /** Subscribe page URL */
     subscribePageUrl = newsletterConfig.subscribePageUrl;
     /** Publication criteria (minimum article count, priority score threshold) */
@@ -2261,14 +2384,6 @@ class ContentGenerateProvider {
     async fetchArticleCandidates() {
         return this.articleRepository.findCandidatesForNewsletter();
     }
-    /** HTML template with markers for title and content injection */
-    htmlTemplate = {
-        html: createNewsletterHtmlTemplate(crawlingTargetGroups.flatMap((group) => group.targets)),
-        markers: {
-            title: 'NEWSLETTER_TITLE',
-            content: 'NEWSLETTER_CONTENT',
-        },
-    };
     /**
      * Save generated newsletter to the repository
      * @param input - Newsletter data and used articles
@@ -2317,8 +2432,35 @@ class CrawlingProvider {
  * Date service implementation
  * - Provides current date and display date strings
  * - Always returns Korea Standard Time (KST, Asia/Seoul) regardless of server timezone
+ * - Accepts optional publishDate to override the current date (e.g., for next-day publishing)
  */
 class DateService {
+    targetDate;
+    /**
+     * @param publishDate - Optional ISO date string (YYYY-MM-DD) to use instead of current date.
+     *                       When provided, the newsletter will use this date as its publication date.
+     * @throws {Error} If publishDate is not in YYYY-MM-DD format or is not a real calendar date.
+     */
+    constructor(publishDate) {
+        if (publishDate !== undefined) {
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(publishDate)) {
+                throw new Error(`Invalid publishDate format: "${publishDate}". Expected YYYY-MM-DD (e.g., "2025-02-12").`);
+            }
+            const date = new Date(publishDate + 'T00:00:00+09:00');
+            // Round-trip check: format back to YYYY-MM-DD in KST and compare.
+            // Catches invalid dates like "2025-02-30" that JS silently normalizes to "2025-03-02".
+            const roundTrip = date.toLocaleDateString('en-CA', {
+                timeZone: 'Asia/Seoul',
+            });
+            if (roundTrip !== publishDate) {
+                throw new Error(`Invalid publishDate: "${publishDate}" is not a real calendar date.`);
+            }
+            this.targetDate = date;
+        }
+        else {
+            this.targetDate = new Date();
+        }
+    }
     /**
      * Get current date in ISO format (YYYY-MM-DD)
      * - Always returns date in Korea Standard Time (UTC+9)
@@ -2327,7 +2469,7 @@ class DateService {
     getCurrentISODateString() {
         // Use Intl.DateTimeFormat to get date in Korea timezone
         // 'en-CA' locale returns YYYY-MM-DD format by default
-        const kstDate = new Date().toLocaleDateString('en-CA', {
+        const kstDate = this.targetDate.toLocaleDateString('en-CA', {
             timeZone: 'Asia/Seoul',
         });
         return kstDate;
@@ -2344,7 +2486,7 @@ class DateService {
             month: 'long',
             day: 'numeric',
         });
-        return formatter.format(new Date());
+        return formatter.format(this.targetDate);
     }
 }
 
@@ -2418,13 +2560,31 @@ function createNewsletterGenerator(dependencies) {
     const google$1 = google.createGoogleGenerativeAI({
         apiKey: dependencies.googleGenerativeAIApiKey,
     });
-    const dateService = new DateService();
+    const dateService = new DateService(dependencies.publishDate);
     const taskService = new TaskService(dependencies.taskRepository);
     const crawlingProvider = new CrawlingProvider(dependencies.articleRepository);
     const analysisProvider = new AnalysisProvider(openai$1, dependencies.articleRepository, dependencies.tagRepository);
-    const contentGenerateProvider = new ContentGenerateProvider(google$1, dependencies.articleRepository, dependencies.newsletterRepository);
+    // Inject display date from DateService into template options
+    const templateOptions = dependencies.templateOptions
+        ? {
+            ...dependencies.templateOptions,
+            displayDate: dateService.getDisplayDateString(),
+        }
+        : undefined;
+    let resolvedContentOptions = { ...contentOptions };
+    let resolvedBrandName = newsletterConfig.brandName;
+    if (templateOptions?.isKrasNewsletter) {
+        resolvedContentOptions = {
+            ...resolvedContentOptions,
+            expertField: ['고고학 우선적 문화유산'],
+            freeFormIntro: true,
+            titleContext: templateOptions.titleContext || undefined,
+        };
+        resolvedBrandName = '한국고고학회 뉴스레터';
+    }
+    const contentGenerateProvider = new ContentGenerateProvider(google$1, dependencies.articleRepository, dependencies.newsletterRepository, templateOptions, resolvedBrandName);
     return new core.GenerateNewsletter({
-        contentOptions,
+        contentOptions: resolvedContentOptions,
         dateService,
         taskService,
         crawlingProvider,
@@ -2467,6 +2627,259 @@ async function generateNewsletter(dependencies) {
     return generator.generate();
 }
 
+/**
+ * Generates a welcome email HTML string with CSS inlined via juice.
+ *
+ * API is designed to match the original heripo-web `generateWelcomeHTML(id, name)` usage,
+ * with an optional third parameter for KRAS mode and site URL override.
+ *
+ * @param id - Subscriber ID (used for unsubscribe links in default mode)
+ * @param name - Subscriber display name
+ * @param options - Optional configuration for KRAS mode and site URL
+ * @returns Complete HTML string with CSS inlined (ready to send as email)
+ *
+ * @example
+ * ```typescript
+ * // Default heripo branding (same as original heripo-web usage):
+ * const html = generateWelcomeHTML('subscriber-123', '홍길동');
+ *
+ * // KRAS mode:
+ * const krasHtml = generateWelcomeHTML('subscriber-123', '홍길동', {
+ *   isKrasNewsletter: true,
+ * });
+ * ```
+ */
+function generateWelcomeHTML(id, name, options) {
+    const isKras = options?.isKrasNewsletter ?? false;
+    const siteUrl = options?.siteUrl ?? 'https://heripo.com';
+    const safeName = sanitizeText(name);
+    const unsubscribeUrl = isKras
+        ? '{{{RESEND_UNSUBSCRIBE_URL}}}'
+        : `${siteUrl}/research-radar/unsubscribe?id=${id}`;
+    return juice(createWelcomeHtmlRaw(safeName, isKras, siteUrl, unsubscribeUrl));
+}
+function createWelcomeHtmlRaw(name, isKras, siteUrl, unsubscribeUrl) {
+    const title = isKras
+        ? '한국고고학회 뉴스레터 구독 완료'
+        : 'heripo 리서치 레이더 구독 완료';
+    const headerHtml = isKras
+        ? `${krasHeaderHtml()}
+            <h1 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; line-height: 1.2; margin: 0 0
+            18px 0; letter-spacing: -0.5px; margin-top: 0; font-size: 32px; font-weight: bold; color: #111111; border-bottom: 3px solid #D2691E; padding-bottom: 8px;">${name}님, 한국고고학회 뉴스레터를 구독해주셔서 감사합니다.</h1>`
+        : `${heripoLogoHtml('8px')}
+
+            <h1 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; line-height: 1.2; margin: 0 0
+            18px 0; letter-spacing: -0.5px; margin-top: 0; font-size: 32px; font-weight: bold; color: #111111; border-bottom: 3px solid #D2691E; padding-bottom: 8px;">${name}님, heripo 리서치 레이더에 오신 것을 환영합니다!</h1>`;
+    const feedbackHeading = `${name}님의 목소리가 heripo의 미래를 만듭니다`;
+    const feedbackText = 'heripo';
+    const newsletterLine = isKras
+        ? `<p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">뉴스레터(리서치 레이더)는 heripo의 초기 선행 기능 중 하나입니다. 뉴스레터 소스 추가 요청은 <a href="https://github.com/heripo-lab/heripo-research-radar/issues" target="_blank">GitHub 이슈</a>를 통해 언제든 환영합니다.</p>`
+        : `<p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">뉴스레터(리서치 레이더)는 heripo의 초기 선행 기능 중 하나입니다. 뉴스레터 소스 추가 요청은 <a href="https://github.com/heripo-lab/heripo-research-radar/issues" target="_blank">GitHub 이슈</a>를 통해 언제든 환영합니다.</p>`;
+    const warningHtml = isKras
+        ? `
+            <blockquote style="background-color: #fef2f2; border-left: 5px solid #dc2626; margin: 24px 0; padding: 20px; border-radius: 4px;">
+              <h3 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 18px; font-weight: bold; line-height: 1.3; color: #dc2626; margin: 0 0 10px 0; letter-spacing: -0.1px;">⚠️ 본인이 신청하지 않으셨다면</h3>
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0; margin-bottom: 10px;">만약 본인이 직접 구독 신청을 하지 않으셨다면, 다른 분이 실수로 이메일 주소를 입력했을 가능성이 있습니다. 이 경우 아래 링크를 통해 즉시 수신을 거부하실 수 있습니다.</p>
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0;"><a href="${unsubscribeUrl}" style="color: #dc2626; font-weight: bold;">🚫 수신 거부하기</a></p>
+            </blockquote>`
+        : `
+            <blockquote style="background-color: #fef2f2; border-left: 5px solid #dc2626; margin: 24px 0; padding: 20px; border-radius: 4px;">
+              <h3 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 18px; font-weight: bold; line-height: 1.3; color: #dc2626; margin: 0 0 10px 0; letter-spacing: -0.1px;">⚠️ 본인이 신청하지 않으셨다면</h3>
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0; margin-bottom: 10px;">만약 본인이 직접 구독 신청을 하지 않으셨다면, 다른 분이 실수로 이메일 주소를 입력했을 가능성이 있습니다. 이 경우 아래 링크를 통해 즉시 수신을 거부하실 수 있습니다.</p>
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0;"><a href="${unsubscribeUrl}" style="color: #dc2626; font-weight: bold;">🚫 수신 거부하기</a></p>
+            </blockquote>`;
+    const footerDisclaimerText = isKras
+        ? '이 이메일은 heripo.com에서 한국고고학회 뉴스레터를 구독하신 분들에게 발송됩니다.'
+        : '이 이메일은 heripo.com에서 리서치 레이더를 구독하신 분들에게 발송됩니다.';
+    const footerUnsubscribeHtml = isKras
+        ? `<p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 14px; line-height: 1.7; color: #6b7280; margin: 0 0 18px 0; margin-bottom: 8px;">📱 구독 관리: <a href="${unsubscribeUrl}" class="footer-link">구독 해지</a></p>`
+        : `<p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 14px; line-height: 1.7; color: #6b7280; margin: 0 0 18px 0; margin-bottom: 8px;">📱 구독 관리: <a href="${unsubscribeUrl}" class="footer-link">구독 해지</a></p>`;
+    return `<!DOCTYPE html>
+<html lang="ko" style="color-scheme: light dark; supported-color-schemes: light dark;">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="color-scheme" content="light dark">
+  <meta name="supported-color-schemes" content="light dark">
+  <title>${title}</title>
+  <style type="text/css">
+      a:hover {
+          color: #D2691E;
+      }
+      .button-link {
+          color: #fff !important;
+          text-decoration: none !important;
+          font-weight: bold;
+          font-size: 16px;
+          display: inline-block;
+          padding: 10px 28px;
+          border-radius: 4px;
+          background: #D2691E;
+          border: none;
+      }
+      .button-link:hover {
+          background: #b85a1a;
+      }
+      @media screen and (max-width: 800px) {
+          .container {
+              width: 100% !important;
+              max-width: 100% !important;
+              padding: 0 !important;
+          }
+
+          .content-cell {
+              padding: 20px !important;
+          }
+      }
+      @media screen and (max-width: 600px) {
+          h1 {
+              font-size: 24px !important;
+          }
+
+          h2 {
+              font-size: 20px !important;
+          }
+      }
+      @media (prefers-color-scheme: dark) {
+          body,
+          .dark-mode-bg {
+              background-color: #121212 !important;
+          }
+
+          .dark-mode-content-bg {
+              background-color: #1e1e1e !important;
+              box-shadow: 0 4px 10px rgba(0,0,0,0.25) !important;
+          }
+
+          h1,
+          h2,
+          h3,
+          h4,
+          h5,
+          h6 {
+              color: #FFFFFF !important;
+          }
+
+          h2,
+          h3,
+          h4 {
+              background: #1e1e1e !important;
+          }
+
+          p,
+          li {
+              color: #FFFFFF !important;
+          }
+
+          a:not(.button-link) {
+              color: #4da6ff !important;
+              text-decoration: underline !important;
+          }
+
+          a.button-link {
+              color: #fff !important;
+          }
+
+          blockquote {
+              background-color: #2b2b2b !important;
+          }
+
+          blockquote p {
+              color: #bbbbbb !important;
+          }
+
+          .footer-text {
+              color: #999999 !important;
+          }
+
+          .footer-link {
+              color: #999999 !important;
+              text-decoration: underline !important;
+          }
+
+          .dark-logo {
+              display: block !important;
+          }
+
+          .light-logo {
+              display: none !important;
+          }
+
+          .welcome-notice {
+              background-color: #2b2b2b !important;
+          }
+
+          .header-dark-text {
+              color: #eeeeee !important;
+          }
+
+          .dark-logo-inline {
+              display: inline-block !important;
+          }
+      }
+  </style>
+</head>
+<body style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; background-color: #f4f4f4; font-size: 16px; line-height: 1.7; letter-spacing: 0.01em; height: 100%; width: 100%; margin: 0; padding: 0;">
+<table border="0" cellpadding="0" cellspacing="0" width="100%" role="presentation" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt;">
+  <tr>
+    <td bgcolor="#f4f4f4" align="center" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt; padding: 20px 0;" class="dark-mode-bg">
+      <!--[if (gte mso 9)|(IE)]>
+      <table align="center" border="0" cellspacing="0" cellpadding="0" width="800">
+        <tr>
+          <td align="center" valign="top" width="800">
+      <![endif]-->
+      <table border="0" cellpadding="0" cellspacing="0" width="100%" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt; max-width: 800px;" class="container" role="presentation">
+        <tr>
+          <td bgcolor="#ffffff" align="left" class="content-cell dark-mode-content-bg" style="-webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; mso-table-lspace: 0pt; mso-table-rspace: 0pt; padding: 48px 44px 44px 44px; border-radius: 12px; box-shadow: 0 4px 18px rgba(0,0,0,0.07);">
+${headerHtml}
+
+            <h2 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 24px; font-weight: bold; line-height: 1.3; color: #D2691E; margin: 0 0 15px 0; letter-spacing: -0.2px; border-left: 5px solid #D2691E; padding-left: 12px; background: #fff7f2;">💬 ${feedbackHeading}</h2>
+
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">가장 큰 응원은 ${feedbackText}를 직접 사용해보시고, 솔직한 피드백을 주시는 것입니다.</p>
+
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;"><strong style="color: #D2691E; font-weight: bold;">"이런 기능이 있다면 좋겠다"</strong> 혹은 <strong style="color: #D2691E; font-weight: bold;">"이런 점은 불편하다"</strong>와 같은 의견을 언제든 보내주세요.</p>
+
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;">여러분의 피드백 하나하나가 ${feedbackText}의 다음 발걸음을 결정합니다.</p>
+${isKras
+        ? `
+            <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 16px; line-height: 1.7; color: #444444; margin: 0 0 18px 0;"><strong><a href="https://github.com/heripo-lab" target="_blank">heripo lab</a></strong>은 한국고고학회와 함께 뉴스레터 발행 및 고고학의 디지털 전환을 추진하고 있습니다. 앞으로도 연구 현장에 실질적으로 도움이 되는 정보와 기술을 제공해 드리겠습니다.</p>
+`
+        : ''}
+            <hr style="border: 0; border-top: 1px solid #e5e7eb; margin: 28px 0 20px;">
+
+            <h2 style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 24px; font-weight: bold; line-height: 1.3; color: #D2691E; margin: 0 0 15px 0; letter-spacing: -0.2px; border-left: 5px solid #D2691E; padding-left: 12px; background: #fff7f2;">🔍 heripo(헤리포) 플랫폼 소개</h2>
+${platformIntroHtml()}
+            ${newsletterLine}
+${warningHtml}
+
+            <hr style="border: 0; border-top: 1px solid #e5e7eb; margin: 32px 0;">
+
+            <div style="color: #6b7280; font-size: 14px;" class="footer-text">
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 14px; line-height: 1.7; color: #6b7280; margin: 0 0 18px 0; margin-bottom: 8px;">📧 피드백 및 문의: <a href="${siteUrl}/contact" class="footer-link">문의하기</a></p>
+              ${footerUnsubscribeHtml}
+
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 14px; line-height: 1.7; color: #6b7280; margin: 0 0 18px 0; margin-bottom: 15px;"><em>정보 검색에 쏟던 시간을 연구와 창의적 기획에 집중하는 시간으로 바꿔보세요.</em></p>
+
+${poweredByFooterHtml()}
+
+              <p style="font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; font-size: 12px; line-height: 1.7; color: #9ca3af; margin: 0;">${footerDisclaimerText}<br>더 이상 이메일을 받고 싶지 않으시면 <a href="${unsubscribeUrl}" target="_blank" style="color: #888888; text-decoration: underline;" class="footer-link">여기에서 수신 거부</a>하세요.</p>
+            </div>
+          </td>
+        </tr>
+      </table>
+      <!--[if (gte mso 9)|(IE)]>
+      </td>
+      </tr>
+      </table>
+      <![endif]-->
+    </td>
+  </tr>
+</table>
+</body>
+</html>`;
+}
+
 exports.AnalysisProvider = AnalysisProvider;
 exports.ContentGenerateProvider = ContentGenerateProvider;
 exports.CrawlingProvider = CrawlingProvider;
@@ -2475,6 +2888,7 @@ exports.TaskService = TaskService;
 exports.contentOptions = contentOptions;
 exports.crawlingTargetGroups = crawlingTargetGroups;
 exports.generateNewsletter = generateNewsletter;
+exports.generateWelcomeHTML = generateWelcomeHTML;
 exports.llmConfig = llmConfig;
 exports.newsletterConfig = newsletterConfig;
 //# sourceMappingURL=index.cjs.map