@whyour/qinglong 2.21.0 → 2.23.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 (362) hide show
  1. package/.dockerignore +13 -0
  2. package/.env.example +7 -0
  3. package/AGENTS.md +2 -2
  4. package/README-en.md +24 -0
  5. package/README.md +24 -0
  6. package/back/protos/api.proto +9 -1
  7. package/back/protos/cron.proto +8 -1
  8. package/deploy/kubernetes/README.md +81 -0
  9. package/deploy/kubernetes/base/kustomization.yaml +5 -0
  10. package/deploy/kubernetes/base/qinglong.yaml +95 -0
  11. package/deploy/kubernetes/overlays/example/kustomization.yaml +10 -0
  12. package/docker/Dockerfile +31 -12
  13. package/docker/Dockerfile.310 +31 -12
  14. package/docker/Dockerfile.debian +22 -14
  15. package/docker/Dockerfile.debian310 +24 -14
  16. package/docker/build-manifest.cjs +28 -0
  17. package/docker/verify-build.cjs +49 -0
  18. package/docs/development/node-cron-migration.md +49 -0
  19. package/docs/development/task-startup.md +78 -0
  20. package/docs/releases/2.22.0-validation.md +49 -0
  21. package/docs/releases/2.22.0.md +62 -0
  22. package/docs/releases/2.23.0.md +33 -0
  23. package/docs/script-history.md +53 -0
  24. package/ecosystem.config.js +10 -1
  25. package/package.json +19 -13
  26. package/sample/config.sample.sh +17 -2
  27. package/sample/notify.js +118 -0
  28. package/sample/notify.py +93 -0
  29. package/scripts/benchmark-execution.cjs +96 -0
  30. package/scripts/benchmark-script-history.cjs +39 -0
  31. package/scripts/publish-static.sh +34 -0
  32. package/scripts/sync-static.sh +20 -0
  33. package/scripts/wait-for-mirror.sh +214 -0
  34. package/scripts/write-build-info.cjs +27 -0
  35. package/shell/api.sh +96 -83
  36. package/shell/check.sh +59 -19
  37. package/shell/lang/en.sh +6 -0
  38. package/shell/lang/zh.sh +6 -0
  39. package/shell/node_path_cache.sh +136 -0
  40. package/shell/otask.sh +17 -10
  41. package/shell/preload/sitecustomize.js +11 -3
  42. package/shell/preload/sitecustomize.py +4 -2
  43. package/shell/share.sh +27 -10
  44. package/shell/start.sh +6 -3
  45. package/shell/task-timeout.sh +63 -0
  46. package/shell/task.sh +21 -9
  47. package/shell/update.sh +104 -98
  48. package/shell/upgrade.cjs +8 -0
  49. package/static/build/api/clientIp.js +42 -0
  50. package/static/build/api/config.js +9 -21
  51. package/static/build/api/cron.js +39 -3
  52. package/static/build/api/dashboard.js +50 -6
  53. package/static/build/api/env.js +17 -16
  54. package/static/build/api/health.js +2 -2
  55. package/static/build/api/index.js +4 -0
  56. package/static/build/api/log.js +39 -19
  57. package/static/build/api/open.js +2 -1
  58. package/static/build/api/retention.js +63 -0
  59. package/static/build/api/script.js +172 -25
  60. package/static/build/api/subscription.js +19 -8
  61. package/static/build/api/system.js +66 -12
  62. package/static/build/api/user.js +75 -15
  63. package/static/build/app.js +63 -54
  64. package/static/build/bootstrap/database.js +51 -0
  65. package/static/build/config/const.js +2 -0
  66. package/static/build/config/grpcCerts.js +93 -44
  67. package/static/build/config/index.js +0 -4
  68. package/static/build/config/share.js +5 -4
  69. package/static/build/config/subscription.js +19 -11
  70. package/static/build/config/util.js +142 -45
  71. package/static/build/data/cron.js +1 -0
  72. package/static/build/data/notify.js +18 -1
  73. package/static/build/data/sock.js +1 -0
  74. package/static/build/loaders/app.js +8 -6
  75. package/static/build/loaders/db.js +5 -35
  76. package/static/build/loaders/deps.js +30 -22
  77. package/static/build/loaders/express.js +46 -32
  78. package/static/build/loaders/initData.js +26 -33
  79. package/static/build/loaders/initFile.js +1 -1
  80. package/static/build/loaders/initTask.js +14 -3
  81. package/static/build/loaders/server.js +1 -1
  82. package/static/build/loaders/sock.js +72 -6
  83. package/static/build/middlewares/monitoring.js +12 -33
  84. package/static/build/middlewares/protectedPathCase.js +17 -0
  85. package/static/build/middlewares/uniqueConstraintError.js +15 -0
  86. package/static/build/protos/api.js +78 -2
  87. package/static/build/protos/cron.js +83 -5
  88. package/static/build/protos/health.js +1 -1
  89. package/static/build/schedule/addCron.js +67 -19
  90. package/static/build/schedule/api.js +5 -2
  91. package/static/build/schedule/client.js +56 -6
  92. package/static/build/schedule/delCron.js +11 -1
  93. package/static/build/schedule/health.js +72 -7
  94. package/static/build/schedule/setConcurrency.js +27 -0
  95. package/static/build/services/config.js +5 -43
  96. package/static/build/services/cron.js +389 -174
  97. package/static/build/services/dependence.js +66 -18
  98. package/static/build/services/env.js +1 -1
  99. package/static/build/services/grpc.js +4 -3
  100. package/static/build/services/health.js +4 -7
  101. package/static/build/services/http.js +9 -3
  102. package/static/build/services/log.js +2 -3
  103. package/static/build/services/metrics.js +46 -14
  104. package/static/build/services/notify.js +73 -5
  105. package/static/build/services/open.js +106 -31
  106. package/static/build/services/retention.js +123 -0
  107. package/static/build/services/schedule.js +77 -43
  108. package/static/build/services/script.js +4 -5
  109. package/static/build/services/scriptHistory.js +30 -0
  110. package/static/build/services/sshKey.js +39 -14
  111. package/static/build/services/subscription.js +161 -87
  112. package/static/build/services/system.js +116 -43
  113. package/static/build/services/user.js +255 -37
  114. package/static/build/shared/auth.js +22 -3
  115. package/static/build/shared/authMutation.js +17 -0
  116. package/static/build/shared/childProcess.js +82 -0
  117. package/static/build/shared/clientIp.js +27 -0
  118. package/static/build/shared/cronCommand.js +17 -0
  119. package/static/build/shared/cronSchedule.js +101 -0
  120. package/static/build/shared/cronScheduler.js +73 -0
  121. package/static/build/shared/errors.js +9 -0
  122. package/static/build/shared/fileAccess.js +60 -0
  123. package/static/build/shared/i18n.js +63 -4
  124. package/static/build/shared/logPath.js +15 -0
  125. package/static/build/shared/logReader.js +85 -0
  126. package/static/build/shared/logStreamManager.js +80 -60
  127. package/static/build/shared/loginThrottle.js +45 -0
  128. package/static/build/shared/pLimit.js +22 -8
  129. package/static/build/shared/password.js +30 -0
  130. package/static/build/shared/retention.js +58 -0
  131. package/static/build/shared/runCron.js +39 -17
  132. package/static/build/shared/schedulerMutationLock.js +44 -0
  133. package/static/build/shared/schedulerReadiness.js +82 -0
  134. package/static/build/shared/schemaMigrations.js +58 -0
  135. package/static/build/shared/scriptHistory.js +445 -0
  136. package/static/build/shared/shellQuote.js +11 -0
  137. package/static/build/shared/startupProcess.js +48 -0
  138. package/static/build/shared/store.js +7 -0
  139. package/static/build/shared/subscriptionMutationLock.js +34 -0
  140. package/static/build/shared/subscriptionPath.js +41 -0
  141. package/static/build/shared/subscriptionStorage.js +98 -0
  142. package/static/build/shared/trustProxy.js +119 -0
  143. package/static/build/shared/utils.js +2 -1
  144. package/static/build/token.js +3 -14
  145. package/static/build/validation/schedule.js +6 -12
  146. package/static/dist/{1885.e1ea09f6.async.js → 1885.b8f427bf.async.js} +1 -1
  147. package/static/dist/2031.6af40025.async.js +1 -0
  148. package/static/dist/2693.51c2636b.async.js +1 -0
  149. package/static/dist/{2890.9e373f5b.async.js → 2890.add55e85.async.js} +1 -1
  150. package/static/dist/2901.2ca95295.async.js +1 -0
  151. package/static/dist/292.264757f0.async.js +1 -0
  152. package/static/dist/3512.95e41255.async.js +1 -0
  153. package/static/dist/445.a65ff63b.async.js +1 -0
  154. package/static/dist/4736.1d2b5cb6.async.js +1 -0
  155. package/static/dist/{6013.4e38de36.async.js → 6013.db535339.async.js} +1 -1
  156. package/static/dist/6212.9e6d9913.async.js +1 -0
  157. package/static/dist/{6339.ab305e96.async.js → 6431.4603ad0e.async.js} +1 -1
  158. package/static/dist/{6872.42f939f1.async.js → 6872.a503ef55.async.js} +1 -1
  159. package/static/dist/7231.f7e5b668.async.js +1 -0
  160. package/static/dist/{7355.f9f263d8.async.js → 7355.fca746f5.async.js} +1 -1
  161. package/static/dist/{7508.7dcee91c.async.js → 7508.d90eac63.async.js} +1 -1
  162. package/static/dist/{7984.594296a5.async.js → 7984.eaac7402.async.js} +1 -1
  163. package/static/dist/8844.a0fef08e.async.js +1 -0
  164. package/static/dist/index.html +2 -2
  165. package/static/dist/layouts__index.633d3553.async.js +1 -0
  166. package/static/dist/preload_helper.01fcd534.js +1 -0
  167. package/static/dist/{src__pages__config__index.a22ff7dc.async.js → src__pages__config__index.9aba4054.async.js} +1 -1
  168. package/static/dist/src__pages__crontab__detail.86b2eebb.async.js +1 -0
  169. package/static/dist/src__pages__crontab__index.ae4e06f2.async.js +1 -0
  170. package/static/dist/{src__pages__crontab__logModal.0b8cce8c.async.js → src__pages__crontab__logModal.930535e2.async.js} +1 -1
  171. package/static/dist/src__pages__crontab__modal.a2c8fdcc.async.js +1 -0
  172. package/static/dist/src__pages__crontab__viewCreateModal.7b4f9cbe.async.js +1 -0
  173. package/static/dist/src__pages__crontab__viewManageModal.cd454ea0.async.js +1 -0
  174. package/static/dist/src__pages__dashboard__index.243c5a35.async.js +1 -0
  175. package/static/dist/src__pages__dashboard__taskResultModal.7795d6e1.async.js +1 -0
  176. package/static/dist/src__pages__dependence__index.874d501f.async.js +1 -0
  177. package/static/dist/src__pages__dependence__logModal.154efe7a.async.js +1 -0
  178. package/static/dist/src__pages__dependence__modal.0fa8b421.async.js +1 -0
  179. package/static/dist/src__pages__diff__index.b94e5dc5.async.js +1 -0
  180. package/static/dist/src__pages__env__editNameModal.c13d47d2.async.js +1 -0
  181. package/static/dist/src__pages__env__index.fd6fd2b0.async.js +1 -0
  182. package/static/dist/src__pages__env__modal.4d71adb3.async.js +1 -0
  183. package/static/dist/src__pages__error__index.aae50c94.async.js +1 -0
  184. package/static/dist/src__pages__initialization__index.82a2e967.async.js +1 -0
  185. package/static/dist/src__pages__log__index.71250e0d.async.js +1 -0
  186. package/static/dist/{src__pages__login__index.8c813eb1.async.js → src__pages__login__index.a0fd5ed8.async.js} +1 -1
  187. package/static/dist/src__pages__script__editModal.afabf073.async.js +1 -0
  188. package/static/dist/src__pages__script__editNameModal.789ad87b.async.js +1 -0
  189. package/static/dist/src__pages__script__historyDrawer.8c58d958.async.js +1 -0
  190. package/static/dist/src__pages__script__historyDrawer.a449193a.chunk.css +1 -0
  191. package/static/dist/src__pages__script__index.ab360776.chunk.css +1 -0
  192. package/static/dist/src__pages__script__index.fc575945.async.js +1 -0
  193. package/static/dist/src__pages__script__renameModal.0ab029e7.async.js +1 -0
  194. package/static/dist/src__pages__script__saveModal.8fca1a22.async.js +1 -0
  195. package/static/dist/src__pages__script__saveWithHistory.99ece830.async.js +1 -0
  196. package/static/dist/src__pages__script__setting.35ad4f02.async.js +1 -0
  197. package/static/dist/src__pages__setting__appModal.7eaeb9d3.async.js +1 -0
  198. package/static/dist/src__pages__setting__checkUpdate.d175b154.async.js +1 -0
  199. package/static/dist/src__pages__setting__clientIp.3a8711ed.async.js +1 -0
  200. package/static/dist/src__pages__setting__dependence.9c0f749b.async.js +1 -0
  201. package/static/dist/src__pages__setting__index.cb397741.async.js +1 -0
  202. package/static/dist/src__pages__setting__loginLog.e0a1f54d.async.js +1 -0
  203. package/static/dist/src__pages__setting__notification.2ffe4e5a.async.js +1 -0
  204. package/static/dist/src__pages__setting__other.3d0b8492.async.js +1 -0
  205. package/static/dist/{src__pages__setting__progress.8823ac90.async.js → src__pages__setting__progress.2ccae3d7.async.js} +1 -1
  206. package/static/dist/src__pages__setting__security.e2d71ebb.async.js +1 -0
  207. package/static/dist/src__pages__setting__systemLog.b3046955.async.js +1 -0
  208. package/static/dist/src__pages__subscription__index.43086a06.async.js +1 -0
  209. package/static/dist/src__pages__subscription__logModal.cdba5139.async.js +1 -0
  210. package/static/dist/src__pages__subscription__modal.30868ba8.async.js +1 -0
  211. package/static/dist/{umi.ca04a019.js → umi.3a24a9fa.js} +1 -1
  212. package/test/back/advisory-input-security.test.cjs +416 -0
  213. package/test/back/auth-security.test.cjs +74 -0
  214. package/test/back/build-provenance.test.cjs +150 -0
  215. package/test/back/code-scanning-security.test.cjs +189 -0
  216. package/test/back/cron-log-name.test.cjs +110 -0
  217. package/test/back/cron-macros.test.cjs +51 -0
  218. package/test/back/cron-schedule-compatibility.test.cjs +69 -0
  219. package/test/back/cron-scheduler-routing.test.cjs +59 -0
  220. package/test/back/cron-validation.test.cjs +45 -0
  221. package/test/back/dashboard-failures.test.cjs +173 -0
  222. package/test/back/database-bootstrap.test.cjs +193 -0
  223. package/test/back/dependence-cache-status.test.cjs +125 -0
  224. package/test/back/deprecated-file-routes.test.cjs +82 -0
  225. package/test/back/draft-path-security.test.cjs +235 -0
  226. package/test/back/ecosystem.test.cjs +28 -0
  227. package/test/back/env-import-security.test.cjs +91 -0
  228. package/test/back/env-name-parsing.test.cjs +96 -0
  229. package/test/back/execution-lifecycle.test.cjs +236 -0
  230. package/test/back/file-access-scope.test.cjs +180 -0
  231. package/test/back/file-access-security.test.cjs +47 -0
  232. package/test/back/fileTreeListing.test.cjs +57 -0
  233. package/test/back/grpc-cron-response.test.cjs +60 -0
  234. package/test/back/grpc-mtls-security.test.cjs +136 -0
  235. package/test/back/http-exclusive-listen.test.cjs +31 -0
  236. package/test/back/http-security.test.cjs +313 -0
  237. package/test/back/legacy-cron-recovery.test.cjs +76 -0
  238. package/test/back/linux-mirror-result.test.cjs +176 -0
  239. package/test/back/listen-security.test.cjs +68 -0
  240. package/test/back/log-path-security.test.cjs +158 -0
  241. package/test/back/logReader.test.cjs +72 -0
  242. package/test/back/manual-execution.test.cjs +85 -0
  243. package/test/back/manual-stop-claim.test.cjs +220 -0
  244. package/test/back/metrics.test.cjs +34 -0
  245. package/test/back/mirror-status.test.cjs +257 -0
  246. package/test/back/monitoring.test.cjs +73 -0
  247. package/test/back/node-cron-migration.test.cjs +65 -0
  248. package/test/back/node-path-cache.test.cjs +202 -0
  249. package/test/back/node-path-lock.test.cjs +182 -0
  250. package/test/back/npm-publication.test.cjs +70 -0
  251. package/test/back/preload-lazy-notify.test.cjs +168 -0
  252. package/test/back/primary-apm.test.cjs +24 -0
  253. package/test/back/process-exit-state.test.cjs +81 -0
  254. package/test/back/process-stop-signal.test.cjs +77 -0
  255. package/test/back/protected-path-case.test.cjs +58 -0
  256. package/test/back/qlServiceLogCommand.test.cjs +128 -0
  257. package/test/back/queued-cron-invalidation.test.cjs +98 -0
  258. package/test/back/restart-instance-recovery.test.cjs +116 -0
  259. package/test/back/retention.test.cjs +131 -0
  260. package/test/back/role-loading.test.cjs +118 -0
  261. package/test/back/schedule-health.test.cjs +86 -0
  262. package/test/back/scheduler-bulk-recovery.test.cjs +40 -0
  263. package/test/back/scheduler-concurrency.test.cjs +411 -0
  264. package/test/back/scheduler-file-lock.test.cjs +51 -0
  265. package/test/back/scheduler-mutation.test.cjs +312 -0
  266. package/test/back/scheduler-readiness.test.cjs +85 -0
  267. package/test/back/scheduler-reconciliation.test.cjs +206 -0
  268. package/test/back/scheduler-rpc-timeout.test.cjs +49 -0
  269. package/test/back/schema-migrations.test.cjs +127 -0
  270. package/test/back/script-file-access.test.cjs +210 -0
  271. package/test/back/script-history-api.test.cjs +551 -0
  272. package/test/back/script-history.test.cjs +383 -0
  273. package/test/back/shell-api-parsing.test.cjs +184 -0
  274. package/test/back/shell-translation-output.test.cjs +16 -0
  275. package/test/back/shell-upgrade.test.cjs +312 -0
  276. package/test/back/shellApiToken.test.cjs +151 -0
  277. package/test/back/sock-polling.test.cjs +297 -0
  278. package/test/back/sock-security.test.cjs +72 -0
  279. package/test/back/ssh-config-home.test.cjs +113 -0
  280. package/test/back/start-env-preservation.test.cjs +53 -0
  281. package/test/back/static-mirror-trigger.test.cjs +441 -0
  282. package/test/back/static-mirror.test.cjs +179 -0
  283. package/test/back/stop-failure-feedback.test.cjs +158 -0
  284. package/test/back/stop-race.test.cjs +171 -0
  285. package/test/back/subscription-cleanup.test.cjs +53 -0
  286. package/test/back/subscription-mutation-lock.test.cjs +83 -0
  287. package/test/back/subscription-review-regression.test.cjs +607 -0
  288. package/test/back/subscription-stop-state.test.cjs +66 -0
  289. package/test/back/subscription-storage-regression.test.cjs +553 -0
  290. package/test/back/system-dependence-cache.test.cjs +127 -0
  291. package/test/back/system-export-history.test.cjs +119 -0
  292. package/test/back/systemTokenRenewal.test.cjs +497 -0
  293. package/test/back/task-shell-lifecycle.test.cjs +194 -0
  294. package/test/back/task-time.test.cjs +116 -0
  295. package/test/back/unique-constraint-error.test.cjs +72 -0
  296. package/test/back/upgrade-guards.test.cjs +285 -0
  297. package/test/back/upgrade-lifecycle.test.cjs +288 -0
  298. package/test/back/upgrade-transaction.test.cjs +133 -0
  299. package/test/back/user-api.test.cjs +99 -0
  300. package/test/back/user-security.test.cjs +349 -0
  301. package/test/back/worker-apm.test.cjs +84 -0
  302. package/test/back/wpush-grpc.test.cjs +116 -0
  303. package/test/fixtures/legacy-cron.json +1371 -0
  304. package/test/front/cron-log-pagination.test.cjs +214 -0
  305. package/test/front/diff-file-routing.test.cjs +126 -0
  306. package/test/front/http-auth.test.cjs +152 -0
  307. package/test/front/http-error.test.cjs +29 -0
  308. package/test/front/script-history-save.test.cjs +121 -0
  309. package/test/helpers/load-security-module.cjs +42 -0
  310. package/test/helpers/upgrade-fixture.cjs +30 -0
  311. package/version.yaml +14 -34
  312. package/CLAUDE.md +0 -43
  313. package/static/dist/1147.c420132e.async.js +0 -1
  314. package/static/dist/134.54df9e38.async.js +0 -1
  315. package/static/dist/2096.6d98fd12.async.js +0 -1
  316. package/static/dist/2208.f7ba3dfa.async.js +0 -1
  317. package/static/dist/2286.164bb089.async.js +0 -1
  318. package/static/dist/3191.63263871.async.js +0 -1
  319. package/static/dist/4859.6592cebb.async.js +0 -1
  320. package/static/dist/4902.555f92ab.async.js +0 -1
  321. package/static/dist/5520.ff2cfd6b.async.js +0 -1
  322. package/static/dist/6431.c50479be.async.js +0 -1
  323. package/static/dist/6707.801b886b.async.js +0 -1
  324. package/static/dist/8826.2447a104.async.js +0 -1
  325. package/static/dist/layouts__index.a7a2bfe0.async.js +0 -1
  326. package/static/dist/preload_helper.0431c0f3.js +0 -1
  327. package/static/dist/src__pages__crontab__detail.b9c36808.async.js +0 -1
  328. package/static/dist/src__pages__crontab__index.fed99fd0.async.js +0 -1
  329. package/static/dist/src__pages__crontab__modal.f7041c7c.async.js +0 -1
  330. package/static/dist/src__pages__crontab__viewCreateModal.4d589f66.async.js +0 -1
  331. package/static/dist/src__pages__crontab__viewManageModal.0e317746.async.js +0 -1
  332. package/static/dist/src__pages__dashboard__index.b30f2f47.async.js +0 -1
  333. package/static/dist/src__pages__dependence__index.3d87ceac.async.js +0 -1
  334. package/static/dist/src__pages__dependence__logModal.0681830b.async.js +0 -1
  335. package/static/dist/src__pages__dependence__modal.11124896.async.js +0 -1
  336. package/static/dist/src__pages__diff__index.013b7c75.async.js +0 -1
  337. package/static/dist/src__pages__env__editNameModal.5d264b25.async.js +0 -1
  338. package/static/dist/src__pages__env__index.baa27d4e.async.js +0 -1
  339. package/static/dist/src__pages__env__modal.7f2ef1bc.async.js +0 -1
  340. package/static/dist/src__pages__error__index.f156b45e.async.js +0 -1
  341. package/static/dist/src__pages__initialization__index.e96d4ba8.async.js +0 -1
  342. package/static/dist/src__pages__log__index.e0978bae.async.js +0 -1
  343. package/static/dist/src__pages__script__editModal.cbf4ec0e.async.js +0 -1
  344. package/static/dist/src__pages__script__editNameModal.3e7e100d.async.js +0 -1
  345. package/static/dist/src__pages__script__index.2765d1b8.async.js +0 -1
  346. package/static/dist/src__pages__script__index.60b6f827.chunk.css +0 -1
  347. package/static/dist/src__pages__script__renameModal.5e987ef5.async.js +0 -1
  348. package/static/dist/src__pages__script__saveModal.3f9d23d6.async.js +0 -1
  349. package/static/dist/src__pages__script__setting.a535793a.async.js +0 -1
  350. package/static/dist/src__pages__setting__appModal.251cd14f.async.js +0 -1
  351. package/static/dist/src__pages__setting__checkUpdate.46efe057.async.js +0 -1
  352. package/static/dist/src__pages__setting__dependence.8a7a9529.async.js +0 -1
  353. package/static/dist/src__pages__setting__index.cc85fdfb.async.js +0 -1
  354. package/static/dist/src__pages__setting__loginLog.cea6056c.async.js +0 -1
  355. package/static/dist/src__pages__setting__notification.390fc905.async.js +0 -1
  356. package/static/dist/src__pages__setting__other.b22d2165.async.js +0 -1
  357. package/static/dist/src__pages__setting__security.598720a8.async.js +0 -1
  358. package/static/dist/src__pages__setting__systemLog.67406721.async.js +0 -1
  359. package/static/dist/src__pages__subscription__index.d0ab2abc.async.js +0 -1
  360. package/static/dist/src__pages__subscription__logModal.3864b37f.async.js +0 -1
  361. package/static/dist/src__pages__subscription__modal.3562c670.async.js +0 -1
  362. /package/static/dist/{4859.1b962b29.chunk.css → 292.1b962b29.chunk.css} +0 -0
