@happyvertical/smrt-analytics 0.51.31 → 0.51.33

package/README.md

@@ -73,6 +73,23 @@ const insights = await report.analyzeResults();
 const trending = await report.hasPositiveTrends();
 ```
 
+`hasPositiveTrends()` keeps that boolean API. When `decisions: { type:
+'typesafe' }` is configured and no AI tools are registered, it sends the
+resolved report prompt plus only the selected metrics and persisted aggregate
+rows to the typed-decision route. Its threshold defaults to `0.5`; a configured
+uncertainty band uses the same resolved prompt on the generative route, matching
+the framework's decision fallback behavior. The route treats higher
+user-growth, engagement, and conversion values as favorable, and higher bounce
+or error rates as adverse. Unknown metric directions, incomplete comparison
+periods, and insufficient or ambiguous data are not inferred as positive.
+Configured decision failures propagate. Without a decision provider, the
+existing prompt-driven `yes`/`no` behavior remains in use. `resultData` retains
+the documented caller-managed PII limitation in either route.
+
+The framework website's analytics guide should add a worked decision-provider
+configuration example; this package README documents the runtime contract until
+that guide is updated.
+
 ### Server-Side Event Lifecycle
 
 Events track their delivery status with built-in retry support:

package/dist/__tests__/helpers/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Test helper utilities
+ * @packageDocumentation
+ */
+export * from './test-db.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC"}

package/dist/__tests__/helpers/test-db.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Test database utilities for multi-adapter testing
+ * @packageDocumentation
+ */
+import { type DatabaseInterface } from '@happyvertical/sql';
+export type TestAdapter = 'sqlite' | 'postgres' | 'json';
+export interface TestDbConfig {
+    type: 'sqlite' | 'postgres' | 'json';
+    url: string;
+    writeStrategy?: 'immediate';
+}
+/**
+ * Get the current test adapter from environment
+ */
+export declare function getTestAdapter(): TestAdapter;
+/**
+ * Get database configuration for the current test adapter
+ */
+export declare function getTestDbConfig(): TestDbConfig;
+/**
+ * Create a database instance for the current test adapter
+ */
+export declare function createTestDb(): Promise<{
+    db: DatabaseInterface;
+    config: TestDbConfig;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Deterministic UUID for a readable fixture label. Property ids are native
+ * UUID columns on PostgreSQL, so a literal such as `'prop-123'` is rejected
+ * there (22P02) while SQLite's text ids accept it; routing every fixture id
+ * through this keeps the same readable label valid on all three adapters.
+ */
+export declare function fixtureId(label: string): string;
+/** Seed explicit real parents for collection fixtures that exercise child rows. */
+export declare function seedAnalyticsProperties(db: DatabaseInterface, ids: readonly string[]): Promise<void>;
+/**
+ * Check if PostgreSQL is available (cached)
+ */
+export declare function isPostgresAvailable(): Promise<boolean>;
+/**
+ * Get display name for current adapter (for test descriptions)
+ */
+export declare function getAdapterDisplayName(): string;
+/**
+ * Check if current test run is for a specific adapter
+ */
+export declare function isAdapter(adapter: TestAdapter): boolean;
+//# sourceMappingURL=test-db.d.ts.map

package/dist/__tests__/helpers/test-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-db.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/test-db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,KAAK,iBAAiB,EAAe,MAAM,oBAAoB,CAAC;AAGzE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CA8B9C;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC,CAqFD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED,mFAAmF;AACnF,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,iBAAiB,EACrB,GAAG,EAAE,SAAS,MAAM,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf;AAKD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAsB5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEvD"}

package/dist/collections/AnalyticsDataStreamCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * AnalyticsDataStreamCollection - Collection manager for AnalyticsDataStream objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { AnalyticsDataStream } from '../models/AnalyticsDataStream.js';
 import { DataStreamStatus, DataStreamType } from '../types/index.js';

package/dist/collections/AnalyticsEventCollection.d.ts

@@ -1,6 +1,10 @@
+/**
+ * AnalyticsEventCollection - Collection manager for AnalyticsEvent objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { AnalyticsEvent } from '../models/AnalyticsEvent.js';
-import { PropertyStatsWithTrend, TrackingEventStatus } from '../types/index.js';
+import { type PropertyStatsWithTrend, TrackingEventStatus } from '../types/index.js';
 export declare class AnalyticsEventCollection extends SmrtCollection<AnalyticsEvent> {
     static readonly _itemClass: typeof AnalyticsEvent;
     /**

package/dist/collections/AnalyticsPropertyCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * AnalyticsPropertyCollection - Collection manager for AnalyticsProperty objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { AnalyticsProperty } from '../models/AnalyticsProperty.js';
 import { AnalyticsPropertyStatus, AnalyticsProvider } from '../types/index.js';

package/dist/collections/AnalyticsReportCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * AnalyticsReportCollection - Collection manager for AnalyticsReport objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { AnalyticsReport } from '../models/AnalyticsReport.js';
 import { ReportFrequency, ReportStatus } from '../types/index.js';

package/dist/index.d.ts

@@ -1,3 +1,14 @@
+/**
+ * @happyvertical/smrt-analytics
+ *
+ * Analytics integration models for SMRT framework.
+ * Provides SMRT-wrapped models for managing analytics properties, data streams,
+ * reports, and event tracking with integration to @happyvertical/analytics SDK.
+ *
+ * @packageDocumentation
+ */
+import './__smrt-register__.js';
+import './prompts.js';
 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';