@uptimizr/sdk-core 0.1.2 → 0.3.0

package/dist/graphicsDiagnostics.js

@@ -0,0 +1,409 @@
+import { LIMITS } from "@uptimizr/schema";
+const DEFAULT_MAX_ATTEMPTS = 20;
+const DEFAULT_INTERVAL_MS = 250;
+/**
+ * Wire a WebGPU `GPUDevice.lost` into a `graphics_diagnostic` (ADR 0021 part 2,
+ * `category: "device-lost"`). Engine-agnostic: every connector that can have a
+ * WebGPU device hands a device *getter* here, so the gating, severity mapping,
+ * length-cap, and event shape live in exactly one place.
+ *
+ * Behavior:
+ * - **Opt-in gate.** No-ops (nothing scheduled, nothing emitted) unless
+ *   `ctx.config.captureGraphicsDiagnostics` is on. (Unlike `context_lost`, which is
+ *   always-on; device loss is the richer opt-in diagnostic.)
+ * - **Async device init.** A WebGPU backend builds its device asynchronously
+ *   (three's `renderer.init()` / first `renderAsync`, Babylon's `initAsync`), so
+ *   the device is frequently `undefined` at collector `start()` time. We therefore
+ *   take a *getter* and **poll** it (bounded by {@link WireGpuDeviceLostOptions})
+ *   until the device appears, rather than reading once and silently giving up.
+ * - **Severity.** `info` when `reason === "destroyed"` (an expected, app-requested
+ *   loss via `device.destroy()`); `fatal` otherwise (an unrequested loss —
+ *   rendering cannot continue).
+ * - **Marker.** Emits a single discrete incident (no `count`): device loss is rare
+ *   and decisive, so the high-fidelity marker is the right default here.
+ * - **Privacy.** The optional `message` is locally truncated to
+ *   {@link LIMITS.maxGraphicsDiagnosticMessageLength} and rides through `ctx.emit`,
+ *   which applies the client's `beforeSend` for deployer-owned redaction.
+ *
+ * Teardown is cooperative: pass an `isActive` predicate (typically `() => !stopped`).
+ * It is checked before each poll and again when `device.lost` resolves, so neither a
+ * pending poll nor a late device loss emits after the collector has stopped.
+ *
+ * @param ctx Collector context (config + `emit`).
+ * @param getDevice Returns the WebGPU device, or `undefined`/`null` while it is
+ *   still initializing or on WebGL (where it never appears — a clean no-op). Must
+ *   not throw; read the field defensively (optional chaining).
+ * @param isActive Returns `false` once the collector has been torn down.
+ * @param options Polling bounds (mainly for tests).
+ */
+export function wireGpuDeviceLost(ctx, getDevice, isActive, options) {
+    if (!ctx.config.captureGraphicsDiagnostics)
+        return;
+    const maxAttempts = options?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    const intervalMs = options?.intervalMs ?? DEFAULT_INTERVAL_MS;
+    let attempts = 0;
+    const attach = (device) => {
+        const lost = device.lost;
+        if (!lost || typeof lost.then !== "function")
+            return;
+        void lost.then((info) => {
+            if (!isActive())
+                return;
+            const reason = typeof info?.reason === "string" ? info.reason : undefined;
+            const severity = reason === "destroyed" ? "info" : "fatal";
+            const rawMessage = typeof info?.message === "string" ? info.message : undefined;
+            const message = rawMessage
+                ? rawMessage.slice(0, LIMITS.maxGraphicsDiagnosticMessageLength)
+                : undefined;
+            ctx.emit({
+                type: "graphics_diagnostic",
+                severity,
+                category: "device-lost",
+                backend: "webgpu",
+                ...(message ? { message } : {}),
+            });
+        });
+    };
+    const poll = () => {
+        if (!isActive())
+            return;
+        const device = getDevice();
+        if (device) {
+            attach(device);
+            return;
+        }
+        // Device not ready yet (async backend init). Retry on a bounded schedule; the
+        // WebGL path never produces a device, so this simply exhausts and stops.
+        attempts += 1;
+        if (attempts >= maxAttempts)
+            return;
+        setTimeout(poll, intervalMs);
+    };
+    poll();
+}
+export function createDiagnosticRollup(emit) {
+    let count = 0;
+    let first;
+    let timer;
+    const flush = () => {
+        if (count === 0)
+            return;
+        emit(count, first);
+        count = 0;
+        first = undefined;
+    };
+    return {
+        record(value) {
+            if (count === 0)
+                first = value;
+            count += 1;
+        },
+        get count() {
+            return count;
+        },
+        flush,
+        start(intervalMs) {
+            timer = setInterval(flush, intervalMs);
+        },
+        stop() {
+            if (timer)
+                clearInterval(timer);
+            timer = undefined;
+            flush();
+        },
+    };
+}
+const DEFAULT_FLUSH_INTERVAL_MS = 30_000;
+/**
+ * Wire WebGPU `uncapturederror` into a **rate-limited per-session rollup**
+ * (ADR 0021 part 2, decision 4 / ADR 0012). This is the highest-volume diagnostic,
+ * so the default — and only — emission is aggregated: a burst of errors becomes a
+ * single `graphics_diagnostic` carrying `count: N` plus the first message, never N
+ * discrete events. Shared and engine-agnostic so every connector (Babylon, three,
+ * …) hands a device *getter* here and the gating, subtype mapping, length-cap,
+ * aggregation, and flush cadence live in exactly one place.
+ *
+ * Behavior:
+ * - **Opt-in gate.** No-ops unless `ctx.config.captureGraphicsDiagnostics` is on.
+ * - **Async device init.** Polls the getter (bounded, same as {@link wireGpuDeviceLost})
+ *   until the WebGPU device appears, so a backend that builds its device async
+ *   (three `renderer.init()`/`renderAsync`, Babylon `initAsync`) isn't missed.
+ * - **Subtype.** `GPUOutOfMemoryError` → `out-of-memory` (`severity: error`);
+ *   anything else → `validation` (`severity: warning`). The most severe category
+ *   seen wins for the rollup; the first message is kept.
+ * - **Rollup.** Accumulates `count` + first `message` and flushes one event on a
+ *   bounded interval and again at teardown; emits nothing if no error occurred.
+ * - **Privacy.** `message` is truncated to {@link LIMITS.maxGraphicsDiagnosticMessageLength}
+ *   and rides through `ctx.emit` (so `beforeSend` applies); raw shader source is excluded.
+ *
+ * @returns A teardown function that removes the listener, clears the timer, and
+ *   flushes any pending rollup. Connectors call it from `stop()`/dispose.
+ * @param getDevice Returns the WebGPU device, or `undefined`/`null` while it is
+ *   still initializing or on WebGL (a clean no-op). Must not throw.
+ * @param isActive Returns `false` once the collector is torn down — nothing emits after.
+ */
+export function wireGpuUncapturedError(ctx, getDevice, isActive, options) {
+    if (!ctx.config.captureGraphicsDiagnostics)
+        return () => { };
+    const maxAttempts = options?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    const intervalMs = options?.intervalMs ?? DEFAULT_INTERVAL_MS;
+    const flushIntervalMs = options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+    let attempts = 0;
+    let firstMessage;
+    let category = "validation";
+    let device;
+    let listener;
+    const rollup = createDiagnosticRollup((n, first) => {
+        const severity = category === "out-of-memory" ? "error" : "warning";
+        ctx.emit({
+            type: "graphics_diagnostic",
+            severity,
+            category,
+            backend: "webgpu",
+            count: n,
+            ...(first ? { message: first } : {}),
+        });
+        category = "validation";
+    });
+    const attach = (target) => {
+        if (typeof target.addEventListener !== "function")
+            return;
+        device = target;
+        listener = (e) => {
+            if (!isActive())
+                return;
+            const error = e?.error;
+            if (rollup.count === 0) {
+                const raw = typeof error?.message === "string" ? error.message : undefined;
+                firstMessage = raw ? raw.slice(0, LIMITS.maxGraphicsDiagnosticMessageLength) : undefined;
+            }
+            rollup.record(firstMessage);
+            if (error?.constructor?.name === "GPUOutOfMemoryError")
+                category = "out-of-memory";
+        };
+        target.addEventListener("uncapturederror", listener);
+        rollup.start(flushIntervalMs);
+    };
+    const poll = () => {
+        if (!isActive())
+            return;
+        const target = getDevice();
+        if (target) {
+            attach(target);
+            return;
+        }
+        attempts += 1;
+        if (attempts >= maxAttempts)
+            return;
+        setTimeout(poll, intervalMs);
+    };
+    poll();
+    return () => {
+        if (device && listener && typeof device.removeEventListener === "function") {
+            device.removeEventListener("uncapturederror", listener);
+        }
+        rollup.stop();
+    };
+}
+const DEFAULT_MAX_SHADER_INCIDENTS = 25;
+/**
+ * Build a `graphics_diagnostic` for a shader compile/link **failure**. Pure and
+ * redaction-aware: the engine info log is the message (length-capped); raw shader
+ * `source` is appended **only** when the deployer opted in via `captureShaderSource`
+ * (ADR 0021 part 2 — source is application IP). Either way the result is capped to
+ * the schema limit and still rides through `beforeSend`.
+ */
+export function buildShaderCompileDiagnostic(input) {
+    const log = input.infoLog?.trim() ?? "";
+    const includeSource = input.captureShaderSource && input.source ? input.source : "";
+    const raw = includeSource ? `${log}\n${includeSource}`.trim() : log;
+    const message = raw ? raw.slice(0, LIMITS.maxGraphicsDiagnosticMessageLength) : undefined;
+    return {
+        type: "graphics_diagnostic",
+        severity: "error",
+        category: "shader-compile",
+        ...(input.backend ? { backend: input.backend } : {}),
+        ...(message ? { message } : {}),
+    };
+}
+/**
+ * Capture WebGL shader compile and program link **failures** as
+ * `graphics_diagnostic` (`category: shader-compile`). Wraps the context's
+ * `compileShader`/`linkProgram`; on a failed status it reads the matching info log
+ * (and, when `captureShaderSource` is on, the shader source) and emits one capped,
+ * redactable diagnostic. Bounded per session so a build loop cannot flood ingestion.
+ *
+ * Opt-in: no-ops unless `ctx.config.captureGraphicsDiagnostics`. Returns a detach
+ * fn that restores the original methods.
+ */
+export function wireGlShaderDiagnostics(ctx, gl, isActive, options) {
+    if (!ctx.config.captureGraphicsDiagnostics)
+        return () => { };
+    const max = options?.maxIncidents ?? DEFAULT_MAX_SHADER_INCIDENTS;
+    const backend = gl.LINK_STATUS != null ? "webgl2" : "webgl";
+    const wantSource = ctx.config.captureShaderSource;
+    let count = 0;
+    if (typeof gl.compileShader !== "function" || typeof gl.linkProgram !== "function")
+        return () => { };
+    const origCompile = gl.compileShader.bind(gl);
+    const origLink = gl.linkProgram.bind(gl);
+    const emit = (infoLog, source) => {
+        if (!isActive() || count >= max)
+            return;
+        count += 1;
+        ctx.emit(buildShaderCompileDiagnostic({
+            backend,
+            captureShaderSource: wantSource,
+            ...(infoLog ? { infoLog } : {}),
+            ...(source ? { source } : {}),
+        }));
+    };
+    gl.compileShader = function (shader) {
+        origCompile(shader);
+        if (!isActive())
+            return;
+        if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+            const source = wantSource && gl.getShaderSource ? gl.getShaderSource(shader) : undefined;
+            emit(gl.getShaderInfoLog(shader), source ?? undefined);
+        }
+    };
+    gl.linkProgram = function (program) {
+        origLink(program);
+        if (!isActive())
+            return;
+        if (!gl.getProgramParameter(program, gl.LINK_STATUS))
+            emit(gl.getProgramInfoLog(program));
+    };
+    return () => {
+        gl.compileShader = origCompile;
+        gl.linkProgram = origLink;
+    };
+}
+/**
+ * Capture WebGPU shader-module compile errors as `graphics_diagnostic`
+ * (`category: shader-compile`). Wraps `device.createShaderModule` and inspects the
+ * module's async `compilationInfo()` for `error` messages. Source (`descriptor.code`)
+ * is included only when `captureShaderSource` is on. Opt-in + bounded; returns detach.
+ */
+export function wireGpuShaderDiagnostics(ctx, device, isActive, options) {
+    if (!ctx.config.captureGraphicsDiagnostics)
+        return () => { };
+    const max = options?.maxIncidents ?? DEFAULT_MAX_SHADER_INCIDENTS;
+    const wantSource = ctx.config.captureShaderSource;
+    let count = 0;
+    if (typeof device.createShaderModule !== "function")
+        return () => { };
+    const orig = device.createShaderModule.bind(device);
+    device.createShaderModule = function (descriptor) {
+        const module = orig(descriptor);
+        const info = module.getCompilationInfo ?? module.compilationInfo;
+        if (typeof info === "function") {
+            void info.call(module).then((result) => {
+                if (!isActive() || count >= max)
+                    return;
+                const errors = (result?.messages ?? []).filter((m) => m?.type === "error");
+                if (errors.length === 0)
+                    return;
+                count += 1;
+                ctx.emit(buildShaderCompileDiagnostic({
+                    backend: "webgpu",
+                    captureShaderSource: wantSource,
+                    infoLog: errors.map((m) => m.message ?? "").join("\n"),
+                    ...(descriptor?.code ? { source: descriptor.code } : {}),
+                }));
+            });
+        }
+        return module;
+    };
+    return () => {
+        device.createShaderModule = orig;
+    };
+}
+const DEFAULT_GL_ERROR_INTERVAL_MS = 5000;
+const GL_NO_ERROR = 0;
+/**
+ * Opportunistically **sample** `gl.getError()` and emit a rate-limited rollup
+ * `graphics_diagnostic` (`category: validation`, ADR 0021 part 2). Runs on a low-rate
+ * timer — never per-frame, since `getError()` forces a sync GPU stall (ADR forbids it).
+ * Non-`NO_ERROR` results are aggregated into a single `count`ed event flushed on the
+ * next tick (and on teardown), so a storm cannot flood ingestion. WebGPU has no
+ * `getError`, so passing nothing makes this a clean no-op.
+ *
+ * Opt-in: no-ops unless `captureGraphicsDiagnostics`. Returns a detach fn that flushes
+ * any pending rollup and clears the timer.
+ */
+export function wireGlErrorSampling(ctx, gl, isActive, options) {
+    if (!ctx.config.captureGraphicsDiagnostics)
+        return () => { };
+    const intervalMs = options?.intervalMs ?? DEFAULT_GL_ERROR_INTERVAL_MS;
+    const rollup = createDiagnosticRollup((n, first) => {
+        ctx.emit({
+            type: "graphics_diagnostic",
+            severity: "warning",
+            category: "validation",
+            ...(first != null ? { code: `0x${first.toString(16)}` } : {}),
+            count: n,
+        });
+    });
+    const sample = () => {
+        if (!isActive())
+            return;
+        // Drain every pending GL error in one go: `getError()` reports one flag at a
+        // time, so we loop until NO_ERROR to fold a tick's full backlog into the rollup.
+        let code = gl.getError();
+        while (code !== GL_NO_ERROR) {
+            rollup.record(code);
+            code = gl.getError();
+        }
+        rollup.flush();
+    };
+    const timer = setInterval(sample, intervalMs);
+    return () => {
+        clearInterval(timer);
+        rollup.stop();
+    };
+}
+/**
+ * Emit a one-shot context-creation failure as a `graphics_diagnostic`
+ * (ADR 0021 part 2, `category: "context-loss"`, `severity: "fatal"`) when a
+ * connector cannot obtain a rendering context/adapter at init. Engine-agnostic:
+ * every connector reduces its backend-specific check to a {@link ContextCreationProbe}
+ * so the gating, length-cap, and event shape live in exactly one place.
+ *
+ * Behavior:
+ * - **Opt-in gate.** No-ops unless `ctx.config.captureGraphicsDiagnostics` is on
+ *   (mirroring {@link wireGpuDeviceLost}; `context_lost` runtime loss stays
+ *   always-on, this *creation* case is the richer opt-in diagnostic).
+ * - **Discrete marker.** Emits a single incident with no `count`: a creation
+ *   failure is rare and decisive, so the high-fidelity marker is the right default.
+ * - **Backend.** `unknown` when the connector can't determine which API failed
+ *   (no context means little to introspect).
+ * - **Ordering.** Connectors call this at `start()`. The client sets `started`
+ *   before running collectors, so the marker queues right after `session_start`
+ *   and is flushed by the normal cadence even though no transport round-trip has
+ *   happened yet.
+ * - **Privacy.** Any `message` is truncated to
+ *   {@link LIMITS.maxGraphicsDiagnosticMessageLength} and rides `ctx.emit`, which
+ *   applies the client's `beforeSend` for deployer-owned redaction.
+ *
+ * @param ctx Collector context (config + `emit`).
+ * @param probe The connector's context-creation result. Must not throw; read the
+ *   engine defensively (optional chaining) and pass `{ failed: false }` on doubt.
+ */
+export function wireContextCreationFailure(ctx, probe) {
+    if (!ctx.config.captureGraphicsDiagnostics)
+        return;
+    if (!probe.failed)
+        return;
+    const message = probe.message
+        ? probe.message.slice(0, LIMITS.maxGraphicsDiagnosticMessageLength)
+        : undefined;
+    ctx.emit({
+        type: "graphics_diagnostic",
+        severity: "fatal",
+        category: "context-loss",
+        backend: probe.backend ?? "unknown",
+        ...(message ? { message } : {}),
+    });
+}
+//# sourceMappingURL=graphicsDiagnostics.js.map

