@senpi/runtime 1.1.0-dev.runtime-phase-2.20260609132603 → 1.1.0-dev.runtime-phase-2.20260610130051

package/dist/recording/otel/attributes.js

@@ -0,0 +1,131 @@
+/**
+ * Attribute flattening + the timestamp/duration conversions. The flattening rule is the central
+ * query convention: dotted lowercase snake_case keys, `String(v)` values (booleans as
+ * `"true"`/`"false"`), null/undefined omitted, open bags flattened one level, arrays as a single
+ * JSON-string key. Caps bound a row well under the batcher's body cap.
+ *
+ * Order within a row is: redact (typed-field, upstream) → flatten (here) → cap (here).
+ */
+import { MAX_ATTR_VALUE_CHARS, MAX_BAG_KEYS, MAX_CONFIG_CHARS, MAX_TOTAL_ATTR_CHARS, TRUNCATE_MARKER, } from "./constants.js";
+/**
+ * Non-finite or negative epoch-ms must not reach `BigInt()` — `BigInt(NaN)`/`BigInt(Infinity)`
+ * throw, and a negative timestamp is an invalid wire value. Sanitize to `0n` so one bad clock value
+ * degrades a single row rather than throwing and dropping the whole record (every numeric *attribute*
+ * is already finite-guarded in {@link AttrBuilder.put}; timestamps bypass that path).
+ */
+function toEpochMs(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return 0n;
+    return BigInt(Math.trunc(ms));
+}
+/** ms → epoch-ns digit string. BigInt: ms·1e6 overflows Number's safe-integer range. */
+export function msToNs(ms) {
+    return (toEpochMs(ms) * 1000000n).toString();
+}
+/** Duration ns digit string from a clean `endedAt − startedAt` (clamped ≥ 0 defensively). */
+export function durationNs(startedAt, endedAt) {
+    const ns = (toEpochMs(endedAt) - toEpochMs(startedAt)) * 1000000n;
+    return (ns < 0n ? 0n : ns).toString();
+}
+/** Truncate a value past the per-value cap, marking it so the cut is visible downstream. */
+function capValue(value, max) {
+    if (value.length <= max)
+        return value;
+    // `max` could be smaller than the marker (defensive: no current caller passes one that small);
+    // clamp the kept length to ≥ 0 so the slice index never goes negative.
+    return value.slice(0, Math.max(0, max - TRUNCATE_MARKER.length)) + TRUNCATE_MARKER;
+}
+function scalarToString(value) {
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    return String(value);
+}
+/**
+ * Accumulates a row's flat attribute map, applying the casing/null/cap rules uniformly. Callers add
+ * scalars under explicit keys (never auto camel→snake — acronyms mangle), bags one level deep, and
+ * arrays/blobs as single JSON keys.
+ */
+export class AttrBuilder {
+    attrs = {};
+    totalChars = 0;
+    /** Set a scalar under an explicit key. null/undefined → omit; over budget → drop silently. */
+    put(key, value) {
+        if (value === null || value === undefined)
+            return this;
+        if (typeof value === "number" && !Number.isFinite(value))
+            return this;
+        this.assign(key, capValue(scalarToString(value), MAX_ATTR_VALUE_CHARS));
+        return this;
+    }
+    /** Flatten an open bag ONE level under `prefix` (`prefix.{k}`); scalars `String()`, else JSON. */
+    putBag(prefix, bag) {
+        if (!bag)
+            return this;
+        let count = 0;
+        for (const [k, v] of Object.entries(bag)) {
+            if (count >= MAX_BAG_KEYS)
+                break;
+            if (v === null || v === undefined)
+                continue;
+            const str = typeof v === "object" ? safeJson(v) : scalarToString(v);
+            if (str === undefined)
+                continue;
+            // Count only keys actually emitted, so MAX_BAG_KEYS means "emitted" not "attempted" even
+            // when the total-attr guard drops some.
+            if (this.assign(`${prefix}.${k}`, capValue(str, MAX_ATTR_VALUE_CHARS)))
+                count++;
+        }
+        return this;
+    }
+    /** `Record<string,boolean>` → `prefix.{name} = "true"|"false"`. */
+    putFactors(prefix, factors) {
+        if (!factors)
+            return this;
+        let count = 0;
+        for (const [name, v] of Object.entries(factors)) {
+            if (count >= MAX_BAG_KEYS)
+                break;
+            if (this.assign(`${prefix}.${name}`, v ? "true" : "false"))
+                count++;
+        }
+        return this;
+    }
+    /** A single JSON-string key for an array or structured value (queried rarely, structure kept). */
+    putJson(key, value, maxChars = MAX_ATTR_VALUE_CHARS) {
+        if (value === null || value === undefined)
+            return this;
+        const str = safeJson(value);
+        if (str === undefined)
+            return this;
+        this.assign(key, capValue(str, maxChars));
+        return this;
+    }
+    /** The `runtime.config` blob: single JSON key, larger size cap, never flattened. */
+    putConfig(key, value) {
+        return this.putJson(key, value, MAX_CONFIG_CHARS);
+    }
+    /** Assign under the total-attr guard. Returns whether the key was actually stored. */
+    assign(key, value) {
+        // Total-attr guard: once the row's attrs hit the budget, drop further keys rather than let one
+        // record blow past the batcher's body cap.
+        if (this.totalChars + key.length + value.length > MAX_TOTAL_ATTR_CHARS)
+            return false;
+        this.attrs[key] = value;
+        this.totalChars += key.length + value.length;
+        return true;
+    }
+    build() {
+        return this.attrs;
+    }
+}
+/** `JSON.stringify` that never throws (circular refs etc.) — returns undefined on failure. */
+function safeJson(value) {
+    try {
+        const s = JSON.stringify(value);
+        return s === undefined ? undefined : s;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=attributes.js.map

package/dist/recording/otel/attributes.js.map

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

package/dist/recording/otel/constants.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Query-load-bearing constants for the mapper: span/event names, the severity map, scope
+ * identity, attribute namespaces, and the size caps. These are part of the telemetry contract —
+ * changing a name or a severity breaks saved queries downstream, so they live in one pinned place.
+ */
+import type { SpanKind } from "../transport/index.js";
+import type { RecordingRecord } from "../records.js";
+/** One constant pair for this emitter. `ScopeVersion` is injectable on the emitter for the
+ *  real package version (Task 4 wiring); this is the default. */
+export declare const SCOPE_NAME = "senpi.recording";
+export declare const SCOPE_VERSION = "1.1.1";
+export declare const SPAN_NAME: {
+    readonly scannerRun: "scanner.run";
+    /** Root span of a signal-evaluation pass. */
+    readonly signalPass: "signal.evaluation_pass";
+    /** One child span per evaluated signal within a pass. */
+    readonly signalEvaluation: "signal.evaluation";
+};
+/** OTEL-idiomatic span event recording an error on a span. */
+export declare const EXCEPTION_EVENT_NAME = "exception";
+/** OTEL SeverityNumber/SeverityText pairs. */
+export interface Severity {
+    readonly number: number;
+    readonly text: string;
+}
+export declare const SEVERITY: {
+    readonly INFO: {
+        readonly number: 9;
+        readonly text: "INFO";
+    };
+    readonly WARN: {
+        readonly number: 13;
+        readonly text: "WARN";
+    };
+    readonly ERROR: {
+        readonly number: 17;
+        readonly text: "ERROR";
+    };
+};
+/**
+ * Per-record/outcome severity map (deliberately not constant). Errors → ERROR; a self-pause is a
+ * WARN-worthy operational event; every other discrete event is INFO.
+ */
+export declare function severityFor(record: RecordingRecord): Severity;
+/**
+ * `EventName` scheme: `{type}` for records with no sub-enum, `{type}.{discriminator}` where a
+ * discriminating enum exists — so `position_lifecycle.opened`, `dsl_transition.sl_updated`,
+ * `runtime_state.paused` are all directly filterable.
+ */
+export declare function eventNameFor(record: RecordingRecord): string;
+export type RecordRoute = {
+    readonly kind: "trace";
+    readonly spanKind: SpanKind;
+} | {
+    readonly kind: "log";
+};
+/**
+ * Declarative trace-vs-log routing for all 7 record types. Heuristic: durationful *work units* are
+ * spans; discrete events and errors are logs. The two point-in-time domain events
+ * (`position_lifecycle`, `runtime_lifecycle`) are logs, not zero-duration spans — they carry no
+ * duration, and logs are the natural home for point-in-time events, which keeps the trace view
+ * exclusively work units. (Severity for log routes comes from {@link severityFor}.)
+ */
+export declare const ROUTING: {
+    readonly [K in RecordingRecord["type"]]: RecordRoute;
+};
+/** `1` = sampled. `0` reads as "dropped" to OTEL consumers, so always emit `1`. */
+export declare const TRACE_FLAGS_SAMPLED = 1;
+/** Replacement for a scrubbed scalar value; presence is kept, content removed. */
+export declare const REDACT_MARKER = "[redacted]";
+/** Per-value character cap; longer values are truncated with {@link TRUNCATE_MARKER}. */
+export declare const MAX_ATTR_VALUE_CHARS = 4096;
+/** Marker appended to a truncated value. */
+export declare const TRUNCATE_MARKER = "\u2026[truncated]";
+/** Max keys flattened out of a single open bag, bounding key cardinality from an unbounded bag. */
+export declare const MAX_BAG_KEYS = 64;
+/** Char cap for the single `runtime.config` JSON blob (larger than a normal value, still bounded). */
+export declare const MAX_CONFIG_CHARS = 16384;
+/** Total character budget across one row's attribute map — the total-attr guard. */
+export declare const MAX_TOTAL_ATTR_CHARS = 65536;
+//# sourceMappingURL=constants.d.ts.map

package/dist/recording/otel/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/recording/otel/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD;iEACiE;AACjE,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAC5C,eAAO,MAAM,aAAa,UAAU,CAAC;AAGrC,eAAO,MAAM,SAAS;;IAEpB,6CAA6C;;IAE7C,yDAAyD;;CAEjD,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAGhD,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;CAIwB,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAS7D;AAGD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAgB5D;AAGD,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7B;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,WAAW;CAQlE,CAAC;AAGX,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAGrC,kFAAkF;AAClF,eAAO,MAAM,aAAa,eAAe,CAAC;AAG1C,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,4CAA4C;AAC5C,eAAO,MAAM,eAAe,sBAAiB,CAAC;AAC9C,mGAAmG;AACnG,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,QAAQ,CAAC"}

package/dist/recording/otel/constants.js

@@ -0,0 +1,96 @@
+/**
+ * Query-load-bearing constants for the mapper: span/event names, the severity map, scope
+ * identity, attribute namespaces, and the size caps. These are part of the telemetry contract —
+ * changing a name or a severity breaks saved queries downstream, so they live in one pinned place.
+ */
+// ── Scope (the instrumenting library identity) ───────────────────────────────
+/** One constant pair for this emitter. `ScopeVersion` is injectable on the emitter for the
+ *  real package version (Task 4 wiring); this is the default. */
+export const SCOPE_NAME = "senpi.recording";
+export const SCOPE_VERSION = "1.1.1";
+// ── Span names (traces) ──────────────────────────────────────────────────────
+export const SPAN_NAME = {
+    scannerRun: "scanner.run",
+    /** Root span of a signal-evaluation pass. */
+    signalPass: "signal.evaluation_pass",
+    /** One child span per evaluated signal within a pass. */
+    signalEvaluation: "signal.evaluation",
+};
+/** OTEL-idiomatic span event recording an error on a span. */
+export const EXCEPTION_EVENT_NAME = "exception";
+export const SEVERITY = {
+    INFO: { number: 9, text: "INFO" },
+    WARN: { number: 13, text: "WARN" },
+    ERROR: { number: 17, text: "ERROR" },
+};
+/**
+ * Per-record/outcome severity map (deliberately not constant). Errors → ERROR; a self-pause is a
+ * WARN-worthy operational event; every other discrete event is INFO.
+ */
+export function severityFor(record) {
+    switch (record.type) {
+        case "runtime_error":
+            return SEVERITY.ERROR;
+        case "runtime_state":
+            return record.phase === "paused" ? SEVERITY.WARN : SEVERITY.INFO;
+        default:
+            return SEVERITY.INFO;
+    }
+}
+// ── Event names (the log-type discriminator) ─────────────────────────────────
+/**
+ * `EventName` scheme: `{type}` for records with no sub-enum, `{type}.{discriminator}` where a
+ * discriminating enum exists — so `position_lifecycle.opened`, `dsl_transition.sl_updated`,
+ * `runtime_state.paused` are all directly filterable.
+ */
+export function eventNameFor(record) {
+    switch (record.type) {
+        case "position_lifecycle":
+            return `position_lifecycle.${record.event}`;
+        case "dsl_transition":
+            return `dsl_transition.${record.transition}`;
+        case "runtime_lifecycle":
+            return `runtime_lifecycle.${record.phase}`;
+        case "runtime_state":
+            return `runtime_state.${record.phase}`;
+        case "runtime_error":
+            return "runtime_error";
+        default:
+            // Trace-routed records do not carry an EventName; defensive fallback only.
+            return record.type;
+    }
+}
+/**
+ * Declarative trace-vs-log routing for all 7 record types. Heuristic: durationful *work units* are
+ * spans; discrete events and errors are logs. The two point-in-time domain events
+ * (`position_lifecycle`, `runtime_lifecycle`) are logs, not zero-duration spans — they carry no
+ * duration, and logs are the natural home for point-in-time events, which keeps the trace view
+ * exclusively work units. (Severity for log routes comes from {@link severityFor}.)
+ */
+export const ROUTING = {
+    scanner_run: { kind: "trace", spanKind: "Internal" },
+    signal_evaluated: { kind: "trace", spanKind: "Internal" },
+    position_lifecycle: { kind: "log" },
+    dsl_transition: { kind: "log" },
+    runtime_error: { kind: "log" },
+    runtime_lifecycle: { kind: "log" },
+    runtime_state: { kind: "log" },
+};
+// ── Wire defaults ─────────────────────────────────────────────────────────────
+/** `1` = sampled. `0` reads as "dropped" to OTEL consumers, so always emit `1`. */
+export const TRACE_FLAGS_SAMPLED = 1;
+// ── Redaction ──────────────────────────────────────────────────────────────────
+/** Replacement for a scrubbed scalar value; presence is kept, content removed. */
+export const REDACT_MARKER = "[redacted]";
+// ── Size caps ────────────────────────────────────────────────────────────────
+/** Per-value character cap; longer values are truncated with {@link TRUNCATE_MARKER}. */
+export const MAX_ATTR_VALUE_CHARS = 4096;
+/** Marker appended to a truncated value. */
+export const TRUNCATE_MARKER = "…[truncated]";
+/** Max keys flattened out of a single open bag, bounding key cardinality from an unbounded bag. */
+export const MAX_BAG_KEYS = 64;
+/** Char cap for the single `runtime.config` JSON blob (larger than a normal value, still bounded). */
+export const MAX_CONFIG_CHARS = 16384;
+/** Total character budget across one row's attribute map — the total-attr guard. */
+export const MAX_TOTAL_ATTR_CHARS = 65536;
+//# sourceMappingURL=constants.js.map

package/dist/recording/otel/constants.js.map

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

package/dist/recording/otel/ids.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Id generation seam. The wire row shape requires a `TraceId`+`SpanId` per row, so the mapper mints
+ * them. Injecting the generator keeps the row functions pure *given their deps*, so golden
+ * `record → row` tests pass a deterministic stub. No uuid lib, no `@opentelemetry/*`.
+ */
+export interface IdGenerator {
+    /** 32 lowercase-hex chars (16 bytes). */
+    traceId(): string;
+    /** 16 lowercase-hex chars (8 bytes). */
+    spanId(): string;
+}
+/** Production generator: cryptographically-random lowercase-hex ids. */
+export declare const cryptoIdGenerator: IdGenerator;
+//# sourceMappingURL=ids.d.ts.map

package/dist/recording/otel/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/recording/otel/ids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,IAAI,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,WAG/B,CAAC"}

package/dist/recording/otel/ids.js

@@ -0,0 +1,12 @@
+/**
+ * Id generation seam. The wire row shape requires a `TraceId`+`SpanId` per row, so the mapper mints
+ * them. Injecting the generator keeps the row functions pure *given their deps*, so golden
+ * `record → row` tests pass a deterministic stub. No uuid lib, no `@opentelemetry/*`.
+ */
+import { randomBytes } from "node:crypto";
+/** Production generator: cryptographically-random lowercase-hex ids. */
+export const cryptoIdGenerator = {
+    traceId: () => randomBytes(16).toString("hex"),
+    spanId: () => randomBytes(8).toString("hex"),
+};
+//# sourceMappingURL=ids.js.map

package/dist/recording/otel/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/recording/otel/ids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1C,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;CAC7C,CAAC"}

package/dist/recording/otel/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `src/recording/otel/` — the mapper + {@link OtelEmitter}: domain records → HyperDX `TraceRow`/
+ * `LogRow`, then handed to the batcher. A mapper, not a span SDK (no `@opentelemetry/*`).
+ */
+export { OtelEmitter } from "./otel-emitter.js";
+export type { OtelEmitterOptions } from "./otel-emitter.js";
+export { cryptoIdGenerator } from "./ids.js";
+export type { IdGenerator } from "./ids.js";
+export { SCOPE_NAME, SCOPE_VERSION, SPAN_NAME, SEVERITY, ROUTING, severityFor, eventNameFor, } from "./constants.js";
+export type { Severity, RecordRoute } from "./constants.js";
+export { buildResource, mapScannerRun, mapSignalEvaluated, mapPositionLifecycle, mapDslTransition, mapRuntimeError, mapRuntimeLifecycle, mapRuntimeState, } from "./mappers.js";
+export type { MapperDeps, Resource } from "./mappers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recording/otel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recording/otel/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/recording/otel/index.js

@@ -0,0 +1,9 @@
+/**
+ * `src/recording/otel/` — the mapper + {@link OtelEmitter}: domain records → HyperDX `TraceRow`/
+ * `LogRow`, then handed to the batcher. A mapper, not a span SDK (no `@opentelemetry/*`).
+ */
+export { OtelEmitter } from "./otel-emitter.js";
+export { cryptoIdGenerator } from "./ids.js";
+export { SCOPE_NAME, SCOPE_VERSION, SPAN_NAME, SEVERITY, ROUTING, severityFor, eventNameFor, } from "./constants.js";
+export { buildResource, mapScannerRun, mapSignalEvaluated, mapPositionLifecycle, mapDslTransition, mapRuntimeError, mapRuntimeLifecycle, mapRuntimeState, } from "./mappers.js";
+//# sourceMappingURL=index.js.map

package/dist/recording/otel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recording/otel/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/recording/otel/mappers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The mapper: `RecordingRecord → TraceRow[] | LogRow[]`. Pure functions given their deps (identity,
+ * an injected {@link IdGenerator}, scope) — that is what makes the golden `record → row` tests
+ * deterministic. No `@opentelemetry/*`: this builds wire rows, it is not a span SDK.
+ *
+ * Per-record key maps and the trace-vs-log routing are pinned in {@link ./constants} and appended
+ * to the Task 2 brief. Order within a row: redact (typed-field) → flatten → cap.
+ */
+import type { DslTransitionRecord, IdentityEnvelope, PositionLifecycleRecord, RuntimeErrorRecord, RuntimeLifecycleRecord, RuntimeStateRecord, ScannerRunRecord, SignalEvaluatedRecord } from "../index.js";
+import type { LogRow, TraceRow } from "../transport/index.js";
+import type { IdGenerator } from "./ids.js";
+/**
+ * Deps that make the row functions pure: identity envelope, the memoized resource (identity is
+ * immutable for the emitter's lifetime, so it is built once — see {@link buildResource}), the id
+ * seam, and the instrumenting scope.
+ */
+export interface MapperDeps {
+    readonly identity: IdentityEnvelope;
+    readonly resource: Resource;
+    readonly ids: IdGenerator;
+    readonly scopeName: string;
+    readonly scopeVersion: string;
+}
+export interface Resource {
+    readonly resourceAttributes: Record<string, string>;
+    readonly address: string;
+}
+/**
+ * Identity → `ResourceAttributes` (server-required `service.name` included) + the derived `address`.
+ * Built once per emitter and shared (frozen) across every row it produces. `address` is derived from
+ * `identity.strategyAddress` directly — not read back from the attribute map — so a future attr-budget
+ * edge can never silently empty the ownership/keying field.
+ */
+export declare function buildResource(identity: IdentityEnvelope): Resource;
+export declare function mapScannerRun(record: ScannerRunRecord, deps: MapperDeps): TraceRow[];
+export declare function mapSignalEvaluated(record: SignalEvaluatedRecord, deps: MapperDeps): TraceRow[];
+export declare function mapPositionLifecycle(record: PositionLifecycleRecord, deps: MapperDeps): LogRow[];
+export declare function mapDslTransition(record: DslTransitionRecord, deps: MapperDeps): LogRow[];
+export declare function mapRuntimeError(record: RuntimeErrorRecord, deps: MapperDeps): LogRow[];
+export declare function mapRuntimeLifecycle(record: RuntimeLifecycleRecord, deps: MapperDeps): LogRow[];
+export declare function mapRuntimeState(record: RuntimeStateRecord, deps: MapperDeps): LogRow[];
+//# sourceMappingURL=mappers.d.ts.map

package/dist/recording/otel/mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../../../src/recording/otel/mappers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,MAAM,EAIN,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAW/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAU5C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,CAiBlE;AAiGD,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,EAAE,CAgCpF;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,EAAE,CAmD9F;AAuDD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,UAAU,GACf,MAAM,EAAE,CAiCV;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAoCxF;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAYtF;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAa9F;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAatF"}