import { createHash } from "node:crypto"; import { z } from "zod"; /** Caller-selected network content; omission retains metadata alone. */ export const browserNetworkContentSelectionValuesSchema = z.strictObject({ request_body: z.boolean().default(false), response_body: z.boolean().default(false), header_values: z.boolean().default(false), }); /** Input omission selects metadata without defaulting legacy capture coverage. */ export const browserNetworkContentSelectionSchema = browserNetworkContentSelectionValuesSchema.default({ request_body: false, response_body: false, header_values: false, }); /** Self-verifying retained bytes, after any declared-secret redaction. */ export const browserNetworkBodySchema = z.union([ z.strictObject({ state: z.literal("not_requested") }), z.strictObject({ state: z.literal("not_exposed") }), z.strictObject({ state: z.literal("unavailable"), reason: z.enum([ "request-failed", "response-unfinished", "body-read-failed", "body-read-timeout", "cancelled", "capture-ended", ]), message: z.string().min(1), }), z .strictObject({ state: z.literal("captured"), representation: z.enum([ "browser-exposed-request-bytes", "browser-decoded-response-bytes", ]), encoding: z.literal("base64"), content: z.string(), bytes: z.number().int().min(0), sha256: z.string().regex(/^[a-f0-9]{64}$/u), media_type: z.string().nullable(), redacted: z.boolean(), }) .superRefine((artifact, context) => { const bytes = Buffer.from(artifact.content, "base64"); if (bytes.toString("base64") !== artifact.content) context.addIssue({ code: "custom", path: ["content"], message: "Network body must use canonical base64", }); if (bytes.length !== artifact.bytes) context.addIssue({ code: "custom", path: ["bytes"], message: "Network body byte count disagrees with retained bytes", }); if (createHash("sha256").update(bytes).digest("hex") !== artifact.sha256) context.addIssue({ code: "custom", path: ["sha256"], message: "Network body digest disagrees with retained bytes", }); }), ]); /** Headers retain producer order and duplicates, with credential values removed. */ export const browserNetworkHeadersSchema = z.union([ z.strictObject({ state: z.literal("not_requested") }), z.strictObject({ state: z.literal("unavailable"), message: z.string().min(1), }), z.strictObject({ state: z.literal("captured"), items: z.array( z.strictObject({ name: z.string().min(1), value: z.string().nullable(), redacted: z.boolean(), }), ), }), ]); export type BrowserNetworkContentSelection = z.infer< typeof browserNetworkContentSelectionSchema >; export type BrowserNetworkBody = z.infer; export type BrowserNetworkHeaders = z.infer;