docs-combiner 0.4.0 → 1.0.0

package/dist/agentApi/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/agentApi/validation.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentValidation = buildAgentValidation;
+const escalation_1 = require("./escalation");
+const generatedPairsGuard_1 = require("./generatedPairsGuard");
+function buildAgentValidation(input) {
+    var _a;
+    const checks = [
+        { id: 'googleAuth', ok: input.hasGoogleAuth, message: 'Google Drive auth is required.' },
+        { id: 'openRouterKey', ok: input.hasOpenRouterKey, message: 'OpenRouter API key is required.' },
+        { id: 'driveFolder', ok: input.hasDriveFolder, message: 'Working Drive folder is required.' },
+        { id: 'product', ok: Boolean(input.product.trim()), message: 'Product is required.' },
+        { id: 'geoBlock', ok: input.hasGeo, message: 'At least one geo row is required.' },
+        {
+            id: 'creativeSelections',
+            ok: input.textApproachCount >= 2 && input.imageApproachCounts.some(count => count > 0),
+            message: 'Text and image creative selections are required.',
+        },
+    ];
+    if ((_a = input.incompletePairs) === null || _a === void 0 ? void 0 : _a.length) {
+        checks.push({
+            id: 'generatedPairsComplete',
+            ok: false,
+            message: `Generated title/text pairs are incomplete — ${(0, generatedPairsGuard_1.buildIncompletePairsValidationMessage)(input.incompletePairs)}. Regenerate pairs before catalog export.`,
+        });
+    }
+    const hints = input.mappedOfferFromCsv
+        ? []
+        : ['Offer is not bound in campaigns.csv yet — bind via setup-campaign or UI selector.'];
+    const escalation = (0, escalation_1.buildValidationEscalation)({ blocking: checks.filter(check => !check.ok), hints });
+    return Object.assign({ ok: checks.every(check => check.ok), checks, blocking: checks.filter(check => !check.ok), hints }, (escalation ? { escalation } : {}));
+}

package/dist/campaignsCsv.js

