aads-cli 1.0.0

package/dist/io/excel-reader.js

@@ -0,0 +1,83 @@
+import ExcelJS from "exceljs";
+import fs from "node:fs";
+import path from "node:path";
+const wildcardToRegExp = (pattern) => {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    const regex = escaped.replace(/\*/g, ".*").replace(/\?/g, ".");
+    return new RegExp(`^${regex}$`, "i");
+};
+export const resolveInputFiles = (inputPattern) => {
+    const normalized = inputPattern.replace(/\\/g, "/");
+    const hasWildcard = /[*?]/.test(normalized);
+    if (!hasWildcard) {
+        return [inputPattern];
+    }
+    const parsed = path.parse(normalized);
+    const dir = parsed.dir || ".";
+    const filePattern = parsed.base;
+    const regex = wildcardToRegExp(filePattern);
+    if (!fs.existsSync(dir)) {
+        throw new Error(`Input directory not found: ${dir}`);
+    }
+    return fs
+        .readdirSync(dir)
+        .filter((name) => regex.test(name))
+        .map((name) => path.join(dir, name))
+        .sort((a, b) => a.localeCompare(b));
+};
+const normalizeCell = (value) => {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (value instanceof Date)
+        return value;
+    if (typeof value === "object" && "text" in value && typeof value.text === "string")
+        return value.text;
+    if (typeof value === "object" && "result" in value)
+        return value.result ?? "";
+    return String(value);
+};
+const readWorksheetAsRows = (worksheet) => {
+    const rows = [];
+    worksheet.eachRow((row) => {
+        const values = row.values;
+        rows.push(values.slice(1).map((value) => (value === undefined ? "" : value)));
+    });
+    if (rows.length === 0) {
+        return { headers: [], rows: [] };
+    }
+    const headers = rows[0].map((h) => String(h ?? "").trim());
+    const dataRows = rows.slice(1).map((cells) => {
+        const item = {};
+        for (let i = 0; i < headers.length; i += 1) {
+            item[headers[i]] = normalizeCell(cells[i]);
+        }
+        return item;
+    });
+    return { headers, rows: dataRows };
+};
+export const readBulkExcelFiles = async (inputPattern) => {
+    const files = resolveInputFiles(inputPattern);
+    if (files.length === 0) {
+        throw new Error(`No input files matched: ${inputPattern}`);
+    }
+    const results = [];
+    for (const file of files) {
+        const workbook = new ExcelJS.Workbook();
+        await workbook.xlsx.readFile(file);
+        for (const worksheet of workbook.worksheets) {
+            const parsed = readWorksheetAsRows(worksheet);
+            if (parsed.headers.length === 0 || parsed.rows.length === 0) {
+                continue;
+            }
+            results.push({
+                sourceFile: `${file}#${worksheet.name}`,
+                headers: parsed.headers,
+                rows: parsed.rows,
+            });
+        }
+    }
+    return results;
+};
+//# sourceMappingURL=excel-reader.js.map

package/dist/io/excel-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-reader.js","sourceRoot":"","sources":["../../src/io/excel-reader.ts"],"names":[],"mappings":"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"}

package/dist/io/excel-writer.d.ts

@@ -0,0 +1,7 @@
+export interface WriteSheetInput {
+    name: string;
+    header: string[];
+    rows: Array<Array<string | number | Date>>;
+}
+export declare const writeXlsx: (outputPath: string, sheets: WriteSheetInput[]) => Promise<void>;
+//# sourceMappingURL=excel-writer.d.ts.map

package/dist/io/excel-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-writer.d.ts","sourceRoot":"","sources":["../../src/io/excel-writer.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC5C;AAmBD,eAAO,MAAM,SAAS,GAAU,YAAY,MAAM,EAAE,QAAQ,eAAe,EAAE,KAAG,OAAO,CAAC,IAAI,CAwB3F,CAAC"}

package/dist/io/excel-writer.js

