@bytebrand/export-cars 1.26.47 → 1.26.48

package/src/configs/ooyyo.config.ts

@@ -1,15 +1,65 @@
-import { Params } from '../interfaces/params.interface';
-import { Config } from './config';
-import { ExportType, FileType, ImageType } from '../enums';
-
-export class OoyyoConfig extends Config {
-  constructor(params: Params) {
-    super(params);
-    this.pathesConfig.localConvertedDirectory = `resources/${ExportType.OOYYO}-export`;
-    this.imageType = ImageType.default;
-    this.outputFiles = [
-      `${this.pathesConfig.localConvertedDirectory}/api_export_cars_${ExportType.OOYYO}.${FileType.XML}`,
-      `${this.pathesConfig.localConvertedDirectory}/autode-${ExportType.OOYYO}.${FileType.TAR_GZ}`,
-    ];
-  }
-}
+import { toNumber } from 'lodash';
+
+import { ExportType, ImageType } from '../enums';
+import { Params } from '../interfaces/params.interface';
+import { FeedGuardOptions } from '../services/feed-guard';
+import { Config } from './config';
+
+const text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '');
+
+const positiveNumber = (value: unknown, fallback: number): number => {
+  const parsed = toNumber(text(value));
+  return text(value) && Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+};
+
+// Guard defaults (same as AutoUncle / meinestadt / markt.de). minPublishedItems only forbids an
+// empty file; before a live run set it from a PROD dry-run (see docs/ooyyo/RUNBOOK.md).
+export const OOYYO_DEFAULTS = {
+  imageConcurrency: 16,
+  minSourceItems: 1000,
+  minPublishedItems: 1,
+  maxDropPercent: 20,
+  maxSourceAgeHours: 26,
+  maxStaleHours: 48,
+};
+
+/**
+ * OOYYO vehicle XML (ADV-331): one full-inventory XML + the same file gzipped (`.xml.gz`), the two
+ * forms OOYYO accepts from a fixed HTTPS URL (partner, 16.10.2026; FTP not recommended).
+ * Dry-run is the default: the files go to resources/ooyyo-dryrun, which no Cronicle step reads and
+ * nothing serves. Only ooyyoDryRun=false writes resources/ooyyo-export. The legacy
+ * autode-ooyyo.tar.gz (FTP package) is no longer produced. Each mode has its own guard state.
+ */
+export class OoyyoConfig extends Config {
+  dryRun: boolean;
+  imageConcurrency: number;
+  // 0 = no limit (OOYYO accepts all pictures; 20 is only a ranking recommendation)
+  maxImages: number;
+  stateDir: string;
+  feedGuard: FeedGuardOptions;
+
+  constructor(params: Params) {
+    super(params);
+    this.campaign = ExportType.OOYYO;
+    this.dryRun = text(params.ooyyoDryRun).toLowerCase() !== 'false';
+    const mode = this.dryRun ? 'dryrun' : 'export';
+    this.pathesConfig.localConvertedDirectory = `resources/${ExportType.OOYYO}-${mode}`;
+    this.stateDir = `resources/${ExportType.OOYYO}-state/${mode}`;
+    this.imageType = ImageType.clean;
+    this.imageConcurrency = positiveNumber(params.ooyyoImageConcurrency, OOYYO_DEFAULTS.imageConcurrency);
+    this.maxImages = Math.floor(positiveNumber(params.ooyyoMaxImages, 0));
+    this.feedGuard = {
+      stateDir: this.stateDir,
+      minSourceItems: positiveNumber(params.feedGuardMinSourceItems, OOYYO_DEFAULTS.minSourceItems),
+      minPublishedItems: positiveNumber(params.feedGuardMinPublishedItems, OOYYO_DEFAULTS.minPublishedItems),
+      maxDropPercent: positiveNumber(params.feedGuardMaxDropPercent, OOYYO_DEFAULTS.maxDropPercent),
+      maxSourceAgeHours: positiveNumber(params.feedGuardMaxSourceAgeHours, OOYYO_DEFAULTS.maxSourceAgeHours),
+      maxStaleHours: positiveNumber(params.feedGuardMaxStaleHours, OOYYO_DEFAULTS.maxStaleHours),
+      acceptDrop: text(params.feedGuardAcceptDrop).toLowerCase() === 'true',
+    };
+    this.outputFiles = [
+      `${this.pathesConfig.localConvertedDirectory}/${ExportType.OOYYO}.xml`,
+      `${this.pathesConfig.localConvertedDirectory}/${ExportType.OOYYO}.xml.gz`,
+    ];
+  }
+}