package/dist/graphicsDiagnostics.js.map

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

package/dist/index.d.ts

@@ -15,9 +15,15 @@ export { classifyCameraGesture, DEFAULT_GESTURE_THRESHOLDS } from "./gesture.js"
 export { CANONICAL_FRAME, toCanonicalAabb, toCanonicalDirection, toCanonicalPosition, toCanonicalQuat, fromCanonicalAabb, fromCanonicalDirection, fromCanonicalPosition, fromCanonicalQuat, } from "./coordinates.js";
 export { decomposeWorldMatrix } from "./matrix.js";
 export type { DecomposedTransform } from "./matrix.js";
+export { createAggregator, collectSnapshotTransferables, percentileAsc, visibilityContribution, aabbClose, roundAabb, vec3Close, poseUnchanged, nodeSampleUnchanged, clamp01, } from "./aggregation/index.js";
+export type { Aggregator, AggregatorConfig, AggregatorOptions, Snapshot, SnapshotChannel, CameraSnapshot, PerfSnapshot, NodeSnapshot, VisibilityMeshObservation, VisibilityTickSnapshot, VisibilityFlushSnapshot, GestureSnapshot, HoverSnapshot, VisibilityContribution, CameraPose, NodeSample, } from "./aggregation/index.js";
 export { xrSource, xrHandedness } from "./xrInput.js";
