atomic-lockfile 0.0.1-security → 1.4.2

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.

Potentially problematic release.


This version of atomic-lockfile might be problematic. Click here for more details.

Files changed (605) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/LICENSE +21 -0
  3. package/README.md +207 -3
  4. package/dist/esm/adapters/atomic.js +42 -0
  5. package/dist/esm/adapters/atomic.js.map +1 -0
  6. package/dist/esm/adapters/fs.js +29 -0
  7. package/dist/esm/adapters/fs.js.map +1 -0
  8. package/dist/esm/adapters/index.js +27 -0
  9. package/dist/esm/adapters/index.js.map +1 -0
  10. package/dist/esm/adapters/mkdir.js +31 -0
  11. package/dist/esm/adapters/mkdir.js.map +1 -0
  12. package/dist/esm/adapters/symlink.js +29 -0
  13. package/dist/esm/adapters/symlink.js.map +1 -0
  14. package/dist/esm/async/check.js +11 -0
  15. package/dist/esm/async/check.js.map +1 -0
  16. package/dist/esm/async/index.js +4 -0
  17. package/dist/esm/async/index.js.map +1 -0
  18. package/dist/esm/async/lock.js +13 -0
  19. package/dist/esm/async/lock.js.map +1 -0
  20. package/dist/esm/async/unlock.js +8 -0
  21. package/dist/esm/async/unlock.js.map +1 -0
  22. package/dist/esm/cli/commands/cleanup.js +28 -0
  23. package/dist/esm/cli/commands/cleanup.js.map +1 -0
  24. package/dist/esm/cli/commands/list.js +26 -0
  25. package/dist/esm/cli/commands/list.js.map +1 -0
  26. package/dist/esm/cli/commands/lock.js +26 -0
  27. package/dist/esm/cli/commands/lock.js.map +1 -0
  28. package/dist/esm/cli/commands/status.js +27 -0
  29. package/dist/esm/cli/commands/status.js.map +1 -0
  30. package/dist/esm/cli/commands/unlock.js +20 -0
  31. package/dist/esm/cli/commands/unlock.js.map +1 -0
  32. package/dist/esm/cli/formatters/index.js +14 -0
  33. package/dist/esm/cli/formatters/index.js.map +1 -0
  34. package/dist/esm/cli/formatters/json.js +15 -0
  35. package/dist/esm/cli/formatters/json.js.map +1 -0
  36. package/dist/esm/cli/formatters/table.js +18 -0
  37. package/dist/esm/cli/formatters/table.js.map +1 -0
  38. package/dist/esm/cli/formatters/text.js +20 -0
  39. package/dist/esm/cli/formatters/text.js.map +1 -0
  40. package/dist/esm/cli/index.js +56 -0
  41. package/dist/esm/cli/index.js.map +1 -0
  42. package/dist/esm/compat/cjs.js +11 -0
  43. package/dist/esm/compat/cjs.js.map +1 -0
  44. package/dist/esm/compat/esm.js +11 -0
  45. package/dist/esm/compat/esm.js.map +1 -0
  46. package/dist/esm/compat/index.js +4 -0
  47. package/dist/esm/compat/index.js.map +1 -0
  48. package/dist/esm/compat/v1.js +23 -0
  49. package/dist/esm/compat/v1.js.map +1 -0
  50. package/dist/esm/config/defaults.js +12 -0
  51. package/dist/esm/config/defaults.js.map +1 -0
  52. package/dist/esm/config/index.js +17 -0
  53. package/dist/esm/config/index.js.map +1 -0
  54. package/dist/esm/config/schema.js +55 -0
  55. package/dist/esm/config/schema.js.map +1 -0
  56. package/dist/esm/constants/defaults.js +15 -0
  57. package/dist/esm/constants/defaults.js.map +1 -0
  58. package/dist/esm/constants/errors.js +37 -0
  59. package/dist/esm/constants/errors.js.map +1 -0
  60. package/dist/esm/constants/index.js +14 -0
  61. package/dist/esm/constants/index.js.map +1 -0
  62. package/dist/esm/constants/signals.js +21 -0
  63. package/dist/esm/constants/signals.js.map +1 -0
  64. package/dist/esm/constants/timeouts.js +16 -0
  65. package/dist/esm/constants/timeouts.js.map +1 -0
  66. package/dist/esm/core/acquire.js +51 -0
  67. package/dist/esm/core/acquire.js.map +1 -0
  68. package/dist/esm/core/buildLockData.js +23 -0
  69. package/dist/esm/core/buildLockData.js.map +1 -0
  70. package/dist/esm/core/check.js +62 -0
  71. package/dist/esm/core/check.js.map +1 -0
  72. package/dist/esm/core/cleanup.js +45 -0
  73. package/dist/esm/core/cleanup.js.map +1 -0
  74. package/dist/esm/core/handle.js +43 -0
  75. package/dist/esm/core/handle.js.map +1 -0
  76. package/dist/esm/core/index.js +8 -0
  77. package/dist/esm/core/index.js.map +1 -0
  78. package/dist/esm/core/list.js +38 -0
  79. package/dist/esm/core/list.js.map +1 -0
  80. package/dist/esm/core/release.js +21 -0
  81. package/dist/esm/core/release.js.map +1 -0
  82. package/dist/esm/errors/AbortError.js +18 -0
  83. package/dist/esm/errors/AbortError.js.map +1 -0
  84. package/dist/esm/errors/ConflictError.js +20 -0
  85. package/dist/esm/errors/ConflictError.js.map +1 -0
  86. package/dist/esm/errors/IOError.js +24 -0
  87. package/dist/esm/errors/IOError.js.map +1 -0
  88. package/dist/esm/errors/LockError.js +30 -0
  89. package/dist/esm/errors/LockError.js.map +1 -0
  90. package/dist/esm/errors/PermissionError.js +21 -0
  91. package/dist/esm/errors/PermissionError.js.map +1 -0
  92. package/dist/esm/errors/StaleError.js +27 -0
  93. package/dist/esm/errors/StaleError.js.map +1 -0
  94. package/dist/esm/errors/TimeoutError.js +21 -0
  95. package/dist/esm/errors/TimeoutError.js.map +1 -0
  96. package/dist/esm/errors/ValidationError.js +21 -0
  97. package/dist/esm/errors/ValidationError.js.map +1 -0
  98. package/dist/esm/errors/index.js +24 -0
  99. package/dist/esm/errors/index.js.map +1 -0
  100. package/dist/esm/events/emitter.js +41 -0
  101. package/dist/esm/events/emitter.js.map +1 -0
  102. package/dist/esm/events/index.js +3 -0
  103. package/dist/esm/events/index.js.map +1 -0
  104. package/dist/esm/events/types.js +15 -0
  105. package/dist/esm/events/types.js.map +1 -0
  106. package/dist/esm/hooks/afterLock.js +18 -0
  107. package/dist/esm/hooks/afterLock.js.map +1 -0
  108. package/dist/esm/hooks/afterUnlock.js +18 -0
  109. package/dist/esm/hooks/afterUnlock.js.map +1 -0
  110. package/dist/esm/hooks/beforeLock.js +18 -0
  111. package/dist/esm/hooks/beforeLock.js.map +1 -0
  112. package/dist/esm/hooks/beforeUnlock.js +18 -0
  113. package/dist/esm/hooks/beforeUnlock.js.map +1 -0
  114. package/dist/esm/hooks/index.js +24 -0
  115. package/dist/esm/hooks/index.js.map +1 -0
  116. package/dist/esm/hooks/onError.js +18 -0
  117. package/dist/esm/hooks/onError.js.map +1 -0
  118. package/dist/esm/hooks/onStale.js +18 -0
  119. package/dist/esm/hooks/onStale.js.map +1 -0
  120. package/dist/esm/hooks/onTimeout.js +18 -0
  121. package/dist/esm/hooks/onTimeout.js.map +1 -0
  122. package/dist/esm/index.js +21 -0
  123. package/dist/esm/index.js.map +1 -0
  124. package/dist/esm/logger/console.js +38 -0
  125. package/dist/esm/logger/console.js.map +1 -0
  126. package/dist/esm/logger/debug.js +26 -0
  127. package/dist/esm/logger/debug.js.map +1 -0
  128. package/dist/esm/logger/index.js +15 -0
  129. package/dist/esm/logger/index.js.map +1 -0
  130. package/dist/esm/logger/noop.js +12 -0
  131. package/dist/esm/logger/noop.js.map +1 -0
  132. package/dist/esm/meta/index.js +3 -0
  133. package/dist/esm/meta/index.js.map +1 -0
  134. package/dist/esm/meta/package.js +27 -0
  135. package/dist/esm/meta/package.js.map +1 -0
  136. package/dist/esm/meta/version.js +27 -0
  137. package/dist/esm/meta/version.js.map +1 -0
  138. package/dist/esm/middleware/index.js +11 -0
  139. package/dist/esm/middleware/index.js.map +1 -0
  140. package/dist/esm/middleware/logging.js +20 -0
  141. package/dist/esm/middleware/logging.js.map +1 -0
  142. package/dist/esm/middleware/metrics.js +32 -0
  143. package/dist/esm/middleware/metrics.js.map +1 -0
  144. package/dist/esm/middleware/retry.js +22 -0
  145. package/dist/esm/middleware/retry.js.map +1 -0
  146. package/dist/esm/middleware/timeout.js +28 -0
  147. package/dist/esm/middleware/timeout.js.map +1 -0
  148. package/dist/esm/platform/darwin.js +17 -0
  149. package/dist/esm/platform/darwin.js.map +1 -0
  150. package/dist/esm/platform/index.js +6 -0
  151. package/dist/esm/platform/index.js.map +1 -0
  152. package/dist/esm/platform/linux.js +31 -0
  153. package/dist/esm/platform/linux.js.map +1 -0
  154. package/dist/esm/platform/unix.js +34 -0
  155. package/dist/esm/platform/unix.js.map +1 -0
  156. package/dist/esm/platform/windows.js +22 -0
  157. package/dist/esm/platform/windows.js.map +1 -0
  158. package/dist/esm/plugins/cleanup.js +39 -0
  159. package/dist/esm/plugins/cleanup.js.map +1 -0
  160. package/dist/esm/plugins/heartbeat.js +31 -0
  161. package/dist/esm/plugins/heartbeat.js.map +1 -0
  162. package/dist/esm/plugins/index.js +6 -0
  163. package/dist/esm/plugins/index.js.map +1 -0
  164. package/dist/esm/plugins/pid.js +25 -0
  165. package/dist/esm/plugins/pid.js.map +1 -0
  166. package/dist/esm/plugins/stale.js +21 -0
  167. package/dist/esm/plugins/stale.js.map +1 -0
  168. package/dist/esm/plugins/ttl.js +28 -0
  169. package/dist/esm/plugins/ttl.js.map +1 -0
  170. package/dist/esm/promise/index.js +3 -0
  171. package/dist/esm/promise/index.js.map +1 -0
  172. package/dist/esm/promise/lock.js +13 -0
  173. package/dist/esm/promise/lock.js.map +1 -0
  174. package/dist/esm/promise/withLock.js +22 -0
  175. package/dist/esm/promise/withLock.js.map +1 -0
  176. package/dist/esm/registry/global.js +29 -0
  177. package/dist/esm/registry/global.js.map +1 -0
  178. package/dist/esm/registry/index.js +3 -0
  179. package/dist/esm/registry/index.js.map +1 -0
  180. package/dist/esm/registry/local.js +28 -0
  181. package/dist/esm/registry/local.js.map +1 -0
  182. package/dist/esm/strategies/advisory.js +19 -0
  183. package/dist/esm/strategies/advisory.js.map +1 -0
  184. package/dist/esm/strategies/exclusive.js +19 -0
  185. package/dist/esm/strategies/exclusive.js.map +1 -0
  186. package/dist/esm/strategies/index.js +27 -0
  187. package/dist/esm/strategies/index.js.map +1 -0
  188. package/dist/esm/strategies/optimistic.js +22 -0
  189. package/dist/esm/strategies/optimistic.js.map +1 -0
  190. package/dist/esm/strategies/shared.js +19 -0
  191. package/dist/esm/strategies/shared.js.map +1 -0
  192. package/dist/esm/sync/check.js +39 -0
  193. package/dist/esm/sync/check.js.map +1 -0
  194. package/dist/esm/sync/index.js +4 -0
  195. package/dist/esm/sync/index.js.map +1 -0
  196. package/dist/esm/sync/lock.js +39 -0
  197. package/dist/esm/sync/lock.js.map +1 -0
  198. package/dist/esm/sync/unlock.js +21 -0
  199. package/dist/esm/sync/unlock.js.map +1 -0
  200. package/dist/esm/types/adapter.js +2 -0
  201. package/dist/esm/types/adapter.js.map +1 -0
  202. package/dist/esm/types/events.js +2 -0
  203. package/dist/esm/types/events.js.map +1 -0
  204. package/dist/esm/types/index.js +2 -0
  205. package/dist/esm/types/index.js.map +1 -0
  206. package/dist/esm/types/lock.js +2 -0
  207. package/dist/esm/types/lock.js.map +1 -0
  208. package/dist/esm/types/logger.js +2 -0
  209. package/dist/esm/types/logger.js.map +1 -0
  210. package/dist/esm/types/options.js +2 -0
  211. package/dist/esm/types/options.js.map +1 -0
  212. package/dist/esm/types/state.js +2 -0
  213. package/dist/esm/types/state.js.map +1 -0
  214. package/dist/esm/types/strategy.js +2 -0
  215. package/dist/esm/types/strategy.js.map +1 -0
  216. package/dist/esm/utils/backoff.js +40 -0
  217. package/dist/esm/utils/backoff.js.map +1 -0
  218. package/dist/esm/utils/fs.js +88 -0
  219. package/dist/esm/utils/fs.js.map +1 -0
  220. package/dist/esm/utils/hash.js +20 -0
  221. package/dist/esm/utils/hash.js.map +1 -0
  222. package/dist/esm/utils/hostname.js +28 -0
  223. package/dist/esm/utils/hostname.js.map +1 -0
  224. package/dist/esm/utils/index.js +14 -0
  225. package/dist/esm/utils/index.js.map +1 -0
  226. package/dist/esm/utils/parse.js +44 -0
  227. package/dist/esm/utils/parse.js.map +1 -0
  228. package/dist/esm/utils/path.js +35 -0
  229. package/dist/esm/utils/path.js.map +1 -0
  230. package/dist/esm/utils/pid.js +35 -0
  231. package/dist/esm/utils/pid.js.map +1 -0
  232. package/dist/esm/utils/platform.js +35 -0
  233. package/dist/esm/utils/platform.js.map +1 -0
  234. package/dist/esm/utils/random.js +26 -0
  235. package/dist/esm/utils/random.js.map +1 -0
  236. package/dist/esm/utils/retry.js +37 -0
  237. package/dist/esm/utils/retry.js.map +1 -0
  238. package/dist/esm/utils/serialize.js +27 -0
  239. package/dist/esm/utils/serialize.js.map +1 -0
  240. package/dist/esm/utils/time.js +44 -0
  241. package/dist/esm/utils/time.js.map +1 -0
  242. package/dist/esm/utils/validate.js +42 -0
  243. package/dist/esm/utils/validate.js.map +1 -0
  244. package/dist/types/adapters/atomic.d.ts +3 -0
  245. package/dist/types/adapters/atomic.d.ts.map +1 -0
  246. package/dist/types/adapters/fs.d.ts +3 -0
  247. package/dist/types/adapters/fs.d.ts.map +1 -0
  248. package/dist/types/adapters/index.d.ts +9 -0
  249. package/dist/types/adapters/index.d.ts.map +1 -0
  250. package/dist/types/adapters/mkdir.d.ts +3 -0
  251. package/dist/types/adapters/mkdir.d.ts.map +1 -0
  252. package/dist/types/adapters/symlink.d.ts +3 -0
  253. package/dist/types/adapters/symlink.d.ts.map +1 -0
  254. package/dist/types/async/check.d.ts +6 -0
  255. package/dist/types/async/check.d.ts.map +1 -0
  256. package/dist/types/async/index.d.ts +4 -0
  257. package/dist/types/async/index.d.ts.map +1 -0
  258. package/dist/types/async/lock.d.ts +5 -0
  259. package/dist/types/async/lock.d.ts.map +1 -0
  260. package/dist/types/async/unlock.d.ts +5 -0
  261. package/dist/types/async/unlock.d.ts.map +1 -0
  262. package/dist/types/cli/commands/cleanup.d.ts +2 -0
  263. package/dist/types/cli/commands/cleanup.d.ts.map +1 -0
  264. package/dist/types/cli/commands/list.d.ts +2 -0
  265. package/dist/types/cli/commands/list.d.ts.map +1 -0
  266. package/dist/types/cli/commands/lock.d.ts +2 -0
  267. package/dist/types/cli/commands/lock.d.ts.map +1 -0
  268. package/dist/types/cli/commands/status.d.ts +2 -0
  269. package/dist/types/cli/commands/status.d.ts.map +1 -0
  270. package/dist/types/cli/commands/unlock.d.ts +2 -0
  271. package/dist/types/cli/commands/unlock.d.ts.map +1 -0
  272. package/dist/types/cli/formatters/index.d.ts +7 -0
  273. package/dist/types/cli/formatters/index.d.ts.map +1 -0
  274. package/dist/types/cli/formatters/json.d.ts +5 -0
  275. package/dist/types/cli/formatters/json.d.ts.map +1 -0
  276. package/dist/types/cli/formatters/table.d.ts +3 -0
  277. package/dist/types/cli/formatters/table.d.ts.map +1 -0
  278. package/dist/types/cli/formatters/text.d.ts +6 -0
  279. package/dist/types/cli/formatters/text.d.ts.map +1 -0
  280. package/dist/types/cli/index.d.ts +3 -0
  281. package/dist/types/cli/index.d.ts.map +1 -0
  282. package/dist/types/compat/cjs.d.ts +11 -0
  283. package/dist/types/compat/cjs.d.ts.map +1 -0
  284. package/dist/types/compat/esm.d.ts +11 -0
  285. package/dist/types/compat/esm.d.ts.map +1 -0
  286. package/dist/types/compat/index.d.ts +4 -0
  287. package/dist/types/compat/index.d.ts.map +1 -0
  288. package/dist/types/compat/v1.d.ts +15 -0
  289. package/dist/types/compat/v1.d.ts.map +1 -0
  290. package/dist/types/config/defaults.d.ts +3 -0
  291. package/dist/types/config/defaults.d.ts.map +1 -0
  292. package/dist/types/config/index.d.ts +9 -0
  293. package/dist/types/config/index.d.ts.map +1 -0
  294. package/dist/types/config/schema.d.ts +12 -0
  295. package/dist/types/config/schema.d.ts.map +1 -0
  296. package/dist/types/constants/defaults.d.ts +15 -0
  297. package/dist/types/constants/defaults.d.ts.map +1 -0
  298. package/dist/types/constants/errors.d.ts +21 -0
  299. package/dist/types/constants/errors.d.ts.map +1 -0
  300. package/dist/types/constants/index.d.ts +14 -0
  301. package/dist/types/constants/index.d.ts.map +1 -0
  302. package/dist/types/constants/signals.d.ts +6 -0
  303. package/dist/types/constants/signals.d.ts.map +1 -0
  304. package/dist/types/constants/timeouts.d.ts +16 -0
  305. package/dist/types/constants/timeouts.d.ts.map +1 -0
  306. package/dist/types/core/acquire.d.ts +4 -0
  307. package/dist/types/core/acquire.d.ts.map +1 -0
  308. package/dist/types/core/buildLockData.d.ts +4 -0
  309. package/dist/types/core/buildLockData.d.ts.map +1 -0
  310. package/dist/types/core/check.d.ts +6 -0
  311. package/dist/types/core/check.d.ts.map +1 -0
  312. package/dist/types/core/cleanup.d.ts +14 -0
  313. package/dist/types/core/cleanup.d.ts.map +1 -0
  314. package/dist/types/core/handle.d.ts +4 -0
  315. package/dist/types/core/handle.d.ts.map +1 -0
  316. package/dist/types/core/index.d.ts +9 -0
  317. package/dist/types/core/index.d.ts.map +1 -0
  318. package/dist/types/core/list.d.ts +4 -0
  319. package/dist/types/core/list.d.ts.map +1 -0
  320. package/dist/types/core/release.d.ts +4 -0
  321. package/dist/types/core/release.d.ts.map +1 -0
  322. package/dist/types/errors/AbortError.d.ts +8 -0
  323. package/dist/types/errors/AbortError.d.ts.map +1 -0
  324. package/dist/types/errors/ConflictError.d.ts +9 -0
  325. package/dist/types/errors/ConflictError.d.ts.map +1 -0
  326. package/dist/types/errors/IOError.d.ts +10 -0
  327. package/dist/types/errors/IOError.d.ts.map +1 -0
  328. package/dist/types/errors/LockError.d.ts +12 -0
  329. package/dist/types/errors/LockError.d.ts.map +1 -0
  330. package/dist/types/errors/PermissionError.d.ts +9 -0
  331. package/dist/types/errors/PermissionError.d.ts.map +1 -0
  332. package/dist/types/errors/StaleError.d.ts +11 -0
  333. package/dist/types/errors/StaleError.d.ts.map +1 -0
  334. package/dist/types/errors/TimeoutError.d.ts +9 -0
  335. package/dist/types/errors/TimeoutError.d.ts.map +1 -0
  336. package/dist/types/errors/ValidationError.d.ts +9 -0
  337. package/dist/types/errors/ValidationError.d.ts.map +1 -0
  338. package/dist/types/errors/index.d.ts +14 -0
  339. package/dist/types/errors/index.d.ts.map +1 -0
  340. package/dist/types/events/emitter.d.ts +12 -0
  341. package/dist/types/events/emitter.d.ts.map +1 -0
  342. package/dist/types/events/index.d.ts +3 -0
  343. package/dist/types/events/index.d.ts.map +1 -0
  344. package/dist/types/events/types.d.ts +3 -0
  345. package/dist/types/events/types.d.ts.map +1 -0
  346. package/dist/types/hooks/afterLock.d.ts +7 -0
  347. package/dist/types/hooks/afterLock.d.ts.map +1 -0
  348. package/dist/types/hooks/afterUnlock.d.ts +7 -0
  349. package/dist/types/hooks/afterUnlock.d.ts.map +1 -0
  350. package/dist/types/hooks/beforeLock.d.ts +7 -0
  351. package/dist/types/hooks/beforeLock.d.ts.map +1 -0
  352. package/dist/types/hooks/beforeUnlock.d.ts +7 -0
  353. package/dist/types/hooks/beforeUnlock.d.ts.map +1 -0
  354. package/dist/types/hooks/index.d.ts +9 -0
  355. package/dist/types/hooks/index.d.ts.map +1 -0
  356. package/dist/types/hooks/onError.d.ts +6 -0
  357. package/dist/types/hooks/onError.d.ts.map +1 -0
  358. package/dist/types/hooks/onStale.d.ts +7 -0
  359. package/dist/types/hooks/onStale.d.ts.map +1 -0
  360. package/dist/types/hooks/onTimeout.d.ts +6 -0
  361. package/dist/types/hooks/onTimeout.d.ts.map +1 -0
  362. package/dist/types/index.d.ts +22 -0
  363. package/dist/types/index.d.ts.map +1 -0
  364. package/dist/types/logger/console.d.ts +3 -0
  365. package/dist/types/logger/console.d.ts.map +1 -0
  366. package/dist/types/logger/debug.d.ts +3 -0
  367. package/dist/types/logger/debug.d.ts.map +1 -0
  368. package/dist/types/logger/index.d.ts +8 -0
  369. package/dist/types/logger/index.d.ts.map +1 -0
  370. package/dist/types/logger/noop.d.ts +3 -0
  371. package/dist/types/logger/noop.d.ts.map +1 -0
  372. package/dist/types/meta/index.d.ts +3 -0
  373. package/dist/types/meta/index.d.ts.map +1 -0
  374. package/dist/types/meta/package.d.ts +8 -0
  375. package/dist/types/meta/package.d.ts.map +1 -0
  376. package/dist/types/meta/version.d.ts +14 -0
  377. package/dist/types/meta/version.d.ts.map +1 -0
  378. package/dist/types/middleware/index.d.ts +10 -0
  379. package/dist/types/middleware/index.d.ts.map +1 -0
  380. package/dist/types/middleware/logging.d.ts +3 -0
  381. package/dist/types/middleware/logging.d.ts.map +1 -0
  382. package/dist/types/middleware/metrics.d.ts +13 -0
  383. package/dist/types/middleware/metrics.d.ts.map +1 -0
  384. package/dist/types/middleware/retry.d.ts +5 -0
  385. package/dist/types/middleware/retry.d.ts.map +1 -0
  386. package/dist/types/middleware/timeout.d.ts +7 -0
  387. package/dist/types/middleware/timeout.d.ts.map +1 -0
  388. package/dist/types/platform/darwin.d.ts +5 -0
  389. package/dist/types/platform/darwin.d.ts.map +1 -0
  390. package/dist/types/platform/index.d.ts +6 -0
  391. package/dist/types/platform/index.d.ts.map +1 -0
  392. package/dist/types/platform/linux.d.ts +6 -0
  393. package/dist/types/platform/linux.d.ts.map +1 -0
  394. package/dist/types/platform/unix.d.ts +8 -0
  395. package/dist/types/platform/unix.d.ts.map +1 -0
  396. package/dist/types/platform/windows.d.ts +7 -0
  397. package/dist/types/platform/windows.d.ts.map +1 -0
  398. package/dist/types/plugins/cleanup.d.ts +4 -0
  399. package/dist/types/plugins/cleanup.d.ts.map +1 -0
  400. package/dist/types/plugins/heartbeat.d.ts +7 -0
  401. package/dist/types/plugins/heartbeat.d.ts.map +1 -0
  402. package/dist/types/plugins/index.d.ts +8 -0
  403. package/dist/types/plugins/index.d.ts.map +1 -0
  404. package/dist/types/plugins/pid.d.ts +5 -0
  405. package/dist/types/plugins/pid.d.ts.map +1 -0
  406. package/dist/types/plugins/stale.d.ts +9 -0
  407. package/dist/types/plugins/stale.d.ts.map +1 -0
  408. package/dist/types/plugins/ttl.d.ts +7 -0
  409. package/dist/types/plugins/ttl.d.ts.map +1 -0
  410. package/dist/types/promise/index.d.ts +3 -0
  411. package/dist/types/promise/index.d.ts.map +1 -0
  412. package/dist/types/promise/lock.d.ts +6 -0
  413. package/dist/types/promise/lock.d.ts.map +1 -0
  414. package/dist/types/promise/withLock.d.ts +7 -0
  415. package/dist/types/promise/withLock.d.ts.map +1 -0
  416. package/dist/types/registry/global.d.ts +15 -0
  417. package/dist/types/registry/global.d.ts.map +1 -0
  418. package/dist/types/registry/index.d.ts +3 -0
  419. package/dist/types/registry/index.d.ts.map +1 -0
  420. package/dist/types/registry/local.d.ts +10 -0
  421. package/dist/types/registry/local.d.ts.map +1 -0
  422. package/dist/types/strategies/advisory.d.ts +4 -0
  423. package/dist/types/strategies/advisory.d.ts.map +1 -0
  424. package/dist/types/strategies/exclusive.d.ts +4 -0
  425. package/dist/types/strategies/exclusive.d.ts.map +1 -0
  426. package/dist/types/strategies/index.d.ts +9 -0
  427. package/dist/types/strategies/index.d.ts.map +1 -0
  428. package/dist/types/strategies/optimistic.d.ts +8 -0
  429. package/dist/types/strategies/optimistic.d.ts.map +1 -0
  430. package/dist/types/strategies/shared.d.ts +4 -0
  431. package/dist/types/strategies/shared.d.ts.map +1 -0
  432. package/dist/types/sync/check.d.ts +4 -0
  433. package/dist/types/sync/check.d.ts.map +1 -0
  434. package/dist/types/sync/index.d.ts +4 -0
  435. package/dist/types/sync/index.d.ts.map +1 -0
  436. package/dist/types/sync/lock.d.ts +7 -0
  437. package/dist/types/sync/lock.d.ts.map +1 -0
  438. package/dist/types/sync/unlock.d.ts +3 -0
  439. package/dist/types/sync/unlock.d.ts.map +1 -0
  440. package/dist/types/types/adapter.d.ts +21 -0
  441. package/dist/types/types/adapter.d.ts.map +1 -0
  442. package/dist/types/types/events.d.ts +37 -0
  443. package/dist/types/types/events.d.ts.map +1 -0
  444. package/dist/types/types/index.d.ts +8 -0
  445. package/dist/types/types/index.d.ts.map +1 -0
  446. package/dist/types/types/lock.d.ts +38 -0
  447. package/dist/types/types/lock.d.ts.map +1 -0
  448. package/dist/types/types/logger.d.ts +21 -0
  449. package/dist/types/types/logger.d.ts.map +1 -0
  450. package/dist/types/types/options.d.ts +52 -0
  451. package/dist/types/types/options.d.ts.map +1 -0
  452. package/dist/types/types/state.d.ts +34 -0
  453. package/dist/types/types/state.d.ts.map +1 -0
  454. package/dist/types/types/strategy.d.ts +24 -0
  455. package/dist/types/types/strategy.d.ts.map +1 -0
  456. package/dist/types/utils/backoff.d.ts +6 -0
  457. package/dist/types/utils/backoff.d.ts.map +1 -0
  458. package/dist/types/utils/fs.d.ts +12 -0
  459. package/dist/types/utils/fs.d.ts.map +1 -0
  460. package/dist/types/utils/hash.d.ts +7 -0
  461. package/dist/types/utils/hash.d.ts.map +1 -0
  462. package/dist/types/utils/hostname.d.ts +9 -0
  463. package/dist/types/utils/hostname.d.ts.map +1 -0
  464. package/dist/types/utils/index.d.ts +14 -0
  465. package/dist/types/utils/index.d.ts.map +1 -0
  466. package/dist/types/utils/parse.d.ts +7 -0
  467. package/dist/types/utils/parse.d.ts.map +1 -0
  468. package/dist/types/utils/path.d.ts +10 -0
  469. package/dist/types/utils/path.d.ts.map +1 -0
  470. package/dist/types/utils/pid.d.ts +11 -0
  471. package/dist/types/utils/pid.d.ts.map +1 -0
  472. package/dist/types/utils/platform.d.ts +12 -0
  473. package/dist/types/utils/platform.d.ts.map +1 -0
  474. package/dist/types/utils/random.d.ts +7 -0
  475. package/dist/types/utils/random.d.ts.map +1 -0
  476. package/dist/types/utils/retry.d.ts +10 -0
  477. package/dist/types/utils/retry.d.ts.map +1 -0
  478. package/dist/types/utils/serialize.d.ts +7 -0
  479. package/dist/types/utils/serialize.d.ts.map +1 -0
  480. package/dist/types/utils/time.d.ts +12 -0
  481. package/dist/types/utils/time.d.ts.map +1 -0
  482. package/dist/types/utils/validate.d.ts +5 -0
  483. package/dist/types/utils/validate.d.ts.map +1 -0
  484. package/package.json +132 -3
  485. package/src/adapters/atomic.ts +39 -0
  486. package/src/adapters/fs.ts +30 -0
  487. package/src/adapters/index.ts +31 -0
  488. package/src/adapters/mkdir.ts +32 -0
  489. package/src/adapters/symlink.ts +30 -0
  490. package/src/async/check.ts +15 -0
  491. package/src/async/index.ts +3 -0
  492. package/src/async/lock.ts +15 -0
  493. package/src/async/unlock.ts +11 -0
  494. package/src/cli/commands/cleanup.ts +28 -0
  495. package/src/cli/commands/list.ts +27 -0
  496. package/src/cli/commands/lock.ts +27 -0
  497. package/src/cli/commands/status.ts +26 -0
  498. package/src/cli/commands/unlock.ts +20 -0
  499. package/src/cli/formatters/index.ts +18 -0
  500. package/src/cli/formatters/json.ts +18 -0
  501. package/src/cli/formatters/table.ts +26 -0
  502. package/src/cli/formatters/text.ts +22 -0
  503. package/src/cli/index.ts +61 -0
  504. package/src/compat/cjs.ts +11 -0
  505. package/src/compat/esm.ts +11 -0
  506. package/src/compat/index.ts +3 -0
  507. package/src/compat/v1.ts +35 -0
  508. package/src/config/defaults.ts +20 -0
  509. package/src/config/index.ts +24 -0
  510. package/src/config/schema.ts +66 -0
  511. package/src/constants/defaults.ts +14 -0
  512. package/src/constants/errors.ts +39 -0
  513. package/src/constants/index.ts +14 -0
  514. package/src/constants/signals.ts +26 -0
  515. package/src/constants/timeouts.ts +18 -0
  516. package/src/core/acquire.ts +54 -0
  517. package/src/core/buildLockData.ts +25 -0
  518. package/src/core/check.ts +66 -0
  519. package/src/core/cleanup.ts +53 -0
  520. package/src/core/handle.ts +62 -0
  521. package/src/core/index.ts +8 -0
  522. package/src/core/list.ts +38 -0
  523. package/src/core/release.ts +35 -0
  524. package/src/errors/AbortError.ts +25 -0
  525. package/src/errors/ConflictError.ts +28 -0
  526. package/src/errors/IOError.ts +39 -0
  527. package/src/errors/LockError.ts +39 -0
  528. package/src/errors/PermissionError.ts +35 -0
  529. package/src/errors/StaleError.ts +41 -0
  530. package/src/errors/TimeoutError.ts +28 -0
  531. package/src/errors/ValidationError.ts +28 -0
  532. package/src/errors/index.ts +28 -0
  533. package/src/events/emitter.ts +50 -0
  534. package/src/events/index.ts +2 -0
  535. package/src/events/types.ts +16 -0
  536. package/src/hooks/afterLock.ts +24 -0
  537. package/src/hooks/afterUnlock.ts +24 -0
  538. package/src/hooks/beforeLock.ts +28 -0
  539. package/src/hooks/beforeUnlock.ts +24 -0
  540. package/src/hooks/deps +0 -0
  541. package/src/hooks/index.ts +25 -0
  542. package/src/hooks/onError.ts +22 -0
  543. package/src/hooks/onStale.ts +24 -0
  544. package/src/hooks/onTimeout.ts +27 -0
  545. package/src/index.ts +25 -0
  546. package/src/logger/console.ts +39 -0
  547. package/src/logger/debug.ts +29 -0
  548. package/src/logger/index.ts +20 -0
  549. package/src/logger/noop.ts +13 -0
  550. package/src/meta/index.ts +2 -0
  551. package/src/meta/package.ts +29 -0
  552. package/src/meta/version.ts +26 -0
  553. package/src/middleware/index.ts +18 -0
  554. package/src/middleware/logging.ts +21 -0
  555. package/src/middleware/metrics.ts +44 -0
  556. package/src/middleware/retry.ts +25 -0
  557. package/src/middleware/timeout.ts +34 -0
  558. package/src/platform/darwin.ts +19 -0
  559. package/src/platform/index.ts +6 -0
  560. package/src/platform/linux.ts +32 -0
  561. package/src/platform/unix.ts +36 -0
  562. package/src/platform/windows.ts +26 -0
  563. package/src/plugins/cleanup.ts +45 -0
  564. package/src/plugins/heartbeat.ts +42 -0
  565. package/src/plugins/index.ts +7 -0
  566. package/src/plugins/pid.ts +26 -0
  567. package/src/plugins/stale.ts +33 -0
  568. package/src/plugins/ttl.ts +27 -0
  569. package/src/promise/index.ts +2 -0
  570. package/src/promise/lock.ts +23 -0
  571. package/src/promise/withLock.ts +30 -0
  572. package/src/registry/global.ts +39 -0
  573. package/src/registry/index.ts +11 -0
  574. package/src/registry/local.ts +37 -0
  575. package/src/strategies/advisory.ts +21 -0
  576. package/src/strategies/exclusive.ts +21 -0
  577. package/src/strategies/index.ts +31 -0
  578. package/src/strategies/optimistic.ts +29 -0
  579. package/src/strategies/shared.ts +23 -0
  580. package/src/sync/check.ts +43 -0
  581. package/src/sync/index.ts +3 -0
  582. package/src/sync/lock.ts +38 -0
  583. package/src/sync/unlock.ts +19 -0
  584. package/src/types/adapter.ts +23 -0
  585. package/src/types/events.ts +63 -0
  586. package/src/types/index.ts +24 -0
  587. package/src/types/lock.ts +40 -0
  588. package/src/types/logger.ts +23 -0
  589. package/src/types/options.ts +57 -0
  590. package/src/types/state.ts +36 -0
  591. package/src/types/strategy.ts +31 -0
  592. package/src/utils/backoff.ts +52 -0
  593. package/src/utils/fs.ts +93 -0
  594. package/src/utils/hash.ts +25 -0
  595. package/src/utils/hostname.ts +31 -0
  596. package/src/utils/index.ts +13 -0
  597. package/src/utils/parse.ts +43 -0
  598. package/src/utils/path.ts +43 -0
  599. package/src/utils/pid.ts +36 -0
  600. package/src/utils/platform.ts +45 -0
  601. package/src/utils/random.ts +31 -0
  602. package/src/utils/retry.ts +59 -0
  603. package/src/utils/serialize.ts +31 -0
  604. package/src/utils/time.ts +51 -0
  605. package/src/utils/validate.ts +45 -0
