@nxtedition/mime 1.0.1

package/LICENSE

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

package/README.md

@@ -0,0 +1,81 @@
+# @nxtedition/mime
+
+MIME type lookup and extension resolution with built-in support for broadcast and professional media formats missing from the standard `mime` package.
+
+## Install
+
+```sh
+npm install @nxtedition/mime
+```
+
+## Usage
+
+### Lookup MIME type by filename
+
+```js
+import { lookup } from '@nxtedition/mime'
+
+lookup('video.mxf') // 'application/mxf'
+lookup('video.mp4') // 'video/mp4'
+lookup('video.nut') // 'video/x-nut'
+lookup('audio.ac3') // 'audio/ac3'
+lookup('subs.stl') // 'application/x-ebu-stl'
+lookup('subs.scc') // 'text/x-scc'
+```
+
+### Get extension from MIME type
+
+```js
+import { extension } from '@nxtedition/mime'
+
+extension('video/mp4') // 'mp4'
+extension('video/x-dnxhd') // 'dnxhd'
+extension('audio/ac3') // 'ac3'
+extension('application/x-ebu-stl') // 'stl'
+extension('video/quicktime', 'clip.mov') // 'mov'
+```
+
+## Broadcast & media types
+
+Types handled beyond the standard `mime` package:
+
+| Extension    | MIME Type                     | Format                    |
+| ------------ | ----------------------------- | ------------------------- |
+| `.nut`       | `video/x-nut`                 | NUT container             |
+| `.dnxhd`     | `video/x-dnxhd`               | Avid DNxHD/DNxHR          |
+| `.dv`        | `video/x-dv`                  | DV video                  |
+| `.h265`      | `video/h265`                  | Raw HEVC stream           |
+| `.av1`       | `video/av1`                   | Raw AV1 stream            |
+| `.ffv1`      | `video/ffv1`                  | FFV1 archival codec       |
+| `.vc1`       | `video/vc1`                   | VC-1 video                |
+| `.ac3`       | `audio/ac3`                   | Dolby Digital             |
+| `.eac3`      | `audio/eac3`                  | Dolby Digital Plus        |
+| `.opus`      | `audio/opus`                  | Opus audio                |
+| `.flac`      | `audio/flac`                  | FLAC lossless             |
+| `.pcm-s16le` | `audio/x-pcm-s16le`           | Raw 16-bit PCM            |
+| `.pcm-s24le` | `audio/x-pcm-s24le`           | Raw 24-bit PCM            |
+| `.pcm-s32le` | `audio/x-pcm-s32le`           | Raw 32-bit PCM            |
+| `.stl`       | `application/x-ebu-stl`       | EBU STL subtitles         |
+| `.scc`       | `text/x-scc`                  | Scenarist Closed Captions |
+| `.cap`       | `application/x-cap`           | Softel CAP captions       |
+| `.890`       | `application/x-890`           | Cavena 890 subtitles      |
+| `.pac`       | `application/x-pac`           | Screen Electronics PAC    |
+| `.ass`       | `text/x-ass`                  | Advanced SubStation Alpha |
+| `.ssa`       | `text/x-ssa`                  | SubStation Alpha          |
+| `.exr`       | `image/x-exr`                 | OpenEXR                   |
+| `.cin`       | `image/x-cin`                 | Cineon                    |
+| `.ism`       | `application/vnd.ms-sstr+xml` | Smooth Streaming          |
+
+## API
+
+### `lookup(name: string): string | null`
+
+Returns the MIME type for the given filename or path, or `null` if unknown.
+
+### `extension(mimeType: string, fileName?: string): string | null`
+
+Returns the file extension for the given MIME type, or `null` if unknown. The optional `fileName` parameter is used to disambiguate (e.g. `video/quicktime` → `mov` when the filename ends in `.mov`).
+
+## License
+
+MIT

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export declare function lookup(name: string): string | null;
+export declare function extension(mimeType: string): string | null;

package/lib/index.js

