@sequencemedia/music-library 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# @sequencemedia/itunes-library
+
+Parses an `iTunes Library.xml` file and transforms it to [`m3u`](https://en.wikipedia.org/wiki/M3U) files, JSON, or JavaScript.
+
+The command line app can watch for changes to an `iTunes Library.xml` file and write `m3u` files to a destination directory.
+
+Or, the component functions can be imported into your own application. 
+
+This packages implements [`@sequencemedia/itunes-library-parser`](https://github.com/sequencemedia/itunes-library-parser).
+
+Requires [Java](https://www.oracle.com/java/technologies/javase-downloads.html) and [Saxon PE](https://www.saxonica.com/welcome/welcome.xml).
+
+## Command line app
+
+```
+npm run start -- --jar "/usr/local/bin/saxon/SaxonPE10-0J/saxon-pe-10.0.jar" --xml "~/Music/iTunes/iTunes Library.xml" --destination "~/Documents/iTunes Library"
+```
+
+Paths will differ on your device.
+
+## Library
+
+Transforms the entire library.
+
+```javascript
+const { toM3U } = require('./lib/library')
+const {
+  toJSON,
+  toJS,
+  toES
+ } = require('./lib/library/transform')
+```
+
+### `toM3U`
+
+Requires the arguments `jar`, `xml`, and `destination`.
+
+- `jar` - the path to the Saxon binary on your device
+- `xml` - the path to the `iTunes Library.xml` file
+- `destination` - the path for the `m3u` files to be written
+
+Returns a `Promise` resolving when all `m3u` files are written.
+
+### `toJSON`
+
+Requires the arguments `jar`, and `xml`.
+
+- `jar` - the path to the Saxon binary on your device
+- `xml` - the path to the `iTunes Library.xml` file
+
+Returns a `Promise` resolving to a `JSON` string.
+
+### `toJS`
+
+Requires the arguments `jar`, and `xml`.
+
+- `jar` - the path to the Saxon binary on your device
+- `xml` - the path to the `iTunes Library.xml` file
+
+Returns a `Promise` resolving to a JavaScript object.
+
+### `toES`
+
+Requires the arguments `jar`, and `xml`.
+
+- `jar` - the path to the Saxon binary on your device
+- `xml` - the path to the `iTunes Library.xml` file
+
+Returns a `Promise` resolving to a collection of JavaScript `Map` and `Set` instances.
+
+## Playlists
+
+Transforms the playlists.
+
+```javascript
+const { toM3U } = require('./lib/library/playlists')
+const {
+  toJSON,
+  toJS,
+  toES
+ } = require('./lib/library/playlists/transform')
+```
+
+See **Library**.
+
+## Tracks
+
+Transforms the tracks.
+
+```javascript
+const { toM3U } = require('./lib/library/tracks')
+const {
+  toJSON,
+  toJS,
+  toES
+ } = require('./lib/library/tracks/transform')
+```
+
+See **Library**.

package/app.mjs

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+import 'dotenv/config'
+
+import debug from 'debug'
+
+import {
+  readFile
+} from 'fs/promises'
+
+import psList from 'ps-list'
+
+import commander from 'commander'
+
+import * as watch from '#music-library/watch'
+
+const {
+  library,
+  library: {
+    tracks,
+    playlists
+  }
+} = watch
+
+const NAME = 'ml.App'
+process.title = NAME
+
+async function app () {
+  const PACKAGE = JSON.parse(await readFile('./package.json'))
+
+  const {
+    name
+  } = PACKAGE
+
+  /**
+   *  Permit only one instance of the application
+   */
+  try {
+    const a = (await psList())
+      .filter(({ name }) => name === NAME)
+
+    if (a.length > 1) {
+      const {
+        pid: PID
+      } = process
+
+      const {
+        pid
+      } = a.find(({ pid }) => pid !== PID)
+
+      const log = debug('music-library:process:log')
+
+      log(`Killing application "${name}" in process ${pid}.`)
+
+      process.kill(pid)
+    }
+  } catch ({ message }) {
+    const error = debug('music-library:process:error')
+
+    error(message)
+    return
+  }
+
+  const log = debug('@sequencemedia/music-library')
+
+  const {
+    pid,
+    argv,
+    env: {
+      JAR,
+      XML,
+      DESTINATION
+    }
+  } = process
+
+  log(`Starting application "${name}" in process ${pid}.`)
+
+  const {
+    version
+  } = PACKAGE
+
+  commander
+    .version(version)
+    .option('-j, --jar [jar]', 'Path to Saxon PE/EE JAR')
+    .option('-x, --xml [xml]', 'Path to iTunes Library XML')
+    .option('-d, --destination [destination]', 'Destination path for M3Us')
+    .option('-t, --tracks', 'Parse all tracks')
+    .option('-p, --playlists', 'Parse all playlists')
+    .parse(argv)
+
+  const {
+    jar = JAR,
+    xml = XML,
+    destination = DESTINATION,
+    tracks: t = false,
+    playlists: p = false
+  } = commander.opts()
+
+  const l = (
+    (t && p) || (!t && !p)
+  )
+
+  if (l) {
+    log(`Application "${name}" in process ${pid} watching Library.`)
+
+    log({ jar, xml, destination })
+
+    return (
+      library
+        .toM3U(jar, xml, destination)
+    )
+  } else {
+    if (t) {
+      log(`Application "${name}" in process ${pid} watching Tracks.`)
+
+      return (
+        tracks
+          .toM3U(jar, xml, destination)
+      )
+    }
+
+    if (p) {
+      log(`Application "${name}" in process ${pid} watching Playlists.`)
+
+      return (
+        playlists
+          .toM3U(jar, xml, destination)
+      )
+    }
+  }
+}
+
+export default app()

package/babel.config.cjs

@@ -0,0 +1,24 @@
+const presets = [
+  [
+    '@babel/env',
+    {
+      targets: {
+        node: 'current'
+      },
+      useBuiltIns: 'usage',
+      corejs: 3
+    }
+  ]
+]
+
+const plugins = [
+  '@babel/proposal-export-default-from',
+  '@babel/proposal-export-namespace-from'
+]
+
+module.exports = {
+  compact: true,
+  comments: false,
+  presets,
+  plugins
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@sequencemedia/music-library",
+  "version": "1.0.0",
+  "description": "Watch Apple Music Library XML and parse to JSON, JS, ES, or M3U",
+  "keywords": [
+    "music",
+    "library",
+    "xml",
+    "parser",
+    "music",
+    "audio",
+    "video",
+    "track",
+    "playlist",
+    "json",
+    "m3u",
+    "m3u8"
+  ],
+  "main": "./app.mjs",
+  "type": "module",
+  "author": "Jonathan Perry for Sequence Media Limited <sequencemedia@sequencemedia.net>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.13.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/sequencemedia/music-library"
+  },
+  "homepage": "https://github.com/sequencemedia/music-library",
+  "bugs": {
+    "url": "https://github.com/sequencemedia/music-library/issues"
+  },
+  "scripts": {
+    "lint": "eslint . --ext .mjs --ext .cjs",
+    "lint:fix": "npm run lint -- --fix",
+    "start": "cross-env DEBUG=@sequencemedia/music-library* NODE_ENV=production node .",
+    "start:dev": "cross-env DEBUG=@sequencemedia/music-library* NODE_ENV=development node ."
+  },
+  "dependencies": {
+    "@sequencemedia/music-library-parser": "1.0.0",
+    "chokidar": "^3.5.2",
+    "commander": "^8.3.0",
+    "cross-env": "^7.0.3",
+    "debug": "^4.3.3",
+    "dotenv": "^10.0.0",
+    "ps-list": "7.2.0",
+    "supports-color": "^9.2.1"
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.16.0",
+    "@babel/core": "^7.16.5",
+    "@babel/eslint-parser": "^7.16.5",
+    "@babel/plugin-proposal-export-default-from": "^7.16.5",
+    "@babel/plugin-proposal-export-namespace-from": "^7.16.5",
+    "@babel/preset-env": "^7.16.5",
+    "core-js": "^3.20.1",
+    "eslint": "7.32.0",
+    "eslint-config-standard": "^16.0.3",
+    "eslint-import-resolver-babel-module": "^5.3.1",
+    "eslint-plugin-import": "^2.25.3",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "5.2.0",
+    "rimraf": "^3.0.2"
+  },
+  "imports": {
+    "#music-library/common/normalise": "./src/common/normalise.mjs",
+    "#music-library/library": "./src/library/index.mjs",
+    "#music-library/watch": "./src/watch/index.mjs",
+    "#music-library/watch/library": "./src/watch/library/index.mjs",
+    "#music-library/watch/library/transform": "./src/watch/library/transform/index.mjs",
+    "#music-library/watch/library/playlists": "./src/watch/library/playlists/index.mjs",
+    "#music-library/watch/library/playlists/transform": "./src/watch/library/playlists/transform/index.mjs",
+    "#music-library/watch/library/tracks": "./src/watch/library/tracks/index.mjs",
+    "#music-library/watch/library/tracks/transform": "./src/watch/library/tracks/transform/index.mjs"
+  }
+}

package/src/common/normalise.mjs

@@ -0,0 +1,9 @@
+import {
+  homedir
+} from 'os'
+
+import path from 'path'
+
+const normalise = (p) => path.resolve(p.trim().replace(/^~/, homedir()))
+
+export default normalise

package/src/index.mjs

@@ -0,0 +1 @@
+export * as library from '#music-library/library'

package/src/library/index.js

@@ -0,0 +1,37 @@
+import debug from 'debug'
+
+import * as musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    toM3U: parseToM3U
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:error')
+
+export async function toM3U (jar, xml, destination) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    const d = destination
+      ? normalise(destination)
+      : destination
+
+    return await parseToM3U(j, x, d)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export * as tracks from './tracks'
+export * as playlists from './playlists'
+export * as transform from './transform'

package/src/library/playlists/index.js

@@ -0,0 +1,37 @@
+import debug from 'debug'
+
+import * as musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    playlists: {
+      toM3U: parseToM3U
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:error')
+
+export async function toM3U (jar, xml, destination) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    const d = destination
+      ? normalise(destination)
+      : destination
+
+    return await parseToM3U(j, x, d)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export * as transform from './transform'

package/src/library/playlists/transform/index.js

@@ -0,0 +1,67 @@
+import debug from 'debug'
+
+import * as musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    playlists: {
+      transform: {
+        toJSON: transformToJSON,
+        toJS: transformToJS,
+        toES: transformToES
+      }
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:transform:error')
+
+export async function toJSON (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToJSON(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export async function toJS (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToJS(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export async function toES (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToES(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}

package/src/library/tracks/index.js

@@ -0,0 +1,37 @@
+import debug from 'debug'
+
+import * as musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    tracks: {
+      toM3U: parseToM3U
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:error')
+
+export async function toM3U (jar, xml, destination) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    const d = destination
+      ? normalise(destination)
+      : destination
+
+    return await parseToM3U(j, x, d)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export * as transform from './transform'

package/src/library/tracks/transform/index.js

@@ -0,0 +1,67 @@
+import debug from 'debug'
+
+import * as musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    tracks: {
+      transform: {
+        toJSON: transformToJSON,
+        toJS: transformToJS,
+        toES: transformToES
+      }
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:transform:error')
+
+export async function toJSON (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToJSON(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export async function toJS (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToJS(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export async function toES (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToES(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}

package/src/library/transform/index.js

@@ -0,0 +1,65 @@
+import debug from 'debug'
+
+import * as musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    transform: {
+      toJSON: transformToJSON,
+      toJS: transformToJS,
+      toES: transformToES
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:transform:error')
+
+export async function toJSON (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToJSON(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export async function toJS (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToJS(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}
+
+export async function toES (jar, xml) {
+  try {
+    const j = jar
+      ? normalise(jar)
+      : jar
+
+    const x = xml
+      ? normalise(xml)
+      : xml
+
+    return await transformToES(j, x)
+  } catch ({ message }) {
+    error(message)
+  }
+}

package/src/watch/index.mjs

@@ -0,0 +1 @@
+export * as library from '#music-library/watch/library'

package/src/watch/library/index.mjs

@@ -0,0 +1,42 @@
+import chokidar from 'chokidar'
+
+import debug from 'debug'
+
+import musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    toM3U: parseToM3U
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:error')
+
+export function toM3U (jar, xml, destination) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  const d = destination
+    ? normalise(destination)
+    : destination
+
+  return (
+    chokidar.watch(x)
+      .on('ready', () => parseToM3U(j, x, d))
+      .on('change', () => parseToM3U(j, x, d))
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export * as tracks from '#music-library/watch/library/tracks'
+export * as playlists from '#music-library/watch/library/playlists'
+export * as transform from '#music-library/watch/library/transform'

package/src/watch/library/playlists/index.mjs

@@ -0,0 +1,42 @@
+import chokidar from 'chokidar'
+
+import debug from 'debug'
+
+import musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    playlists: {
+      toM3U: parseToM3U
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:error')
+
+export function toM3U (jar, xml, destination) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  const d = destination
+    ? normalise(destination)
+    : destination
+
+  return (
+    chokidar.watch(x)
+      .on('ready', () => parseToM3U(j, x, d))
+      .on('change', () => parseToM3U(j, x, d))
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export * as transform from '#music-library/watch/library/playlists/transform'

package/src/watch/library/playlists/transform/index.mjs

@@ -0,0 +1,102 @@
+import chokidar from 'chokidar'
+
+import debug from 'debug'
+
+import musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    playlists: {
+      transform: {
+        toJSON: transformToJSON,
+        toJS: transformToJS,
+        toES: transformToES
+      }
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:transform:error')
+
+export function toJSON (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToJSON(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToJSON(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export function toJS (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToJS(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToJS(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export function toES (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToES(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToES(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}

package/src/watch/library/tracks/index.mjs

@@ -0,0 +1,42 @@
+import chokidar from 'chokidar'
+
+import debug from 'debug'
+
+import musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    tracks: {
+      toM3U: parseToM3U
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:error')
+
+export function toM3U (jar, xml, destination) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  const d = destination
+    ? normalise(destination)
+    : destination
+
+  return (
+    chokidar.watch(x)
+      .on('ready', () => parseToM3U(j, x, d))
+      .on('change', () => parseToM3U(j, x, d))
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export * as transform from '#music-library/watch/library/tracks/transform'

package/src/watch/library/tracks/transform/index.mjs

@@ -0,0 +1,102 @@
+import chokidar from 'chokidar'
+
+import debug from 'debug'
+
+import musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    tracks: {
+      transform: {
+        toJSON: transformToJSON,
+        toJS: transformToJS,
+        toES: transformToES
+      }
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:transform:error')
+
+export function toJSON (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToJSON(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToJSON(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export function toJS (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToJS(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToJS(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export function toES (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToES(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToES(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}

package/src/watch/library/transform/index.mjs

@@ -0,0 +1,100 @@
+import chokidar from 'chokidar'
+
+import debug from 'debug'
+
+import musicLibraryParser from '@sequencemedia/music-library-parser'
+
+import normalise from '#music-library/common/normalise'
+
+const {
+  library: {
+    transform: {
+      toJSON: transformToJSON,
+      toJS: transformToJS,
+      toES: transformToES
+    }
+  }
+} = musicLibraryParser
+
+const error = debug('@sequencemedia/music-library:transform:error')
+
+export function toJSON (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToJSON(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToJSON(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export function toJS (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToJS(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToJS(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}
+
+export function toES (jar, xml, func = () => {}) {
+  const j = jar
+    ? normalise(jar)
+    : jar
+
+  const x = xml
+    ? normalise(xml)
+    : xml
+
+  return (
+    chokidar.watch(x)
+      .on('ready', async function ready () {
+        func(
+          await transformToES(j, x)
+        )
+      })
+      .on('change', async function change () {
+        func(
+          await transformToES(j, x)
+        )
+      })
+      .on('error', ({ message }) => {
+        error(`Error in watcher: "${message}"`)
+      })
+  )
+}