@synnaxlabs/client 0.56.2 → 0.57.0

package/dist/src/framer/cache/dynamic.d.ts

@@ -0,0 +1,71 @@
+import { alamos } from '@synnaxlabs/alamos';
+import { MultiSeries, Series, TimeSpan, TimeStamp } from '@synnaxlabs/x';
+import { Transform } from './transform';
+/** Response from a write to the {@link Dynamic} cache. */
+export interface WriteResponse {
+    /** Series flushed because the write did not fit in the current buffer. */
+    flushed: MultiSeries;
+    /** A list of series that were allocated during the write. */
+    allocated: MultiSeries;
+}
+/** Props for the {@link Dynamic} cache. */
+export interface DynamicProps {
+    /**
+     * Sets the maximum size of the buffer that the cache will maintain before flushing
+     * data out to the caller.
+     */
+    dynamicBufferSize: number | TimeSpan;
+    /** Applied to every series before it enters a buffer. Defaults to identity. */
+    transform?: Transform;
+    /** Used for logging. */
+    instrumentation?: alamos.Instrumentation;
+    /** Pulls the current time. */
+    now?: () => TimeStamp;
+}
+/**
+ * A cache for channel data that maintains a single, rolling Series as a buffer
+ * for channel data. The buffer's data type is derived from the first written series,
+ * so the cache needs no channel metadata.
+ */
+export declare class Dynamic {
+    private readonly props;
+    private counter;
+    private curr;
+    /** End timestamp of the last fully written stamped series in the current buffer.
+     * Null when the buffer holds unstamped or partially written data, in which case
+     * the flush falls back to the wall clock. */
+    private currDataEnd;
+    private avgRate;
+    private timeOfLastWrite;
+    private totalWrites;
+    private readonly now;
+    constructor(props: DynamicProps);
+    /** @returns the number of samples currently held in the cache. */
+    get length(): number;
+    /**
+     * @returns the current buffer being written to by the cache. Under no circumstances
+     * should this be modified by the caller.
+     */
+    get leadingBuffer(): Series | null;
+    /**
+     * @returns a list of buffers that were filled by the cache during the write. If the
+     * current buffer is able to fit all writes, no buffers will be returned.
+     */
+    write(series: MultiSeries): WriteResponse;
+    private allocate;
+    private allocStart;
+    private allocCurr;
+    private flushCurr;
+    private _write;
+    private updateAvgRate;
+    private nextBufferSize;
+    /**
+     * Flushes the leading buffer, stamping its end with the last stamped write or
+     * the wall clock.
+     * @returns the flushed buffer, or null when there is none.
+     */
+    flush(): Series | null;
+    /** Closes the cache. It must not be used afterwards. */
+    close(): void;
+}
+//# sourceMappingURL=dynamic.d.ts.map

package/dist/src/framer/cache/dynamic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../../../../src/framer/cache/dynamic.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAGL,WAAW,EACX,MAAM,EACN,KAAK,QAAQ,EACb,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE9E,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,EAAE,WAAW,CAAC;IACrB,6DAA6D;IAC7D,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC;IACrC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC;IACzC,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,SAAS,CAAC;CACvB;AAYD;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,IAAI,CAAuB;IACnC;;iDAE6C;IAC7C,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;gBAE1B,KAAK,EAAE,YAAY;IAY/B,kEAAkE;IAClE,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAUzC,OAAO,CAAC,QAAQ;IAgChB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,MAAM;IAmEd,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,cAAc;IAQtB;;;;OAIG;IACH,KAAK,IAAI,MAAM,GAAG,IAAI;IAStB,wDAAwD;IACxD,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/framer/cache/reader.d.ts

