@alwaysmeticulous/api 2.286.0 → 2.288.2

package/dist/custom-checks.types.d.ts

@@ -0,0 +1,113 @@
+import { HarRequest, HarResponse } from "./sdk-bundle-api/sdk-to-bundle/har-log";
+/**
+ * Types for authoring custom checks. A custom check compares the snapshots
+ * captured during the base and head replays of a test run and returns a verdict
+ * plus a report that is surfaced in the Meticulous UI.
+ */
+/**
+ * A piece of data captured at a point during a replay, to be compared by a
+ * custom check. A check may receive multiple snapshots sharing the same `type`,
+ * `sessionId` and `stageDuringSession`; it should align the base and head
+ * snapshots and base its verdict only on the differences (pre-existing issues
+ * are ignored, consistent with Meticulous's semantics).
+ */
+export interface Snapshot<T = unknown> {
+    /** The snapshot kind, e.g. "network-requests" or a customer-defined type. */
+    type: string;
+    /** The recorded session the snapshot was captured during. */
+    sessionId: string;
+    /**
+     * Where in the session the snapshot was captured, identified by the screenshot
+     * taken at that point (e.g. "screenshot-after-event-2", "final-state").
+     */
+    stageDuringSession: string;
+    data: T;
+}
+/** The base and head snapshots passed to a custom check. */
+export interface CustomCheckInput {
+    baseSnapshots: Snapshot[];
+    headSnapshots: Snapshot[];
+}
+/**
+ * - `pass`: no regression; the check is green and no report is surfaced.
+ * - `warn`: the check is green but its report is shown to the user.
+ * - `fail`: the check is red.
+ * - `execution-error`: the check failed to run.
+ */
+export type CustomCheckVerdict = "pass" | "warn" | "fail" | "execution-error";
+/**
+ * Maximum length of a custom check `summary`. The summary is rendered inline in
+ * the UI, so it is truncated to this many characters when displayed rather than
+ * relying on plugin authors to keep it short.
+ */
+export declare const CUSTOM_CHECK_SUMMARY_MAX_LENGTH = 500;
+/** The result a custom check returns after comparing the snapshots. */
+export interface CustomCheckOutput {
+    verdict: CustomCheckVerdict;
+    /**
+     * A short summary shown inline in the UI, e.g. "+30mb inc bundle size".
+     * Truncated to {@link CUSTOM_CHECK_SUMMARY_MAX_LENGTH} characters when displayed.
+     */
+    summary?: string;
+    report: CustomCheckReport;
+}
+/** A report rendered in the UI when the check is opened. Markdown for now. */
+export type CustomCheckReport = MarkdownReport;
+export interface MarkdownReport {
+    type: "markdown";
+    markdown: string;
+}
+/**
+ * The contract a custom check implements: `execute` compares the base and head
+ * snapshots and returns a verdict and report.
+ */
+export interface CustomCheck {
+    execute: (input: CustomCheckInput) => Promise<CustomCheckOutput>;
+}
+/**
+ * Manifest describing a custom check plugin to Meticulous. It sits alongside the
+ * built entrypoint and is loaded (without executing the check) so the check can
+ * be discovered ahead of time.
+ */
+export interface CustomCheckPluginManifest {
+    /** Stable identifier for the check, e.g. "accessibility-check". */
+    id: string;
+    type: "custom-check";
+    /** Plugin version, e.g. "1.0.0". */
+    version: string;
+    configuration: {
+        /** Name shown in the UI, e.g. "Accessibility". */
+        displayName: string;
+        /** The snapshot types this check consumes, e.g. ["network-requests"]. */
+        handlesSnapshotTypes: string[];
+        /** Path to the built entrypoint, relative to the manifest, e.g. "./entrypoint.js". */
+        entryPoint: string;
+    };
+}
+/** A Meticulous plugin manifest. Only custom checks are supported today. */
+export type PluginManifest = CustomCheckPluginManifest;
+/**
+ * The snapshot `type` of the built-in network requests snapshot. Checks that
+ * consume it receive `Snapshot<NetworkRequestSnapshotData>` values.
+ */
+export declare const NETWORK_REQUESTS_SNAPSHOT_TYPE = "network-requests";
+/**
+ * `data` of a built-in "network-requests" snapshot: a single xhr/fetch request
+ * captured during the replay, with the stubbed response that was served.
+ *
+ * `requestBody`/`responseBody` may be truncated (large bodies are ellipsized
+ * with an MD5 of the remainder, so body changes are still detectable); url,
+ * method, status and headers are captured in full.
+ */
+export interface NetworkRequestSnapshotData {
+    url: string;
+    method: string;
+    requestHeaders: HarRequest["headers"];
+    requestBody?: string;
+    /** Status of the response served, or null if the request was not matched. */
+    status: number | null;
+    responseHeaders: HarResponse["headers"];
+    responseBody?: string;
+    /** Whether the request was matched to a recorded request and stubbed. */
+    matched: boolean;
+}

