@socketsecurity/lib 6.0.6 → 6.0.7

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 (499) hide show
  1. package/CHANGELOG.md +26 -1
  2. package/dist/ai/discover.d.mts +2 -2
  3. package/dist/ai/discover.js +3 -2
  4. package/dist/ai/spawn.js +2 -1
  5. package/dist/ai/types.d.mts +18 -6
  6. package/dist/ai/worktree.d.mts +6 -6
  7. package/dist/ai/worktree.js +1 -1
  8. package/dist/ansi/strip.d.ts +1 -1
  9. package/dist/ansi/strip.js +0 -2
  10. package/dist/archives/_internal.js +7 -9
  11. package/dist/archives/extract.js +1 -1
  12. package/dist/archives/tar.js +6 -6
  13. package/dist/archives/zip.js +3 -5
  14. package/dist/argv/flag-predicates.d.ts +12 -12
  15. package/dist/argv/flag-predicates.js +17 -17
  16. package/dist/argv/flag-types.d.ts +18 -18
  17. package/dist/argv/flag-types.js +4 -4
  18. package/dist/argv/parse.d.ts +1 -1
  19. package/dist/arrays/_internal.js +11 -12
  20. package/dist/arrays/chunk.js +0 -1
  21. package/dist/arrays/join.d.ts +37 -3
  22. package/dist/arrays/join.js +43 -7
  23. package/dist/arrays/unique.js +0 -1
  24. package/dist/bin/_internal.d.ts +1 -1
  25. package/dist/bin/_internal.js +1 -1
  26. package/dist/bin/exec.js +2 -3
  27. package/dist/bin/find.js +13 -13
  28. package/dist/bin/prim.cjs +22736 -22556
  29. package/dist/bin/resolve.js +12 -13
  30. package/dist/bin/which.js +8 -8
  31. package/dist/cache/ttl/store.js +5 -5
  32. package/dist/checks/primordials-defaults.d.ts +3 -3
  33. package/dist/checks/primordials-defaults.js +3 -3
  34. package/dist/checks/primordials.js +4 -3
  35. package/dist/{bin → cli}/check-primordials.d.ts +11 -11
  36. package/dist/{bin → cli}/check-primordials.js +55 -52
  37. package/dist/{bin → cli}/check.js +3 -3
  38. package/dist/{bin → cli}/socket-lib.d.ts +1 -1
  39. package/dist/{bin → cli}/socket-lib.js +4 -4
  40. package/dist/colors/socket-palette.js +7 -9
  41. package/dist/compression/_internal.d.ts +12 -12
  42. package/dist/compression/_internal.js +17 -17
  43. package/dist/compression/brotli.d.ts +25 -25
  44. package/dist/compression/brotli.js +33 -33
  45. package/dist/compression/gzip.d.ts +23 -23
  46. package/dist/compression/gzip.js +40 -40
  47. package/dist/constants/agents.d.ts +3 -1
  48. package/dist/constants/agents.js +15 -11
  49. package/dist/constants/licenses.js +3 -3
  50. package/dist/constants/node.d.ts +23 -0
  51. package/dist/constants/node.js +47 -15
  52. package/dist/constants/packages.js +22 -28
  53. package/dist/constants/platform.d.ts +30 -3
  54. package/dist/constants/platform.js +72 -12
  55. package/dist/constants/runtime.d.ts +22 -0
  56. package/dist/constants/runtime.js +32 -0
  57. package/dist/constants/socket.js +1 -1
  58. package/dist/cover/code.js +8 -8
  59. package/dist/cover/formatters.js +5 -5
  60. package/dist/crypto/hash.d.ts +26 -1
  61. package/dist/crypto/hash.js +43 -12
  62. package/dist/debug/_internal.js +4 -6
  63. package/dist/debug/caller-info.js +2 -3
  64. package/dist/debug/namespace.d.ts +7 -0
  65. package/dist/debug/namespace.js +21 -12
  66. package/dist/debug/output.js +21 -24
  67. package/dist/debug/types.d.ts +4 -4
  68. package/dist/dlx/arborist.js +6 -6
  69. package/dist/dlx/binary-cache.js +14 -14
  70. package/dist/dlx/binary-download.d.ts +1 -1
  71. package/dist/dlx/binary-download.js +11 -11
  72. package/dist/dlx/binary-resolution.js +16 -14
  73. package/dist/dlx/binary-types.d.ts +5 -5
  74. package/dist/dlx/binary.js +5 -5
  75. package/dist/dlx/cache.js +1 -1
  76. package/dist/dlx/detect.d.ts +34 -25
  77. package/dist/dlx/detect.js +86 -77
  78. package/dist/dlx/dir.js +2 -2
  79. package/dist/dlx/firewall.d.ts +1 -1
  80. package/dist/dlx/lockfile.d.ts +19 -18
  81. package/dist/dlx/lockfile.js +16 -16
  82. package/dist/dlx/manifest.d.ts +6 -6
  83. package/dist/dlx/manifest.js +5 -5
  84. package/dist/dlx/package.d.ts +10 -10
  85. package/dist/dlx/package.js +16 -16
  86. package/dist/dlx/packages.js +4 -4
  87. package/dist/dlx/paths.js +7 -7
  88. package/dist/dlx/spec.js +1 -1
  89. package/dist/dlx/types.d.ts +28 -27
  90. package/dist/eco/cargo/parse-lockfile.d.ts +1 -1
  91. package/dist/eco/cargo/parse-lockfile.js +2 -2
  92. package/dist/eco/manifest/analyze-lockfile.js +2 -2
  93. package/dist/eco/manifest/detect-format.js +4 -4
  94. package/dist/eco/manifest/find-packages.js +2 -2
  95. package/dist/eco/manifest/get-package-versions.js +2 -2
  96. package/dist/eco/manifest/get-package.js +2 -2
  97. package/dist/eco/manifest/parse-lockfile.js +2 -2
  98. package/dist/eco/manifest/parse-manifest.js +2 -2
  99. package/dist/eco/manifest/parse.js +2 -2
  100. package/dist/eco/npm/npm/exec.js +2 -2
  101. package/dist/eco/npm/npm/flags.js +7 -12
  102. package/dist/eco/npm/npm/parse-lockfile.d.ts +14 -14
  103. package/dist/eco/npm/npm/parse-lockfile.js +3 -3
  104. package/dist/eco/npm/parse-package-json.js +3 -3
  105. package/dist/eco/npm/pnpm/exec.d.ts +1 -1
  106. package/dist/eco/npm/pnpm/exec.js +5 -5
  107. package/dist/eco/npm/pnpm/flags.js +0 -3
  108. package/dist/eco/npm/pnpm/parse-lockfile.d.ts +1 -1
  109. package/dist/eco/npm/pnpm/parse-lockfile.js +4 -4
  110. package/dist/eco/npm/script.js +9 -6
  111. package/dist/eco/npm/yarnpkg/yarn/exec.js +3 -3
  112. package/dist/eco/npm/yarnpkg/yarn/parse-lockfile.d.ts +2 -2
  113. package/dist/eco/npm/yarnpkg/yarn/parse-lockfile.js +8 -8
  114. package/dist/effects/pulse-frames.d.ts +3 -1
  115. package/dist/effects/shimmer-keyframes.d.ts +1 -1
  116. package/dist/effects/shimmer-terminal.d.ts +1 -1
  117. package/dist/env/boolean.js +0 -1
  118. package/dist/env/ci.js +0 -1
  119. package/dist/env/debug.js +0 -1
  120. package/dist/env/github-status.d.ts +51 -0
  121. package/dist/env/github-status.js +90 -0
  122. package/dist/env/github.js +0 -8
  123. package/dist/env/home.js +0 -1
  124. package/dist/env/locale.js +0 -3
  125. package/dist/env/node-auth-token.js +0 -1
  126. package/dist/env/node-env.js +0 -1
  127. package/dist/env/node-version-managers.d.ts +53 -0
  128. package/dist/env/node-version-managers.js +90 -0
  129. package/dist/env/npm.js +0 -5
  130. package/dist/env/number.js +0 -1
  131. package/dist/env/package-manager.js +3 -6
  132. package/dist/env/path.js +0 -1
  133. package/dist/env/pre-commit.js +1 -2
  134. package/dist/env/rewire.d.ts +7 -6
  135. package/dist/env/rewire.js +15 -16
  136. package/dist/env/shell.js +0 -1
  137. package/dist/env/socket-cli.js +5 -18
  138. package/dist/env/socket-mcp.d.ts +114 -0
  139. package/dist/env/socket-mcp.js +146 -0
  140. package/dist/env/socket.d.ts +1 -109
  141. package/dist/env/socket.js +12 -167
  142. package/dist/env/string.js +0 -1
  143. package/dist/env/temp-dir.js +0 -3
  144. package/dist/env/term.js +0 -1
  145. package/dist/env/test.js +3 -6
  146. package/dist/env/windows.js +0 -4
  147. package/dist/env/xdg.js +0 -3
  148. package/dist/events/exit/_internal.d.ts +11 -9
  149. package/dist/events/exit/_internal.js +31 -35
  150. package/dist/events/exit/handler.js +3 -4
  151. package/dist/events/exit/intercept.js +4 -6
  152. package/dist/events/exit/lifecycle.js +16 -18
  153. package/dist/events/exit/signals.js +1 -2
  154. package/dist/events/exit/types.d.ts +6 -5
  155. package/dist/external/@npmcli/package-json.js +2 -2
  156. package/dist/external/npm-pack.js +2 -2
  157. package/dist/external-tools/bazel/read-bazel-version-file.js +1 -1
  158. package/dist/external-tools/bazel/types.d.ts +1 -1
  159. package/dist/external-tools/cdxgen/from-vfs.js +1 -1
  160. package/dist/external-tools/cdxgen/types.d.ts +1 -1
  161. package/dist/external-tools/from-download.d.ts +1 -1
  162. package/dist/external-tools/from-download.js +1 -1
  163. package/dist/external-tools/janus/from-vfs.js +1 -1
  164. package/dist/external-tools/janus/types.d.ts +1 -1
  165. package/dist/external-tools/jre/detect-platform-arch.d.ts +10 -6
  166. package/dist/external-tools/jre/detect-platform-arch.js +29 -14
  167. package/dist/external-tools/jre/from-vfs.js +1 -1
  168. package/dist/external-tools/jre/types.d.ts +1 -1
  169. package/dist/external-tools/manifest.d.ts +7 -7
  170. package/dist/external-tools/manifest.js +12 -12
  171. package/dist/external-tools/opengrep/from-vfs.js +1 -1
  172. package/dist/external-tools/opengrep/types.d.ts +1 -1
  173. package/dist/external-tools/python/asset-names.d.ts +76 -0
  174. package/dist/external-tools/python/asset-names.js +104 -0
  175. package/dist/external-tools/python/dlx.d.ts +80 -0
  176. package/dist/external-tools/python/dlx.js +87 -0
  177. package/dist/external-tools/python/from-download.d.ts +53 -0
  178. package/dist/external-tools/python/from-download.js +68 -0
  179. package/dist/external-tools/python/from-path.d.ts +7 -0
  180. package/dist/external-tools/python/from-path.js +23 -0
  181. package/dist/external-tools/python/pin.d.ts +121 -0
  182. package/dist/external-tools/python/pin.js +173 -0
  183. package/dist/external-tools/python/pip-install.d.ts +75 -0
  184. package/dist/external-tools/python/pip-install.js +139 -0
  185. package/dist/external-tools/python/resolve.d.ts +42 -0
  186. package/dist/external-tools/python/resolve.js +58 -0
  187. package/dist/external-tools/python/types.d.ts +49 -0
  188. package/dist/external-tools/sbt/from-vfs.js +1 -1
  189. package/dist/external-tools/sbt/types.d.ts +1 -1
  190. package/dist/external-tools/skillspector/from-path.js +3 -5
  191. package/dist/external-tools/skillspector/from-vfs.js +1 -1
  192. package/dist/external-tools/synp/from-download.js +2 -2
  193. package/dist/external-tools/synp/from-vfs.js +1 -1
  194. package/dist/external-tools/trivy/from-vfs.js +1 -1
  195. package/dist/external-tools/trivy/types.d.ts +1 -1
  196. package/dist/external-tools/trufflehog/from-vfs.js +1 -1
  197. package/dist/external-tools/trufflehog/types.d.ts +1 -1
  198. package/dist/fs/_internal.d.ts +1 -1
  199. package/dist/fs/_internal.js +7 -7
  200. package/dist/fs/access.js +5 -9
  201. package/dist/fs/{path-cache.js → allowed-dirs-cache.js} +1 -1
  202. package/dist/fs/encoding.js +5 -7
  203. package/dist/fs/{find-up.js → find.js} +11 -13
  204. package/dist/fs/inspect.js +7 -13
  205. package/dist/fs/read-dir.js +7 -10
  206. package/dist/fs/read-file.js +8 -14
  207. package/dist/fs/read-json-cache.d.ts +6 -4
  208. package/dist/fs/read-json-cache.js +9 -6
  209. package/dist/fs/read-json.js +4 -6
  210. package/dist/fs/resolve-module.js +1 -1
  211. package/dist/fs/safe.d.ts +1 -1
  212. package/dist/fs/safe.js +12 -13
  213. package/dist/fs/unique.js +4 -5
  214. package/dist/fs/validate.js +1 -2
  215. package/dist/fs/write-json.js +4 -5
  216. package/dist/git/_internal.js +10 -10
  217. package/dist/git/changed.js +4 -4
  218. package/dist/git/repo.js +3 -3
  219. package/dist/git/staged.js +4 -4
  220. package/dist/git/unstaged.js +4 -4
  221. package/dist/github/ghsa.js +2 -2
  222. package/dist/github/refs-cache.d.ts +1 -1
  223. package/dist/github/refs-cache.js +5 -5
  224. package/dist/github/refs-rest.js +5 -5
  225. package/dist/github/{fetch.js → request.js} +13 -2
  226. package/dist/github/token.js +1 -1
  227. package/dist/github/types.d.ts +1 -1
  228. package/dist/globs/_internal.js +7 -9
  229. package/dist/globs/match.js +4 -6
  230. package/dist/globs/matcher.d.ts +3 -3
  231. package/dist/globs/matcher.js +12 -14
  232. package/dist/globs/stream.js +1 -2
  233. package/dist/globs/types.d.ts +24 -24
  234. package/dist/http-request/_internal.d.ts +1 -1
  235. package/dist/http-request/browser.js +4 -2
  236. package/dist/http-request/checksum-file.d.ts +55 -0
  237. package/dist/http-request/checksum-file.js +95 -0
  238. package/dist/http-request/download-types.d.ts +15 -23
  239. package/dist/http-request/download.js +3 -3
  240. package/dist/http-request/headers.js +0 -1
  241. package/dist/http-request/request-attempt.js +37 -33
  242. package/dist/http-request/request-types.d.ts +2 -2
  243. package/dist/http-request/request.js +1 -1
  244. package/dist/http-request/user-agent.js +3 -4
  245. package/dist/integrity.d.ts +86 -18
  246. package/dist/integrity.js +119 -30
  247. package/dist/ipc/directory.js +2 -2
  248. package/dist/ipc/paths.js +1 -1
  249. package/dist/ipc/write.js +1 -1
  250. package/dist/ipc-cli/get.js +12 -12
  251. package/dist/json/edit.js +13 -14
  252. package/dist/json/format.js +2 -2
  253. package/dist/json/parse.d.ts +1 -1
  254. package/dist/json/parse.js +3 -7
  255. package/dist/logger/_internal.d.ts +4 -4
  256. package/dist/logger/_internal.js +3 -3
  257. package/dist/logger/colors.js +4 -3
  258. package/dist/logger/console-methods.d.ts +132 -0
  259. package/dist/logger/console-methods.js +169 -0
  260. package/dist/logger/console.d.ts +12 -0
  261. package/dist/logger/console.js +42 -11
  262. package/dist/logger/indentation-methods.d.ts +81 -0
  263. package/dist/logger/indentation-methods.js +121 -0
  264. package/dist/logger/node.d.ts +16 -338
  265. package/dist/logger/node.js +75 -608
  266. package/dist/logger/options.d.ts +39 -0
  267. package/dist/logger/options.js +47 -0
  268. package/dist/logger/semantic-methods.d.ts +63 -0
  269. package/dist/logger/semantic-methods.js +108 -0
  270. package/dist/logger/stream-methods.d.ts +63 -0
  271. package/dist/logger/stream-methods.js +101 -0
  272. package/dist/logger/stream.d.ts +37 -0
  273. package/dist/logger/stream.js +42 -0
  274. package/dist/logger/symbols-builder.js +9 -9
  275. package/dist/logger/symbols.d.ts +2 -25
  276. package/dist/logger/symbols.js +53 -74
  277. package/dist/logger/types.d.ts +1 -1
  278. package/dist/memo/types.d.ts +6 -6
  279. package/dist/native-messaging/host.d.ts +20 -0
  280. package/dist/native-messaging/host.js +120 -0
  281. package/dist/native-messaging/index.d.ts +5 -0
  282. package/dist/native-messaging/index.js +22 -0
  283. package/dist/native-messaging/install.d.ts +60 -0
  284. package/dist/native-messaging/install.js +141 -0
  285. package/dist/native-messaging/rate-limit.d.ts +62 -0
  286. package/dist/native-messaging/rate-limit.js +115 -0
  287. package/dist/native-messaging/run.d.ts +10 -0
  288. package/dist/native-messaging/run.js +17 -0
  289. package/dist/node/async-hooks.js +4 -3
  290. package/dist/node/child-process.js +4 -3
  291. package/dist/node/crypto.js +4 -3
  292. package/dist/node/events.js +4 -3
  293. package/dist/node/fs-promises.js +4 -3
  294. package/dist/node/fs.js +4 -3
  295. package/dist/node/http.js +4 -3
  296. package/dist/node/https.js +4 -3
  297. package/dist/node/module.js +10 -6
  298. package/dist/node/os.js +4 -3
  299. package/dist/node/path.js +4 -3
  300. package/dist/node/timers-promises.js +4 -3
  301. package/dist/node/url.js +4 -3
  302. package/dist/node/util.js +4 -3
  303. package/dist/objects/getters.js +5 -7
  304. package/dist/objects/inspect.js +1 -4
  305. package/dist/objects/mutate.js +2 -3
  306. package/dist/objects/predicates.js +0 -4
  307. package/dist/objects/sort.js +3 -7
  308. package/dist/packages/edit-class.js +15 -16
  309. package/dist/packages/edit.js +12 -14
  310. package/dist/packages/exports.js +11 -17
  311. package/dist/packages/fetch.d.ts +16 -0
  312. package/dist/packages/fetch.js +81 -0
  313. package/dist/packages/find.d.ts +55 -0
  314. package/dist/packages/find.js +65 -0
  315. package/dist/packages/isolation.js +14 -14
  316. package/dist/packages/licenses.js +16 -16
  317. package/dist/packages/manifest.js +12 -15
  318. package/dist/packages/metadata-extensions.d.ts +14 -0
  319. package/dist/packages/metadata-extensions.js +43 -0
  320. package/dist/packages/normalize.js +5 -9
  321. package/dist/packages/provenance.js +16 -18
  322. package/dist/packages/read.d.ts +29 -0
  323. package/dist/packages/read.js +66 -0
  324. package/dist/packages/specs.d.ts +48 -1
  325. package/dist/packages/specs.js +74 -11
  326. package/dist/packages/tarball.d.ts +24 -0
  327. package/dist/packages/tarball.js +79 -0
  328. package/dist/packages/types.d.ts +21 -20
  329. package/dist/packages/validation.js +0 -3
  330. package/dist/paths/_internal.d.ts +2 -1
  331. package/dist/paths/_internal.js +7 -19
  332. package/dist/paths/conversion.js +5 -9
  333. package/dist/paths/filenames.d.ts +0 -1
  334. package/dist/paths/filenames.js +0 -2
  335. package/dist/paths/normalize.js +4 -5
  336. package/dist/paths/packages.js +4 -7
  337. package/dist/paths/predicates.js +9 -16
  338. package/dist/paths/resolve.js +11 -14
  339. package/dist/paths/rewire.js +3 -3
  340. package/dist/paths/socket.js +16 -16
  341. package/dist/paths/walk.d.ts +1 -1
  342. package/dist/paths/walk.js +4 -4
  343. package/dist/perf/report.js +2 -2
  344. package/dist/perf/types.d.ts +1 -1
  345. package/dist/pkg-ext/data.js +1 -1
  346. package/dist/primordials/array.js +9 -9
  347. package/dist/primordials/date.js +2 -2
  348. package/dist/primordials/error.js +3 -3
  349. package/dist/primordials/headers.d.ts +10 -0
  350. package/dist/primordials/headers.js +23 -0
  351. package/dist/primordials/intl.d.ts +13 -0
  352. package/dist/primordials/intl.js +26 -0
  353. package/dist/primordials/math.js +33 -33
  354. package/dist/primordials/number.js +9 -9
  355. package/dist/primordials/object.js +5 -5
  356. package/dist/primordials/string.d.ts +2 -2
  357. package/dist/primordials/string.js +6 -6
  358. package/dist/primordials/symbol.js +3 -3
  359. package/dist/primordials/uncurry.js +9 -9
  360. package/dist/process/abort.js +3 -3
  361. package/dist/process/lock-manager.js +8 -8
  362. package/dist/process/spawn/_internal.js +6 -8
  363. package/dist/process/spawn/child.js +14 -14
  364. package/dist/process/spawn/errors.js +2 -4
  365. package/dist/process/spawn/kill-tree.d.ts +53 -0
  366. package/dist/process/spawn/kill-tree.js +85 -0
  367. package/dist/process/spawn/stdio.js +0 -1
  368. package/dist/process/spawn/types.d.ts +5 -5
  369. package/dist/process/transient.js +2 -2
  370. package/dist/promises/_internal.d.ts +2 -1
  371. package/dist/promises/_internal.js +2 -6
  372. package/dist/promises/iterate.js +11 -15
  373. package/dist/promises/options.js +3 -6
  374. package/dist/promises/retry.js +4 -5
  375. package/dist/promises/timers.d.ts +30 -0
  376. package/dist/promises/timers.js +48 -0
  377. package/dist/releases/github-archives.d.ts +6 -6
  378. package/dist/releases/github-archives.js +2 -2
  379. package/dist/releases/github-asset-url.d.ts +1 -1
  380. package/dist/releases/github-asset-url.js +5 -5
  381. package/dist/releases/github-downloads.d.ts +1 -1
  382. package/dist/releases/github-downloads.js +3 -3
  383. package/dist/releases/github-listing.d.ts +11 -2
  384. package/dist/releases/github-listing.js +20 -7
  385. package/dist/releases/github-retry-config.js +1 -1
  386. package/dist/releases/github-types.d.ts +6 -6
  387. package/dist/releases/socket-btm-binary-naming.d.ts +107 -0
  388. package/dist/releases/socket-btm-binary-naming.js +155 -0
  389. package/dist/releases/socket-btm.d.ts +8 -115
  390. package/dist/releases/socket-btm.js +16 -159
  391. package/dist/schema/types.d.ts +1 -1
  392. package/dist/sea/detect.js +6 -6
  393. package/dist/secrets/_internal.d.ts +2 -2
  394. package/dist/secrets/_internal.js +2 -2
  395. package/dist/secrets/compare.d.ts +45 -0
  396. package/dist/secrets/compare.js +61 -0
  397. package/dist/secrets/keychain.js +6 -4
  398. package/dist/secrets/linux.js +19 -19
  399. package/dist/secrets/macos.d.ts +1 -1
  400. package/dist/secrets/macos.js +13 -13
  401. package/dist/secrets/rc.d.ts +2 -2
  402. package/dist/secrets/rc.js +6 -4
  403. package/dist/secrets/socket-api-token.d.ts +4 -4
  404. package/dist/secrets/socket-api-token.js +18 -9
  405. package/dist/secrets/windows.js +14 -13
  406. package/dist/shadow/skip.js +2 -2
  407. package/dist/smol/detect.js +9 -10
  408. package/dist/smol/http.js +6 -7
  409. package/dist/smol/https.js +6 -7
  410. package/dist/smol/manifest.d.ts +1 -1
  411. package/dist/smol/manifest.js +6 -7
  412. package/dist/smol/path.d.ts +1 -1
  413. package/dist/smol/path.js +7 -8
  414. package/dist/smol/primordial.d.ts +4 -0
  415. package/dist/smol/primordial.js +6 -7
  416. package/dist/smol/purl.d.ts +1 -1
  417. package/dist/smol/purl.js +7 -8
  418. package/dist/smol/versions.js +6 -7
  419. package/dist/smol/vfs.js +6 -7
  420. package/dist/sorts/_internal.js +6 -8
  421. package/dist/sorts/natural.js +10 -12
  422. package/dist/sorts/semver.js +1 -2
  423. package/dist/sorts/strings.js +0 -1
  424. package/dist/sorts/types.d.ts +1 -1
  425. package/dist/spinner/create-spinner-class.d.ts +38 -0
  426. package/dist/spinner/create-spinner-class.js +302 -0
  427. package/dist/spinner/default.js +8 -9
  428. package/dist/spinner/spinner-internals.d.ts +36 -0
  429. package/dist/spinner/spinner-internals.js +101 -0
  430. package/dist/spinner/spinner-shimmer-methods.d.ts +54 -0
  431. package/dist/spinner/spinner-shimmer-methods.js +143 -0
  432. package/dist/spinner/spinner-status-methods.d.ts +40 -0
  433. package/dist/spinner/spinner-status-methods.js +133 -0
  434. package/dist/spinner/spinner.d.ts +4 -5
  435. package/dist/spinner/spinner.js +18 -705
  436. package/dist/spinner/types.d.ts +3 -1
  437. package/dist/spinner/with.d.ts +10 -0
  438. package/dist/spinner/with.js +16 -2
  439. package/dist/stdio/divider.js +1 -1
  440. package/dist/stdio/footer.js +3 -3
  441. package/dist/stdio/header.js +4 -4
  442. package/dist/stdio/progress.js +5 -5
  443. package/dist/stdio/prompts.d.ts +5 -3
  444. package/dist/stdio/prompts.js +6 -7
  445. package/dist/stdio/stdout.js +3 -3
  446. package/dist/streams/parallel.js +3 -5
  447. package/dist/streams/transform.js +2 -3
  448. package/dist/strings/format.js +2 -6
  449. package/dist/strings/predicates.js +0 -2
  450. package/dist/strings/search.js +1 -2
  451. package/dist/strings/transform.js +0 -3
  452. package/dist/strings/width.js +9 -10
  453. package/dist/tables/bordered.js +4 -3
  454. package/dist/tables/padding.js +1 -1
  455. package/dist/tables/simple.js +8 -5
  456. package/dist/temporal/instant.js +1 -1
  457. package/dist/temporal/slots.js +6 -6
  458. package/dist/temporal/system.js +9 -9
  459. package/dist/themes/context.d.ts +3 -2
  460. package/dist/themes/context.js +4 -5
  461. package/dist/themes/themes.js +15 -15
  462. package/dist/themes/types.d.ts +3 -3
  463. package/dist/url/parse.js +0 -2
  464. package/dist/url/predicates.js +1 -2
  465. package/dist/url/search-params.js +3 -9
  466. package/dist/url/types.d.ts +5 -5
  467. package/dist/versions/_internal.js +3 -3
  468. package/dist/words/article.js +0 -1
  469. package/dist/words/capitalize.js +0 -1
  470. package/dist/words/pluralize.js +15 -5
  471. package/package.json +247 -106
  472. package/dist/external-tools/uv/asset-names.d.ts +0 -36
  473. package/dist/external-tools/uv/asset-names.js +0 -70
  474. package/dist/external-tools/uv/from-download.d.ts +0 -17
  475. package/dist/external-tools/uv/from-download.js +0 -47
  476. package/dist/external-tools/uv/from-path.d.ts +0 -5
  477. package/dist/external-tools/uv/from-path.js +0 -22
  478. package/dist/external-tools/uv/from-vfs.d.ts +0 -7
  479. package/dist/external-tools/uv/from-vfs.js +0 -26
  480. package/dist/external-tools/uv/resolve.d.ts +0 -25
  481. package/dist/external-tools/uv/resolve.js +0 -53
  482. package/dist/external-tools/uv/types.d.ts +0 -24
  483. package/dist/http-request/checksums.d.ts +0 -69
  484. package/dist/http-request/checksums.js +0 -108
  485. package/dist/http-request/http-request.d.ts +0 -12
  486. package/dist/http-request/http-request.js +0 -11
  487. package/dist/packages/operations.d.ts +0 -113
  488. package/dist/packages/operations.js +0 -304
  489. package/dist/ssri/convert.d.ts +0 -48
  490. package/dist/ssri/convert.js +0 -69
  491. package/dist/ssri/parse.d.ts +0 -27
  492. package/dist/ssri/parse.js +0 -41
  493. package/dist/ssri/validate.d.ts +0 -41
  494. package/dist/ssri/validate.js +0 -56
  495. /package/dist/{bin → cli}/check.d.ts +0 -0
  496. /package/dist/external-tools/{uv → python}/types.js +0 -0
  497. /package/dist/fs/{path-cache.d.ts → allowed-dirs-cache.d.ts} +0 -0
  498. /package/dist/fs/{find-up.d.ts → find.d.ts} +0 -0
  499. /package/dist/github/{fetch.d.ts → request.d.ts} +0 -0