package/src/exporters/marktde.exporter.ts

@@ -1,78 +1,78 @@
-import { Injectable } from '@nestjs/common';
-import { ModuleRef } from '@nestjs/core';
-
-import { FsChunkInterface } from '@bytebrand/chunkable';
-import { LoggerService } from '@bytebrand/cronicle-helper';
-
-import { CarService, RulesService, LoaderService, ConfigService, ImagesService } from '../services';
-import { ImageUrlValidator } from '../services/image-url-validator.service';
-import { FeedGuard } from '../services/feed-guard';
-import { MarktdeFeedRun, MarktdeSourceCar } from '../services/marktde-feed-run';
-import { zipSingleFile } from '../services/meinstadt-feed-run';
-import { MobileTransformer } from '../transformers/mobile.transformer';
-import { toMarktdeImages } from '../transformers/marktde.transformer';
-import { resolveOpenAiImageFields } from '../transformers/openai-image-fields';
-import { MarktdeConfig } from '../configs/marktde.config';
-import { Exporter } from '../interfaces/exporter.interface';
-
-/**
- * ExportType.MARKTDE (ADV-328). Was the shared MobileExporter; now wires the Cronicle/Nest services
- * into MarktdeFeedRun, which holds the logic. The row itself still comes from MobileTransformer (same
- * mapping sheet, same columns); only the markt.de columns are replaced. EAUTO / YESCAR / EVIUM keep
- * the MobileExporter unchanged.
- */
-@Injectable()
-export class MarktdeExporter implements Exporter {
-  constructor(
-    private carService: CarService,
-    private configService: ConfigService,
-    private rulesService: RulesService,
-    private loaderService: LoaderService,
-    private imagesService: ImagesService,
-    private moduleRef: ModuleRef,
-  ) {}
-
-  async export(): Promise<void> {
-    const config = this.configService.config as MarktdeConfig;
-    const [csvFile, zipFile] = config.outputFiles;
-    const validator = new ImageUrlValidator({ concurrency: config.imageConcurrency });
-    const transformer = await this.moduleRef.create(MobileTransformer);
-
-    const run = new MarktdeFeedRun(
-      {
-        forEachChunk: fn => this.loaderService.process((chunk: FsChunkInterface) => fn(chunk.data as MarktdeSourceCar[])),
-        filterCar: source => this.carService.filterCar(source, this.rulesService.rules),
-        resolveImages: async ({ car, images }) => toMarktdeImages(
-          await resolveOpenAiImageFields(this.imagesService.getCleanImages(car._id, images), validator),
-          config.maxImages,
-        ),
-        legacyRow: async ({ car, images }) => (await transformer.transform(car, images)) as Record<string, unknown>,
-        imageStats: () => validator.stats,
-        zip: zipSingleFile,
-        guard: new FeedGuard(config.feedGuard),
-      },
-      {
-        runId: config.runId,
-        dryRun: config.dryRun,
-        domain: config.domain,
-        sourceDirectory: config.pathesConfig.localDirectory,
-        sourceBaseFileName: config.pathesConfig.baseFileName,
-        csvFile,
-        zipFile,
-        stateDir: config.stateDir,
-      },
-    );
-
-    try {
-      const report = await run.run();
-      if (report.stale) {
-        console.log(`marktde feed STALE: last good file ${report.lastGoodAgeHours?.toFixed(1)} h old`);
-      }
-    } catch (error) {
-      // main.ts would report a rejected run as {"complete":1,"code":0}; fail the job so the chained
-      // upload step does not run (report + lock already handled by the run).
-      LoggerService.exitError(`marktde feed not published: ${error?.message ?? error}`);
-      process.exit(1);
-    }
-  }
-}
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+
+import { FsChunkInterface } from '@bytebrand/chunkable';
+import { LoggerService } from '@bytebrand/cronicle-helper';
+
+import { CarService, RulesService, LoaderService, ConfigService, ImagesService } from '../services';
+import { ImageUrlValidator } from '../services/image-url-validator.service';
+import { FeedGuard } from '../services/feed-guard';
+import { MarktdeFeedRun, MarktdeSourceCar } from '../services/marktde-feed-run';
+import { zipSingleFile } from '../services/meinstadt-feed-run';
+import { MobileTransformer } from '../transformers/mobile.transformer';
+import { toMarktdeImages } from '../transformers/marktde.transformer';
+import { resolveOpenAiImageFields } from '../transformers/openai-image-fields';
+import { MarktdeConfig } from '../configs/marktde.config';
+import { Exporter } from '../interfaces/exporter.interface';
+
+/**
+ * ExportType.MARKTDE (ADV-328). Was the shared MobileExporter; now wires the Cronicle/Nest services
+ * into MarktdeFeedRun, which holds the logic. The row itself still comes from MobileTransformer (same
+ * mapping sheet, same columns); only the markt.de columns are replaced. EAUTO / YESCAR / EVIUM keep
+ * the MobileExporter unchanged.
+ */
+@Injectable()
+export class MarktdeExporter implements Exporter {
+  constructor(
+    private carService: CarService,
+    private configService: ConfigService,
+    private rulesService: RulesService,
+    private loaderService: LoaderService,
+    private imagesService: ImagesService,
+    private moduleRef: ModuleRef,
+  ) {}
+
+  async export(): Promise<void> {
+    const config = this.configService.config as MarktdeConfig;
+    const [csvFile, zipFile] = config.outputFiles;
+    const validator = new ImageUrlValidator({ concurrency: config.imageConcurrency });
+    const transformer = await this.moduleRef.create(MobileTransformer);
+
+    const run = new MarktdeFeedRun(
+      {
+        forEachChunk: fn => this.loaderService.process((chunk: FsChunkInterface) => fn(chunk.data as MarktdeSourceCar[])),
+        filterCar: source => this.carService.filterCar(source, this.rulesService.rules),
+        resolveImages: async ({ car, images }) => toMarktdeImages(
+          await resolveOpenAiImageFields(this.imagesService.getCleanImages(car._id, images), validator),
+          config.maxImages,
+        ),
+        legacyRow: async ({ car, images }) => (await transformer.transform(car, images)) as Record<string, unknown>,
+        imageStats: () => validator.stats,
+        zip: zipSingleFile,
+        guard: new FeedGuard(config.feedGuard),
+      },
+      {
+        runId: config.runId,
+        dryRun: config.dryRun,
+        domain: config.domain,
+        sourceDirectory: config.pathesConfig.localDirectory,
+        sourceBaseFileName: config.pathesConfig.baseFileName,
+        csvFile,
+        zipFile,
+        stateDir: config.stateDir,
+      },
+    );
+
+    try {
+      const report = await run.run();
+      if (report.stale) {
+        console.log(`marktde feed STALE: last good file ${report.lastGoodAgeHours?.toFixed(1)} h old`);
+      }
+    } catch (error) {
+      // main.ts would report a rejected run as {"complete":1,"code":0}; fail the job so the chained
+      // upload step does not run (report + lock already handled by the run).
+      LoggerService.exitError(`marktde feed not published: ${error?.message ?? error}`);
+      process.exit(1);
+    }
+  }
+}

