@pagebridge/core 0.0.3 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Soma Somorjai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Soma Somorjai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cannibalization-analyzer.d.ts

@@ -0,0 +1,38 @@
+import type { DrizzleClient } from "@pagebridge/db";
+import type { CannibalizationTarget } from "./sync-engine.js";
+export interface CannibalizationGroup {
+    query: string;
+    pages: {
+        page: string;
+        clicks: number;
+        impressions: number;
+        position: number;
+    }[];
+}
+export interface CannibalizationConfig {
+    /** Minimum impressions per query to consider (default: 100) */
+    minImpressions: number;
+    /** Lookback window in days (default: 28) */
+    windowDays: number;
+    /** Days of data lag to skip (default: 3) */
+    lagDays: number;
+}
+export declare class CannibalizationAnalyzer {
+    private config;
+    constructor(db: DrizzleClient, config?: Partial<CannibalizationConfig>);
+    private db;
+    /**
+     * Finds queries where 2+ pages rank, grouped by query.
+     * Returns site-wide cannibalization groups.
+     */
+    analyzeSiteWide(siteId: string): Promise<CannibalizationGroup[]>;
+    /**
+     * For each matched page, finds competing pages and shared queries.
+     * Returns a Map keyed by page URL.
+     */
+    analyzeForPages(siteId: string, matches: {
+        gscUrl: string;
+        sanityId: string | undefined;
+    }[]): Promise<Map<string, CannibalizationTarget[]>>;
+}
+//# sourceMappingURL=cannibalization-analyzer.d.ts.map

package/dist/cannibalization-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cannibalization-analyzer.d.ts","sourceRoot":"","sources":["../src/cannibalization-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAwB;gBAE1B,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAKtE,OAAO,CAAC,EAAE,CAAgB;IAE1B;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA6DtE;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,GAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;CAgDjD"}

package/dist/cannibalization-analyzer.js

@@ -0,0 +1,109 @@
+import { queryAnalytics } from "@pagebridge/db";
+import { and, eq, gte, lte, sql } from "drizzle-orm";
+import { daysAgo, formatDate } from "./utils/date-utils.js";
+const defaultConfig = {
+    minImpressions: 100,
+    windowDays: 28,
+    lagDays: 3,
+};
+export class CannibalizationAnalyzer {
+    config;
+    constructor(db, config) {
+        this.db = db;
+        this.config = { ...defaultConfig, ...config };
+    }
+    db;
+    /**
+     * Finds queries where 2+ pages rank, grouped by query.
+     * Returns site-wide cannibalization groups.
+     */
+    async analyzeSiteWide(siteId) {
+        const startDate = daysAgo(this.config.windowDays);
+        const endDate = daysAgo(this.config.lagDays);
+        // Get all query+page combos with significant impressions
+        const results = await this.db
+            .select({
+            page: queryAnalytics.page,
+            query: queryAnalytics.query,
+            totalClicks: sql `sum(${queryAnalytics.clicks})`,
+            totalImpressions: sql `sum(${queryAnalytics.impressions})`,
+            avgPosition: sql `avg(${queryAnalytics.position})`,
+        })
+            .from(queryAnalytics)
+            .where(and(eq(queryAnalytics.siteId, siteId), gte(queryAnalytics.date, formatDate(startDate)), lte(queryAnalytics.date, formatDate(endDate))))
+            .groupBy(queryAnalytics.page, queryAnalytics.query);
+        // Group by query and filter for queries with 2+ pages
+        const queryMap = new Map();
+        for (const row of results) {
+            const impressions = Number(row.totalImpressions) || 0;
+            if (impressions < this.config.minImpressions)
+                continue;
+            const existing = queryMap.get(row.query) ?? [];
+            existing.push({
+                page: row.page,
+                clicks: Number(row.totalClicks) || 0,
+                impressions,
+                position: Number(row.avgPosition) || 0,
+            });
+            queryMap.set(row.query, existing);
+        }
+        const groups = [];
+        for (const [query, pages] of queryMap) {
+            if (pages.length >= 2) {
+                pages.sort((a, b) => a.position - b.position);
+                groups.push({ query, pages });
+            }
+        }
+        // Sort by total impressions across competing pages
+        groups.sort((a, b) => {
+            const aImpr = a.pages.reduce((s, p) => s + p.impressions, 0);
+            const bImpr = b.pages.reduce((s, p) => s + p.impressions, 0);
+            return bImpr - aImpr;
+        });
+        return groups;
+    }
+    /**
+     * For each matched page, finds competing pages and shared queries.
+     * Returns a Map keyed by page URL.
+     */
+    async analyzeForPages(siteId, matches) {
+        const groups = await this.analyzeSiteWide(siteId);
+        const matchedUrls = new Set(matches.map((m) => m.gscUrl));
+        const sanityIdByUrl = new Map();
+        for (const m of matches) {
+            if (m.sanityId)
+                sanityIdByUrl.set(m.gscUrl, m.sanityId);
+        }
+        const result = new Map();
+        for (const group of groups) {
+            const pagesInGroup = group.pages.map((p) => p.page);
+            const matchedPagesInGroup = pagesInGroup.filter((p) => matchedUrls.has(p));
+            if (matchedPagesInGroup.length === 0)
+                continue;
+            for (const page of matchedPagesInGroup) {
+                const competitors = pagesInGroup.filter((p) => p !== page);
+                if (competitors.length === 0)
+                    continue;
+                const existing = result.get(page) ?? [];
+                for (const competitor of competitors) {
+                    // Check if we already have this competitor for this page
+                    const existingTarget = existing.find((t) => t.competingPage === competitor);
+                    if (existingTarget) {
+                        if (!existingTarget.sharedQueries.includes(group.query)) {
+                            existingTarget.sharedQueries.push(group.query);
+                        }
+                    }
+                    else {
+                        existing.push({
+                            competingPage: competitor,
+                            competingDocumentId: sanityIdByUrl.get(competitor) ?? "",
+                            sharedQueries: [group.query],
+                        });
+                    }
+                }
+                result.set(page, existing);
+            }
+        }
+        return result;
+    }
+}

