ZipPacker

public ZipPacker();

Creates an owned packer without an open file and CompressionLevel=-1. Compression can be set before Open. Check Error when finishing entries/archive, then dispose the object.

public int CompressionLevel { get; set; }

Setting -1 or 0..9 for the next opened entry, default -1. Does not change an already started record and persists after Close. None=0 here means Deflate level 0 rather than ZIP Store. Invalid levels are diagnosed and rejected; settings guarantee no particular speed/size.

public Error AddDirectory(string path, FileAccess.UnixPermissionFlags permissions = FileAccess.UnixPermissionFlags.ExecuteOther | FileAccess.UnixPermissionFlags.ReadOther | FileAccess.UnixPermissionFlags.ExecuteGroup | FileAccess.UnixPermissionFlags.ReadGroup | FileAccess.UnixPermissionFlags.ExecuteOwner | FileAccess.UnixPermissionFlags.WriteOwner | FileAccess.UnixPermissionFlags.ReadOwner, ulong modifiedTime = 0);

Adds a directory record, appending / when needed, and immediately closes it. Scans no filesystem and adds no ancestor chain. Repeating a cached path in the same session is rejected; existing archive directories are not automatically loaded into that cache. Call between file entries and check Error.

public Error Close();

Finalizes the ZIP central directory and closes the file; check Error.Ok before publishing the result. The current library also finishes an open entry, while explicit CloseFile lets you inspect that result separately. Retains CompressionLevel and clears the directory cache on success. Re-closing a closed session is diagnosed.

public Error CloseFile();

Finishes the current entry while leaving the archive open for another. AddDirectory already closes its record. Check Error.Ok; calling without a current entry is not a successful operation.

public int GetCompressionLevel();

Reads the stored packer setting rather than a header category from an existing record. Requires no open archive.

public Error Open(string path, ZipPacker.ZipAppend append = ZipPacker.ZipAppend.Create);

Opens a destination using append mode; default Create replaces the file. Addinzip appends records and Createafter starts a separate ZIP after existing bytes. Calls Close on a previous session without directly forwarding its failure: close explicitly. Prepare the destination parent directory first.

public void SetCompressionLevel(int compressionLevel);

Sets CompressionLevel for later records: -1 or 0..9. Allowed before Open; does not recompress an already open record.

public Error StartFile(string path);

Starts a new path-named record inside the open archive rather than reading a source file. Can add its immediate parent record with 0755. Uses the compression setting at call time. A repeated name creates a duplicate rather than replacement. Finish the preceding record explicitly; permissions/modifiedTime set this record metadata. This overload supplies 0644 and modifiedTime=0 and is not SDK-obsolete.

public Error StartFile(string path, FileAccess.UnixPermissionFlags permissions = FileAccess.UnixPermissionFlags.ReadOther | FileAccess.UnixPermissionFlags.ReadGroup | FileAccess.UnixPermissionFlags.WriteOwner | FileAccess.UnixPermissionFlags.ReadOwner, ulong modifiedTime = 0);

Starts a new path-named record inside the open archive rather than reading a source file. Can add its immediate parent record with 0755. Uses the compression setting at call time. A repeated name creates a duplicate rather than replacement. Finish the preceding record explicitly; permissions/modifiedTime set this record metadata.

public Error WriteFile(byte[] data);

Writes bytes into the current open entry. Multiple calls append successive chunks; infers no source path or encoding. Use bounded chunks within your memory budget. Check Error from this call rather than only a later Close.

public Error WriteFile(ReadOnlySpan<byte> data);

Writes bytes into the current open entry. Multiple calls append successive chunks; infers no source path or encoding. Use bounded chunks within your memory budget. Check Error from this call rather than only a later Close.