@flanksource/clicky-ui 0.3.54 → 0.3.56

package/dist/data/timeseries-stream.cjs

@@ -0,0 +1,304 @@
+let react = require("react");
+// src/data/timeseries-stream.ts
+var DEFAULT_DEBOUNCE_MS = 50;
+var CLOSED = 2;
+var DEFAULT_WINDOW_MS = 36e5;
+/** The state of a group nothing has been received for. */
+var EMPTY_TIMESERIES_STREAM_GROUP = Object.freeze({
+	bySource: /* @__PURE__ */ new Map(),
+	answered: /* @__PURE__ */ new Set(),
+	error: null
+});
+function timeseriesStreamGroupKey({ baseUrl, range, interval }) {
+	return JSON.stringify([
+		baseUrl,
+		range,
+		interval
+	]);
+}
+/**
+* The stream tick for a widget's `refreshMs`: whole seconds, rounded up, at
+* least 1s (the server minimum). `null` for `refreshMs <= 0`, which asks for
+* no live updates, so such widgets fetch once instead of streaming.
+*/
+function timeseriesStreamInterval(refreshMs) {
+	if (!(refreshMs > 0)) return null;
+	return `${Math.max(1, Math.ceil(refreshMs / 1e3))}s`;
+}
+/**
+* Where a widget's series streams from. With a `baseUrl` the series streams
+* as `id` from `{baseUrl}stream`. Without one (the single-`url` panel form),
+* the url is split at its last path `/`: `"/api/v1/metrics/sqlserver.cpu"`
+* streams as `sqlserver.cpu` from `/api/v1/metrics/stream`, the same single
+* segment the server's `GET {prefix}/metrics/{id}` route reads. A url with no
+* such prefix has no stream endpoint, so it is null and keeps fetching.
+*/
+function timeseriesStreamAddress(baseUrl, id) {
+	if (baseUrl !== "") return {
+		baseUrl,
+		id
+	};
+	const query = id.indexOf("?");
+	const slash = id.lastIndexOf("/", query === -1 ? id.length : query);
+	if (slash === -1 || slash === id.length - 1 || slash === query - 1) return null;
+	return {
+		baseUrl: id.slice(0, slash + 1),
+		id: id.slice(slash + 1)
+	};
+}
+function timeseriesStreamUrl(group, ids) {
+	const params = new URLSearchParams();
+	for (const id of ids) params.append("id", id);
+	if (group.range) params.set("since", group.range);
+	params.set("interval", group.interval);
+	return `${group.baseUrl}stream?${params.toString()}`;
+}
+var GO_DURATION_UNITS_MS = {
+	ns: 1e-6,
+	us: .001,
+	"µs": .001,
+	ms: 1,
+	s: 1e3,
+	m: 6e4,
+	h: 36e5
+};
+var GO_DURATION = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:ns|us|µs|ms|s|m|h)(?:(?:\d+(?:\.\d*)?|\.\d+)(?:ns|us|µs|ms|s|m|h))*$/;
+var GO_DURATION_PART = /(\d+(?:\.\d*)?|\.\d+)(ns|us|µs|ms|s|m|h)/g;
+/**
+* The oldest timestamp (epoch ms) the window `range` keeps at `nowMs`, read the
+* way the server reads `since`: an RFC3339 time, or a Go duration before now.
+*/
+function timeseriesWindowStart(range, nowMs) {
+	if (range === "") return nowMs - DEFAULT_WINDOW_MS;
+	if (range === "0") return nowMs;
+	if (GO_DURATION.test(range)) {
+		let ms = 0;
+		for (const [, amount, unit] of range.matchAll(GO_DURATION_PART)) ms += Number(amount) * GO_DURATION_UNITS_MS[unit];
+		return nowMs - ms;
+	}
+	const at = Date.parse(range);
+	if (Number.isNaN(at)) throw new Error(`metrics range ${JSON.stringify(range)} is neither a Go duration nor an RFC3339 time`);
+	return at;
+}
+function pointTime(point) {
+	const at = Date.parse(point.at);
+	if (Number.isNaN(at)) throw new Error(`metrics point has an invalid timestamp ${JSON.stringify(point.at)}`);
+	return at;
+}
+function trimPoints(points, startMs) {
+	return points.filter((p) => pointTime(p) >= startMs);
+}
+/** `existing` with `fresh` merged in by timestamp (fresh wins), sorted oldest first. */
+function mergePoints(existing, fresh) {
+	const byTime = /* @__PURE__ */ new Map();
+	for (const p of existing) byTime.set(pointTime(p), p);
+	for (const p of fresh) byTime.set(pointTime(p), p);
+	return [...byTime.entries()].sort(([a], [b]) => a - b).map(([, p]) => p);
+}
+function parseFrame(name, data) {
+	const frame = JSON.parse(String(data));
+	if (!frame || !Array.isArray(frame.series)) throw new Error(`metrics stream ${name} frame has no series array`);
+	return frame;
+}
+function buildState(group) {
+	const bySource = /* @__PURE__ */ new Map();
+	for (const s of group.series.values()) {
+		const list = bySource.get(s.source) ?? [];
+		list.push(s);
+		bySource.set(s.source, list);
+	}
+	return {
+		bySource,
+		answered: new Set(group.answered),
+		error: group.error
+	};
+}
+/** Creates the store behind {@link TimeseriesStreamProvider}; see the module comment. */
+function createTimeseriesStream(options) {
+	const { factory, debounceMs = DEFAULT_DEBOUNCE_MS, now = Date.now } = options;
+	const groups = /* @__PURE__ */ new Map();
+	const dirty = /* @__PURE__ */ new Set();
+	const listeners = /* @__PURE__ */ new Set();
+	let flushTimer = null;
+	let snapshot = /* @__PURE__ */ new Map();
+	function notify(next) {
+		snapshot = next;
+		for (const listener of Array.from(listeners)) listener();
+	}
+	function publish(group) {
+		notify(new Map(snapshot).set(group.key, buildState(group)));
+	}
+	function forget(key) {
+		const next = new Map(snapshot);
+		next.delete(key);
+		notify(next);
+	}
+	function fail(group, error) {
+		group.error = error;
+		publish(group);
+	}
+	function applySnapshot(group, ids, frame) {
+		const start = timeseriesWindowStart(group.range, now());
+		group.series = new Map(frame.series.map((s) => [s.id, {
+			...s,
+			points: trimPoints(s.points, start)
+		}]));
+		group.answered = new Set(ids);
+		group.error = null;
+	}
+	function applyAppend(group, frame) {
+		const start = timeseriesWindowStart(group.range, now());
+		const next = /* @__PURE__ */ new Map();
+		for (const [id, s] of group.series) next.set(id, {
+			...s,
+			points: trimPoints(s.points, start)
+		});
+		for (const s of frame.series) {
+			const held = next.get(s.id);
+			const points = held ? mergePoints(held.points, s.points) : s.points;
+			next.set(s.id, {
+				...s,
+				points: trimPoints(points, start)
+			});
+		}
+		for (const id of frame.removed ?? []) next.delete(id);
+		group.series = next;
+	}
+	function open(group, ids) {
+		const url = timeseriesStreamUrl(group, ids);
+		const source = factory(url);
+		const current = () => group.source === source;
+		const onFrame = (name) => (event) => {
+			if (!current()) return;
+			try {
+				const frame = parseFrame(name, event.data);
+				if (name === "snapshot") applySnapshot(group, ids, frame);
+				else applyAppend(group, frame);
+				publish(group);
+			} catch (err) {
+				fail(group, err instanceof Error ? err : new Error(String(err)));
+			}
+		};
+		source.addEventListener("snapshot", onFrame("snapshot"));
+		source.addEventListener("append", onFrame("append"));
+		source.addEventListener("error", (event) => {
+			if (!current()) return;
+			if (event instanceof ErrorEvent) {
+				fail(group, new Error(event.message));
+				return;
+			}
+			const data = event.data;
+			if (typeof data === "string" && data !== "") {
+				let message;
+				try {
+					message = String(JSON.parse(data).error ?? data);
+				} catch {
+					message = data;
+				}
+				fail(group, new Error(message));
+				return;
+			}
+			if (source.readyState === CLOSED) fail(group, /* @__PURE__ */ new Error(`metrics stream closed: ${url}`));
+		});
+		group.source?.close();
+		group.source = source;
+		group.ids = ids;
+	}
+	function reconcile(key) {
+		const group = groups.get(key);
+		if (!group) return;
+		const ids = [...group.refs.keys()].sort();
+		if (ids.length === 0) {
+			group.source?.close();
+			groups.delete(key);
+			forget(key);
+			return;
+		}
+		if (ids.length === group.ids.length && ids.every((id, i) => id === group.ids[i])) return;
+		const kept = new Set(ids);
+		for (const [id, s] of group.series) if (!kept.has(s.source)) group.series.delete(id);
+		group.answered = new Set([...group.answered].filter((id) => kept.has(id)));
+		group.error = null;
+		open(group, ids);
+		publish(group);
+	}
+	function flush() {
+		flushTimer = null;
+		const keys = [...dirty];
+		dirty.clear();
+		for (const key of keys) reconcile(key);
+	}
+	function markDirty(key) {
+		dirty.add(key);
+		if (flushTimer) clearTimeout(flushTimer);
+		flushTimer = setTimeout(flush, debounceMs);
+	}
+	return {
+		register(registration) {
+			const { id, ...groupFields } = registration;
+			if (id === "") throw new Error("timeseries stream registration needs a metric id");
+			const key = timeseriesStreamGroupKey(groupFields);
+			let group = groups.get(key);
+			if (!group) {
+				group = {
+					...groupFields,
+					key,
+					refs: /* @__PURE__ */ new Map(),
+					ids: [],
+					source: null,
+					series: /* @__PURE__ */ new Map(),
+					answered: /* @__PURE__ */ new Set(),
+					error: null
+				};
+				groups.set(key, group);
+			}
+			const owner = group;
+			owner.refs.set(id, (owner.refs.get(id) ?? 0) + 1);
+			markDirty(key);
+			let registered = true;
+			return () => {
+				if (!registered) return;
+				registered = false;
+				if (groups.get(key) !== owner) return;
+				const count = (owner.refs.get(id) ?? 0) - 1;
+				if (count > 0) owner.refs.set(id, count);
+				else owner.refs.delete(id);
+				markDirty(key);
+			};
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		getSnapshot() {
+			return snapshot;
+		},
+		getGroup(key) {
+			return snapshot.get(key) ?? EMPTY_TIMESERIES_STREAM_GROUP;
+		},
+		close() {
+			if (flushTimer) clearTimeout(flushTimer);
+			flushTimer = null;
+			dirty.clear();
+			for (const group of groups.values()) group.source?.close();
+			groups.clear();
+			if (snapshot.size > 0) notify(/* @__PURE__ */ new Map());
+		}
+	};
+}
+var TimeseriesStreamContext = (0, react.createContext)(null);
+/** The provided {@link TimeseriesStream}, or null outside a `TimeseriesStreamProvider`. */
+function useTimeseriesStream() {
+	return (0, react.useContext)(TimeseriesStreamContext);
+}
+exports.EMPTY_TIMESERIES_STREAM_GROUP = EMPTY_TIMESERIES_STREAM_GROUP;
+exports.TimeseriesStreamContext = TimeseriesStreamContext;
+exports.createTimeseriesStream = createTimeseriesStream;
+exports.timeseriesStreamAddress = timeseriesStreamAddress;
+exports.timeseriesStreamGroupKey = timeseriesStreamGroupKey;
+exports.timeseriesStreamInterval = timeseriesStreamInterval;
+exports.timeseriesStreamUrl = timeseriesStreamUrl;
+exports.timeseriesWindowStart = timeseriesWindowStart;
+exports.useTimeseriesStream = useTimeseriesStream;
+
+//# sourceMappingURL=timeseries-stream.cjs.map

package/dist/data/timeseries-stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries-stream.cjs","names":["createContext","useContext"],"sources":["../../src/data/timeseries-stream.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { EventSourceFactory, EventSourceLike } from \"../hooks/event-source\";\nimport type { TimeseriesPoint, TimeseriesServerSeries } from \"./TimeseriesPanel.model\";\n\n// One subscription per (baseUrl, range, interval) group serves every widget on\n// a page: widgets register the ids they show, registrations are coalesced over\n// a short debounce, and each group holds a single\n// `{baseUrl}stream?id=…&since=<range>&interval=<n>s` stream (clicky\n// metrics.RegisterStreamRoutes). Opened through the EventSourceFactory, so\n// under createEventHub every group rides the tab's one hub connection.\n\n/** The payload of a stream's `snapshot` and `append` events. */\nexport interface TimeseriesStreamFrame {\n  series: TimeseriesServerSeries[];\n  /** Series ids (not sources) that no longer exist. */\n  removed?: string[];\n}\n\n/** The identity of a stream group: every widget with the same three shares one subscription. */\nexport interface TimeseriesStreamGroup {\n  /** Prefix the stream path is appended to, e.g. \"/api/v1/metrics/\". */\n  baseUrl: string;\n  /** The look-back window, sent as `since` (a Go duration or RFC3339 time). */\n  range: string;\n  /** The server tick, e.g. \"5s\" (see {@link timeseriesStreamInterval}). */\n  interval: string;\n}\n\nexport interface TimeseriesStreamRegistration extends TimeseriesStreamGroup {\n  id: string;\n}\n\n/** What a group's widgets read, replaced (never mutated) on every change. */\nexport interface TimeseriesStreamGroupState {\n  /** Every series held, grouped by the requested id (`source`) it answers. */\n  bySource: ReadonlyMap<string, readonly TimeseriesServerSeries[]>;\n  /** Requested ids a snapshot has answered; an id outside it is still loading. */\n  answered: ReadonlySet<string>;\n  /** The stream's error event, or its failure to open; cleared by the next snapshot. */\n  error: Error | null;\n}\n\nexport interface TimeseriesStream {\n  /** Adds one widget's interest in an id; the returned function removes it. */\n  register(registration: TimeseriesStreamRegistration): () => void;\n  /** useSyncExternalStore subscription: called after any group's state changes. */\n  subscribe(listener: () => void): () => void;\n  /** Every group's state by {@link timeseriesStreamGroupKey}; a new map after any change. */\n  getSnapshot(): ReadonlyMap<string, TimeseriesStreamGroupState>;\n  /** The state of one group (empty when nothing is registered in it). */\n  getGroup(key: string): TimeseriesStreamGroupState;\n  /** Closes every subscription and forgets every registration; later registrations start afresh. */\n  close(): void;\n}\n\nexport interface TimeseriesStreamOptions {\n  factory: EventSourceFactory;\n  /** How long registrations coalesce before groups re-subscribe. Defaults to 50ms. */\n  debounceMs?: number;\n  /** Clock used to trim points older than the range window. Defaults to Date.now. */\n  now?: () => number;\n}\n\nconst DEFAULT_DEBOUNCE_MS = 50;\nconst CLOSED = 2;\n// The server's window when `since` is empty (clicky metrics defaultWindow).\nconst DEFAULT_WINDOW_MS = 60 * 60 * 1000;\n\n/** The state of a group nothing has been received for. */\nexport const EMPTY_TIMESERIES_STREAM_GROUP: TimeseriesStreamGroupState = Object.freeze({\n  bySource: new Map(),\n  answered: new Set<string>(),\n  error: null,\n});\n\nexport function timeseriesStreamGroupKey({ baseUrl, range, interval }: TimeseriesStreamGroup): string {\n  return JSON.stringify([baseUrl, range, interval]);\n}\n\n/**\n * The stream tick for a widget's `refreshMs`: whole seconds, rounded up, at\n * least 1s (the server minimum). `null` for `refreshMs <= 0`, which asks for\n * no live updates, so such widgets fetch once instead of streaming.\n */\nexport function timeseriesStreamInterval(refreshMs: number): string | null {\n  if (!(refreshMs > 0)) return null;\n  return `${Math.max(1, Math.ceil(refreshMs / 1000))}s`;\n}\n\n/**\n * Where a widget's series streams from. With a `baseUrl` the series streams\n * as `id` from `{baseUrl}stream`. Without one (the single-`url` panel form),\n * the url is split at its last path `/`: `\"/api/v1/metrics/sqlserver.cpu\"`\n * streams as `sqlserver.cpu` from `/api/v1/metrics/stream`, the same single\n * segment the server's `GET {prefix}/metrics/{id}` route reads. A url with no\n * such prefix has no stream endpoint, so it is null and keeps fetching.\n */\nexport function timeseriesStreamAddress(baseUrl: string, id: string): { baseUrl: string; id: string } | null {\n  if (baseUrl !== \"\") return { baseUrl, id };\n  const query = id.indexOf(\"?\");\n  const slash = id.lastIndexOf(\"/\", query === -1 ? id.length : query);\n  if (slash === -1 || slash === id.length - 1 || slash === query - 1) return null;\n  return { baseUrl: id.slice(0, slash + 1), id: id.slice(slash + 1) };\n}\n\nexport function timeseriesStreamUrl(group: TimeseriesStreamGroup, ids: readonly string[]): string {\n  const params = new URLSearchParams();\n  for (const id of ids) params.append(\"id\", id);\n  if (group.range) params.set(\"since\", group.range);\n  params.set(\"interval\", group.interval);\n  return `${group.baseUrl}stream?${params.toString()}`;\n}\n\nconst GO_DURATION_UNITS_MS: Record<string, number> = {\n  ns: 1e-6,\n  us: 1e-3,\n  \"µs\": 1e-3,\n  ms: 1,\n  s: 1000,\n  m: 60_000,\n  h: 3_600_000,\n};\nconst GO_DURATION = /^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:ns|us|µs|ms|s|m|h)(?:(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:ns|us|µs|ms|s|m|h))*$/;\nconst GO_DURATION_PART = /(\\d+(?:\\.\\d*)?|\\.\\d+)(ns|us|µs|ms|s|m|h)/g;\n\n/**\n * The oldest timestamp (epoch ms) the window `range` keeps at `nowMs`, read the\n * way the server reads `since`: an RFC3339 time, or a Go duration before now.\n */\nexport function timeseriesWindowStart(range: string, nowMs: number): number {\n  if (range === \"\") return nowMs - DEFAULT_WINDOW_MS;\n  if (range === \"0\") return nowMs;\n  if (GO_DURATION.test(range)) {\n    let ms = 0;\n    for (const [, amount, unit] of range.matchAll(GO_DURATION_PART)) {\n      ms += Number(amount) * (GO_DURATION_UNITS_MS[unit as string] as number);\n    }\n    return nowMs - ms;\n  }\n  const at = Date.parse(range);\n  if (Number.isNaN(at)) {\n    throw new Error(`metrics range ${JSON.stringify(range)} is neither a Go duration nor an RFC3339 time`);\n  }\n  return at;\n}\n\nfunction pointTime(point: TimeseriesPoint): number {\n  const at = Date.parse(point.at);\n  if (Number.isNaN(at)) throw new Error(`metrics point has an invalid timestamp ${JSON.stringify(point.at)}`);\n  return at;\n}\n\nfunction trimPoints(points: readonly TimeseriesPoint[], startMs: number): TimeseriesPoint[] {\n  return points.filter((p) => pointTime(p) >= startMs);\n}\n\n/** `existing` with `fresh` merged in by timestamp (fresh wins), sorted oldest first. */\nfunction mergePoints(existing: readonly TimeseriesPoint[], fresh: readonly TimeseriesPoint[]): TimeseriesPoint[] {\n  const byTime = new Map<number, TimeseriesPoint>();\n  for (const p of existing) byTime.set(pointTime(p), p);\n  for (const p of fresh) byTime.set(pointTime(p), p);\n  return [...byTime.entries()].sort(([a], [b]) => a - b).map(([, p]) => p);\n}\n\nfunction parseFrame(name: string, data: unknown): TimeseriesStreamFrame {\n  const frame = JSON.parse(String(data)) as TimeseriesStreamFrame;\n  if (!frame || !Array.isArray(frame.series)) {\n    throw new Error(`metrics stream ${name} frame has no series array`);\n  }\n  return frame;\n}\n\ninterface GroupRecord extends TimeseriesStreamGroup {\n  key: string;\n  refs: Map<string, number>;\n  ids: string[];\n  source: EventSourceLike | null;\n  /** Held series keyed by series id, in server order. */\n  series: Map<string, TimeseriesServerSeries>;\n  answered: Set<string>;\n  error: Error | null;\n}\n\nfunction buildState(group: GroupRecord): TimeseriesStreamGroupState {\n  const bySource = new Map<string, TimeseriesServerSeries[]>();\n  for (const s of group.series.values()) {\n    const list = bySource.get(s.source) ?? [];\n    list.push(s);\n    bySource.set(s.source, list);\n  }\n  return { bySource, answered: new Set(group.answered), error: group.error };\n}\n\n/** Creates the store behind {@link TimeseriesStreamProvider}; see the module comment. */\nexport function createTimeseriesStream(options: TimeseriesStreamOptions): TimeseriesStream {\n  const { factory, debounceMs = DEFAULT_DEBOUNCE_MS, now = Date.now } = options;\n  const groups = new Map<string, GroupRecord>();\n  const dirty = new Set<string>();\n  const listeners = new Set<() => void>();\n  let flushTimer: ReturnType<typeof setTimeout> | null = null;\n  let snapshot: ReadonlyMap<string, TimeseriesStreamGroupState> = new Map();\n\n  function notify(next: Map<string, TimeseriesStreamGroupState>): void {\n    snapshot = next;\n    for (const listener of Array.from(listeners)) listener();\n  }\n\n  function publish(group: GroupRecord): void {\n    notify(new Map(snapshot).set(group.key, buildState(group)));\n  }\n\n  function forget(key: string): void {\n    const next = new Map(snapshot);\n    next.delete(key);\n    notify(next);\n  }\n\n  function fail(group: GroupRecord, error: Error): void {\n    group.error = error;\n    publish(group);\n  }\n\n  function applySnapshot(group: GroupRecord, ids: readonly string[], frame: TimeseriesStreamFrame): void {\n    const start = timeseriesWindowStart(group.range, now());\n    group.series = new Map(frame.series.map((s) => [s.id, { ...s, points: trimPoints(s.points, start) }]));\n    group.answered = new Set(ids);\n    group.error = null;\n  }\n\n  function applyAppend(group: GroupRecord, frame: TimeseriesStreamFrame): void {\n    const start = timeseriesWindowStart(group.range, now());\n    const next = new Map<string, TimeseriesServerSeries>();\n    for (const [id, s] of group.series) next.set(id, { ...s, points: trimPoints(s.points, start) });\n    for (const s of frame.series) {\n      const held = next.get(s.id);\n      const points = held ? mergePoints(held.points, s.points) : s.points;\n      next.set(s.id, { ...s, points: trimPoints(points, start) });\n    }\n    for (const id of frame.removed ?? []) next.delete(id);\n    group.series = next;\n  }\n\n  function open(group: GroupRecord, ids: string[]): void {\n    const url = timeseriesStreamUrl(group, ids);\n    const source = factory(url);\n    const current = () => group.source === source;\n    const onFrame = (name: \"snapshot\" | \"append\") => (event: Event) => {\n      if (!current()) return;\n      try {\n        const frame = parseFrame(name, (event as MessageEvent).data);\n        if (name === \"snapshot\") applySnapshot(group, ids, frame);\n        else applyAppend(group, frame);\n        publish(group);\n      } catch (err) {\n        fail(group, err instanceof Error ? err : new Error(String(err)));\n      }\n    };\n    source.addEventListener(\"snapshot\", onFrame(\"snapshot\"));\n    source.addEventListener(\"append\", onFrame(\"append\"));\n    source.addEventListener(\"error\", (event) => {\n      if (!current()) return;\n      // A sub the event hub failed (the server closed it with an error, or\n      // refused the subscribe) is an ErrorEvent carrying the server's message.\n      // A server-sent `error` event carries {\"error\": msg}; a transport error\n      // carries no data. A transport error that leaves the source CONNECTING\n      // is a reconnect the hub (or native EventSource) re-subscribes from with\n      // a fresh snapshot; one that leaves it CLOSED is a failed subscription\n      // native EventSource gives no reason for.\n      if (event instanceof ErrorEvent) {\n        fail(group, new Error(event.message));\n        return;\n      }\n      const data = (event as MessageEvent).data;\n      if (typeof data === \"string\" && data !== \"\") {\n        let message: string;\n        try {\n          message = String((JSON.parse(data) as { error?: unknown }).error ?? data);\n        } catch {\n          message = data;\n        }\n        fail(group, new Error(message));\n        return;\n      }\n      if (source.readyState === CLOSED) fail(group, new Error(`metrics stream closed: ${url}`));\n    });\n    group.source?.close();\n    group.source = source;\n    group.ids = ids;\n  }\n\n  function reconcile(key: string): void {\n    const group = groups.get(key);\n    if (!group) return;\n    const ids = [...group.refs.keys()].sort();\n    if (ids.length === 0) {\n      group.source?.close();\n      groups.delete(key);\n      forget(key);\n      return;\n    }\n    if (ids.length === group.ids.length && ids.every((id, i) => id === group.ids[i])) return;\n    // Keep what is held for ids still requested until the new snapshot\n    // replaces it; an error belonged to the subscription being replaced.\n    const kept = new Set(ids);\n    for (const [id, s] of group.series) if (!kept.has(s.source)) group.series.delete(id);\n    group.answered = new Set([...group.answered].filter((id) => kept.has(id)));\n    group.error = null;\n    open(group, ids);\n    publish(group);\n  }\n\n  function flush(): void {\n    flushTimer = null;\n    const keys = [...dirty];\n    dirty.clear();\n    for (const key of keys) reconcile(key);\n  }\n\n  function markDirty(key: string): void {\n    dirty.add(key);\n    if (flushTimer) clearTimeout(flushTimer);\n    flushTimer = setTimeout(flush, debounceMs);\n  }\n\n  return {\n    register(registration) {\n      const { id, ...groupFields } = registration;\n      if (id === \"\") throw new Error(\"timeseries stream registration needs a metric id\");\n      const key = timeseriesStreamGroupKey(groupFields);\n      let group = groups.get(key);\n      if (!group) {\n        group = {\n          ...groupFields,\n          key,\n          refs: new Map(),\n          ids: [],\n          source: null,\n          series: new Map(),\n          answered: new Set(),\n          error: null,\n        };\n        groups.set(key, group);\n      }\n      const owner = group;\n      owner.refs.set(id, (owner.refs.get(id) ?? 0) + 1);\n      markDirty(key);\n      let registered = true;\n      return () => {\n        if (!registered) return;\n        registered = false;\n        // close() may have dropped the group already (the provider unmounting\n        // before its widgets); a later registration makes a new record.\n        if (groups.get(key) !== owner) return;\n        const count = (owner.refs.get(id) ?? 0) - 1;\n        if (count > 0) owner.refs.set(id, count);\n        else owner.refs.delete(id);\n        markDirty(key);\n      };\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    getSnapshot() {\n      return snapshot;\n    },\n    getGroup(key) {\n      return snapshot.get(key) ?? EMPTY_TIMESERIES_STREAM_GROUP;\n    },\n    close() {\n      if (flushTimer) clearTimeout(flushTimer);\n      flushTimer = null;\n      dirty.clear();\n      for (const group of groups.values()) group.source?.close();\n      groups.clear();\n      if (snapshot.size > 0) notify(new Map());\n    },\n  };\n}\n\nexport const TimeseriesStreamContext = createContext<TimeseriesStream | null>(null);\n\n/** The provided {@link TimeseriesStream}, or null outside a `TimeseriesStreamProvider`. */\nexport function useTimeseriesStream(): TimeseriesStream | null {\n  return useContext(TimeseriesStreamContext);\n}\n"],"mappings":"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"}

