@bytebrand/export-cars 1.26.26 → 1.26.28

package/test/google-feed-item-row.test.ts

@@ -1,121 +1,135 @@
-// Run: npm test (ts-node, no test framework needed)
-import * as assert from 'node:assert/strict';
-import { buildGoogleFeedItemRow } from '../src/transformers/google-feed-item-row';
-import { googleElectricRange, googleElectricRangeSource } from '../src/transformers/google-feed-envkv';
-
-const exportedAt = new Date('2026-10-08T23:30:00.000Z');
-
-const car = (fuel: string, extra: Record<string, any> = {}): any => ({
-  _id: 'cbd-1',
-  metaData: { vehicleId: 'veh-1' },
-  consumption: { fuel },
-  engineData: 'hybridPlugin' in extra ? { hybridPlugin: extra.hybridPlugin } : {},
-  battery: extra.battery || {},
-});
-
-// Shape of what GoogleTransformer returns after dropping the empty optional attributes.
-const item = (extra: Record<string, any> = {}): any => ({
-  id: 'cbd-1',
-  brand: 'VW',
-  model: 'Golf',
-  condition: 'Used',
-  engine: 'Gasoline',
-  price: '19990.5 EUR',
-  availability: 'in_stock',
-  ...extra,
-});
-
-const cases: Array<[string, () => void]> = [
-  ['combustion car: sent values, omitted attributes are null', () => {
-    const row = buildGoogleFeedItemRow(
-      car('selector_fuel_petrol', { hybridPlugin: false }),
-      item({ fuel_consumption: '5.1l/100km', co2_emissions: '118g/km' }),
-      '12345',
-      exportedAt,
-    );
-    assert.deepEqual(row, {
-      partitionDay: '2026-10-08',
-      exportedAt: '2026-10-08T23:30:00.000Z',
-      feed: 'google',
-      runId: '12345',
-      itemId: 'cbd-1',
-      vehicleId: 'veh-1',
-      make: 'VW',
-      model: 'Golf',
-      condition: 'Used',
-      fuel: 'selector_fuel_petrol',
-      hybridPlugin: false,
-      engine: 'Gasoline',
-      electricRange: null,
-      fuelConsumption: '5.1l/100km',
-      fuelConsumptionDischarged: null,
-      energyConsumption: null,
-      co2Emissions: '118g/km',
-      rangeSourceField: null,
-      price: 19990.5,
-      availability: 'in_stock',
-    });
-  }],
-  ['BEV: range source is the field the range came from', () => {
-    const bev = car('selector_fuel_electrical', { battery: { batteryRangeElectric: 400 } });
-    const row = buildGoogleFeedItemRow(
-      bev,
-      item({ engine: 'Electric', electric_range: googleElectricRange(bev), energy_consumption: '16.5kWh/100km', co2_emissions: '0g/km' }),
-      '12345',
-      exportedAt,
-    );
-    assert.equal(row.electricRange, '400km');
-    assert.equal(row.rangeSourceField, 'battery.batteryRangeElectric');
-    assert.equal(row.hybridPlugin, null);
-    assert.equal(row.energyConsumption, '16.5kWh/100km');
-    assert.equal(row.co2Emissions, '0g/km');
-  }],
-  ['plug-in: EAER first, then WLTP range, then delivered range', () => {
-    const phev = (battery: object) => car('selector_fuel_hybridElectricalPetrol', { hybridPlugin: true, battery });
-    assert.equal(googleElectricRangeSource(phev({ wltpTotalRange: 62, wltpRange: 59 })), 'battery.wltpTotalRange');
-    assert.equal(googleElectricRangeSource(phev({ wltpTotalRange: 0, wltpRange: 59 })), 'battery.wltpRange');
-    assert.equal(googleElectricRangeSource(phev({ batteryRangeElectric: 50 })), 'battery.batteryRangeElectric');
-    assert.equal(googleElectricRangeSource(phev({ wltpTotalRangeCity: 70 })), null);
-  }],
-  ['range source agrees with googleElectricRange', () => {
-    const cars = [
-      car('selector_fuel_electrical', { battery: { wltpRange: 451, batteryRangeElectric: 400 } }),
-      car('selector_fuel_electrical', { battery: { wltpRange: 0 } }),
-      car('selector_fuel_hybridElectricalPetrol', { hybridPlugin: false, battery: { wltpRange: 50 } }),
-      car('selector_fuel_petrol', { battery: { wltpRange: 50 } }),
-    ];
-    for (const c of cars) {
-      assert.equal(googleElectricRangeSource(c) === null, googleElectricRange(c) === undefined);
-    }
-    assert.equal(googleElectricRangeSource(cars[0]), 'battery.wltpRange');
-  }],
-  ['no range source when the item carries no electric_range', () => {
-    const bev = car('selector_fuel_electrical', { battery: { wltpRange: 451 } });
-    assert.equal(buildGoogleFeedItemRow(bev, item(), null, exportedAt).rangeSourceField, null);
-  }],
-  ['missing run id, vehicle id and unparsable price become null', () => {
-    const row = buildGoogleFeedItemRow(
-      { consumption: {} } as any,
-      item({ price: ' EUR', availability: undefined }),
-      undefined,
-      exportedAt,
-    );
-    assert.equal(row.runId, null);
-    assert.equal(row.vehicleId, null);
-    assert.equal(row.fuel, null);
-    assert.equal(row.price, null);
-    assert.equal(row.availability, null);
-  }],
-];
-
-let failed = 0;
-for (const [name, fn] of cases) {
-  try {
-    fn();
-    console.log(`ok   ${name}`);
-  } catch (e) {
-    failed++;
-    console.log(`FAIL ${name}\n     ${(e as Error).message}`);
-  }
-}
-if (failed) process.exit(1);
+// Run: npm test (ts-node, no test framework needed)
+import * as assert from 'node:assert/strict';
+import { buildGoogleFeedItemRow } from '../src/transformers/google-feed-item-row';
+import { googleElectricRange, googleElectricRangeSource } from '../src/transformers/google-feed-envkv';
+
+const exportedAt = new Date('2026-10-08T23:30:00.000Z');
+
+const car = (fuel: string, extra: Record<string, any> = {}): any => ({
+  _id: 'cbd-1',
+  metaData: { vehicleId: 'veh-1' },
+  consumption: { fuel },
+  engineData: 'hybridPlugin' in extra ? { hybridPlugin: extra.hybridPlugin } : {},
+  battery: extra.battery || {},
+});
+
+// Shape of what GoogleTransformer returns after dropping the empty optional attributes.
+const item = (extra: Record<string, any> = {}): any => ({
+  id: 'cbd-1',
+  brand: 'VW',
+  model: 'Golf',
+  condition: 'Used',
+  engine: 'Gasoline',
+  price: '19990.5 EUR',
+  availability: 'in_stock',
+  ...extra,
+});
+
+const cases: Array<[string, () => void]> = [
+  ['combustion car: sent values, omitted attributes are null', () => {
+    const row = buildGoogleFeedItemRow(
+      car('selector_fuel_petrol', { hybridPlugin: false }),
+      item({ fuel_consumption: '5.1l/100km', co2_emissions: '118g/km' }),
+      '12345',
+      exportedAt,
+    );
+    assert.deepEqual(row, {
+      partitionDay: '2026-10-08',
+      exportedAt: '2026-10-08T23:30:00.000Z',
+      feed: 'google',
+      runId: '12345',
+      itemId: 'cbd-1',
+      vehicleId: 'veh-1',
+      make: 'VW',
+      model: 'Golf',
+      condition: 'Used',
+      fuel: 'selector_fuel_petrol',
+      hybridPlugin: false,
+      engine: 'Gasoline',
+      electricRange: null,
+      fuelConsumption: '5.1l/100km',
+      fuelConsumptionDischarged: null,
+      energyConsumption: null,
+      co2Emissions: '118g/km',
+      rangeSourceField: null,
+      price: 19990.5,
+      availability: 'in_stock',
+      publicationGate: null,
+      estimatedAttributes: null,
+    });
+  }],
+  ['publication gate: mode and estimated attributes; none estimated is null', () => {
+    const petrol = car('selector_fuel_petrol', { hybridPlugin: false });
+    const gated = buildGoogleFeedItemRow(petrol, item(), '12345', exportedAt, {
+      mode: 'enforce',
+      estimatedAttributes: ['fuel_consumption', 'co2_emissions'],
+    });
+    assert.equal(gated.publicationGate, 'enforce');
+    assert.equal(gated.estimatedAttributes, 'fuel_consumption,co2_emissions');
+    const clean = buildGoogleFeedItemRow(petrol, item(), '12345', exportedAt, { mode: 'audit', estimatedAttributes: [] });
+    assert.equal(clean.publicationGate, 'audit');
+    assert.equal(clean.estimatedAttributes, null);
+  }],
+  ['BEV: range source is the field the range came from', () => {
+    const bev = car('selector_fuel_electrical', { battery: { batteryRangeElectric: 400 } });
+    const row = buildGoogleFeedItemRow(
+      bev,
+      item({ engine: 'Electric', electric_range: googleElectricRange(bev), energy_consumption: '16.5kWh/100km', co2_emissions: '0g/km' }),
+      '12345',
+      exportedAt,
+    );
+    assert.equal(row.electricRange, '400km');
+    assert.equal(row.rangeSourceField, 'battery.batteryRangeElectric');
+    assert.equal(row.hybridPlugin, null);
+    assert.equal(row.energyConsumption, '16.5kWh/100km');
+    assert.equal(row.co2Emissions, '0g/km');
+  }],
+  ['plug-in: EAER first, then WLTP range, then delivered range', () => {
+    const phev = (battery: object) => car('selector_fuel_hybridElectricalPetrol', { hybridPlugin: true, battery });
+    assert.equal(googleElectricRangeSource(phev({ wltpTotalRange: 62, wltpRange: 59 })), 'battery.wltpTotalRange');
+    assert.equal(googleElectricRangeSource(phev({ wltpTotalRange: 0, wltpRange: 59 })), 'battery.wltpRange');
+    assert.equal(googleElectricRangeSource(phev({ batteryRangeElectric: 50 })), 'battery.batteryRangeElectric');
+    assert.equal(googleElectricRangeSource(phev({ wltpTotalRangeCity: 70 })), null);
+  }],
+  ['range source agrees with googleElectricRange', () => {
+    const cars = [
+      car('selector_fuel_electrical', { battery: { wltpRange: 451, batteryRangeElectric: 400 } }),
+      car('selector_fuel_electrical', { battery: { wltpRange: 0 } }),
+      car('selector_fuel_hybridElectricalPetrol', { hybridPlugin: false, battery: { wltpRange: 50 } }),
+      car('selector_fuel_petrol', { battery: { wltpRange: 50 } }),
+    ];
+    for (const c of cars) {
+      assert.equal(googleElectricRangeSource(c) === null, googleElectricRange(c) === undefined);
+    }
+    assert.equal(googleElectricRangeSource(cars[0]), 'battery.wltpRange');
+  }],
+  ['no range source when the item carries no electric_range', () => {
+    const bev = car('selector_fuel_electrical', { battery: { wltpRange: 451 } });
+    assert.equal(buildGoogleFeedItemRow(bev, item(), null, exportedAt).rangeSourceField, null);
+  }],
+  ['missing run id, vehicle id and unparsable price become null', () => {
+    const row = buildGoogleFeedItemRow(
+      { consumption: {} } as any,
+      item({ price: ' EUR', availability: undefined }),
+      undefined,
+      exportedAt,
+    );
+    assert.equal(row.runId, null);
+    assert.equal(row.vehicleId, null);
+    assert.equal(row.fuel, null);
+    assert.equal(row.price, null);
+    assert.equal(row.availability, null);
+  }],
+];
+
+let failed = 0;
+for (const [name, fn] of cases) {
+  try {
+    fn();
+    console.log(`ok   ${name}`);
+  } catch (e) {
+    failed++;
+    console.log(`FAIL ${name}\n     ${(e as Error).message}`);
+  }
+}
+if (failed) process.exit(1);

