@heripo/research-radar 2.1.0 → 2.3.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { UrlString, ParsedTarget, CrawlingTargetGroup, CrawlingTarget, UnscoredArticle, ArticleForUpdateByAnalysis, ArticleForGenerateContent, Newsletter, AppLogger, EmailService, EmailMessage, DateService as DateService$1, IsoDateString, TaskService as TaskService$1, AnalysisProvider as AnalysisProvider$1, ContentGenerateProvider as ContentGenerateProvider$1, HtmlTemplate, CrawlingProvider as CrawlingProvider$1 } from '@llm-newsletter-kit/core';
+import { UrlString, ParsedTarget, CrawlingTargetGroup, CrawlingTarget, UnscoredArticle, ArticleForUpdateByAnalysis, ArticleForGenerateContent, Newsletter, AppLogger, EmailService, EmailMessage, DateService as DateService$1, IsoDateString, TaskService as TaskService$1, AnalysisProvider as AnalysisProvider$1, ContentGenerateProvider as ContentGenerateProvider$1, HtmlTemplate, CrawlingProvider as CrawlingProvider$1, GenerateNewsletterConfig } from '@llm-newsletter-kit/core';
 import { OpenAIProvider } from '@ai-sdk/openai';
 import { GoogleGenerativeAIProvider } from '@ai-sdk/google';
 
@@ -64,6 +64,68 @@ interface TagRepository {
      */
     findAllTags(): Promise<string[]>;
 }
+/**
+ * Base template options shared by all newsletter variants.
+ */
+interface BaseNewsletterTemplateOptions {
+    /**
+     * Markdown content for KRAS news section.
+     * Converted to HTML and injected into the newsletter template.
+     */
+    krasNewsMarkdown?: string;
+    /**
+     * Markdown content for heripo lab news section.
+     * Converted to HTML and injected into the newsletter template.
+     */
+    heripolabNewsMarkdown?: string;
+    /**
+     * Display date string for the newsletter header (e.g. "2026년 2월 12일").
+     * Injected from DateService.getDisplayDateString() at generation time.
+     */
+    displayDate?: string;
+}
+/**
+ * Template options for the default (heripo) newsletter variant.
+ */
+interface DefaultNewsletterTemplateOptions extends BaseNewsletterTemplateOptions {
+    isKrasNewsletter?: false;
+}
+/**
+ * Template options for the KRAS (Korean Archaeological Society) newsletter variant.
+ *
+ * When isKrasNewsletter is true, additional KRAS-specific options become available:
+ * - titleContext: Context string to prioritize in newsletter title generation
+ */
+interface KrasNewsletterTemplateOptions extends BaseNewsletterTemplateOptions {
+    isKrasNewsletter: true;
+    /**
+     * Context string to prioritize when generating the newsletter title.
+     * Only available in KRAS mode. When provided, the LLM will consider this value
+     * as the top priority along with the generated newsletter content for title creation.
+     * An empty string is treated as undefined (no context).
+     */
+    titleContext?: string;
+}
+/**
+ * Template customization options for newsletter HTML generation.
+ *
+ * Uses a discriminated union on `isKrasNewsletter`:
+ * - When `isKrasNewsletter` is `true`: KRAS-specific options (titleContext) are available.
+ * - When `isKrasNewsletter` is `false` or omitted: Only base options are available.
+ */
+type NewsletterTemplateOptions = DefaultNewsletterTemplateOptions | KrasNewsletterTemplateOptions;
+/**
+ * Options for generating the welcome email HTML.
+ *
+ * When `isKrasNewsletter` is `true`, KRAS-specific branding and content are applied.
+ * When `isKrasNewsletter` is `false` or omitted, standard heripo branding is used.
+ */
+interface WelcomeTemplateOptions {
+    /** When true, apply KRAS (Korean Archaeological Society) branding */
+    isKrasNewsletter?: boolean;
+    /** Site base URL for constructing links (default: 'https://heripo.com') */
+    siteUrl?: string;
+}
 /**
  * Repository interface for newsletter management
  */
@@ -135,6 +197,10 @@ interface NewsletterGeneratorDependencies {
      * @example "2025-02-12"
      */
     publishDate?: string;
+    /** Newsletter template customization options (optional) */
+    templateOptions?: NewsletterTemplateOptions;
+    /** Custom fetch function for crawling (e.g., proxy-based fetch). Optional. */
+    customFetch?: typeof fetch;
 }
 /**
  * Newsletter generation execution function
@@ -156,6 +222,30 @@ interface NewsletterGeneratorDependencies {
  */
 declare function generateNewsletter(dependencies: NewsletterGeneratorDependencies): Promise<string | number | null>;
 
