@substrat-run/control-plane-api 0.124.0 → 0.126.0

package/dist/aggregate-reads.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The aggregate reads, computed ONCE from cubes (#1877) — the request histogram, the
+ * facet counts and the log patterns, whatever source produced the cubes.
+ *
+ * Pure, so the semantics the routes promise are held here and nowhere else, and the
+ * contract suite can drive them over any `AggregateSource`:
+ *
+ * - **the tenant, and the scope when one is named, are applied first** — a cube carries
+ *   every tenant of its service, and no other tenant's row may reach an answer;
+ * - a facet is counted with every OTHER filter applied and its own left out;
+ * - a line with no `level` is `unrecorded`, counted and never dropped;
+ * - a pattern's share is of every matching `ctx.log` line, not only the listed ones;
+ * - `estimated` is carried through from any sampled part of a cube.
+ */
+import { type AggregateSource, type Cube, type PatternCubeRow, type RequestCubeRow } from './aggregate-source.js';
+import { type LogPatterns, type RequestFacetKey, type RequestFacets, type RequestVolume, type RequestWhere, type ObservabilityReader } from './observability.js';
+/** Who and what a read is about — the tenant is the narrowing, never widened. */
+export interface AggregateScope {
+    tenantId: string;
+    scopeId?: string | undefined;
+    where?: RequestWhere | undefined;
+}
+/**
+ * The width a histogram's bars are drawn at: the asked-for count over the window, never
+ * finer than the cube's grain, and a whole number of grains so no grain is split.
+ */
+export declare function barWidth(span: number, buckets: number, grainMs: number): number;
+/** The request histogram: per-level counts per bar, bars with no requests left out. */
+export declare function volumeFrom(cube: Cube<RequestCubeRow>, scope: AggregateScope & {
+    from: number;
+    to: number;
+    buckets: number;
+    grainMs: number;
+}): RequestVolume;
+/** Facet counts: each facet with every other filter applied and its own left out. */
+export declare function facetsFrom(cube: Cube<RequestCubeRow>, scope: AggregateScope & {
+    keys?: readonly RequestFacetKey[] | undefined;
+}): RequestFacets;
+/** `ctx.log` lines grouped by template: count, share, level split, and a small histogram. */
+export declare function patternsFrom(cube: Cube<PatternCubeRow>, scope: {
+    tenantId: string;
+    scopeId?: string | undefined;
+    from: number;
+    to: number;
+    buckets: number;
+    grainMs: number;
+    level?: readonly string[] | undefined;
+    operation?: readonly string[] | undefined;
+}): LogPatterns;
+/** Cubes for several services, as one — a tenant's app can be served by more than one. */
+export declare function mergeCubes<R>(cubes: readonly Cube<R>[]): Cube<R>;
+/** The window aligned outward to whole grains, so no grain is half in and half out. */
+export declare function alignWindow(from: number, to: number, grainMs: number): {
+    from: number;
+    to: number;
+};
+/**
+ * The three aggregate reads of `ObservabilityReader`, over any source (#1877). An adapter
+ * binds its reads to this rather than computing them itself, so every source — the
+ * telemetry query, a cache of it, a future store — answers with the same semantics, and
+ * the contract suite holds one implementation to them.
+ *
+ * The histogram and the facet panel ask for the same cube (same window, same grain), so a
+ * cached source answers a page's two reads from one block of counts.
+ */
+export declare function aggregateReads(source: AggregateSource): Required<Pick<ObservabilityReader, 'tenantRequestVolume' | 'tenantRequestFacets' | 'tenantLogPatterns'>>;
+//# sourceMappingURL=aggregate-reads.d.ts.map

package/dist/aggregate-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-reads.d.ts","sourceRoot":"","sources":["../src/aggregate-reads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5H,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAE5B,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAClC;AAyBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E;AAKD,uFAAuF;AACvF,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,EAC1B,KAAK,EAAE,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrF,aAAa,CAef;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,EAC1B,KAAK,EAAE,cAAc,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAA;CAAE,GACxE,aAAa,CAuBf;AAKD,6FAA6F;AAC7F,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,EAC1B,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3C,GACA,WAAW,CA2Cb;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAEhE;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAEnG;AAcD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,GACtB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,mBAAmB,CAAC,CAAC,CA6B1G"}

package/dist/aggregate-reads.js

@@ -0,0 +1,186 @@
+/**
+ * The aggregate reads, computed ONCE from cubes (#1877) — the request histogram, the
+ * facet counts and the log patterns, whatever source produced the cubes.
+ *
+ * Pure, so the semantics the routes promise are held here and nowhere else, and the
+ * contract suite can drive them over any `AggregateSource`:
+ *
+ * - **the tenant, and the scope when one is named, are applied first** — a cube carries
+ *   every tenant of its service, and no other tenant's row may reach an answer;
+ * - a facet is counted with every OTHER filter applied and its own left out;
+ * - a line with no `level` is `unrecorded`, counted and never dropped;
+ * - a pattern's share is of every matching `ctx.log` line, not only the listed ones;
+ * - `estimated` is carried through from any sampled part of a cube.
+ */
+import { grainFor } from './aggregate-source.js';
+import { LOG_PATTERN_TOP, REQUEST_FACET_KEYS, REQUEST_FACET_TOP, } from './observability.js';
+/** The caller's rows: its tenant, and its scope when it named one. Applied before anything else. */
+function own(rows, scope) {
+    return rows.filter((r) => r.tenantId === scope.tenantId && (!scope.scopeId || r.scopeId === scope.scopeId));
+}
+/** A request row's value for a facet, as a filter compares it (status as text). */
+function facetValue(r, key) {
+    const v = r[key];
+    return v === null || v === undefined ? null : String(v);
+}
+/** Does a row pass every facet filter — except `omit`'s, when counting that facet? */
+function passes(r, where, omit) {
+    for (const key of REQUEST_FACET_KEYS) {
+        if (key === omit)
+            continue;
+        const values = where?.[key];
+        if (!values || values.length === 0)
+            continue;
+        const v = facetValue(r, key);
+        if (v === null || !values.includes(v))
+            return false;
+    }
+    return true;
+}
+/**
+ * The width a histogram's bars are drawn at: the asked-for count over the window, never
+ * finer than the cube's grain, and a whole number of grains so no grain is split.
+ */
+export function barWidth(span, buckets, grainMs) {
+    return Math.max(grainMs, Math.ceil(span / Math.max(1, buckets) / grainMs) * grainMs);
+}
+const levelOf = (v) => v === 'info' || v === 'warn' || v === 'error' ? v : 'unrecorded';
+/** The request histogram: per-level counts per bar, bars with no requests left out. */
+export function volumeFrom(cube, scope) {
+    const width = barWidth(scope.to - scope.from, scope.buckets, scope.grainMs);
+    const bars = new Map();
+    for (const r of own(cube.rows, scope)) {
+        if (!passes(r, scope.where))
+            continue;
+        const start = scope.from + Math.floor((r.bucket - scope.from) / width) * width;
+        const bar = bars.get(start) ?? { start: new Date(start).toISOString(), info: 0, warn: 0, error: 0, unrecorded: 0 };
+        bar[levelOf(r.level)] += r.count;
+        bars.set(start, bar);
+    }
+    return {
+        bucketMs: width,
+        buckets: [...bars.entries()].sort(([a], [b]) => a - b).map(([, b]) => b),
+        estimated: cube.estimated,
+    };
+}
+/** Facet counts: each facet with every other filter applied and its own left out. */
+export function facetsFrom(cube, scope) {
+    const rows = own(cube.rows, scope);
+    const total = rows.filter((r) => passes(r, scope.where)).reduce((n, r) => n + r.count, 0);
+    const facets = Object.fromEntries(REQUEST_FACET_KEYS.map((k) => [k, []]));
+    for (const key of scope.keys ?? REQUEST_FACET_KEYS) {
+        const counts = new Map();
+        for (const r of rows) {
+            if (!passes(r, scope.where, key))
+                continue;
+            const v = facetValue(r, key);
+            // A line with no value for this key is not a value anybody can filter on; the total
+            // above still counts it.
+            if (v === null || v === '')
+                continue;
+            counts.set(v, (counts.get(v) ?? 0) + r.count);
+        }
+        facets[key] = [...counts.entries()]
+            .map(([v, count]) => ({ value: key === 'status' ? Number(v) : v, count }))
+            .sort((a, b) => b.count - a.count || String(a.value).localeCompare(String(b.value)))
+            .slice(0, REQUEST_FACET_TOP);
+    }
+    return { total, facets, estimated: cube.estimated };
+}
+const patternLevel = (v) => v === 'debug' || v === 'warn' || v === 'error' ? v : 'info';
+/** `ctx.log` lines grouped by template: count, share, level split, and a small histogram. */
+export function patternsFrom(cube, scope) {
+    const width = barWidth(scope.to - scope.from, scope.buckets, scope.grainMs);
+    const rows = own(cube.rows, scope).filter((r) => (!scope.level?.length || scope.level.includes(patternLevel(r.level))) &&
+        (!scope.operation?.length || (r.operation !== null && scope.operation.includes(r.operation))));
+    const total = rows.reduce((n, r) => n + r.count, 0);
+    const byTemplate = new Map();
+    for (const r of rows) {
+        if (r.template === '')
+            continue;
+        let e = byTemplate.get(r.template);
+        if (!e) {
+            e = { levels: { debug: 0, info: 0, warn: 0, error: 0 }, bars: new Map() };
+            byTemplate.set(r.template, e);
+        }
+        e.levels[patternLevel(r.level)] += r.count;
+        const start = scope.from + Math.floor((r.bucket - scope.from) / width) * width;
+        e.bars.set(start, (e.bars.get(start) ?? 0) + r.count);
+    }
+    const patterns = [...byTemplate.entries()]
+        .map(([template, e]) => {
+        const count = e.levels.debug + e.levels.info + e.levels.warn + e.levels.error;
+        const dominant = ['error', 'warn', 'info', 'debug'].reduce((best, l) => e.levels[l] > e.levels[best] ? l : best);
+        return {
+            template,
+            count,
+            share: total > 0 ? count / total : 0,
+            levels: e.levels,
+            dominant,
+            buckets: [...e.bars.entries()].sort(([a], [b]) => a - b).map(([t, n]) => ({ start: new Date(t).toISOString(), count: n })),
+        };
+    })
+        .sort((a, b) => b.count - a.count || a.template.localeCompare(b.template));
+    return {
+        total,
+        bucketMs: width,
+        patterns: patterns.slice(0, LOG_PATTERN_TOP),
+        truncated: patterns.length > LOG_PATTERN_TOP,
+        estimated: cube.estimated,
+    };
+}
+/** Cubes for several services, as one — a tenant's app can be served by more than one. */
+export function mergeCubes(cubes) {
+    return { rows: cubes.flatMap((c) => c.rows), estimated: cubes.some((c) => c.estimated) };
+}
+/** The window aligned outward to whole grains, so no grain is half in and half out. */
+export function alignWindow(from, to, grainMs) {
+    return { from: Math.floor(from / grainMs) * grainMs, to: Math.ceil(to / grainMs) * grainMs };
+}
+/**
+ * The scripts an aggregate read counts over — REQUIRED. A cube is counted per script family,
+ * so there is no tenant-only fallback, and answering an absent list with empty counts would
+ * read as "no traffic". The routes always resolve it; this refuses a caller that did not.
+ */
+function scriptsOf(services) {
+    if (services === undefined) {
+        throw new Error("aggregate log reads need the app's script families (`services`) — a cube is counted per family");
+    }
+    return services;
+}
+/**
+ * The three aggregate reads of `ObservabilityReader`, over any source (#1877). An adapter
+ * binds its reads to this rather than computing them itself, so every source — the
+ * telemetry query, a cache of it, a future store — answers with the same semantics, and
+ * the contract suite holds one implementation to them.
+ *
+ * The histogram and the facet panel ask for the same cube (same window, same grain), so a
+ * cached source answers a page's two reads from one block of counts.
+ */
+export function aggregateReads(source) {
+    const requestCube = async (input) => {
+        const services = scriptsOf(input.services);
+        const grainMs = grainFor(input.to - input.from);
+        const window = alignWindow(input.from, input.to, grainMs);
+        const cube = mergeCubes(await Promise.all(services.map((service) => source.requests({ service, ...window, grainMs }))));
+        return { grainMs, window, cube };
+    };
+    return {
+        async tenantRequestVolume(input) {
+            const { grainMs, window, cube } = await requestCube(input);
+            return volumeFrom(cube, { ...input, ...window, buckets: input.buckets, grainMs });
+        },
+        async tenantRequestFacets(input) {
+            const { cube } = await requestCube(input);
+            return facetsFrom(cube, input);
+        },
+        async tenantLogPatterns(input) {
+            const services = scriptsOf(input.services);
+            const grainMs = grainFor(input.to - input.from);
+            const window = alignWindow(input.from, input.to, grainMs);
+            const cube = mergeCubes(await Promise.all(services.map((service) => source.patterns({ service, ...window, grainMs }))));
+            return patternsFrom(cube, { ...input, ...window, grainMs });
+        },
+    };
+}
+//# sourceMappingURL=aggregate-reads.js.map

package/dist/aggregate-reads.js.map

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

package/dist/aggregate-source.d.ts

@@ -0,0 +1,125 @@
+/**
+ * The aggregate half of the observability seam (#1877): counts, grouped by every facet,
+ * for one deployed service and one span of time — and the cache that makes each span be
+ * counted once.
+ *
+ * ## Why a second seam
+ *
+ * `ObservabilityReader` is the adapter the routes reach through, and its shapes are the
+ * contract the dashboard reads. Underneath it, the request histogram, the facet counts
+ * and the log patterns are all the same computation — sum a cube of counts — over a
+ * source that could be a telemetry query, a cache of earlier answers, or a pre-aggregated
+ * store. This file is that source, so the three reads are written once
+ * (`aggregate-reads.ts`) and the way the counts are obtained can keep improving behind
+ * them without the API moving.
+ *
+ * ## Why a cube, and why per service
+ *
+ * A source answers for a whole SERVICE (a deployed script) and every tenant it served,
+ * grouped by every facet at once. A per-tenant answer would pay to scan the whole script's
+ * lines to keep one tenant's; grouping by tenant in the same scan answers every tenant at
+ * the price of one. And every facet in the grouping means any filter a panel produces is
+ * summed from the cube in memory — ticking a value costs no query.
+ *
+ * The rows are therefore OTHER TENANTS' counts too. The reads filter to the caller's
+ * tenant before anything leaves them, and the contract suite holds them to it.
+ *
+ * ## Why the cache is safe to keep forever
+ *
+ * Logs never change. A span of time that has closed — and has had long enough for late
+ * lines to be ingested — has final counts, so its cube is kept for good and every later
+ * reader of any tenant gets it without a query. Only the open span is read live.
+ */
+/** One row of the request cube: how many stamped invocation lines had these values. */
+export interface RequestCubeRow {
+    /** Start of the grain bucket, epoch milliseconds. */
+    bucket: number;
+    tenantId: string;
+    scopeId: string | null;
+    /** `null` for a line written before the field existed (#1746). */
+    level: string | null;
+    operation: string | null;
+    problemCode: string | null;
+    principalKind: string | null;
+    surface: string | null;
+    status: number | null;
+    count: number;
+}
+/** One row of the pattern cube: how many `ctx.log` lines had these values (#1747). */
+export interface PatternCubeRow {
+    bucket: number;
+    tenantId: string;
+    scopeId: string | null;
+    template: string;
+    level: string | null;
+    operation: string | null;
+    count: number;
+}
+/** A cube and whether any of it was counted from a sample. */
+export interface Cube<Row> {
+    rows: Row[];
+    /** The backend scaled a sample; the counts are estimates. */
+    estimated: boolean;
+    /**
+     * `false` when the source could not vouch for having every group — it had to page an
+     * answer whose order is not guaranteed. Still answered, never KEPT: a cache that stored
+     * it would serve a smaller answer as final for good. Absent means complete.
+     */
+    complete?: boolean;
+}
+/** What a source is asked: one service, one span, cut at one grain. */
+export interface CubeQuery {
+    /** The deployed script the lines came from — the scan boundary and the cache key. */
+    service: string;
+    /** Epoch milliseconds, inclusive / exclusive, aligned to `grainMs`. */
+    from: number;
+    to: number;
+    grainMs: number;
+}
+/** A source of cubes. Implementations: the telemetry query, and a cache wrapping one. */
+export interface AggregateSource {
+    requests(q: CubeQuery): Promise<Cube<RequestCubeRow>>;
+    patterns(q: CubeQuery): Promise<Cube<PatternCubeRow>>;
+}
+/** The grains a cube is cut at. Finer grains serve narrower windows. */
+export declare const GRAINS_MS: readonly [10000, 60000, 300000, 3600000];
+/**
+ * The grain for a window: the coarsest that still gives a zoomed histogram real
+ * resolution. Fifteen minutes and under is cut into 10 s, two hours into a minute, a day
+ * into five minutes, anything longer into hours — so a histogram of 90 bars never has
+ * fewer than about 90 grains to draw them from, and a three-day window is 72 of them.
+ */
+export declare function grainFor(windowMs: number): number;
+/** A cached block is twelve grains: 2 min, 12 min, 1 h or 12 h. */
+export declare function blockMsFor(grainMs: number): number;
+/** How long after a block ends before its counts are final — Workers Logs ingests late. */
+export declare const CLOSE_LAG_MS: number;
+/** A stored block: its cube, as the source answered it. */
+export interface StoredBlock<Row> {
+    rows: Row[];
+    estimated: boolean;
+}
+/** Where closed blocks live. Keys are opaque; a block, once written, never changes. */
+export interface CubeStore {
+    get(keys: readonly string[]): Promise<Map<string, StoredBlock<unknown>>>;
+    put(key: string, block: StoredBlock<unknown>, blockStart: number): Promise<void>;
+}
+/** An in-memory store — the tests', and a harness without a Durable Object. */
+export declare function memoryCubeStore(): CubeStore & {
+    size(): number;
+};
+/** The cache key of one block. The grain is in it: a block at 5 min is not one at 1 h. */
+export declare function blockKey(kind: 'requests' | 'patterns', service: string, grainMs: number, start: number): string;
+/**
+ * A source that counts each closed block once.
+ *
+ * A query is split into blocks of twelve grains, aligned to the epoch so every reader
+ * cuts the same blocks. A block that closed more than `CLOSE_LAG_MS` ago is read from the
+ * store, or counted by `inner` and stored; the rest are counted live and not kept. Rows
+ * outside the query's span are dropped, so a caller never sees the block edges.
+ */
+export declare function cachedSource(inner: AggregateSource, store: CubeStore, opts?: {
+    now?: () => number;
+    lagMs?: number;
+}): AggregateSource;
+//# sourceMappingURL=aggregate-source.d.ts.map

package/dist/aggregate-source.d.ts.map

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

package/dist/aggregate-source.js

@@ -0,0 +1,134 @@
+/**
+ * The aggregate half of the observability seam (#1877): counts, grouped by every facet,
+ * for one deployed service and one span of time — and the cache that makes each span be
+ * counted once.
+ *
+ * ## Why a second seam
+ *
+ * `ObservabilityReader` is the adapter the routes reach through, and its shapes are the
+ * contract the dashboard reads. Underneath it, the request histogram, the facet counts
+ * and the log patterns are all the same computation — sum a cube of counts — over a
+ * source that could be a telemetry query, a cache of earlier answers, or a pre-aggregated
+ * store. This file is that source, so the three reads are written once
+ * (`aggregate-reads.ts`) and the way the counts are obtained can keep improving behind
+ * them without the API moving.
+ *
+ * ## Why a cube, and why per service
+ *
+ * A source answers for a whole SERVICE (a deployed script) and every tenant it served,
+ * grouped by every facet at once. A per-tenant answer would pay to scan the whole script's
+ * lines to keep one tenant's; grouping by tenant in the same scan answers every tenant at
+ * the price of one. And every facet in the grouping means any filter a panel produces is
+ * summed from the cube in memory — ticking a value costs no query.
+ *
+ * The rows are therefore OTHER TENANTS' counts too. The reads filter to the caller's
+ * tenant before anything leaves them, and the contract suite holds them to it.
+ *
+ * ## Why the cache is safe to keep forever
+ *
+ * Logs never change. A span of time that has closed — and has had long enough for late
+ * lines to be ingested — has final counts, so its cube is kept for good and every later
+ * reader of any tenant gets it without a query. Only the open span is read live.
+ */
+/** The grains a cube is cut at. Finer grains serve narrower windows. */
+export const GRAINS_MS = [10_000, 60_000, 300_000, 3_600_000];
+/**
+ * The grain for a window: the coarsest that still gives a zoomed histogram real
+ * resolution. Fifteen minutes and under is cut into 10 s, two hours into a minute, a day
+ * into five minutes, anything longer into hours — so a histogram of 90 bars never has
+ * fewer than about 90 grains to draw them from, and a three-day window is 72 of them.
+ */
+export function grainFor(windowMs) {
+    if (windowMs <= 15 * 60_000)
+        return 10_000;
+    if (windowMs <= 2 * 3_600_000)
+        return 60_000;
+    if (windowMs <= 24 * 3_600_000)
+        return 300_000;
+    return 3_600_000;
+}
+/** A cached block is twelve grains: 2 min, 12 min, 1 h or 12 h. */
+export function blockMsFor(grainMs) {
+    return grainMs * 12;
+}
+/** How long after a block ends before its counts are final — Workers Logs ingests late. */
+export const CLOSE_LAG_MS = 5 * 60_000;
+/** An in-memory store — the tests', and a harness without a Durable Object. */
+export function memoryCubeStore() {
+    const blocks = new Map();
+    return {
+        async get(keys) {
+            const out = new Map();
+            for (const k of keys) {
+                const b = blocks.get(k);
+                if (b)
+                    out.set(k, b);
+            }
+            return out;
+        },
+        async put(key, block) {
+            blocks.set(key, block);
+        },
+        size: () => blocks.size,
+    };
+}
+/** The cache key of one block. The grain is in it: a block at 5 min is not one at 1 h. */
+export function blockKey(kind, service, grainMs, start) {
+    return `${kind}|${service}|${grainMs}|${start}`;
+}
+/** How many uncached blocks one read computes at once — a bound on the backend's load. */
+const BLOCK_CONCURRENCY = 4;
+async function inBatches(items, size, fn) {
+    const out = [];
+    for (let i = 0; i < items.length; i += size)
+        out.push(...(await Promise.all(items.slice(i, i + size).map(fn))));
+    return out;
+}
+/**
+ * A source that counts each closed block once.
+ *
+ * A query is split into blocks of twelve grains, aligned to the epoch so every reader
+ * cuts the same blocks. A block that closed more than `CLOSE_LAG_MS` ago is read from the
+ * store, or counted by `inner` and stored; the rest are counted live and not kept. Rows
+ * outside the query's span are dropped, so a caller never sees the block edges.
+ */
+export function cachedSource(inner, store, opts = {}) {
+    const now = opts.now ?? (() => Date.now());
+    const lag = opts.lagMs ?? CLOSE_LAG_MS;
+    const read = async (kind, q, count) => {
+        const blockMs = blockMsFor(q.grainMs);
+        const first = Math.floor(q.from / blockMs) * blockMs;
+        const starts = [];
+        for (let s = first; s < q.to; s += blockMs)
+            starts.push(s);
+        const closedBefore = now() - lag;
+        const closed = starts.filter((s) => s + blockMs <= closedBefore);
+        const open = starts.filter((s) => s + blockMs > closedBefore);
+        const keys = closed.map((s) => blockKey(kind, q.service, q.grainMs, s));
+        const found = await store.get(keys);
+        const missing = closed.filter((_, i) => !found.has(keys[i]));
+        const counted = await inBatches(missing, BLOCK_CONCURRENCY, async (s) => {
+            const block = await count({ service: q.service, from: s, to: s + blockMs, grainMs: q.grainMs });
+            // Only a block the source vouches for as whole is kept; the rest is recounted next time.
+            if (block.complete !== false) {
+                await store.put(blockKey(kind, q.service, q.grainMs, s), { rows: block.rows, estimated: block.estimated }, s);
+            }
+            return block;
+        });
+        // The open blocks as ONE live span: they are contiguous, and one query is cheaper
+        // than several short ones.
+        const live = open.length > 0
+            ? await count({ service: q.service, from: open[0], to: open[open.length - 1] + blockMs, grainMs: q.grainMs })
+            : { rows: [], estimated: false };
+        const blocks = [...[...found.values()].map((b) => b), ...counted, live];
+        return {
+            rows: blocks.flatMap((b) => b.rows).filter((r) => r.bucket >= q.from && r.bucket < q.to),
+            estimated: blocks.some((b) => b.estimated),
+        };
+    };
+    return {
+        requests: (q) => read('requests', q, (b) => inner.requests(b)),
+        patterns: (q) => read('patterns', q, (b) => inner.patterns(b)),
+    };
+}
+//# sourceMappingURL=aggregate-source.js.map

package/dist/aggregate-source.js.map

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

package/dist/api.d.ts.map

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