Method initializeWatcher

api/src/extensions/manager.ts:474–526

* Start the chokidar watcher for extensions on the local filesystem

()

	 * Start the chokidar watcher for extensions on the local filesystem
	 */
	private initializeWatcher(): void {
		const logger = useLogger();

		logger.info('Watching extensions for changes...');

		const extensionDirPath = pathToRelativeUrl(getExtensionsPath());

		const resolvedExtDir = path.resolve(extensionDirPath);

		this.watcher = chokidar.watch([path.resolve('package.json'), extensionDirPath], {
			ignoreInitial: true,
			// Only top level watch inside extensions folder is necessary, "dist" paths are added via updateWatchedExtensions
			depth: 1,
			ignored: (val: string, stats?: Stats) => {
				if (val.includes('node_modules')) return true;

				// allow directory traversal so chokidar can reach nested package.json files
				if (!stats || stats.isDirectory()) return false;

				// allow root package.json and package.json in direct extension dirs (extensionsDir/*/package.json)
				if (val.endsWith('package.json')) {
					const resolvedVal = path.resolve(val);

					// root package.json
					if (!resolvedVal.startsWith(resolvedExtDir + path.sep)) return false;

					// allow if within an extension folder dir
					return path.dirname(resolvedVal) === resolvedExtDir;
				}

				// allow "dist" entrypoints added via updateWatchedExtensions
				if (this.isWatchedExtensionPath(val)) return false;

				return true;
			},
			// on macOS dotdirs in linked extensions are watched too
			followSymlinks: os.platform() === 'darwin' ? false : true,
		});

		this.watcher
			.on(
				'add',
				debounce(() => this.reload(), 500),
			)
			.on(
				'change',
				debounce(() => this.reload(), 650),
			)
			.on(
				'unlink',
				debounce(() => this.reload(), 2000),
			);
	}

	/**
	 * Close and destroy the local filesystem watcher if enabled