@bytebrand/export-cars 1.26.26 → 1.26.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytebrand/export-cars",
-  "version": "1.26.26",
+  "version": "1.26.28",
   "description": "",
   "author": "bytebrand",
   "license": "UNLICENSED",
@@ -11,7 +11,7 @@
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint": "eslint -c .eslintrc.js --ext .ts src/",
     "start:dev": "nest start --watch",
-    "test": "ts-node --transpile-only test/google-feed-envkv.test.ts && ts-node --transpile-only test/google-feed-item-row.test.ts"
+    "test": "ts-node --transpile-only test/google-feed-envkv.test.ts && ts-node --transpile-only test/google-feed-item-row.test.ts && ts-node --transpile-only test/publication-gate.test.ts"
   },
   "dependencies": {
     "@bytebrand/autode-request": "^1.19.2",

package/schema/feed-items.json

@@ -118,5 +118,17 @@
     "type": "STRING",
     "mode": "NULLABLE",
     "description": "<g:availability> as sent"
+  },
+  {
+    "name": "publicationGate",
+    "type": "STRING",
+    "mode": "NULLABLE",
+    "description": "EnVKV C8 gate mode of the run (audit / enforce), null when off"
+  },
+  {
+    "name": "estimatedAttributes",
+    "type": "STRING",
+    "mode": "NULLABLE",
+    "description": "Comma-separated EnVKV attributes whose value CBD estimated; left out of the item in enforce mode"
   }
 ]

package/src/configs/config.ts

@@ -1,5 +1,5 @@
 import { Environment, ExportType, ImageType } from '../enums';
