@agent-native/core 0.137.7 → 0.138.0

package/corpus/templates/analytics/app/i18n-data.ts

@@ -927,6 +927,22 @@ const enUS = {
     firstPartyAnalytics: "First-party Analytics",
     firstPartyDescription:
       "Receive product, session, and $ai_generation events through the same first-party endpoint for dashboarding and LLM observability.",
+    bigQueryRecommendationTitle: "BigQuery is recommended for this data",
+    bigQueryRecommendationDescription:
+      "Neon is still the default. Connect BigQuery when you have 1M+ observed events or repeated slow queries/timeouts, then use it for high-volume or historical analysis.",
+    bigQueryConnectedTitle: "BigQuery is ready for heavier queries",
+    bigQueryConnectedDescription:
+      "Use BigQuery for high-volume or historical tracking queries. Neon remains available for recent operational analytics.",
+    bigQuerySetup: "Set up BigQuery",
+    bigQueryMonitorDescription:
+      "Neon is still a good fit. Keep an eye on event volume and query latency; this card will recommend BigQuery if pressure grows.",
+    bigQueryHealthyDescription:
+      "Neon is a good fit for this first-party data right now. We will flag this again if volume or query latency grows.",
+    bigQueryHealthUnavailable:
+      "We could not check first-party analytics pressure right now. Reload and try again before changing backends.",
+    analyticsEventCount: "Observed events",
+    slowQueries24h: "Slow queries (24h)",
+    maxQueryDuration: "Max query time",
     defaultKeyName: "Hosted templates",
     endpoint: "Endpoint",
     serverEnv: "Server env",
@@ -1401,6 +1417,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "第一方 Analytics",
       firstPartyDescription:
         "通过同一个第一方端点接收产品、会话和 $ai_generation 事件，用于仪表板和 LLM 可观测性。",
+      bigQueryRecommendationTitle: "建议为此数据使用 BigQuery",
+      bigQueryRecommendationDescription:
+        "Neon 仍是默认选择。当观察到 100 万以上事件或反复出现慢查询/超时时，请连接 BigQuery，并用它进行高数据量或历史分析。",
+      bigQueryConnectedTitle: "BigQuery 已准备好处理更重的查询",
+      bigQueryConnectedDescription:
+        "使用 BigQuery 处理高数据量或历史跟踪查询。Neon 仍可用于近期运营分析。",
+      bigQuerySetup: "设置 BigQuery",
+      bigQueryMonitorDescription:
+        "Neon 目前仍然适合。请关注事件量和查询延迟；如果压力增加，此卡片会建议 BigQuery。",
+      bigQueryHealthyDescription:
+        "目前 Neon 适合这项第一方数据。如果事件量或查询延迟增加，我们会再次提醒你。",
+      bigQueryHealthUnavailable:
+        "现在无法检查第一方 Analytics 压力。请重新加载后再尝试更换后端。",
+      analyticsEventCount: "观察到的事件",
+      slowQueries24h: "慢查询（24 小时）",
+      maxQueryDuration: "最长查询时间",
       defaultKeyName: "托管模板",
       endpoint: "端点",
       serverEnv: "服务器环境",
@@ -1704,6 +1736,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "zx3qz",
       firstPartyDescription:
         "Reciba eventos de producto, sesión y $ai_generation en el mismo endpoint propio para dashboards y observabilidad de LLM.",
+      bigQueryRecommendationTitle: "Se recomienda BigQuery para estos datos",
+      bigQueryRecommendationDescription:
+        "Neon sigue siendo la opción predeterminada. Conecta BigQuery cuando tengas más de 1 millón de eventos observados o consultas lentas/tiempos de espera repetidos, y úsalo para análisis históricos o de gran volumen.",
+      bigQueryConnectedTitle: "BigQuery está listo para consultas más pesadas",
+      bigQueryConnectedDescription:
+        "Usa BigQuery para consultas históricas o de seguimiento de gran volumen. Neon sigue disponible para análisis operativos recientes.",
+      bigQuerySetup: "Configurar BigQuery",
+      bigQueryMonitorDescription:
+        "Neon sigue siendo una buena opción. Vigila el volumen de eventos y la latencia; esta tarjeta recomendará BigQuery si aumenta la presión.",
+      bigQueryHealthyDescription:
+        "Neon es una buena opción para estos datos propios por ahora. Te avisaremos si aumentan el volumen o la latencia.",
+      bigQueryHealthUnavailable:
+        "No se pudo comprobar la presión de Analytics propio. Recarga e inténtalo de nuevo antes de cambiar de backend.",
+      analyticsEventCount: "Eventos observados",
+      slowQueries24h: "Consultas lentas (24 h)",
+      maxQueryDuration: "Tiempo máximo de consulta",
       defaultKeyName: "Plantillas alojadas",
       endpoint: "Punto final",
       serverEnv: "entorno del servidor",
@@ -2025,6 +2073,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "Analytics propriétaire",
       firstPartyDescription:
         "Recevez les événements produit, session et $ai_generation sur le même point de terminaison propriétaire pour les tableaux de bord et l'observabilité LLM.",
+      bigQueryRecommendationTitle: "BigQuery est recommandé pour ces données",
+      bigQueryRecommendationDescription:
+        "Neon reste la valeur par défaut. Connectez BigQuery avec plus d’un million d’événements observés ou des requêtes lentes/expirées répétées, puis utilisez-le pour les analyses historiques ou volumineuses.",
+      bigQueryConnectedTitle: "BigQuery est prêt pour les requêtes lourdes",
+      bigQueryConnectedDescription:
+        "Utilisez BigQuery pour les requêtes de suivi historiques ou volumineuses. Neon reste disponible pour les analyses opérationnelles récentes.",
+      bigQuerySetup: "Configurer BigQuery",
+      bigQueryMonitorDescription:
+        "Neon reste adapté pour le moment. Surveillez le volume et la latence ; cette carte recommandera BigQuery si la pression augmente.",
+      bigQueryHealthyDescription:
+        "Neon convient actuellement à ces données propriétaires. Nous vous préviendrons si le volume ou la latence augmente.",
+      bigQueryHealthUnavailable:
+        "Impossible de vérifier la pression Analytics propriétaire. Rechargez la page avant de changer de backend.",
+      analyticsEventCount: "Événements observés",
+      slowQueries24h: "Requêtes lentes (24 h)",
+      maxQueryDuration: "Durée maximale de requête",
       defaultKeyName: "Modèles hébergés",
       endpoint: "Point de terminaison",
       serverEnv: "Environnement du serveur",
@@ -2344,6 +2408,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "First-Party-Analytics",
       firstPartyDescription:
         "Empfangen Sie Produkt-, Sitzungs- und $ai_generation-Ereignisse über denselben Erstanbieter-Endpunkt für Dashboards und LLM-Observability.",
+      bigQueryRecommendationTitle: "BigQuery wird für diese Daten empfohlen",
+      bigQueryRecommendationDescription:
+        "Neon bleibt die Standardeinstellung. Verbinde BigQuery ab 1 Million beobachteter Ereignisse oder wiederholt langsamen/abgebrochenen Abfragen und nutze es für umfangreiche oder historische Analysen.",
+      bigQueryConnectedTitle: "BigQuery ist für umfangreiche Abfragen bereit",
+      bigQueryConnectedDescription:
+        "Nutze BigQuery für umfangreiche oder historische Tracking-Abfragen. Neon bleibt für aktuelle operative Analysen verfügbar.",
+      bigQuerySetup: "BigQuery einrichten",
+      bigQueryMonitorDescription:
+        "Neon ist derzeit weiterhin geeignet. Beobachte Ereignismenge und Abfragelatenz; bei wachsendem Druck wird diese Karte BigQuery empfehlen.",
+      bigQueryHealthyDescription:
+        "Neon ist für diese First-Party-Daten derzeit gut geeignet. Wir melden uns erneut, wenn Menge oder Latenz steigen.",
+      bigQueryHealthUnavailable:
+        "Der Druck der First-Party-Analytics konnte nicht geprüft werden. Lade die Seite neu, bevor du das Backend wechselst.",
+      analyticsEventCount: "Beobachtete Ereignisse",
+      slowQueries24h: "Langsame Abfragen (24 h)",
+      maxQueryDuration: "Maximale Abfragezeit",
       defaultKeyName: "Gehostete Vorlagen",
       endpoint: "Endpunkt",
       serverEnv: "Serverumgebung",
@@ -2658,6 +2738,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "ファーストパーティ Analytics",
       firstPartyDescription:
         "同じファーストパーティエンドポイントで製品、セッション、$ai_generation イベントを受信し、ダッシュボードと LLM 可観測性に使用します。",
+      bigQueryRecommendationTitle: "このデータには BigQuery をおすすめします",
+      bigQueryRecommendationDescription:
+        "Neon は引き続き標準です。観測イベントが 100 万件を超える、または遅いクエリやタイムアウトが繰り返される場合は BigQuery に接続し、大量・履歴分析に使用してください。",
+      bigQueryConnectedTitle: "BigQuery は重いクエリに対応できます",
+      bigQueryConnectedDescription:
+        "大量または履歴のトラッキングクエリには BigQuery を使用してください。Neon は最近の運用分析に引き続き利用できます。",
+      bigQuerySetup: "BigQuery を設定",
+      bigQueryMonitorDescription:
+        "今のところ Neon が適しています。イベント量とクエリ遅延を確認してください。負荷が増えるとこのカードが BigQuery をおすすめします。",
+      bigQueryHealthyDescription:
+        "現在、このファーストパーティデータには Neon が適しています。量やクエリ遅延が増えたら再度お知らせします。",
+      bigQueryHealthUnavailable:
+        "ファーストパーティ Analytics の負荷を確認できませんでした。バックエンドを変更する前に再読み込みしてください。",
+      analyticsEventCount: "観測イベント",
+      slowQueries24h: "遅いクエリ（24 時間）",
+      maxQueryDuration: "最大クエリ時間",
       defaultKeyName: "ホストされたテンプレート",
       endpoint: "終点",
       serverEnv: "サーバー環境",
@@ -2967,6 +3063,23 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "퍼스트파티 Analytics",
       firstPartyDescription:
         "동일한 퍼스트파티 엔드포인트에서 제품, 세션, $ai_generation 이벤트를 받아 대시보드와 LLM 관측성에 사용합니다.",
+      bigQueryRecommendationTitle: "이 데이터에는 BigQuery를 권장합니다",
+      bigQueryRecommendationDescription:
+        "Neon은 여전히 기본값입니다. 관측 이벤트가 100만 개 이상이거나 느린 쿼리/시간 초과가 반복되면 BigQuery를 연결하고 대용량 또는 과거 분석에 사용하세요.",
+      bigQueryConnectedTitle:
+        "BigQuery가 무거운 쿼리를 처리할 준비가 되었습니다",
+      bigQueryConnectedDescription:
+        "대용량 또는 과거 추적 쿼리에는 BigQuery를 사용하세요. Neon은 최근 운영 분석에 계속 사용할 수 있습니다.",
+      bigQuerySetup: "BigQuery 설정",
+      bigQueryMonitorDescription:
+        "현재는 Neon이 적합합니다. 이벤트 양과 쿼리 지연을 확인하세요. 부담이 커지면 이 카드에서 BigQuery를 권장합니다.",
+      bigQueryHealthyDescription:
+        "현재 이 퍼스트파티 데이터에는 Neon이 적합합니다. 양이나 쿼리 지연이 증가하면 다시 알려드립니다.",
+      bigQueryHealthUnavailable:
+        "퍼스트파티 Analytics 부담을 확인하지 못했습니다. 백엔드를 바꾸기 전에 다시 로드하세요.",
+      analyticsEventCount: "관측된 이벤트",
+      slowQueries24h: "느린 쿼리 (24시간)",
+      maxQueryDuration: "최대 쿼리 시간",
       defaultKeyName: "호스팅된 템플릿",
       endpoint: "엔드포인트",
       serverEnv: "서버 환경",
@@ -3274,6 +3387,23 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "Analytics primário",
       firstPartyDescription:
         "Receba eventos de produto, sessão e $ai_generation pelo mesmo endpoint primário para dashboards e observabilidade de LLM.",
+      bigQueryRecommendationTitle: "BigQuery é recomendado para estes dados",
+      bigQueryRecommendationDescription:
+        "Neon continua sendo o padrão. Conecte o BigQuery ao observar mais de 1 milhão de eventos ou consultas lentas/expiradas repetidas e use-o para análises históricas ou de alto volume.",
+      bigQueryConnectedTitle:
+        "BigQuery está pronto para consultas mais pesadas",
+      bigQueryConnectedDescription:
+        "Use BigQuery para consultas históricas ou de rastreamento de alto volume. Neon continua disponível para análises operacionais recentes.",
+      bigQuerySetup: "Configurar BigQuery",
+      bigQueryMonitorDescription:
+        "Neon ainda é uma boa opção. Acompanhe o volume de eventos e a latência; este cartão recomendará BigQuery se a pressão aumentar.",
+      bigQueryHealthyDescription:
+        "Neon é uma boa opção para estes dados primários agora. Avisaremos novamente se o volume ou a latência crescer.",
+      bigQueryHealthUnavailable:
+        "Não foi possível verificar a pressão do Analytics primário. Recarregue antes de trocar o backend.",
+      analyticsEventCount: "Eventos observados",
+      slowQueries24h: "Consultas lentas (24 h)",
+      maxQueryDuration: "Tempo máximo da consulta",
       defaultKeyName: "Modelos hospedados",
       endpoint: "Ponto final",
       serverEnv: "Ambiente do servidor",
@@ -3585,6 +3715,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "प्रथम-पक्ष Analytics",
       firstPartyDescription:
         "डैशबोर्ड और LLM observability के लिए उसी प्रथम-पक्ष endpoint से product, session, और $ai_generation events प्राप्त करें।",
+      bigQueryRecommendationTitle: "इस डेटा के लिए BigQuery की सलाह है",
+      bigQueryRecommendationDescription:
+        "Neon अभी भी डिफ़ॉल्ट है। 10 लाख से अधिक देखे गए events या बार-बार धीमे queries/timeouts होने पर BigQuery जोड़ें और बड़े या पुराने डेटा के विश्लेषण के लिए इसका उपयोग करें।",
+      bigQueryConnectedTitle: "BigQuery भारी queries के लिए तैयार है",
+      bigQueryConnectedDescription:
+        "बड़े या पुराने tracking queries के लिए BigQuery का उपयोग करें। हाल के operational analytics के लिए Neon उपलब्ध रहेगा।",
+      bigQuerySetup: "BigQuery सेट अप करें",
+      bigQueryMonitorDescription:
+        "अभी Neon उपयुक्त है। event volume और query latency पर नज़र रखें; दबाव बढ़ने पर यह card BigQuery की सलाह देगा।",
+      bigQueryHealthyDescription:
+        "अभी इस first-party data के लिए Neon उपयुक्त है। volume या query latency बढ़ने पर हम फिर बताएँगे।",
+      bigQueryHealthUnavailable:
+        "First-party Analytics pressure की जाँच नहीं हो सकी। backend बदलने से पहले reload करके फिर प्रयास करें।",
+      analyticsEventCount: "देखे गए events",
+      slowQueries24h: "धीमे queries (24 घंटे)",
+      maxQueryDuration: "अधिकतम query समय",
       defaultKeyName: "होस्ट किए गए टेम्पलेट",
       endpoint: "endpoint",
       serverEnv: "सर्वर एन.वी",
@@ -3887,6 +4033,22 @@ const analyticsSliceTranslations: {
       firstPartyAnalytics: "تحليلات الطرف الأول",
       firstPartyDescription:
         "استقبل أحداث المنتج والجلسة و $ai_generation عبر نقطة نهاية الطرف الأول نفسها للوحات المعلومات ومراقبة LLM.",
+      bigQueryRecommendationTitle: "يُنصح باستخدام BigQuery لهذه البيانات",
+      bigQueryRecommendationDescription:
+        "يبقى Neon هو الخيار الافتراضي. وصّل BigQuery عند وجود أكثر من مليون حدث ملحوظ أو تكرار الاستعلامات البطيئة/المهلة، واستخدمه للتحليل التاريخي أو عالي الحجم.",
+      bigQueryConnectedTitle: "BigQuery جاهز للاستعلامات الأثقل",
+      bigQueryConnectedDescription:
+        "استخدم BigQuery لاستعلامات التتبع عالية الحجم أو التاريخية. يظل Neon متاحاً للتحليلات التشغيلية الحديثة.",
+      bigQuerySetup: "إعداد BigQuery",
+      bigQueryMonitorDescription:
+        "لا يزال Neon مناسباً حالياً. راقب حجم الأحداث وزمن الاستعلام؛ ستوصي هذه البطاقة بـ BigQuery إذا زاد الضغط.",
+      bigQueryHealthyDescription:
+        "Neon مناسب حالياً لبيانات الطرف الأول هذه. سننبهك مجدداً إذا زاد الحجم أو زمن الاستعلام.",
+      bigQueryHealthUnavailable:
+        "تعذّر التحقق من ضغط Analytics للطرف الأول. أعد التحميل وحاول مجدداً قبل تغيير الخلفية.",
+      analyticsEventCount: "الأحداث الملحوظة",
+      slowQueries24h: "الاستعلامات البطيئة (24 ساعة)",
+      maxQueryDuration: "أقصى زمن للاستعلام",
       defaultKeyName: "القوالب المستضافة",
       endpoint: "نقطة النهاية",
       serverEnv: "بيئة الخادم",

package/corpus/templates/analytics/app/pages/DataSources.tsx

@@ -10,7 +10,7 @@ import {
   useActionQuery,
 } from "@agent-native/core/client/hooks";
 import { oauthRedirectUri } from "@agent-native/core/client/host";
-import { useT } from "@agent-native/core/client/i18n";
+import { useFormatters, useT } from "@agent-native/core/client/i18n";
 import { useOrgRole } from "@agent-native/core/client/org";
 import {
   IconCheck,
@@ -118,6 +118,18 @@ interface GitHubOAuthStatus {
   error?: string;
 }
 
+interface FirstPartyAnalyticsHealthResponse {
+  status: "healthy" | "monitor" | "recommend_bigquery" | "unavailable";
+  metrics: {
+    eventCount: number;
+    slowQueryCount24h: number;
+    maxQueryDurationMs24h: number;
+  };
+  bigQuery: {
+    configured: boolean | null;
+  };
+}
+
 const firstPartyAnalyticsEndpoint =
   (import.meta.env as Record<string, string | undefined>)
     .VITE_AGENT_NATIVE_ANALYTICS_ENDPOINT ||
@@ -1577,6 +1589,7 @@ function AddDataSourceCTA() {
 
 function FirstPartyAnalyticsCard() {
   const t = useT();
+  const { formatNumber } = useFormatters();
   const queryClient = useQueryClient();
   const [expanded, setExpanded] = useState(false);
   const [name, setName] = useState(() => t("dataSources.defaultKeyName"));
@@ -1592,6 +1605,33 @@ function FirstPartyAnalyticsCard() {
     (key) => !key.revokedAt,
   );
   const connected = keys.length > 0;
+  const {
+    data: rawHealth,
+    isLoading: isHealthLoading,
+    isError: isHealthError,
+  } = useActionQuery("get-first-party-analytics-health", undefined, {
+    staleTime: 30_000,
+    retry: false,
+  });
+  const health = rawHealth as FirstPartyAnalyticsHealthResponse | undefined;
+  const healthStatus = isHealthError ? "unavailable" : health?.status;
+  const bigQueryConfigured = health?.bigQuery.configured === true;
+  const healthTitleKey =
+    healthStatus === "recommend_bigquery"
+      ? bigQueryConfigured
+        ? "dataSources.bigQueryConnectedTitle"
+        : "dataSources.bigQueryRecommendationTitle"
+      : null;
+  const healthDescriptionKey =
+    healthStatus === "recommend_bigquery"
+      ? bigQueryConfigured
+        ? "dataSources.bigQueryConnectedDescription"
+        : "dataSources.bigQueryRecommendationDescription"
+      : healthStatus === "monitor"
+        ? "dataSources.bigQueryMonitorDescription"
+        : healthStatus === "healthy"
+          ? "dataSources.bigQueryHealthyDescription"
+          : "dataSources.bigQueryHealthUnavailable";
 
   const createKey = useActionMutation("create-analytics-public-key", {
     onSuccess: (result: any) => {
@@ -1641,6 +1681,18 @@ function FirstPartyAnalyticsCard() {
             <div className="flex shrink-0 items-center gap-2">
               {isLoading ? (
                 <Skeleton className="h-4 w-20 rounded-full" />
+              ) : healthStatus === "recommend_bigquery" ? (
+                <span
+                  className="flex min-w-0 items-center gap-1.5 text-xs font-medium text-amber-500"
+                  title={healthTitleKey ? t(healthTitleKey) : undefined}
+                >
+                  <IconAlertCircle className="h-3.5 w-3.5 shrink-0" />
+                  <span className="max-w-[12rem] truncate">
+                    {healthTitleKey
+                      ? t(healthTitleKey)
+                      : t("dataSources.bigQueryRecommendationTitle")}
+                  </span>
+                </span>
               ) : connected ? (
                 <span className="flex items-center gap-1.5 text-xs text-emerald-500 font-medium whitespace-nowrap">
                   <IconCheck className="h-3.5 w-3.5" />
@@ -1665,6 +1717,79 @@ function FirstPartyAnalyticsCard() {
       {expanded && (
         <CardContent className="border-t border-border/50 px-5 py-4">
           <div className="space-y-4">
+            {isHealthLoading ? (
+              <Skeleton className="h-28 w-full rounded-md" />
+            ) : (
+              <div
+                className={`rounded-md border p-3 text-xs ${
+                  healthStatus === "recommend_bigquery"
+                    ? "border-amber-500/30 bg-amber-500/10"
+                    : "border-border/50 bg-muted/20"
+                }`}
+              >
+                <div className="flex items-start justify-between gap-3">
+                  <div className="flex min-w-0 items-start gap-2">
+                    <IconAlertCircle
+                      className={`mt-px h-3.5 w-3.5 shrink-0 ${
+                        healthStatus === "recommend_bigquery"
+                          ? "text-amber-500"
+                          : "text-muted-foreground"
+                      }`}
+                    />
+                    <div className="min-w-0 space-y-1">
+                      {healthTitleKey && (
+                        <p className="font-medium text-foreground">
+                          {t(healthTitleKey)}
+                        </p>
+                      )}
+                      <p className="text-muted-foreground">
+                        {t(healthDescriptionKey)}
+                      </p>
+                    </div>
+                  </div>
+                  {healthStatus === "recommend_bigquery" &&
+                  !bigQueryConfigured ? (
+                    <Button asChild size="sm" className="shrink-0 text-xs">
+                      <Link to="/data-sources?source=bigquery">
+                        {t("dataSources.bigQuerySetup")}
+                      </Link>
+                    </Button>
+                  ) : null}
+                </div>
+                {health && healthStatus !== "unavailable" && (
+                  <div className="mt-3 grid grid-cols-3 gap-2 border-t border-border/30 pt-3">
+                    <div>
+                      <div className="text-muted-foreground">
+                        {t("dataSources.analyticsEventCount")}
+                      </div>
+                      <div className="font-medium text-foreground">
+                        {formatNumber(health.metrics.eventCount)}
+                      </div>
+                    </div>
+                    <div>
+                      <div className="text-muted-foreground">
+                        {t("dataSources.slowQueries24h")}
+                      </div>
+                      <div className="font-medium text-foreground">
+                        {formatNumber(health.metrics.slowQueryCount24h)}
+                      </div>
+                    </div>
+                    <div>
+                      <div className="text-muted-foreground">
+                        {t("dataSources.maxQueryDuration")}
+                      </div>
+                      <div className="font-medium text-foreground">
+                        {formatNumber(
+                          health.metrics.maxQueryDurationMs24h / 1_000,
+                          { maximumFractionDigits: 1 },
+                        )}
+                        s
+                      </div>
+                    </div>
+                  </div>
+                )}
+              </div>
+            )}
             <div className="grid gap-2 rounded-md border border-border/50 bg-muted/20 p-3 text-xs">
               <div className="flex items-center justify-between gap-3">
                 <span className="text-muted-foreground">

package/corpus/templates/analytics/changelog/2026-08-05-analytics-now-flags-neon-pressure-and-guides-high-volume-tra.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-05
+---
+
+Analytics now flags Neon pressure and guides high-volume tracking queries to BigQuery when needed

package/corpus/templates/analytics/changelog/2026-08-05-first-party-analytics-uses-compact-rollups-for-faster-usage-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-05
+---
+
+First-party analytics uses compact rollups for faster usage and retention queries

package/corpus/templates/analytics/server/db/schema.ts

@@ -258,6 +258,58 @@ export const analyticsEvents = table("analytics_events", {
   orgId: text("org_id"),
 });
 
+/**
+ * Compact daily event counts. The tenant key is non-null so the natural key
+ * remains unique for both organization-scoped and personal analytics keys.
+ */
+export const analyticsEventDailyRollups = table(
+  "analytics_event_daily_rollups",
+  {
+    id: text("id").primaryKey(),
+    tenantKey: text("tenant_key").notNull(),
+    ownerEmail: text("owner_email").notNull(),
+    orgId: text("org_id"),
+    eventDate: text("event_date").notNull(),
+    eventName: text("event_name").notNull(),
+    app: text("app").notNull().default(""),
+    template: text("template").notNull().default(""),
+    eventCount: integer("event_count").notNull().default(0),
+  },
+);
+
+/** One row per identifiable visitor and normalized event day. */
+export const analyticsUserDays = table("analytics_user_days", {
+  id: text("id").primaryKey(),
+  tenantKey: text("tenant_key").notNull(),
+  ownerEmail: text("owner_email").notNull(),
+  orgId: text("org_id"),
+  eventDate: text("event_date").notNull(),
+  userKey: text("user_key").notNull(),
+});
+
+/**
+ * Compact pressure signals for first-party queries that are already slow or
+ * failing. Successful fast queries never write here, so the diagnostic path
+ * cannot become another hot-path event log.
+ */
+export const analyticsQueryPressureDaily = table(
+  "analytics_query_pressure_daily",
+  {
+    id: text("id").primaryKey(),
+    tenantKey: text("tenant_key").notNull(),
+    ownerEmail: text("owner_email").notNull(),
+    orgId: text("org_id"),
+    eventDate: text("event_date").notNull(),
+    queryClass: text("query_class").notNull(),
+    slowQueryCount: integer("slow_query_count").notNull().default(0),
+    timeoutCount: integer("timeout_count").notNull().default(0),
+    errorCount: integer("error_count").notNull().default(0),
+    totalDurationMs: integer("total_duration_ms").notNull().default(0),
+    maxDurationMs: integer("max_duration_ms").notNull().default(0),
+    lastSeenAt: text("last_seen_at").notNull(),
+  },
+);
+
 /**
  * Generic alert rules over first-party analytics events. Rules are owned by a
  * user/org but can target any app, template, event name, or event property.

package/corpus/templates/analytics/server/lib/credential-keys.ts

@@ -57,6 +57,8 @@ export const credentialKeys: CredentialKeyConfig[] = [
   { key: "POSTHOG_API_KEY", label: "PostHog API Key", required: false },
   { key: "POSTHOG_PROJECT_ID", label: "PostHog Project ID", required: false },
   { key: "POSTHOG_HOST", label: "PostHog Host", required: false },
+  // FullStory Server API fallback for structured reads
+  { key: "FULLSTORY_API_KEY", label: "FullStory API key", required: false },
   // PostgreSQL (user's external DB, not the app's DATABASE_URL)
   { key: "POSTGRES_URL", label: "PostgreSQL URL", required: false },
   // Stripe
@@ -342,6 +344,7 @@ const credentialAliases: Record<string, string[]> = {
   postgres: ["POSTGRES_URL"],
   postgresql: ["POSTGRES_URL"],
   posthog: ["POSTHOG_API_KEY", "POSTHOG_PROJECT_ID", "POSTHOG_HOST"],
+  fullstory: ["FULLSTORY_API_KEY"],
   prometheus: [
     "PROMETHEUS_URL",
     "PROMETHEUS_USERNAME",