@mikeci/pos-replay-protocol 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @mikeci/pos-replay-protocol
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Hợp đồng session replay dùng chung cho SDK, collector và player. `protocolVersion` hiện tại là `1`. Player từ chối bản ghi có version cao hơn.
+
+Chunk bắt đầu bằng một record `snapshot`. `patch` cập nhật hoặc xóa node. `interaction` ghi tap hoặc scroll. `privacy_boundary` chặn nội dung nhạy cảm. `lifecycle` ghi background, foreground, đổi tài khoản hoặc khoảng trống.
+
+`encodeChunk` gắn checksum SHA-256 của JSON đã sắp khóa, không gồm chính checksum. Cùng nội dung luôn ra cùng checksum. Payload bị sửa sẽ không qua `decodeChunk`.
+
+Tọa độ node là tương đối với `parentId`. Ô `input` và component có tên nhạy cảm được đổi text thành `••••` trước khi ra khỏi thiết bị.

package/dist/codec.d.ts

@@ -0,0 +1,12 @@
+import { type ReplayChunk, type ReplayNode } from "./types.js";
+export declare function stableJson(value: unknown): string;
+/** SHA-256 dùng khi runtime không có Web Crypto, ví dụ Hermes. */
+export declare function sha256Fallback(text: string): string;
+export declare function sha256Hex(text: string): Promise<string>;
+export declare function chunkWithoutChecksum(chunk: ReplayChunk): ReplayChunk;
+export declare function checksumChunk(chunk: ReplayChunk): Promise<string>;
+export declare function validateNode(node: ReplayNode): string[];
+export declare function validateChunk(chunk: ReplayChunk): string[];
+export declare function encodeChunk(chunk: ReplayChunk): Promise<ReplayChunk>;
+export declare function decodeChunk(input: unknown): Promise<ReplayChunk>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmF,KAAK,WAAW,EAAE,KAAK,UAAU,EAAqB,MAAM,YAAY,CAAC;AAmBnK,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AA4BD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkDnD;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAIpE;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvE;AAYD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAUvD;AAyBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAc1D;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAK1E;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAStE"}

package/dist/codec.js

