@radzor/image-transform

High-performance image transformation using Sharp. Resize, crop, convert formats, apply watermarks, strip metadata, and optimize for web. Supports JPEG, PNG, WebP, AVIF, GIF, and SVG inputs.

Mediav0.1.0typescriptServerimageresizecompresssharpwebpavifcropwatermarkoptimizeby Radzor

Install

View source on GitHub →

$npx radzor@latest add image-transform

⚠ Constraints: Sharp requires native bindings — prebuilt binaries are available for common platforms. Not compatible with edge runtimes. In Docker, install libvips or use the sharp Docker image. Width and height are both optional in resize; omit one to scale proportionally.

Inputs

Name	Type	Default	Description
quality	number	80	Output quality for lossy formats (1-100). Applies to JPEG, WebP, AVIF.
defaultFormat	'jpeg' \| 'png' \| 'webp' \| 'avif'	webp	Default output format when not specified per operation.
stripMetadata	boolean	true	Remove EXIF, GPS, and ICC metadata from output.
progressive	boolean	true	Use progressive (interlaced) encoding for JPEG/PNG.

qualitynumber

Output quality for lossy formats (1-100). Applies to JPEG, WebP, AVIF.

default: 80

defaultFormat'jpeg' | 'png' | 'webp' | 'avif'

{ "llm": { "constraints": "Sharp requires native bindings — prebuilt binaries are available for common platforms. Not compatible with edge runtimes. In Docker, install libvips or use the sharp Docker image. Width and height are both optional in resize; omit one to scale proportionally.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/image-transform", "tags": [ "image", "resize", "compress", "sharp", "webp", "avif", "crop", "watermark", "optimize" ], "events": [ { "name": "onTransformed", "payload": { "width": "number", "format": "string", "height": "number", "sizeBytes": "number" }, "description": "Fired when a transformation completes successfully." }, { "name": "onError", "payload": { "code": "string", "message": "string", "operation": "string" }, "description": "Fired when a transformation fails." } ], "inputs": [ { "name": "quality", "type": "number", "default": 80, "required": false, "description": "Output quality for lossy formats (1-100). Applies to JPEG, WebP, AVIF." }, { "name": "defaultFormat", "type": "'jpeg' | 'png' | 'webp' | 'avif'", "default": "webp", "required": false, "description": "Default output format when not specified per operation." }, { "name": "stripMetadata", "type": "boolean", "default": true, "required": false, "description": "Remove EXIF, GPS, and ICC metadata from output." }, { "name": "progressive", "type": "boolean", "default": true, "required": false, "description": "Use progressive (interlaced) encoding for JPEG/PNG." } ], "radzor": "1.0.0", "actions": [ { "name": "resize", "params": [ { "name": "input", "type": "Buffer | string", "description": "Input image as Buffer or file path." }, { "name": "width", "type": "number", "required": false, "description": "Target width in pixels." }, { "name": "height", "type": "number", "required": false, "description": "Target height in pixels." }, { "name": "fit", "type": "'cover' | 'contain' | 'fill' | 'inside' | 'outside'", "required": false, "description": "Resize strategy." } ], "returns": "Promise<Buffer>", "description": "Resize an image. Preserves aspect ratio by default (fit=inside)." }, { "name": "crop", "params": [ { "name": "input", "type": "Buffer | string", "description": "Input image." }, { "name": "width", "type": "number", "description": "Crop width." }, { "name": "height", "type": "number", "description": "Crop height." }, { "name": "left", "type": "number", "required": false, "description": "Left offset." }, { "name": "top", "type": "number", "required": false, "description": "Top offset." } ], "returns": "Promise<Buffer>", "description": "Crop a region from an image." }, { "name": "convert", "params": [ { "name": "input", "type": "Buffer | string", "description": "Input image." }, { "name": "format", "type": "'jpeg' | 'png' | 'webp' | 'avif'", "description": "Target format." }, { "name": "quality", "type": "number", "required": false, "description": "Output quality override (1-100)." } ], "returns": "Promise<Buffer>", "description": "Convert an image to a different format." }, { "name": "watermark", "params": [ { "name": "input", "type": "Buffer | string", "description": "Base image." }, { "name": "overlay", "type": "Buffer | string", "description": "Watermark image to composite." }, { "name": "gravity", "type": "'southeast' | 'south' | 'southwest' | 'east' | 'center' | 'west' | 'northeast' | 'north' | 'northwest'", "required": false, "description": "Watermark position." } ], "returns": "Promise<Buffer>", "description": "Add a watermark overlay to an image." }, { "name": "getMetadata", "params": [ { "name": "input", "type": "Buffer | string", "description": "Input image." } ], "returns": "Promise<ImageMetadata>", "description": "Read image metadata without transformation." } ], "outputs": [ { "name": "imageBuffer", "type": "Buffer", "description": "Transformed image as raw bytes." }, { "name": "metadata", "type": "ImageMetadata", "fields": [ { "name": "width", "type": "number" }, { "name": "height", "type": "number" }, { "name": "format", "type": "string" }, { "name": "size", "type": "number" }, { "name": "hasAlpha", "type": "boolean", "required": false }, { "name": "space", "type": "string", "required": false } ], "description": "Output image metadata: width, height, format, size." } ], "runtime": "server", "version": "0.1.0", "category": "media", "languages": [ "typescript" ], "description": "High-performance image transformation using Sharp. Resize, crop, convert formats, apply watermarks, strip metadata, and optimize for web. Supports JPEG, PNG, WebP, AVIF, GIF, and SVG inputs.", "dependencies": { "radzor": [ "@radzor/file-upload" ], "packages": { "sharp": "^0.33.0" } }, "composability": { "connectsTo": [ { "output": "imageBuffer", "compatibleWith": [ "@radzor/file-upload.action.upload.data" ] } ] } }

@radzor/image-transform

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History

Name	Type	Description
imageBuffer	Buffer	Transformed image as raw bytes.
metadata	ImageMetadata	Output image metadata: width, height, format, size. .widthnumber .heightnumber .formatstring .sizenumber .hasAlphaboolean(optional) .spacestring(optional)