@@ -0,0 +1,194 @@
1
+ const test = require('node:test');
2
+ const assert = require('node:assert/strict');
3
+ const fs = require('node:fs');
4
+ const os = require('node:os');
5
+ const path = require('node:path');
6
+ const { spawnSync } = require('node:child_process');
7
+
8
+ function extract(file, name) {
9
+ const text = fs.readFileSync(file, 'utf8');
10
+ const start = text.indexOf(name + '() {');
11
+ assert.ok(start >= 0, name);
12
+ return text.slice(start, text.indexOf('\n}', start) + 2);
13
+ }
14
+ const helpers = [
15
+ fs.readFileSync('shell/task-timeout.sh', 'utf8'),
16
+ ...['handle_task_start', 'handle_task_end', 'run_task_before', 'run_task_after', 'get_env_array', 'clear_env'].map(n => extract('shell/share.sh', n)),
17
+ ...['run_shell_script', 'define_program', 'format_params'].map(n => extract('shell/task.sh', n)),
18
+ ].join('\n');
19
+ const taskSource = path.resolve('shell/otask.sh');
20
+
21
+ function fixture(t) {
22
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'ql-shell-lifecycle-'));
23
+ t.after(() => fs.rmSync(root, { recursive: true, force: true }));
24
+ const write = (name, body) => fs.writeFileSync(path.join(root, name), body);
25
+ write('env.sh', 'export QA_PANEL="alpha&beta&gamma"\n');
26
+ write('before.sh', 'export QA_BEFORE=ready\nqa_function() { printf "HOOK_FUNCTION\\n"; }\n');
27
+ write('after.sh', 'printf "AFTER:%s:%s\\n" "$QA_PANEL" "$QA_BEFORE" >> "$QA_ROOT/events"\n');
28
+ const run = (args, timeout = '') => {
29
+ const r = spawnSync('/bin/bash', ['-c', helpers + `
30
+ dir_scripts=$QA_ROOT; dir_shell=$QA_ROOT; dir_dep=$QA_ROOT
31
+ file_env=$QA_ROOT/env.sh; file_task_before=$QA_ROOT/before.sh; file_task_after=$QA_ROOT/after.sh
32
+ ID=42; log_path=fixture.log; is_macos=0
33
+ dir_log=$QA_ROOT; log_dir=.; mtime_format='%Y-%m-%d %H:%M:%S'
34
+ format_log_time() { printf fixture; }
35
+ time_format='%Y-%m-%d %H:%M:%S'; begin_time=start; begin_timestamp=$(date +%s)
36
+ real_time=true; no_delay=true; NODE_OPTIONS=''; PYTHONPATH=''
37
+ pnpm() { printf '/fixture/global\\n'; }
38
+ t() { :; }
39
+ update_cron() { printf 'STATUS:%s:%s\\n' "$2" "$7" >> "$QA_ROOT/events"; }
40
+ record_cron_stat() { printf 'STAT:%s\\n' "$2" >> "$QA_ROOT/events"; }
41
+ format_params "$@"; define_program "${'${task_shell_params[@]}'}"
42
+ . "$QA_TASK_SOURCE"
43
+ printf 'WRAPPER_FINISHED\\n' >> "$QA_ROOT/events"
44
+ `, 'fixture', ...args], { cwd: root, env: { ...process.env, command_timeout_time: timeout, QA_ROOT: root, QA_TASK_SOURCE: taskSource }, encoding: 'utf8', timeout: 10000 });
45
+ assert.equal(r.status, 0, r.stdout + r.stderr);
46
+ return { stdout: r.stdout, events: fs.readFileSync(path.join(root, 'events'), 'utf8').trim().split('\n') };
47
+ };
48
+ return { write, run };
49
+ }
50
+
51
+ for (const [label, body, code] of [
52
+ ['normal return', ':', 0],
53
+ ['exit zero', 'exit 0', 0],
54
+ ['exit failure', 'exit 7', 7],
55
+ ['exec replacement', "exec bash -c 'exit 9'", 9],
56
+ ['errexit failure', 'set -e\nfalse\necho SHOULD_NOT_RUN', 1],
57
+ ['script EXIT trap', `trap 'echo SCRIPT_EXIT_TRAP' EXIT\nexit 4`, 4],
58
+ ]) {
59
+ test(`sourced shell ${label} still runs after hook and reports exactly one completion`, t => {
60
+ const f = fixture(t);
61
+ f.write('probe.sh', `[[ "$QA_PANEL" == 'alpha&beta&gamma' && "$QA_BEFORE" == ready ]] || exit 99\nqa_function\n${body}\n`);
62
+ const r = f.run(['probe.sh']);
63
+ assert.match(r.stdout, /HOOK_FUNCTION/);
64
+ assert.doesNotMatch(r.stdout, /SHOULD_NOT_RUN/);
65
+ if (label === 'script EXIT trap') assert.match(r.stdout, /SCRIPT_EXIT_TRAP/);
66
+ assert.deepEqual(r.events, ['STATUS:0:', 'AFTER:alpha&beta&gamma:ready', `STATUS:1:${code}`, `STAT:${code}`, 'WRAPPER_FINISHED']);
67
+ });
68
+ }
69
+
70
+ test('shell arguments and before-hook functions survive isolation while script state stays in the child', t => {
71
+ const f = fixture(t);
72
+ f.write('probe.sh', '[[ "$1" == "arg with spaces" ]] || exit 99\nqa_function\nexport QA_BEFORE=changed\ncd /\nexit 5\n');
73
+ const r = f.run(['probe.sh', '--', 'arg with spaces']);
74
+ assert.match(r.stdout, /HOOK_FUNCTION/);
75
+ assert.ok(r.events.includes('AFTER:alpha&beta&gamma:ready'));
76
+ assert.ok(r.events.includes('STATUS:1:5'));
77
+ });
78
+
79
+ for (const [label, args] of [
80
+ ['explicit shell interpreter', ['bash', 'probe.sh', 'argument']],
81
+ ['shell script with positional args', ['probe.sh', 'argument']],
82
+ ]) {
83
+ test(`${label} preserves generated environment and reports failure`, t => {
84
+ const f = fixture(t);
85
+ f.write('probe.sh', '[[ "$QA_PANEL" == "alpha&beta&gamma" && "$QA_BEFORE" == ready && "$1" == argument ]] || exit 99\nexit 6\n');
86
+ const r = f.run(args);
87
+ assert.ok(r.events.includes('STATUS:1:6'));
88
+ assert.equal(r.events.filter(x => x.startsWith('STATUS:1:')).length, 1);
89
+ });
90
+ }
91
+
92
+ test('explicit Python interpreter receives panel and before-hook environment', t => {
93
+ const f = fixture(t);
94
+ f.write('probe.py', 'import os,sys\nassert os.environ["QA_PANEL"] == "alpha&beta&gamma"\nassert os.environ["QA_BEFORE"] == "ready"\nassert sys.argv[1] == "argument"\nsys.exit(8)\n');
95
+ assert.ok(f.run(['python3', 'probe.py', 'argument']).events.includes('STATUS:1:8'));
96
+ });
97
+
98
+ test('explicit Node interpreter retains generated environment', t => {
99
+ const f = fixture(t);
100
+ f.write('probe.cjs', 'if (process.env.QA_PANEL !== "alpha&beta&gamma" || process.env.QA_BEFORE !== "ready") process.exit(99); process.exit(8);\n');
101
+ assert.ok(f.run(['node', 'probe.cjs']).events.includes('STATUS:1:8'));
102
+ });
103
+
104
+ test('plain commands retain generated environment', t => {
105
+ const f = fixture(t);
106
+ assert.match(f.run(['printenv', 'QA_PANEL']).stdout, /alpha&beta&gamma/);
107
+ });
108
+
109
+ for (const mode of ['desi', 'conc']) {
110
+ test(`shell ${mode} keeps selected account values and completion reporting`, t => {
111
+ const f = fixture(t);
112
+ f.write('probe.sh', 'printf "ACCOUNT=%s\\n" "$QA_PANEL"\nexit 0\n');
113
+ const r = f.run(['probe.sh', mode, 'QA_PANEL', '2-3']);
114
+ assert.match(r.stdout, mode === 'desi' ? /ACCOUNT=beta&gamma/ : /ACCOUNT=beta\nACCOUNT=gamma/);
115
+ assert.doesNotMatch(r.stdout, /ACCOUNT=alpha/);
116
+ assert.ok(r.events.includes(`AFTER:${mode === 'desi' ? 'beta&gamma' : 'gamma'}:ready`));
117
+ assert.equal(r.events.filter(x => x === 'STATUS:1:0').length, 1);
118
+ assert.equal(r.events.filter(x => x.startsWith('AFTER:')).length, 1);
119
+ });
120
+ }
121
+
122
+ for (const [label, args] of [
123
+ ['sourced shell', ['probe.sh', '--', 'space value']],
124
+ ['explicit bash', ['bash', 'probe.sh', 'space value']],
125
+ ]) {
126
+ test(`${label} timeout stops descendants and finalizes once with 124`, t => {
127
+ const f = fixture(t);
128
+ f.write('before.sh', 'export QA_BEFORE=ready\nprivate_value=private\nprivate_array=(one "two words")\nqa_function() { printf "HOOK_FUNCTION\\n"; }\n');
129
+ f.write('probe.sh', `[[ "$QA_PANEL" == 'alpha&beta&gamma' && "$QA_BEFORE" == ready && "$1" == 'space value' ]] || exit 91\n${label === 'sourced shell' ? '[[ "$private_value" = private && "${private_array[1]}" = "two words" ]] || exit 92\nqa_function\n' : ''}trap 'echo EXIT_TRAP' EXIT\nsleep 3\necho SHOULD_NOT_RUN\n`);
130
+ const before = Date.now();
131
+ const r = f.run(args, '0.2s');
132
+ assert.ok(Date.now() - before < 2500, r.stdout);
133
+ assert.doesNotMatch(r.stdout, /SHOULD_NOT_RUN/);
134
+ assert.match(r.stdout, /EXIT_TRAP/);
135
+ assert.deepEqual(r.events, ['STATUS:0:', 'AFTER:alpha&beta&gamma:ready', 'STATUS:1:124', 'STAT:124', 'WRAPPER_FINISHED']);
136
+ });
137
+ }
138
+
139
+ test('timeout escalates when a shell and its children ignore TERM', t => {
140
+ const f = fixture(t);
141
+ f.write('probe.sh', 'trap "" TERM\nsleep 3\necho SHOULD_NOT_RUN\n');
142
+ const before = Date.now();
143
+ const r = f.run(['probe.sh'], '0.1');
144
+ assert.ok(Date.now() - before < 2500);
145
+ assert.doesNotMatch(r.stdout, /SHOULD_NOT_RUN/);
146
+ assert.ok(r.events.includes('STATUS:1:124'));
147
+ });
148
+
149
+ test('completed timed tasks keep their exit code and do not wait for the timer', t => {
150
+ const f = fixture(t);
151
+ f.write('probe.sh', 'exit 7\n');
152
+ const before = Date.now();
153
+ const r = f.run(['probe.sh'], '1h');
154
+ assert.ok(Date.now() - before < 1500);
155
+ assert.ok(r.events.includes('STATUS:1:7'));
156
+ });
157
+
158
+ test('zero disables the deadline and invalid durations never start the script', t => {
159
+ const f = fixture(t);
160
+ f.write('probe.sh', 'echo DID_RUN\n');
161
+ assert.match(f.run(['probe.sh'], '0s').stdout, /DID_RUN/);
162
+ f.write('events', '');
163
+ const r = f.run(['probe.sh'], 'wrong');
164
+ assert.doesNotMatch(r.stdout, /DID_RUN/);
165
+ assert.ok(r.events.includes('STATUS:1:125'));
166
+ });
167
+
168
+ for (const [runtime, filename, body] of [
169
+ ['python3', 'timed.py', 'import time\nprint("STARTED", flush=True)\ntime.sleep(3)\nprint("SHOULD_NOT_RUN", flush=True)\n'],
170
+ ['node', 'timed.cjs', 'console.log("STARTED"); setTimeout(() => console.log("SHOULD_NOT_RUN"), 3000);\n'],
171
+ ]) {
172
+ test(`${runtime} timeout stops execution and reports 124`, t => {
173
+ const f = fixture(t);
174
+ f.write(filename, body);
175
+ const r = f.run([runtime, filename], '0.5s');
176
+ assert.match(r.stdout, /STARTED/);
177
+ assert.doesNotMatch(r.stdout, /SHOULD_NOT_RUN/);
178
+ assert.ok(r.events.includes('STATUS:1:124'));
179
+ assert.equal(r.events.filter(x => x.startsWith('AFTER:')).length, 1);
180
+ });
181
+ }
182
+
183
+ for (const mode of ['desi', 'conc']) {
184
+ test(`timed shell ${mode} preserves selected accounts and terminates every worker`, t => {
185
+ const f = fixture(t);
186
+ f.write('probe.sh', 'echo "ACCOUNT=$QA_PANEL"\nsleep 3\necho SHOULD_NOT_RUN\n');
187
+ const r = f.run(['probe.sh', mode, 'QA_PANEL', '2-3'], '0.2s');
188
+ assert.match(r.stdout, mode === 'desi' ? /ACCOUNT=beta&gamma/ : /ACCOUNT=beta\nACCOUNT=gamma/);
189
+ assert.doesNotMatch(r.stdout, /SHOULD_NOT_RUN/);
190
+ assert.equal(r.events.filter(x => x.startsWith('AFTER:')).length, 1);
191
+ // Concurrent mode retains its existing aggregate wait status behavior.
192
+ assert.ok(r.events.includes(`STATUS:1:${mode === 'desi' ? 124 : 0}`));
193
+ });
194
+ }
@@ -0,0 +1,116 @@
1
+ const test = require('node:test');
2
+ const assert = require('node:assert/strict');
3
+ const fs = require('node:fs');
4
+ const os = require('node:os');
5
+ const path = require('node:path');
6
+ const { spawnSync } = require('node:child_process');
7
+ function extract(file, name) {
8
+ const text = fs.readFileSync(file, 'utf8');
9
+ const start = text.indexOf(name + '() {');
10
+ assert.ok(start >= 0);
11
+ return text.slice(start, text.indexOf('\n}', start) + 2);
12
+ }
13
+ const source =
14
+ ['handle_log_path', 'init_begin_time']
15
+ .map((n) => extract('shell/task.sh', n))
16
+ .join('\n') +
17
+ '\n' +
18
+ ['format_time', 'format_log_time', 'format_timestamp', 'handle_task_end']
19
+ .map((n) => extract('shell/share.sh', n))
20
+ .join('\n');
21
+ function run(t, body) {
22
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ql-task-time-'));
23
+ t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
24
+ const result = spawnSync(
25
+ '/bin/bash',
26
+ [
27
+ '-ec',
28
+ source +
29
+ `
30
+ is_macos=0
31
+ mtime_format='%Y-%m-%d %H:%M:%S.%3N'
32
+ time_format='%Y-%m-%d %H:%M:%S'
33
+ ID=42; dir_log=/tmp; log_name=''; real_log_path=''; no_tee=''; real_time=''
34
+ make_dir() { :; }
35
+ t() { printf '%s\\n' "$*" >> "$TEST_DIR/messages"; }
36
+ update_cron() { printf '%s\\n' "$*" >> "$TEST_DIR/status"; }
37
+ record_cron_stat() { printf '%s\\n' "$*" >> "$TEST_DIR/stats"; }
38
+ date() {
39
+ printf '%s\\n' "$*" >> "$TEST_DIR/dates"
40
+ case "$1" in
41
+ '+%Y-%m-%d %H:%M:%S.%3N|%Y-%m-%d-%H-%M-%S-%3N') printf '%s\\n' '2026-09-12 23:59:59.999|2026-09-12-23-59-59-999';;
42
+ '+%Y-%m-%d %H:%M:%S|%s') printf '%s\\n' '2026-09-13 00:00:00|101';;
43
+ '-d') [[ "$3" == '+%s' ]] && echo 100;;
44
+ *) echo raw-time;;
45
+ esac
46
+ }
47
+ ` +
48
+ body,
49
+ ],
50
+ { encoding: 'utf8', env: { ...process.env, TEST_DIR: dir } },
51
+ );
52
+ assert.equal(result.status, 0, result.stderr + result.stdout);
53
+ return {
54
+ dir,
55
+ text: (name) =>
56
+ fs.existsSync(path.join(dir, name))
57
+ ? fs.readFileSync(path.join(dir, name), 'utf8')
58
+ : '',
59
+ };
60
+ }
61
+ test('Linux task timestamps share a snapshot and retain millisecond log names across midnight', (t) => {
62
+ const r = run(
63
+ t,
64
+ `handle_log_path 'folder/example.js'
65
+ init_begin_time
66
+ [[ "$log_path" == 'folder_example_42/2026-09-12-23-59-59-999.log' ]]
67
+ [[ "$time" == '2026-09-12 23:59:59.999' && "$begin_time" == '2026-09-12 23:59:59' && "$begin_timestamp" == 100 ]]
68
+ handle_task_end`,
69
+ );
70
+ assert.equal(r.text('dates').trim().split('\n').length, 3);
71
+ assert.match(r.text('stats'), /^42 0 1\n$/);
72
+ assert.match(r.text('messages'), /2026-09-13 00:00:00/);
73
+ });
74
+ test('explicit log paths and output mode remain intact', (t) => {
75
+ run(
76
+ t,
77
+ `real_log_path='custom/output.log'; real_time=true
78
+ handle_log_path 'folder/example.js'
79
+ [[ "$log_path" == 'custom/output.log' && "$cmd" == '' ]]`,
80
+ );
81
+ });
82
+ test('task failure keeps exit code and minimum one-second runtime', (t) => {
83
+ const r = run(
84
+ t,
85
+ `begin_timestamp=101; _task_exit_code=7; log_path=test.log
86
+ handle_task_end`,
87
+ );
88
+ assert.equal(r.text('stats'), '42 7 1\n');
89
+ assert.match(r.text('messages'), /失败/);
90
+ assert.match(r.text('status'), /101 1 7/);
91
+ });
92
+ test('manual stop retains stopped message and exit status reporting', (t) => {
93
+ const r = run(
94
+ t,
95
+ `begin_timestamp=99; _task_exit_code=1; log_path=test.log; MANUAL=true
96
+ handle_task_end`,
97
+ );
98
+ assert.equal(r.text('stats'), '42 1 2\n');
99
+ assert.match(r.text('messages'), /已停止/);
100
+ });
101
+ for (const mode of ['macos', 'custom'])
102
+ test(`${mode} keeps legacy time conversion helpers`, (t) => {
103
+ run(
104
+ t,
105
+ `
106
+ ${mode === 'macos' ? 'is_macos=1' : 'mtime_format=custom; time_format=custom'}
107
+ format_log_time() { echo legacy-log; }
108
+ format_time() { echo legacy-time; }
109
+ format_timestamp() { echo 100; }
110
+ handle_log_path example.js
111
+ init_begin_time
112
+ [[ "$log_time" == legacy-log && "$begin_time" == legacy-time && "$begin_timestamp" == 100 ]]
113
+ handle_task_end
114
+ `,
115
+ );
116
+ });
@@ -0,0 +1,72 @@
1
+ const test = require('node:test');
2
+ const assert = require('node:assert/strict');
3
+ const { Sequelize, DataTypes } = require('sequelize');
4
+ const i18n = require.resolve('../../back/shared/i18n');
5
+ require.cache[i18n] = {
6
+ id: i18n,
7
+ filename: i18n,
8
+ loaded: true,
9
+ exports: { t: (x) => x },
10
+ };
11
+ const handler = require('../../back/middlewares/uniqueConstraintError').default;
12
+
13
+ test('database uniqueness conflicts return 409 without values and preserve existing rows', async () => {
14
+ const db = new Sequelize('sqlite::memory:', { logging: false });
15
+ try {
16
+ const App = db.define('App', {
17
+ name: { type: DataTypes.STRING, unique: true },
18
+ });
19
+ const Env = db.define('Env', {
20
+ name: { type: DataTypes.STRING, unique: 'pair' },
21
+ value: { type: DataTypes.STRING, unique: 'pair' },
22
+ });
23
+ await db.sync();
24
+ const first = await App.create({ name: 'private-app' });
25
+ const second = await App.create({ name: 'other' });
26
+ await Env.create({ name: 'TOKEN', value: 'private-value' });
27
+ const env = await Env.create({ name: 'TOKEN', value: 'other-value' });
28
+ for (const write of [
29
+ () => App.create({ name: first.name }),
30
+ () => second.update({ name: first.name }),
31
+ () => env.update({ value: 'private-value' }),
32
+ ]) {
33
+ await assert.rejects(write, (err) => {
34
+ let status, body;
35
+ handler(
36
+ err,
37
+ {},
38
+ {
39
+ status: (x) => {
40
+ status = x;
41
+ return {
42
+ json: (x) => {
43
+ body = x;
44
+ },
45
+ };
46
+ },
47
+ },
48
+ () => assert.fail('constraint passed through'),
49
+ );
50
+ assert.equal(status, 409);
51
+ assert.equal(body.code, 409);
52
+ assert.doesNotMatch(
53
+ JSON.stringify(body),
54
+ /private-|TOKEN|INSERT|UPDATE/,
55
+ );
56
+ return true;
57
+ });
58
+ }
59
+ assert.equal((await second.reload()).name, 'other');
60
+ assert.equal((await env.reload()).value, 'other-value');
61
+ const writes = await Promise.allSettled([
62
+ App.create({ name: 'race' }),
63
+ App.create({ name: 'race' }),
64
+ ]);
65
+ assert.equal(writes.filter((x) => x.status === 'fulfilled').length, 1);
66
+ assert.equal(await App.count({ where: { name: 'race' } }), 1);
67
+ const unrelated = new Error('unrelated');
68
+ handler(unrelated, {}, {}, (err) => assert.equal(err, unrelated));
69
+ } finally {
70
+ await db.close();
71
+ }
72
+ });
@@ -0,0 +1,285 @@
1
+ const test = require('node:test');
2
+ const assert = require('node:assert/strict');
3
+ const fs = require('node:fs/promises');
4
+ const os = require('node:os');
5
+ const path = require('node:path');
6
+ const http = require('node:http');
7
+ const { randomUUID } = require('node:crypto');
8
+ const { spawn } = require('node:child_process');
9
+ const { withUpgradeLock, waitForHealth } = require('../../shell/upgrade.cjs');
10
+
11
+ async function temporary(t) {
12
+ const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'ql-upgrade-guards-'));
13
+ t.after(() => fs.rm(tmp, { recursive: true, force: true }));
14
+ return tmp;
15
+ }
16
+
17
+ for (const legacy of [true, false])
18
+ test(
19
+ `concurrent reclamation of a ${
20
+ legacy ? 'legacy lock' : 'unique owner lock'
21
+ } cannot remove a new owner`,
22
+ { timeout: 5000 },
23
+ async (t) => {
24
+ const tmp = await temporary(t);
25
+ const lock = path.join(tmp, 'upgrade.lock');
26
+ const owner = legacy ? 'pid' : `owner-99999999-${randomUUID()}`;
27
+ await fs.mkdir(lock);
28
+ await fs.writeFile(path.join(lock, owner), legacy ? '99999999' : '');
29
+ const original = {
30
+ readFile: fs.readFile,
31
+ readdir: fs.readdir,
32
+ rm: fs.rm,
33
+ unlink: fs.unlink,
34
+ };
35
+ let readCount = 0,
36
+ removeCount = 0,
37
+ active = 0,
38
+ maximum = 0;
39
+ let readyReaders, firstEntered, release;
40
+ const readers = new Promise((resolve) => {
41
+ readyReaders = resolve;
42
+ });
43
+ const entered = new Promise((resolve) => {
44
+ firstEntered = resolve;
45
+ });
46
+ const held = new Promise((resolve) => {
47
+ release = resolve;
48
+ });
49
+ const synchronize = async () => {
50
+ if (++readCount === 2) readyReaders();
51
+ await readers;
52
+ };
53
+ t.mock.method(fs, 'readFile', async (...args) => {
54
+ const value = await original.readFile(...args);
55
+ if (legacy && args[0] === path.join(lock, owner) && readCount < 2)
56
+ await synchronize();
57
+ return value;
58
+ });
59
+ t.mock.method(fs, 'readdir', async (...args) => {
60
+ const value = await original.readdir(...args);
61
+ if (!legacy && args[0] === lock && readCount < 2) await synchronize();
62
+ return value;
63
+ });
64
+ t.mock.method(fs, 'rm', async (...args) => {
65
+ if (args[0] === lock && ++removeCount === 2) await entered;
66
+ return original.rm(...args);
67
+ });
68
+ t.mock.method(fs, 'unlink', async (...args) => {
69
+ if (args[0] === path.join(lock, owner) && ++removeCount === 2)
70
+ await entered;
71
+ return original.unlink(...args);
72
+ });
73
+ const operation = async () => {
74
+ maximum = Math.max(maximum, ++active);
75
+ firstEntered();
76
+ if (active === 1) await held;
77
+ active--;
78
+ };
79
+ const attempts = [
80
+ withUpgradeLock(tmp, operation),
81
+ withUpgradeLock(tmp, operation),
82
+ ].map((attempt) =>
83
+ attempt.then(
84
+ () => ({ ok: true }),
85
+ (error) => ({ error }),
86
+ ),
87
+ );
88
+ try {
89
+ await entered;
90
+ const contender = await Promise.race(attempts);
91
+ assert.match(contender.error?.message || '', /Another upgrade/);
92
+ assert.equal(maximum, 1);
93
+ assert.equal((await original.readdir(lock)).length, 1);
94
+ } finally {
95
+ release();
96
+ await Promise.all(attempts);
97
+ }
98
+ assert.deepEqual(await original.readdir(tmp), []);
99
+ },
100
+ );
101
+
102
+ test('an empty abandoned lock is acquired atomically and a failed operation releases its owner', async (t) => {
103
+ const tmp = await temporary(t);
104
+ await fs.mkdir(path.join(tmp, 'upgrade.lock'));
105
+ await assert.rejects(
106
+ withUpgradeLock(tmp, async () => {
107
+ await assert.rejects(
108
+ withUpgradeLock(tmp, async () => assert.fail('concurrent operation')),
109
+ /Another upgrade/,
110
+ );
111
+ throw new Error('operation failed');
112
+ }),
113
+ /operation failed/,
114
+ );
115
+ await withUpgradeLock(tmp, async () => {});
116
+ assert.deepEqual(await fs.readdir(tmp), []);
117
+ });
118
+
119
+ test('release never deletes another owner after the original lock was replaced', async (t) => {
120
+ const tmp = await temporary(t);
121
+ const lock = path.join(tmp, 'upgrade.lock');
122
+ const replacement = `owner-${process.pid}-${randomUUID()}`;
123
+ await withUpgradeLock(tmp, async () => {
124
+ await fs.rm(lock, { recursive: true });
125
+ await fs.mkdir(lock);
126
+ await fs.writeFile(path.join(lock, replacement), '');
127
+ });
128
+ assert.deepEqual(await fs.readdir(lock), [replacement]);
129
+ });
130
+
131
+ test(
132
+ 'a lock left by a killed process can be reclaimed by a new process',
133
+ { timeout: 5000 },
134
+ async (t) => {
135
+ const tmp = await temporary(t);
136
+ const worker = path.join(tmp, 'worker.cjs');
137
+ await fs.writeFile(
138
+ worker,
139
+ `
140
+ const { withUpgradeLock } = require(${JSON.stringify(
141
+ path.resolve('shell/upgrade.cjs'),
142
+ )});
143
+ withUpgradeLock(process.argv[2], async () => {
144
+ process.stdout.write('owned\\n');
145
+ await new Promise(() => setInterval(() => {}, 1000));
146
+ }).catch(error => { process.stderr.write(error.message); process.exitCode = 1; });
147
+ `,
148
+ );
149
+ const child = spawn(process.execPath, [worker, tmp], {
150
+ stdio: ['ignore', 'pipe', 'pipe'],
151
+ });
152
+ t.after(() => {
153
+ if (child.exitCode === null && child.signalCode === null)
154
+ child.kill('SIGKILL');
155
+ });
156
+ const closed = new Promise((resolve, reject) => {
157
+ child.once('error', reject);
158
+ child.once('close', resolve);
159
+ });
160
+ await new Promise((resolve, reject) => {
161
+ child.stdout.once('data', resolve);
162
+ child.once('error', reject);
163
+ child.once('exit', () =>
164
+ reject(new Error('worker exited before acquiring its lock')),
165
+ );
166
+ });
167
+ child.kill('SIGKILL');
168
+ await closed;
169
+ await withUpgradeLock(tmp, async () => {
170
+ await assert.rejects(
171
+ withUpgradeLock(tmp, async () => {}),
172
+ /Another upgrade/,
173
+ );
174
+ });
175
+ assert.deepEqual(await fs.readdir(tmp), ['worker.cjs']);
176
+ },
177
+ );
178
+
179
+ async function healthServer(t, handler) {
180
+ const server = http.createServer(handler);
181
+ await new Promise((resolve, reject) => {
182
+ server.once('error', reject);
183
+ server.listen(0, '127.0.0.1', resolve);
184
+ });
185
+ t.after(
186
+ () =>
187
+ new Promise((resolve) => {
188
+ server.close(resolve);
189
+ server.closeAllConnections();
190
+ }),
191
+ );
192
+ return String(server.address().port);
193
+ }
194
+
195
+ test('health checks normalize supported URL prefixes exactly like the backend', async (t) => {
196
+ const requests = [];
197
+ const port = await healthServer(t, (req, res) => {
198
+ requests.push(req.url);
199
+ if (
200
+ ['/api/health', '/panel/api/health', '/panel//api/health'].includes(
201
+ req.url,
202
+ )
203
+ )
204
+ res.end('{"code":200,"data":{"status":"ok"}}');
205
+ else {
206
+ res.statusCode = 404;
207
+ res.end('{}');
208
+ }
209
+ });
210
+ for (const prefix of [
211
+ '',
212
+ '/',
213
+ 'panel',
214
+ '/panel',
215
+ 'panel/',
216
+ '/panel/',
217
+ 'panel//',
218
+ '/panel//',
219
+ ])
220
+ await waitForHealth({ QlPort: port, QlBaseUrl: prefix }, 100);
221
+ assert.deepEqual(requests, [
222
+ '/api/health',
223
+ '/api/health',
224
+ ...Array(4).fill('/panel/api/health'),
225
+ ...Array(2).fill('/panel//api/health'),
226
+ ]);
227
+ });
228
+
229
+ test(
230
+ 'health timeout bounds a continuously streaming response',
231
+ { timeout: 3000 },
232
+ async (t) => {
233
+ const port = await healthServer(t, (req, res) => {
234
+ const timer = setInterval(() => res.write(' '), 10);
235
+ res.once('close', () => clearInterval(timer));
236
+ });
237
+ const began = Date.now();
238
+ await assert.rejects(waitForHealth({ QlPort: port }, 80), /health check/);
239
+ assert.ok(
240
+ Date.now() - began < 1000,
241
+ 'deadline must not depend on socket inactivity',
242
+ );
243
+ },
244
+ );
245
+
246
+ for (const streaming of [false, true])
247
+ test(
248
+ `cancellation interrupts ${
249
+ streaming ? 'an active response' : 'the retry delay'
250
+ } and releases the upgrade lock`,
251
+ { timeout: 3000 },
252
+ async (t) => {
253
+ const tmp = await temporary(t);
254
+ const controller = new AbortController();
255
+ const reason = new Error('cancelled health check');
256
+ const port = await healthServer(t, (req, res) => {
257
+ if (streaming) res.write('{');
258
+ else {
259
+ res.statusCode = 503;
260
+ res.end('{}');
261
+ }
262
+ setTimeout(() => controller.abort(reason), 30);
263
+ });
264
+ const began = Date.now();
265
+ await assert.rejects(
266
+ withUpgradeLock(tmp, () =>
267
+ waitForHealth({ QlPort: port }, 5000, controller.signal),
268
+ ),
269
+ (error) => error === reason,
270
+ );
271
+ assert.ok(
272
+ Date.now() - began < 400,
273
+ 'cancel must interrupt the current wait',
274
+ );
275
+ await withUpgradeLock(tmp, async () => {});
276
+ assert.deepEqual(await fs.readdir(tmp), []);
277
+ },
278
+ );
279
+
280
+ test('unhealthy, malformed and oversized health responses fail within the deadline', async (t) => {
281
+ for (const body of ['{}', '{', ' '.repeat(65537)]) {
282
+ const port = await healthServer(t, (req, res) => res.end(body));
283
+ await assert.rejects(waitForHealth({ QlPort: port }, 20), /health check/);
284
+ }
285
+ });