pond-ts 0.14.2 → 0.15.0

package/dist/LiveFusedRolling.js

@@ -0,0 +1,393 @@
+import { normalizeAggregateColumns, } from './aggregate-columns.js';
+import { Event } from './Event.js';
+import { Time } from './Time.js';
+import { rollingStateFor } from './reducers/index.js';
+import { bucketIndexFor, boundaryTimestampFor, } from './triggers.js';
+import { parseDuration } from './utils/duration.js';
+/**
+ * Multi-window rolling that maintains N windows in one ingest pass
+ * over a single shared deque. Replaces the workaround of multiple
+ * separate `LiveRollingAggregation`s sharing the same source — the
+ * gRPC experiment's V6→V7 profile-diff (PR #19) showed every per-
+ * event pond hop roughly doubled when running two rollings.
+ *
+ * Each declared window has:
+ *  - Its own resolved duration (clipped to retention; see PLAN.md)
+ *  - Its own column-spec list and reducer states
+ *  - Its own head cursor into the shared deque
+ *
+ * Output is ONE merged stream: one event per trigger boundary, with
+ * all windows' columns concatenated into one record. Duplicate
+ * output column names across windows are rejected at construction
+ * with a clear error (compile-time detection is queued as a
+ * follow-up).
+ *
+ * **Single trigger.** All windows share the configured trigger.
+ * Per-window cadence is explicitly NOT supported — that's what
+ * fusion saves. Users who need per-window cadence fall back to two
+ * separate `rolling()` calls and pay the V7 cost.
+ *
+ * **Time-based windows only.** Object keys are duration strings.
+ * Count-based windows stay on the existing single-window
+ * `LiveRollingAggregation`. This constraint keeps the
+ * window-clip-to-retention rule and boundary-detection logic clean.
+ *
+ * Public API: constructed via the `live.rolling(fusedMapping, opts)`
+ * keyed-form overload on `LiveSeries` / `LiveView`. User code
+ * doesn't import this class directly.
+ */
+export class LiveFusedRolling {
+    name;
+    schema;
+    /** Shared deque sized by the longest declared window. */
+    #entries;
+    /** Per-window state, in declared order. */
+    #windows;
+    /**
+     * Longest declared window in ms — bounds the shared deque. Equal
+     * to `max(windows[i].windowMs)`.
+     */
+    #longestWindowMs;
+    /**
+     * Output column specs in declared order — flat union across all
+     * windows. Used to assemble emit records and the output schema.
+     */
+    #emitColumns;
+    #trigger;
+    /**
+     * For clock triggers: the bucket index of the most recently
+     * crossed boundary. Undefined until the first event is ingested.
+     */
+    #lastClockBucketIdx;
+    /**
+     * For count triggers: the number of events ingested since the
+     * most recent emission.
+     */
+    #countSinceLastEmit;
+    #nextIndex;
+    #outputEvents;
+    #onEvent;
+    #unsubscribe;
+    constructor(source, fusedMapping, options = {}) {
+        this.name = source.name;
+        const topMinSamples = options.minSamples ?? 0;
+        if (!Number.isInteger(topMinSamples) || topMinSamples < 0) {
+            throw new TypeError('rolling minSamples must be a non-negative integer (default 0)');
+        }
+        this.#trigger = options.trigger ?? { kind: 'event' };
+        this.#lastClockBucketIdx = undefined;
+        this.#countSinceLastEmit = 0;
+        this.#nextIndex = 0;
+        this.#entries = [];
+        this.#outputEvents = [];
+        this.#onEvent = new Set();
+        // Resolve each window: parse the duration key, normalize the
+        // mapping (handles bare AggregateMap, AggregateOutputMap, and the
+        // elaborated `{ mapping, minSamples }` wrapper), build per-column
+        // reducer state.
+        const windowKeys = Object.keys(fusedMapping);
+        if (windowKeys.length === 0) {
+            throw new TypeError('fused rolling: at least one window must be declared');
+        }
+        const windows = [];
+        let longestMs = 0;
+        for (const key of windowKeys) {
+            const value = fusedMapping[key];
+            const { innerMapping, perWindowMinSamples } = unwrapFusedMappingValue(value);
+            const windowMs = resolveWindowKey(key);
+            if (windowMs > longestMs)
+                longestMs = windowMs;
+            // Reuse the same column-normalisation helper used by the
+            // single-window rolling — keeps reducer-state behavior
+            // identical to today's-shape `LiveRollingAggregation`.
+            const columns = normalizeAggregateColumns(source.schema, innerMapping);
+            const states = columns.map((c) => rollingStateFor(c.reducer));
+            windows.push({
+                id: key,
+                windowMs,
+                columns,
+                states,
+                minSamples: perWindowMinSamples ?? topMinSamples,
+                head: 0,
+            });
+        }
+        this.#windows = windows;
+        this.#longestWindowMs = longestMs;
+        // Build the merged output schema. Reject duplicate output column
+        // names across windows. (Compile-time detection is a follow-up;
+        // runtime check keeps shipping unblocked.)
+        const seenOutputs = new Set();
+        const emitColumns = [];
+        for (const win of this.#windows) {
+            for (const col of win.columns) {
+                if (seenOutputs.has(col.output)) {
+                    throw new TypeError(`fused rolling: duplicate output column '${col.output}' across windows. ` +
+                        `Each output column name must be unique across the merged schema. ` +
+                        `Either rename the alias (use AggregateOutputMap with a distinct \`from\` ` +
+                        `→ alias mapping) or drop one of the duplicating windows.`);
+                }
+                seenOutputs.add(col.output);
+                emitColumns.push(col);
+            }
+        }
+        this.#emitColumns = emitColumns;
+        this.schema = Object.freeze([
+            source.schema[0],
+            ...emitColumns.map((c) => ({
+                name: c.output,
+                kind: c.kind,
+                required: false,
+            })),
+        ]);
+        // Replay the source's existing events through the same ingest
+        // path, so a fused rolling created on a non-empty source matches
+        // the streaming-from-construction shape.
+        for (let i = 0; i < source.length; i++) {
+            this.#ingest(source.at(i));
+        }
+        this.#unsubscribe = source.on('event', (event) => {
+            this.#ingest(event);
+        });
+    }
+    // ── LiveSource<Out> contract ────────────────────────────────
+    get length() {
+        return this.#outputEvents.length;
+    }
+    at(index) {
+        if (index < 0)
+            index = this.#outputEvents.length + index;
+        return this.#outputEvents[index];
+    }
+    /**
+     * Read the current merged snapshot — every window's reducer
+     * outputs concatenated into one record. Useful for live-display
+     * patterns where the consumer wants the latest values without
+     * waiting for the next trigger fire.
+     */
+    value() {
+        const result = {};
+        for (const win of this.#windows) {
+            const warmup = this.#windowSize(win) < win.minSamples;
+            for (let i = 0; i < win.columns.length; i++) {
+                result[win.columns[i].output] = warmup
+                    ? undefined
+                    : win.states[i].snapshot();
+            }
+        }
+        return result;
+    }
+    on(type, fn) {
+        if (type !== 'event') {
+            throw new TypeError(`LiveFusedRolling.on: unsupported event type '${String(type)}'`);
+        }
+        this.#onEvent.add(fn);
+        return () => {
+            this.#onEvent.delete(fn);
+        };
+    }
+    dispose() {
+        this.#unsubscribe();
+    }
+    // ── Private ─────────────────────────────────────────────────
+    /**
+     * Number of events currently in window `w`'s reducer state.
+     * Equals `entries.length - (w.head - frontAbsIdx)` where
+     * `frontAbsIdx = entries[0].absIdx`. Used for minSamples gating.
+     */
+    #windowSize(w) {
+        if (this.#entries.length === 0)
+            return 0;
+        const frontAbsIdx = this.#entries[0].absIdx;
+        return this.#entries.length - (w.head - frontAbsIdx);
+    }
+    #ingest(event) {
+        const data = event.data();
+        const absIdx = this.#nextIndex++;
+        const ts = event.begin();
+        const entry = { absIdx, timestamp: ts, data };
+        this.#entries.push(entry);
+        // Per-window: advance head while leading entries are out-of-window,
+        // then add the new event to every column's reducer state.
+        for (const win of this.#windows) {
+            const cutoff = ts - win.windowMs;
+            while (win.head < absIdx &&
+                this.#getEntry(win.head).timestamp < cutoff) {
+                const old = this.#getEntry(win.head);
+                for (let i = 0; i < win.columns.length; i++) {
+                    win.states[i].remove(old.absIdx, old.data[win.columns[i].source]);
+                }
+                win.head++;
+            }
+            for (let i = 0; i < win.columns.length; i++) {
+                win.states[i].add(absIdx, data[win.columns[i].source]);
+            }
+        }
+        // Compact the shared deque: drop entries before the leftmost
+        // window head. The longest window's head IS this leftmost head
+        // in steady state.
+        this.#compactFront();
+        // Emission gated by the configured trigger.
+        switch (this.#trigger.kind) {
+            case 'event':
+                this.#emitEvent(event.key());
+                return;
+            case 'clock':
+                this.#emitClock(ts, this.#trigger);
+                return;
+            case 'count':
+                this.#emitCount(event.key(), this.#trigger.n);
+                return;
+        }
+    }
+    /**
+     * Translate an absolute event index to its current position in
+     * the shared deque. Returns `undefined` if the entry has been
+     * compacted out of the front.
+     */
+    #getEntry(absIdx) {
+        if (this.#entries.length === 0)
+            return undefined;
+        const front = this.#entries[0].absIdx;
+        const offset = absIdx - front;
+        if (offset < 0 || offset >= this.#entries.length)
+            return undefined;
+        return this.#entries[offset];
+    }
+    /**
+     * Drop entries from the front of the shared deque whose absIdx
+     * is less than every window's head. The longest window's head
+     * defines the leftmost-still-live cursor.
+     *
+     * Uses `Array.shift()` for now (matches today's
+     * `LiveRollingAggregation`); the head-index-pointer ring-buffer
+     * optimization is queued as a separate tactical fix in PLAN.md.
+     */
+    #compactFront() {
+        if (this.#entries.length === 0)
+            return;
+        let minHead = this.#windows[0].head;
+        for (let i = 1; i < this.#windows.length; i++) {
+            const h = this.#windows[i].head;
+            if (h < minHead)
+                minHead = h;
+        }
+        while (this.#entries.length > 0 && this.#entries[0].absIdx < minHead) {
+            this.#entries.shift();
+        }
+    }
+    #emitCount(key, n) {
+        this.#countSinceLastEmit++;
+        if (this.#countSinceLastEmit < n)
+            return;
+        this.#countSinceLastEmit = 0;
+        this.#emitEvent(key);
+    }
+    /**
+     * Build one merged event with every window's reducer snapshot
+     * concatenated into one record, then push to outputs and notify
+     * listeners.
+     */
+    #emitEvent(key) {
+        const record = {};
+        for (const win of this.#windows) {
+            const warmup = this.#windowSize(win) < win.minSamples;
+            for (let i = 0; i < win.columns.length; i++) {
+                record[win.columns[i].output] = warmup
+                    ? undefined
+                    : win.states[i].snapshot();
+            }
+        }
+        const outputEvent = new Event(key, record);
+        this.#outputEvents.push(outputEvent);
+        for (const fn of this.#onEvent)
+            fn(outputEvent);
+    }
+    #emitClock(eventTs, trigger) {
+        const bucketIdx = bucketIndexFor(trigger, eventTs);
+        if (this.#lastClockBucketIdx === undefined) {
+            this.#lastClockBucketIdx = bucketIdx;
+            return;
+        }
+        if (bucketIdx > this.#lastClockBucketIdx) {
+            const boundaryMs = boundaryTimestampFor(trigger, bucketIdx);
+            this.#emitEvent(new Time(boundaryMs));
+            this.#lastClockBucketIdx = bucketIdx;
+        }
+    }
+}
+// ── Helpers (module-private) ──────────────────────────────────
+/**
+ * Resolve a fused-mapping window key (duration string or `'buffer'`
+ * sentinel) to a duration in ms. The `'buffer'` sentinel is reserved
+ * for future use by `live.reduce()` and not yet implemented; throws
+ * a clear error for now.
+ */
+function resolveWindowKey(key) {
+    if (key === 'buffer') {
+        throw new TypeError(`fused rolling: 'buffer' sentinel key is reserved for live.reduce(); ` +
+            `not yet implemented. Use an explicit duration string ` +
+            `(e.g. '1m', '200ms') for now.`);
+    }
+    // parseDuration's input type is `number | DurationString` — at runtime it
+    // throws on bad input. Cast to satisfy the type and let parseDuration
+    // surface a clear error if the key isn't a valid duration string. Wrap
+    // the throw to point at the fused-rolling context.
+    try {
+        return parseDuration(key);
+    }
+    catch {
+        throw new TypeError(`fused rolling: invalid window key '${key}'. Keys must be duration ` +
+            `strings (e.g. '1m', '200ms', '5s'). Count-based windows stay on ` +
+            `the existing single-window overload.`);
+    }
+}
+/**
+ * Peel off the elaborated wrapper if present, returning the inner
+ * mapping and the per-window minSamples (if specified).
+ */
+/**
+ * True when `v` looks like an `AggregateOutputSpec` — i.e., a bare
+ * `{ from: string, using: ... }` shape. Used to disambiguate the
+ * elaborated-wrapper detection: a user with an `AggregateOutputMap`
+ * entry literally named `'mapping'` (e.g. `{ '1m': { mapping: { from:
+ * 'cpu', using: 'avg' } } }`) must NOT be unwrapped as the wrapper.
+ *
+ * The wrapper's `mapping` field carries a whole record of column
+ * specs; the colliding-name AggregateOutputMap entry's `mapping` key
+ * carries one spec. This check distinguishes the two by looking for
+ * the `from` + `using` discriminators that only exist on a spec.
+ */
+function isAggregateOutputSpec(v) {
+    return (v !== null &&
+        typeof v === 'object' &&
+        typeof v.from === 'string' &&
+        'using' in v);
+}
+function unwrapFusedMappingValue(value) {
+    if (value !== null &&
+        typeof value === 'object' &&
+        'mapping' in value &&
+        typeof value.mapping === 'object' &&
+        // Disambiguation: if `.mapping` is itself an AggregateOutputSpec,
+        // the user named an alias `mapping` in an AggregateOutputMap —
+        // this is NOT the elaborated wrapper. Fall through to the bare
+        // mapping branch.
+        !isAggregateOutputSpec(value.mapping)) {
+        const elaborated = value;
+        if (elaborated.minSamples !== undefined) {
+            if (!Number.isInteger(elaborated.minSamples) ||
+                elaborated.minSamples < 0) {
+                throw new TypeError('fused rolling: per-window minSamples must be a non-negative integer');
+            }
+        }
+        return {
+            innerMapping: elaborated.mapping,
+            perWindowMinSamples: elaborated.minSamples,
+        };
+    }
+    return {
+        innerMapping: value,
+        perWindowMinSamples: undefined,
+    };
+}
+//# sourceMappingURL=LiveFusedRolling.js.map

