@saihm/shm 0.0.0-stage → 0.38.0

package/dist/saihm_client/server_features.js

@@ -0,0 +1,415 @@
+export const SERVER_FEATURE_NAMES = Object.freeze(["events", "warmStart", "replicas", "capacity"]);
+export const READ_VERSION = 1;
+export const MAX_LIST_ENTRIES = 64;
+export const MAX_LABEL_LENGTH = 64;
+export const MAX_REPORT_PATH_LENGTH = 256;
+export const MAX_DURATION_LENGTH = 64;
+export const FAST_TIERS = Object.freeze(["PRO_FAST", "ENTERPRISE_FAST"]);
+export const OWN_CELL_EVENT_KINDS = Object.freeze(["cell-written", "cell-erased"]);
+export const WARM_START_TOKEN = "required";
+const STATUS_ROOT = "status result";
+const INFO_ROOT = "info document";
+const NOT_A_LABEL = `is not a name of 1 to ${MAX_LABEL_LENGTH} printable ASCII characters`;
+class FieldError {
+    field;
+    reason;
+    constructor(field, reason) {
+        this.field = field;
+        this.reason = reason;
+    }
+}
+function fail(field, what) {
+    throw new FieldError(field, `${field} ${what}`);
+}
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const own = (o, key) => (Object.hasOwn(o, key) ? o[key] : undefined);
+const isPositiveWhole = (x) => Number.isSafeInteger(x) && x > 0;
+const isNonNegativeWhole = (x) => Number.isSafeInteger(x) && x >= 0;
+const isNonNegativeFinite = (x) => typeof x === "number" && Number.isFinite(x) && x >= 0;
+const isPercentile = (x) => typeof x === "number" && Number.isFinite(x) && x > 0 && x <= 100;
+const PRINTABLE_TRIMMED = /^[\x21-\x7E](?:[\x20-\x7E]*[\x21-\x7E])?$/;
+export function isFeatureLabel(s) {
+    return typeof s === "string" && s.length <= MAX_LABEL_LENGTH && PRINTABLE_TRIMMED.test(s);
+}
+const available = (value) => Object.freeze({ kind: "available", value });
+const absent = (reason) => Object.freeze({ kind: "absent", reason });
+const unsupported = (reason) => Object.freeze({ kind: "unsupported-version", reason });
+const malformed = (field, reason) => Object.freeze({ kind: "malformed", field, reason });
+const unusable = (rule, reason) => Object.freeze({ kind: "unusable", rule, reason });
+function guard(path, read) {
+    try {
+        return read();
+    }
+    catch (e) {
+        if (e instanceof FieldError)
+            return malformed(e.field, e.reason);
+        return malformed(path, `${path} could not be read`);
+    }
+}
+function required(o, path, key) {
+    const v = own(o, key);
+    if (v === undefined)
+        fail(`${path}.${key}`, "is missing");
+    return v;
+}
+function versions(o, path) {
+    const field = `${path}.v`;
+    const v = required(o, path, "v");
+    if (!Array.isArray(v))
+        fail(field, "is not a list of versions");
+    if (v.length > MAX_LIST_ENTRIES)
+        fail(field, `holds more than ${MAX_LIST_ENTRIES} entries`);
+    const out = [];
+    for (let i = 0; i < v.length; i++) {
+        const x = v[i];
+        if (!isPositiveWhole(x))
+            fail(`${field}[${i}]`, "is not a positive whole number");
+        out.push(x);
+    }
+    return Object.freeze(out);
+}
+function wholeNumber(o, path, key) {
+    const v = required(o, path, key);
+    if (!isNonNegativeWhole(v))
+        fail(`${path}.${key}`, "is not a non-negative whole number");
+    return v;
+}
+function nullableWholeNumber(o, path, key) {
+    const v = required(o, path, key);
+    if (v === null)
+        return null;
+    if (!isNonNegativeWhole(v))
+        fail(`${path}.${key}`, "is not null or a non-negative whole number");
+    return v;
+}
+function positiveWholeNumber(o, path, key) {
+    const v = required(o, path, key);
+    if (!isPositiveWhole(v))
+        fail(`${path}.${key}`, "is not a positive whole number");
+    return v;
+}
+function nonNegativeNumber(o, path, key) {
+    const v = required(o, path, key);
+    if (!isNonNegativeFinite(v))
+        fail(`${path}.${key}`, "is not a finite, non-negative number");
+    return v;
+}
+function percentileOf(o, path, key) {
+    const v = required(o, path, key);
+    if (!isPercentile(v))
+        fail(`${path}.${key}`, "is not a finite number above 0 and at most 100");
+    return v;
+}
+function flag(o, path, key) {
+    const v = required(o, path, key);
+    if (typeof v !== "boolean")
+        fail(`${path}.${key}`, "is not true or false");
+    return v;
+}
+function nullableFlag(o, path, key) {
+    const v = required(o, path, key);
+    if (v === null)
+        return null;
+    if (typeof v !== "boolean")
+        fail(`${path}.${key}`, "is not true, false or null");
+    return v;
+}
+function label(o, path, key) {
+    const v = required(o, path, key);
+    if (!isFeatureLabel(v))
+        fail(`${path}.${key}`, NOT_A_LABEL);
+    return v;
+}
+function labels(o, path, key, isRequired) {
+    const field = `${path}.${key}`;
+    const v = own(o, key);
+    if (v === undefined || (v === null && !isRequired)) {
+        if (isRequired)
+            fail(field, "is missing");
+        return null;
+    }
+    if (!Array.isArray(v))
+        fail(field, "is not a list");
+    if (v.length > MAX_LIST_ENTRIES)
+        fail(field, `holds more than ${MAX_LIST_ENTRIES} entries`);
+    const out = [];
+    for (let i = 0; i < v.length; i++) {
+        const x = v[i];
+        if (!isFeatureLabel(x))
+            fail(`${field}[${i}]`, NOT_A_LABEL);
+        out.push(x);
+    }
+    return Object.freeze(out);
+}
+const HOUR_MS = 3_600_000;
+const DAY_MS = 24 * HOUR_MS;
+const WINDOW = /^P(?:([1-9][0-9]*)D|T([1-9][0-9]*)H)$/;
+function windowOf(o, path, key) {
+    const field = `${path}.${key}`;
+    const v = required(o, path, key);
+    if (typeof v !== "string")
+        fail(field, "is not a string");
+    const m = v.length <= MAX_DURATION_LENGTH ? WINDOW.exec(v) : null;
+    if (m === null)
+        fail(field, "is not a whole number of days (PnD) or of hours (PTnH), above zero");
+    const ms = m[1] !== undefined ? Number(m[1]) * DAY_MS : Number(m[2]) * HOUR_MS;
+    if (!Number.isSafeInteger(ms))
+        fail(field, "is longer than an exact whole number of milliseconds can state");
+    return { text: v, ms };
+}
+const ISO_UTC = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?Z$/;
+function utcTime(o, path, key) {
+    const field = `${path}.${key}`;
+    const v = required(o, path, key);
+    if (typeof v !== "string" || !ISO_UTC.test(v))
+        fail(field, "is not an ISO-8601 UTC time");
+    const t = Date.parse(v);
+    if (!Number.isFinite(t) || new Date(t).toISOString().slice(0, 19) !== v.slice(0, 19))
+        fail(field, "is not a real calendar time");
+    return { text: v, ms: t };
+}
+const SAME_ORIGIN_PATH = /^\/(?!\/)(?:[A-Za-z0-9\-._~!$&'()*+,;=:@/]|%[0-9A-Fa-f]{2})*$/;
+function optionalOriginPath(o, path, key) {
+    const v = own(o, key);
+    if (v === undefined || v === null)
+        return null;
+    if (typeof v !== "string" || v.length > MAX_REPORT_PATH_LENGTH || !SAME_ORIGIN_PATH.test(v)) {
+        fail(`${path}.${key}`, `is not a path on the service's own origin of at most ${MAX_REPORT_PATH_LENGTH} characters`);
+    }
+    return v;
+}
+const UNUSABLE_BECAUSE = Object.freeze({
+    "fast-tier-only": `is offered only on the Fast tiers (${FAST_TIERS.join(", ")}), and the status result names none of them as this identity's tier`,
+    "needs-own-cell-events": `is usable only together with own-cell events, and features.events does not offer both ${OWN_CELL_EVENT_KINDS.join(" and ")}`,
+    "needs-token": `is usable only when its token member is "${WARM_START_TOKEN}" (a client that names its payload files per call), and it is not`,
+});
+function readFeature(features, name, read, forbiddenBy = null, objectRule) {
+    const path = `features.${name}`;
+    return guard(path, () => {
+        const raw = own(features, name);
+        if (raw === undefined)
+            return absent(`${path} is missing: this identity cannot use the feature`);
+        if (raw === null)
+            return absent(`${path} is null: this identity cannot use the feature`);
+        if (forbiddenBy !== null)
+            return unusable(forbiddenBy, `${path} ${UNUSABLE_BECAUSE[forbiddenBy]}: this identity cannot use it`);
+        if (!isObject(raw))
+            fail(path, "is not an object");
+        const v = versions(raw, path);
+        if (!v.includes(READ_VERSION))
+            return unsupported(`${path}.v does not list version ${READ_VERSION}, the only version this release reads`);
+        const ruled = objectRule?.(raw) ?? null;
+        if (ruled !== null)
+            return unusable(ruled, `${path} ${UNUSABLE_BECAUSE[ruled]}: this identity cannot use it`);
+        return available(read(raw, path, v));
+    });
+}
+function namesFastTier(statusResult) {
+    try {
+        const tier = own(statusResult, "tier");
+        return typeof tier === "string" && FAST_TIERS.includes(tier);
+    }
+    catch {
+        return false;
+    }
+}
+const readEvents = (o, path, v) => {
+    const kinds = labels(o, path, "kinds", false);
+    return Object.freeze({ v, kinds, ownCellEvents: kinds !== null && OWN_CELL_EVENT_KINDS.every((k) => kinds.includes(k)) });
+};
+const warmStartTokenRule = (o) => (own(o, "token") === WARM_START_TOKEN ? null : "needs-token");
+const readWarmStart = (o, path, v) => Object.freeze({
+    v,
+    token: WARM_START_TOKEN,
+    maxBytes: wholeNumber(o, path, "maxBytes"),
+    maxSnapshots: wholeNumber(o, path, "maxSnapshots"),
+    retentionS: wholeNumber(o, path, "retentionS"),
+});
+function fenceMode(o, path, key) {
+    const v = required(o, path, key);
+    if (v !== "synchronous" && v !== "bounded")
+        fail(`${path}.${key}`, 'is not "synchronous" or "bounded", the two fence modes this release reads');
+    return v;
+}
+const readReplicas = (o, path, v) => Object.freeze({ v, maxStalenessMs: wholeNumber(o, path, "maxStalenessMs"), erasureFence: fenceMode(o, path, "erasureFence") });
+const readCapacity = (o, path, v) => {
+    const reserved = flag(o, path, "reserved");
+    const unit = label(o, path, "unit");
+    if (reserved) {
+        const value = {
+            v,
+            reserved: true,
+            unit,
+            rate: nonNegativeNumber(o, path, "rate"),
+            burst: wholeNumber(o, path, "burst"),
+            objectiveApplies: flag(o, path, "objectiveApplies"),
+            attainment: readAttainment(o, path),
+        };
+        return Object.freeze(value);
+    }
+    for (const key of ["rate", "burst"]) {
+        if (required(o, path, key) !== null)
+            fail(`${path}.${key}`, "is not null, as it must be when reserved is false");
+    }
+    if (required(o, path, "objectiveApplies") !== false)
+        fail(`${path}.objectiveApplies`, "is not false, as it must be when reserved is false");
+    const value = { v, reserved: false, unit, rate: null, burst: null, objectiveApplies: false, attainment: readAttainment(o, path) };
+    return Object.freeze(value);
+};
+function readAttainment(capacity, capacityPath) {
+    const path = `${capacityPath}.attainment`;
+    return guard(path, () => {
+        const raw = own(capacity, "attainment");
+        if (raw === undefined)
+            return absent(`${path} is missing: the service stated no attainment for this identity`);
+        if (raw === null)
+            return absent(`${path} is null: the service stated no attainment for this identity`);
+        if (!isObject(raw))
+            fail(path, "is not an object");
+        const v = required(raw, path, "v");
+        if (!isPositiveWhole(v))
+            fail(`${path}.v`, "is not a positive whole number");
+        if (v !== READ_VERSION)
+            return unsupported(`${path}.v is not ${READ_VERSION}, the only report version this release reads`);
+        const window = windowOf(raw, path, "window");
+        const asOf = utcTime(raw, path, "asOf");
+        const operations = attainmentEntries(raw, path);
+        return available(Object.freeze({ v, window: window.text, windowMs: window.ms, asOf: asOf.text, asOfMs: asOf.ms, operations }));
+    });
+}
+function attainmentEntries(o, path) {
+    const field = `${path}.operations`;
+    const list = required(o, path, "operations");
+    if (!Array.isArray(list))
+        fail(field, "is not a list");
+    if (list.length > MAX_LIST_ENTRIES)
+        fail(field, `holds more than ${MAX_LIST_ENTRIES} entries`);
+    const out = [];
+    const seen = new Set();
+    for (let i = 0; i < list.length; i++) {
+        const at = `${field}[${i}]`;
+        const e = list[i];
+        if (!isObject(e))
+            fail(at, "is not an object");
+        const operation = label(e, at, "operation");
+        const percentile = percentileOf(e, at, "percentile");
+        const thresholdMs = positiveWholeNumber(e, at, "thresholdMs");
+        const samples = wholeNumber(e, at, "samples");
+        const observedMs = nullableWholeNumber(e, at, "observedMs");
+        if (observedMs !== null && samples === 0)
+            fail(`${at}.observedMs`, "is stated, but samples is 0: an operation with no traffic has no figure");
+        const met = nullableFlag(e, at, "met");
+        let entry;
+        if (observedMs === null || met === null) {
+            if (observedMs !== met)
+                fail(`${at}.met`, "is stated where observedMs is null, or null where observedMs is stated");
+            entry = { operation, percentile, thresholdMs, samples, observedMs: null, met: null };
+        }
+        else {
+            if (met !== observedMs <= thresholdMs)
+                fail(`${at}.met`, "contradicts the entry's own figures: met is observedMs <= thresholdMs");
+            entry = { operation, percentile, thresholdMs, samples, observedMs, met };
+        }
+        const key = `${operation}\n${percentile}`;
+        if (seen.has(key))
+            fail(at, "repeats an operation and percentile stated earlier in the list");
+        seen.add(key);
+        out.push(Object.freeze(entry));
+    }
+    return Object.freeze(out);
+}
+export function parseServerFeatures(statusResult) {
+    const all = (r) => Object.freeze({ events: r, warmStart: r, replicas: r, capacity: r });
+    let features;
+    try {
+        if (!isObject(statusResult))
+            return all(malformed(STATUS_ROOT, `the ${STATUS_ROOT} is not an object`));
+    }
+    catch {
+        return all(malformed(STATUS_ROOT, `the ${STATUS_ROOT} could not be read`));
+    }
+    try {
+        features = own(statusResult, "features");
+        if (features !== undefined && features !== null && !isObject(features))
+            return all(malformed("features", "features is not an object"));
+    }
+    catch {
+        return all(malformed("features", "features could not be read"));
+    }
+    if (features === undefined) {
+        return all(absent(`the ${STATUS_ROOT} carries no features object: a server that predates feature discovery offers none of the four`));
+    }
+    if (features === null)
+        return all(absent("features is null: this identity can use none of the four"));
+    const f = features;
+    const fastTier = namesFastTier(statusResult);
+    const events = readFeature(f, "events", readEvents);
+    const ownCellEvents = events.kind === "available" && events.value.ownCellEvents;
+    return Object.freeze({
+        events,
+        warmStart: readFeature(f, "warmStart", readWarmStart, ownCellEvents ? null : "needs-own-cell-events", warmStartTokenRule),
+        replicas: readFeature(f, "replicas", readReplicas, fastTier ? null : "fast-tier-only"),
+        capacity: readFeature(f, "capacity", readCapacity, fastTier ? null : "fast-tier-only"),
+    });
+}
+function objectiveEntries(o, path) {
+    const field = `${path}.objectives`;
+    const list = required(o, path, "objectives");
+    if (!Array.isArray(list))
+        fail(field, "is not a list");
+    if (list.length === 0)
+        fail(field, "is empty: it states no objective");
+    if (list.length > MAX_LIST_ENTRIES)
+        fail(field, `holds more than ${MAX_LIST_ENTRIES} entries`);
+    const out = [];
+    const seen = new Set();
+    for (let i = 0; i < list.length; i++) {
+        const at = `${field}[${i}]`;
+        const e = list[i];
+        if (!isObject(e))
+            fail(at, "is not an object");
+        const operation = label(e, at, "operation");
+        const percentile = percentileOf(e, at, "percentile");
+        const thresholdMs = positiveWholeNumber(e, at, "thresholdMs");
+        const key = `${operation}\n${percentile}`;
+        if (seen.has(key))
+            fail(at, "repeats an operation and percentile stated earlier in the list");
+        seen.add(key);
+        out.push(Object.freeze({ operation, percentile, thresholdMs }));
+    }
+    return Object.freeze(out);
+}
+export function parseLatencyObjective(infoDocument) {
+    const path = "latencyObjective";
+    let raw;
+    try {
+        if (!isObject(infoDocument))
+            return malformed(INFO_ROOT, `the ${INFO_ROOT} is not an object`);
+        raw = own(infoDocument, path);
+    }
+    catch {
+        return malformed(INFO_ROOT, `the ${INFO_ROOT} could not be read`);
+    }
+    if (raw === undefined)
+        return absent(`the ${INFO_ROOT} carries no ${path}: no objective exists, and none may be stated`);
+    if (raw === null)
+        return absent(`${path} is null: no objective exists, and none may be stated`);
+    return guard(path, () => {
+        if (!isObject(raw))
+            fail(path, "is not an object");
+        const v = versions(raw, path);
+        if (!v.includes(READ_VERSION))
+            return unsupported(`${path}.v does not list version ${READ_VERSION}, the only version this release reads`);
+        const window = windowOf(raw, path, "window");
+        const measured = required(raw, path, "measured");
+        if (typeof measured !== "string")
+            fail(`${path}.measured`, "is not a string");
+        if (measured !== "service")
+            fail(`${path}.measured`, "names a point other than the service, the only one this release can compare against");
+        const objectives = objectiveEntries(raw, path);
+        const tiers = labels(raw, path, "tiers", true) ?? fail(`${path}.tiers`, "is missing");
+        const reportPath = optionalOriginPath(raw, path, "reportPath");
+        return available(Object.freeze({ v, window: window.text, windowMs: window.ms, measured: "service", objectives, tiers, reportPath }));
+    });
+}
+//# sourceMappingURL=server_features.js.map

package/dist/saihm_client/server_features.js.map

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

package/dist/saihm_client/share_guard.d.ts

@@ -0,0 +1,9 @@
+import type { ShareOptions, ShareRecipient, ShareScope } from "./types.js";
+export declare const EPOCH_HOUR_MS = 3600000;
+export declare const MAX_EXPIRY_HOURS_AHEAD = 1000000;
+export declare function hourEpochNow(nowMs?: number): number;
+export declare function expiryEpochHoursFromNow(hours: number, nowMs?: number): string;
+export declare function guardExpiry(expiryEpoch: string | undefined, nowHours: number): void;
+export declare function guardShare(recipient: ShareRecipient, scope: ShareScope, opts?: ShareOptions, nowMs?: number): string;
+export declare function guardContent(content: string, maxChars: number): string;
+//# sourceMappingURL=share_guard.d.ts.map

package/dist/saihm_client/share_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share_guard.d.ts","sourceRoot":"","sources":["../../src/saihm_client/share_guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM3E,eAAO,MAAM,aAAa,UAAY,CAAC;AACvC,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAEhD,wBAAgB,YAAY,CAAC,KAAK,GAAE,MAAmB,GAAG,MAAM,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,CAGzF;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAcnF;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,YAAiB,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,CAYpI;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKtE"}

package/dist/saihm_client/share_guard.js

@@ -0,0 +1,53 @@
+import { verifyBinding } from "../coordination/identity.js";
+import { SaihmTransportError } from "./types.js";
+const HEX64 = /^[0-9a-f]{64}$/;
+const SCOPES = new Set(["read", "write", "readwrite"]);
+export const EPOCH_HOUR_MS = 3_600_000;
+export const MAX_EXPIRY_HOURS_AHEAD = 1_000_000;
+export function hourEpochNow(nowMs = Date.now()) {
+    return Math.floor(nowMs / EPOCH_HOUR_MS);
+}
+export function expiryEpochHoursFromNow(hours, nowMs = Date.now()) {
+    if (!Number.isInteger(hours) || hours < 1)
+        throw new RangeError(`expiryEpochHoursFromNow: hours must be a positive integer, got ${String(hours)}`);
+    return String(hourEpochNow(nowMs) + hours);
+}
+export function guardExpiry(expiryEpoch, nowHours) {
+    if (expiryEpoch === undefined)
+        return;
+    if (typeof expiryEpoch !== "string" || !/^[0-9]{1,20}$/.test(expiryEpoch)) {
+        throw new SaihmTransportError(`share refused: expiryEpoch must be a decimal count of HOURS since 1970, got ${JSON.stringify(expiryEpoch)}`);
+    }
+    const e = Number(expiryEpoch);
+    if (e <= nowHours) {
+        throw new SaihmTransportError(`share refused: expiryEpoch ${expiryEpoch} is not in the future (the protocol's hour is ${nowHours}) — the grant would lapse at once`);
+    }
+    if (e > nowHours + MAX_EXPIRY_HOURS_AHEAD) {
+        throw new SaihmTransportError(`share refused: expiryEpoch ${expiryEpoch} is more than ${MAX_EXPIRY_HOURS_AHEAD} hours ahead — the protocol counts HOURS since 1970 (now ${nowHours}), so this reads as seconds or milliseconds and the grant would never lapse; write it as expiryEpochHoursFromNow(hours)`);
+    }
+}
+export function guardShare(recipient, scope, opts = {}, nowMs = Date.now()) {
+    const id = typeof recipient.agentIdHash === "string" ? recipient.agentIdHash.trim().toLowerCase() : "";
+    if (!HEX64.test(id)) {
+        throw new SaihmTransportError(`share refused: recipient agentIdHash is not 64 hex characters (${JSON.stringify(recipient.agentIdHash)})`);
+    }
+    if (!SCOPES.has(scope))
+        throw new SaihmTransportError(`share refused: unknown scope ${JSON.stringify(scope)}`);
+    if (recipient.record !== undefined) {
+        const v = verifyBinding(id, recipient.record);
+        if (!v.ok)
+            throw new SaihmTransportError(`share refused: recipient record does not bind to ${id.slice(0, 8)}… — ${v.reason}`);
+    }
+    guardExpiry(opts.expiryEpoch, hourEpochNow(nowMs));
+    return id;
+}
+export function guardContent(content, maxChars) {
+    if (typeof content !== "string" || content.trim() === "")
+        throw new SaihmTransportError("remember refused: empty content");
+    if (content.includes("\u0000"))
+        throw new SaihmTransportError("remember refused: content contains a NUL byte");
+    if (content.length > maxChars)
+        throw new SaihmTransportError(`remember refused: content is ${content.length} chars, over the ${maxChars} limit for this transport`);
+    return content;
+}
+//# sourceMappingURL=share_guard.js.map

package/dist/saihm_client/share_guard.js.map

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

package/dist/saihm_client/timing.d.ts

@@ -0,0 +1,100 @@
+import { type LatencyObjective } from "./server_features.js";
+export type Admission = "reserved" | "shared";
+export interface Timing {
+    readonly serverMs: number | null;
+    readonly totalMs: number;
+    readonly admission: Admission | null;
+}
+export type TimingRead = {
+    readonly kind: "present";
+    readonly timing: Timing;
+} | {
+    readonly kind: "absent";
+    readonly reason: string;
+} | {
+    readonly kind: "malformed";
+    readonly field: string;
+    readonly reason: string;
+};
+export declare const DEFAULT_SAMPLES_PER_OPERATION = 4096;
+export declare const DEFAULT_MAX_OPERATIONS = 32;
+export declare const SAMPLES_PER_OPERATION_LIMIT = 1048576;
+export declare const OPERATIONS_LIMIT = 1024;
+export declare const DEFAULT_MIN_ATTAINMENT_SAMPLES = 20;
+export declare function parseTiming(toolResult: unknown): TimingRead;
+export declare function nearestRank(n: number, p: number): number;
+export interface Percentiles {
+    readonly n: number;
+    readonly p50: number;
+    readonly p95: number;
+    readonly p99: number;
+}
+export interface AdmissionCounts {
+    readonly all: number;
+    readonly reserved: number;
+    readonly shared: number;
+    readonly unknown: number;
+}
+export interface OperationTimingReport {
+    readonly operation: string;
+    readonly counts: AdmissionCounts;
+    readonly totalMs: Percentiles | null;
+    readonly serverMs: Percentiles | null;
+    readonly networkMs: Percentiles | null;
+    readonly windowHeld: boolean;
+}
+export type RecordRefusal = "operation" | "timing" | "time" | "operation-limit";
+export type RecordOutcome = {
+    readonly recorded: true;
+} | {
+    readonly recorded: false;
+    readonly refusal: RecordRefusal;
+};
+export interface TimingReport {
+    readonly fromMs: number;
+    readonly toMs: number;
+    readonly operations: readonly OperationTimingReport[];
+    readonly refused: {
+        readonly operation: number;
+        readonly timing: number;
+        readonly time: number;
+        readonly operationLimit: number;
+    };
+}
+export type AttainmentGap = "no-reserved-samples" | "insufficient-samples" | "window-not-held" | "entry-unusable";
+interface AttainmentBase {
+    readonly operation: string;
+    readonly percentile: number;
+    readonly thresholdMs: number;
+    readonly n: number;
+}
+export type ObjectiveAttainment = (AttainmentBase & {
+    readonly observedMs: number;
+    readonly met: boolean;
+}) | (AttainmentBase & {
+    readonly observedMs: null;
+    readonly met: null;
+    readonly reason: AttainmentGap;
+});
+export interface TimingCollectorOptions {
+    readonly samplesPerOperation?: number;
+    readonly maxOperations?: number;
+}
+export interface AttainmentOptions {
+    readonly minSamples?: number;
+}
+export declare class TimingCollector {
+    readonly samplesPerOperation: number;
+    readonly maxOperations: number;
+    private readonly rings;
+    private readonly refusals;
+    constructor(opts?: TimingCollectorOptions);
+    private refuse;
+    record(operation: string, timing: Timing, atMs: number): RecordOutcome;
+    report(nowMs: number, windowMs: number): TimingReport;
+    private summarize;
+    attainment(objective: LatencyObjective, nowMs: number, opts?: AttainmentOptions): readonly ObjectiveAttainment[];
+    private judge;
+}
+export {};
+//# sourceMappingURL=timing.d.ts.map

package/dist/saihm_client/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/saihm_client/timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,2BAA2B,UAAY,CAAC;AACrD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AASjD,wBAAgB,WAAW,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAyB3D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxD;AAGD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAEhF,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAExH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACnI;AAED,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,UAAU,cAAc;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B,CAAC,cAAc,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,GACzE,CAAC,cAAc,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAEzG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAkED,qBAAa,eAAe;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2D;gBAExE,IAAI,GAAE,sBAA2B;IAK7C,OAAO,CAAC,MAAM;IAMd,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa;IA0BtE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAUrD,OAAO,CAAC,SAAS;IAgCjB,UAAU,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,SAAS,mBAAmB,EAAE;IAgBpH,OAAO,CAAC,KAAK;CA6Bd"}