capture.go 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. // Package capture bounds native screenshots and their private-file transport.
  2. package capture
  3. import (
  4. "bytes"
  5. "image/png"
  6. "io"
  7. "os"
  8. "path/filepath"
  9. "strings"
  10. "clusterflow.dev/cfbrowser/api"
  11. )
  12. const MaxBytes = 4 * 1024 * 1024
  13. const MaxDimension = 4096
  14. func Validate(data []byte) error {
  15. if len(data) > MaxBytes {
  16. return api.Err("BROWSER_RESULT_LIMIT", "screenshot exceeds 4 MiB")
  17. }
  18. c, err := png.DecodeConfig(bytes.NewReader(data))
  19. if err != nil || c.Width < 1 || c.Height < 1 || c.Width > MaxDimension || c.Height > MaxDimension {
  20. return api.Err("BROWSER_INVALID_RESULT", "invalid or oversized PNG (maximum 4096 x 4096)")
  21. }
  22. return nil
  23. }
  24. // Save returns a random basename, never page-controlled paths or PNG over RPC.
  25. func Save(dir string, data []byte) (string, error) {
  26. if err := Validate(data); err != nil {
  27. return "", err
  28. }
  29. if dir == "" {
  30. return "", api.Err("BROWSER_INVALID_CONFIG", "capture requires a private download directory")
  31. }
  32. f, err := os.CreateTemp(dir, "capture-*.png")
  33. if err != nil {
  34. return "", err
  35. }
  36. name := f.Name()
  37. _, err = f.Write(data)
  38. closeErr := f.Close()
  39. if err == nil {
  40. err = closeErr
  41. }
  42. if err != nil {
  43. _ = os.Remove(name)
  44. return "", err
  45. }
  46. return filepath.Base(name), nil
  47. }
  48. // Load consumes only a private capture file and removes it even on failure.
  49. func Load(dir, name string) ([]byte, error) {
  50. if dir == "" || filepath.Base(name) != name || strings.ContainsAny(name, "/\\\x00") || !strings.HasPrefix(name, "capture-") || !strings.HasSuffix(name, ".png") {
  51. return nil, api.Err("BROWSER_INVALID_RESULT", "invalid capture file token")
  52. }
  53. root, err := os.OpenRoot(dir)
  54. if err != nil {
  55. return nil, err
  56. }
  57. defer root.Close()
  58. defer root.Remove(name)
  59. f, err := root.Open(name)
  60. if err != nil {
  61. return nil, err
  62. }
  63. defer f.Close()
  64. data, err := io.ReadAll(io.LimitReader(f, MaxBytes+1))
  65. if err == nil {
  66. err = Validate(data)
  67. }
  68. return data, err
  69. }