pkgzip

type Limits struct {
	// MaxFiles 是包内文件数上限。
	MaxFiles int
	// MaxEntries 是「文件 + 落盘目录」的总条目数上限。
	//
	// 单看文件数不够：目录条目不占字节、也不计入文件数，一个只含几万个空目录的
	// 几十 KB 压缩包能绕过 MaxFiles/MaxTotalSize，耗尽 inode 与磁盘元数据。
	// 非正数时退回 MaxFiles，保持旧调用方的行为不变。
	MaxEntries int
	// MaxFileSize 是单个文件解压后的字节上限。
	MaxFileSize int64
	// MaxTotalSize 是整包解压后的字节上限。
	MaxTotalSize int64
	// MaxPathDepth 是包内路径的层级上限。
	MaxPathDepth int
}

type Options struct {
	Limits Limits
	// AllowedExtensions 是允许出现的文件扩展名（小写，含点）。
	//
	// 白名单而非黑名单：两类包都只该包含声明式资产，没有理由出现可执行文件。
	// 放行一个不该放行的后缀，等于给站点留下一个可上传的后门。
	AllowedExtensions map[string]bool
	// DirPerm 与 FilePerm 是新建目录与文件的权限。
	DirPerm  os.FileMode
	FilePerm os.FileMode
}