@happyvertical/smrt-analytics 0.30.0

package/dist/models/AnalyticsDataStream.d.ts

@@ -0,0 +1,94 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { DataStreamStatus, DataStreamType } from '../types/index.js';
+/**
+ * AnalyticsDataStream represents a data stream (web, iOS, Android) for an analytics property.
+ *
+ * @example
+ * ```typescript
+ * const stream = await streams.create({
+ *   propertyId: property.id,
+ *   displayName: 'Web Stream',
+ *   streamType: DataStreamType.WEB,
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   defaultUri: 'https://example.com'
+ * });
+ * ```
+ */
+export declare class AnalyticsDataStream extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenancy isolation (#1410).
+     *
+     * Data streams expose tenant-private platform configuration (measurement
+     * IDs, Firebase app IDs, bundle/package names, default URIs). Without tenant
+     * scoping the generated `list`/`get` API returns every tenant's streams.
+     * `@TenantScoped` auto-filters reads and binds writes to the active tenant.
+     */
+    tenantId: string | null;
+    /**
+     * Parent property ID (references AnalyticsProperty)
+     */
+    propertyId: string;
+    /**
+     * Human-readable display name
+     */
+    displayName: string;
+    /**
+     * Stream type (WEB, ANDROID, IOS)
+     */
+    streamType: DataStreamType;
+    /**
+     * External stream ID from provider
+     */
+    externalId: string;
+    /**
+     * Measurement ID for web streams (G-XXXXXXX)
+     */
+    measurementId: string;
+    /**
+     * Firebase App ID for app streams
+     */
+    firebaseAppId: string;
+    /**
+     * Default URI for web streams
+     */
+    defaultUri: string;
+    /**
+     * Bundle ID for iOS apps
+     */
+    bundleId: string;
+    /**
+     * Package name for Android apps
+     */
+    packageName: string;
+    /**
+     * Stream status
+     */
+    status: DataStreamStatus;
+    /**
+     * Enhanced measurement enabled
+     */
+    enhancedMeasurement: boolean;
+    constructor(options?: any);
+    /**
+     * Check if this is a web stream
+     */
+    isWeb(): boolean;
+    /**
+     * Check if this is an iOS app stream
+     */
+    isIOS(): boolean;
+    /**
+     * Check if this is an Android app stream
+     */
+    isAndroid(): boolean;
+    /**
+     * Check if this is a mobile app stream (iOS or Android)
+     */
+    isMobileApp(): boolean;
+    /**
+     * Get the platform identifier (measurementId for web, firebaseAppId for apps)
+     */
+    getPlatformId(): string;
+}
+export default AnalyticsDataStream;
+//# sourceMappingURL=AnalyticsDataStream.d.ts.map

package/dist/models/AnalyticsDataStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsDataStream.d.ts","sourceRoot":"","sources":["../../src/models/AnalyticsDataStream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,qBAOa,mBAAoB,SAAQ,UAAU;IACjD;;;;;;;OAOG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAEH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;IAEzB;;OAEG;IACH,UAAU,EAAE,cAAc,CAAsB;IAEhD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAM;IAE3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAM;IAE3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAM;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;IAEzB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAA2B;IAEnD;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAQ;gBAExB,OAAO,GAAE,GAAQ;IAqB7B;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,aAAa,IAAI,MAAM;CAMxB;AAED,eAAe,mBAAmB,CAAC"}

package/dist/models/AnalyticsEvent.d.ts