package/dist/ctr-anomaly-analyzer.d.ts

@@ -0,0 +1,46 @@
+import type { DrizzleClient } from "@pagebridge/db";
+/** Industry-average CTR by position (positions 1-10) */
+export declare const EXPECTED_CTR_BY_POSITION: Record<number, number>;
+export type CtrAnomalySeverity = "low" | "medium" | "high";
+export interface CtrAnomaly {
+    page: string;
+    detected: boolean;
+    actualCtr: number;
+    expectedCtr: number;
+    positionBucket: number;
+    severity: CtrAnomalySeverity;
+    message: string;
+}
+export interface InsightAlert {
+    type: "ctr_anomaly" | "quick_win_available" | "position_decay" | "stale_content" | "cannibalization";
+    severity: "low" | "medium" | "high";
+    message: string;
+}
+export interface CtrAnomalyConfig {
+    /** Minimum impressions over the period (default: 100) */
+    minImpressions: number;
+    /** Maximum average position to analyze (default: 10) */
+    maxPosition: number;
+    /** Ratio thresholds: actual/expected below this = high severity (default: 0.25) */
+    highThreshold: number;
+    /** Ratio thresholds: actual/expected below this = medium severity (default: 0.5) */
+    mediumThreshold: number;
+    /** Ratio thresholds: actual/expected below this = low severity (default: 0.75) */
+    lowThreshold: number;
+}
+export declare class CtrAnomalyAnalyzer {
+    private db;
+    private config;
+    constructor(db: DrizzleClient, config?: Partial<CtrAnomalyConfig>);
+    /**
+     * Analyzes pages for CTR anomalies — pages ranking in top 10 positions
+     * with CTR significantly below industry averages.
+     */
+    analyze(siteId: string): Promise<Map<string, CtrAnomaly>>;
+    /**
+     * Builds alert objects from anomaly results + other insight data
+     * for writing to snapshot documents.
+     */
+    static buildAlerts(ctrAnomaly?: CtrAnomaly, hasQuickWins?: boolean, hasDecay?: boolean, hasCannibalization?: boolean): InsightAlert[];
+}
+//# sourceMappingURL=ctr-anomaly-analyzer.d.ts.map

