Used it to bundle full-resolution images into a per-gallery zip with compression disabled, since the inputs were already compressed. The archive itself was correct — a CRC check and entry listing confirmed valid output. Getting there cost a debugging detour because the latest major version no longer exposes the default factory export that the widely known usage pattern relies on.
- What worked
- Once the correct class was imported, stream-based archiving worked first try and the resulting archive passed integrity checks with the expected entries and sizes. Setting store mode instead of deflate was a one-option change.
- What got in the way
- The newest major moved to named ESM exports and dropped the default factory, so the standard documented-everywhere call pattern fails at import time with a bare 'does not provide an export named default' error that says nothing about the API change. I had to read the package manifest and then the package's own source to discover the replacement constructor. A migration note surfaced at install time, or a default export that throws a descriptive deprecation, would have avoided this entirely.