v0.3.1

Changelog

• Add maxBase64Bytes encode budgets and base64Bytes output metadata for model and messaging payload limits.
• Expand coverage for malformed image headers, EXIF orientation handling, native fallback selection, and external encoder error paths.
• Require Node 22 or newer and add a tarball install/import smoke gate to CI.

npm

• Version: https://www.npmjs.com/package/rastermill/v/0.3.1
• Tarball: https://registry.npmjs.org/rastermill/-/rastermill-0.3.1.tgz
• Integrity: sha512-CX4nij6+ZLHYIaojJNfLTr7W+AiH/IPJi6E9Aw1br2///1KZL2KBOHd68rkcLedc47MPvb4hhH+fzYeGFa4A/Q==
• Published: 2026-05-30T14:58:13.440Z

Verification

• CI: https://github.com/openclaw/rastermill/actions/runs/26683818369 (dbb453b25941be8a588320261a9f2494334b8760)
• Local: pnpm prepublishOnly
• Local: pnpm package:smoke
• Registry: npm view rastermill@0.3.1 version dist-tags dist.tarball dist.integrity time --registry=https://registry.npmjs.org/ --json

Rastermill 0.3.0

Rastermill 0.3.0

Changes

• Add transparency(input) for alpha-channel and transparent-pixel inspection across common raster formats.
• Add execution: "auto" | "internal" | "external" so callers can keep work in-process, force native tools, or use automatic fallback.
• Collapse writing into encode(input, options?) for exact formats, auto format choice, dimension limits, and byte-budget search.
• Remove the documented encodeWithinBytes export; migrate encodeWithinBytes(input, { maxBytes, ...options }) to encode(input, { maxBytes, ...options }).
• Add metadata policy controls: transformed outputs strip metadata by default; no-op within-limit auto encodes preserve original bytes unless callers pass metadata: "strip".
• Improve default byte-budget searches so small dimension limits can keep downscaling without explicit search.maxSide.
• Keep Photon loading lazy, including default-instance and external-execution paths.
• Expand docs for transparency, execution modes, metadata behavior, and unified encode.

Verification

• Local: pnpm check
• Local: pnpm test (57 tests)
• Local: pnpm build
• Local: pnpm docs:check
• Local: npm pack --dry-run
• GitHub CI: CI run 26471848289 passed for commit 19be07c04392cfd26397ef9acdd6322cfe127a09.

npm

• Version: https://www.npmjs.com/package/rastermill/v/0.3.0
• Tarball: https://registry.npmjs.org/rastermill/-/rastermill-0.3.0.tgz
• Integrity: sha512-4g2i0I7M5sba//lFBh19Wi0hDGw8o+isnt/BtEyqQXIZaYclhcNBwL/Fw/6gDCp7aaLwQHADuUvyHCB0Oat5Vw==
• Published: 2026-05-26T20:07:12.218Z

Rastermill 0.2.0

Rastermill 0.2.0

Initial public npm release of Rastermill: portable image processing for Node agents with Photon, native codec fallbacks, pixel-budget guards, and typed encode/probe APIs.

npm: https://www.npmjs.com/package/rastermill/v/0.2.0
Tarball: https://registry.npmjs.org/rastermill/-/rastermill-0.2.0.tgz
Integrity: sha512-Uc3oKCF4v+sh8OznkG5P6wzQQUstZI/dEGubjNXfWqmCn6iMEAVz8V8S3SVJf+lfQsGpL9iIjBOECmt2ernOAA==

Proof:

• npm published as latest
• CI green: https://github.com/openclaw/rastermill/actions/runs/26426700277
• Pages deploy green: https://github.com/openclaw/rastermill/actions/runs/26426699709