@oneuptime/common 12.0.32 → 12.0.34

package/build/dist/Types/Rum/SessionReplay.js

@@ -130,6 +130,100 @@ export const SESSION_REPLAY_ALLOWED_RETENTION_DAYS = [
  * is itself a privacy control.
  */
 export const DEFAULT_SESSION_REPLAY_RETENTION_IN_DAYS = 7;
+/*
+ * ---- Caps on host-page supplied strings (identify / setTags / track). ----
+ *
+ * Every one of these is enforced twice, on the client before the bytes
+ * leave the page and again at ingest, and the two sides MUST agree: a
+ * recorder that sends more than the server keeps produces silent
+ * truncation nobody can explain from the dashboard, and a server that
+ * keeps more than the recorder sends is a cap that protects nothing. The
+ * numbers are small on purpose. These maps ride on the header row of a
+ * ReplacingMergeTree that is rewritten by the finalizer, so every byte
+ * here is merge amplification, and they are rendered in list cells that
+ * have to stay one line.
+ */
+/* identify(ref, traits): the traits map. */
+export const SESSION_REPLAY_MAX_TRAIT_KEYS = 20;
+export const SESSION_REPLAY_MAX_TRAIT_KEY_LENGTH = 40;
+export const SESSION_REPLAY_MAX_TRAIT_VALUE_LENGTH = 200;
+/*
+ * setTags()/addTag(): tighter than traits because tags are indexed for the
+ * tag:key=value search and shown as pills, where a 200-character value is
+ * unreadable anyway.
+ */
+export const SESSION_REPLAY_MAX_TAG_KEYS = 20;
+export const SESSION_REPLAY_MAX_TAG_KEY_LENGTH = 32;
+export const SESSION_REPLAY_MAX_TAG_VALUE_LENGTH = 128;
+/*
+ * track(name, properties): a custom event's name is a rail row title, and
+ * its properties map shares the trait caps for key/value length.
+ */
+export const SESSION_REPLAY_MAX_CUSTOM_EVENT_NAME_LENGTH = 64;
+export const SESSION_REPLAY_MAX_CUSTOM_EVENT_PROPERTY_KEYS = 20;
+/*
+ * Per-CHUNK caps on the two custom-event kinds the host page can fire in a
+ * loop. Per chunk rather than per session so a long session keeps
+ * recording interactions after a busy minute; the recorder emits one
+ * "-dropped { count }" event per chunk once a cap is hit, so the player
+ * can say "212 clicks not labelled" instead of showing a quiet stretch.
+ */
+export const SESSION_REPLAY_MAX_CUSTOM_EVENTS_PER_CHUNK = 50;
+export const SESSION_REPLAY_MAX_CLICK_EVENTS_PER_CHUNK = 100;
+/*
+ * The visible text carried on a click event (aria-label, name or text
+ * content, after the active masking transform). Enough to read "Place
+ * order", short enough that a click on a paragraph cannot smuggle it.
+ */
+export const SESSION_REPLAY_MAX_CLICK_TEXT_LENGTH = 40;
+/* captureSession(reason): the reason becomes a custom event property. */
+export const SESSION_REPLAY_MAX_CAPTURE_REASON_LENGTH = 80;
+/*
+ * ---- Player-side activity model. ----
+ *
+ * A stretch with no user input for at least this long is an idle band on
+ * the timeline and a candidate for "skip idle". 5s is the smallest gap a
+ * viewer perceives as waiting rather than reading; shorter bands would
+ * turn every pause-to-read into a jump.
+ */
+export const SESSION_REPLAY_IDLE_THRESHOLD_MS = 5 * 1000;
+/*
+ * Coarse activity from the manifest alone: a chunk carrying fewer events
+ * than this is provisionally idle before it is decoded. A chunk always
+ * holds a handful of housekeeping events (meta, viewport, the flush
+ * checkout), so "3 or fewer" means nothing the user did reached it. The
+ * finalizer uses the same threshold to compute activeMs on the header, so
+ * the list's "idle 40%" and the timeline's hatched bands agree.
+ */
+export const SESSION_REPLAY_ACTIVE_CHUNK_MIN_EVENTS = 4;
+/*
+ * ---- List search. ----
+ *
+ * Free-text search runs as a case-insensitive substring match over several
+ * argMax'd header columns, which cannot use an index. The string cap keeps
+ * the predicate cheap; the window cap bounds how many partitions it may
+ * scan, and the handler answers "narrow the range" rather than timing out
+ * against a wider window.
+ */
+export const SESSION_REPLAY_LIST_SEARCH_MAX_LENGTH = 200;
+export const SESSION_REPLAY_LIST_SEARCH_MAX_WINDOW_DAYS = 30;
+/*
+ * Everything a current recorder build can capture beyond the rrweb DOM
+ * stream. The recorder sends the subset it implements on chunk 0
+ * (SessionReplayChunkEnvelope.capabilities); the player and the setup page
+ * compare a recording against this list to explain what an older cached
+ * artifact could not have captured, e.g. "click labels: no". Additive
+ * only: a value is never removed or renamed, because stored headers quote
+ * these strings.
+ */
+export const SESSION_REPLAY_RECORDER_CAPABILITIES = [
+    "click-events",
+    "web-vitals",
+    "custom-events",
+    "traits",
+    "tags",
+    "visibility",
+];
 /*
  * Machine-readable disclosures of what the recorder could not capture.
  * Surfaced on the player so a viewer sees "this region was not recorded"
@@ -154,6 +248,21 @@ export var SessionReplayFidelityNotice;
      * may be noisier than the application's settings intend.
      */
     SessionReplayFidelityNotice["IgnorePatternsDiscarded"] = "ignore-patterns-discarded";
+    /*
+     * A per-session cap on recorded console lines, errors, network requests
+     * or route changes was reached, so later signals of that kind were not
+     * recorded. The footage itself is complete; only the rail is truncated
+     * past this point. The recorder emits an in-band cap marker too, so the
+     * rail can show WHERE the truncation started.
+     */
+    SessionReplayFidelityNotice["SignalCapReached"] = "signal-cap-reached";
+    /*
+     * rrweb threw inside the recorder's own emit path (its errorHandler
+     * swallowed it so the host page kept working) three or more times on
+     * this page. The recorder took a fresh checkout after the burst, so the
+     * footage recovers, but playback may skip or freeze around those points.
+     */
+    SessionReplayFidelityNotice["RecorderError"] = "recorder-error";
 })(SessionReplayFidelityNotice || (SessionReplayFidelityNotice = {}));
 /* Why a session stopped accumulating chunks. */
 export var SessionReplaySealedReason;
