@happyvertical/smrt-analytics 0.30.0

package/AGENTS.md

@@ -0,0 +1,68 @@
+# @happyvertical/smrt-analytics
+
+GA4/Plausible/Matomo analytics integration with server-side event tracking and AI-powered reporting.
+
+## Models
+
+- **AnalyticsProperty**: GA4 property, Plausible site, or Matomo site. Provider metadata, status, sync timestamps.
+- **AnalyticsDataStream**: web/iOS/Android data streams. Measurement IDs (G-XXXXXX for GA4, Firebase app ID for mobile).
+- **AnalyticsEvent**: tracked events with params (JSON), retry queue, conversion classification.
+- **AnalyticsReport**: saved report configs with dimensions/metrics (JSON), scheduling (daily/weekly/monthly), result caching.
+
+All models use STI (`tableStrategy: 'sti'`).
+
+All four persisted models are `@TenantScoped({ mode: 'optional' })` with a nullable `tenantId` (#1410), matching the framework convention used by sibling domain packages (ads/jobs/commerce). **When a tenant context is active**, the interceptor auto-filters `list`/`get`/raw reads and binds `create`/`save` writes to that tenant, keeping one tenant's properties, data streams, events (end-user PII), and cached report rows from reaching another. Because the mode is `optional`, the interceptor intentionally passes **through unfiltered when no tenant context is established** — so a surface is only safe insofar as it establishes tenant context first. Generated SvelteKit routes do this (#1540); the CLI/MCP code paths do not yet, which is a known framework-level residual (fail-closed tenant context for CLI/MCP) tracked outside this package, not an analytics-specific gap.
+
+## Key Collection Methods
+
+`findByExternalId()`, `findByProvider()`, `findNeedingSync()`, `findGA4Properties()`, `findPlausibleSites()`, `findMatomoSites()`
+
+## AI Operations
+
+`analyzePerformance()`, `analyzeResults()`, `hasPositiveTrends()` route through registered prompts (see Prompt Registry below) so tenant overrides apply via `resolvePrompt()`. `isPerformingWell()` still uses the inline `is()` shortcut.
+
+## Prompt Registry
+
+Three prompts are registered at module-load time via `definePrompt()` from `@happyvertical/smrt-prompts`. Re-exported from the package root for tenant override targeting.
+
+| Key | Method | Variables (PII-conscious) |
+|-----|--------|---------------------------|
+| `smrtAnalytics.property.analyzePerformance` | `AnalyticsProperty.analyzePerformance()` | `period`, `propertyDisplayName`, `propertyProvider` |
+| `smrtAnalytics.report.analyzeResults` | `AnalyticsReport.analyzeResults()` | `reportName`, `reportDimensions`, `reportMetrics`, `dateRangeStart`, `dateRangeEnd`, `rowCount`, `reportData` |
+| `smrtAnalytics.report.hasPositiveTrends` | `AnalyticsReport.hasPositiveTrends()` | `reportMetrics`, `reportData` |
+
+**Excluded from variables (never reach the AI provider):**
+- `id`, `propertyId`, `tenantId`, `externalId` — internal foreign keys / UUIDs that link to identifying records.
+- `apiSecret`, `measurementId`, `siteDomain` — provider credentials and platform-specific identifiers (GA4 API secrets, Matomo `idSite`, custom `G-XXXX` measurement IDs).
+- `providerMetadata` — extensible JSON blob that may contain credentials, account IDs, or other configuration secrets.
+- `lastError`, raw `dimensionFilter` / `metricFilter` JSON — internal error strings (may contain auth tokens) and filter expressions that may reference cookie IDs, user-pseudo-IDs, or IP-derived geos.
+
+**`resultData` is forwarded verbatim.** This package does not — and cannot — strip PII from result rows, 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. Callers must:
+
+- 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 `src/__tests__/analytics-report-prompt.test.ts`.
+
+See `src/prompts.ts` for the full rationale block.
+
+## UI Registry
+
+Svelte components live in `src/svelte/` and auto-register with `ModuleUIRegistry` from `@happyvertical/smrt-svelte/registry` when `@happyvertical/smrt-analytics/svelte` is imported.
+
+Slot declarations live in `src/ui.ts`, exported via the `./ui` package subpath. The slots are: `analytics-summary`, `events-table`, `property-info`, `property-status-badge`, `stat-card`, `trend-badge` (see `ANALYTICS_UI_SLOTS` for icons / categories / display order).
+
+```typescript
+import '@happyvertical/smrt-analytics/svelte'; // side-effect: registers slots
+import { ModuleUIRegistry } from '@happyvertical/smrt-svelte/registry';
+const StatCard = ModuleUIRegistry.get('@happyvertical/smrt-analytics', 'stat-card');
+```
+
+## Gotchas
+
+- **`apiSecret` / `providerMetadata` stripped from API/MCP**: marked `@field({ sensitive: true })` (#1540) so they never appear in generated responses or `where` filters. They are still stored at rest **unencrypted** — envelope encryption via `@happyvertical/smrt-secrets` is a separate, breaking follow-up (tracked, not done here).
+- **Event retry at model level**: no background job integration
+- **JSON fields**: params, dimensions, metrics use string storage with getter/setter helpers
+- **Measurement IDs differ per platform**: G-XXXXXX (GA4 web) vs Firebase app ID (mobile)
+- **`analyzeResults` is now a single AI call**: previously issued a second freeform `do()` to summarize "top 3 insights"; folded into the registered template, and `insights` mirrors `analysis` in the response shape.

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @happyvertical/smrt-analytics
+
+Analytics integration models for the SMRT framework. Manages analytics properties (GA4, Plausible, Matomo), data streams, server-side event tracking with retry support, and AI-powered report generation with scheduling.
+
+## Installation
+
+```bash
+pnpm add @happyvertical/smrt-analytics
+```
+
+## Usage
+
+```typescript
+import {
+  AnalyticsProperty, AnalyticsPropertyCollection,
+  AnalyticsDataStream, AnalyticsDataStreamCollection,
+  AnalyticsEvent, AnalyticsEventCollection,
+  AnalyticsReport, AnalyticsReportCollection,
+  AnalyticsProvider, DataStreamType, ReportFrequency
+} from '@happyvertical/smrt-analytics';
+
+// Create a GA4 property
+const properties = new AnalyticsPropertyCollection(db);
+const property = await properties.create({
+  name: 'main-site',
+  displayName: 'Main Site Analytics',
+  provider: AnalyticsProvider.GA4,
+  externalId: 'properties/123456789',
+  measurementId: 'G-XXXXXXXXXX',
+  apiSecret: 'server-side-secret',
+  status: 'active',
+});
+
+// Add a web data stream
+const streams = new AnalyticsDataStreamCollection(db);
+await streams.create({
+  propertyId: property.id,
+  displayName: 'Web Traffic',
+  streamType: DataStreamType.WEB,
+  measurementId: 'G-XXXXXXXXXX',
+  defaultUri: 'https://example.com',
+  status: 'active',
+});
+
+// Track a server-side event with retry support
+const events = new AnalyticsEventCollection(db);
+const event = await events.create({
+  propertyId: property.id,
+  eventName: 'purchase',
+  clientId: 'client-uuid',
+  params: JSON.stringify({ value: 99.99, currency: 'USD' }),
+  status: 'pending',
+});
+// After sending: event.markSent() or event.markFailed('timeout')
+// Retry logic: event.shouldRetry(3) checks retryCount < maxRetries
+
+// Create a scheduled report with dimensions and metrics
+const reports = new AnalyticsReportCollection(db);
+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' }]),
+  dateRangeStart: '7daysAgo',
+  dateRangeEnd: 'today',
+  frequency: ReportFrequency.WEEKLY,
+});
+
+// AI-powered operations (uses do() and is() from SmrtObject)
+const analysis = await property.analyzePerformance({ period: '30 days' });
+const isHealthy = await property.isPerformingWell();
+const insights = await report.analyzeResults();
+const trending = await report.hasPositiveTrends();
+```
+
+### Server-Side Event Lifecycle
+
+Events track their delivery status with built-in retry support:
+
+1. **PENDING** -- created, not yet sent to provider
+2. **SENT** -- successfully delivered (`markSent()` sets `sentAt` timestamp)
+3. **FAILED** -- delivery failed (`markFailed(error)` increments `retryCount`)
+
+Use `shouldRetry(maxRetries)` to check if a failed event should be retried, and `resetForRetry()` to reset it to PENDING.
+
+### Report Scheduling
+
+Reports support automatic scheduling via `ReportFrequency`:
+
+- `ONCE` -- single run, no rescheduling
+- `DAILY` / `WEEKLY` / `MONTHLY` -- `calculateNextRun()` sets `nextRunAt` after each run
+
+Use `isDue()` to check if a scheduled report needs to run.
+
+## API
+
+### Models
+
+| Export | Description |
+|--------|------------|
+| `AnalyticsProperty` | GA4 property, Plausible site, or Matomo site. AI methods: `analyzePerformance()`, `isPerformingWell()` |
+| `AnalyticsDataStream` | Data stream within a property (web/iOS/Android). `getPlatformId()` returns measurementId or firebaseAppId |
+| `AnalyticsEvent` | Server-side tracking event with retry queue. `toTrackEvent()` builds SDK payload |
+| `AnalyticsReport` | Saved report config with dimensions/metrics, scheduling, result caching. AI methods: `analyzeResults()`, `hasPositiveTrends()` |
+
+### Collections
+
+`AnalyticsPropertyCollection`, `AnalyticsDataStreamCollection`, `AnalyticsEventCollection`, `AnalyticsReportCollection`
+
+### Enums
+
+| Export | Description |
+|--------|------------|
+| `AnalyticsProvider` | `ga4`, `plausible`, `matomo` |
+| `AnalyticsPropertyStatus` | `active`, `inactive`, `pending` |
+| `DataStreamType` | `WEB_DATA_STREAM`, `ANDROID_APP_DATA_STREAM`, `IOS_APP_DATA_STREAM` |
+| `DataStreamStatus` | `active`, `inactive` |
+| `TrackingEventStatus` | `pending`, `sent`, `failed` |
+| `ReportStatus` | `draft`, `scheduled`, `running`, `completed`, `failed` |
+| `ReportFrequency` | `once`, `daily`, `weekly`, `monthly` |
+| `CountingMethod` | `ONCE_PER_EVENT`, `ONCE_PER_SESSION` |
+| `CustomDimensionScope` | `EVENT`, `USER`, `ITEM` |
+
+### SDK Types
+
+Re-exported from `./types` for SDK compatibility: `AnalyticsInterface`, `AnalyticsCapabilities`, `SDKProperty`, `SDKDataStream`, `SDKTrackEvent`, `SDKPageviewEvent`, `SDKReportOptions`, `SDKReportResult`, `SDKCustomDimension`, `SDKCustomMetric`, `SDKKeyEvent`, `PropertyStatsWithTrend`.
+
+## Dependencies
+
+- `@happyvertical/smrt-core` -- ORM and code generation
+- Peer: `svelte` (optional, for Svelte components via `@happyvertical/smrt-analytics/svelte`)

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/collections/AnalyticsDataStreamCollection.d.ts

@@ -0,0 +1,69 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { AnalyticsDataStream } from '../models/AnalyticsDataStream.js';
+import { DataStreamStatus, DataStreamType } from '../types/index.js';
+export declare class AnalyticsDataStreamCollection extends SmrtCollection<AnalyticsDataStream> {
+    static readonly _itemClass: typeof AnalyticsDataStream;
+    /**
+     * Find streams by property
+     *
+     * @param propertyId - Parent property ID
+     * @returns Array of data streams
+     */
+    findByProperty(propertyId: string): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find stream by external ID
+     *
+     * @param externalId - External stream ID from provider
+     * @returns Matching stream or null
+     */
+    findByExternalId(externalId: string): Promise<AnalyticsDataStream | null>;
+    /**
+     * Find stream by measurement ID (web streams)
+     *
+     * @param measurementId - GA4 measurement ID (G-XXXXXXX)
+     * @returns Matching stream or null
+     */
+    findByMeasurementId(measurementId: string): Promise<AnalyticsDataStream | null>;
+    /**
+     * Find streams by type
+     *
+     * @param streamType - Stream type (WEB, ANDROID, IOS)
+     * @returns Array of matching streams
+     */
+    findByType(streamType: DataStreamType): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find all web streams
+     */
+    findWebStreams(): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find all iOS app streams
+     */
+    findIOSStreams(): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find all Android app streams
+     */
+    findAndroidStreams(): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find all mobile app streams (iOS + Android)
+     */
+    findMobileStreams(): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find streams by status
+     *
+     * @param status - Stream status
+     * @returns Array of matching streams
+     */
+    findByStatus(status: DataStreamStatus): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find all active streams
+     */
+    findActive(): Promise<AnalyticsDataStream[]>;
+    /**
+     * Find active streams for a property
+     *
+     * @param propertyId - Parent property ID
+     * @returns Array of active streams
+     */
+    findActiveByProperty(propertyId: string): Promise<AnalyticsDataStream[]>;
+}
+//# sourceMappingURL=AnalyticsDataStreamCollection.d.ts.map

package/dist/collections/AnalyticsDataStreamCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsDataStreamCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AnalyticsDataStreamCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,qBAAa,6BAA8B,SAAQ,cAAc,CAAC,mBAAmB,CAAC;IACpF,MAAM,CAAC,QAAQ,CAAC,UAAU,6BAAuB;IAEjD;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOxE;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAQtC;;;;;OAKG;IACG,mBAAmB,CACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAQtC;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAO5E;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAItD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAItD;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAI1D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAQzD;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAO5E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAIlD;;;;;OAKG;IACG,oBAAoB,CACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,EAAE,CAAC;CASlC"}

package/dist/collections/AnalyticsEventCollection.d.ts

@@ -0,0 +1,131 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { AnalyticsEvent } from '../models/AnalyticsEvent.js';
+import { PropertyStatsWithTrend, TrackingEventStatus } from '../types/index.js';
+export declare class AnalyticsEventCollection extends SmrtCollection<AnalyticsEvent> {
+    static readonly _itemClass: typeof AnalyticsEvent;
+    /**
+     * Find events by property
+     *
+     * @param propertyId - Parent property ID
+     * @returns Array of events
+     */
+    findByProperty(propertyId: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Find events by event name
+     *
+     * @param eventName - Event name to filter by
+     * @returns Array of matching events
+     */
+    findByEventName(eventName: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Find events by client ID
+     *
+     * @param clientId - Client ID
+     * @returns Array of events for this client
+     */
+    findByClientId(clientId: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Find events by user ID
+     *
+     * @param userId - User ID
+     * @returns Array of events for this user
+     */
+    findByUserId(userId: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Find events by status
+     *
+     * @param status - Tracking event status
+     * @returns Array of matching events
+     */
+    findByStatus(status: TrackingEventStatus): Promise<AnalyticsEvent[]>;
+    /**
+     * Find all pending events
+     */
+    findPending(): Promise<AnalyticsEvent[]>;
+    /**
+     * Find all sent events
+     */
+    findSent(): Promise<AnalyticsEvent[]>;
+    /**
+     * Find all failed events
+     */
+    findFailed(): Promise<AnalyticsEvent[]>;
+    /**
+     * Find events that should be retried
+     *
+     * @param maxRetries - Maximum retry count
+     * @returns Array of events eligible for retry
+     */
+    findForRetry(maxRetries?: number): Promise<AnalyticsEvent[]>;
+    /**
+     * Find pending events for a property
+     *
+     * @param propertyId - Parent property ID
+     * @returns Array of pending events
+     */
+    findPendingByProperty(propertyId: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Find events by date range
+     *
+     * @param startDate - Start date
+     * @param endDate - End date
+     * @returns Array of events in date range
+     */
+    findByDateRange(startDate: Date, endDate: Date): Promise<AnalyticsEvent[]>;
+    /**
+     * Find conversion events
+     *
+     * @param propertyId - Optional property ID filter
+     * @returns Array of conversion events
+     */
+    findConversions(propertyId?: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Find pageview events
+     *
+     * @param propertyId - Optional property ID filter
+     * @returns Array of pageview events
+     */
+    findPageviews(propertyId?: string): Promise<AnalyticsEvent[]>;
+    /**
+     * Count events by event name for a property
+     *
+     * @param propertyId - Property ID
+     * @returns Map of event name to count
+     */
+    countByEventName(propertyId: string): Promise<Map<string, number>>;
+    /**
+     * Get event stats for a property
+     *
+     * @param propertyId - Property ID
+     * @returns Event statistics
+     */
+    getPropertyStats(propertyId: string): Promise<{
+        total: number;
+        pending: number;
+        sent: number;
+        failed: number;
+        conversions: number;
+        pageviews: number;
+    }>;
+    /**
+     * Get day-over-day pageview stats with trend for a property.
+     *
+     * Compares today's pageview count against yesterday's to produce a
+     * trend direction and percentage change. A threshold of 5% is used
+     * to classify 'up' vs 'down' vs 'flat'.
+     *
+     * @param propertyId - Property ID
+     * @param now - Optional current date (for testing)
+     * @returns Stats with trend
+     */
+    getPropertyStatsWithTrend(propertyId: string, now?: Date): Promise<PropertyStatsWithTrend>;
+    /**
+     * Get day-over-day stats for multiple properties in batch.
+     *
+     * @param propertyIds - Array of property IDs
+     * @param now - Optional current date (for testing)
+     * @returns Map of propertyId to stats
+     */
+    getBatchPropertyStats(propertyIds: string[], now?: Date): Promise<Map<string, PropertyStatsWithTrend>>;
+}
+//# sourceMappingURL=AnalyticsEventCollection.d.ts.map

package/dist/collections/AnalyticsEventCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsEventCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AnalyticsEventCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,KAAK,sBAAsB,EAC3B,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,UAAU,wBAAkB;IAE5C;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOnE;;;;;OAKG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOnE;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOjE;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAO7D;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAO1E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI7C;;;;;OAKG;IACG,YAAY,CAAC,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKrE;;;;;OAKG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAU1E;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B;;;;;OAKG;IACG,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAcrE;;;;;OAKG;IACG,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWnE;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYxE;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAClD,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAeF;;;;;;;;;;OAUG;IACG,yBAAyB,CAC7B,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,sBAAsB,CAAC;IA2DlC;;;;;;OAMG;IACG,qBAAqB,CACzB,WAAW,EAAE,MAAM,EAAE,EACrB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAqEhD"}

package/dist/collections/AnalyticsPropertyCollection.d.ts

@@ -0,0 +1,66 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { AnalyticsProperty } from '../models/AnalyticsProperty.js';
+import { AnalyticsPropertyStatus, AnalyticsProvider } from '../types/index.js';
+export declare class AnalyticsPropertyCollection extends SmrtCollection<AnalyticsProperty> {
+    static readonly _itemClass: typeof AnalyticsProperty;
+    /**
+     * Find property by external ID
+     *
+     * @param externalId - External ID from provider
+     * @returns Matching property or null
+     */
+    findByExternalId(externalId: string): Promise<AnalyticsProperty | null>;
+    /**
+     * Find property by measurement ID (GA4)
+     *
+     * @param measurementId - GA4 measurement ID (G-XXXXXXXXXX)
+     * @returns Matching property or null
+     */
+    findByMeasurementId(measurementId: string): Promise<AnalyticsProperty | null>;
+    /**
+     * Find property by site domain and optional provider.
+     *
+     * @param siteDomain - Provider site domain
+     * @param provider - Optional provider discriminator for migration/coexistence
+     * @returns Matching property or null
+     */
+    findBySiteDomain(siteDomain: string, provider?: AnalyticsProvider): Promise<AnalyticsProperty | null>;
+    /**
+     * Find properties by provider
+     *
+     * @param provider - Analytics provider
+     * @returns Array of matching properties
+     */
+    findByProvider(provider: AnalyticsProvider): Promise<AnalyticsProperty[]>;
+    /**
+     * Find all GA4 properties
+     */
+    findGA4Properties(): Promise<AnalyticsProperty[]>;
+    /**
+     * Find all Plausible sites
+     */
+    findPlausibleSites(): Promise<AnalyticsProperty[]>;
+    /**
+     * Find all Matomo sites
+     */
+    findMatomoSites(): Promise<AnalyticsProperty[]>;
+    /**
+     * Find properties by status
+     *
+     * @param status - Property status
+     * @returns Array of matching properties
+     */
+    findByStatus(status: AnalyticsPropertyStatus): Promise<AnalyticsProperty[]>;
+    /**
+     * Find all active properties
+     */
+    findActive(): Promise<AnalyticsProperty[]>;
+    /**
+     * Find properties that need syncing (not synced in last N hours)
+     *
+     * @param hoursAgo - Hours since last sync
+     * @returns Array of properties needing sync
+     */
+    findNeedingSync(hoursAgo?: number): Promise<AnalyticsProperty[]>;
+}
+//# sourceMappingURL=AnalyticsPropertyCollection.d.ts.map

package/dist/collections/AnalyticsPropertyCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPropertyCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AnalyticsPropertyCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;IAE/C;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;;;OAKG;IACG,mBAAmB,CACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;;;;OAMG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;;;OAKG;IACG,cAAc,CAClB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAO/B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIvD;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrD;;;;;OAKG;IACG,YAAY,CAChB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAO/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIhD;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAQ3E"}

package/dist/collections/AnalyticsReportCollection.d.ts

@@ -0,0 +1,69 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { AnalyticsReport } from '../models/AnalyticsReport.js';
+import { ReportFrequency, ReportStatus } from '../types/index.js';
+export declare class AnalyticsReportCollection extends SmrtCollection<AnalyticsReport> {
+    static readonly _itemClass: typeof AnalyticsReport;
+    /**
+     * Find reports by property
+     *
+     * @param propertyId - Parent property ID
+     * @returns Array of reports
+     */
+    findByProperty(propertyId: string): Promise<AnalyticsReport[]>;
+    /**
+     * Find reports by status
+     *
+     * @param status - Report status
+     * @returns Array of matching reports
+     */
+    findByStatus(status: ReportStatus): Promise<AnalyticsReport[]>;
+    /**
+     * Find all draft reports
+     */
+    findDrafts(): Promise<AnalyticsReport[]>;
+    /**
+     * Find all scheduled reports
+     */
+    findScheduled(): Promise<AnalyticsReport[]>;
+    /**
+     * Find all completed reports
+     */
+    findCompleted(): Promise<AnalyticsReport[]>;
+    /**
+     * Find all failed reports
+     */
+    findFailed(): Promise<AnalyticsReport[]>;
+    /**
+     * Find reports by frequency
+     *
+     * @param frequency - Report frequency
+     * @returns Array of matching reports
+     */
+    findByFrequency(frequency: ReportFrequency): Promise<AnalyticsReport[]>;
+    /**
+     * Find all recurring reports (not one-time)
+     */
+    findRecurring(): Promise<AnalyticsReport[]>;
+    /**
+     * Find reports due to run
+     *
+     * @returns Array of reports that are due
+     */
+    findDue(): Promise<AnalyticsReport[]>;
+    /**
+     * Find reports for a property by status
+     *
+     * @param propertyId - Parent property ID
+     * @param status - Report status
+     * @returns Array of matching reports
+     */
+    findByPropertyAndStatus(propertyId: string, status: ReportStatus): Promise<AnalyticsReport[]>;
+    /**
+     * Find recently run reports
+     *
+     * @param hoursAgo - Hours since last run
+     * @returns Array of recently run reports
+     */
+    findRecentlyRun(hoursAgo?: number): Promise<AnalyticsReport[]>;
+}
+//# sourceMappingURL=AnalyticsReportCollection.d.ts.map

package/dist/collections/AnalyticsReportCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsReportCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AnalyticsReportCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;IAE7C;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOpE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;;;;OAKG;IACG,eAAe,CACnB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKjD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAO3C;;;;;;OAMG;IACG,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAOzE"}

package/dist/collections/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Collection exports for smrt-analytics
+ */
+export { AnalyticsDataStreamCollection } from './AnalyticsDataStreamCollection.js';
+export { AnalyticsEventCollection } from './AnalyticsEventCollection.js';
+export { AnalyticsPropertyCollection } from './AnalyticsPropertyCollection.js';
+export { AnalyticsReportCollection } from './AnalyticsReportCollection.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { AnalyticsDataStreamCollection, AnalyticsEventCollection, AnalyticsPropertyCollection, AnalyticsReportCollection, } from './collections/index.js';
+export { AnalyticsDataStream, AnalyticsEvent, AnalyticsProperty, AnalyticsReport, } from './models/index.js';
+export { promptMessageOptions, smrtAnalyticsAnalyzePerformancePrompt, smrtAnalyticsAnalyzeResultsPrompt, smrtAnalyticsHasPositiveTrendsPrompt, } from './prompts.js';
+export type { AnalyticsCapabilities, AnalyticsInterface, PropertyStatsWithTrend, SDKCustomDimension, SDKCustomMetric, SDKDataStream, SDKKeyEvent, SDKPageviewEvent, SDKProperty, SDKReportOptions, SDKReportResult, SDKTrackEvent, } from './types/index.js';
+export { AnalyticsPropertyStatus, AnalyticsProvider, CountingMethod, CustomDimensionScope, DataStreamStatus, DataStreamType, ReportFrequency, ReportStatus, TrackingEventStatus, } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,wBAAwB,CAAC;AAGhC,OAAO,cAAc,CAAC;AAGtB,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}