@@ -0,0 +1,142 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { TrackingEventStatus } from '../types/index.js';
+/**
+ * AnalyticsEvent represents a tracked analytics event (server-side tracking log).
+ *
+ * @example
+ * ```typescript
+ * const event = await events.create({
+ *   propertyId: property.id,
+ *   eventName: 'purchase',
+ *   clientId: 'user-123',
+ *   params: JSON.stringify({ value: 99.99, currency: 'USD' })
+ * });
+ * await event.send();
+ * ```
+ */
+export declare class AnalyticsEvent extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenancy isolation (#1410).
+     *
+     * Analytics events carry end-user PII (`userId`, `clientId`, `ipAddress`,
+     * `userAgent`, `sessionId`). Without tenant scoping the generated
+     * `list`/`get` API leaks every tenant's visitor data, and `create` lets a
+     * caller write events bound to another tenant's `propertyId`. `@TenantScoped`
+     * auto-filters reads and binds writes to the active tenant context.
+     */
+    tenantId: string | null;
+    /**
+     * Parent property ID (references AnalyticsProperty)
+     */
+    propertyId: string;
+    /**
+     * Event name (e.g., 'purchase', 'page_view', 'sign_up')
+     */
+    eventName: string;
+    /**
+     * Client ID for anonymous tracking
+     */
+    clientId: string;
+    /**
+     * User ID for identified tracking
+     */
+    userId: string;
+    /**
+     * Event parameters (JSON)
+     */
+    params: string;
+    /**
+     * Event timestamp
+     */
+    eventTimestamp: Date;
+    /**
+     * Tracking status
+     */
+    status: TrackingEventStatus;
+    /**
+     * Timestamp when sent to provider
+     */
+    sentAt: Date | null;
+    /**
+     * Error message if sending failed
+     */
+    errorMessage: string;
+    /**
+     * Retry count
+     */
+    retryCount: number;
+    /**
+     * Disable personalized ads
+     */
+    nonPersonalizedAds: boolean;
+    /**
+     * Session ID
+     */
+    sessionId: string;
+    /**
+     * Page path (for pageview events)
+     */
+    pagePath: string;
+    /**
+     * Page title (for pageview events)
+     */
+    pageTitle: string;
+    /**
+     * User agent
+     */
+    userAgent: string;
+    /**
+     * IP address (anonymized)
+     */
+    ipAddress: string;
+    constructor(options?: any);
+    /**
+     * Get parsed event parameters
+     */
+    getParams(): Record<string, string | number | boolean>;
+    /**
+     * Set event parameters
+     */
+    setParams(params: Record<string, string | number | boolean>): void;
+    /**
+     * Add a parameter to the event
+     */
+    addParam(key: string, value: string | number | boolean): void;
+    /**
+     * Check if this is a pageview event
+     */
+    isPageview(): boolean;
+    /**
+     * Check if this is a conversion event
+     */
+    isConversion(): boolean;
+    /**
+     * Mark as sent successfully
+     */
+    markSent(): void;
+    /**
+     * Mark as failed
+     */
+    markFailed(error: string): void;
+    /**
+     * Reset for retry
+     */
+    resetForRetry(): void;
+    /**
+     * Check if event should be retried
+     */
+    shouldRetry(maxRetries?: number): boolean;
+    /**
+     * Build SDK TrackEvent object
+     */
+    toTrackEvent(): {
+        name: string;
+        params?: Record<string, string | number | boolean>;
+        clientId?: string;
+        userId?: string;
+        timestamp?: number;
+        nonPersonalizedAds?: boolean;
+    };
+}
+export default AnalyticsEvent;
+//# sourceMappingURL=AnalyticsEvent.d.ts.map

package/dist/models/AnalyticsEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsEvent.d.ts","sourceRoot":"","sources":["../../src/models/AnalyticsEvent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,qBAOa,cAAe,SAAQ,UAAU;IAC5C;;;;;;;;OAQG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAEH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAM;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAM;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAQ;IAEtB;;OAEG;IACH,cAAc,EAAE,IAAI,CAAc;IAElC;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAA+B;IAE1D;;OAEG;IACH,MAAM,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE3B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAM;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAK;IAEvB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAS;IAEpC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAM;IAEtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;gBAEX,OAAO,GAAE,GAAQ;IAwB7B;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAQtD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAIlE;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAM7D;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAUvB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,WAAW,CAAC,UAAU,GAAE,MAAU,GAAG,OAAO;IAM5C;;OAEG;IACH,YAAY,IAAI;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;QACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B;CAUF;AAED,eAAe,cAAc,CAAC"}

package/dist/models/AnalyticsProperty.d.ts