+/**
+ * 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,
+ * });
+ * ```
+ */
+declare function generateWelcomeHTML(id: string, name: string, options?: WelcomeTemplateOptions): string;
+
 /**
  * Date service implementation
  * - Provides current date and display date strings
@@ -258,11 +348,13 @@ declare class ContentGenerateProvider implements ContentGenerateProvider$1 {
     private readonly newsletterRepository;
     private _issueOrder;
     model: ReturnType<GoogleGenerativeAIProvider>;
-    constructor(google: GoogleGenerativeAIProvider, articleRepository: ArticleRepository, newsletterRepository: NewsletterRepository);
+    /** HTML template with markers for title and content injection */
+    htmlTemplate: HtmlTemplate;
+    /** Newsletter brand name (defaults to config, can be overridden via constructor) */
+    newsletterBrandName: string;
+    constructor(google: GoogleGenerativeAIProvider, articleRepository: ArticleRepository, newsletterRepository: NewsletterRepository, templateOptions?: NewsletterTemplateOptions, brandName?: string);
     /** LLM temperature setting for content generation */
     temperature: number;
-    /** Newsletter brand name */
-    newsletterBrandName: string;
     /** Subscribe page URL */
     subscribePageUrl: UrlString;
     /** Publication criteria (minimum article count, priority score threshold) */
@@ -284,8 +376,6 @@ declare class ContentGenerateProvider implements ContentGenerateProvider$1 {
      * @returns Articles eligible for inclusion in the newsletter
      */
     fetchArticleCandidates(): Promise<ArticleForGenerateContent[]>;
-    /** HTML template with markers for title and content injection */
-    htmlTemplate: HtmlTemplate;
     /**
      * Save generated newsletter to the repository
      * @param input - Newsletter data and used articles
@@ -309,9 +399,11 @@ declare class CrawlingProvider implements CrawlingProvider$1 {
     private readonly articleRepository;
     /** Maximum number of concurrent crawling operations */
     maxConcurrency: number;
-    constructor(articleRepository: ArticleRepository);
+    /** Optional custom fetch function (e.g., proxy-based fetch) */
+    customFetch?: typeof fetch;
     /** Crawling target groups configuration */
     crawlingTargetGroups: CrawlingTargetGroup[];
+    constructor(articleRepository: ArticleRepository, customFetch?: typeof fetch);
     /**
      * Fetch existing articles by URLs to avoid duplicate crawling
      * @param articleUrls - URLs to check
@@ -331,26 +423,31 @@ declare class CrawlingProvider implements CrawlingProvider$1 {
     }): Promise<number>;
 }
 
-declare const crawlingTargetGroups: CrawlingTargetGroup[];
+declare function createCrawlingTargetGroups(customFetch?: typeof fetch): CrawlingTargetGroup[];
 
 /**
- * Newsletter content configuration
+ * Content options type extracted from core GenerateNewsletterConfig
  */
-declare const contentOptions: {
-    outputLanguage: string;
-    expertField: string[];
-};
+type ContentOptions = GenerateNewsletterConfig<any>['contentOptions'];
 /**
- * Newsletter brand configuration
+ * Newsletter brand configuration type
  */
-declare const newsletterConfig: {
+interface NewsletterConfig {
     brandName: string;
     subscribePageUrl: string;
     publicationCriteria: {
         minimumArticleCountForIssue: number;
         priorityArticleScoreThreshold: number;
     };
-};
+}
+/**
+ * Newsletter content configuration
+ */
+declare const contentOptions: ContentOptions;
+/**
+ * Newsletter brand configuration
+ */
+declare const newsletterConfig: NewsletterConfig;
 /**
  * LLM configuration
  */
@@ -362,5 +459,5 @@ declare const llmConfig: {
     };
 };
 
-export { AnalysisProvider, ContentGenerateProvider, CrawlingProvider, DateService, TaskService, contentOptions, crawlingTargetGroups, generateNewsletter, llmConfig, newsletterConfig };
-export type { ArticleRepository, NewsletterGeneratorDependencies, NewsletterRepository, PreviewNewsletterOptions, TagRepository, TaskRepository };
+export { AnalysisProvider, ContentGenerateProvider, CrawlingProvider, DateService, TaskService, contentOptions, createCrawlingTargetGroups, generateNewsletter, generateWelcomeHTML, llmConfig, newsletterConfig };
+export type { ArticleRepository, ContentOptions, NewsletterConfig, NewsletterGeneratorDependencies, NewsletterRepository, NewsletterTemplateOptions, PreviewNewsletterOptions, TagRepository, TaskRepository, WelcomeTemplateOptions };