@@ -1,55 +1,16 @@
1
1
  "use strict";
2
2
  /* Socket Lib - Built with rolldown */
3
3
  Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
4
- const require_primordials_number = require('../primordials/number.js');
5
4
  const require_env_boolean = require('./boolean.js');
6
5
  const require_env_rewire = require('./rewire.js');
7
6
  const require_env_number = require('./number.js');
7
+ const require_env_socket_mcp = require('./socket-mcp.js');
8
8
 
9
9
  //#region src/env/socket.ts
10
10
  /**
11
11
  * @file Socket Security environment variable getters.
12
12
  */
13
13
  /**
14
- * Whether the MCP server should run in HTTP mode. MCP_HTTP_MODE — when set to
15
- * the literal string `'true'`, the MCP server serves over HTTP instead of
16
- * stdio. Returns `false` for any other value (including unset).
17
- *
18
- * @example
19
- * ;```typescript
20
- * import { getMcpHttpMode } from '@socketsecurity/lib/env/socket'
21
- *
22
- * if (getMcpHttpMode()) {
23
- * startHttpServer()
24
- * }
25
- * ```
26
- *
27
- * @returns `true` if HTTP mode is enabled, `false` otherwise
28
- */
29
- /*@__NO_SIDE_EFFECTS__*/
30
- function getMcpHttpMode() {
31
- return require_env_rewire.getEnvValue("MCP_HTTP_MODE") === "true";
32
- }
33
- /**
34
- * MCP HTTP server listen port. MCP_PORT — port the MCP HTTP server binds to.
35
- * Defaults to `3000` (matches socket-mcp's documented default). Invalid /
36
- * non-numeric values also fall back to `3000`.
37
- *
38
- * @example
39
- * ;```typescript
40
- * import { getMcpPort } from '@socketsecurity/lib/env/socket'
41
- *
42
- * const port = getMcpPort()
43
- * ```
44
- *
45
- * @returns The MCP server port (default `3000`)
46
- */
47
- /*@__NO_SIDE_EFFECTS__*/
48
- function getMcpPort() {
49
- const parsed = /* @__PURE__ */ require_env_number.envAsNumber(require_env_rewire.getEnvValue("MCP_PORT"));
50
- return require_primordials_number.NumberIsFinite(parsed) && parsed > 0 ? parsed : 3e3;
51
- }
52
- /**
53
14
  * SOCKET_ACCEPT_RISKS environment variable getter. Whether to accept all Socket
54
15
  * Security risks.
55
16
  *
@@ -64,9 +25,8 @@ function getMcpPort() {
64
25
  *
65
26
  * @returns `true` if risks are accepted, `false` otherwise
66
27
  */
