@owlmeans/viable-log 0.1.18-rc.1 → 0.1.18-rc.3

package/README.md

@@ -1,3 +1,150 @@
+# @owlmeans/viable-log
+
+A generated (target) application's link to the OwlMeans platform (viable), expressed as two
+`@owlmeans/log` plugins plus the wire contract the platform reads them with. `viablePreviewPlugin`
+sends the target web's analytics events to the manager frame that embeds the preview;
+`viableSlotPlugin` writes the target backend's error records and analytics events as marked JSON
+lines on stdout, where the platform's publisher picks them up. A generated app registers both
+unconditionally — each is inert wherever the platform is absent — and the platform side imports the
+same package to parse what the app emits. An application that is not generated and run by viable has
+no use for it: count events with `@owlmeans/web-log` (tag manager) instead. The `viable-log` skill
+covers this package; the `logging` skill sets the policy for the log calls that feed it.
+
+## Installation
+
+```bash
+bun add @owlmeans/viable-log@^0.1.18-rc.3
+```
+
+## Concepts
+
+- **Target application** — an app generated and hosted by viable. It logs only through
+  `@owlmeans/log`; these plugins decide what reaches the platform.
+- **Preview channel** — `window[PREVIEW_REPORTER_FLAG]`, an object with `post(type, payload)`
+  installed by the platform's injected reporter in a framed preview. Absent in production.
+- **Slot events** — a backend process run by the publisher with `OWLMEANS_SLOT_EVENTS=1`
+  (`SLOT_EVENTS_ENV`). Without that variable the slot plugin writes nothing.
+- **Target event line** — `TARGET_EVENT_MARKER` (`'[owl:event] '`) followed by one JSON `TargetEvent`,
+  capped at `TARGET_EVENT_MAX` (16 KiB). Versioned by `TARGET_EVENT_VERSION`.
+- **Untrusted input** — the platform treats every line as written by generated code: it validates
+  marker, JSON, version, kind and level, clips text fields and drops unknown ones.
+
+## Usage
+
+### 1. Target web — register the preview plugin
+
+```typescript
+import { addLogPlugin, logger } from '@owlmeans/log'
+import { viablePreviewPlugin } from '@owlmeans/viable-log'
+
+addLogPlugin(viablePreviewPlugin())
+
+logger('ui').info('Opened', { page: 'home' }, { analytics: 'page_view' })
+// in a framed preview: channel.post('OWLMEANS_PREVIEW_ANALYTICS', { event: 'page_view', scope: 'ui', data: { page: 'home' }, ... })
+// anywhere else: nothing
+```
+
+Browser errors need no plugin: a record carrying an `Error` reaches the reporter's own
+`console.error` hook through the logger's console sink.
+
+### 2. Target backend — register the slot plugin
+
+```typescript
+import { addLogPlugin, logger } from '@owlmeans/log'
+import { viableSlotPlugin } from '@owlmeans/viable-log'
+
+addLogPlugin(viableSlotPlugin())
+
+const log = logger('api')
+log.error('Request failed', error)                                  // → kind 'error' line
+log.info('Signed up', { plan: 'free' }, { analytics: 'signup' })   // → kind 'analytics' line
+log.warn('Slow query')                                              // → no line (not error, not analytics)
+```
+
+### 3. Platform side — read a stdout line
+
+```typescript
+import { targetEventHelper } from '@owlmeans/viable-log'
+
+for (const line of chunk.split('\n')) {
+  const event = targetEventHelper.parseTargetEventLine(line)   // marker may appear anywhere in the line
+  if (event == null) {
+    continue                                                   // ordinary output, or a rejected line
+  }
+  relay(event)
+}
+```
+
+### 4. Platform side — detect the preview channel
+
+```typescript
+import { previewChannel, PREVIEW_ANALYTICS_TYPE } from '@owlmeans/viable-log'
+
+previewChannel()?.post(PREVIEW_ANALYTICS_TYPE, payload)
+```
+
+`previewChannel()` returns `undefined` outside a browser and whenever the flag is not an object with
+a `post` function.
+
+## API
+
+### Plugins and helpers
+
+| Symbol | Kind | Purpose |
+|---|---|---|
+| `viablePreviewPlugin()` | function → `LogPlugin` | Name `'viable-preview'`; `track` posts each `AnalyticsEvent` as `PREVIEW_ANALYTICS_TYPE` through the preview channel |
+| `viableSlotPlugin()` | function → `LogPlugin` | Name `'viable-slot'`; `log` emits error-level records, `track` emits analytics events, both as target event lines on `process.stdout` when `SLOT_EVENTS_ENV` is `'1'` |
+| `previewChannel()` | function | The current document's `PreviewChannel`, or `undefined` |
+| `targetEventHelper` | `TargetEventHelper` | Default instance of the line protocol |
+| `createTargetEventHelper()` | function | Builds a `TargetEventHelper` |
+| `targetEventHelper.targetEventLine(event)` | member | Serialise an event; an over-long one loses its stack, then its data, then is cut at `TARGET_EVENT_MAX` |
+| `targetEventHelper.parseTargetEventLine(line)` | member | Validate and clip an untrusted line → `TargetEvent \| undefined` |
+| `targetEventLine`, `parseTargetEventLine` | functions | Deprecated wrappers; use `targetEventHelper` |
+
+### Constants
+
+| Symbol | Value | Purpose |
+|---|---|---|
+| `PREVIEW_REPORTER_FLAG` | `'__owlmeansPreviewReporter'` | `window` property holding the preview channel |
+| `PREVIEW_ANALYTICS_TYPE` | `'OWLMEANS_PREVIEW_ANALYTICS'` | Message type of a preview analytics post |
+| `TARGET_EVENT_MARKER` | `'[owl:event] '` | Prefix of a target event line |
+| `SLOT_EVENTS_ENV` | `'OWLMEANS_SLOT_EVENTS'` | Environment variable the publisher sets to `1` |
+| `TARGET_EVENT_VERSION` | `1` | Format version of `TargetEvent` |
+| `TARGET_EVENT_MAX` | `16384` | Longest line written and accepted |
+
+### Types
+
+| Symbol | Shape |
+|---|---|
+| `TargetEvent` | `{ v, kind, ts, level, scope, message, event?, data?, error?: { name, message, stack?, incidentId? } }` |
+| `TargetEventKind` | `'error' \| 'analytics'` |
+| `PreviewChannel` | `{ v: number, post(type, payload) }` |
+| `PreviewAnalyticsPayload` | the `AnalyticsEvent` from `@owlmeans/log` |
+| `TargetEventHelper` | `{ targetEventLine, parseTargetEventLine }` |
+
+On parse, text fields are clipped: `scope` and `event` to 200 characters (`scope` falls back to
+`'target'`), `message` to 2000, `error.stack` to 8000, `error.incidentId` to 100.
+
+## Common pitfalls
+
+- Never build a marked line or post a preview message from application code — log through
+  `@owlmeans/log` and let the plugins emit.
+- Do not gate plugin registration on the environment; both plugins are already inert without the
+  channel or `OWLMEANS_SLOT_EVENTS=1`.
+- The slot plugin forwards only `error` records; `warn` and lower reach the platform only when the
+  call also carries an `analytics` option.
+- A stack or a large `data` may be dropped to fit `TARGET_EVENT_MAX` — keep the message meaningful
+  on its own.
+- Changing any `TargetEvent` field shape requires a new `TARGET_EVENT_VERSION`; the parser rejects
+  every other version.
+- Anything read from `parseTargetEventLine` is still user-generated content — do not render or log
+  it as trusted text.
+
+## Related packages
+
+- [`@owlmeans/log`](../log) — `logger`, `addLogPlugin`, `LogPlugin` and the analytics call option
+- [`@owlmeans/web-log`](../web-log) — consent-gated analytics plugins for a tag manager
+
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
 
