exiftool-vendored 25.0.0 → 25.2.0

package/CHANGELOG.md

@@ -26,6 +26,25 @@ vendored versions of ExifTool match the version that they vendor.
 
 ## Version history
 
+### v25.2.0
+
+- 🌱/✨ ExifTool upgraded to [v12.82](https://exiftool.org/history.html#v12.82)
+
+- 📦 Add support for `NODE_DEBUG=exiftool-vendored`
+
+- 📦 Export `exiftoolPath()` so custom implementations can use it as a fallback
+  (or default, and provide their own fallback)
+
+### v25.1.0
+
+- ✨ Added `retain` field to [`ExifTool.deleteAllTags`](https://photostructure.github.io/exiftool-vendored.js/classes/ExifTool.html#deleteAllTags) to address [#178](https://github.com/photostructure/exiftool-vendored.js/issues/178)
+
+- 📦 Added jsdocs for many `Tag` interface types
+
+- 📦 Expose `GeolocationTags` and `isGeolocationTag()`
+
+- 📦 Add `FileTags.FileCreateDate` (only a thing on Windows)
+
 ### v25.0.0
 
 - 🌱/✨ ExifTool upgraded to [v12.80](https://exiftool.org/history.html#v12.80), which **adds support for reverse-geo lookups** and [several other geolocation features](https://exiftool.org/geolocation.html
@@ -34,7 +53,7 @@ vendored versions of ExifTool match the version that they vendor.
 
 - ✨ `ExifToolOptions.exiftoolPath` can now be an `async` function
 
-- ✨ Added [Geolocation](https://photostructure.github.io/exiftool-vendored.js/interfaces/Geolocation.html) Tags. These will only be available if `{geolocation: true}` is passed to the [ExifTool constructor](https://photostructure.github.io/exiftool-vendored.js/classes/ExifTool.html#constructor).
+- ✨ Added [Geolocation](https://photostructure.github.io/exiftool-vendored.js/interfaces/GeolocationTags.html) Tags. These will only be available if `{geolocation: true}` is passed to the [ExifTool constructor](https://photostructure.github.io/exiftool-vendored.js/classes/ExifTool.html#constructor).
 
 - 📦 Added support for `electron-forge`: [see the docs for details](https://photostructure.github.io/exiftool-vendored.js/#md:electron-forge-support).
 

package/README.md

@@ -43,6 +43,20 @@
 or
 
      npm install --save exiftool-vendored
+     
+### Debug logging
+
+If anything doesn't work, the first thing to try is enabling the logger.
+
+You can provide a [Logger implementation](https://photostructure.github.io/batch-cluster.js/interfaces/Logger.html) via [`ExifToolOptions.logger`](https://photostructure.github.io/exiftool-vendored.js/interfaces/ExifToolOptions.html#logger), or set the environment variable `NODE_DEBUG=exiftool-vendored`. [See the debuglog() documentation](https://nodejs.org/docs/latest/api/util.html#utildebuglogsection-callback) for more details.
+     
+### Regarding use within Electron
+
+Due to how different every Electron application setup is, and how new versions
+frequently have breaking changes, **do not ask for help by opening a github
+issue on this project.** 
+
+Please seek help via StackOverflow, the Electron discord, or other channels.
 
 ### Electron-builder support
 
@@ -52,17 +66,28 @@ Add the following pattern to `electron-builder.yml`'s `asarUnpack`:
 - "node_modules/exiftool-vendored.*/**/*"
 ```
 
+The default `exiftoolPath` implementation will detect `app.asar` in your `require`
+path and replace it with `app.asar.unpacked` automatically.
+
 ### Electron-forge support
 
 Version 25.0 of this library added experimental support for `electron-forge`:
 add the following element to your `ForgeConfig.packagerConfig.extraResource`
-string array, and things should "just work":
+string array, and things should "just work" **for the main process**.
 
 ```ts
 "./node_modules/exiftool-vendored." +
   (process.platform === "win32" ? "exe" : "pl")
 ```
 
+**If your main process forks any node subprocesses, `process.resourcesPath` _will
+not be set_ in those subprocesses, and the default `exiftoolPath` won't work.**
+
+If this is your case, you must provide a correct implementation of
+[ExifToolOptions.exiftoolPath](https://photostructure.github.io/exiftool-vendored.js/interfaces/ExifToolOptions.html#exiftoolPath),
+either by passing through `resourcesPath` via `process.env`, or some other
+method.
+
 ### Installation notes
 
 - `exiftool-vendored` provides an installation of ExifTool relevant for your

package/dist/DefaultExifToolOptions.d.ts

@@ -1,5 +1,7 @@
+import * as bc from "batch-cluster";
 import { ExifToolOptions } from "./ExifToolOptions";
 import { Omit } from "./Omit";
+export declare const ConsoleLogger: bc.Logger;
 /**
  * Default values for `ExifToolOptions`, except for `processFactory` (which is
  * created by the ExifTool constructor)

package/dist/DefaultExifToolOptions.js

@@ -23,8 +23,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultExifToolOptions = void 0;
+exports.DefaultExifToolOptions = exports.ConsoleLogger = void 0;
 const bc = __importStar(require("batch-cluster"));
+const node_util_1 = require("node:util");
 const CapturedAtTagNames_1 = require("./CapturedAtTagNames");
 const DefaultExiftoolArgs_1 = require("./DefaultExiftoolArgs");
 const DefaultMaxProcs_1 = require("./DefaultMaxProcs");
@@ -32,6 +33,18 @@ const ExiftoolPath_1 = require("./ExiftoolPath");
 const GeoTz_1 = require("./GeoTz");
 const IsWin32_1 = require("./IsWin32");
 const VersionTask_1 = require("./VersionTask");
+const _debuglog = (0, node_util_1.debuglog)("exiftool-vendored");
+function noop() { }
+exports.ConsoleLogger = {
+    trace: noop,
+    debug: _debuglog,
+    info: _debuglog,
+    warn: console.warn,
+    error: console.error,
+};
+function logger() {
+    return (0, node_util_1.debuglog)("exiftool-vendored").enabled ? exports.ConsoleLogger : bc.NoLogger;
+}
 /**
  * Default values for `ExifToolOptions`, except for `processFactory` (which is
  * created by the ExifTool constructor)
@@ -64,6 +77,7 @@ exports.DefaultExifToolOptions = Object.freeze({
     includeImageDataMD5: undefined,
     inferTimezoneFromDatestamps: false, // to retain prior behavior
     inferTimezoneFromDatestampTags: [...CapturedAtTagNames_1.CapturedAtTagNames],
+    logger,
     numericTags: [
         "*Duration*",
         "GPSAltitude",

package/dist/DefaultExifToolOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultExifToolOptions.js","sourceRoot":"","sources":["../src/DefaultExifToolOptions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAAmC;AACnC,6DAAyD;AACzD,+DAA2D;AAC3D,uDAAmD;AAEnD,iDAA6C;AAC7C,mCAA+B;AAC/B,uCAAmC;AAEnC,+CAA2C;AAE3C;;;GAGG;AACU,QAAA,sBAAsB,GAG/B,MAAM,CAAC,MAAM,CAAC;IAChB,GAAG,IAAI,EAAE,CAAC,mBAAmB,EAAE;IAC/B,QAAQ,EAAE,iCAAe;IACzB,kBAAkB,EAAE,GAAG;IACvB,kBAAkB,EAAE,KAAK;IACzB,yEAAyE;IACzE,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,IAAI;IAC1B,WAAW,EAAE,CAAC;IACd,YAAY,EAAZ,2BAAY;IACZ,YAAY,EAAE,yCAAmB;IACjC,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,CAAC,IAAA,iBAAO,GAAE;IACrB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,qBAAqB;IAClC,cAAc,EAAE,IAAI,yBAAW,EAAE,CAAC,OAAO;IACzC,yBAAyB,EAAE,KAAK;IAChC,kBAAkB,EAAE,kBAAkB;IAEtC,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,IAAI;IACxB,KAAK,EAAE,aAAK;IACZ,WAAW,EAAE,KAAK;IAClB,oBAAoB,EAAE,IAAI;IAC1B,aAAa,EAAE,KAAK;IACpB,mBAAmB,EAAE,SAAS;IAC9B,2BAA2B,EAAE,KAAK,EAAE,2BAA2B;IAC/D,8BAA8B,EAAE,CAAC,GAAG,uCAAkB,CAAC;IACvD,WAAW,EAAE;QACX,YAAY;QACZ,aAAa;QACb,aAAa;QACb,cAAc;QACd,aAAa;QACb,aAAa;KACd;IACD,MAAM,EAAE,KAAK;CACd,CAAC,CAAA"}
+{"version":3,"file":"DefaultExifToolOptions.js","sourceRoot":"","sources":["../src/DefaultExifToolOptions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAAmC;AACnC,yCAAoC;AACpC,6DAAyD;AACzD,+DAA2D;AAC3D,uDAAmD;AAEnD,iDAA6C;AAC7C,mCAA+B;AAC/B,uCAAmC;AAEnC,+CAA2C;AAE3C,MAAM,SAAS,GAAG,IAAA,oBAAQ,EAAC,mBAAmB,CAAC,CAAA;AAC/C,SAAS,IAAI,KAAI,CAAC;AAEL,QAAA,aAAa,GAAc;IACtC,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,KAAK,EAAE,OAAO,CAAC,KAAK;CACrB,CAAA;AAED,SAAS,MAAM;IACb,OAAO,IAAA,oBAAQ,EAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAa,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAA;AAC5E,CAAC;AAED;;;GAGG;AACU,QAAA,sBAAsB,GAG/B,MAAM,CAAC,MAAM,CAAC;IAChB,GAAG,IAAI,EAAE,CAAC,mBAAmB,EAAE;IAC/B,QAAQ,EAAE,iCAAe;IACzB,kBAAkB,EAAE,GAAG;IACvB,kBAAkB,EAAE,KAAK;IACzB,yEAAyE;IACzE,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,IAAI;IAC1B,WAAW,EAAE,CAAC;IACd,YAAY,EAAZ,2BAAY;IACZ,YAAY,EAAE,yCAAmB;IACjC,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,CAAC,IAAA,iBAAO,GAAE;IACrB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,qBAAqB;IAClC,cAAc,EAAE,IAAI,yBAAW,EAAE,CAAC,OAAO;IACzC,yBAAyB,EAAE,KAAK;IAChC,kBAAkB,EAAE,kBAAkB;IAEtC,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,IAAI;IACxB,KAAK,EAAE,aAAK;IACZ,WAAW,EAAE,KAAK;IAClB,oBAAoB,EAAE,IAAI;IAC1B,aAAa,EAAE,KAAK;IACpB,mBAAmB,EAAE,SAAS;IAC9B,2BAA2B,EAAE,KAAK,EAAE,2BAA2B;IAC/D,8BAA8B,EAAE,CAAC,GAAG,uCAAkB,CAAC;IACvD,MAAM;IACN,WAAW,EAAE;QACX,YAAY;QACZ,aAAa;QACb,aAAa;QACb,cAAc;QACd,aAAa;QACb,aAAa;KACd;IACD,MAAM,EAAE,KAAK;CACd,CAAC,CAAA"}

package/dist/ErrorsAndWarnings.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorsAndWarnings.js","sourceRoot":"","sources":["../src/ErrorsAndWarnings.ts"],"names":[],"mappings":";;;AAAA,mCAA8B;AAE9B,qCAAwC;AAiBxC,SAAgB,iBAAiB,CAC/B,IAAuB,EACvB,CAAwC;IAExC,OAAO;QACL,MAAM,EAAE,IAAA,YAAI,EAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,QAAQ,EAAE,IAAA,YAAI,EAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC9D,CAAA;AACH,CAAC;AARD,8CAQC"}
+{"version":3,"file":"ErrorsAndWarnings.js","sourceRoot":"","sources":["../src/ErrorsAndWarnings.ts"],"names":[],"mappings":";;;AAAA,mCAA8B;AAE9B,qCAAwC;AAkBxC,SAAgB,iBAAiB,CAC/B,IAAuB,EACvB,CAAwC;IAExC,OAAO;QACL,MAAM,EAAE,IAAA,YAAI,EAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,QAAQ,EAAE,IAAA,YAAI,EAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC9D,CAAA;AACH,CAAC;AARD,8CAQC"}

package/dist/ExifTool.d.ts

@@ -5,7 +5,7 @@ import { Defined, DefinedOrNullValued } from "./Defined";
 import { ErrorsAndWarnings } from "./ErrorsAndWarnings";
 import { ExifToolOptions } from "./ExifToolOptions";
 import { ExifToolTask } from "./ExifToolTask";
-import { GeolocationTags } from "./GeolocationTags";
+import { ExifToolVendoredTags } from "./ExifToolVendoredTags";
 import { ICCProfileTags } from "./ICCProfileTags";
 import { CollectionInfo, KeywordInfoStruct, KeywordStruct, MWGCollectionsTags, MWGKeywordTags } from "./MWGTags";
 import { Maybe } from "./Maybe";
@@ -16,7 +16,7 @@ import { ReadTaskOptions } from "./ReadTask";
 import { ResourceEvent } from "./ResourceEvent";
 import { ShortcutTags } from "./ShortcutTags";
 import { Struct } from "./Struct";
-import { APP12Tags, APP14Tags, APP1Tags, APP4Tags, APP5Tags, APP6Tags, CompositeTags, EXIFTags, ExifToolTags, FileTags, FlashPixTags, IPTCTags, JFIFTags, MPFTags, MakerNotesTags, MetaTags, PanasonicRawTags, PhotoshopTags, PrintIMTags, QuickTimeTags, RAFTags, RIFFTags, Tags, XMPTags } from "./Tags";
+import { APP12Tags, APP14Tags, APP1Tags, APP4Tags, APP5Tags, APP6Tags, CompositeTags, EXIFTags, ExifToolTags, FileTags, FlashPixTags, GeolocationTags, IPTCTags, JFIFTags, MPFTags, MakerNotesTags, MetaTags, PanasonicRawTags, PhotoshopTags, PrintIMTags, QuickTimeTags, RAFTags, RIFFTags, Tags, XMPTags } from "./Tags";
 import { Version } from "./Version";
 import { AdditionalWriteTags, ExpandedDateTags, MutableTags, StructAppendTags, WriteTags } from "./WriteTags";
 import { WriteTaskOptions, WriteTaskResult } from "./WriteTask";
@@ -29,23 +29,35 @@ export { ExifDate } from "./ExifDate";
 export { ExifDateTime } from "./ExifDateTime";
 export { ExifTime } from "./ExifTime";
 export { ExifToolTask } from "./ExifToolTask";
+export { exiftoolPath } from "./ExiftoolPath";
+export { isGeolocationTag } from "./GeolocationTags";
 export { parseJSON } from "./JSON";
 export { DefaultReadTaskOptions } from "./ReadTask";
 export { UnsetZone, UnsetZoneName, UnsetZoneOffsetMinutes, defaultVideosToUTC, offsetMinutesToZoneName, } from "./Timezones";
 export { DefaultWriteTaskOptions } from "./WriteTask";
-export type { APP12Tags, APP14Tags, APP1Tags, APP4Tags, APP5Tags, APP6Tags, AdditionalWriteTags, ApplicationRecordTags, CollectionInfo, CompositeTags, Defined, DefinedOrNullValued, EXIFTags, ErrorsAndWarnings, ExifToolOptions, ExifToolTags, ExpandedDateTags, FileTags, FlashPixTags, GeolocationTags, ICCProfileTags, IPTCTags, JFIFTags, Json, KeywordInfoStruct, KeywordStruct, Literal, MPFTags, MWGCollectionsTags, MWGKeywordTags, MakerNotesTags, Maybe, MetaTags, MutableTags, Omit, PanasonicRawTags, PhotoshopTags, PrintIMTags, QuickTimeTags, RAFTags, RIFFTags, RawTags, ReadTaskOptions, ResourceEvent, ShortcutTags, Struct, StructAppendTags, Tags, Version, WriteTags, WriteTaskOptions, WriteTaskResult, XMPTags, };
+export type { APP12Tags, APP14Tags, APP1Tags, APP4Tags, APP5Tags, APP6Tags, AdditionalWriteTags, ApplicationRecordTags, CollectionInfo, CompositeTags, Defined, DefinedOrNullValued, EXIFTags, ErrorsAndWarnings, ExifToolOptions, ExifToolTags, ExifToolVendoredTags, ExpandedDateTags, FileTags, FlashPixTags, GeolocationTags, ICCProfileTags, IPTCTags, JFIFTags, Json, KeywordInfoStruct, KeywordStruct, Literal, MPFTags, MWGCollectionsTags, MWGKeywordTags, MakerNotesTags, Maybe, MetaTags, MutableTags, Omit, PanasonicRawTags, PhotoshopTags, PrintIMTags, QuickTimeTags, RAFTags, RIFFTags, RawTags, ReadTaskOptions, ResourceEvent, ShortcutTags, Struct, StructAppendTags, Tags, Version, WriteTags, WriteTaskOptions, WriteTaskResult, XMPTags, };
 /**
  * Manages delegating calls to a cluster of ExifTool child processes.
  *
- * Instances should be shared: consider using the exported singleton instance
- * of this class, {@link exiftool}.
+ * **NOTE: Instances are expensive!**
+ *
+ * * use either the default exported singleton instance of this class,
+ *   {@link exiftool}, or your own singleton
+ *
+ * * make sure you await {@link ExifTool.end} when you're done with an instance
+ *   to clean up subprocesses
+ *
+ * * review the {@link ExifToolOptions} for configuration options--the default
+ *   values are conservative to avoid overwhelming your system.
+ *
+ * @see https://photostructure.github.io/exiftool-vendored.js/ for more documentation.
  */
 export declare class ExifTool {
     #private;
     readonly options: ExifToolOptions;
-    private readonly batchCluster;
-    readonly exiftoolPath: () => Promise<string>;
+    readonly batchCluster: bc.BatchCluster;
     constructor(options?: Partial<ExifToolOptions>);
+    readonly exiftoolPath: () => Promise<string>;
     /**
      * Register life cycle event listeners. Delegates to BatchProcess.
      */
@@ -120,8 +132,15 @@ export declare class ExifTool {
      * name `${FILENAME}_original`) will be retained. Note that some tags, like
      * stat information and image dimensions, are intrinsic to the file and will
      * continue to exist if you re-`read` the file.
+     *
+     * @param {string} file the file to strip of metadata
+     *
+     * @param {(keyof Tags | string)[]} opts.retain optional. If provided, this is
+     * a list of metadata keys to **not** delete.
      */
-    deleteAllTags(file: string): Promise<WriteTaskResult>;
+    deleteAllTags(file: string, opts?: {
+        retain?: (keyof Tags | string)[];
+    }): Promise<WriteTaskResult>;
     /**
      * Extract the low-resolution thumbnail in `path/to/image.jpg`
      * and write it to `path/to/thumbnail.jpg`.

package/dist/ExifTool.js

@@ -32,7 +32,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _ExifTool_checkForPerl;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.exiftool = exports.ExifTool = exports.DefaultWriteTaskOptions = exports.offsetMinutesToZoneName = exports.defaultVideosToUTC = exports.UnsetZoneOffsetMinutes = exports.UnsetZoneName = exports.UnsetZone = exports.DefaultReadTaskOptions = exports.parseJSON = exports.ExifToolTask = exports.ExifTime = exports.ExifDateTime = exports.ExifDate = exports.DefaultMaxProcs = exports.DefaultExiftoolArgs = exports.DefaultExifToolOptions = exports.CapturedAtTagNames = exports.BinaryField = void 0;
+exports.exiftool = exports.ExifTool = exports.DefaultWriteTaskOptions = exports.offsetMinutesToZoneName = exports.defaultVideosToUTC = exports.UnsetZoneOffsetMinutes = exports.UnsetZoneName = exports.UnsetZone = exports.DefaultReadTaskOptions = exports.parseJSON = exports.isGeolocationTag = exports.exiftoolPath = exports.ExifToolTask = exports.ExifTime = exports.ExifDateTime = exports.ExifDate = exports.DefaultMaxProcs = exports.DefaultExiftoolArgs = exports.DefaultExifToolOptions = exports.CapturedAtTagNames = exports.BinaryField = void 0;
 const bc = __importStar(require("batch-cluster"));
 const _cp = __importStar(require("node:child_process"));
 const _fs = __importStar(require("node:fs"));
@@ -43,6 +43,7 @@ const BinaryToBufferTask_1 = require("./BinaryToBufferTask");
 const DefaultExifToolOptions_1 = require("./DefaultExifToolOptions");
 const DeleteAllTagsArgs_1 = require("./DeleteAllTagsArgs");
 const ExifToolOptions_1 = require("./ExifToolOptions");
+const ExiftoolPath_1 = require("./ExiftoolPath");
 const IsWin32_1 = require("./IsWin32");
 const Lazy_1 = require("./Lazy");
 const Object_1 = require("./Object");
@@ -72,6 +73,10 @@ var ExifTime_1 = require("./ExifTime");
 Object.defineProperty(exports, "ExifTime", { enumerable: true, get: function () { return ExifTime_1.ExifTime; } });
 var ExifToolTask_1 = require("./ExifToolTask");
 Object.defineProperty(exports, "ExifToolTask", { enumerable: true, get: function () { return ExifToolTask_1.ExifToolTask; } });
+var ExiftoolPath_2 = require("./ExiftoolPath");
+Object.defineProperty(exports, "exiftoolPath", { enumerable: true, get: function () { return ExiftoolPath_2.exiftoolPath; } });
+var GeolocationTags_1 = require("./GeolocationTags");
+Object.defineProperty(exports, "isGeolocationTag", { enumerable: true, get: function () { return GeolocationTags_1.isGeolocationTag; } });
 var JSON_1 = require("./JSON");
 Object.defineProperty(exports, "parseJSON", { enumerable: true, get: function () { return JSON_1.parseJSON; } });
 var ReadTask_2 = require("./ReadTask");
@@ -84,6 +89,10 @@ Object.defineProperty(exports, "defaultVideosToUTC", { enumerable: true, get: fu
 Object.defineProperty(exports, "offsetMinutesToZoneName", { enumerable: true, get: function () { return Timezones_1.offsetMinutesToZoneName; } });
 var WriteTask_2 = require("./WriteTask");
 Object.defineProperty(exports, "DefaultWriteTaskOptions", { enumerable: true, get: function () { return WriteTask_2.DefaultWriteTaskOptions; } });
+/**
+ * Is the #!/usr/bin/perl shebang line in exiftool-vendored.pl going to fail? If
+ * so, we need to find `perl` ourselves, and ignore the shebang line.
+ */
 const _ignoreShebang = (0, Lazy_1.lazy)(() => !(0, IsWin32_1.isWin32)() && !_fs.existsSync("/usr/bin/perl"));
 const whichPerl = (0, Lazy_1.lazy)(async () => {
     const result = await (0, Which_1.which)("perl");
@@ -95,12 +104,29 @@ const whichPerl = (0, Lazy_1.lazy)(async () => {
 /**
  * Manages delegating calls to a cluster of ExifTool child processes.
  *
- * Instances should be shared: consider using the exported singleton instance
- * of this class, {@link exiftool}.
+ * **NOTE: Instances are expensive!**
+ *
+ * * use either the default exported singleton instance of this class,
+ *   {@link exiftool}, or your own singleton
+ *
+ * * make sure you await {@link ExifTool.end} when you're done with an instance
+ *   to clean up subprocesses
+ *
+ * * review the {@link ExifToolOptions} for configuration options--the default
+ *   values are conservative to avoid overwhelming your system.
+ *
+ * @see https://photostructure.github.io/exiftool-vendored.js/ for more documentation.
  */
 class ExifTool {
     constructor(options = {}) {
         var _a;
+        this.exiftoolPath = (0, Lazy_1.lazy)(async () => {
+            var _a;
+            const o = this.options;
+            return ((_a = (await ((0, Object_1.isFunction)(o.exiftoolPath)
+                ? o.exiftoolPath(this.options.logger())
+                : o.exiftoolPath))) !== null && _a !== void 0 ? _a : (0, ExiftoolPath_1.exiftoolPath)(this.options.logger()));
+        });
         /**
          * Register life cycle event listeners. Delegates to BatchProcess.
          */
@@ -109,6 +135,8 @@ class ExifTool {
          * Unregister life cycle event listeners. Delegates to BatchProcess.
          */
         this.off = (event, listener) => this.batchCluster.off(event, listener);
+        // calling whichPerl through this lazy() means we only do that task once per
+        // instance.
         _ExifTool_checkForPerl.set(this, (0, Lazy_1.lazy)(async () => {
             if (this.options.checkPerl) {
                 await whichPerl(); // < throws if perl is missing
@@ -139,7 +167,6 @@ class ExifTool {
             detached: false, // < no orphaned exiftool procs, please
             env,
         };
-        this.exiftoolPath = (0, Lazy_1.lazy)(async () => (0, Object_1.isFunction)(o.exiftoolPath) ? o.exiftoolPath(o.logger()) : o.exiftoolPath);
         const processFactory = async () => ignoreShebang
             ? _cp.spawn(await whichPerl(), [await this.exiftoolPath(), ...o.exiftoolArgs], spawnOpts)
             : _cp.spawn(await this.exiftoolPath(), o.exiftoolArgs, spawnOpts);
@@ -234,9 +261,19 @@ class ExifTool {
      * name `${FILENAME}_original`) will be retained. Note that some tags, like
      * stat information and image dimensions, are intrinsic to the file and will
      * continue to exist if you re-`read` the file.
+     *
+     * @param {string} file the file to strip of metadata
+     *
+     * @param {(keyof Tags | string)[]} opts.retain optional. If provided, this is
+     * a list of metadata keys to **not** delete.
      */
-    deleteAllTags(file) {
-        return this.write(file, {}, DeleteAllTagsArgs_1.DeleteAllTagsArgs);
+    deleteAllTags(file, opts) {
+        var _a;
+        const args = [...DeleteAllTagsArgs_1.DeleteAllTagsArgs];
+        for (const ea of (_a = opts === null || opts === void 0 ? void 0 : opts.retain) !== null && _a !== void 0 ? _a : []) {
+            args.push(`-${ea}<${ea}`);
+        }
+        return this.write(file, {}, args);
     }
     /**
      * Extract the low-resolution thumbnail in `path/to/image.jpg`

package/dist/ExifTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExifTool.js","sourceRoot":"","sources":["../src/ExifTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExifTool.js","sourceRoot":"","sources":["../src/ExifTool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAAmC;AACnC,wDAAyC;AACzC,6CAA8B;AAC9B,gEAAkC;AAElC,6CAA4C;AAC5C,iEAA6D;AAC7D,6DAAyD;AACzD,qEAAiE;AAEjE,2DAAuD;AAEvD,uDAA4E;AAG5E,iDAA6C;AAE7C,uCAAmC;AACnC,iCAA6B;AAS7B,qCAAqC;AAErC,iCAA6B;AAG7B,+CAA2C;AAC3C,yCAA4E;AAE5E,6DAAyD;AAEzD,qCAA0C;AA8B1C,+CAA2C;AAC3C,mCAA+B;AAQ/B,2CAA0E;AAE1E,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AACpB,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAC3B,mEAAiE;AAAxD,gIAAA,sBAAsB,OAAA;AAC/B,6DAA2D;AAAlD,0HAAA,mBAAmB,OAAA;AAC5B,qDAAmD;AAA1C,kHAAA,eAAe,OAAA;AACxB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,qDAAoD;AAA3C,mHAAA,gBAAgB,OAAA;AACzB,+BAAkC;AAAzB,iGAAA,SAAS,OAAA;AAClB,uCAAmD;AAA1C,kHAAA,sBAAsB,OAAA;AAC/B,yCAMoB;AALlB,sGAAA,SAAS,OAAA;AACT,0GAAA,aAAa,OAAA;AACb,mHAAA,sBAAsB,OAAA;AACtB,+GAAA,kBAAkB,OAAA;AAClB,oHAAA,uBAAuB,OAAA;AAEzB,yCAAqD;AAA5C,oHAAA,uBAAuB,OAAA;AA0DhC;;;GAGG;AACH,MAAM,cAAc,GAAG,IAAA,WAAI,EACzB,GAAG,EAAE,CAAC,CAAC,IAAA,iBAAO,GAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CACrD,CAAA;AAED,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,KAAK,IAAI,EAAE;IAChC,MAAM,MAAM,GAAG,MAAM,IAAA,aAAK,EAAC,MAAM,CAAC,CAAA;IAClC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAa,QAAQ;IAInB,YAAY,UAAoC,EAAE;;QAwCzC,iBAAY,GAAG,IAAA,WAAI,EAAC,KAAK,IAAI,EAAE;;YACtC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAA;YACtB,OAAO,CACL,MAAA,CAAC,MAAM,CAAC,IAAA,mBAAU,EAAC,CAAC,CAAC,YAAY,CAAC;gBAChC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,mCAAI,IAAA,2BAAY,EAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAC5D,CAAA;QACH,CAAC,CAAC,CAAA;QAEF;;WAEG;QACM,OAAE,GAA0B,CAAC,KAAU,EAAE,QAAa,EAAE,EAAE,CACjE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAEvC;;WAEG;QACM,QAAG,GAA2B,CAAC,KAAU,EAAE,QAAa,EAAE,EAAE,CACnE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAkQxC,4EAA4E;QAC5E,YAAY;QACH,iCAAgB,IAAA,WAAI,EAAC,KAAK,IAAI,EAAE;YACvC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,MAAM,SAAS,EAAE,CAAA,CAAC,8BAA8B;YAClD,CAAC;QACH,CAAC,CAAC;QAEF;;;;;WAKG;UAPD;QAlUA,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAA;QACH,CAAC;QACD,MAAM,CAAC,GAAG,IAAA,yCAAuB,EAAC;YAChC,GAAG,+CAAsB;YACzB,GAAG,OAAO;SACX,CAAC,CAAA;QAEF,MAAM,aAAa,GAAG,MAAA,CAAC,CAAC,aAAa,mCAAI,cAAc,EAAE,CAAA;QAEzD,MAAM,GAAG,GAAsB,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAA;QAC9D,IAAI,IAAA,iBAAQ,EAAC,sBAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAA,cAAK,EAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,aAAa,GAAG,sBAAO,CAAC,GAAG,CAAC,aAAa,CAAA;QAC/C,CAAC;QACD,MAAM,SAAS,GAAqB;YAClC,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,KAAK,EAAE,uCAAuC;YACxD,GAAG;SACJ,CAAA;QACD,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE,CAChC,aAAa;YACX,CAAC,CAAC,GAAG,CAAC,KAAK,CACP,MAAM,SAAS,EAAE,EACjB,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,EAC9C,SAAS,CACV;YACH,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;QAErE,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,CAAC;YACJ,aAAa;YACb,cAAc;SACf,CAAA;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvD,CAAC;IAuBD;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,yBAAW,EAAE,CAAC,CAAA;IAClD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,IAAY,EACZ,eAAyB,CAAC,OAAO,CAAC,EAClC,OAAkC;QAElC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAC3B,mBAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;YACjB,YAAY;YACZ,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,OAAO,EAAE,GAAG,+BAAoB,CAAC;YAC9C,GAAG,OAAO;SACX,CAAC,CACI,CAAA,CAAC,mEAAmE;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,IAAY,EAAE,OAAiB,EAAE;QACvC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,yBAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CACH,IAAY,EACZ,IAAe,EACf,IAAe,EACf,OAA0B;QAE1B,wEAAwE;QACxE,yBAAyB;QACzB,MAAM,SAAS,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAC,WAAW,CACrB,GAAG,EAAE,CACH,qBAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;YAC9B,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC/B,GAAG,OAAO;SACX,CAAC,EACJ,SAAS,CACV,CAAA;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CACX,IAAY,EACZ,IAA2C;;QAE3C,MAAM,IAAI,GAAG,CAAC,GAAG,qCAAiB,CAAC,CAAA;QACnC,KAAK,MAAM,EAAE,IAAI,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,mCAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;IAED;;;;;;;;OAQG;IACH,gBAAgB,CAAC,SAAiB,EAAE,aAAqB;QACvD,OAAO,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;IAC1E,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,SAAiB,EAAE,WAAmB;QACnD,OAAO,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,SAAiB,EAAE,UAAkB;QACrD,OAAO,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;IACnE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,GAAW,EACX,IAAY;QAEZ,2EAA2E;QAC3E,kCAAkC;QAClC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAC7C,2CAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAC7C,CAAA;QACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,wBAAwB,CAC5B,OAAmB,EACnB,SAAiB;QAEjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CACzC,uCAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAC3C,CAAA;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAA;QACf,CAAC;aAAM,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;YACnC,MAAM,MAAM,CAAA;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,6CAA6C,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CACvE,CAAA;QACH,CAAC;IACH,CAAC;IACD;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CACZ,SAAiB,EACjB,UAAkB,EAClB,oBAAoB,GAAG,KAAK;QAE5B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAC3B,uCAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,oBAAoB,CAAC,CACpE,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,UAAU,GAAG,IAAI;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,CAAA;IAClD,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAChC,CAAC;IAUD;;;;;OAKG;IACH,WAAW,CAAI,IAA2B,EAAE,SAAS,GAAG,IAAI;QAC1D,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE;YACnB,MAAM,uBAAA,IAAI,8BAAc,MAAlB,IAAI,CAAgB,CAAA;YAC1B,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;QAC9C,CAAC,CAAA;QACD,OAAO,SAAS,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACrE,CAAC;IAED;;;;;OAKG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,cAAc,CAAA;IACzC,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,UAAU,GAAG,IAAI;QACnC,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAC1D,CAAC;CACF;AApYD,4BAoYC;;AAED;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA"}

package/dist/ExifToolOptions.d.ts

@@ -56,8 +56,10 @@ export interface ExifToolOptions extends bc.BatchClusterOptions, bc.BatchProcess
      * Allows for non-standard paths to ExifTool. Defaults to the perl or
      * windows binaries provided by `exiftool-vendored.pl` or
      * `exiftool-vendored.exe`.
+     *
+     * This must be the full path to `exiftool`, not just the directory.
      */
-    exiftoolPath: string | ((logger?: bc.Logger) => string | Promise<string>);
+    exiftoolPath: string | Promise<string> | ((logger?: bc.Logger) => string | Promise<string>);
     /**
      * Args passed to exiftool on launch.
      */
@@ -167,7 +169,9 @@ export interface ExifToolOptions extends bc.BatchClusterOptions, bc.BatchProcess
      */
     ignoreZeroZeroLatLon: boolean;
     /**
-     * Override the default geo-to-timezone lookup service. Note that if {@link geolocation} is enabled, we'll try to use {@
+     * Override the default geo-to-timezone lookup service. Note that if
+       {@link geolocation} is enabled, we'll use
+       {@link Tags.GeolocationTimeZone} if it's not blank.
      *
      * This defaults to `@photostructure/tz-lookup`, but if you have the
      * resources, consider using `geo-tz` for more accurate results.

package/dist/ExifToolOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExifToolOptions.js","sourceRoot":"","sources":["../src/ExifToolOptions.ts"],"names":[],"mappings":";;;AAgPA,SAAgB,uBAAuB,CAErC,OAAU;IACV,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,IAAI,OAAO,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;QACzE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IACrE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAPD,0DAOC"}
+{"version":3,"file":"ExifToolOptions.js","sourceRoot":"","sources":["../src/ExifToolOptions.ts"],"names":[],"mappings":";;;AAuPA,SAAgB,uBAAuB,CAErC,OAAU;IACV,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,IAAI,OAAO,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;QACzE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IACrE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAPD,0DAOC"}

package/dist/ExifToolTags.d.ts

@@ -0,0 +1,7 @@
+import { ExifToolTags } from "./Tags";
+export declare const ExifToolTagNames: (keyof ExifToolTags)[];
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+export declare function isExifToolTag(name: string): name is keyof ExifToolTags;

package/dist/ExifToolTags.js

@@ -0,0 +1,20 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExifToolTag = exports.ExifToolTagNames = void 0;
+const Object_1 = require("./Object");
+exports.ExifToolTagNames = (0, Object_1.keysOf)({
+    ExifToolVersion: true,
+    SourceFile: true,
+    Error: true,
+    Warning: true,
+});
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+function isExifToolTag(name) {
+    return exports.ExifToolTagNames.includes(name);
+}
+exports.isExifToolTag = isExifToolTag;
+//# sourceMappingURL=ExifToolTags.js.map

package/dist/ExifToolTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExifToolTags.js","sourceRoot":"","sources":["../src/ExifToolTags.ts"],"names":[],"mappings":";AAAA,uDAAuD;;;AAEvD,qCAAiC;AAGpB,QAAA,gBAAgB,GAAG,IAAA,eAAM,EAAe;IACnD,eAAe,EAAE,IAAI;IACrB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;CACd,CAAC,CAAA;AAEF;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,wBAAgB,CAAC,QAAQ,CAAC,IAAW,CAAC,CAAA;AAC/C,CAAC;AAFD,sCAEC"}

package/dist/ExifToolVendoredTags.d.ts

@@ -0,0 +1,23 @@
+import { ErrorsAndWarnings } from "./ErrorsAndWarnings";
+/**
+ * This tags are added to {@link Tags} from this library.
+ */
+export interface ExifToolVendoredTags extends ErrorsAndWarnings {
+    /**
+     * Either an offset, like `UTC-7`, or an actual IANA timezone, like
+     * `America/Los_Angeles`.
+     *
+     * This will be missing if we can't intuit a timezone from the metadata.
+     */
+    tz?: string;
+    /**
+     * Description of where and how `tz` was extracted
+     */
+    tzSource?: string;
+}
+export declare const ExifToolVendoredTagNames: (keyof ExifToolVendoredTags)[];
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+export declare function isExifToolVendoredTag(name: string): name is keyof ExifToolVendoredTags;

package/dist/ExifToolVendoredTags.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExifToolVendoredTag = exports.ExifToolVendoredTagNames = void 0;
+const Object_1 = require("./Object");
+exports.ExifToolVendoredTagNames = (0, Object_1.keysOf)({
+    tz: true,
+    tzSource: true,
+    errors: true,
+    warnings: true,
+});
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+function isExifToolVendoredTag(name) {
+    return exports.ExifToolVendoredTagNames.includes(name);
+}
+exports.isExifToolVendoredTag = isExifToolVendoredTag;
+//# sourceMappingURL=ExifToolVendoredTags.js.map

package/dist/ExifToolVendoredTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExifToolVendoredTags.js","sourceRoot":"","sources":["../src/ExifToolVendoredTags.ts"],"names":[],"mappings":";;;AACA,qCAAiC;AAoBpB,QAAA,wBAAwB,GAAG,IAAA,eAAM,EAAuB;IACnE,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;CACf,CAAC,CAAA;AAEF;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,IAAY;IAEZ,OAAO,gCAAwB,CAAC,QAAQ,CAAC,IAAW,CAAC,CAAA;AACvD,CAAC;AAJD,sDAIC"}

package/dist/ExiftoolPath.d.ts

@@ -1,2 +1,28 @@
 import { Logger } from "batch-cluster";
+/**
+ * This implementation relies on the fact that both `exiftool-vendored.pl` and
+ * `exiftool-vendored.exe` both export the path to their respective exiftool
+ * binary.
+ *
+ * When running in node, this method should suffice.
+ *
+ * When running in Electron, all bets are off, due to ASAR packaging and other
+ * nonsense. As perl can't run from within an ASAR archive, `electron-builder`
+ * must be configured to `asarUnpack`
+ * "**/node_modules/exiftool-vendored.{pl,exe}/". See
+ * <https://www.electron.build/generated/platformspecificbuildoptions#configuration-asarUnpack>
+ * for details.
+ *
+ * If you're using `electron-forge`, add something like the following to your
+ * ForgeConfig.packagerConfig.extraResource array: `fs.join(".", "node_modules",
+ * "exiftool-vendored." + (isWin ? "exe" : "pl"))` but then you must specify a
+ * custom exiftoolPath in your options hash, as subprocesses that use
+ * ELECTRON_RUN_AS_NODE will no longer have process.resourcesPath set.
+ *
+ * If none of the above work for your use case, you can provide your own
+ * `exiftoolPath` implementation to your instance of ExifTool
+ *
+ * @return the path to the exiftool binary, preferring the vendored version in
+ * node_modules.
+ */
 export declare function exiftoolPath(logger?: Logger): Promise<string>;

package/dist/ExiftoolPath.js

@@ -22,14 +22,10 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exiftoolPath = void 0;
 const _fs = __importStar(require("node:fs"));
 const _path = __importStar(require("node:path"));
-const node_process_1 = __importDefault(require("node:process"));
 const IsWin32_1 = require("./IsWin32");
 const Which_1 = require("./Which");
 function vendorPackage() {
@@ -45,27 +41,48 @@ function tryRequire({ prefix = "", logger, } = {}) {
         return;
     }
 }
+/**
+ * This implementation relies on the fact that both `exiftool-vendored.pl` and
+ * `exiftool-vendored.exe` both export the path to their respective exiftool
+ * binary.
+ *
+ * When running in node, this method should suffice.
+ *
+ * When running in Electron, all bets are off, due to ASAR packaging and other
+ * nonsense. As perl can't run from within an ASAR archive, `electron-builder`
+ * must be configured to `asarUnpack`
+ * "**/node_modules/exiftool-vendored.{pl,exe}/". See
+ * <https://www.electron.build/generated/platformspecificbuildoptions#configuration-asarUnpack>
+ * for details.
+ *
+ * If you're using `electron-forge`, add something like the following to your
+ * ForgeConfig.packagerConfig.extraResource array: `fs.join(".", "node_modules",
+ * "exiftool-vendored." + (isWin ? "exe" : "pl"))` but then you must specify a
+ * custom exiftoolPath in your options hash, as subprocesses that use
+ * ELECTRON_RUN_AS_NODE will no longer have process.resourcesPath set.
+ *
+ * If none of the above work for your use case, you can provide your own
+ * `exiftoolPath` implementation to your instance of ExifTool
+ *
+ * @return the path to the exiftool binary, preferring the vendored version in
+ * node_modules.
+ */
 async function exiftoolPath(logger) {
     const path = tryRequire({ prefix: "", logger });
     // This s/app.asar/app.asar.unpacked/ path switch adds support for Electron
-    // apps that are ASAR-packed (like by electron-builder). This is necessary because
-    // Note that we can't reliably automatically detect that we're running in
-    // electron because child processes that are spawned by the main process will
-    // most likely need the ELECTRON_RUN_AS_NODE environment variable set, which
-    // will unset the process.versions.electron field.
-    const fixedPath = path === null || path === void 0 ? void 0 : path.split(_path.sep).map((ea) => (ea === "app.asar" ? "app.asar.unpacked" : ea)).join(_path.sep);
-    // Note also, that we must check for the fixedPath first, because Electron's
-    // ASAR shenanigans will make existsSync return true even for asar-packed
-    // resources.
-    if (fixedPath != null && _fs.existsSync(fixedPath)) {
-        return fixedPath;
+    // apps whose modules are ASAR-packed (like by electron-builder).
+    const asarUnpackedPath = path === null || path === void 0 ? void 0 : path.split(_path.sep).map((ea) => (ea === "app.asar" ? "app.asar.unpacked" : ea)).join(_path.sep);
+    // NOTE: we must check for the fixedPath FIRST, because Electron's ASAR
+    // shenanigans will make existsSync return true for asar-packed resources
+    if (asarUnpackedPath != null && _fs.existsSync(asarUnpackedPath)) {
+        return asarUnpackedPath;
     }
     if (path != null && _fs.existsSync(path)) {
         return path;
     }
     logger === null || logger === void 0 ? void 0 : logger.warn("Failed to find exiftool via " + vendorPackage());
-    // Set by electron-forge:
-    const electronResourcePath = node_process_1.default.resourcesPath;
+    // process.resourcesPath is set by electron-forge:
+    const electronResourcePath = process.resourcesPath;
     if (electronResourcePath != null) {
         const forgePath = _path.join(electronResourcePath, vendorPackage(), "bin", "exiftool" + ((0, IsWin32_1.isWin32)() ? ".exe" : ""));
         if (_fs.existsSync(forgePath)) {

package/dist/ExiftoolPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExiftoolPath.js","sourceRoot":"","sources":["../src/ExiftoolPath.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6CAA8B;AAC9B,iDAAkC;AAClC,gEAAkC;AAClC,uCAAmC;AAEnC,mCAA+B;AAE/B,SAAS,aAAa;IACpB,OAAO,oBAAoB,GAAG,CAAC,IAAA,iBAAO,GAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,UAAU,CAAC,EAClB,MAAM,GAAG,EAAE,EACX,MAAM,MACyC,EAAE;IACjD,MAAM,EAAE,GAAG,MAAM,GAAG,aAAa,EAAE,CAAA;IACnC,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,EAAE,CAAC,CAAA;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,EAAE,GAAG,aAAa,EAAE,KAAK,CAAC,CAAA;QACvC,OAAM;IACR,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,MAAe;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,2EAA2E;IAC3E,kFAAkF;IAClF,yEAAyE;IACzE,6EAA6E;IAC7E,4EAA4E;IAC5E,kDAAkD;IAClD,MAAM,SAAS,GAAG,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAClB,KAAK,CAAC,KAAK,CAAC,GAAG,EAChB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAElB,4EAA4E;IAC5E,yEAAyE;IACzE,aAAa;IACb,IAAI,SAAS,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,8BAA8B,GAAG,aAAa,EAAE,CAAC,CAAA;IAE9D,yBAAyB;IACzB,MAAM,oBAAoB,GAAI,sBAAe,CAAC,aAAa,CAAA;IAC3D,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAC1B,oBAAoB,EACpB,aAAa,EAAE,EACf,KAAK,EACL,UAAU,GAAG,CAAC,IAAA,iBAAO,GAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CACvC,CAAA;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CACV,4DAA4D,GAAG,SAAS,CACzE,CAAA;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,QAAQ,GAAG,MAAM,IAAA,aAAK,EAAC,UAAU,CAAC,CAAA;IACxC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;AACH,CAAC;AApDD,oCAoDC"}
+{"version":3,"file":"ExiftoolPath.js","sourceRoot":"","sources":["../src/ExiftoolPath.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6CAA8B;AAC9B,iDAAkC;AAClC,uCAAmC;AAEnC,mCAA+B;AAE/B,SAAS,aAAa;IACpB,OAAO,oBAAoB,GAAG,CAAC,IAAA,iBAAO,GAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,UAAU,CAAC,EAClB,MAAM,GAAG,EAAE,EACX,MAAM,MACyC,EAAE;IACjD,MAAM,EAAE,GAAG,MAAM,GAAG,aAAa,EAAE,CAAA;IACnC,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,EAAE,CAAC,CAAA;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,EAAE,GAAG,aAAa,EAAE,KAAK,CAAC,CAAA;QACvC,OAAM;IACR,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,YAAY,CAAC,MAAe;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,2EAA2E;IAC3E,iEAAiE;IAEjE,MAAM,gBAAgB,GAAG,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CACzB,KAAK,CAAC,KAAK,CAAC,GAAG,EAChB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAElB,uEAAuE;IACvE,yEAAyE;IACzE,IAAI,gBAAgB,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjE,OAAO,gBAAgB,CAAA;IACzB,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,8BAA8B,GAAG,aAAa,EAAE,CAAC,CAAA;IAE9D,kDAAkD;IAClD,MAAM,oBAAoB,GAAI,OAAe,CAAC,aAAa,CAAA;IAC3D,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAC1B,oBAAoB,EACpB,aAAa,EAAE,EACf,KAAK,EACL,UAAU,GAAG,CAAC,IAAA,iBAAO,GAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CACvC,CAAA;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CACV,4DAA4D,GAAG,SAAS,CACzE,CAAA;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,QAAQ,GAAG,MAAM,IAAA,aAAK,EAAC,UAAU,CAAC,CAAA;IACxC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;AACH,CAAC;AAhDD,oCAgDC"}

package/dist/FileTags.d.ts

@@ -0,0 +1,6 @@
+import { FileTags } from "./Tags";
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+export declare function isFileTag(name: string): name is keyof FileTags;

package/dist/FileTags.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFileTag = void 0;
+const Object_1 = require("./Object");
+const FileTagNames = (0, Object_1.keysOf)({
+    BMPVersion: true,
+    BitsPerSample: true,
+    ColorComponents: true,
+    CurrentIPTCDigest: true,
+    Directory: true,
+    EncodingProcess: true,
+    ExifByteOrder: true,
+    FileAccessDate: true,
+    FileCreateDate: true,
+    FileInodeChangeDate: true,
+    FileModifyDate: true,
+    FileName: true,
+    FilePermissions: true,
+    FileSize: true,
+    FileType: true,
+    FileTypeExtension: true,
+    ImageDataMD5: true,
+    ImageHeight: true,
+    ImageWidth: true,
+    MIMEType: true,
+    NumColors: true,
+    NumImportantColors: true,
+    PixelsPerMeterX: true,
+    PixelsPerMeterY: true,
+    Planes: true,
+    YCbCrSubSampling: true,
+});
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+function isFileTag(name) {
+    return FileTagNames.includes(name);
+}
+exports.isFileTag = isFileTag;
+//# sourceMappingURL=FileTags.js.map

package/dist/FileTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTags.js","sourceRoot":"","sources":["../src/FileTags.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAGjC,MAAM,YAAY,GAAG,IAAA,eAAM,EAAW;IACpC,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;IACvB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,cAAc,EAAE,IAAI;IACpB,QAAQ,EAAE,IAAI;IACd,eAAe,EAAE,IAAI;IACrB,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE,IAAI;IACZ,gBAAgB,EAAE,IAAI;CACvB,CAAC,CAAA;AAEF;;;GAGG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAW,CAAC,CAAA;AAC3C,CAAC;AAFD,8BAEC"}

package/dist/GeolocationTags.d.ts

@@ -1,3 +1,9 @@
+export declare const GeolocationTagNames: (keyof GeolocationTags)[];
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+export declare function isGeolocationTag(name: string): name is keyof GeolocationTags;
 /**
  * These tags are only available if {@link ExifToolOptions.geolocation} is true and the file
  * has valid GPS location data.

package/dist/GeolocationTags.js

@@ -1,3 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGeolocationTag = exports.GeolocationTagNames = void 0;
+const Object_1 = require("./Object");
+exports.GeolocationTagNames = (0, Object_1.keysOf)({
+    GeolocationBearing: true,
+    GeolocationCity: true,
+    GeolocationCountry: true,
+    GeolocationCountryCode: true,
+    GeolocationDistance: true,
+    GeolocationFeatureCode: true,
+    GeolocationPopulation: true,
+    GeolocationPosition: true,
+    GeolocationRegion: true,
+    GeolocationSubregion: true,
+    GeolocationTimeZone: true,
+});
+/**
+ * Is the given tag name intrinsic to the content of a given file? In other
+ * words, is it not an artifact of a metadata field?
+ */
+function isGeolocationTag(name) {
+    return exports.GeolocationTagNames.includes(name);
+}
+exports.isGeolocationTag = isGeolocationTag;
 //# sourceMappingURL=GeolocationTags.js.map

package/dist/GeolocationTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeolocationTags.js","sourceRoot":"","sources":["../src/GeolocationTags.ts"],"names":[],"mappings":""}
+{"version":3,"file":"GeolocationTags.js","sourceRoot":"","sources":["../src/GeolocationTags.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAEpB,QAAA,mBAAmB,GAAG,IAAA,eAAM,EAAkB;IACzD,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,IAAI;IAC5B,qBAAqB,EAAE,IAAI;IAC3B,mBAAmB,EAAE,IAAI;IACzB,iBAAiB,EAAE,IAAI;IACvB,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,IAAI;CAC1B,CAAC,CAAA;AAEF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,2BAAmB,CAAC,QAAQ,CAAC,IAAW,CAAC,CAAA;AAClD,CAAC;AAFD,4CAEC"}

package/dist/Object.d.ts

@@ -6,3 +6,13 @@ export type Unpick<T, U> = {
     [P in keyof T]: P extends U ? never : T[P];
 };
 export declare function omit<T extends Record<string, any>, S extends string>(t: T, ...keysToOmit: S[]): Unpick<T, S>;
+/**
+ * Provides a type-safe exhaustive array of keys for a given interface.
+ *
+ * Unfortunately, `satisfies (keyof T)[]` doesn't ensure all keys are present,
+ * and doesn't guard against duplicates. This function does.
+ *
+ * @param t - The interface to extract keys from. This is a Record of keys to
+ * `true`, which ensures the returned key array is unique.
+ */
+export declare function keysOf<T>(t: Required<Record<keyof T, true>>): (keyof T)[];

package/dist/Object.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.omit = exports.fromEntries = exports.isFunction = exports.keys = void 0;
+exports.keysOf = exports.omit = exports.fromEntries = exports.isFunction = exports.keys = void 0;
 // eslint-disable-next-line @typescript-eslint/ban-types
 function keys(o) {
     return o == null
@@ -40,4 +40,17 @@ function omit(t, ...keysToOmit) {
     return result;
 }
 exports.omit = omit;
+/**
+ * Provides a type-safe exhaustive array of keys for a given interface.
+ *
+ * Unfortunately, `satisfies (keyof T)[]` doesn't ensure all keys are present,
+ * and doesn't guard against duplicates. This function does.
+ *
+ * @param t - The interface to extract keys from. This is a Record of keys to
+ * `true`, which ensures the returned key array is unique.
+ */
+function keysOf(t) {
+    return Object.keys(t);
+}
+exports.keysOf = keysOf;
 //# sourceMappingURL=Object.js.map

package/dist/Object.js.map

@@ -1 +1 @@
-{"version":3,"file":"Object.js","sourceRoot":"","sources":["../src/Object.ts"],"names":[],"mappings":";;;AAEA,wDAAwD;AACxD,SAAgB,IAAI,CAA+C,CAAI;IACrE,OAAO,CAAC,IAAI,IAAI;QACd,CAAC,CAAC,EAAE;QACJ,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC5B,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAC9B,CAAA;AACf,CAAC;AAND,oBAMC;AAED,SAAgB,UAAU,CAAC,GAAQ;IACjC,OAAO,OAAO,GAAG,KAAK,UAAU,CAAA;AAClC,CAAC;AAFD,gCAEC;AAED,SAAgB,WAAW,CACzB,GAAkC,EAClC,GAAS;IAET,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAA;IAC/C,4DAA4D;IAC5D,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,EAAE,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;YACjB,qBAAqB;YACrB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,GAAG,GAAG,EAAE,CAAA;gBACrC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAjBD,kCAiBC;AAID,SAAgB,IAAI,CAClB,CAAI,EACJ,GAAG,UAAe;IAElB,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,EAAS,CAAA;IAC/B,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;IACvB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,EAAE,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAVD,oBAUC"}
+{"version":3,"file":"Object.js","sourceRoot":"","sources":["../src/Object.ts"],"names":[],"mappings":";;;AAEA,wDAAwD;AACxD,SAAgB,IAAI,CAA+C,CAAI;IACrE,OAAO,CAAC,IAAI,IAAI;QACd,CAAC,CAAC,EAAE;QACJ,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC5B,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAC9B,CAAA;AACf,CAAC;AAND,oBAMC;AAED,SAAgB,UAAU,CAAC,GAAQ;IACjC,OAAO,OAAO,GAAG,KAAK,UAAU,CAAA;AAClC,CAAC;AAFD,gCAEC;AAED,SAAgB,WAAW,CACzB,GAAkC,EAClC,GAAS;IAET,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAA;IAC/C,4DAA4D;IAC5D,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,EAAE,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;YACjB,qBAAqB;YACrB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,GAAG,GAAG,EAAE,CAAA;gBACrC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAjBD,kCAiBC;AAID,SAAgB,IAAI,CAClB,CAAI,EACJ,GAAG,UAAe;IAElB,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,EAAS,CAAA;IAC/B,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;IACvB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,EAAE,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAVD,oBAUC;AAED;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAI,CAAkC;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAA;AAC9B,CAAC;AAFD,wBAEC"}

package/dist/Tags.d.ts

@@ -1,24 +1,32 @@
 import { ApplicationRecordTags } from "./ApplicationRecordTags";
 import { BinaryField } from "./BinaryField";
-import { ErrorsAndWarnings } from "./ErrorsAndWarnings";
 import { ExifDate } from "./ExifDate";
 import { ExifDateTime } from "./ExifDateTime";
 import { ExifTime } from "./ExifTime";
-import { GeolocationTags } from "./GeolocationTags";
+import { ExifToolVendoredTags } from "./ExifToolVendoredTags";
 import { ICCProfileTags } from "./ICCProfileTags";
 import { ImageDataHashTag } from "./ImageDataHashTag";
 import { MWGCollectionsTags, MWGKeywordTags } from "./MWGTags";
 import { ResourceEvent } from "./ResourceEvent";
 import { Struct } from "./Struct";
 import { Version } from "./Version";
+/**
+ * These tags are added by `exiftool`.
+ */
 export interface ExifToolTags {
     /** ☆☆☆☆ ✔ Example: "File is empty" */
     Error?: string;
-    /** ★★★★ ✔ Example: 12.8 */
+    /** ★★★★ ✔ Example: 12.82 */
     ExifToolVersion?: number;
+    /** ☆☆☆☆   Example: "path/to/file.jpg" */
+    SourceFile?: string;
     /** ☆☆☆☆ ✔ Example: "Unrecognized IPTC record 0 (ignored)" */
     Warning?: string;
 }
+/**
+ * These tags are not metadata fields, but are intrinsic to the content of a
+ * given file. ExifTool can't write to many of these tags.
+ */
 export interface FileTags {
     /** ☆☆☆☆ ✔ Example: "Windows V3" */
     BMPVersion?: string;
@@ -34,9 +42,11 @@ export interface FileTags {
     EncodingProcess?: string;
     /** ★★★★ ✔ Example: "Little-endian (Intel, II)" */
     ExifByteOrder?: string;
-    /** ★★★★ ✔ Example: "2024:03:26 15:28:17-07:00" */
+    /** ★★★★ ✔ Example: "2024:04:11 15:42:05-07:00" */
     FileAccessDate?: ExifDateTime | string;
-    /** ★★★★ ✔ Example: "2024:03:20 21:17:00-07:00" */
+    /** ☆☆☆☆   Example:  */
+    FileCreateDate?: ExifDateTime | string;
+    /** ★★★★ ✔ Example: "2024:04:09 21:42:21-07:00" */
     FileInodeChangeDate?: ExifDateTime | string;
     /** ★★★★ ✔ Example: "2023:07:19 21:21:02-07:00" */
     FileModifyDate?: ExifDateTime | string;
@@ -71,6 +81,11 @@ export interface FileTags {
     /** ★★★★ ✔ Example: "YCbCr4:4:4 (1 1)" */
     YCbCrSubSampling?: string;
 }
+/**
+ * These are tags are derived from the values of one or more other tags.
+ * Only a few are writable directly.
+ * @see https://exiftool.org/TagNames/Composite.html
+ */
 export interface CompositeTags {
     /** ☆☆☆☆ ✔ Example: "Unknown (49 5)" */
     AdvancedSceneMode?: string;
@@ -122,7 +137,7 @@ export interface CompositeTags {
     OriginalDecisionData?: BinaryField | string;
     /** ☆☆☆☆   Example: "9.9 um" */
     PeakSpectralSensitivity?: string;
-    /** ★★★☆ ✔ Example: "(Binary data 315546 bytes, use -b option to extract)" */
+    /** ★★★☆ ✔ Example: "(Binary data 37244 bytes, use -b option to extract)" */
     PreviewImage?: BinaryField;
     /** ☆☆☆☆ ✔ Example: "On" */
     RedEyeReduction?: string;
@@ -170,7 +185,7 @@ export interface APP1Tags {
     CreatorSoftware?: string;
     /** ☆☆☆☆   Example: "2013:03:12 16:31:26" */
     DateTimeGenerated?: ExifDateTime | string;
-    /** ☆☆☆☆   Example: "(Binary data 275008 bytes, use -b option to extract)" */
+    /** ☆☆☆☆   Example: "(Binary data 1011393 bytes, use -b option to extract)" */
     EmbeddedImage?: BinaryField | string;
     /** ☆☆☆☆   Example: 960 */
     EmbeddedImageHeight?: number;
@@ -178,6 +193,8 @@ export interface APP1Tags {
     EmbeddedImageType?: string;
     /** ☆☆☆☆   Example: 640 */
     EmbeddedImageWidth?: number;
+    /** ☆☆☆☆   Example: 1 */
+    Emissivity?: number;
     /** ☆☆☆☆   Example: "46.1 deg" */
     FieldOfView?: string;
     /** ☆☆☆☆   Example: "NOF" */
@@ -260,6 +277,8 @@ export interface APP1Tags {
     Real2IR?: number;
     /** ☆☆☆☆   Example: "26.7 C" */
     ReflectedApparentTemperature?: string;
+    /** ☆☆☆☆   Example: "80.0 %" */
+    RelativeHumidity?: string;
     /** ☆☆☆☆   Example: "41 110 240" */
     UnderflowColor?: string;
 }
@@ -420,39 +439,14 @@ export interface APP14Tags {
 export interface APP4Tags {
     /** ☆☆☆☆ ✔ Example: "40 C" */
     AmbientTemperature?: string;
-    /** ☆☆☆☆   Example: 1 */
-    Emissivity?: number;
-    /** ☆☆☆☆   Example: "80.0 %" */
-    RelativeHumidity?: string;
 }
 export interface APP5Tags {
     /** ☆☆☆☆   Example: 45 */
     Compass?: string;
 }
-export interface APP6Tags {
-    /** ☆☆☆☆ ✔ Example: 800 */
-    AutoISOMax?: number;
-    /** ☆☆☆☆ ✔ Example: 3200 */
-    AutoISOMin?: number;
-    /** ☆☆☆☆ ✔ Example: "Up" */
-    AutoRotation?: string;
-    /** ☆☆☆☆ ✔ Example: "Photo Global Settings" */
-    DeviceName?: string;
-    /** ☆☆☆☆ ✔ Example: "On (Manual)" */
-    HDRSetting?: string;
-    /** ☆☆☆☆ ✔ Example: "AUTO" */
-    MaximumShutterAngle?: string;
-    /** ☆☆☆☆ ✔ Example: "859830e2f50cb3397a6216f09553fce800000000000000000000000000000000" */
-    MediaUniqueID?: string;
-    /** ☆☆☆☆ ✔ Example: "7.6.4" */
-    MetadataVersion?: string;
-    /** ☆☆☆☆ ✔ Example: "12MP_W" */
-    PhotoResolution?: string;
-    /** ☆☆☆☆ ✔ Example: "On" */
-    ProTune?: string;
-    /** ☆☆☆☆ ✔ Example: "4_1SEC" */
-    Rate?: string;
-}
+/**
+ * @see https://exiftool.org/TagNames/EXIF.html
+ */
 export interface EXIFTags {
     /** ☆☆☆☆ ✔ Example: 988517 */
     Acceleration?: number;
@@ -636,7 +630,7 @@ export interface EXIFTags {
     InteropIndex?: string;
     /** ★★★★ ✔ Example: "undef undef undef" */
     InteropVersion?: string;
-    /** ☆☆☆☆ ✔ Example: "(Binary data 772608 bytes, use -b option to extract)" */
+    /** ☆☆☆☆ ✔ Example: "(Binary data 532480 bytes, use -b option to extract)" */
     JpgFromRaw?: BinaryField;
     /** ☆☆☆☆ ✔ Example: 845574 */
     JpgFromRawLength?: number;
@@ -845,8 +839,35 @@ export interface EXIFTags {
     /** ★★★★ ✔ Example: 99 */
     YResolution?: number;
 }
+export interface APP6Tags {
+    /** ☆☆☆☆ ✔ Example: 800 */
+    AutoISOMax?: number;
+    /** ☆☆☆☆ ✔ Example: 3200 */
+    AutoISOMin?: number;
+    /** ☆☆☆☆ ✔ Example: "Up" */
+    AutoRotation?: string;
+    /** ☆☆☆☆ ✔ Example: "Photo Global Settings" */
+    DeviceName?: string;
+    /** ☆☆☆☆ ✔ Example: "On (Manual)" */
+    HDRSetting?: string;
+    /** ☆☆☆☆ ✔ Example: "AUTO" */
+    MaximumShutterAngle?: string;
+    /** ☆☆☆☆ ✔ Example: "859830e2f50cb3397a6216f09553fce800000000000000000000000000000000" */
+    MediaUniqueID?: string;
+    /** ☆☆☆☆ ✔ Example: "7.6.4" */
+    MetadataVersion?: string;
+    /** ☆☆☆☆ ✔ Example: "12MP_W" */
+    PhotoResolution?: string;
+    /** ☆☆☆☆ ✔ Example: "On" */
+    ProTune?: string;
+    /** ☆☆☆☆ ✔ Example: "4_1SEC" */
+    Rate?: string;
+}
+/**
+ * @see https://exiftool.org/TagNames/FlashPix.html
+ */
 export interface FlashPixTags {
-    /** ☆☆☆☆   Example: "(Binary data 20796 bytes, use -b option to extract)" */
+    /** ☆☆☆☆   Example: "(Binary data 18 bytes, use -b option to extract)" */
     AudioStream?: BinaryField | string;
     /** ☆☆☆☆ ✔ Example: "Unicode UTF-16, little endian" */
     CodePage?: string;
@@ -869,6 +890,34 @@ export interface FlashPixTags {
     /** ☆☆☆☆ ✔ Example: 1 */
     UsedExtensionNumbers?: number;
 }
+/**
+ * These tags are only available if {@link ExifToolOptions.geolocation} is true
+ * and the file has valid GPS location data.
+ */
+export interface GeolocationTags {
+    /** ☆☆☆☆ ✔ Example: 99 */
+    GeolocationBearing?: number;
+    /** ☆☆☆☆ ✔ Example: "Zürich" */
+    GeolocationCity?: string;
+    /** ☆☆☆☆ ✔ Example: "United States" */
+    GeolocationCountry?: string;
+    /** ☆☆☆☆ ✔ Example: "US" */
+    GeolocationCountryCode?: string;
+    /** ☆☆☆☆ ✔ Example: "9.60 km" */
+    GeolocationDistance?: string;
+    /** ☆☆☆☆ ✔ Example: "PPLL" */
+    GeolocationFeatureCode?: string;
+    /** ☆☆☆☆ ✔ Example: 95000 */
+    GeolocationPopulation?: number;
+    /** ☆☆☆☆ ✔ Example: "7.3397, 134.4733" */
+    GeolocationPosition?: string;
+    /** ☆☆☆☆ ✔ Example: "Île-de-France" */
+    GeolocationRegion?: string;
+    /** ☆☆☆☆ ✔ Example: "Yokohama Shi" */
+    GeolocationSubregion?: string;
+    /** ☆☆☆☆ ✔ Example: "Pacific/Saipan" */
+    GeolocationTimeZone?: string;
+}
 export interface JSONTags {
     /** ☆☆☆☆   Example: 0 */
     AIScene?: number;
@@ -883,30 +932,9 @@ export interface JSONTags {
     /** ☆☆☆☆   Example: 1 */
     ZoomMultiple?: number;
 }
-export interface MPFTags {
-    /** ★★☆☆ ✔ Example: 9697 */
-    DependentImage1EntryNumber?: number;
-    /** ★★☆☆ ✔ Example: 960 */
-    DependentImage2EntryNumber?: number;
-    /** ☆☆☆☆ ✔ Example: "(Binary data 66 bytes, use -b option to extract)" */
-    ImageUIDList?: BinaryField | string;
-    /** ★★☆☆ ✔ Example: "0100" */
-    MPFVersion?: string;
-    /** ★★☆☆ ✔ Example: "Representative image, Dependent parent image" */
-    MPImageFlags?: string;
-    /** ★★☆☆ ✔ Example: "Unknown (4)" */
-    MPImageFormat?: string;
-    /** ★★☆☆ ✔ Example: 999325 */
-    MPImageLength?: number;
-    /** ★★☆☆ ✔ Example: 9999872 */
-    MPImageStart?: number;
-    /** ★★☆☆ ✔ Example: "Undefined" */
-    MPImageType?: string;
-    /** ★★☆☆ ✔ Example: 3 */
-    NumberOfImages?: number;
-    /** ☆☆☆☆ ✔ Example: 1 */
-    TotalFrames?: number;
-}
+/**
+ * @see https://exiftool.org/TagNames/IPTC.html
+ */
 export interface IPTCTags {
     /** ☆☆☆☆ ✔ Example: 4 */
     ApplicationRecordVersion?: number;
@@ -973,6 +1001,30 @@ export interface IPTCTags {
     /** ☆☆☆☆ ✔ Example: "1 (most urgent)" */
     Urgency?: string;
 }
+export interface MPFTags {
+    /** ★★☆☆ ✔ Example: 9697 */
+    DependentImage1EntryNumber?: number;
+    /** ★★☆☆ ✔ Example: 960 */
+    DependentImage2EntryNumber?: number;
+    /** ☆☆☆☆ ✔ Example: "(Binary data 66 bytes, use -b option to extract)" */
+    ImageUIDList?: BinaryField | string;
+    /** ★★☆☆ ✔ Example: "0100" */
+    MPFVersion?: string;
+    /** ★★☆☆ ✔ Example: "Representative image, Dependent parent image" */
+    MPImageFlags?: string;
+    /** ★★☆☆ ✔ Example: "Unknown (4)" */
+    MPImageFormat?: string;
+    /** ★★☆☆ ✔ Example: 999325 */
+    MPImageLength?: number;
+    /** ★★☆☆ ✔ Example: 9999872 */
+    MPImageStart?: number;
+    /** ★★☆☆ ✔ Example: "Undefined" */
+    MPImageType?: string;
+    /** ★★☆☆ ✔ Example: 3 */
+    NumberOfImages?: number;
+    /** ☆☆☆☆ ✔ Example: 1 */
+    TotalFrames?: number;
+}
 export interface MetaTags {
     /** ☆☆☆☆   Example: 1 */
     BorderID?: number;
@@ -1017,6 +1069,9 @@ export interface PanasonicRawTags {
     /** ☆☆☆☆ ✔ Example: 7 */
     NumWBEntries?: number;
 }
+/**
+ * @see https://exiftool.org/TagNames/Photoshop.html
+ */
 export interface PhotoshopTags {
     /** ☆☆☆☆ ✔ Example: true */
     CopyrightFlag?: boolean;
@@ -1806,7 +1861,7 @@ export interface MakerNotesTags {
     CameraISO?: string;
     /** ☆☆☆☆ ✔ Example: "Unknown (155)" */
     CameraOrientation?: string;
-    /** ☆☆☆☆ ✔ Example: "(Binary data 8412 bytes, use -b option to extract)" */
+    /** ☆☆☆☆ ✔ Example: "(Binary data 8378 bytes, use -b option to extract)" */
     CameraParameters?: BinaryField | string;
     /** ☆☆☆☆ ✔ Example: "User Defined 3" */
     CameraPictureStyle?: string;
@@ -2142,7 +2197,7 @@ export interface MakerNotesTags {
     DSPFirmwareVersion?: string;
     /** ☆☆☆☆ ✔ Example: "Yes" */
     DarkFocusEnvironment?: string;
-    /** ★★☆☆ ✔ Example: "(Binary data 114 bytes, use -b option to extract)" */
+    /** ★★☆☆ ✔ Example: "(Binary data 280 bytes, use -b option to extract)" */
     DataDump?: BinaryField | string;
     /** ☆☆☆☆ ✔ Example: 8289 */
     DataScaling?: number;
@@ -4471,6 +4526,9 @@ export interface MakerNotesTags {
     /** ☆☆☆☆ ✔ Example: 4184638 */
     ZoomedPreviewStart?: number;
 }
+/**
+ * @see https://exiftool.org/TagNames/XMP.html
+ */
 export interface XMPTags {
     /** ☆☆☆☆ ✔ Example: "uuid:faf5bdd5-ba3d-11da-ad31-d33d75182f1b" */
     About?: string;
@@ -4686,7 +4744,7 @@ export interface XMPTags {
     GreenHue?: number;
     /** ☆☆☆☆ ✔ Example: 0 */
     GreenSaturation?: number;
-    /** ☆☆☆☆ ✔ Example: "(Binary data 23317 bytes, use -b option to extract)" */
+    /** ☆☆☆☆ ✔ Example: "(Binary data 49603 bytes, use -b option to extract)" */
     HDRPMakerNote?: BinaryField | string;
     /** ☆☆☆☆ ✔ Example: false */
     HasCrop?: boolean;
@@ -5035,14 +5093,8 @@ export interface XMPTags {
  * devices (like iPhones) An example value, JSON stringified, follows the
  * popularity ratings.
  *
- * Autogenerated by "yarn mktags" by ExifTool 12.80 on Tue Mar 26 2024.
- * 2723 unique tags were found in 10096 photo and video files.
+ * Autogenerated by "yarn mktags" by ExifTool 12.82 on Thu Apr 11 2024.
+ * 2736 unique tags were found in 10096 photo and video files.
  */
-export interface Tags extends APP12Tags, APP14Tags, APP1Tags, APP4Tags, APP5Tags, APP6Tags, ApplicationRecordTags, CompositeTags, EXIFTags, ErrorsAndWarnings, ExifToolTags, FileTags, FlashPixTags, GeolocationTags, ICCProfileTags, IPTCTags, ImageDataHashTag, JFIFTags, JSONTags, MPFTags, MWGCollectionsTags, MWGKeywordTags, MakerNotesTags, MetaTags, PanasonicRawTags, PhotoshopTags, PrintIMTags, QuickTimeTags, RAFTags, RIFFTags, XMPTags {
-    /** Full, resolved native path to this file */
-    SourceFile?: string;
-    /** Either an offset, like `UTC-7`, or an actual timezone, like `America/Los_Angeles` */
-    tz?: string;
-    /** Description of where and how `tz` was extracted */
-    tzSource?: string;
+export interface Tags extends APP12Tags, APP14Tags, APP1Tags, APP4Tags, APP5Tags, APP6Tags, ApplicationRecordTags, CompositeTags, EXIFTags, ExifToolTags, ExifToolVendoredTags, FileTags, FlashPixTags, GeolocationTags, ICCProfileTags, IPTCTags, ImageDataHashTag, JFIFTags, JSONTags, MPFTags, MWGCollectionsTags, MWGKeywordTags, MakerNotesTags, MetaTags, PanasonicRawTags, PhotoshopTags, PrintIMTags, QuickTimeTags, RAFTags, RIFFTags, XMPTags {
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exiftool-vendored",
-  "version": "25.0.0",
+  "version": "25.2.0",
   "description": "Efficient, cross-platform access to ExifTool",
   "main": "./dist/ExifTool.js",
   "types": "./dist/ExifTool.d.ts",
@@ -17,6 +17,7 @@
     "compile:watch": "yarn precompile && tsc --watch",
     "premktags": "yarn compile",
     "mktags": "node dist/update/mktags.js",
+    "prelint": "yarn compile",
     "lint": "yarn eslint src --ext .ts",
     "prettier": "prettier --write src/*.ts src/**/*.ts",
     "pretest": "run-p lint compile",
@@ -32,6 +33,9 @@
     "url": "https://github.com/photostructure/exiftool-vendored.js.git"
   },
   "release-it": {
+    "hooks": {
+      "before:init": "yarn lint"
+    },
     "src": {
       "tagName": "v%s",
       "commitArgs": "-S",
@@ -73,12 +77,12 @@
     "@types/globule": "^1.1.9",
     "@types/he": "^1.2.3",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^20.11.30",
+    "@types/node": "^20.12.7",
     "@types/progress": "^2.0.7",
     "@types/tmp": "^0.2.6",
     "@types/xmldom": "^0.1.34",
-    "@typescript-eslint/eslint-plugin": "^7.4.0",
-    "@typescript-eslint/parser": "^7.4.0",
+    "@typescript-eslint/eslint-plugin": "^7.6.0",
+    "@typescript-eslint/parser": "^7.6.0",
     "@xmldom/xmldom": "^0.8.10",
     "chai": "^4.3.10",
     "chai-as-promised": "^7.1.1",
@@ -86,7 +90,7 @@
     "eslint": "^8.57.0",
     "eslint-plugin-import": "^2.29.1",
     "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-regexp": "^2.4.0",
+    "eslint-plugin-regexp": "^2.5.0",
     "extract-zip": "^2.0.1",
     "geo-tz": "^8.0.2",
     "globule": "^1.3.4",
@@ -100,8 +104,8 @@
     "serve": "^14.2.1",
     "source-map-support": "^0.5.21",
     "tmp": "^0.2.3",
-    "typedoc": "^0.25.12",
-    "typescript": "^5.4.3",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.4.5",
     "xpath": "^0.0.34"
   },
   "dependencies-note": "@types/luxon is a proper dependency, not devDependency, as our exported TypeScript typings reference luxon types. See <https://github.com/photostructure/exiftool-vendored.js/pull/108>",
@@ -113,7 +117,7 @@
     "luxon": "^3.4.4"
   },
   "optionalDependencies": {
-    "exiftool-vendored.exe": "12.80.0",
-    "exiftool-vendored.pl": "12.80.0"
+    "exiftool-vendored.exe": "12.82.0",
+    "exiftool-vendored.pl": "12.82.0"
   }
 }