magic-file 1.0.0

package/LICENSE

@@ -0,0 +1,19 @@
+BSD 2-Clause License
+
+Copyright (c) 2026, Ayanmwunmi Ogaga
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. 

package/README.md

@@ -0,0 +1,214 @@
+# magic-file
+
+Get the MIME type of virtually any file format using **libmagic**, the
+same engine behind the Unix `file` command, compiled to **WebAssembly**.
+
+Unlike most browser-friendly file type detectors that recognize only a
+limited set of signatures, **magic-file** leverages the full power of
+**libmagic** to identify **thousands of file formats** that have been
+introduced over the years.
+
+It works everywhere JavaScript runs:
+
+-   ✅ Browser
+-   ✅ React
+-   ✅ Next.js
+-   ✅ Vite
+-   ✅ Node.js
+-   ✅ Bun
+-   ✅ Deno
+-   ✅ Most modern bundlers
+
+There are already excellent packages such as `file-type`, but they
+intentionally support a relatively small collection of common file
+signatures. **magic-file** is designed for applications that need much
+broader coverage while still remaining easy to use.
+
+Internally, this project uses a WebAssembly build of **libmagic**,
+inspired by Colin Kennedy's work: - https://github.com/moshen/wasmagic -
+https://github.com/file/file -
+https://man7.org/linux/man-pages/man3/libmagic.3.html
+
+The WASM build has been heavily optimized so it can run reliably in
+browsers as well as server-side runtimes.
+
+## Live Demo
+
+Try **magic-file** in your browser without installing anything:
+
+🌐 **https://filetypecheck.com/**
+
+The demo runs entirely in your browser—your files are **never uploaded** or sent to a server. Drag and drop a file (or enter a URL) to instantly detect its real MIME type and validate whether its extension matches its actual content. :contentReference[oaicite:0]{index=0}
+
+
+## Why is the package around 600KB?
+
+`magic-file` embeds the compiled **magic database** containing
+signatures for thousands of known file formats.
+
+Instead of shipping several megabytes of data, the database is
+compressed and baked directly into the WASM binary.
+
+The final download is approximately **600KB**, and when served through
+**gzip** or **Brotli** (Next.js, React, Vite, CDN, etc.) it becomes even
+smaller over the network.
+
+The result is a single package with:
+
+- No native compilation
+- Minimal runtime dependencies
+- Cross-platform compatibility
+- File detection powered by `libmagic`
+
+## Why magic-file?
+
+There are already excellent packages such as `file-type`, but they intentionally support a relatively small collection of common file signatures. **magic-file** is designed for applications that require much broader coverage by leveraging the same detection engine used by the Unix `file` command. :contentReference[oaicite:1]{index=1}
+
+------------------------------------------------------------------------
+
+## Installation
+
+``` bash
+npm install magic-file
+```
+
+## Quick Example
+
+``` ts
+import { Magic } from "magic-file";
+
+const magic = await Magic.create();
+
+const mime = await magic.detect(buffer);
+const mime2 = await magic.detect(arrayBuffer);
+const mime3 = await magic.detect(file);
+const mime4 = await magic.detect(blob);
+
+magic.dispose();
+```
+
+------------------------------------------------------------------------
+
+# Browser (React / Next.js / Vite)
+
+``` tsx
+import { Magic } from "magic-file";
+
+const handleFileChange = async (e) => {
+  const files = Array.from(e.target.files).slice(0, 6);
+
+  if (!files.length) return;
+
+  const start = performance.now();
+
+  setLoading(true);
+  setResults([]);
+
+  let magic;
+
+  try {
+    magic = await Magic.create();
+
+    const results = [];
+
+    for (const file of files) {
+      const mime = await magic.detect(file);
+      results.push({
+        name: file.name,
+        mime
+      });
+    }
+
+    console.log(`${performance.now() - start}ms`);
+
+    setResults(results);
+
+  } finally {
+    magic?.dispose();
+    setLoading(false);
+  }
+};
+
+<input type="file" multiple onChange={handleFileChange} />
+```
+
+------------------------------------------------------------------------
+
+# Node.js
+
+``` js
+const { Magic } = require("magic-file");
+const { readFile } = require("node:fs/promises");
+
+async function detect(path) {
+
+    const magic = await Magic.create();
+
+    try {
+        const buffer = await readFile(path);
+
+        const mime = await magic.detect(buffer);
+
+        console.log(mime);
+
+    } finally {
+        magic.dispose();
+    }
+}
+
+detect("./package.json");
+```
+
+------------------------------------------------------------------------
+
+# Bun
+
+``` ts
+import { Magic } from "magic-file";
+
+const magic = await Magic.create();
+
+try {
+
+    const file = Bun.file("./package.json");
+
+    const mime = await magic.detect(
+        new Uint8Array(await file.arrayBuffer())
+    );
+
+    console.log(mime);
+
+} finally {
+    magic.dispose();
+}
+```
+
+------------------------------------------------------------------------
+
+## Features
+
+-   Full **libmagic** powered detection
+-   Supports thousands of file formats
+-   Browser, Node.js, Bun and Deno support
+-   React, Next.js and Vite compatible
+-   Zero production dependencies
+-   No native compilation
+-   Single embedded magic database
+-   Dual ESM / CommonJS
+-   Supports `Buffer`, `Uint8Array`, `ArrayBuffer`, `Blob` and `File`
+-   Small API: `create()`, `detect()`, `dispose()`
+
+------------------------------------------------------------------------
+
+## Acknowledgements
+
+`magic-file` is powered by **libmagic**, the same file identification library used by the Unix `file` command.
+
+This project builds upon the WebAssembly work originally started by Colin Kennedy:
+- https://github.com/moshen/wasmagic
+
+Special thanks to the libmagic project and its maintainers, including Ian F. Darwin and Christos Zoulas, for creating and maintaining one of the most comprehensive file identification libraries available.
+
+## License
+
+BSD-2-Clause

