// Package capture bounds native screenshots and their private-file transport. package capture import ( "bytes" "image/png" "io" "os" "path/filepath" "strings" "clusterflow.dev/cfbrowser/api" ) const MaxBytes = 4 * 1024 * 1024 const MaxDimension = 4096 func Validate(data []byte) error { if len(data) > MaxBytes { return api.Err("BROWSER_RESULT_LIMIT", "screenshot exceeds 4 MiB") } c, err := png.DecodeConfig(bytes.NewReader(data)) if err != nil || c.Width < 1 || c.Height < 1 || c.Width > MaxDimension || c.Height > MaxDimension { return api.Err("BROWSER_INVALID_RESULT", "invalid or oversized PNG (maximum 4096 x 4096)") } return nil } // Save returns a random basename, never page-controlled paths or PNG over RPC. func Save(dir string, data []byte) (string, error) { if err := Validate(data); err != nil { return "", err } if dir == "" { return "", api.Err("BROWSER_INVALID_CONFIG", "capture requires a private download directory") } f, err := os.CreateTemp(dir, "capture-*.png") if err != nil { return "", err } name := f.Name() _, err = f.Write(data) closeErr := f.Close() if err == nil { err = closeErr } if err != nil { _ = os.Remove(name) return "", err } return filepath.Base(name), nil } // Load consumes only a private capture file and removes it even on failure. func Load(dir, name string) ([]byte, error) { if dir == "" || filepath.Base(name) != name || strings.ContainsAny(name, "/\\\x00") || !strings.HasPrefix(name, "capture-") || !strings.HasSuffix(name, ".png") { return nil, api.Err("BROWSER_INVALID_RESULT", "invalid capture file token") } root, err := os.OpenRoot(dir) if err != nil { return nil, err } defer root.Close() defer root.Remove(name) f, err := root.Open(name) if err != nil { return nil, err } defer f.Close() data, err := io.ReadAll(io.LimitReader(f, MaxBytes+1)) if err == nil { err = Validate(data) } return data, err }