@@ -6,7 +153,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.48
+npx @owlmeans/agent-skills@^0.1.18-rc.52
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/viable-log",
-  "version": "0.1.18-rc.1",
-  "generatedAt": "2026-10-05T08:32:19.097Z",
+  "version": "0.1.18-rc.3",
+  "generatedAt": "2026-10-08T21:27:54.291Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/viable-log/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: viable-log
-description: How to use @owlmeans/viable-log — a generated (target) application's link to the OwlMeans Viable platform, as two @owlmeans/log plugins. viablePreviewPlugin sends the target web's analytics events to the manager frame through the preview reporter's channel; viableSlotPlugin writes the target backend's error records and analytics events as marked JSON stdout lines for the publisher to relay. Also the shared contract the platform reads them with (TARGET_EVENT_MARKER, parseTargetEventLine, PREVIEW_REPORTER_FLAG). Auto-invoked when wiring the platform link into a generated app's web or backend, importing viablePreviewPlugin, viableSlotPlugin or parseTargetEventLine, or changing how the preview reporter or the publisher takes events from a target.
+description: How to use @owlmeans/viable-log — a generated (target) application's link to the OwlMeans Viable platform, as two @owlmeans/log plugins. viablePreviewPlugin sends the target web's analytics events to the manager frame through the preview reporter's channel; viableSlotPlugin writes the target backend's error records and analytics events as marked JSON stdout lines for the publisher to relay. Also the shared contract the platform reads them with (TARGET_EVENT_MARKER, targetEventHelper.parseTargetEventLine, PREVIEW_REPORTER_FLAG). Auto-invoked when wiring the platform link into a generated app's web or backend, importing viablePreviewPlugin, viableSlotPlugin or targetEventHelper, or changing how the preview reporter or the publisher takes events from a target.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/viable-log
 
 **Layer:** Domain (depends on `@owlmeans/log` only)