package/THIRD_PARTY_NOTICES

@@ -0,0 +1,36 @@
+# 1. libmagic
+
+* **Homepage:** https://www.darwinsys.com/file/
+* **License:** BSD-2-Clause
+* 
+BSD-2-Clause
+
+$File: COPYING,v 1.2 2018/09/09 20:33:28 christos Exp $
+Copyright (c) Ian F. Darwin 1986, 1987, 1989, 1990, 1991, 1992, 1994, 1995.
+Software written by Ian F. Darwin and others;
+maintained 1994- Christos Zoulas.
+
+This software is not subject to any export provision of the United States
+Department of Commerce, and may be exported to any country or planet. 
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+1. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

package/dist/cjs/Magic.d.ts

@@ -0,0 +1,12 @@
+import type { MagicInput, MagicOptions } from "./types.js";
+export declare class Magic {
+    static create(options?: MagicOptions): Promise<Magic>;
+    private detector;
+    private mutex;
+    private disposed;
+    private constructor();
+    detect(input: MagicInput): Promise<string>;
+    dispose(): void;
+    static normalize(input: MagicInput): Promise<Uint8Array>;
+}
+//# sourceMappingURL=Magic.d.ts.map

package/dist/cjs/Magic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Magic.d.ts","sourceRoot":"","sources":["../../src/Magic.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AAQpB,qBAAa,KAAK;WACH,MAAM,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiB/D,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO;IAMD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBhD,OAAO,IAAI,IAAI;IAUf,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAGzD"}