@@ -0,0 +1,42 @@
+import ExcelJS from "exceljs";
+import fs from "node:fs";
+import path from "node:path";
+const autoFitColumns = (worksheet) => {
+    worksheet.columns?.forEach((column) => {
+        let maxLength = 10;
+        if (!column.eachCell) {
+            return;
+        }
+        column.eachCell({ includeEmpty: true }, (cell) => {
+            const value = cell.value;
+            const cellText = value === null || value === undefined ? "" : String(value);
+            if (cellText.length > maxLength) {
+                maxLength = Math.min(cellText.length + 2, 80);
+            }
+        });
+        column.width = maxLength;
+    });
+};
+export const writeXlsx = async (outputPath, sheets) => {
+    if (sheets.length === 0) {
+        throw new Error("No sheets to write.");
+    }
+    const workbook = new ExcelJS.Workbook();
+    workbook.creator = "aads";
+    workbook.created = new Date();
+    for (const sheet of sheets) {
+        const ws = workbook.addWorksheet(sheet.name);
+        ws.addRow(sheet.header);
+        for (const row of sheet.rows) {
+            ws.addRow(row);
+        }
+        const headerRow = ws.getRow(1);
+        headerRow.font = { bold: true };
+        headerRow.alignment = { vertical: "middle", horizontal: "left" };
+        ws.views = [{ state: "frozen", ySplit: 1 }];
+        autoFitColumns(ws);
+    }
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    await workbook.xlsx.writeFile(outputPath);
+};
+//# sourceMappingURL=excel-writer.js.map

package/dist/io/excel-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-writer.js","sourceRoot":"","sources":["../../src/io/excel-writer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,cAAc,GAAG,CAAC,SAA4B,EAAQ,EAAE;IAC5D,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACpC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;gBAChC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAkB,EAAE,MAAyB,EAAiB,EAAE;IAC9F,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,SAAS,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/B,SAAS,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,SAAS,CAAC,SAAS,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACjE,EAAE,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5C,cAAc,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC,CAAC"}

package/dist/pipeline/analyze-pipeline.d.ts

@@ -0,0 +1,8 @@
+import type { AnalyzePipelineResult } from "./types.js";
+import type { OptimisationConfig } from "../config/optimisation-config.js";
+export interface AnalyzePipelineOptions {
+    layerPolicyPath?: string;
+    rankingDbPath?: string;
+}
+export declare const runAnalyzePipeline: (inputPattern: string, config: OptimisationConfig, options?: AnalyzePipelineOptions) => Promise<AnalyzePipelineResult>;
+//# sourceMappingURL=analyze-pipeline.d.ts.map

package/dist/pipeline/analyze-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/analyze-pipeline.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,qBAAqB,EAA4C,MAAM,YAAY,CAAC;AAClG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAqE3E,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,EACpB,QAAQ,kBAAkB,EAC1B,UAAU,sBAAsB,KAC/B,OAAO,CAAC,qBAAqB,CAwE/B,CAAC"}

package/dist/pipeline/analyze-pipeline.js

