@ttkit/daily-hot-api 0.1.3 → 0.1.4

package/dist/news-brief/news-brief.scheduler.d.ts

@@ -0,0 +1,34 @@
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import { SchedulerRegistry } from '@nestjs/schedule';
+import { HotListsService } from '../host-lists/hot-lists.service';
+import { NewsBriefConfigService } from './news-brief.config';
+import { NewsBriefService } from './news-brief.service';
+export declare class NewsBriefScheduler implements OnModuleInit, OnModuleDestroy {
+    private readonly config;
+    private readonly schedulerRegistry;
+    private readonly newsBriefService;
+    private readonly hotListsService;
+    private readonly logger;
+    private readonly cronJobName;
+    private isRunning;
+    private enabled;
+    constructor(config: NewsBriefConfigService, schedulerRegistry: SchedulerRegistry, newsBriefService: NewsBriefService, hotListsService: HotListsService);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    isEnabled(): boolean;
+    getStatus(): {
+        isRunning: boolean;
+        enabled: boolean;
+        cronExpression: string;
+        timezone: string;
+        categories: string[];
+        cronJobExists: boolean;
+    };
+    start(): void;
+    stop(): void;
+    reconfigure(): void;
+    private setupCronJob;
+    private stopCronJob;
+    private handleCron;
+    private validateCategoryProfiles;
+}

package/dist/news-brief/news-brief.scheduler.js

@@ -0,0 +1,143 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var NewsBriefScheduler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewsBriefScheduler = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const cron_1 = require("cron");
+const hot_lists_service_1 = require("../host-lists/hot-lists.service");
+const news_brief_config_1 = require("./news-brief.config");
+const news_brief_service_1 = require("./news-brief.service");
+const news_brief_ai_client_1 = require("./clients/news-brief-ai.client");
+let NewsBriefScheduler = NewsBriefScheduler_1 = class NewsBriefScheduler {
+    constructor(config, schedulerRegistry, newsBriefService, hotListsService) {
+        this.config = config;
+        this.schedulerRegistry = schedulerRegistry;
+        this.newsBriefService = newsBriefService;
+        this.hotListsService = hotListsService;
+        this.logger = new common_1.Logger(NewsBriefScheduler_1.name);
+        this.cronJobName = 'news-brief-generate';
+        this.isRunning = false;
+        this.enabled = false;
+        this.enabled = this.config.enabled;
+    }
+    onModuleInit() {
+        this.validateCategoryProfiles(this.config.knownCategories);
+        this.setupCronJob();
+    }
+    onModuleDestroy() {
+        this.stopCronJob();
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    getStatus() {
+        return {
+            isRunning: this.isRunning,
+            enabled: this.enabled,
+            cronExpression: this.config.cronExpression,
+            timezone: this.config.timezone,
+            categories: this.config.categoryCodes,
+            cronJobExists: this.schedulerRegistry.doesExist('cron', this.cronJobName),
+        };
+    }
+    start() {
+        this.enabled = true;
+        this.setupCronJob();
+    }
+    stop() {
+        this.enabled = false;
+        this.stopCronJob();
+    }
+    reconfigure() {
+        this.setupCronJob();
+    }
+    setupCronJob() {
+        try {
+            this.stopCronJob();
+            if (!this.enabled) {
+                this.logger.log('News brief scheduler is disabled');
+                return;
+            }
+            const cronExpression = this.config.cronExpression;
+            const timezone = this.config.timezone;
+            const job = new cron_1.CronJob(cronExpression, () => {
+                void this.handleCron();
+            }, null, false, timezone);
+            this.schedulerRegistry.addCronJob(this.cronJobName, job);
+            job.start();
+            this.logger.log(`News brief cron job setup with expression: ${cronExpression}`);
+        }
+        catch (error) {
+            this.logger.error('Failed to setup news brief cron job:', error);
+        }
+    }
+    stopCronJob() {
+        try {
+            if (this.schedulerRegistry.doesExist('cron', this.cronJobName)) {
+                this.schedulerRegistry.deleteCronJob(this.cronJobName);
+                this.logger.log(`Stopped cron job: ${this.cronJobName}`);
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to stop news brief cron job:', error);
+        }
+    }
+    async handleCron() {
+        if (!this.enabled || this.isRunning) {
+            return;
+        }
+        this.isRunning = true;
+        try {
+            const result = await this.newsBriefService.generate();
+            const succeeded = result.results.filter((item) => item.status === 'success').length;
+            const failed = result.results.filter((item) => item.status === 'failed').length;
+            this.logger.log(`News brief run for ${result.briefDate}/${result.period}: ${succeeded} succeeded, ${failed} failed`);
+        }
+        catch (error) {
+            this.logger.error('News brief generation failed:', error);
+        }
+        finally {
+            this.isRunning = false;
+        }
+    }
+    validateCategoryProfiles(profiles) {
+        const registeredSources = new Set(this.hotListsService.getAllSources());
+        const missingSources = [];
+        const oversized = [];
+        for (const profile of profiles) {
+            for (const source of profile.sources) {
+                if (!registeredSources.has(source)) {
+                    missingSources.push(`${profile.code}:${source}`);
+                }
+            }
+            if (profile.maxItems > news_brief_ai_client_1.PROMPT_BUDGET.maxOutputItems) {
+                oversized.push(`${profile.code}:${profile.maxItems}`);
+            }
+        }
+        if (missingSources.length > 0) {
+            throw new Error(`Unknown hot list source(s) in news category registry: ${missingSources.join(', ')}`);
+        }
+        if (oversized.length > 0) {
+            throw new Error(`News category maxItems exceeds PROMPT_BUDGET.maxOutputItems (${news_brief_ai_client_1.PROMPT_BUDGET.maxOutputItems}): ${oversized.join(', ')}`);
+        }
+    }
+};
+exports.NewsBriefScheduler = NewsBriefScheduler;
+exports.NewsBriefScheduler = NewsBriefScheduler = NewsBriefScheduler_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [news_brief_config_1.NewsBriefConfigService,
+        schedule_1.SchedulerRegistry,
+        news_brief_service_1.NewsBriefService,
+        hot_lists_service_1.HotListsService])
+], NewsBriefScheduler);
+//# sourceMappingURL=news-brief.scheduler.js.map