@@ -0,0 +1,142 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { AnalyticsPropertyStatus, AnalyticsProvider } from '../types/index.js';
+/**
+ * AnalyticsProperty represents an analytics property (GA4 property,
+ * Plausible site, or Matomo site).
+ *
+ * @example
+ * ```typescript
+ * const property = await properties.create({
+ *   name: 'My Website',
+ *   displayName: 'My Website Analytics',
+ *   provider: AnalyticsProvider.GA4,
+ *   externalId: 'properties/123456789',
+ *   measurementId: 'G-XXXXXXXXXX'
+ * });
+ * ```
+ */
+export declare class AnalyticsProperty extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenancy isolation (#1410).
+     *
+     * Without tenant scoping the generated `list`/`get` API and any raw query
+     * return every tenant's properties — including the `@field({ sensitive })`
+     * `apiSecret` / `providerMetadata` credentials. `@TenantScoped` registers
+     * this class with the tenant interceptor so reads are auto-filtered and
+     * writes are bound to the active tenant context.
+     */
+    tenantId: string | null;
+    /**
+     * Internal name/identifier
+     */
+    name: string;
+    /**
+     * Human-readable display name
+     */
+    displayName: string;
+    /**
+     * Analytics provider (ga4, plausible, matomo)
+     */
+    provider: AnalyticsProvider;
+    /**
+     * External ID from the provider (e.g., "properties/123456789" for GA4,
+     * idSite for Matomo)
+     */
+    externalId: string;
+    /**
+     * Measurement ID for GA4 (G-XXXXXXXXXX)
+     */
+    measurementId: string;
+    /**
+     * Provider API secret/token (GA4 API secret, Matomo token_auth)
+     *
+     * Sensitive (#1540): excluded from generated API/MCP responses and rejected
+     * as a `where` filter key so it can't be probed.
+     */
+    apiSecret: string;
+    /**
+     * Site domain for Plausible/Matomo
+     */
+    siteDomain: string;
+    /**
+     * Property timezone
+     */
+    timeZone: string;
+    /**
+     * Currency code (e.g., 'USD', 'EUR')
+     */
+    currencyCode: string;
+    /**
+     * Industry category
+     */
+    industryCategory: string;
+    /**
+     * Service level (STANDARD, PREMIUM)
+     */
+    serviceLevel: string;
+    /**
+     * Property status
+     */
+    status: AnalyticsPropertyStatus;
+    /**
+     * Last sync timestamp with provider
+     */
+    lastSyncAt: Date | null;
+    /**
+     * Metadata from provider (JSON)
+     *
+     * Sensitive (#1540): may carry provider credentials/tokens, so it is excluded
+     * from generated API/MCP responses and rejected as a `where` filter key.
+     */
+    providerMetadata: string;
+    constructor(options?: any);
+    /**
+     * Check if this is a GA4 property
+     */
+    isGA4(): boolean;
+    /**
+     * Check if this is a Plausible site
+     */
+    isPlausible(): boolean;
+    /**
+     * Check if this is a Matomo site
+     */
+    isMatomo(): boolean;
+    /**
+     * Get parsed provider metadata
+     */
+    getProviderMetadata(): Record<string, unknown>;
+    /**
+     * Set provider metadata
+     */
+    setProviderMetadata(metadata: Record<string, unknown>): void;
+    /**
+     * Mark as synced with provider
+     */
+    markSynced(): void;
+    /**
+     * AI-powered: Analyze property performance.
+     *
+     * Uses the `smrtAnalytics.property.analyzePerformance` prompt registered
+     * via `@happyvertical/smrt-prompts`, allowing tenant- or instance-level
+     * overrides of the template, model, and parameters at runtime.
+     *
+     * Only non-PII fields (display name, provider label, requested period)
+     * are sent to the AI provider. Internal identifiers (`id`, `externalId`,
+     * `measurementId`, `apiSecret`, `providerMetadata`) are intentionally
+     * excluded — see `../prompts.ts` for the full exclusion rationale.
+     */
+    analyzePerformance(options?: {
+        period?: string;
+    }): Promise<{
+        action: string;
+        period: string;
+        analysis: string;
+    }>;
+    /**
+     * AI-powered: Check if property is performing well
+     */
+    isPerformingWell(): Promise<boolean>;
+}
+export default AnalyticsProperty;
+//# sourceMappingURL=AnalyticsProperty.d.ts.map

