@houtini/better-search-console 1.0.0

package/dist/tools/compare-periods.d.ts

@@ -0,0 +1,3 @@
+import type { ComparePeriodParams } from '../types/index.js';
+export declare function comparePeriods(params: ComparePeriodParams): any;
+//# sourceMappingURL=compare-periods.d.ts.map

package/dist/tools/compare-periods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-periods.d.ts","sourceRoot":"","sources":["../../src/tools/compare-periods.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,wBAAgB,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,GAAG,CA4I/D"}

package/dist/tools/compare-periods.js

@@ -0,0 +1,127 @@
+import { existsSync } from 'fs';
+import { Database } from '../core/Database.js';
+import { getDbPath } from './helpers.js';
+export function comparePeriods(params) {
+    const { siteUrl, period1Start, period1End, period2Start, period2End, dimension = 'query', limit = 50, pageFilter, } = params;
+    const dbPath = getDbPath(siteUrl);
+    if (!existsSync(dbPath)) {
+        throw new Error(`No database found for "${siteUrl}". Run sync_gsc_data first.`);
+    }
+    const validDimensions = ['query', 'page', 'device', 'country'];
+    if (!validDimensions.includes(dimension)) {
+        throw new Error(`Invalid dimension: "${dimension}". Valid: ${validDimensions.join(', ')}`);
+    }
+    const db = new Database(dbPath);
+    try {
+        let pageFilterClause = '';
+        const extraValues = [];
+        if (pageFilter) {
+            pageFilterClause = ' AND page LIKE ?';
+            extraValues.push(`%${pageFilter}%`);
+        }
+        // Summary totals for each period
+        const period1Summary = db.queryOne(`
+      SELECT
+        COALESCE(SUM(clicks), 0) as clicks,
+        COALESCE(SUM(impressions), 0) as impressions,
+        ROUND(CAST(SUM(clicks) AS REAL) / NULLIF(SUM(impressions), 0), 4) as ctr,
+        ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?${pageFilterClause}
+    `, [period1Start, period1End, ...extraValues]);
+        const period2Summary = db.queryOne(`
+      SELECT
+        COALESCE(SUM(clicks), 0) as clicks,
+        COALESCE(SUM(impressions), 0) as impressions,
+        ROUND(CAST(SUM(clicks) AS REAL) / NULLIF(SUM(impressions), 0), 4) as ctr,
+        ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?${pageFilterClause}
+    `, [period2Start, period2End, ...extraValues]);
+        // Dimension breakdown
+        const dimFilter = dimension === 'query' ? ' AND query IS NOT NULL' :
+            dimension === 'page' ? ' AND page IS NOT NULL' : '';
+        const rows = db.query(`
+      SELECT
+        ${dimension} as dimension_value,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as period1_clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as period1_impressions,
+        ROUND(
+          CAST(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) AS REAL)
+          / NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END), 0), 4
+        ) as period1_ctr,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as period2_clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as period2_impressions,
+        ROUND(
+          CAST(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) AS REAL)
+          / NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END), 0), 4
+        ) as period2_ctr,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END)
+          - SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as click_change,
+        ROUND(
+          (SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END)
+           - SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END))
+          * 100.0
+          / NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END), 0),
+          1
+        ) as click_change_pct
+      FROM search_analytics
+      WHERE (date BETWEEN ? AND ? OR date BETWEEN ? AND ?)${dimFilter}${pageFilterClause}
+      GROUP BY ${dimension}
+      HAVING period1_clicks > 0 OR period2_clicks > 0
+      ORDER BY period2_clicks DESC
+      LIMIT ?
+    `, [
+            // period1 clicks
+            period1Start, period1End,
+            // period1 impressions
+            period1Start, period1End,
+            // period1 ctr numerator
+            period1Start, period1End,
+            // period1 ctr denominator
+            period1Start, period1End,
+            // period2 clicks
+            period2Start, period2End,
+            // period2 impressions
+            period2Start, period2End,
+            // period2 ctr numerator
+            period2Start, period2End,
+            // period2 ctr denominator
+            period2Start, period2End,
+            // click_change
+            period2Start, period2End,
+            period1Start, period1End,
+            // click_change_pct numerator
+            period2Start, period2End,
+            period1Start, period1End,
+            // click_change_pct denominator
+            period1Start, period1End,
+            // WHERE date ranges
+            period1Start, period1End,
+            period2Start, period2End,
+            ...extraValues,
+            limit,
+        ]);
+        const pctChange = (curr, prev) => prev === 0 ? null : Math.round(((curr - prev) / prev) * 1000) / 10;
+        return {
+            dimension,
+            period1: { startDate: period1Start, endDate: period1End },
+            period2: { startDate: period2Start, endDate: period2End },
+            summary: {
+                period1: period1Summary,
+                period2: period2Summary,
+                changes: {
+                    clicks: period2Summary.clicks - period1Summary.clicks,
+                    clicksPct: pctChange(period2Summary.clicks, period1Summary.clicks),
+                    impressions: period2Summary.impressions - period1Summary.impressions,
+                    impressionsPct: pctChange(period2Summary.impressions, period1Summary.impressions),
+                },
+            },
+            rows,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=compare-periods.js.map

package/dist/tools/compare-periods.js.map

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

package/dist/tools/get-dashboard.d.ts

@@ -0,0 +1,10 @@
+import { type ComparisonMode } from './helpers.js';
+export interface DashboardParams {
+    siteUrl: string;
+    dateRange?: string;
+    comparisonMode?: ComparisonMode;
+    matchWeekdays?: boolean;
+    brandTerms?: string[];
+}
+export declare function getDashboardData(params: DashboardParams): any;
+//# sourceMappingURL=get-dashboard.d.ts.map

package/dist/tools/get-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dashboard.d.ts","sourceRoot":"","sources":["../../src/tools/get-dashboard.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,GAAG,CAqU7D"}

package/dist/tools/get-dashboard.js

@@ -0,0 +1,310 @@
+import { existsSync } from 'fs';
+import { Database } from '../core/Database.js';
+import { getDbPath, getPeriodDates } from './helpers.js';
+export function getDashboardData(params) {
+    const { siteUrl, dateRange = '3m', comparisonMode = 'previous_period', matchWeekdays = false, brandTerms } = params;
+    const dbPath = getDbPath(siteUrl);
+    if (!existsSync(dbPath)) {
+        throw new Error(`No database found for "${siteUrl}". Run sync_gsc_data first.`);
+    }
+    const { current, prior } = getPeriodDates(dateRange, undefined, comparisonMode, matchWeekdays);
+    const comparisonDisabled = comparisonMode === 'disabled';
+    const db = new Database(dbPath);
+    try {
+        // 1. Summary metrics
+        const currentSummary = db.queryOne(`
+      SELECT
+        COALESCE(SUM(clicks), 0) as clicks,
+        COALESCE(SUM(impressions), 0) as impressions,
+        ROUND(CAST(SUM(clicks) AS REAL) / NULLIF(SUM(impressions), 0), 4) as ctr,
+        ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?
+    `, [current.startDate, current.endDate]);
+        const priorSummary = db.queryOne(`
+      SELECT
+        COALESCE(SUM(clicks), 0) as clicks,
+        COALESCE(SUM(impressions), 0) as impressions,
+        ROUND(CAST(SUM(clicks) AS REAL) / NULLIF(SUM(impressions), 0), 4) as ctr,
+        ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?
+    `, [prior.startDate, prior.endDate]);
+        // 2. Daily trend (with CTR and position for metric toggles)
+        const dailyTrend = db.query(`
+      SELECT date,
+        SUM(clicks) as clicks,
+        SUM(impressions) as impressions,
+        ROUND(CAST(SUM(clicks) AS REAL) / NULLIF(SUM(impressions), 0), 4) as ctr,
+        ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?
+      GROUP BY date
+      ORDER BY date ASC
+    `, [current.startDate, current.endDate]);
+        // 2b. Prior period daily trend (for dashed overlay)
+        const priorDailyTrend = comparisonDisabled ? [] : db.query(`
+      SELECT date,
+        SUM(clicks) as clicks,
+        SUM(impressions) as impressions,
+        ROUND(CAST(SUM(clicks) AS REAL) / NULLIF(SUM(impressions), 0), 4) as ctr,
+        ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?
+      GROUP BY date
+      ORDER BY date ASC
+    `, [prior.startDate, prior.endDate]);
+        // 3. Top queries with change + CTR + position
+        const topQueries = db.query(`
+      SELECT query,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as impressions,
+        ROUND(CAST(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) AS REAL) /
+          NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END), 0), 4) as ctr,
+        ROUND(AVG(CASE WHEN date BETWEEN ? AND ? THEN position ELSE NULL END), 1) as avg_position,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as prior_clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as prior_impressions,
+        ROUND(CAST(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) AS REAL) /
+          NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END), 0), 4) as prior_ctr,
+        ROUND(AVG(CASE WHEN date BETWEEN ? AND ? THEN position ELSE NULL END), 1) as prior_avg_position,
+        ROUND(
+          (SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END)
+           - SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END))
+          * 100.0
+          / NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END), 0),
+          1
+        ) as clicks_change_pct
+      FROM search_analytics
+      WHERE query IS NOT NULL
+        AND (date BETWEEN ? AND ? OR date BETWEEN ? AND ?)
+      GROUP BY query
+      HAVING clicks > 0
+      ORDER BY clicks DESC
+      LIMIT 100
+    `, [
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+        ]);
+        // 4. Top pages with change + CTR + position
+        const topPages = db.query(`
+      SELECT page,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as impressions,
+        ROUND(CAST(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) AS REAL) /
+          NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END), 0), 4) as ctr,
+        ROUND(AVG(CASE WHEN date BETWEEN ? AND ? THEN position ELSE NULL END), 1) as avg_position,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as prior_clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as prior_impressions,
+        ROUND(CAST(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) AS REAL) /
+          NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END), 0), 4) as prior_ctr,
+        ROUND(AVG(CASE WHEN date BETWEEN ? AND ? THEN position ELSE NULL END), 1) as prior_avg_position,
+        ROUND(
+          (SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END)
+           - SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END))
+          * 100.0
+          / NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END), 0),
+          1
+        ) as clicks_change_pct
+      FROM search_analytics
+      WHERE page IS NOT NULL
+        AND (date BETWEEN ? AND ? OR date BETWEEN ? AND ?)
+      GROUP BY page
+      HAVING clicks > 0
+      ORDER BY clicks DESC
+      LIMIT 100
+    `, [
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+        ]);
+        // 5. Country breakdown
+        const countries = db.query(`
+      SELECT country,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as impressions,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END) as prior_clicks,
+        SUM(CASE WHEN date BETWEEN ? AND ? THEN impressions ELSE 0 END) as prior_impressions,
+        ROUND(
+          (SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END)
+           - SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END))
+          * 100.0
+          / NULLIF(SUM(CASE WHEN date BETWEEN ? AND ? THEN clicks ELSE 0 END), 0),
+          1
+        ) as clicks_change_pct
+      FROM search_analytics
+      WHERE country IS NOT NULL
+        AND (date BETWEEN ? AND ? OR date BETWEEN ? AND ?)
+      GROUP BY country
+      HAVING clicks > 0
+      ORDER BY clicks DESC
+      LIMIT 50
+    `, [
+            current.startDate, current.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+            prior.startDate, prior.endDate,
+            current.startDate, current.endDate,
+            prior.startDate, prior.endDate,
+        ]);
+        // 6. Ranking buckets — computed in SQL to avoid pulling millions of rows into JS
+        const rankingBuckets = db.query(`
+      SELECT
+        CASE
+          WHEN avg_pos <= 3 THEN '1-3'
+          WHEN avg_pos <= 10 THEN '4-10'
+          WHEN avg_pos <= 20 THEN '11-20'
+          WHEN avg_pos <= 50 THEN '21-50'
+          WHEN avg_pos <= 100 THEN '51-100'
+          ELSE '100+'
+        END as bucket,
+        COUNT(*) as count
+      FROM (
+        SELECT AVG(position) as avg_pos
+        FROM search_analytics
+        WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+        GROUP BY query
+      )
+      GROUP BY bucket
+      ORDER BY MIN(avg_pos)
+    `, [current.startDate, current.endDate]);
+        // 7. New queries (in current but not in prior) — using EXCEPT for efficiency
+        const newQueries = comparisonDisabled ? [] : db.query(`
+      SELECT query, SUM(clicks) as clicks, SUM(impressions) as impressions, ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?
+        AND query IS NOT NULL
+        AND query IN (
+          SELECT query FROM search_analytics WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+          EXCEPT
+          SELECT query FROM search_analytics WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+        )
+      GROUP BY query
+      HAVING clicks > 0
+      ORDER BY clicks DESC
+      LIMIT 50
+    `, [current.startDate, current.endDate, current.startDate, current.endDate, prior.startDate, prior.endDate]);
+        // 8. Lost queries (in prior but not in current) — using EXCEPT for efficiency
+        const lostQueries = comparisonDisabled ? [] : db.query(`
+      SELECT query, SUM(clicks) as clicks, SUM(impressions) as impressions, ROUND(AVG(position), 1) as avg_position
+      FROM search_analytics
+      WHERE date BETWEEN ? AND ?
+        AND query IS NOT NULL
+        AND query IN (
+          SELECT query FROM search_analytics WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+          EXCEPT
+          SELECT query FROM search_analytics WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+        )
+      GROUP BY query
+      HAVING clicks > 0
+      ORDER BY clicks DESC
+      LIMIT 50
+    `, [prior.startDate, prior.endDate, prior.startDate, prior.endDate, current.startDate, current.endDate]);
+        // 9. Branded split (if brandTerms provided)
+        let brandedSplit = null;
+        if (brandTerms && brandTerms.length > 0) {
+            const brandConditions = brandTerms.map(() => 'LOWER(query) LIKE ?').join(' OR ');
+            const brandValues = brandTerms.map(t => `%${t.toLowerCase()}%`);
+            const splitSummary = db.query(`
+        SELECT
+          CASE WHEN ${brandConditions} THEN 'branded' ELSE 'non-branded' END as segment,
+          SUM(clicks) as clicks,
+          SUM(impressions) as impressions
+        FROM search_analytics
+        WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+        GROUP BY segment
+      `, [...brandValues, current.startDate, current.endDate]);
+            const priorSplitSummary = comparisonDisabled ? [] : db.query(`
+        SELECT
+          CASE WHEN ${brandConditions} THEN 'branded' ELSE 'non-branded' END as segment,
+          SUM(clicks) as clicks,
+          SUM(impressions) as impressions
+        FROM search_analytics
+        WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+        GROUP BY segment
+      `, [...brandValues, prior.startDate, prior.endDate]);
+            const splitTrend = db.query(`
+        SELECT date,
+          CASE WHEN ${brandConditions} THEN 'branded' ELSE 'non-branded' END as segment,
+          SUM(clicks) as clicks
+        FROM search_analytics
+        WHERE date BETWEEN ? AND ? AND query IS NOT NULL
+        GROUP BY date, segment
+        ORDER BY date ASC
+      `, [...brandValues, current.startDate, current.endDate]);
+            brandedSplit = { summary: splitSummary, priorSummary: priorSplitSummary, trend: splitTrend };
+        }
+        // 10. Last synced timestamp
+        const meta = db.getPropertyMeta(siteUrl);
+        const lastSyncedAt = meta?.lastSyncedAt ?? null;
+        const pctChange = (curr, prev) => prev === 0 ? null : Math.round(((curr - prev) / prev) * 1000) / 10;
+        return {
+            siteUrl,
+            dateRange,
+            comparisonMode,
+            matchWeekdays,
+            lastSyncedAt,
+            period: { current, prior },
+            summary: {
+                current: {
+                    clicks: currentSummary.clicks,
+                    impressions: currentSummary.impressions,
+                    ctr: currentSummary.ctr,
+                    avgPosition: currentSummary.avg_position,
+                },
+                prior: {
+                    clicks: priorSummary.clicks,
+                    impressions: priorSummary.impressions,
+                    ctr: priorSummary.ctr,
+                    avgPosition: priorSummary.avg_position,
+                },
+                changes: {
+                    clicksPct: pctChange(currentSummary.clicks, priorSummary.clicks),
+                    impressionsPct: pctChange(currentSummary.impressions, priorSummary.impressions),
+                    ctrPct: pctChange(currentSummary.ctr ?? 0, priorSummary.ctr ?? 0),
+                    avgPositionPct: pctChange(currentSummary.avg_position ?? 0, priorSummary.avg_position ?? 0),
+                },
+            },
+            dailyTrend,
+            priorDailyTrend,
+            topQueries,
+            topPages,
+            countries,
+            rankingBuckets,
+            newQueries,
+            lostQueries,
+            brandedSplit,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=get-dashboard.js.map

package/dist/tools/get-dashboard.js.map

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

package/dist/tools/get-insights.d.ts

@@ -0,0 +1,3 @@
+import type { InsightParams } from '../types/index.js';
+export declare function getInsights(params: InsightParams): any;
+//# sourceMappingURL=get-insights.d.ts.map

package/dist/tools/get-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-insights.d.ts","sourceRoot":"","sources":["../../src/tools/get-insights.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG,CAoBtD"}