@happyvertical/smrt-analytics 0.30.0

package/dist/playground.js

@@ -0,0 +1,99 @@
+const sampleStats = {
+  todayPageviews: 18240,
+  yesterdayPageviews: 15980,
+  todayUsers: 3924,
+  yesterdayUsers: 3410,
+  trend: "up",
+  trendPercent: 14.1
+};
+const sampleEvents = [
+  {
+    id: "analytics-event-1",
+    eventName: "page_view",
+    clientId: "client_01HJQ9M4X0A8Q2D",
+    pagePath: "/guides/editorial-playbook",
+    eventTimestamp: "2026-03-21T16:14:00.000Z",
+    status: "sent"
+  },
+  {
+    id: "analytics-event-2",
+    eventName: "cta_click",
+    clientId: "client_01HJQ9M4X0A8Q2D",
+    pagePath: "/pricing",
+    eventTimestamp: "2026-03-21T16:10:00.000Z",
+    status: "sent"
+  },
+  {
+    id: "analytics-event-3",
+    eventName: "form_submit",
+    clientId: "client_01HJQ9NGH1J9Q8R",
+    pagePath: "/newsletter",
+    eventTimestamp: "2026-03-21T15:58:00.000Z",
+    status: "pending"
+  }
+];
+const loadAnalyticsSummary = () => import("./svelte/AnalyticsSummary.svelte");
+const loadEventsTable = () => import("./svelte/EventsTable.svelte");
+const loadPropertyInfo = () => import("./svelte/PropertyInfo.svelte");
+const playground = {
+  packageName: "@happyvertical/smrt-analytics",
+  displayName: "Analytics",
+  description: "Dashboard primitives for property health, traffic trends, and recent event delivery.",
+  entries: [
+    {
+      id: "analytics-summary",
+      title: "Analytics Summary",
+      description: "Traffic summary cards that surface today-vs-yesterday performance at a glance.",
+      loadComponent: loadAnalyticsSummary,
+      order: 1,
+      props: {
+        stats: sampleStats
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    },
+    {
+      id: "events-table",
+      title: "Events Table",
+      description: "Recent outbound analytics events with delivery status and page context.",
+      loadComponent: loadEventsTable,
+      order: 2,
+      props: {
+        events: sampleEvents,
+        maxRows: 8
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    },
+    {
+      id: "property-info",
+      title: "Property Info",
+      description: "Connection status and property metadata for a configured analytics destination.",
+      loadComponent: loadPropertyInfo,
+      order: 3,
+      props: {
+        propertyId: "properties/348920114",
+        measurementId: "G-9A4F2P7Q1C",
+        provider: "ga4",
+        status: "active",
+        lastSyncAt: "2026-03-21T16:05:00.000Z",
+        siteDomain: "newsroom.example.com"
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    }
+  ]
+};
+export {
+  playground as default
+};
+//# sourceMappingURL=playground.js.map

package/dist/playground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.js","sources":["../src/svelte/playground.ts"],"sourcesContent":["const sampleStats = {\n  todayPageviews: 18240,\n  yesterdayPageviews: 15980,\n  todayUsers: 3924,\n  yesterdayUsers: 3410,\n  trend: 'up',\n  trendPercent: 14.1,\n};\n\nconst sampleEvents = [\n  {\n    id: 'analytics-event-1',\n    eventName: 'page_view',\n    clientId: 'client_01HJQ9M4X0A8Q2D',\n    pagePath: '/guides/editorial-playbook',\n    eventTimestamp: '2026-03-21T16:14:00.000Z',\n    status: 'sent',\n  },\n  {\n    id: 'analytics-event-2',\n    eventName: 'cta_click',\n    clientId: 'client_01HJQ9M4X0A8Q2D',\n    pagePath: '/pricing',\n    eventTimestamp: '2026-03-21T16:10:00.000Z',\n    status: 'sent',\n  },\n  {\n    id: 'analytics-event-3',\n    eventName: 'form_submit',\n    clientId: 'client_01HJQ9NGH1J9Q8R',\n    pagePath: '/newsletter',\n    eventTimestamp: '2026-03-21T15:58:00.000Z',\n    status: 'pending',\n  },\n];\n\nconst loadAnalyticsSummary = () => import('./AnalyticsSummary.svelte');\nconst loadEventsTable = () => import('./EventsTable.svelte');\nconst loadPropertyInfo = () => import('./PropertyInfo.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-analytics',\n  displayName: 'Analytics',\n  description:\n    'Dashboard primitives for property health, traffic trends, and recent event delivery.',\n  entries: [\n    {\n      id: 'analytics-summary',\n      title: 'Analytics Summary',\n      description:\n        'Traffic summary cards that surface today-vs-yesterday performance at a glance.',\n      loadComponent: loadAnalyticsSummary,\n      order: 1,\n      props: {\n        stats: sampleStats,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'events-table',\n      title: 'Events Table',\n      description:\n        'Recent outbound analytics events with delivery status and page context.',\n      loadComponent: loadEventsTable,\n      order: 2,\n      props: {\n        events: sampleEvents,\n        maxRows: 8,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'property-info',\n      title: 'Property Info',\n      description:\n        'Connection status and property metadata for a configured analytics destination.',\n      loadComponent: loadPropertyInfo,\n      order: 3,\n      props: {\n        propertyId: 'properties/348920114',\n        measurementId: 'G-9A4F2P7Q1C',\n        provider: 'ga4',\n        status: 'active',\n        lastSyncAt: '2026-03-21T16:05:00.000Z',\n        siteDomain: 'newsroom.example.com',\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n  ],\n};\n"],"names":[],"mappings":"AAAA,MAAM,cAAc;AAAA,EAClB,gBAAgB;AAAA,EAChB,oBAAoB;AAAA,EACpB,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,OAAO;AAAA,EACP,cAAc;AAChB;AAEA,MAAM,eAAe;AAAA,EACnB;AAAA,IACE,IAAI;AAAA,IACJ,WAAW;AAAA,IACX,UAAU;AAAA,IACV,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,QAAQ;AAAA,EAAA;AAAA,EAEV;AAAA,IACE,IAAI;AAAA,IACJ,WAAW;AAAA,IACX,UAAU;AAAA,IACV,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,QAAQ;AAAA,EAAA;AAAA,EAEV;AAAA,IACE,IAAI;AAAA,IACJ,WAAW;AAAA,IACX,UAAU;AAAA,IACV,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,QAAQ;AAAA,EAAA;AAEZ;AAEA,MAAM,uBAAuB,MAAM,OAAO,kCAA2B;AACrE,MAAM,kBAAkB,MAAM,OAAO,6BAAsB;AAC3D,MAAM,mBAAmB,MAAM,OAAO,8BAAuB;AAE7D,MAAA,aAAe;AAAA,EACb,aAAa;AAAA,EACb,aAAa;AAAA,EACb,aACE;AAAA,EACF,SAAS;AAAA,IACP;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,eAAe;AAAA,MACf,OAAO;AAAA,MACP,OAAO;AAAA,QACL,OAAO;AAAA,MAAA;AAAA,MAET,OAAO;AAAA,QACL,MAAM;AAAA,UACJ,OAAO;AAAA,QAAA;AAAA,MACT;AAAA,IACF;AAAA,IAEF;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,eAAe;AAAA,MACf,OAAO;AAAA,MACP,OAAO;AAAA,QACL,QAAQ;AAAA,QACR,SAAS;AAAA,MAAA;AAAA,MAEX,OAAO;AAAA,QACL,MAAM;AAAA,UACJ,OAAO;AAAA,QAAA;AAAA,MACT;AAAA,IACF;AAAA,IAEF;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,eAAe;AAAA,MACf,OAAO;AAAA,MACP,OAAO;AAAA,QACL,YAAY;AAAA,QACZ,eAAe;AAAA,QACf,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,YAAY;AAAA,MAAA;AAAA,MAEd,OAAO;AAAA,QACL,MAAM;AAAA,UACJ,OAAO;AAAA,QAAA;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEJ;"}

package/dist/prompts.d.ts

@@ -0,0 +1,57 @@
+import { ResolvedPromptAI } from '@happyvertical/smrt-prompts';
+/**
+ * `AnalyticsProperty.analyzePerformance()` prompt. Only the human-readable
+ * display name, provider label, and the requested period reach the model;
+ * provider IDs, API secrets, and the providerMetadata blob are excluded.
+ */
+export declare const smrtAnalyticsAnalyzePerformancePrompt: import('@happyvertical/smrt-prompts').PromptDefinition;
+/**
+ * `AnalyticsReport.analyzeResults()` prompt. Surfaces report name, the
+ * dimension/metric labels (which are public GA4/Plausible/Matomo schema
+ * names — not user data), the date-range window, and the row count plus
+ * a JSON-stringified `resultData` blob.
+ *
+ * **`resultData` is forwarded verbatim.** This package does not strip PII
+ * from result rows — it cannot, because the row schema is determined by
+ * the dimensions/metrics the caller asked the analytics provider to
+ * return. If the caller persists rows containing a `userPseudoId`,
+ * `clientId`, IP-derived geolocation, or any other identifier, those
+ * fields WILL reach the AI provider. Either:
+ *
+ *   - exclude PII-bearing dimensions before persisting `resultData`
+ *     (e.g. don't request `userPseudoId` as a GA4 dimension), or
+ *   - apply a column allowlist at the call site before invoking
+ *     `analyzeResults()`, or
+ *   - override the prompt template via `PromptOverride` to redact rows.
+ *
+ * The forwarding contract is pinned by a regression test in
+ * `__tests__/analytics-report-prompt.test.ts`.
+ */
+export declare const smrtAnalyticsAnalyzeResultsPrompt: import('@happyvertical/smrt-prompts').PromptDefinition;
+/**
+ * `AnalyticsReport.hasPositiveTrends()` boolean classifier prompt. Same
+ * variables as `analyzeResults` minus the descriptive name — only the
+ * provider-schema metric labels and the aggregate `resultData` payload are
+ * needed to decide whether the trend is positive.
+ *
+ * The template explicitly instructs the model to begin its response with
+ * either "yes" or "no" so the boolean coercion in `hasPositiveTrends()`
+ * (`/^\s*(yes|true)\b/i`) is reliable. Without the leading-word
+ * instruction the model commonly answers with prose that happens to
+ * describe positive trends but starts with a sentence like "The
+ * conversion rate is up..." — the parser would then treat that as
+ * `false` despite a positive analysis. Tenants overriding this template
+ * MUST preserve the leading yes/no convention.
+ */
+export declare const smrtAnalyticsHasPositiveTrendsPrompt: import('@happyvertical/smrt-prompts').PromptDefinition;
+/**
+ * Build the message-options object passed to `aiClient.message()` from a
+ * `ResolvedPromptAI` shape. Mirrors the helper in `smrt-properties` and
+ * `smrt-content` so behavior across packages is identical.
+ */
+export declare function promptMessageOptions(ai: ResolvedPromptAI): {
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    model?: string | undefined;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,wDAWhD,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,iCAAiC,wDAsB5C,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oCAAoC,wDAkB/C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,gBAAgB;;;;EASxD"}