package/dist/models/AnalyticsProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProperty.d.ts","sourceRoot":"","sources":["../../src/models/AnalyticsProperty.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAS,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAOnE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;;;;;;;;;;;GAcG;AACH,qBAOa,iBAAkB,SAAQ,UAAU;IAC/C;;;;;;;;OAQG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;IAEzB;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAyB;IAEpD;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAM;IAE3B;;;;;OAKG;IAEH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAyB;IAEzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAS;IAE7B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAM;IAE9B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAc;IAElC;;OAEG;IACH,MAAM,EAAE,uBAAuB,CAAkC;IAEjE;;OAEG;IACH,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE/B;;;;;OAKG;IAEH,gBAAgB,EAAE,MAAM,CAAQ;gBAEpB,OAAO,GAAE,GAAQ;IAyB7B;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ9C;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;;;;;;;OAWG;IACG,kBAAkB,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QACnE,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IA2CF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;CAe3C;AAED,eAAe,iBAAiB,CAAC"}

package/dist/models/AnalyticsReport.d.ts

@@ -0,0 +1,206 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { ReportFrequency, ReportStatus } from '../types/index.js';
+/**
+ * AnalyticsReport represents a saved report configuration with optional scheduling.
+ *
+ * @example
+ * ```typescript
+ * const report = await reports.create({
+ *   propertyId: property.id,
+ *   name: 'Weekly Traffic Report',
+ *   dimensions: JSON.stringify([{ name: 'country' }, { name: 'deviceCategory' }]),
+ *   metrics: JSON.stringify([{ name: 'activeUsers' }, { name: 'sessions' }]),
+ *   frequency: ReportFrequency.WEEKLY
+ * });
+ * ```
+ */
+export declare class AnalyticsReport extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenancy isolation (#1410).
+     *
+     * Reports persist `resultData` rows that may contain tenant-private metrics
+     * and PII-bearing dimensions. Without tenant scoping the generated
+     * `list`/`get` API returns every tenant's cached report data, and the
+     * AI-powered `analyze`/`run` operations could run over another tenant's
+     * rows. `@TenantScoped` auto-filters reads and binds writes to the tenant.
+     */
+    tenantId: string | null;
+    /**
+     * Parent property ID (references AnalyticsProperty)
+     */
+    propertyId: string;
+    /**
+     * Report name
+     */
+    name: string;
+    /**
+     * Report description
+     */
+    description: string;
+    /**
+     * Dimensions to group by (JSON array)
+     */
+    dimensions: string;
+    /**
+     * Metrics to retrieve (JSON array)
+     */
+    metrics: string;
+    /**
+     * Date range start (relative or absolute)
+     */
+    dateRangeStart: string;
+    /**
+     * Date range end (relative or absolute)
+     */
+    dateRangeEnd: string;
+    /**
+     * Dimension filter expression (JSON)
+     */
+    dimensionFilter: string;
+    /**
+     * Metric filter expression (JSON)
+     */
+    metricFilter: string;
+    /**
+     * Sort order (JSON array)
+     */
+    orderBy: string;
+    /**
+     * Maximum results to return
+     */
+    maxResults: number;
+    /**
+     * Report status
+     */
+    status: ReportStatus;
+    /**
+     * Scheduling frequency
+     */
+    frequency: ReportFrequency;
+    /**
+     * Last run timestamp
+     */
+    lastRunAt: Date | null;
+    /**
+     * Next scheduled run
+     */
+    nextRunAt: Date | null;
+    /**
+     * Cached result data (JSON)
+     */
+    resultData: string;
+    /**
+     * Row count from last run
+     */
+    rowCount: number;
+    /**
+     * Error message from last failed run
+     */
+    lastError: string;
+    constructor(options?: any);
+    /**
+     * Get parsed dimensions
+     */
+    getDimensions(): Array<{
+        name: string;
+    }>;
+    /**
+     * Set dimensions
+     */
+    setDimensions(dimensions: Array<{
+        name: string;
+    }>): void;
+    /**
+     * Get parsed metrics
+     */
+    getMetrics(): Array<{
+        name: string;
+    }>;
+    /**
+     * Set metrics
+     */
+    setMetrics(metrics: Array<{
+        name: string;
+    }>): void;
+    /**
+     * Get parsed result data
+     */
+    getResultData(): Record<string, unknown> | null;
+    /**
+     * Set result data
+     */
+    setResultData(data: Record<string, unknown>): void;
+    /**
+     * Mark report as running
+     */
+    markRunning(): void;
+    /**
+     * Mark report as completed with results
+     */
+    markCompleted(rowCount: number): void;
+    /**
+     * Mark report as failed
+     */
+    markFailed(error: string): void;
+    /**
+     * Calculate next scheduled run based on frequency
+     */
+    calculateNextRun(): void;
+    /**
+     * Check if report is due to run
+     */
+    isDue(): boolean;
+    /**
+     * AI-powered: Analyze report results.
+     *
+     * Uses the `smrtAnalytics.report.analyzeResults` prompt registered via
+     * `@happyvertical/smrt-prompts`, allowing tenant- or instance-level
+     * overrides of the template, model, and parameters at runtime.
+     *
+     * Internal identifiers (`id`, `propertyId`, `tenantId`, `lastError`, raw
+     * `dimensionFilter` / `metricFilter` JSON) are excluded from the prompt
+     * variables — see `../prompts.ts` for the exclusion rationale.
+     *
+     * **`resultData` is FORWARDED VERBATIM.** The persisted result rows are
+     * JSON-stringified into the `reportData` variable; this 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. Callers are responsible for excluding PII-bearing dimensions
+     * before persisting, applying a column allowlist at the call site, or
+     * overriding the prompt template via `PromptOverride`. The forwarding is
+     * pinned by a regression test in
+     * `__tests__/analytics-report-prompt.test.ts`.
+     *
+     * The previous implementation issued a second freeform `this.do()` call
+     * to re-summarize "top 3 insights"; that behaviour is now folded into
+     * the single registered template (which already asks for findings,
+     * trends, and recommendations) — `insights` mirrors `analysis` so the
+     * return shape is preserved without a redundant AI round-trip.
+     */
+    analyzeResults(_options?: any): Promise<{
+        action: string;
+        analysis: string;
+        insights: string;
+    }>;
+    /**
+     * AI-powered: Check if results show positive trends.
+     *
+     * Uses the `smrtAnalytics.report.hasPositiveTrends` prompt registered
+     * via `@happyvertical/smrt-prompts`. Only the metric labels and the
+     * aggregate `resultData` JSON are sent to the AI provider — though as
+     * with `analyzeResults`, `resultData` is forwarded verbatim and may
+     * carry PII the caller persisted; see `analyzeResults` docstring and
+     * `../prompts.ts`.
+     *
+     * Boolean coercion uses `/^\s*(yes|true)\b/i` against the trimmed
+     * response. The registered prompt template explicitly instructs the
+     * model to begin its answer with the literal word "yes" or "no" so
+     * this regex is reliable; tenant overrides MUST preserve that leading-
+     * word convention or the boolean will silently fall to `false`.
+     */
+    hasPositiveTrends(): Promise<boolean>;
+}
+export default AnalyticsReport;
+//# sourceMappingURL=AnalyticsReport.d.ts.map

