@bytebrand/export-cars 1.26.27 → 1.26.29

package/dist/formats/openai-ads-csv.builder.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiAdsCsvBuilder = exports.openAiAdsCsvRow = exports.openAiAdsCsvHeader = exports.toCsvLine = exports.toCsvCell = void 0;
+const fs_1 = require("fs");
+const events_1 = require("events");
+const openai_ads_interface_1 = require("../interfaces/openai-ads.interface");
+const toCsvCell = (value) => {
+    if (value === undefined || value === null) {
+        return '';
+    }
+    const text = typeof value === 'boolean' ? (value ? 'true' : 'false') : value;
+    return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+};
+exports.toCsvCell = toCsvCell;
+const toCsvLine = (cells) => `${cells.map(exports.toCsvCell).join(',')}\n`;
+exports.toCsvLine = toCsvLine;
+const openAiAdsCsvHeader = () => (0, exports.toCsvLine)([...openai_ads_interface_1.OPENAI_ADS_COLUMNS]);
+exports.openAiAdsCsvHeader = openAiAdsCsvHeader;
+const openAiAdsCsvRow = (row) => (0, exports.toCsvLine)(openai_ads_interface_1.OPENAI_ADS_COLUMNS.map(column => row[column]));
+exports.openAiAdsCsvRow = openAiAdsCsvRow;
+class OpenAiAdsCsvBuilder {
+    fileName;
+    stream;
+    rows = 0;
+    constructor(fileName) {
+        this.fileName = fileName;
+    }
+    async buildStart() {
+        this.stream = (0, fs_1.createWriteStream)(this.fileName, { encoding: 'utf8' });
+        await this.write((0, exports.openAiAdsCsvHeader)());
+    }
+    async addItem(row) {
+        await this.write((0, exports.openAiAdsCsvRow)(row));
+        this.rows += 1;
+    }
+    async buildEnd() {
+        this.stream.end();
+        await (0, events_1.once)(this.stream, 'finish');
+        return this.rows;
+    }
+    async write(chunk) {
+        if (!this.stream.write(chunk)) {
+            await (0, events_1.once)(this.stream, 'drain');
+        }
+    }
+}
+exports.OpenAiAdsCsvBuilder = OpenAiAdsCsvBuilder;
+//# sourceMappingURL=openai-ads-csv.builder.js.map

package/dist/formats/openai-ads-csv.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-ads-csv.builder.js","sourceRoot":"","sources":["../../src/formats/openai-ads-csv.builder.ts"],"names":[],"mappings":";;;AAAA,2BAAoD;AACpD,mCAA8B;AAE9B,6EAAsF;AAK/E,MAAM,SAAS,GAAG,CAAC,KAA0C,EAAU,EAAE;IAC9E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE;QACzC,OAAO,EAAE,CAAC;KACX;IACD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7E,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB;AAEK,MAAM,SAAS,GAAG,CAAC,KAAiD,EAAU,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;AAAjH,QAAA,SAAS,aAAwG;AAEvH,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAAC,IAAA,iBAAS,EAAC,CAAC,GAAG,yCAAkB,CAAC,CAAC,CAAC;AAAtE,QAAA,kBAAkB,sBAAoD;AAE5E,MAAM,eAAe,GAAG,CAAC,GAAiB,EAAU,EAAE,CAAC,IAAA,iBAAS,EAAC,yCAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAA1G,QAAA,eAAe,mBAA2F;AAOvH,MAAa,mBAAmB;IAID;IAHrB,MAAM,CAAc;IACpB,IAAI,GAAG,CAAC,CAAC;IAEjB,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAI,CAAC;IAElD,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,MAAM,GAAG,IAAA,sBAAiB,EAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAA,0BAAkB,GAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAiB;QAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAA,uBAAe,EAAC,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAClB,MAAM,IAAA,aAAI,EAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,KAAa;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC7B,MAAM,IAAA,aAAI,EAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAClC;IACH,CAAC;CACF;AA3BD,kDA2BC"}

package/dist/interfaces/openai-ads.interface.d.ts