package/dist/cjs/Magic.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Magic = void 0;
+const detector_js_1 = require("./detector.js");
+const loader_js_1 = require("./loader.js");
+const input_js_1 = require("./input.js");
+const mutex_js_1 = require("./mutex.js");
+const constants_js_1 = require("./constants.js");
+const errors_js_1 = require("./errors.js");
+class Magic {
+    static async create(options = {}) {
+        const resolved = {
+            flags: options.flags ?? constants_js_1.DEFAULT_FLAGS,
+            loadDefaultMagicfile: options.loadDefaultMagicfile ?? constants_js_1.DEFAULT_LOAD_DEFAULT_MAGICFILE,
+            magicFiles: options.magicFiles ?? [],
+            stdio: options.stdio ?? constants_js_1.NOOP_STDIO,
+            locateFile: options.locateFile,
+            wasmBinary: options.wasmBinary,
+        };
+        const module = await (0, loader_js_1.loadModule)(resolved);
+        const detector = (0, detector_js_1.createDetector)(module);
+        return new Magic(detector);
+    }
+    constructor(detector) {
+        this.detector = detector;
+        this.mutex = (0, mutex_js_1.createMutex)();
+        this.disposed = false;
+    }
+    async detect(input) {
+        if (this.disposed) {
+            throw new errors_js_1.MagicDisposedError();
+        }
+        if (!this.detector) {
+            throw new errors_js_1.MagicDisposedError();
+        }
+        const release = await this.mutex.acquire();
+        try {
+            const buffer = await (0, input_js_1.normalizeInput)(input);
+            return this.detector(buffer);
+        }
+        finally {
+            release();
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.detector) {
+            this.detector.dispose();
+            this.detector = null;
+        }
+    }
+    static normalize(input) {
+        return (0, input_js_1.normalizeInput)(input);
+    }
+}
+exports.Magic = Magic;
+//# sourceMappingURL=Magic.js.map

package/dist/cjs/Magic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Magic.js","sourceRoot":"","sources":["../../src/Magic.ts"],"names":[],"mappings":";;;AACA,+CAA+C;AAC/C,2CAAyC;AACzC,yCAA4C;AAC5C,yCAAqD;AAMrD,iDAIwB;AACxB,2CAAiD;AAEjD,MAAa,KAAK;IAChB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAwB,EAAE;QAC5C,MAAM,QAAQ,GAAyB;YACrC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,4BAAa;YACrC,oBAAoB,EAClB,OAAO,CAAC,oBAAoB,IAAI,6CAA8B;YAChE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,yBAAU;YAClC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAU,EAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAA,4BAAc,EAAC,MAAM,CAAC,CAAC;QAExC,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAMD,YAAoB,QAAkB;QACpC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAA,sBAAW,GAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAiB;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,8BAAkB,EAAE,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,8BAAkB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAE3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAc,EAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAiB;QAChC,OAAO,IAAA,yBAAc,EAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF;AA5DD,sBA4DC"}

package/dist/cjs/StdioOverrideFunction.d.ts

@@ -0,0 +1,2 @@
+export type StdioOverrideFunction = (stdioName: "stdout" | "stderr", text: string) => void;
+//# sourceMappingURL=StdioOverrideFunction.d.ts.map

package/dist/cjs/StdioOverrideFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioOverrideFunction.d.ts","sourceRoot":"","sources":["../../src/StdioOverrideFunction.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,QAAQ,GAAG,QAAQ,EAC9B,IAAI,EAAE,MAAM,KACT,IAAI,CAAC"}

package/dist/cjs/StdioOverrideFunction.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=StdioOverrideFunction.js.map

package/dist/cjs/StdioOverrideFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioOverrideFunction.js","sourceRoot":"","sources":["../../src/StdioOverrideFunction.ts"],"names":[],"mappings":""}

package/dist/cjs/constants.d.ts

