@wasmedia/wexiftool 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wmedia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE-exiftool

@@ -0,0 +1,19 @@
+ExifTool License Notice
+=======================
+
+This package bundles ExifTool by Phil Harvey (https://exiftool.org/).
+
+ExifTool is free software; you can redistribute it and/or modify it
+under the same terms as Perl itself, which means either:
+
+  a) the GNU General Public License as published by the Free Software
+     Foundation; either version 1, or (at your option) any later version, or
+
+  b) the "Artistic License" which comes with Perl.
+
+For the full text of these licenses, see:
+  - GNU GPL: https://www.gnu.org/licenses/gpl.html
+  - Artistic License: https://dev.perl.org/licenses/artistic.html
+
+ExifTool homepage: https://exiftool.org/
+ExifTool author: Phil Harvey (philharvey66 at gmail.com)

package/README.md

@@ -1,3 +1,106 @@
-# Temporary Holding Version
+# wexiftool
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![pipeline status](https://gitlab.com/wasmedia/wexiftool/badges/main/pipeline.svg)](https://gitlab.com/wasmedia/wexiftool/-/pipelines)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![demo](https://img.shields.io/badge/demo-GitLab%20Pages-orange)](https://wasmedia.gitlab.io/wexiftool/)
+
+Run the real, full-featured [ExifTool](https://exiftool.org/) in the browser and Node.js — no server required.
+
+wexiftool compiles Perl 5.40 to WebAssembly via Emscripten and bundles Phil Harvey's ExifTool into the WASM virtual filesystem. This gives you the complete ExifTool (read **and** write support for 400+ metadata formats) as a JavaScript/TypeScript library.
+
+## CLI Usage
+
+Use it just like native exiftool — no Perl installation required:
+
+```bash
+# Install globally
+npm install -g @wasmedia/wexiftool
+
+# Or use directly with npx
+npx @wasmedia/wexiftool photo.jpg
+npx @wasmedia/wexiftool -Artist="Jane Doe" photo.jpg
+npx @wasmedia/wexiftool -json -G *.jpg
+npx @wasmedia/wexiftool -ver
+```
+
+All standard exiftool flags and options work as expected.
+
+## API Usage
+
+```typescript
+import { WExifTool } from '@wasmedia/wexiftool';
+
+const wexiftool = await WExifTool.create();
+
+// Read metadata
+const metadata = await wexiftool.read(file); // File, Blob, ArrayBuffer, or Uint8Array
+
+// Write metadata
+const modified = await wexiftool.write(file, {
+  Artist: 'Jane Doe',
+  Copyright: '2026 Jane Doe',
+});
+
+// Pass arbitrary exiftool flags
+const raw = await wexiftool.readRaw(file, ['-G', '-s']);
+
+// Run any exiftool command (low-level)
+const result = await wexiftool.exec(['-json', '-G'], files);
+
+wexiftool.destroy(); // Free WASM memory
+```
+
+## Install
+
+```bash
+npm install @wasmedia/wexiftool
+# or
+pnpm add @wasmedia/wexiftool
+```
+
+A standalone UMD bundle with inlined WASM is also available for `<script>` tag usage at `https://exiftool.wasmedia.org/wexiftool.standalone.js` (see [Standalone Bundle](docs/standalone-bundle.md)). It's ~70MB and not part of the npm package; the npm package, which loads the WASM separately, is recommended for production.
+
+## Demo
+
+A playground demo is available where you can drop an image to read and edit its metadata entirely client-side. Deployed via GitLab Pages.
+
+## How It Works
+
+1. Perl 5.40 is cross-compiled to WASM using Emscripten inside a Docker container
+2. ExifTool's Perl modules are embedded into the Emscripten virtual filesystem (MEMFS)
+3. Image data is written into MEMFS, ExifTool processes it via `callMain()`, results are extracted
+4. A TypeScript API wraps the low-level Emscripten interface with a clean async interface
+
+## Building from Source
+
+Requires Docker.
+
+```bash
+pnpm install
+pnpm run build:wasm   # Builds Perl + ExifTool WASM (Docker, ~10-15 min first time)
+pnpm run build        # Builds the JS/TS library
+pnpm run dev          # Launches the demo playground dev server
+pnpm test             # Runs tests
+```
+
+## Size
+
+The WASM payload is approximately 53MB uncompressed (~13MB gzipped). The library lazy-loads the WASM on first use.
+
+## Status
+
+End-to-end functional: `exiftool -ver` returns the version, EXIF metadata reads from a real JPEG fixture, and EXIF tag writes round-trip through `WExifTool.write()` → `WExifTool.read()`. The currently statically-linked XS set is `File::Glob` (more in `build/build-xs-extensions.sh`); ExifTool's read and most-of-write paths are pure Perl and work with what `libperl.a` already provides.
+
+Build is single-threaded by design (`usethreads=undef`, `usemultiplicity=undef`) and uses no dynamic loading (`usedl=undef`).
+
+**Known issue:** writing `EXIF:Copyright` (tag ID `0x8298`) silently corrupts the IFD entry — verified that the resulting file is unreadable by both wexiftool and native exiftool. All other EXIF tags tested round-trip correctly. Suspected signed-vs-unsigned 16-bit arithmetic on the tag ID inside ExifTool's WASM build. See `CHANGELOG.md` Known Issues.
+
+## Contributing
+
+Contributions welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) for setup, project layout, and PR guidelines. Notable changes are tracked in [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT
+
+This project bundles [ExifTool](https://exiftool.org/) by Phil Harvey, which is licensed under the Perl Artistic License / GPL. See [LICENSE-exiftool](LICENSE-exiftool) for details.

package/dist/cli.cjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";const f=require("fs"),u=require("path"),p=require("./wexiftool-Dt9AnMsh.cjs");async function d(){const t=process.argv.slice(2);t.length===0&&(w(),process.exit(1));const{flags:o,filePaths:i}=x(t);if(o.includes("-ver")||o.includes("-version")){const e=await p.WExifTool.create(),n=await e.exec([...o]);process.stdout.write(n.stdout+`
+`),n.stderr&&process.stderr.write(n.stderr+`
+`),e.destroy(),process.exit(n.exitCode)}i.length===0&&(console.error("Error: No input files specified."),process.exit(1));for(const e of i){const n=u.resolve(e);f.existsSync(n)||(console.error(`Error: File not found: ${e}`),process.exit(1)),f.statSync(n).isFile()||(console.error(`Error: Not a file: ${e}`),process.exit(1))}const c=o.some(e=>e.includes("=")&&e.startsWith("-")&&!e.startsWith("-if")),s=await p.WExifTool.create(),r=new Map(i.map(e=>[e,e])),a=[...o,...i];c&&!o.includes("-overwrite_original")&&!o.includes("-overwrite_original_in_place")&&a.unshift("-overwrite_original");const l=await s.exec(a,r,{writeBack:c});l.stdout&&process.stdout.write(l.stdout+`
+`),l.stderr&&process.stderr.write(l.stderr+`
+`),s.destroy(),process.exit(l.exitCode)}function x(t){const o=[],i=[],c=new Set(["-tagsFromFile","-tagsfromfile","-o","-out","-w","-textOut","-textout","-srcfile","-sep","-d","-dateformat","-dateFormat","-charset","-config"]);let s=0;for(;s<t.length;){const r=t[s];if(r==="--"){i.push(...t.slice(s+1));break}if(r.startsWith("-")){o.push(r);const a=r.toLowerCase().split("=")[0];c.has(a)&&!r.includes("=")&&s+1<t.length&&(s++,o.push(t[s]))}else i.push(r);s++}return{flags:o,filePaths:i}}function w(){console.log(`wexiftool - ExifTool running on WebAssembly
+
+Usage:
+  wexiftool [OPTIONS] FILE...
+
+Examples:
+  wexiftool photo.jpg                     Read all metadata
+  wexiftool -json photo.jpg               Output as JSON
+  wexiftool -Artist="Jane Doe" photo.jpg  Write a tag
+  wexiftool -G -s photo.jpg               Grouped, short output
+  wexiftool -ver                          Show ExifTool version
+
+All standard ExifTool options are supported.
+See https://exiftool.org/ for full documentation.`)}d().catch(t=>{console.error(t.message||t),process.exit(1)});

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export { }

package/dist/cli.es.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { existsSync as p, statSync as u } from "fs";
+import { resolve as d } from "path";
+import { W as f } from "./wexiftool-CUKoJisL.js";
+async function x() {
+  const t = process.argv.slice(2);
+  t.length === 0 && (h(), process.exit(1));
+  const { flags: o, filePaths: i } = w(t);
+  if (o.includes("-ver") || o.includes("-version")) {
+    const e = await f.create(), n = await e.exec([...o]);
+    process.stdout.write(n.stdout + `
+`), n.stderr && process.stderr.write(n.stderr + `
+`), e.destroy(), process.exit(n.exitCode);
+  }
+  i.length === 0 && (console.error("Error: No input files specified."), process.exit(1));
+  for (const e of i) {
+    const n = d(e);
+    p(n) || (console.error(`Error: File not found: ${e}`), process.exit(1)), u(n).isFile() || (console.error(`Error: Not a file: ${e}`), process.exit(1));
+  }
+  const a = o.some(
+    (e) => e.includes("=") && e.startsWith("-") && !e.startsWith("-if")
+  ), s = await f.create(), r = new Map(i.map((e) => [e, e])), c = [...o, ...i];
+  a && !o.includes("-overwrite_original") && !o.includes("-overwrite_original_in_place") && c.unshift("-overwrite_original");
+  const l = await s.exec(c, r, { writeBack: a });
+  l.stdout && process.stdout.write(l.stdout + `
+`), l.stderr && process.stderr.write(l.stderr + `
+`), s.destroy(), process.exit(l.exitCode);
+}
+function w(t) {
+  const o = [], i = [], a = /* @__PURE__ */ new Set([
+    "-tagsFromFile",
+    "-tagsfromfile",
+    "-o",
+    "-out",
+    "-w",
+    "-textOut",
+    "-textout",
+    "-srcfile",
+    "-sep",
+    "-d",
+    "-dateformat",
+    "-dateFormat",
+    "-charset",
+    "-config"
+  ]);
+  let s = 0;
+  for (; s < t.length; ) {
+    const r = t[s];
+    if (r === "--") {
+      i.push(...t.slice(s + 1));
+      break;
+    }
+    if (r.startsWith("-")) {
+      o.push(r);
+      const c = r.toLowerCase().split("=")[0];
+      a.has(c) && !r.includes("=") && s + 1 < t.length && (s++, o.push(t[s]));
+    } else
+      i.push(r);
+    s++;
+  }
+  return { flags: o, filePaths: i };
+}
+function h() {
+  console.log(`wexiftool - ExifTool running on WebAssembly
+
+Usage:
+  wexiftool [OPTIONS] FILE...
+
+Examples:
+  wexiftool photo.jpg                     Read all metadata
+  wexiftool -json photo.jpg               Output as JSON
+  wexiftool -Artist="Jane Doe" photo.jpg  Write a tag
+  wexiftool -G -s photo.jpg               Grouped, short output
+  wexiftool -ver                          Show ExifTool version
+
+All standard ExifTool options are supported.
+See https://exiftool.org/ for full documentation.`);
+}
+x().catch((t) => {
+  console.error(t.message || t), process.exit(1);
+});