vite-plugin-smart-prefetch 0.3.4 → 0.3.6

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BigQueryAnalyticsConnector: () => BigQueryAnalyticsConnector,
   smartPrefetch: () => smartPrefetch
 });
 module.exports = __toCommonJS(index_exports);
@@ -42,7 +43,7 @@ var BigQueryAnalyticsConnector = class {
   constructor(projectId, datasetId, location = "asia-south1", debug = false) {
     this.projectId = projectId;
     this.datasetId = datasetId;
-    this.location = location;
+    this.location = location && location !== "asia" ? location : "asia-south1";
     this.debug = debug;
     this.bigquery = new import_bigquery.BigQuery({
       projectId
@@ -51,7 +52,8 @@ var BigQueryAnalyticsConnector = class {
       console.log("\u2705 BigQuery Analytics connector initialized");
       console.log(`   Project ID: ${projectId}`);
       console.log(`   Dataset ID: ${datasetId}`);
-      console.log(`   Location: ${location}`);
+      console.log(`   Location: ${this.location}`);
+      console.log(`   Querying daily events tables: ${projectId}.${datasetId}.events_*`);
     }
   }
   /**
@@ -61,20 +63,27 @@ var BigQueryAnalyticsConnector = class {
   async fetchNavigationSequences(config = {}) {
     const { days = 30 } = config;
     const minSessions = 1;
-    console.log(`\u{1F4CA} Fetching navigation data from BigQuery...`);
-    console.log(`   Dataset: ${this.datasetId}`);
+    console.log(`
+${"\u2550".repeat(60)}`);
+    console.log(`\u{1F4CA} STAGE 1: PREPARING BIGQUERY QUERY`);
+    console.log(`${"\u2550".repeat(60)}`);
+    console.log(`   Project ID: ${this.projectId}`);
+    console.log(`   Dataset ID: ${this.datasetId}`);
+    console.log(`   Location: ${this.location}`);
     console.log(`   Date range: Last ${days} days`);
+    console.log(`   Daily tables pattern: events_*`);
+    console.log(`   Event type filter: page_view`);
+    console.log(`   Expected fields: user_pseudo_id, ga_session_id, page_path`);
     try {
       const query = `
         WITH page_sessions AS (
           SELECT
-            user_id,
+            user_pseudo_id,
             (SELECT value.int_value FROM UNNEST(event_params) WHERE KEY = 'ga_session_id' LIMIT 1) as session_id,
-            (SELECT value.string_value FROM UNNEST(event_params) WHERE KEY = 'page_location' LIMIT 1) as page_location,
             (SELECT value.string_value FROM UNNEST(event_params) WHERE KEY = 'page_path' LIMIT 1) as page_path,
             event_timestamp,
             ROW_NUMBER() OVER (
-              PARTITION BY user_id, (SELECT value.int_value FROM UNNEST(event_params) WHERE KEY = 'ga_session_id' LIMIT 1)
+              PARTITION BY user_pseudo_id, (SELECT value.int_value FROM UNNEST(event_params) WHERE KEY = 'ga_session_id' LIMIT 1)
               ORDER BY event_timestamp
             ) as page_sequence
           FROM \`${this.projectId}.${this.datasetId}.events_*\`
@@ -88,7 +97,7 @@ var BigQueryAnalyticsConnector = class {
           SELECT
             COALESCE(curr.page_path, '(direct)') as from_page,
             LEAD(curr.page_path) OVER (
-              PARTITION BY curr.user_id, curr.session_id
+              PARTITION BY curr.user_pseudo_id, curr.session_id
               ORDER BY curr.page_sequence
             ) as to_page
           FROM page_sessions curr
@@ -100,52 +109,132 @@ var BigQueryAnalyticsConnector = class {
           COUNT(*) as transition_count
         FROM transitions
         WHERE to_page IS NOT NULL
-        GROUP BY from_page, to_page
+        GROUP BY previous_page_path, page_path
         ORDER BY transition_count DESC
         LIMIT 10000
       `;
       if (this.debug) {
-        console.log(`\u{1F4E4} BigQuery Query:`);
+        console.log(`
+\u{1F4E4} Full BigQuery Query:`);
+        console.log(`${"\u2500".repeat(60)}`);
         console.log(query);
+        console.log(`${"\u2500".repeat(60)}`);
       }
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 2: EXECUTING QUERY`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   \u23F3 Querying BigQuery...`);
       const [rows] = await this.bigquery.query({
         query,
         location: this.location
       });
-      if (this.debug) {
-        console.log(`\u2705 Query executed successfully`);
-        console.log(`   Rows returned: ${rows.length}`);
+      console.log(`   \u2705 Query executed successfully`);
+      console.log(`   \u{1F4C8} Total transitions returned: ${rows.length}`);
+      if (rows.length === 0) {
+        console.log(`
+${"\u2550".repeat(60)}`);
+        console.log(`\u26A0\uFE0F  STAGE 2: NO DATA RETURNED!`);
+        console.log(`${"\u2550".repeat(60)}`);
+        console.log(`   \u274C BigQuery returned 0 rows`);
+        console.log(`
+   Possible causes:`);
+        console.log(`   1. No event tables in date range (events_YYYYMMDD)`);
+        console.log(`   2. No page_view events in those tables`);
+        console.log(`   3. page_path parameter not being tracked`);
+        console.log(`   4. Wrong location (currently: ${this.location})`);
+        console.log(`   5. Wrong dataset name: ${this.datasetId}`);
+        console.log(`
+   Troubleshooting:`);
+        console.log(`   \u2022 Check BigQuery console for available event tables`);
+        console.log(`   \u2022 Verify GA4 property is exporting to BigQuery`);
+        console.log(`   \u2022 Confirm page_path is being captured in GA4`);
+        console.log(`${"\u2550".repeat(60)}
+`);
+        return [];
       }
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 3: PROCESSING RAW DATA`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   Processing ${rows.length} raw transitions...`);
       const navigationData = [];
+      let processedCount = 0;
+      let filteredCount = 0;
+      let emptyPathCount = 0;
+      let lowCountCount = 0;
       const rawData = rows.map((row) => ({
         previous_page_path: row.previous_page_path,
         page_path: row.page_path,
         transition_count: row.transition_count
       }));
-      rows.forEach((row) => {
+      console.log(`
+   ${"\u2500".repeat(56)}`);
+      console.log(`   Processing each transition row...`);
+      console.log(`   ${"\u2500".repeat(56)}`);
+      rows.forEach((row, index) => {
         const previousPage = row.previous_page_path || "(direct)";
         const currentPage = row.page_path || "";
         const transitionCount = parseInt(row.transition_count || "0");
+        if (this.debug && index < 5) {
+          console.log(`
+   Row ${index + 1}:`);
+          console.log(`     Raw: "${previousPage}" \u2192 "${currentPage}" (count: ${transitionCount})`);
+        }
         const normalizedPrevious = previousPage === "(direct)" || previousPage === "(not set)" ? "(direct)" : this.normalizeRoute(previousPage);
         const normalizedCurrent = this.normalizeRoute(currentPage);
+        if (this.debug && index < 5) {
+          console.log(`     Normalized: "${normalizedPrevious}" \u2192 "${normalizedCurrent}"`);
+        }
         if (normalizedCurrent && transitionCount >= minSessions) {
           navigationData.push({
             from: normalizedPrevious,
             to: normalizedCurrent,
             count: transitionCount
           });
+          processedCount++;
+          if (this.debug && index < 5) {
+            console.log(`     \u2705 ACCEPTED`);
+          }
+        } else {
+          filteredCount++;
+          if (!normalizedCurrent) {
+            emptyPathCount++;
+            if (this.debug && index < 5) {
+              console.log(`     \u274C FILTERED: normalized to empty path (likely build artifact)`);
+            }
+          } else if (transitionCount < minSessions) {
+            lowCountCount++;
+            if (this.debug && index < 5) {
+              console.log(`     \u274C FILTERED: transition count ${transitionCount} < minSessions ${minSessions}`);
+            }
+          }
         }
       });
+      console.log(`
+   ${"\u2500".repeat(56)}`);
+      console.log(`   Processing Summary:`);
+      console.log(`   \u2705 Accepted: ${processedCount}`);
+      console.log(`   \u274C Filtered out: ${filteredCount}`);
+      console.log(`      \u2022 Empty paths: ${emptyPathCount}`);
+      console.log(`      \u2022 Low transition count: ${lowCountCount}`);
       this.saveDataForInspection(rawData, navigationData);
-      if (this.debug) {
-        console.log(`\u2705 Processed ${navigationData.length} navigation transitions`);
-        if (navigationData.length > 0) {
-          console.log(`
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 4: FINAL RESULTS`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   Total valid transitions: ${navigationData.length}`);
+      if (navigationData.length === 0) {
+        console.log(`
+   \u26A0\uFE0F  WARNING: All transitions were filtered out!`);
+        console.log(`   Check the logs above to see why rows were rejected.`);
+        console.log(`   Raw data saved to: .bigquery-raw-data/raw-bigquery-response.json`);
+      } else {
+        console.log(`
    Top 5 transitions:`);
-          navigationData.slice(0, 5).forEach((nav, i) => {
-            console.log(`   ${i + 1}. ${nav.from} \u2192 ${nav.to} (${nav.count} transitions)`);
-          });
-        }
+        navigationData.slice(0, 5).forEach((nav, i) => {
+          console.log(`   ${i + 1}. ${nav.from} \u2192 ${nav.to} (${nav.count})`);
+        });
         const uniqueRoutes = /* @__PURE__ */ new Set();
         navigationData.forEach((nav) => {
           if (nav.from !== "(direct)") uniqueRoutes.add(nav.from);
@@ -155,85 +244,45 @@ var BigQueryAnalyticsConnector = class {
    \u{1F4CA} Unique routes: ${uniqueRoutes.size}`);
         console.log(`   Routes: ${Array.from(uniqueRoutes).sort().join(", ")}`);
         console.log(`
-   \u{1F4C1} Raw data saved to: .bigquery-raw-data/`);
+   \u{1F4C1} Data inspection files created:`);
+        console.log(`      \u2022 .bigquery-raw-data/raw-bigquery-response.json`);
+        console.log(`      \u2022 .bigquery-raw-data/processed-navigation-data.json`);
+        console.log(`      \u2022 .bigquery-raw-data/data-transformation-summary.json`);
       }
+      console.log(`${"\u2550".repeat(60)}
+`);
       return navigationData;
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "Unknown error";
+      const errorMessage = error instanceof Error ? error.message : String(error) || "Unknown error";
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u274C ERROR: QUERY EXECUTION FAILED`);
+      console.log(`${"\u2550".repeat(60)}`);
       if (errorMessage.includes("bigquery.jobs.create") || errorMessage.includes("PERMISSION_DENIED")) {
-        console.error("\u274C Failed to fetch BigQuery data: Permission Denied");
-        console.error("   Service account needs BigQuery Job User role in the project");
-        console.error("   Error details:", errorMessage);
+        console.error(`   \u274C Permission Denied`);
+        console.error(`   Service account needs BigQuery Job User role in project: ${this.projectId}`);
+        console.error(`   Error: ${errorMessage}`);
+      } else if (errorMessage.includes("was not found")) {
+        console.error(`   \u274C Dataset not found`);
+        console.error(`   Cannot find dataset: ${this.projectId}.${this.datasetId}`);
+        console.error(`   Try a different location or check dataset name`);
+        console.error(`   Current location: ${this.location}`);
+        console.error(`   Error: ${errorMessage}`);
       } else {
-        console.error("\u274C Failed to fetch BigQuery data:", error);
+        const errorType = error instanceof Error ? error.constructor.name : "Unknown";
+        console.error(`   Error type: ${errorType}`);
+        console.error(`   Message: ${errorMessage}`);
       }
+      console.log(`${"\u2550".repeat(60)}
+`);
       throw new Error(
         `BigQuery Analytics error: ${errorMessage}`
       );
     }
   }
-  /**
-   * Map friendly page names (with spaces/capitals) back to route paths
-   * GA4 may log display names instead of URL paths
-   * Examples: "Audit Logs" → "/audit-logs", "API Documentation" → "/api-docs", "Home" → "/"
-   */
-  friendlyNameToRoute(name) {
-    const friendlyToRoute = {
-      // Exact matches (with spaces and capitals)
-      "API Documentation": "/api-docs",
-      "Audit Logs": "/audit-logs",
-      "/Home": "/",
-      "/home": "/",
-      "Home": "/",
-      "/Dashboard": "/dashboard",
-      "Dashboard": "/dashboard",
-      // PascalCase variants (all 27 routes)
-      "Profile": "/profile",
-      "Settings": "/settings",
-      "Preferences": "/preferences",
-      "Privacy": "/privacy",
-      "Security": "/security",
-      "Analytics": "/analytics",
-      "Reports": "/reports",
-      "Metrics": "/metrics",
-      "Projects": "/projects",
-      "Tasks": "/tasks",
-      "Teams": "/teams",
-      "Workspaces": "/workspaces",
-      "Workflows": "/workflows",
-      "Templates": "/templates",
-      "Logs": "/logs",
-      "AuditLogs": "/audit-logs",
-      "Integrations": "/integrations",
-      "ApiDocs": "/api-docs",
-      "Support": "/support",
-      "Help": "/help",
-      "Billing": "/billing",
-      "Plans": "/plans",
-      "Usage": "/usage",
-      "Permissions": "/permissions",
-      "Notifications": "/notifications"
-    };
-    if (friendlyToRoute[name]) {
-      return friendlyToRoute[name];
-    }
-    const lowerName = name.toLowerCase();
-    for (const [key, value] of Object.entries(friendlyToRoute)) {
-      if (key.toLowerCase() === lowerName) {
-        return value;
-      }
-    }
-    if (name.startsWith("/")) {
-      if (name === "/") {
-        return "/";
-      }
-      return name.toLowerCase();
-    }
-    return "/" + lowerName;
-  }
   /**
    * Normalize route paths
-   * Converts dynamic segments to parameters and friendly names to route paths
+   * Converts dynamic segments to parameters and standardizes format
    */
   normalizeRoute(path2) {
     const buildArtifacts = [
@@ -247,7 +296,7 @@ var BigQueryAnalyticsConnector = class {
     if (buildArtifacts.some((pattern) => pattern.test(path2))) {
       return "";
     }
-    let normalized = this.friendlyNameToRoute(path2);
+    let normalized = path2;
     normalized = normalized.split("?")[0].split("#")[0];
     if (normalized.length > 1 && normalized.endsWith("/")) {
       normalized = normalized.slice(0, -1);
@@ -304,28 +353,49 @@ var BigQueryAnalyticsConnector = class {
     }
   }
   /**
-   * Fetch navigation data WITH segment information
-   * Includes segment/role field so plugin can group by any role dynamically
-   * @param config - Data range configuration
-   * @returns Navigation data with segment field included
+   * Fetch navigation data WITH optional segment information
+   * Only includes segment/grouping field when explicitly requested
+   * @param config - Data range configuration with optional segmentField
+   * @returns Navigation data, optionally with segment field included
    */
   async fetchNavigationWithSegments(config = {}) {
-    const { days = 30 } = config;
-    console.log(`\u{1F4CA} Fetching navigation data with segments from BigQuery...`);
-    console.log(`   Dataset: ${this.datasetId}`);
+    const { days = 30, segmentField } = config;
+    if (!segmentField) {
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 1: PREPARING BIGQUERY QUERY (SEGMENTED)`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   \u26A0\uFE0F  No segment field specified`);
+      console.log(`   Falling back to fetchNavigationSequences (base data only)`);
+      console.log(`   To include segments, pass: { segmentField: 'field_name' }`);
+      console.log(`${"\u2550".repeat(60)}
+`);
+      return this.fetchNavigationSequences(config);
+    }
+    console.log(`
+${"\u2550".repeat(60)}`);
+    console.log(`\u{1F4CA} STAGE 1: PREPARING SEGMENTED BIGQUERY QUERY`);
+    console.log(`${"\u2550".repeat(60)}`);
+    console.log(`   Project ID: ${this.projectId}`);
+    console.log(`   Dataset ID: ${this.datasetId}`);
+    console.log(`   Location: ${this.location}`);
     console.log(`   Date range: Last ${days} days`);
+    console.log(`   Daily tables pattern: events_*`);
+    console.log(`   Event type filter: page_view`);
+    console.log(`   Segment field: ${segmentField}`);
+    console.log(`   Expected fields: user_pseudo_id, ga_session_id, page_path, ${segmentField}`);
     try {
+      const segmentParam = `(SELECT value.string_value FROM UNNEST(event_params) WHERE KEY = '${segmentField}' LIMIT 1) as segment_value`;
       const query = `
         WITH page_sessions AS (
           SELECT
-            user_id,
+            user_pseudo_id,
             (SELECT value.int_value FROM UNNEST(event_params) WHERE KEY = 'ga_session_id' LIMIT 1) as session_id,
             (SELECT value.string_value FROM UNNEST(event_params) WHERE KEY = 'page_path' LIMIT 1) as page_path,
-            (SELECT value.string_value FROM UNNEST(event_params) WHERE KEY = 'user_role' LIMIT 1) as user_role,
-            (SELECT value.string_value FROM UNNEST(event_params) WHERE KEY = 'user_segment' LIMIT 1) as user_segment,
+            ${segmentParam},
             event_timestamp,
             ROW_NUMBER() OVER (
-              PARTITION BY user_id, (SELECT value.int_value FROM UNNEST(event_params) WHERE KEY = 'ga_session_id' LIMIT 1)
+              PARTITION BY user_pseudo_id, (SELECT value.int_value FROM UNNEST(event_params) WHERE KEY = 'ga_session_id' LIMIT 1)
               ORDER BY event_timestamp
             ) as page_sequence
           FROM \`${this.projectId}.${this.datasetId}.events_*\`
@@ -339,10 +409,10 @@ var BigQueryAnalyticsConnector = class {
           SELECT
             COALESCE(curr.page_path, '(direct)') as from_page,
             LEAD(curr.page_path) OVER (
-              PARTITION BY curr.user_id, curr.session_id
+              PARTITION BY curr.user_pseudo_id, curr.session_id
               ORDER BY curr.page_sequence
             ) as to_page,
-            COALESCE(curr.user_role, curr.user_segment, 'unknown') as segment
+            COALESCE(curr.segment_value, 'unknown') as segment
           FROM page_sessions curr
           WHERE curr.page_sequence > 0
         )
@@ -353,45 +423,104 @@ var BigQueryAnalyticsConnector = class {
           COUNT(*) as transition_count
         FROM transitions
         WHERE to_page IS NOT NULL
-        GROUP BY from_page, to_page, segment
+        GROUP BY previous_page_path, page_path, segment
         ORDER BY segment, transition_count DESC
         LIMIT 50000
       `;
       if (this.debug) {
-        console.log(`\u{1F4E4} Query with segments:`);
+        console.log(`
+\u{1F4E4} Full Query with segment field (${segmentField}):`);
+        console.log(`${"\u2500".repeat(60)}`);
         console.log(query);
+        console.log(`${"\u2500".repeat(60)}`);
       }
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 2: EXECUTING QUERY`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   \u23F3 Querying BigQuery with segment field: ${segmentField}`);
       const [rows] = await this.bigquery.query({
         query,
         location: this.location
       });
-      if (this.debug) {
-        console.log(`\u2705 Query executed successfully`);
-        console.log(`   Rows returned: ${rows.length}`);
+      console.log(`   \u2705 Query executed successfully`);
+      console.log(`   \u{1F4C8} Total transitions returned: ${rows.length}`);
+      if (rows.length === 0) {
+        console.log(`
+${"\u2550".repeat(60)}`);
+        console.log(`\u26A0\uFE0F  STAGE 2: NO DATA RETURNED!`);
+        console.log(`${"\u2550".repeat(60)}`);
+        console.log(`   \u274C BigQuery returned 0 rows for segmented query`);
+        console.log(`   Segment field: ${segmentField}`);
+        console.log(`   Check if this field exists in your GA4 event_params`);
+        console.log(`${"\u2550".repeat(60)}
+`);
+        return [];
       }
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 3: PROCESSING SEGMENTED DATA`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   Processing ${rows.length} raw transitions with segments...`);
       const navigationData = [];
-      rows.forEach((row) => {
+      let processedCount = 0;
+      let filteredCount = 0;
+      const segmentCounts = /* @__PURE__ */ new Map();
+      console.log(`
+   ${"\u2500".repeat(56)}`);
+      console.log(`   Processing each transition row...`);
+      console.log(`   ${"\u2500".repeat(56)}`);
+      rows.forEach((row, index) => {
         const previousPage = row.previous_page_path || "(direct)";
         const currentPage = row.page_path || "";
         const transitionCount = parseInt(row.transition_count || "0");
         const segment = row.segment || "unknown";
+        if (this.debug && index < 3) {
+          console.log(`
+   Row ${index + 1}:`);
+          console.log(`     Raw: "${previousPage}" \u2192 "${currentPage}" | segment: "${segment}" (count: ${transitionCount})`);
+        }
         const normalizedPrevious = previousPage === "(direct)" || previousPage === "(not set)" ? "(direct)" : this.normalizeRoute(previousPage);
         const normalizedCurrent = this.normalizeRoute(currentPage);
+        if (this.debug && index < 3) {
+          console.log(`     Normalized: "${normalizedPrevious}" \u2192 "${normalizedCurrent}" | segment: "${segment}"`);
+        }
         if (normalizedCurrent && transitionCount >= 1) {
           navigationData.push({
             from: normalizedPrevious,
             to: normalizedCurrent,
             count: transitionCount,
             segment
-            // Include segment/role field
           });
+          processedCount++;
+          segmentCounts.set(segment, (segmentCounts.get(segment) || 0) + 1);
+          if (this.debug && index < 3) {
+            console.log(`     \u2705 ACCEPTED`);
+          }
+        } else {
+          filteredCount++;
+          if (this.debug && index < 3) {
+            console.log(`     \u274C FILTERED`);
+          }
         }
       });
-      if (this.debug && navigationData.length > 0) {
-        console.log(`\u2705 Processed ${navigationData.length} transitions with segment data`);
-        const uniqueSegments = new Set(navigationData.map((d) => d.segment));
+      console.log(`
+   ${"\u2500".repeat(56)}`);
+      console.log(`   Processing Summary:`);
+      console.log(`   \u2705 Accepted: ${processedCount}`);
+      console.log(`   \u274C Filtered out: ${filteredCount}`);
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u{1F4CA} STAGE 4: FINAL RESULTS (SEGMENTED)`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   Total valid transitions: ${navigationData.length}`);
+      if (navigationData.length > 0) {
+        const uniqueSegments = Array.from(segmentCounts.keys()).sort();
         console.log(`
-   Detected segments: ${Array.from(uniqueSegments).sort().join(", ")}`);
+   \u{1F4CA} Detected segments: ${uniqueSegments.length}`);
+        uniqueSegments.forEach((seg) => {
+          console.log(`      \u2022 ${seg} (${segmentCounts.get(seg)} transitions)`);
+        });
         const bySegment = /* @__PURE__ */ new Map();
         navigationData.forEach((d) => {
           if (!bySegment.has(d.segment)) {
@@ -401,42 +530,31 @@ var BigQueryAnalyticsConnector = class {
         });
         bySegment.forEach((transitions, segment) => {
           console.log(`
-   Top 3 transitions for ${segment}:`);
+   Top 3 transitions for segment "${segment}":`);
           transitions.sort((a, b) => b.count - a.count).slice(0, 3).forEach((nav, i) => {
-            console.log(`   ${i + 1}. ${nav.from} \u2192 ${nav.to} (${nav.count} transitions)`);
+            console.log(`      ${i + 1}. ${nav.from} \u2192 ${nav.to} (${nav.count})`);
           });
         });
+      } else {
+        console.log(`   \u26A0\uFE0F  WARNING: All transitions were filtered out!`);
       }
+      console.log(`${"\u2550".repeat(60)}
+`);
       return navigationData;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "Unknown error";
+      console.log(`
+${"\u2550".repeat(60)}`);
+      console.log(`\u274C ERROR: SEGMENTED QUERY EXECUTION FAILED`);
+      console.log(`${"\u2550".repeat(60)}`);
+      console.log(`   Segment field: ${segmentField}`);
+      console.log(`   Error: ${errorMessage}`);
+      console.log(`${"\u2550".repeat(60)}
+`);
       console.warn(`\u26A0\uFE0F  Failed to fetch navigation data with segments: ${errorMessage}`);
       return [];
     }
   }
-  /**
-   * Test connection to BigQuery
-   * Note: May fail if service account lacks bigquery.jobs.create permission
-   * but actual queries may still work. This is expected for viewer-only accounts.
-   */
-  async testConnection() {
-    try {
-      const query = `SELECT 1 as test_value`;
-      await this.bigquery.query({
-        query,
-        location: this.location
-      });
-      if (this.debug) {
-        console.log("\u2705 BigQuery connection test successful");
-      }
-      return true;
-    } catch (error) {
-      if (this.debug) {
-        console.warn("\u26A0\uFE0F  BigQuery connection test failed (may be expected for read-only accounts)");
-      }
-      return false;
-    }
-  }
 };
 
 // src/plugin/model/guessjs-ml-trainer.ts
@@ -1855,6 +1973,7 @@ function generateDashboard(config) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BigQueryAnalyticsConnector,
   smartPrefetch
 });
 //# sourceMappingURL=index.cjs.map