@uptimizr/db 2.0.1 → 2.1.0

package/dist/insights/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/insights/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,+EAA+E;AAC/E,eAAO,MAAM,YAAY,SAAS,CAAC;AAcnC,4EAA4E;AAC5E,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5E;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,GAAE,MAAyB,GACjC,MAAM,GAAG,IAAI,CAKf;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAI7F;AAED,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAM5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,SAAI,GAAG,MAAM,GAAG,IAAI,CAIvE"}

package/dist/insights/stats.js

@@ -0,0 +1,181 @@
+/**
+ * **Insight statistics** (ADR 0051 §4, design sketch §D).
+ *
+ * The descriptive statistics the insight primitives are built from, in pure
+ * TypeScript: no SQL, no dialect, no I/O. That is the whole design rule of
+ * `src/insights/` — the *series* is portable (one dialect-authored bucket query,
+ * parity-tested on all four engines) and the *statistics over it* are computed
+ * once, here, so DuckDB, ClickHouse, Postgres and SQL Server cannot disagree
+ * about what "the median" or "the MAD" means.
+ *
+ * Every function is total and deterministic:
+ *
+ * - it takes a plain `readonly number[]` and returns a `number` or `null`;
+ * - `null` always means *"not defined for this input"* (an empty series, a
+ *   single point where a slope needs two), never `0` — a zero mean is a claim
+ *   about the data, absence is not (the same rule the registry row schemas
+ *   follow);
+ * - non-finite inputs are rejected up front rather than silently poisoning a
+ *   result with `NaN`.
+ *
+ * Robust statistics (median, MAD) are used rather than mean/standard deviation
+ * wherever a value is ranked or compared, because a scene's bucket series is
+ * routinely dominated by one outlier day — a launch, a bot sweep, a broken
+ * deploy — and a standard deviation computed across it makes every subsequent
+ * change look insignificant.
+ */
+// `leastSquaresSlope` is the same statistic the `format=summary` series envelope
+// already reports (design sketch §B.1), so it is reused rather than re-derived:
+// `baseline.slope` and a `format=summary` trend on the same series must agree to
+// the last bit, and the only way to guarantee that is to run the same code.
+export { leastSquaresSlope, trendOf } from "../query/summary/stats.js";
+/**
+ * Floor added to the MAD in the denominator of {@link robustZ}.
+ *
+ * A reference window that never varied has `mad = 0`, and dividing by it would
+ * be `Infinity`/`NaN`. Adding a small epsilon keeps the score finite and keeps
+ * its *ordering* meaningful: against a perfectly flat reference, any change at
+ * all is genuinely unprecedented and should rank above a change of the same size
+ * against a noisy one. What stops that from flooding the top of a `movers` list
+ * is the `minSample` gate, not the epsilon — a flat-zero series with two events
+ * behind it reports `aboveMinSample: false` and is ranked below every gated
+ * mover (see `movers.ts`).
+ */
+export const ROBUST_Z_EPSILON = 1e-9;
+/** Scale factor making the MAD a consistent estimator of σ for normal data. */
+export const MAD_TO_SIGMA = 1.4826;
+/** The finite values of `values`, in a fresh array. */
+function finite(values) {
+    const out = [];
+    for (const value of values)
+        if (Number.isFinite(value))
+            out.push(value);
+    return out;
+}
+/** The finite values of `values`, ascending, in a fresh array. */
+function sortedFinite(values) {
+    return finite(values).sort((a, b) => a - b);
+}
+/** The arithmetic mean of the finite values; `null` when there are none. */
+export function mean(values) {
+    const sample = finite(values);
+    if (sample.length === 0)
+        return null;
+    let total = 0;
+    for (const value of sample)
+        total += value;
+    return total / sample.length;
+}
+/**
+ * The `q`-quantile (`0..1`) by **linear interpolation between order statistics**
+ * — the "R type 7" / `numpy.percentile` default, and the same definition the
+ * dialects' own `quantile()` uses closely enough for the tolerances the parity
+ * harness applies.
+ *
+ * `null` when the series is empty or `q` is outside `0..1`. `q = 0` and `q = 1`
+ * return the min and max exactly.
+ */
+export function quantile(values, q) {
+    if (!Number.isFinite(q) || q < 0 || q > 1)
+        return null;
+    const sample = sortedFinite(values);
+    if (sample.length === 0)
+        return null;
+    if (sample.length === 1)
+        return sample[0];
+    const position = q * (sample.length - 1);
+    const lower = Math.floor(position);
+    const upper = Math.ceil(position);
+    const low = sample[lower];
+    if (lower === upper)
+        return low;
+    const high = sample[upper];
+    return low + (high - low) * (position - lower);
+}
+/** The median (the 0.5 quantile); `null` on an empty series. */
+export function median(values) {
+    return quantile(values, 0.5);
+}
+/**
+ * The **median absolute deviation**: `median(|x − median(x)|)`.
+ *
+ * The robust counterpart of the standard deviation, and the spread every
+ * insight primitive compares against. Unlike σ it has a breakdown point of 50%,
+ * so a single catastrophic day in a 28-day window widens it by nothing at all
+ * instead of tripling it. Reported **unscaled** (raw median deviation, not
+ * multiplied by {@link MAD_TO_SIGMA}) because it is used as a denominator for a
+ * *ranking* score rather than as a σ estimate; a caller that wants σ multiplies.
+ *
+ * `null` on an empty series; `0` on a constant one, which is a true statement
+ * about the data rather than a missing value.
+ */
+export function medianAbsoluteDeviation(values) {
+    const sample = finite(values);
+    if (sample.length === 0)
+        return null;
+    const centre = median(sample);
+    if (centre == null)
+        return null;
+    return median(sample.map((value) => Math.abs(value - centre)));
+}
+/**
+ * The **robust z-score** of a change: `delta / (mad + ε)`.
+ *
+ * "How many typical bucket-to-bucket deviations is this move?" — the ranking
+ * score for `movers` (design sketch §D). Returns `0` for a zero delta whatever
+ * the spread (nothing moved, so nothing is surprising), and `null` when `delta`
+ * or `mad` is missing or non-finite, so a metric with no reference series is
+ * reported as unranked rather than as a confident zero.
+ *
+ * A negative `mad` is impossible by construction and is treated as missing.
+ */
+export function robustZ(delta, mad, epsilon = ROBUST_Z_EPSILON) {
+    if (delta == null || !Number.isFinite(delta))
+        return null;
+    if (mad == null || !Number.isFinite(mad) || mad < 0)
+        return null;
+    if (delta === 0)
+        return 0;
+    return delta / (mad + epsilon);
+}
+/**
+ * Relative change from `previous` to `current`, as a ratio (`0.25` is +25%).
+ *
+ * `null` when either side is missing or when `previous` is zero — a percentage
+ * change from nothing is undefined, and reporting `Infinity` (or, worse,
+ * `100%`) would be a claim the data does not support. The absolute `delta` is
+ * always available alongside it, which is the honest number in that case.
+ */
+export function relativeChange(current, previous) {
+    if (current == null || previous == null)
+        return null;
+    if (!Number.isFinite(current) || !Number.isFinite(previous) || previous === 0)
+        return null;
+    return (current - previous) / Math.abs(previous);
+}
+/** The sum of the finite values; `null` when there are none (never `0`). */
+export function sum(values) {
+    const sample = finite(values);
+    if (sample.length === 0)
+        return null;
+    let total = 0;
+    for (const value of sample)
+        total += value;
+    return total;
+}
+/**
+ * Round a computed statistic to a fixed number of decimals.
+ *
+ * Applied at the API edge only. Two engines can differ in the last bits of a
+ * floating-point division, and an agent comparing a `z` of `3.0000000000000004`
+ * with one of `3` should not see a difference — so every derived number the
+ * insight endpoints emit is rounded to a declared precision, which also keeps
+ * the JSON (and the tokens an agent pays for it) small.
+ */
+export function round(value, decimals = 6) {
+    if (value == null || !Number.isFinite(value))
+        return null;
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=stats.js.map

package/dist/insights/stats.js.map

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

package/dist/insights/windows.d.ts

@@ -0,0 +1,95 @@
+/**
+ * **Window resolution** for the insight primitives (ADR 0051 §4, sketch §D).
+ *
+ * Both primitives take a time range the way the rest of the query surface does
+ * (`since` / `until`, epoch ms, lower-inclusive and upper-exclusive) and both
+ * add a shorthand on top — `window` days for `baseline`, an implicit "previous
+ * equal window" reference for `movers`. This module is the single place those
+ * shorthands become concrete milliseconds, so the route stays thin and the rules
+ * are unit-testable without a server.
+ *
+ * ## Windows are snapped to bucket boundaries
+ *
+ * Every resolved bound is floored to the bucket grain. Two reasons, and both are
+ * about not lying to the reader:
+ *
+ * 1. **No partial buckets.** A range ending "now" would otherwise end mid-day,
+ *    and today's third-of-a-day of traffic would be compared against whole days
+ *    — which reads as a collapse in every count metric, every morning. Flooring
+ *    `until` ends the window at the last *complete* bucket instead.
+ * 2. **Exact attribution.** A bucket is attributed to the window its **start**
+ *    falls in. With snapped bounds that is exact: every bucket lies wholly
+ *    inside one window, so no event is counted twice or split.
+ *
+ * The snapped bounds are echoed back in the response envelope (`format=table`
+ * and `format=summary` both carry `range`), so a caller can always see the
+ * window that was actually measured.
+ */
+import { type BucketGrain } from "./measures.js";
+/** Milliseconds in a day — the unit `baseline`'s `window` parameter counts in. */
+export declare const DAY_MS = 86400000;
+/** Default `baseline` window, in days. */
+export declare const DEFAULT_BASELINE_WINDOW_DAYS = 28;
+/** Largest `baseline` window a caller may ask for, in days. */
+export declare const MAX_BASELINE_WINDOW_DAYS = 365;
+/** Default `movers` range when the caller gives none, in days. */
+export declare const DEFAULT_MOVERS_RANGE_DAYS = 7;
+/** A resolved, bucket-aligned half-open window `[since, until)`. */
+export interface ResolvedWindow {
+    since: number;
+    until: number;
+}
+/** Floor an epoch-ms instant to the start of its bucket. */
+export declare function floorToBucket(epochMs: number, bucket: BucketGrain): number;
+/**
+ * Resolve `baseline`'s window.
+ *
+ * `until` defaults to the last complete bucket before `now`; `since` defaults to
+ * `window` days before that. An explicit `since` wins over `window` — the
+ * shorthand only fills in a bound the caller left out, so the two can never
+ * disagree about what was measured.
+ *
+ * The result is always non-empty: a range whose snapped bounds collapse (a
+ * `window` shorter than one bucket, or an inverted pair) is widened to the
+ * single bucket ending at `until`, so `baseline` answers with one bucket rather
+ * than with nothing.
+ */
+export declare function resolveBaselineWindow(opts: {
+    since?: number;
+    until?: number;
+    windowDays?: number;
+    bucket: BucketGrain;
+    now: number;
+}): ResolvedWindow;
+/**
+ * Resolve `movers`' current range and its reference.
+ *
+ * The range defaults to the last {@link DEFAULT_MOVERS_RANGE_DAYS} complete
+ * days. The reference defaults to **the equal window immediately before it**,
+ * which is what makes "what changed this week" mean week-on-week without the
+ * caller having to do date arithmetic. Either reference bound may be pinned
+ * explicitly; `refUntil` alone still implies an equal-length reference ending
+ * there.
+ */
+export declare function resolveMoversWindows(opts: {
+    since?: number;
+    until?: number;
+    refSince?: number;
+    refUntil?: number;
+    bucket: BucketGrain;
+    now: number;
+}): {
+    range: ResolvedWindow;
+    reference: ResolvedWindow;
+};
+/**
+ * The single range a bucket query has to cover to serve both windows.
+ *
+ * `movers` issues **one** bucket scan per metric rather than two, and splits the
+ * rows in TypeScript — halving the query count, and guaranteeing that both
+ * windows saw the same snapshot of the data even if events land mid-request.
+ */
+export declare function spanningWindow(a: ResolvedWindow, b: ResolvedWindow): ResolvedWindow;
+/** Whether a bucket start falls inside a half-open window. */
+export declare function inWindow(bucketStart: number, window: ResolvedWindow): boolean;
+//# sourceMappingURL=windows.d.ts.map

package/dist/insights/windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../src/insights/windows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,kFAAkF;AAClF,eAAO,MAAM,MAAM,WAAa,CAAC;AAEjC,0CAA0C;AAC1C,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAG1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,cAAc,CAMjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,cAAc,CAAA;CAAE,CAevD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,cAAc,CAEnF;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAE7E"}

package/dist/insights/windows.js

@@ -0,0 +1,97 @@
+/**
+ * **Window resolution** for the insight primitives (ADR 0051 §4, sketch §D).
+ *
+ * Both primitives take a time range the way the rest of the query surface does
+ * (`since` / `until`, epoch ms, lower-inclusive and upper-exclusive) and both
+ * add a shorthand on top — `window` days for `baseline`, an implicit "previous
+ * equal window" reference for `movers`. This module is the single place those
+ * shorthands become concrete milliseconds, so the route stays thin and the rules
+ * are unit-testable without a server.
+ *
+ * ## Windows are snapped to bucket boundaries
+ *
+ * Every resolved bound is floored to the bucket grain. Two reasons, and both are
+ * about not lying to the reader:
+ *
+ * 1. **No partial buckets.** A range ending "now" would otherwise end mid-day,
+ *    and today's third-of-a-day of traffic would be compared against whole days
+ *    — which reads as a collapse in every count metric, every morning. Flooring
+ *    `until` ends the window at the last *complete* bucket instead.
+ * 2. **Exact attribution.** A bucket is attributed to the window its **start**
+ *    falls in. With snapped bounds that is exact: every bucket lies wholly
+ *    inside one window, so no event is counted twice or split.
+ *
+ * The snapped bounds are echoed back in the response envelope (`format=table`
+ * and `format=summary` both carry `range`), so a caller can always see the
+ * window that was actually measured.
+ */
+import { BUCKET_SECONDS } from "./measures.js";
+/** Milliseconds in a day — the unit `baseline`'s `window` parameter counts in. */
+export const DAY_MS = 86_400_000;
+/** Default `baseline` window, in days. */
+export const DEFAULT_BASELINE_WINDOW_DAYS = 28;
+/** Largest `baseline` window a caller may ask for, in days. */
+export const MAX_BASELINE_WINDOW_DAYS = 365;
+/** Default `movers` range when the caller gives none, in days. */
+export const DEFAULT_MOVERS_RANGE_DAYS = 7;
+/** Floor an epoch-ms instant to the start of its bucket. */
+export function floorToBucket(epochMs, bucket) {
+    const width = BUCKET_SECONDS[bucket] * 1000;
+    return Math.floor(epochMs / width) * width;
+}
+/**
+ * Resolve `baseline`'s window.
+ *
+ * `until` defaults to the last complete bucket before `now`; `since` defaults to
+ * `window` days before that. An explicit `since` wins over `window` — the
+ * shorthand only fills in a bound the caller left out, so the two can never
+ * disagree about what was measured.
+ *
+ * The result is always non-empty: a range whose snapped bounds collapse (a
+ * `window` shorter than one bucket, or an inverted pair) is widened to the
+ * single bucket ending at `until`, so `baseline` answers with one bucket rather
+ * than with nothing.
+ */
+export function resolveBaselineWindow(opts) {
+    const width = BUCKET_SECONDS[opts.bucket] * 1000;
+    const until = floorToBucket(opts.until ?? opts.now, opts.bucket);
+    const days = opts.windowDays ?? DEFAULT_BASELINE_WINDOW_DAYS;
+    const since = floorToBucket(opts.since ?? until - days * DAY_MS, opts.bucket);
+    return since >= until ? { since: until - width, until } : { since, until };
+}
+/**
+ * Resolve `movers`' current range and its reference.
+ *
+ * The range defaults to the last {@link DEFAULT_MOVERS_RANGE_DAYS} complete
+ * days. The reference defaults to **the equal window immediately before it**,
+ * which is what makes "what changed this week" mean week-on-week without the
+ * caller having to do date arithmetic. Either reference bound may be pinned
+ * explicitly; `refUntil` alone still implies an equal-length reference ending
+ * there.
+ */
+export function resolveMoversWindows(opts) {
+    const width = BUCKET_SECONDS[opts.bucket] * 1000;
+    const until = floorToBucket(opts.until ?? opts.now, opts.bucket);
+    const sinceRaw = floorToBucket(opts.since ?? until - DEFAULT_MOVERS_RANGE_DAYS * DAY_MS, opts.bucket);
+    const since = sinceRaw >= until ? until - width : sinceRaw;
+    const span = until - since;
+    const refUntil = floorToBucket(opts.refUntil ?? since, opts.bucket);
+    const refSinceRaw = floorToBucket(opts.refSince ?? refUntil - span, opts.bucket);
+    const refSince = refSinceRaw >= refUntil ? refUntil - width : refSinceRaw;
+    return { range: { since, until }, reference: { since: refSince, until: refUntil } };
+}
+/**
+ * The single range a bucket query has to cover to serve both windows.
+ *
+ * `movers` issues **one** bucket scan per metric rather than two, and splits the
+ * rows in TypeScript — halving the query count, and guaranteeing that both
+ * windows saw the same snapshot of the data even if events land mid-request.
+ */
+export function spanningWindow(a, b) {
+    return { since: Math.min(a.since, b.since), until: Math.max(a.until, b.until) };
+}
+/** Whether a bucket start falls inside a half-open window. */
+export function inWindow(bucketStart, window) {
+    return bucketStart >= window.since && bucketStart < window.until;
+}
+//# sourceMappingURL=windows.js.map

package/dist/insights/windows.js.map

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

package/dist/metadata.d.ts

@@ -6,7 +6,7 @@
  * the scale-tier Postgres metadata clients reuse these, so the type contracts live
  * once and OSS carries no Postgres dependency.
  */
-import type { Aabb, SceneProxy } from "@uptimizr/schema";
+import type { Aabb, Annotation, AnnotationTargetKind, GlossaryEntry, MetadataAuthorKind, PanelSpecV1, SavedAnalysis, SavedAnalysisQuery, SceneProxy } from "@uptimizr/schema";
 /** SHA-256 hash of an API key. Only the hash is ever stored (never plaintext). */
 export declare function hashApiKey(plaintext: string): string;
 /** Display prefix used to identify a key without revealing it. */
@@ -267,4 +267,181 @@ export interface SceneRepresentationSummary {
     capturedAt: Date | null;
     updatedAt: Date;
 }
+/**
+ * The storage projections of `@uptimizr/schema`'s metadata contracts
+ * (sketch §E.2). The wire shapes live once, in the schema package; these add
+ * only what the *row* knows and the client cannot set — the generated id, who
+ * wrote it, and when.
+ *
+ * Every one of these tables is **project-scoped, bounded and audited**. They
+ * are the only writable surface besides ingestion, they never touch the events
+ * tables, and the `annotate` capability gates each write (ADR 0051 §7/§9).
+ */
+/** Who wrote a metadata row — derived by the collector, never by the payload. */
+export type { MetadataAuthorKind };
+/** What an annotation is about — re-exported so stores need one import. */
+export type { AnnotationTargetKind };
+/**
+ * Attribution attached to every metadata write: the kind of author the
+ * collector decided on, and the id of the API key that carried the request
+ * (never the key or its hash — ADR 0003). `authorKeyId` is null only for rows
+ * written by a store's own tooling (seeding, tests).
+ */
+export interface MetadataAuthor {
+    authorKind: MetadataAuthorKind;
+    authorKeyId: string | null;
+}
+/** One stored annotation. */
+export interface AnnotationRecord extends MetadataAuthor {
+    id: string;
+    projectId: string;
+    targetKind: AnnotationTargetKind;
+    targetId: string | null;
+    /** Start of the annotated period, or null for a standing note. */
+    since: Date | null;
+    /** End of the annotated period, or null for an open-ended / instant note. */
+    until: Date | null;
+    text: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** What a caller supplies to create an annotation; the store fills id and times. */
+export interface CreateAnnotationInput extends MetadataAuthor {
+    annotation: Annotation;
+}
+/**
+ * Filters for the annotation read path. All optional: the unfiltered call is
+ * "the project's recent annotations", which is what the dashboard time axis and
+ * the project context document both ask for.
+ */
+export interface ListAnnotationsOptions {
+    /** Only annotations about this kind of thing. */
+    targetKind?: AnnotationTargetKind;
+    /** Only annotations about this specific scene/mesh/region/metric. */
+    targetId?: string;
+    /**
+     * Overlap filter, epoch ms: keep annotations whose period intersects
+     * `[since, until)`. A standing note (no period) always matches — it is about
+     * the project as a whole, not about a moment.
+     */
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+/** One stored glossary entry. Identity is `(projectId, term)`. */
+export interface GlossaryEntryRecord {
+    projectId: string;
+    term: string;
+    meaning: string;
+    updatedAt: Date;
+}
+/** What a caller supplies to upsert a glossary entry. */
+export interface PutGlossaryEntryInput {
+    entry: GlossaryEntry;
+}
+/** One stored saved analysis. */
+export interface SavedAnalysisRecord extends MetadataAuthor {
+    id: string;
+    projectId: string;
+    title: string;
+    /** The stored question, parsed back from its JSON column. */
+    query: SavedAnalysisQuery;
+    conclusion: string | null;
+    createdAt: Date;
+}
+/** What a caller supplies to create a saved analysis. */
+export interface CreateSavedAnalysisInput extends MetadataAuthor {
+    analysis: SavedAnalysis;
+}
+/** Row cap for a list read, shared by every metadata list endpoint. */
+export interface MetadataListOptions {
+    limit?: number;
+}
+/**
+ * Per-project row caps (ADR 0051 §5). Metadata is a curated set of notes, so
+ * every store refuses the write that would exceed its table's cap rather than
+ * silently growing. The numbers live in `@uptimizr/schema`'s `LIMITS` with the
+ * rest of the wire bounds; this is the storage-side view of them.
+ */
+export declare const METADATA_LIMITS: {
+    readonly annotations: 500;
+    readonly glossary: 200;
+    readonly savedAnalyses: 200;
+    readonly panelSpecs: 50;
+};
+/** Which metadata table a {@link MetadataLimitError} is about. */
+export type MetadataTable = keyof typeof METADATA_LIMITS;
+/**
+ * Thrown by a store when a write would take a project past the table's cap.
+ * The collector maps it to `409 Conflict` — the request was well-formed, the
+ * project is simply full, and the caller fixes it by deleting something.
+ */
+export declare class MetadataLimitError extends Error {
+    readonly table: MetadataTable;
+    readonly limit: number;
+    constructor(table: MetadataTable, limit: number);
+}
+/**
+ * Clamp a caller-supplied `limit` into `[1, max]`, defaulting when absent.
+ * Shared by every store so one engine cannot quietly return more rows than
+ * another for the same request.
+ */
+export declare function clampMetadataLimit(limit: number | undefined, fallback?: number, max?: number): number;
+/**
+ * Parse a stored `query` JSON column back into an object. A row written by this
+ * collector always parses; a hand-edited or truncated one degrades to `{}`
+ * rather than failing the whole listing.
+ */
+export declare function parseSavedAnalysisQuery(json: string): SavedAnalysisQuery;
+/**
+ * One stored panel spec: what the dashboard draws, who pinned it, and when.
+ *
+ * The spec itself lives in a single JSON `spec` column, for the same reason a
+ * subscription's declaration does: it is a closed document validated at the
+ * request boundary (`panelSpecV1Schema` for the shape, `validatePanelSpec` for
+ * the vocabulary) and never queried *into*. The columns beside it are exactly
+ * what the store must filter (`project_id`), order (`created_at`) and address
+ * (`id`) — nothing about the chart or the query is promoted, because no read
+ * path asks a database about it.
+ */
+export interface PanelSpecRecord extends MetadataAuthor {
+    id: string;
+    projectId: string;
+    /** The stored spec, parsed back from its JSON column. */
+    spec: PanelSpecV1;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** What a caller supplies to pin a panel; the store fills id and timestamps. */
+export interface CreatePanelSpecInput extends MetadataAuthor {
+    spec: PanelSpecV1;
+}
+/**
+ * What a caller supplies to replace a pinned panel's spec.
+ *
+ * Authorship is deliberately **not** part of an update: the row keeps the
+ * `authorKind` / `authorKeyId` it was created with. Who pinned a panel is a
+ * fact about when it appeared on somebody's dashboard, and an edit does not
+ * change that — mirroring how the annotation rows keep their original author
+ * across an edit of the note.
+ */
+export interface UpdatePanelSpecInput {
+    spec: PanelSpecV1;
+}
+/**
+ * Parse a stored `spec` JSON column back into a document.
+ *
+ * Returns `null` rather than a partial object when the text is not a JSON
+ * object at all: unlike a saved analysis' opaque `query` — which degrades to
+ * `{}` because it is stored but never interpreted — a panel spec is *rendered*,
+ * so a row that cannot be one is better skipped than drawn. The listing drops
+ * it and the rest of the grid is unaffected, which is the same posture
+ * `loadSpecPanels` takes in `@uptimizr/react`.
+ *
+ * The result is typed as the wire shape but **not** re-validated here: a store
+ * is not the boundary, and re-running Zod on every row of every listing would
+ * pay the validation cost on the read path for a document the write path
+ * already checked. The renderer validates what it is about to draw.
+ */
+export declare function parsePanelSpec(json: string): PanelSpecV1 | null;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

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