@@ -0,0 +1,35 @@
+export declare const OPENAI_ADS_COLUMNS: readonly ["item_id", "title", "description", "url", "brand", "seller_name", "image_url", "additional_image_urls", "availability", "price", "condition", "is_ads_eligible"];
+export type OpenAiAdsColumn = typeof OPENAI_ADS_COLUMNS[number];
+export type OpenAiAdsAvailability = 'in_stock' | 'out_of_stock';
+export type OpenAiAdsCondition = 'new' | 'used';
+export interface OpenAiAdsRow {
+    item_id: string;
+    title: string;
+    description: string;
+    url: string;
+    brand: string;
+    seller_name: string;
+    image_url: string;
+    additional_image_urls: string;
+    availability: OpenAiAdsAvailability;
+    price: string;
+    condition: OpenAiAdsCondition;
+    is_ads_eligible: boolean;
+}
+export declare enum OpenAiAdsExclusion {
+    noId = "no_id",
+    duplicateId = "duplicate_id",
+    filtered = "filtered",
+    invalidPrice = "invalid_price",
+    noTitle = "no_title",
+    noBrand = "no_brand",
+    conditionUnknown = "condition_unknown",
+    dealerInactive = "dealer_inactive",
+    dealerUnknown = "dealer_unknown",
+    noImage = "no_image"
+}
+export declare enum OpenAiAdsOutOfStockReason {
+    reserved = "reserved",
+    soldFlag = "sold_flag",
+    notInSnapshot = "not_in_snapshot"
+}

package/dist/interfaces/openai-ads.interface.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiAdsOutOfStockReason = exports.OpenAiAdsExclusion = exports.OPENAI_ADS_COLUMNS = void 0;
+exports.OPENAI_ADS_COLUMNS = [
+    'item_id',
+    'title',
+    'description',
+    'url',
+    'brand',
+    'seller_name',
+    'image_url',
+    'additional_image_urls',
+    'availability',
+    'price',
+    'condition',
+    'is_ads_eligible',
+];
+var OpenAiAdsExclusion;
+(function (OpenAiAdsExclusion) {
+    OpenAiAdsExclusion["noId"] = "no_id";
+    OpenAiAdsExclusion["duplicateId"] = "duplicate_id";
+    OpenAiAdsExclusion["filtered"] = "filtered";
+    OpenAiAdsExclusion["invalidPrice"] = "invalid_price";
+    OpenAiAdsExclusion["noTitle"] = "no_title";
+    OpenAiAdsExclusion["noBrand"] = "no_brand";
+    OpenAiAdsExclusion["conditionUnknown"] = "condition_unknown";
+    OpenAiAdsExclusion["dealerInactive"] = "dealer_inactive";
+    OpenAiAdsExclusion["dealerUnknown"] = "dealer_unknown";
+    OpenAiAdsExclusion["noImage"] = "no_image";
+})(OpenAiAdsExclusion || (exports.OpenAiAdsExclusion = OpenAiAdsExclusion = {}));
+var OpenAiAdsOutOfStockReason;
+(function (OpenAiAdsOutOfStockReason) {
+    OpenAiAdsOutOfStockReason["reserved"] = "reserved";
+    OpenAiAdsOutOfStockReason["soldFlag"] = "sold_flag";
+    OpenAiAdsOutOfStockReason["notInSnapshot"] = "not_in_snapshot";
+})(OpenAiAdsOutOfStockReason || (exports.OpenAiAdsOutOfStockReason = OpenAiAdsOutOfStockReason = {}));
+//# sourceMappingURL=openai-ads.interface.js.map

package/dist/interfaces/openai-ads.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-ads.interface.js","sourceRoot":"","sources":["../../src/interfaces/openai-ads.interface.ts"],"names":[],"mappings":";;;AAGa,QAAA,kBAAkB,GAAG;IAChC,SAAS;IACT,OAAO;IACP,aAAa;IACb,KAAK;IACL,OAAO;IACP,aAAa;IACb,WAAW;IACX,uBAAuB;IACvB,cAAc;IACd,OAAO;IACP,WAAW;IACX,iBAAiB;CACT,CAAC;AA4BX,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,oCAAc,CAAA;IACd,kDAA4B,CAAA;IAC5B,2CAAqB,CAAA;IACrB,oDAA8B,CAAA;IAC9B,0CAAoB,CAAA;IACpB,0CAAoB,CAAA;IACpB,4DAAsC,CAAA;IACtC,wDAAkC,CAAA;IAClC,sDAAgC,CAAA;IAChC,0CAAoB,CAAA;AACtB,CAAC,EAXW,kBAAkB,kCAAlB,kBAAkB,QAW7B;AAGD,IAAY,yBAKX;AALD,WAAY,yBAAyB;IACnC,kDAAqB,CAAA;IACrB,mDAAsB,CAAA;IAEtB,8DAAiC,CAAA;AACnC,CAAC,EALW,yBAAyB,yCAAzB,yBAAyB,QAKpC"}