package/dist/ctr-anomaly-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctr-anomaly-analyzer.d.ts","sourceRoot":"","sources":["../src/ctr-anomaly-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKpD,wDAAwD;AACxD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW3D,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EACA,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,eAAe,GACf,iBAAiB,CAAC;IACtB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,EAAE;IAHZ,OAAO,CAAC,MAAM,CAAmB;gBAGvB,EAAE,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAKpC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAkE/D;;;OAGG;IACH,MAAM,CAAC,WAAW,CAChB,UAAU,CAAC,EAAE,UAAU,EACvB,YAAY,CAAC,EAAE,OAAO,EACtB,QAAQ,CAAC,EAAE,OAAO,EAClB,kBAAkB,CAAC,EAAE,OAAO,GAC3B,YAAY,EAAE;CAqClB"}

package/dist/ctr-anomaly-analyzer.js

@@ -0,0 +1,118 @@
+import { searchAnalytics } from "@pagebridge/db";
+import { and, eq, gte, lte, sql } from "drizzle-orm";
+import { daysAgo, formatDate } from "./utils/date-utils.js";
+/** Industry-average CTR by position (positions 1-10) */
+export const EXPECTED_CTR_BY_POSITION = {
+    1: 0.319,
+    2: 0.246,
+    3: 0.185,
+    4: 0.133,
+    5: 0.095,
+    6: 0.069,
+    7: 0.052,
+    8: 0.041,
+    9: 0.033,
+    10: 0.028,
+};
+const defaultConfig = {
+    minImpressions: 100,
+    maxPosition: 10,
+    highThreshold: 0.25,
+    mediumThreshold: 0.5,
+    lowThreshold: 0.75,
+};
+export class CtrAnomalyAnalyzer {
+    db;
+    config;
+    constructor(db, config) {
+        this.db = db;
+        this.config = { ...defaultConfig, ...config };
+    }
+    /**
+     * Analyzes pages for CTR anomalies — pages ranking in top 10 positions
+     * with CTR significantly below industry averages.
+     */
+    async analyze(siteId) {
+        const startDate = daysAgo(28);
+        const endDate = daysAgo(3);
+        const results = await this.db
+            .select({
+            page: searchAnalytics.page,
+            totalClicks: sql `sum(${searchAnalytics.clicks})`,
+            totalImpressions: sql `sum(${searchAnalytics.impressions})`,
+            avgPosition: sql `avg(${searchAnalytics.position})`,
+        })
+            .from(searchAnalytics)
+            .where(and(eq(searchAnalytics.siteId, siteId), gte(searchAnalytics.date, formatDate(startDate)), lte(searchAnalytics.date, formatDate(endDate))))
+            .groupBy(searchAnalytics.page);
+        const anomalies = new Map();
+        for (const row of results) {
+            const position = Number(row.avgPosition) || 0;
+            const impressions = Number(row.totalImpressions) || 0;
+            const clicks = Number(row.totalClicks) || 0;
+            if (position > this.config.maxPosition || position < 1)
+                continue;
+            if (impressions < this.config.minImpressions)
+                continue;
+            const positionBucket = Math.round(position);
+            const expectedCtr = EXPECTED_CTR_BY_POSITION[Math.min(positionBucket, 10)] ?? 0.028;
+            const actualCtr = impressions > 0 ? clicks / impressions : 0;
+            const ratio = expectedCtr > 0 ? actualCtr / expectedCtr : 1;
+            if (ratio >= this.config.lowThreshold)
+                continue;
+            const severity = ratio < this.config.highThreshold
+                ? "high"
+                : ratio < this.config.mediumThreshold
+                    ? "medium"
+                    : "low";
+            const expectedPct = (expectedCtr * 100).toFixed(1);
+            const actualPct = (actualCtr * 100).toFixed(1);
+            anomalies.set(row.page, {
+                page: row.page,
+                detected: true,
+                actualCtr,
+                expectedCtr,
+                positionBucket,
+                severity,
+                message: `CTR is ${actualPct}% vs ${expectedPct}% expected for position ${positionBucket}`,
+            });
+        }
+        return anomalies;
+    }
+    /**
+     * Builds alert objects from anomaly results + other insight data
+     * for writing to snapshot documents.
+     */
+    static buildAlerts(ctrAnomaly, hasQuickWins, hasDecay, hasCannibalization) {
+        const alerts = [];
+        if (ctrAnomaly?.detected) {
+            alerts.push({
+                type: "ctr_anomaly",
+                severity: ctrAnomaly.severity,
+                message: ctrAnomaly.message,
+            });
+        }
+        if (hasQuickWins) {
+            alerts.push({
+                type: "quick_win_available",
+                severity: "low",
+                message: "Page 1 opportunities found — queries at positions 8-20",
+            });
+        }
+        if (hasDecay) {
+            alerts.push({
+                type: "position_decay",
+                severity: "medium",
+                message: "Content decay detected — performance declining",
+            });
+        }
+        if (hasCannibalization) {
+            alerts.push({
+                type: "cannibalization",
+                severity: "medium",
+                message: "Query cannibalization detected — multiple pages competing",
+            });
+        }
+        return alerts;
+    }
+}