package/dist/custom-checks.types.js

@@ -0,0 +1,18 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="aaa133b4-907a-5e85-b83c-765d117cdeec")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_REQUESTS_SNAPSHOT_TYPE = exports.CUSTOM_CHECK_SUMMARY_MAX_LENGTH = void 0;
+/**
+ * Maximum length of a custom check `summary`. The summary is rendered inline in
+ * the UI, so it is truncated to this many characters when displayed rather than
+ * relying on plugin authors to keep it short.
+ */
+exports.CUSTOM_CHECK_SUMMARY_MAX_LENGTH = 500;
+/**
+ * The snapshot `type` of the built-in network requests snapshot. Checks that
+ * consume it receive `Snapshot<NetworkRequestSnapshotData>` values.
+ */
+exports.NETWORK_REQUESTS_SNAPSHOT_TYPE = "network-requests";
+//# sourceMappingURL=custom-checks.types.js.map
+//# debugId=aaa133b4-907a-5e85-b83c-765d117cdeec

package/dist/custom-checks.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-checks.types.js","sources":["../src/custom-checks.types.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAgDA;;;;GAIG;AACU,QAAA,+BAA+B,GAAG,GAAG,CAAC;AA4DnD;;;GAGG;AACU,QAAA,8BAA8B,GAAG,kBAAkB,CAAC","debugId":"aaa133b4-907a-5e85-b83c-765d117cdeec"}

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { TestRunChunkStatus } from "./replay/test-run-chunk.types";
 export * from "./sdk-bundle-api/sdk-to-bundle/test-run-environment";
 export { ReplayableEvent } from "./sdk-bundle-api/bidirectional/replayable-event";
 export { HarEntry, HarLog, HarRequest, HarResponse, } from "./sdk-bundle-api/sdk-to-bundle/har-log";
-export { Cookie, SessionData, UrlHistoryEvent, WindowData, ApplicationSpecificData, StorageEntry, EarlyRequest, SerializedIDBValidKey, IDBObjectStoreMetadata, IDBObjectStoreSnapshot, IDBObjectStoreWithEntries, IDBIndexSnapshot, CustomDataSingletonInternalKey, CustomDataSingletonInternalValues, CustomData, CustomUserEvent, SessionContext, ExpiringImage, CustomRecordingType, } from "./sdk-bundle-api/sdk-to-bundle/session-data";
+export { Cookie, SessionData, UrlHistoryEvent, WindowData, ApplicationSpecificData, StorageEntry, EarlyRequest, SerializedIDBValidKey, IDBObjectStoreMetadata, IDBObjectStoreSnapshot, IDBObjectStoreWithEntries, IDBIndexSnapshot, CustomDataSingletonInternalKey, CustomDataSingletonInternalValues, CustomData, CustomUserEvent, SessionContext, ExpiringImage, CustomRecordingType, HttpSpanAttributes, SerializedBackendSpan, } from "./sdk-bundle-api/sdk-to-bundle/session-data";
 export { SequenceNumber, WebSocketConnectionData, WebSocketConnectionEvent, WebSocketConnectionCreatedEvent, WebSocketConnectionOpenedEvent, EncodedArrayBuffer, EncodedBlob, WebSocketConnectionMessageEvent, WebSocketConnectionErrorEvent, WebSocketConnectionClosedEvent, } from "./sdk-bundle-api/sdk-to-bundle/websocket-data";
 export * from "./sdk-bundle-api/sdk-to-bundle/event-source-data";
 export { StreamingFetchChunk, StreamingFetchResponseData, } from "./sdk-bundle-api/sdk-to-bundle/streaming-fetch-data";
@@ -21,3 +21,4 @@ export { AssetUploadMetadata } from "./sdk-bundle-api/sdk-to-bundle/asset-upload
 export { S3Location } from "./s3.types";
 export { CompanionAssetsInfo } from "./sdk-bundle-api/sdk-to-bundle/companion-assets";
 export { DeploymentArchiveType } from "./sdk-bundle-api/sdk-to-bundle/deployment-archive-type";