package/src/exporters/ooyyo.exporter.ts

@@ -1,48 +1,75 @@
-import { Injectable } from '@nestjs/common';
-import { CarService, LoaderService, ConfigService, RulesService } from '../services';
-import { FsChunkInterface } from '@bytebrand/chunkable';
-import { Exporter } from '../interfaces/exporter.interface';
-import { CronicleUtils } from '@bytebrand/cronicle-helper';
-import { ModuleRef } from '@nestjs/core';
-import { Zipper } from '@bytebrand/zipper';
-import { OoyyoXmlBuilder } from '../formats/ooyyo-xml.builder';
-import { OoyyoTransformer } from '../transformers/ooyyo.transformer';
-
-@Injectable()
-export class OoyyoExporter implements Exporter {
-  constructor(
-    private carService: CarService,
-    private configService: ConfigService,
-    private loaderService: LoaderService,
-    private moduleRef: ModuleRef,
-    private rulesService: RulesService,
-  ) {}
-
-  async export(): Promise<void> {
-    const [fileXml, fileGZ] = this.configService.config.outputFiles;
-    await CronicleUtils.ensureDir(this.configService.config.pathesConfig.localConvertedDirectory);
-    await CronicleUtils.emptyDir(this.configService.config.pathesConfig.localConvertedDirectory);
-
-    const ooyyoXmlBuilder = new OoyyoXmlBuilder(fileXml);
-    await ooyyoXmlBuilder.buildStart();
-
-    const ooyyoTransformer = await this.moduleRef.create(OoyyoTransformer);
-
-    await this.loaderService.process(async (chunk: FsChunkInterface) => {
-      const chunkData = chunk.data.filter(car => this.carService.filterCar(car, this.rulesService.rules));
-
-        for (let i = 0; i < chunkData.length; i += 1) {
-          const { car, images } = chunkData[i];
-          // console.time(`Transform ${car._id}`);
-          await ooyyoXmlBuilder.addItem(await ooyyoTransformer.transform(car, images));
-          // console.timeEnd(`Transform ${car._id}`);
-          this.carService.counter.countCar(images);
-        }
-    });
-
-    await ooyyoXmlBuilder.buildEnd();
-    console.log(this.carService.counter.getCountedCars());
-
-    fileGZ && await Zipper.tar({ dest: fileGZ, fileList: [fileXml] });
-  }
-}
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+
+import { FsChunkInterface } from '@bytebrand/chunkable';
+import { LoggerService } from '@bytebrand/cronicle-helper';
+
+import { CarService, RulesService, LoaderService, ConfigService, ImagesService } from '../services';
+import { ImageUrlValidator } from '../services/image-url-validator.service';
+import { FeedGuard } from '../services/feed-guard';
+import { OoyyoFeedRun, OoyyoSourceCar } from '../services/ooyyo-feed-run';
+import { OoyyoTransformer, toOoyyoImages } from '../transformers/ooyyo.transformer';
+import { resolveOpenAiImageFields } from '../transformers/openai-image-fields';
+import { OoyyoConfig } from '../configs/ooyyo.config';
+import { Exporter } from '../interfaces/exporter.interface';
+
+/**
+ * ExportType.OOYYO (ADV-331). Wires the Cronicle/Nest services into OoyyoFeedRun, which holds the
+ * logic. The output directory is no longer emptied: the new XML / XML.gz replace the old ones only
+ * after the snapshot, the written file and the counts passed.
+ */
+@Injectable()
+export class OoyyoExporter implements Exporter {
+  constructor(
+    private carService: CarService,
+    private configService: ConfigService,
+    private loaderService: LoaderService,
+    private rulesService: RulesService,
+    private imagesService: ImagesService,
+    private moduleRef: ModuleRef,
+  ) {}
+
+  async export(): Promise<void> {
+    const config = this.configService.config as OoyyoConfig;
+    const [xmlFile, gzFile] = config.outputFiles;
+    const validator = new ImageUrlValidator({ concurrency: config.imageConcurrency });
+    const transformer = await this.moduleRef.create(OoyyoTransformer);
+
+    const run = new OoyyoFeedRun(
+      {
+        forEachChunk: fn => this.loaderService.process((chunk: FsChunkInterface) => fn(chunk.data as OoyyoSourceCar[])),
+        filterCar: source => this.carService.filterCar(source, this.rulesService.rules),
+        resolveImages: async ({ car, images }) => toOoyyoImages(
+          await resolveOpenAiImageFields(this.imagesService.getCleanImages(car._id, images), validator),
+          config.maxImages,
+        ),
+        translate: selector => transformer.translate(selector),
+        region: (postcode, country) => transformer.region(postcode, country),
+        imageStats: () => validator.stats,
+        guard: new FeedGuard(config.feedGuard),
+      },
+      {
+        runId: config.runId,
+        dryRun: config.dryRun,
+        domain: config.domain,
+        sourceDirectory: config.pathesConfig.localDirectory,
+        sourceBaseFileName: config.pathesConfig.baseFileName,
+        xmlFile,
+        gzFile,
+        stateDir: config.stateDir,
+      },
+    );
+
+    try {
+      const report = await run.run();
+      if (report.stale) {
+        console.log(`ooyyo feed STALE: last good file ${report.lastGoodAgeHours?.toFixed(1)} h old`);
+      }
+    } catch (error) {
+      // main.ts would report a rejected run as {"complete":1,"code":0}; fail the job so the chained
+      // `6.1 … part 2` step does not run (report + lock already handled by the run).
+      LoggerService.exitError(`ooyyo feed not published: ${error?.message ?? error}`);
+      process.exit(1);
+    }
+  }
+}