package/dist/daily-metrics-collector.d.ts

@@ -0,0 +1,12 @@
+import type { DrizzleClient } from "@pagebridge/db";
+import type { DailyMetricPoint } from "./sync-engine.js";
+export declare class DailyMetricsCollector {
+    private db;
+    constructor(db: DrizzleClient);
+    /**
+     * Collects 28 days of daily metrics per page for sparkline charts.
+     * Returns a Map keyed by page URL.
+     */
+    collect(siteId: string): Promise<Map<string, DailyMetricPoint[]>>;
+}
+//# sourceMappingURL=daily-metrics-collector.d.ts.map

package/dist/daily-metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-metrics-collector.d.ts","sourceRoot":"","sources":["../src/daily-metrics-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,qBAAa,qBAAqB;IACpB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAErC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CA6CxE"}

package/dist/daily-metrics-collector.js

@@ -0,0 +1,47 @@
+import { searchAnalytics } from "@pagebridge/db";
+import { and, eq, gte, lte } from "drizzle-orm";
+import { daysAgo, formatDate } from "./utils/date-utils.js";
+export class DailyMetricsCollector {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Collects 28 days of daily metrics per page for sparkline charts.
+     * Returns a Map keyed by page URL.
+     */
+    async collect(siteId) {
+        const startDate = daysAgo(31); // extra days for buffer
+        const endDate = daysAgo(3);
+        const results = await this.db
+            .select({
+            page: searchAnalytics.page,
+            date: searchAnalytics.date,
+            clicks: searchAnalytics.clicks,
+            impressions: searchAnalytics.impressions,
+            position: searchAnalytics.position,
+        })
+            .from(searchAnalytics)
+            .where(and(eq(searchAnalytics.siteId, siteId), gte(searchAnalytics.date, formatDate(startDate)), lte(searchAnalytics.date, formatDate(endDate))));
+        const map = new Map();
+        for (const row of results) {
+            const existing = map.get(row.page) ?? [];
+            existing.push({
+                date: row.date,
+                clicks: row.clicks ?? 0,
+                impressions: row.impressions ?? 0,
+                position: row.position ?? 0,
+            });
+            map.set(row.page, existing);
+        }
+        // Sort each page's points by date
+        for (const [page, points] of map) {
+            points.sort((a, b) => a.date.localeCompare(b.date));
+            // Keep last 28 points
+            if (points.length > 28) {
+                map.set(page, points.slice(-28));
+            }
+        }
+        return map;
+    }
+}

