@bytebrand/export-cars 1.22.26 → 1.22.27

package/src/transformers/google.transformer.ts

@@ -1,584 +1,584 @@
-import { escape, get, isNumber, join, round, toSafeInteger, toString, trim, truncate } from 'lodash';
-import { CarDescriptionFactory, DescriptionTypeEnum } from '@bytebrand/car-description';
-import { DataSchemes } from '@bytebrand/car-schema';
-import { TranslatorExtended } from '@bytebrand/schema-tools';
-import { de, deVehicleDetailsPage, deVehicleProps } from '@bytebrand/i18n-dictionaries';
-import { ImboImageResponseInterface } from '@bytebrand/chunkable';
-import { Injectable } from '@nestjs/common';
-import { ConfigService, ImagesService, TransformerService, UserService } from '../services';
-import { GoogleXmlItem } from '../interfaces';
-import { isValidVin } from '../utils';
-
-const GOOGLE_MAX_TRIM_LENGTH = 50;
-const TIMESTAMP_FIRST_YEAR = 1970;
-
-@Injectable()
-export class GoogleTransformer {
-  private translator: TranslatorExtended;
-
-  constructor(
-    private userService: UserService,
-    private configService: ConfigService,
-    private imageService: ImagesService,
-    private readonly transformService: TransformerService,
-  ) {
-    const dict = { ...de, ...deVehicleProps, ...deVehicleDetailsPage };
-    this.translator = new TranslatorExtended(dict);
-  }
-
-  async transform({ car, images }: { car: DataSchemes.Car; images: Array<any> }): Promise<GoogleXmlItem> {
-    if (!this.checkCarValidity(car, images))
-      return null
-
-    const carId = toString(get(car, '_id', ''));
-    const transformedImages = await this.imageService.getExtIntDefaultImages(
-      car,
-      images,
-      this.configService.config.imageType,
-      false,
-    );
-
-    if (!transformedImages.extMain.length) {
-      console.log(`Car ${car._id} has no extMain image`);
-      return null
-    }
-
-    const allImages = [
-      ...transformedImages.extMain,
-      ...transformedImages.ext,
-      ...transformedImages.int,
-      ...transformedImages.feat
-    ]
-
-    const item: GoogleXmlItem = {
-      google_product_category: '916',
-      vehicle_fulfillment: {
-        option: 'online',
-        store_code: 'Online_shop'
-      },
-      certification: this.getCertification(car),
-      title: this.getTitle(car),
-      product_type: this.getCategory(car),
-      VIN: this.getVin(car),
-      id: carId,
-      image_link: allImages[0],
-      additional_image_link: allImages.slice(1, 10),
-      ads_redirect: this.getLink(car),
-      link: this.getLink(car),
-      link_template: `${this.getLink(car)}?store={store_code}`,
-      condition: this.mapState(car),
-      price: this.getPrice(car),
-      vehicle_msrp: this.getVehicleMsrp(car),
-      // certified_pre-owned: '',
-      brand: this.transformService.make(car),
-      model: this.transformService.model(car),
-      trim: this.getTrim(car),
-      year: this.getYear(car),
-      mileage: `${this.transformService.mileage(car)}km`,
-      color: this.getColor(car),
-      vehicle_option: this.getExtrasField(car),
-      body_style: this.mapBodyStyle(car),
-      engine: this.mapFuel(car),
-      transmission: this.mapTransmission(car),
-      drive: this.mapDrive(car),
-      doors: this.getDoors(car),
-      capacity: this.getCapacity(car),
-      date_first_registered: this.getDateFirstRegistered(car),
-      fuel_consumption: `${this.transformService.fuelConsumption(car)}l/100km`,
-      energy_consumption: this.getEnergyConsumption(car),
-      electric_range: this.getElectricRange(car),
-      fuel_consumption_discharged_battery: this.getFuelConsumptionDischargedBattery(car),
-      co2_emissions: `${this.transformService.cO2Emission(car)}g/km`,
-      description: this.processText((await this.getDescription(car))),
-      identifier_exists: 'yes',
-      availability: 'in_stock',
-      // custom_label_0: '',
-      // custom_label_1: '',
-      // custom_label_2: '',
-      // custom_label_3: '',
-      // custom_label_4: '',
-
-      // availability: this.getAvailability(car),
-      // sale_price: this.getPrice(car),
-      // energy_efficiency_class: this.getEnergyClass(car),
-      installment: this.getInstallment(car),
-      // custom_label_0: `${this.getInstallment(car)} EUR mtl.`,
-    };
-
-    // Google rejects empty/partial values — getElement() emits `<tag/>` for falsy
-    // values, which Merchant treats as "missing". Drop optional attributes that have
-    // no data (certification when CO2 class unknown, EV-only metrics on non-EV cars,
-    // installment when APR is missing) instead of emitting empty tags.
-    const optionalKeys: Array<keyof GoogleXmlItem> = [
-      'certification',
-      'energy_consumption',
-      'electric_range',
-      'fuel_consumption_discharged_battery',
-      'installment',
-      'body_style',
-      'vehicle_msrp',
-      'transmission',
-      'drive',
-      'doors',
-      'capacity',
-    ];
-    for (const key of optionalKeys) {
-      if (!item[key]) {
-        delete item[key];
-      }
-    }
-
-    return item;
-  }
-
-  private checkCarValidity(car: DataSchemes.Car, images: ImboImageResponseInterface[]) {
-    if (images.length === 0)
-      return false
-
-    return true
-  }
-
-  private getVin(car: DataSchemes.Car): string {
-    const vin = get(car, 'metaData.vin', '');
-    return isValidVin(vin) ? vin : get(car, 'marketing.fakeVIN', '');
-  }
-
-  private getTitle(car: DataSchemes.Car): string {
-    const model = toString(get(car, 'mainData.model', ''));
-    const brand = trim(this.getBrand(car));
-    const subModel = trim(this.getTrim(car));
-    const year = this.getYear(car);
-
-    const titleParts = [brand, model, year, subModel].filter(Boolean);
-
-    return truncate(trim(escape(join(titleParts, ' '))), { length: 100, separator: ' ' });
-  }
-
-  private processText(input: string) {
-    return input
-      .replace(/\*\*\\/g, '</strong></p>|||')
-      .replace(/\*\*/g, '<p><strong>')
-      .split('|||')
-      .map(item => item.trim())
-      .flatMap(str =>
-        str.split('\\')
-          .map(item => item.trim())
-          .filter(Boolean)
-      )
-      .map(item =>
-        item.startsWith('* ') ? item.slice(2) : item
-      )
-      .map(item =>
-        item.includes('<p>') ? item : `<p>${item}</p>`
-      )
-      .join('');
-  }
-
-  private async getDescription(car: DataSchemes.Car): Promise<string> {
-    const dealerId = get(car, 'metaData.ownerId');
-    const descriptionSchema = await this.userService.getDefaultSummaryByDealerId(dealerId);
-    const descriptionBuilder = CarDescriptionFactory.create(DescriptionTypeEnum.Mobile, car);
-
-    const transformedBody = descriptionBuilder.transformSeparately(descriptionSchema)
-
-    return transformedBody.body;
-  }
-
-  private getCategory(car: DataSchemes.Car): string {
-    return this.translator.translateVal(get(car, 'mainData.category', ''));
-  }
-
-  private getBreadcrumbs(car: DataSchemes.Car): string {
-    const make = get(car, 'mainData.make', '');
-    const model = get(car, 'mainData.model', '');
-
-    return `${make} ${model}`;
-  }
-
-  private getLink(car: DataSchemes.Car): string {
-    const autodeId = get(car, '_id', '');
-    if (this.configService.config.isCriteo) {
-      return `https://www.${this.configService.config.domain}/search/vehicle/${autodeId}?source=criteo&medium=cpc&campaign=retargeting`;
-    }
-    return `https://www.${this.configService.config.domain}/search/vehicle/${autodeId}`;
-  }
-
-  protected getWLTP(car: any): any {
-    const envkvCompliant = get(car, 'consumption.envkvCompliant');
-    const hybridPlagin = get(car, 'engineData.hybridPlugin');
-
-    if (envkvCompliant && hybridPlagin) {
-      const powerCombined = get(car, 'consumption.consumptionPowerCombined');
-      return `${powerCombined}kWt/100km`;
-    }
-  }
-
-  private getVehicleMsrp(car: DataSchemes.Car): string | undefined {
-    const retailPrice = get(car, 'price.recomendedRetailPrice');
-    const salesPrice = get(car, 'price.currentSalesPrice', 0);
-    if (!retailPrice || round(retailPrice, 2) === round(salesPrice, 2)) {
-      return undefined;
-    }
-    return `${round(retailPrice, 2)} EUR`;
-  }
-
-  private getPrice(car: DataSchemes.Car): string {
-    const price = get(car, 'price.currentSalesPrice', 0);
-    return `${round(price, 2)} EUR`;
-  }
-
-  private getColor(car: DataSchemes.Car): string {
-    let colorSelection = get(car, 'exterior.exteriorColor', 'other');
-    if (!colorSelection || colorSelection === 'selector_unknown') {
-      colorSelection = 'other';
-    }
-    return this.translator.translateVal(colorSelection);
-  }
-
-  private mapState(car: DataSchemes.Car): string {
-    const available = {
-      selector_condition_new: 'New',
-      selector_condition_used: 'Used',
-      selector_unknown: 'Used',
-    };
-    const condition = get(car, 'mainData.condition', 'selector_unknown');
-    return get(available, condition);
-  }
-
-  private getAvailability(car: DataSchemes.Car): string {
-    const available = {
-      selector_availabilityMode_fromDate: 'Ab einem bestimmten Datum',
-      selector_availabilityMode_unknown: 'Ab einem bestimmten Datum',
-      selector_availabilityMode_always: 'Sofort',
-    };
-    const availability = get(car, 'offer.availabilityMode', 'selector_availabilityMode_unknown');
-    return get(available, availability);
-  }
-
-  private mapEnergyClass(selector: string): string {
-    const available = {
-      selector_energyEfficiencyClass_a: 'A',
-      selector_energyEfficiencyClass_ap: 'A+',
-      selector_energyEfficiencyClass_app: 'A++',
-      selector_energyEfficiencyClass_appp: 'A+++',
-      selector_energyEfficiencyClass_b: 'B',
-      selector_energyEfficiencyClass_c: 'C',
-      selector_energyEfficiencyClass_d: 'D',
-      selector_energyEfficiencyClass_e: 'E',
-      selector_energyEfficiencyClass_f: 'F',
-      selector_energyEfficiencyClass_g: 'G',
-      selector_unknown: 'default',
-    };
-    const value = get(available, selector);
-    return value ? value.replace(/\+/g, '') : '';
-  }
-
-  private getEnergyClass(car: DataSchemes.Car): string {
-    return this.mapEnergyClass(get(car, 'environmentEmissions.energyEfficiencyClass', 'selector_unknown'));
-  }
-
-  private getDischargedEnergyClass(car: DataSchemes.Car): string {
-    return this.mapEnergyClass(get(car, 'environmentEmissions.wltpDischargedEnergyEfficiencyClass', 'selector_unknown'));
-  }
-
-  private getCertification(car: DataSchemes.Car) {
-    const certifications: Array<{ certification_authority: string; certification_name: string; certification_value: string }> = [];
-
-    const co2Class = this.getEnergyClass(car);
-    if (co2Class && co2Class !== 'default') {
-      certifications.push({
-        certification_authority: 'BMWK',
-        certification_name: 'Vehicle_CO2_Class',
-        certification_value: co2Class,
-      });
-    }
-
-    if (get(car, 'engineData.hybridPlugin')) {
-      const dischargedClass = this.getDischargedEnergyClass(car);
-      if (dischargedClass && dischargedClass !== 'default') {
-        certifications.push({
-          certification_authority: 'BMWK',
-          certification_name: 'Vehicle_CO2_Class_Discharged_Battery',
-          certification_value: dischargedClass,
-        });
-      }
-    }
-
-    return certifications.length ? certifications : undefined;
-  }
-
-  private getEnergyConsumption(car: DataSchemes.Car): string | undefined {
-    const fuel = get(car, 'consumption.fuel');
-    const isElectricOrHybrid =
-      ['selector_fuel_electrical', 'selector_fuel_hybridElectricalPetrol', 'selector_fuel_hybridElectricalDiesel'].includes(fuel) ||
-      !!get(car, 'engineData.hybridPlugin');
-    if (!isElectricOrHybrid) {
-      return undefined;
-    }
-    const power = get(car, 'consumption.wltpPowerCombined') || get(car, 'consumption.consumptionPowerCombined');
-    return power ? `${power}kWh/100km` : undefined;
-  }
-
-  private getElectricRange(car: DataSchemes.Car): string | undefined {
-    const range = get(car, 'battery.batteryRangeElectric') || get(car, 'battery.wltpRange');
-    return range ? `${range}km` : undefined;
-  }
-
-  private getFuelConsumptionDischargedBattery(car: DataSchemes.Car): string | undefined {
-    if (!get(car, 'engineData.hybridPlugin')) {
-      return undefined;
-    }
-    const consumption = get(car, 'consumption.consumptionCombined') || get(car, 'consumption.wltpCombined');
-    return consumption ? `${consumption}l/100km` : undefined;
-  }
-
-  private getInstallment(car: DataSchemes.Car) {
-    const monthlyInstallment = round(get(car, 'rate.monthlyInstallment', null));
-    const paybackPeriod = round(get(car, 'rate.paybackPeriod', null));
-    const apr = toString(get(car, 'financing.annualPercentageRate', '')).trim();
-
-    // Google requires `apr` inside the installment block; a partial installment
-    // block (without apr) makes Google reject the whole attribute. If financing
-    // data is incomplete, omit installment entirely so the rest of the item stays valid.
-    if (!monthlyInstallment || !paybackPeriod || !apr) {
-      return undefined;
-    }
-
-    return {
-      paybackPeriod,
-      monthlyInstallment,
-      apr,
-    };
-  }
-
-  private getBrand(car: DataSchemes.Car): string {
-    const make = get(car, 'mainData.make', '');
-
-    switch (make) {
-      case 'Mercedes-Benz':
-        return 'Mercedes';
-      case 'Volkswagen':
-        return 'VW';
-      default:
-        return make;
-    }
-  }
-
-  private mapFuel(car: DataSchemes.Car): string {
-    const available = {
-      selector_fuel_petrol: 'Gasoline',
-      selector_fuel_diesel: 'Diesel',
-      selector_fuel_electrical: 'Electric',
-      selector_fuel_hybridElectricalPetrol: 'Hybrid',
-      selector_fuel_hybridElectricalDiesel: 'Hybrid',
-      selector_fuel_carGas: 'CarGas',
-      selector_fuel_naturalGas: 'NaturalGas',
-      selector_fuel_ethanol: 'Ethanol',
-      selector_fuel_hydrogen: 'Hydrogen',
-      selector_unknown: 'Other',
-    };
-    const fuel = get(car, 'consumption.fuel', 'selector_unknown');
-    let engine = get(available, fuel, 'Other')
-    const hybridPlugin = car?.engineData?.hybridPlugin;
-    if (engine === 'Hybrid' && hybridPlugin)
-      engine = 'plug-in_hybrid';
-
-    return engine;
-  }
-
-  private mapBodyStyle(car: DataSchemes.Car): string {
-    const available = {
-      selector_category_combi: 'station wagon',
-      selector_category_sedan: 'sedan',
-      selector_category_coupe: 'coupe',
-      selector_category_convertible: 'convertible',
-      selector_category_suv: 'suv',
-      selector_category_van: 'full size van',
-      selector_category_transporter: 'truck',
-      selector_category_minibus: 'minivan',
-    };
-    const category = get(car, 'mainData.category', 'selector_unknown');
-    return get(available, category);
-  }
-
-  private mapTransmission(car: DataSchemes.Car): string | undefined {
-    const available = {
-      selector_gearbox_manualShift: 'MANUAL',
-      selector_gearbox_semiAutomatic: 'AUTOMATIC',
-      selector_gearbox_automatic: 'AUTOMATIC',
-    };
-    return get(available, get(car, 'driveSuspension.gearbox'));
-  }
-
-  private mapDrive(car: DataSchemes.Car): string | undefined {
-    const available = {
-      selector_driveType_frontWheelDrive: 'FWD',
-      selector_driveType_rearWheelDrive: 'RWD',
-      selector_driveType_allWheelDrive: 'AWD',
-    };
-    return get(available, get(car, 'driveSuspension.driveType'));
-  }
-
-  private getDoors(car: DataSchemes.Car): number | undefined {
-    return toSafeInteger(get(car, 'mainData.doors')) || undefined;
-  }
-
-  private getCapacity(car: DataSchemes.Car): number | undefined {
-    return toSafeInteger(get(car, 'engineData.cubicCapacity')) || undefined;
-  }
-
-  private getExtrasField(car: DataSchemes.Car): string[] {
-    const booleanFields: string[] = [
-      'engineData.startStopSystem',
-      'window.panoramicGlassRoof',
-      'assistants.automaticRainSensor',
-      'assistants.cruiseControl',
-      'assistants.headUpDisplay',
-      'assistants.abs',
-      'assistants.esp',
-      'assistants.collisionAvoidance',
-      'assistants.trafficSignRecognition',
-      'lights.xenonHeadlights',
-      'lights.ledHeadlights',
-      'lights.laserHeadlights',
-      'lights.lightSensor',
-      'wheel.multifunctionalWheel',
-      'heatingCooling.auxiliaryHeating',
-      'trailerCoupling.trailerCouplingFix',
-      'trailerCoupling.trailerCouplingRemovable',
-      'trailerCoupling.trailerCouplingRotatable',
-      'multimedia.navigationSystem',
-      'multimedia.bluetooth',
-      'multimedia.handsFreePhoneSystem',
-    ];
-
-    const selectorFields: string[] = [
-      'driveSuspension.driveType',
-      'interior.interiorType',
-      'heatingCooling.climatisation',
-    ];
-
-    const selectorListFields: string[] = [
-      'seats.driverSeats',
-      'seats.coDriverSeats',
-      'seats.backSeats',
-      'assistants.parkingAssistants',
-      'airbags.airbag',
-    ];
-
-    const filteredBooleanFields = booleanFields.filter((field: string) => {
-      return get(car, field, false);
-    });
-    const filteredSelectorFields = selectorFields.filter((field: string) => {
-      const value = get(car, field);
-      return value && value !== 'selector_unknown';
-    });
-    const filteredSelectorListFields = selectorListFields.filter((field: string) => {
-      const list: string[] = get(car, field);
-      if (this.isNotEmptyArray(list)) {
-        const filtered: string[] = list.filter((selector: string) => {
-          return selector && selector !== 'selector_unknown';
-        });
-        return filtered.length;
-      }
-      return false;
-    });
-    return filteredBooleanFields
-      .concat(filteredSelectorFields)
-      .concat(filteredSelectorListFields)
-      .slice(0, 200)
-      .map((field: string) => {
-        return this.translator.translateVal(field.replace('.', '_'));
-      })
-      .map((field: string) => {
-        return field.substring(0, 200)
-      });
-  }
-
-  private getTrim(car: DataSchemes.Car): string {
-    const trim = toString(get(car, 'mainData.subModel', ''));
-    return truncate(trim, { length: GOOGLE_MAX_TRIM_LENGTH, separator: ' ' });
-  }
-
-  private convertToSeconds(fieldValue: string | number | Date | null): any {
-    if (fieldValue === null) {
-      return null;
-    }
-
-    let timestamp = 0;
-
-    if (typeof fieldValue === 'number') {
-      if (fieldValue > 1e12) {
-        timestamp = fieldValue;
-      } else {
-        timestamp = fieldValue * 1000;
-      }
-    }
-
-    return Math.floor(timestamp);
-  }
-
-  private monthDiffLess(car: DataSchemes.Car, month: number) {
-    const fieldDate = new Date(this.convertToSeconds(car.mainData.firstRegistration)).getTime();
-    const conditionDate = new Date().getTime();
-    if (!isNumber(fieldDate)) {
-      return false;
-    }
-
-    const monthsDifference = (fieldDate - conditionDate) / (1000 * 60 * 60 * 24 * 30);
-
-    return Math.round(Math.abs(monthsDifference)) <= month;
-  }
-
-  private getMileage(car: DataSchemes.Car): number {
-    let mileage = get(car, 'mainData.mileage', 0);
-
-    if (mileage < 1000)
-      mileage = 1001
-
-    return !mileage ? 10 : mileage;
-  }
-
-  private getYear(car: DataSchemes.Car): number {
-    // mainData.firstModelsProductionDate is already a 4-digit year (mobile.de "vintage").
-    // constructionYear/firstRegistration/metaData.creationDate are unix timestamps in
-    // seconds (constructionYear is stored via legacy dateToUnix, not a bare year — see
-    // services/scrapper/src/ai/car-bridge.ts:174). Not every car has firstModelsProductionDate
-    // (e.g. dealer FTP imports), so fall through to other date sources — `year` is a
-    // mandatory Google feed field.
-    const firstModelsProductionYear = toSafeInteger(get(car, 'mainData.firstModelsProductionDate', 0));
-    const constructionYear = new Date(+get(car, 'mainData.constructionYear', 0) * 1000).getUTCFullYear();
-    const firstRegistrationYear = new Date(+get(car, 'mainData.firstRegistration', 0) * 1000).getUTCFullYear();
-    const metaCreationYear = new Date(+get(car, 'metaData.creationDate', 0) * 1000).getUTCFullYear();
-    const currentYear = new Date().getUTCFullYear();
-
-    return [firstModelsProductionYear, constructionYear, firstRegistrationYear, metaCreationYear, currentYear]
-      .find(year => year > TIMESTAMP_FIRST_YEAR);
-  }
-
-  private getDateFirstRegistered(car: DataSchemes.Car): string {
-    let timestamp = +get(car, 'mainData.firstRegistration', '');
-
-    if (!timestamp) {
-      timestamp = Math.round(new Date().getTime() / 1000);
-    }
-
-    if (!car.mainData.firstRegistration || this.monthDiffLess(car, 8)) {
-      const currentDate = new Date();
-      currentDate.setMonth(currentDate.getMonth() - 9);
-      timestamp = Math.round(currentDate.getTime() / 1000);
-    }
-
-    const date = new Date(timestamp * 1000);
-    const month = date.getUTCMonth() + 1;
-    const year = date.getUTCFullYear();
-
-    const formattedMonth = month < 10 ? `0${month}` : month;
-
-    return `${year}-${formattedMonth}`;
-  }
-
-  private isNotEmptyArray(array: any[]): boolean {
-    return array && Array.isArray(array) && !!array.length;
-  }
-}
+import { escape, get, isNumber, join, round, toSafeInteger, toString, trim, truncate } from 'lodash';
+import { CarDescriptionFactory, DescriptionTypeEnum } from '@bytebrand/car-description';
+import { DataSchemes } from '@bytebrand/car-schema';
+import { TranslatorExtended } from '@bytebrand/schema-tools';
+import { de, deVehicleDetailsPage, deVehicleProps } from '@bytebrand/i18n-dictionaries';
+import { ImboImageResponseInterface } from '@bytebrand/chunkable';
+import { Injectable } from '@nestjs/common';
+import { ConfigService, ImagesService, TransformerService, UserService } from '../services';
+import { GoogleXmlItem } from '../interfaces';
+import { isValidVin } from '../utils';
+
+const GOOGLE_MAX_TRIM_LENGTH = 50;
+const TIMESTAMP_FIRST_YEAR = 1970;
+
+@Injectable()
+export class GoogleTransformer {
+  private translator: TranslatorExtended;
+
+  constructor(
+    private userService: UserService,
+    private configService: ConfigService,
+    private imageService: ImagesService,
+    private readonly transformService: TransformerService,
+  ) {
+    const dict = { ...de, ...deVehicleProps, ...deVehicleDetailsPage };
+    this.translator = new TranslatorExtended(dict);
+  }
+
+  async transform({ car, images }: { car: DataSchemes.Car; images: Array<any> }): Promise<GoogleXmlItem> {
+    if (!this.checkCarValidity(car, images))
+      return null
+
+    const carId = toString(get(car, '_id', ''));
+    const transformedImages = await this.imageService.getExtIntDefaultImages(
+      car,
+      images,
+      this.configService.config.imageType,
+      false,
+    );
+
+    if (!transformedImages.extMain.length) {
+      console.log(`Car ${car._id} has no extMain image`);
+      return null
+    }
+
+    const allImages = [
+      ...transformedImages.extMain,
+      ...transformedImages.ext,
+      ...transformedImages.int,
+      ...transformedImages.feat
+    ]
+
+    const item: GoogleXmlItem = {
+      google_product_category: '916',
+      vehicle_fulfillment: {
+        option: 'online',
+        store_code: 'Online_shop'
+      },
+      certification: this.getCertification(car),
+      title: this.getTitle(car),
+      product_type: this.getCategory(car),
+      VIN: this.getVin(car),
+      id: carId,
+      image_link: allImages[0],
+      additional_image_link: allImages.slice(1, 10),
+      ads_redirect: this.getLink(car),
+      link: this.getLink(car),
+      link_template: `${this.getLink(car)}?store={store_code}`,
+      condition: this.mapState(car),
+      price: this.getPrice(car),
+      vehicle_msrp: this.getVehicleMsrp(car),
+      // certified_pre-owned: '',
+      brand: this.transformService.make(car),
+      model: this.transformService.model(car),
+      trim: this.getTrim(car),
+      year: this.getYear(car),
+      mileage: `${this.transformService.mileage(car)}km`,
+      color: this.getColor(car),
+      vehicle_option: this.getExtrasField(car),
+      body_style: this.mapBodyStyle(car),
+      engine: this.mapFuel(car),
+      transmission: this.mapTransmission(car),
+      drive: this.mapDrive(car),
+      doors: this.getDoors(car),
+      capacity: this.getCapacity(car),
+      date_first_registered: this.getDateFirstRegistered(car),
+      fuel_consumption: `${this.transformService.fuelConsumption(car)}l/100km`,
+      energy_consumption: this.getEnergyConsumption(car),
+      electric_range: this.getElectricRange(car),
+      fuel_consumption_discharged_battery: this.getFuelConsumptionDischargedBattery(car),
+      co2_emissions: `${this.transformService.cO2Emission(car)}g/km`,
+      description: this.processText((await this.getDescription(car))),
+      identifier_exists: 'yes',
+      availability: 'in_stock',
+      // custom_label_0: '',
+      // custom_label_1: '',
+      // custom_label_2: '',
+      // custom_label_3: '',
+      // custom_label_4: '',
+
+      // availability: this.getAvailability(car),
+      // sale_price: this.getPrice(car),
+      // energy_efficiency_class: this.getEnergyClass(car),
+      installment: this.getInstallment(car),
+      // custom_label_0: `${this.getInstallment(car)} EUR mtl.`,
+    };
+
+    // Google rejects empty/partial values — getElement() emits `<tag/>` for falsy
+    // values, which Merchant treats as "missing". Drop optional attributes that have
+    // no data (certification when CO2 class unknown, EV-only metrics on non-EV cars,
+    // installment when APR is missing) instead of emitting empty tags.
+    const optionalKeys: Array<keyof GoogleXmlItem> = [
+      'certification',
+      'energy_consumption',
+      'electric_range',
+      'fuel_consumption_discharged_battery',
+      'installment',
+      'body_style',
+      'vehicle_msrp',
+      'transmission',
+      'drive',
+      'doors',
+      'capacity',
+    ];
+    for (const key of optionalKeys) {
+      if (!item[key]) {
+        delete item[key];
+      }
+    }
+
+    return item;
+  }
+
+  private checkCarValidity(car: DataSchemes.Car, images: ImboImageResponseInterface[]) {
+    if (images.length === 0)
+      return false
+
+    return true
+  }
+
+  private getVin(car: DataSchemes.Car): string {
+    const vin = get(car, 'metaData.vin', '');
+    return isValidVin(vin) ? vin : get(car, 'marketing.fakeVIN', '');
+  }
+
+  private getTitle(car: DataSchemes.Car): string {
+    const model = toString(get(car, 'mainData.model', ''));
+    const brand = trim(this.getBrand(car));
+    const subModel = trim(this.getTrim(car));
+    const year = this.getYear(car);
+
+    const titleParts = [brand, model, year, subModel].filter(Boolean);
+
+    return truncate(trim(escape(join(titleParts, ' '))), { length: 100, separator: ' ' });
+  }
+
+  private processText(input: string) {
+    return input
+      .replace(/\*\*\\/g, '</strong></p>|||')
+      .replace(/\*\*/g, '<p><strong>')
+      .split('|||')
+      .map(item => item.trim())
+      .flatMap(str =>
+        str.split('\\')
+          .map(item => item.trim())
+          .filter(Boolean)
+      )
+      .map(item =>
+        item.startsWith('* ') ? item.slice(2) : item
+      )
+      .map(item =>
+        item.includes('<p>') ? item : `<p>${item}</p>`
+      )
+      .join('');
+  }
+
+  private async getDescription(car: DataSchemes.Car): Promise<string> {
+    const dealerId = get(car, 'metaData.ownerId');
+    const descriptionSchema = await this.userService.getDefaultSummaryByDealerId(dealerId);
+    const descriptionBuilder = CarDescriptionFactory.create(DescriptionTypeEnum.Mobile, car);
+
+    const transformedBody = descriptionBuilder.transformSeparately(descriptionSchema)
+
+    return transformedBody.body;
+  }
+
+  private getCategory(car: DataSchemes.Car): string {
+    return this.translator.translateVal(get(car, 'mainData.category', ''));
+  }
+
+  private getBreadcrumbs(car: DataSchemes.Car): string {
+    const make = get(car, 'mainData.make', '');
+    const model = get(car, 'mainData.model', '');
+
+    return `${make} ${model}`;
+  }
+
+  private getLink(car: DataSchemes.Car): string {
+    const autodeId = get(car, '_id', '');
+    if (this.configService.config.isCriteo) {
+      return `https://www.${this.configService.config.domain}/search/vehicle/${autodeId}?source=criteo&medium=cpc&campaign=retargeting`;
+    }
+    return `https://www.${this.configService.config.domain}/search/vehicle/${autodeId}`;
+  }
+
+  protected getWLTP(car: any): any {
+    const envkvCompliant = get(car, 'consumption.envkvCompliant');
+    const hybridPlagin = get(car, 'engineData.hybridPlugin');
+
+    if (envkvCompliant && hybridPlagin) {
+      const powerCombined = get(car, 'consumption.consumptionPowerCombined');
+      return `${powerCombined}kWt/100km`;
+    }
+  }
+
+  private getVehicleMsrp(car: DataSchemes.Car): string | undefined {
+    const retailPrice = get(car, 'price.recomendedRetailPrice');
+    const salesPrice = get(car, 'price.currentSalesPrice', 0);
+    if (!retailPrice || round(retailPrice, 2) === round(salesPrice, 2)) {
+      return undefined;
+    }
+    return `${round(retailPrice, 2)} EUR`;
+  }
+
+  private getPrice(car: DataSchemes.Car): string {
+    const price = get(car, 'price.currentSalesPrice', 0);
+    return `${round(price, 2)} EUR`;
+  }
+
+  private getColor(car: DataSchemes.Car): string {
+    let colorSelection = get(car, 'exterior.exteriorColor', 'other');
+    if (!colorSelection || colorSelection === 'selector_unknown') {
+      colorSelection = 'other';
+    }
+    return this.translator.translateVal(colorSelection);
+  }
+
+  private mapState(car: DataSchemes.Car): string {
+    const available = {
+      selector_condition_new: 'New',
+      selector_condition_used: 'Used',
+      selector_unknown: 'Used',
+    };
+    const condition = get(car, 'mainData.condition', 'selector_unknown');
+    return get(available, condition);
+  }
+
+  private getAvailability(car: DataSchemes.Car): string {
+    const available = {
+      selector_availabilityMode_fromDate: 'Ab einem bestimmten Datum',
+      selector_availabilityMode_unknown: 'Ab einem bestimmten Datum',
+      selector_availabilityMode_always: 'Sofort',
+    };
+    const availability = get(car, 'offer.availabilityMode', 'selector_availabilityMode_unknown');
+    return get(available, availability);
+  }
+
+  private mapEnergyClass(selector: string): string {
+    const available = {
+      selector_energyEfficiencyClass_a: 'A',
+      selector_energyEfficiencyClass_ap: 'A+',
+      selector_energyEfficiencyClass_app: 'A++',
+      selector_energyEfficiencyClass_appp: 'A+++',
+      selector_energyEfficiencyClass_b: 'B',
+      selector_energyEfficiencyClass_c: 'C',
+      selector_energyEfficiencyClass_d: 'D',
+      selector_energyEfficiencyClass_e: 'E',
+      selector_energyEfficiencyClass_f: 'F',
+      selector_energyEfficiencyClass_g: 'G',
+      selector_unknown: 'default',
+    };
+    const value = get(available, selector);
+    return value ? value.replace(/\+/g, '') : '';
+  }
+
+  private getEnergyClass(car: DataSchemes.Car): string {
+    return this.mapEnergyClass(get(car, 'environmentEmissions.energyEfficiencyClass', 'selector_unknown'));
+  }
+
+  private getDischargedEnergyClass(car: DataSchemes.Car): string {
+    return this.mapEnergyClass(get(car, 'environmentEmissions.wltpDischargedEnergyEfficiencyClass', 'selector_unknown'));
+  }
+
+  private getCertification(car: DataSchemes.Car) {
+    const certifications: Array<{ certification_authority: string; certification_name: string; certification_value: string }> = [];
+
+    const co2Class = this.getEnergyClass(car);
+    if (co2Class && co2Class !== 'default') {
+      certifications.push({
+        certification_authority: 'BMWK',
+        certification_name: 'Vehicle_CO2_Class',
+        certification_value: co2Class,
+      });
+    }
+
+    if (get(car, 'engineData.hybridPlugin')) {
+      const dischargedClass = this.getDischargedEnergyClass(car);
+      if (dischargedClass && dischargedClass !== 'default') {
+        certifications.push({
+          certification_authority: 'BMWK',
+          certification_name: 'Vehicle_CO2_Class_Discharged_Battery',
+          certification_value: dischargedClass,
+        });
+      }
+    }
+
+    return certifications.length ? certifications : undefined;
+  }
+
+  private getEnergyConsumption(car: DataSchemes.Car): string | undefined {
+    const fuel = get(car, 'consumption.fuel');
+    const isElectricOrHybrid =
+      ['selector_fuel_electrical', 'selector_fuel_hybridElectricalPetrol', 'selector_fuel_hybridElectricalDiesel'].includes(fuel) ||
+      !!get(car, 'engineData.hybridPlugin');
+    if (!isElectricOrHybrid) {
+      return undefined;
+    }
+    const power = get(car, 'consumption.wltpPowerCombined') || get(car, 'consumption.consumptionPowerCombined');
+    return power ? `${power}kWh/100km` : undefined;
+  }
+
+  private getElectricRange(car: DataSchemes.Car): string | undefined {
+    const range = get(car, 'battery.batteryRangeElectric') || get(car, 'battery.wltpRange');
+    return range ? `${range}km` : undefined;
+  }
+
+  private getFuelConsumptionDischargedBattery(car: DataSchemes.Car): string | undefined {
+    if (!get(car, 'engineData.hybridPlugin')) {
+      return undefined;
+    }
+    const consumption = get(car, 'consumption.consumptionCombined') || get(car, 'consumption.wltpCombined');
+    return consumption ? `${consumption}l/100km` : undefined;
+  }
+
+  private getInstallment(car: DataSchemes.Car) {
+    const monthlyInstallment = round(get(car, 'rate.monthlyInstallment', null));
+    const paybackPeriod = round(get(car, 'rate.paybackPeriod', null));
+    const apr = toString(get(car, 'financing.annualPercentageRate', '')).trim();
+
+    // Google requires `apr` inside the installment block; a partial installment
+    // block (without apr) makes Google reject the whole attribute. If financing
+    // data is incomplete, omit installment entirely so the rest of the item stays valid.
+    if (!monthlyInstallment || !paybackPeriod || !apr) {
+      return undefined;
+    }
+
+    return {
+      paybackPeriod,
+      monthlyInstallment,
+      apr,
+    };
+  }
+
+  private getBrand(car: DataSchemes.Car): string {
+    const make = get(car, 'mainData.make', '');
+
+    switch (make) {
+      case 'Mercedes-Benz':
+        return 'Mercedes';
+      case 'Volkswagen':
+        return 'VW';
+      default:
+        return make;
+    }
+  }
+
+  private mapFuel(car: DataSchemes.Car): string {
+    const available = {
+      selector_fuel_petrol: 'Gasoline',
+      selector_fuel_diesel: 'Diesel',
+      selector_fuel_electrical: 'Electric',
+      selector_fuel_hybridElectricalPetrol: 'Hybrid',
+      selector_fuel_hybridElectricalDiesel: 'Hybrid',
+      selector_fuel_carGas: 'CarGas',
+      selector_fuel_naturalGas: 'NaturalGas',
+      selector_fuel_ethanol: 'Ethanol',
+      selector_fuel_hydrogen: 'Hydrogen',
+      selector_unknown: 'Other',
+    };
+    const fuel = get(car, 'consumption.fuel', 'selector_unknown');
+    let engine = get(available, fuel, 'Other')
+    const hybridPlugin = car?.engineData?.hybridPlugin;
+    if (engine === 'Hybrid' && hybridPlugin)
+      engine = 'plug-in_hybrid';
+
+    return engine;
+  }
+
+  private mapBodyStyle(car: DataSchemes.Car): string {
+    const available = {
+      selector_category_combi: 'station wagon',
+      selector_category_sedan: 'sedan',
+      selector_category_coupe: 'coupe',
+      selector_category_convertible: 'convertible',
+      selector_category_suv: 'suv',
+      selector_category_van: 'full size van',
+      selector_category_transporter: 'truck',
+      selector_category_minibus: 'minivan',
+    };
+    const category = get(car, 'mainData.category', 'selector_unknown');
+    return get(available, category);
+  }
+
+  private mapTransmission(car: DataSchemes.Car): string | undefined {
+    const available = {
+      selector_gearbox_manualShift: 'MANUAL',
+      selector_gearbox_semiAutomatic: 'AUTOMATIC',
+      selector_gearbox_automatic: 'AUTOMATIC',
+    };
+    return get(available, get(car, 'driveSuspension.gearbox'));
+  }
+
+  private mapDrive(car: DataSchemes.Car): string | undefined {
+    const available = {
+      selector_driveType_frontWheelDrive: 'FWD',
+      selector_driveType_rearWheelDrive: 'RWD',
+      selector_driveType_allWheelDrive: 'AWD',
+    };
+    return get(available, get(car, 'driveSuspension.driveType'));
+  }
+
+  private getDoors(car: DataSchemes.Car): number | undefined {
+    return toSafeInteger(get(car, 'mainData.doors')) || undefined;
+  }
+
+  private getCapacity(car: DataSchemes.Car): number | undefined {
+    return toSafeInteger(get(car, 'engineData.cubicCapacity')) || undefined;
+  }
+
+  private getExtrasField(car: DataSchemes.Car): string[] {
+    const booleanFields: string[] = [
+      'engineData.startStopSystem',
+      'window.panoramicGlassRoof',
+      'assistants.automaticRainSensor',
+      'assistants.cruiseControl',
+      'assistants.headUpDisplay',
+      'assistants.abs',
+      'assistants.esp',
+      'assistants.collisionAvoidance',
+      'assistants.trafficSignRecognition',
+      'lights.xenonHeadlights',
+      'lights.ledHeadlights',
+      'lights.laserHeadlights',
+      'lights.lightSensor',
+      'wheel.multifunctionalWheel',
+      'heatingCooling.auxiliaryHeating',
+      'trailerCoupling.trailerCouplingFix',
+      'trailerCoupling.trailerCouplingRemovable',
+      'trailerCoupling.trailerCouplingRotatable',
+      'multimedia.navigationSystem',
+      'multimedia.bluetooth',
+      'multimedia.handsFreePhoneSystem',
+    ];
+
+    const selectorFields: string[] = [
+      'driveSuspension.driveType',
+      'interior.interiorType',
+      'heatingCooling.climatisation',
+    ];
+
+    const selectorListFields: string[] = [
+      'seats.driverSeats',
+      'seats.coDriverSeats',
+      'seats.backSeats',
+      'assistants.parkingAssistants',
+      'airbags.airbag',
+    ];
+
+    const filteredBooleanFields = booleanFields.filter((field: string) => {
+      return get(car, field, false);
+    });
+    const filteredSelectorFields = selectorFields.filter((field: string) => {
+      const value = get(car, field);
+      return value && value !== 'selector_unknown';
+    });
+    const filteredSelectorListFields = selectorListFields.filter((field: string) => {
+      const list: string[] = get(car, field);
+      if (this.isNotEmptyArray(list)) {
+        const filtered: string[] = list.filter((selector: string) => {
+          return selector && selector !== 'selector_unknown';
+        });
+        return filtered.length;
+      }
+      return false;
+    });
+    return filteredBooleanFields
+      .concat(filteredSelectorFields)
+      .concat(filteredSelectorListFields)
+      .slice(0, 200)
+      .map((field: string) => {
+        return this.translator.translateVal(field.replace('.', '_'));
+      })
+      .map((field: string) => {
+        return field.substring(0, 200)
+      });
+  }
+
+  private getTrim(car: DataSchemes.Car): string {
+    const trim = toString(get(car, 'mainData.subModel', ''));
+    return truncate(trim, { length: GOOGLE_MAX_TRIM_LENGTH, separator: ' ' });
+  }
+
+  private convertToSeconds(fieldValue: string | number | Date | null): any {
+    if (fieldValue === null) {
+      return null;
+    }
+
+    let timestamp = 0;
+
+    if (typeof fieldValue === 'number') {
+      if (fieldValue > 1e12) {
+        timestamp = fieldValue;
+      } else {
+        timestamp = fieldValue * 1000;
+      }
+    }
+
+    return Math.floor(timestamp);
+  }
+
+  private monthDiffLess(car: DataSchemes.Car, month: number) {
+    const fieldDate = new Date(this.convertToSeconds(car.mainData.firstRegistration)).getTime();
+    const conditionDate = new Date().getTime();
+    if (!isNumber(fieldDate)) {
+      return false;
+    }
+
+    const monthsDifference = (fieldDate - conditionDate) / (1000 * 60 * 60 * 24 * 30);
+
+    return Math.round(Math.abs(monthsDifference)) <= month;
+  }
+
+  private getMileage(car: DataSchemes.Car): number {
+    let mileage = get(car, 'mainData.mileage', 0);
+
+    if (mileage < 1000)
+      mileage = 1001
+
+    return !mileage ? 10 : mileage;
+  }
+
+  private getYear(car: DataSchemes.Car): number {
+    // mainData.firstModelsProductionDate is already a 4-digit year (mobile.de "vintage").
+    // constructionYear/firstRegistration/metaData.creationDate are unix timestamps in
+    // seconds (constructionYear is stored via legacy dateToUnix, not a bare year — see
+    // services/scrapper/src/ai/car-bridge.ts:174). Not every car has firstModelsProductionDate
+    // (e.g. dealer FTP imports), so fall through to other date sources — `year` is a
+    // mandatory Google feed field.
+    const firstModelsProductionYear = toSafeInteger(get(car, 'mainData.firstModelsProductionDate', 0));
+    const constructionYear = new Date(+get(car, 'mainData.constructionYear', 0) * 1000).getUTCFullYear();
+    const firstRegistrationYear = new Date(+get(car, 'mainData.firstRegistration', 0) * 1000).getUTCFullYear();
+    const metaCreationYear = new Date(+get(car, 'metaData.creationDate', 0) * 1000).getUTCFullYear();
+    const currentYear = new Date().getUTCFullYear();
+
+    return [firstModelsProductionYear, constructionYear, firstRegistrationYear, metaCreationYear, currentYear]
+      .find(year => year > TIMESTAMP_FIRST_YEAR);
+  }
+
+  private getDateFirstRegistered(car: DataSchemes.Car): string {
+    let timestamp = +get(car, 'mainData.firstRegistration', '');
+
+    if (!timestamp) {
+      timestamp = Math.round(new Date().getTime() / 1000);
+    }
+
+    if (!car.mainData.firstRegistration || this.monthDiffLess(car, 8)) {
+      const currentDate = new Date();
+      currentDate.setMonth(currentDate.getMonth() - 9);
+      timestamp = Math.round(currentDate.getTime() / 1000);
+    }
+
+    const date = new Date(timestamp * 1000);
+    const month = date.getUTCMonth() + 1;
+    const year = date.getUTCFullYear();
+
+    const formattedMonth = month < 10 ? `0${month}` : month;
+
+    return `${year}-${formattedMonth}`;
+  }
+
+  private isNotEmptyArray(array: any[]): boolean {
+    return array && Array.isArray(array) && !!array.length;
+  }
+}