@depup/datadog__browser-rum 6.31.0-depup.0

package/cjs/domain/record/serialization/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeInTransaction = exports.serializeChangesInTransaction = exports.aggregateSerializationStats = exports.updateSerializationStats = exports.createSerializationStats = exports.serializeAttribute = exports.serializeNodeAsChange = exports.serializeNode = exports.serializeMutationsAsChange = exports.serializeMutations = exports.serializeFullSnapshotAsChange = exports.serializeFullSnapshot = exports.getElementInputValue = exports.createRootInsertionCursor = exports.createChildInsertionCursor = exports.isIncrementalSnapshotChangeRecordsEnabled = exports.isFullSnapshotChangeRecordsEnabled = exports.createIdentityNodeIdRemapper = exports.createCopyingNodeIdRemapper = exports.createChangeConverter = void 0;
+var conversions_1 = require("./conversions");
+Object.defineProperty(exports, "createChangeConverter", { enumerable: true, get: function () { return conversions_1.createChangeConverter; } });
+Object.defineProperty(exports, "createCopyingNodeIdRemapper", { enumerable: true, get: function () { return conversions_1.createCopyingNodeIdRemapper; } });
+Object.defineProperty(exports, "createIdentityNodeIdRemapper", { enumerable: true, get: function () { return conversions_1.createIdentityNodeIdRemapper; } });
+var experimentalFeatures_1 = require("./experimentalFeatures");
+Object.defineProperty(exports, "isFullSnapshotChangeRecordsEnabled", { enumerable: true, get: function () { return experimentalFeatures_1.isFullSnapshotChangeRecordsEnabled; } });
+Object.defineProperty(exports, "isIncrementalSnapshotChangeRecordsEnabled", { enumerable: true, get: function () { return experimentalFeatures_1.isIncrementalSnapshotChangeRecordsEnabled; } });
+var insertionCursor_1 = require("./insertionCursor");
+Object.defineProperty(exports, "createChildInsertionCursor", { enumerable: true, get: function () { return insertionCursor_1.createChildInsertionCursor; } });
+Object.defineProperty(exports, "createRootInsertionCursor", { enumerable: true, get: function () { return insertionCursor_1.createRootInsertionCursor; } });
+var serializationUtils_1 = require("./serializationUtils");
+Object.defineProperty(exports, "getElementInputValue", { enumerable: true, get: function () { return serializationUtils_1.getElementInputValue; } });
+var serializeFullSnapshot_1 = require("./serializeFullSnapshot");
+Object.defineProperty(exports, "serializeFullSnapshot", { enumerable: true, get: function () { return serializeFullSnapshot_1.serializeFullSnapshot; } });
+var serializeFullSnapshotAsChange_1 = require("./serializeFullSnapshotAsChange");
+Object.defineProperty(exports, "serializeFullSnapshotAsChange", { enumerable: true, get: function () { return serializeFullSnapshotAsChange_1.serializeFullSnapshotAsChange; } });
+var serializeMutations_1 = require("./serializeMutations");
+Object.defineProperty(exports, "serializeMutations", { enumerable: true, get: function () { return serializeMutations_1.serializeMutations; } });
+var serializeMutationsAsChange_1 = require("./serializeMutationsAsChange");
+Object.defineProperty(exports, "serializeMutationsAsChange", { enumerable: true, get: function () { return serializeMutationsAsChange_1.serializeMutationsAsChange; } });
+var serializeNode_1 = require("./serializeNode");
+Object.defineProperty(exports, "serializeNode", { enumerable: true, get: function () { return serializeNode_1.serializeNode; } });
+var serializeNodeAsChange_1 = require("./serializeNodeAsChange");
+Object.defineProperty(exports, "serializeNodeAsChange", { enumerable: true, get: function () { return serializeNodeAsChange_1.serializeNodeAsChange; } });
+var serializeAttribute_1 = require("./serializeAttribute");
+Object.defineProperty(exports, "serializeAttribute", { enumerable: true, get: function () { return serializeAttribute_1.serializeAttribute; } });
+var serializationStats_1 = require("./serializationStats");
+Object.defineProperty(exports, "createSerializationStats", { enumerable: true, get: function () { return serializationStats_1.createSerializationStats; } });
+Object.defineProperty(exports, "updateSerializationStats", { enumerable: true, get: function () { return serializationStats_1.updateSerializationStats; } });
+Object.defineProperty(exports, "aggregateSerializationStats", { enumerable: true, get: function () { return serializationStats_1.aggregateSerializationStats; } });
+var serializationTransaction_1 = require("./serializationTransaction");
+Object.defineProperty(exports, "serializeChangesInTransaction", { enumerable: true, get: function () { return serializationTransaction_1.serializeChangesInTransaction; } });
+Object.defineProperty(exports, "serializeInTransaction", { enumerable: true, get: function () { return serializationTransaction_1.serializeInTransaction; } });
+//# sourceMappingURL=index.js.map

