bb154d1067
Inspect bounded offline aioquic1.5.0 JSON qlog0.3 and page retained event/transport facts with explicit trace and stream selectors. Preserve producer coordinates, exact numeric lexemes, global pre-selection fact scope and endpoint declaration uncertainty. Verified four real HTTP/3 recordings with an independent interval oracle, public CLI/MCP/schema parity, auth exclusions, source-deletion views and actual decoder heap exhaustion. Unverified producer platforms and qlog-specific lifecycle induction remain documented. Co-authored-by: LuisTaffelli <86675342+LuisTaffelli@users.noreply.github.com> Co-authored-by: N0zoM1z0 <161784452+N0zoM1z0@users.noreply.github.com>
77 lines
2.6 KiB
TypeScript
77 lines
2.6 KiB
TypeScript
import { z } from "zod";
|
|
|
|
const decimal = z.string().regex(/^(0|[1-9][0-9]*)$/u);
|
|
const unsignedFact = z.discriminatedUnion("state", [
|
|
z.strictObject({ state: z.literal("reported"), value: decimal }),
|
|
z.strictObject({
|
|
state: z.literal("unknown"),
|
|
reason: z.literal("omitted-null-or-redacted"),
|
|
}),
|
|
]);
|
|
const traceLocation = z.discriminatedUnion("kind", [
|
|
z.strictObject({ kind: z.literal("json-pointer"), pointer: z.string() }),
|
|
z.strictObject({
|
|
kind: z.literal("unknown"),
|
|
reason: z.literal("explicit-sensitive-value"),
|
|
}),
|
|
]);
|
|
|
|
/** Exact, source-bound transport facts; coverage never establishes network completeness. */
|
|
export const qlogCaptureFactsSchema = z.strictObject({
|
|
profile: z.literal("aioquic-1.5.0-json-0.3"),
|
|
scope: z.literal("all-recorded-events-before-selection"),
|
|
body_bytes: z.literal("not-reported"),
|
|
clock: z.strictObject({
|
|
unit: z.literal("milliseconds"),
|
|
domain: z.literal("unix-epoch"),
|
|
basis: z.literal("selected-aioquic-profile-not-producer-authentication"),
|
|
}),
|
|
traces: z.array(
|
|
z.strictObject({
|
|
trace_index: z.number().int().nonnegative(),
|
|
location: traceLocation,
|
|
event_count: z.number().int().nonnegative(),
|
|
odcid: z.string().nullable(),
|
|
vantage_point: z.enum(["client", "server"]).nullable(),
|
|
incomplete_fact_records: z.array(z.number().int().nonnegative()),
|
|
loss_declarations: z.array(
|
|
z.strictObject({
|
|
record_ordinal: z.number().int().nonnegative(),
|
|
confidence: z.literal("observed"),
|
|
packet_number: unsignedFact,
|
|
packet_type: z.string().nullable(),
|
|
packet_number_space: z
|
|
.enum(["initial", "handshake", "application"])
|
|
.nullable(),
|
|
}),
|
|
),
|
|
streams: z.array(
|
|
z.strictObject({
|
|
stream_id: decimal,
|
|
direction: z.enum(["sent", "received"]),
|
|
confidence: z.literal("derived"),
|
|
scope: z.literal("observed-stream-frame-ranges"),
|
|
contributions: z.array(
|
|
z.strictObject({
|
|
record_ordinal: z.number().int().nonnegative(),
|
|
frame_index: z.number().int().nonnegative(),
|
|
offset: decimal,
|
|
length: decimal,
|
|
fin: z.boolean().nullable(),
|
|
}),
|
|
),
|
|
covered_ranges: z.array(
|
|
z.strictObject({ start: decimal, end: decimal }),
|
|
),
|
|
unique_bytes: decimal,
|
|
frame_length_sum: decimal,
|
|
repeated_bytes: decimal,
|
|
reported_final_sizes: z.array(decimal),
|
|
}),
|
|
),
|
|
}),
|
|
),
|
|
});
|
|
|
|
export type QlogCaptureFacts = z.output<typeof qlogCaptureFactsSchema>;
|