mirror of
https://github.com/morluto/rea.git
synced 2026-11-21 14:05:49 +00:00
* fix(source-map): share bounded structural inspection with local analysis Refs #12135 * fix(javascript): retain relative URL traversal and decline unusable map paths * fix(javascript): retain source content beyond coordinate admission
88 lines
3.0 KiB
TypeScript
88 lines
3.0 KiB
TypeScript
import { isRecord } from "../kernel/isRecord.js";
|
|
|
|
/** Artifact source declarations do not require generated-position decoding. */
|
|
type SourceMapRecord = Readonly<Record<string, unknown>>;
|
|
|
|
export interface ExternalSourceMapSection {
|
|
readonly section_path: readonly number[];
|
|
readonly url: string;
|
|
}
|
|
|
|
export interface InvalidSourceMapSection {
|
|
readonly section_path: readonly number[];
|
|
readonly reason: string;
|
|
}
|
|
|
|
export type SourceMapSection =
|
|
| { readonly kind: "embedded"; readonly map: SourceMapRecord }
|
|
| { readonly kind: "external"; readonly url: string }
|
|
| { readonly kind: "invalid"; readonly reason: string };
|
|
|
|
export type SourceMapSectionList =
|
|
| { readonly kind: "regular" }
|
|
| { readonly kind: "indexed"; readonly sections: readonly unknown[] }
|
|
| { readonly kind: "invalid"; readonly reason: string };
|
|
|
|
/**
|
|
* Return the JSON parsing view of retained source-map text. ECMA-426 permits
|
|
* HTTP responses to start with `)]}'`; the first line is transport framing.
|
|
* Keep the original text for artifact identity and Evidence provenance.
|
|
* https://tc39.es/ecma426/#sec-fetchsourcemap
|
|
*/
|
|
export const sourceMapJsonText = (text: string): string => {
|
|
const withoutBom = text.replace(/^\uFEFF/u, "");
|
|
if (!withoutBom.startsWith(")]}'")) return withoutBom;
|
|
const newline = withoutBom.search(/[\r\n]/u);
|
|
return newline === -1 ? "" : withoutBom.slice(newline);
|
|
};
|
|
|
|
/** Classify section ownership once; an external URL takes precedence over map. */
|
|
export const classifySourceMapSection = (
|
|
section: unknown,
|
|
): SourceMapSection => {
|
|
if (!isRecord(section))
|
|
return {
|
|
kind: "invalid",
|
|
reason: "Indexed source-map section must be an object.",
|
|
};
|
|
if (Object.prototype.hasOwnProperty.call(section, "url"))
|
|
return typeof section.url === "string"
|
|
? { kind: "external", url: section.url }
|
|
: {
|
|
kind: "invalid",
|
|
reason: "External source-map section URL must be a string.",
|
|
};
|
|
if (!isRecord(section.map))
|
|
return {
|
|
kind: "invalid",
|
|
reason:
|
|
"Indexed source-map section requires an embedded map or external URL.",
|
|
};
|
|
if (!isVersion3Map(section.map))
|
|
return {
|
|
kind: "invalid",
|
|
reason: "Indexed source-map section map is not a version 3 map.",
|
|
};
|
|
return { kind: "embedded", map: section.map };
|
|
};
|
|
|
|
/** A present `sections` member must be an array in every source-map consumer. */
|
|
export const classifySourceMapSections = (
|
|
map: unknown,
|
|
): SourceMapSectionList => {
|
|
if (!isRecord(map))
|
|
return { kind: "invalid", reason: "Source map must be an object." };
|
|
if (!Object.prototype.hasOwnProperty.call(map, "sections"))
|
|
return { kind: "regular" };
|
|
return Array.isArray(map.sections)
|
|
? { kind: "indexed", sections: map.sections }
|
|
: {
|
|
kind: "invalid",
|
|
reason: "Indexed source-map sections must be an array.",
|
|
};
|
|
};
|
|
|
|
/** Whether a parsed value has the version-3 map shape. */
|
|
export const isVersion3Map = (value: unknown): value is SourceMapRecord =>
|
|
isRecord(value) && value.version === 3;
|