package/src/formats/ooyyo-xml.builder.ts

@@ -1,48 +1,87 @@
-import { XMLBuilderBase } from '@bytebrand/cronicle-helper';
-import { OoyyoXmlItem } from '../interfaces';
-
-export class OoyyoXmlBuilder extends XMLBuilderBase {
-  async buildStart(): Promise<void> {
-    await this.write(`<?xml version="1.0" encoding="UTF-8"?>
-    <ooyyo xsi:noNamespaceSchemaLocation="OoyyoFormat.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">`);
-  }
-
-  async addItem(car: OoyyoXmlItem): Promise<void> {
-    let item = '';
-
-    item += '\n<ad>\n';
-    item += this.getElement('url', car.url, true);
-    item += this.getElement('title', car.title, true);
-    item += this.getElement('content', car.content, true);
-    item += this.getElement('price', car.price, true, { unit: 'euro' });
-    item += this.getElement('make', car.make, true);
-    item += this.getElement('model', car.model, true);
-    item += this.getElement('trim', car.trim, true);
-    item += this.getElement('engine_size', car.engine_size, true, { unit: 'cc' });
-    item += this.getElement('body_type', car.body_type, true);
-    item += this.getElement('color', car.color, true);
-    item += this.getElement('year', car.year, true);
-    item += this.getElement('mileage', car.mileage, true, { unit: 'km' });
-    item += this.getElement('fuel_type', car.fuel_type, true);
-    item += this.getElement('transmission', car.transmission, true);
-    item += this.getElement('euronorm', car.euronorm, true);
-    item += this.getElement('power', car.power, true, { unit: 'kw' });
-    item += this.getElement('doors', car.doors, true);
-    item += this.getElement('seats', car.seats, true);
-    item += this.getElement('gears', car.gears, true);
-    item += this.getElementsTree('location', car.location, true);
-    item += this.getElementsList('pictures', 'picture', car.pictures, true);
-    item += this.getElement('vin', car.vin, true);
-    item += this.getElement('is_new', car.is_new, true);
-    item += this.getElement('date', car.date, true);
-    item += this.getElement('time', car.time, true);
-    item += '</ad>';
-
-    await this.write(item);
-  }
-
-  async buildEnd(): Promise<void> {
-    await this.write('\n</ooyyo>');
-    await this.end();
-  }
-}
+import { createWriteStream, WriteStream } from 'fs';
+import { OoyyoXmlItem } from '../interfaces';
+
+// Characters XML 1.0 does not allow at all (a single one makes the whole file unreadable).
+// eslint-disable-next-line no-control-regex
+const INVALID_XML_CHARS = /[\u0000-\u0008\u000B\u000C\u000E-\u001F￾￿]|[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
+
+export const stripInvalidXmlChars = (value: string): string => value.replace(INVALID_XML_CHARS, '');
+
+// CDATA cannot contain "]]>": split it across two sections. Everything else goes in verbatim
+// (UTF-8 umlauts, "&" in URLs), exactly as the partner sample wraps every value in CDATA.
+export const cdata = (value: string): string =>
+  `<![CDATA[${stripInvalidXmlChars(value).replace(/]]>/g, ']]]]><![CDATA[>')}]]>`;
+
+/**
+ * Writes the OOYYO XML (ADV-331): UTF-8, root/namespace exactly as OoyyoFormat.xml, element order as
+ * in the sample, every value in CDATA. Empty optional elements are left out — the legacy builder
+ * wrote `<engine_size/>` / `<power/>` without the unit attribute the XSD requires, so such a file was
+ * not schema-valid. `price` always carries unit="EUR".
+ */
+export class OoyyoXmlBuilder {
+  private stream: WriteStream;
+
+  constructor(fileName: string) {
+    this.stream = createWriteStream(fileName, { flags: 'w', encoding: 'utf8' });
+  }
+
+  private write(chunk: string): Promise<void> {
+    return new Promise((resolve, reject) => this.stream.write(chunk, error => (error ? reject(error) : resolve())));
+  }
+
+  async buildStart(): Promise<void> {
+    await this.write('<?xml version="1.0" encoding="UTF-8"?>\n'
+      + '<ooyyo xsi:noNamespaceSchemaLocation="OoyyoFormat.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">\n');
+  }
+
+  async addItem(car: OoyyoXmlItem): Promise<void> {
+    await this.write(OoyyoXmlBuilder.toXml(car));
+  }
+
+  static toXml(car: OoyyoXmlItem): string {
+    const el = (tag: string, value: string, unit?: string, indent = '    '): string =>
+      (value ? `${indent}<${tag}${unit ? ` unit="${unit}"` : ''}>${cdata(value)}</${tag}>\n` : '');
+    const location = [
+      el('city', car.location?.city, undefined, '      '),
+      el('postcode', car.location?.postcode, undefined, '      '),
+      el('region', car.location?.region, undefined, '      '),
+    ].join('');
+    const pictures = (car.pictures ?? []).map(url => el('picture', url, undefined, '      ')).join('');
+
+    return '  <ad>\n'
+      + el('url', car.url)
+      + el('title', car.title)
+      + el('content', car.content)
+      + el('price', car.price, car.priceUnit)
+      + el('make', car.make)
+      + el('model', car.model)
+      + el('engine_size', car.engine_size, 'cc')
+      + el('trim', car.trim)
+      + el('body_type', car.body_type)
+      + el('color', car.color)
+      + el('year', car.year)
+      + el('mileage', car.mileage, 'km')
+      + el('fuel_type', car.fuel_type)
+      + el('transmission', car.transmission)
+      + el('euronorm', car.euronorm)
+      + el('power', car.power, 'kw')
+      + el('doors', car.doors)
+      + el('seats', car.seats)
+      + el('gears', car.gears)
+      + (location ? `    <location>\n${location}    </location>\n` : '')
+      + (pictures ? `    <pictures>\n${pictures}    </pictures>\n` : '')
+      + el('vin', car.vin)
+      + el('is_new', car.is_new)
+      + el('date', car.date)
+      + el('time', car.time)
+      + '  </ad>\n';
+  }
+
+  async buildEnd(): Promise<void> {
+    await this.write('</ooyyo>\n');
+    await new Promise<void>((resolve, reject) => {
+      this.stream.on('error', reject);
+      this.stream.end(() => resolve());
+    });
+  }
+}

package/src/interfaces/export-item.interface.ts

@@ -62,9 +62,50 @@ export interface Auto24XmlItem {
   dealer_phone: string;
 }
 
-export interface OoyyoXmlItem extends FbXmlItem {
-  euronorm: string;
+// One OOYYO <ad> (ADV-331). '' = element left out (every element is optional in OoyyoFormat.xsd;
+// the importer's mandatory fields are enforced by validateOoyyoItem).
+export interface OoyyoXmlItem {
+  url: string;
+  title: string;
+  content: string;
+  // whole euros
+  price: string;
+  // always 'EUR' (partner, 19.10.2026)
+  priceUnit: 'EUR';
+  make: string;
+  model: string;
+  // ccm, unit="cc"
+  engine_size: string;
+  trim: string;
+  body_type: string;
+  color: string;
+  year: string;
+  // unit="km"
   mileage: string;
+  fuel_type: string;
+  transmission: string;
+  euronorm: string;
+  // unit="kw"
+  power: string;
+  doors: string;
+  seats: string;
+  gears: string;
+  location: {
+    city: string;
+    // string, leading zero kept
+    postcode: string;
+    // Bundesland
+    region: string;
+  };
+  // validated public HTTPS photo URLs, hero first
+  pictures: string[];
+  vin: string;
+  // '1' new, '0' used
+  is_new: string;
+  // DD/MM/YYYY, Europe/Berlin
+  date: string;
+  // HH:MM, Europe/Berlin
+  time: string;
 }
 
 // Keys and order as the meinestadt exporter emits them (see docs/meinestadt/AUDIT.md §3).

package/src/interfaces/params.interface.ts

@@ -53,6 +53,11 @@ export interface Params {
   marktdeDryRun?: string;
   marktdeImageConcurrency?: string;
   marktdeMaxImages?: string;
+  // OOYYO feed only (ADV-331), Cronicle text params; see configs/ooyyo.config.ts.
+  // Live output needs ooyyoDryRun=false explicitly.
+  ooyyoDryRun?: string;
+  ooyyoImageConcurrency?: string;
+  ooyyoMaxImages?: string;
 }
 
 // Parsed from feedItemsBq* by GoogleConfig.