@pagebridge/core 0.0.3 → 0.1.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/index.d.ts

@@ -3,4 +3,5 @@ export { SyncEngine, type SyncOptions, type SyncResult, type IndexStatusSyncResu
 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";
 //# 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,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;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -3,3 +3,4 @@ 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";

package/dist/quick-win-analyzer.d.ts

@@ -0,0 +1,30 @@
+import type { DrizzleClient } from "@pagebridge/db";
+export interface QuickWinQuery {
+    query: string;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+}
+export interface QuickWinConfig {
+    /** Minimum average position to qualify (default: 8) */
+    positionMin: number;
+    /** Maximum average position to qualify (default: 20) */
+    positionMax: number;
+    /** Minimum total impressions to qualify (default: 50) */
+    minImpressions: number;
+    /** Maximum quick wins per page (default: 10) */
+    maxPerPage: number;
+}
+export declare class QuickWinAnalyzer {
+    private db;
+    private config;
+    constructor(db: DrizzleClient, config?: Partial<QuickWinConfig>);
+    /**
+     * Finds "quick win" queries for all pages: queries where position is 8-20
+     * with significant impressions. These are page-1 opportunities where a small
+     * content tweak could improve ranking.
+     */
+    analyze(siteId: string): Promise<Map<string, QuickWinQuery[]>>;
+}
+//# sourceMappingURL=quick-win-analyzer.d.ts.map

package/dist/quick-win-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-win-analyzer.d.ts","sourceRoot":"","sources":["../src/quick-win-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,EAAE;IAHZ,OAAO,CAAC,MAAM,CAAiB;gBAGrB,EAAE,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKlC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CA4DrE"}

package/dist/quick-win-analyzer.js

@@ -0,0 +1,73 @@
+import { queryAnalytics } from "@pagebridge/db";
+import { and, eq, gte, lte, sql } from "drizzle-orm";
+const defaultConfig = {
+    positionMin: 8,
+    positionMax: 20,
+    minImpressions: 50,
+    maxPerPage: 10,
+};
+export class QuickWinAnalyzer {
+    db;
+    config;
+    constructor(db, config) {
+        this.db = db;
+        this.config = { ...defaultConfig, ...config };
+    }
+    /**
+     * Finds "quick win" queries for all pages: queries where position is 8-20
+     * with significant impressions. These are page-1 opportunities where a small
+     * content tweak could improve ranking.
+     */
+    async analyze(siteId) {
+        const startDate = daysAgo(28);
+        const endDate = daysAgo(3);
+        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);
+        const quickWins = 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.positionMin ||
+                position > this.config.positionMax ||
+                impressions < this.config.minImpressions) {
+                continue;
+            }
+            const entry = {
+                query: row.query,
+                clicks,
+                impressions,
+                ctr: impressions > 0 ? clicks / impressions : 0,
+                position,
+            };
+            const existing = quickWins.get(row.page) ?? [];
+            existing.push(entry);
+            quickWins.set(row.page, existing);
+        }
+        // Sort by impressions desc and cap per page
+        for (const [page, queries] of quickWins) {
+            queries.sort((a, b) => b.impressions - a.impressions);
+            if (queries.length > this.config.maxPerPage) {
+                quickWins.set(page, queries.slice(0, this.config.maxPerPage));
+            }
+        }
+        return quickWins;
+    }
+}
+function daysAgo(days) {
+    const date = new Date();
+    date.setDate(date.getDate() - days);
+    return date;
+}
+function formatDate(date) {
+    return date.toISOString().split("T")[0];
+}

package/dist/sync-engine.d.ts

@@ -1,11 +1,13 @@
 import type { DrizzleClient } from "@pagebridge/db";
 import type { SanityClient } from "@sanity/client";
 import type { GSCClient, IndexStatusResult } from "./gsc-client.js";
