@rawdash/connector-firebase-crashlytics 0.21.1 → 0.23.0

package/dist/index.js

@@ -1,6 +1,7 @@
 // ../gcp-shared/dist/index.js
 import { z } from "zod";
 import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 var serviceAccountKeySchema = z.object({
   client_email: z.string().min(1),
   private_key: z.string().min(1),
@@ -77,6 +78,15 @@ async function buildServiceAccountJwt(serviceAccountJson, scope) {
     body
   };
 }
+function buildRefreshTokenGrant(credentials) {
+  const body = new URLSearchParams({
+    grant_type: "refresh_token",
+    refresh_token: credentials.refreshToken,
+    client_id: credentials.clientId,
+    client_secret: credentials.clientSecret
+  }).toString();
+  return { url: "https://oauth2.googleapis.com/token", body };
+}
 var gcpAuthConfigShape = {
   serviceAccountJson: z2.object({ $secret: z2.string().trim().min(1) }).meta({
     label: "Service Account JSON",
@@ -84,8 +94,6 @@ var gcpAuthConfigShape = {
     secret: true
   })
 };
-
-// ../../connector-shared/dist/index.js
 var HttpClientError = class extends Error {
   response;
   constructor(message, response) {
@@ -99,10 +107,227 @@ var AuthError = class extends HttpClientError {
 };
 var HTTP_CLIENT_VERSION = "0.0.0";
 var DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+function parseEpoch(value, unit) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (unit === "iso") {
+    if (typeof value !== "string") {
+      return null;
+    }
+    const ms = new Date(value).getTime();
+    return Number.isFinite(ms) ? ms : null;
+  }
+  if (typeof value === "string" && value.trim() === "") {
+    return null;
+  }
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) {
+    return null;
+  }
+  const result = unit === "s" ? n * 1e3 : n;
+  return Number.isFinite(result) ? result : null;
+}
+var BQ_IDENT_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+var BQ_DATASET_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+var BQ_API_BASE = "https://bigquery.googleapis.com/bigquery/v2";
+var BQ_READONLY_SCOPE = "https://www.googleapis.com/auth/bigquery.readonly";
+var BQ_PAGE_SIZE = 1e4;
+var BQ_QUERY_TIMEOUT_MS = 3e4;
+var bqQueryResponseSchema = z3.object({
+  jobComplete: z3.boolean().optional(),
+  schema: z3.object({
+    fields: z3.array(z3.object({ name: z3.string(), type: z3.string() }))
+  }).optional(),
+  rows: z3.array(
+    z3.object({
+      f: z3.array(z3.object({ v: z3.string().nullable().optional() }))
+    })
+  ).optional(),
+  pageToken: z3.string().optional(),
+  jobReference: z3.object({
+    projectId: z3.string(),
+    jobId: z3.string(),
+    location: z3.string().optional()
+  }).optional()
+});
+function buildBigQueryPageRequest(opts) {
+  const pageSize = opts.pageSize ?? BQ_PAGE_SIZE;
+  const timeoutMs = opts.timeoutMs ?? BQ_QUERY_TIMEOUT_MS;
+  if (opts.pageToken === void 0) {
+    const url2 = `${BQ_API_BASE}/projects/${encodeURIComponent(
+      opts.projectId
+    )}/queries`;
+    const body = {
+      query: opts.sql,
+      useLegacySql: false,
+      maxResults: pageSize,
+      timeoutMs
+    };
+    if (opts.location !== void 0) {
+      body["location"] = opts.location;
+    }
+    return { method: "POST", url: url2, body: JSON.stringify(body) };
+  }
+  if (opts.jobReference === void 0) {
+    throw new Error(
+      "cannot fetch the next page of BigQuery results without a jobReference"
+    );
+  }
+  const params = new URLSearchParams({
+    pageToken: opts.pageToken,
+    maxResults: String(pageSize),
+    timeoutMs: String(timeoutMs)
+  });
+  const location = opts.jobReference.location ?? opts.location;
+  if (location !== void 0) {
+    params.set("location", location);
+  }
+  const url = `${BQ_API_BASE}/projects/${encodeURIComponent(
+    opts.jobReference.projectId
+  )}/queries/${encodeURIComponent(opts.jobReference.jobId)}?${params.toString()}`;
+  return { method: "GET", url };
+}
+async function collectBigQueryPages(opts) {
+  const rows = [];
+  let pageToken;
+  let jobReference;
+  let page = 0;
+  const phaseStart = Date.now();
+  do {
+    if (opts.signal?.aborted) {
+      return { rows, aborted: true };
+    }
+    const request = buildBigQueryPageRequest({
+      projectId: opts.projectId,
+      sql: opts.sql,
+      pageToken,
+      jobReference,
+      location: opts.location,
+      pageSize: opts.pageSize
+    });
+    let response;
+    try {
+      response = await opts.fetchPage(request, opts.signal);
+    } catch (err) {
+      opts.logger?.warn("fetch page failed", {
+        resource: opts.resource,
+        page: page + 1,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      throw err;
+    }
+    if (response.jobComplete === false) {
+      throw new Error(opts.jobIncompleteMessage);
+    }
+    if (response.jobReference !== void 0) {
+      jobReference = response.jobReference;
+    }
+    const pageRows = opts.mapRows(response);
+    rows.push(...pageRows);
+    pageToken = typeof response.pageToken === "string" && response.pageToken.length > 0 ? response.pageToken : void 0;
+    page += 1;
+    opts.logger?.info("fetched page", {
+      resource: opts.resource,
+      page,
+      items: pageRows.length,
+      next: pageToken ?? null
+    });
+  } while (pageToken !== void 0);
+  opts.logger?.info("resource done", {
+    resource: opts.resource,
+    pages: page,
+    items: rows.length,
+    duration_ms: Date.now() - phaseStart
+  });
+  return { rows, aborted: false };
+}
+function indexBqFields(response) {
+  const fieldIndex = {};
+  (response.schema?.fields ?? []).forEach((field, idx) => {
+    fieldIndex[field.name] = idx;
+  });
+  return fieldIndex;
+}
+function readBqCell(cells, fieldIndex, name) {
+  const idx = fieldIndex[name];
+  if (idx === void 0) {
+    return null;
+  }
+  const raw = cells[idx]?.v;
+  if (raw === void 0 || raw === null) {
+    return null;
+  }
+  return raw;
+}
+function parseBqDateOrEpoch(value) {
+  const dateMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (dateMatch) {
+    return Date.UTC(
+      Number(dateMatch[1]),
+      Number(dateMatch[2]) - 1,
+      Number(dateMatch[3])
+    );
+  }
+  return parseEpoch(value, "iso");
+}
+var GcpAccessTokenProvider = class {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  opts;
+  cached = null;
+  async resolveGrant() {
+    const serviceAccountJson = this.opts.getServiceAccountJson();
+    if (serviceAccountJson) {
+      return buildServiceAccountJwt(serviceAccountJson, this.opts.scope);
+    }
+    const refreshTokenCredentials = this.opts.getRefreshTokenCredentials?.();
+    if (refreshTokenCredentials) {
+      return buildRefreshTokenGrant(refreshTokenCredentials);
+    }
+    throw new AuthError(
+      `${this.opts.connectorId}: missing serviceAccountJson or refresh-token credentials`
+    );
+  }
+  async getToken(signal) {
+    if (this.cached && Date.now() < this.cached.expiresAt) {
+      return this.cached.token;
+    }
+    const { url, body } = await this.resolveGrant();
+    const res = await this.opts.post(url, {
+      resource: "oauth_token",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body,
+      signal
+    });
+    const expiresIn = res.body.expires_in ?? 3600;
+    this.cached = {
+      token: res.body.access_token,
+      expiresAt: Date.now() + (expiresIn - 60) * 1e3
+    };
+    return this.cached.token;
+  }
+};
+var MS_PER_DAY = 864e5;
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function toDateStr(ms) {
+  const d = new Date(ms);
+  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+}
+function startOfUtcDay(ms) {
+  return Math.floor(ms / MS_PER_DAY) * MS_PER_DAY;
+}
+
+// ../../connector-shared/dist/index.js
+var HTTP_CLIENT_VERSION2 = "0.0.0";
+var DEFAULT_USER_AGENT2 = `rawdash-connector/${HTTP_CLIENT_VERSION2} (+https://rawdash.dev)`;
 function connectorUserAgent(connectorId) {
-  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION2} (+https://rawdash.dev)`;
 }
-function parseEpoch(value, unit) {
+function parseEpoch2(value, unit) {
   if (value === null || value === void 0) {
     return null;
   }
@@ -132,18 +357,16 @@ import {
   defineResources,
   schemasFromResources
 } from "@rawdash/core";
-import { z as z3 } from "zod";
-var BQ_IDENT_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
-var BQ_DATASET_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+import { z as z4 } from "zod";
 var configFields = defineConfigFields(
-  z3.object({
+  z4.object({
     ...gcpAuthConfigShape,
-    projectId: z3.string().regex(BQ_IDENT_RE, "projectId must be a valid GCP project id").meta({
+    projectId: z4.string().regex(BQ_IDENT_RE, "projectId must be a valid GCP project id").meta({
       label: "GCP project ID",
       description: "Project that hosts the Firebase Crashlytics -> BigQuery export (also the project used to bill the BigQuery queries this connector runs).",
       placeholder: "my-firebase-project"
     }),
-    bqDataset: z3.string().regex(
+    bqDataset: z4.string().regex(
       BQ_DATASET_RE,
       "bqDataset must be a valid BigQuery dataset id (letters, digits, and underscores; must start with a letter or underscore)"
     ).optional().meta({
@@ -151,17 +374,17 @@ var configFields = defineConfigFields(
       description: "BigQuery dataset containing the Crashlytics export tables. Defaults to firebase_crashlytics (the default name Firebase uses when you enable the export).",
       placeholder: "firebase_crashlytics"
     }),
-    bqLocation: z3.string().min(1).optional().meta({
+    bqLocation: z4.string().min(1).optional().meta({
       label: "BigQuery location",
       description: "Region or multi-region of the Crashlytics dataset (e.g. US, EU, us-central1). Defaults to US.",
       placeholder: "US"
     }),
-    lookbackDays: z3.number().int().positive().max(720).optional().meta({
+    lookbackDays: z4.number().int().positive().max(720).optional().meta({
       label: "Backfill window (days)",
       description: "How many days of history to query on a full sync. Defaults to 90.",
       placeholder: "90"
     }),
-    topIssuesLimit: z3.number().int().positive().max(500).optional().meta({
+    topIssuesLimit: z4.number().int().positive().max(500).optional().meta({
       label: "Top issues limit",
       description: "How many top issues to retain per sync, ranked by event count over the backfill window. Defaults to 50.",
       placeholder: "50"
@@ -175,6 +398,7 @@ var doc = defineConnectorDoc({
   tagline: "Track mobile app reliability over time from the Firebase Crashlytics -> BigQuery export: daily crashes, crash-free user rate, and top issues by impact.",
   vendor: {
     name: "Firebase",
+    domain: "firebase.google.com",
     apiDocs: "https://firebase.google.com/docs/crashlytics/bigquery-export",
     website: "https://firebase.google.com/products/crashlytics"
   },
@@ -197,39 +421,18 @@ var doc = defineConnectorDoc({
     "The Crashlytics BigQuery export is streamed; the trailing 2 days are always refetched on incremental syncs to pick up late-arriving rows."
   ]
 });
-var BQ_API_BASE = "https://bigquery.googleapis.com/bigquery/v2";
-var BQ_SCOPE = "https://www.googleapis.com/auth/bigquery.readonly";
 var CRASHES_METRIC_NAME = "crashes_per_day";
 var TOP_ISSUES_ENTITY_TYPE = "firebase_crashlytics_issue";
 var DEFAULT_LOOKBACK_DAYS = 90;
 var DEFAULT_TOP_ISSUES_LIMIT = 50;
 var DEFAULT_BQ_DATASET = "firebase_crashlytics";
 var INCREMENTAL_LOOKBACK_DAYS = 2;
-var MS_PER_DAY = 864e5;
-var PAGE_SIZE = 1e4;
 var firebaseCrashlyticsCredentials = {
   serviceAccountJson: {
     description: "Google service account JSON key (raw JSON or base64)",
     auth: "required"
   }
 };
-var bqQueryResponseSchema = z3.object({
-  jobComplete: z3.boolean().optional(),
-  schema: z3.object({
-    fields: z3.array(z3.object({ name: z3.string(), type: z3.string() }))
-  }).optional(),
-  rows: z3.array(
-    z3.object({
-      f: z3.array(z3.object({ v: z3.string().nullable().optional() }))
-    })
-  ).optional(),
-  pageToken: z3.string().optional(),
-  jobReference: z3.object({
-    projectId: z3.string(),
-    jobId: z3.string(),
-    location: z3.string().optional()
-  }).optional()
-});
 var firebaseCrashlyticsResources = defineResources({
   [CRASHES_METRIC_NAME]: {
     shape: "metric",
@@ -267,6 +470,7 @@ var firebaseCrashlyticsResources = defineResources({
   },
   top_issues: {
     shape: "entity",
+    filterable: [],
     description: "Top crash issues by event count over the backfill window, ranked across all apps and versions present in the export. One entity per Crashlytics issue id.",
     endpoint: "POST /bigquery/v2/projects/{projectId}/queries",
     notes: "topIssuesLimit caps how many issues are retained per sync (default 50). Rows are sorted by descending event count over the backfill window.",
@@ -330,56 +534,35 @@ var FirebaseCrashlyticsConnector = class _FirebaseCrashlyticsConnector extends B
   }
   id = id;
   credentials = firebaseCrashlyticsCredentials;
-  cachedToken = null;
-  async getAccessToken(signal) {
-    if (this.cachedToken && Date.now() < this.cachedToken.expiresAt) {
-      return this.cachedToken.token;
-    }
-    const { serviceAccountJson } = this.creds;
-    if (!serviceAccountJson) {
-      throw new AuthError(`${this.id}: missing serviceAccountJson credential`);
-    }
-    const { url, body } = await buildServiceAccountJwt(
-      serviceAccountJson,
-      BQ_SCOPE
-    );
-    const res = await this.post(url, {
-      resource: "oauth_token",
-      headers: { "Content-Type": "application/x-www-form-urlencoded" },
-      body,
-      signal
+  tokenProvider;
+  getAccessToken(signal) {
+    this.tokenProvider ??= new GcpAccessTokenProvider({
+      connectorId: this.id,
+      scope: BQ_READONLY_SCOPE,
+      getServiceAccountJson: () => this.creds.serviceAccountJson,
+      post: (url, opts) => this.post(url, opts)
     });
-    const expiresIn = res.body.expires_in ?? 3600;
-    this.cachedToken = {
-      token: res.body.access_token,
-      expiresAt: Date.now() + (expiresIn - 60) * 1e3
-    };
-    return this.cachedToken.token;
+    return this.tokenProvider.getToken(signal);
   }
-  async runQuery(accessToken, resource, sql, pageToken, signal) {
-    const url = `${BQ_API_BASE}/projects/${encodeURIComponent(
-      this.settings.projectId
-    )}/queries`;
-    const body = {
-      query: sql,
-      useLegacySql: false,
-      maxResults: PAGE_SIZE,
-      timeoutMs: 3e4
+  async fetchBigQueryPage(resource, request, signal) {
+    const accessToken = await this.getAccessToken(signal);
+    const headers = {
+      Authorization: `Bearer ${accessToken}`,
+      "Content-Type": "application/json",
+      "User-Agent": connectorUserAgent(this.id)
     };
-    if (this.settings.bqLocation !== void 0) {
-      body["location"] = this.settings.bqLocation;
-    }
-    if (pageToken !== void 0) {
-      body["pageToken"] = pageToken;
+    if (request.method === "POST") {
+      const res2 = await this.post(request.url, {
+        resource,
+        headers,
+        body: request.body,
+        signal
+      });
+      return res2.body;
     }
-    const res = await this.post(url, {
+    const res = await this.get(request.url, {
       resource,
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        "Content-Type": "application/json",
-        "User-Agent": connectorUserAgent(this.id)
-      },
-      body: JSON.stringify(body),
+      headers,
       signal
     });
     return res.body;
@@ -432,107 +615,36 @@ var FirebaseCrashlyticsConnector = class _FirebaseCrashlyticsConnector extends B
     }
     return { done: true };
   }
+  jobIncompleteMessage() {
+    return `${this.id}: BigQuery query did not complete within the synchronous timeout (jobComplete=false). Narrow the lookbackDays so the query finishes faster.`;
+  }
   async collectSamples(sql, signal) {
-    const samples = [];
-    let pageToken;
-    let page = 0;
-    const phaseStart = Date.now();
-    do {
-      if (signal?.aborted) {
-        break;
-      }
-      const accessToken = await this.getAccessToken(signal);
-      let response;
-      try {
-        response = await this.runQuery(
-          accessToken,
-          CRASHES_METRIC_NAME,
-          sql,
-          pageToken,
-          signal
-        );
-      } catch (err) {
-        this.logger.warn("fetch page failed", {
-          resource: CRASHES_METRIC_NAME,
-          page: page + 1,
-          error: err instanceof Error ? err.message : String(err)
-        });
-        throw err;
-      }
-      if (response.jobComplete === false) {
-        throw new Error(
-          `${this.id}: BigQuery query did not complete within the synchronous timeout (jobComplete=false). Narrow the lookbackDays so the query finishes faster.`
-        );
-      }
-      const pageSamples = buildCrashesSamplesFromBqResponse(response);
-      samples.push(...pageSamples);
-      pageToken = typeof response.pageToken === "string" && response.pageToken.length > 0 ? response.pageToken : void 0;
-      page += 1;
-      this.logger.info("fetched page", {
-        resource: CRASHES_METRIC_NAME,
-        page,
-        items: pageSamples.length,
-        next: pageToken ?? null
-      });
-    } while (pageToken !== void 0);
-    this.logger.info("resource done", {
+    const { rows } = await collectBigQueryPages({
+      projectId: this.settings.projectId,
+      sql,
       resource: CRASHES_METRIC_NAME,
-      pages: page,
-      items: samples.length,
-      duration_ms: Date.now() - phaseStart
+      location: this.settings.bqLocation,
+      signal,
+      logger: this.logger,
+      mapRows: buildCrashesSamplesFromBqResponse,
+      jobIncompleteMessage: this.jobIncompleteMessage(),
+      fetchPage: (request, sig) => this.fetchBigQueryPage(CRASHES_METRIC_NAME, request, sig)
     });
-    return samples;
+    return rows;
   }
   async collectIssues(sql, signal) {
-    const entities = [];
-    let pageToken;
-    let page = 0;
-    const phaseStart = Date.now();
-    do {
-      if (signal?.aborted) {
-        break;
-      }
-      const accessToken = await this.getAccessToken(signal);
-      let response;
-      try {
-        response = await this.runQuery(
-          accessToken,
-          "top_issues",
-          sql,
-          pageToken,
-          signal
-        );
-      } catch (err) {
-        this.logger.warn("fetch page failed", {
-          resource: "top_issues",
-          page: page + 1,
-          error: err instanceof Error ? err.message : String(err)
-        });
-        throw err;
-      }
-      if (response.jobComplete === false) {
-        throw new Error(
-          `${this.id}: BigQuery query did not complete within the synchronous timeout (jobComplete=false). Narrow the lookbackDays so the query finishes faster.`
-        );
-      }
-      const pageEntities = buildTopIssuesEntitiesFromBqResponse(response);
-      entities.push(...pageEntities);
-      pageToken = typeof response.pageToken === "string" && response.pageToken.length > 0 ? response.pageToken : void 0;
-      page += 1;
-      this.logger.info("fetched page", {
-        resource: "top_issues",
-        page,
-        items: pageEntities.length,
-        next: pageToken ?? null
-      });
-    } while (pageToken !== void 0);
-    this.logger.info("resource done", {
+    const { rows } = await collectBigQueryPages({
+      projectId: this.settings.projectId,
+      sql,
       resource: "top_issues",
-      pages: page,
-      items: entities.length,
-      duration_ms: Date.now() - phaseStart
+      location: this.settings.bqLocation,
+      signal,
+      logger: this.logger,
+      mapRows: buildTopIssuesEntitiesFromBqResponse,
+      jobIncompleteMessage: this.jobIncompleteMessage(),
+      fetchPage: (request, sig) => this.fetchBigQueryPage("top_issues", request, sig)
     });
-    return entities;
+    return rows;
   }
 };
 function buildCrashesPerDaySql(args) {
@@ -580,27 +692,17 @@ function buildTopIssuesSql(args) {
     `  AND DATE(event_timestamp) < DATE('${args.endDate}')`,
     "  AND issue_id IS NOT NULL",
     "GROUP BY issue_id",
-    "ORDER BY event_count DESC",
+    "ORDER BY event_count DESC, last_seen DESC, issue_id ASC",
     `LIMIT ${args.limit}`
   ].join("\n");
 }
-function pad2(n) {
-  return String(n).padStart(2, "0");
-}
-function toDateStr(ms) {
-  const d = new Date(ms);
-  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
-}
-function startOfUtcDay(ms) {
-  return Math.floor(ms / MS_PER_DAY) * MS_PER_DAY;
-}
 function getCrashlyticsWindow(options, lookbackDays, now = Date.now()) {
   const endMs = startOfUtcDay(now) + MS_PER_DAY;
   let days = lookbackDays;
   if (options.mode === "latest") {
     days = INCREMENTAL_LOOKBACK_DAYS;
   } else if (options.since !== void 0) {
-    const sinceMs = parseEpoch(options.since, "iso");
+    const sinceMs = parseEpoch2(options.since, "iso");
     if (sinceMs !== null) {
       const elapsed = Math.ceil((now - sinceMs) / MS_PER_DAY);
       days = Math.min(
@@ -615,14 +717,10 @@ function getCrashlyticsWindow(options, lookbackDays, now = Date.now()) {
   };
 }
 function buildCrashesSamplesFromBqResponse(response) {
-  const schema = response.schema?.fields ?? [];
-  const fieldIndex = {};
-  schema.forEach((field, idx) => {
-    fieldIndex[field.name] = idx;
-  });
+  const fieldIndex = indexBqFields(response);
   const samples = [];
   for (const row of response.rows ?? []) {
-    const dateValue = readCell(row.f, fieldIndex, "date");
+    const dateValue = readBqCell(row.f, fieldIndex, "date");
     if (dateValue === null) {
       continue;
     }
@@ -630,7 +728,7 @@ function buildCrashesSamplesFromBqResponse(response) {
     if (ts === null) {
       continue;
     }
-    const crashesRaw = readCell(row.f, fieldIndex, "crashes");
+    const crashesRaw = readBqCell(row.f, fieldIndex, "crashes");
     if (crashesRaw === null) {
       continue;
     }
@@ -638,8 +736,8 @@ function buildCrashesSamplesFromBqResponse(response) {
     if (!Number.isFinite(crashes)) {
       continue;
     }
-    const crashingUsersRaw = readCell(row.f, fieldIndex, "crashing_users");
-    const totalUsersRaw = readCell(row.f, fieldIndex, "total_users");
+    const crashingUsersRaw = readBqCell(row.f, fieldIndex, "crashing_users");
+    const totalUsersRaw = readBqCell(row.f, fieldIndex, "total_users");
     const crashingUsers = crashingUsersRaw !== null ? Number.parseFloat(crashingUsersRaw) : NaN;
     const totalUsers = totalUsersRaw !== null ? Number.parseFloat(totalUsersRaw) : NaN;
     let crashFreeRate = null;
@@ -648,9 +746,9 @@ function buildCrashesSamplesFromBqResponse(response) {
       crashFreeRate = Math.max(0, Math.min(1, rate));
     }
     const attributes = {};
-    const appId = readCell(row.f, fieldIndex, "app_id");
-    const platform = readCell(row.f, fieldIndex, "platform");
-    const version = readCell(row.f, fieldIndex, "version");
+    const appId = readBqCell(row.f, fieldIndex, "app_id");
+    const platform = readBqCell(row.f, fieldIndex, "platform");
+    const version = readBqCell(row.f, fieldIndex, "version");
     attributes["app_id"] = appId;
     attributes["platform"] = platform;
     attributes["version"] = version;
@@ -666,30 +764,26 @@ function buildCrashesSamplesFromBqResponse(response) {
   return samples;
 }
 function buildTopIssuesEntitiesFromBqResponse(response) {
-  const schema = response.schema?.fields ?? [];
-  const fieldIndex = {};
-  schema.forEach((field, idx) => {
-    fieldIndex[field.name] = idx;
-  });
+  const fieldIndex = indexBqFields(response);
   const entities = [];
   for (const row of response.rows ?? []) {
-    const issueId = readCell(row.f, fieldIndex, "issue_id");
+    const issueId = readBqCell(row.f, fieldIndex, "issue_id");
     if (issueId === null || issueId.length === 0) {
       continue;
     }
-    const eventCountRaw = readCell(row.f, fieldIndex, "event_count");
-    const userCountRaw = readCell(row.f, fieldIndex, "user_count");
+    const eventCountRaw = readBqCell(row.f, fieldIndex, "event_count");
+    const userCountRaw = readBqCell(row.f, fieldIndex, "user_count");
     const eventCount = eventCountRaw !== null ? Number.parseFloat(eventCountRaw) : NaN;
     const userCount = userCountRaw !== null ? Number.parseFloat(userCountRaw) : NaN;
-    const lastSeenRaw = readCell(row.f, fieldIndex, "last_seen");
+    const lastSeenRaw = readBqCell(row.f, fieldIndex, "last_seen");
     const lastSeenMs = lastSeenRaw !== null ? parseBqDateOrEpoch(lastSeenRaw) : null;
     const updatedAt = lastSeenMs ?? Date.now();
     const attributes = {
       issue_id: issueId,
-      title: readCell(row.f, fieldIndex, "title"),
-      subtitle: readCell(row.f, fieldIndex, "subtitle"),
-      app_id: readCell(row.f, fieldIndex, "app_id"),
-      platform: readCell(row.f, fieldIndex, "platform"),
+      title: readBqCell(row.f, fieldIndex, "title"),
+      subtitle: readBqCell(row.f, fieldIndex, "subtitle"),
+      app_id: readBqCell(row.f, fieldIndex, "app_id"),
+      platform: readBqCell(row.f, fieldIndex, "platform"),
       event_count: Number.isFinite(eventCount) ? eventCount : 0,
       user_count: Number.isFinite(userCount) ? userCount : 0,
       last_seen: lastSeenMs !== null ? new Date(lastSeenMs).toISOString() : null
@@ -703,28 +797,6 @@ function buildTopIssuesEntitiesFromBqResponse(response) {
   }
   return entities;
 }
-function readCell(cells, fieldIndex, name) {
-  const idx = fieldIndex[name];
-  if (idx === void 0) {
-    return null;
-  }
-  const raw = cells[idx]?.v;
-  if (raw === void 0 || raw === null) {
-    return null;
-  }
-  return raw;
-}
-function parseBqDateOrEpoch(value) {
-  const dateMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
-  if (dateMatch) {
-    return Date.UTC(
-      Number(dateMatch[1]),
-      Number(dateMatch[2]) - 1,
-      Number(dateMatch[3])
-    );
-  }
-  return parseEpoch(value, "iso");
-}
 
 // src/index.ts
 var index_default = FirebaseCrashlyticsConnector;