+export { wireGpuDeviceLost, wireGpuUncapturedError, wireContextCreationFailure, wireGlShaderDiagnostics, wireGpuShaderDiagnostics, wireGlErrorSampling, buildShaderCompileDiagnostic, createDiagnosticRollup, } from "./graphicsDiagnostics.js";
+export type { GpuDeviceLostLike, GpuDeviceLostInfoLike, WireGpuDeviceLostOptions, GpuErrorLike, GpuDeviceErrorTargetLike, WireGpuUncapturedErrorOptions, ContextCreationProbe, DiagnosticRollup, ShaderDiagnosticsOptions, GlErrorSamplingOptions, WebGlShaderContextLike, WebGpuShaderDeviceLike, WebGlErrorContextLike, } from "./graphicsDiagnostics.js";
 export type { Collector, CollectorContext, CollectorHandle, BeforeSendHook, EventInput, ResolvedConfig, StartMeta, TrackInputOptions, CapabilityChangeReport, Transport, UptimizrConfig, } from "./types.js";
 export type { Processor, WorkerLike, WorkerFactory, WorkerProcessorOptions } from "./processor.js";
+export { createMainSink, createWorkerAggregationSink } from "./aggregationSink.js";
+export type { AggregationSink, WorkerAggregationSinkOptions } from "./aggregationSink.js";
 export type { SampleRate, SamplingProfile, BoneSamplingConfig, NodeSamplingConfig, ResolvedCadence, } from "./sampling.js";
 export type { CameraGestureSample, ClassifiedGesture, GestureThresholds, GestureClassifyOptions, } from "./gesture.js";
 export type { XrInputSourceLike, XrCaptureOptions, XrRayHit, XrRayProbe } from "./xrInput.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEnG,YAAY,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC5B,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,OAAO,GACR,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,UAAU,EACV,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,YAAY,EACZ,wBAAwB,EACxB,6BAA6B,EAC7B,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAE1F,YAAY,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -14,5 +14,8 @@ export { resolveCadence } from "./sampling.js";
 export { classifyCameraGesture, DEFAULT_GESTURE_THRESHOLDS } from "./gesture.js";
 export { CANONICAL_FRAME, toCanonicalAabb, toCanonicalDirection, toCanonicalPosition, toCanonicalQuat, fromCanonicalAabb, fromCanonicalDirection, fromCanonicalPosition, fromCanonicalQuat, } from "./coordinates.js";
 export { decomposeWorldMatrix } from "./matrix.js";