@@ -208,5 +317,13 @@ export var SessionReplayDisabledReason;
      * not match one, or a kill key is set.
      */
     SessionReplayDisabledReason["NotEnabledForApplication"] = "not-enabled-for-application";
+    /*
+     * The project's daily byte budget or the application's monthly budget
+     * is already spent, so the recorder is told at config time not to
+     * record at all. Without this every new page load would record,
+     * compress and upload a chunk only to be refused. `disabledDetail`
+     * says which budget and `budgetResetsAt` when it clears.
+     */
+    SessionReplayDisabledReason["BudgetExhausted"] = "budget-exhausted";
 })(SessionReplayDisabledReason || (SessionReplayDisabledReason = {}));
 //# sourceMappingURL=SessionReplay.js.map

package/build/dist/Types/Rum/SessionReplay.js.map

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

package/build/dist/Types/Rum/SessionReplayApi.js

@@ -0,0 +1,181 @@
+export const SESSION_REPLAY_SORT_BY_VALUES = ["startTime", "durationMs", "errorCount", "frustration"];
+/*
+ * Response header on /chunks, comma-separated ascending indexes: chunks
+ * that EXIST and were asked for, but did not fit this body under
+ * MAX_SESSION_REPLAY_READ_BYTES. Absent when nothing was left out.
+ *
+ * A loader that reads their absence as missing footage would draw a hole
+ * in a recording that is whole; the honest response is to ask for them
+ * again in a smaller page. Named here so the server that sets it and the
+ * loader that reads it quote one string.
+ */
+export const SESSION_REPLAY_OMITTED_CHUNKS_HEADER = "X-OneUptime-Replay-Omitted-Chunks";
+/* ---- Read failures ---- */
+/*
+ * The read routes answer 404 with a message whose PREFIX carries the
+ * reason, because the three reasons need three different screens and an
+ * HTTP status cannot tell them apart: a recording that aged out under
+ * retention (and whose signals may still exist in logs and traces), one
+ * erased by a data-subject request (which will never come back), and an
+ * id that was never recorded in this project. classifyManifestFailure in
+ * the Dashboard branches on exactly these; they live here so neither side
+ * invents a fourth spelling.
+ */
+export const SESSION_REPLAY_READ_ERROR_PREFIX_EXPIRED = "expired:";
+export const SESSION_REPLAY_READ_ERROR_PREFIX_ERASED = "erased:";
+export const SESSION_REPLAY_READ_ERROR_PREFIX_NOT_FOUND = "not-found:";
+export const SESSION_REPLAY_READ_ERROR_PREFIXES = [
+    SESSION_REPLAY_READ_ERROR_PREFIX_EXPIRED,
+    SESSION_REPLAY_READ_ERROR_PREFIX_ERASED,
+    SESSION_REPLAY_READ_ERROR_PREFIX_NOT_FOUND,
+];
+/*
+ * The response is the wire form of RecordingHealthStatus; see
+ * Common/Types/Rum/SessionReplayHealth.ts, which owns it because the
+ * health diagnosis is the only consumer.
+ */
+/* ---- Defensive row readers shared by the Dashboard parsers. ---- */
+/*
+ * Every route above answers a hand-written ClickHouse projection, not a
+ * model serialisation, so nothing is trusted: numbers may arrive as
+ * strings (ClickHouse quotes 64-bit integers in JSON), UInt8 booleans as
+ * 0/1 or "0"/"1", and any field may be absent on an older server.
+ */
+/* A finite number, or 0. Use readDtoOptionalNumber when 0 would be a lie. */
+export function readDtoNumber(row, key) {
+    const parsed = Number(row[key]);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+/*
+ * A finite number, or undefined when the field is absent, null, or not a
+ * number. This is the reader for every additive counter: "not measured"
+ * must stay distinguishable from "measured as zero" all the way to the UI.
+ */
+export function readDtoOptionalNumber(row, key) {
+    const value = row[key];
+    if (value === null || value === undefined || value === "") {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+export function readDtoString(row, key) {
+    const value = row[key];
+    return value === null || value === undefined ? "" : String(value);
+}
+/* A non-empty string, or undefined. */
+export function readDtoOptionalString(row, key) {
+    const value = row[key];
+    if (typeof value === "string") {
+        return value.length > 0 ? value : undefined;
+    }
+    return undefined;
+}
+/* ClickHouse UInt8 booleans arrive as 0/1, sometimes as the strings "0"/"1". */
+export function readDtoBoolean(row, key) {
+    const value = row[key];
+    return value === true || value === 1 || value === "1";
+}
+export function readDtoStringArray(row, key) {
+    const value = row[key];
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map((entry) => {
+        return String(entry);
+    });
+}
+export function readDtoNumberArray(row, key) {
+    const value = row[key];
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const numbers = [];
+    for (const entry of value) {
+        const parsed = Number(entry);
+        if (Number.isFinite(parsed)) {
+            numbers.push(parsed);
+        }
+    }
+    return numbers;
+}
+/*
+ * A Map(String, String) column, serialised by ClickHouse as a JSON object.
+ * Non-object values (including arrays) read as an empty map; values are
+ * stringified so a numeric-looking tag still renders.
+ */
+export function readDtoStringMap(row, key) {
+    const value = row[key];
+    const result = {};
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return result;
+    }
+    for (const entryKey of Object.keys(value)) {
+        const entry = value[entryKey];
+        if (entry === null || entry === undefined) {
+            continue;
+        }
+        result[entryKey] = String(entry);
+    }
+    return result;
+}
+/*
+ * An ISO-8601 timestamp as unix ms, or undefined when absent or
+ * unparseable. Never 0: epoch is a real instant and would place a row at
+ * 1970 on the timeline.
+ */
+export function readDtoUnixMs(row, key) {
+    const value = row[key];
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value !== "string" || value.length === 0) {
+        return undefined;
+    }
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/*
+ * True when the cursor carries the additive sort fields; false for the
+ * legacy {startTimeUnixMs, sessionId} shape.
+ */
+export function isSessionReplaySortedListCursor(cursor) {
+    return (typeof cursor.sortBy === "string" &&
+        typeof cursor.sortValue === "number");
+}
+/*
+ * Read a cursor off an untyped body. The legacy shape is normalised to
+ * sortBy "startTime" so callers have one branch to write. Returns null
+ * when neither shape is present.
+ */
+export function parseSessionReplayListCursor(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const row = value;
+    const sessionId = readDtoOptionalString(row, "sessionId");
+    if (!sessionId) {
+        return null;
+    }
+    const sortBy = row["sortBy"];
+    const sortValue = readDtoOptionalNumber(row, "sortValue");
+    if (typeof sortBy === "string" &&
+        SESSION_REPLAY_SORT_BY_VALUES.includes(sortBy) &&
+        sortValue !== undefined) {
+        return {
+            sortBy: sortBy,
+            sortValue: sortValue,
+            sessionId: sessionId,
+        };
+    }
+    const startTimeUnixMs = readDtoOptionalNumber(row, "startTimeUnixMs");
+    if (startTimeUnixMs !== undefined) {
+        return {
+            sortBy: "startTime",
+            sortValue: startTimeUnixMs,
+            sessionId: sessionId,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=SessionReplayApi.js.map

package/build/dist/Types/Rum/SessionReplayApi.js.map

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

package/build/dist/Types/Rum/SessionReplayCaptureTrigger.js

@@ -2,25 +2,34 @@
  * What causes a session to be uploaded — the single decision that drives
  * the cost, storage and privacy-exposure profile of the whole feature.
  *
- * OnErrorOrFrustration is the observability-native default: the recorder
- * holds a rolling buffer and only uploads when something actually went
- * wrong, so a recording exists for very nearly every failed session
- * while costing roughly 15x less than recording everyone.
+ * Always is the default. Replay earns its keep on the sessions where
+ * NOTHING threw: the checkout nobody completed, the form everybody
+ * abandoned, the support call about a page that "looked wrong". A
+ * recorder that only uploads failures answers half the questions people
+ * open a session list to ask, and - worse - makes the other half look
+ * broken, because a session with no recording is indistinguishable from
+ * a feature that does not work.
  */
 var SessionReplayCaptureTrigger;
 (function (SessionReplayCaptureTrigger) {
     /*
-     * Default. Upload only on error / unhandled rejection / 5xx response /
-     * frustration signal, plus whatever the sample percentage picks up.
+     * Default. Upload every sampled session from its first event, whether
+     * or not anything goes wrong. The sample percentage (100 by default) is
+     * the dial for cost: halve it and you halve both the bytes stored and
+     * the end-user data at rest.
      */
-    SessionReplayCaptureTrigger["OnErrorOrFrustration"] = "OnErrorOrFrustration";
+    SessionReplayCaptureTrigger["Always"] = "Always";
     /*
-     * Upload every sampled session from its first event, whether or not
-     * anything goes wrong. What users migrating from a marketing-analytics
-     * tool expect to find. Materially more expensive and materially more
-     * end-user data at rest.
+     * Upload only on error / unhandled rejection / 5xx response /
+     * frustration signal, plus whatever the sample percentage picks up.
+     *
+     * The recorder holds a rolling in-memory buffer and uploads it
+     * retroactively when something goes wrong, so a recording exists for
+     * very nearly every FAILED session while costing roughly 15x less than
+     * recording everyone. Choose it when storage or data minimisation
+     * matters more than being able to watch an ordinary session.
      */
-    SessionReplayCaptureTrigger["Always"] = "Always";
+    SessionReplayCaptureTrigger["OnErrorOrFrustration"] = "OnErrorOrFrustration";
 })(SessionReplayCaptureTrigger || (SessionReplayCaptureTrigger = {}));
 export default SessionReplayCaptureTrigger;
 //# sourceMappingURL=SessionReplayCaptureTrigger.js.map

package/build/dist/Types/Rum/SessionReplayCaptureTrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionReplayCaptureTrigger.js","sourceRoot":"","sources":["../../../../Types/Rum/SessionReplayCaptureTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,IAAK,2BAcJ;AAdD,WAAK,2BAA2B;IAC9B;;;OAGG;IACH,4EAA6C,CAAA;IAE7C;;;;;OAKG;IACH,gDAAiB,CAAA;AACnB,CAAC,EAdI,2BAA2B,KAA3B,2BAA2B,QAc/B;AAED,eAAe,2BAA2B,CAAC"}
+{"version":3,"file":"SessionReplayCaptureTrigger.js","sourceRoot":"","sources":["../../../../Types/Rum/SessionReplayCaptureTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,IAAK,2BAoBJ;AApBD,WAAK,2BAA2B;IAC9B;;;;;OAKG;IACH,gDAAiB,CAAA;IAEjB;;;;;;;;;OASG;IACH,4EAA6C,CAAA;AAC/C,CAAC,EApBI,2BAA2B,KAA3B,2BAA2B,QAoB/B;AAED,eAAe,2BAA2B,CAAC"}

package/build/dist/Types/Rum/SessionReplayConsentMode.js

@@ -10,16 +10,20 @@
 var SessionReplayConsentMode;
 (function (SessionReplayConsentMode) {
     /*
-     * Default. Nothing is uploaded until the host page grants consent.
-     * Chunks carry their consentState and the ingest worker drops any
-     * chunk marked Unknown when the application requires explicit consent,
-     * so a recorder that skips the handshake fails closed server-side too.
+     * Nothing is uploaded until the host page grants consent. Chunks carry
+     * their consentState and the ingest worker drops any chunk marked
+     * Unknown when the application requires explicit consent, so a
+     * recorder that skips the handshake fails closed server-side too. Most
+     * EU deployments want this mode; it is not the default because a
+     * page that never calls grantConsent() records nothing at all, which
+     * is indistinguishable from a broken install on day one.
      */
     SessionReplayConsentMode["RequireExplicit"] = "RequireExplicit";
     /*
-     * The customer asserts they have a lawful basis that does not require
-     * a per-session grant (for example an internal admin tool covered by
-     * an employment agreement). Uploads begin immediately.
+     * Default (RumApplication.sessionReplayConsentMode). The customer
+     * asserts they have a lawful basis that does not require a per-session
+     * grant (for example an internal admin tool covered by an employment
+     * agreement). Uploads begin immediately.
      */
     SessionReplayConsentMode["NotRequired"] = "NotRequired";
 })(SessionReplayConsentMode || (SessionReplayConsentMode = {}));

package/build/dist/Types/Rum/SessionReplayConsentMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionReplayConsentMode.js","sourceRoot":"","sources":["../../../../Types/Rum/SessionReplayConsentMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,IAAK,wBAeJ;AAfD,WAAK,wBAAwB;IAC3B;;;;;OAKG;IACH,+DAAmC,CAAA;IAEnC;;;;OAIG;IACH,uDAA2B,CAAA;AAC7B,CAAC,EAfI,wBAAwB,KAAxB,wBAAwB,QAe5B;AAED,eAAe,wBAAwB,CAAC"}
+{"version":3,"file":"SessionReplayConsentMode.js","sourceRoot":"","sources":["../../../../Types/Rum/SessionReplayConsentMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,IAAK,wBAmBJ;AAnBD,WAAK,wBAAwB;IAC3B;;;;;;;;OAQG;IACH,+DAAmC,CAAA;IAEnC;;;;;OAKG;IACH,uDAA2B,CAAA;AAC7B,CAAC,EAnBI,wBAAwB,KAAxB,wBAAwB,QAmB5B;AAED,eAAe,wBAAwB,CAAC"}

package/build/dist/Types/Rum/SessionReplayCustomEvents.js

@@ -0,0 +1,172 @@
+import { SessionRotationReason } from "../../Utils/Rum/SessionIdentity";
+import { isSessionReplayStringMap } from "../../Utils/Rum/SessionReplayStringMap";
+export const SessionReplayCustomEventTag = {
+    Console: "oneuptime.console",
+    Network: "oneuptime.network",
+    Route: "oneuptime.route",
+    Error: "oneuptime.error",
+    Frustration: "oneuptime.frustration",
+    Performance: "oneuptime.performance",
+    BfcacheRestore: "oneuptime.bfcache-restore",
+    SessionRotated: "oneuptime.session-rotated",
+    Click: "oneuptime.click",
+    ClickDropped: "oneuptime.click-dropped",
+    Visibility: "oneuptime.visibility",
+    Custom: "oneuptime.custom",
+    CustomDropped: "oneuptime.custom-dropped",
+    Identify: "oneuptime.identify",
+    Tags: "oneuptime.tags",
+};
+/* Every tag, for "is this one of ours" checks and exhaustiveness tests. */
+export const SESSION_REPLAY_CUSTOM_EVENT_TAGS = Object.values(SessionReplayCustomEventTag);
+/* rrweb's EventType.Custom. Declared here so readers stay rrweb-free. */
+export const SESSION_REPLAY_RRWEB_CUSTOM_EVENT_TYPE = 5;
+/* ---- Type guards. Minimum required fields only; the rest is optional. ---- */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+function isOneOf(value, allowed) {
+    return (typeof value === "string" &&
+        allowed.includes(value));
+}
+const CONSOLE_LEVELS = [
+    "error",
+    "warn",
+];
+const ROUTE_KINDS = [
+    "pushState",
+    "replaceState",
+    "popstate",
+    "hashchange",
+];
+const ERROR_KINDS = [
+    "error",
+    "unhandledrejection",
+];
+const FRUSTRATION_KINDS = [
+    "rage-click",
+    "dead-click",
+    "error-click",
+    "refresh-rage",
+];
+const PERFORMANCE_BUDGET_KINDS = ["lcp", "long-task", "slow-request"];
+const WEB_VITAL_METRICS = [
+    "LCP",
+    "CLS",
+    "INP",
+    "FCP",
+    "TTFB",
+];
+const WEB_VITAL_RATINGS = [
+    "good",
+    "needs-improvement",
+    "poor",
+];
+const VISIBILITY_STATES = [
+    "hidden",
+    "visible",
+];
+export function isSessionReplayCustomEventTag(value) {
+    return isOneOf(value, SESSION_REPLAY_CUSTOM_EVENT_TAGS);
+}
+/*
+ * The `data` of an rrweb event, when it is one of ours. Does not check the
+ * event's `type`; callers filter on SESSION_REPLAY_RRWEB_CUSTOM_EVENT_TYPE
+ * first because rrweb's own events also carry a `data` object.
+ */
+export function isSessionReplayCustomEventData(value) {
+    return isRecord(value) && typeof value["tag"] === "string";
+}
+export function isSessionReplayConsolePayload(value) {
+    return (isRecord(value) &&
+        isOneOf(value["level"], CONSOLE_LEVELS) &&
+        typeof value["message"] === "string");
+}
+export function isSessionReplayNetworkPayload(value) {
+    /*
+     * method/url/status are the row; timing, bytes and isError have safe
+     * defaults on the reader side, and traceId is optional on the wire.
+     */
+    return (isRecord(value) &&
+        typeof value["method"] === "string" &&
+        typeof value["url"] === "string" &&
+        isFiniteNumber(value["status"]));
+}
+export function isSessionReplayRoutePayload(value) {
+    return (isRecord(value) &&
+        typeof value["from"] === "string" &&
+        typeof value["to"] === "string" &&
+        isOneOf(value["kind"], ROUTE_KINDS));
+}
+export function isSessionReplayErrorPayload(value) {
+    return (isRecord(value) &&
+        isOneOf(value["kind"], ERROR_KINDS) &&
+        typeof value["message"] === "string");
+}
+export function isSessionReplayFrustrationPayload(value) {
+    return (isRecord(value) &&
+        isOneOf(value["kind"], FRUSTRATION_KINDS) &&
+        isFiniteNumber(value["atUnixMs"]));
+}
+export function isSessionReplayPerformanceBudgetPayload(value) {
+    return (isRecord(value) &&
+        isOneOf(value["kind"], PERFORMANCE_BUDGET_KINDS) &&
+        isFiniteNumber(value["durationMs"]) &&
+        isFiniteNumber(value["budgetMs"]));
+}
+export function isSessionReplayWebVitalPayload(value) {
+    return (isRecord(value) &&
+        value["kind"] === "web-vital" &&
+        isOneOf(value["metric"], WEB_VITAL_METRICS) &&
+        isFiniteNumber(value["value"]) &&
+        isOneOf(value["rating"], WEB_VITAL_RATINGS));
+}
+export function isSessionReplayPerformancePayload(value) {
+    return (isSessionReplayPerformanceBudgetPayload(value) ||
+        isSessionReplayWebVitalPayload(value));
+}
+export function isSessionReplayBfcacheRestorePayload(value) {
+    return isRecord(value) && isFiniteNumber(value["restoredAtUnixMs"]);
+}
+export function isSessionReplaySessionRotatedPayload(value) {
+    return (isRecord(value) &&
+        typeof value["previousSessionId"] === "string" &&
+        isOneOf(value["rotationReason"], Object.values(SessionRotationReason)) &&
+        isFiniteNumber(value["rotatedAtUnixMs"]));
+}
+export function isSessionReplayClickPayload(value) {
+    return (isRecord(value) &&
+        typeof value["selector"] === "string" &&
+        isFiniteNumber(value["x"]) &&
+        isFiniteNumber(value["y"]) &&
+        isFiniteNumber(value["atUnixMs"]) &&
+        (value["text"] === undefined || typeof value["text"] === "string"));
+}
+export function isSessionReplayClickDroppedPayload(value) {
+    return isRecord(value) && isFiniteNumber(value["count"]);
+}
+export function isSessionReplayVisibilityPayload(value) {
+    return (isRecord(value) &&
+        isOneOf(value["state"], VISIBILITY_STATES) &&
+        isFiniteNumber(value["atUnixMs"]));
+}
+export function isSessionReplayCustomPayload(value) {
+    return (isRecord(value) &&
+        typeof value["name"] === "string" &&
+        value["name"].length > 0 &&
+        (value["properties"] === undefined ||
+            isSessionReplayStringMap(value["properties"])));
+}
+export function isSessionReplayCustomDroppedPayload(value) {
+    return isRecord(value) && isFiniteNumber(value["count"]);
+}
+export function isSessionReplayIdentifyPayload(value) {
+    return isRecord(value) && typeof value["hasTraits"] === "boolean";
+}
+export function isSessionReplayTagsPayload(value) {
+    return isRecord(value) && isSessionReplayStringMap(value["tags"]);
+}
+//# sourceMappingURL=SessionReplayCustomEvents.js.map

package/build/dist/Types/Rum/SessionReplayCustomEvents.js.map

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

package/build/dist/Types/Rum/SessionReplayHealth.js

@@ -0,0 +1,37 @@
+/*
+ * Recording health for one RUM application: the answer to "why are there
+ * no recordings?" as data rather than as silence.
+ *
+ * Two shapes live here. SessionReplayIngestStatusResponseDto is the JSON
+ * that POST /telemetry/rum/session-replay/ingest-status answers today
+ * plus its additive fields, every new one optional. RecordingHealthStatus
+ * is the normalised object the Dashboard builds from it (see
+ * parseRecordingHealthStatus in Common/Utils/Rum/SessionReplayHealth.ts)
+ * and the only input diagnoseRecordingHealth takes. Keeping the two apart
+ * is what lets the diagnosis be exhaustively tested against a stable
+ * shape while the wire grows a field at a time.
+ *
+ * One rule runs through both: a counter that could not be read is null,
+ * never 0. "0 refusals" and "the refusal counter is unreachable" are
+ * different facts and the UI says "unknown" for the second.
+ */
+export const SESSION_REPLAY_REFUSAL_REASONS = [
+    "ingest-disabled",
+    "instance-not-offering-replay",
+    "policy-unavailable",
+    "not-enabled",
+    "origin-not-allowed",
+    "session-chunk-cap",
+    "not-sampled",
+    "rate-limited",
+    "rate-counter-unavailable",
+    "budget-exhausted",
+    "budget-counter-unavailable",
+    "app-monthly-budget-exhausted",
+    "consent-required",
+];
+export function isSessionReplayRefusalReason(value) {
+    return (typeof value === "string" &&
+        SESSION_REPLAY_REFUSAL_REASONS.includes(value));
+}
+//# sourceMappingURL=SessionReplayHealth.js.map