+export { Snapshot, CustomCheckInput, CustomCheckVerdict, CustomCheckOutput, CustomCheckReport, MarkdownReport, CustomCheck, CustomCheckPluginManifest, PluginManifest, NetworkRequestSnapshotData, NETWORK_REQUESTS_SNAPSHOT_TYPE, CUSTOM_CHECK_SUMMARY_MAX_LENGTH, } from "./custom-checks.types";

package/dist/index.js

@@ -1,5 +1,5 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4d355048-519b-539f-97e2-b08438b0f52c")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="78889a89-65b0-5901-8866-651c405305a4")}catch(e){}}();
 
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -16,7 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CustomDataSingletonInternalKey = exports.isPrAuthorRelevance = exports.SessionRelevance = void 0;
+exports.CUSTOM_CHECK_SUMMARY_MAX_LENGTH = exports.NETWORK_REQUESTS_SNAPSHOT_TYPE = exports.CustomDataSingletonInternalKey = exports.isPrAuthorRelevance = exports.SessionRelevance = void 0;
 var test_run_types_1 = require("./replay/test-run.types");
 Object.defineProperty(exports, "SessionRelevance", { enumerable: true, get: function () { return test_run_types_1.SessionRelevance; } });
 Object.defineProperty(exports, "isPrAuthorRelevance", { enumerable: true, get: function () { return test_run_types_1.isPrAuthorRelevance; } });
@@ -24,5 +24,8 @@ __exportStar(require("./sdk-bundle-api/sdk-to-bundle/test-run-environment"), exp
 var session_data_1 = require("./sdk-bundle-api/sdk-to-bundle/session-data");
 Object.defineProperty(exports, "CustomDataSingletonInternalKey", { enumerable: true, get: function () { return session_data_1.CustomDataSingletonInternalKey; } });
 __exportStar(require("./sdk-bundle-api/sdk-to-bundle/event-source-data"), exports);
+var custom_checks_types_1 = require("./custom-checks.types");
+Object.defineProperty(exports, "NETWORK_REQUESTS_SNAPSHOT_TYPE", { enumerable: true, get: function () { return custom_checks_types_1.NETWORK_REQUESTS_SNAPSHOT_TYPE; } });
+Object.defineProperty(exports, "CUSTOM_CHECK_SUMMARY_MAX_LENGTH", { enumerable: true, get: function () { return custom_checks_types_1.CUSTOM_CHECK_SUMMARY_MAX_LENGTH; } });
 //# sourceMappingURL=index.js.map
-//# debugId=4d355048-519b-539f-97e2-b08438b0f52c
+//# debugId=78889a89-65b0-5901-8866-651c405305a4

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAuBA,0DAaiC;AAZ/B,kHAAA,gBAAgB,OAAA;AAChB,qHAAA,mBAAmB,OAAA;AAsBrB,sFAAoE;AAQpE,4EAoBqD;AAPnD,8HAAA,8BAA8B,OAAA;AAoBhC,mFAAiE","debugId":"4d355048-519b-539f-97e2-b08438b0f52c"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAuBA,0DAaiC;AAZ/B,kHAAA,gBAAgB,OAAA;AAChB,qHAAA,mBAAmB,OAAA;AAsBrB,sFAAoE;AAQpE,4EAsBqD;AATnD,8HAAA,8BAA8B,OAAA;AAsBhC,mFAAiE;AA0DjE,6DAa+B;AAF7B,qIAAA,8BAA8B,OAAA;AAC9B,sIAAA,+BAA+B,OAAA","debugId":"78889a89-65b0-5901-8866-651c405305a4"}

package/dist/sdk-bundle-api/sdk-to-bundle/session-data.d.ts