-**Install:** `"@owlmeans/viable-log": "^0.1.18-rc.1"` in `dependencies`
+**Install:** `"@owlmeans/viable-log": "^0.1.18-rc.3"` in `dependencies`
 
 The platform is "just one of the plugins" of a target's logging: a generated app logs through
 `@owlmeans/log`, and registers these two plugins so what it says reaches Viable. Both are inert
@@ -32,10 +32,10 @@ Errors in the **browser** need no plugin: a record carrying an `Error` reaches t
 
 ## The contract
 
-`parseTargetEventLine(line)` is how the platform's publisher reads a stdout line — **the input is
+`targetEventHelper.parseTargetEventLine(line)` is how the platform's publisher reads a stdout line — **the input is
 untrusted, written by generated code**: the marker, JSON, version
 (`TARGET_EVENT_VERSION`), kind and level are checked, every text field is clipped, unknown fields are
-dropped. `targetEventLine(event)` writes one, cutting a stack and then data to stay under
+dropped. `targetEventHelper.targetEventLine(event)` writes one, cutting a stack and then data to stay under
 `TARGET_EVENT_MAX`. Change a field's shape only with a new `TARGET_EVENT_VERSION`. An application writes events only
 through `@owlmeans/log` (`log.error(…)`, or a call with an `analytics` option) — never by building a
 marked line or posting a preview message itself.

package/build/event/types.d.ts

@@ -0,0 +1,13 @@
+import type { TargetEvent } from '../types.js';
+/** The stdout line protocol a target's backend speaks to the platform's publisher. */
+export interface TargetEventHelper {
+    /** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
+    targetEventLine: (event: TargetEvent) => string;
+    /**
+     * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
+     * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
+     * written by generated code, and nothing outside this function may read fields of it unchecked.
+     */
+    parseTargetEventLine: (line: string) => TargetEvent | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/event/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/event/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,wGAAwG;IACxG,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAA;IAC/C;;;;OAIG;IACH,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;CAChE"}

package/build/event/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/event/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/event/types.ts"],"names":[],"mappings":""}

package/build/event.d.ts

@@ -1,10 +1,9 @@
 import type { TargetEvent } from './types.js';
-/** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
+import type { TargetEventHelper } from './event/types.js';
+export declare const createTargetEventHelper: () => TargetEventHelper;
+export declare const targetEventHelper: TargetEventHelper;
+/** @deprecated compat:factory-refactor — use `targetEventHelper.targetEventLine(…)` */
 export declare const targetEventLine: (event: TargetEvent) => string;
-/**
- * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
- * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
- * written by generated code, and nothing outside this function may read fields of it unchecked.
- */
+/** @deprecated compat:factory-refactor — use `targetEventHelper.parseTargetEventLine(…)` */
 export declare const parseTargetEventLine: (line: string) => TargetEvent | undefined;
 //# sourceMappingURL=event.d.ts.map

package/build/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,wGAAwG;AACxG,eAAO,MAAM,eAAe,UAAW,WAAW,KAAG,MASpD,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SAAU,MAAM,KAAG,WAAW,GAAG,SAqCjE,CAAA"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAMzD,eAAO,MAAM,uBAAuB,QAAO,iBAoD1C,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAA4B,CAAA;AAE1D,uFAAuF;AACvF,eAAO,MAAM,eAAe,UAAW,WAAW,KAAG,MAAkD,CAAA;AAEvG,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,SAAU,MAAM,KAAG,WAAW,GAAG,SACpB,CAAA"}