@@ -0,0 +1,145 @@
+import path from "node:path";
+import { existsSync } from "node:fs";
+import { createHeaderMap } from "../core/header-mapper.js";
+import { asNumber, normalizeMatchType, normalizeState, normalizeText, safeDivide, toNumber, } from "../core/normalizer.js";
+import { readBulkExcelFiles } from "../io/excel-reader.js";
+import { readCsvFiles } from "../io/csv-reader.js";
+import { analyzePerformance } from "../analysis/performance-analyzer.js";
+import { buildCampaignStructure } from "../analysis/campaign-structure.js";
+import { classifySkus } from "../analysis/sku-classifier.js";
+import { generateCpcRecommendations } from "../analysis/cpc-optimizer.js";
+import { analyzeAutoToManual } from "../analysis/auto-to-manual.js";
+import { classifyCampaignLayers } from "../analysis/campaign-layer-classifier.js";
+import { loadCampaignLayerPolicy } from "../config/campaign-layer-policy.js";
+import { extractDateRangeFromFiles } from "../utils/date-utils.js";
+import { RankingDb } from "../ranking/ranking-db.js";
+const readInputs = async (inputPattern) => {
+    const ext = path.extname(inputPattern).toLowerCase();
+    if (ext === ".csv") {
+        return readCsvFiles(inputPattern);
+    }
+    return readBulkExcelFiles(inputPattern);
+};
+const normalizeRecord = (row, source) => {
+    const map = createHeaderMap(source.headers);
+    const pick = (index) => (index >= 0 ? row[source.headers[index]] : "");
+    const asText = (index) => normalizeText(pick(index));
+    const asNum = (index) => asNumber(pick(index), 0);
+    const asNumOrEmpty = (index) => toNumber(pick(index));
+    const clicks = asNum(map.clicks);
+    const impressions = asNum(map.impressions);
+    const spend = asNum(map.spend);
+    const sales = asNum(map.sales);
+    const orders = asNum(map.orders);
+    const keywordText = asText(map.keywordText);
+    const customerSearchTerm = asText(map.customerSearchTerm);
+    // Infer targetingType as "auto" from product targeting expression auto subtypes
+    const productTargetingExpr = asText(map.productTargetingExpression);
+    const AUTO_SUBTYPES = ["close-match", "loose-match", "substitutes", "complements"];
+    let targetingType = asText(map.targetingType);
+    if (!targetingType && AUTO_SUBTYPES.includes(productTargetingExpr)) {
+        targetingType = "auto";
+    }
+    return {
+        campaignId: asText(map.campaignId),
+        campaignName: asText(map.campaignName),
+        adGroupId: asText(map.adGroupId),
+        adGroupName: asText(map.adGroupName),
+        keywordId: asText(map.keywordId),
+        keywordText,
+        customerSearchTerm,
+        productTargetingExpression: productTargetingExpr,
+        matchType: normalizeMatchType(asText(map.matchType)),
+        targetingType,
+        sku: asText(map.sku),
+        asin: asText(map.asin),
+        portfolioId: asText(map.portfolioId),
+        state: normalizeState(asText(map.state)),
+        campaignStatus: normalizeState(asText(map.state)),
+        dailyBudget: asNumOrEmpty(map.dailyBudget),
+        bid: asNumOrEmpty(map.bid),
+        adGroupDefaultBid: asNumOrEmpty(map.adGroupDefaultBid),
+        clicks,
+        impressions,
+        spend,
+        sales,
+        orders,
+        ctr: safeDivide(clicks, impressions),
+        cvr: safeDivide(orders, clicks),
+        acos: safeDivide(spend, sales),
+        roas: safeDivide(sales, spend),
+        startDate: "",
+        endDate: "",
+        biddingStrategy: "",
+        sourceFile: source.sourceFile,
+    };
+};
+export const runAnalyzePipeline = async (inputPattern, config, options) => {
+    const input = await readInputs(inputPattern);
+    const dateRange = extractDateRangeFromFiles(input.map((i) => i.sourceFile));
+    const records = input
+        .flatMap((file) => file.rows.map((row) => normalizeRecord(row, file)))
+        .filter((row) => row.campaignId !== "" ||
+        row.campaignName !== "" ||
+        row.keywordText !== "" ||
+        row.customerSearchTerm !== "" ||
+        row.productTargetingExpression !== "" ||
+        row.clicks > 0 ||
+        row.impressions > 0 ||
+        row.spend > 0 ||
+        row.sales > 0);
+    // Build SEO ranking data if ranking DB is available
+    let seoRankingData;
+    const rankingDbPath = options?.rankingDbPath ?? process.env.RANKING_DB_PATH;
+    if (rankingDbPath && config.seo.enabled && existsSync(rankingDbPath)) {
+        let rankingDb;
+        try {
+            rankingDb = new RankingDb(rankingDbPath);
+            const adKeywords = [...new Set(records.map((r) => r.keywordText).filter((k) => k !== ""))];
+            const asins = [...new Set(records.map((r) => r.asin).filter((a) => a !== ""))];
+            seoRankingData = rankingDb.buildSeoRankingData(adKeywords, asins, rankingDbPath);
+        }
+        finally {
+            rankingDb?.close();
+        }
+    }
+    const campaignMetrics = analyzePerformance(records);
+    const structure = buildCampaignStructure(records);
+    const skuClassification = classifySkus(records);
+    const cpcRecommendations = generateCpcRecommendations(records, skuClassification, {
+        minClicks: config.minClicksForCpc,
+        targetAcos: config.targetAcos,
+        seoRankingData,
+        seoConfig: config.seo,
+    });
+    const { promotionCandidates, negativeCandidates } = analyzeAutoToManual(records, {
+        minClicks: config.minClicksForPromotion,
+        minCvr: config.minCvrForPromotion,
+        negativeAcosThreshold: config.negativeAcosThreshold,
+    });
+    // Layer classification (optional, skipped if policy not found)
+    let layerClassification;
+    try {
+        const policy = await loadCampaignLayerPolicy(options?.layerPolicyPath);
+        if (policy) {
+            layerClassification = classifyCampaignLayers(campaignMetrics, policy);
+        }
+    }
+    catch {
+        // Policy file invalid or unreadable — skip layer classification silently
+    }
+    return {
+        input,
+        records,
+        dateRange,
+        campaignMetrics,
+        structure,
+        skuClassification,
+        cpcRecommendations,
+        promotionCandidates,
+        negativeCandidates,
+        layerClassification,
+        seoRankingData,
+    };
+};
+//# sourceMappingURL=analyze-pipeline.js.map

package/dist/pipeline/analyze-pipeline.js.map

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

package/dist/pipeline/types.d.ts

