@ttkit/daily-hot-api 0.1.3 → 0.1.5

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

@@ -0,0 +1,185 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewsBriefController = void 0;
+const common_1 = require("@nestjs/common");
+const news_brief_config_1 = require("./news-brief.config");
+const news_brief_service_1 = require("./news-brief.service");
+const news_brief_scheduler_1 = require("./news-brief.scheduler");
+const generate_news_brief_dto_1 = require("./dto/generate-news-brief.dto");
+const news_brief_date_param_dto_1 = require("./dto/news-brief-date-param.dto");
+const list_news_briefs_query_dto_1 = require("./dto/list-news-briefs-query.dto");
+let NewsBriefController = class NewsBriefController {
+    constructor(newsBriefService, newsBriefScheduler, config) {
+        this.newsBriefService = newsBriefService;
+        this.newsBriefScheduler = newsBriefScheduler;
+        this.config = config;
+    }
+    generate(body) {
+        if (!this.config.manualGenerateEnabled) {
+            throw new common_1.ForbiddenException('Manual news brief generation is disabled. Set NEWS_BRIEF_MANUAL_GENERATE_ENABLED=true for ops use; frontend must not call this endpoint.');
+        }
+        return this.newsBriefService.generate(body);
+    }
+    getConfig() {
+        return {
+            enabled: this.newsBriefScheduler.isEnabled(),
+            ...this.newsBriefService.getConfig(),
+        };
+    }
+    getCategories() {
+        return this.newsBriefService.getCategories();
+    }
+    getDigest(categories, date, period) {
+        return this.newsBriefService.findDigest(categories, date, period);
+    }
+    getSchedulerStatus() {
+        return this.newsBriefScheduler.getStatus();
+    }
+    startScheduler() {
+        this.newsBriefScheduler.start();
+        return { message: 'News brief scheduler started' };
+    }
+    stopScheduler() {
+        this.newsBriefScheduler.stop();
+        return { message: 'News brief scheduler stopped' };
+    }
+    reconfigureScheduler() {
+        this.newsBriefScheduler.reconfigure();
+        return { message: 'News brief scheduler reconfigured' };
+    }
+    findLatest(category, period, includeDebug) {
+        return this.newsBriefService.findLatest(category, period, includeDebug === 'true');
+    }
+    list(query) {
+        return this.newsBriefService.list(query);
+    }
+    deleteHistory(olderThan, beforeDate, category) {
+        return this.newsBriefService.deleteHistory({
+            olderThan,
+            beforeDate,
+            category,
+        });
+    }
+    deleteByDate(params, category, period) {
+        return this.newsBriefService.deleteByDate(params.date, category, period);
+    }
+    findByDate(params, category, period, includeDebug) {
+        return this.newsBriefService.findByDate(params.date, category, period, includeDebug === 'true');
+    }
+};
+exports.NewsBriefController = NewsBriefController;
+__decorate([
+    (0, common_1.Post)('generate'),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [generate_news_brief_dto_1.GenerateNewsBriefDto]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "generate", null);
+__decorate([
+    (0, common_1.Get)('config'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "getConfig", null);
+__decorate([
+    (0, common_1.Get)('categories'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "getCategories", null);
+__decorate([
+    (0, common_1.Get)('digest'),
+    __param(0, (0, common_1.Query)('categories')),
+    __param(1, (0, common_1.Query)('date')),
+    __param(2, (0, common_1.Query)('period')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "getDigest", null);
+__decorate([
+    (0, common_1.Get)('scheduler/status'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "getSchedulerStatus", null);
+__decorate([
+    (0, common_1.Post)('scheduler/start'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "startScheduler", null);
+__decorate([
+    (0, common_1.Post)('scheduler/stop'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "stopScheduler", null);
+__decorate([
+    (0, common_1.Post)('scheduler/reconfigure'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "reconfigureScheduler", null);
+__decorate([
+    (0, common_1.Get)('latest'),
+    __param(0, (0, common_1.Query)('category')),
+    __param(1, (0, common_1.Query)('period')),
+    __param(2, (0, common_1.Query)('includeDebug')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "findLatest", null);
+__decorate([
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Query)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [list_news_briefs_query_dto_1.ListNewsBriefsQueryDto]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "list", null);
+__decorate([
+    (0, common_1.Delete)('history'),
+    __param(0, (0, common_1.Query)('olderThan')),
+    __param(1, (0, common_1.Query)('beforeDate')),
+    __param(2, (0, common_1.Query)('category')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "deleteHistory", null);
+__decorate([
+    (0, common_1.Delete)(':date'),
+    __param(0, (0, common_1.Param)()),
+    __param(1, (0, common_1.Query)('category')),
+    __param(2, (0, common_1.Query)('period')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [news_brief_date_param_dto_1.NewsBriefDateParamDto, String, String]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "deleteByDate", null);
+__decorate([
+    (0, common_1.Get)(':date'),
+    __param(0, (0, common_1.Param)()),
+    __param(1, (0, common_1.Query)('category')),
+    __param(2, (0, common_1.Query)('period')),
+    __param(3, (0, common_1.Query)('includeDebug')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [news_brief_date_param_dto_1.NewsBriefDateParamDto, String, String, String]),
+    __metadata("design:returntype", void 0)
+], NewsBriefController.prototype, "findByDate", null);
+exports.NewsBriefController = NewsBriefController = __decorate([
+    (0, common_1.Controller)('api/news-briefs'),
+    __metadata("design:paramtypes", [news_brief_service_1.NewsBriefService,
+        news_brief_scheduler_1.NewsBriefScheduler,
+        news_brief_config_1.NewsBriefConfigService])
+], NewsBriefController);
+//# sourceMappingURL=news-brief.controller.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare class NewsBriefModule {
+}

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

@@ -0,0 +1,47 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewsBriefModule = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const cache_module_1 = require("../cache/cache.module");
+const database_module_1 = require("../database/database.module");
+const daily_brief_module_1 = require("../daily-brief/daily-brief.module");
+const hot_lists_module_1 = require("../host-lists/hot-lists.module");
+const scheduler_module_1 = require("../scheduler/scheduler.module");
+const news_brief_ai_client_1 = require("./clients/news-brief-ai.client");
+const news_brief_search_service_1 = require("./clients/news-brief-search.service");
+const news_brief_config_1 = require("./news-brief.config");
+const news_brief_controller_1 = require("./news-brief.controller");
+const news_brief_scheduler_1 = require("./news-brief.scheduler");
+const news_brief_service_1 = require("./news-brief.service");
+let NewsBriefModule = class NewsBriefModule {
+};
+exports.NewsBriefModule = NewsBriefModule;
+exports.NewsBriefModule = NewsBriefModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            schedule_1.ScheduleModule,
+            cache_module_1.CacheModule,
+            database_module_1.DatabaseModule,
+            hot_lists_module_1.HotListsModule,
+            scheduler_module_1.SchedulerModule,
+            daily_brief_module_1.DailyBriefModule,
+        ],
+        controllers: [news_brief_controller_1.NewsBriefController],
+        providers: [
+            news_brief_config_1.NewsBriefConfigService,
+            news_brief_service_1.NewsBriefService,
+            news_brief_scheduler_1.NewsBriefScheduler,
+            news_brief_ai_client_1.NewsBriefAiClient,
+            news_brief_search_service_1.NewsBriefSearchService,
+        ],
+        exports: [news_brief_service_1.NewsBriefService],
+    })
+], NewsBriefModule);
+//# sourceMappingURL=news-brief.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"news-brief.module.js","sourceRoot":"","sources":["../../src/news-brief/news-brief.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,+CAAkD;AAClD,wDAAoD;AACpD,iEAA6D;AAC7D,0EAAqE;AACrE,qEAAgE;AAChE,oEAAgE;AAChE,yEAAmE;AACnE,mFAA6E;AAC7E,2DAA6D;AAC7D,mEAA8D;AAC9D,iEAA4D;AAC5D,6DAAwD;AA2BjD,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IArB3B,IAAA,eAAM,EAAC;QAEN,OAAO,EAAE;YACP,yBAAc;YACd,0BAAW;YACX,gCAAc;YACd,iCAAc;YACd,kCAAe;YAEf,qCAAgB;SACjB;QACD,WAAW,EAAE,CAAC,2CAAmB,CAAC;QAClC,SAAS,EAAE;YACT,0CAAsB;YACtB,qCAAgB;YAChB,yCAAkB;YAClB,wCAAiB;YACjB,kDAAsB;SACvB;QACD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,eAAe,CAAG"}

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;
+}