@happyvertical/analytics 0.74.8

package/dist/shared/providers/matomo.d.ts

@@ -0,0 +1,49 @@
+import { AnalyticsCapabilities, AnalyticsInterface, ConfigOptions, CreateDataStreamOptions, CreatePropertyOptions, CustomDimension, CustomDimensionOptions, CustomMetric, CustomMetricOptions, DataStream, DimensionMetadata, KeyEvent, KeyEventOptions, ListPropertiesOptions, MatomoOptions, MetricMetadata, PageviewEvent, Property, RealtimeReportOptions, ReportOptions, ReportResult, SnippetOptions, TrackEvent, TrackingSnippet, UpdatePropertyOptions } from '../types.js';
+import { MatomoAdmin } from './matomo-admin.js';
+export declare class MatomoProvider implements AnalyticsInterface {
+    private readonly baseUrl;
+    private readonly reportingTransport;
+    readonly admin: MatomoAdmin;
+    constructor(options: MatomoOptions);
+    createProperty(_options: CreatePropertyOptions): Promise<Property>;
+    listProperties(_options?: ListPropertiesOptions): Promise<Property[]>;
+    getProperty(propertyId: string): Promise<Property>;
+    updateProperty(_propertyId: string, _data: UpdatePropertyOptions): Promise<Property>;
+    deleteProperty(propertyId: string): Promise<void>;
+    getCapabilities(): Promise<AnalyticsCapabilities>;
+    /**
+     * Generate a Matomo `_paq` tracking snippet.
+     *
+     * Note on `SnippetOptions.anonymizeIp`: Matomo handles IP anonymization
+     * **server-side** via the PrivacyManager plugin (Matomo admin → Privacy →
+     * Anonymize visitors' IP addresses). The JS tracker has no equivalent
+     * client-side directive — `setDoNotTrack` respects the browser's DNT
+     * signal but does not anonymize IPs, so we deliberately do not emit it
+     * here. The flag is preserved on the returned `config` object as a
+     * caller-visible signal, but its enforcement is the operator's
+     * responsibility on the Matomo install.
+     */
+    generateTrackingSnippet(propertyId: string, options?: SnippetOptions): TrackingSnippet;
+    generateConfig(propertyId: string, options?: ConfigOptions): Record<string, unknown>;
+    getDataStreams(_propertyId: string): Promise<DataStream[]>;
+    createDataStream(_propertyId: string, _options: CreateDataStreamOptions): Promise<DataStream>;
+    deleteDataStream(_propertyId: string, _streamId: string): Promise<void>;
+    getCustomDimensions(_propertyId: string): Promise<CustomDimension[]>;
+    createCustomDimension(_propertyId: string, _options: CustomDimensionOptions): Promise<CustomDimension>;
+    archiveCustomDimension(_propertyId: string, _dimensionId: string): Promise<void>;
+    getCustomMetrics(_propertyId: string): Promise<CustomMetric[]>;
+    createCustomMetric(_propertyId: string, _options: CustomMetricOptions): Promise<CustomMetric>;
+    archiveCustomMetric(_propertyId: string, _metricId: string): Promise<void>;
+    getKeyEvents(_propertyId: string): Promise<KeyEvent[]>;
+    createKeyEvent(_propertyId: string, _options: KeyEventOptions): Promise<KeyEvent>;
+    deleteKeyEvent(_propertyId: string, _eventId: string): Promise<void>;
+    runReport(propertyId: string, options: ReportOptions): Promise<ReportResult>;
+    runRealtimeReport(propertyId: string, options?: RealtimeReportOptions): Promise<ReportResult>;
+    getMetrics(_propertyId: string): Promise<MetricMetadata[]>;
+    getDimensions(_propertyId: string): Promise<DimensionMetadata[]>;
+    track(_event: TrackEvent): Promise<void>;
+    trackPageview(_pageview: PageviewEvent): Promise<void>;
+    trackBatch(_events: TrackEvent[]): Promise<void>;
+    identify(_userId: string, _traits?: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=matomo.d.ts.map

package/dist/shared/providers/matomo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matomo.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/matomo.ts"],"names":[],"mappings":"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"}

package/dist/shared/providers/plausible.d.ts

@@ -0,0 +1,50 @@
+import { AnalyticsCapabilities, AnalyticsInterface, ConfigOptions, CreateDataStreamOptions, CreatePropertyOptions, CustomDimension, CustomDimensionOptions, CustomMetric, CustomMetricOptions, DataStream, DimensionMetadata, KeyEvent, KeyEventOptions, ListPropertiesOptions, MetricMetadata, PageviewEvent, PlausibleOptions, Property, RealtimeReportOptions, ReportOptions, ReportResult, SnippetOptions, TrackEvent, TrackingSnippet, UpdatePropertyOptions } from '../types.js';
+/**
+ * Plausible Analytics provider
+ */
+export declare class PlausibleProvider implements AnalyticsInterface {
+    private options;
+    private baseUrl;
+    constructor(options: PlausibleOptions);
+    /**
+     * Make an authenticated API request
+     */
+    private request;
+    createProperty(options: CreatePropertyOptions): Promise<Property>;
+    listProperties(_options?: ListPropertiesOptions): Promise<Property[]>;
+    getProperty(propertyId: string): Promise<Property>;
+    updateProperty(_propertyId: string, _data: UpdatePropertyOptions): Promise<Property>;
+    deleteProperty(propertyId: string): Promise<void>;
+    getDataStreams(_propertyId: string): Promise<DataStream[]>;
+    createDataStream(_propertyId: string, _options: CreateDataStreamOptions): Promise<DataStream>;
+    deleteDataStream(_propertyId: string, _streamId: string): Promise<void>;
+    getCustomDimensions(_propertyId: string): Promise<CustomDimension[]>;
+    createCustomDimension(_propertyId: string, _options: CustomDimensionOptions): Promise<CustomDimension>;
+    archiveCustomDimension(_propertyId: string, _dimensionId: string): Promise<void>;
+    getCustomMetrics(_propertyId: string): Promise<CustomMetric[]>;
+    createCustomMetric(_propertyId: string, _options: CustomMetricOptions): Promise<CustomMetric>;
+    archiveCustomMetric(_propertyId: string, _metricId: string): Promise<void>;
+    getKeyEvents(_propertyId: string): Promise<KeyEvent[]>;
+    createKeyEvent(propertyId: string, options: KeyEventOptions): Promise<KeyEvent>;
+    deleteKeyEvent(propertyId: string, eventId: string): Promise<void>;
+    runReport(propertyId: string, options: ReportOptions): Promise<ReportResult>;
+    runRealtimeReport(propertyId: string, _options?: RealtimeReportOptions): Promise<ReportResult>;
+    getMetrics(_propertyId: string): Promise<MetricMetadata[]>;
+    getDimensions(_propertyId: string): Promise<DimensionMetadata[]>;
+    /**
+     * Map GA4-style metric names to Plausible format
+     */
+    private mapMetricName;
+    /**
+     * Map GA4-style dimension names to Plausible format
+     */
+    private mapDimensionName;
+    track(event: TrackEvent): Promise<void>;
+    trackPageview(pageview: PageviewEvent): Promise<void>;
+    trackBatch(events: TrackEvent[]): Promise<void>;
+    identify(_userId: string, _traits?: Record<string, unknown>): Promise<void>;
+    generateTrackingSnippet(propertyId: string, _options?: SnippetOptions): TrackingSnippet;
+    generateConfig(propertyId: string, _options?: ConfigOptions): Record<string, unknown>;
+    getCapabilities(): Promise<AnalyticsCapabilities>;
+}
+//# sourceMappingURL=plausible.d.ts.map

package/dist/shared/providers/plausible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plausible.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/plausible.ts"],"names":[],"mappings":"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"}