Files
triggerdotdev--trigger.dev/apps/webapp/test/sanitizeRowsOnParseError.test.ts
T
2026-07-13 13:32:57 +08:00

297 lines
11 KiB
TypeScript

import { describe, it, expect } from "vitest";
import {
INVALID_UTF16_SENTINEL,
isClickHouseJsonParseError,
parseRowNumberFromError,
sanitizeRows,
sanitizeUnknownInPlace,
} from "~/v3/eventRepository/sanitizeRowsOnParseError.server";
const HIGH_SURROGATE = "\uD800";
const LOW_SURROGATE = "\uDC00";
describe("isClickHouseJsonParseError", () => {
it("recognises ClickHouse's parse-error string", () => {
const err = new Error(
"Cannot parse JSON object here: {...}: (while reading the value of key attributes): (at row 15)\n: While executing ParallelParsingBlockInputFormat. "
);
expect(isClickHouseJsonParseError(err)).toBe(true);
});
it("returns false for unrelated errors", () => {
expect(isClickHouseJsonParseError(new Error("Connection refused"))).toBe(false);
expect(
isClickHouseJsonParseError(
new Error("Size of JSON object at position 999 is extremely large.")
)
).toBe(false);
});
it("returns false for null / undefined / strings", () => {
expect(isClickHouseJsonParseError(null)).toBe(false);
expect(isClickHouseJsonParseError(undefined)).toBe(false);
expect(isClickHouseJsonParseError("Cannot parse JSON object")).toBe(true);
});
});
describe("parseRowNumberFromError", () => {
it("extracts the row index from a typical ClickHouse error message", () => {
expect(
parseRowNumberFromError(
"Cannot parse JSON object here: { ... }: (while reading the value of key attributes): (at row 1942)\n: While executing ParallelParsingBlockInputFormat."
)
).toBe(1942);
});
it("returns null when no row index is present", () => {
expect(parseRowNumberFromError("Some other error without a row hint")).toBeNull();
});
it("returns the first match when multiple `at row N` substrings exist", () => {
expect(parseRowNumberFromError("at row 1, oops also at row 2")).toBe(1);
});
});
describe("sanitizeUnknownInPlace", () => {
it("returns the string unchanged when it has no surrogates", () => {
const result = sanitizeUnknownInPlace("hello world");
expect(result).toEqual({ value: "hello world", fixed: 0 });
});
it("replaces a lone-surrogate string with the sentinel", () => {
const result = sanitizeUnknownInPlace(`prefix ${HIGH_SURROGATE} suffix`);
expect(result.value).toBe(INVALID_UTF16_SENTINEL);
expect(result.fixed).toBe(1);
});
it("leaves valid surrogate pairs (emoji) intact", () => {
const result = sanitizeUnknownInPlace("hello 😀 world");
expect(result.value).toBe("hello 😀 world");
expect(result.fixed).toBe(0);
});
it("walks nested objects and mutates string leaves in place", () => {
const row = {
id: "row-1",
attributes: {
ai: {
prompt: { messages: `bad ${HIGH_SURROGATE} string` },
usage: { input_tokens: 42 },
},
clean: "untouched",
},
};
const result = sanitizeUnknownInPlace(row);
expect(result.fixed).toBe(1);
expect((row.attributes.ai.prompt as any).messages).toBe(INVALID_UTF16_SENTINEL);
expect(row.attributes.clean).toBe("untouched");
expect((row.attributes.ai.usage as any).input_tokens).toBe(42);
expect(row.id).toBe("row-1");
});
it("walks arrays recursively", () => {
const value = [
"ok",
`bad ${LOW_SURROGATE} value`,
"also ok",
{ nested: `also bad ${HIGH_SURROGATE}` },
];
const result = sanitizeUnknownInPlace(value);
expect(result.fixed).toBe(2);
expect(value[1]).toBe(INVALID_UTF16_SENTINEL);
expect((value[3] as any).nested).toBe(INVALID_UTF16_SENTINEL);
expect(value[0]).toBe("ok");
expect(value[2]).toBe("also ok");
});
it("leaves non-string primitives untouched", () => {
expect(sanitizeUnknownInPlace(42)).toEqual({ value: 42, fixed: 0 });
expect(sanitizeUnknownInPlace(true)).toEqual({ value: true, fixed: 0 });
expect(sanitizeUnknownInPlace(null)).toEqual({ value: null, fixed: 0 });
expect(sanitizeUnknownInPlace(undefined)).toEqual({ value: undefined, fixed: 0 });
});
// ─── Out-of-range integers (TRI-9755) ──────────────────────────────────────
// ClickHouse's JSON(max_dynamic_paths) column rejects bare integer tokens
// outside [Int64.MIN, UInt64.MAX]. Such Numbers serialise as bare integer
// form via JSON.stringify (no exponent, since |value| < 1e21) so they reach
// ClickHouse as unquoted oversized ints. Sanitizer replaces them with the
// string form, which ClickHouse's dynamic JSON column accepts as a String
// subtype on that path.
it("replaces an integer-valued Number above UInt64.MAX with its string form", () => {
// 117039831458782870000 is the actual prod value (Google Plus ID after
// upstream JS-Number precision loss from 117039831458782873093).
const result = sanitizeUnknownInPlace(117039831458782870000);
expect(result.value).toBe("117039831458782870000");
expect(result.fixed).toBe(1);
});
it("catches the float64 boundary at exactly 2**64 (UInt64.MAX + 1)", () => {
// float64 cannot represent UInt64.MAX (2^64 - 1) exactly — the literal
// 18446744073709551615 in JS source rounds to 2^64. JSON.stringify
// emits this Number as "18446744073709552000", which exceeds UInt64.MAX
// and trips ClickHouse. Regression for the BigInt-based comparison;
// a naïve `value > 18446744073709551615` would let this pass.
const result = sanitizeUnknownInPlace(2 ** 64);
expect(result.value).toBe("18446744073709552000");
expect(result.fixed).toBe(1);
});
it("replaces an integer-valued Number below Int64.MIN with its string form", () => {
// -9223372036854775809 is the first failing negative; in float64 it
// rounds to the same representation as Int64.MIN (-9223372036854775808),
// but for completeness we check a clearly-out-of-range negative.
const result = sanitizeUnknownInPlace(-1e20);
expect(result.value).toBe("-100000000000000000000");
expect(result.fixed).toBe(1);
});
it("leaves safe integers and boundary values untouched", () => {
// 42 — safe integer
expect(sanitizeUnknownInPlace(42)).toEqual({ value: 42, fixed: 0 });
// Number.MAX_SAFE_INTEGER (2^53 - 1) — JSON.stringify still emits as integer
expect(sanitizeUnknownInPlace(Number.MAX_SAFE_INTEGER)).toEqual({
value: Number.MAX_SAFE_INTEGER,
fixed: 0,
});
// 2^63 (Int64.MAX + 1) — still fits in UInt64, CH accepts it
expect(sanitizeUnknownInPlace(2 ** 63)).toEqual({ value: 2 ** 63, fixed: 0 });
});
it("leaves non-integer numbers untouched (floats, NaN, Infinity)", () => {
// Numbers with a fractional part — emitted with `.` in JSON
expect(sanitizeUnknownInPlace(3.14)).toEqual({ value: 3.14, fixed: 0 });
// Very large float-form (>= 1e21) — JSON.stringify uses exponent form,
// CH parses as Float64 successfully
expect(sanitizeUnknownInPlace(1e25)).toEqual({ value: 1e25, fixed: 0 });
// NaN / Infinity — JSON.stringify emits `null`, so harmless on the wire
expect(sanitizeUnknownInPlace(Number.NaN)).toEqual({ value: Number.NaN, fixed: 0 });
expect(sanitizeUnknownInPlace(Number.POSITIVE_INFINITY)).toEqual({
value: Number.POSITIVE_INFINITY,
fixed: 0,
});
});
it("finds an oversized integer nested deep inside the actual scan-social-profiles shape", () => {
const row = {
output: {
data: {
profiles: [
{ module: "linktree", query: "x@example.com" },
{
module: "poshmark",
spec_format: [
{
platform_variables: [
{
key: "gp_id",
proper_key: "Gp Id",
// The actual prod value — bare JSON integer > UInt64.MAX
value: 117039831458782870000,
type: "int",
},
],
},
],
},
],
},
},
};
const result = sanitizeUnknownInPlace(row);
expect(result.fixed).toBe(1);
expect((row.output.data.profiles[1].spec_format![0].platform_variables[0] as any).value).toBe(
"117039831458782870000"
);
// Untouched neighbours
expect(row.output.data.profiles[0].module).toBe("linktree");
expect(row.output.data.profiles[1].spec_format![0].platform_variables[0].type).toBe("int");
});
});
describe("sanitizeRows", () => {
function makeRow(suffix: string, badField?: string) {
return {
id: `row-${suffix}`,
attributes: { foo: badField ?? "clean" },
};
}
it("sanitizes every row that has bad strings", () => {
const rows = [
makeRow("0", `bad-0-${HIGH_SURROGATE}`),
makeRow("1", `bad-1-${HIGH_SURROGATE}`),
makeRow("2", "clean"),
makeRow("3", `bad-3-${HIGH_SURROGATE}`),
];
const result = sanitizeRows(rows);
expect(rows[0].attributes.foo).toBe(INVALID_UTF16_SENTINEL);
expect(rows[1].attributes.foo).toBe(INVALID_UTF16_SENTINEL);
expect(rows[2].attributes.foo).toBe("clean");
expect(rows[3].attributes.foo).toBe(INVALID_UTF16_SENTINEL);
expect(result.rowsTouched).toBe(3);
expect(result.fieldsSanitized).toBe(3);
});
it("returns zero counts when no row has bad strings", () => {
const rows = [makeRow("0"), makeRow("1"), makeRow("2")];
const result = sanitizeRows(rows);
expect(result).toEqual({ rowsTouched: 0, fieldsSanitized: 0 });
});
it("returns zero counts for an empty batch", () => {
expect(sanitizeRows([])).toEqual({ rowsTouched: 0, fieldsSanitized: 0 });
});
it("counts multiple sanitized fields on the same row as one rowTouched but multiple fields", () => {
const rows = [
{
id: "r0",
attributes: {
a: `bad ${HIGH_SURROGATE}`,
b: `also bad ${LOW_SURROGATE}`,
c: "fine",
},
},
];
const result = sanitizeRows(rows);
expect(result.rowsTouched).toBe(1);
expect(result.fieldsSanitized).toBe(2);
});
it("counts surrogate fixes and out-of-range integer fixes together (TRI-9755)", () => {
const rows = [
{
id: "r0",
attributes: {
surrogate: `bad ${HIGH_SURROGATE}`,
bigint: 117039831458782870000,
clean: "fine",
safe: 42,
},
},
{
id: "r1",
attributes: {
bigint: -1e20,
clean: "still fine",
},
},
{
id: "r2",
attributes: { clean: "no fixes needed" },
},
];
const result = sanitizeRows(rows);
expect(result.rowsTouched).toBe(2);
expect(result.fieldsSanitized).toBe(3);
expect(rows[0].attributes.surrogate).toBe(INVALID_UTF16_SENTINEL);
expect(rows[0].attributes.bigint).toBe("117039831458782870000");
expect(rows[0].attributes.safe).toBe(42);
expect(rows[1].attributes.bigint).toBe("-100000000000000000000");
});
});