@@ -0,0 +1,34 @@
+export declare const MagicFlags: Readonly<{
+    readonly NONE: 0;
+    readonly DEBUG: 1;
+    readonly SYMLINK: 2;
+    readonly COMPRESS: 4;
+    readonly DEVICES: 8;
+    readonly MIME_TYPE: 16;
+    readonly CONTINUE: 32;
+    readonly CHECK: 64;
+    readonly PRESERVE_ATIME: 128;
+    readonly RAW: 256;
+    readonly ERROR: 512;
+    readonly MIME_ENCODING: 1024;
+    readonly APPLE: 2048;
+    readonly EXTENSION: 16777216;
+    readonly COMPRESS_TRANSP: 33554432;
+    readonly NO_COMPRESS_FORK: 67108864;
+    readonly NO_CHECK_COMPRESS: 4096;
+    readonly NO_CHECK_TAR: 8192;
+    readonly NO_CHECK_SOFT: 16384;
+    readonly NO_CHECK_APPTYPE: 32768;
+    readonly NO_CHECK_ELF: 65536;
+    readonly NO_CHECK_TEXT: 131072;
+    readonly NO_CHECK_CDF: 262144;
+    readonly NO_CHECK_CSV: 524288;
+    readonly NO_CHECK_TOKENS: 1048576;
+    readonly NO_CHECK_ENCODING: 2097152;
+    readonly NO_CHECK_JSON: 4194304;
+    readonly NO_CHECK_SIMH: 8388608;
+}>;
+export declare const DEFAULT_FLAGS: number;
+export declare const DEFAULT_LOAD_DEFAULT_MAGICFILE = true;
+export declare const NOOP_STDIO: (_stdioName: "stdout" | "stderr", _text: string) => void;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BZ,CAAC;AAEZ,eAAO,MAAM,aAAa,EAAE,MAA6B,CAAC;AAC1D,eAAO,MAAM,8BAA8B,OAAO,CAAC;AACnD,eAAO,MAAM,UAAU,GAAI,YAAY,QAAQ,GAAG,QAAQ,EAAE,OAAO,MAAM,SAAO,CAAC"}

package/dist/cjs/constants.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOOP_STDIO = exports.DEFAULT_LOAD_DEFAULT_MAGICFILE = exports.DEFAULT_FLAGS = exports.MagicFlags = void 0;
+exports.MagicFlags = Object.freeze({
+    NONE: 0x0000000,
+    DEBUG: 0x0000001,
+    SYMLINK: 0x0000002,
+    COMPRESS: 0x0000004,
+    DEVICES: 0x0000008,
+    MIME_TYPE: 0x0000010,
+    CONTINUE: 0x0000020,
+    CHECK: 0x0000040,
+    PRESERVE_ATIME: 0x0000080,
+    RAW: 0x0000100,
+    ERROR: 0x0000200,
+    MIME_ENCODING: 0x0000400,
+    APPLE: 0x0000800,
+    EXTENSION: 0x1000000,
+    COMPRESS_TRANSP: 0x2000000,
+    NO_COMPRESS_FORK: 0x4000000,
+    NO_CHECK_COMPRESS: 0x0001000,
+    NO_CHECK_TAR: 0x0002000,
+    NO_CHECK_SOFT: 0x0004000,
+    NO_CHECK_APPTYPE: 0x0008000,
+    NO_CHECK_ELF: 0x0010000,
+    NO_CHECK_TEXT: 0x0020000,
+    NO_CHECK_CDF: 0x0040000,
+    NO_CHECK_CSV: 0x0080000,
+    NO_CHECK_TOKENS: 0x0100000,
+    NO_CHECK_ENCODING: 0x0200000,
+    NO_CHECK_JSON: 0x0400000,
+    NO_CHECK_SIMH: 0x0800000,
+});
+exports.DEFAULT_FLAGS = exports.MagicFlags.MIME_TYPE;
+exports.DEFAULT_LOAD_DEFAULT_MAGICFILE = true;
+const NOOP_STDIO = (_stdioName, _text) => { };
+exports.NOOP_STDIO = NOOP_STDIO;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;IAChB,cAAc,EAAE,SAAS;IACzB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,gBAAgB,EAAE,SAAS;IAC3B,iBAAiB,EAAE,SAAS;IAC5B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,SAAS;IACxB,gBAAgB,EAAE,SAAS;IAC3B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,iBAAiB,EAAE,SAAS;IAC5B,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,SAAS;CAChB,CAAC,CAAC;AAEC,QAAA,aAAa,GAAW,kBAAU,CAAC,SAAS,CAAC;AAC7C,QAAA,8BAA8B,GAAG,IAAI,CAAC;AAC5C,MAAM,UAAU,GAAG,CAAC,UAA+B,EAAE,KAAa,EAAE,EAAE,GAAE,CAAC,CAAC;AAApE,QAAA,UAAU,cAA0D"}

