mirror of
https://github.com/morluto/rea
synced 2026-10-26 06:16:17 -04:00
morluto
10b83a9b62
Return typed fetch outcomes with completed map coverage when acquisition is cancelled or a response resource fails. Compose those facts with the captured inspection as partial bundle Evidence, preserving exclusions, exact abort causes, and cleanup priority without claiming unperformed script analysis. Keep complete response-body SHA-256 and byte counts when map interpretation fails, while preserving compact failure rows and capacity for later valid maps. Reuse the read owner digest for successful text artifacts and preflight their JSON representation before parsing. Historical failed rows remain importable. Exercise controlled HTTP/stream boundaries, CLI SIGINT, and SDK cancellation with later MCP Evidence retrieval. Share the public cancellation fixture and use one Result API across consumers. Real Chromium and Windows CLI cancellation were not verified.
450 lines
11 KiB
TypeScript
450 lines
11 KiB
TypeScript
import { createHash } from "node:crypto";
|
|
import { expect, it } from "vitest";
|
|
import { fetchWebSourceMapsOk } from "../../fixtures/fetchWebSourceMapsOk.js";
|
|
import { analyzeWebBundleInputSchema } from "../../../src/domain/webBundleAnalysis.js";
|
|
import { traceSourceMap } from "../../../src/javascript/sourceMaps/TraceSourceMap.js";
|
|
|
|
const cases = [
|
|
{
|
|
name: "later nested line resets outer column",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 5,
|
|
column: 10,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 1,
|
|
column: 0,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [[7, 0, "a.ts"]],
|
|
dedicatedControl: true,
|
|
},
|
|
{
|
|
name: "same line retains summed columns",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 5,
|
|
column: 10,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 3,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [[6, 13, "a.ts"]],
|
|
dedicatedControl: true,
|
|
},
|
|
{
|
|
name: "ordinary leaf unchanged",
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA;AACA",
|
|
},
|
|
expected: [
|
|
[1, 0, "a.ts"],
|
|
[2, 0, "a.ts"],
|
|
],
|
|
dedicatedControl: true,
|
|
},
|
|
{
|
|
name: "same-line sibling clipping",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 0,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA,QAAQ,IAAI",
|
|
},
|
|
},
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 10,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["b.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [
|
|
[1, 0, "a.ts"],
|
|
[1, 8, "a.ts"],
|
|
[1, 10, "b.ts"],
|
|
],
|
|
dedicatedControl: false,
|
|
expectedStatus: "invalid",
|
|
},
|
|
{
|
|
name: "nested gap clips previous parent leaf",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 0,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA,QAAQ,IAAI",
|
|
},
|
|
},
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 5,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 3,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["b.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [
|
|
[1, 0, "a.ts"],
|
|
[1, 8, "b.ts"],
|
|
],
|
|
dedicatedControl: false,
|
|
expectedStatus: "invalid",
|
|
},
|
|
{
|
|
name: "empty indexed sibling clips previous leaf",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 0,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA,QAAQ,IAAI",
|
|
},
|
|
},
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 5,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [],
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [[1, 0, "a.ts"]],
|
|
dedicatedControl: false,
|
|
expectedStatus: "invalid",
|
|
},
|
|
{
|
|
name: "depth-three same-line composition",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 2,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 3,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 4,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
},
|
|
],
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [[1, 9, "a.ts"]],
|
|
dedicatedControl: true,
|
|
},
|
|
{
|
|
name: "multiline inherited sibling stop",
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 0,
|
|
column: 0,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: {
|
|
line: 1,
|
|
column: 3,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA;AACA;AACA;AACA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
},
|
|
{
|
|
offset: {
|
|
line: 3,
|
|
column: 1,
|
|
},
|
|
map: {
|
|
version: 3,
|
|
sources: ["b.ts"],
|
|
sourcesContent: ["export const value=1;"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
},
|
|
expected: [
|
|
[2, 3, "a.ts"],
|
|
[3, 0, "a.ts"],
|
|
[4, 0, "a.ts"],
|
|
[4, 1, "b.ts"],
|
|
],
|
|
dedicatedControl: false,
|
|
expectedStatus: "invalid",
|
|
},
|
|
] as const;
|
|
|
|
it.each(cases)(
|
|
"preserves indexed coordinate contract: $name",
|
|
async (testCase) => {
|
|
const { map, expected, dedicatedControl } = testCase;
|
|
const expectedStatus =
|
|
"expectedStatus" in testCase ? testCase.expectedStatus : "included";
|
|
const origin = "https://example.test";
|
|
const url = origin + "/app.js.map";
|
|
const text = JSON.stringify(map);
|
|
// The dedicated decoder already normalizes absolute leaves. Its stricter
|
|
// overlap profile is compared only for the valid non-overlapping maps.
|
|
if (dedicatedControl) {
|
|
for (const [line, column] of expected) {
|
|
const point = traceSourceMap(text, url, { line, column });
|
|
expect(point.lookup.matched_generated_position).toEqual({
|
|
line,
|
|
column,
|
|
});
|
|
expect(point.matches).toHaveLength(1);
|
|
}
|
|
}
|
|
const result = await fetchWebSourceMapsOk(
|
|
[{ scriptKey: "scr_" + "1".repeat(64), declaredUrl: url, fetchUrl: url }],
|
|
analyzeWebBundleInputSchema.parse({
|
|
cdp_endpoint: "http://127.0.0.1:9222",
|
|
allowed_origins: [origin],
|
|
target_id: "page-1",
|
|
fetch_source_maps: true,
|
|
}),
|
|
undefined,
|
|
{ fetch: () => Promise.resolve(new Response(text, { status: 200 })) },
|
|
);
|
|
const item = result.items[0];
|
|
if (expectedStatus === "invalid") {
|
|
expect(item).toMatchObject({
|
|
status: "invalid",
|
|
artifact: null,
|
|
mappings: [],
|
|
limitation: expect.stringContaining("overlap"),
|
|
});
|
|
return;
|
|
}
|
|
if (item?.status !== "included") throw new Error(JSON.stringify(result));
|
|
expect(
|
|
item.mappings.map((entry) => [
|
|
entry.generated_line,
|
|
entry.generated_column,
|
|
entry.source?.replace(origin + "/", "") ?? null,
|
|
]),
|
|
).toEqual(expected);
|
|
expect(item.artifact.sha256).toBe(
|
|
createHash("sha256").update(text).digest("hex"),
|
|
);
|
|
expect(item.artifact.bytes).toBe(Buffer.byteLength(text));
|
|
// Boundary-only markers must not introduce empty original-source identities.
|
|
expect(item.original_sources.map(({ source }) => source)).toEqual([
|
|
...new Set(expected.map(([, , source]) => origin + "/" + source)),
|
|
]);
|
|
},
|
|
);
|
|
|
|
it("rejects a source mapping that crosses an indexed section boundary", async () => {
|
|
const origin = "https://example.test";
|
|
const url = `${origin}/app.js.map`;
|
|
const makeMap = (firstMappings: string) => ({
|
|
version: 3,
|
|
sections: [
|
|
{
|
|
offset: { line: 0, column: 0 },
|
|
map: {
|
|
version: 3,
|
|
sources: ["a.js"],
|
|
sourcesContent: ["x();"],
|
|
names: [],
|
|
mappings: firstMappings,
|
|
},
|
|
},
|
|
{
|
|
offset: { line: 0, column: 1 },
|
|
map: {
|
|
version: 3,
|
|
sources: ["b.js"],
|
|
sourcesContent: ["y();"],
|
|
names: [],
|
|
mappings: "AAAA",
|
|
},
|
|
},
|
|
],
|
|
});
|
|
const input = analyzeWebBundleInputSchema.parse({
|
|
cdp_endpoint: "http://127.0.0.1:9222",
|
|
allowed_origins: [origin],
|
|
target_id: "page-1",
|
|
fetch_source_maps: true,
|
|
});
|
|
const request = {
|
|
scriptKey: "scr_" + "1".repeat(64),
|
|
declaredUrl: url,
|
|
fetchUrl: url,
|
|
};
|
|
const fetchMap = (map: ReturnType<typeof makeMap>) =>
|
|
fetchWebSourceMapsOk([request], input, undefined, {
|
|
fetch: () =>
|
|
Promise.resolve(new Response(JSON.stringify(map), { status: 200 })),
|
|
});
|
|
const overlapping = makeMap("AAAA,EAAA");
|
|
const overlapText = JSON.stringify(overlapping);
|
|
expect(() =>
|
|
traceSourceMap(overlapText, url, { line: 1, column: 2 }),
|
|
).toThrow(/overlap/u);
|
|
const overlappingResult = await fetchMap(overlapping);
|
|
expect(overlappingResult).toMatchObject({
|
|
status: "unavailable",
|
|
requested: 1,
|
|
processed: 1,
|
|
});
|
|
expect(overlappingResult.items[0]).toMatchObject({
|
|
status: "invalid",
|
|
artifact: null,
|
|
mappings: [],
|
|
limitation: expect.stringContaining("overlap"),
|
|
});
|
|
|
|
const controlResult = await fetchMap(makeMap("AAAA"));
|
|
expect(controlResult.items[0]).toMatchObject({
|
|
status: "included",
|
|
limitation: null,
|
|
mappings: [
|
|
{ generated_line: 1, generated_column: 0, source: `${origin}/a.js` },
|
|
{ generated_line: 1, generated_column: 1, source: `${origin}/b.js` },
|
|
],
|
|
});
|
|
});
|