mirror of
https://github.com/morluto/rea
synced 2026-10-26 06:16:17 -04:00
morluto
475a0f84da
Use one explicit object/array slot model and JSON-pointer property identity across mutation analysis, return projection, and semantic graphs. Require observed presence for discriminants and resolve writes only through retained object or array receivers. BREAKING CHANGE: projected return fields require explicit presence and semantic object operations carry full property paths.
103 lines
3.8 KiB
TypeScript
103 lines
3.8 KiB
TypeScript
import type {
|
|
JavaScriptSemanticResourceLimit,
|
|
JavaScriptSemanticValue,
|
|
} from "./javascriptSemanticValueTypes.js";
|
|
|
|
/** Maximum distinct alternatives retained in one normalized primitive value. */
|
|
export const SEMANTIC_PRIMITIVE_CANDIDATE_LIMIT = 256;
|
|
/** Maximum active expression nesting during inert semantic evaluation. */
|
|
export const SEMANTIC_EXPRESSION_DEPTH_LIMIT = 256;
|
|
/** Bound normalized strings and transient keys independently of transport limits. */
|
|
export const SEMANTIC_PRIMITIVE_JSON_BYTES_LIMIT = 1_048_576;
|
|
|
|
const RESOURCE_LIMIT_REASON: Record<JavaScriptSemanticResourceLimit, string> = {
|
|
"primitive-candidates":
|
|
"Primitive candidate budget exceeded (maximum 256 alternatives).",
|
|
"primitive-bytes":
|
|
"Primitive string-byte budget exceeded (maximum 1048576 estimated JSON bytes).",
|
|
"expression-depth":
|
|
"Semantic expression depth budget exceeded (maximum 256 nested expressions).",
|
|
};
|
|
|
|
/** Check UTF-16 length against worst-case JSON escaping without flattening. */
|
|
const jsonStringBytesFromLength = (codeUnits: number): number =>
|
|
codeUnits * 6 + 2;
|
|
|
|
/** Bound string payload before JSON key serialization or candidate creation. */
|
|
export const exceedsSemanticPrimitiveStringByteBudget = (
|
|
strings: Iterable<string>,
|
|
): boolean => {
|
|
let total = 0;
|
|
for (const value of strings) {
|
|
total += jsonStringBytesFromLength(value.length);
|
|
if (total > SEMANTIC_PRIMITIVE_JSON_BYTES_LIMIT) return true;
|
|
}
|
|
return false;
|
|
};
|
|
|
|
/** Bound all outputs of a primitive addition before concatenating any. */
|
|
export const exceedsSemanticPrimitiveAdditionByteBudget = (
|
|
left: readonly (string | number | boolean | null)[],
|
|
right: readonly (string | number | boolean | null)[],
|
|
): boolean => {
|
|
let total = 0;
|
|
for (const leftValue of left) {
|
|
for (const rightValue of right) {
|
|
if (typeof leftValue !== "string" && typeof rightValue !== "string")
|
|
continue;
|
|
const length = String(leftValue).length + String(rightValue).length;
|
|
total += jsonStringBytesFromLength(length);
|
|
if (total > SEMANTIC_PRIMITIVE_JSON_BYTES_LIMIT) return true;
|
|
}
|
|
}
|
|
return false;
|
|
};
|
|
|
|
/** Bound template interpolation outputs before creating concatenated strings. */
|
|
export const exceedsSemanticTemplateByteBudget = (
|
|
prefixes: readonly string[],
|
|
suffixes: readonly string[],
|
|
): boolean => {
|
|
let total = 0;
|
|
for (const prefix of prefixes) {
|
|
for (const suffix of suffixes) {
|
|
total += jsonStringBytesFromLength(prefix.length + suffix.length);
|
|
if (total > SEMANTIC_PRIMITIVE_JSON_BYTES_LIMIT) return true;
|
|
}
|
|
}
|
|
return false;
|
|
};
|
|
|
|
/** Make an explicit unknown value tagged with the semantic resource bound. */
|
|
export const semanticResourceLimitUnknown = (
|
|
resourceLimit: JavaScriptSemanticResourceLimit,
|
|
): JavaScriptSemanticValue => ({
|
|
status: "unknown",
|
|
reason: RESOURCE_LIMIT_REASON[resourceLimit],
|
|
resourceLimit,
|
|
});
|
|
|
|
/** Collect resource-limit classifications from nested semantic values. */
|
|
export const semanticResourceLimitsIn = (
|
|
values: readonly JavaScriptSemanticValue[],
|
|
): readonly JavaScriptSemanticResourceLimit[] => {
|
|
const found = new Set<JavaScriptSemanticResourceLimit>();
|
|
const pending = [...values];
|
|
while (pending.length > 0) {
|
|
const value = pending.pop();
|
|
if (value === undefined) continue;
|
|
if (value.status === "unknown" && value.resourceLimit !== undefined)
|
|
found.add(value.resourceLimit);
|
|
else if (value.status === "object")
|
|
for (const property of value.properties) pending.push(property.value);
|
|
else if (value.status === "array")
|
|
for (const item of value.items) pending.push(item.value);
|
|
}
|
|
return [...found].sort();
|
|
};
|
|
|
|
/** Display label for one stable resource classification. */
|
|
export const semanticResourceLimitReason = (
|
|
resourceLimit: JavaScriptSemanticResourceLimit,
|
|
): string => RESOURCE_LIMIT_REASON[resourceLimit];
|