package/build/event.js

@@ -1,58 +1,60 @@
 import { TARGET_EVENT_MARKER, TARGET_EVENT_MAX, TARGET_EVENT_VERSION } from './consts.js';
 import { LEVELS } from './consts.local.js';
-/** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
-export const targetEventLine = (event) => {
-    let line = TARGET_EVENT_MARKER + JSON.stringify(event);
-    if (line.length > TARGET_EVENT_MAX && event.error?.stack != null) {
-        line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, error: { ...event.error, stack: undefined } });
-    }
-    if (line.length > TARGET_EVENT_MAX) {
-        line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, data: undefined });
-    }
-    return line.length > TARGET_EVENT_MAX ? line.slice(0, TARGET_EVENT_MAX) : line;
-};
 const text = (value, max) => typeof value === 'string' ? value.slice(0, max) : undefined;
-/**
- * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
- * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
- * written by generated code, and nothing outside this function may read fields of it unchecked.
- */
-export const parseTargetEventLine = (line) => {
-    const at = line.indexOf(TARGET_EVENT_MARKER);
-    if (at < 0 || line.length > TARGET_EVENT_MAX + 64) {
-        return undefined;
-    }
-    let raw;
-    try {
-        raw = JSON.parse(line.slice(at + TARGET_EVENT_MARKER.length));
-    }
-    catch {
-        return undefined;
-    }
-    if (raw == null || typeof raw !== 'object') {
-        return undefined;
-    }
-    const event = raw;
-    if (event.v !== TARGET_EVENT_VERSION || (event.kind !== 'error' && event.kind !== 'analytics')
-        || typeof event.ts !== 'number' || !LEVELS.includes(event.level)) {
-        return undefined;
-    }
-    const error = event.error != null && typeof event.error === 'object' ? event.error : undefined;
-    return {
-        v: TARGET_EVENT_VERSION,
-        kind: event.kind,
-        ts: event.ts,
-        level: event.level,
-        scope: text(event.scope, 200) ?? 'target',
-        message: text(event.message, 2000) ?? '',
-        event: text(event.event, 200),
-        data: event.data,
-        error: error != null
-            ? {
-                name: text(error.name, 200) ?? 'Error', message: text(error.message, 2000) ?? '',
-                stack: text(error.stack, 8000), incidentId: text(error.incidentId, 100),
-            }
-            : undefined,
+export const createTargetEventHelper = () => {
+    const targetEventLine = (event) => {
+        let line = TARGET_EVENT_MARKER + JSON.stringify(event);
+        if (line.length > TARGET_EVENT_MAX && event.error?.stack != null) {
+            line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, error: { ...event.error, stack: undefined } });
+        }
+        if (line.length > TARGET_EVENT_MAX) {
+            line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, data: undefined });
+        }
+        return line.length > TARGET_EVENT_MAX ? line.slice(0, TARGET_EVENT_MAX) : line;
+    };
+    const parseTargetEventLine = (line) => {
+        const at = line.indexOf(TARGET_EVENT_MARKER);
+        if (at < 0 || line.length > TARGET_EVENT_MAX + 64) {
+            return undefined;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(line.slice(at + TARGET_EVENT_MARKER.length));
+        }
+        catch {
+            return undefined;
+        }
+        if (raw == null || typeof raw !== 'object') {
+            return undefined;
+        }
+        const event = raw;
+        if (event.v !== TARGET_EVENT_VERSION || (event.kind !== 'error' && event.kind !== 'analytics')
+            || typeof event.ts !== 'number' || !LEVELS.includes(event.level)) {
+            return undefined;
+        }
+        const error = event.error != null && typeof event.error === 'object' ? event.error : undefined;
+        return {
+            v: TARGET_EVENT_VERSION,
+            kind: event.kind,
+            ts: event.ts,
+            level: event.level,
+            scope: text(event.scope, 200) ?? 'target',
+            message: text(event.message, 2000) ?? '',
+            event: text(event.event, 200),
+            data: event.data,
+            error: error != null
+                ? {
+                    name: text(error.name, 200) ?? 'Error', message: text(error.message, 2000) ?? '',
+                    stack: text(error.stack, 8000), incidentId: text(error.incidentId, 100),
+                }
+                : undefined,
+        };
     };
+    return { targetEventLine, parseTargetEventLine };
 };