package/cjs/domain/record/serialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/record/serialization/index.ts"],"names":[],"mappings":";;;AACA,6CAAgH;AAAvG,oHAAA,qBAAqB,OAAA;AAAE,0HAAA,2BAA2B,OAAA;AAAE,2HAAA,4BAA4B,OAAA;AACzF,+DAAsH;AAA7G,0IAAA,kCAAkC,OAAA;AAAE,iJAAA,yCAAyC,OAAA;AACtF,qDAAyF;AAAhF,6HAAA,0BAA0B,OAAA;AAAE,4HAAA,yBAAyB,OAAA;AAC9D,2DAA2D;AAAlD,0HAAA,oBAAoB,OAAA;AAC7B,iEAA+D;AAAtD,8HAAA,qBAAqB,OAAA;AAC9B,iFAA+E;AAAtE,8IAAA,6BAA6B,OAAA;AACtC,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAC3B,2EAAyE;AAAhE,wIAAA,0BAA0B,OAAA;AACnC,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AACtB,iEAA+D;AAAtD,8HAAA,qBAAqB,OAAA;AAC9B,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAC3B,2DAAsH;AAA7G,8HAAA,wBAAwB,OAAA;AAAE,8HAAA,wBAAwB,OAAA;AAAE,iIAAA,2BAA2B,OAAA;AAExF,uEAAqH;AAA5G,yIAAA,6BAA6B,OAAA;AAAE,kIAAA,sBAAsB,OAAA"}

package/cjs/domain/record/serialization/insertionCursor.d.ts

@@ -0,0 +1,57 @@
+import type { InsertionPoint } from '../../../types';
+import type { NodeId, NodeIds } from '../itemIds';
+/**
+ * InsertionCursor tracks the point at which the next node will be inserted during
+ * Change-style DOM serialization.
+ *
+ * When a new node is added to the document, we use an InsertionPoint to encode its
+ * position. There are often multiple equally-valid ways to express the same insertion
+ * point; we generally want to favor encodings that use as few characters as possible (to
+ * reduce uncompressed size) and that are as repetitive as possible (to reduce compressed
+ * size). InsertionCursor's purpose is to heuristically pick an efficient encoding based
+ * on the nodes we've recently serialized, while doing as little work as possible. The
+ * results are not optimal, but should be close to it in most situations.
+ *
+ * At the beginning of the serialization process, use a factory function like
+ * createRootInsertionCursor() to create a new cursor with an appropriate initial
+ * position.
+ *
+ * When visiting a node, the expected usage pattern is as follows:
+ * 1. Call advance() to get a node id and insertion point for the node.
+ * 2. Serialize the node.
+ * 3. If the node has no children, we're done; continue to the node's next
+ * sibling and apply this algorithm again.
+ * 4. Otherwise, call descend() to move the cursor into the node's child list.
+ * 5. Recursively apply this algorithm.
+ * 6. Call ascend() to move the cursor out of the node's child list. We're done;
+ * continue to the node's next sibling and apply this algorithm again.
+ */
+export interface InsertionCursor {
+    /**
+     * Given the node id for a new node, returns the InsertionPoint for that node.
+     * Updates the cursor to point to the new node's next sibling.
+     */
+    advance(node: Node): {
+        nodeId: NodeId;
+        insertionPoint: InsertionPoint;
+    };
+    /**
+     * Ascends out of the current child list and updates the cursor to point to the parent
+     * node's next sibling.
+     */
+    ascend(): void;
+    /**
+     * Descends into the child list of the last node we inserted and updates the cursor to
+     * point to the node's first child.
+     */
+    descend(): void;
+}
+/** Returns an InsertionCursor which starts positioned at the root of the document. */
+export declare function createRootInsertionCursor(nodeIds: NodeIds): InsertionCursor;
+/**
+ * Returns an InsertionCursor which starts positioned in the child list of the given
+ * parent node. If a next sibling is provided, the cursor points to the position
+ * immediately before the next sibling; otherwise, the cursor points to the end of the
+ * child list.
+ */
+export declare function createChildInsertionCursor(parentId: NodeId, nextSiblingId: NodeId | undefined, nodeIds: NodeIds): InsertionCursor;

