@heripo/research-radar 2.3.1 → 2.3.3

package/README.md

@@ -24,7 +24,7 @@ An AI-powered newsletter service for Korean cultural heritage. Built on [`@llm-n
 - Type-safe TypeScript with strict interfaces
 - Provider pattern for swapping components (Crawling/Analysis/Content/Email)
 - 66 crawling targets across heritage agencies, museums, academic societies
-- LLM-driven analysis (GPT-5 models)
+- Dual LLM providers: OpenAI GPT-5 (analysis) + Google Gemini (content generation)
 - Built-in retries, chain options, preview emails
 
 **Links**: [Live service](https://heripo.com/research-radar/subscribe) • [Newsletter example](https://heripo.com/research-radar-newsletter-example.html) • [Core engine](https://github.com/heripo-lab/llm-newsletter-kit-core)
@@ -69,7 +69,7 @@ For academic publications:
 npm install @heripo/research-radar @llm-newsletter-kit/core
 ```
 
-**Requirements**: Node.js >= 22, OpenAI API key
+**Requirements**: Node.js >= 22, OpenAI API key, Google Generative AI API key
 
 **Note**: `@llm-newsletter-kit/core` is a peer dependency and must be installed separately.
 
@@ -80,6 +80,7 @@ import { generateNewsletter } from '@heripo/research-radar';
 
 const newsletterId = await generateNewsletter({
   openAIApiKey: process.env.OPENAI_API_KEY,
+  googleGenerativeAIApiKey: process.env.GOOGLE_GENERATIVE_AI_API_KEY,
 
   // Implement these repository interfaces (see src/types/dependencies.ts)
   taskRepository: {
@@ -104,8 +105,11 @@ const newsletterId = await generateNewsletter({
     saveNewsletter: async (data) => db.newsletters.save(data),
   },
 
-  // Optional: Custom logger and preview
+  // Optional parameters:
   logger: console,
+  publishDate: '2026-02-20',        // Override publication date (ISO format)
+  templateOptions: { /* ... */ },    // Newsletter template customization
+  customFetch: proxyFetch,           // Custom fetch for proxy-based crawling
   previewNewsletter: {
     fetchNewsletterForPreview: async () => db.newsletters.latest(),
     emailService: resendEmailService,
@@ -135,7 +139,7 @@ Uses the **Provider-Service pattern** from `@llm-newsletter-kit/core`. See [core
 
 **Parsers** (`src/parsers/`): Custom extractors per organization
 
-**Template** (`src/templates/newsletter-html.ts`): Responsive email with light/dark mode
+**Templates** (`src/templates/`): `newsletter-html.ts` (responsive email with light/dark mode), `welcome-html.ts` (`generateWelcomeHTML()`), `shared.ts` (shared HTML components)
 
 ## Development commands
 
@@ -158,6 +162,7 @@ A web-based tool for testing crawling parsers during development. Built with Exp
 
 ```bash
 npm run dev:crawler        # Start at http://localhost:3333
+npm run dev:crawler:proxy  # Start with proxy support (uses .env)
 ```
 
 **Features**:
@@ -167,6 +172,26 @@ npm run dev:crawler        # Start at http://localhost:3333
 - 5-minute response cache (with skip/clear options)
 - Timing info for fetch and parse operations
 
+### Newsletter Preview
+
+Preview rendered newsletter HTML with sample content.
+
+```bash
+npm run dev:newsletter-preview  # Start at http://localhost:3334
+```
+
+Query params: `?kras=true` (KRAS mode), `?krasNews=true` (KRAS news section), `?heripolabNews=true` (heripo lab news section)
+
+### Welcome Email Preview
+
+Preview rendered welcome email HTML.
+
+```bash
+npm run dev:welcome-preview  # Start at http://localhost:3335
+```
+
+Query params: `?kras=true` (KRAS mode), `?name=홍길동` (subscriber name)
+
 ## 🤝 Contributing
 
 You can use this project in two ways:
@@ -197,14 +222,14 @@ subscribeUrl: 'https://yourdomain.com/subscribe'
 
 **4. Switch LLM provider** (optional):
 
-To use Anthropic/Gemini/Ollama instead of OpenAI:
-- `src/newsletter-generator.ts`: Change `createOpenAI()` to your provider
+Currently uses dual providers: **OpenAI** (analysis) + **Google Gemini** (content generation). To change:
+- `src/newsletter-generator.ts`: Change `createOpenAI()` / `createGoogleGenerativeAI()` to your provider
 - `src/providers/analysis.provider.ts`: Update model names (currently `gpt-5-mini`, `gpt-5.1`)
-- `src/providers/content-generate.provider.ts`: Update model name
+- `src/providers/content-generate.provider.ts`: Update model name (currently `gemini-3-pro-preview`)
 
 Any [Vercel AI SDK provider](https://sdk.vercel.ai/providers) works.
 
-**Search keywords**: `heripo`, `kimhongyeon`, `#D2691E`, `openai`, `gpt-5`
+**Search keywords**: `heripo`, `kimhongyeon`, `#D2691E`, `openai`, `gpt-5`, `google`, `GoogleGenerativeAI`, `gemini`, `createGoogleGenerativeAI`
 
 ## Why Code-Based?
 

package/dist/index.cjs

@@ -2284,7 +2284,7 @@ ${options.krasNewsMarkdown}
         fixMalformedUrls: true,
         fixBoldSyntax: true,
         convertStrikethrough: true,
-    })
+    }).replaceAll('%7B%7B%7BRESEND_UNSUBSCRIBE_URL%7D%7D%7D', '{{{RESEND_UNSUBSCRIBE_URL}}}')
     : ''}
             
             ${options?.heripolabNewsMarkdown
@@ -2315,7 +2315,7 @@ ${options.heripolabNewsMarkdown}
             </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>${options?.isKrasNewsletter ? '한국고고학회' : '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>

package/dist/index.js

@@ -2263,7 +2263,7 @@ ${options.krasNewsMarkdown}
         fixMalformedUrls: true,
         fixBoldSyntax: true,
         convertStrikethrough: true,
-    })
+    }).replaceAll('%7B%7B%7BRESEND_UNSUBSCRIBE_URL%7D%7D%7D', '{{{RESEND_UNSUBSCRIBE_URL}}}')
     : ''}
             
             ${options?.heripolabNewsMarkdown
@@ -2294,7 +2294,7 @@ ${options.heripolabNewsMarkdown}
             </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>${options?.isKrasNewsletter ? '한국고고학회' : '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>

package/package.json

@@ -2,7 +2,7 @@
   "name": "@heripo/research-radar",
   "private": false,
   "type": "module",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "AI-driven intelligence for Korean cultural heritage. This package serves as both a ready-to-use newsletter service and a practical implementation example for the LLM-Newsletter-Kit.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -45,11 +45,11 @@
   "author": "kimhongyeon",
   "license": "Apache-2.0",
   "dependencies": {
-    "@ai-sdk/google": "^3.0.29",
-    "@ai-sdk/openai": "^3.0.28",
+    "@ai-sdk/google": "^3.0.30",
+    "@ai-sdk/openai": "^3.0.30",
     "cheerio": "^1.2.0",
     "dompurify": "^3.3.1",
-    "jsdom": "^28.0.0",
+    "jsdom": "^28.1.0",
     "juice": "^11.1.1",
     "safe-markdown2html": "^1.0.0",
     "turndown": "^7.2.2"
@@ -58,24 +58,24 @@
     "@llm-newsletter-kit/core": "~1.3.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@llm-newsletter-kit/core": "^1.3.1",
+    "@eslint/js": "^10.0.1",
+    "@llm-newsletter-kit/core": "^1.3.3",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/express": "^5.0.6",
     "@types/jsdom": "^27.0.0",
-    "@types/node": "^25.2.3",
+    "@types/node": "^25.3.0",
     "@types/turndown": "^5.0.6",
-    "eslint": "^9.39.2",
+    "eslint": "^10.0.1",
     "eslint-plugin-unused-imports": "^4.4.1",
     "express": "^5.2.1",
     "prettier": "^3.8.1",
-    "rimraf": "^6.1.2",
-    "rollup": "^4.57.1",
+    "rimraf": "^6.1.3",
+    "rollup": "^4.58.0",
     "rollup-plugin-dts": "^6.3.0",
     "rollup-plugin-typescript2": "^0.36.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.55.0"
+    "typescript-eslint": "^8.56.0"
   },
   "repository": {
     "type": "git",