package/dist/LiveFusedRolling.js.map

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

package/dist/LivePartitionedFusedRolling.d.ts

@@ -0,0 +1,65 @@
+import { type ClockTrigger } from './triggers.js';
+import type { EventForSchema, LiveSource, SeriesSchema } from './types.js';
+import type { FusedMapping } from './types-fused-rolling.js';
+type EventListener = (event: any) => void;
+/**
+ * Synchronised partitioned fused multi-window rolling. Maintains N
+ * windows per partition in one ingest pass over a single shared
+ * deque per partition. Driven by a clock trigger; emits a
+ * synchronised burst of one merged event per partition per boundary
+ * crossing.
+ *
+ * **Why fused matters here.** The gRPC experiment's V6→V7 profile-
+ * diff (PR #19) showed that running two separate
+ * `LivePartitionedSyncRolling` instances doubled every per-event
+ * pond hop in inclusive time (`#routeEvent` 15→29%, `ingest`
+ * 12→25%). A single fused rolling does the per-event work once.
+ *
+ * Output schema is `[time, <byColumn>, ...mergedColumns]` — same
+ * partition-column auto-injection as the existing single-window
+ * partitioned sync rolling. Duplicate output column names across
+ * windows are rejected at construction.
+ *
+ * **Single trigger, clock only.** Per-window cadence is not
+ * supported; cross-partition boundary detection requires a single
+ * trigger anyway. Event/count triggers don't make sense for synced
+ * cross-partition emission and are not accepted.
+ *
+ * Public API: constructed via the `partitionBy('host').rolling(
+ * fusedMapping, { trigger })` keyed-form overload on
+ * `LivePartitionedSeries`. User code doesn't import this class
+ * directly.
+ */
+export declare class LivePartitionedFusedRolling<S extends SeriesSchema, K extends string, Out extends SeriesSchema> implements LiveSource<Out> {
+    #private;
+    readonly name: string;
+    readonly schema: Out;
+    /**
+     * @internal — constructed by `LivePartitionedSeries.rolling`'s
+     * keyed-form clock-trigger overload.
+     */
+    constructor(upstreamName: string, byColumn: string, byColumnKind: string, reducerInputSchema: SeriesSchema, fusedMapping: FusedMapping<SeriesSchema>, trigger: ClockTrigger, options?: {
+        minSamples?: number;
+        declaredGroups?: ReadonlyArray<K>;
+    });
+    get length(): number;
+    at(index: number): EventForSchema<Out> | undefined;
+    on(type: 'event', fn: EventListener): () => void;
+    dispose(): void;
+    /**
+     * @internal — used by `LivePartitionedSeries.rolling` to register
+     * each per-partition `'event'` listener disposer so this fused
+     * rolling can detach them on `dispose()`.
+     */
+    _registerUnsubscribe(unsub: () => void): void;
+    /**
+     * Called by `LivePartitionedSeries` for each event arriving on a
+     * partition's `LiveSource`. Updates that partition's per-window
+     * state in one pass, then if the bucket index advances, emits a
+     * synchronised burst of one merged event per known partition at
+     * the new boundary timestamp.
+     */
+    ingest(partitionKey: K, event: EventForSchema<S>): void;
+}
+export {};
+//# sourceMappingURL=LivePartitionedFusedRolling.d.ts.map

package/dist/LivePartitionedFusedRolling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LivePartitionedFusedRolling.d.ts","sourceRoot":"","sources":["../src/LivePartitionedFusedRolling.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAIV,cAAc,EACd,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,0BAA0B,CAAC;AAsChF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AAe1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,2BAA2B,CACtC,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,YAAY,CACxB,YAAW,UAAU,CAAC,GAAG,CAAC;;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAiBrB;;;OAGG;gBAED,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,YAAY,EAChC,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,EACxC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;KAAO;IAuG1E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,SAAS;IAKlD,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAYhD,OAAO,IAAI,IAAI;IAOf;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAM7C;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;CAsKxD"}