@equinor/fusion-framework-module-analytics 3.0.5 → 3.1.0-next.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +68 -0
- package/README.md +22 -214
- package/dist/esm/__tests__/MockAnalyticsAdapter.test.js +91 -0
- package/dist/esm/__tests__/MockAnalyticsAdapter.test.js.map +1 -0
- package/dist/esm/__tests__/mock/analytics-mock-adapter.test.js +60 -0
- package/dist/esm/__tests__/mock/analytics-mock-adapter.test.js.map +1 -0
- package/dist/esm/mock/MockAnalyticsAdapter.js +134 -0
- package/dist/esm/mock/MockAnalyticsAdapter.js.map +1 -0
- package/dist/esm/mock/index.js +26 -0
- package/dist/esm/mock/index.js.map +1 -0
- package/dist/esm/version.js +1 -1
- package/dist/esm/version.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/dist/types/__tests__/MockAnalyticsAdapter.test.d.ts +1 -0
- package/dist/types/__tests__/mock/analytics-mock-adapter.test.d.ts +1 -0
- package/dist/types/mock/MockAnalyticsAdapter.d.ts +76 -0
- package/dist/types/mock/index.d.ts +25 -0
- package/dist/types/version.d.ts +1 -1
- package/docs/adapters.md +79 -0
- package/docs/collectors.md +91 -0
- package/docs/testing.md +87 -0
- package/docs/tracking-events.md +16 -0
- package/package.json +13 -9
- package/src/__tests__/MockAnalyticsAdapter.test.ts +127 -0
- package/src/__tests__/mock/analytics-mock-adapter.test.ts +79 -0
- package/src/mock/MockAnalyticsAdapter.ts +178 -0
- package/src/mock/index.ts +29 -0
- package/src/version.ts +1 -1
- package/vitest.config.ts +11 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,73 @@
|
|
|
1
1
|
# @equinor/fusion-framework-module-analytics
|
|
2
2
|
|
|
3
|
+
## 3.1.0-next.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 2836e0b: Add `MockAnalyticsAdapter` and `./mock` subpath for asserting on tracked analytics events in tests.
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import { enableAnalytics } from "@equinor/fusion-framework-module-analytics";
|
|
11
|
+
import { MockAnalyticsAdapter } from "@equinor/fusion-framework-module-analytics/mock";
|
|
12
|
+
|
|
13
|
+
const recorder = new MockAnalyticsAdapter();
|
|
14
|
+
|
|
15
|
+
enableAnalytics(configurator, (builder) => {
|
|
16
|
+
builder.setAdapter("mock", async () => recorder);
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
// ... exercise the app under test, then assert:
|
|
20
|
+
const event = await recorder.waitForAnalytic("button-click");
|
|
21
|
+
expect(event.attributes?.section).toBe("header");
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### `getAnalytics(matcher?)`
|
|
25
|
+
|
|
26
|
+
Returns recorded events synchronously, filtered by an event name, an array of names, or a predicate. Omit the matcher to get every recorded event.
|
|
27
|
+
|
|
28
|
+
### `waitForAnalytic(matcher, options?)`
|
|
29
|
+
|
|
30
|
+
Resolves with the first matching event, resolving immediately if one was already recorded, or waiting for a future one. Supports an optional `timeout` (ms) and `AbortSignal` so a test cannot hang indefinitely, and rejects if the adapter is disposed before a match occurs.
|
|
31
|
+
|
|
32
|
+
### Patch Changes
|
|
33
|
+
|
|
34
|
+
- e8aae1f: Internal: publish every package on the `next` pre-release tag so the whole framework can be installed as a coherent set.
|
|
35
|
+
|
|
36
|
+
Packages without their own changes are bumped only to receive a `-next.N` version and the `next` dist-tag on npm. Install with:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
pnpm add @equinor/fusion-framework-react-app@next
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
- Updated dependencies [e8aae1f]
|
|
43
|
+
- Updated dependencies [2836e0b]
|
|
44
|
+
- Updated dependencies [2836e0b]
|
|
45
|
+
- Updated dependencies [2836e0b]
|
|
46
|
+
- Updated dependencies [2836e0b]
|
|
47
|
+
- Updated dependencies [2836e0b]
|
|
48
|
+
- Updated dependencies [2836e0b]
|
|
49
|
+
- Updated dependencies [2836e0b]
|
|
50
|
+
- Updated dependencies [2836e0b]
|
|
51
|
+
- Updated dependencies [2836e0b]
|
|
52
|
+
- Updated dependencies [2836e0b]
|
|
53
|
+
- Updated dependencies [2836e0b]
|
|
54
|
+
- Updated dependencies [2836e0b]
|
|
55
|
+
- Updated dependencies [2836e0b]
|
|
56
|
+
- Updated dependencies [2836e0b]
|
|
57
|
+
- @equinor/fusion-framework-module@6.1.3-next.0
|
|
58
|
+
- @equinor/fusion-framework-module-app@8.1.0-next.0
|
|
59
|
+
- @equinor/fusion-framework-module-context@9.0.0-next.0
|
|
60
|
+
- @equinor/fusion-framework-module-event@6.1.0-next.0
|
|
61
|
+
- @equinor/fusion-framework-module-http@8.1.0-next.0
|
|
62
|
+
- @equinor/fusion-observable@9.1.2-next.0
|
|
63
|
+
|
|
64
|
+
## 3.0.6
|
|
65
|
+
|
|
66
|
+
### Patch Changes
|
|
67
|
+
|
|
68
|
+
- Updated dependencies [73bfe52]
|
|
69
|
+
- @equinor/fusion-framework-module-context@8.0.3
|
|
70
|
+
|
|
3
71
|
## 3.0.5
|
|
4
72
|
|
|
5
73
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -3,6 +3,15 @@
|
|
|
3
3
|
Fusion Framework module for collecting and exporting application analytics using
|
|
4
4
|
OpenTelemetry standards.
|
|
5
5
|
|
|
6
|
+
## Who should use this
|
|
7
|
+
|
|
8
|
+
- **Application and portal developers** who want to track user interactions
|
|
9
|
+
(clicks, context changes, app usage) without wiring up telemetry by hand.
|
|
10
|
+
- **Module authors** who want their module's lifecycle events picked up by
|
|
11
|
+
analytics automatically via a collector.
|
|
12
|
+
- **Test authors** who need to assert which analytics events an app or
|
|
13
|
+
collector produced.
|
|
14
|
+
|
|
6
15
|
## Overview
|
|
7
16
|
|
|
8
17
|
The analytics module provides a pluggable **adapter/collector** architecture:
|
|
@@ -22,6 +31,16 @@ When a collector emits an event it is delivered to **every** registered adapter.
|
|
|
22
31
|
| `@equinor/fusion-framework-module-analytics/adapters` | `ConsoleAnalyticsAdapter`, `FusionAnalyticsAdapter`, `IAnalyticsAdapter` |
|
|
23
32
|
| `@equinor/fusion-framework-module-analytics/collectors` | `ContextSelectedCollector`, `AppSelectedCollector`, `AppLoadedCollector`, `IAnalyticsCollector` |
|
|
24
33
|
| `@equinor/fusion-framework-module-analytics/logExporters` | `OTLPLogExporter`, `FusionOTLPLogExporter` |
|
|
34
|
+
| `@equinor/fusion-framework-module-analytics/mock` | `MockAnalyticsAdapter` — record tracked events for test assertions |
|
|
35
|
+
|
|
36
|
+
## Documentation
|
|
37
|
+
|
|
38
|
+
| Topic | Description |
|
|
39
|
+
|---|---|
|
|
40
|
+
| [Adapters](docs/adapters.md) | `ConsoleAnalyticsAdapter`, `FusionAnalyticsAdapter`, and creating a custom `IAnalyticsAdapter` |
|
|
41
|
+
| [Collectors](docs/collectors.md) | Built-in collectors (context/app selection, app loaded) and creating a custom `IAnalyticsCollector` |
|
|
42
|
+
| [Tracking Events Manually](docs/tracking-events.md) | `provider.trackAnalytic` / `trackAnalytic$` for ad-hoc event tracking |
|
|
43
|
+
| [Testing](docs/testing.md) | `MockAnalyticsAdapter`, recording and awaiting tracked events, and using a bespoke `ModulesConfigurator` in tests |
|
|
25
44
|
|
|
26
45
|
## Quick Start
|
|
27
46
|
|
|
@@ -52,217 +71,6 @@ const configure = (configurator) => {
|
|
|
52
71
|
> Fusion Framework module system. Manual initialisation is only required when
|
|
53
72
|
> accessing the provider directly.
|
|
54
73
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
sending analytics data to their destinations. All adapters support async
|
|
59
|
-
initialisation and will be initialised automatically when the provider starts.
|
|
60
|
-
|
|
61
|
-
### ConsoleAnalyticsAdapter
|
|
62
|
-
|
|
63
|
-
Logs every analytics event to the browser console. Useful for development and
|
|
64
|
-
debugging. No configuration required.
|
|
65
|
-
|
|
66
|
-
```typescript
|
|
67
|
-
builder.setAdapter('console', async () => new ConsoleAnalyticsAdapter());
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
### FusionAnalyticsAdapter
|
|
71
|
-
|
|
72
|
-
Forwards analytics events to an OpenTelemetry-compatible log endpoint via a
|
|
73
|
-
bundled `LoggerProvider`.
|
|
74
|
-
|
|
75
|
-
Configuration options:
|
|
76
|
-
|
|
77
|
-
| Option | Type | Description |
|
|
78
|
-
|---|---|---|
|
|
79
|
-
| `portalId` | `string` | Portal identifier included in every log record |
|
|
80
|
-
| `logExporter` | `OTLPExporterBase` | OTLP log exporter for transport |
|
|
81
|
-
|
|
82
|
-
#### Using `OTLPLogExporter` (direct HTTP)
|
|
83
|
-
|
|
84
|
-
```typescript
|
|
85
|
-
import { OTLPLogExporter } from '@equinor/fusion-framework-module-analytics/logExporters';
|
|
86
|
-
import { FusionAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/adapters';
|
|
87
|
-
|
|
88
|
-
builder.setAdapter('fusion-log', async () => {
|
|
89
|
-
const logExporter = new OTLPLogExporter({
|
|
90
|
-
url: 'https://example.com/v1/logs',
|
|
91
|
-
headers: { 'Content-Type': 'application/json' },
|
|
92
|
-
});
|
|
93
|
-
return new FusionAnalyticsAdapter({ portalId: 'my-portal', logExporter });
|
|
94
|
-
});
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
#### Using `FusionOTLPLogExporter` (service discovery HTTP client)
|
|
98
|
-
|
|
99
|
-
```typescript
|
|
100
|
-
import { FusionOTLPLogExporter } from '@equinor/fusion-framework-module-analytics/logExporters';
|
|
101
|
-
import { FusionAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/adapters';
|
|
102
|
-
|
|
103
|
-
builder.setAdapter('fusion', async (args) => {
|
|
104
|
-
if (args.hasModule('serviceDiscovery')) {
|
|
105
|
-
const sd = await args.requireInstance('serviceDiscovery');
|
|
106
|
-
const httpClient = await sd.createClient('analytics');
|
|
107
|
-
const logExporter = new FusionOTLPLogExporter(httpClient);
|
|
108
|
-
return new FusionAnalyticsAdapter({ portalId: 'my-portal', logExporter });
|
|
109
|
-
}
|
|
110
|
-
console.error('Service discovery unavailable — analytics adapter not created');
|
|
111
|
-
});
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### Creating a Custom Adapter
|
|
115
|
-
|
|
116
|
-
Implement `IAnalyticsAdapter` and register it with `setAdapter`:
|
|
117
|
-
|
|
118
|
-
```typescript
|
|
119
|
-
import type { IAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/adapters';
|
|
120
|
-
import type { AnalyticsEvent } from '@equinor/fusion-framework-module-analytics';
|
|
121
|
-
|
|
122
|
-
class MyRemoteAdapter implements IAnalyticsAdapter {
|
|
123
|
-
registerAnalytic(event: AnalyticsEvent): void {
|
|
124
|
-
navigator.sendBeacon('/analytics', JSON.stringify(event));
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
[Symbol.dispose](): void {
|
|
128
|
-
// cleanup if needed
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
builder.setAdapter('remote', async () => new MyRemoteAdapter());
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
## Collectors
|
|
136
|
-
|
|
137
|
-
Collectors implement `IAnalyticsCollector` (or extend `BaseCollector`) and emit
|
|
138
|
-
`AnalyticsEvent` objects that are forwarded to all adapters. All collectors
|
|
139
|
-
support async initialisation.
|
|
140
|
-
|
|
141
|
-
### ContextSelectedCollector
|
|
142
|
-
|
|
143
|
-
Emits an event when the active Fusion context changes. Includes the new context,
|
|
144
|
-
the previous context, and the current app key in attributes.
|
|
145
|
-
|
|
146
|
-
```typescript
|
|
147
|
-
builder.setCollector('context-selected', async (args) => {
|
|
148
|
-
const ctx = await args.requireInstance('context');
|
|
149
|
-
const app = await args.requireInstance('app');
|
|
150
|
-
return new ContextSelectedCollector(ctx, app);
|
|
151
|
-
});
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
### AppSelectedCollector
|
|
155
|
-
|
|
156
|
-
Emits an event when the active application changes. Includes the new and
|
|
157
|
-
previous app key metadata.
|
|
158
|
-
|
|
159
|
-
```typescript
|
|
160
|
-
builder.setCollector('app-selected', async (args) => {
|
|
161
|
-
const app = await args.requireInstance('app');
|
|
162
|
-
return new AppSelectedCollector(app);
|
|
163
|
-
});
|
|
164
|
-
```
|
|
165
|
-
|
|
166
|
-
### AppLoadedCollector
|
|
167
|
-
|
|
168
|
-
Emits an event when an application's modules finish loading. Includes app
|
|
169
|
-
manifest metadata and the current context (if available).
|
|
170
|
-
|
|
171
|
-
```typescript
|
|
172
|
-
builder.setCollector('app-loaded', async (args) => {
|
|
173
|
-
const event = await args.requireInstance('event');
|
|
174
|
-
const app = await args.requireInstance('app');
|
|
175
|
-
return new AppLoadedCollector(event, app);
|
|
176
|
-
});
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
### Creating a Custom Collector
|
|
180
|
-
|
|
181
|
-
Extend `BaseCollector` with a Zod schema for validation:
|
|
182
|
-
|
|
183
|
-
```typescript
|
|
184
|
-
import { BaseCollector, createSchema } from '@equinor/fusion-framework-module-analytics/collectors';
|
|
185
|
-
import { z } from 'zod';
|
|
186
|
-
import { of } from 'rxjs';
|
|
187
|
-
|
|
188
|
-
const schema = createSchema(z.string(), z.object({ page: z.string() }));
|
|
189
|
-
|
|
190
|
-
class PageViewCollector extends BaseCollector<string, { page: string }> {
|
|
191
|
-
constructor() {
|
|
192
|
-
super('page-view', schema);
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
_initialize() {
|
|
196
|
-
return of({ value: window.location.pathname, attributes: { page: document.title } });
|
|
197
|
-
}
|
|
198
|
-
}
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
## Tracking Events Manually
|
|
202
|
-
|
|
203
|
-
The provider exposes methods for ad-hoc event tracking outside of collectors:
|
|
204
|
-
|
|
205
|
-
```typescript
|
|
206
|
-
// Single event
|
|
207
|
-
provider.trackAnalytic({
|
|
208
|
-
name: 'button-click',
|
|
209
|
-
value: 'save',
|
|
210
|
-
attributes: { section: 'toolbar' },
|
|
211
|
-
});
|
|
212
|
-
|
|
213
|
-
// Observable stream
|
|
214
|
-
const subscription = provider.trackAnalytic$(myEvent$);
|
|
215
|
-
// later: subscription.unsubscribe();
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
#### Configuration
|
|
219
|
-
|
|
220
|
-
The Context Selected Collector needs the context provider.
|
|
221
|
-
|
|
222
|
-
##### Example configuration
|
|
223
|
-
|
|
224
|
-
```typescript
|
|
225
|
-
import { enableAnalytics } from '@equinor/fusion-framework-module-analytics';
|
|
226
|
-
import { ContextSelectedCollector } from '@equinor/fusion-framework-module-analytics/collectors';
|
|
227
|
-
|
|
228
|
-
const configure = (configurator: IModulesConfigurator<any, any>) => {
|
|
229
|
-
enableAnalytics(configurator, (builder) => {
|
|
230
|
-
builder.setCollector('context-selected', async (args) => {
|
|
231
|
-
const contextProvider = await args.requireInstance('context');
|
|
232
|
-
const appProvider = await args.requireInstance('app');
|
|
233
|
-
return new ContextSelectedCollector(contextProvider, appProvider);
|
|
234
|
-
});
|
|
235
|
-
});
|
|
236
|
-
}
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
### Creating Custom Collectors
|
|
240
|
-
|
|
241
|
-
You can create custom analytics collector by extending the `BaseCollector` class,
|
|
242
|
-
or implement the `IAnalyticsCollector` interface and add it in configuration.
|
|
243
|
-
|
|
244
|
-
#### Example Custom Collector
|
|
245
|
-
|
|
246
|
-
```typescript
|
|
247
|
-
import { type AnalyticsEvent, enableAnalytics } from '@equinor/fusion-framework-module-analytics';
|
|
248
|
-
|
|
249
|
-
const configure = (configurator: IModulesConfigurator<any, any>) => {
|
|
250
|
-
enableAnalytics(configurator, (builder) => {
|
|
251
|
-
builder.setCollector('click-test', async () => {
|
|
252
|
-
const subject = new Subject<AnalyticsEvent>();
|
|
253
|
-
window.addEventListener('click', (e) => {
|
|
254
|
-
subject.next({
|
|
255
|
-
name: 'window-clicker',
|
|
256
|
-
value: 42,
|
|
257
|
-
});
|
|
258
|
-
});
|
|
259
|
-
|
|
260
|
-
return {
|
|
261
|
-
subscribe: (subscriber) => {
|
|
262
|
-
return subject.subscribe(subscriber);
|
|
263
|
-
},
|
|
264
|
-
};
|
|
265
|
-
});
|
|
266
|
-
});
|
|
267
|
-
}
|
|
268
|
-
```
|
|
74
|
+
See [Adapters](docs/adapters.md), [Collectors](docs/collectors.md), and
|
|
75
|
+
[Tracking Events Manually](docs/tracking-events.md) for the full adapter/collector
|
|
76
|
+
reference and how to build your own.
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import { describe, it, expect, vi, afterEach } from 'vitest';
|
|
2
|
+
import { MockAnalyticsAdapter } from '../mock/MockAnalyticsAdapter.js';
|
|
3
|
+
const createEvent = (name, overrides = {}) => ({
|
|
4
|
+
name,
|
|
5
|
+
value: null,
|
|
6
|
+
...overrides,
|
|
7
|
+
});
|
|
8
|
+
describe('MockAnalyticsAdapter', () => {
|
|
9
|
+
afterEach(() => {
|
|
10
|
+
vi.useRealTimers();
|
|
11
|
+
});
|
|
12
|
+
it('records events via registerAnalytic and returns them from getAnalytics', () => {
|
|
13
|
+
const adapter = new MockAnalyticsAdapter();
|
|
14
|
+
adapter.registerAnalytic(createEvent('button-click'));
|
|
15
|
+
adapter.registerAnalytic(createEvent('page-view'));
|
|
16
|
+
expect(adapter.getAnalytics().map((e) => e.name)).toEqual(['button-click', 'page-view']);
|
|
17
|
+
});
|
|
18
|
+
it('filters getAnalytics by a single name, an array, and a predicate', () => {
|
|
19
|
+
const adapter = new MockAnalyticsAdapter();
|
|
20
|
+
adapter.registerAnalytic(createEvent('button-click', { attributes: { section: 'header' } }));
|
|
21
|
+
adapter.registerAnalytic(createEvent('page-view'));
|
|
22
|
+
expect(adapter.getAnalytics('button-click')).toHaveLength(1);
|
|
23
|
+
expect(adapter.getAnalytics(['button-click', 'page-view'])).toHaveLength(2);
|
|
24
|
+
expect(adapter.getAnalytics((e) => e.attributes?.section === 'header')).toHaveLength(1);
|
|
25
|
+
});
|
|
26
|
+
it('resolves waitForAnalytic immediately when a matching event is already recorded', async () => {
|
|
27
|
+
const adapter = new MockAnalyticsAdapter();
|
|
28
|
+
adapter.registerAnalytic(createEvent('button-click'));
|
|
29
|
+
const event = await adapter.waitForAnalytic('button-click');
|
|
30
|
+
expect(event.name).toBe('button-click');
|
|
31
|
+
});
|
|
32
|
+
it('resolves waitForAnalytic when a matching event is recorded later', async () => {
|
|
33
|
+
const adapter = new MockAnalyticsAdapter();
|
|
34
|
+
const promise = adapter.waitForAnalytic('button-click');
|
|
35
|
+
adapter.registerAnalytic(createEvent('page-view'));
|
|
36
|
+
adapter.registerAnalytic(createEvent('button-click'));
|
|
37
|
+
const event = await promise;
|
|
38
|
+
expect(event.name).toBe('button-click');
|
|
39
|
+
});
|
|
40
|
+
it('resolves waitForAnalytic via predicate matcher', async () => {
|
|
41
|
+
const adapter = new MockAnalyticsAdapter();
|
|
42
|
+
const promise = adapter.waitForAnalytic((e) => e.attributes?.id === 42);
|
|
43
|
+
adapter.registerAnalytic(createEvent('button-click', { attributes: { id: 1 } }));
|
|
44
|
+
adapter.registerAnalytic(createEvent('button-click', { attributes: { id: 42 } }));
|
|
45
|
+
const event = await promise;
|
|
46
|
+
expect(event.attributes?.id).toBe(42);
|
|
47
|
+
});
|
|
48
|
+
it('rejects when the timeout elapses before a matching event is recorded', async () => {
|
|
49
|
+
vi.useFakeTimers();
|
|
50
|
+
const adapter = new MockAnalyticsAdapter();
|
|
51
|
+
const promise = adapter.waitForAnalytic('button-click', { timeout: 500 });
|
|
52
|
+
vi.advanceTimersByTime(501);
|
|
53
|
+
await expect(promise).rejects.toThrow('waitForAnalytic timed out after 500ms');
|
|
54
|
+
});
|
|
55
|
+
it('rejects when the AbortSignal fires before a matching event', async () => {
|
|
56
|
+
const adapter = new MockAnalyticsAdapter();
|
|
57
|
+
const controller = new AbortController();
|
|
58
|
+
const promise = adapter.waitForAnalytic('button-click', { signal: controller.signal });
|
|
59
|
+
controller.abort();
|
|
60
|
+
await expect(promise).rejects.toThrow();
|
|
61
|
+
});
|
|
62
|
+
it('rejects immediately when passed an already-aborted signal', async () => {
|
|
63
|
+
const adapter = new MockAnalyticsAdapter();
|
|
64
|
+
const controller = new AbortController();
|
|
65
|
+
controller.abort();
|
|
66
|
+
await expect(adapter.waitForAnalytic('button-click', { signal: controller.signal })).rejects.toThrow();
|
|
67
|
+
});
|
|
68
|
+
it('rejects pending waitForAnalytic calls when the adapter is disposed', async () => {
|
|
69
|
+
const adapter = new MockAnalyticsAdapter();
|
|
70
|
+
const promise = adapter.waitForAnalytic('button-click');
|
|
71
|
+
adapter[Symbol.dispose]();
|
|
72
|
+
await expect(promise).rejects.toThrow('disposed before a matching event was recorded');
|
|
73
|
+
});
|
|
74
|
+
it('rejects instead of hanging when a predicate matcher throws on a future event', async () => {
|
|
75
|
+
const adapter = new MockAnalyticsAdapter();
|
|
76
|
+
const boom = new Error('predicate boom');
|
|
77
|
+
const promise = adapter.waitForAnalytic(() => {
|
|
78
|
+
throw boom;
|
|
79
|
+
});
|
|
80
|
+
adapter.registerAnalytic(createEvent('button-click'));
|
|
81
|
+
await expect(promise).rejects.toThrow(boom);
|
|
82
|
+
});
|
|
83
|
+
it('does not interfere with events recorded by another adapter instance', () => {
|
|
84
|
+
const adapterA = new MockAnalyticsAdapter();
|
|
85
|
+
const adapterB = new MockAnalyticsAdapter();
|
|
86
|
+
adapterA.registerAnalytic(createEvent('button-click'));
|
|
87
|
+
expect(adapterA.getAnalytics()).toHaveLength(1);
|
|
88
|
+
expect(adapterB.getAnalytics()).toHaveLength(0);
|
|
89
|
+
});
|
|
90
|
+
});
|
|
91
|
+
//# sourceMappingURL=MockAnalyticsAdapter.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MockAnalyticsAdapter.test.js","sourceRoot":"","sources":["../../../src/__tests__/MockAnalyticsAdapter.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { describe, expect, it, vi } from 'vitest';
|
|
2
|
+
import { ModulesConfigurator } from '@equinor/fusion-framework-module';
|
|
3
|
+
import { Subject } from 'rxjs';
|
|
4
|
+
import { enableAnalytics } from '../../enable-analytics.js';
|
|
5
|
+
import { ConsoleAnalyticsAdapter } from '../../adapters/ConsoleAnalyticsAdapter.js';
|
|
6
|
+
import { MockAnalyticsAdapter } from '../../mock/MockAnalyticsAdapter.js';
|
|
7
|
+
/**
|
|
8
|
+
* Initializes the analytics module through the real module system, with a
|
|
9
|
+
* `MockAnalyticsAdapter` registered alongside whatever the test configures.
|
|
10
|
+
*
|
|
11
|
+
* @remarks
|
|
12
|
+
* Deliberately avoids hand-building an `AnalyticsProvider`. Testing the
|
|
13
|
+
* adapter's own logic in isolation (see `MockAnalyticsAdapter.test.ts`) can't
|
|
14
|
+
* prove it actually receives events through the real configure -> initialize
|
|
15
|
+
* -> collector/adapter dispatch pipeline every other adapter goes through.
|
|
16
|
+
*
|
|
17
|
+
* @param configure - Optional callback to register additional adapters/collectors.
|
|
18
|
+
* @returns The real `IAnalyticsProvider` instance and the recording adapter.
|
|
19
|
+
*/
|
|
20
|
+
const initializeWith = async (configure) => {
|
|
21
|
+
const recorder = new MockAnalyticsAdapter();
|
|
22
|
+
const configurator = new ModulesConfigurator([]);
|
|
23
|
+
enableAnalytics(configurator, (builder) => {
|
|
24
|
+
builder.setAdapter('mock', async () => recorder);
|
|
25
|
+
configure?.(builder);
|
|
26
|
+
});
|
|
27
|
+
const instances = await configurator.initialize();
|
|
28
|
+
const provider = instances.analytics;
|
|
29
|
+
return { provider, recorder };
|
|
30
|
+
};
|
|
31
|
+
describe('MockAnalyticsAdapter (through the real analytics module)', () => {
|
|
32
|
+
it('observes events pushed via provider.trackAnalytic', async () => {
|
|
33
|
+
const { provider, recorder } = await initializeWith();
|
|
34
|
+
provider.trackAnalytic({ name: 'button-click', value: 'save' });
|
|
35
|
+
expect(recorder.getAnalytics('button-click')).toHaveLength(1);
|
|
36
|
+
});
|
|
37
|
+
it('observes events emitted by a real registered collector', async () => {
|
|
38
|
+
const clicks$ = new Subject();
|
|
39
|
+
const { recorder } = await initializeWith((builder) => {
|
|
40
|
+
builder.setCollector('clicks', async () => clicks$);
|
|
41
|
+
});
|
|
42
|
+
clicks$.next({ name: 'window-click', value: 42 });
|
|
43
|
+
const event = await recorder.waitForAnalytic('window-click');
|
|
44
|
+
expect(event.value).toBe(42);
|
|
45
|
+
});
|
|
46
|
+
it('does not interfere with other adapters registered alongside it', async () => {
|
|
47
|
+
const logSpy = vi.spyOn(console, 'log').mockImplementation(() => undefined);
|
|
48
|
+
const { provider, recorder } = await initializeWith((builder) => {
|
|
49
|
+
builder.setAdapter('console', async () => new ConsoleAnalyticsAdapter());
|
|
50
|
+
});
|
|
51
|
+
provider.trackAnalytic({ name: 'page-view', value: null });
|
|
52
|
+
expect(recorder.getAnalytics('page-view')).toHaveLength(1);
|
|
53
|
+
expect(logSpy).toHaveBeenCalledWith('Analytics::Adapter::Console', {
|
|
54
|
+
name: 'page-view',
|
|
55
|
+
value: null,
|
|
56
|
+
});
|
|
57
|
+
logSpy.mockRestore();
|
|
58
|
+
});
|
|
59
|
+
});
|
|
60
|
+
//# sourceMappingURL=analytics-mock-adapter.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"analytics-mock-adapter.test.js","sourceRoot":"","sources":["../../../../src/__tests__/mock/analytics-mock-adapter.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import { Subject, filter } from 'rxjs';
|
|
2
|
+
/**
|
|
3
|
+
* An {@link IAnalyticsAdapter} that records every tracked event in-memory instead
|
|
4
|
+
* of exporting it to a backend, for asserting on analytics in tests.
|
|
5
|
+
*
|
|
6
|
+
* @remarks
|
|
7
|
+
* Register it like any other adapter via {@link IAnalyticsConfigurator.setAdapter};
|
|
8
|
+
* it does not interfere with other adapters registered alongside it.
|
|
9
|
+
*
|
|
10
|
+
* @template T - Analytics event type, defaults to {@link AnalyticsEvent}.
|
|
11
|
+
*
|
|
12
|
+
* @example
|
|
13
|
+
* ```ts
|
|
14
|
+
* import { MockAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/mock';
|
|
15
|
+
*
|
|
16
|
+
* const recorder = new MockAnalyticsAdapter();
|
|
17
|
+
* enableAnalytics(configurator, (builder) => {
|
|
18
|
+
* builder.setAdapter('mock', async () => recorder);
|
|
19
|
+
* });
|
|
20
|
+
*
|
|
21
|
+
* // ...later, in a test
|
|
22
|
+
* const event = await recorder.waitForAnalytic('button-click');
|
|
23
|
+
* expect(event.attributes?.section).toBe('header');
|
|
24
|
+
* ```
|
|
25
|
+
*/
|
|
26
|
+
export class MockAnalyticsAdapter {
|
|
27
|
+
#events = [];
|
|
28
|
+
#events$ = new Subject();
|
|
29
|
+
/**
|
|
30
|
+
* Records the event so it is visible to {@link getAnalytics} and any pending
|
|
31
|
+
* {@link waitForAnalytic} calls.
|
|
32
|
+
*
|
|
33
|
+
* @param event - The analytics event to record.
|
|
34
|
+
*/
|
|
35
|
+
registerAnalytic(event) {
|
|
36
|
+
this.#events.push(event);
|
|
37
|
+
this.#events$.next(event);
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Returns recorded events matching `matcher`, in dispatch order.
|
|
41
|
+
*
|
|
42
|
+
* @param matcher - Event name, array of names, or a predicate. Omit to get every recorded event.
|
|
43
|
+
* @returns Matching recorded events.
|
|
44
|
+
*/
|
|
45
|
+
getAnalytics(matcher) {
|
|
46
|
+
// No matcher: return every event recorded so far.
|
|
47
|
+
if (matcher === undefined)
|
|
48
|
+
return [...this.#events];
|
|
49
|
+
// Narrow down to events accepted by the matcher.
|
|
50
|
+
return this.#events.filter((event) => this.#matches(event, matcher));
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Waits for the next event matching `matcher`, resolving immediately if a
|
|
54
|
+
* matching event was already recorded.
|
|
55
|
+
*
|
|
56
|
+
* @param matcher - Event name, array of names, or a predicate.
|
|
57
|
+
* @param options - Optional timeout (ms) or AbortSignal.
|
|
58
|
+
* @returns A promise that resolves with the first matching event.
|
|
59
|
+
*/
|
|
60
|
+
waitForAnalytic(matcher, options) {
|
|
61
|
+
// Already recorded: resolve immediately rather than only watching future events.
|
|
62
|
+
const recorded = this.#events.find((event) => this.#matches(event, matcher));
|
|
63
|
+
// Already recorded: resolve immediately rather than only watching future events.
|
|
64
|
+
if (recorded)
|
|
65
|
+
return Promise.resolve(recorded);
|
|
66
|
+
return new Promise((resolve, reject) => {
|
|
67
|
+
const { timeout: ms, signal } = options ?? {};
|
|
68
|
+
// Fail fast without subscribing when the caller already aborted.
|
|
69
|
+
if (signal?.aborted) {
|
|
70
|
+
reject(signal.reason ?? new DOMException('Aborted', 'AbortError'));
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
let timer;
|
|
74
|
+
// Declared before subscribing so `complete` can reach it even when the
|
|
75
|
+
// adapter is already disposed and fires synchronously during `subscribe`.
|
|
76
|
+
let sub;
|
|
77
|
+
const cleanup = () => {
|
|
78
|
+
clearTimeout(timer);
|
|
79
|
+
sub?.unsubscribe();
|
|
80
|
+
};
|
|
81
|
+
// Only forward events accepted by the matcher to the subscriber below.
|
|
82
|
+
sub = this.#events$.pipe(filter((event) => this.#matches(event, matcher))).subscribe({
|
|
83
|
+
next: (event) => {
|
|
84
|
+
cleanup();
|
|
85
|
+
resolve(event);
|
|
86
|
+
},
|
|
87
|
+
// A throwing predicate matcher surfaces here instead of hanging the promise forever.
|
|
88
|
+
error: (err) => {
|
|
89
|
+
cleanup();
|
|
90
|
+
reject(err);
|
|
91
|
+
},
|
|
92
|
+
complete: () => {
|
|
93
|
+
cleanup();
|
|
94
|
+
reject(new Error('MockAnalyticsAdapter disposed before a matching event was recorded'));
|
|
95
|
+
},
|
|
96
|
+
});
|
|
97
|
+
// Only arm a timeout when the caller opted in.
|
|
98
|
+
if (ms !== undefined) {
|
|
99
|
+
timer = setTimeout(() => {
|
|
100
|
+
cleanup();
|
|
101
|
+
reject(new Error(`waitForAnalytic timed out after ${ms}ms`));
|
|
102
|
+
}, ms);
|
|
103
|
+
}
|
|
104
|
+
// Only wire abort handling when the caller passed a signal.
|
|
105
|
+
if (signal) {
|
|
106
|
+
signal.addEventListener('abort', () => {
|
|
107
|
+
cleanup();
|
|
108
|
+
reject(signal.reason ?? new DOMException('Aborted', 'AbortError'));
|
|
109
|
+
}, { once: true });
|
|
110
|
+
}
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Tests whether `event` satisfies `matcher`.
|
|
115
|
+
*
|
|
116
|
+
* @param event - Event to test.
|
|
117
|
+
* @param matcher - Event name, array of names, or a predicate.
|
|
118
|
+
* @returns Whether `event` matches.
|
|
119
|
+
*/
|
|
120
|
+
#matches(event, matcher) {
|
|
121
|
+
// String matcher: compare event name directly.
|
|
122
|
+
if (typeof matcher === 'string')
|
|
123
|
+
return event.name === matcher;
|
|
124
|
+
// Array matcher: match against any of the given names.
|
|
125
|
+
if (Array.isArray(matcher))
|
|
126
|
+
return matcher.includes(event.name);
|
|
127
|
+
return matcher(event);
|
|
128
|
+
}
|
|
129
|
+
/** Completes the internal event stream, rejecting any pending `waitForAnalytic` calls. */
|
|
130
|
+
[Symbol.dispose]() {
|
|
131
|
+
this.#events$.complete();
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
//# sourceMappingURL=MockAnalyticsAdapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MockAnalyticsAdapter.js","sourceRoot":"","sources":["../../../src/mock/MockAnalyticsAdapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Mock analytics adapter for tests: records tracked events in-memory instead
|
|
3
|
+
* of exporting them to a backend.
|
|
4
|
+
*
|
|
5
|
+
* @remarks
|
|
6
|
+
* Register it like any other {@link IAnalyticsAdapter} via
|
|
7
|
+
* {@link IAnalyticsConfigurator.setAdapter} — it observes tracked events
|
|
8
|
+
* alongside real adapters without affecting their delivery.
|
|
9
|
+
*
|
|
10
|
+
* @example
|
|
11
|
+
* ```ts
|
|
12
|
+
* import { MockAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/mock';
|
|
13
|
+
*
|
|
14
|
+
* const recorder = new MockAnalyticsAdapter();
|
|
15
|
+
* enableAnalytics(configurator, (builder) => {
|
|
16
|
+
* builder.setAdapter('mock', async () => recorder);
|
|
17
|
+
* });
|
|
18
|
+
*
|
|
19
|
+
* const event = await recorder.waitForAnalytic('button-click');
|
|
20
|
+
* expect(event.attributes?.section).toBe('header');
|
|
21
|
+
* ```
|
|
22
|
+
*
|
|
23
|
+
* @packageDocumentation
|
|
24
|
+
*/
|
|
25
|
+
export { MockAnalyticsAdapter, } from './MockAnalyticsAdapter.js';
|
|
26
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mock/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACL,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC"}
|
package/dist/esm/version.js
CHANGED