@neuxnet/neux-cli 0.2.3

package/src/core/watch.js

@@ -0,0 +1,113 @@
+import path from 'node:path'
+import fs from 'node:fs/promises'
+import chokidar from 'chokidar'
+import { DiminaCliError } from './errors.js'
+
+const DEFAULT_IGNORES = new Set(['.git', 'node_modules', 'dist', 'artifacts'])
+
+function isInsidePath(filePath, roots) {
+  return roots.some((root) => {
+    const relative = path.relative(root, filePath)
+    return relative === '' || (!!relative && !relative.startsWith('..') && !path.isAbsolute(relative))
+  })
+}
+
+function hasIgnoredSegment(filePath, projectRoot, ignoredNames) {
+  const relative = path.relative(projectRoot, filePath)
+  if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) return false
+  return relative.split(path.sep).some(name => ignoredNames.has(name) || name.startsWith('.DS_Store'))
+}
+
+export async function createProjectWatcher(options = {}) {
+  const projectRoot = path.resolve(options.project || options.projectPath || process.cwd())
+  const debounceMs = Number.parseInt(options.debounceMs ?? 120, 10)
+  const ignoredNames = new Set([...DEFAULT_IGNORES, ...(options.ignoreNames || [])])
+  const ignoredPaths = (options.ignorePaths || []).map(target => path.resolve(target))
+  const onChange = options.onChange
+
+  if (typeof onChange !== 'function') {
+    throw new DiminaCliError('DIMINA_WATCH_INVALID', 'createProjectWatcher requires an onChange callback')
+  }
+
+  const watcher = chokidar.watch(projectRoot, {
+    ignored: target => {
+      const filePath = path.resolve(String(target))
+      return isInsidePath(filePath, ignoredPaths) || hasIgnoredSegment(filePath, projectRoot, ignoredNames)
+    },
+    ignoreInitial: true,
+    atomic: true,
+    persistent: options.persistent !== false,
+  })
+
+  let closed = false
+  let timer = null
+  let pendingEvents = []
+  const knownMtimes = new Map()
+
+  const emit = (event) => {
+    pendingEvents.push(event)
+    clearTimeout(timer)
+    timer = setTimeout(() => {
+      if (!closed && pendingEvents.length) {
+        const events = pendingEvents
+        if (!closed) onChange({ ...events[0], events })
+      }
+      pendingEvents = []
+    }, debounceMs)
+  }
+
+  const handleChange = async (eventType, changedPath) => {
+    if (closed) return
+    const filePath = path.resolve(changedPath)
+    if (isInsidePath(filePath, ignoredPaths) || hasIgnoredSegment(filePath, projectRoot, ignoredNames)) return
+    try {
+      const stat = await fs.stat(filePath)
+      const previousMtime = knownMtimes.get(filePath)
+      knownMtimes.set(filePath, stat.mtimeMs)
+      if (eventType === 'change' && previousMtime === stat.mtimeMs) return
+    }
+    catch {
+      knownMtimes.delete(filePath)
+    }
+    emit({ eventType, path: filePath, projectPath: projectRoot })
+  }
+
+  watcher.on('add', filePath => handleChange('rename', filePath))
+  watcher.on('change', filePath => handleChange('change', filePath))
+  watcher.on('unlink', filePath => handleChange('rename', filePath))
+
+  await new Promise((resolve, reject) => {
+    const onReady = () => {
+      watcher.off('error', onError)
+      resolve()
+    }
+    const onError = error => {
+      watcher.off('ready', onReady)
+      reject(error)
+    }
+    watcher.once('ready', onReady)
+    watcher.once('error', onError)
+  })
+
+  const watched = watcher.getWatched()
+  await Promise.all(Object.entries(watched).flatMap(([directory, names]) => names.map(async name => {
+    const filePath = path.resolve(directory, name)
+    try {
+      knownMtimes.set(filePath, (await fs.stat(filePath)).mtimeMs)
+    }
+    catch {
+      // The file may have disappeared between chokidar's ready event and stat.
+    }
+  })))
+
+  return {
+    projectPath: projectRoot,
+    async close() {
+      if (closed) return
+      closed = true
+      clearTimeout(timer)
+      pendingEvents = []
+      await watcher.close()
+    },
+  }
+}