+export const targetEventHelper = createTargetEventHelper();
+/** @deprecated compat:factory-refactor — use `targetEventHelper.targetEventLine(…)` */
+export const targetEventLine = (event) => targetEventHelper.targetEventLine(event);
+/** @deprecated compat:factory-refactor — use `targetEventHelper.parseTargetEventLine(…)` */
+export const parseTargetEventLine = (line) => targetEventHelper.parseTargetEventLine(line);
 //# sourceMappingURL=event.js.map

package/build/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEzF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,wGAAwG;AACxG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAkB,EAAU,EAAE;IAC5D,IAAI,IAAI,GAAG,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACtD,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QACjE,IAAI,GAAG,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;IACxG,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACnC,IAAI,GAAG,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChF,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,GAAW,EAAsB,EAAE,CAC/D,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAA2B,EAAE;IAC5E,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC5C,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,GAAG,EAAE,EAAE,CAAC;QAClD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,GAAY,CAAA;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,GAA8B,CAAA;IAC5C,IAAI,KAAK,CAAC,CAAC,KAAK,oBAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;WACzF,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAe,CAAC,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAgC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzH,OAAO;QACL,CAAC,EAAE,oBAAoB;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAA6B;QAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,QAAQ;QACzC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;QACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,IAAI,IAAI;YAClB,CAAC,CAAC;gBACA,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;gBAChF,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC;aACxE;YACD,CAAC,CAAC,SAAS;KACd,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export type * from './types.js';
+export type * from './event/types.js';
 export * from './consts.js';
 export * from './event.js';
 export * from './plugins.js';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,kBAAkB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/build/plugins.js

@@ -1,5 +1,5 @@
 import { PREVIEW_ANALYTICS_TYPE, PREVIEW_REPORTER_FLAG, SLOT_EVENTS_ENV, TARGET_EVENT_VERSION } from './consts.js';
-import { targetEventLine } from './event.js';
+import { targetEventHelper } from './event.js';
 /** The reporter's channel of the current document, or `undefined` outside a framed preview. */
 export const previewChannel = () => {
     if (typeof window === 'undefined') {
@@ -47,7 +47,7 @@ export const viableSlotPlugin = () => {
     const emit = (event) => {
         const out = stdout();
         if (out != null && slotEventsEnabled()) {
-            out.write(`${targetEventLine(event)}\n`);
+            out.write(`${targetEventHelper.targetEventLine(event)}\n`);
         }
     };
     return {

package/build/plugins.js.map

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

package/build/types.d.ts

@@ -30,5 +30,6 @@ export interface TargetEvent {
     };
 }
 /** The payload of a preview `Analytics` message (browser → manager). */
-export type PreviewAnalyticsPayload = AnalyticsEvent;
+export interface PreviewAnalyticsPayload extends AnalyticsEvent {
+}
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,eAAe,CAAA;IACrB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/E;AAED,wEAAwE;AACxE,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,eAAe,CAAA;IACrB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/E;AAED,wEAAwE;AACxE,MAAM,WAAW,uBAAwB,SAAQ,cAAc;CAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/viable-log",
-  "version": "0.1.18-rc.1",
+  "version": "0.1.18-rc.3",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,7 +22,7 @@
     }
   },
   "dependencies": {
-    "@owlmeans/log": "^0.1.18-rc.1"
+    "@owlmeans/log": "^0.1.18-rc.3"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/event/types.ts

@@ -0,0 +1,13 @@
+import type { TargetEvent } from '../types.js'
+
+/** The stdout line protocol a target's backend speaks to the platform's publisher. */
+export interface TargetEventHelper {
+  /** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
+  targetEventLine: (event: TargetEvent) => string
+  /**
+   * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
+   * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
+   * written by generated code, and nothing outside this function may read fields of it unchecked.
+   */
+  parseTargetEventLine: (line: string) => TargetEvent | undefined
+}

package/src/event.ts

@@ -1,62 +1,70 @@
 import { TARGET_EVENT_MARKER, TARGET_EVENT_MAX, TARGET_EVENT_VERSION } from './consts.js'
 import type { TargetEvent } from './types.js'
+import type { TargetEventHelper } from './event/types.js'
 import { LEVELS } from './consts.local.js'
 
-/** The stdout line of an event. Over-long ones lose their stack, then their data — never their head. */
-export const targetEventLine = (event: TargetEvent): string => {
-  let line = TARGET_EVENT_MARKER + JSON.stringify(event)
-  if (line.length > TARGET_EVENT_MAX && event.error?.stack != null) {
-    line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, error: { ...event.error, stack: undefined } })
-  }
-  if (line.length > TARGET_EVENT_MAX) {
-    line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, data: undefined })
-  }
-  return line.length > TARGET_EVENT_MAX ? line.slice(0, TARGET_EVENT_MAX) : line
-}
-
 const text = (value: unknown, max: number): string | undefined =>
   typeof value === 'string' ? value.slice(0, max) : undefined
 