package/cjs/domain/record/serialization/insertionCursor.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRootInsertionCursor = createRootInsertionCursor;
+exports.createChildInsertionCursor = createChildInsertionCursor;
+/** Returns an InsertionCursor which starts positioned at the root of the document. */
+function createRootInsertionCursor(nodeIds) {
+    return createInsertionCursor(undefined, undefined, nodeIds);
+}
+/**
+ * Returns an InsertionCursor which starts positioned in the child list of the given
+ * parent node. If a next sibling is provided, the cursor points to the position
+ * immediately before the next sibling; otherwise, the cursor points to the end of the
+ * child list.
+ */
+function createChildInsertionCursor(parentId, nextSiblingId, nodeIds) {
+    return createInsertionCursor(parentId, nextSiblingId, nodeIds);
+}
+function createInsertionCursor(parentId, nextSiblingId, nodeIds) {
+    let cursor = {
+        container: undefined,
+        parentId,
+        previousSiblingId: undefined,
+        nextSiblingId,
+    };
+    const computeInsertionPoint = (nodeId) => {
+        if (cursor.previousSiblingId === nodeId - 1) {
+            // Use an AppendAfterPreviousInsertionPoint. (i.e., 0)
+            return 0;
+        }
+        if (cursor.nextSiblingId !== undefined) {
+            // Use an InsertBeforeInsertionPoint. We identify the next sibling using a
+            // negative integer indicating the difference between the new node's id and its next
+            // sibling's id.
+            return cursor.nextSiblingId - nodeId;
+        }
+        if (cursor.parentId !== undefined) {
+            // Use an AppendChildInsertionPoint. We identify the parent node using a positive
+            // integer indicating the difference between the new node's id and its parent's id.
+            return nodeId - cursor.parentId;
+        }
+        // There's no parent. Use a RootInsertionPoint. (i.e., null)
+        return null;
+    };
+    return {
+        advance(node) {
+            const nodeId = nodeIds.getOrInsert(node);
+            const insertionPoint = computeInsertionPoint(nodeId);
+            cursor.previousSiblingId = nodeId;
+            return { nodeId, insertionPoint };
+        },
+        ascend() {
+            if (cursor.container) {
+                cursor = cursor.container;
+            }
+        },
+        descend() {
+            if (cursor.previousSiblingId !== undefined) {
+                cursor = {
+                    container: cursor,
+                    parentId: cursor.previousSiblingId,
+                    previousSiblingId: undefined,
+                    nextSiblingId: undefined,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=insertionCursor.js.map

package/cjs/domain/record/serialization/insertionCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertionCursor.js","sourceRoot":"","sources":["../../../../src/domain/record/serialization/insertionCursor.ts"],"names":[],"mappings":";;AAkDA,8DAEC;AAQD,gEAMC;AAjBD,sFAAsF;AACtF,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,OAAO,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CACxC,QAAgB,EAChB,aAAiC,EACjC,OAAgB;IAEhB,OAAO,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;AAChE,CAAC;AAED,SAAS,qBAAqB,CAC5B,QAA4B,EAC5B,aAAiC,EACjC,OAAgB;IAShB,IAAI,MAAM,GAAoB;QAC5B,SAAS,EAAE,SAAS;QACpB,QAAQ;QACR,iBAAiB,EAAE,SAAS;QAC5B,aAAa;KACd,CAAA;IAED,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAkB,EAAE;QAC/D,IAAI,MAAM,CAAC,iBAAiB,KAAK,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,sDAAsD;YACtD,OAAO,CAAC,CAAA;QACV,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,0EAA0E;YAC1E,oFAAoF;YACpF,gBAAgB;YAChB,OAAO,MAAM,CAAC,aAAa,GAAG,MAAM,CAAA;QACtC,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,iFAAiF;YACjF,mFAAmF;YACnF,OAAO,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAA;QACjC,CAAC;QACD,4DAA4D;QAC5D,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED,OAAO;QACL,OAAO,CAAC,IAAU;YAChB,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YACxC,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;YACpD,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAA;YACjC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACnC,CAAC;QACD,MAAM;YACJ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,MAAM,GAAG,MAAM,CAAC,SAAS,CAAA;YAC3B,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBAC3C,MAAM,GAAG;oBACP,SAAS,EAAE,MAAM;oBACjB,QAAQ,EAAE,MAAM,CAAC,iBAAiB;oBAClC,iBAAiB,EAAE,SAAS;oBAC5B,aAAa,EAAE,SAAS;iBACzB,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/cjs/domain/record/serialization/serialization.types.d.ts

@@ -0,0 +1,24 @@
+import type { NodePrivacyLevel } from '@datadog/browser-rum-core';
+export type ParentNodePrivacyLevel = typeof NodePrivacyLevel.ALLOW | typeof NodePrivacyLevel.MASK | typeof NodePrivacyLevel.MASK_USER_INPUT | typeof NodePrivacyLevel.MASK_UNLESS_ALLOWLISTED;
+/**
+ * Virtual attributes. These attributes appear in the serialized attribute map of
+ * elements, but they're not actually derived from the DOM; they're used to represent
+ * metadata about the element they're attached to.
+ */
+export interface VirtualAttributes {
+    /**
+     * For <style> and <link> elements, the rules in the element's stylesheet, extracted
+     * from the CSSOM.
+     */
+    _cssText?: string;
+    /** For <audio> and <video> elements, the playback state of the element's media. */
+    rr_mediaState?: 'paused' | 'played';
+    /** For elements which are scroll containers, the element's X scroll position, if non-zero. */
+    rr_scrollLeft?: number;
+    /** For elements which are scroll containers, the element's Y scroll position, if non-zero. */
+    rr_scrollTop?: number;
+    /** For HIDDEN elements, the width of the element's bounding client rect. */
+    rr_width?: string;
+    /** For HIDDEN elements, the height of the element's bounding client rect. */
+    rr_height?: string;
+}

package/cjs/domain/record/serialization/serialization.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=serialization.types.js.map

package/cjs/domain/record/serialization/serialization.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.types.js","sourceRoot":"","sources":["../../../../src/domain/record/serialization/serialization.types.ts"],"names":[],"mappings":""}

package/cjs/domain/record/serialization/serializationStats.d.ts

@@ -0,0 +1,12 @@
+export interface SerializationMetric {
+    count: number;
+    max: number;
+    sum: number;
+}
+export interface SerializationStats {
+    cssText: SerializationMetric;
+    serializationDuration: SerializationMetric;
+}
+export declare function createSerializationStats(): SerializationStats;
+export declare function updateSerializationStats(stats: SerializationStats, metric: keyof SerializationStats, value: number): void;
+export declare function aggregateSerializationStats(aggregateStats: SerializationStats, stats: SerializationStats): void;

package/cjs/domain/record/serialization/serializationStats.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSerializationStats = createSerializationStats;
+exports.updateSerializationStats = updateSerializationStats;
+exports.aggregateSerializationStats = aggregateSerializationStats;
+function createSerializationStats() {
+    return {
+        cssText: {
+            count: 0,
+            max: 0,
+            sum: 0,
+        },
+        serializationDuration: {
+            count: 0,
+            max: 0,
+            sum: 0,
+        },
+    };
+}
+function updateSerializationStats(stats, metric, value) {
+    stats[metric].count += 1;
+    stats[metric].max = Math.max(stats[metric].max, value);
+    stats[metric].sum += value;
+}
+function aggregateSerializationStats(aggregateStats, stats) {
+    for (const metric of ['cssText', 'serializationDuration']) {
+        aggregateStats[metric].count += stats[metric].count;
+        aggregateStats[metric].max = Math.max(aggregateStats[metric].max, stats[metric].max);
+        aggregateStats[metric].sum += stats[metric].sum;
+    }
+}
+//# sourceMappingURL=serializationStats.js.map

package/cjs/domain/record/serialization/serializationStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializationStats.js","sourceRoot":"","sources":["../../../../src/domain/record/serialization/serializationStats.ts"],"names":[],"mappings":";;AAWA,4DAaC;AAED,4DAQC;AAED,kEAMC;AA/BD,SAAgB,wBAAwB;IACtC,OAAO;QACL,OAAO,EAAE;YACP,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACP;QACD,qBAAqB,EAAE;YACrB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACP;KACF,CAAA;AACH,CAAC;AAED,SAAgB,wBAAwB,CACtC,KAAyB,EACzB,MAAgC,EAChC,KAAa;IAEb,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;IACxB,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACtD,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,KAAK,CAAA;AAC5B,CAAC;AAED,SAAgB,2BAA2B,CAAC,cAAkC,EAAE,KAAyB;IACvG,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAU,EAAE,CAAC;QACnE,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAA;QACnD,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;QACpF,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAA;IACjD,CAAC;AACH,CAAC"}

package/cjs/domain/record/serialization/serializationTransaction.d.ts

@@ -0,0 +1,96 @@
+import type { TimeStamp } from '@datadog/browser-core';
+import type { AddCDataSectionNodeChange, AddDocTypeNodeChange, AddDocumentFragmentNodeChange, AddDocumentNodeChange, AddElementNodeChange, AddNodeChange, AddShadowRootNodeChange, AddTextNodeChange, AttributeChange, BrowserRecord, InsertionPoint, MediaInteractionType, StyleSheetMediaList, StyleSheetRules } from '../../../types';
+import type { NodeId, StyleSheetId } from '../itemIds';
+import type { EmitRecordCallback, EmitStatsCallback } from '../record.types';
+import type { RecordingScope } from '../recordingScope';
+import type { SerializationStats } from './serializationStats';
+export type SerializationTransactionCallback = (transaction: SerializationTransaction) => void;
+export declare const enum SerializationKind {
+    INITIAL_FULL_SNAPSHOT = 0,
+    SUBSEQUENT_FULL_SNAPSHOT = 1,
+    INCREMENTAL_SNAPSHOT = 2
+}
+/**
+ * A serialization transaction is used to build and emit a sequence of session replay
+ * records containing a serialized snapshot of the DOM.
+ */
+export interface SerializationTransaction {
+    /** Add a record to the transaction. It will be emitted when the transaction ends. */
+    add(record: BrowserRecord): void;
+    /**
+     * Add a metric to the transaction's statistics. The aggregated statistics will be
+     * emitted when the transaction ends.
+     */
+    addMetric(metric: keyof SerializationStats, value: number): void;
+    /**
+     * Assign and return an id to the given node. If the node has previously been assigned
+     * an id, the existing id will be reused.
+     */
+    assignId(node: Node): NodeId;
+    /** The kind of serialization being performed in this transaction. */
+    kind: SerializationKind;
+    /**
+     * A set used to track nodes which have been serialized in the current transaction. If
+     * undefined, this feature is disabled; this is the default state in new transactions
+     * for performance reasons. Set the property to a non-undefined value if you need this
+     * capability.
+     */
+    serializedNodeIds?: Set<NodeId>;
+    /** The recording scope in which this transaction is occurring. */
+    scope: RecordingScope;
+}
+/**
+ * Perform serialization within a transaction. At the end of the transaction, the
+ * generated records and statistics will be emitted.
+ */
+export declare function serializeInTransaction(kind: SerializationKind, emitRecord: EmitRecordCallback, emitStats: EmitStatsCallback, scope: RecordingScope, serialize: SerializationTransactionCallback): void;
+type AddNodeParams<NodeChange extends AddNodeChange> = NodeChange extends [any, any, ...infer Params] ? Params : never;
+export type ChangeSerializationTransactionCallback = (transaction: ChangeSerializationTransaction) => void;
+/**
+ * ChangeSerializationTransaction is used to build and emit a BrowserChangeRecord
+ * containing a serialized snapshot of the DOM. Unlike SerializationTransaction, it
+ * doesn't support emitting arbitrary BrowserRecords; instead, the builder methods it
+ * exposes are used to construct a single BrowserChangeRecord which is emitted at the end
+ * of the transaction.
+ */
+export interface ChangeSerializationTransaction {
+    /**
+     * Add a metric to the transaction's statistics. The aggregated statistics will be
+     * emitted when the transaction ends.
+     */
+    addMetric(metric: keyof SerializationStats, value: number): void;
+    /** Add a node to the document at the given insertion point. */
+    addNode(pos: InsertionPoint, nodeName: '#cdata-section', ...params: AddNodeParams<AddCDataSectionNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: '#doctype', ...params: AddNodeParams<AddDocTypeNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: '#document', ...params: AddNodeParams<AddDocumentNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: '#document-fragment', ...params: AddNodeParams<AddDocumentFragmentNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: '#shadow-root', ...params: AddNodeParams<AddShadowRootNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: '#text', ...params: AddNodeParams<AddTextNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: Exclude<string, `#${string}`>, ...params: AddNodeParams<AddElementNodeChange>): void;
+    addNode(pos: InsertionPoint, nodeName: string, ...params: AddNodeParams<AddNodeChange>): void;
+    /** Add a stylesheet to the document. */
+    addStyleSheet(rules: StyleSheetRules, mediaList?: StyleSheetMediaList, disabled?: boolean): void;
+    /**
+     * Attach one or more stylesheets to a <link>, <style>, #document, #document-fragment,
+     * or #shadow-root node.
+     */
+    attachStyleSheets(nodeId: NodeId, sheetIds: StyleSheetId[]): void;
+    /** Remove a node from the document. */
+    removeNode(nodeId: NodeId): void;
+    /** Set a node's attributes to the given values. */
+    setAttributes(change: AttributeChange): void;
+    /** Set the media playback state of an <audio> or <video> element. */
+    setMediaPlaybackState(nodeId: NodeId, state: MediaInteractionType): void;
+    /** Set the given node's scroll position in CSS pixels. */
+    setScrollPosition(nodeId: NodeId, x: number, y: number): void;
+    /** Set the given node's size in CSS pixels. */
+    setSize(nodeId: NodeId, width: number, height: number): void;
+    /** Set the given node's text content. */
+    setText(nodeId: NodeId, content: string): void;
+    /** The kind of serialization being performed in this transaction. */
+    kind: SerializationKind;
+    /** The recording scope in which this transaction is occurring. */
+    scope: RecordingScope;
+}
+export declare function serializeChangesInTransaction(kind: SerializationKind, emitRecord: EmitRecordCallback, emitStats: EmitStatsCallback, scope: RecordingScope, timestamp: TimeStamp, serialize: ChangeSerializationTransactionCallback): void;
+export {};

package/cjs/domain/record/serialization/serializationTransaction.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeInTransaction = serializeInTransaction;
+exports.serializeChangesInTransaction = serializeChangesInTransaction;
+const browser_core_1 = require("@datadog/browser-core");
+const types_1 = require("../../../types");
+const serializationStats_1 = require("./serializationStats");
+const changeEncoder_1 = require("./changeEncoder");
+/**
+ * Perform serialization within a transaction. At the end of the transaction, the
+ * generated records and statistics will be emitted.
+ */
+function serializeInTransaction(kind, emitRecord, emitStats, scope, serialize) {
+    const records = [];
+    const stats = (0, serializationStats_1.createSerializationStats)();
+    const transaction = {
+        add(record) {
+            records.push(record);
+        },
+        addMetric(metric, value) {
+            (0, serializationStats_1.updateSerializationStats)(stats, metric, value);
+        },
+        assignId(node) {
+            const id = scope.nodeIds.getOrInsert(node);
+            if (transaction.serializedNodeIds) {
+                transaction.serializedNodeIds.add(id);
+            }
+            return id;
+        },
+        kind,
+        scope,
+    };
+    const start = (0, browser_core_1.timeStampNow)();
+    serialize(transaction);
+    (0, serializationStats_1.updateSerializationStats)(stats, 'serializationDuration', (0, browser_core_1.elapsed)(start, (0, browser_core_1.timeStampNow)()));
+    for (const record of records) {
+        emitRecord(record);
+    }
+    emitStats(stats);
+}
+function serializeChangesInTransaction(kind, emitRecord, emitStats, scope, timestamp, serialize) {
+    const encoder = (0, changeEncoder_1.createChangeEncoder)(scope.stringIds);
+    const stats = (0, serializationStats_1.createSerializationStats)();
+    const transaction = {
+        addMetric(metric, value) {
+            (0, serializationStats_1.updateSerializationStats)(stats, metric, value);
+        },
+        addNode(...change) {
+            encoder.add(types_1.ChangeType.AddNode, change);
+        },
+        addStyleSheet(rules, mediaList, disabled) {
+            if (disabled) {
+                encoder.add(types_1.ChangeType.AddStyleSheet, [rules, mediaList || [], disabled]);
+            }
+            else if (mediaList) {
+                encoder.add(types_1.ChangeType.AddStyleSheet, [rules, mediaList]);
+            }
+            else {
+                encoder.add(types_1.ChangeType.AddStyleSheet, [rules]);
+            }
+        },
+        attachStyleSheets(nodeId, sheetIds) {
+            const change = [nodeId];
+            for (const sheetId of sheetIds) {
+                change.push(sheetId);
+            }
+            encoder.add(types_1.ChangeType.AttachedStyleSheets, change);
+        },
+        removeNode(nodeId) {
+            encoder.add(types_1.ChangeType.RemoveNode, nodeId);
+        },
+        setAttributes(change) {
+            encoder.add(types_1.ChangeType.Attribute, change);
+        },
+        setMediaPlaybackState(nodeId, state) {
+            encoder.add(types_1.ChangeType.MediaPlaybackState, [nodeId, state]);
+        },
+        setScrollPosition(nodeId, x, y) {
+            encoder.add(types_1.ChangeType.ScrollPosition, [nodeId, x, y]);
+        },
+        setSize(nodeId, width, height) {
+            encoder.add(types_1.ChangeType.Size, [nodeId, width, height]);
+        },
+        setText(nodeId, content) {
+            encoder.add(types_1.ChangeType.Text, [nodeId, content]);
+        },
+        kind,
+        scope,
+    };
+    const start = (0, browser_core_1.timeStampNow)();
+    serialize(transaction);
+    (0, serializationStats_1.updateSerializationStats)(stats, 'serializationDuration', (0, browser_core_1.elapsed)(start, (0, browser_core_1.timeStampNow)()));
+    const changes = encoder.flush();
+    if (changes.length > 0) {
+        emitRecord({
+            data: changes,
+            type: types_1.RecordType.Change,
+            timestamp,
+        });
+    }
+    emitStats(stats);
+}
+//# sourceMappingURL=serializationTransaction.js.map

package/cjs/domain/record/serialization/serializationTransaction.js.map

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

package/cjs/domain/record/serialization/serializationUtils.d.ts

@@ -0,0 +1,18 @@
+import type { NodePrivacyLevel } from '@datadog/browser-rum-core';
+/**
+ * Get the element "value" to be serialized as an attribute or an input update record. It respects
+ * the input privacy mode of the element.
+ * PERFROMANCE OPTIMIZATION: Assumes that privacy level `HIDDEN` is never encountered because of earlier checks.
+ */
+export declare function getElementInputValue(element: Element, nodePrivacyLevel: NodePrivacyLevel): string | undefined;
+export declare const URL_IN_CSS_REF: RegExp;
+export declare const ABSOLUTE_URL: RegExp;
+export declare const DATA_URI: RegExp;
+export declare function switchToAbsoluteUrl(cssText: string, cssHref: string | null): string;
+export declare function getValidTagName(tagName: string): string;
+/**
+ * Returns the tag name of the given element, normalized to ensure a consistent lowercase
+ * representation regardless of whether the element is HTML, XHTML, or SVG.
+ */
+export declare function normalizedTagName(element: Element): string;
+export declare function censoredImageForSize(width: number, height: number): string;

package/cjs/domain/record/serialization/serializationUtils.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_URI = exports.ABSOLUTE_URL = exports.URL_IN_CSS_REF = void 0;
+exports.getElementInputValue = getElementInputValue;
+exports.switchToAbsoluteUrl = switchToAbsoluteUrl;
+exports.getValidTagName = getValidTagName;
+exports.normalizedTagName = normalizedTagName;
+exports.censoredImageForSize = censoredImageForSize;
+const browser_core_1 = require("@datadog/browser-core");
+const browser_rum_core_1 = require("@datadog/browser-rum-core");
+/**
+ * Get the element "value" to be serialized as an attribute or an input update record. It respects
+ * the input privacy mode of the element.
+ * PERFROMANCE OPTIMIZATION: Assumes that privacy level `HIDDEN` is never encountered because of earlier checks.
+ */
+function getElementInputValue(element, nodePrivacyLevel) {
+    /*
+     BROWSER SPEC NOTE: <input>, <select>
+     For some <input> elements, the `value` is an exceptional property/attribute that has the
+     value synced between el.value and el.getAttribute()
+     input[type=button,checkbox,hidden,image,radio,reset,submit]
+     */
+    const tagName = element.tagName;
+    const value = element.value;
+    if ((0, browser_rum_core_1.shouldMaskNode)(element, nodePrivacyLevel)) {
+        const type = element.type;
+        if (tagName === 'INPUT' && (type === 'button' || type === 'submit' || type === 'reset')) {
+            // Overrule `MASK` privacy level for button-like element values, as they are used during replay
+            // to display their label. They can still be hidden via the "hidden" privacy attribute or class name.
+            return value;
+        }
+        else if (!value || tagName === 'OPTION') {
+            // <Option> value provides no benefit
+            return;
+        }
+        return browser_rum_core_1.CENSORED_STRING_MARK;
+    }
+    if (tagName === 'OPTION' || tagName === 'SELECT') {
+        return element.value;
+    }
+    if (tagName !== 'INPUT' && tagName !== 'TEXTAREA') {
+        return;
+    }
+    return value;
+}
+exports.URL_IN_CSS_REF = /url\((?:(')([^']*)'|(")([^"]*)"|([^)]*))\)/gm;
+exports.ABSOLUTE_URL = /^[A-Za-z]+:|^\/\//;
+exports.DATA_URI = /^["']?data:.*,/i;
+function switchToAbsoluteUrl(cssText, cssHref) {
+    return cssText.replace(exports.URL_IN_CSS_REF, (matchingSubstring, singleQuote, urlWrappedInSingleQuotes, doubleQuote, urlWrappedInDoubleQuotes, urlNotWrappedInQuotes) => {
+        const url = urlWrappedInSingleQuotes || urlWrappedInDoubleQuotes || urlNotWrappedInQuotes;
+        if (!cssHref || !url || exports.ABSOLUTE_URL.test(url) || exports.DATA_URI.test(url)) {
+            return matchingSubstring;
+        }
+        const quote = singleQuote || doubleQuote || '';
+        return `url(${quote}${makeUrlAbsolute(url, cssHref)}${quote})`;
+    });
+}
+function makeUrlAbsolute(url, baseUrl) {
+    try {
+        return (0, browser_core_1.buildUrl)(url, baseUrl).href;
+    }
+    catch (_a) {
+        return url;
+    }
+}
+const TAG_NAME_REGEX = /[^a-z1-6-_]/;
+function getValidTagName(tagName) {
+    const processedTagName = tagName.toLowerCase().trim();
+    if (TAG_NAME_REGEX.test(processedTagName)) {
+        // if the tag name is odd and we cannot extract
+        // anything from the string, then we return a
+        // generic div
+        return 'div';
+    }
+    return processedTagName;
+}
+/**
+ * Returns the tag name of the given element, normalized to ensure a consistent lowercase
+ * representation regardless of whether the element is HTML, XHTML, or SVG.
+ */
+function normalizedTagName(element) {
+    return element.tagName.toLowerCase();
+}
+function censoredImageForSize(width, height) {
+    return `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='${width}' height='${height}' style='background-color:silver'%3E%3C/svg%3E`;
+}
+//# sourceMappingURL=serializationUtils.js.map

package/cjs/domain/record/serialization/serializationUtils.js.map

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

package/cjs/domain/record/serialization/serializeAttribute.d.ts

@@ -0,0 +1,4 @@
+import { NodePrivacyLevel } from '@datadog/browser-rum-core';
+import type { RumConfiguration } from '@datadog/browser-rum-core';
+export declare const MAX_ATTRIBUTE_VALUE_CHAR_LENGTH = 1000000;
+export declare function serializeAttribute(element: Element, nodePrivacyLevel: NodePrivacyLevel, attributeName: string, configuration: RumConfiguration): string | null;

package/cjs/domain/record/serialization/serializeAttribute.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_ATTRIBUTE_VALUE_CHAR_LENGTH = void 0;
+exports.serializeAttribute = serializeAttribute;
+const browser_rum_core_1 = require("@datadog/browser-rum-core");
+const serializationUtils_1 = require("./serializationUtils");
+// TODO: temporarily bump the Session Replay limit to 1Mb for dataUrls
+// This limit should be removed after [PANA-2843] is implemented
+exports.MAX_ATTRIBUTE_VALUE_CHAR_LENGTH = 1000000;
+function serializeAttribute(element, nodePrivacyLevel, attributeName, configuration) {
+    if (nodePrivacyLevel === browser_rum_core_1.NodePrivacyLevel.HIDDEN) {
+        // dup condition for direct access case
+        return null;
+    }
+    const attributeValue = element.getAttribute(attributeName);
+    const tagName = element.tagName;
+    if ((0, browser_rum_core_1.shouldMaskAttribute)(tagName, attributeName, attributeValue, nodePrivacyLevel, configuration)) {
+        // mask image URLs
+        if (tagName === 'IMG') {
+            // generate image with similar dimension than the original to have the same rendering behaviour
+            const image = element;
+            if (image.naturalWidth > 0) {
+                return (0, serializationUtils_1.censoredImageForSize)(image.naturalWidth, image.naturalHeight);
+            }
+            const { width, height } = element.getBoundingClientRect();
+            if (width > 0 || height > 0) {
+                return (0, serializationUtils_1.censoredImageForSize)(width, height);
+            }
+            // if we can't get the image size, fallback to the censored image
+            return browser_rum_core_1.CENSORED_IMG_MARK;
+        }
+        if (tagName === 'SOURCE') {
+            return browser_rum_core_1.CENSORED_IMG_MARK;
+        }
+        return browser_rum_core_1.CENSORED_STRING_MARK;
+    }
+    if (!attributeValue) {
+        return attributeValue;
+    }
+    return (0, browser_rum_core_1.sanitizeIfLongDataUrl)(attributeValue, exports.MAX_ATTRIBUTE_VALUE_CHAR_LENGTH);
+}
+//# sourceMappingURL=serializeAttribute.js.map

package/cjs/domain/record/serialization/serializeAttribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeAttribute.js","sourceRoot":"","sources":["../../../../src/domain/record/serialization/serializeAttribute.ts"],"names":[],"mappings":";;;AAcA,gDAwCC;AAtDD,gEAMkC;AAElC,6DAA2D;AAE3D,sEAAsE;AACtE,gEAAgE;AACnD,QAAA,+BAA+B,GAAG,OAAS,CAAA;AAExD,SAAgB,kBAAkB,CAChC,OAAgB,EAChB,gBAAkC,EAClC,aAAqB,EACrB,aAA+B;IAE/B,IAAI,gBAAgB,KAAK,mCAAgB,CAAC,MAAM,EAAE,CAAC;QACjD,uCAAuC;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAA;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAC/B,IAAI,IAAA,sCAAmB,EAAC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,CAAC;QACjG,kBAAkB;QAClB,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,+FAA+F;YAC/F,MAAM,KAAK,GAAG,OAA2B,CAAA;YACzC,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAA,yCAAoB,EAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;YACtE,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAA;YACzD,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAA,yCAAoB,EAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC5C,CAAC;YACD,iEAAiE;YACjE,OAAO,oCAAiB,CAAA;QAC1B,CAAC;QACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO,oCAAiB,CAAA;QAC1B,CAAC;QAED,OAAO,uCAAoB,CAAA;IAC7B,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,OAAO,IAAA,wCAAqB,EAAC,cAAc,EAAE,uCAA+B,CAAC,CAAA;AAC/E,CAAC"}