package/test/publication-gate.test.ts

@@ -0,0 +1,86 @@
+// Run: npm test (ts-node, no test framework needed)
+import * as assert from 'node:assert/strict';
+import { PublicationGate } from '../src/services/publication-gate';
+
+const icev = (extra: Record<string, unknown> = {}): any => ({
+  _id: 'car-1',
+  consumption: { fuel: 'selector_fuel_petrol', wltpCombined: 6.1, consumptionCombined: 6.4, ...(extra.consumption as object) },
+  engineData: {},
+  battery: {},
+  environmentEmissions: { wltpCo2: 139, co2: 145, ...(extra.environmentEmissions as object) },
+});
+
+const plugIn = (): any => ({
+  _id: 'car-2',
+  consumption: { fuel: 'selector_fuel_hybridElectricalPetrol', wltpWeightedCombined: 0.8, wltpCombined: 6.6, wltpWeightedPowerCombined: 15.6 },
+  engineData: { hybridPlugin: true },
+  battery: { wltpRange: 101 },
+  environmentEmissions: { wltpCo2: 18 },
+});
+
+const gate = (mode: 'audit' | 'enforce', entries: [string, string][]) => new PublicationGate(mode, new Map(entries));
+
+const cases: Array<[string, () => void]> = [
+  ['off: never estimated, never touches the item', () => {
+    const off = PublicationGate.off();
+    assert.deepEqual(off.estimatedAttributes(icev()), []);
+    const item = { fuel_consumption: '6.1l/100km' };
+    assert.deepEqual(off.apply(item, ['fuel_consumption']), { fuel_consumption: '6.1l/100km' });
+  }],
+  ['the estimate counts only for the field the attribute was taken from', () => {
+    // wltpCombined is sent; an estimate on the legacy fallback does not matter
+    assert.deepEqual(gate('audit', [['car-1|consumption.consumptionCombined', '6.4']]).estimatedAttributes(icev()), []);
+    assert.deepEqual(gate('audit', [['car-1|consumption.wltpCombined', '6.1']]).estimatedAttributes(icev()), ['fuel_consumption']);
+  }],
+  ['a later delivered value (stored value differs from the logged estimate) is not an estimate', () => {
+    assert.deepEqual(gate('audit', [['car-1|environmentEmissions.wltpCo2', '150']]).estimatedAttributes(icev()), []);
+    assert.deepEqual(gate('audit', [['car-1|environmentEmissions.wltpCo2', '139.0']]).estimatedAttributes(icev()), ['co2_emissions']);
+  }],
+  ['fallback field: wltpCombined missing, consumptionCombined sent and estimated', () => {
+    const car = icev({ consumption: { wltpCombined: null } });
+    assert.deepEqual(gate('audit', [['car-1|consumption.consumptionCombined', '6.4']]).estimatedAttributes(car), ['fuel_consumption']);
+  }],
+  ['other cars are not affected', () => {
+    assert.deepEqual(gate('audit', [['car-9|consumption.wltpCombined', '6.1']]).estimatedAttributes(icev()), []);
+  }],
+  ['confirmed plug-in: weighted values estimated, delivered range and CO2 kept', () => {
+    const g = gate('enforce', [
+      ['car-2|consumption.wltpWeightedCombined', '0.8'],
+      ['car-2|consumption.wltpWeightedPowerCombined', '15.6'],
+    ]);
+    const attributes = g.estimatedAttributes(plugIn());
+    assert.deepEqual(attributes, ['fuel_consumption', 'energy_consumption']);
+    const item = {
+      fuel_consumption: '0.8l/100km',
+      fuel_consumption_discharged_battery: '6.6l/100km',
+      energy_consumption: '15.6kWh/100km',
+      electric_range: '101km',
+      co2_emissions: '18g/km',
+    };
+    assert.deepEqual(g.apply(item, attributes), {
+      fuel_consumption_discharged_battery: '6.6l/100km',
+      electric_range: '101km',
+      co2_emissions: '18g/km',
+    });
+  }],
+  ['audit records but does not remove', () => {
+    const item = { fuel_consumption: '6.1l/100km' };
+    assert.deepEqual(gate('audit', []).apply(item, ['fuel_consumption']), { fuel_consumption: '6.1l/100km' });
+  }],
+  ['BEV CO2 0 g/km has no field behind it and is never gated', () => {
+    const bev: any = { _id: 'car-3', consumption: { fuel: 'selector_fuel_electrical', wltpPowerCombined: 16.8 }, engineData: {}, battery: {}, environmentEmissions: { wltpCo2: 0 } };
+    assert.deepEqual(gate('audit', [['car-3|environmentEmissions.wltpCo2', '0'], ['car-3|consumption.wltpPowerCombined', '16.8']]).estimatedAttributes(bev), ['energy_consumption']);
+  }],
+];
+
+let failed = 0;
+for (const [name, fn] of cases) {
+  try {
+    fn();
+    console.log(`ok   ${name}`);
+  } catch (e) {
+    failed += 1;
+    console.error(`FAIL ${name}\n     ${e.message}`);
+  }
+}
+if (failed) process.exit(1);