+export { createAggregator, collectSnapshotTransferables, percentileAsc, visibilityContribution, aabbClose, roundAabb, vec3Close, poseUnchanged, nodeSampleUnchanged, clamp01, } from "./aggregation/index.js";
 export { xrSource, xrHandedness } from "./xrInput.js";
+export { wireGpuDeviceLost, wireGpuUncapturedError, wireContextCreationFailure, wireGlShaderDiagnostics, wireGpuShaderDiagnostics, wireGlErrorSampling, buildShaderCompileDiagnostic, createDiagnosticRollup, } from "./graphicsDiagnostics.js";
+export { createMainSink, createWorkerAggregationSink } from "./aggregationSink.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC5B,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,OAAO,GACR,MAAM,wBAAwB,CAAC;AAmBhC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAgClC,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/offloadProtocol.d.ts

@@ -1,17 +1,25 @@
 import type { CollectRequest } from "@uptimizr/schema";
+import type { AggregatorConfig } from "./aggregation/aggregator.js";
+import type { Snapshot } from "./aggregation/snapshot.js";
+import type { EventInput } from "./types.js";
 /**
  * Wire protocol for the opt-in offload worker (ADR 0031).
  *
  * These are **type-only** definitions shared by the main-thread processor
- * ([`processor.ts`](./processor.ts)) and the worker entry
+ * ([`processor.ts`](./processor.ts)), the aggregation sink
+ * ([`aggregationSink.ts`](./aggregationSink.ts)) and the worker entry
  * ([`offloadWorker.ts`](./offloadWorker.ts)). Keeping the protocol in its own
  * module (with no runtime exports) means the worker bundle pulls in none of the
- * processor's runtime code — it stays tiny.
+ * main-thread runtime code — it stays tiny.
  *
- * The only thing that crosses the boundary is the plain-data `CollectRequest`
- * DTO: by the time a batch reaches the worker it is an array of Zod-shaped plain
- * objects with no engine/DOM handles, so it travels by structured clone (or, for
- * buffer-backed fields, by transfer).
+ * Two roles cross the boundary:
+ * - **Transport** (#93–99): a finalized plain-data `CollectRequest` batch travels
+ *   to the worker to be serialized + dispatched; only an ack comes back.
+ * - **Aggregation** (#10): raw plain-number {@link Snapshot} DTOs travel to the
+ *   worker (high-volume channels by transfer), are aggregated worker-side into
+ *   finalized {@link EventInput}s, and those come back to the page for the
+ *   envelope/`beforeSend`/queue/transport machinery — so the unload guarantee
+ *   (ADR 0031 §5) and `beforeSend` (a main-thread closure) are preserved.
  */
 /** Sets the collector URL the worker dispatches to. Sent once at construction. */
 export interface WorkerInitMessage {
@@ -27,14 +35,50 @@ export interface WorkerBatchMessage {
     /** The plain-data batch to serialize and send. */
     batch: CollectRequest;
 }
+/** Configures the worker-resident aggregator. Sent once at construction. */
+export interface WorkerAggInitMessage {
+    type: "aggInit";
+    /** Serializable per-channel aggregation config (no callbacks/handles). */
+    config: AggregatorConfig;
+}
+/** A raw snapshot DTO to aggregate worker-side (ADR 0031 follow-up, #10). */
+export interface WorkerSnapshotMessage {
+    type: "snapshot";
+    /** Capture timestamp (epoch ms) stamped on the page; carried onto emitted events. */
+    capturedAt: number;
+    /** The plain-number snapshot to ingest. */
+    snapshot: Snapshot;
+}
+/**
+ * Drain barrier for the terminal unload flush (ADR 0031 §5). Because
+ * `postMessage` is ordered, by the time the worker echoes this back every prior
+ * snapshot's finalized events have already been posted to the page.
+ */
+export interface WorkerFlushUnloadMessage {
+    type: "flushUnload";
+    id: number;
+}
 /** Messages the main thread sends to the worker. */
-export type WorkerInbound = WorkerInitMessage | WorkerBatchMessage;
+export type WorkerInbound = WorkerInitMessage | WorkerBatchMessage | WorkerAggInitMessage | WorkerSnapshotMessage | WorkerFlushUnloadMessage;
 /** The delivery result for one batch, reported back to the main thread. */
 export interface WorkerResultMessage {
     type: "result";
     id: number;
     ok: boolean;
 }
+/** Finalized events produced by the worker-resident aggregator (#10). */
+export interface WorkerEventsMessage {
+    type: "events";
+    /** The `capturedAt` of the snapshot that produced these events (for `ts`). */
+    capturedAt: number;
+    /** Finalized, envelope-less events to emit on the page. */
+    events: EventInput[];
+}
+/** Ack that the unload drain barrier has been reached (#10). */
+export interface WorkerUnloadDoneMessage {
+    type: "unloadDone";
+    id: number;
+}
 /** Messages the worker sends back to the main thread. */
-export type WorkerOutbound = WorkerResultMessage;
+export type WorkerOutbound = WorkerResultMessage | WorkerEventsMessage | WorkerUnloadDoneMessage;
 //# sourceMappingURL=offloadProtocol.d.ts.map

package/dist/offloadProtocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offloadProtocol.d.ts","sourceRoot":"","sources":["../src/offloadProtocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AAEH,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEnE,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;CACb;AAED,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"offloadProtocol.d.ts","sourceRoot":"","sources":["../src/offloadProtocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,oDAAoD;AACpD,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,CAAC;AAE7B,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;CACb;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC"}

package/dist/offloadWorker.js

@@ -1,18 +1,50 @@
+import { createAggregator } from "./aggregation/aggregator.js";
 // The build uses the DOM lib (not WebWorker), so narrow `self` structurally.
 const scope = self;
 /** Resolved collector URL, set by the `init` message before any batch arrives. */
 let collectUrl = "";
+/** Worker-resident aggregator, created on `aggInit`. Buffers events per ingest. */
+let aggregator;
+let eventBuffer = [];
 scope.addEventListener("message", (event) => {
     const message = event.data;
     if (!message) {
         return;
     }
-    if (message.type === "init") {
-        collectUrl = message.url;
-        return;
-    }
-    if (message.type === "batch") {
-        void dispatch(message.id, message.batch);
+    switch (message.type) {
+        case "init":
+            collectUrl = message.url;
+            return;
+        case "batch":
+            void dispatch(message.id, message.batch);
+            return;
+        case "aggInit":
+            aggregator = createAggregator({
+                ...message.config,
+                emit: (e) => eventBuffer.push(e),
+            });
+            return;
+        case "snapshot": {
+            if (!aggregator)
+                return;
+            eventBuffer = [];
+            aggregator.ingest(message.snapshot);
+            if (eventBuffer.length > 0) {
+                const out = {
+                    type: "events",
+                    capturedAt: message.capturedAt,
+                    events: eventBuffer,
+                };
+                eventBuffer = [];
+                scope.postMessage(out);
+            }
+            return;
+        }
+        case "flushUnload": {
+            const done = { type: "unloadDone", id: message.id };
+            scope.postMessage(done);
+            return;
+        }
     }
 });
 /** Serialize and POST one batch, then report the outcome back to the page. */
@@ -37,5 +69,4 @@ async function dispatch(id, batch) {
     const result = { type: "result", id, ok };
     scope.postMessage(result);
 }
-export {};
 //# sourceMappingURL=offloadWorker.js.map

package/dist/offloadWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"offloadWorker.js","sourceRoot":"","sources":["../src/offloadWorker.ts"],"names":[],"mappings":"AAuBA,6EAA6E;AAC7E,MAAM,KAAK,GAAG,IAA8B,CAAC;AAE7C,kFAAkF;AAClF,IAAI,UAAU,GAAG,EAAE,CAAC;AAEpB,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAiC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;QACzB,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,KAAK,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,KAAc;IAChD,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,IAAI,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE;gBACxC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI;gBACJ,yEAAyE;gBACzE,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM;aAChC,CAAC,CAAC;YACH,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,GAAG,KAAK,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC/D,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"offloadWorker.js","sourceRoot":"","sources":["../src/offloadWorker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,6BAA6B,CAAC;AAkChF,6EAA6E;AAC7E,MAAM,KAAK,GAAG,IAA8B,CAAC;AAE7C,kFAAkF;AAClF,IAAI,UAAU,GAAG,EAAE,CAAC;AAEpB,mFAAmF;AACnF,IAAI,UAAkC,CAAC;AACvC,IAAI,WAAW,GAAiB,EAAE,CAAC;AAEnC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAiC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;YACzB,OAAO;QACT,KAAK,OAAO;YACV,KAAK,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO;QACT,KAAK,SAAS;YACZ,UAAU,GAAG,gBAAgB,CAAC;gBAC5B,GAAG,OAAO,CAAC,MAAM;gBACjB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;aACjC,CAAC,CAAC;YACH,OAAO;QACT,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxB,WAAW,GAAG,EAAE,CAAC;YACjB,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAwB;oBAC/B,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,WAAW;iBACpB,CAAC;gBACF,WAAW,GAAG,EAAE,CAAC;gBACjB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;YAC7E,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,KAAc;IAChD,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,IAAI,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE;gBACxC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI;gBACJ,yEAAyE;gBACzE,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM;aAChC,CAAC,CAAC;YACH,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,GAAG,KAAK,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC/D,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/processor.d.ts

@@ -88,6 +88,8 @@ export interface WorkerProcessorOptions {
  * channels that opt in must own a fresh buffer per batch.
  */
 export declare function collectTransferables(batch: CollectRequest): Transferable[];
+/** Default factory: a module worker shipped alongside the SDK in `dist/`. */
+export declare function defaultWorkerFactory(): WorkerLike;
 /**
  * Create a worker-backed processor that runs steady-state serialization +
  * dispatch off the main thread (ADR 0031). Returns `null` when a worker cannot