package/dist/decay-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decay-detector.d.ts","sourceRoot":"","sources":["../src/decay-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAAG,kBAAkB,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,kBAAkB,CAAC;IAC1D,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AASD,eAAO,MAAM,YAAY,EAAE,SAAS,EAsBnC,CAAC;AAEF,qBAAa,aAAa;IAEtB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,KAAK;gBADL,EAAE,EAAE,aAAa,EACjB,KAAK,GAAE,SAAS,EAAiB;IAGrC,WAAW,CACf,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACjC,WAAW,GAAE,iBAA+C,GAC3D,OAAO,CAAC,WAAW,EAAE,CAAC;YAsCX,iBAAiB;IA8B/B,OAAO,CAAC,YAAY;IAwEpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;CAgB3B"}
+{"version":3,"file":"decay-detector.d.ts","sourceRoot":"","sources":["../src/decay-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAAG,kBAAkB,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,kBAAkB,CAAC;IAC1D,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AASD,eAAO,MAAM,YAAY,EAAE,SAAS,EAsBnC,CAAC;AAEF,qBAAa,aAAa;IAEtB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,KAAK;gBADL,EAAE,EAAE,aAAa,EACjB,KAAK,GAAE,SAAS,EAAiB;IAGrC,WAAW,CACf,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACjC,WAAW,GAAE,iBAA+C,GAC3D,OAAO,CAAC,WAAW,EAAE,CAAC;YAsCX,iBAAiB;IA8B/B,OAAO,CAAC,YAAY;IAwEpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;CAgB3B"}

package/dist/decay-detector.js

@@ -1,5 +1,6 @@
 import { searchAnalytics } from "@pagebridge/db";
 import { and, avg, gte, lte, sql, eq } from "drizzle-orm";
+import { daysAgo, daysSince, formatDate } from "./utils/date-utils.js";
 export const defaultRules = [
     {
         type: "position_decay",
@@ -160,16 +161,3 @@ export class DecayDetector {
         return Array.from(byPage.values());
     }
 }
-function daysAgo(days) {
-    const date = new Date();
-    date.setDate(date.getDate() - days);
-    return date;
-}
-function daysSince(date) {
-    const now = new Date();
-    const diff = now.getTime() - date.getTime();
-    return Math.floor(diff / (1000 * 60 * 60 * 24));
-}
-function formatDate(date) {
-    return date.toISOString().split("T")[0];
-}

package/dist/index.d.ts

@@ -1,6 +1,14 @@
 export { GSCClient, type GSCClientOptions, type IndexStatusResult, type IndexVerdict, } from "./gsc-client.js";
-export { SyncEngine, type SyncOptions, type SyncResult, type IndexStatusSyncResult, } from "./sync-engine.js";
+export { SyncEngine, type SyncOptions, type SyncResult, type IndexStatusSyncResult, type SnapshotInsights, type PublishingImpact, type CannibalizationTarget, type DailyMetricPoint, } from "./sync-engine.js";
 export { DecayDetector, defaultRules, type DecayRule, type DecaySignal, type QuietPeriodConfig, } from "./decay-detector.js";
 export { URLMatcher, type MatchResult, type URLMatcherConfig, type UnmatchReason, type MatchDiagnostics, } from "./url-matcher.js";
 export { TaskGenerator, type TaskGeneratorOptions, type QueryContext, } from "./task-generator.js";
+export { QuickWinAnalyzer, type QuickWinQuery, type QuickWinConfig, } from "./quick-win-analyzer.js";
+export { CtrAnomalyAnalyzer, EXPECTED_CTR_BY_POSITION, type CtrAnomaly, type CtrAnomalySeverity, type CtrAnomalyConfig, type InsightAlert, } from "./ctr-anomaly-analyzer.js";
+export { DailyMetricsCollector } from "./daily-metrics-collector.js";
+export { PublishingImpactAnalyzer, type EditDateInfo, } from "./publishing-impact-analyzer.js";
+export { CannibalizationAnalyzer, type CannibalizationGroup, type CannibalizationConfig, } from "./cannibalization-analyzer.js";
+export { SiteInsightAnalyzer, type SiteInsightData, type TopPerformer, type ZeroClickPage, type OrphanPage, type NewKeywordOpportunity, } from "./site-insight-analyzer.js";
+export { InsightWriter } from "./insight-writer.js";
+export { daysAgo, formatDate, daysSince } from "./utils/date-utils.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -3,3 +3,11 @@ export { SyncEngine, } from "./sync-engine.js";
 export { DecayDetector, defaultRules, } from "./decay-detector.js";
 export { URLMatcher, } from "./url-matcher.js";
 export { TaskGenerator, } from "./task-generator.js";
+export { QuickWinAnalyzer, } from "./quick-win-analyzer.js";
+export { CtrAnomalyAnalyzer, EXPECTED_CTR_BY_POSITION, } from "./ctr-anomaly-analyzer.js";
+export { DailyMetricsCollector } from "./daily-metrics-collector.js";
+export { PublishingImpactAnalyzer, } from "./publishing-impact-analyzer.js";
+export { CannibalizationAnalyzer, } from "./cannibalization-analyzer.js";
+export { SiteInsightAnalyzer, } from "./site-insight-analyzer.js";
+export { InsightWriter } from "./insight-writer.js";
+export { daysAgo, formatDate, daysSince } from "./utils/date-utils.js";

package/dist/insight-generator.d.ts

@@ -0,0 +1,100 @@
+import { type CtrAnomaly } from "./ctr-anomaly-analyzer.js";
+import type { DecaySignal } from "./decay-detector.js";
+import type { QuickWinQuery } from "./quick-win-analyzer.js";
+/**
+ * Represents a single insight with unified structure
+ */
+export interface SeoInsightData {
+    insightId: string;
+    insightType: "quick_win" | "ctr_anomaly" | "position_decay" | "low_ctr" | "impressions_drop" | "cannibalization" | "zero_click" | "new_keyword" | "publishing_impact";
+    status: "open";
+    priority: "low" | "medium" | "high" | "critical";
+    opportunityScore: number;
+    reason: string;
+    recommendation: string;
+    url: string;
+    pathScope: string;
+    property?: string;
+    linkedDocumentId?: string;
+    metrics: Record<string, number>;
+    queries?: Array<{
+        query: string;
+        impressions: number;
+        clicks: number;
+        position: number;
+    }>;
+    dateRange: {
+        start: string;
+        end: string;
+    };
+    detectedAt: string;
+}
+export interface CannibalizationTarget {
+    competingPage: string;
+    competingDocumentId?: string;
+    sharedQueries: string[];
+}
+export interface MatchResult {
+    gscUrl: string;
+    sanityId?: string;
+    documentTitle?: string;
+}
+export interface ZeroClickPage {
+    page: string;
+    documentId?: string;
+    documentTitle?: string;
+    impressions: number;
+    clicks: number;
+}
+export interface NewKeywordOpportunity {
+    query: string;
+    page: string;
+    documentId?: string;
+    impressions: number;
+    position: number;
+}
+export interface PublishingImpact {
+    lastEditedAt: string;
+    daysSinceEdit: number;
+    positionBefore?: number;
+    positionAfter?: number;
+    positionDelta?: number;
+    clicksBefore?: number;
+    clicksAfter?: number;
+    impressionsBefore?: number;
+    impressionsAfter?: number;
+    ctrBefore?: number;
+    ctrAfter?: number;
+}
+export interface InsightGeneratorOptions {
+    quickWins?: Map<string, QuickWinQuery[]>;
+    ctrAnomalies?: Map<string, CtrAnomaly>;
+    decaySignals?: DecaySignal[];
+    cannibalizationTargets?: Map<string, CannibalizationTarget[]>;
+    publishingImpact?: Map<string, PublishingImpact>;
+    zeroClickPages?: ZeroClickPage[];
+    newKeywords?: NewKeywordOpportunity[];
+    matches?: MatchResult[];
+}
+/**
+ * Converts all analyzer outputs into unified insight documents
+ */
+export declare class InsightGenerator {
+    private siteId;
+    private property;
+    constructor(siteId: string, property: string);
+    /**
+     * Generate unified insights from all analyzer results
+     * Returns a Map keyed by insightId for idempotency
+     */
+    generate(options: InsightGeneratorOptions): Map<string, SeoInsightData>;
+    private makeId;
+    private prioritizeQuickWin;
+    private scoreQuickWin;
+    private scoreCtrAnomaly;
+    private scoreDecay;
+    private estimateCtrFromPosition;
+    private formatDecayReason;
+    private formatDecayRecommendation;
+}
+//# sourceMappingURL=insight-generator.d.ts.map

package/dist/insight-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-generator.d.ts","sourceRoot":"","sources":["../src/insight-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EACP,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,SAAS,GACT,kBAAkB,GAClB,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,mBAAmB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,sBAAsB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC9D,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,QAAQ;gBAAhC,MAAM,EAAE,MAAM,EAAU,QAAQ,EAAE,MAAM;IAE5D;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IA6OvE,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,yBAAyB;CAYlC"}