Changelog

What changed in each release.

Open as Markdown

0.3.0 (2026-11-20)

  • Add the versionless Chop-Status response header and rename X-Bytes-Saved to Chop-Bytes-Saved. Image ETags now account for the Chop headers so revalidation refreshes stale metadata. Update clients that read the old header and purge cached image variants or change their URLs if clients need the new header immediately. (7f8fbfc)
  • Document how to avoid stampedes with the nginx cache: longer lock timeouts, stale copies while one request refreshes, no retries on a slow request, cache sizing and a warm-up. The recipe now sets them, and proxy_cache_valid is documented as a fallback to the max-age of chop. (3388be7)

0.2.2 (2026-11-15)

  • Reorganize the documentation by task, with real command output at the top of each page: a quickstart, pages to resize images, serve responsive images, serve AVIF and WebP, set quality, serve transparent and animated images, choose a source, serve from an HTTPS origin, S3 and named hosts, run in Docker, prepare for production, cache with nginx or a CDN, troubleshoot errors, and migrate from Photon or Cloudflare Image Resizing. The long reference page is gone, and its rules live in the pages that own them. (d447886)
  • Start each documentation page with a # Title heading instead of a title in the front matter, so that the Markdown pages read well on GitHub and in node_modules. (ca287e4)
  • Point the package homepage to the documentation site, so that the Homepage link on the npm package page works without access to the private repository. (ca287e4)

0.2.1 (2026-11-07)

  • Make the exported DEFAULT_SETTINGS report the real maxConcurrency default of the number of CPUs, which createConfig used to compute separately after overriding the placeholder value. (c075de5)
  • Move the detailed usage documentation from the README into topic pages of the docs/ directory, so that the docs site has a guide for each area besides the reference. (da8652c)
  • Publish the docs/ directory in the npm package, so that agents and editors can read the documentation of the installed version. (da8652c)

0.2.0 (2026-11-04)

  • Add the allowedInputFormats and autoFormats settings (CHOP_ALLOWED_INPUT_FORMATS and CHOP_AUTO_FORMATS), and pick the negotiated format by the q-values of the Accept header. (496d04d)
  • Add an internal AWS Signature Version 4 signer for S3 and a per-request header hook on the HTTP origin, as groundwork for an S3 origin. (a038143)
  • Load originals from an HTTP(S) origin with CHOP_ORIGIN, or from allow-listed hosts named in URLs with CHOP_ALLOWED_HOSTS, through a pluggable origin interface, with pinned and blocked-address-checked connections, no redirects, a streaming size cap, timeouts and a separate fetch limit, in both the query and cloudflare schemes. (971a1cf)
  • Add an S3 origin: CHOP_ORIGIN=s3://bucket[/prefix] reads originals from AWS S3 or an S3-compatible service (SeaweedFS, MinIO, R2) with AWS Signature Version 4 requests, configured with CHOP_S3_ENDPOINT, CHOP_S3_REGION, CHOP_S3_PATH_STYLE and the CHOP_S3_* or AWS_* credentials, with the S3 error codes in the operator log. (2099b59)

0.1.1 (2026-11-04)

  • Fix the README, which still said that the package is not published. (aaa907b)

0.1.0 (2026-11-04)

  • Add Chop, an HTTP image server with AVIF and WebP negotiation from the Accept header, resize, crop and letterbox, Cloudflare-style URLs through pluggable URL schemes, and a library and CLI. (2a83fd3)
  • Publish the package to npm. (93cd789)