@@ -0,0 +1,22 @@
1
+ import { isWindows } from '../utils/platform.js';
2
+ export function assertWindows() {
3
+ if (!isWindows())
4
+ throw new Error('This operation is only supported on Windows');
5
+ }
6
+ export function getWindowsTempDir() {
7
+ return process.env['TEMP'] ?? process.env['TMP'] ?? 'C:\\Temp';
8
+ }
9
+ export function normalizeWindowsPath(filePath) {
10
+ return filePath.replace(/\//g, '\\');
11
+ }
12
+ export function isUNCPath(filePath) {
13
+ return filePath.startsWith('\\\\');
14
+ }
15
+ export function getWindowsDrive(filePath) {
16
+ const match = /^([A-Za-z]):/.exec(filePath);
17
+ return match ? (match[1] ?? null) : null;
18
+ }
19
+ export function canUseWindowsNamedMutex() {
20
+ return isWindows();
21
+ }
22
+ //# sourceMappingURL=windows.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"windows.js","sourceRoot":"","sources":["../../../src/platform/windows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,SAAS,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { promises as fsp } from 'node:fs';
2
+ import { unlinkSafe } from '../utils/fs.js';
3
+ import { CLEANUP_SIGNALS } from '../constants/signals.js';
4
+ const registeredCleanup = new Set();
5
+ export function registerCleanupHandler(lockPath, onCleanup) {
6
+ registeredCleanup.add(lockPath);
7
+ const handler = () => {
8
+ if (registeredCleanup.has(lockPath)) {
9
+ onCleanup(lockPath);
10
+ registeredCleanup.delete(lockPath);
11
+ }
12
+ };
13
+ const signals = [...CLEANUP_SIGNALS];
14
+ signals.forEach((sig) => process.once(sig, handler));
15
+ process.once('exit', handler);
16
+ return () => {
17
+ signals.forEach((sig) => process.removeListener(sig, handler));
18
+ process.removeListener('exit', handler);
19
+ registeredCleanup.delete(lockPath);
20
+ };
21
+ }
22
+ export async function cleanupStaleLocks(directory, extension = '.lock') {
23
+ const removed = [];
24
+ try {
25
+ const files = await fsp.readdir(directory);
26
+ for (const file of files) {
27
+ if (file.endsWith(extension)) {
28
+ await unlinkSafe(`${directory}/${file}`);
29
+ removed.push(file);
30
+ }
31
+ }
32
+ }
33
+ catch { /* ignore */ }
34
+ return removed;
35
+ }
36
+ export function getRegisteredLocks() {
37
+ return [...registeredCleanup];
38
+ }
39
+ //# sourceMappingURL=cleanup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/plugins/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE5C,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,SAAqC;IAC5F,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEhC,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACpB,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAoB,CAAC,GAAG,eAAe,CAAC,CAAC;IACtD,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB,EAAE,SAAS,GAAG,OAAO;IAC5E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,MAAM,UAAU,CAAC,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;AAChC,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { promises as fsp } from 'node:fs';
2
+ import { serializeLockData } from '../utils/serialize.js';
3
+ import { INTERVAL_HEARTBEAT } from '../constants/timeouts.js';
4
+ export function startHeartbeat(lockPath, getData, intervalMs = INTERVAL_HEARTBEAT, onError) {
5
+ let running = true;
6
+ const beat = async () => {
7
+ if (!running)
8
+ return;
9
+ try {
10
+ const data = getData();
11
+ const updated = { ...data, updated: Date.now() };
12
+ await fsp.writeFile(lockPath, serializeLockData(updated), 'utf-8');
13
+ }
14
+ catch (err) {
15
+ onError?.(err);
16
+ }
17
+ if (running)
18
+ setTimeout(beat, intervalMs);
19
+ };
20
+ const timer = setTimeout(beat, intervalMs);
21
+ return {
22
+ stop() {
23
+ running = false;
24
+ clearTimeout(timer);
25
+ },
26
+ get running() {
27
+ return running;
28
+ },
29
+ };
30
+ }
31
+ //# sourceMappingURL=heartbeat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../src/plugins/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAO9D,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAuB,EACvB,UAAU,GAAG,kBAAkB,EAC/B,OAA8B;IAE9B,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;YACvB,MAAM,OAAO,GAAa,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC3D,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,CAAC,GAAY,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO;YAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE3C,OAAO;QACL,IAAI;YACF,OAAO,GAAG,KAAK,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,6 @@
1
+ export { checkStale, shouldRemoveStale } from './stale.js';
2
+ export { startHeartbeat } from './heartbeat.js';
3
+ export { writePidFile, readPidFile, removePidFile, buildPidFilePath } from './pid.js';
4
+ export { getTtlRemaining, isLockExpiredByTtl, buildTtlExpiry, ttlToHuman, validateTtl } from './ttl.js';
5
+ export { registerCleanupHandler, cleanupStaleLocks, getRegisteredLocks } from './cleanup.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
@@ -0,0 +1,25 @@
1
+ import { promises as fsp } from 'node:fs';
2
+ import { getCurrentPid } from '../utils/pid.js';
3
+ export async function writePidFile(pidFilePath) {
4
+ await fsp.writeFile(pidFilePath, String(getCurrentPid()), 'utf-8');
5
+ }
6
+ export async function readPidFile(pidFilePath) {
7
+ try {
8
+ const content = await fsp.readFile(pidFilePath, 'utf-8');
9
+ const pid = parseInt(content.trim(), 10);
10
+ return isNaN(pid) ? null : pid;
11
+ }
12
+ catch {
13
+ return null;
14
+ }
15
+ }
16
+ export async function removePidFile(pidFilePath) {
17
+ try {
18
+ await fsp.unlink(pidFilePath);
19
+ }
20
+ catch { /* ignore */ }
21
+ }
22
+ export function buildPidFilePath(lockPath) {
23
+ return `${lockPath}.pid`;
24
+ }
25
+ //# sourceMappingURL=pid.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pid.js","sourceRoot":"","sources":["../../../src/plugins/pid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,GAAG,QAAQ,MAAM,CAAC;AAC3B,CAAC"}
@@ -0,0 +1,21 @@
1
+ import { isStale } from '../utils/time.js';
2
+ import { isOrphanedPid } from '../utils/pid.js';
3
+ import { isSameHost } from '../utils/hostname.js';
4
+ import { DEFAULT_STALE_AGE } from '../constants/defaults.js';
5
+ export function checkStale(data, staleAgeMs = DEFAULT_STALE_AGE) {
6
+ const ageMs = Date.now() - data.updated;
7
+ if (data.expires !== null && Date.now() > data.expires) {
8
+ return { isStale: true, reason: 'expired', ageMs };
9
+ }
10
+ if (isStale(data.updated, staleAgeMs)) {
11
+ return { isStale: true, reason: 'age', ageMs };
12
+ }
13
+ if (isSameHost(data.hostname) && isOrphanedPid(data.pid)) {
14
+ return { isStale: true, reason: 'orphan', ageMs };
15
+ }
16
+ return { isStale: false, reason: null, ageMs };
17
+ }
18
+ export function shouldRemoveStale(result, removeStale) {
19
+ return result.isStale && removeStale;
20
+ }
21
+ //# sourceMappingURL=stale.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stale.js","sourceRoot":"","sources":["../../../src/plugins/stale.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQ7D,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,UAAU,GAAG,iBAAiB;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;IAExC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB,EAAE,WAAoB;IAC9E,OAAO,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC;AACvC,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { remainingTtlMs, isExpired } from '../utils/time.js';
2
+ export function getTtlRemaining(data) {
3
+ if (data.ttl === null)
4
+ return null;
5
+ return remainingTtlMs(data.created, data.ttl);
6
+ }
7
+ export function isLockExpiredByTtl(data) {
8
+ if (data.ttl === null)
9
+ return false;
10
+ return isExpired(data.created, data.ttl);
11
+ }
12
+ export function buildTtlExpiry(ttlMs) {
13
+ return Date.now() + ttlMs;
14
+ }
15
+ export function ttlToHuman(ttlMs) {
16
+ if (ttlMs < 1000)
17
+ return `${ttlMs}ms`;
18
+ if (ttlMs < 60_000)
19
+ return `${(ttlMs / 1000).toFixed(1)}s`;
20
+ return `${(ttlMs / 60_000).toFixed(1)}m`;
21
+ }
22
+ export function validateTtl(ttlMs) {
23
+ if (ttlMs <= 0)
24
+ throw new RangeError(`TTL must be > 0, got ${ttlMs}`);
25
+ if (!Number.isFinite(ttlMs))
26
+ throw new RangeError(`TTL must be finite, got ${ttlMs}`);
27
+ }
28
+ //# sourceMappingURL=ttl.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../../src/plugins/ttl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,OAAO,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;AACxF,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { lock, tryLock, lockWithTimeout } from './lock.js';
2
+ export { withLock, withLockResult } from './withLock.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/promise/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { acquireLock } from '../core/acquire.js';
2
+ export function lock(path, options) {
3
+ return acquireLock(path, options);
4
+ }
5
+ export function tryLock(path, options) {
6
+ return acquireLock(path, { ...options, retries: 0 }).catch(() => null);
7
+ }
8
+ export function lockWithTimeout(path, timeoutMs, options) {
9
+ const controller = new AbortController();
10
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
11
+ return acquireLock(path, { ...options, signal: controller.signal, timeout: timeoutMs }).finally(() => clearTimeout(timer));
12
+ }
13
+ //# sourceMappingURL=lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/promise/lock.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAwB;IACzD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAwB;IAC5D,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,SAAiB,EACjB,OAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAC7F,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAC1B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { acquireLock } from '../core/acquire.js';
2
+ export async function withLock(path, fn, options = {}) {
3
+ const handle = await acquireLock(path, options);
4
+ try {
5
+ return await fn();
6
+ }
7
+ finally {
8
+ await handle.release();
9
+ }
10
+ }
11
+ export async function withLockResult(path, fn, options = {}) {
12
+ const start = Date.now();
13
+ const handle = await acquireLock(path, options);
14
+ try {
15
+ const result = await fn();
16
+ return { result, heldMs: Date.now() - start };
17
+ }
18
+ finally {
19
+ await handle.release();
20
+ }
21
+ }
22
+ //# sourceMappingURL=withLock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"withLock.js","sourceRoot":"","sources":["../../../src/promise/withLock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,EAAwB,EACxB,UAA2B,EAAE;IAE7B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,EAAwB,EACxB,UAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}
@@ -0,0 +1,29 @@
1
+ class GlobalLockRegistry {
2
+ locks = new Map();
3
+ register(snapshot) {
4
+ this.locks.set(snapshot.lockPath, snapshot);
5
+ }
6
+ unregister(lockPath) {
7
+ this.locks.delete(lockPath);
8
+ }
9
+ get(lockPath) {
10
+ return this.locks.get(lockPath);
11
+ }
12
+ has(lockPath) {
13
+ return this.locks.has(lockPath);
14
+ }
15
+ getAll() {
16
+ return [...this.locks.values()];
17
+ }
18
+ getActive() {
19
+ return this.getAll().filter((s) => s.state === 'locked');
20
+ }
21
+ clear() {
22
+ this.locks.clear();
23
+ }
24
+ size() {
25
+ return this.locks.size;
26
+ }
27
+ }
28
+ export const globalRegistry = new GlobalLockRegistry();
29
+ //# sourceMappingURL=global.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/registry/global.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB;IACL,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE9D,QAAQ,CAAC,QAA2B;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,kBAAkB,EAAE,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { globalRegistry } from './global.js';
2
+ export { registerHandle, unregisterHandle, getHandle, hasHandle, getAllHandles, getActiveHandles, releaseAllHandles, clearRegistry, } from './local.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC"}
@@ -0,0 +1,28 @@
1
+ const localHandles = new Map();
2
+ export function registerHandle(handle) {
3
+ localHandles.set(handle.lockPath, handle);
4
+ }
5
+ export function unregisterHandle(lockPath) {
6
+ localHandles.delete(lockPath);
7
+ }
8
+ export function getHandle(lockPath) {
9
+ return localHandles.get(lockPath);
10
+ }
11
+ export function hasHandle(lockPath) {
12
+ return localHandles.has(lockPath);
13
+ }
14
+ export function getAllHandles() {
15
+ return [...localHandles.values()];
16
+ }
17
+ export function getActiveHandles() {
18
+ return getAllHandles().filter((h) => h.acquired);
19
+ }
20
+ export async function releaseAllHandles() {
21
+ const handles = [...localHandles.values()];
22
+ await Promise.allSettled(handles.map((h) => h.release()));
23
+ localHandles.clear();
24
+ }
25
+ export function clearRegistry() {
26
+ localHandles.clear();
27
+ }
28
+ //# sourceMappingURL=local.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local.js","sourceRoot":"","sources":["../../../src/registry/local.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1D,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC"}
@@ -0,0 +1,19 @@
1
+ export const advisoryStrategy = {
2
+ name: 'advisory',
3
+ description: 'Cooperative locking — processes agree not to write when a lock is held.',
4
+ allowsConcurrent: false,
5
+ requiresKernel: false,
6
+ crossProcess: true,
7
+ crossMachine: false,
8
+ supports: {
9
+ ttl: true,
10
+ heartbeat: false,
11
+ shared: false,
12
+ upgrade: false,
13
+ downgrade: false,
14
+ },
15
+ };
16
+ export function isAdvisoryLockRespected() {
17
+ return true;
18
+ }
19
+ //# sourceMappingURL=advisory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"advisory.js","sourceRoot":"","sources":["../../../src/strategies/advisory.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAuB;IAClD,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,yEAAyE;IACtF,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,KAAK;IACnB,QAAQ,EAAE;QACR,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,19 @@
1
+ export const exclusiveStrategy = {
2
+ name: 'exclusive',
3
+ description: 'Only one process may hold the lock at a time. All others are blocked.',
4
+ allowsConcurrent: false,
5
+ requiresKernel: false,
6
+ crossProcess: true,
7
+ crossMachine: false,
8
+ supports: {
9
+ ttl: true,
10
+ heartbeat: true,
11
+ shared: false,
12
+ upgrade: false,
13
+ downgrade: false,
14
+ },
15
+ };
16
+ export function isExclusiveCompatible(strategy) {
17
+ return strategy === 'exclusive';
18
+ }
19
+ //# sourceMappingURL=exclusive.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exclusive.js","sourceRoot":"","sources":["../../../src/strategies/exclusive.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,uEAAuE;IACpF,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,KAAK;IACnB,QAAQ,EAAE;QACR,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,QAAQ,KAAK,WAAW,CAAC;AAClC,CAAC"}
@@ -0,0 +1,27 @@
1
+ export { exclusiveStrategy } from './exclusive.js';
2
+ export { sharedStrategy } from './shared.js';
3
+ export { advisoryStrategy } from './advisory.js';
4
+ export { optimisticStrategy } from './optimistic.js';
5
+ import { exclusiveStrategy } from './exclusive.js';
6
+ import { sharedStrategy } from './shared.js';
7
+ import { advisoryStrategy } from './advisory.js';
8
+ import { optimisticStrategy } from './optimistic.js';
9
+ const strategyRegistry = new Map([
10
+ ['exclusive', exclusiveStrategy],
11
+ ['shared', sharedStrategy],
12
+ ['advisory', advisoryStrategy],
13
+ ['optimistic', optimisticStrategy],
14
+ ]);
15
+ export function getStrategy(name) {
16
+ const strategy = strategyRegistry.get(name);
17
+ if (!strategy)
18
+ throw new Error(`Unknown strategy: "${name}"`);
19
+ return strategy;
20
+ }
21
+ export function listStrategies() {
22
+ return [...strategyRegistry.keys()];
23
+ }
24
+ export function isStrategyAvailable(name) {
25
+ return strategyRegistry.has(name);
26
+ }
27
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAmC;IACjE,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAChC,CAAC,QAAQ,EAAE,cAAc,CAAC;IAC1B,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAC9B,CAAC,YAAY,EAAE,kBAAkB,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,GAAG,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}
@@ -0,0 +1,22 @@
1
+ export const optimisticStrategy = {
2
+ name: 'optimistic',
3
+ description: 'Assume no conflict; detect conflicts on write and retry.',
4
+ allowsConcurrent: true,
5
+ requiresKernel: false,
6
+ crossProcess: true,
7
+ crossMachine: true,
8
+ supports: {
9
+ ttl: false,
10
+ heartbeat: false,
11
+ shared: true,
12
+ upgrade: false,
13
+ downgrade: false,
14
+ },
15
+ };
16
+ export function createOptimisticVersion(data) {
17
+ return {
18
+ version: Date.now(),
19
+ etag: Buffer.from(data).toString('base64'),
20
+ };
21
+ }
22
+ //# sourceMappingURL=optimistic.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"optimistic.js","sourceRoot":"","sources":["../../../src/strategies/optimistic.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0DAA0D;IACvE,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE;QACR,GAAG,EAAE,KAAK;QACV,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;KACjB;CACF,CAAC;AAOF,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAC3C,CAAC;AACJ,CAAC"}
@@ -0,0 +1,19 @@
1
+ export const sharedStrategy = {
2
+ name: 'shared',
3
+ description: 'Multiple readers may hold the lock simultaneously; writers require exclusivity.',
4
+ allowsConcurrent: true,
5
+ requiresKernel: false,
6
+ crossProcess: true,
7
+ crossMachine: false,
8
+ supports: {
9
+ ttl: true,
10
+ heartbeat: true,
11
+ shared: true,
12
+ upgrade: true,
13
+ downgrade: true,
14
+ },
15
+ };
16
+ export function countSharedHolders(lockDir, extension) {
17
+ return import('node:fs').then(({ promises }) => promises.readdir(lockDir).then((files) => files.filter((f) => f.endsWith(extension)).length));
18
+ }
19
+ //# sourceMappingURL=shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/strategies/shared.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iFAAiF;IAC9F,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,KAAK;IACnB,QAAQ,EAAE;QACR,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI;KAChB;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,SAAiB;IACnE,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC7C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAC/G,CAAC;AACJ,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { accessSync, readFileSync, statSync, constants } from 'node:fs';
2
+ import { resolveLockPath } from '../utils/path.js';
3
+ import { safeDeserializeLockData } from '../utils/serialize.js';
4
+ import { DEFAULT_LOCK_EXTENSION } from '../constants/defaults.js';
5
+ export function checkSync(filePath, lockExtension = DEFAULT_LOCK_EXTENSION) {
6
+ const lockPath = resolveLockPath(filePath, lockExtension);
7
+ try {
8
+ accessSync(lockPath, constants.F_OK);
9
+ }
10
+ catch {
11
+ return { path: filePath, lockPath, data: null, exists: false, readable: false, writable: false, stale: false, expired: false, ageMs: 0 };
12
+ }
13
+ let raw = null;
14
+ try {
15
+ raw = readFileSync(lockPath, 'utf-8');
16
+ }
17
+ catch { /* ignore */ }
18
+ const data = raw ? safeDeserializeLockData(raw) : null;
19
+ let ageMs = 0;
20
+ try {
21
+ ageMs = Date.now() - statSync(lockPath).mtimeMs;
22
+ }
23
+ catch { /* ignore */ }
24
+ return {
25
+ path: filePath,
26
+ lockPath,
27
+ data,
28
+ exists: true,
29
+ readable: raw !== null,
30
+ writable: true,
31
+ stale: false,
32
+ expired: false,
33
+ ageMs,
34
+ };
35
+ }
36
+ export function isLockedSync(filePath, lockExtension = DEFAULT_LOCK_EXTENSION) {
37
+ return checkSync(filePath, lockExtension).exists;
38
+ }
39
+ //# sourceMappingURL=check.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/sync/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,aAAa,GAAG,sBAAsB;IAChF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC3I,CAAC;IAED,IAAI,GAAG,GAAkB,IAAI,CAAC;IAC9B,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAExB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAExB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,IAAI;QACJ,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,GAAG,KAAK,IAAI;QACtB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,KAAK;QACd,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,aAAa,GAAG,sBAAsB;IACnF,OAAO,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,MAAM,CAAC;AACnD,CAAC"}
@@ -0,0 +1,4 @@
1
+ export { lockSync, tryLockSync } from './lock.js';
2
+ export { unlockSync, forceUnlockSync } from './unlock.js';
3
+ export { checkSync, isLockedSync } from './check.js';
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { writeFileSync, accessSync, unlinkSync, constants } from 'node:fs';
2
+ import { resolveLockPath } from '../utils/path.js';
3
+ import { buildLockData } from '../core/buildLockData.js';
4
+ import { serializeLockData } from '../utils/serialize.js';
5
+ import { ConflictError } from '../errors/ConflictError.js';
6
+ import { DEFAULT_LOCK_EXTENSION } from '../constants/defaults.js';
7
+ export function lockSync(filePath, options = {}) {
8
+ const lockPath = resolveLockPath(filePath, options.lockExtension ?? DEFAULT_LOCK_EXTENSION);
9
+ const data = buildLockData(options);
10
+ const content = serializeLockData(data);
11
+ try {
12
+ accessSync(lockPath, constants.F_OK);
13
+ throw new ConflictError(filePath, lockPath, null);
14
+ }
15
+ catch (err) {
16
+ const e = err;
17
+ if (e.code !== 'ENOENT')
18
+ throw err;
19
+ }
20
+ writeFileSync(lockPath, content, { encoding: 'utf-8', flag: 'wx' });
21
+ return {
22
+ lockPath,
23
+ release: () => {
24
+ try {
25
+ unlinkSync(lockPath);
26
+ }
27
+ catch { /* ignore */ }
28
+ },
29
+ };
30
+ }
31
+ export function tryLockSync(filePath, options) {
32
+ try {
33
+ return lockSync(filePath, options);
34
+ }
35
+ catch {
36
+ return null;
37
+ }
38
+ }
39
+ //# sourceMappingURL=lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/sync/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAmB,MAAM,0BAA0B,CAAC;AAGnF,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,UAA0B,EAAE;IACrE,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC;gBAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAwB;IACpE,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
@@ -0,0 +1,21 @@
1
+ import { unlinkSync } from 'node:fs';
2
+ import { resolveLockPath } from '../utils/path.js';
3
+ import { DEFAULT_LOCK_EXTENSION } from '../constants/defaults.js';
4
+ export function unlockSync(filePath, lockExtension = DEFAULT_LOCK_EXTENSION) {
5
+ const lockPath = resolveLockPath(filePath, lockExtension);
6
+ try {
7
+ unlinkSync(lockPath);
8
+ }
9
+ catch (err) {
10
+ const e = err;
11
+ if (e.code !== 'ENOENT')
12
+ throw err;
13
+ }
14
+ }
15
+ export function forceUnlockSync(lockPath) {
16
+ try {
17
+ unlinkSync(lockPath);
18
+ }
19
+ catch { /* ignore */ }
20
+ }
21
+ //# sourceMappingURL=unlock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unlock.js","sourceRoot":"","sources":["../../../src/sync/unlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,aAAa,GAAG,sBAAsB;IACjF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/types/events.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.js.map