package/dist/interfaces/params.interface.d.ts

@@ -14,9 +14,29 @@ export interface Params {
     feedItemsBqProject?: string;
     feedItemsBqDataset?: string;
     feedItemsBqTable?: string;
+    publicationGate?: string;
+    publicationGateBqProject?: string;
+    publicationGateBqDataset?: string;
+    publicationGateBqTable?: string;
+    openAiAdsDryRun?: string;
+    openAiAdsSellerName?: string;
+    openAiAdsRetentionDays?: string;
+    openAiAdsImageConcurrency?: string;
+    feedGuardMinSourceItems?: string;
+    feedGuardMinPublishedItems?: string;
+    feedGuardMaxDropPercent?: string;
+    feedGuardMaxSourceAgeHours?: string;
+    feedGuardMaxStaleHours?: string;
+    feedGuardAcceptDrop?: string;
 }
 export interface FeedItemsBigQueryTarget {
     project: string;
     dataset: string;
     table: string;
 }
+export interface PublicationGateConfig {
+    mode: 'off' | 'audit' | 'enforce';
+    project: string;
+    dataset: string;
+    table: string;
+}

package/dist/services/feed-guard.d.ts

@@ -0,0 +1,44 @@
+export interface FeedGuardOptions {
+    stateDir: string;
+    minSourceItems: number;
+    minPublishedItems: number;
+    maxDropPercent: number;
+    maxSourceAgeHours: number;
+    maxStaleHours: number;
+    acceptDrop: boolean;
+    lockStaleHours?: number;
+}
+export interface SourceSnapshot {
+    files: number;
+    missingChunks: number[];
+    newestMtime: Date | null;
+    oldestMtime: Date | null;
+}
+export interface FeedCounts {
+    sourceItems: number;
+    publishedItems: number;
+}
+export interface LastGood extends FeedCounts {
+    publishedAt: string;
+    file: string;
+    runId?: string;
+}
+export declare class FeedGuardError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare const inspectSourceSnapshot: (directory: string, baseFileName: string) => Promise<SourceSnapshot>;
+export declare class FeedGuard {
+    private readonly options;
+    private lockFile;
+    constructor(options: FeedGuardOptions);
+    private get lastGoodFile();
+    readLastGood(): Promise<LastGood | null>;
+    acquireLock(runId: string, now: Date): Promise<void>;
+    releaseLock(): Promise<void>;
+    checkSource(snapshot: SourceSnapshot, now: Date): void;
+    checkCounts(counts: FeedCounts, lastGood: LastGood | null): void;
+    staleHours(lastGood: LastGood | null, now: Date): number | null;
+    isStale(lastGood: LastGood | null, now: Date): boolean;
+    publish(tmpFile: string, finalFile: string, counts: FeedCounts, now: Date, runId?: string): Promise<LastGood>;
+}