package/dist/data/timeseries-stream.d.ts

@@ -0,0 +1,81 @@
+import { EventSourceFactory } from '../hooks/event-source.js';
+import { TimeseriesServerSeries } from './TimeseriesPanel.model.js';
+/** The payload of a stream's `snapshot` and `append` events. */
+export interface TimeseriesStreamFrame {
+    series: TimeseriesServerSeries[];
+    /** Series ids (not sources) that no longer exist. */
+    removed?: string[];
+}
+/** The identity of a stream group: every widget with the same three shares one subscription. */
+export interface TimeseriesStreamGroup {
+    /** Prefix the stream path is appended to, e.g. "/api/v1/metrics/". */
+    baseUrl: string;
+    /** The look-back window, sent as `since` (a Go duration or RFC3339 time). */
+    range: string;
+    /** The server tick, e.g. "5s" (see {@link timeseriesStreamInterval}). */
+    interval: string;
+}
+export interface TimeseriesStreamRegistration extends TimeseriesStreamGroup {
+    id: string;
+}
+/** What a group's widgets read, replaced (never mutated) on every change. */
+export interface TimeseriesStreamGroupState {
+    /** Every series held, grouped by the requested id (`source`) it answers. */
+    bySource: ReadonlyMap<string, readonly TimeseriesServerSeries[]>;
+    /** Requested ids a snapshot has answered; an id outside it is still loading. */
+    answered: ReadonlySet<string>;
+    /** The stream's error event, or its failure to open; cleared by the next snapshot. */
+    error: Error | null;
+}
+export interface TimeseriesStream {
+    /** Adds one widget's interest in an id; the returned function removes it. */
+    register(registration: TimeseriesStreamRegistration): () => void;
+    /** useSyncExternalStore subscription: called after any group's state changes. */
+    subscribe(listener: () => void): () => void;
+    /** Every group's state by {@link timeseriesStreamGroupKey}; a new map after any change. */
+    getSnapshot(): ReadonlyMap<string, TimeseriesStreamGroupState>;
+    /** The state of one group (empty when nothing is registered in it). */
+    getGroup(key: string): TimeseriesStreamGroupState;
+    /** Closes every subscription and forgets every registration; later registrations start afresh. */
+    close(): void;
+}
+export interface TimeseriesStreamOptions {
+    factory: EventSourceFactory;
+    /** How long registrations coalesce before groups re-subscribe. Defaults to 50ms. */
+    debounceMs?: number;
+    /** Clock used to trim points older than the range window. Defaults to Date.now. */
+    now?: () => number;
+}
+/** The state of a group nothing has been received for. */
+export declare const EMPTY_TIMESERIES_STREAM_GROUP: TimeseriesStreamGroupState;
+export declare function timeseriesStreamGroupKey({ baseUrl, range, interval }: TimeseriesStreamGroup): string;
+/**
+ * The stream tick for a widget's `refreshMs`: whole seconds, rounded up, at
+ * least 1s (the server minimum). `null` for `refreshMs <= 0`, which asks for
+ * no live updates, so such widgets fetch once instead of streaming.
+ */
+export declare function timeseriesStreamInterval(refreshMs: number): string | null;
+/**
+ * Where a widget's series streams from. With a `baseUrl` the series streams
+ * as `id` from `{baseUrl}stream`. Without one (the single-`url` panel form),
+ * the url is split at its last path `/`: `"/api/v1/metrics/sqlserver.cpu"`
+ * streams as `sqlserver.cpu` from `/api/v1/metrics/stream`, the same single
+ * segment the server's `GET {prefix}/metrics/{id}` route reads. A url with no
+ * such prefix has no stream endpoint, so it is null and keeps fetching.
+ */
+export declare function timeseriesStreamAddress(baseUrl: string, id: string): {
+    baseUrl: string;
+    id: string;
+} | null;
+export declare function timeseriesStreamUrl(group: TimeseriesStreamGroup, ids: readonly string[]): string;
+/**
+ * The oldest timestamp (epoch ms) the window `range` keeps at `nowMs`, read the
+ * way the server reads `since`: an RFC3339 time, or a Go duration before now.
+ */
+export declare function timeseriesWindowStart(range: string, nowMs: number): number;
+/** Creates the store behind {@link TimeseriesStreamProvider}; see the module comment. */
+export declare function createTimeseriesStream(options: TimeseriesStreamOptions): TimeseriesStream;
+export declare const TimeseriesStreamContext: import('react').Context<TimeseriesStream | null>;
+/** The provided {@link TimeseriesStream}, or null outside a `TimeseriesStreamProvider`. */
+export declare function useTimeseriesStream(): TimeseriesStream | null;
+//# sourceMappingURL=timeseries-stream.d.ts.map