@@ -0,0 +1,221 @@
+import { MAX_CHUNK_BYTES, MAX_NODES, MAX_RECORDS, MAX_TEXT, NODE_TYPES, PROTOCOL_VERSION } from "./types.js";
+const NODE_KEYS = new Set([
+    "id",
+    "parentId",
+    "type",
+    "bounds",
+    "zIndex",
+    "clipsChildren",
+    "text",
+    "assetId",
+    "state",
+    "style",
+    "componentId",
+    "contentId",
+    "contentVersion",
+    "masked",
+]);
+export function stableJson(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value))
+        return value.map(sortValue);
+    if (!value || typeof value !== "object")
+        return value;
+    const source = value;
+    const out = {};
+    for (const key of Object.keys(source).sort()) {
+        if (source[key] !== undefined)
+            out[key] = sortValue(source[key]);
+    }
+    return out;
+}
+const SHA_K = [
+    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
+    0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
+    0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+    0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
+    0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+    0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
+    0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+];
+function rotr(value, bits) {
+    return (value >>> bits) | (value << (32 - bits));
+}
+/** SHA-256 dùng khi runtime không có Web Crypto, ví dụ Hermes. */
+export function sha256Fallback(text) {
+    const bytes = [...new TextEncoder().encode(text)];
+    const bitLength = bytes.length * 8;
+    bytes.push(0x80);
+    while (bytes.length % 64 !== 56)
+        bytes.push(0);
+    const high = Math.floor(bitLength / 0x100000000);
+    const low = bitLength >>> 0;
+    for (let shift = 24; shift >= 0; shift -= 8)
+        bytes.push((high >>> shift) & 0xff);
+    for (let shift = 24; shift >= 0; shift -= 8)
+        bytes.push((low >>> shift) & 0xff);
+    const hash = [0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19];
+    const words = new Array(64);
+    for (let offset = 0; offset < bytes.length; offset += 64) {
+        for (let index = 0; index < 16; index += 1) {
+            const start = offset + index * 4;
+            words[index] = ((bytes[start] ?? 0) << 24) | ((bytes[start + 1] ?? 0) << 16) | ((bytes[start + 2] ?? 0) << 8) | (bytes[start + 3] ?? 0);
+        }
+        for (let index = 16; index < 64; index += 1) {
+            const start = words[index - 15] ?? 0;
+            const end = words[index - 2] ?? 0;
+            const small = rotr(start, 7) ^ rotr(start, 18) ^ (start >>> 3);
+            const large = rotr(end, 17) ^ rotr(end, 19) ^ (end >>> 10);
+            words[index] = ((words[index - 16] ?? 0) + small + (words[index - 7] ?? 0) + large) >>> 0;
+        }
+        let [a, b, c, d, e, f, g, h] = hash;
+        for (let index = 0; index < 64; index += 1) {
+            const sum1 = rotr(e ?? 0, 6) ^ rotr(e ?? 0, 11) ^ rotr(e ?? 0, 25);
+            const choice = ((e ?? 0) & (f ?? 0)) ^ (~(e ?? 0) & (g ?? 0));
+            const temp1 = (((h ?? 0) + sum1 + choice + (SHA_K[index] ?? 0) + (words[index] ?? 0)) >>> 0);
+            const sum0 = rotr(a ?? 0, 2) ^ rotr(a ?? 0, 13) ^ rotr(a ?? 0, 22);
+            const majority = ((a ?? 0) & (b ?? 0)) ^ ((a ?? 0) & (c ?? 0)) ^ ((b ?? 0) & (c ?? 0));
+            const temp2 = (sum0 + majority) >>> 0;
+            h = g;
+            g = f;
+            f = e;
+            e = ((d ?? 0) + temp1) >>> 0;
+            d = c;
+            c = b;
+            b = a;
+            a = (temp1 + temp2) >>> 0;
+        }
+        hash[0] = ((hash[0] ?? 0) + (a ?? 0)) >>> 0;
+        hash[1] = ((hash[1] ?? 0) + (b ?? 0)) >>> 0;
+        hash[2] = ((hash[2] ?? 0) + (c ?? 0)) >>> 0;
+        hash[3] = ((hash[3] ?? 0) + (d ?? 0)) >>> 0;
+        hash[4] = ((hash[4] ?? 0) + (e ?? 0)) >>> 0;
+        hash[5] = ((hash[5] ?? 0) + (f ?? 0)) >>> 0;
+        hash[6] = ((hash[6] ?? 0) + (g ?? 0)) >>> 0;
+        hash[7] = ((hash[7] ?? 0) + (h ?? 0)) >>> 0;
+    }
+    return hash.map((word) => (word ?? 0).toString(16).padStart(8, "0")).join("");
+}
+export async function sha256Hex(text) {
+    const subtle = globalThis.crypto?.subtle;
+    if (subtle?.digest) {
+        try {
+            const digest = await subtle.digest("SHA-256", new TextEncoder().encode(text));
+            return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+        }
+        catch {
+            return sha256Fallback(text);
+        }
+    }
+    return sha256Fallback(text);
+}
+export function chunkWithoutChecksum(chunk) {
+    const copy = { ...chunk };
+    delete copy.checksum;
+    return copy;
+}
+export async function checksumChunk(chunk) {
+    return sha256Hex(stableJson(chunkWithoutChecksum(chunk)));
+}
+function boundsOk(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const box = value;
+    return ["x", "y", "width", "height"].every((key) => typeof box[key] === "number" && Number.isFinite(box[key]));
+}
+function unknownKeys(value, allowed) {
+    return Object.keys(value).filter((key) => !allowed.has(key));
+}
+export function validateNode(node) {
+    const issues = [];
+    const extra = unknownKeys(node, NODE_KEYS);
+    if (extra.length)
+        issues.push(`unknown node fields: ${extra.join(",")}`);
+    if (!node.id)
+        issues.push("node id required");
+    if (node.parentId !== null && typeof node.parentId !== "string")
+        issues.push("parentId must be string or null");
+    if (!NODE_TYPES.includes(node.type))
+        issues.push(`unknown node type ${node.type}`);
+    if (!boundsOk(node.bounds))
+        issues.push("bounds invalid");
+    if (node.text && node.text.length > MAX_TEXT)
+        issues.push("text too long");
+    return issues;
+}
+const RECORD_TYPES = new Set(["snapshot", "patch", "interaction", "lifecycle", "viewport", "privacy_boundary"]);
+const LIFECYCLE_KINDS = new Set(["background", "foreground", "account_changed", "gap"]);
+function validateRecord(record, index) {
+    const issues = [];
+    const type = record.type;
+    if (typeof type !== "string" || !RECORD_TYPES.has(type)) {
+        issues.push(`record ${index} unknown type ${String(type)}`);
+        return issues;
+    }
+    if (!Number.isInteger(record.seq) || record.seq < 0)
+        issues.push(`record ${index} seq`);
+    if (!Number.isFinite(record.offsetMs) || record.offsetMs < 0)
+        issues.push(`record ${index} offset`);
+    if (record.type === "snapshot" || record.type === "patch") {
+        const nodes = record.type === "snapshot" ? record.nodes : record.upserts;
+        if (!Array.isArray(nodes) || nodes.length > MAX_NODES)
+            issues.push("too many nodes");
+        else
+            for (const node of nodes)
+                issues.push(...validateNode(node));
+    }
+    if (record.type === "interaction" && record.kind !== "tap" && record.kind !== "scroll")
+        issues.push("interaction kind");
+    if (record.type === "lifecycle" && !LIFECYCLE_KINDS.has(record.kind))
+        issues.push("lifecycle kind");
+    if (record.type === "privacy_boundary" && typeof record.blocked !== "boolean")
+        issues.push("privacy blocked");
+    return issues;
+}
+export function validateChunk(chunk) {
+    const issues = [];
+    if (chunk.protocolVersion > PROTOCOL_VERSION)
+        issues.push("unsupported protocol version");
+    if (!chunk.protocolVersion || chunk.protocolVersion < 1)
+        issues.push("protocol version required");
+    if (!chunk.replayId || !chunk.segmentId || !chunk.chunkId || !chunk.sessionId)
+        issues.push("identity required");
+    if (!Number.isInteger(chunk.chunkSequence) || chunk.chunkSequence < 0)
+        issues.push("chunk sequence");
+    if (chunk.endOffsetMs < chunk.startOffsetMs)
+        issues.push("offset range");
+    if (!chunk.viewport || chunk.viewport.width <= 0 || chunk.viewport.height <= 0)
+        issues.push("viewport");
+    if (!Array.isArray(chunk.records) || chunk.records.length > MAX_RECORDS)
+        issues.push("records");
+    chunk.records.forEach((record, index) => issues.push(...validateRecord(record, index)));
+    const hasKeyframe = chunk.records.some((record) => record.type === "snapshot");
+    if (!hasKeyframe)
+        issues.push("chunk requires a snapshot keyframe");
+    if (stableJson(chunk).length > MAX_CHUNK_BYTES)
+        issues.push("chunk too large");
+    return issues;
+}
+export async function encodeChunk(chunk) {
+    const issues = validateChunk(chunk);
+    if (issues.length)
+        throw Object.assign(new Error(issues[0] ?? "invalid chunk"), { issues });
+    const checksum = await checksumChunk(chunk);
+    return { ...chunk, checksum };
+}
+export async function decodeChunk(input) {
+    const chunk = input;
+    const issues = validateChunk(chunk);
+    if (issues.length)
+        throw Object.assign(new Error(issues[0] ?? "invalid chunk"), { issues, statusCode: 400 });
+    if (chunk.checksum) {
+        const expected = await checksumChunk(chunk);
+        if (expected !== chunk.checksum)
+            throw Object.assign(new Error("checksum_mismatch"), { statusCode: 400 });
+    }
+    return chunk;
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

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

package/dist/fixture.d.ts

@@ -0,0 +1,6 @@
+import type { ReplayChunk, ReplayNode } from "./types.js";
+export declare function homeNodes(): ReplayNode[];
+export declare function pickTicketNodes(): ReplayNode[];
+export declare function checkoutNodes(): ReplayNode[];
+export declare function sampleRecording(): ReplayChunk[];
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS1D,wBAAgB,SAAS,IAAI,UAAU,EAAE,CAwBxC;AAED,wBAAgB,eAAe,IAAI,UAAU,EAAE,CAM9C;AAED,wBAAgB,aAAa,IAAI,UAAU,EAAE,CAc5C;AAED,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAuC/C"}

package/dist/fixture.js

@@ -0,0 +1,93 @@
+import { PROTOCOL_VERSION } from "./types.js";
+const viewport = { width: 390, height: 844, pixelRatio: 2 };
+function node(partial) {
+    return partial;
+}
+export function homeNodes() {
+    return [
+        node({ id: "root", parentId: null, type: "view", bounds: { x: 0, y: 0, width: 390, height: 844 }, style: { backgroundColor: "#ffffff" } }),
+        node({
+            id: "banner",
+            parentId: "root",
+            type: "view",
+            componentId: "home.jackpot_banner",
+            contentId: "jackpot-1",
+            contentVersion: "1",
+            bounds: { x: 16, y: 120, width: 358, height: 140 },
+            style: { backgroundColor: "#e8eefc", borderRadius: 16 },
+        }),
+        node({ id: "banner-title", parentId: "banner", type: "text", bounds: { x: 16, y: 24, width: 300, height: 32 }, text: "Jackpot 12 tỷ" }),
+        node({
+            id: "buy",
+            parentId: "root",
+            type: "button",
+            componentId: "home.buy_ticket",
+            bounds: { x: 16, y: 290, width: 180, height: 48 },
+            text: "Chọn vé",
+            style: { backgroundColor: "#1d4ed8", color: "#ffffff", borderRadius: 12 },
+        }),
+    ];
+}
+export function pickTicketNodes() {
+    return [
+        node({ id: "root", parentId: null, type: "view", bounds: { x: 0, y: 0, width: 390, height: 844 }, style: { backgroundColor: "#ffffff" } }),
+        node({ id: "list", parentId: "root", type: "scroll", bounds: { x: 0, y: 80, width: 390, height: 700 } }),
+        node({ id: "row", parentId: "list", type: "button", componentId: "ticket.row", contentId: "mega-01", bounds: { x: 16, y: 8, width: 358, height: 64 }, text: "Mega 6/45" }),
+    ];
+}
+export function checkoutNodes() {
+    return [
+        node({ id: "root", parentId: null, type: "view", bounds: { x: 0, y: 0, width: 390, height: 844 }, style: { backgroundColor: "#ffffff" } }),
+        node({ id: "title", parentId: "root", type: "text", bounds: { x: 16, y: 80, width: 300, height: 32 }, text: "Thanh toán" }),
+        node({ id: "error", parentId: "root", type: "text", bounds: { x: 16, y: 140, width: 340, height: 28 }, text: "Không đủ số dư" }),
+        node({
+            id: "phone",
+            parentId: "root",
+            type: "input",
+            componentId: "checkout.otp",
+            bounds: { x: 16, y: 200, width: 240, height: 44 },
+            text: "123456",
+        }),
+    ];
+}
+export function sampleRecording() {
+    return [
+        {
+            protocolVersion: PROTOCOL_VERSION,
+            replayId: "replay-1",
+            segmentId: "segment-1",
+            chunkId: "chunk-1",
+            chunkSequence: 0,
+            sessionId: "session-1",
+            screenInstanceId: "home-1",
+            startOffsetMs: 0,
+            endOffsetMs: 1_200,
+            viewport,
+            records: [
+                { type: "snapshot", seq: 1, offsetMs: 0, nodes: homeNodes() },
+                { type: "interaction", seq: 2, offsetMs: 400, kind: "scroll", targetId: "root", scrollX: 0, scrollY: 80 },
+                { type: "interaction", seq: 3, offsetMs: 900, kind: "tap", targetId: "buy", actionId: "act-buy", x: 40, y: 20 },
+            ],
+        },
+        {
+            protocolVersion: PROTOCOL_VERSION,
+            replayId: "replay-1",
+            segmentId: "segment-1",
+            chunkId: "chunk-3",
+            chunkSequence: 2,
+            sessionId: "session-1",
+            screenInstanceId: "checkout-1",
+            startOffsetMs: 12_000,
+            endOffsetMs: 13_000,
+            viewport,
+            records: [
+                { type: "lifecycle", seq: 1, offsetMs: 12_000, kind: "gap" },
+                { type: "snapshot", seq: 2, offsetMs: 12_000, nodes: checkoutNodes() },
+                { type: "patch", seq: 3, offsetMs: 12_400, upserts: [{ id: "error", parentId: "root", type: "text", bounds: { x: 16, y: 140, width: 340, height: 28 }, text: "Đã thanh toán" }], removedIds: [] },
+                { type: "privacy_boundary", seq: 4, offsetMs: 12_600, blocked: true, reason: "otp" },
+                { type: "lifecycle", seq: 5, offsetMs: 12_800, kind: "background" },
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { MAX_CHUNK_BYTES, MAX_NODES, MAX_RECORDS, MAX_TEXT, NODE_TYPES, PROTOCOL_VERSION, } from "./types.js";
+export type { InteractionRecord, LifecycleRecord, PatchRecord, PrivacyBoundaryRecord, ReplayBounds, ReplayChunk, ReplayNode, ReplayNodeType, ReplayRecord, ReplayViewport, SnapshotRecord, ViewportRecord, } from "./types.js";
+export { checksumChunk, decodeChunk, encodeChunk, sha256Fallback, stableJson, validateChunk, validateNode } from "./codec.js";
+export { maskNode, maskText, shouldMask } from "./mask.js";
+export { applyRecords, emptyScene, placeNodes, recordsUntil, sceneNodes, type PlacedNode, type Scene } from "./scene.js";
+export { checkoutNodes, homeNodes, pickTicketNodes, sampleRecording } from "./fixture.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9H,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACzH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { MAX_CHUNK_BYTES, MAX_NODES, MAX_RECORDS, MAX_TEXT, NODE_TYPES, PROTOCOL_VERSION, } from "./types.js";
+export { checksumChunk, decodeChunk, encodeChunk, sha256Fallback, stableJson, validateChunk, validateNode } from "./codec.js";
+export { maskNode, maskText, shouldMask } from "./mask.js";
+export { applyRecords, emptyScene, placeNodes, recordsUntil, sceneNodes } from "./scene.js";
+export { checkoutNodes, homeNodes, pickTicketNodes, sampleRecording } from "./fixture.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAepB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9H,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAA+B,MAAM,YAAY,CAAC;AACzH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/mask.d.ts

@@ -0,0 +1,12 @@
+import type { ReplayNode, ReplayNodeType } from "./types.js";
+export declare function shouldMask(type: ReplayNodeType, hints?: {
+    secure?: boolean;
+    analyticsMask?: boolean;
+    componentId?: string;
+}): boolean;
+export declare function maskText(text: string | undefined, masked: boolean): string | undefined;
+export declare function maskNode(node: ReplayNode, hints?: {
+    secure?: boolean;
+    analyticsMask?: boolean;
+}): ReplayNode;
+//# sourceMappingURL=mask.d.ts.map

package/dist/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../src/mask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAIzI;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAGhH"}

package/dist/mask.js

@@ -0,0 +1,18 @@
+const SENSITIVE = /otp|password|passwd|pin|cvv|token|bank|card|cccd|secret/i;
+export function shouldMask(type, hints = {}) {
+    if (hints.secure || hints.analyticsMask)
+        return true;
+    if (type === "input")
+        return true;
+    return SENSITIVE.test(hints.componentId ?? "");
+}
+export function maskText(text, masked) {
+    if (!text)
+        return text;
+    return masked ? "••••" : text;
+}
+export function maskNode(node, hints = {}) {
+    const masked = Boolean(node.masked) || shouldMask(node.type, { ...hints, componentId: node.componentId });
+    return { ...node, masked, text: maskText(node.text, masked) };
+}
+//# sourceMappingURL=mask.js.map

package/dist/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../src/mask.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,0DAA0D,CAAC;AAE7E,MAAM,UAAU,UAAU,CAAC,IAAoB,EAAE,QAA6E,EAAE;IAC9H,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAwB,EAAE,MAAe;IAChE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAgB,EAAE,QAAuD,EAAE;IAClG,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1G,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/scene.d.ts

@@ -0,0 +1,23 @@
+import type { InteractionRecord, ReplayNode, ReplayRecord } from "./types.js";
+export interface Scene {
+    nodes: Map<string, ReplayNode>;
+    order: string[];
+    blocked: boolean;
+    gap: boolean;
+    scroll: {
+        targetId: string;
+        x: number;
+        y: number;
+    } | null;
+    taps: InteractionRecord[];
+}
+export declare function emptyScene(): Scene;
+export declare function applyRecords(scene: Scene, records: ReplayRecord[]): Scene;
+export declare function sceneNodes(scene: Scene): ReplayNode[];
+export interface PlacedNode extends ReplayNode {
+    absX: number;
+    absY: number;
+}
+export declare function placeNodes(nodes: ReplayNode[]): PlacedNode[];
+export declare function recordsUntil(records: ReplayRecord[], offsetMs: number): ReplayRecord[];
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED,wBAAgB,UAAU,IAAI,KAAK,CAElC;AAOD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,CAoCzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE,CAKrD;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAa5D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAEtF"}

package/dist/scene.js

@@ -0,0 +1,78 @@
+export function emptyScene() {
+    return { nodes: new Map(), order: [], blocked: false, gap: false, scroll: null, taps: [] };
+}
+function remember(scene, node) {
+    if (!scene.nodes.has(node.id))
+        scene.order.push(node.id);
+    scene.nodes.set(node.id, node);
+}
+export function applyRecords(scene, records) {
+    const ordered = [...records].sort((left, right) => left.seq - right.seq || left.offsetMs - right.offsetMs);
+    for (const record of ordered) {
+        if (record.type === "lifecycle" && record.kind === "gap") {
+            scene.nodes.clear();
+            scene.order = [];
+            scene.gap = true;
+            continue;
+        }
+        if (record.type === "privacy_boundary") {
+            scene.blocked = record.blocked;
+            if (record.blocked) {
+                for (const [id, node] of scene.nodes)
+                    scene.nodes.set(id, { ...node, text: node.type === "input" || node.masked ? "••••" : node.text, masked: node.masked });
+            }
+            continue;
+        }
+        if (scene.blocked && (record.type === "interaction" || record.type === "patch" || record.type === "snapshot")) {
+            if (record.type !== "snapshot")
+                continue;
+        }
+        if (record.type === "snapshot") {
+            scene.nodes.clear();
+            scene.order = [];
+            scene.gap = false;
+            for (const node of record.nodes)
+                remember(scene, node);
+        }
+        else if (record.type === "patch") {
+            for (const id of record.removedIds) {
+                scene.nodes.delete(id);
+                scene.order = scene.order.filter((item) => item !== id);
+            }
+            for (const node of record.upserts)
+                remember(scene, node);
+        }
+        else if (record.type === "interaction") {
+            if (record.kind === "scroll")
+                scene.scroll = { targetId: record.targetId, x: record.scrollX ?? 0, y: record.scrollY ?? 0 };
+            if (record.kind === "tap")
+                scene.taps = [...scene.taps, record];
+        }
+    }
+    return scene;
+}
+export function sceneNodes(scene) {
+    return scene.order.flatMap((id) => {
+        const node = scene.nodes.get(id);
+        return node ? [node] : [];
+    });
+}
+export function placeNodes(nodes) {
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    const placed = new Map();
+    const visit = (node) => {
+        const cached = placed.get(node.id);
+        if (cached)
+            return cached;
+        const parent = node.parentId ? byId.get(node.parentId) : undefined;
+        const origin = parent ? visit(parent) : { absX: 0, absY: 0 };
+        const next = { ...node, absX: origin.absX + node.bounds.x, absY: origin.absY + node.bounds.y };
+        placed.set(node.id, next);
+        return next;
+    };
+    return nodes.map(visit);
+}
+export function recordsUntil(records, offsetMs) {
+    return records.filter((record) => record.offsetMs <= offsetMs).sort((left, right) => left.seq - right.seq);
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+export declare const PROTOCOL_VERSION = 1;
+export declare const NODE_TYPES: readonly ["view", "text", "button", "input", "image", "scroll", "modal", "placeholder"];
+export type ReplayNodeType = (typeof NODE_TYPES)[number];
+export interface ReplayBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ReplayNode {
+    id: string;
+    parentId: string | null;
+    type: ReplayNodeType;
+    bounds: ReplayBounds;
+    zIndex?: number;
+    clipsChildren?: boolean;
+    text?: string;
+    assetId?: string;
+    state?: {
+        selected?: boolean;
+        disabled?: boolean;
+        loading?: boolean;
+    };
+    style?: {
+        backgroundColor?: string;
+        color?: string;
+        fontSize?: number;
+        borderRadius?: number;
+    };
+    componentId?: string;
+    contentId?: string;
+    contentVersion?: string;
+    masked?: boolean;
+}
+export interface SnapshotRecord {
+    type: "snapshot";
+    seq: number;
+    offsetMs: number;
+    nodes: ReplayNode[];
+}
+export interface PatchRecord {
+    type: "patch";
+    seq: number;
+    offsetMs: number;
+    upserts: ReplayNode[];
+    removedIds: string[];
+}
+export interface InteractionRecord {
+    type: "interaction";
+    seq: number;
+    offsetMs: number;
+    kind: "tap" | "scroll";
+    targetId: string;
+    actionId?: string;
+    x?: number;
+    y?: number;
+    scrollX?: number;
+    scrollY?: number;
+}
+export interface LifecycleRecord {
+    type: "lifecycle";
+    seq: number;
+    offsetMs: number;
+    kind: "background" | "foreground" | "account_changed" | "gap";
+}
+export interface ViewportRecord {
+    type: "viewport";
+    seq: number;
+    offsetMs: number;
+    width: number;
+    height: number;
+    pixelRatio: number;
+}
+export interface PrivacyBoundaryRecord {
+    type: "privacy_boundary";
+    seq: number;
+    offsetMs: number;
+    blocked: boolean;
+    reason?: string;
+}
+export type ReplayRecord = SnapshotRecord | PatchRecord | InteractionRecord | LifecycleRecord | ViewportRecord | PrivacyBoundaryRecord;
+export interface ReplayViewport {
+    width: number;
+    height: number;
+    pixelRatio: number;
+}
+export interface ReplayChunk {
+    protocolVersion: number;
+    replayId: string;
+    segmentId: string;
+    chunkId: string;
+    chunkSequence: number;
+    sessionId: string;
+    screenInstanceId?: string;
+    startOffsetMs: number;
+    endOffsetMs: number;
+    viewport: ReplayViewport;
+    records: ReplayRecord[];
+    checksum?: string;
+}
+export declare const MAX_NODES = 400;
+export declare const MAX_RECORDS = 800;
+export declare const MAX_TEXT = 240;
+export declare const MAX_CHUNK_BYTES: number;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+export const PROTOCOL_VERSION = 1;
+export const NODE_TYPES = ["view", "text", "button", "input", "image", "scroll", "modal", "placeholder"];
+export const MAX_NODES = 400;
+export const MAX_RECORDS = 800;
+export const MAX_TEXT = 240;
+export const MAX_CHUNK_BYTES = 256 * 1024;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAU,CAAC;AAqHlH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@mikeci/pos-replay-protocol",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Shared session replay protocol: nodes, records, chunks, checksums.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  }
 }