@@ -0,0 +1,126 @@
+import mime from 'mime'
+
+const EXT_TO_MIME                         = {
+  // Broadcast containers
+  nut: 'video/x-nut',
+  aaf: 'application/octet-stream',
+  lxf: 'application/octet-stream',
+
+  // Raw codecs
+  dnxhd: 'video/x-dnxhd',
+  dnxhr: 'video/x-dnxhd',
+  dv: 'video/x-dv',
+  h265: 'video/h265',
+  265: 'video/h265',
+  av1: 'video/av1',
+  ffv1: 'video/ffv1',
+  vc1: 'video/vc1',
+
+  // Raw PCM
+  'pcm-s32le': 'audio/x-pcm-s32le',
+  'pcm-s24le': 'audio/x-pcm-s24le',
+  'pcm-s16le': 'audio/x-pcm-s16le',
+
+  // Audio codecs missing extensions in mime-db
+  ac3: 'audio/ac3',
+  eac3: 'audio/eac3',
+  ec3: 'audio/eac3',
+  opus: 'audio/opus',
+  flac: 'audio/flac',
+
+  // Broadcast subtitle/caption formats
+  stl: 'application/x-ebu-stl',
+  scc: 'text/x-scc',
+  cap: 'application/x-cap',
+  890: 'application/x-890',
+  pac: 'application/x-pac',
+  ass: 'text/x-ass',
+  ssa: 'text/x-ssa',
+
+  // Imaging
+  exr: 'image/x-exr',
+  cin: 'image/x-cin',
+
+  // Streaming
+  ism: 'application/vnd.ms-sstr+xml',
+
+  // NOTE: Workaround for Chrome.
+  // See, https://bugs.chromium.org/p/chromium/issues/detail?id=227004.
+  mp3: 'audio/mp3',
+}
+
+const MIME_TO_EXT                         = {
+  // Broadcast containers
+  'video/x-nut': 'nut',
+  'video/nut': 'nut',
+
+  // Raw codecs
+  'video/x-dnxhd': 'dnxhd',
+  'video/dnxhd': 'dnxhd',
+  'video/x-dv': 'dv',
+  'video/dv': 'dv',
+  'video/h265': 'h265',
+  'video/av1': 'av1',
+  'video/ffv1': 'ffv1',
+  'video/vc1': 'vc1',
+
+  // Raw PCM
+  'audio/x-pcm-s32le': 'pcm-s32le',
+  'audio/pcm-s32le': 'pcm-s32le',
+  'audio/x-pcm-s24le': 'pcm-s24le',
+  'audio/pcm-s24le': 'pcm-s24le',
+  'audio/x-pcm-s16le': 'pcm-s16le',
+  'audio/pcm-s16le': 'pcm-s16le',
+
+  // Audio codecs
+  'audio/ac3': 'ac3',
+  'audio/eac3': 'eac3',
+  'audio/opus': 'opus',
+  'audio/flac': 'flac',
+
+  // Broadcast subtitle/caption formats
+  'application/x-ebu-stl': 'stl',
+  'text/x-scc': 'scc',
+  'application/x-cap': 'cap',
+  'application/x-890': '890',
+  'application/x-pac': 'pac',
+  'text/x-ass': 'ass',
+  'text/x-ssa': 'ssa',
+
+  // Imaging
+  'image/x-exr': 'exr',
+  'image/x-cin': 'cin',
+
+  // Streaming
+  'application/vnd.ms-sstr+xml': 'ism',
+
+  // QuickTime — prefer .mov over .qt
+  'video/quicktime': 'mov',
+}
+
+export function lookup(name        )                {
+  if (typeof name !== 'string' || name.length === 0) {
+    return null
+  }
+
+  const match = name.match(/\.([^.]+)$/)
+  const ext = match?.[1]?.toLowerCase()
+
+  if (ext && EXT_TO_MIME[ext]) {
+    return EXT_TO_MIME[ext]
+  }
+
+  return mime.getType(name)
+}
+
+export function extension(mimeType        )                {
+  if (typeof mimeType !== 'string' || mimeType.length === 0) {
+    return null
+  }
+
+  if (MIME_TO_EXT[mimeType]) {
+    return MIME_TO_EXT[mimeType]
+  }
+
+  return mime.getExtension(mimeType) || (mimeType || '').split('/').pop() || null
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nxtedition/mime",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc && amaroc ./src/index.ts && mv src/index.js lib/",
+    "prepublishOnly": "yarn build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test",
+    "test:ci": "node --test"
+  },
+  "dependencies": {
+    "mime": "^4.0.7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "amaroc": "^1.0.1",
+    "oxlint-tsgolint": "^0.13.0",
+    "rimraf": "^6.1.3",
+    "typescript": "^5.9.3"
+  },
+  "gitHead": "a54f10182ade3ca92e198dce10ff06d059d296b8"
+}