@@ -0,0 +1,43 @@
+import { MultiSeries, TimeRange, TimeSpan } from '@synnaxlabs/x';
+import { channel } from '../../channel';
+import { Cache } from './cache';
+import { Frame } from '../frame';
+/** A function that reads a telemetry frame from the Synnax cluster. */
+export interface RemoteReader {
+    (tr: TimeRange, keys: channel.Key[]): Promise<Frame>;
+}
+export interface ReaderProps {
+    /** Function used to read remote data from the server. */
+    readRemote: RemoteReader;
+    /** Will read from and populate the given cache with fetched data. */
+    cache: Cache;
+    /**
+     * Used to batch read requests to the server to minimize traffic. The window is not
+     * extended by later reads, so it is also the maximum wait before a batch fires.
+     * @default TimeSpan.milliseconds(50)
+     */
+    batchDebounce?: TimeSpan;
+    /**
+     * Reads whose gap time ranges are within this threshold merge into one request.
+     * @default TimeSpan.milliseconds(5)
+     */
+    overlapThreshold?: TimeSpan;
+}
+/**
+ * Reads historical telemetry, serving from the cache and batch-filling gaps from the
+ * server. A batch failure rejects only the reads whose gaps were in the failed fetch.
+ */
+export declare class Reader {
+    private readonly props;
+    private readonly batcher;
+    private readonly mu;
+    constructor(props: ReaderProps);
+    /**
+     * Reads the given time range for the given channel.
+     * @throws {UnexpectedError} if the reader is closed while the read is pending.
+     */
+    read(tr: TimeRange, channel: channel.Key): Promise<MultiSeries>;
+    private batchRead;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/src/framer/cache/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../../src/framer/cache/reader.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,WAAW,EAGX,SAAS,EACT,QAAQ,EACT,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACtD;AAaD,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,UAAU,EAAE,YAAY,CAAC;IACzB,qEAAqE;IACrE,KAAK,EAAE,KAAK,CAAC;IACb;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,QAAQ,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAExD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoC;gBAE3C,KAAK,EAAE,WAAW;IAkB9B;;;OAGG;IACG,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;YAUvD,SAAS;IAsDjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/src/framer/cache/static.d.ts

@@ -0,0 +1,66 @@
+import { alamos } from '@synnaxlabs/alamos';
+import { MultiSeries, Size, TimeRange, TimeSpan } from '@synnaxlabs/x';
+import { Transform } from './transform';
+export interface DirtyReadResult {
+    series: MultiSeries;
+    gaps: TimeRange[];
+}
+export interface GCMetrics {
+    purgedSeries: number;
+    purgedBytes: Size;
+}
+export declare const zeroGCMetrics: () => GCMetrics;
+/** Props for the {@link Static} cache. */
+export interface StaticProps {
+    /** Used for logging */
+    instrumentation?: alamos.Instrumentation;
+    /** Applied to every series before it enters the cache. Defaults to identity. */
+    transform?: Transform;
+    /**
+     * Sets the amount of time that a cache entry must be in the cache before it can
+     * be marked as stale and subject to garbage collection.
+     * @default TimeSpan.seconds(20) */
+    staleEntryThreshold?: TimeSpan;
+}
+export declare const DEFAULT_STATIC_PROPS: Required<StaticProps>;
+/**
+ * A cache for historical channel data that will not be modified after it is written.
+ * Fetched and streamed entries are held apart because they measure position in
+ * different spaces: a fetched sample carries its committed alignment, the same sample
+ * streamed carries a provisional leading one. Insertion and gap computation both assume
+ * a single space, so each kind gets its own list.
+ */
+export declare class Static {
+    private fetched;
+    private streamed;
+    private readonly props;
+    constructor(props: StaticProps);
+    /**
+     * Writes the given series to the cache, merging written series with any existing
+     * series in the cache.
+     * @param streamed - Marks the series as live-streamed data. A fetched write evicts
+     * every streamed entry whose time range it fully covers.
+     */
+    write(series: MultiSeries, streamed?: boolean): void;
+    private evictStreamed;
+    /**
+     * Executes a 'dirty' read of the cache, retrieving any series in the cache that
+     * overlap with the given time range. The series may extend before or after the range.
+     * Gaps are computed against fetched entries only. Streamed entries carry provisional
+     * leading alignments that cannot pair with fetched data on another channel, so they
+     * never claim coverage; the fetch they provoke evicts them.
+     * @returns A list of series that overlap with the given time range and a list of
+     * gaps, representing the regions of time the fetched series do not cover.
+     */
+    dirtyRead(tr: TimeRange): DirtyReadResult;
+    /**
+     * Garbage collects the cache, removing any stale entries.
+     * @returns metrics about the garbage collection.
+     */
+    gc(): GCMetrics;
+    /** Closes the cache, freeing all of its resources. */
+    close(): void;
+    private writeOne;
+    private repairIntegrity;
+}
+//# sourceMappingURL=static.d.ts.map

package/dist/src/framer/cache/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../../src/framer/cache/static.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAEL,WAAW,EAEX,IAAI,EACJ,SAAS,EACT,QAAQ,EAET,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,QAAO,SAG/B,CAAC;AAEH,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC;IACzC,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;uCAGmC;IACnC,mBAAmB,CAAC,EAAE,QAAQ,CAAC;CAChC;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAItD,CAAC;AASF;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAElC,KAAK,EAAE,WAAW;IAS9B;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAE,OAAe,GAAG,IAAI;IAY3D,OAAO,CAAC,aAAa;IAWrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,eAAe;IAkBzC;;;OAGG;IACH,EAAE,IAAI,SAAS;IAmBf,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,eAAe;CAsBxB"}

package/dist/src/framer/cache/streamer.d.ts

@@ -0,0 +1,86 @@
+import { alamos } from '@synnaxlabs/alamos';
+import { breaker, CrudeTimeSpan, destructor, MultiSeries } from '@synnaxlabs/x';
+import { channel } from '../../channel';
+import { Cache } from './cache';
+import { Streamer, StreamerConfig } from '../streamer';
+import { status } from '../../status';
+/** Stream lifecycle hooks the streamer uses to track connection health. */
+export interface StreamHooks {
+    /** Called after every successful reconnect of the underlying stream. */
+    onReopen: () => void;
+    /** Called when the underlying stream fails and reconnection begins. */
+    onDrop: (error: Error) => void;
+}
+/** Opens the underlying frame stream, hardened against connection loss. */
+export interface HardenedOpener {
+    (config: StreamerConfig, hooks: StreamHooks): Promise<Streamer>;
+}
+/**
+ * Receives every channel that changed on the shared stream, which may include
+ * keys the handler did not subscribe to.
+ */
+export type StreamHandler = (data: Map<channel.Key, MultiSeries>) => void;
+/** Receives per-key data-plane status transitions for subscribed channels. */
+export type StatusHandler = (key: channel.Key, status: status.Status) => void;
+/**
+ * A durable handle on streaming demand. Closing it releases the demand; until then
+ * the streamer owns converging the underlying stream to it.
+ */
+export interface Subscription {
+    /** Releases the subscription's demand. */
+    close: () => void;
+    /** @returns the current data-plane status for the given key. */
+    status: (key: channel.Key) => status.Status;
+    /** Registers a handler for status transitions on the subscription's keys. */
+    onStatusChange: (handler: StatusHandler) => destructor.Destructor;
+}
+export interface MultiplexedStreamerProps {
+    cache: Cache;
+    openStreamer: HardenedOpener;
+    instrumentation?: alamos.Instrumentation;
+    /**
+     * How long a closed subscription's keys stay on the stream, damping churn from
+     * rapid unsubscribe and resubscribe cycles.
+     * @default TimeSpan.seconds(5)
+     */
+    removalDelay?: CrudeTimeSpan;
+    /** Retry behavior for stream open and update failures. */
+    breaker?: breaker.Config;
+}
+/**
+ * Multiplexes durable subscriptions onto one shared frame stream. Demand
+ * registration is synchronous and cannot fail per key; all convergence work
+ * surfaces as per-key statuses instead of thrown errors.
+ */
+export declare class MultiplexedStreamer {
+    private readonly props;
+    private readonly connMu;
+    private readonly breaker;
+    private readonly entries;
+    private readonly statuses;
+    private reconcileTimer;
+    private readonly removalTimers;
+    private runLoop;
+    private streamer;
+    private sentKeys;
+    constructor(props: MultiplexedStreamerProps);
+    /**
+     * Registers demand for the given keys. Registration is synchronous: the handler
+     * is called with any existing leading buffers, and the stream converges to the
+     * new demand in the background.
+     * @throws {UnexpectedError} if the streamer has been closed.
+     */
+    stream(handler: StreamHandler, keys: channel.Key[]): Subscription;
+    close(): Promise<void>;
+    private releaseStream;
+    private remove;
+    private scheduleReconcile;
+    /** @returns the union of keys across all entries, including those pending
+     * removal, so the stream lags demand only by the removal delay. */
+    private desiredKeys;
+    private setStatus;
+    private flushBuffers;
+    private reconcile;
+    private run;
+}
+//# sourceMappingURL=streamer.d.ts.map

package/dist/src/framer/cache/streamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamer.d.ts","sourceRoot":"","sources":["../../../../src/framer/cache/streamer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAEL,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,WAAW,EAKZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,uEAAuE;IACvE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACjE;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;AAE1E,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,KAAK,MAAM,CAAC,MAAM,CAAC;IAC5C,6EAA6E;IAC7E,cAAc,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,UAAU,CAAC,UAAU,CAAC;CACnE;AASD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,cAAc,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC;IACzC;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC;CAC1B;AAYD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAIpB;IAIF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAyB;IAGzC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,KAAK,EAAE,wBAAwB;IA6B3C;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY;IAmC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBd,aAAa;IAS3B,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,iBAAiB;IAQzB;uEACmE;IACnE,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,YAAY;YAKN,SAAS;YAwET,GAAG;CAiDlB"}

package/dist/src/framer/cache/transform.d.ts

@@ -0,0 +1,18 @@
+import { DataType, math, Series } from '@synnaxlabs/x';
+/**
+ * Converts series into the representation the caller renders from before they enter
+ * cache buffers. Injected at construction; the cache applies it to every write.
+ */
+export interface Transform {
+    /** @returns the buffer data type used to hold series of the given type. */
+    resolveDataType: (dt: DataType) => DataType;
+    /**
+     * Converts the series to the resolved data type.
+     * @param offset - Subtracted from each sample before narrowing conversions to
+     * preserve precision. Omitted when the buffer anchors off the first sample.
+     */
+    convert: (series: Series, offset?: math.Numeric) => Series;
+}
+/** A transform that stores every series exactly as it arrives. */
+export declare const IDENTITY_TRANSFORM: Transform;
+//# sourceMappingURL=transform.d.ts.map

package/dist/src/framer/cache/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../src/framer/cache/transform.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,eAAe,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,QAAQ,CAAC;IAC5C;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC;CAC5D;AAED,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,EAAE,SAGhC,CAAC"}

package/dist/src/framer/cache/unary.d.ts

@@ -0,0 +1,37 @@
+import { MultiSeries, Series, TimeRange } from '@synnaxlabs/x';
+import { DynamicProps } from './dynamic';
+import { DirtyReadResult, GCMetrics, StaticProps } from './static';
+export interface UnaryProps extends StaticProps, Pick<DynamicProps, "dynamicBufferSize"> {
+}
+/**
+ * Caches data for a single channel: a dynamic leading buffer for live writes backed
+ * by a static cache for flushed and historical data.
+ * @throws {UnexpectedError} from every method after close().
+ */
+export declare class Unary {
+    private closed;
+    private readonly static;
+    private readonly dynamic;
+    constructor(props: UnaryProps);
+    writeDynamic(series: MultiSeries): MultiSeries;
+    get leadingBuffer(): Series | null;
+    /**
+     * Flushes the live leading buffer into the static cache with its real end time,
+     * so reads treat the span after it as a gap to fetch. Call when streaming for
+     * the channel stops.
+     */
+    flushDynamic(): void;
+    writeStatic(series: MultiSeries): void;
+    /**
+     * Reads cached data overlapping the given time range. The result includes the
+     * live leading buffer when it overlaps, but the buffer never claims coverage:
+     * its samples carry provisional leading alignments that cannot pair with fetched
+     * data on another channel, so its span is still reported as a gap to fetch. A
+     * span may therefore return in both its streamed and fetched representation.
+     */
+    read(tr: TimeRange): DirtyReadResult;
+    gc(): GCMetrics;
+    close(): void;
+    private checkOpen;
+}
+//# sourceMappingURL=unary.d.ts.map

package/dist/src/framer/cache/unary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unary.d.ts","sourceRoot":"","sources":["../../../../src/framer/cache/unary.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,UACf,SAAQ,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC;CAAG;AAEjE;;;;GAIG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,KAAK,EAAE,UAAU;IAS7B,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAQ9C,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAGjC;IAED;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAOpB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKtC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,eAAe;IASpC,EAAE,IAAI,SAAS;IAKf,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,SAAS;CAIlB"}

package/dist/src/framer/client.d.ts

@@ -1,6 +1,8 @@
 import { UnaryClient, WebSocketClient } from '@synnaxlabs/freighter';
 import { CrudeSeries, CrudeTimeRange, CrudeTimeStamp, MultiSeries } from '@synnaxlabs/x';
 import { channel } from '../channel';
+import { ChannelRetriever } from './adapter';
+import { Feed, FeedOptions } from './feed';
 import { Frame } from './frame';
 import { Iterator, IteratorConfig } from './iterator';
 import { ReadRequest } from './reader';
@@ -9,22 +11,30 @@ import { Writer, WriterConfig } from './writer';
 import { ontology } from '../ontology';
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "policy" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view" | "workspace";
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
     key: string;
 } | {
-    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "policy" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view" | "workspace";
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
     key: string;
 };