67
- /*@__NO_SIDE_EFFECTS__*/
68
28
  function getSocketAcceptRisks() {
69
- return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_ACCEPT_RISKS"));
29
+ return require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_ACCEPT_RISKS"));
70
30
  }
71
31
  /**
72
32
  * SOCKET_API_BASE_URL environment variable getter. Socket Security API base
@@ -82,7 +42,6 @@ function getSocketAcceptRisks() {
82
42
  *
83
43
  * @returns The API base URL, or `undefined` if not set
84
44
  */
85
- /*@__NO_SIDE_EFFECTS__*/
86
45
  function getSocketApiBaseUrl() {
87
46
  return require_env_rewire.getEnvValue("SOCKET_API_BASE_URL");
88
47
  }
@@ -100,7 +59,6 @@ function getSocketApiBaseUrl() {
100
59
  *
101
60
  * @returns The API proxy URL, or `undefined` if not set
102
61
  */
103
- /*@__NO_SIDE_EFFECTS__*/
104
62
  function getSocketApiProxy() {
105
63
  return require_env_rewire.getEnvValue("SOCKET_API_PROXY");
106
64
  }
@@ -118,9 +76,8 @@ function getSocketApiProxy() {
118
76
  *
119
77
  * @returns The timeout in milliseconds, or `0` if not set
120
78
  */
121
- /*@__NO_SIDE_EFFECTS__*/
122
79
  function getSocketApiTimeout() {
123
- return /* @__PURE__ */ require_env_number.envAsNumber(require_env_rewire.getEnvValue("SOCKET_API_TIMEOUT"));
80
+ return require_env_number.envAsNumber(require_env_rewire.getEnvValue("SOCKET_API_TIMEOUT"));
124
81
  }
125
82
  /**
126
83
  * Socket Security API authentication token.
@@ -142,7 +99,6 @@ function getSocketApiTimeout() {
142
99
  *
143
100
  * @returns The API token, or `undefined` if no name in the chain is set
144
101
  */
145
- /*@__NO_SIDE_EFFECTS__*/
146
102
  function getSocketApiToken() {
147
103
  return require_env_rewire.getEnvValue("SOCKET_API_TOKEN") || require_env_rewire.getEnvValue("SOCKET_API_KEY") || require_env_rewire.getEnvValue("SOCKET_CLI_API_TOKEN") || require_env_rewire.getEnvValue("SOCKET_CLI_API_KEY") || require_env_rewire.getEnvValue("SOCKET_SECURITY_API_TOKEN") || require_env_rewire.getEnvValue("SOCKET_SECURITY_API_KEY");
148
104
  }
@@ -161,7 +117,6 @@ function getSocketApiToken() {
161
117
  *
162
118
  * @returns The API URL override, or `undefined` if not set
163
119
  */
164
- /*@__NO_SIDE_EFFECTS__*/
165
120
  function getSocketApiUrl() {
166
121
  return require_env_rewire.getEnvValue("SOCKET_API_URL");
167
122
  }
@@ -178,7 +133,6 @@ function getSocketApiUrl() {
178
133
  *
179
134
  * @returns The branch name, or `undefined` if not set
180
135
  */
181
- /*@__NO_SIDE_EFFECTS__*/
182
136
  function getSocketBranchName() {
183
137
  return require_env_rewire.getEnvValue("SOCKET_BRANCH_NAME");
184
138
  }
@@ -196,7 +150,6 @@ function getSocketBranchName() {
196
150
  *
197
151
  * @returns The cacache directory path, or `undefined` if not set
198
152
  */
199
- /*@__NO_SIDE_EFFECTS__*/
200
153
  function getSocketCacacheDirEnv() {
201
154
  return require_env_rewire.getEnvValue("SOCKET_CACACHE_DIR");
202
155
  }
@@ -216,7 +169,6 @@ function getSocketCacacheDirEnv() {
216
169
  *
217
170
  * @returns The override URL, or `undefined` when default applies
218
171
  */
219
- /*@__NO_SIDE_EFFECTS__*/
220
172
  function getSocketCloudAuthUrl() {
221
173
  return require_env_rewire.getEnvValue("SOCKET_CLOUD_AUTH_URL");
222
174
  }
@@ -228,7 +180,6 @@ function getSocketCloudAuthUrl() {
228
180
  *
229
181
  * @returns The client ID, or `undefined` if not set
230
182
  */
231
- /*@__NO_SIDE_EFFECTS__*/
232
183
  function getSocketCloudClientId() {
233
184
  return require_env_rewire.getEnvValue("SOCKET_CLOUD_CLIENT_ID");
234
185
  }
@@ -239,7 +190,6 @@ function getSocketCloudClientId() {
239
190
  *
240
191
  * @returns The client secret, or `undefined` if not set
241
192
  */
242
- /*@__NO_SIDE_EFFECTS__*/
243
193
  function getSocketCloudClientSecret() {
244
194
  return require_env_rewire.getEnvValue("SOCKET_CLOUD_CLIENT_SECRET");
245
195
  }
@@ -250,7 +200,6 @@ function getSocketCloudClientSecret() {
250
200
  *
251
201
  * @returns The override URL, or `undefined` when default applies
252
202
  */
253
- /*@__NO_SIDE_EFFECTS__*/
254
203
  function getSocketCloudIntrospectUrl() {
255
204
  return require_env_rewire.getEnvValue("SOCKET_CLOUD_INTROSPECT_URL");
256
205
  }
@@ -261,7 +210,6 @@ function getSocketCloudIntrospectUrl() {
261
210
  *
262
211
  * @returns The override URL, or `undefined` when default applies
263
212
  */
264
- /*@__NO_SIDE_EFFECTS__*/
265
213
  function getSocketCloudTokenUrl() {
266
214
  return require_env_rewire.getEnvValue("SOCKET_CLOUD_TOKEN_URL");
267
215
  }
@@ -272,7 +220,6 @@ function getSocketCloudTokenUrl() {
272
220
  *
273
221
  * @returns The override URL, or `undefined` when default applies
274
222
  */
275
- /*@__NO_SIDE_EFFECTS__*/
276
223
  function getSocketCloudUserinfoUrl() {
277
224
  return require_env_rewire.getEnvValue("SOCKET_CLOUD_USERINFO_URL");
278
225
  }
@@ -290,7 +237,6 @@ function getSocketCloudUserinfoUrl() {
290
237
  *
291
238
  * @returns The config file path, or `undefined` if not set
292
239
  */
293
- /*@__NO_SIDE_EFFECTS__*/
294
240
  function getSocketConfig() {
295
241
  return require_env_rewire.getEnvValue("SOCKET_CONFIG");
296
242
  }
@@ -308,7 +254,6 @@ function getSocketConfig() {
308
254
  *
309
255
  * @returns The Socket debug filter, or `undefined` if not set
310
256
  */
311
- /*@__NO_SIDE_EFFECTS__*/
312
257
  function getSocketDebug() {
313
258
  return require_env_rewire.getEnvValue("SOCKET_DEBUG");
314
259
  }
@@ -326,7 +271,6 @@ function getSocketDebug() {
326
271
  *
327
272
  * @returns The DLX directory path, or `undefined` if not set
328
273
  */
329
- /*@__NO_SIDE_EFFECTS__*/
330
274
  function getSocketDlxDirEnv() {
331
275
  return require_env_rewire.getEnvValue("SOCKET_DLX_DIR");
332
276
  }
@@ -343,7 +287,6 @@ function getSocketDlxDirEnv() {
343
287
  *
344
288
  * @returns The Socket home directory, or `undefined` if not set
345
289
  */
346
- /*@__NO_SIDE_EFFECTS__*/
347
290
  function getSocketHome() {
348
291
  return require_env_rewire.getEnvValue("SOCKET_HOME");
349
292
  }
@@ -362,9 +305,8 @@ function getSocketHome() {
362
305
  *
363
306
  * @returns `true` if the API token requirement is skipped, `false` otherwise
364
307
  */
365
- /*@__NO_SIDE_EFFECTS__*/
366
308
  function getSocketNoApiToken() {
367
- return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_NO_API_TOKEN"));
309
+ return require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_NO_API_TOKEN"));
368
310
  }
369
311
  /**
370
312
  * SOCKET_NPM_REGISTRY environment variable getter. Socket NPM registry URL
@@ -380,84 +322,10 @@ function getSocketNoApiToken() {
380
322
  *
381
323
  * @returns The Socket NPM registry URL, or `undefined` if not set
382
324
  */
383
- /*@__NO_SIDE_EFFECTS__*/
384
325
  function getSocketNpmRegistry() {
385
326
  return require_env_rewire.getEnvValue("SOCKET_NPM_REGISTRY");
386
327
  }
387
328
  /**
388
- * OAuth introspection client ID for the MCP HTTP server.
389
- * SOCKET_OAUTH_INTROSPECTION_CLIENT_ID — client credential used to call the
390
- * issuer's introspection endpoint. Empty string when unset.
391
- *
392
- * @example
393
- * ;```typescript
394
- * import { getSocketOauthIntrospectionClientId } from '@socketsecurity/lib/env/socket'
395
- *
396
- * const clientId = getSocketOauthIntrospectionClientId()
397
- * ```
398
- *
399
- * @returns The OAuth client ID, or `''` if not set
400
- */
401
- /*@__NO_SIDE_EFFECTS__*/
402
- function getSocketOauthIntrospectionClientId() {
403
- return require_env_rewire.getEnvValue("SOCKET_OAUTH_INTROSPECTION_CLIENT_ID") ?? "";
404
- }
405
- /**
406
- * OAuth introspection client secret for the MCP HTTP server.
407
- * SOCKET_OAUTH_INTROSPECTION_CLIENT_SECRET — paired with the client ID for
408
- * authenticated introspection requests. Empty string when unset.
409
- *
410
- * @example
411
- * ;```typescript
412
- * import { getSocketOauthIntrospectionClientSecret } from '@socketsecurity/lib/env/socket'
413
- *
414
- * const clientSecret = getSocketOauthIntrospectionClientSecret()
415
- * ```
416
- *
417
- * @returns The OAuth client secret, or `''` if not set
418
- */
419
- /*@__NO_SIDE_EFFECTS__*/
420
- function getSocketOauthIntrospectionClientSecret() {
421
- return require_env_rewire.getEnvValue("SOCKET_OAUTH_INTROSPECTION_CLIENT_SECRET") ?? "";
422
- }
423
- /**
424
- * OAuth issuer URL for the MCP HTTP server. SOCKET_OAUTH_ISSUER — issuer to
425
- * validate inbound OAuth tokens against. Returns the empty string when unset;
426
- * callers treat empty as "no issuer configured".
427
- *
428
- * @example
429
- * ;```typescript
430
- * import { getSocketOauthIssuer } from '@socketsecurity/lib/env/socket'
431
- *
432
- * const issuer = getSocketOauthIssuer()
433
- * if (issuer) { ... }
434
- * ```
435
- *
436
- * @returns The OAuth issuer URL, or `''` if not set
437
- */
438
- /*@__NO_SIDE_EFFECTS__*/
439
- function getSocketOauthIssuer() {
440
- return require_env_rewire.getEnvValue("SOCKET_OAUTH_ISSUER") ?? "";
441
- }
442
- /**
443
- * Required OAuth scopes for the MCP HTTP server. SOCKET_OAUTH_REQUIRED_SCOPES —
444
- * whitespace-separated list of scopes inbound tokens must carry. Defaults to
445
- * `'packages:list'` (the minimum scope socket-mcp's depscore tool needs).
446
- *
447
- * @example
448
- * ;```typescript
449
- * import { getSocketOauthRequiredScopes } from '@socketsecurity/lib/env/socket'
450
- *
451
- * const scopes = getSocketOauthRequiredScopes().split(/\s+/u)
452
- * ```
453
- *
454
- * @returns The required-scopes string, defaulting to `'packages:list'`
455
- */
456
- /*@__NO_SIDE_EFFECTS__*/
457
- function getSocketOauthRequiredScopes() {
458
- return require_env_rewire.getEnvValue("SOCKET_OAUTH_REQUIRED_SCOPES") ?? "packages:list";
459
- }
460
- /**
461
329
  * SOCKET_ORG_SLUG environment variable getter. Socket Security organization
462
330
  * slug identifier.
463
331
  *
@@ -471,7 +339,6 @@ function getSocketOauthRequiredScopes() {
471
339
  *
472
340
  * @returns The organization slug, or `undefined` if not set
473
341
  */
474
- /*@__NO_SIDE_EFFECTS__*/
475
342
  function getSocketOrgSlug() {
476
343
  return require_env_rewire.getEnvValue("SOCKET_ORG_SLUG");
477
344
  }
@@ -489,7 +356,6 @@ function getSocketOrgSlug() {
489
356
  *
490
357
  * @returns The Socket registry URL, or `undefined` if not set
491
358
  */
492
- /*@__NO_SIDE_EFFECTS__*/
493
359
  function getSocketRegistryUrl() {
494
360
  return require_env_rewire.getEnvValue("SOCKET_REGISTRY_URL");
495
361
  }
@@ -507,7 +373,6 @@ function getSocketRegistryUrl() {
507
373
  *
508
374
  * @returns The repository name, or `undefined` if neither is set
509
375
  */
510
- /*@__NO_SIDE_EFFECTS__*/
511
376
  function getSocketRepositoryName() {
512
377
  return require_env_rewire.getEnvValue("SOCKET_REPOSITORY_NAME") || require_env_rewire.getEnvValue("SOCKET_REPO_NAME");
513
378
  }
@@ -526,33 +391,13 @@ function getSocketRepositoryName() {
526
391
  *
527
392
  * @returns `true` if viewing all risks, `false` otherwise
528
393
  */
529
- /*@__NO_SIDE_EFFECTS__*/
530
394
  function getSocketViewAllRisks() {
531
- return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_VIEW_ALL_RISKS"));
532
- }
533
- /**
534
- * Whether the MCP HTTP server should trust upstream proxy headers. TRUST_PROXY
535
- * — when set to the literal string `'true'`, the server honors
536
- * `X-Forwarded-Host` / `X-Forwarded-Proto` when composing OAuth metadata URLs.
537
- * Off by default to prevent header spoofing when no upstream proxy is present.
538
- *
539
- * @example
540
- * ;```typescript
541
- * import { getTrustProxy } from '@socketsecurity/lib/env/socket'
542
- *
543
- * if (getTrustProxy()) { ... }
544
- * ```
545
- *
546
- * @returns `true` if proxy headers are trusted, `false` otherwise
547
- */
548
- /*@__NO_SIDE_EFFECTS__*/
549
- function getTrustProxy() {
550
- return require_env_rewire.getEnvValue("TRUST_PROXY") === "true";
395
+ return require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_VIEW_ALL_RISKS"));
551
396
  }
552
397
 
553
398
  //#endregion
554
- exports.getMcpHttpMode = getMcpHttpMode;
555
- exports.getMcpPort = getMcpPort;
399
+ exports.getMcpHttpMode = require_env_socket_mcp.getMcpHttpMode;
400
+ exports.getMcpPort = require_env_socket_mcp.getMcpPort;
556
401
  exports.getSocketAcceptRisks = getSocketAcceptRisks;
557
402
  exports.getSocketApiBaseUrl = getSocketApiBaseUrl;
558
403
  exports.getSocketApiProxy = getSocketApiProxy;
@@ -573,12 +418,12 @@ exports.getSocketDlxDirEnv = getSocketDlxDirEnv;
573
418
  exports.getSocketHome = getSocketHome;
574
419
  exports.getSocketNoApiToken = getSocketNoApiToken;
575
420
  exports.getSocketNpmRegistry = getSocketNpmRegistry;
576
- exports.getSocketOauthIntrospectionClientId = getSocketOauthIntrospectionClientId;
577
- exports.getSocketOauthIntrospectionClientSecret = getSocketOauthIntrospectionClientSecret;
578
- exports.getSocketOauthIssuer = getSocketOauthIssuer;
579
- exports.getSocketOauthRequiredScopes = getSocketOauthRequiredScopes;
421
+ exports.getSocketOauthIntrospectionClientId = require_env_socket_mcp.getSocketOauthIntrospectionClientId;
422
+ exports.getSocketOauthIntrospectionClientSecret = require_env_socket_mcp.getSocketOauthIntrospectionClientSecret;
423
+ exports.getSocketOauthIssuer = require_env_socket_mcp.getSocketOauthIssuer;
424
+ exports.getSocketOauthRequiredScopes = require_env_socket_mcp.getSocketOauthRequiredScopes;
580
425
  exports.getSocketOrgSlug = getSocketOrgSlug;
581
426
  exports.getSocketRegistryUrl = getSocketRegistryUrl;
582
427
  exports.getSocketRepositoryName = getSocketRepositoryName;
583
428
  exports.getSocketViewAllRisks = getSocketViewAllRisks;
584
- exports.getTrustProxy = getTrustProxy;
429
+ exports.getTrustProxy = require_env_socket_mcp.getTrustProxy;
@@ -31,7 +31,6 @@ const require_primordials_array = require('../primordials/array.js');
31
31
  *
32
32
  * @returns The string value, or the default value
33
33
  */
34
- /*@__NO_SIDE_EFFECTS__*/
35
34
  function envAsString(value, defaultValueOrOptions = "") {
36
35
  /* c8 ignore stop */
37
36
  const { defaultValue = "", trim = true } = typeof defaultValueOrOptions === "object" && defaultValueOrOptions !== null && !require_primordials_array.ArrayIsArray(defaultValueOrOptions) && ("defaultValue" in defaultValueOrOptions || "trim" in defaultValueOrOptions) ? defaultValueOrOptions : { defaultValue: defaultValueOrOptions === void 0 ? "" : typeof defaultValueOrOptions === "string" ? defaultValueOrOptions : require_primordials_string.StringCtor(defaultValueOrOptions) };
@@ -21,7 +21,6 @@ const require_env_rewire = require('./rewire.js');
21
21
  *
22
22
  * @returns The Windows temp directory path, or `undefined` if not set
23
23
  */
24
- /*@__NO_SIDE_EFFECTS__*/
25
24
  function getTemp() {
26
25
  return require_env_rewire.getEnvValue("TEMP");
27
26
  }
@@ -38,7 +37,6 @@ function getTemp() {
38
37
  *
39
38
  * @returns The alternative temp directory path, or `undefined` if not set
40
39
  */
41
- /*@__NO_SIDE_EFFECTS__*/
42
40
  function getTmp() {
43
41
  return require_env_rewire.getEnvValue("TMP");
44
42
  }
@@ -55,7 +53,6 @@ function getTmp() {
55
53
  *
56
54
  * @returns The Unix/macOS temp directory path, or `undefined` if not set
57
55
  */
58
- /*@__NO_SIDE_EFFECTS__*/
59
56
  function getTmpdir() {
60
57
  return require_env_rewire.getEnvValue("TMPDIR");
61
58
  }
package/dist/env/term.js CHANGED
@@ -22,7 +22,6 @@ const require_env_rewire = require('./rewire.js');
22
22
  *
23
23
  * @returns The terminal type identifier, or `undefined` if not set
24
24
  */
25
- /*@__NO_SIDE_EFFECTS__*/
26
25
  function getTerm() {
27
26
  return require_env_rewire.getEnvValue("TERM");
28
27
  }
package/dist/env/test.js CHANGED
@@ -24,9 +24,8 @@ const require_env_string = require('./string.js');
24
24
  *
25
25
  * @returns The Jest worker ID string, or empty string if not set
26
26
  */
27
- /*@__NO_SIDE_EFFECTS__*/
28
27
  function getJestWorkerId() {
29
- return /* @__PURE__ */ require_env_string.envAsString(require_env_rewire.getEnvValue("JEST_WORKER_ID"));
28
+ return require_env_string.envAsString(require_env_rewire.getEnvValue("JEST_WORKER_ID"));
30
29
  }
31
30
  /**
32
31
  * VITEST environment variable. Set when running tests with Vitest.
@@ -42,9 +41,8 @@ function getJestWorkerId() {
42
41
  *
43
42
  * @returns `true` if running in Vitest, `false` otherwise
44
43
  */
45
- /*@__NO_SIDE_EFFECTS__*/
46
44
  function getVitest() {
47
- return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("VITEST"));
45
+ return require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("VITEST"));
48
46
  }
49
47
  /**
50
48
  * Check if code is running in a test environment. Checks NODE_ENV, VITEST, and
@@ -61,9 +59,8 @@ function getVitest() {
61
59
  *
62
60
  * @returns `true` if running in a test environment, `false` otherwise
63
61
  */
64
- /*@__NO_SIDE_EFFECTS__*/
65
62
  function isTest() {
66
- return /* @__PURE__ */ require_env_string.envAsString(/* @__PURE__ */ require_env_node_env.getNodeEnv()) === "test" || /* @__PURE__ */ getVitest() || !!/* @__PURE__ */ getJestWorkerId();
63
+ return require_env_string.envAsString(require_env_node_env.getNodeEnv()) === "test" || getVitest() || !!getJestWorkerId();
67
64
  }
68
65
 
69
66
  //#endregion
@@ -22,7 +22,6 @@ const require_env_rewire = require('./rewire.js');
22
22
  *
23
23
  * @returns The Windows AppData roaming directory, or `undefined` if not set
24
24
  */
25
- /*@__NO_SIDE_EFFECTS__*/
26
25
  function getAppdata() {
27
26
  return require_env_rewire.getEnvValue("APPDATA");
28
27
  }
@@ -40,7 +39,6 @@ function getAppdata() {
40
39
  *
41
40
  * @returns The path to the command processor, or `undefined` if not set
42
41
  */
43
- /*@__NO_SIDE_EFFECTS__*/
44
42
  function getComspec() {
45
43
  return require_env_rewire.getEnvValue("COMSPEC");
46
44
  }
@@ -58,7 +56,6 @@ function getComspec() {
58
56
  *
59
57
  * @returns The Windows local AppData directory, or `undefined` if not set
60
58
  */
61
- /*@__NO_SIDE_EFFECTS__*/
62
59
  function getLocalappdata() {
63
60
  return require_env_rewire.getEnvValue("LOCALAPPDATA");
64
61
  }
@@ -75,7 +72,6 @@ function getLocalappdata() {
75
72
  *
76
73
  * @returns The Windows user profile directory, or `undefined` if not set
77
74
  */
78
- /*@__NO_SIDE_EFFECTS__*/
79
75
  function getUserprofile() {
80
76
  return require_env_rewire.getEnvValue("USERPROFILE");
81
77
  }
package/dist/env/xdg.js CHANGED
@@ -22,7 +22,6 @@ const require_env_rewire = require('./rewire.js');
22
22
  *
23
23
  * @returns The XDG cache directory path, or `undefined` if not set
24
24
  */
25
- /*@__NO_SIDE_EFFECTS__*/
26
25
  function getXdgCacheHome() {
27
26
  return require_env_rewire.getEnvValue("XDG_CACHE_HOME");
28
27
  }
@@ -40,7 +39,6 @@ function getXdgCacheHome() {
40
39
  *
41
40
  * @returns The XDG config directory path, or `undefined` if not set
42
41
  */
43
- /*@__NO_SIDE_EFFECTS__*/
44
42
  function getXdgConfigHome() {
45
43
  return require_env_rewire.getEnvValue("XDG_CONFIG_HOME");
46
44
  }
@@ -58,7 +56,6 @@ function getXdgConfigHome() {
58
56
  *
59
57
  * @returns The XDG data directory path, or `undefined` if not set
60
58
  */
61
- /*@__NO_SIDE_EFFECTS__*/
62
59
  function getXdgDataHome() {
63
60
  return require_env_rewire.getEnvValue("XDG_DATA_HOME");
64
61
  }
@@ -8,10 +8,12 @@
8
8
  * License — Copyright (c) 2015-2023 Benjamin Coe, Isaac Z. Schlueter, and
9
9
  * Contributors.
10
10
  */
11
+ import type { EventEmitter } from 'node:events';
12
+ import type * as NodeEvents from 'node:events';
11
13
  import type { SignalExitEmitter } from './types';
12
14
  export declare const globalProcess: (NodeJS.Process & {
13
- __signal_exit_emitter__?: import('node:events').EventEmitter;
14
- reallyExit?: (code?: number | undefined) => never;
15
+ __signal_exit_emitter__?: EventEmitter | undefined;
16
+ reallyExit?: ((code?: number | undefined) => never) | undefined;
15
17
  }) | undefined;
16
18
  export declare const originalProcessEmit: {
17
19
  (event: "beforeExit", code: number): boolean;
@@ -23,17 +25,17 @@ export declare const originalProcessEmit: {
23
25
  (event: "unhandledRejection", reason: unknown, promise: Promise<unknown>): boolean;
24
26
  (event: "warning", warning: Error): boolean;
25
27
  (event: "message", message: unknown, sendHandle: import("child_process").SendHandle): NodeJS.Process & {
26
- __signal_exit_emitter__?: import('node:events').EventEmitter;
27
- reallyExit?: (code?: number | undefined) => never;
28
+ __signal_exit_emitter__?: EventEmitter | undefined;
29
+ reallyExit?: ((code?: number | undefined) => never) | undefined;
28
30
  };
29
31
  (event: NodeJS.Signals, signal?: NodeJS.Signals): boolean;
30
32
  (event: "multipleResolves", type: NodeJS.MultipleResolveType, promise: Promise<unknown>, value: unknown): NodeJS.Process & {
31
- __signal_exit_emitter__?: import('node:events').EventEmitter;
32
- reallyExit?: (code?: number | undefined) => never;
33
+ __signal_exit_emitter__?: EventEmitter | undefined;
34
+ reallyExit?: ((code?: number | undefined) => never) | undefined;
33
35
  };
34
36
  (event: "worker", listener: NodeJS.WorkerListener): NodeJS.Process & {
35
- __signal_exit_emitter__?: import('node:events').EventEmitter;
36
- reallyExit?: (code?: number | undefined) => never;
37
+ __signal_exit_emitter__?: EventEmitter | undefined;
38
+ reallyExit?: ((code?: number | undefined) => never) | undefined;
37
39
  };
38
40
  } | undefined;
39
41
  export declare const platform: string;
@@ -41,7 +43,7 @@ export declare const originalProcessReallyExit: ((code?: number | undefined) =>
41
43
  export declare const WIN32: boolean;
42
44
  export declare function emit(event: string, code: number | undefined, signal: string | undefined): void;
43
45
  export declare function getEmitter(): SignalExitEmitter;
44
- export declare function getEvents(): typeof import('node:events');
46
+ export declare function getEvents(): typeof NodeEvents;
45
47
  /**
46
48
  * Get the cached signal list. Triggers lazy init on first call; after `load()`
47
49
  * runs it returns the filtered subset of successfully registered signals
@@ -8,67 +8,63 @@ const originalProcessEmit = globalProcess?.emit;
8
8
  const platform = globalProcess?.platform ?? "";
9
9
  const originalProcessReallyExit = globalProcess?.reallyExit;
10
10
  const WIN32 = platform === "win32";
11
- let _events;
12
- let _emitter;
13
- let _loaded = false;
14
- let _signals;
11
+ let events;
12
+ let emitter;
13
+ let loaded = false;
14
+ let signals;
15
15
  /* c8 ignore start - Only called from signal-listener body and
16
16
  processEmit/processReallyExit interceptors, all of which are
17
17
  c8-ignored. Cannot be reached from the test runner. */
18
- /*@__NO_SIDE_EFFECTS__*/
19
18
  function emit(event, code, signal) {
20
- const emitter = /* @__PURE__ */ getEmitter();
21
- if (emitter.emitted?.[event]) return;
22
- if (emitter.emitted) emitter.emitted[event] = true;
23
- emitter.emit(event, code, signal);
19
+ const sigEmitter = getEmitter();
20
+ if (sigEmitter.emitted?.[event]) return;
21
+ if (sigEmitter.emitted) sigEmitter.emitted[event] = true;
22
+ sigEmitter.emit(event, code, signal);
24
23
  }
25
24
  /* c8 ignore stop */
26
- /*@__NO_SIDE_EFFECTS__*/
27
25
  function getEmitter() {
28
- /* c8 ignore start */
29
- if (_emitter === void 0) {
30
- if (globalProcess?.__signal_exit_emitter__) _emitter = globalProcess.__signal_exit_emitter__;
26
+ /* c8 ignore start - cross-copy signal-exit init, unreachable from test runner */
27
+ if (emitter === void 0) {
28
+ if (globalProcess?.__signal_exit_emitter__) emitter = globalProcess.__signal_exit_emitter__;
31
29
  else if (globalProcess) {
32
- const EventEmitter = (/* @__PURE__ */ getEvents()).EventEmitter;
33
- _emitter = globalProcess.__signal_exit_emitter__ = new EventEmitter();
34
- _emitter.count = 0;
35
- _emitter.emitted = { __proto__: null };
30
+ const EventEmitterClass = getEvents().EventEmitter;
31
+ emitter = globalProcess.__signal_exit_emitter__ = new EventEmitterClass();
32
+ emitter.count = 0;
33
+ emitter.emitted = { __proto__: null };
36
34
  }
37
- if (_emitter && !_emitter.infinite) {
38
- _emitter.setMaxListeners(Number.POSITIVE_INFINITY);
39
- _emitter.infinite = true;
35
+ if (emitter && !emitter.infinite) {
36
+ emitter.setMaxListeners(Number.POSITIVE_INFINITY);
37
+ emitter.infinite = true;
40
38
  }
41
39
  }
42
40
  /* c8 ignore stop */
43
- return _emitter;
41
+ return emitter;
44
42
  }
45
- /*@__NO_SIDE_EFFECTS__*/
46
43
  function getEvents() {
47
- /* c8 ignore start */
48
- if (_events === void 0) _events = /*@__PURE__*/ require("node:events");
44
+ /* c8 ignore start - lazy require, second-call branch unreachable from test runner */
45
+ if (events === void 0) events = /*@__PURE__*/ require("node:events");
49
46
  /* c8 ignore stop */
50
- return _events;
47
+ return events;
51
48
  }
52
49
  /**
53
50
  * Get the cached signal list. Triggers lazy init on first call; after `load()`
54
51
  * runs it returns the filtered subset of successfully registered signals
55
52
  * instead of the full default list.
56
53
  */
57
- /*@__NO_SIDE_EFFECTS__*/
58
54
  function getSignals() {
59
- if (_signals === void 0) {
60
- _signals = [
55
+ if (signals === void 0) {
56
+ signals = [
61
57
  "SIGABRT",
62
58
  "SIGALRM",
63
59
  "SIGHUP",
64
60
  "SIGINT",
65
61
  "SIGTERM"
66
62
  ];
67
- /* c8 ignore start */
68
- if (!WIN32) _signals.push("SIGVTALRM", "SIGXCPU", "SIGXFSZ", "SIGUSR2", "SIGTRAP", "SIGSYS", "SIGQUIT", "SIGIOT");
69
- if (platform === "linux") _signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT", "SIGUNUSED");
63
+ /* c8 ignore start - platform-specific signal lists run only on their target OS */
64
+ if (!WIN32) signals.push("SIGVTALRM", "SIGXCPU", "SIGXFSZ", "SIGUSR2", "SIGTRAP", "SIGSYS", "SIGQUIT", "SIGIOT");
65
+ if (platform === "linux") signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT", "SIGUNUSED");
70
66
  }
71
- return _signals;
67
+ return signals;
72
68
  }
73
69
  /**
74
70
  * Read the loaded flag from a sibling leaf (lifecycle / on-exit).
@@ -76,7 +72,7 @@ function getSignals() {
76
72
  * @private
77
73
  */
78
74
  function isLoaded() {
79
- return _loaded;
75
+ return loaded;
80
76
  }
81
77
  /**
82
78
  * Set the `loaded` flag from a sibling leaf (load / unload).
@@ -84,7 +80,7 @@ function isLoaded() {
84
80
  * @private
85
81
  */
86
82
  function setLoaded(value) {
87
- _loaded = value;
83
+ loaded = value;
88
84
  }
89
85
  /**
90
86
  * Replace the cached signal list (used by `load()`'s filter step).
@@ -92,7 +88,7 @@ function setLoaded(value) {
92
88
  * @private
93
89
  */
94
90
  function setSignals(value) {
95
- _signals = value;
91
+ signals = value;
96
92
  }
97
93
 
98
94
  //#endregion