-/**
- * The event a stdout line carries, or `undefined` when the line is not one — absent marker, broken
- * JSON, unknown version, or a shape the platform does not accept. The input is untrusted: it is
- * written by generated code, and nothing outside this function may read fields of it unchecked.
- */
-export const parseTargetEventLine = (line: string): TargetEvent | undefined => {
-  const at = line.indexOf(TARGET_EVENT_MARKER)
-  if (at < 0 || line.length > TARGET_EVENT_MAX + 64) {
-    return undefined
-  }
-  let raw: unknown
-  try {
-    raw = JSON.parse(line.slice(at + TARGET_EVENT_MARKER.length))
-  } catch {
-    return undefined
-  }
-  if (raw == null || typeof raw !== 'object') {
-    return undefined
-  }
-  const event = raw as Record<string, unknown>
-  if (event.v !== TARGET_EVENT_VERSION || (event.kind !== 'error' && event.kind !== 'analytics')
-    || typeof event.ts !== 'number' || !LEVELS.includes(event.level as string)) {
-    return undefined
+export const createTargetEventHelper = (): TargetEventHelper => {
+  const targetEventLine = (event: TargetEvent): string => {
+    let line = TARGET_EVENT_MARKER + JSON.stringify(event)
+    if (line.length > TARGET_EVENT_MAX && event.error?.stack != null) {
+      line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, error: { ...event.error, stack: undefined } })
+    }
+    if (line.length > TARGET_EVENT_MAX) {
+      line = TARGET_EVENT_MARKER + JSON.stringify({ ...event, data: undefined })
+    }
+    return line.length > TARGET_EVENT_MAX ? line.slice(0, TARGET_EVENT_MAX) : line
   }
-  const error = event.error != null && typeof event.error === 'object' ? event.error as Record<string, unknown> : undefined
-
-  return {
-    v: TARGET_EVENT_VERSION,
-    kind: event.kind,
-    ts: event.ts,
-    level: event.level as TargetEvent['level'],
-    scope: text(event.scope, 200) ?? 'target',
-    message: text(event.message, 2000) ?? '',
-    event: text(event.event, 200),
-    data: event.data,
-    error: error != null
-      ? {
-        name: text(error.name, 200) ?? 'Error', message: text(error.message, 2000) ?? '',
-        stack: text(error.stack, 8000), incidentId: text(error.incidentId, 100),
-      }
-      : undefined,
+
+  const parseTargetEventLine = (line: string): TargetEvent | undefined => {
+    const at = line.indexOf(TARGET_EVENT_MARKER)
+    if (at < 0 || line.length > TARGET_EVENT_MAX + 64) {
+      return undefined
+    }
+    let raw: unknown
+    try {
+      raw = JSON.parse(line.slice(at + TARGET_EVENT_MARKER.length))
+    } catch {
+      return undefined
+    }
+    if (raw == null || typeof raw !== 'object') {
+      return undefined
+    }
+    const event = raw as Record<string, unknown>
+    if (event.v !== TARGET_EVENT_VERSION || (event.kind !== 'error' && event.kind !== 'analytics')
+      || typeof event.ts !== 'number' || !LEVELS.includes(event.level as string)) {
+      return undefined
+    }
+    const error = event.error != null && typeof event.error === 'object' ? event.error as Record<string, unknown> : undefined
+
+    return {
+      v: TARGET_EVENT_VERSION,
+      kind: event.kind,
+      ts: event.ts,
+      level: event.level as TargetEvent['level'],
+      scope: text(event.scope, 200) ?? 'target',
+      message: text(event.message, 2000) ?? '',
+      event: text(event.event, 200),
+      data: event.data,
+      error: error != null
+        ? {
+          name: text(error.name, 200) ?? 'Error', message: text(error.message, 2000) ?? '',
+          stack: text(error.stack, 8000), incidentId: text(error.incidentId, 100),
+        }
+        : undefined,
+    }
   }
+
+  return { targetEventLine, parseTargetEventLine }
 }
+
+export const targetEventHelper = createTargetEventHelper()
+
+/** @deprecated compat:factory-refactor — use `targetEventHelper.targetEventLine(…)` */
+export const targetEventLine = (event: TargetEvent): string => targetEventHelper.targetEventLine(event)
+
+/** @deprecated compat:factory-refactor — use `targetEventHelper.parseTargetEventLine(…)` */
+export const parseTargetEventLine = (line: string): TargetEvent | undefined =>
+  targetEventHelper.parseTargetEventLine(line)

package/src/index.ts

@@ -1,5 +1,6 @@
 
 export type * from './types.js'
+export type * from './event/types.js'
 export * from './consts.js'
 export * from './event.js'
 export * from './plugins.js'

package/src/plugins.ts

@@ -1,6 +1,6 @@
 import type { LogPlugin, LogRecord } from '@owlmeans/log'
 import { PREVIEW_ANALYTICS_TYPE, PREVIEW_REPORTER_FLAG, SLOT_EVENTS_ENV, TARGET_EVENT_VERSION } from './consts.js'
-import { targetEventLine } from './event.js'
+import { targetEventHelper } from './event.js'
 import type { PreviewChannel, TargetEvent } from './types.js'
 import type { Stdout } from './types.local.js'
 
@@ -58,7 +58,7 @@ export const viableSlotPlugin = (): LogPlugin => {
   const emit = (event: TargetEvent): void => {
     const out = stdout()
     if (out != null && slotEventsEnabled()) {
-      out.write(`${targetEventLine(event)}\n`)
+      out.write(`${targetEventHelper.targetEventLine(event)}\n`)
     }
   }
   return {

package/src/types.ts

@@ -29,4 +29,4 @@ export interface TargetEvent {
 }
 
 /** The payload of a preview `Analytics` message (browser → manager). */
-export type PreviewAnalyticsPayload = AnalyticsEvent
+export interface PreviewAnalyticsPayload extends AnalyticsEvent {}

package/tests/viable-log.spec.ts

@@ -1,8 +1,8 @@
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
-import { addLogPlugin, logger, nativeConsole, resetLog } from '@owlmeans/log'
+import { addLogPlugin, logger, resetLog, logStateHelper } from '@owlmeans/log'
 import {
   PREVIEW_ANALYTICS_TYPE, PREVIEW_REPORTER_FLAG, SLOT_EVENTS_ENV, TARGET_EVENT_MARKER, TARGET_EVENT_MAX,
-  parseTargetEventLine, targetEventLine, viablePreviewPlugin, viableSlotPlugin,
+  targetEventHelper, viablePreviewPlugin, viableSlotPlugin,
 } from '@owlmeans/viable-log'
 import type { TargetEvent } from '@owlmeans/viable-log'
 
@@ -13,37 +13,37 @@ const sample = (patch: Partial<TargetEvent> = {}): TargetEvent => ({
 describe('target event line', () => {
   test('round-trips through targetEventLine and parseTargetEventLine', () => {
     const event = sample({ data: { id: 1 }, error: { name: 'Error', message: 'x', stack: 's', incidentId: 'i' }, event: 'e' })
-    expect(parseTargetEventLine(targetEventLine(event))).toEqual(event)
+    expect(targetEventHelper.parseTargetEventLine(targetEventHelper.targetEventLine(event))).toEqual(event)
   })
 
   test('finds the marker anywhere in a line (prefixed stdout)', () => {
-    expect(parseTargetEventLine(`12:00 ${targetEventLine(sample())}`)?.message).toBe('boom')
+    expect(targetEventHelper.parseTargetEventLine(`12:00 ${targetEventHelper.targetEventLine(sample())}`)?.message).toBe('boom')
   })
 
   test('rejects a line without a marker, broken JSON, a wrong version or kind, a bad level', () => {
-    expect(parseTargetEventLine('plain')).toBeUndefined()
-    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}{nope`)).toBeUndefined()
-    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), v: 2 })}`)).toBeUndefined()
-    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), kind: 'x' })}`)).toBeUndefined()
-    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), level: 'fatal' })}`)).toBeUndefined()
-    expect(parseTargetEventLine(`${TARGET_EVENT_MARKER}null`)).toBeUndefined()
+    expect(targetEventHelper.parseTargetEventLine('plain')).toBeUndefined()
+    expect(targetEventHelper.parseTargetEventLine(`${TARGET_EVENT_MARKER}{nope`)).toBeUndefined()
+    expect(targetEventHelper.parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), v: 2 })}`)).toBeUndefined()
+    expect(targetEventHelper.parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), kind: 'x' })}`)).toBeUndefined()
+    expect(targetEventHelper.parseTargetEventLine(`${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), level: 'fatal' })}`)).toBeUndefined()
+    expect(targetEventHelper.parseTargetEventLine(`${TARGET_EVENT_MARKER}null`)).toBeUndefined()
   })
 
   test('clips untrusted text fields and ignores unknown fields', () => {
     const line = `${TARGET_EVENT_MARKER}${JSON.stringify({ ...sample(), message: 'm'.repeat(5000), extra: 'x', scope: 7 })}`
-    const parsed = parseTargetEventLine(line)!
+    const parsed = targetEventHelper.parseTargetEventLine(line)!
     expect(parsed.message.length).toBe(2000)
     expect(parsed.scope).toBe('target')
     expect('extra' in parsed).toBe(false)
   })
 
   test('an over-long event loses its stack first, then its data, and stays under the cap', () => {
-    const stackless = targetEventLine(sample({ error: { name: 'E', message: 'm', stack: 's'.repeat(TARGET_EVENT_MAX * 2) } }))
+    const stackless = targetEventHelper.targetEventLine(sample({ error: { name: 'E', message: 'm', stack: 's'.repeat(TARGET_EVENT_MAX * 2) } }))
     expect(stackless.length).toBeLessThanOrEqual(TARGET_EVENT_MAX)
-    expect(parseTargetEventLine(stackless)?.error?.message).toBe('m')
-    const dataless = targetEventLine(sample({ data: 'd'.repeat(TARGET_EVENT_MAX * 2) }))
+    expect(targetEventHelper.parseTargetEventLine(stackless)?.error?.message).toBe('m')
+    const dataless = targetEventHelper.targetEventLine(sample({ data: 'd'.repeat(TARGET_EVENT_MAX * 2) }))
     expect(dataless.length).toBeLessThanOrEqual(TARGET_EVENT_MAX)
-    expect(parseTargetEventLine(dataless)?.message).toBe('boom')
+    expect(targetEventHelper.parseTargetEventLine(dataless)?.message).toBe('boom')
   })
 })
 
