@happyvertical/smrt-analytics 0.51.31 → 0.51.33

package/dist/prompts.d.ts

@@ -1,10 +1,54 @@
-import { ResolvedPromptAI } from '@happyvertical/smrt-prompts';
+/**
+ * Prompt registrations for the @happyvertical/smrt-analytics package.
+ *
+ * Prompts are registered at module-load time via `definePrompt()` so that
+ * tenant-aware overrides can be applied at call time via `resolvePrompt()`.
+ *
+ * Mirrors the pattern used by `@happyvertical/smrt-properties` (see
+ * `prompts.ts`) and `@happyvertical/smrt-content` (see `content-prompts.ts`).
+ *
+ * PII / internal-field exclusion policy:
+ *
+ * Variables that this package never forwards to the AI provider:
+ *   - `id`, `tenantId`, `propertyId` and other foreign-key/UUID fields —
+ *     they identify internal records and provide no analytic value.
+ *   - `apiSecret`, `measurementId`, `externalId`, `siteDomain` — these are
+ *     provider credentials or platform-specific identifiers (e.g. GA4 API
+ *     secrets, Matomo `idSite`, custom `G-XXXX` measurement IDs) that may
+ *     be tenant-private configuration.
+ *   - `providerMetadata` — extensible JSON blob that may contain
+ *     credentials, account IDs, or other configuration secrets.
+ *   - `lastError`, raw `dimensionFilter` / `metricFilter` JSON — internal
+ *     error strings (which may contain auth tokens) and filter expressions
+ *     that may reference cookie IDs or user-pseudo-IDs are kept out of the
+ *     prompt variable set.
+ *
+ * Variables this package DOES forward (potentially carrying PII the caller
+ * persisted):
+ *   - `reportData` (a JSON.stringify of the persisted `resultData`) — this
+ *     is forwarded VERBATIM to the AI in `analyzeResults` and
+ *     `hasPositiveTrends`. The package cannot strip PII because the row
+ *     schema is determined by which dimensions/metrics the caller asked
+ *     the analytics provider to return. If the persisted rows contain
+ *     `userPseudoId`, `clientId`, IP-derived geolocation, or any other
+ *     identifier, those fields WILL reach the AI provider. The forwarding
+ *     is pinned by a regression test in
+ *     `__tests__/analytics-report-prompt.test.ts`. Callers must either
+ *     exclude PII-bearing dimensions before persisting, apply a column
+ *     allowlist at the call site, or override the prompt template via
+ *     `PromptOverride` to redact rows.
+ *
+ * Acceptable variables (always safe): human-readable names, time periods,
+ * computed aggregates (row counts, totals), and high-level dimension/metric
+ * labels (which are public GA4/Plausible/Matomo schema names).
+ */
+import { type 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;
+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
@@ -27,7 +71,7 @@ export declare const smrtAnalyticsAnalyzePerformancePrompt: import('@happyvertic
  * 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;
+export declare const smrtAnalyticsAnalyzeResultsPrompt: import("@happyvertical/smrt-prompts").PromptDefinition;
 /**
  * `AnalyticsReport.hasPositiveTrends()` boolean classifier prompt. Same
  * variables as `analyzeResults` minus the descriptive name — only the
@@ -43,7 +87,7 @@ export declare const smrtAnalyticsAnalyzeResultsPrompt: import('@happyvertical/s
  * `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;
+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

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-analytics",
-  "packageVersion": "0.51.31",
+  "packageVersion": "0.51.33",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "8f5da29a47067a9daa1e84b030cfc77e4bbb286be563c5204f296e15fdc64927",
-    "packageJson": "f202e299e56a6e05673c9e2e9c3d7da7c91ee7aa9a29f26c0ea662bc3deb189c",
+    "manifest": "f7832ca9a3ae2e584a4883e031cc73f22c3c11a275758ca25988d048d9ed45ae",
+    "packageJson": "d738a8706e3a2e35e847b4a5334cf6275b2fc1772ef2a98b3133f58a9fefa547",
     "agents": "baaeb44320f95dc5dc86925318e791369681ad80acfbb82a0f667f2aed0e511c"
   },
   "exports": [
@@ -32,7 +32,7 @@
     "fast-glob": "3.3.3",
     "svelte-check": "^4.7.6",
     "svelte": "^5.57.1",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/dist/ui.d.ts

@@ -1,4 +1,17 @@
-import { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+/**
+ * Analytics Module UI Slot Declarations
+ *
+ * This file defines the UI extension points for the analytics module.
+ * UI components are implemented in the ./svelte subpath and auto-register
+ * with `ModuleUIRegistry` when that subpath is imported.
+ *
+ * @example Usage
+ * ```typescript
+ * import { ANALYTICS_MODULE_META } from '@happyvertical/smrt-analytics/ui';
+ * console.log(ANALYTICS_MODULE_META.uiSlots);
+ * ```
+ */
+import type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
 /**
  * Analytics module UI slots
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-analytics",
-  "version": "0.51.31",
+  "version": "0.51.33",
   "smrtJsdoc": "strict",
   "description": "Analytics integration models for SMRT framework",
   "type": "module",
@@ -33,11 +33,11 @@
     }
   },
   "dependencies": {
-    "@happyvertical/smrt-core": "0.51.31",
-    "@happyvertical/smrt-prompts": "0.51.31",
-    "@happyvertical/smrt-tenancy": "0.51.31",
-    "@happyvertical/smrt-types": "0.51.31",
-    "@happyvertical/smrt-ui": "0.51.31"
+    "@happyvertical/smrt-core": "0.51.33",
+    "@happyvertical/smrt-prompts": "0.51.33",
+    "@happyvertical/smrt-tenancy": "0.51.33",
+    "@happyvertical/smrt-types": "0.51.33",
+    "@happyvertical/smrt-ui": "0.51.33"
   },
   "peerDependencies": {
     "svelte": "^5.57.1"
@@ -48,14 +48,14 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.51.31",
+    "@happyvertical/smrt-vitest": "0.51.33",
     "@happyvertical/sql": "^0.94.1",
     "@sveltejs/package": "^2.5.8",
     "@types/node": "24.13.6",
     "fast-glob": "3.3.3",
     "svelte-check": "^4.7.6",
     "svelte": "^5.57.1",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },