@ohos-ports/pm2 0.0.0-stage → 7.1.2-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (267) hide show
  1. package/CHANGELOG.md +2607 -0
  2. package/CONTRIBUTING.md +124 -0
  3. package/GNU-AGPL-3.0.txt +665 -0
  4. package/LICENSE +1 -0
  5. package/README.md +255 -2
  6. package/SECURITY.md +41 -0
  7. package/bin/pm2 +3 -0
  8. package/bin/pm2-dev +3 -0
  9. package/bin/pm2-docker +3 -0
  10. package/bin/pm2-runtime +3 -0
  11. package/bin/pm2.ps1 +3 -0
  12. package/constants.js +113 -0
  13. package/index.js +12 -0
  14. package/lib/API/Configuration.js +212 -0
  15. package/lib/API/Containerizer.js +335 -0
  16. package/lib/API/Dashboard.js +726 -0
  17. package/lib/API/Deploy.js +117 -0
  18. package/lib/API/Extra.js +798 -0
  19. package/lib/API/ExtraMgmt/Docker.js +30 -0
  20. package/lib/API/Log.js +388 -0
  21. package/lib/API/LogManagement.js +351 -0
  22. package/lib/API/Modules/LOCAL.js +122 -0
  23. package/lib/API/Modules/Modularizer.js +148 -0
  24. package/lib/API/Modules/NPM.js +443 -0
  25. package/lib/API/Modules/TAR.js +368 -0
  26. package/lib/API/Modules/flagExt.js +46 -0
  27. package/lib/API/Modules/index.js +120 -0
  28. package/lib/API/Monit.js +247 -0
  29. package/lib/API/Serve.js +497 -0
  30. package/lib/API/Startup.js +630 -0
  31. package/lib/API/UX/helpers.js +213 -0
  32. package/lib/API/UX/index.js +9 -0
  33. package/lib/API/UX/pm2-describe.js +197 -0
  34. package/lib/API/UX/pm2-ls-minimal.js +31 -0
  35. package/lib/API/UX/pm2-ls.js +581 -0
  36. package/lib/API/Version.js +383 -0
  37. package/lib/API/interpreter.json +12 -0
  38. package/lib/API/pm2-plus/PM2IO.js +381 -0
  39. package/lib/API/pm2-plus/auth-strategies/CliAuth.js +306 -0
  40. package/lib/API/pm2-plus/auth-strategies/WebAuth.js +195 -0
  41. package/lib/API/pm2-plus/helpers.js +97 -0
  42. package/lib/API/pm2-plus/link.js +126 -0
  43. package/lib/API/pm2-plus/pres/motd +16 -0
  44. package/lib/API/pm2-plus/pres/motd.update +26 -0
  45. package/lib/API/pm2-plus/pres/welcome +28 -0
  46. package/lib/API/pm2-plus/process-selector.js +52 -0
  47. package/lib/API/schema.json +375 -0
  48. package/lib/API.js +1980 -0
  49. package/lib/Client.js +793 -0
  50. package/lib/Common.js +949 -0
  51. package/lib/Configuration.js +309 -0
  52. package/lib/Daemon.js +468 -0
  53. package/lib/Event.js +37 -0
  54. package/lib/God/ActionMethods.js +955 -0
  55. package/lib/God/ClusterMode.js +192 -0
  56. package/lib/God/ForkMode.js +205 -0
  57. package/lib/God/Methods.js +292 -0
  58. package/lib/God/Reload.js +300 -0
  59. package/lib/God/StdioLogger.js +239 -0
  60. package/lib/God.js +653 -0
  61. package/lib/HttpInterface.js +75 -0
  62. package/lib/OtelManager.js +74 -0
  63. package/lib/ProcessContainer.js +321 -0
  64. package/lib/ProcessContainerBun.js +355 -0
  65. package/lib/ProcessContainerFork.js +42 -0
  66. package/lib/ProcessContainerForkBun.js +31 -0
  67. package/lib/ProcessUtils.js +74 -0
  68. package/lib/TreeKill.js +111 -0
  69. package/lib/Utility.js +304 -0
  70. package/lib/VersionCheck.js +46 -0
  71. package/lib/Watcher.js +117 -0
  72. package/lib/Worker.js +200 -0
  73. package/lib/binaries/CLI.js +1092 -0
  74. package/lib/binaries/DevCLI.js +183 -0
  75. package/lib/binaries/Runtime.js +101 -0
  76. package/lib/binaries/Runtime4Docker.js +192 -0
  77. package/lib/completion.js +229 -0
  78. package/lib/completion.sh +40 -0
  79. package/lib/motd +36 -0
  80. package/lib/templates/Dockerfiles/Dockerfile-nodejs.tpl +8 -0
  81. package/lib/templates/ecosystem-es.tpl +24 -0
  82. package/lib/templates/ecosystem-simple-es.tpl +8 -0
  83. package/lib/templates/ecosystem-simple.tpl +6 -0
  84. package/lib/templates/ecosystem.tpl +22 -0
  85. package/lib/templates/init-scripts/launchd.tpl +35 -0
  86. package/lib/templates/init-scripts/openrc.tpl +52 -0
  87. package/lib/templates/init-scripts/pm2-init-amazon.sh +86 -0
  88. package/lib/templates/init-scripts/rcd-openbsd.tpl +41 -0
  89. package/lib/templates/init-scripts/rcd.tpl +44 -0
  90. package/lib/templates/init-scripts/smf.tpl +43 -0
  91. package/lib/templates/init-scripts/systemd-online.tpl +22 -0
  92. package/lib/templates/init-scripts/systemd.tpl +22 -0
  93. package/lib/templates/init-scripts/upstart.tpl +103 -0
  94. package/lib/templates/logrotate.d/pm2 +10 -0
  95. package/lib/templates/sample-apps/http-server/README.md +14 -0
  96. package/lib/templates/sample-apps/http-server/api.js +9 -0
  97. package/lib/templates/sample-apps/http-server/ecosystem.config.js +14 -0
  98. package/lib/templates/sample-apps/http-server/package.json +11 -0
  99. package/lib/templates/sample-apps/pm2-plus-metrics-actions/README.md +45 -0
  100. package/lib/templates/sample-apps/pm2-plus-metrics-actions/custom-metrics.js +66 -0
  101. package/lib/templates/sample-apps/pm2-plus-metrics-actions/ecosystem.config.js +12 -0
  102. package/lib/templates/sample-apps/pm2-plus-metrics-actions/package.json +11 -0
  103. package/lib/templates/sample-apps/python-app/README.md +4 -0
  104. package/lib/templates/sample-apps/python-app/echo.py +7 -0
  105. package/lib/templates/sample-apps/python-app/ecosystem.config.js +12 -0
  106. package/lib/templates/sample-apps/python-app/package.json +11 -0
  107. package/lib/tools/Config.js +251 -0
  108. package/lib/tools/SysMetrics.js +375 -0
  109. package/lib/tools/copydirSync.js +101 -0
  110. package/lib/tools/deleteFolderRecursive.js +19 -0
  111. package/lib/tools/find-package-json.js +74 -0
  112. package/lib/tools/fmt.js +72 -0
  113. package/lib/tools/interpreter.js +88 -0
  114. package/lib/tools/isbinaryfile.js +94 -0
  115. package/lib/tools/json5.js +752 -0
  116. package/lib/tools/multimeter/bar.js +111 -0
  117. package/lib/tools/multimeter/charm/encode.js +18 -0
  118. package/lib/tools/multimeter/charm/index.js +305 -0
  119. package/lib/tools/multimeter/index.js +76 -0
  120. package/lib/tools/open.js +56 -0
  121. package/lib/tools/passwd.js +58 -0
  122. package/lib/tools/pm2-config-keys.js +165 -0
  123. package/lib/tools/prompt.js +76 -0
  124. package/lib/tools/serviceStop.js +149 -0
  125. package/lib/tools/sexec.js +55 -0
  126. package/lib/tools/treeify.js +113 -0
  127. package/lib/tools/typestrip.js +55 -0
  128. package/lib/tools/which.js +120 -0
  129. package/lib/tools/xdg-open +861 -0
  130. package/modules/blessed/LICENSE +20 -0
  131. package/modules/blessed/README.md +34 -0
  132. package/modules/blessed/index.js +1 -0
  133. package/modules/blessed/lib/alias.js +526 -0
  134. package/modules/blessed/lib/blessed.js +32 -0
  135. package/modules/blessed/lib/colors.js +530 -0
  136. package/modules/blessed/lib/events.js +189 -0
  137. package/modules/blessed/lib/gpmclient.js +221 -0
  138. package/modules/blessed/lib/helpers.js +165 -0
  139. package/modules/blessed/lib/keys.js +339 -0
  140. package/modules/blessed/lib/program.js +4297 -0
  141. package/modules/blessed/lib/tput.js +3022 -0
  142. package/modules/blessed/lib/unicode.js +885 -0
  143. package/modules/blessed/lib/widget.js +32 -0
  144. package/modules/blessed/lib/widgets/box.js +34 -0
  145. package/modules/blessed/lib/widgets/element.js +2570 -0
  146. package/modules/blessed/lib/widgets/list.js +599 -0
  147. package/modules/blessed/lib/widgets/log.js +83 -0
  148. package/modules/blessed/lib/widgets/node.js +282 -0
  149. package/modules/blessed/lib/widgets/screen.js +2298 -0
  150. package/modules/blessed/lib/widgets/scrollablebox.js +389 -0
  151. package/modules/blessed/lib/widgets/scrollabletext.js +35 -0
  152. package/modules/blessed/lib/widgets/text.js +35 -0
  153. package/modules/blessed/usr/linux +0 -0
  154. package/modules/blessed/usr/windows-ansi +0 -0
  155. package/modules/blessed/usr/xterm +0 -0
  156. package/modules/blessed/usr/xterm-256color +0 -0
  157. package/modules/blessed/usr/xterm.termcap +243 -0
  158. package/modules/chokidar/LICENSE +21 -0
  159. package/modules/chokidar/VENDORED.md +76 -0
  160. package/modules/chokidar/index.js +979 -0
  161. package/modules/chokidar/lib/brace-expand.js +180 -0
  162. package/modules/chokidar/lib/constants.js +66 -0
  163. package/modules/chokidar/lib/fsevents-handler.js +526 -0
  164. package/modules/chokidar/lib/nodefs-handler.js +654 -0
  165. package/modules/fclone.js +49 -0
  166. package/modules/pm2-axon/index.js +2 -0
  167. package/modules/pm2-axon/lib/configurable/History.md +5 -0
  168. package/modules/pm2-axon/lib/configurable/Makefile +7 -0
  169. package/modules/pm2-axon/lib/configurable/Readme.md +57 -0
  170. package/modules/pm2-axon/lib/configurable/index.js +2 -0
  171. package/modules/pm2-axon/lib/configurable/lib/configurable.js +47 -0
  172. package/modules/pm2-axon/lib/configurable/package.json +68 -0
  173. package/modules/pm2-axon/lib/index.js +44 -0
  174. package/modules/pm2-axon/lib/plugins/queue.js +71 -0
  175. package/modules/pm2-axon/lib/plugins/round-robin.js +55 -0
  176. package/modules/pm2-axon/lib/sockets/pub-emitter.js +26 -0
  177. package/modules/pm2-axon/lib/sockets/pub.js +77 -0
  178. package/modules/pm2-axon/lib/sockets/pull.js +37 -0
  179. package/modules/pm2-axon/lib/sockets/push.js +32 -0
  180. package/modules/pm2-axon/lib/sockets/rep.js +73 -0
  181. package/modules/pm2-axon/lib/sockets/req.js +101 -0
  182. package/modules/pm2-axon/lib/sockets/sock.js +430 -0
  183. package/modules/pm2-axon/lib/sockets/sub-emitter.js +92 -0
  184. package/modules/pm2-axon/lib/sockets/sub.js +147 -0
  185. package/modules/pm2-axon/lib/utils.js +19 -0
  186. package/modules/pm2-axon-rpc/index.js +3 -0
  187. package/modules/pm2-axon-rpc/lib/client.js +63 -0
  188. package/modules/pm2-axon-rpc/lib/server.js +139 -0
  189. package/modules/pm2-io-agent/LICENSE +661 -0
  190. package/modules/pm2-io-agent/README.md +62 -0
  191. package/modules/pm2-io-agent/config.js +30 -0
  192. package/modules/pm2-io-agent/constants.js +118 -0
  193. package/modules/pm2-io-agent/index.js +2 -0
  194. package/modules/pm2-io-agent/src/InteractorClient.js +513 -0
  195. package/modules/pm2-io-agent/src/InteractorDaemon.js +455 -0
  196. package/modules/pm2-io-agent/src/PM2Client.js +112 -0
  197. package/modules/pm2-io-agent/src/PM2Interface.js +180 -0
  198. package/modules/pm2-io-agent/src/TransporterInterface.js +173 -0
  199. package/modules/pm2-io-agent/src/Utility.js +392 -0
  200. package/modules/pm2-io-agent/src/WatchDog.js +70 -0
  201. package/modules/pm2-io-agent/src/push/DataRetriever.js +77 -0
  202. package/modules/pm2-io-agent/src/push/PushInteractor.js +206 -0
  203. package/modules/pm2-io-agent/src/push/TransactionAggregator.js +670 -0
  204. package/modules/pm2-io-agent/src/reverse/ReverseInteractor.js +128 -0
  205. package/modules/pm2-io-agent/src/transporters/Transporter.js +129 -0
  206. package/modules/pm2-io-agent/src/transporters/WebsocketTransport.js +202 -0
  207. package/modules/pm2-io-agent/src/utils/BinaryHeap.js +135 -0
  208. package/modules/pm2-io-agent/src/utils/EDS.js +111 -0
  209. package/modules/pm2-io-agent/src/utils/probes/Histogram.js +204 -0
  210. package/modules/pm2-io-agent/src/utils/units.js +10 -0
  211. package/modules/pm2-io-bpm/configuration.js +141 -0
  212. package/modules/pm2-io-bpm/constants.js +10 -0
  213. package/modules/pm2-io-bpm/featureManager.js +110 -0
  214. package/modules/pm2-io-bpm/features/dependencies.js +48 -0
  215. package/modules/pm2-io-bpm/features/events.js +50 -0
  216. package/modules/pm2-io-bpm/features/metrics.js +102 -0
  217. package/modules/pm2-io-bpm/features/notify.js +238 -0
  218. package/modules/pm2-io-bpm/features/profiling.js +70 -0
  219. package/modules/pm2-io-bpm/features/tracing.js +174 -0
  220. package/modules/pm2-io-bpm/index.js +11 -0
  221. package/modules/pm2-io-bpm/metrics/eventLoopMetrics.js +136 -0
  222. package/modules/pm2-io-bpm/metrics/httpMetrics.js +175 -0
  223. package/modules/pm2-io-bpm/metrics/network.js +132 -0
  224. package/modules/pm2-io-bpm/metrics/runtime.js +161 -0
  225. package/modules/pm2-io-bpm/metrics/v8.js +104 -0
  226. package/modules/pm2-io-bpm/otel/constants.js +7 -0
  227. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/platform/index.js +17 -0
  228. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/platform/node/index.js +17 -0
  229. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/platform/node/util.js +51 -0
  230. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/transform.js +137 -0
  231. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/types.js +24 -0
  232. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/utils.js +23 -0
  233. package/modules/pm2-io-bpm/otel/custom-zipkin-exporter/zipkin.js +149 -0
  234. package/modules/pm2-io-bpm/pmx.js +380 -0
  235. package/modules/pm2-io-bpm/profilers/addonProfiler.js +193 -0
  236. package/modules/pm2-io-bpm/profilers/inspectorProfiler.js +302 -0
  237. package/modules/pm2-io-bpm/serviceManager.js +21 -0
  238. package/modules/pm2-io-bpm/services/actions.js +159 -0
  239. package/modules/pm2-io-bpm/services/inspector.js +43 -0
  240. package/modules/pm2-io-bpm/services/metrics.js +186 -0
  241. package/modules/pm2-io-bpm/services/runtimeStats.js +54 -0
  242. package/modules/pm2-io-bpm/services/transport.js +11 -0
  243. package/modules/pm2-io-bpm/transports/IPCTransport.js +115 -0
  244. package/modules/pm2-io-bpm/utils/BinaryHeap.js +134 -0
  245. package/modules/pm2-io-bpm/utils/EDS.js +113 -0
  246. package/modules/pm2-io-bpm/utils/EWMA.js +32 -0
  247. package/modules/pm2-io-bpm/utils/autocast.js +61 -0
  248. package/modules/pm2-io-bpm/utils/metrics/counter.js +33 -0
  249. package/modules/pm2-io-bpm/utils/metrics/gauge.js +23 -0
  250. package/modules/pm2-io-bpm/utils/metrics/histogram.js +192 -0
  251. package/modules/pm2-io-bpm/utils/metrics/meter.js +46 -0
  252. package/modules/pm2-io-bpm/utils/miscellaneous.js +19 -0
  253. package/modules/pm2-io-bpm/utils/module.js +67 -0
  254. package/modules/pm2-io-bpm/utils/shimmer.js +19 -0
  255. package/modules/pm2-io-bpm/utils/stackParser.js +160 -0
  256. package/modules/pm2-io-bpm/utils/transactionAggregator.js +429 -0
  257. package/modules/pm2-io-bpm/utils/units.js +16 -0
  258. package/modules/vizion/LICENSE +13 -0
  259. package/modules/vizion/README.md +133 -0
  260. package/modules/vizion/index.js +1 -0
  261. package/modules/vizion/lib/git/git.js +247 -0
  262. package/modules/vizion/lib/vizion.js +52 -0
  263. package/package.json +170 -4
  264. package/paths.js +121 -0
  265. package/pm2 +11 -0
  266. package/types/index.d.ts +732 -0
  267. package/types/tsconfig.json +14 -0