@@ -74,18 +74,18 @@ describe('viableSlotPlugin', () => {
   const written: string[] = []
   const proc = globalThis.process
   const realWrite = proc.stdout.write.bind(proc.stdout)
-  let saved: ReturnType<typeof nativeConsole>
+  let saved: ReturnType<typeof logStateHelper.nativeConsole>
 
   beforeEach(() => {
     resetLog()
     written.length = 0
-    saved = { ...nativeConsole() }
-    for (const key of Object.keys(nativeConsole()) as (keyof ReturnType<typeof nativeConsole>)[]) nativeConsole()[key] = () => undefined
+    saved = { ...logStateHelper.nativeConsole() }
+    for (const key of Object.keys(logStateHelper.nativeConsole()) as (keyof ReturnType<typeof logStateHelper.nativeConsole>)[]) logStateHelper.nativeConsole()[key] = () => undefined
     ;(proc.stdout as { write: unknown }).write = (chunk: string) => { written.push(String(chunk)); return true }
   })
   afterEach(() => {
     ;(proc.stdout as { write: unknown }).write = realWrite
-    Object.assign(nativeConsole(), saved)
+    Object.assign(logStateHelper.nativeConsole(), saved)
     delete proc.env[SLOT_EVENTS_ENV]
     resetLog()
   })
@@ -104,7 +104,7 @@ describe('viableSlotPlugin', () => {
     logger('api').info('Signed up', { plan: 'free' }, { analytics: 'signup' })
     logger('api').info('plain info')
     logger('api').warn('plain warn')
-    const events = written.map(line => parseTargetEventLine(line)!)
+    const events = written.map(line => targetEventHelper.parseTargetEventLine(line)!)
     expect(events.map(e => [e.kind, e.event ?? e.message])).toEqual([['error', 'Request failed'], ['analytics', 'signup']])
     expect(events[0].error).toMatchObject({ name: 'Error', message: 'db down', incidentId: 'inc-1' })
     expect(events[1].data).toEqual({ plan: 'free' })