index.ts

import libmagicFactory from "./libmagic-wrapper";
import type LibmagicModule from "./LibmagicModule";
import type StdioOverrideFunction from "./StdioOverrideFunction";
export { default as StdioOverrideFunction } from "./StdioOverrideFunction";

declare function wrappedDetect(bufPointer: number, bufLength: number): string;

export enum WASMagicFlags {
  /** No flags */
  NONE = 0x0000000,
  /** Turn on debugging */
  DEBUG = 0x0000001,
  /** Follow symlinks */
  SYMLINK = 0x0000002,
  /** Check inside compressed files */
  COMPRESS = 0x0000004,
  /** Look at the contents of devices */
  DEVICES = 0x0000008,
  /** Return the MIME type */
  MIME_TYPE = 0x0000010,
  /** Return all matches */
  CONTINUE = 0x0000020,
  /** Print warnings to stderr */
  CHECK = 0x0000040,
  /** Restore access time on exit */
  PRESERVE_ATIME = 0x0000080,
  /** Don't convert unprintable chars */
  RAW = 0x0000100,
  /** Handle ENOENT etc as real errors */
  ERROR = 0x0000200,
  /** Return the MIME encoding */
  MIME_ENCODING = 0x0000400,
  /** Return the Apple creator/type */
  APPLE = 0x0000800,
  /** Return a /-separated list of extensions */
  EXTENSION = 0x1000000,
  /** Check inside compressed files but not report compression */
  COMPRESS_TRANSP = 0x2000000,
  /** Don't allow decompression that needs to fork */
  NO_COMPRESS_FORK = 0x4000000,
  /** Don't check for compressed files */
  NO_CHECK_COMPRESS = 0x0001000,
  /** Don't check for tar files */
  NO_CHECK_TAR = 0x0002000,
  /** Don't check magic entries */
  NO_CHECK_SOFT = 0x0004000,
  /** Don't check application type */
  NO_CHECK_APPTYPE = 0x0008000,
  /** Don't check for elf details */
  NO_CHECK_ELF = 0x0010000,
  /** Don't check for text files */
  NO_CHECK_TEXT = 0x0020000,
  /** Don't check for cdf files */
  NO_CHECK_CDF = 0x0040000,
  /** Don't check for CSV files */
  NO_CHECK_CSV = 0x0080000,
  /** Don't check tokens */
  NO_CHECK_TOKENS = 0x0100000,
  /** Don't check text encodings */
  NO_CHECK_ENCODING = 0x0200000,
  /** Don't check for JSON files */
  NO_CHECK_JSON = 0x0400000,
  /** Don't check for SIMH tape files */
  NO_CHECK_SIMH = 0x0800000,
}

export type WASMagicOptions = {
  flags?: WASMagicFlags;
  loadDefaultMagicfile?: boolean;
  magicFiles?: Uint8Array[];
  stdio?: StdioOverrideFunction;
};

type WASMagicOptionsComplete = {
  flags: WASMagicFlags;
  loadDefaultMagicfile: boolean;
  magicFiles: Uint8Array[];
  stdio: StdioOverrideFunction;
};

const defaultWASMagicOptions: WASMagicOptionsComplete = Object.freeze({
  flags: WASMagicFlags.MIME_TYPE,
  loadDefaultMagicfile: true,
  magicFiles: [],
  stdio: (_stdioName: "stdout" | "stderr", _text: string) => {},
});

export class WASMagic {
  static async create(
    options: WASMagicOptions = defaultWASMagicOptions,
  ): Promise<WASMagic> {
    const Module = await libmagicFactory();
    return new WASMagic(Module, options);
  }

  private Module: LibmagicModule;
  private detectFromWasm: typeof wrappedDetect;

  private constructor(Module: LibmagicModule, inputOptions: WASMagicOptions) {
    const options = Object.assign({}, defaultWASMagicOptions, inputOptions);
    Module.printOverride = options.stdio;

    Module.FS.chdir("/magic");

    const magicPaths: string[] = [];

    // Write each magic file to the internal WASM filesystem
    for (let i = 0; i < options.magicFiles.length; i++) {
      Module.FS.writeFile(`/magic/${i}`, options.magicFiles[i]);
      magicPaths.push(`${i}`);
    }

    if (options.loadDefaultMagicfile) {
      magicPaths.push("magic.mgc");
    }

    const loadErr = Module.ccall(
      "magic_wrapper_load",
      "string",
      ["number", "string"],
      [options.flags, magicPaths.join(":")],
    );

    if (loadErr !== "") {
      throw new Error(`WASMagic Load Error: ${loadErr}`);
    }

    // Remove each magic file from the internal WASM filesystem
    // This frees available memory
    for (let i = 0; i < options.magicFiles.length; i++) {
      Module.FS.unlink(`/magic/${i}`);
    }
    Module.FS.unlink("/magic/magic.mgc");

    this.Module = Module;
    this.detectFromWasm = Module.cwrap("magic_wrapper_detect", "string", [
      "number",
      "number",
    ]) as typeof wrappedDetect;
  }

  detect(buf: Uint8Array): string {
    const ptr = this.Module._malloc(buf.length);
    this.Module.HEAPU8.set(buf, ptr);
    const result = this.detectFromWasm(ptr, buf.length);
    this.Module._free(ptr);
    return result;
  }

  /**
   * @deprecated Use {@link WASMagic#detect} instead
   */
  getMime(buf: Uint8Array): string {
    return this.detect(buf);
  }
}