package/dist/cjs/detector.d.ts

@@ -0,0 +1,7 @@
+import type { LibmagicModule } from "./types.js";
+export declare function createDetector(module: LibmagicModule): {
+    (buffer: Uint8Array): string;
+    dispose(): void;
+};
+export type Detector = ReturnType<typeof createDetector>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/cjs/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc;aAQ3B,UAAU,GAAG,MAAM;;EAwB5C;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/cjs/detector.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDetector = createDetector;
+const memory_js_1 = require("./memory.js");
+const errors_js_1 = require("./errors.js");
+function createDetector(module) {
+    const detectFromWasm = module.cwrap("magic_wrapper_detect", "string", [
+        "number",
+        "number",
+    ]);
+    const scratch = new memory_js_1.ScratchBuffer();
+    function detect(buffer) {
+        const ptr = scratch.write(module, buffer);
+        let result;
+        try {
+            result = detectFromWasm(ptr, buffer.byteLength);
+        }
+        catch (err) {
+            throw new errors_js_1.MagicDetectError(`Detection failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (result == null) {
+            throw new errors_js_1.MagicDetectError("Detection returned null or undefined result");
+        }
+        return result;
+    }
+    detect.dispose = () => {
+        scratch.release(module);
+    };
+    return detect;
+}
+//# sourceMappingURL=detector.js.map

package/dist/cjs/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/detector.ts"],"names":[],"mappings":";;AAIA,wCAgCC;AAnCD,2CAA4C;AAC5C,2CAA+C;AAE/C,SAAgB,cAAc,CAAC,MAAsB;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,QAAQ,EAAE;QACpE,QAAQ;QACR,QAAQ;KACT,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,yBAAa,EAAE,CAAC;IAEpC,SAAS,MAAM,CAAC,MAAkB;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,4BAAgB,CACxB,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxE,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,4BAAgB,CAAC,6CAA6C,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class MagicError extends Error {
+    constructor(message: string);
+}
+export declare class MagicLoadError extends MagicError {
+    constructor(message: string);
+}
+export declare class MagicDetectError extends MagicError {
+    constructor(message: string);
+}
+export declare class MagicDisposedError extends MagicError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,kBAAmB,SAAQ,UAAU;;CAMjD"}

package/dist/cjs/errors.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MagicDisposedError = exports.MagicDetectError = exports.MagicLoadError = exports.MagicError = void 0;
+class MagicError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MagicError";
+        Object.setPrototypeOf(this, MagicError.prototype);
+    }
+}
+exports.MagicError = MagicError;
+class MagicLoadError extends MagicError {
+    constructor(message) {
+        super(message);
+        this.name = "MagicLoadError";
+        Object.setPrototypeOf(this, MagicLoadError.prototype);
+    }
+}
+exports.MagicLoadError = MagicLoadError;
+class MagicDetectError extends MagicError {
+    constructor(message) {
+        super(message);
+        this.name = "MagicDetectError";
+        Object.setPrototypeOf(this, MagicDetectError.prototype);
+    }
+}
+exports.MagicDetectError = MagicDetectError;
+class MagicDisposedError extends MagicError {
+    constructor() {
+        super("Magic instance has been disposed and can no longer be used");
+        this.name = "MagicDisposedError";
+        Object.setPrototypeOf(this, MagicDisposedError.prototype);
+    }
+}
+exports.MagicDisposedError = MagicDisposedError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,gCAMC;AAED,MAAa,cAAe,SAAQ,UAAU;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAND,wCAMC;AAED,MAAa,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAND,4CAMC;AAED,MAAa,kBAAmB,SAAQ,UAAU;IAChD;QACE,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAND,gDAMC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,5 @@
+export { Magic } from "./Magic.js";
+export { MagicFlags } from "./constants.js";
+export { MagicError, MagicLoadError, MagicDetectError, MagicDisposedError, } from "./errors.js";
+export type { MagicOptions, MagicInput, StdioOverrideFunction, LibmagicModule, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MagicDisposedError = exports.MagicDetectError = exports.MagicLoadError = exports.MagicError = exports.MagicFlags = exports.Magic = void 0;
+var Magic_js_1 = require("./Magic.js");
+Object.defineProperty(exports, "Magic", { enumerable: true, get: function () { return Magic_js_1.Magic; } });
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "MagicFlags", { enumerable: true, get: function () { return constants_js_1.MagicFlags; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "MagicError", { enumerable: true, get: function () { return errors_js_1.MagicError; } });
+Object.defineProperty(exports, "MagicLoadError", { enumerable: true, get: function () { return errors_js_1.MagicLoadError; } });
+Object.defineProperty(exports, "MagicDetectError", { enumerable: true, get: function () { return errors_js_1.MagicDetectError; } });
+Object.defineProperty(exports, "MagicDisposedError", { enumerable: true, get: function () { return errors_js_1.MagicDisposedError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,+CAA4C;AAAnC,0GAAA,UAAU,OAAA;AACnB,yCAKqB;AAJnB,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,+GAAA,kBAAkB,OAAA"}

package/dist/cjs/input.d.ts

@@ -0,0 +1,3 @@
+import type { MagicInput } from "./types.js";
+export declare function normalizeInput(input: MagicInput): Promise<Uint8Array>;
+//# sourceMappingURL=input.d.ts.map

package/dist/cjs/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB3E"}

package/dist/cjs/input.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeInput = normalizeInput;
+async function normalizeInput(input) {
+    // Note: Node's Buffer is a subclass of Uint8Array, so this branch also
+    // covers Buffer inputs (including ones with a non-zero byteOffset into a
+    // shared underlying ArrayBuffer) without needing a separate check.
+    if (input instanceof Uint8Array) {
+        return input;
+    }
+    if (input instanceof ArrayBuffer) {
+        return new Uint8Array(input);
+    }
+    if (isBlob(input) || isFile(input)) {
+        const buf = await input.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    throw new TypeError(`Unsupported input type. Expected Uint8Array, ArrayBuffer, Buffer, Blob, or File. Got ${typeof input}`);
+}
+function isBlob(value) {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+}
+function isFile(value) {
+    return typeof File !== "undefined" && value instanceof File;
+}
+//# sourceMappingURL=input.js.map

package/dist/cjs/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/input.ts"],"names":[],"mappings":";;AAEA,wCAoBC;AApBM,KAAK,UAAU,cAAc,CAAC,KAAiB;IACpD,uEAAuE;IACvE,yEAAyE;IACzE,mEAAmE;IACnE,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAO,KAAc,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,wFAAwF,OAAO,KAAK,EAAE,CACvG,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,CAAC;AAC9D,CAAC"}

package/dist/cjs/loader.d.ts

@@ -0,0 +1,3 @@
+import type { LibmagicModule, MagicOptionsResolved } from "./types.js";
+export declare function loadModule(options: MagicOptionsResolved): Promise<LibmagicModule>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/cjs/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAEd,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA4BpB,wBAAsB,UAAU,CAC9B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA8DzB"}