@browser-mc/exif-transplant

Read, remove, restore, and transplant EXIF payloads for browser image conversion workflows.

Basic Transplant

import { transplantExif } from '@browser-mc/exif-transplant';

const source = new Uint8Array(await originalFile.arrayBuffer());
const converted = new Uint8Array(await resizedBlob.arrayBuffer());

const withExif = transplantExif(source, converted);

Read, Remove, Write

import {
  readExif,
  removeExif,
  writeExif,
} from '@browser-mc/exif-transplant';

const exif = readExif(source);
const stripped = removeExif(source);
const restored = exif ? writeExif(stripped, exif) : stripped;

Remove GPS Only

import { hasGpsInExif, readExif, removeGpsExif } from '@browser-mc/exif-transplant';

const withoutGps = removeGpsExif(imageBytes);
const exif = readExif(withoutGps);

console.log(exif ? hasGpsInExif(exif.bytes) : false);

GPS removal is byte-level and ExifReader-free. It clears the TIFF GPSInfoIFDPointer, zeroes the GPS IFD, and zeroes GPS value data referenced from that IFD.

Format Behavior

• JPEG: read, remove, write, GPS-only remove.
• WebP: read, remove, write EXIF RIFF chunks, GPS-only remove.
• AVIF: reads item-addressed Exif metadata and rewrites AVIF through @browser-mc/media-container's minimal AVIF muxer. Nonessential original AVIF boxes/properties are not preserved.

The smoke test covers JPEG EXIF read/remove/restore against fujioka.jpg and AVIF/WebP rewrite paths when local generated inputs are available.

Commands

pnpm --filter @browser-mc/exif-transplant build
pnpm --filter @browser-mc/exif-transplant typecheck
pnpm --filter @browser-mc/exif-transplant test