package/dist/news-brief/news-brief.scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"news-brief.scheduler.js","sourceRoot":"","sources":["../../src/news-brief/news-brief.scheduler.ts"],"names":[],"mappings":"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"}

package/dist/news-brief/news-brief.service.d.ts

@@ -0,0 +1,60 @@
+import { CacheService } from '../cache/cache.service';
+import { HotListsService } from '../host-lists/hot-lists.service';
+import { HotItemRepository } from '../database/repositories/hot-item.repository';
+import { NewsBriefRepository } from '../database/repositories/news-brief.repository';
+import { FetchHotDataTask } from '../scheduler/tasks/fetch-hot-data.task';
+import { GenerateNewsBriefOptions, ListNewsBriefsOptions, NewsBriefDeleteHistoryResponse, NewsBriefDeleteResponse, NewsBriefDigestResponse, NewsBriefGenerateResponse, NewsBriefListResponse, NewsBriefPublicConfig, NewsBriefResponse, NewsCategorySummary } from './interfaces/news-brief.interface';
+import { NewsBriefAiClient } from './clients/news-brief-ai.client';
+import { NewsBriefSearchService } from './clients/news-brief-search.service';
+import { NewsBriefConfigService } from './news-brief.config';
+export declare class NewsBriefService {
+    private readonly config;
+    private readonly newsBriefRepository;
+    private readonly hotItemRepository;
+    private readonly fetchHotDataTask;
+    private readonly hotListsService;
+    private readonly aiClient;
+    private readonly searchService;
+    private readonly cacheService;
+    private readonly logger;
+    constructor(config: NewsBriefConfigService, newsBriefRepository: NewsBriefRepository, hotItemRepository: HotItemRepository, fetchHotDataTask: FetchHotDataTask, hotListsService: HotListsService, aiClient: NewsBriefAiClient, searchService: NewsBriefSearchService, cacheService: CacheService);
+    generate(options?: GenerateNewsBriefOptions): Promise<NewsBriefGenerateResponse>;
+    findLatest(category: string | undefined, period?: string, includeDebug?: boolean): Promise<NewsBriefResponse | null>;
+    findByDate(date: string, category: string | undefined, period?: string, includeDebug?: boolean): Promise<NewsBriefResponse | null>;
+    findDigest(categories?: string | string[], date?: string, period?: string): Promise<NewsBriefDigestResponse>;
+    list(options: ListNewsBriefsOptions): Promise<NewsBriefListResponse>;
+    deleteByDate(date: string, category?: string, period?: string): Promise<NewsBriefDeleteResponse>;
+    deleteHistory(options: {
+        olderThan?: string;
+        beforeDate?: string;
+        category?: string;
+    }): Promise<NewsBriefDeleteHistoryResponse>;
+    getConfig(): NewsBriefPublicConfig;
+    getCategories(): NewsCategorySummary[];
+    private generateForCategory;
+    private generateClaimedBrief;
+    private fetchLatestSourceItems;
+    private refreshSourceOnce;
+    private refreshSource;
+    private loadHistoryItems;
+    private buildSourceNameMap;
+    private toInputItem;
+    private mergeAndLimitItems;
+    private timestampOf;
+    private effectiveMaxItems;
+    private isSearchActive;
+    private buildSearchEvidence;
+    private buildSearchQuery;
+    private resolveDigestProfiles;
+    private resolveGenerateProfiles;
+    private requireKnownCategory;
+    private unknownCategoryMessage;
+    private resolveSourcesOverride;
+    private resolveBriefDate;
+    private validateDate;
+    private normalizePeriod;
+    private normalizeOptionalPeriod;
+    private resolveOlderThanDate;
+    private resolveInputWindow;
+    private toResponse;
+}