-import { FeedItemsBigQueryTarget, Params } from '../interfaces/params.interface';
+import { FeedItemsBigQueryTarget, Params, PublicationGateConfig } from '../interfaces/params.interface';
 
 export class Config {
   apikey: string;
@@ -43,6 +43,8 @@ export class Config {
   runId?: string;
   // Set only when the job configures the feed items BigQuery table; unset = no BigQuery calls.
   feedItemsBigQuery?: FeedItemsBigQueryTarget;
+  // EnVKV C8 publication gate of the Google feed; unset = off.
+  publicationGate?: PublicationGateConfig;
 
   protected environmentConfig = {
     [Environment.DEVELOP]: {

package/src/configs/google.config.ts

@@ -1,26 +1,41 @@
-import { ExportType, FileType, ImageType } from 'src/enums';
-import { resolveMaxFeedSalesPrice } from '../constants/feed-price.constants';
-import { Params } from '../interfaces/params.interface';
-import { Config } from './config';
-
-const trimmed = (value: unknown): string => (typeof value === 'string' ? value.trim() : '');
-
-export class GoogleConfig extends Config {
-  constructor(params: Params) {
-    super(params);
-    this.pathesConfig.localConvertedDirectory = `resources/${ExportType.GOOGLE}-export`;
-    this.imageType = ImageType.default;
-    this.maxCurrentSalesPrice = resolveMaxFeedSalesPrice(params.maxCurrentSalesPrice);
-    const feedItemsBigQuery = {
-      project: trimmed(params.feedItemsBqProject),
-      dataset: trimmed(params.feedItemsBqDataset),
-      table: trimmed(params.feedItemsBqTable),
-    };
-    if (feedItemsBigQuery.project && feedItemsBigQuery.dataset && feedItemsBigQuery.table) {
-      this.feedItemsBigQuery = feedItemsBigQuery;
-    }
-    this.outputFiles = [
-      `${this.pathesConfig.localConvertedDirectory}/api_export_cars_${ExportType.GOOGLE}.${FileType.XML}`,
-    ];
-  }
-}
+import { ExportType, FileType, ImageType } from 'src/enums';
+import { resolveMaxFeedSalesPrice } from '../constants/feed-price.constants';
+import { Params, PublicationGateConfig } from '../interfaces/params.interface';
+import { Config } from './config';
+
+const trimmed = (value: unknown): string => (typeof value === 'string' ? value.trim() : '');
+
+export class GoogleConfig extends Config {
+  constructor(params: Params) {
+    super(params);
+    this.pathesConfig.localConvertedDirectory = `resources/${ExportType.GOOGLE}-export`;
+    this.imageType = ImageType.default;
+    this.maxCurrentSalesPrice = resolveMaxFeedSalesPrice(params.maxCurrentSalesPrice);
+    const feedItemsBigQuery = {
+      project: trimmed(params.feedItemsBqProject),
+      dataset: trimmed(params.feedItemsBqDataset),
+      table: trimmed(params.feedItemsBqTable),
+    };
+    if (feedItemsBigQuery.project && feedItemsBigQuery.dataset && feedItemsBigQuery.table) {
+      this.feedItemsBigQuery = feedItemsBigQuery;
+    }
+    const gateMode = trimmed(params.publicationGate).toLowerCase();
+    if (gateMode === 'audit' || gateMode === 'enforce') {
+      const gate = {
+        mode: gateMode as PublicationGateConfig['mode'],
+        project: trimmed(params.publicationGateBqProject),
+        dataset: trimmed(params.publicationGateBqDataset),
+        table: trimmed(params.publicationGateBqTable),
+      };
+      if (!gate.project || !gate.dataset || !gate.table) {
+        throw new Error(`publicationGate=${gateMode} needs publicationGateBqProject, publicationGateBqDataset and publicationGateBqTable`);
+      }
+      this.publicationGate = gate;
+    } else if (gateMode && gateMode !== 'off') {
+      throw new Error(`publicationGate must be off, audit or enforce, got "${gateMode}"`);
+    }
+    this.outputFiles = [
+      `${this.pathesConfig.localConvertedDirectory}/api_export_cars_${ExportType.GOOGLE}.${FileType.XML}`,
+    ];
+  }
+}

package/src/export.command.ts

@@ -1,38 +1,38 @@
-import { createInterface } from 'readline';
-import { Command, CommandRunner } from 'nest-commander';
-import { ConfigService } from './services';
-import { Input } from './interfaces/input.interface';
-import { exportSchema } from './export.schema';
-import { ModuleRef } from '@nestjs/core';
-import { Exporter } from './interfaces/exporter.interface';
-import { LoggerService } from '@bytebrand/cronicle-helper';
-
-@Command({
-  name: 'export',
-  options: { isDefault: true },
-})
-export class ExportRunner extends CommandRunner {
-  constructor(
-    private configService: ConfigService,
-    private moduleRef: ModuleRef,
-  ) {
-    super();
-  }
-
-  async run(): Promise<void> {
-    const rl = createInterface({ input: process.stdin });
-    await new Promise<void>((resolve, reject) => {
-      rl.on('line', async (data: string) => {
-        const input = JSON.parse(data) as Input;
-        LoggerService.log(`Running job: ${input.id} - ${JSON.stringify(input)} \n`);
-
-        this.configService.config = new exportSchema[input.params.exportType].config(input.params);
-        this.configService.config.runId = input.id;
-        const exporter = await this.moduleRef.create<Exporter>(exportSchema[input.params.exportType].exporter);
-        await exporter.export().catch(reject);
-
-        resolve(rl.close());
-      });
-    });
-  }
-}
+import { createInterface } from 'readline';
+import { Command, CommandRunner } from 'nest-commander';
+import { ConfigService } from './services';
+import { Input } from './interfaces/input.interface';
+import { exportSchema } from './export.schema';
+import { ModuleRef } from '@nestjs/core';
+import { Exporter } from './interfaces/exporter.interface';
+import { LoggerService } from '@bytebrand/cronicle-helper';
+
+@Command({
+  name: 'export',
+  options: { isDefault: true },
+})
+export class ExportRunner extends CommandRunner {
+  constructor(
+    private configService: ConfigService,
+    private moduleRef: ModuleRef,
+  ) {
+    super();
+  }
+
+  async run(): Promise<void> {
+    const rl = createInterface({ input: process.stdin });
+    await new Promise<void>((resolve, reject) => {
+      rl.on('line', async (data: string) => {
+        const input = JSON.parse(data) as Input;
+        LoggerService.log(`Running job: ${input.id} - ${JSON.stringify(input)} \n`);
+
+        this.configService.config = new exportSchema[input.params.exportType].config(input.params);
+        this.configService.config.runId = input.id;
+        const exporter = await this.moduleRef.create<Exporter>(exportSchema[input.params.exportType].exporter);
+        await exporter.export().catch(reject);
+
+        resolve(rl.close());
+      });
+    });
+  }
+}

package/src/exporters/google.exporter.ts

@@ -1,56 +1,67 @@
-import { Injectable } from '@nestjs/common';
-import { ModuleRef } from '@nestjs/core';
-
-import { CronicleUtils } from '@bytebrand/cronicle-helper';
-import { FsChunkInterface } from '@bytebrand/chunkable';
-
-import { CarService, ConfigService, LoaderService, RulesService } from '../services';
-import { GoogleTransformer } from '../transformers/google.transformer';
-import { buildGoogleFeedItemRow } from '../transformers/google-feed-item-row';
-import { FeedItemsBigQueryWriter } from '../services/feed-items-bigquery.writer';
-import { GoogleXmlBuilder } from '../formats/google-xml.builder';
-import { Exporter } from '../interfaces/exporter.interface';
-
-@Injectable()
-export class GoogleExporter implements Exporter {
-  constructor(
-    private carService: CarService,
-    private configService: ConfigService,
-    private rulesService: RulesService,
-    private loaderService: LoaderService,
-    private moduleRef: ModuleRef,
-  ) { }
-
-  async export(): Promise<void> {
-    const [fileName] = this.configService.config.outputFiles;
-    await CronicleUtils.ensureDir(this.configService.config.pathesConfig.localConvertedDirectory);
-    await CronicleUtils.emptyDir(this.configService.config.pathesConfig.localConvertedDirectory);
-
-    const googleXmlBuilder = new GoogleXmlBuilder(fileName);
-    await googleXmlBuilder.buildStart(this.configService.config.domain);
-
-    const googleTransformer = await this.moduleRef.create(GoogleTransformer);
-
-    // Opt-in audit of the sent items (feedItemsBq* job params); null = no BigQuery calls at all.
-    const { feedItemsBigQuery, runId } = this.configService.config;
-    const feedItemsWriter = feedItemsBigQuery ? new FeedItemsBigQueryWriter(feedItemsBigQuery) : null;
-    const exportedAt = new Date();
-
-    await this.loaderService.process(async (chunk: FsChunkInterface) => {
-      chunk.data = chunk.data.filter(car => this.carService.filterCar(car, this.rulesService.rules));
-
-      for (const data of chunk.data) {
-        const car = await googleTransformer.transform(data);
-        if (car) {
-          await googleXmlBuilder.addItem(car);
-          feedItemsWriter?.add(buildGoogleFeedItemRow(data.car, car, runId, exportedAt));
-        }
-        this.carService.counter.countCar(data.images);
-      }
-    });
-
-    await googleXmlBuilder.buildEnd();
-    await feedItemsWriter?.close();
-    console.log(this.carService.counter.getCountedCars());
-  }
-}
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+
+import { CronicleUtils } from '@bytebrand/cronicle-helper';
+import { FsChunkInterface } from '@bytebrand/chunkable';
+
+import { CarService, ConfigService, LoaderService, RulesService } from '../services';
+import { GoogleTransformer } from '../transformers/google.transformer';
+import { buildGoogleFeedItemRow } from '../transformers/google-feed-item-row';
+import { FeedItemsBigQueryWriter } from '../services/feed-items-bigquery.writer';
+import { loadPublicationGate } from '../services/publication-gate';
+import { GoogleXmlBuilder } from '../formats/google-xml.builder';
+import { Exporter } from '../interfaces/exporter.interface';
+
+@Injectable()
+export class GoogleExporter implements Exporter {
+  constructor(
+    private carService: CarService,
+    private configService: ConfigService,
+    private rulesService: RulesService,
+    private loaderService: LoaderService,
+    private moduleRef: ModuleRef,
+  ) { }
+
+  async export(): Promise<void> {
+    // EnVKV C8: estimated EnVKV values (CBD enrichment log); off unless the job sets publicationGate.
+    // Read first: in enforce mode a failure stops the run before the output directory is emptied.
+    const gate = await loadPublicationGate(this.configService.config.publicationGate);
+    const [fileName] = this.configService.config.outputFiles;
+    await CronicleUtils.ensureDir(this.configService.config.pathesConfig.localConvertedDirectory);
+    await CronicleUtils.emptyDir(this.configService.config.pathesConfig.localConvertedDirectory);
+
+    const googleXmlBuilder = new GoogleXmlBuilder(fileName);
+    await googleXmlBuilder.buildStart(this.configService.config.domain);
+
+    const googleTransformer = await this.moduleRef.create(GoogleTransformer);
+
+    // Opt-in audit of the sent items (feedItemsBq* job params); null = no BigQuery calls at all.
+    const { feedItemsBigQuery, runId } = this.configService.config;
+    const feedItemsWriter = feedItemsBigQuery ? new FeedItemsBigQueryWriter(feedItemsBigQuery) : null;
+    const exportedAt = new Date();
+    let gatedItems = 0;
+
+    await this.loaderService.process(async (chunk: FsChunkInterface) => {
+      chunk.data = chunk.data.filter(car => this.carService.filterCar(car, this.rulesService.rules));
+
+      for (const data of chunk.data) {
+        const car = await googleTransformer.transform(data);
+        if (car) {
+          const estimatedAttributes = gate.estimatedAttributes(data.car);
+          if (estimatedAttributes.length) gatedItems += 1;
+          await googleXmlBuilder.addItem(gate.apply(car, estimatedAttributes));
+          const gateInfo = gate.mode === 'off' ? null : { mode: gate.mode, estimatedAttributes };
+          feedItemsWriter?.add(buildGoogleFeedItemRow(data.car, car, runId, exportedAt, gateInfo));
+        }
+        this.carService.counter.countCar(data.images);
+      }
+    });
+
+    await googleXmlBuilder.buildEnd();
+    if (gate.mode !== 'off') {
+      console.log(`Publication gate ${gate.mode}: ${gatedItems} items with estimated EnVKV values${gate.mode === 'enforce' ? ' (attributes left out)' : ''}`);
+    }
+    await feedItemsWriter?.close();
+    console.log(this.carService.counter.getCountedCars());
+  }
+}

package/src/interfaces/params.interface.ts

@@ -1,29 +1,43 @@
-import { Environment, ExportType } from '../enums';
-
-export interface Params {
-  environment: Environment;
-  exportType?: ExportType;
-  apikey?: string;
-  String?: string;
-  Number?: string;
-  Date?: string;
-  isNewCar?: boolean;
-  cpc?: string;
-  ownerId?: string;
-  metaPushPriorityCsvUrl?: string;
-  // Cronicle plugin param (text field, so it arrives as a string); overrides the
-  // default MAX_FEED_SALES_PRICE_EUR cap in the configs that apply one.
-  maxCurrentSalesPrice?: string;
-  // Google feed only, opt-in: when all three are set, every exported item is also written to
-  // `<project>.<dataset>.<table>` in BigQuery (schema/feed-items.json, see README).
-  feedItemsBqProject?: string;
-  feedItemsBqDataset?: string;
-  feedItemsBqTable?: string;
-}
-
-// Parsed from feedItemsBq* by GoogleConfig.
-export interface FeedItemsBigQueryTarget {
-  project: string;
-  dataset: string;
-  table: string;
-}
+import { Environment, ExportType } from '../enums';
+
+export interface Params {
+  environment: Environment;
+  exportType?: ExportType;
+  apikey?: string;
+  String?: string;
+  Number?: string;
+  Date?: string;
+  isNewCar?: boolean;
+  cpc?: string;
+  ownerId?: string;
+  metaPushPriorityCsvUrl?: string;
+  // Cronicle plugin param (text field, so it arrives as a string); overrides the
+  // default MAX_FEED_SALES_PRICE_EUR cap in the configs that apply one.
+  maxCurrentSalesPrice?: string;
+  // Google feed only, opt-in: when all three are set, every exported item is also written to
+  // `<project>.<dataset>.<table>` in BigQuery (schema/feed-items.json, see README).
+  feedItemsBqProject?: string;
+  feedItemsBqDataset?: string;
+  feedItemsBqTable?: string;
+  // Google feed only, EnVKV C8: off (default) | audit | enforce, and the car-basic-data enrichment log
+  // table the estimates are read from (see services/publication-gate.ts).
+  publicationGate?: string;
+  publicationGateBqProject?: string;
+  publicationGateBqDataset?: string;
+  publicationGateBqTable?: string;
+}
+
+// Parsed from feedItemsBq* by GoogleConfig.
+export interface FeedItemsBigQueryTarget {
+  project: string;
+  dataset: string;
+  table: string;
+}
+
+// Parsed from publicationGate* by GoogleConfig.
+export interface PublicationGateConfig {
+  mode: 'off' | 'audit' | 'enforce';
+  project: string;
+  dataset: string;
+  table: string;
+}

package/src/services/feed-items-bigquery.writer.ts

@@ -1,101 +1,101 @@
-import { join } from 'path';
-import { BigQueryLogger } from '@bytebrand/bigquery-logger';
-import { FeedItemsBigQueryTarget } from '../interfaces/params.interface';
-import { FeedItemRow } from '../transformers/google-feed-item-row';
-
-const BATCH_SIZE = 500;
-// After this many failed batches the writer gives up for the run (missing table, bad credentials).
-const MAX_FAILED_BATCHES = 3;
-const CLOSE_TIMEOUT_MS = 60000;
-
-class FeedItemsBigQueryLogger extends BigQueryLogger {
-  async insertRows(rows: FeedItemRow[]): Promise<void> {
-    await this.client
-      .dataset(this.options.BigQueryDataset)
-      .table(this.options.BigQueryLogTable)
-      .insert(rows, { skipInvalidRows: true, ignoreUnknownValues: true });
-  }
-}
-
-// Audit trail of the feed items: rows are buffered and inserted in batches of 500 in the background,
-// one batch at a time. Errors are logged and swallowed — the feed export must never fail because of
-// BigQuery.
-export class FeedItemsBigQueryWriter {
-  private logger: FeedItemsBigQueryLogger;
-  private buffer: FeedItemRow[] = [];
-  private queue: Promise<void> = Promise.resolve();
-  private failedBatches = 0;
-  private insertedRows = 0;
-
-  constructor(private target: FeedItemsBigQueryTarget) {
-    try {
-      const credentials = require(join(process.cwd(), 'credentials/google-cloud-project-id.json'));
-      this.logger = new FeedItemsBigQueryLogger(credentials, {
-        BigQueryProject: target.project,
-        BigQueryDataset: target.dataset,
-        BigQueryLogTable: target.table,
-      });
-    } catch (e) {
-      // First line only: a missing credentials file comes with the whole require stack.
-      console.log(`Feed items BigQuery disabled: ${String(e?.message || e).split('\n')[0]}`);
-    }
-  }
-
-  add(row: FeedItemRow): void {
-    if (!this.enabled) return;
-    this.buffer.push(row);
-    if (this.buffer.length >= BATCH_SIZE) this.flush();
-  }
-
-  // Waits for the pending batches, but never longer than CLOSE_TIMEOUT_MS: a hanging BigQuery
-  // must not hold up the feed export (the XML is already written at this point).
-  async close(): Promise<void> {
-    this.flush();
-    let timer: NodeJS.Timeout | undefined;
-    const timeout = new Promise<'timeout'>((resolve) => {
-      timer = setTimeout(() => resolve('timeout'), CLOSE_TIMEOUT_MS);
-    });
-    const outcome = await Promise.race([this.queue.then(() => 'done' as const), timeout]);
-    if (timer) clearTimeout(timer);
-    if (outcome === 'timeout') console.error(`Feed items BigQuery: gave up waiting after ${CLOSE_TIMEOUT_MS} ms`);
-    if (this.logger) {
-      console.log(`Feed items BigQuery: ${this.insertedRows} rows to ${this.tableName}, ${this.failedBatches} failed batches`);
-    }
-  }
-
-  private get enabled(): boolean {
-    return !!this.logger && this.failedBatches < MAX_FAILED_BATCHES;
-  }
-
-  private get tableName(): string {
-    return `${this.target.project}.${this.target.dataset}.${this.target.table}`;
-  }
-
-  private flush(): void {
-    if (!this.buffer.length) return;
-    const rows = this.buffer;
-    this.buffer = [];
-    this.queue = this.queue.then(() => this.insert(rows));
-  }
-
-  private async insert(rows: FeedItemRow[]): Promise<void> {
-    if (!this.enabled) return;
-    try {
-      await this.logger.insertRows(rows);
-      this.insertedRows += rows.length;
-    } catch (e) {
-      // PartialFailureError: the valid rows went in (skipInvalidRows), `errors` lists the rejected
-      // ones; the first is enough to see the cause.
-      const rejected: any[] = e?.name === 'PartialFailureError' && Array.isArray(e.errors) ? e.errors : null;
-      const firstRowError = rejected?.[0]?.errors?.[0];
-      const detail = firstRowError ? ` (${firstRowError.reason}: ${firstRowError.message})` : '';
-      if (rejected) {
-        this.insertedRows += rows.length - rejected.length;
-        console.log(`Feed items BigQuery rejected ${rejected.length} of ${rows.length} rows${detail}`);
-      } else {
-        this.failedBatches++;
-        console.log(`Feed items BigQuery insert of ${rows.length} rows failed: ${e?.message || e}`);
-      }
-    }
-  }
-}
+import { join } from 'path';
+import { BigQueryLogger } from '@bytebrand/bigquery-logger';
+import { FeedItemsBigQueryTarget } from '../interfaces/params.interface';
+import { FeedItemRow } from '../transformers/google-feed-item-row';
+
+const BATCH_SIZE = 500;
+// After this many failed batches the writer gives up for the run (missing table, bad credentials).
+const MAX_FAILED_BATCHES = 3;
+const CLOSE_TIMEOUT_MS = 60000;
+
+class FeedItemsBigQueryLogger extends BigQueryLogger {
+  async insertRows(rows: FeedItemRow[]): Promise<void> {
+    await this.client
+      .dataset(this.options.BigQueryDataset)
+      .table(this.options.BigQueryLogTable)
+      .insert(rows, { skipInvalidRows: true, ignoreUnknownValues: true });
+  }
+}
+
+// Audit trail of the feed items: rows are buffered and inserted in batches of 500 in the background,
+// one batch at a time. Errors are logged and swallowed — the feed export must never fail because of
+// BigQuery.
+export class FeedItemsBigQueryWriter {
+  private logger: FeedItemsBigQueryLogger;
+  private buffer: FeedItemRow[] = [];
+  private queue: Promise<void> = Promise.resolve();
+  private failedBatches = 0;
+  private insertedRows = 0;
+
+  constructor(private target: FeedItemsBigQueryTarget) {
+    try {
+      const credentials = require(join(process.cwd(), 'credentials/google-cloud-project-id.json'));
+      this.logger = new FeedItemsBigQueryLogger(credentials, {
+        BigQueryProject: target.project,
+        BigQueryDataset: target.dataset,
+        BigQueryLogTable: target.table,
+      });
+    } catch (e) {
+      // First line only: a missing credentials file comes with the whole require stack.
+      console.log(`Feed items BigQuery disabled: ${String(e?.message || e).split('\n')[0]}`);
+    }
+  }
+
+  add(row: FeedItemRow): void {
+    if (!this.enabled) return;
+    this.buffer.push(row);
+    if (this.buffer.length >= BATCH_SIZE) this.flush();
+  }
+
+  // Waits for the pending batches, but never longer than CLOSE_TIMEOUT_MS: a hanging BigQuery
+  // must not hold up the feed export (the XML is already written at this point).
+  async close(): Promise<void> {
+    this.flush();
+    let timer: NodeJS.Timeout | undefined;
+    const timeout = new Promise<'timeout'>((resolve) => {
+      timer = setTimeout(() => resolve('timeout'), CLOSE_TIMEOUT_MS);
+    });
+    const outcome = await Promise.race([this.queue.then(() => 'done' as const), timeout]);
+    if (timer) clearTimeout(timer);
+    if (outcome === 'timeout') console.error(`Feed items BigQuery: gave up waiting after ${CLOSE_TIMEOUT_MS} ms`);
+    if (this.logger) {
+      console.log(`Feed items BigQuery: ${this.insertedRows} rows to ${this.tableName}, ${this.failedBatches} failed batches`);
+    }
+  }
+
+  private get enabled(): boolean {
+    return !!this.logger && this.failedBatches < MAX_FAILED_BATCHES;
+  }
+
+  private get tableName(): string {
+    return `${this.target.project}.${this.target.dataset}.${this.target.table}`;
+  }
+
+  private flush(): void {
+    if (!this.buffer.length) return;
+    const rows = this.buffer;
+    this.buffer = [];
+    this.queue = this.queue.then(() => this.insert(rows));
+  }
+
+  private async insert(rows: FeedItemRow[]): Promise<void> {
+    if (!this.enabled) return;
+    try {
+      await this.logger.insertRows(rows);
+      this.insertedRows += rows.length;
+    } catch (e) {
+      // PartialFailureError: the valid rows went in (skipInvalidRows), `errors` lists the rejected
+      // ones; the first is enough to see the cause.
+      const rejected: any[] = e?.name === 'PartialFailureError' && Array.isArray(e.errors) ? e.errors : null;
+      const firstRowError = rejected?.[0]?.errors?.[0];
+      const detail = firstRowError ? ` (${firstRowError.reason}: ${firstRowError.message})` : '';
+      if (rejected) {
+        this.insertedRows += rows.length - rejected.length;
+        console.log(`Feed items BigQuery rejected ${rejected.length} of ${rows.length} rows${detail}`);
+      } else {
+        this.failedBatches++;
+        console.log(`Feed items BigQuery insert of ${rows.length} rows failed: ${e?.message || e}`);
+      }
+    }
+  }
+}