@@ -0,0 +1,142 @@
+import type { CampaignLayerClassification } from "../analysis/campaign-layer-classifier.js";
+import type { SeoRankingData } from "../ranking/types.js";
+export type RowValue = string | number | boolean | Date | null | undefined;
+export type DataRow = Record<string, RowValue>;
+export type OutputFormat = "console" | "json" | "markdown" | "xlsx";
+export interface BulkInputData {
+    sourceFile: string;
+    headers: string[];
+    rows: DataRow[];
+}
+export interface NormalizedRecord {
+    campaignId: string;
+    campaignName: string;
+    adGroupId: string;
+    adGroupName: string;
+    keywordId: string;
+    keywordText: string;
+    customerSearchTerm: string;
+    productTargetingExpression: string;
+    matchType: string;
+    targetingType: string;
+    sku: string;
+    asin: string;
+    portfolioId: string;
+    state: string;
+    campaignStatus: string;
+    dailyBudget: number | "";
+    bid: number | "";
+    adGroupDefaultBid: number | "";
+    clicks: number;
+    impressions: number;
+    spend: number;
+    sales: number;
+    orders: number;
+    ctr: number;
+    cvr: number;
+    acos: number;
+    roas: number;
+    startDate: string;
+    endDate: string;
+    biddingStrategy: string;
+    sourceFile: string;
+}
+export interface CampaignMetrics {
+    campaignId: string;
+    campaignName: string;
+    targetingType: string;
+    state: string;
+    clicks: number;
+    impressions: number;
+    spend: number;
+    sales: number;
+    orders: number;
+    ctr: number;
+    cvr: number;
+    acos: number;
+    roas: number;
+    dailyBudget: number | "";
+}
+export interface CampaignStructureNode {
+    campaignId: string;
+    campaignName: string;
+    adGroups: Array<{
+        adGroupId: string;
+        adGroupName: string;
+        keywordCount: number;
+        productTargetCount: number;
+        spend: number;
+        sales: number;
+        acos: number;
+    }>;
+}
+export type SkuLabel = "focus" | "nurture" | "improve" | "prune";
+export interface SkuClassification {
+    sku: string;
+    label: SkuLabel;
+    bidAdjust: number;
+    budgetAdjust: number;
+    reason: string;
+}
+export interface CpcRecommendation {
+    campaignId: string;
+    campaignName: string;
+    adGroupId: string;
+    adGroupName: string;
+    keywordId: string;
+    keywordText: string;
+    matchType: string;
+    sku: string;
+    clicks: number;
+    avgCpc: number;
+    currentBid: number;
+    recommendedBid: number;
+    bidAdjust: number;
+    reason: string;
+    seoFactor?: number;
+    organicPosition?: number | null;
+    seoReason?: string;
+}
+export interface PromotionCandidate {
+    campaignId: string;
+    campaignName: string;
+    adGroupId: string;
+    adGroupName: string;
+    keywordText: string;
+    matchType: string;
+    sku: string;
+    clicks: number;
+    spend: number;
+    orders: number;
+    cvr: number;
+    avgCpc: number;
+    recommendedBid: number;
+    recommendedAdGroupName: string;
+}
+export interface NegativeCandidate {
+    campaignId: string;
+    campaignName: string;
+    adGroupId: string;
+    adGroupName: string;
+    keywordText: string;
+    matchType: string;
+    reason: string;
+}
+export interface AnalyzePipelineResult {
+    input: BulkInputData[];
+    records: NormalizedRecord[];
+    dateRange: {
+        startDate: string;
+        endDate: string;
+        days: number;
+    } | null;
+    campaignMetrics: CampaignMetrics[];
+    structure: CampaignStructureNode[];
+    skuClassification: SkuClassification[];
+    cpcRecommendations: CpcRecommendation[];
+    promotionCandidates: PromotionCandidate[];
+    negativeCandidates: NegativeCandidate[];
+    layerClassification?: CampaignLayerClassification[];
+    seoRankingData?: SeoRankingData;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":""}

package/dist/ranking/keyword-matcher.d.ts

@@ -0,0 +1,10 @@
+import type { KeywordMapping } from "./types.js";
+export declare const normalizeKeyword: (text: string) => string;
+export interface KeywordMatchResult {
+    adKeyword: string;
+    rankingKeyword: string;
+    normalizedKey: string;
+    source: "exact" | "normalized" | "mapping";
+}
+export declare const matchKeywords: (adKeywords: string[], rankingKeywords: string[], mappings?: KeywordMapping[]) => KeywordMatchResult[];
+//# sourceMappingURL=keyword-matcher.d.ts.map

package/dist/ranking/keyword-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-matcher.d.ts","sourceRoot":"","sources":["../../src/ranking/keyword-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAE/C,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;CAC5C;AAED,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,EAAE,EACpB,iBAAiB,MAAM,EAAE,EACzB,WAAW,cAAc,EAAE,KAC1B,kBAAkB,EA2CpB,CAAC"}

package/dist/ranking/keyword-matcher.js

@@ -0,0 +1,62 @@
+// Full-width to half-width conversion table for ASCII range (U+FF01..U+FF5E -> U+0021..U+007E)
+const FULLWIDTH_OFFSET = 0xff01 - 0x0021;
+const toHalfWidth = (text) => {
+    let result = "";
+    for (const ch of text) {
+        const code = ch.codePointAt(0);
+        if (code >= 0xff01 && code <= 0xff5e) {
+            result += String.fromCodePoint(code - FULLWIDTH_OFFSET);
+        }
+        else if (code === 0x3000) {
+            // Ideographic space -> ASCII space
+            result += " ";
+        }
+        else {
+            result += ch;
+        }
+    }
+    return result;
+};
+export const normalizeKeyword = (text) => {
+    return toHalfWidth(text).toLowerCase().replace(/\s+/g, " ").trim();
+};
+export const matchKeywords = (adKeywords, rankingKeywords, mappings) => {
+    const results = [];
+    const rankingNormMap = new Map();
+    for (const rk of rankingKeywords) {
+        rankingNormMap.set(normalizeKeyword(rk), rk);
+    }
+    // Build manual mapping lookup (adKeyword normalized -> rankingKeyword)
+    const manualMap = new Map();
+    if (mappings) {
+        for (const m of mappings) {
+            manualMap.set(normalizeKeyword(m.adKeyword), m.rankingKeyword);
+        }
+    }
+    for (const adKw of adKeywords) {
+        const normAd = normalizeKeyword(adKw);
+        // 1. Manual mapping takes priority
+        const mappedRanking = manualMap.get(normAd);
+        if (mappedRanking) {
+            results.push({
+                adKeyword: adKw,
+                rankingKeyword: mappedRanking,
+                normalizedKey: normalizeKeyword(mappedRanking),
+                source: "mapping",
+            });
+            continue;
+        }
+        // 2. Normalized match
+        const exactRanking = rankingNormMap.get(normAd);
+        if (exactRanking) {
+            results.push({
+                adKeyword: adKw,
+                rankingKeyword: exactRanking,
+                normalizedKey: normAd,
+                source: "normalized",
+            });
+        }
+    }
+    return results;
+};
+//# sourceMappingURL=keyword-matcher.js.map

package/dist/ranking/keyword-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-matcher.js","sourceRoot":"","sources":["../../src/ranking/keyword-matcher.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE;IAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAChC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,mCAAmC;YACnC,MAAM,IAAI,GAAG,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE;IACvD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC,CAAC;AASF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,UAAoB,EACpB,eAAyB,EACzB,QAA2B,EACL,EAAE;IACxB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;QACjC,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,uEAAuE;IACvE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEtC,mCAAmC;QACnC,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,IAAI;gBACf,cAAc,EAAE,aAAa;gBAC7B,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAC;gBAC9C,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,sBAAsB;QACtB,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,IAAI;gBACf,cAAc,EAAE,YAAY;gBAC5B,aAAa,EAAE,MAAM;gBACrB,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/ranking/ranking-db.d.ts

@@ -0,0 +1,14 @@
+import type { KeywordRankingInfo, SeoRankingData } from "./types.js";
+export declare class RankingDb {
+    private db;
+    constructor(dbPath: string);
+    getOrganicPosition(keyword: string, asin: string): number | null;
+    getSponsoredPosition(keyword: string, asin: string): number | null;
+    getLatestRanking(keyword: string, asin: string): KeywordRankingInfo;
+    getTrackedKeywords(): string[];
+    getTrackedAsins(): string[];
+    getLatestSnapshotDate(): string;
+    buildSeoRankingData(adKeywords: string[], asins: string[], dbPath: string): SeoRankingData;
+    close(): void;
+}
+//# sourceMappingURL=ranking-db.d.ts.map

package/dist/ranking/ranking-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-db.d.ts","sourceRoot":"","sources":["../../src/ranking/ranking-db.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBrE,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAK1B,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAahE,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAalE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB;IAgCnE,kBAAkB,IAAI,MAAM,EAAE;IAM9B,eAAe,IAAI,MAAM,EAAE;IAM3B,qBAAqB,IAAI,MAAM;IAQ/B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAiC1F,KAAK,IAAI,IAAI;CAGd"}