@escapenavigator/types 2.0.13 → 2.0.15

package/dist/shared/city-pipeline.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Полный конвейер обработки города одним фоновым воркером: импорт из
+ * Wikidata → AI-ресёрч по темам → триаж → обогащение → автосвязи →
+ * тексты EN и RU. Всё, кроме генерации обложек. Запуск только вручную
+ * по конкретному городу; за раз — одна активная джоба на город.
+ */
+export declare class StartCityPipelineDto {
+    cityId: number;
+    /** Сколько тем ресёрча планировать (по умолчанию 6). */
+    maxThemes?: number;
+    /** false — пропустить генерацию русского (по умолчанию генерим EN+RU). */
+    withRussian?: boolean;
+}
+export type CityPipelineStatus = 'running' | 'done' | 'failed';
+export declare const CITY_PIPELINE_STAGES: readonly ["import-wikidata", "research", "triage", "enrich-attractions", "enrich-persons", "autolink", "content-en", "content-ru"];
+export type CityPipelineStage = (typeof CITY_PIPELINE_STAGES)[number];
+/** Итог одного этапа — короткая строка для лога в админке. */
+export type CityPipelineLogEntry = {
+    stage: CityPipelineStage;
+    /** Человекочитаемый итог («+38 places, +12 persons»). */
+    summary: string;
+    /** null — этап прошёл; строка — этап упал, но конвейер продолжился. */
+    error: string | null;
+    durationMs: number;
+};
+export type CityPipelineRunRO = {
+    id: number;
+    cityId: number;
+    city: string;
+    status: CityPipelineStatus;
+    /** Текущий этап (для running) либо последний выполненный. */
+    stage: CityPipelineStage | null;
+    /** Прогресс внутри этапа («theme 3/6: coffeehouse culture»). */
+    stageDetail: string | null;
+    log: CityPipelineLogEntry[];
+    /** Фатальная ошибка, остановившая конвейер (status=failed). */
+    error: string | null;
+    startedAt: string;
+    finishedAt: string | null;
+};

package/dist/shared/city-pipeline.js

@@ -0,0 +1,52 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CITY_PIPELINE_STAGES = exports.StartCityPipelineDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Полный конвейер обработки города одним фоновым воркером: импорт из
+ * Wikidata → AI-ресёрч по темам → триаж → обогащение → автосвязи →
+ * тексты EN и RU. Всё, кроме генерации обложек. Запуск только вручную
+ * по конкретному городу; за раз — одна активная джоба на город.
+ */
+class StartCityPipelineDto {
+}
+exports.StartCityPipelineDto = StartCityPipelineDto;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], StartCityPipelineDto.prototype, "cityId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(10),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], StartCityPipelineDto.prototype, "maxThemes", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], StartCityPipelineDto.prototype, "withRussian", void 0);
+exports.CITY_PIPELINE_STAGES = [
+    'import-wikidata',
+    'research',
+    'triage',
+    'enrich-attractions',
+    'enrich-persons',
+    'autolink',
+    'content-en',
+    'content-ru',
+];

package/dist/shared/city-research.d.ts

@@ -0,0 +1,46 @@
+/**
+ * AI-исследователь города: сильная модель с web search добирает
+ * интересные места, личности и связи, которых нет в формальных
+ * источниках (Wikidata). Результат — кандидаты в needReview,
+ * ничего не публикуется автоматически. Только ручной запуск по городу.
+ */
+export declare class CityResearchDto {
+    cityId: number;
+    /** Опциональный фокус: район или тема («coffeehouse writers», «Leopoldstadt»). */
+    focus?: string;
+    limitPlaces?: number;
+    /** true — только показать кандидатов, ничего не сохранять. */
+    dryRun?: boolean;
+}
+export type CityResearchPersonRO = {
+    name: string;
+    /** lived / performed / created / buried / studied / depicted. */
+    relation: string;
+    /** Суть связи одним предложением. */
+    detail: string | null;
+};
+export type CityResearchItemRO = {
+    title: string;
+    /** Чем место интересно — зацепка будущей истории. */
+    storyHook: string;
+    category: string;
+    approxAddress: string | null;
+    /** 0–1: уверенность модели, что факты проверяемы. */
+    confidence: number;
+    persons: CityResearchPersonRO[];
+    geocoded: boolean;
+    action: 'created' | 'exists' | 'dry-run' | 'skipped';
+    note: string | null;
+};
+export type CityResearchReportRO = {
+    cityId: number;
+    city: string;
+    dryRun: boolean;
+    focus: string | null;
+    placesFound: number;
+    placesCreated: number;
+    personsCreated: number;
+    linksCreated: number;
+    skippedExisting: number;
+    items: CityResearchItemRO[];
+};

package/dist/shared/city-research.js

@@ -0,0 +1,49 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CityResearchDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * AI-исследователь города: сильная модель с web search добирает
+ * интересные места, личности и связи, которых нет в формальных
+ * источниках (Wikidata). Результат — кандидаты в needReview,
+ * ничего не публикуется автоматически. Только ручной запуск по городу.
+ */
+class CityResearchDto {
+}
+exports.CityResearchDto = CityResearchDto;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CityResearchDto.prototype, "cityId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], CityResearchDto.prototype, "focus", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(30),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CityResearchDto.prototype, "limitPlaces", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], CityResearchDto.prototype, "dryRun", void 0);

