@bytebrand/export-cars 1.26.28 → 1.26.30

package/test/fixtures/images.golden.json

@@ -0,0 +1,218 @@
+{
+  "full": {
+    "defaultWithPlaceholders": [
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extRight0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extCowl00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extLeft00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extSide00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extBack00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extOpened001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/conext000001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/engine000001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intDash00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intSeats0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intTrunk0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/seatHeat0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/featRims0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/simple000001/large",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "defaultIgnorePlaceholders": [
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extRight0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extCowl00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extLeft00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extSide00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extBack00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extOpened001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/conext000001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/engine000001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intDash00001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intSeats0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intTrunk0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/seatHeat0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/featRims0001/large",
+      "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/simple000001/large"
+    ],
+    "marketing": [
+      "https://images.auto.de/generated_images/2/c/e/2ce1d71f-851f-4123-ae16-187ddd7923c5/criteo-channel-extRight0001.jpg",
+      "https://images.auto.de/generated_images/2/c/e/2ce1d71f-851f-4123-ae16-187ddd7923c5/criteo-channel-extBack00001.jpg",
+      "https://images.auto.de/generated_images/2/c/e/2ce1d71f-851f-4123-ae16-187ddd7923c5/criteo-channel-intDash00001.jpg",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "googleExtInt": {
+      "extMain": [
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extRight0001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extLeft00001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extOpened001/small"
+      ],
+      "ext": [
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extCowl00001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extSide00001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/extBack00001/small"
+      ],
+      "int": [
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intDash00001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intSeats0001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/intTrunk0001/small"
+      ],
+      "feat": [
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/conext000001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/engine000001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/seatHeat0001/small",
+        "https://images.auto.de/carimage/2ce1d71f-851f-4123-ae16-187ddd7923c5/featRims0001/small"
+      ]
+    }
+  },
+  "leftOnly": {
+    "defaultWithPlaceholders": [
+      "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/extLeft00002/large",
+      "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/extBack00002/large",
+      "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/intDash00002/large",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "defaultIgnorePlaceholders": [
+      "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/extLeft00002/large",
+      "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/extBack00002/large",
+      "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/intDash00002/large"
+    ],
+    "marketing": [
+      "https://images.auto.de/generated_images/3/7/0/3703a23a-654d-426e-801e-beeffcc1e9c8/criteo-channel-extLeft00002.jpg",
+      "https://images.auto.de/generated_images/3/7/0/3703a23a-654d-426e-801e-beeffcc1e9c8/criteo-channel-extBack00002.jpg",
+      "https://images.auto.de/generated_images/3/7/0/3703a23a-654d-426e-801e-beeffcc1e9c8/criteo-channel-intDash00002.jpg",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "googleExtInt": {
+      "extMain": [
+        "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/extLeft00002/small"
+      ],
+      "ext": [
+        "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/extBack00002/small"
+      ],
+      "int": [
+        "https://images.auto.de/carimage/3703a23a-654d-426e-801e-beeffcc1e9c8/intDash00002/small"
+      ],
+      "feat": []
+    }
+  },
+  "noHero": {
+    "defaultWithPlaceholders": [
+      "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/extBack00003/large",
+      "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/intDash00003/large",
+      "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/featRims0003/large",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "defaultIgnorePlaceholders": [
+      "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/extBack00003/large",
+      "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/intDash00003/large",
+      "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/featRims0003/large"
+    ],
+    "marketing": [
+      "https://images.auto.de/generated_images/2/c/9/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/criteo-channel-extBack00003.jpg",
+      "https://images.auto.de/generated_images/2/c/9/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/criteo-channel-intDash00003.jpg",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "googleExtInt": {
+      "extMain": [],
+      "ext": [
+        "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/extBack00003/small"
+      ],
+      "int": [
+        "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/intDash00003/small"
+      ],
+      "feat": [
+        "https://images.auto.de/carimage/2c91c177-ddd3-4224-8b04-bdb96bf1b64c/featRims0003/small"
+      ]
+    }
+  },
+  "duplicates": {
+    "defaultWithPlaceholders": [
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0004/large",
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0004/large",
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0005/large",
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/intDash00004/large",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "defaultIgnorePlaceholders": [
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0004/large",
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0004/large",
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0005/large",
+      "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/intDash00004/large"
+    ],
+    "marketing": [
+      "https://images.auto.de/generated_images/2/e/1/2e101cac-fb72-4cd7-a598-2ebba983a4f9/criteo-channel-extRight0005.jpg",
+      "https://images.auto.de/generated_images/2/e/1/2e101cac-fb72-4cd7-a598-2ebba983a4f9/criteo-channel-intDash00004.jpg",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "googleExtInt": {
+      "extMain": [
+        "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0004/small",
+        "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0004/small",
+        "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/extRight0005/small"
+      ],
+      "ext": [],
+      "int": [
+        "https://images.auto.de/carimage/2e101cac-fb72-4cd7-a598-2ebba983a4f9/intDash00004/small"
+      ],
+      "feat": []
+    }
+  },
+  "onlyUnknown": {
+    "defaultWithPlaceholders": [
+      "https://images.auto.de/carimage/61889cf8-2193-4c1e-8cdd-521ca2d38c9a/simple000006/large",
+      "https://images.auto.de/carimage/61889cf8-2193-4c1e-8cdd-521ca2d38c9a/promo0000006/large",
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "defaultIgnorePlaceholders": [
+      "https://images.auto.de/carimage/61889cf8-2193-4c1e-8cdd-521ca2d38c9a/simple000006/large",
+      "https://images.auto.de/carimage/61889cf8-2193-4c1e-8cdd-521ca2d38c9a/promo0000006/large"
+    ],
+    "marketing": [
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "googleExtInt": {
+      "extMain": [],
+      "ext": [],
+      "int": [],
+      "feat": []
+    }
+  },
+  "empty": {
+    "defaultWithPlaceholders": [
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "defaultIgnorePlaceholders": [
+      "https://images.auto.de/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/GvyXmrpaf1D6/large-cached.jpeg",
+      "https://images.auto.de/carimage/noimage/pFyfBsqBHEso/large-cached.jpeg"
+    ],
+    "marketing": null,
+    "googleExtInt": {
+      "extMain": [],
+      "ext": [],
+      "int": [],
+      "feat": []
+    }
+  }
+}

package/test/fixtures/imbo-images.fixture.ts

@@ -0,0 +1,77 @@
+import { ImboImageResponseInterface } from '@bytebrand/chunkable';
+
+// Imbo image lists as CarBasicDataCarsLoader hands them to the transformers (newest first, as Imbo
+// returns them). Codes mirror real image_code_predicted labels, incl. the "-suffix" form.
+const img = (imageIdentifier: string, imageCodePredicted?: string): ImboImageResponseInterface => ({
+  imageIdentifier,
+  imageCodePredicted,
+});
+
+export const IMBO_FIXTURES: Record<string, { carId: string; images: ImboImageResponseInterface[] }> = {
+  full: {
+    carId: '2ce1d71f-851f-4123-ae16-187ddd7923c5',
+    images: [
+      img('intDash00001', 'int_f_ipanel1'),
+      img('featRims0001', 'ext_feat_rims'),
+      img('extBack00001', 'ext_b_main'),
+      img('simple000001', 'simple_01'),
+      img('extLeft00001', 'ext_f_left'),
+      img('conext000001', 'conext_f_main'),
+      img('intSeats0001', 'int_f_driverseats-1'),
+      img('extCowl00001', 'ext_f_cowl'),
+      img('extOpened001', 'ext_f_main_opened'),
+      img('engine000001', 'ext_feat_engine'),
+      img('seatHeat0001', 'int_feat_seatheating'),
+      img('extRight0001', 'ext_f_right'),
+      img('extSide00001', 'ext_l_main'),
+      img('intTrunk0001', 'int_b_trunk'),
+    ],
+  },
+  leftOnly: {
+    carId: '3703a23a-654d-426e-801e-beeffcc1e9c8',
+    images: [
+      img('intDash00002', 'int_f_ipanel1'),
+      img('extBack00002', 'ext_b_main'),
+      img('extLeft00002', 'ext_f_left'),
+    ],
+  },
+  noHero: {
+    carId: '2c91c177-ddd3-4224-8b04-bdb96bf1b64c',
+    images: [
+      img('extBack00003', 'ext_b_main'),
+      img('intDash00003', 'int_f_ipanel1'),
+      img('featRims0003', 'ext_feat_rims'),
+    ],
+  },
+  duplicates: {
+    carId: '2e101cac-fb72-4cd7-a598-2ebba983a4f9',
+    images: [
+      img('extRight0004', 'ext_f_right'),
+      img('extRight0004', 'ext_f_right'),
+      img('extRight0005', 'ext_f_right'),
+      img('intDash00004', 'int_f_ipanel1'),
+    ],
+  },
+  onlyUnknown: {
+    carId: '61889cf8-2193-4c1e-8cdd-521ca2d38c9a',
+    images: [img('simple000006', 'simple_01'), img('promo0000006', 'promo_slide')],
+  },
+  empty: {
+    carId: '0b0999c6-2f02-4bc3-8852-2307e8a0232f',
+    images: [],
+  },
+};
+
+// Same shape as a stored MarketingImageConfig (criteo-like) for getMarketingImages.
+export const MARKETING_CONFIG_FIXTURE = {
+  channelCode: 'criteo channel',
+  imageExtension: 'jpg',
+  marketingImages: [
+    { imageCodes: ['ext_f_right', 'ext_f_left'] },
+    { imageCodes: ['int_f_ipanel1'] },
+    { imageCodes: ['ext_b_main'] },
+  ],
+};
+
+export const cloneImages = (images: ImboImageResponseInterface[]): ImboImageResponseInterface[] =>
+  images.map(i => ({ ...i }));

package/test/fixtures/openai-ads.fixture.ts

@@ -0,0 +1,89 @@
+import { ImboImageResponseInterface } from '@bytebrand/chunkable';
+
+// Minimal RFC 4180 reader for the tests: whole file -> rows of cells (quoted newlines kept).
+export const parseCsv = (text: string): string[][] => {
+  const rows: string[][] = [];
+  let row: string[] = [];
+  let cell = '';
+  let quoted = false;
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i];
+    if (quoted) {
+      if (c === '"' && text[i + 1] === '"') { cell += '"'; i++; } else if (c === '"') { quoted = false; } else { cell += c; }
+    } else if (c === '"') {
+      quoted = true;
+    } else if (c === ',') {
+      row.push(cell); cell = '';
+    } else if (c === '\n') {
+      row.push(cell); rows.push(row); row = []; cell = '';
+    } else {
+      cell += c;
+    }
+  }
+  if (cell || row.length) { row.push(cell); rows.push(row); }
+  return rows;
+};
+
+export const csvObjects = (text: string): Record<string, string>[] => {
+  const [header, ...rows] = parseCsv(text);
+  return rows.map(cells => Object.fromEntries(header.map((name, i) => [name, cells[i]])));
+};
+
+// German labels the TranslatorExtended returns for these selectors (checked against
+// @bytebrand/i18n-dictionaries); anything else comes back as the key itself, like the real one.
+const LABELS: Record<string, string> = {
+  selector_fuel_petrol: 'Benzin',
+  selector_fuel_diesel: 'Diesel',
+  selector_gearbox_manualShift: 'Manuell',
+  selector_gearbox_automatic: 'Automatik',
+  selector_category_sedan: 'Limousine',
+  selector_category_combi: 'Kombi',
+  selector_exteriorColor_black: 'Schwarz',
+  selector_exteriorColor_grey: 'Grau',
+  selector_unknown: 'Unbekannt',
+};
+export const translate = (key: string): string => LABELS[key] ?? key;
+
+export const NOW = new Date('2026-10-12T08:00:00Z');
+const MAR_2021 = Date.UTC(2021, 2, 15) / 1000;
+
+export const car = (id: string, overrides: Record<string, any> = {}): any => {
+  const base: any = {
+    _id: id,
+    mainData: {
+      make: 'Volkswagen',
+      model: 'Golf',
+      subModel: '1.5 TSI Life',
+      condition: 'selector_condition_used',
+      firstRegistration: MAR_2021,
+      mileage: 45000,
+      category: 'selector_category_sedan',
+    },
+    metaData: { ownerId: 'dealer-1', imagesCount: 2, vehicleId: 'ABC123' },
+    price: { currentSalesPrice: 17990 },
+    rate: { monthlyInstallment: 199, paybackPeriod: 48 },
+    consumption: { fuel: 'selector_fuel_petrol' },
+    driveSuspension: { gearbox: 'selector_gearbox_manualShift' },
+    engineData: { powerKW: 110, powerPS: 150 },
+    exterior: { exteriorColor: 'selector_exteriorColor_black' },
+    offer: { offerAvailability: 'selector_unknown' },
+    state: { isOnline: true },
+  };
+  for (const [path, value] of Object.entries(overrides)) {
+    const keys = path.split('.');
+    let target = base;
+    keys.slice(0, -1).forEach((key) => { target[key] = target[key] ?? {}; target = target[key]; });
+    if (value === undefined) {
+      delete target[keys[keys.length - 1]];
+    } else {
+      target[keys[keys.length - 1]] = value;
+    }
+  }
+  return base;
+};
+
+export const images = (prefix: string): ImboImageResponseInterface[] => [
+  { imageIdentifier: `${prefix}Back`, imageCodePredicted: 'ext_b_main' },
+  { imageIdentifier: `${prefix}Right`, imageCodePredicted: 'ext_f_right' },
+  { imageIdentifier: `${prefix}Dash`, imageCodePredicted: 'int_f_ipanel1' },
+];

package/test/image-url-validator.test.ts

@@ -0,0 +1,110 @@
+// Run: npm test (ts-node, no test framework needed)
+// Local stub image host — no real network. requireHttps is switched off only for the stub server.
+import * as assert from 'node:assert/strict';
+import { createServer, IncomingMessage, ServerResponse } from 'http';
+import { AddressInfo } from 'net';
+import { ImageUrlRejectReason as R, ImageUrlValidator } from '../src/services/image-url-validator.service';
+
+const hits: Record<string, number> = {};
+const JPEG = Buffer.from([0xff, 0xd8, 0xff, 0xe0, 0x00, 0x10]);
+
+const routes: Record<string, (req: IncomingMessage, res: ServerResponse) => void> = {
+  '/ok.jpg': (_, res) => { res.writeHead(200, { 'Content-Type': 'image/jpeg' }); res.end(JPEG); },
+  '/ok.png': (_, res) => { res.writeHead(200, { 'Content-Type': 'image/png' }); res.end(); },
+  '/photo.webp': (_, res) => { res.writeHead(200, { 'Content-Type': 'image/webp' }); res.end(); },
+  '/page.html': (_, res) => { res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' }); res.end('<html>'); },
+  // images.auto.de answers unknown images exactly like this: 404 with a placeholder JPEG body
+  '/missing.jpg': (_, res) => { res.writeHead(404, { 'Content-Type': 'image/jpeg' }); res.end(JPEG); },
+  '/forbidden.jpg': (_, res) => { res.writeHead(403, { 'Content-Type': 'text/html' }); res.end('Just a moment...'); },
+  '/error.jpg': (_, res) => { res.writeHead(503); res.end(); },
+  '/moved.jpg': (_, res) => { res.writeHead(302, { Location: '/ok.jpg' }); res.end(); },
+  '/loop.jpg': (_, res) => { res.writeHead(302, { Location: '/loop.jpg' }); res.end(); },
+  '/slow.jpg': (_, res) => { setTimeout(() => { res.writeHead(200, { 'Content-Type': 'image/jpeg' }); res.end(); }, 400); },
+  '/no-head.jpg': (req, res) => {
+    if (req.method === 'HEAD') { res.writeHead(405); res.end(); return; }
+    res.writeHead(200, { 'Content-Type': 'image/jpeg' }); res.end(JPEG);
+  },
+  '/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg': (_, res) => { res.writeHead(200, { 'Content-Type': 'image/jpeg' }); res.end(JPEG); },
+};
+
+const server = createServer((req, res) => {
+  const path = req.url.split('?')[0];
+  hits[path] = (hits[path] ?? 0) + 1;
+  (routes[path] ?? ((_, r) => { r.writeHead(404); r.end(); }))(req, res);
+});
+
+(async () => {
+  await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve));
+  const base = `http://127.0.0.1:${(server.address() as AddressInfo).port}`;
+  const validator = (options = {}) => new ImageUrlValidator({ requireHttps: false, timeoutMs: 150, ...options });
+  const expectReject = async (path: string, reason: R, status?: number) => {
+    const check = await validator().validate(`${base}${path}`);
+    assert.equal(check.ok, false);
+    assert.equal(check.reason, reason);
+    if (status) assert.equal(check.status, status);
+  };
+
+  const cases: Array<[string, () => Promise<void>]> = [
+    ['200 image/jpeg and image/png are valid', async () => {
+      assert.equal((await validator().validate(`${base}/ok.jpg`)).ok, true);
+      assert.equal((await validator().validate(`${base}/ok.png`)).ok, true);
+    }],
+    ['404 with an image/jpeg placeholder body is rejected on status', () => expectReject('/missing.jpg', R.httpStatus, 404)],
+    ['403 (WAF / challenge) is rejected', () => expectReject('/forbidden.jpg', R.httpStatus, 403)],
+    ['5xx is rejected', () => expectReject('/error.jpg', R.httpStatus, 503)],
+    ['wrong MIME (HTML) is rejected', () => expectReject('/page.html', R.wrongMime)],
+    ['WebP is rejected unless the partner allows it', async () => {
+      await expectReject('/photo.webp', R.wrongMime);
+      assert.equal((await validator({ allowedMimeTypes: ['image/webp'] }).validate(`${base}/photo.webp`)).ok, true);
+    }],
+    ['a redirect within the limit is followed and the final URL kept', async () => {
+      const check = await validator().validate(`${base}/moved.jpg`);
+      assert.equal(check.ok, true);
+      assert.equal(check.finalUrl, `${base}/ok.jpg`);
+    }],
+    ['redirect loop is rejected', () => expectReject('/loop.jpg', R.tooManyRedirects)],
+    ['timeout is rejected', () => expectReject('/slow.jpg', R.timeout)],
+    ['HEAD not allowed (405) falls back to GET', async () => {
+      assert.equal((await validator().validate(`${base}/no-head.jpg`)).ok, true);
+    }],
+    ['placeholder URL is rejected without any request', async () => {
+      await expectReject('/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg', R.placeholder);
+      assert.equal(hits['/carimage/noimage/7pNvWELuWhZX/large-cached.jpeg'], undefined);
+    }],
+    ['non-HTTPS, credentials and relative URLs are rejected without a request', async () => {
+      const strict = new ImageUrlValidator();
+      assert.equal((await strict.validate(`${base}/ok.png`)).reason, R.notHttps);
+      assert.equal((await strict.validate('https://user:secret@images.auto.de/carimage/a/b/large-cached.jpeg')).reason, R.credentials);
+      assert.equal((await strict.validate('/carimage/a/b/large-cached.jpeg')).reason, R.invalidUrl);
+      assert.equal((await strict.validate('ftp://images.auto.de/a.jpg')).reason, R.invalidUrl);
+    }],
+    ['each URL is probed once per run (cached) and counted once', async () => {
+      const v = validator();
+      const before = hits['/ok.jpg'];
+      await v.validateAll([`${base}/ok.jpg`, `${base}/ok.jpg`, `${base}/missing.jpg`]);
+      await v.validate(`${base}/ok.jpg`);
+      assert.equal(hits['/ok.jpg'] - before, 1);
+      assert.deepEqual(v.stats, { ok: 1, [R.httpStatus]: 1 });
+    }],
+    ['probe budget: URLs beyond maxProbes are reported, not fetched', async () => {
+      const v = validator({ maxProbes: 1 });
+      const [first, second] = await v.validateAll([`${base}/ok.jpg`, `${base}/ok.png`]);
+      assert.equal(first.ok, true);
+      assert.equal(second.reason, R.budgetExhausted);
+    }],
+  ];
+
+  let failed = 0;
+  for (const [name, fn] of cases) {
+    try {
+      await fn();
+      console.log(`ok   ${name}`);
+    } catch (e) {
+      failed += 1;
+      console.error(`FAIL ${name}\n     ${e.message}`);
+    }
+  }
+  (server as any).closeAllConnections?.(); // Node ≥18.2; @types/node here is older
+  server.close();
+  if (failed) process.exit(1);
+})();

package/test/images-regression.test.ts

@@ -0,0 +1,23 @@
+// Run: npm test (ts-node, no test framework needed)
+// ADV-336 regression lock: the image URLs every existing partner export (Google, Meta-marketing,
+// default partners) builds must stay byte-identical. images.golden.json was recorded from the
+// ImagesService BEFORE the clean profile was added — never regenerate it to make this test pass.
+import * as assert from 'node:assert/strict';
+import { readFileSync } from 'fs';
+import { snapshotExistingImageOutputs } from './fixtures/images-service.harness';
+
+const golden = JSON.parse(readFileSync(`${__dirname}/fixtures/images.golden.json`, 'utf8'));
+
+snapshotExistingImageOutputs().then((actual) => {
+  let failed = 0;
+  for (const name of Object.keys(golden)) {
+    try {
+      assert.deepEqual(actual[name], golden[name]);
+      console.log(`ok   existing image outputs unchanged: ${name}`);
+    } catch (e) {
+      failed += 1;
+      console.error(`FAIL existing image outputs changed: ${name}\n     ${e.message}`);
+    }
+  }
+  if (failed) process.exit(1);
+});