@@ -82,6 +82,11 @@ export interface SessionData {
      * Only present on some recordings since ~Feb 2026.
      */
     initialNavigationResponse?: HarResponse;
+    /**
+     * Backend spans captured by the backend recorder.
+     * Only present on recordings since ~June 2026.
+     */
+    backendSpans?: SerializedBackendSpan[];
 }
 export interface WindowData {
     startUrl: string;
@@ -299,4 +304,66 @@ export interface ExpiringImage {
     compressionStrategy: string;
     data: string;
 }
+export interface HttpSpanAttributes {
+    "http.request.method"?: string;
+    "http.request.method_original"?: string;
+    "http.response.status_code"?: number;
+    "http.route"?: string;
+    "url.full"?: string;
+    "url.path"?: string;
+    "url.query"?: string;
+    "url.scheme"?: string;
+    "server.address"?: string;
+    "server.port"?: number;
+    "client.address"?: string;
+    "network.peer.address"?: string;
+    "network.peer.port"?: number;
+    "network.protocol.version"?: string;
+    "user_agent.original"?: string;
+    "user_agent.synthetic.type"?: string;
+    "error.type"?: string;
+    "http.url"?: string;
+    "http.method"?: string;
+    "http.target"?: string;
+    "http.host"?: string;
+    "http.scheme"?: string;
+    "http.status_code"?: number;
+    "http.status_text"?: string;
+    "http.flavor"?: string;
+    "http.user_agent"?: string;
+    "http.client_ip"?: string;
+    "http.server_name"?: string;
+    "http.request_content_length"?: number;
+    "http.request_content_length_uncompressed"?: number;
+    "http.response_content_length"?: number;
+    "http.response_content_length_uncompressed"?: number;
+    "http.error_name"?: string;
+    "http.error_message"?: string;
+    "net.host.ip"?: string;
+    "net.host.name"?: string;
+    "net.host.port"?: number;
+    "net.peer.ip"?: string;
+    "net.peer.name"?: string;
+    "net.peer.port"?: number;
+    "net.transport"?: string;
+    "http.request.body"?: string;
+    "http.request.body.truncated"?: boolean;
+    "http.response.body"?: string;
+    "http.response.body.truncated"?: boolean;
+    "meticulous.frontend_session_id"?: string;
+    [key: `http.request.header.${string}`]: string[] | undefined;
+    [key: `http.response.header.${string}`]: string[] | undefined;
+}
+export interface SerializedBackendSpan {
+    name: string;
+    traceId: string;
+    spanId: string;
+    parentSpanId: string | undefined;
+    kind: number;
+    status: unknown;
+    startTimeMs: number;
+    endTimeMs: number;
+    durationMs: number;
+    attributes: HttpSpanAttributes;
+}
 export {};

package/dist/sdk-bundle-api/sdk-to-bundle/session-data.js

@@ -1,5 +1,5 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2fe6ab73-e5d4-5417-a556-ffa00d358dcf")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d349248b-6184-531e-9ac2-79dee320d54c")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CustomDataSingletonInternalKey = void 0;
@@ -37,4 +37,4 @@ var CustomDataSingletonInternalKey;
     CustomDataSingletonInternalKey["CustomObjectTooLargeToSerialize"] = "met-custom-object-too-large-to-serialize";
 })(CustomDataSingletonInternalKey || (exports.CustomDataSingletonInternalKey = CustomDataSingletonInternalKey = {}));
 //# sourceMappingURL=session-data.js.map
-//# debugId=2fe6ab73-e5d4-5417-a556-ffa00d358dcf
+//# debugId=d349248b-6184-531e-9ac2-79dee320d54c

package/dist/sdk-bundle-api/sdk-to-bundle/session-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-data.js","sources":["../../../src/sdk-bundle-api/sdk-to-bundle/session-data.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AA2QA,IAAY,8BAmCX;AAnCD,WAAY,8BAA8B;IACxC;;;OAGG;IACH,gGAA8D,CAAA;IAE9D;;;;;OAKG;IACH,oEAAkC,CAAA;IAElC;;;;;OAKG;IACH,6DAA2B,CAAA;IAE3B;;;OAGG;IACH,8DAA4B,CAAA;IAE5B;;;;OAIG;IACH,8GAA4E,CAAA;AAC9E,CAAC,EAnCW,8BAA8B,8CAA9B,8BAA8B,QAmCzC","debugId":"2fe6ab73-e5d4-5417-a556-ffa00d358dcf"}
+{"version":3,"file":"session-data.js","sources":["../../../src/sdk-bundle-api/sdk-to-bundle/session-data.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAiRA,IAAY,8BAmCX;AAnCD,WAAY,8BAA8B;IACxC;;;OAGG;IACH,gGAA8D,CAAA;IAE9D;;;;;OAKG;IACH,oEAAkC,CAAA;IAElC;;;;;OAKG;IACH,6DAA2B,CAAA;IAE3B;;;OAGG;IACH,8DAA4B,CAAA;IAE5B;;;;OAIG;IACH,8GAA4E,CAAA;AAC9E,CAAC,EAnCW,8BAA8B,8CAA9B,8BAA8B,QAmCzC","debugId":"d349248b-6184-531e-9ac2-79dee320d54c"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/api",
-  "version": "2.286.0",
+  "version": "2.288.2",
   "description": "Meticulous API types",
   "license": "ISC",
   "main": "dist/index.js",