package/dist/data/timeseries-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries-stream.d.ts","sourceRoot":"","sources":["../../src/data/timeseries-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAmB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AASvF,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;IACzE,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,4EAA4E;IAC5E,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC;IACjE,gFAAgF;IAChF,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,sFAAsF;IACtF,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,4BAA4B,GAAG,MAAM,IAAI,CAAC;IACjE,iFAAiF;IACjF,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,2FAA2F;IAC3F,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC/D,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,CAAC;IAClD,kGAAkG;IAClG,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAOD,0DAA0D;AAC1D,eAAO,MAAM,6BAA6B,EAAE,0BAI1C,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAEpG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM3G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMhG;AAcD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAe1E;AAiDD,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAwLzF;AAED,eAAO,MAAM,uBAAuB,kDAA+C,CAAC;AAEpF,2FAA2F;AAC3F,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D"}

package/dist/data/timeseries-stream.fixtures.d.ts

@@ -0,0 +1,36 @@
+import { EventSourceFactory, EventSourceLike } from '../hooks/event-source.js';
+/**
+ * An in-memory EventSourceLike for tests and stories: it records the URL it
+ * was opened with and dispatches whatever frames the caller emits, standing
+ * in for one hub subscription.
+ */
+export declare class FakeEventSource implements EventSourceLike {
+    readonly url: string;
+    readyState: number;
+    onopen: ((ev: Event) => unknown) | null;
+    onmessage: ((ev: MessageEvent) => unknown) | null;
+    onerror: ((ev: Event) => unknown) | null;
+    readonly listeners: Map<string, Set<EventListenerOrEventListenerObject>>;
+    constructor(url: string);
+    /** The `id` query values, in URL order. */
+    get ids(): string[];
+    param(name: string): string | null;
+    get closed(): boolean;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject): void;
+    /** Called once when the consumer closes the stream, e.g. to stop a story's timers. */
+    onClose: (() => void) | null;
+    close(): void;
+    /** Dispatches a server-named event whose data is `payload` as JSON. */
+    emit(name: string, payload: unknown): void;
+    /** A transport failure: no data, the stream ends CLOSED. */
+    fail(): void;
+    private dispatch;
+}
+/** A factory that opens FakeEventSources and keeps every one it opened, oldest first. */
+export declare function createFakeEventSourceFactory(): {
+    factory: EventSourceFactory;
+    opened: FakeEventSource[];
+    latest(): FakeEventSource;
+};
+//# sourceMappingURL=timeseries-stream.fixtures.d.ts.map

package/dist/data/timeseries-stream.fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries-stream.fixtures.d.ts","sourceRoot":"","sources":["../../src/data/timeseries-stream.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMjF;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,eAAe;IAOzC,QAAQ,CAAC,GAAG,EAAE,MAAM;IANhC,UAAU,SAAc;IACxB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAQ;IAC/C,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,IAAI,CAAQ;IACzD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAQ;IAChD,QAAQ,CAAC,SAAS,uDAA8D;gBAE3D,GAAG,EAAE,MAAM;IAEhC,2CAA2C;IAC3C,IAAI,GAAG,IAAI,MAAM,EAAE,CAElB;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,GAAG,IAAI;IAMlF,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,GAAG,IAAI;IAIrF,sFAAsF;IACtF,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEpC,KAAK,IAAI,IAAI;IAMb,uEAAuE;IACvE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAM1C,4DAA4D;IAC5D,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,QAAQ;CAMjB;AAED,yFAAyF;AACzF,wBAAgB,4BAA4B,IAAI;IAC9C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,IAAI,eAAe,CAAC;CAC3B,CAeA"}