package/dist/models/AnalyticsReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsReport.d.ts","sourceRoot":"","sources":["../../src/models/AnalyticsReport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAQxE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,qBAOa,eAAgB,SAAQ,UAAU;IAC7C;;;;;;;;OAQG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAEH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;IAEzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAQ;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAQ;IAEvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAc;IAEpC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAW;IAE/B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAM;IAE7B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAM;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAQ;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAK;IAEvB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAsB;IAE1C;;OAEG;IACH,SAAS,EAAE,eAAe,CAAwB;IAElD;;OAEG;IACH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE9B;;OAEG;IACH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE9B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAK;IAErB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;gBAEX,OAAO,GAAE,GAAQ;IA4B7B;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAQxC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAQrC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAIlD;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS/C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIlD;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQrC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAwBxB;;OAEG;IACH,KAAK,IAAI,OAAO;IAQhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,cAAc,CAAC,QAAQ,GAAE,GAAQ,GAAG,OAAO,CAAC;QAChD,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAiDF;;;;;;;;;;;;;;;OAeG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;CA2B5C;AAED,eAAe,eAAe,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Model exports for smrt-analytics
+ */
+export { AnalyticsDataStream } from './AnalyticsDataStream.js';
+export { AnalyticsEvent } from './AnalyticsEvent.js';
+export { AnalyticsProperty } from './AnalyticsProperty.js';
+export { AnalyticsReport } from './AnalyticsReport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/playground.d.ts

@@ -0,0 +1,2 @@
+export { default } from './svelte/playground.js';
+//# sourceMappingURL=playground.d.ts.map

package/dist/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}