import jpeg from 'jpeg-js' import { encode as encodeWebp } from '@stacksjs/ts-webp' import { encode as encodeBlurhash } from 'blurhash' import { planVariantSizes, variantFormats } from '../domain/image-plan.ts' import type { PhotoCredits, PhotoVariant } from '../domain/types.ts' import { bytesToBase64 } from '../store/base64.ts' import { buildCreditExif, readExif } from './exif.ts' import { applyOrientation, decodeImage, orientedSize, resize, sniffFormat, type Pixels, } from './pixels.ts' export const jpegQuality = 80 export const webpQuality = 72 export type ProcessedFile = { variant: PhotoVariant; bytes: Uint8Array } export type ProcessedImage = { width: number height: number blurhash: string lqip: string credits: PhotoCredits files: Array } export type ProcessOptions = { /** When set, written into each JPEG's EXIF Artist/Copyright. Nothing else is kept. */ creditExif?: { artist: string; copyright: string } } function scaledToFit(pixels: Pixels, width: number) { const height = Math.max(1, Math.round((pixels.height * width) / pixels.width)) return resize(pixels, width, height) } /** * Turn one uploaded photo into web-ready files: every planned width as WebP and * JPEG, upright (EXIF orientation applied), metadata stripped except optional * credits, plus a BlurHash and a tiny JPEG placeholder. */ export async function processImage( bytes: Uint8Array, options: ProcessOptions = {}, ): Promise { const format = sniffFormat(bytes) const exif = format === 'jpeg' ? readExif(bytes) : { orientation: 1, credits: {} } const source = await decodeImage(bytes) const upright = orientedSize(source.width, source.height, exif.orientation) const sizes = planVariantSizes(upright.width, upright.height) const exifPayload = options.creditExif ? buildCreditExif(options.creditExif) : undefined const files: Array = [] for (const size of sizes) { const raw = orientedSize(size.width, size.height, exif.orientation) const pixels = applyOrientation( resize(source, raw.width, raw.height), exif.orientation, ) for (const variantFormat of variantFormats) { const encoded = variantFormat === 'webp' ? encodeWebp( { data: pixels.data, width: pixels.width, height: pixels.height }, { lossless: false, quality: webpQuality }, ) : new Uint8Array( jpeg.encode( { data: pixels.data, width: pixels.width, height: pixels.height, ...(exifPayload ? { exifBuffer: exifPayload } : {}), } as Parameters[0], jpegQuality, ).data, ) files.push({ variant: { width: pixels.width, height: pixels.height, format: variantFormat, bytes: encoded.length, }, bytes: encoded, }) } } const thumbHeight = Math.max( 1, Math.round((32 * upright.height) / upright.width), ) const thumbRaw = orientedSize(32, thumbHeight, exif.orientation) const thumbSource = applyOrientation( resize(source, thumbRaw.width, thumbRaw.height), exif.orientation, ) const blurhash = encodeBlurhash( new Uint8ClampedArray( thumbSource.data.buffer, thumbSource.data.byteOffset, thumbSource.data.byteLength, ), thumbSource.width, thumbSource.height, 4, 3, ) const tiny = scaledToFit(thumbSource, 16) const lqipBytes = new Uint8Array( jpeg.encode({ data: tiny.data, width: tiny.width, height: tiny.height }, 40) .data, ) const largest = sizes[sizes.length - 1]! return { width: largest.width, height: largest.height, blurhash, lqip: `data:image/jpeg;base64,${bytesToBase64(lqipBytes)}`, credits: exif.credits, files, } }