+import type { QuickWinQuery } from "./quick-win-analyzer.js";
 export interface SyncOptions {
     siteUrl: string;
     startDate?: Date;
     endDate?: Date;
     dimensions?: ("page" | "query" | "date")[];
+    onProgress?: (message: string) => void;
 }
 export interface SyncResult {
     pages: string[];
@@ -32,7 +34,9 @@ export declare class SyncEngine {
     writeSnapshots(siteId: string, matches: {
         gscUrl: string;
         sanityId: string | undefined;
-    }[], siteUrl?: string): Promise<void>;
+    }[], siteUrl?: string, insights?: {
+        quickWins?: Map<string, QuickWinQuery[]>;
+    }, onProgress?: (message: string) => void): Promise<void>;
     syncIndexStatus(siteUrl: string, pages: string[]): Promise<IndexStatusSyncResult>;
     getIndexStatus(siteUrl: string, page: string): Promise<IndexStatusResult | null>;
     private getAggregatedMetrics;

package/dist/sync-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../src/sync-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,EAAE,EAAE,aAAa,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE,iBAAiB;IAMhC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA+G/C,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,EAC3D,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmFV,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,qBAAqB,CAAC;IA6E3B,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAqBtB,oBAAoB;YAiDpB,aAAa;CAyD5B"}
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../src/sync-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,EAAE,EAAE,aAAa,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE,iBAAiB;IAMhC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAgK/C,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,EAC3D,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;KAC1C,EACD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,IAAI,CAAC;IAqIV,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,qBAAqB,CAAC;IA6E3B,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAqBtB,oBAAoB;YAiDpB,aAAa;CAyD5B"}

package/dist/sync-engine.js

@@ -1,5 +1,5 @@
 import { searchAnalytics, queryAnalytics, syncLog, pageIndexStatus, } from "@pagebridge/db";
