imageflow-node

npm install @imazen/imageflow

import { Steps, FromFile, FromBuffer, presets } from '@imazen/imageflow';

// Resize an image file
await new Steps(new FromFile('input.jpg'))
  .constrainWithin(800, 600)
  .encode(new FromFile('output.jpg'), presets.mozjpeg(80))
  .execute();

import { Steps, FromBuffer, presets } from '@imazen/imageflow';

const result = await new Steps(new FromBuffer(inputBytes))
  .constrainWithin(400, 400)
  .toBuffer(presets.mozjpeg(85), 'result')
  .execute();

const outputBytes = result.buffers.get('result');

import { Steps, FromStream, presets } from '@imazen/imageflow';
import { createReadStream, createWriteStream } from 'fs';

await new Steps(new FromStream(createReadStream('photo.png')))
  .constrainWithin(1200, 1200)
  .toStream(presets.webpLossy(80), createWriteStream('photo.webp'))
  .execute();

import { Steps, FromURL, FromFile, presets } from '@imazen/imageflow';

await new Steps(new FromURL('https://example.com/photo.jpg'))
  .constrainWithin(500, 500)
  .colorFilterGrayscaleFlat()
  .encode(new FromFile('gray.webp'), presets.webpLossy(75))
  .execute();

import { Steps, FromBuffer, DecodeOptions, presets } from '@imazen/imageflow';

const result = await new Steps(
  new FromBuffer(jpegBytes),
  new DecodeOptions()
    .setJpegDownscaleHint(200, 200)
    .discardColorProfile()
)
  .constrainWithin(200, 200)
  .toBuffer(presets.mozjpeg(80), 'thumb')
  .execute();

import { Steps, FromFile, presets } from '@imazen/imageflow';

await new Steps(new FromFile('original.jpg'))
  .constrainWithin(1200, 1200)
  .branch(s => s.encode(new FromFile('large.jpg'), presets.mozjpeg(85)))
  .branch(s => s
    .constrainWithin(400, 400)
    .encode(new FromFile('medium.jpg'), presets.mozjpeg(80))
  )
  .branch(s => s
    .constrainWithin(150, 150)
    .encode(new FromFile('thumb.jpg'), presets.mozjpeg(70))
  )
  .execute();

import { Steps, FromBuffer, presets } from '@imazen/imageflow';

await new Steps().executeCommand(
  'width=200&height=200&mode=max&format=webp',
  new FromBuffer(inputBytes),
  new FromBuffer(null, 'out')
);

import { presets } from '@imazen/imageflow';

presets.mozjpeg(quality, { progressive?: boolean })
presets.libjpegTurbo(quality, { progressive?: boolean })
presets.webpLossy(quality)
presets.webpLossless()
presets.lodepng({ maxDeflate?: boolean })
presets.pngquant({ quality?: [min, max], speed?: number })
presets.libpng({ maxDeflate?: boolean, matte?: Color })
presets.gif()

git clone https://github.com/imazen/imageflow-node
cd imageflow-node
npm install
npm test          # vitest — 110 tests including doctest examples
npm run docs      # typedoc — generates API reference in docs/

cd native
cargo build
cp target/debug/libimageflow_node.so index.node  # .dylib on macOS, .dll on Windows