@@ -0,0 +1,420 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAMPAIGN_CSV_ADDITIONAL_INFO_OVERRIDE_HEADER = exports.CAMPAIGN_CSV_PRODUCT_OVERRIDE_HEADER = exports.CAMPAIGNS_CSV_FILENAME = void 0;
+exports.parseCampaignsCsvText = parseCampaignsCsvText;
+exports.findCampaignRowForFolder = findCampaignRowForFolder;
+exports.findOfferForCampaign = findOfferForCampaign;
+exports.computeCampaignDescriptionOverrides = computeCampaignDescriptionOverrides;
+exports.campaignDescriptionOverridesEqual = campaignDescriptionOverridesEqual;
+exports.campaignDescriptionOverridesFromRow = campaignDescriptionOverridesFromRow;
+exports.uniqueOffersFromRows = uniqueOffersFromRows;
+exports.upsertCampaignOfferInCsvText = upsertCampaignOfferInCsvText;
+exports.upsertCampaignDescriptionOverridesInCsvText = upsertCampaignDescriptionOverridesInCsvText;
+exports.removeCampaignFromCsvText = removeCampaignFromCsvText;
+const XLSX = __importStar(require("xlsx"));
+exports.CAMPAIGNS_CSV_FILENAME = 'campaigns.csv';
+const normalizeCell = (value) => String(value !== null && value !== void 0 ? value : '').trim();
+const normalizeKey = (value) => value.trim().toLowerCase();
+const CAMPAIGN_HEADER_ALIASES = new Set([
+    'campaign',
+    'campaign_folder_id',
+    'campaign_id',
+    'campaign_path',
+    'folder_id',
+    'drive_folder_id',
+    'кампания',
+    'папка',
+    'папка_кампании',
+]);
+const OFFER_HEADER_ALIASES = new Set([
+    'offer',
+    'offer_folder',
+    'offer_name',
+    'offer_id',
+    'оффер',
+    'оффер_папка',
+]);
+const PRODUCT_OVERRIDE_HEADER_ALIASES = new Set([
+    'offer_product_override',
+    'product_override',
+    'offer_product',
+    'product_description_override',
+    'товар',
+    'описание_товара',
+]);
+const ADDITIONAL_INFO_OVERRIDE_HEADER_ALIASES = new Set([
+    'offer_additional_info_override',
+    'additional_info_override',
+    'offer_additional_info',
+    'additional_info',
+    'доп_информация',
+    'дополнительная_информация',
+]);
+exports.CAMPAIGN_CSV_PRODUCT_OVERRIDE_HEADER = 'offer_product_override';
+exports.CAMPAIGN_CSV_ADDITIONAL_INFO_OVERRIDE_HEADER = 'offer_additional_info_override';
+const normalizeHeader = (header) => normalizeKey(String(header !== null && header !== void 0 ? header : ''))
+    .replace(/\s+/g, '_')
+    .replace(/[^\wа-яё]+/gi, '_')
+    .replace(/_+/g, '_')
+    .replace(/^_|_$/g, '');
+const isCampaignHeader = (header) => CAMPAIGN_HEADER_ALIASES.has(header);
+const isOfferHeader = (header) => OFFER_HEADER_ALIASES.has(header);
+const isProductOverrideHeader = (header) => PRODUCT_OVERRIDE_HEADER_ALIASES.has(header);
+const isAdditionalInfoOverrideHeader = (header) => ADDITIONAL_INFO_OVERRIDE_HEADER_ALIASES.has(header);
+/** Парсит campaigns.csv (текст файла). Первая строка — заголовки. */
+function parseCampaignsCsvText(text) {
+    const errors = [];
+    const trimmed = text.trim();
+    if (!trimmed) {
+        return { rows: [], errors: ['Файл campaigns.csv пустой'] };
+    }
+    try {
+        const workbook = XLSX.read(trimmed, { type: 'string' });
+        const sheetName = workbook.SheetNames[0];
+        if (!sheetName) {
+            return { rows: [], errors: ['В campaigns.csv нет листа'] };
+        }
+        const sheet = workbook.Sheets[sheetName];
+        const matrix = XLSX.utils.sheet_to_json(sheet, {
+            header: 1,
+            defval: '',
+            raw: false,
+        });
+        if (!matrix.length) {
+            return { rows: [], errors: ['В campaigns.csv нет строк'] };
+        }
+        const headerRow = matrix[0].map(normalizeHeader);
+        const campaignCols = [];
+        let offerCol = -1;
+        let productOverrideCol = -1;
+        let additionalInfoOverrideCol = -1;
+        headerRow.forEach((header, index) => {
+            if (!header)
+                return;
+            if (isOfferHeader(header))
+                offerCol = index;
+            else if (isProductOverrideHeader(header))
+                productOverrideCol = index;
+            else if (isAdditionalInfoOverrideHeader(header))
+                additionalInfoOverrideCol = index;
+            else if (isCampaignHeader(header))
+                campaignCols.push(index);
+        });
+        if (offerCol < 0) {
+            return {
+                rows: [],
+                errors: [
+                    'Не найдена колонка оффера (offer / offer_folder / оффер). Добавьте заголовок в первую строку.',
+                ],
+            };
+        }
+        if (campaignCols.length === 0) {
+            return {
+                rows: [],
+                errors: [
+                    'Не найдена колонка кампании (campaign / campaign_folder_id / кампания). Добавьте заголовок в первую строку.',
+                ],
+            };
+        }
+        const rows = [];
+        for (let i = 1; i < matrix.length; i++) {
+            const row = matrix[i] || [];
+            const offer = normalizeCell(row[offerCol]);
+            if (!offer)
+                continue;
+            const matchValues = campaignCols
+                .map(colIndex => normalizeCell(row[colIndex]))
+                .filter(Boolean);
+            if (matchValues.length === 0)
+                continue;
+            rows.push({
+                offer,
+                matchValues,
+                productOverride: productOverrideCol >= 0 ? normalizeCell(row[productOverrideCol]) || undefined : undefined,
+                additionalInfoOverride: additionalInfoOverrideCol >= 0
+                    ? normalizeCell(row[additionalInfoOverrideCol]) || undefined
+                    : undefined,
+            });
+        }
+        if (rows.length === 0) {
+            errors.push('Нет данных: заполните строки с кампанией и оффером');
+        }
+        return { rows, errors };
+    }
+    catch (err) {
+        return { rows: [], errors: [`Ошибка разбора campaigns.csv: ${String(err)}`] };
+    }
+}
+const matchesCampaignValue = (needle, input) => {
+    const key = normalizeKey(needle);
+    if (!key)
+        return false;
+    const folderId = normalizeKey(input.folderId);
+    const folderName = normalizeKey(input.folderName);
+    const displayPath = normalizeKey(input.displayPath);
+    if (folderId && key === folderId)
+        return true;
+    if (folderName && key === folderName)
+        return true;
+    if (displayPath && key === displayPath)
+        return true;
+    if (displayPath && folderName && key === folderName && displayPath.endsWith(`/${folderName}`)) {
+        return true;
+    }
+    if (displayPath.includes('/')) {
+        const suffix = displayPath.split('/').pop() || '';
+        if (suffix && key === suffix)
+            return true;
+    }
+    return false;
+};
+const findCampaignRowIndexInRows = (rows, input) => {
+    if (!input.folderId.trim() && !input.folderName.trim() && !input.displayPath.trim()) {
+        return -1;
+    }
+    return rows.findIndex(row => row.matchValues.some(value => matchesCampaignValue(value, input)));
+};
+/** Находит строку campaigns.csv для рабочей папки кампании. */
+function findCampaignRowForFolder(rows, input) {
+    const index = findCampaignRowIndexInRows(rows, input);
+    return index >= 0 ? rows[index] : null;
+}
+/** Находит оффер для рабочей папки кампании по таблице campaigns.csv. */
+function findOfferForCampaign(rows, input) {
+    var _a, _b;
+    return (_b = (_a = findCampaignRowForFolder(rows, input)) === null || _a === void 0 ? void 0 : _a.offer) !== null && _b !== void 0 ? _b : null;
+}
+/** Вычисляет, что писать в campaigns.csv как оверрайды относительно offer-settings. */
+function computeCampaignDescriptionOverrides(product, additionalInfo, baseline) {
+    const productTrimmed = product.trim();
+    const additionalInfoTrimmed = additionalInfo.trim();
+    const baselineProduct = baseline.generateProduct.trim();
+    const baselineAdditionalInfo = baseline.generateAdditionalInfo.trim();
+    return {
+        productOverride: productTrimmed === baselineProduct ? '' : productTrimmed,
+        additionalInfoOverride: additionalInfoTrimmed === baselineAdditionalInfo ? '' : additionalInfoTrimmed,
+    };
+}
+function campaignDescriptionOverridesEqual(a, b) {
+    return (a.productOverride === b.productOverride &&
+        a.additionalInfoOverride === b.additionalInfoOverride);
+}
+function campaignDescriptionOverridesFromRow(row) {
+    var _a, _b, _c, _d;
+    return {
+        productOverride: (_b = (_a = row === null || row === void 0 ? void 0 : row.productOverride) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : '',
+        additionalInfoOverride: (_d = (_c = row === null || row === void 0 ? void 0 : row.additionalInfoOverride) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : '',
+    };
+}
+/** Уникальные имена офферов из таблицы (порядок сохраняется). */
+function uniqueOffersFromRows(rows) {
+    const seen = new Set();
+    const result = [];
+    for (const row of rows) {
+        const key = normalizeKey(row.offer);
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(row.offer);
+    }
+    return result;
+}
+const DEFAULT_CAMPAIGNS_CSV_HEADERS = ['campaign_folder_id', 'offer'];
+const parseCsvMatrix = (text) => {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        return {
+            parsed: {
+                matrix: [DEFAULT_CAMPAIGNS_CSV_HEADERS],
+                headerRow: DEFAULT_CAMPAIGNS_CSV_HEADERS.map(normalizeHeader),
+                campaignCols: [0],
+                offerCol: 1,
+                campaignFolderIdCol: 0,
+                productOverrideCol: -1,
+                additionalInfoOverrideCol: -1,
+            },
+        };
+    }
+    try {
+        const workbook = XLSX.read(trimmed, { type: 'string' });
+        const sheetName = workbook.SheetNames[0];
+        if (!sheetName)
+            return { errors: ['В campaigns.csv нет листа'] };
+        const sheet = workbook.Sheets[sheetName];
+        const matrix = XLSX.utils.sheet_to_json(sheet, {
+            header: 1,
+            defval: '',
+            raw: false,
+        });
+        if (!matrix.length)
+            return { errors: ['В campaigns.csv нет строк'] };
+        const headerRow = matrix[0].map(normalizeHeader);
+        const campaignCols = [];
+        let offerCol = -1;
+        let productOverrideCol = -1;
+        let additionalInfoOverrideCol = -1;
+        headerRow.forEach((header, index) => {
+            if (!header)
+                return;
+            if (isOfferHeader(header))
+                offerCol = index;
+            else if (isProductOverrideHeader(header))
+                productOverrideCol = index;
+            else if (isAdditionalInfoOverrideHeader(header))
+                additionalInfoOverrideCol = index;
+            else if (isCampaignHeader(header))
+                campaignCols.push(index);
+        });
+        if (offerCol < 0 || campaignCols.length === 0) {
+            return { errors: ['Некорректные заголовки campaigns.csv'] };
+        }
+        const campaignFolderIdCol = headerRow.findIndex(h => h === 'campaign_folder_id') >= 0
+            ? headerRow.findIndex(h => h === 'campaign_folder_id')
+            : campaignCols[0];
+        return {
+            parsed: {
+                matrix,
+                headerRow,
+                campaignCols,
+                offerCol,
+                campaignFolderIdCol,
+                productOverrideCol,
+                additionalInfoOverrideCol,
+            },
+        };
+    }
+    catch (err) {
+        return { errors: [`Ошибка разбора campaigns.csv: ${String(err)}`] };
+    }
+};
+const serializeCsvMatrix = (matrix) => {
+    const sheet = XLSX.utils.aoa_to_sheet(matrix);
+    const workbook = XLSX.utils.book_new();
+    XLSX.utils.book_append_sheet(workbook, sheet, 'campaigns');
+    return XLSX.write(workbook, { type: 'string', bookType: 'csv' });
+};
+const ensureMatrixColumn = (matrix, headerRow, headerLabel, normalizedHeader) => {
+    let colIndex = headerRow.findIndex(header => header === normalizedHeader);
+    if (colIndex >= 0)
+        return colIndex;
+    colIndex = matrix[0].length;
+    matrix[0].push(headerLabel);
+    headerRow.push(normalizedHeader);
+    for (let i = 1; i < matrix.length; i++) {
+        const row = matrix[i] || [];
+        while (row.length < matrix[0].length)
+            row.push('');
+        matrix[i] = row;
+    }
+    return colIndex;
+};
+const findCampaignRowIndex = (matrix, campaignCols, campaignFolderId) => {
+    const folderKey = normalizeKey(campaignFolderId);
+    for (let i = 1; i < matrix.length; i++) {
+        const row = matrix[i] || [];
+        const matched = campaignCols.some(colIndex => normalizeKey(normalizeCell(row[colIndex])) === folderKey);
+        if (matched)
+            return i;
+    }
+    return -1;
+};
+/** Добавить или обновить привязку кампании к офферу в тексте campaigns.csv. */
+function upsertCampaignOfferInCsvText(existingText, campaignFolderId, offer) {
+    const campaignId = normalizeCell(campaignFolderId);
+    const offerName = normalizeCell(offer);
+    if (!campaignId)
+        return { csvText: existingText || '', errors: ['Пустой ID рабочей папки'] };
+    if (!offerName)
+        return { csvText: existingText || '', errors: ['Пустое имя оффера'] };
+    const parsedResult = parseCsvMatrix(existingText || '');
+    if ('errors' in parsedResult) {
+        return { csvText: existingText || '', errors: parsedResult.errors };
+    }
+    const { matrix, campaignCols, offerCol, campaignFolderIdCol } = parsedResult.parsed;
+    const rowIndex = findCampaignRowIndex(matrix, campaignCols, campaignId);
+    if (rowIndex >= 0) {
+        matrix[rowIndex][offerCol] = offerName;
+        matrix[rowIndex][campaignFolderIdCol] = campaignId;
+    }
+    else {
+        const newRow = new Array(matrix[0].length).fill('');
+        newRow[campaignFolderIdCol] = campaignId;
+        newRow[offerCol] = offerName;
+        matrix.push(newRow);
+    }
+    return { csvText: serializeCsvMatrix(matrix), errors: [] };
+}
+/** Обновить оверрайды описания оффера для кампании в campaigns.csv. */
+function upsertCampaignDescriptionOverridesInCsvText(existingText, campaignFolderId, overrides) {
+    const campaignId = normalizeCell(campaignFolderId);
+    if (!campaignId)
+        return { csvText: existingText || '', errors: ['Пустой ID рабочей папки'] };
+    const parsedResult = parseCsvMatrix(existingText || '');
+    if ('errors' in parsedResult) {
+        return { csvText: existingText || '', errors: parsedResult.errors };
+    }
+    const { matrix, headerRow, campaignCols } = parsedResult.parsed;
+    const rowIndex = findCampaignRowIndex(matrix, campaignCols, campaignId);
+    if (rowIndex < 0) {
+        return {
+            csvText: existingText || '',
+            errors: ['В campaigns.csv нет строки для этой рабочей папки — сначала выберите оффер'],
+        };
+    }
+    const productOverrideCol = ensureMatrixColumn(matrix, headerRow, exports.CAMPAIGN_CSV_PRODUCT_OVERRIDE_HEADER, normalizeHeader(exports.CAMPAIGN_CSV_PRODUCT_OVERRIDE_HEADER));
+    const additionalInfoOverrideCol = ensureMatrixColumn(matrix, headerRow, exports.CAMPAIGN_CSV_ADDITIONAL_INFO_OVERRIDE_HEADER, normalizeHeader(exports.CAMPAIGN_CSV_ADDITIONAL_INFO_OVERRIDE_HEADER));
+    matrix[rowIndex][productOverrideCol] = overrides.productOverride;
+    matrix[rowIndex][additionalInfoOverrideCol] = overrides.additionalInfoOverride;
+    return { csvText: serializeCsvMatrix(matrix), errors: [] };
+}
+/** Удалить привязку кампании из campaigns.csv. */
+function removeCampaignFromCsvText(existingText, campaignFolderId) {
+    const campaignId = normalizeCell(campaignFolderId);
+    if (!campaignId)
+        return { csvText: existingText, errors: ['Пустой ID рабочей папки'] };
+    const parsedResult = parseCsvMatrix(existingText);
+    if ('errors' in parsedResult) {
+        return { csvText: existingText, errors: parsedResult.errors };
+    }
+    const { matrix, campaignCols } = parsedResult.parsed;
+    const rowIndex = findCampaignRowIndex(matrix, campaignCols, campaignId);
+    if (rowIndex < 0) {
+        return { csvText: existingText, errors: [] };
+    }
+    matrix.splice(rowIndex, 1);
+    return { csvText: serializeCsvMatrix(matrix), errors: [] };
+}
+;

package/dist/contentPairs.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePairsFromModelContent = parsePairsFromModelContent;
+exports.summarizePairParseResult = summarizePairParseResult;
+/**
+ * Разбор строк «ЗАГОЛОВОК n:» / «ТЕКСТ n:» из ответа модели.
+ * Иногда модель пишет ZAGОЛОВОК (латиница ZAG + кириллица ОЛОВОК) или ZAGOLOVOK — без этого парсер не видит заголовки.
+ */
+const PAIRS_TITLE_LINE_RE = /^[\s\uFEFF]*(?:\*{1,2})?\s*(?:ЗАГОЛОВОК|ZAG[ОOо][ЛLl][ОOо][ВBb][ОOо][КKk]|ZAGOLOVOK)\s+(\d+)\s*:\s*(.+)$/iu;
+const PAIRS_TEXT_LINE_RE = /^[\s\uFEFF]*(?:\*{1,2})?\s*(?:ТЕКСТ|TEKST)\s+(\d+)\s*:\s*(.*)$/iu;
+function parsePairsFromModelContent(content, count) {
+    const titleMap = {};
+    const textMap = {};
+    let currentTextNum = -1;
+    const currentTextLines = [];
+    const lines = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    for (const rawLine of lines) {
+        const trimmed = rawLine.trim();
+        const titleMatch = trimmed.match(PAIRS_TITLE_LINE_RE);
+        if (titleMatch) {
+            if (currentTextNum > 0) {
+                textMap[currentTextNum] = currentTextLines.join('\n').trim();
+                currentTextLines.length = 0;
+                currentTextNum = -1;
+            }
+            titleMap[parseInt(titleMatch[1], 10)] = titleMatch[2].trim();
+            continue;
+        }
+        const textMatch = trimmed.match(PAIRS_TEXT_LINE_RE);
+        if (textMatch) {
+            if (currentTextNum > 0) {
+                textMap[currentTextNum] = currentTextLines.join('\n').trim();
+                currentTextLines.length = 0;
+            }
+            currentTextNum = parseInt(textMatch[1], 10);
+            if (textMatch[2].trim())
+                currentTextLines.push(textMatch[2].trim());
+            continue;
+        }
+        if (currentTextNum > 0 && trimmed.length > 0) {
+            currentTextLines.push(trimmed);
+        }
+    }
+    if (currentTextNum > 0) {
+        textMap[currentTextNum] = currentTextLines.join('\n').trim();
+    }
+    const pairs = Array.from({ length: count }, (_, i) => ({
+        title: titleMap[i + 1] || '',
+        text: textMap[i + 1] || '',
+    }));
+    return { pairs, titleMap, textMap };
+}
+function summarizePairParseResult(parsed, count) {
+    var _a, _b;
+    const lines = [];
+    for (let i = 1; i <= count; i++) {
+        const title = ((_a = parsed.titleMap[i]) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+        const text = ((_b = parsed.textMap[i]) === null || _b === void 0 ? void 0 : _b.trim()) || '';
+        lines.push(`Пара ${i}: заголовок=${title ? `OK (${title.length} симв.)` : 'НЕ НАЙДЕН'}, текст=${text ? `OK (${text.length} симв.)` : 'НЕ НАЙДЕН'}`);
+    }
+    return lines.join('\n');
+}

package/dist/flexcardBalance.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * FlexCard — `GET /api/v1/finance/accounts/` с `X-API-Key`.
+ * Суммируем только поле `balance` (строка или число) по строкам с `currency` === USD.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLEXCARD_FINANCE_ACCOUNTS_URL = void 0;
+exports.fetchFlexCardFinanceAccountsUsdTotal = fetchFlexCardFinanceAccountsUsdTotal;
+const httpTimeout_1 = require("./integrations/httpTimeout");
+exports.FLEXCARD_FINANCE_ACCOUNTS_URL = 'https://flexcard.cards/api/v1/finance/accounts/';
+function num(v) {
+    if (typeof v === 'number' && !Number.isNaN(v))
+        return v;
+    const n = parseFloat(String(v));
+    return Number.isFinite(n) ? n : 0;
+}
+function fetchPaginatedResults(apiKey, initialUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const trimmed = apiKey.trim();
+        const out = [];
+        let url = initialUrl;
+        for (let page = 0; page < 50 && url; page++) {
+            const res = yield (0, httpTimeout_1.fetchWithTimeout)(url, {
+                method: 'GET',
+                headers: {
+                    'X-API-Key': trimmed,
+                    Accept: 'application/json',
+                },
+            });
+            if (!res.ok)
+                return null;
+            const data = (yield res.json());
+            let batch;
+            let next;
+            if (Array.isArray(data)) {
+                batch = data;
+                next = null;
+            }
+            else if (data && typeof data === 'object') {
+                const o = data;
+                const r = o.results;
+                batch = Array.isArray(r) ? r : [];
+                next = (_a = o.next) !== null && _a !== void 0 ? _a : null;
+                if (!Array.isArray(r))
+                    return null;
+            }
+            else {
+                return null;
+            }
+            out.push(...batch);
+            url = next !== null && next !== void 0 ? next : null;
+        }
+        return out;
+    });
+}
+/** Сумма `balance` по всем счетам с валютой USD. */
+function fetchFlexCardFinanceAccountsUsdTotal(apiKey) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const trimmed = apiKey.trim();
+        if (!trimmed)
+            return null;
+        const rows = yield fetchPaginatedResults(trimmed, exports.FLEXCARD_FINANCE_ACCOUNTS_URL);
+        if (rows === null)
+            return null;
+        let sum = 0;
+        for (const raw of rows) {
+            if (!raw || typeof raw !== 'object')
+                continue;
+            const r = raw;
+            const cur = String((_a = r.currency) !== null && _a !== void 0 ? _a : '').toUpperCase();
+            if (cur !== 'USD' && cur !== 'US')
+                continue;
+            sum += num(r.balance);
+        }
+        return sum;
+    });
+}