@kmamal/watcher 0.0.1

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2023 Konstantin M
+
+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,6 @@
+# @kmamal/watcher
+
+[![Package](https://img.shields.io/npm/v/%2540kmamal%252Fwatcher)](https://www.npmjs.com/package/@kmamal/watcher)
+[![Dependencies](https://img.shields.io/librariesio/release/npm/@kmamal/watcher)](https://libraries.io/npm/@kmamal%2Fwatcher)
+[![Count](https://badgen.net/bundlephobia/dependency-count/@kmamal/watcher)](https://bundlephobia.com/package/@kmamal/watcher)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

package/package.json

@@ -0,0 +1,25 @@
+{
+  "version": "0.0.1",
+  "name": "@kmamal/watcher",
+  "description": "watcher",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:kmamal/watcher.git"
+  },
+  "license": "MIT",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "scripts": {
+    "test": "npx @kmamal/testing",
+    "update-exports": "node ./scripts/update-exports.mjs"
+  },
+  "dependencies": {
+    "@kmamal/globs": "^0.0.1",
+    "@kmamal/util": "^0.1.13"
+  },
+  "devDependencies": {
+    "@kmamal/testing": "^0.0.24"
+  }
+}

package/src/index.js

@@ -0,0 +1,138 @@
+const Fs = require('fs')
+const Path = require('path')
+const { EventEmitter } = require('events')
+const { Matcher } = require('@kmamal/globs/matcher')
+const { comm } = require('@kmamal/util/array/comm')
+
+class Watcher extends EventEmitter {
+	constructor (glob, options) {
+		super()
+		this._cwd = options?.cwd ? Path.resolve(options.cwd) : process.cwd()
+		this._throttling = options?.throttling ?? 100
+
+		this._matcher = new Matcher(glob, options)
+		this._cache = new Map()
+		this._scheduled = new Set()
+
+		const addEntry = async (fsPath, props) => {
+			if (this._cache.has(fsPath)) { return }
+			const stats = props?.stats ?? await Fs.promises.stats()
+			const isDir = props?.isDir ?? stats.isDirectory()
+			const path = props?.path ?? (isDir ? `${fsPath}/` : fsPath)
+
+			const watcher = Fs.watch(fsPath, (event, relPath) => {
+				handleChange(isDir ? Path.join(fsPath, relPath) : fsPath)
+			})
+
+			let contents
+			if (isDir) {
+				contents = await Fs.promises.readdir(fsPath)
+				contents.sort()
+			}
+			this._cache.set(fsPath, {
+				watcher,
+				ino: stats.ino,
+				mtimeMs: stats.mtimeMs,
+				contents,
+			})
+
+			const type = isDir ? 'addDir' : 'addFile'
+			this.emit('change', type, path, stats)
+
+			if (isDir && !props?.exhaustive) {
+				const fileIterator = this._matcher.getFiles({
+					cwd: fsPath,
+					includeDirs: true,
+				})
+				for await (const entry of fileIterator) {
+					const { path: childPath, stats: childStats } = entry
+					const childIsDir = childStats.isDirectory()
+					const childFsPath = childIsDir ? childPath.slice(0, -1) : childPath
+					await addEntry(childFsPath, {
+						stats: childStats,
+						path: childPath,
+						isDir: childIsDir,
+						exhaustive: true,
+					})
+				}
+			}
+		}
+
+		const removeEntry = (fsPath, props) => {
+			const entry = props?.entry ?? this._cache.get(fsPath)
+			if (!entry) { return }
+			const isDir = props?.isDir ?? Boolean(entry.contents)
+			const path = props?.isDir ?? (isDir ? `${fsPath}/` : fsPath)
+
+			entry.watcher.close()
+			this._cache.delete(fsPath)
+
+			if (isDir && !props?.exhaustive) {
+				for (const name of entry.contents) {
+					removeEntry(Path.join(fsPath, name))
+				}
+			}
+
+			const type = isDir ? 'delDir' : 'delFile'
+			this.emit('change', type, path)
+		}
+
+		const handleChange = (fsPath) => {
+			if (this._scheduled.has(fsPath)) { return }
+			this._scheduled.add(fsPath)
+			setTimeout(() => {
+				this._scheduled.delete(fsPath)
+				_handleChange(fsPath)
+			}, this._throttling)
+		}
+
+		const _handleChange = async (fsPath) => {
+			let entry = this._cache.get(fsPath)
+
+			try {
+				const newStats = await Fs.promises.stat(fsPath)
+				const isDir = newStats.isDirectory()
+				const newPath = isDir ? `${fsPath}/` : fsPath
+
+				const wasDir = Boolean(entry?.contents)
+				const oldPath = wasDir ? `${fsPath}/` : fsPath
+
+				if (!entry || wasDir !== isDir || entry.ino !== newStats.ino) {
+					if (entry) { removeEntry(fsPath, { entry, path: oldPath, isDir: wasDir }) }
+					entry = addEntry(fsPath, { stats: newStats, path: newPath, isDir })
+					return
+				}
+
+				if (entry.mtimeMs >= newStats.mtimeMs) { return }
+
+				if (!isDir) {
+					this.emit('change', 'change', newPath, newStats)
+				} else {
+					const newContents = await Fs.promises.readdir(fsPath)
+					newContents.sort()
+
+					const { a, b } = comm(entry.contents, newContents)
+					for (const name of a) {
+						removeEntry(Path.join(fsPath, name))
+					}
+					for (const name of b) {
+						addEntry(Path.join(fsPath, name))
+					}
+				}
+			} catch (error) {
+				if (entry) { removeEntry(fsPath, { entry }) }
+			}
+		}
+
+		;(async () => {
+			const fileIterator = this._matcher.getFiles({ includeDirs: true })
+			for await (const { path, stats } of fileIterator) {
+				const isDir = stats.isDirectory()
+				const fsPath = isDir ? path.slice(0, -1) : path
+				await addEntry(fsPath, { stats, path, isDir, exhaustive: true })
+			}
+		})()
+	}
+}
+
+module.exports = { Watcher }