package/dist/services/feed-guard.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedGuard = exports.inspectSourceSnapshot = exports.FeedGuardError = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+class FeedGuardError extends Error {
+    code;
+    constructor(code, message) {
+        super(`[feed-guard:${code}] ${message}`);
+        this.code = code;
+    }
+}
+exports.FeedGuardError = FeedGuardError;
+const HOUR_MS = 60 * 60 * 1000;
+const inspectSourceSnapshot = async (directory, baseFileName) => {
+    let names;
+    try {
+        names = await fs_1.promises.readdir(directory);
+    }
+    catch (error) {
+        if (error?.code === 'ENOENT') {
+            return { files: 0, missingChunks: [], newestMtime: null, oldestMtime: null };
+        }
+        throw error;
+    }
+    const pattern = new RegExp(`^${baseFileName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\.(\\d+)\\.json$`);
+    const chunks = names.map(name => ({ name, match: pattern.exec(name) })).filter(entry => entry.match);
+    const ids = new Set(chunks.map(entry => Number(entry.match[1])));
+    const maxId = ids.size ? Math.max(...ids) : -1;
+    const missingChunks = [];
+    for (let id = 0; id <= maxId; id += 1) {
+        if (!ids.has(id)) {
+            missingChunks.push(id);
+        }
+    }
+    let newest = null;
+    let oldest = null;
+    for (const { name } of chunks) {
+        const { mtimeMs } = await fs_1.promises.stat((0, path_1.join)(directory, name));
+        newest = newest === null ? mtimeMs : Math.max(newest, mtimeMs);
+        oldest = oldest === null ? mtimeMs : Math.min(oldest, mtimeMs);
+    }
+    return {
+        files: chunks.length,
+        missingChunks,
+        newestMtime: newest === null ? null : new Date(newest),
+        oldestMtime: oldest === null ? null : new Date(oldest),
+    };
+};
+exports.inspectSourceSnapshot = inspectSourceSnapshot;
+const dropPercent = (current, previous) => previous > 0 ? ((previous - current) / previous) * 100 : 0;
+class FeedGuard {
+    options;
+    lockFile;
+    constructor(options) {
+        this.options = options;
+    }
+    get lastGoodFile() {
+        return (0, path_1.join)(this.options.stateDir, 'last-good.json');
+    }
+    async readLastGood() {
+        try {
+            return JSON.parse(await fs_1.promises.readFile(this.lastGoodFile, 'utf8'));
+        }
+        catch (error) {
+            if (error?.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async acquireLock(runId, now) {
+        await fs_1.promises.mkdir(this.options.stateDir, { recursive: true });
+        const lockFile = (0, path_1.join)(this.options.stateDir, 'run.lock');
+        const staleMs = (this.options.lockStaleHours ?? 6) * HOUR_MS;
+        try {
+            await fs_1.promises.writeFile(lockFile, JSON.stringify({ runId, startedAt: now.toISOString() }), { flag: 'wx' });
+        }
+        catch (error) {
+            if (error?.code !== 'EEXIST') {
+                throw error;
+            }
+            const { mtimeMs } = await fs_1.promises.stat(lockFile);
+            if (now.getTime() - mtimeMs < staleMs) {
+                throw new FeedGuardError('locked', `another run holds ${lockFile} (since ${new Date(mtimeMs).toISOString()})`);
+            }
+            console.log(`feed-guard: removing stale lock ${lockFile} (${new Date(mtimeMs).toISOString()})`);
+            await fs_1.promises.writeFile(lockFile, JSON.stringify({ runId, startedAt: now.toISOString() }));
+        }
+        this.lockFile = lockFile;
+    }
+    async releaseLock() {
+        if (this.lockFile) {
+            await fs_1.promises.rm(this.lockFile, { force: true });
+            this.lockFile = null;
+        }
+    }
+    checkSource(snapshot, now) {
+        if (!snapshot.files) {
+            throw new FeedGuardError('source_empty', 'base export snapshot has no chunk files');
+        }
+        if (snapshot.missingChunks.length) {
+            throw new FeedGuardError('source_partial', `base export snapshot misses chunk(s) ${snapshot.missingChunks.slice(0, 10).join(', ')}`);
+        }
+        const ageHours = (now.getTime() - snapshot.newestMtime.getTime()) / HOUR_MS;
+        if (ageHours > this.options.maxSourceAgeHours) {
+            throw new FeedGuardError('source_stale', `newest base export chunk is ${ageHours.toFixed(1)} h old (max ${this.options.maxSourceAgeHours} h)`);
+        }
+    }
+    checkCounts(counts, lastGood) {
+        if (counts.sourceItems < this.options.minSourceItems) {
+            throw new FeedGuardError('source_too_small', `${counts.sourceItems} source cars < minimum ${this.options.minSourceItems}`);
+        }
+        if (counts.publishedItems < this.options.minPublishedItems) {
+            throw new FeedGuardError('published_too_small', `${counts.publishedItems} in_stock items < minimum ${this.options.minPublishedItems}`);
+        }
+        if (!lastGood || this.options.acceptDrop) {
+            return;
+        }
+        const sourceDrop = dropPercent(counts.sourceItems, lastGood.sourceItems);
+        const publishedDrop = dropPercent(counts.publishedItems, lastGood.publishedItems);
+        if (sourceDrop > this.options.maxDropPercent || publishedDrop > this.options.maxDropPercent) {
+            throw new FeedGuardError('count_drop', `source ${lastGood.sourceItems} -> ${counts.sourceItems} (-${sourceDrop.toFixed(1)}%), ` +
+                `in_stock ${lastGood.publishedItems} -> ${counts.publishedItems} (-${publishedDrop.toFixed(1)}%), ` +
+                `max ${this.options.maxDropPercent}% — re-run with acceptDrop if the stock really dropped`);
+        }
+    }
+    staleHours(lastGood, now) {
+        return lastGood ? (now.getTime() - Date.parse(lastGood.publishedAt)) / HOUR_MS : null;
+    }
+    isStale(lastGood, now) {
+        const hours = this.staleHours(lastGood, now);
+        return hours !== null && hours > this.options.maxStaleHours;
+    }
+    async publish(tmpFile, finalFile, counts, now, runId) {
+        if ((0, path_1.dirname)(tmpFile) !== (0, path_1.dirname)(finalFile)) {
+            throw new Error(`feed-guard: ${(0, path_1.basename)(tmpFile)} must be in the directory of ${finalFile}`);
+        }
+        try {
+            await fs_1.promises.copyFile(finalFile, `${finalFile}.prev`);
+        }
+        catch (error) {
+            if (error?.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        await fs_1.promises.rename(tmpFile, finalFile);
+        const lastGood = { ...counts, publishedAt: now.toISOString(), file: finalFile, runId };
+        await fs_1.promises.mkdir(this.options.stateDir, { recursive: true });
+        await fs_1.promises.writeFile(`${this.lastGoodFile}.tmp`, JSON.stringify(lastGood, null, 2), 'utf8');
+        await fs_1.promises.rename(`${this.lastGoodFile}.tmp`, this.lastGoodFile);
+        return lastGood;
+    }
+}
+exports.FeedGuard = FeedGuard;
+//# sourceMappingURL=feed-guard.js.map

package/dist/services/feed-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed-guard.js","sourceRoot":"","sources":["../../src/services/feed-guard.ts"],"names":[],"mappings":";;;AAAA,2BAAoC;AACpC,+BAA+C;AAsD/C,MAAa,cAAe,SAAQ,KAAK;IAClB;IAArB,YAAqB,IAAY,EAAE,OAAe;QAChD,KAAK,CAAC,eAAe,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QADtB,SAAI,GAAJ,IAAI,CAAQ;IAEjC,CAAC;CACF;AAJD,wCAIC;AAED,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAGxB,MAAM,qBAAqB,GAAG,KAAK,EAAE,SAAiB,EAAE,YAAoB,EAA2B,EAAE;IAC9G,IAAI,KAAe,CAAC;IACpB,IAAI;QACF,KAAK,GAAG,MAAM,aAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KACrC;IAAC,OAAO,KAAK,EAAE;QACd,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE;YAC5B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SAC9E;QACD,MAAM,KAAK,CAAC;KACb;IACD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,KAAK,EAAE,EAAE,IAAI,CAAC,EAAE;QACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAChB,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACxB;KACF;IACD,IAAI,MAAM,GAAW,IAAI,CAAC;IAC1B,IAAI,MAAM,GAAW,IAAI,CAAC;IAC1B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE;QAC7B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAE,CAAC,IAAI,CAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChE;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,aAAa;QACb,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;QACtD,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;KACvD,CAAC;AACJ,CAAC,CAAC;AAjCW,QAAA,qBAAqB,yBAiChC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,QAAgB,EAAU,EAAE,CAChE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,MAAa,SAAS;IAGS;IAFrB,QAAQ,CAAS;IAEzB,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAI,CAAC;IAE3D,IAAY,YAAY;QACtB,OAAO,IAAA,WAAI,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI;YACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,aAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAa,CAAC;SAC7E;QAAC,OAAO,KAAK,EAAE;YACd,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE;gBAC5B,OAAO,IAAI,CAAC;aACb;YACD,MAAM,KAAK,CAAC;SACb;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,GAAS;QACxC,MAAM,aAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC;QAC7D,IAAI;YACF,MAAM,aAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;SACvG;QAAC,OAAO,KAAK,EAAE;YACd,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE;gBAC5B,MAAM,KAAK,CAAC;aACb;YACD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,GAAG,OAAO,EAAE;gBACrC,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,qBAAqB,QAAQ,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;aAChH;YACD,OAAO,CAAC,GAAG,CAAC,mCAAmC,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YAChG,MAAM,aAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;SACvF;QACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,MAAM,aAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;SACtB;IACH,CAAC;IAED,WAAW,CAAC,QAAwB,EAAE,GAAS;QAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;YACnB,MAAM,IAAI,cAAc,CAAC,cAAc,EAAE,yCAAyC,CAAC,CAAC;SACrF;QACD,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE;YACjC,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,wCAAwC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACtI;QACD,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QAC5E,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;YAC7C,MAAM,IAAI,cAAc,CACtB,cAAc,EACd,+BAA+B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,iBAAiB,KAAK,CACrG,CAAC;SACH;IACH,CAAC;IAED,WAAW,CAAC,MAAkB,EAAE,QAAyB;QACvD,IAAI,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YACpD,MAAM,IAAI,cAAc,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,WAAW,0BAA0B,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;SAC5H;QACD,IAAI,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;YAC1D,MAAM,IAAI,cAAc,CACtB,qBAAqB,EACrB,GAAG,MAAM,CAAC,cAAc,6BAA6B,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CACtF,CAAC;SACH;QACD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YACxC,OAAO;SACR;QACD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzE,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;QAClF,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YAC3F,MAAM,IAAI,cAAc,CACtB,YAAY,EACZ,UAAU,QAAQ,CAAC,WAAW,OAAO,MAAM,CAAC,WAAW,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;gBACxF,YAAY,QAAQ,CAAC,cAAc,OAAO,MAAM,CAAC,cAAc,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;gBACnG,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,wDAAwD,CAC3F,CAAC;SACH;IACH,CAAC;IAED,UAAU,CAAC,QAAyB,EAAE,GAAS;QAC7C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACxF,CAAC;IAED,OAAO,CAAC,QAAyB,EAAE,GAAS;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9D,CAAC;IAGD,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,SAAiB,EAAE,MAAkB,EAAE,GAAS,EAAE,KAAc;QAC7F,IAAI,IAAA,cAAO,EAAC,OAAO,CAAC,KAAK,IAAA,cAAO,EAAC,SAAS,CAAC,EAAE;YAC3C,MAAM,IAAI,KAAK,CAAC,eAAe,IAAA,eAAQ,EAAC,OAAO,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;SAC9F;QACD,IAAI;YACF,MAAM,aAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;SACnD;QAAC,OAAO,KAAK,EAAE;YACd,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE;gBAC5B,MAAM,KAAK,CAAC;aACb;SACF;QACD,MAAM,aAAE,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAa,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACjG,MAAM,aAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,aAAE,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,YAAY,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1F,MAAM,aAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/D,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AApHD,8BAoHC"}

package/dist/services/image-url-validator.service.d.ts

@@ -0,0 +1,45 @@
+export declare enum ImageUrlRejectReason {
+    invalidUrl = "invalid_url",
+    notHttps = "not_https",
+    credentials = "credentials_in_url",
+    placeholder = "placeholder",
+    httpStatus = "http_status",
+    wrongMime = "wrong_mime",
+    tooManyRedirects = "too_many_redirects",
+    timeout = "timeout",
+    networkError = "network_error",
+    budgetExhausted = "budget_exhausted"
+}
+export interface ImageUrlCheck {
+    url: string;
+    ok: boolean;
+    reason?: ImageUrlRejectReason;
+    status?: number;
+    contentType?: string;
+    finalUrl?: string;
+}
+export interface ImageUrlValidatorOptions {
+    allowedMimeTypes?: string[];
+    requireHttps?: boolean;
+    timeoutMs?: number;
+    maxRedirects?: number;
+    concurrency?: number;
+    maxProbes?: number;
+    userAgent?: string;
+}
+export declare class ImageUrlValidator {
+    private readonly options;
+    private readonly limiter;
+    private readonly cache;
+    private readonly counters;
+    private probes;
+    constructor(options?: ImageUrlValidatorOptions);
+    validate(url: string): Promise<ImageUrlCheck>;
+    validateAll(urls: string[]): Promise<ImageUrlCheck[]>;
+    get stats(): Record<string, number>;
+    private check;
+    private checkStatically;
+    private request;
+    private checkResponse;
+    private mapError;
+}

package/dist/services/image-url-validator.service.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageUrlValidator = exports.ImageUrlRejectReason = void 0;
+const axios_1 = require("axios");
+const bottleneck_1 = require("bottleneck");
+var ImageUrlRejectReason;
+(function (ImageUrlRejectReason) {
+    ImageUrlRejectReason["invalidUrl"] = "invalid_url";
+    ImageUrlRejectReason["notHttps"] = "not_https";
+    ImageUrlRejectReason["credentials"] = "credentials_in_url";
+    ImageUrlRejectReason["placeholder"] = "placeholder";
+    ImageUrlRejectReason["httpStatus"] = "http_status";
+    ImageUrlRejectReason["wrongMime"] = "wrong_mime";
+    ImageUrlRejectReason["tooManyRedirects"] = "too_many_redirects";
+    ImageUrlRejectReason["timeout"] = "timeout";
+    ImageUrlRejectReason["networkError"] = "network_error";
+    ImageUrlRejectReason["budgetExhausted"] = "budget_exhausted";
+})(ImageUrlRejectReason || (exports.ImageUrlRejectReason = ImageUrlRejectReason = {}));
+const PLACEHOLDER_PATTERN = /\/carimage\/noimage\//i;
+class ImageUrlValidator {
+    options;
+    limiter;
+    cache = new Map();
+    counters = {};
+    probes = 0;
+    constructor(options = {}) {
+        this.options = {
+            allowedMimeTypes: ['image/jpeg', 'image/png'],
+            requireHttps: true,
+            timeoutMs: 5000,
+            maxRedirects: 3,
+            concurrency: 8,
+            maxProbes: Infinity,
+            userAgent: undefined,
+            ...options,
+        };
+        this.limiter = new bottleneck_1.default({ maxConcurrent: this.options.concurrency });
+    }
+    validate(url) {
+        if (!this.cache.has(url)) {
+            this.cache.set(url, this.check(url).then((result) => {
+                const key = result.ok ? 'ok' : result.reason;
+                this.counters[key] = (this.counters[key] ?? 0) + 1;
+                return result;
+            }));
+        }
+        return this.cache.get(url);
+    }
+    validateAll(urls) {
+        return Promise.all(urls.map(url => this.validate(url)));
+    }
+    get stats() {
+        return { ...this.counters };
+    }
+    async check(url) {
+        const rejected = this.checkStatically(url);
+        if (rejected) {
+            return rejected;
+        }
+        if (this.probes >= this.options.maxProbes) {
+            return { url, ok: false, reason: ImageUrlRejectReason.budgetExhausted };
+        }
+        this.probes++;
+        try {
+            let response = await this.limiter.schedule(() => this.request('HEAD', url));
+            if (response.status === 405 || response.status === 501) {
+                response = await this.limiter.schedule(() => this.request('GET', url));
+            }
+            return this.checkResponse(url, response);
+        }
+        catch (error) {
+            return { url, ok: false, reason: this.mapError(error) };
+        }
+    }
+    checkStatically(url) {
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch {
+            return { url, ok: false, reason: ImageUrlRejectReason.invalidUrl };
+        }
+        if (!['http:', 'https:'].includes(parsed.protocol)) {
+            return { url, ok: false, reason: ImageUrlRejectReason.invalidUrl };
+        }
+        if (this.options.requireHttps && parsed.protocol !== 'https:') {
+            return { url, ok: false, reason: ImageUrlRejectReason.notHttps };
+        }
+        if (parsed.username || parsed.password) {
+            return { url, ok: false, reason: ImageUrlRejectReason.credentials };
+        }
+        if (PLACEHOLDER_PATTERN.test(parsed.pathname)) {
+            return { url, ok: false, reason: ImageUrlRejectReason.placeholder };
+        }
+        return null;
+    }
+    request(method, url) {
+        return axios_1.default.request({
+            method,
+            url,
+            timeout: this.options.timeoutMs,
+            maxRedirects: this.options.maxRedirects,
+            responseType: 'stream',
+            headers: this.options.userAgent ? { 'User-Agent': this.options.userAgent } : undefined,
+            validateStatus: () => true,
+        }).then((response) => {
+            response.data?.destroy?.();
+            return response;
+        });
+    }
+    checkResponse(url, response) {
+        const status = response.status;
+        const contentType = String(response.headers?.['content-type'] ?? '').split(';')[0].trim().toLowerCase();
+        const finalUrl = response.request?.res?.responseUrl ?? url;
+        const result = { url, status, contentType, finalUrl };
+        if (status !== 200) {
+            return { ...result, ok: false, reason: ImageUrlRejectReason.httpStatus };
+        }
+        if (this.options.requireHttps && !finalUrl.startsWith('https:')) {
+            return { ...result, ok: false, reason: ImageUrlRejectReason.notHttps };
+        }
+        if (PLACEHOLDER_PATTERN.test(finalUrl)) {
+            return { ...result, ok: false, reason: ImageUrlRejectReason.placeholder };
+        }
+        if (!this.options.allowedMimeTypes.includes(contentType)) {
+            return { ...result, ok: false, reason: ImageUrlRejectReason.wrongMime };
+        }
+        return { ...result, ok: true };
+    }
+    mapError(error) {
+        if (error?.code === 'ERR_FR_TOO_MANY_REDIRECTS') {
+            return ImageUrlRejectReason.tooManyRedirects;
+        }
+        if (error?.code === 'ECONNABORTED' || error?.code === 'ETIMEDOUT' || /timeout/i.test(error?.message ?? '')) {
+            return ImageUrlRejectReason.timeout;
+        }
+        return ImageUrlRejectReason.networkError;
+    }
+}
+exports.ImageUrlValidator = ImageUrlValidator;
+//# sourceMappingURL=image-url-validator.service.js.map

package/dist/services/image-url-validator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-url-validator.service.js","sourceRoot":"","sources":["../../src/services/image-url-validator.service.ts"],"names":[],"mappings":"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"}

package/dist/services/images.service.d.ts

@@ -5,6 +5,14 @@ import { ConfigService } from './config.service';
 import { UserService } from './user.service';
 import { Config } from '../configs/config';
 import { ImageSize, ImageType } from '../enums';
+export interface CleanImage {
+    url: string;
+    imageIdentifier: string;
+    imageCode: string;
+    heroCandidate: boolean;
+}
+export declare const CLEAN_HERO_IMAGE_CODES: string[];
+export declare const CLEAN_IMAGE_VARIANT = "large-cached.jpeg";
 export declare class ImagesService {
     private readonly configService;
     private readonly userService;
@@ -21,6 +29,10 @@ export declare class ImagesService {
     private categorizeImages;
     getDefaultImages(carId: string, images: ImboImageResponseInterface[], ignoreDefImages: boolean): Array<string>;
     generateImageLinks(images: ImboImageResponseInterface[], carId: string, size?: ImageSize): string[];
+    getCleanImages(carId: string, images: ImboImageResponseInterface[]): CleanImage[];
+    getCleanImageUrls(carId: string, images: ImboImageResponseInterface[]): string[];
+    private isCleanImageCode;
+    private getImageCode;
     getMarketingImages(carId: string, images: ImboImageResponseInterface[], ignoreDefImages: boolean): Promise<string[]>;
     getMetaAiaImage(carId: string, images: ImboImageResponseInterface[], mode: string): Promise<string | null>;
     private imageUrlExists;