+/** Config for {@link Client}. */
+export interface ClientConfig {
+    stream: WebSocketClient;
+    unary: UnaryClient;
+    retrieveChannels: ChannelRetriever;
+}
+/**
+ * Reads and writes telemetry on a Core. Reach it through `client.telem` rather than
+ * building one: `read` and `write` cover one-shot access, and the `open*` methods hand
+ * back a long-lived stream the caller must close.
+ */
 export declare class Client {
-    private readonly streamClient;
-    private readonly retriever;
+    private readonly cfg;
     private readonly deleter;
     private readonly reader;
-    constructor(stream: WebSocketClient, unary: UnaryClient, retriever: channel.Retriever);
+    constructor(cfg: ClientConfig);
     /**
      * Opens a new iterator over the given channels within the provided time range.
-     *
-     * @param tr - A time range to iterate over.
      * @param channels - A list of channels (by name or key) to iterate over.
      * @param opts - see {@link IteratorConfig}
      * @returns a new {@link Iterator}.
@@ -32,7 +42,6 @@ export declare class Client {
     openIterator(tr: CrudeTimeRange, channels: channel.Params, opts?: IteratorConfig): Promise<Iterator>;
     /**
      * Opens a new writer on the given channels.
-     *
      * @param config - The configuration for the created writer, see documentation for
      * writerConfig for more detail.
      * @returns a new {@link Writer}.
@@ -40,19 +49,27 @@ export declare class Client {
     openWriter(config: WriterConfig): Promise<Writer>;
     /**
      * Opens a new streamer with the provided configuration.
-     *
-     * @param config - Configuration parameters for the streamer.
      * @param config.channels - The channels to stream values from. Can be a key, name,
      * list of keys, or list of names.
-     * @param config.from - If this parameter is set and is before the current time,
-     * the streamer will first read and receive historical data from before this point
-     * and then will start reading new values.
-     *
+     * @param config.from - If this parameter is set and is before the current time, the
+     * streamer will first read and receive historical data from before this point and
+     * then will start reading new values.
      */
     openStreamer(config: StreamerConfig): Promise<Streamer>;
+    /**
+     * Opens a feed over this client. The underlying stream opens on first demand;
+     * the caller must close the feed.
+     */
+    openFeed(options?: FeedOptions): Feed;
     write(start: CrudeTimeStamp, channel: channel.Key | channel.Name, data: CrudeSeries): Promise<void>;
     write(start: CrudeTimeStamp, channels: channel.Key[] | channel.Name[], data: CrudeSeries[]): Promise<void>;
     write(start: CrudeTimeStamp, data: Record<channel.Key | channel.Name, CrudeSeries>): Promise<void>;
+    /**
+     * Reads every sample in the time range from the given channels.
+     *
+     * @returns a {@link MultiSeries} for one channel, or a {@link Frame} for several.
+     * @throws {NotFoundError} if a channel does not exist.
+     */
     read(tr: CrudeTimeRange, channel: channel.Key | channel.Name): Promise<MultiSeries>;
     read(tr: CrudeTimeRange, channels: channel.Params): Promise<Frame>;
     read(request: ReadRequest): Promise<ReadableStream<Uint8Array>>;
@@ -60,6 +77,10 @@ export declare class Client {
     readLatest(channel: channel.Key | channel.Name, n: number): Promise<MultiSeries>;
     readLatest(channels: channel.Params, n: number): Promise<Frame>;
     private readLatestNFrame;
+    /**
+     * Deletes every sample in the time range from the given channels. Deletion is
+     * permanent.
+     */
     delete(channels: channel.Params, timeRange: CrudeTimeRange): Promise<void>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/src/framer/client.d.ts.map

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

package/dist/src/framer/codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../src/framer/codec.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,MAAM,EACN,QAAQ,EAIT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2C1D,qBAAa,KAAK;IAChB,WAAW,EAAE,MAAM,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAa;gBAEf,IAAI,GAAE,OAAO,CAAC,GAAG,EAAO,EAAE,SAAS,GAAE,QAAQ,EAAO;IAIhE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAiBxD,OAAO,CAAC,iBAAiB;IAQzB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,GAAE,MAAU,GAAG,UAAU,CAAC,WAAW,CAAC;IA+H1E,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO;CAoGpE;AAED,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAI1C,qBAAa,aAAc,YAAW,MAAM,CAAC,KAAK;IAChD,WAAW,SAAgB;IAC3B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE,KAAK;IAKvB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;IAcjD,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAUpF;AAED,qBAAa,eAAgB,YAAW,MAAM,CAAC,KAAK;IAClD,WAAW,SAAgB;IAC3B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE,KAAK;IAKvB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;IAIjD,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAWpF;AAED,qBAAa,eAAgB,YAAW,MAAM,CAAC,KAAK;IAClD,WAAW,SAAgB;IAC3B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE,KAAK;IAKvB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;IAIjD,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAgBpF"}
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../src/framer/codec.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,MAAM,EACN,QAAQ,EAIT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAwE1D,qBAAa,KAAK;IAChB,WAAW,EAAE,MAAM,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAa;gBAEf,IAAI,GAAE,OAAO,CAAC,GAAG,EAAO,EAAE,SAAS,GAAE,QAAQ,EAAO;IAIhE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAmBxD,OAAO,CAAC,iBAAiB;IAQzB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,GAAE,MAAU,GAAG,UAAU,CAAC,WAAW,CAAC;IAkI1E,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO;CAuGpE;AAED,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAI1C,qBAAa,aAAc,YAAW,MAAM,CAAC,KAAK;IAChD,WAAW,SAAgB;IAC3B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE,KAAK;IAKvB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;IAcjD,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAUpF;AAED,qBAAa,eAAgB,YAAW,MAAM,CAAC,KAAK;IAClD,WAAW,SAAgB;IAC3B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE,KAAK;IAKvB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;IAIjD,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAWpF;AAED,qBAAa,eAAgB,YAAW,MAAM,CAAC,KAAK;IAClD,WAAW,SAAgB;IAC3B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,EAAE,KAAK;IAKvB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;IAIjD,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;CAgBpF"}

package/dist/src/framer/deleter.d.ts

@@ -8,12 +8,12 @@ declare const reqZ: z.ZodObject<{
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
         end: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
     }, z.core.$strip>, z.ZodTransform<TimeRange, {
         start: import('@synnaxlabs/x').TimeStamp;
         end: import('@synnaxlabs/x').TimeStamp;
@@ -22,6 +22,7 @@ declare const reqZ: z.ZodObject<{
 }, z.core.$strip>;
 interface Request extends z.infer<typeof reqZ> {
 }
+/** Deletes a time range of telemetry from a Core. Reach it through `client.telem`. */
 export declare class Deleter {
     private readonly client;
     constructor(client: UnaryClient);

package/dist/src/framer/deleter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleter.d.ts","sourceRoot":"","sources":["../../../src/framer/deleter.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;iBAIR,CAAC;AACH,UAAU,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG;AAIjD,qBAAa,OAAO;IAIlB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAIzB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}
+{"version":3,"file":"deleter.d.ts","sourceRoot":"","sources":["../../../src/framer/deleter.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;iBAIR,CAAC;AACH,UAAU,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG;AAIjD,sFAAsF;AACtF,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAIzB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}

package/dist/src/framer/external.d.ts

@@ -1,5 +1,11 @@
+export { type ChannelRetriever } from './adapter';
+export { type RemoteReader } from './cache/reader';
+export { type StatusHandler, type StreamHandler, type Subscription, } from './cache/streamer';
+export { IDENTITY_TRANSFORM, type Transform } from './cache/transform';
 export * from './client';
+export * from './feed';
 export * from './frame';
+export * from './hardened';
 export * from './iterator';
 export * from './reader';
 export * from './streamer';

package/dist/src/framer/external.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/framer/external.ts"],"names":[],"mappings":"AASA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/framer/external.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC9E,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/src/framer/feed.d.ts

@@ -0,0 +1,40 @@
+import { MultiSeries, TimeRange } from '@synnaxlabs/x';
+import { channel } from '../channel';
+import { CacheProps } from './cache/cache';
+import { ReaderProps } from './cache/reader';
+import { MultiplexedStreamerProps, StreamHandler, Subscription } from './cache/streamer';
+import { StreamOpener } from './streamer';
+/** Props for {@link Feed}, including the transport it reads and streams through. */
+export interface FeedProps extends CacheProps, Omit<ReaderProps, "cache">, Omit<MultiplexedStreamerProps, "cache" | "openStreamer"> {
+    openStreamer: StreamOpener;
+}
+/** The part of {@link FeedProps} a caller sets. The client supplies the rest. */
+export interface FeedOptions extends Omit<FeedProps, "readRemote" | "openStreamer"> {
+}
+/**
+ * Cached, demand-managed access to channel telemetry: durable streaming
+ * subscriptions multiplexed onto one frame stream, and batched historical reads
+ * served through per-channel rolling buffers.
+ */
+export declare class Feed {
+    private readonly cache;
+    private readonly reader;
+    private readonly streamer;
+    constructor(props: FeedProps);
+    /**
+     * Registers durable streaming demand for the given keys. Returns synchronously;
+     * convergence failures surface as per-key statuses, never as rejections. The
+     * handler's first call precedes registration, so a throw from it leaves no
+     * subscription behind.
+     * @throws {UnexpectedError} if the feed has been closed.
+     */
+    stream(handler: StreamHandler, keys: channel.Key[]): Subscription;
+    /**
+     * Reads the given time range for the given channel, serving from the cache and
+     * gap-filling from the cluster.
+     */
+    read(tr: TimeRange, key: channel.Key): Promise<MultiSeries>;
+    /** Closes the feed, releasing the stream and all cached buffers. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=feed.d.ts.map

package/dist/src/framer/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../../../src/framer/feed.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,oFAAoF;AACpF,MAAM,WAAW,SACf,SACE,UAAU,EACV,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAC1B,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,cAAc,CAAC;IAC1D,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,cAAc,CAAC;CAAG;AAEtF;;;;GAIG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,KAAK,EAAE,SAAS;IAqC5B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY;IAIjE;;;OAGG;IACG,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;IAIjE,oEAAoE;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}