package/dist/shared/content-batch.d.ts

@@ -0,0 +1,27 @@
+import { Languages } from './enum/languages.enum';
+/**
+ * Ручной batch-прогон AI-генерации локалей. Автозапуска нет — только
+ * кнопка в админке; лимит ограничивает стоимость одного вызова.
+ * cityId обязателен: идём город за городом, без глобальных прогонов.
+ */
+export declare class GenerateContentBatchDto {
+    language: Languages;
+    /** Сколько записей обработать за вызов. */
+    limit?: number;
+    cityId: number;
+}
+export type ContentBatchItemRO = {
+    id: number;
+    title: string;
+    action: 'generated' | 'error';
+    note: string | null;
+};
+export type ContentBatchReportRO = {
+    language: Languages;
+    processed: number;
+    generated: number;
+    errors: number;
+    /** Сколько записей ещё ждут генерации этого языка. */
+    remaining: number;
+    items: ContentBatchItemRO[];
+};

package/dist/shared/content-batch.js

@@ -0,0 +1,41 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateContentBatchDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const languages_enum_1 = require("./enum/languages.enum");
+/**
+ * Ручной batch-прогон AI-генерации локалей. Автозапуска нет — только
+ * кнопка в админке; лимит ограничивает стоимость одного вызова.
+ * cityId обязателен: идём город за городом, без глобальных прогонов.
+ */
+class GenerateContentBatchDto {
+}
+exports.GenerateContentBatchDto = GenerateContentBatchDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(languages_enum_1.Languages),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], GenerateContentBatchDto.prototype, "language", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(25),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], GenerateContentBatchDto.prototype, "limit", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], GenerateContentBatchDto.prototype, "cityId", void 0);

package/dist/shared/wikidata-enrichment.d.ts

@@ -0,0 +1,24 @@
+/** Batch-обогащение записей из Wikidata (wikidataId, фото, годы жизни). */
+export declare class EnrichWikidataDto {
+    /** Сколько записей обработать за один вызов (внешние API — батчами). */
+    limit?: number;
+    /** Обязателен: идём город за городом, без глобальных прогонов. */
+    cityId: number;
+}
+export type WikidataEnrichmentItemRO = {
+    id: number;
+    title: string;
+    /** Что произошло с записью в этом прогоне. */
+    action: 'matched' | 'photo-added' | 'enriched' | 'skipped' | 'not-found' | 'ambiguous' | 'error';
+    wikidataId: string | null;
+    note: string | null;
+};
+export type WikidataEnrichmentReportRO = {
+    processed: number;
+    wikidataMatched: number;
+    photosAdded: number;
+    skipped: number;
+    /** Осталось необогащённых записей после прогона. */
+    remaining: number;
+    items: WikidataEnrichmentItemRO[];
+};

package/dist/shared/wikidata-enrichment.js

@@ -0,0 +1,31 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnrichWikidataDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Batch-обогащение записей из Wikidata (wikidataId, фото, годы жизни). */
+class EnrichWikidataDto {
+}
+exports.EnrichWikidataDto = EnrichWikidataDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], EnrichWikidataDto.prototype, "limit", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], EnrichWikidataDto.prototype, "cityId", void 0);

package/dist/shared/wikidata-import.d.ts

@@ -0,0 +1,33 @@
+/** Импорт кандидатов (атракшены + личности) города из Wikidata SPARQL. */
+export declare class WikidataCityImportDto {
+    cityId: number;
+    /** Радиус поиска от центра города, км. */
+    radiusKm?: number;
+    limitAttractions?: number;
+    limitPersons?: number;
+    /** true — только показать кандидатов, ничего не сохранять. */
+    dryRun?: boolean;
+}
+export type WikidataImportCandidateRO = {
+    wikidataId: string;
+    title: string;
+    kind: 'attraction' | 'person';
+    /** Наша категория (атракшен) или годы жизни (личность). */
+    detail: string | null;
+    /** Число языковых разделов Wikipedia — прокси известности. */
+    sitelinks: number;
+    hasPhoto: boolean;
+    action: 'created' | 'exists' | 'dry-run' | 'skipped';
+    note: string | null;
+};
+export type WikidataCityImportReportRO = {
+    cityId: number;
+    city: string;
+    dryRun: boolean;
+    attractionsFound: number;
+    attractionsCreated: number;
+    personsFound: number;
+    personsCreated: number;
+    skippedExisting: number;
+    items: WikidataImportCandidateRO[];
+};

package/dist/shared/wikidata-import.js

@@ -0,0 +1,53 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WikidataCityImportDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Импорт кандидатов (атракшены + личности) города из Wikidata SPARQL. */
+class WikidataCityImportDto {
+}
+exports.WikidataCityImportDto = WikidataCityImportDto;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], WikidataCityImportDto.prototype, "cityId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(15),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], WikidataCityImportDto.prototype, "radiusKm", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(200),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], WikidataCityImportDto.prototype, "limitAttractions", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], WikidataCityImportDto.prototype, "limitPersons", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], WikidataCityImportDto.prototype, "dryRun", void 0);