@@ -0,0 +1,526 @@
1
+ 'use strict';
2
+
3
+ const fs = require('fs');
4
+ const sysPath = require('path');
5
+ const { promisify } = require('util');
6
+
7
+ let fsevents;
8
+ try {
9
+ fsevents = require('fsevents');
10
+ } catch (error) {
11
+ if (process.env.CHOKIDAR_PRINT_FSEVENTS_REQUIRE_ERROR) console.error(error);
12
+ }
13
+
14
+ if (fsevents) {
15
+ // TODO: real check
16
+ const mtch = process.version.match(/v(\d+)\.(\d+)/);
17
+ if (mtch && mtch[1] && mtch[2]) {
18
+ const maj = Number.parseInt(mtch[1], 10);
19
+ const min = Number.parseInt(mtch[2], 10);
20
+ if (maj === 8 && min < 16) {
21
+ fsevents = undefined;
22
+ }
23
+ }
24
+ }
25
+
26
+ const {
27
+ EV_ADD,
28
+ EV_CHANGE,
29
+ EV_ADD_DIR,
30
+ EV_UNLINK,
31
+ EV_ERROR,
32
+ STR_DATA,
33
+ STR_END,
34
+ FSEVENT_CREATED,
35
+ FSEVENT_MODIFIED,
36
+ FSEVENT_DELETED,
37
+ FSEVENT_MOVED,
38
+ // FSEVENT_CLONED,
39
+ FSEVENT_UNKNOWN,
40
+ FSEVENT_FLAG_MUST_SCAN_SUBDIRS,
41
+ FSEVENT_TYPE_FILE,
42
+ FSEVENT_TYPE_DIRECTORY,
43
+ FSEVENT_TYPE_SYMLINK,
44
+
45
+ ROOT_GLOBSTAR,
46
+ DIR_SUFFIX,
47
+ DOT_SLASH,
48
+ FUNCTION_TYPE,
49
+ EMPTY_FN,
50
+ IDENTITY_FN
51
+ } = require('./constants');
52
+
53
+ const Depth = (value) => isNaN(value) ? {} : {depth: value};
54
+
55
+ const stat = promisify(fs.stat);
56
+ const lstat = promisify(fs.lstat);
57
+ const realpath = promisify(fs.realpath);
58
+
59
+ const statMethods = { stat, lstat };
60
+
61
+ /**
62
+ * @typedef {String} Path
63
+ */
64
+
65
+ /**
66
+ * @typedef {Object} FsEventsWatchContainer
67
+ * @property {Set<Function>} listeners
68
+ * @property {Function} rawEmitter
69
+ * @property {{stop: Function}} watcher
70
+ */
71
+
72
+ // fsevents instance helper functions
73
+ /**
74
+ * Object to hold per-process fsevents instances (may be shared across chokidar FSWatcher instances)
75
+ * @type {Map<Path,FsEventsWatchContainer>}
76
+ */
77
+ const FSEventsWatchers = new Map();
78
+
79
+ // Threshold of duplicate path prefixes at which to start
80
+ // consolidating going forward
81
+ const consolidateThreshhold = 10;
82
+
83
+ const wrongEventFlags = new Set([
84
+ 69888, 70400, 71424, 72704, 73472, 131328, 131840, 262912
85
+ ]);
86
+
87
+ /**
88
+ * Instantiates the fsevents interface
89
+ * @param {Path} path path to be watched
90
+ * @param {Function} callback called when fsevents is bound and ready
91
+ * @returns {{stop: Function}} new fsevents instance
92
+ */
93
+ const createFSEventsInstance = (path, callback) => {
94
+ const stop = fsevents.watch(path, callback);
95
+ return {stop};
96
+ };
97
+
98
+ /**
99
+ * Instantiates the fsevents interface or binds listeners to an existing one covering
100
+ * the same file tree.
101
+ * @param {Path} path - to be watched
102
+ * @param {Path} realPath - real path for symlinks
103
+ * @param {Function} listener - called when fsevents emits events
104
+ * @param {Function} rawEmitter - passes data to listeners of the 'raw' event
105
+ * @returns {Function} closer
106
+ */
107
+ function setFSEventsListener(path, realPath, listener, rawEmitter) {
108
+ let watchPath = sysPath.extname(realPath) ? sysPath.dirname(realPath) : realPath;
109
+
110
+ const parentPath = sysPath.dirname(watchPath);
111
+ let cont = FSEventsWatchers.get(watchPath);
112
+
113
+ // If we've accumulated a substantial number of paths that
114
+ // could have been consolidated by watching one directory
115
+ // above the current one, create a watcher on the parent
116
+ // path instead, so that we do consolidate going forward.
117
+ if (couldConsolidate(parentPath)) {
118
+ watchPath = parentPath;
119
+ }
120
+
121
+ const resolvedPath = sysPath.resolve(path);
122
+ const hasSymlink = resolvedPath !== realPath;
123
+
124
+ const filteredListener = (fullPath, flags, info) => {
125
+ if (hasSymlink) fullPath = fullPath.replace(realPath, resolvedPath);
126
+ if (
127
+ fullPath === resolvedPath ||
128
+ !fullPath.indexOf(resolvedPath + sysPath.sep)
129
+ ) listener(fullPath, flags, info);
130
+ };
131
+
132
+ // check if there is already a watcher on a parent path
133
+ // modifies `watchPath` to the parent path when it finds a match
134
+ let watchedParent = false;
135
+ for (const watchedPath of FSEventsWatchers.keys()) {
136
+ if (realPath.indexOf(sysPath.resolve(watchedPath) + sysPath.sep) === 0) {
137
+ watchPath = watchedPath;
138
+ cont = FSEventsWatchers.get(watchPath);
139
+ watchedParent = true;
140
+ break;
141
+ }
142
+ }
143
+
144
+ if (cont || watchedParent) {
145
+ cont.listeners.add(filteredListener);
146
+ } else {
147
+ cont = {
148
+ listeners: new Set([filteredListener]),
149
+ rawEmitter,
150
+ watcher: createFSEventsInstance(watchPath, (fullPath, flags) => {
151
+ if (!cont.listeners.size) return;
152
+ if (flags & FSEVENT_FLAG_MUST_SCAN_SUBDIRS) return;
153
+ const info = fsevents.getInfo(fullPath, flags);
154
+ cont.listeners.forEach(list => {
155
+ list(fullPath, flags, info);
156
+ });
157
+
158
+ cont.rawEmitter(info.event, fullPath, info);
159
+ })
160
+ };
161
+ FSEventsWatchers.set(watchPath, cont);
162
+ }
163
+
164
+ // removes this instance's listeners and closes the underlying fsevents
165
+ // instance if there are no more listeners left
166
+ return () => {
167
+ const lst = cont.listeners;
168
+
169
+ lst.delete(filteredListener);
170
+ if (!lst.size) {
171
+ FSEventsWatchers.delete(watchPath);
172
+ if (cont.watcher) return cont.watcher.stop().then(() => {
173
+ cont.rawEmitter = cont.watcher = undefined;
174
+ Object.freeze(cont);
175
+ });
176
+ }
177
+ };
178
+ }
179
+
180
+ // Decide whether or not we should start a new higher-level
181
+ // parent watcher
182
+ const couldConsolidate = (path) => {
183
+ let count = 0;
184
+ for (const watchPath of FSEventsWatchers.keys()) {
185
+ if (watchPath.indexOf(path) === 0) {
186
+ count++;
187
+ if (count >= consolidateThreshhold) {
188
+ return true;
189
+ }
190
+ }
191
+ }
192
+
193
+ return false;
194
+ };
195
+
196
+ // returns boolean indicating whether fsevents can be used
197
+ const canUse = () => fsevents && FSEventsWatchers.size < 128;
198
+
199
+ // determines subdirectory traversal levels from root to path
200
+ const calcDepth = (path, root) => {
201
+ let i = 0;
202
+ while (!path.indexOf(root) && (path = sysPath.dirname(path)) !== root) i++;
203
+ return i;
204
+ };
205
+
206
+ // returns boolean indicating whether the fsevents' event info has the same type
207
+ // as the one returned by fs.stat
208
+ const sameTypes = (info, stats) => (
209
+ info.type === FSEVENT_TYPE_DIRECTORY && stats.isDirectory() ||
210
+ info.type === FSEVENT_TYPE_SYMLINK && stats.isSymbolicLink() ||
211
+ info.type === FSEVENT_TYPE_FILE && stats.isFile()
212
+ )
213
+
214
+ /**
215
+ * @mixin
216
+ */
217
+ class FsEventsHandler {
218
+
219
+ /**
220
+ * @param {import('../index').FSWatcher} fsw
221
+ */
222
+ constructor(fsw) {
223
+ this.fsw = fsw;
224
+ }
225
+ checkIgnored(path, stats) {
226
+ const ipaths = this.fsw._ignoredPaths;
227
+ if (this.fsw._isIgnored(path, stats)) {
228
+ ipaths.add(path);
229
+ if (stats && stats.isDirectory()) {
230
+ ipaths.add(path + ROOT_GLOBSTAR);
231
+ }
232
+ return true;
233
+ }
234
+
235
+ ipaths.delete(path);
236
+ ipaths.delete(path + ROOT_GLOBSTAR);
237
+ }
238
+
239
+ addOrChange(path, fullPath, realPath, parent, watchedDir, item, info, opts) {
240
+ const event = watchedDir.has(item) ? EV_CHANGE : EV_ADD;
241
+ this.handleEvent(event, path, fullPath, realPath, parent, watchedDir, item, info, opts);
242
+ }
243
+
244
+ async checkExists(path, fullPath, realPath, parent, watchedDir, item, info, opts) {
245
+ try {
246
+ const stats = await stat(path)
247
+ if (this.fsw.closed) return;
248
+ if (sameTypes(info, stats)) {
249
+ this.addOrChange(path, fullPath, realPath, parent, watchedDir, item, info, opts);
250
+ } else {
251
+ this.handleEvent(EV_UNLINK, path, fullPath, realPath, parent, watchedDir, item, info, opts);
252
+ }
253
+ } catch (error) {
254
+ if (error.code === 'EACCES') {
255
+ this.addOrChange(path, fullPath, realPath, parent, watchedDir, item, info, opts);
256
+ } else {
257
+ this.handleEvent(EV_UNLINK, path, fullPath, realPath, parent, watchedDir, item, info, opts);
258
+ }
259
+ }
260
+ }
261
+
262
+ handleEvent(event, path, fullPath, realPath, parent, watchedDir, item, info, opts) {
263
+ if (this.fsw.closed || this.checkIgnored(path)) return;
264
+
265
+ if (event === EV_UNLINK) {
266
+ const isDirectory = info.type === FSEVENT_TYPE_DIRECTORY
267
+ // suppress unlink events on never before seen files
268
+ if (isDirectory || watchedDir.has(item)) {
269
+ this.fsw._remove(parent, item, isDirectory);
270
+ }
271
+ } else {
272
+ if (event === EV_ADD) {
273
+ // track new directories
274
+ if (info.type === FSEVENT_TYPE_DIRECTORY) this.fsw._getWatchedDir(path);
275
+
276
+ if (info.type === FSEVENT_TYPE_SYMLINK && opts.followSymlinks) {
277
+ // push symlinks back to the top of the stack to get handled
278
+ const curDepth = opts.depth === undefined ?
279
+ undefined : calcDepth(fullPath, realPath) + 1;
280
+ return this._addToFsEvents(path, false, true, curDepth);
281
+ }
282
+
283
+ // track new paths
284
+ // (other than symlinks being followed, which will be tracked soon)
285
+ this.fsw._getWatchedDir(parent).add(item);
286
+ }
287
+ /**
288
+ * @type {'add'|'addDir'|'unlink'|'unlinkDir'}
289
+ */
290
+ const eventName = info.type === FSEVENT_TYPE_DIRECTORY ? event + DIR_SUFFIX : event;
291
+ this.fsw._emit(eventName, path);
292
+ if (eventName === EV_ADD_DIR) this._addToFsEvents(path, false, true);
293
+ }
294
+ }
295
+
296
+ /**
297
+ * Handle symlinks encountered during directory scan
298
+ * @param {String} watchPath - file/dir path to be watched with fsevents
299
+ * @param {String} realPath - real path (in case of symlinks)
300
+ * @param {Function} transform - path transformer
301
+ * @param {Function} globFilter - path filter in case a glob pattern was provided
302
+ * @returns {Function} closer for the watcher instance
303
+ */
304
+ _watchWithFsEvents(watchPath, realPath, transform, globFilter) {
305
+ if (this.fsw.closed || this.fsw._isIgnored(watchPath)) return;
306
+ const opts = this.fsw.options;
307
+ const watchCallback = async (fullPath, flags, info) => {
308
+ if (this.fsw.closed) return;
309
+ if (
310
+ opts.depth !== undefined &&
311
+ calcDepth(fullPath, realPath) > opts.depth
312
+ ) return;
313
+ const path = transform(sysPath.join(
314
+ watchPath, sysPath.relative(watchPath, fullPath)
315
+ ));
316
+ if (globFilter && !globFilter(path)) return;
317
+ // ensure directories are tracked
318
+ const parent = sysPath.dirname(path);
319
+ const item = sysPath.basename(path);
320
+ const watchedDir = this.fsw._getWatchedDir(
321
+ info.type === FSEVENT_TYPE_DIRECTORY ? path : parent
322
+ );
323
+
324
+ // correct for wrong events emitted
325
+ if (wrongEventFlags.has(flags) || info.event === FSEVENT_UNKNOWN) {
326
+ if (typeof opts.ignored === FUNCTION_TYPE) {
327
+ let stats;
328
+ try {
329
+ stats = await stat(path);
330
+ } catch (error) {}
331
+ if (this.fsw.closed) return;
332
+ if (this.checkIgnored(path, stats)) return;
333
+ if (sameTypes(info, stats)) {
334
+ this.addOrChange(path, fullPath, realPath, parent, watchedDir, item, info, opts);
335
+ } else {
336
+ this.handleEvent(EV_UNLINK, path, fullPath, realPath, parent, watchedDir, item, info, opts);
337
+ }
338
+ } else {
339
+ this.checkExists(path, fullPath, realPath, parent, watchedDir, item, info, opts);
340
+ }
341
+ } else {
342
+ switch (info.event) {
343
+ case FSEVENT_CREATED:
344
+ case FSEVENT_MODIFIED:
345
+ return this.addOrChange(path, fullPath, realPath, parent, watchedDir, item, info, opts);
346
+ case FSEVENT_DELETED:
347
+ case FSEVENT_MOVED:
348
+ return this.checkExists(path, fullPath, realPath, parent, watchedDir, item, info, opts);
349
+ }
350
+ }
351
+ };
352
+
353
+ const closer = setFSEventsListener(
354
+ watchPath,
355
+ realPath,
356
+ watchCallback,
357
+ this.fsw._emitRaw
358
+ );
359
+
360
+ this.fsw._emitReady();
361
+ return closer;
362
+ }
363
+
364
+ /**
365
+ * Handle symlinks encountered during directory scan
366
+ * @param {String} linkPath path to symlink
367
+ * @param {String} fullPath absolute path to the symlink
368
+ * @param {Function} transform pre-existing path transformer
369
+ * @param {Number} curDepth level of subdirectories traversed to where symlink is
370
+ * @returns {Promise<void>}
371
+ */
372
+ async _handleFsEventsSymlink(linkPath, fullPath, transform, curDepth) {
373
+ // don't follow the same symlink more than once
374
+ if (this.fsw.closed || this.fsw._symlinkPaths.has(fullPath)) return;
375
+
376
+ this.fsw._symlinkPaths.set(fullPath, true);
377
+ this.fsw._incrReadyCount();
378
+
379
+ try {
380
+ const linkTarget = await realpath(linkPath);
381
+ if (this.fsw.closed) return;
382
+ if (this.fsw._isIgnored(linkTarget)) {
383
+ return this.fsw._emitReady();
384
+ }
385
+
386
+ this.fsw._incrReadyCount();
387
+
388
+ // add the linkTarget for watching with a wrapper for transform
389
+ // that causes emitted paths to incorporate the link's path
390
+ this._addToFsEvents(linkTarget || linkPath, (path) => {
391
+ let aliasedPath = linkPath;
392
+ if (linkTarget && linkTarget !== DOT_SLASH) {
393
+ aliasedPath = path.replace(linkTarget, linkPath);
394
+ } else if (path !== DOT_SLASH) {
395
+ aliasedPath = sysPath.join(linkPath, path);
396
+ }
397
+ return transform(aliasedPath);
398
+ }, false, curDepth);
399
+ } catch(error) {
400
+ if (this.fsw._handleError(error)) {
401
+ return this.fsw._emitReady();
402
+ }
403
+ }
404
+ }
405
+
406
+ /**
407
+ *
408
+ * @param {Path} newPath
409
+ * @param {fs.Stats} stats
410
+ */
411
+ emitAdd(newPath, stats, processPath, opts, forceAdd) {
412
+ const pp = processPath(newPath);
413
+ const isDir = stats.isDirectory();
414
+ const dirObj = this.fsw._getWatchedDir(sysPath.dirname(pp));
415
+ const base = sysPath.basename(pp);
416
+
417
+ // ensure empty dirs get tracked
418
+ if (isDir) this.fsw._getWatchedDir(pp);
419
+ if (dirObj.has(base)) return;
420
+ dirObj.add(base);
421
+
422
+ if (!opts.ignoreInitial || forceAdd === true) {
423
+ this.fsw._emit(isDir ? EV_ADD_DIR : EV_ADD, pp, stats);
424
+ }
425
+ }
426
+
427
+ initWatch(realPath, path, wh, processPath) {
428
+ if (this.fsw.closed) return;
429
+ const closer = this._watchWithFsEvents(
430
+ wh.watchPath,
431
+ sysPath.resolve(realPath || wh.watchPath),
432
+ processPath,
433
+ wh.globFilter
434
+ );
435
+ this.fsw._addPathCloser(path, closer);
436
+ }
437
+
438
+ /**
439
+ * Handle added path with fsevents
440
+ * @param {String} path file/dir path or glob pattern
441
+ * @param {Function|Boolean=} transform converts working path to what the user expects
442
+ * @param {Boolean=} forceAdd ensure add is emitted
443
+ * @param {Number=} priorDepth Level of subdirectories already traversed.
444
+ * @returns {Promise<void>}
445
+ */
446
+ async _addToFsEvents(path, transform, forceAdd, priorDepth) {
447
+ if (this.fsw.closed) {
448
+ return;
449
+ }
450
+ const opts = this.fsw.options;
451
+ const processPath = typeof transform === FUNCTION_TYPE ? transform : IDENTITY_FN;
452
+
453
+ const wh = this.fsw._getWatchHelpers(path);
454
+
455
+ // evaluate what is at the path we're being asked to watch
456
+ try {
457
+ const stats = await statMethods[wh.statMethod](wh.watchPath);
458
+ if (this.fsw.closed) return;
459
+ if (this.fsw._isIgnored(wh.watchPath, stats)) {
460
+ throw null;
461
+ }
462
+ if (stats.isDirectory()) {
463
+ // emit addDir unless this is a glob parent
464
+ if (!wh.globFilter) this.emitAdd(processPath(path), stats, processPath, opts, forceAdd);
465
+
466
+ // don't recurse further if it would exceed depth setting
467
+ if (priorDepth && priorDepth > opts.depth) return;
468
+
469
+ // scan the contents of the dir
470
+ this.fsw._readdirp(wh.watchPath, {
471
+ fileFilter: entry => wh.filterPath(entry),
472
+ directoryFilter: entry => wh.filterDir(entry),
473
+ ...Depth(opts.depth - (priorDepth || 0))
474
+ }).on(STR_DATA, (entry) => {
475
+ // need to check filterPath on dirs b/c filterDir is less restrictive
476
+ if (this.fsw.closed) {
477
+ return;
478
+ }
479
+ if (entry.stats.isDirectory() && !wh.filterPath(entry)) return;
480
+
481
+ const joinedPath = sysPath.join(wh.watchPath, entry.path);
482
+ const {fullPath} = entry;
483
+
484
+ if (wh.followSymlinks && entry.stats.isSymbolicLink()) {
485
+ // preserve the current depth here since it can't be derived from
486
+ // real paths past the symlink
487
+ const curDepth = opts.depth === undefined ?
488
+ undefined : calcDepth(joinedPath, sysPath.resolve(wh.watchPath)) + 1;
489
+
490
+ this._handleFsEventsSymlink(joinedPath, fullPath, processPath, curDepth);
491
+ } else {
492
+ this.emitAdd(joinedPath, entry.stats, processPath, opts, forceAdd);
493
+ }
494
+ }).on(EV_ERROR, EMPTY_FN).on(STR_END, () => {
495
+ this.fsw._emitReady();
496
+ });
497
+ } else {
498
+ this.emitAdd(wh.watchPath, stats, processPath, opts, forceAdd);
499
+ this.fsw._emitReady();
500
+ }
501
+ } catch (error) {
502
+ if (!error || this.fsw._handleError(error)) {
503
+ // TODO: Strange thing: "should not choke on an ignored watch path" will be failed without 2 ready calls -__-
504
+ this.fsw._emitReady();
505
+ this.fsw._emitReady();
506
+ }
507
+ }
508
+
509
+ if (opts.persistent && forceAdd !== true) {
510
+ if (typeof transform === FUNCTION_TYPE) {
511
+ // realpath has already been resolved
512
+ this.initWatch(undefined, path, wh, processPath);
513
+ } else {
514
+ let realPath;
515
+ try {
516
+ realPath = await realpath(wh.watchPath);
517
+ } catch (e) {}
518
+ this.initWatch(realPath, path, wh, processPath);
519
+ }
520
+ }
521
+ }
522
+
523
+ }
524
+
525
+ module.exports = FsEventsHandler;
526
+ module.exports.canUse = canUse;