-import { and, eq, gte, lte } from "drizzle-orm";
+import { and, eq, gte, lte, sql } from "drizzle-orm";
 export class SyncEngine {
     gsc;
     db;
@@ -10,7 +10,8 @@ export class SyncEngine {
         this.sanity = options.sanity;
     }
     async sync(options) {
-        const { siteUrl, startDate = daysAgo(90), endDate = daysAgo(3), dimensions = ["page", "date"], } = options;
+        const { siteUrl, startDate = daysAgo(90), endDate = daysAgo(3), dimensions = ["page", "query", "date"], onProgress, } = options;
+        const progress = onProgress ?? (() => { });
         const syncLogId = `${siteUrl}:${Date.now()}`;
         await this.db.insert(syncLog).values({
             id: syncLogId,
@@ -19,77 +20,112 @@ export class SyncEngine {
             status: "running",
         });
         try {
-            const rows = await this.gsc.fetchSearchAnalytics({
-                siteUrl,
-                startDate,
-                endDate,
-                dimensions,
-            });
+            // Fetch page-level and query-level data in parallel
+            const fetchQuery = dimensions.includes("query");
+            progress("Fetching data from Google Search Console...");
+            const [pageRows, queryRows] = await Promise.all([
+                this.gsc.fetchSearchAnalytics({
+                    siteUrl,
+                    startDate,
+                    endDate,
+                    dimensions: ["page", "date"],
+                }),
+                fetchQuery
+                    ? this.gsc.fetchSearchAnalytics({
+                        siteUrl,
+                        startDate,
+                        endDate,
+                        dimensions: ["page", "query", "date"],
+                    })
+                    : Promise.resolve([]),
+            ]);
+            progress(`Fetched ${pageRows.length} page rows` +
+                (fetchQuery ? ` and ${queryRows.length} query rows` : "") +
+                ` from GSC`);
             const pages = new Set();
-            for (const row of rows) {
+            for (const row of pageRows)
                 pages.add(row.page);
-                if (row.date) {
-                    const id = `${siteUrl}:${row.page}:${row.date}`;
-                    await this.db
-                        .insert(searchAnalytics)
-                        .values({
-                        id,
-                        siteId: siteUrl,
-                        page: row.page,
-                        date: row.date,
-                        clicks: row.clicks,
-                        impressions: row.impressions,
-                        ctr: row.ctr,
-                        position: row.position,
-                    })
-                        .onConflictDoUpdate({
-                        target: searchAnalytics.id,
-                        set: {
-                            clicks: row.clicks,
-                            impressions: row.impressions,
-                            ctr: row.ctr,
-                            position: row.position,
-                            fetchedAt: new Date(),
-                        },
-                    });
-                }
-                if (row.query && row.date) {
-                    const id = `${siteUrl}:${row.page}:${row.query}:${row.date}`;
-                    await this.db
-                        .insert(queryAnalytics)
-                        .values({
-                        id,
-                        siteId: siteUrl,
-                        page: row.page,
-                        query: row.query,
-                        date: row.date,
-                        clicks: row.clicks,
-                        impressions: row.impressions,
-                        ctr: row.ctr,
-                        position: row.position,
-                    })
-                        .onConflictDoUpdate({
-                        target: queryAnalytics.id,
-                        set: {
-                            clicks: row.clicks,
-                            impressions: row.impressions,
-                            ctr: row.ctr,
-                            position: row.position,
-                        },
-                    });
-                }
+            for (const row of queryRows)
+                pages.add(row.page);
+            const BATCH_SIZE = 500;
+            // Write page-level data to search_analytics
+            const pageValues = pageRows
+                .filter((row) => row.date)
+                .map((row) => ({
+                id: `${siteUrl}:${row.page}:${row.date}`,
+                siteId: siteUrl,
+                page: row.page,
+                date: row.date,
+                clicks: row.clicks,
+                impressions: row.impressions,
+                ctr: row.ctr,
+                position: row.position,
+            }));
+            for (let i = 0; i < pageValues.length; i += BATCH_SIZE) {
+                const batch = pageValues.slice(i, i + BATCH_SIZE);
+                await this.db
+                    .insert(searchAnalytics)
+                    .values(batch)
+                    .onConflictDoUpdate({
+                    target: searchAnalytics.id,
+                    set: {
+                        clicks: sql `excluded.clicks`,
+                        impressions: sql `excluded.impressions`,
+                        ctr: sql `excluded.ctr`,
+                        position: sql `excluded.position`,
+                        fetchedAt: new Date(),
+                    },
+                });
+                progress(`Writing page data... ${Math.min(i + BATCH_SIZE, pageValues.length)}/${pageValues.length} rows`);
             }
+            if (pageValues.length > 0) {
+                progress(`Wrote ${pageValues.length} page rows to database`);
+            }
+            // Write query-level data to query_analytics
+            const queryValues = queryRows
+                .filter((row) => row.query && row.date)
+                .map((row) => ({
+                id: `${siteUrl}:${row.page}:${row.query}:${row.date}`,
+                siteId: siteUrl,
+                page: row.page,
+                query: row.query,
+                date: row.date,
+                clicks: row.clicks,
+                impressions: row.impressions,
+                ctr: row.ctr,
+                position: row.position,
+            }));
+            for (let i = 0; i < queryValues.length; i += BATCH_SIZE) {
+                const batch = queryValues.slice(i, i + BATCH_SIZE);
+                await this.db
+                    .insert(queryAnalytics)
+                    .values(batch)
+                    .onConflictDoUpdate({
+                    target: queryAnalytics.id,
+                    set: {
+                        clicks: sql `excluded.clicks`,
+                        impressions: sql `excluded.impressions`,
+                        ctr: sql `excluded.ctr`,
+                        position: sql `excluded.position`,
+                    },
+                });
+                progress(`Writing query data... ${Math.min(i + BATCH_SIZE, queryValues.length)}/${queryValues.length} rows`);
+            }
+            if (queryValues.length > 0) {
+                progress(`Wrote ${queryValues.length} query rows to database`);
+            }
+            const totalRows = pageRows.length + queryRows.length;
             await this.db
                 .update(syncLog)
                 .set({
                 status: "completed",
                 completedAt: new Date(),
-                rowsProcessed: rows.length,
+                rowsProcessed: totalRows,
             })
                 .where(eq(syncLog.id, syncLogId));
             return {
                 pages: Array.from(pages),
-                rowsProcessed: rows.length,
+                rowsProcessed: totalRows,
                 syncLogId,
             };
         }
@@ -105,7 +141,8 @@ export class SyncEngine {
             throw error;
         }
     }
-    async writeSnapshots(siteId, matches, siteUrl) {
+    async writeSnapshots(siteId, matches, siteUrl, insights, onProgress) {
+        const progress = onProgress ?? (() => { });
         // Get the siteUrl from Sanity if not provided
         let resolvedSiteUrl = siteUrl;
         if (!resolvedSiteUrl) {
@@ -115,32 +152,59 @@ export class SyncEngine {
         if (!resolvedSiteUrl) {
             throw new Error(`Could not find siteUrl for site ID: ${siteId}`);
         }
+        const validMatches = matches.filter((m) => m.sanityId);
+        // Pre-fetch all existing snapshot IDs in one query
+        progress(`Checking existing snapshots for ${validMatches.length} pages...`);
+        const existingSnapshots = await this.sanity.fetch(`*[_type == "gscSnapshot" && site._ref == $siteId]{ _id, page, period }`, { siteId });
+        const snapshotIdMap = new Map();
+        for (const snap of existingSnapshots) {
+            snapshotIdMap.set(`${snap.page}:${snap.period}`, snap._id);
+        }
         const periods = ["last7", "last28", "last90"];
         const periodDays = { last7: 7, last28: 28, last90: 90 };
+        // Pre-fetch index status for all pages in parallel
+        const indexStatusMap = new Map();
+        await Promise.all(validMatches.map(async (match) => {
+            const status = await this.getIndexStatus(resolvedSiteUrl, match.gscUrl);
+            indexStatusMap.set(match.gscUrl, status);
+        }));
+        // Build all snapshot data, querying DB in parallel per match
+        progress(`Computing metrics for ${validMatches.length} pages × ${periods.length} periods...`);
+        const transaction = this.sanity.transaction();
+        let mutationCount = 0;
         for (const period of periods) {
             const startDate = daysAgo(periodDays[period]);
             const endDate = daysAgo(3);
-            for (const match of matches) {
-                if (!match.sanityId)
-                    continue;
-                const metrics = await this.getAggregatedMetrics(resolvedSiteUrl, match.gscUrl, startDate, endDate);
+            // Fetch metrics and top queries in parallel for all matches in this period
+            const matchData = await Promise.all(validMatches.map(async (match) => {
+                const [metrics, topQueries] = await Promise.all([
+                    this.getAggregatedMetrics(resolvedSiteUrl, match.gscUrl, startDate, endDate),
+                    this.getTopQueries(resolvedSiteUrl, match.gscUrl, startDate, endDate),
+                ]);
+                return { match, metrics, topQueries };
+            }));
+            for (const { match, metrics, topQueries } of matchData) {
                 if (!metrics)
                     continue;
-                const topQueries = await this.getTopQueries(resolvedSiteUrl, match.gscUrl, startDate, endDate);
-                // Get index status from database
-                const indexStatusData = await this.getIndexStatus(resolvedSiteUrl, match.gscUrl);
-                const existingSnapshot = await this.sanity.fetch(`*[_type == "gscSnapshot" && site._ref == $siteId && page == $page && period == $period][0]._id`, { siteId, page: match.gscUrl, period });
+                const indexStatusData = indexStatusMap.get(match.gscUrl);
+                const quickWinQueries = period === "last28"
+                    ? (insights?.quickWins?.get(match.gscUrl) ?? [])
+                    : [];
                 const snapshotData = {
                     _type: "gscSnapshot",
                     site: { _type: "reference", _ref: siteId },
                     page: match.gscUrl,
-                    linkedDocument: { _type: "reference", _ref: match.sanityId },
+                    linkedDocument: {
+                        _type: "reference",
+                        _ref: match.sanityId,
+                    },
                     period,
                     clicks: metrics.clicks,
                     impressions: metrics.impressions,
                     ctr: metrics.ctr,
                     position: metrics.position,
                     topQueries,
+                    ...(quickWinQueries.length > 0 ? { quickWinQueries } : {}),
                     fetchedAt: new Date().toISOString(),
                     indexStatus: indexStatusData
                         ? {
@@ -152,14 +216,18 @@ export class SyncEngine {
                         }
                         : undefined,
                 };
-                if (existingSnapshot) {
-                    await this.sanity.patch(existingSnapshot).set(snapshotData).commit();
+                const existingId = snapshotIdMap.get(`${match.gscUrl}:${period}`);
+                if (existingId) {
+                    transaction.patch(existingId, (p) => p.set(snapshotData));
                 }
                 else {
-                    await this.sanity.create(snapshotData);
+                    transaction.create(snapshotData);
                 }
+                mutationCount++;
             }
         }
+        progress(`Committing ${mutationCount} snapshot mutations...`);
+        await transaction.commit();
     }
     async syncIndexStatus(siteUrl, pages) {
         const result = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagebridge/core",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "Core engine for PageBridge — GSC sync, URL matching, content decay detection, and task generation",
   "license": "MIT",
   "private": false,