aads-cli 1.0.0

package/dist/ranking/ranking-db.js

@@ -0,0 +1,97 @@
+import Database from "better-sqlite3";
+import { normalizeKeyword } from "./keyword-matcher.js";
+export class RankingDb {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath, { readonly: true });
+        this.db.pragma("journal_mode = WAL");
+    }
+    getOrganicPosition(keyword, asin) {
+        const row = this.db
+            .prepare(`SELECT position FROM ranking_history
+         WHERE keyword = ? AND asin = ? AND is_sponsored = 0
+         ORDER BY timestamp DESC
+         LIMIT 1`)
+            .get(keyword, asin);
+        return row?.position ?? null;
+    }
+    getSponsoredPosition(keyword, asin) {
+        const row = this.db
+            .prepare(`SELECT position FROM ranking_history
+         WHERE keyword = ? AND asin = ? AND is_sponsored = 1
+         ORDER BY timestamp DESC
+         LIMIT 1`)
+            .get(keyword, asin);
+        return row?.position ?? null;
+    }
+    getLatestRanking(keyword, asin) {
+        const latest = this.db
+            .prepare(`SELECT asin, keyword, timestamp, position, is_sponsored
+         FROM ranking_history
+         WHERE keyword = ? AND asin = ?
+         ORDER BY timestamp DESC
+         LIMIT 1`)
+            .get(keyword, asin);
+        if (!latest) {
+            return {
+                keyword,
+                asin,
+                organicPosition: null,
+                sponsoredPosition: null,
+                snapshotTimestamp: "",
+                found: false,
+            };
+        }
+        return {
+            keyword,
+            asin,
+            organicPosition: this.getOrganicPosition(keyword, asin),
+            sponsoredPosition: this.getSponsoredPosition(keyword, asin),
+            snapshotTimestamp: latest.timestamp,
+            found: true,
+        };
+    }
+    getTrackedKeywords() {
+        const rows = this.db.prepare("SELECT keyword FROM keywords WHERE is_active = 1").all();
+        return rows.map((r) => r.keyword);
+    }
+    getTrackedAsins() {
+        const rows = this.db.prepare("SELECT DISTINCT asin FROM products ORDER BY asin").all();
+        return rows.map((r) => r.asin);
+    }
+    getLatestSnapshotDate() {
+        const row = this.db.prepare("SELECT MAX(timestamp) as latest FROM search_result_snapshots").get();
+        return row?.latest ?? "";
+    }
+    buildSeoRankingData(adKeywords, asins, dbPath) {
+        const trackedKeywords = this.getTrackedKeywords();
+        const snapshotDate = this.getLatestSnapshotDate();
+        // Build normalized lookup: normalized -> original tracked keyword
+        const trackedNormMap = new Map();
+        for (const tk of trackedKeywords) {
+            trackedNormMap.set(normalizeKeyword(tk), tk);
+        }
+        const rankings = new Map();
+        for (const adKw of adKeywords) {
+            const normKey = normalizeKeyword(adKw);
+            const trackedKw = trackedNormMap.get(normKey);
+            if (!trackedKw)
+                continue;
+            const infos = [];
+            for (const asin of asins) {
+                const info = this.getLatestRanking(trackedKw, asin);
+                if (info.found) {
+                    infos.push(info);
+                }
+            }
+            if (infos.length > 0) {
+                rankings.set(normKey, infos);
+            }
+        }
+        return { rankings, dbPath, snapshotDate };
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=ranking-db.js.map

package/dist/ranking/ranking-db.js.map

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

package/dist/ranking/seo-factor.d.ts

@@ -0,0 +1,5 @@
+import type { SeoConfig, SeoRankingData } from "./types.js";
+import type { CpcRecommendation } from "../pipeline/types.js";
+export declare const calcSeoFactor: (organicPosition: number | null, config?: Pick<SeoConfig, "seoFactors">) => number;
+export declare const applySeoAdjustment: (recommendations: CpcRecommendation[], rankingData: SeoRankingData, config: SeoConfig) => CpcRecommendation[];
+//# sourceMappingURL=seo-factor.d.ts.map

package/dist/ranking/seo-factor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-factor.d.ts","sourceRoot":"","sources":["../../src/ranking/seo-factor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAU9D,eAAO,MAAM,aAAa,GAAI,iBAAiB,MAAM,GAAG,IAAI,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,KAAG,MAWtG,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,iBAAiB,iBAAiB,EAAE,EACpC,aAAa,cAAc,EAC3B,QAAQ,SAAS,KAChB,iBAAiB,EA4CnB,CAAC"}

package/dist/ranking/seo-factor.js

@@ -0,0 +1,57 @@
+import { normalizeKeyword } from "./keyword-matcher.js";
+const DEFAULT_SEO_FACTORS = {
+    1: 0.5,
+    2: 0.6,
+    3: 0.7,
+    4: 0.8,
+};
+export const calcSeoFactor = (organicPosition, config) => {
+    if (organicPosition === null || organicPosition <= 0)
+        return 1.0;
+    const factors = config?.seoFactors ?? DEFAULT_SEO_FACTORS;
+    // Exact match in the factors table
+    if (organicPosition in factors) {
+        return factors[organicPosition];
+    }
+    // Position 5-10 or beyond: no adjustment
+    return 1.0;
+};
+export const applySeoAdjustment = (recommendations, rankingData, config) => {
+    return recommendations.map((rec) => {
+        const normKey = normalizeKeyword(rec.keywordText);
+        const rankings = rankingData.rankings.get(normKey);
+        if (!rankings || rankings.length === 0) {
+            return rec;
+        }
+        // Find the best organic position across all ASINs tracked for this keyword
+        let bestOrganicPosition = null;
+        for (const r of rankings) {
+            if (r.organicPosition !== null) {
+                if (bestOrganicPosition === null || r.organicPosition < bestOrganicPosition) {
+                    bestOrganicPosition = r.organicPosition;
+                }
+            }
+        }
+        const seoFactor = calcSeoFactor(bestOrganicPosition, config);
+        if (seoFactor >= 1.0) {
+            return {
+                ...rec,
+                seoFactor: 1.0,
+                organicPosition: bestOrganicPosition,
+            };
+        }
+        const adjustedBid = rec.recommendedBid * seoFactor;
+        const cappedBid = config.cpcCeiling > 0 ? Math.min(adjustedBid, config.cpcCeiling) : adjustedBid;
+        const finalBid = Math.max(1, Math.round(cappedBid));
+        const seoReason = `seoFactor=${seoFactor.toFixed(2)} organic=#${bestOrganicPosition}`;
+        return {
+            ...rec,
+            recommendedBid: finalBid,
+            seoFactor,
+            organicPosition: bestOrganicPosition,
+            seoReason,
+            reason: `${rec.reason} ${seoReason}`,
+        };
+    });
+};
+//# sourceMappingURL=seo-factor.js.map

package/dist/ranking/seo-factor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-factor.js","sourceRoot":"","sources":["../../src/ranking/seo-factor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,mBAAmB,GAA2B;IAClD,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;CACP,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,eAA8B,EAAE,MAAsC,EAAU,EAAE;IAC9G,IAAI,eAAe,KAAK,IAAI,IAAI,eAAe,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IACjE,MAAM,OAAO,GAAG,MAAM,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAE1D,mCAAmC;IACnC,IAAI,eAAe,IAAI,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IAED,yCAAyC;IACzC,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,eAAoC,EACpC,WAA2B,EAC3B,MAAiB,EACI,EAAE;IACvB,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,2EAA2E;QAC3E,IAAI,mBAAmB,GAAkB,IAAI,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;gBAC/B,IAAI,mBAAmB,KAAK,IAAI,IAAI,CAAC,CAAC,eAAe,GAAG,mBAAmB,EAAE,CAAC;oBAC5E,mBAAmB,GAAG,CAAC,CAAC,eAAe,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAE7D,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YACrB,OAAO;gBACL,GAAG,GAAG;gBACN,SAAS,EAAE,GAAG;gBACd,eAAe,EAAE,mBAAmB;aACrC,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC;QACnD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAEpD,MAAM,SAAS,GAAG,aAAa,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,mBAAmB,EAAE,CAAC;QAEtF,OAAO;YACL,GAAG,GAAG;YACN,cAAc,EAAE,QAAQ;YACxB,SAAS;YACT,eAAe,EAAE,mBAAmB;YACpC,SAAS;YACT,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/ranking/types.d.ts

@@ -0,0 +1,25 @@
+export interface KeywordRankingInfo {
+    keyword: string;
+    asin: string;
+    organicPosition: number | null;
+    sponsoredPosition: number | null;
+    snapshotTimestamp: string;
+    found: boolean;
+}
+export interface SeoRankingData {
+    rankings: Map<string, KeywordRankingInfo[]>;
+    dbPath: string;
+    snapshotDate: string;
+}
+export interface SeoConfig {
+    enabled: boolean;
+    seoFactors: Record<number, number>;
+    cpcCeiling: number;
+    keywordMappingPath?: string;
+    targetAsinsPath?: string;
+}
+export interface KeywordMapping {
+    adKeyword: string;
+    rankingKeyword: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ranking/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/ranking/types.js

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

package/dist/ranking/types.js.map

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

package/dist/schemas/types.d.ts

@@ -0,0 +1,32 @@
+export type Primitive = string | number | boolean | null | Date;
+export interface SchemaFieldDefinition {
+    source?: string;
+    sources?: string[];
+    literal?: Primitive;
+    default?: Primitive;
+    transform?: string;
+    required?: boolean;
+    description?: string;
+}
+export interface SchemaSkipCondition {
+    type: "empty" | "emptyOrZero" | "equals";
+    source?: string;
+    sources?: string[];
+    value?: Primitive;
+    values?: Primitive[];
+    reason?: string;
+}
+export interface SchemaEntityDefinition {
+    requiredColumns?: string[];
+    fields: Record<string, SchemaFieldDefinition>;
+    skipConditions?: SchemaSkipCondition[];
+}
+export interface BulkSchema {
+    id: string;
+    version: string;
+    description: string;
+    header: string[];
+    defaults?: Record<string, SchemaFieldDefinition>;
+    entities: Record<string, SchemaEntityDefinition>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schemas/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9C,cAAc,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAClD"}

package/dist/schemas/types.js

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

package/dist/schemas/types.js.map

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

package/dist/utils/date-utils.d.ts

@@ -0,0 +1,17 @@
+export declare const formatDateYYYYMMDD: (value: Date | string | number) => string;
+export interface DateRange {
+    startDate: string;
+    endDate: string;
+    days: number;
+}
+/**
+ * Parse date range from Amazon bulk sheet filename.
+ * Pattern: bulk-{sellerId}-{YYYYMMDD}-{YYYYMMDD}-{timestamp}.xlsx
+ */
+export declare const parseDateRangeFromFilename: (filename: string) => DateRange | null;
+/**
+ * Extract date range from multiple input file paths. Returns the widest range found.
+ */
+export declare const extractDateRangeFromFiles: (filePaths: string[]) => DateRange | null;
+export declare const timestampForFilename: (date?: Date) => string;
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/utils/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../src/utils/date-utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,GAAI,OAAO,IAAI,GAAG,MAAM,GAAG,MAAM,KAAG,MAUlE,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,UAAU,MAAM,KAAG,SAAS,GAAG,IAgBzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,WAAW,MAAM,EAAE,KAAG,SAAS,GAAG,IAW3E,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,WAAiB,KAAG,MAQxD,CAAC"}

package/dist/utils/date-utils.js

@@ -0,0 +1,56 @@
+export const formatDateYYYYMMDD = (value) => {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return "";
+    }
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+};
+/**
+ * Parse date range from Amazon bulk sheet filename.
+ * Pattern: bulk-{sellerId}-{YYYYMMDD}-{YYYYMMDD}-{timestamp}.xlsx
+ */
+export const parseDateRangeFromFilename = (filename) => {
+    const match = filename.match(/(\d{8})-(\d{8})/);
+    if (!match)
+        return null;
+    const [, rawStart, rawEnd] = match;
+    const start = new Date(`${rawStart.slice(0, 4)}-${rawStart.slice(4, 6)}-${rawStart.slice(6, 8)}`);
+    const end = new Date(`${rawEnd.slice(0, 4)}-${rawEnd.slice(4, 6)}-${rawEnd.slice(6, 8)}`);
+    if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime()))
+        return null;
+    const days = Math.round((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+    return {
+        startDate: formatDateYYYYMMDD(start),
+        endDate: formatDateYYYYMMDD(end),
+        days,
+    };
+};
+/**
+ * Extract date range from multiple input file paths. Returns the widest range found.
+ */
+export const extractDateRangeFromFiles = (filePaths) => {
+    const ranges = filePaths.map(parseDateRangeFromFilename).filter((r) => r !== null);
+    if (ranges.length === 0)
+        return null;
+    if (ranges.length === 1)
+        return ranges[0];
+    const starts = ranges.map((r) => r.startDate).sort();
+    const ends = ranges.map((r) => r.endDate).sort();
+    const startDate = starts[0];
+    const endDate = ends[ends.length - 1];
+    const days = Math.round((new Date(endDate).getTime() - new Date(startDate).getTime()) / (1000 * 60 * 60 * 24));
+    return { startDate, endDate, days };
+};
+export const timestampForFilename = (date = new Date()) => {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    const hh = String(date.getHours()).padStart(2, "0");
+    const mm = String(date.getMinutes()).padStart(2, "0");
+    const ss = String(date.getSeconds()).padStart(2, "0");
+    return `${y}${m}${d}-${hh}${mm}${ss}`;
+};
+//# sourceMappingURL=date-utils.js.map

package/dist/utils/date-utils.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare class Logger {
+    private readonly minLevel;
+    constructor(minLevel?: LogLevel);
+    private canLog;
+    log(level: LogLevel, message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,GAAE,QAAiB;IAExD,OAAO,CAAC,MAAM;IAId,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAoB3E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG7D"}

package/dist/utils/logger.js

@@ -0,0 +1,45 @@
+const levelWeight = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+export class Logger {
+    minLevel;
+    constructor(minLevel = "info") {
+        this.minLevel = minLevel;
+    }
+    canLog(level) {
+        return levelWeight[level] >= levelWeight[this.minLevel];
+    }
+    log(level, message, meta) {
+        if (!this.canLog(level)) {
+            return;
+        }
+        const ts = new Date().toISOString();
+        const metaPart = meta && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+        const line = `[${ts}] [${level.toUpperCase()}] ${message}${metaPart}`;
+        if (level === "error") {
+            console.error(line);
+            return;
+        }
+        if (level === "warn") {
+            console.warn(line);
+            return;
+        }
+        console.log(line);
+    }
+    debug(message, meta) {
+        this.log("debug", message, meta);
+    }
+    info(message, meta) {
+        this.log("info", message, meta);
+    }
+    warn(message, meta) {
+        this.log("warn", message, meta);
+    }
+    error(message, meta) {
+        this.log("error", message, meta);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,MAAM,OAAO,MAAM;IACY;IAA7B,YAA6B,WAAqB,MAAM;QAA3B,aAAQ,GAAR,QAAQ,CAAmB;IAAG,CAAC;IAEpD,MAAM,CAAC,KAAe;QAC5B,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;QAClE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,GAAG,IAAI,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,GAAG,QAAQ,EAAE,CAAC;QAEtE,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "aads-cli",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "description": "CLI tool for analyzing Amazon Ads Sponsored Products campaign performance",
+  "keywords": [
+    "amazon-ads",
+    "ppc",
+    "sponsored-products",
+    "cli",
+    "cpc-optimization",
+    "acos"
+  ],
+  "license": "MIT",
+  "author": "yuuki-courage",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yuuki-courage/aads.git"
+  },
+  "bin": {
+    "aads": "./dist/cli.js",
+    "aads-cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "data/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/cli.ts",
+    "lint": "eslint src/",
+    "format:check": "prettier --check 'src/**/*.ts'",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.6.2",
+    "commander": "^14.0.1",
+    "dotenv": "^17.2.1",
+    "exceljs": "^4.4.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^24.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.32.1",
+    "@typescript-eslint/parser": "^8.32.1",
+    "eslint": "^9.27.0",
+    "eslint-config-prettier": "^10.1.5",
+    "prettier": "^3.5.3",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.1"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["better-sqlite3", "esbuild"]
+  }
+}