language-operator 0.1.81 → 0.1.82

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 (427) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/agents/README.md +16 -0
  3. data/.claude/agents/changelog-writer.md +181 -0
  4. data/.claude/hooks/README.md +43 -0
  5. data/.claude/hooks/node_modules/.bin/esbuild +1 -0
  6. data/.claude/hooks/node_modules/.bin/tsc +1 -0
  7. data/.claude/hooks/node_modules/.bin/tsserver +1 -0
  8. data/.claude/hooks/node_modules/.bin/tsx +1 -0
  9. data/.claude/hooks/node_modules/.package-lock.json +136 -0
  10. data/.claude/hooks/node_modules/@esbuild/linux-x64/README.md +3 -0
  11. data/.claude/hooks/node_modules/@esbuild/linux-x64/bin/esbuild +0 -0
  12. data/.claude/hooks/node_modules/@esbuild/linux-x64/package.json +20 -0
  13. data/.claude/hooks/node_modules/@types/node/LICENSE +21 -0
  14. data/.claude/hooks/node_modules/@types/node/README.md +15 -0
  15. data/.claude/hooks/node_modules/@types/node/assert/strict.d.ts +105 -0
  16. data/.claude/hooks/node_modules/@types/node/assert.d.ts +955 -0
  17. data/.claude/hooks/node_modules/@types/node/async_hooks.d.ts +623 -0
  18. data/.claude/hooks/node_modules/@types/node/buffer.buffer.d.ts +466 -0
  19. data/.claude/hooks/node_modules/@types/node/buffer.d.ts +1810 -0
  20. data/.claude/hooks/node_modules/@types/node/child_process.d.ts +1428 -0
  21. data/.claude/hooks/node_modules/@types/node/cluster.d.ts +486 -0
  22. data/.claude/hooks/node_modules/@types/node/compatibility/iterators.d.ts +21 -0
  23. data/.claude/hooks/node_modules/@types/node/console.d.ts +151 -0
  24. data/.claude/hooks/node_modules/@types/node/constants.d.ts +20 -0
  25. data/.claude/hooks/node_modules/@types/node/crypto.d.ts +4065 -0
  26. data/.claude/hooks/node_modules/@types/node/dgram.d.ts +564 -0
  27. data/.claude/hooks/node_modules/@types/node/diagnostics_channel.d.ts +576 -0
  28. data/.claude/hooks/node_modules/@types/node/dns/promises.d.ts +503 -0
  29. data/.claude/hooks/node_modules/@types/node/dns.d.ts +922 -0
  30. data/.claude/hooks/node_modules/@types/node/domain.d.ts +166 -0
  31. data/.claude/hooks/node_modules/@types/node/events.d.ts +1054 -0
  32. data/.claude/hooks/node_modules/@types/node/fs/promises.d.ts +1316 -0
  33. data/.claude/hooks/node_modules/@types/node/fs.d.ts +4676 -0
  34. data/.claude/hooks/node_modules/@types/node/globals.d.ts +150 -0
  35. data/.claude/hooks/node_modules/@types/node/globals.typedarray.d.ts +101 -0
  36. data/.claude/hooks/node_modules/@types/node/http.d.ts +2143 -0
  37. data/.claude/hooks/node_modules/@types/node/http2.d.ts +2480 -0
  38. data/.claude/hooks/node_modules/@types/node/https.d.ts +399 -0
  39. data/.claude/hooks/node_modules/@types/node/index.d.ts +115 -0
  40. data/.claude/hooks/node_modules/@types/node/inspector/promises.d.ts +41 -0
  41. data/.claude/hooks/node_modules/@types/node/inspector.d.ts +224 -0
  42. data/.claude/hooks/node_modules/@types/node/inspector.generated.d.ts +4226 -0
  43. data/.claude/hooks/node_modules/@types/node/module.d.ts +819 -0
  44. data/.claude/hooks/node_modules/@types/node/net.d.ts +933 -0
  45. data/.claude/hooks/node_modules/@types/node/os.d.ts +507 -0
  46. data/.claude/hooks/node_modules/@types/node/package.json +155 -0
  47. data/.claude/hooks/node_modules/@types/node/path/posix.d.ts +8 -0
  48. data/.claude/hooks/node_modules/@types/node/path/win32.d.ts +8 -0
  49. data/.claude/hooks/node_modules/@types/node/path.d.ts +187 -0
  50. data/.claude/hooks/node_modules/@types/node/perf_hooks.d.ts +621 -0
  51. data/.claude/hooks/node_modules/@types/node/process.d.ts +2097 -0
  52. data/.claude/hooks/node_modules/@types/node/punycode.d.ts +117 -0
  53. data/.claude/hooks/node_modules/@types/node/querystring.d.ts +152 -0
  54. data/.claude/hooks/node_modules/@types/node/quic.d.ts +910 -0
  55. data/.claude/hooks/node_modules/@types/node/readline/promises.d.ts +161 -0
  56. data/.claude/hooks/node_modules/@types/node/readline.d.ts +541 -0
  57. data/.claude/hooks/node_modules/@types/node/repl.d.ts +415 -0
  58. data/.claude/hooks/node_modules/@types/node/sea.d.ts +162 -0
  59. data/.claude/hooks/node_modules/@types/node/sqlite.d.ts +937 -0
  60. data/.claude/hooks/node_modules/@types/node/stream/consumers.d.ts +38 -0
  61. data/.claude/hooks/node_modules/@types/node/stream/promises.d.ts +211 -0
  62. data/.claude/hooks/node_modules/@types/node/stream/web.d.ts +296 -0
  63. data/.claude/hooks/node_modules/@types/node/stream.d.ts +1760 -0
  64. data/.claude/hooks/node_modules/@types/node/string_decoder.d.ts +67 -0
  65. data/.claude/hooks/node_modules/@types/node/test/reporters.d.ts +96 -0
  66. data/.claude/hooks/node_modules/@types/node/test.d.ts +2239 -0
  67. data/.claude/hooks/node_modules/@types/node/timers/promises.d.ts +108 -0
  68. data/.claude/hooks/node_modules/@types/node/timers.d.ts +159 -0
  69. data/.claude/hooks/node_modules/@types/node/tls.d.ts +1194 -0
  70. data/.claude/hooks/node_modules/@types/node/trace_events.d.ts +197 -0
  71. data/.claude/hooks/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +462 -0
  72. data/.claude/hooks/node_modules/@types/node/ts5.6/compatibility/float16array.d.ts +71 -0
  73. data/.claude/hooks/node_modules/@types/node/ts5.6/globals.typedarray.d.ts +36 -0
  74. data/.claude/hooks/node_modules/@types/node/ts5.6/index.d.ts +117 -0
  75. data/.claude/hooks/node_modules/@types/node/ts5.7/compatibility/float16array.d.ts +72 -0
  76. data/.claude/hooks/node_modules/@types/node/ts5.7/index.d.ts +117 -0
  77. data/.claude/hooks/node_modules/@types/node/tty.d.ts +250 -0
  78. data/.claude/hooks/node_modules/@types/node/url.d.ts +519 -0
  79. data/.claude/hooks/node_modules/@types/node/util/types.d.ts +558 -0
  80. data/.claude/hooks/node_modules/@types/node/util.d.ts +1653 -0
  81. data/.claude/hooks/node_modules/@types/node/v8.d.ts +979 -0
  82. data/.claude/hooks/node_modules/@types/node/vm.d.ts +1180 -0
  83. data/.claude/hooks/node_modules/@types/node/wasi.d.ts +202 -0
  84. data/.claude/hooks/node_modules/@types/node/web-globals/abortcontroller.d.ts +59 -0
  85. data/.claude/hooks/node_modules/@types/node/web-globals/blob.d.ts +23 -0
  86. data/.claude/hooks/node_modules/@types/node/web-globals/console.d.ts +9 -0
  87. data/.claude/hooks/node_modules/@types/node/web-globals/crypto.d.ts +39 -0
  88. data/.claude/hooks/node_modules/@types/node/web-globals/domexception.d.ts +68 -0
  89. data/.claude/hooks/node_modules/@types/node/web-globals/encoding.d.ts +11 -0
  90. data/.claude/hooks/node_modules/@types/node/web-globals/events.d.ts +106 -0
  91. data/.claude/hooks/node_modules/@types/node/web-globals/fetch.d.ts +54 -0
  92. data/.claude/hooks/node_modules/@types/node/web-globals/importmeta.d.ts +13 -0
  93. data/.claude/hooks/node_modules/@types/node/web-globals/messaging.d.ts +23 -0
  94. data/.claude/hooks/node_modules/@types/node/web-globals/navigator.d.ts +25 -0
  95. data/.claude/hooks/node_modules/@types/node/web-globals/performance.d.ts +45 -0
  96. data/.claude/hooks/node_modules/@types/node/web-globals/storage.d.ts +24 -0
  97. data/.claude/hooks/node_modules/@types/node/web-globals/streams.d.ts +115 -0
  98. data/.claude/hooks/node_modules/@types/node/web-globals/timers.d.ts +44 -0
  99. data/.claude/hooks/node_modules/@types/node/web-globals/url.d.ts +24 -0
  100. data/.claude/hooks/node_modules/@types/node/worker_threads.d.ts +714 -0
  101. data/.claude/hooks/node_modules/@types/node/zlib.d.ts +618 -0
  102. data/.claude/hooks/node_modules/esbuild/LICENSE.md +21 -0
  103. data/.claude/hooks/node_modules/esbuild/README.md +3 -0
  104. data/.claude/hooks/node_modules/esbuild/bin/esbuild +0 -0
  105. data/.claude/hooks/node_modules/esbuild/install.js +289 -0
  106. data/.claude/hooks/node_modules/esbuild/lib/main.d.ts +716 -0
  107. data/.claude/hooks/node_modules/esbuild/lib/main.js +2242 -0
  108. data/.claude/hooks/node_modules/esbuild/package.json +49 -0
  109. data/.claude/hooks/node_modules/get-tsconfig/LICENSE +21 -0
  110. data/.claude/hooks/node_modules/get-tsconfig/README.md +235 -0
  111. data/.claude/hooks/node_modules/get-tsconfig/dist/index.cjs +7 -0
  112. data/.claude/hooks/node_modules/get-tsconfig/dist/index.d.cts +2088 -0
  113. data/.claude/hooks/node_modules/get-tsconfig/dist/index.d.mts +2088 -0
  114. data/.claude/hooks/node_modules/get-tsconfig/dist/index.mjs +7 -0
  115. data/.claude/hooks/node_modules/get-tsconfig/package.json +46 -0
  116. data/.claude/hooks/node_modules/resolve-pkg-maps/LICENSE +21 -0
  117. data/.claude/hooks/node_modules/resolve-pkg-maps/README.md +216 -0
  118. data/.claude/hooks/node_modules/resolve-pkg-maps/dist/index.cjs +1 -0
  119. data/.claude/hooks/node_modules/resolve-pkg-maps/dist/index.d.cts +11 -0
  120. data/.claude/hooks/node_modules/resolve-pkg-maps/dist/index.d.mts +11 -0
  121. data/.claude/hooks/node_modules/resolve-pkg-maps/dist/index.mjs +1 -0
  122. data/.claude/hooks/node_modules/resolve-pkg-maps/package.json +42 -0
  123. data/.claude/hooks/node_modules/tsx/LICENSE +21 -0
  124. data/.claude/hooks/node_modules/tsx/README.md +32 -0
  125. data/.claude/hooks/node_modules/tsx/dist/cjs/api/index.cjs +1 -0
  126. data/.claude/hooks/node_modules/tsx/dist/cjs/api/index.d.cts +35 -0
  127. data/.claude/hooks/node_modules/tsx/dist/cjs/api/index.d.mts +35 -0
  128. data/.claude/hooks/node_modules/tsx/dist/cjs/api/index.mjs +1 -0
  129. data/.claude/hooks/node_modules/tsx/dist/cjs/index.cjs +1 -0
  130. data/.claude/hooks/node_modules/tsx/dist/cjs/index.mjs +1 -0
  131. data/.claude/hooks/node_modules/tsx/dist/cli.cjs +54 -0
  132. data/.claude/hooks/node_modules/tsx/dist/cli.mjs +55 -0
  133. data/.claude/hooks/node_modules/tsx/dist/client-BQVF1NaW.mjs +1 -0
  134. data/.claude/hooks/node_modules/tsx/dist/client-D6NvIMSC.cjs +1 -0
  135. data/.claude/hooks/node_modules/tsx/dist/esm/api/index.cjs +1 -0
  136. data/.claude/hooks/node_modules/tsx/dist/esm/api/index.d.cts +35 -0
  137. data/.claude/hooks/node_modules/tsx/dist/esm/api/index.d.mts +35 -0
  138. data/.claude/hooks/node_modules/tsx/dist/esm/api/index.mjs +1 -0
  139. data/.claude/hooks/node_modules/tsx/dist/esm/index.cjs +2 -0
  140. data/.claude/hooks/node_modules/tsx/dist/esm/index.mjs +2 -0
  141. data/.claude/hooks/node_modules/tsx/dist/get-pipe-path-BHW2eJdv.mjs +1 -0
  142. data/.claude/hooks/node_modules/tsx/dist/get-pipe-path-BoR10qr8.cjs +1 -0
  143. data/.claude/hooks/node_modules/tsx/dist/index-7AaEi15b.mjs +14 -0
  144. data/.claude/hooks/node_modules/tsx/dist/index-BWFBUo6r.cjs +1 -0
  145. data/.claude/hooks/node_modules/tsx/dist/index-gbaejti9.mjs +1 -0
  146. data/.claude/hooks/node_modules/tsx/dist/index-gckBtVBf.cjs +14 -0
  147. data/.claude/hooks/node_modules/tsx/dist/lexer-DQCqS3nf.mjs +3 -0
  148. data/.claude/hooks/node_modules/tsx/dist/lexer-DgIbo0BU.cjs +3 -0
  149. data/.claude/hooks/node_modules/tsx/dist/loader.cjs +1 -0
  150. data/.claude/hooks/node_modules/tsx/dist/loader.mjs +1 -0
  151. data/.claude/hooks/node_modules/tsx/dist/node-features-_8ZFwP_x.mjs +1 -0
  152. data/.claude/hooks/node_modules/tsx/dist/node-features-roYmp9jK.cjs +1 -0
  153. data/.claude/hooks/node_modules/tsx/dist/package-CeBgXWuR.mjs +1 -0
  154. data/.claude/hooks/node_modules/tsx/dist/package-Dxt5kIHw.cjs +1 -0
  155. data/.claude/hooks/node_modules/tsx/dist/patch-repl.cjs +1 -0
  156. data/.claude/hooks/node_modules/tsx/dist/patch-repl.mjs +1 -0
  157. data/.claude/hooks/node_modules/tsx/dist/preflight.cjs +1 -0
  158. data/.claude/hooks/node_modules/tsx/dist/preflight.mjs +1 -0
  159. data/.claude/hooks/node_modules/tsx/dist/register-2sWVXuRQ.cjs +1 -0
  160. data/.claude/hooks/node_modules/tsx/dist/register-B7jrtLTO.mjs +1 -0
  161. data/.claude/hooks/node_modules/tsx/dist/register-CFH5oNdT.mjs +4 -0
  162. data/.claude/hooks/node_modules/tsx/dist/register-D46fvsV_.cjs +4 -0
  163. data/.claude/hooks/node_modules/tsx/dist/repl.cjs +3 -0
  164. data/.claude/hooks/node_modules/tsx/dist/repl.mjs +3 -0
  165. data/.claude/hooks/node_modules/tsx/dist/require-D4F1Lv60.cjs +1 -0
  166. data/.claude/hooks/node_modules/tsx/dist/require-DQxpCAr4.mjs +1 -0
  167. data/.claude/hooks/node_modules/tsx/dist/suppress-warnings.cjs +1 -0
  168. data/.claude/hooks/node_modules/tsx/dist/suppress-warnings.mjs +1 -0
  169. data/.claude/hooks/node_modules/tsx/dist/temporary-directory-B83uKxJF.cjs +1 -0
  170. data/.claude/hooks/node_modules/tsx/dist/temporary-directory-CwHp0_NW.mjs +1 -0
  171. data/.claude/hooks/node_modules/tsx/dist/types-Cxp8y2TL.d.ts +5 -0
  172. data/.claude/hooks/node_modules/tsx/package.json +68 -0
  173. data/.claude/hooks/node_modules/typescript/LICENSE.txt +55 -0
  174. data/.claude/hooks/node_modules/typescript/README.md +50 -0
  175. data/.claude/hooks/node_modules/typescript/SECURITY.md +41 -0
  176. data/.claude/hooks/node_modules/typescript/ThirdPartyNoticeText.txt +193 -0
  177. data/.claude/hooks/node_modules/typescript/bin/tsc +2 -0
  178. data/.claude/hooks/node_modules/typescript/bin/tsserver +2 -0
  179. data/.claude/hooks/node_modules/typescript/lib/_tsc.js +133818 -0
  180. data/.claude/hooks/node_modules/typescript/lib/_tsserver.js +659 -0
  181. data/.claude/hooks/node_modules/typescript/lib/_typingsInstaller.js +222 -0
  182. data/.claude/hooks/node_modules/typescript/lib/cs/diagnosticMessages.generated.json +2122 -0
  183. data/.claude/hooks/node_modules/typescript/lib/de/diagnosticMessages.generated.json +2122 -0
  184. data/.claude/hooks/node_modules/typescript/lib/es/diagnosticMessages.generated.json +2122 -0
  185. data/.claude/hooks/node_modules/typescript/lib/fr/diagnosticMessages.generated.json +2122 -0
  186. data/.claude/hooks/node_modules/typescript/lib/it/diagnosticMessages.generated.json +2122 -0
  187. data/.claude/hooks/node_modules/typescript/lib/ja/diagnosticMessages.generated.json +2122 -0
  188. data/.claude/hooks/node_modules/typescript/lib/ko/diagnosticMessages.generated.json +2122 -0
  189. data/.claude/hooks/node_modules/typescript/lib/lib.d.ts +22 -0
  190. data/.claude/hooks/node_modules/typescript/lib/lib.decorators.d.ts +384 -0
  191. data/.claude/hooks/node_modules/typescript/lib/lib.decorators.legacy.d.ts +22 -0
  192. data/.claude/hooks/node_modules/typescript/lib/lib.dom.asynciterable.d.ts +41 -0
  193. data/.claude/hooks/node_modules/typescript/lib/lib.dom.d.ts +39429 -0
  194. data/.claude/hooks/node_modules/typescript/lib/lib.dom.iterable.d.ts +571 -0
  195. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.collection.d.ts +147 -0
  196. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.core.d.ts +597 -0
  197. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.d.ts +28 -0
  198. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.generator.d.ts +77 -0
  199. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.iterable.d.ts +605 -0
  200. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.promise.d.ts +81 -0
  201. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.proxy.d.ts +128 -0
  202. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.reflect.d.ts +144 -0
  203. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.symbol.d.ts +46 -0
  204. data/.claude/hooks/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts +326 -0
  205. data/.claude/hooks/node_modules/typescript/lib/lib.es2016.array.include.d.ts +116 -0
  206. data/.claude/hooks/node_modules/typescript/lib/lib.es2016.d.ts +21 -0
  207. data/.claude/hooks/node_modules/typescript/lib/lib.es2016.full.d.ts +23 -0
  208. data/.claude/hooks/node_modules/typescript/lib/lib.es2016.intl.d.ts +31 -0
  209. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.arraybuffer.d.ts +21 -0
  210. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.d.ts +26 -0
  211. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.date.d.ts +31 -0
  212. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.full.d.ts +23 -0
  213. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.intl.d.ts +44 -0
  214. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.object.d.ts +49 -0
  215. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts +135 -0
  216. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.string.d.ts +45 -0
  217. data/.claude/hooks/node_modules/typescript/lib/lib.es2017.typedarrays.d.ts +53 -0
  218. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts +77 -0
  219. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.asynciterable.d.ts +53 -0
  220. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.d.ts +24 -0
  221. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.full.d.ts +24 -0
  222. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.intl.d.ts +83 -0
  223. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.promise.d.ts +30 -0
  224. data/.claude/hooks/node_modules/typescript/lib/lib.es2018.regexp.d.ts +37 -0
  225. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.array.d.ts +79 -0
  226. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.d.ts +24 -0
  227. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.full.d.ts +24 -0
  228. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.intl.d.ts +23 -0
  229. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.object.d.ts +33 -0
  230. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.string.d.ts +37 -0
  231. data/.claude/hooks/node_modules/typescript/lib/lib.es2019.symbol.d.ts +24 -0
  232. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.bigint.d.ts +765 -0
  233. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.d.ts +27 -0
  234. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.date.d.ts +42 -0
  235. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.full.d.ts +24 -0
  236. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.intl.d.ts +474 -0
  237. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.number.d.ts +28 -0
  238. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.promise.d.ts +47 -0
  239. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts +99 -0
  240. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.string.d.ts +44 -0
  241. data/.claude/hooks/node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts +41 -0
  242. data/.claude/hooks/node_modules/typescript/lib/lib.es2021.d.ts +23 -0
  243. data/.claude/hooks/node_modules/typescript/lib/lib.es2021.full.d.ts +24 -0
  244. data/.claude/hooks/node_modules/typescript/lib/lib.es2021.intl.d.ts +166 -0
  245. data/.claude/hooks/node_modules/typescript/lib/lib.es2021.promise.d.ts +48 -0
  246. data/.claude/hooks/node_modules/typescript/lib/lib.es2021.string.d.ts +33 -0
  247. data/.claude/hooks/node_modules/typescript/lib/lib.es2021.weakref.d.ts +78 -0
  248. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.array.d.ts +121 -0
  249. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.d.ts +25 -0
  250. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.error.d.ts +75 -0
  251. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.full.d.ts +24 -0
  252. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.intl.d.ts +145 -0
  253. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.object.d.ts +26 -0
  254. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.regexp.d.ts +39 -0
  255. data/.claude/hooks/node_modules/typescript/lib/lib.es2022.string.d.ts +25 -0
  256. data/.claude/hooks/node_modules/typescript/lib/lib.es2023.array.d.ts +924 -0
  257. data/.claude/hooks/node_modules/typescript/lib/lib.es2023.collection.d.ts +21 -0
  258. data/.claude/hooks/node_modules/typescript/lib/lib.es2023.d.ts +22 -0
  259. data/.claude/hooks/node_modules/typescript/lib/lib.es2023.full.d.ts +24 -0
  260. data/.claude/hooks/node_modules/typescript/lib/lib.es2023.intl.d.ts +56 -0
  261. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.arraybuffer.d.ts +65 -0
  262. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.collection.d.ts +29 -0
  263. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.d.ts +26 -0
  264. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.full.d.ts +24 -0
  265. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.object.d.ts +29 -0
  266. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.promise.d.ts +35 -0
  267. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.regexp.d.ts +25 -0
  268. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.sharedmemory.d.ts +68 -0
  269. data/.claude/hooks/node_modules/typescript/lib/lib.es2024.string.d.ts +29 -0
  270. data/.claude/hooks/node_modules/typescript/lib/lib.es5.d.ts +4601 -0
  271. data/.claude/hooks/node_modules/typescript/lib/lib.es6.d.ts +23 -0
  272. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.array.d.ts +35 -0
  273. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.collection.d.ts +96 -0
  274. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.d.ts +29 -0
  275. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.decorators.d.ts +28 -0
  276. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.disposable.d.ts +193 -0
  277. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.error.d.ts +24 -0
  278. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.float16.d.ts +445 -0
  279. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.full.d.ts +24 -0
  280. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.intl.d.ts +21 -0
  281. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.iterator.d.ts +148 -0
  282. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.promise.d.ts +34 -0
  283. data/.claude/hooks/node_modules/typescript/lib/lib.esnext.sharedmemory.d.ts +25 -0
  284. data/.claude/hooks/node_modules/typescript/lib/lib.scripthost.d.ts +322 -0
  285. data/.claude/hooks/node_modules/typescript/lib/lib.webworker.asynciterable.d.ts +41 -0
  286. data/.claude/hooks/node_modules/typescript/lib/lib.webworker.d.ts +13150 -0
  287. data/.claude/hooks/node_modules/typescript/lib/lib.webworker.importscripts.d.ts +23 -0
  288. data/.claude/hooks/node_modules/typescript/lib/lib.webworker.iterable.d.ts +340 -0
  289. data/.claude/hooks/node_modules/typescript/lib/pl/diagnosticMessages.generated.json +2122 -0
  290. data/.claude/hooks/node_modules/typescript/lib/pt-br/diagnosticMessages.generated.json +2122 -0
  291. data/.claude/hooks/node_modules/typescript/lib/ru/diagnosticMessages.generated.json +2122 -0
  292. data/.claude/hooks/node_modules/typescript/lib/tr/diagnosticMessages.generated.json +2122 -0
  293. data/.claude/hooks/node_modules/typescript/lib/tsc.js +8 -0
  294. data/.claude/hooks/node_modules/typescript/lib/tsserver.js +8 -0
  295. data/.claude/hooks/node_modules/typescript/lib/tsserverlibrary.d.ts +17 -0
  296. data/.claude/hooks/node_modules/typescript/lib/tsserverlibrary.js +21 -0
  297. data/.claude/hooks/node_modules/typescript/lib/typesMap.json +497 -0
  298. data/.claude/hooks/node_modules/typescript/lib/typescript.d.ts +11437 -0
  299. data/.claude/hooks/node_modules/typescript/lib/typescript.js +200276 -0
  300. data/.claude/hooks/node_modules/typescript/lib/typingsInstaller.js +8 -0
  301. data/.claude/hooks/node_modules/typescript/lib/watchGuard.js +53 -0
  302. data/.claude/hooks/node_modules/typescript/lib/zh-cn/diagnosticMessages.generated.json +2122 -0
  303. data/.claude/hooks/node_modules/typescript/lib/zh-tw/diagnosticMessages.generated.json +2122 -0
  304. data/.claude/hooks/node_modules/typescript/package.json +120 -0
  305. data/.claude/hooks/node_modules/undici-types/LICENSE +21 -0
  306. data/.claude/hooks/node_modules/undici-types/README.md +6 -0
  307. data/.claude/hooks/node_modules/undici-types/agent.d.ts +32 -0
  308. data/.claude/hooks/node_modules/undici-types/api.d.ts +43 -0
  309. data/.claude/hooks/node_modules/undici-types/balanced-pool.d.ts +29 -0
  310. data/.claude/hooks/node_modules/undici-types/cache-interceptor.d.ts +172 -0
  311. data/.claude/hooks/node_modules/undici-types/cache.d.ts +36 -0
  312. data/.claude/hooks/node_modules/undici-types/client-stats.d.ts +15 -0
  313. data/.claude/hooks/node_modules/undici-types/client.d.ts +108 -0
  314. data/.claude/hooks/node_modules/undici-types/connector.d.ts +34 -0
  315. data/.claude/hooks/node_modules/undici-types/content-type.d.ts +21 -0
  316. data/.claude/hooks/node_modules/undici-types/cookies.d.ts +30 -0
  317. data/.claude/hooks/node_modules/undici-types/diagnostics-channel.d.ts +74 -0
  318. data/.claude/hooks/node_modules/undici-types/dispatcher.d.ts +276 -0
  319. data/.claude/hooks/node_modules/undici-types/env-http-proxy-agent.d.ts +22 -0
  320. data/.claude/hooks/node_modules/undici-types/errors.d.ts +161 -0
  321. data/.claude/hooks/node_modules/undici-types/eventsource.d.ts +66 -0
  322. data/.claude/hooks/node_modules/undici-types/fetch.d.ts +211 -0
  323. data/.claude/hooks/node_modules/undici-types/formdata.d.ts +108 -0
  324. data/.claude/hooks/node_modules/undici-types/global-dispatcher.d.ts +9 -0
  325. data/.claude/hooks/node_modules/undici-types/global-origin.d.ts +7 -0
  326. data/.claude/hooks/node_modules/undici-types/h2c-client.d.ts +73 -0
  327. data/.claude/hooks/node_modules/undici-types/handlers.d.ts +15 -0
  328. data/.claude/hooks/node_modules/undici-types/header.d.ts +160 -0
  329. data/.claude/hooks/node_modules/undici-types/index.d.ts +80 -0
  330. data/.claude/hooks/node_modules/undici-types/interceptors.d.ts +39 -0
  331. data/.claude/hooks/node_modules/undici-types/mock-agent.d.ts +68 -0
  332. data/.claude/hooks/node_modules/undici-types/mock-call-history.d.ts +111 -0
  333. data/.claude/hooks/node_modules/undici-types/mock-client.d.ts +27 -0
  334. data/.claude/hooks/node_modules/undici-types/mock-errors.d.ts +12 -0
  335. data/.claude/hooks/node_modules/undici-types/mock-interceptor.d.ts +94 -0
  336. data/.claude/hooks/node_modules/undici-types/mock-pool.d.ts +27 -0
  337. data/.claude/hooks/node_modules/undici-types/package.json +55 -0
  338. data/.claude/hooks/node_modules/undici-types/patch.d.ts +29 -0
  339. data/.claude/hooks/node_modules/undici-types/pool-stats.d.ts +19 -0
  340. data/.claude/hooks/node_modules/undici-types/pool.d.ts +41 -0
  341. data/.claude/hooks/node_modules/undici-types/proxy-agent.d.ts +29 -0
  342. data/.claude/hooks/node_modules/undici-types/readable.d.ts +68 -0
  343. data/.claude/hooks/node_modules/undici-types/retry-agent.d.ts +8 -0
  344. data/.claude/hooks/node_modules/undici-types/retry-handler.d.ts +125 -0
  345. data/.claude/hooks/node_modules/undici-types/snapshot-agent.d.ts +109 -0
  346. data/.claude/hooks/node_modules/undici-types/util.d.ts +18 -0
  347. data/.claude/hooks/node_modules/undici-types/utility.d.ts +7 -0
  348. data/.claude/hooks/node_modules/undici-types/webidl.d.ts +341 -0
  349. data/.claude/hooks/node_modules/undici-types/websocket.d.ts +186 -0
  350. data/.claude/hooks/package-lock.json +562 -0
  351. data/.claude/hooks/package.json +19 -0
  352. data/.claude/hooks/skill-activation-prompt.sh +11 -0
  353. data/.claude/hooks/skill-activation-prompt.ts +185 -0
  354. data/.claude/hooks/tsconfig.json +12 -0
  355. data/.claude/settings.json +33 -0
  356. data/.claude/skills/README.md +29 -0
  357. data/.claude/skills/ruby-gem-development/SKILL.md +293 -0
  358. data/.claude/skills/skill-rules.json +117 -0
  359. data/.claude/skills/thor-cli-development/SKILL.md +431 -0
  360. data/CHANGELOG.md +7 -0
  361. data/Gemfile.lock +3 -1
  362. data/completions/{_aictl → _langop} +37 -37
  363. data/completions/{aictl.bash → langop.bash} +16 -16
  364. data/completions/langop.fish +114 -0
  365. data/components/agent/Gemfile +1 -1
  366. data/components/tool/Gemfile +1 -1
  367. data/docs/README.md +10 -10
  368. data/docs/agent-internals.md +1 -1
  369. data/docs/cheat-sheet.md +76 -76
  370. data/docs/cli-reference.md +71 -71
  371. data/docs/how-agents-work.md +1 -1
  372. data/docs/installation.md +30 -30
  373. data/docs/quickstart.md +30 -30
  374. data/docs/using-tools.md +11 -11
  375. data/docs/webhooks.md +6 -6
  376. data/examples/ux_helpers_demo.rb +4 -4
  377. data/lib/language_operator/agent/task_executor.rb +0 -37
  378. data/lib/language_operator/agent/web_server.rb +311 -323
  379. data/lib/language_operator/cli/commands/agent/base.rb +16 -15
  380. data/lib/language_operator/cli/commands/agent/code_operations.rb +6 -6
  381. data/lib/language_operator/cli/commands/agent/helpers/synthesis_watcher.rb +1 -1
  382. data/lib/language_operator/cli/commands/agent/lifecycle.rb +2 -2
  383. data/lib/language_operator/cli/commands/agent/logs.rb +2 -2
  384. data/lib/language_operator/cli/commands/agent/workspace.rb +8 -8
  385. data/lib/language_operator/cli/commands/cluster.rb +172 -158
  386. data/lib/language_operator/cli/commands/install.rb +878 -81
  387. data/lib/language_operator/cli/commands/model/base.rb +7 -6
  388. data/lib/language_operator/cli/commands/organization.rb +61 -0
  389. data/lib/language_operator/cli/commands/persona.rb +10 -8
  390. data/lib/language_operator/cli/commands/status.rb +83 -13
  391. data/lib/language_operator/cli/commands/system/exec.rb +10 -10
  392. data/lib/language_operator/cli/commands/system/schema.rb +6 -6
  393. data/lib/language_operator/cli/commands/system/synthesis_template.rb +6 -6
  394. data/lib/language_operator/cli/commands/system/synthesize.rb +14 -14
  395. data/lib/language_operator/cli/commands/system/validate_template.rb +4 -4
  396. data/lib/language_operator/cli/commands/tool/base.rb +1 -1
  397. data/lib/language_operator/cli/commands/tool/install.rb +2 -2
  398. data/lib/language_operator/cli/commands/tool/search.rb +3 -3
  399. data/lib/language_operator/cli/commands/ui.rb +173 -0
  400. data/lib/language_operator/cli/commands/use.rb +80 -9
  401. data/lib/language_operator/cli/errors/suggestions.rb +21 -21
  402. data/lib/language_operator/cli/formatters/progress_formatter.rb +2 -1
  403. data/lib/language_operator/cli/formatters/table_formatter.rb +21 -1
  404. data/lib/language_operator/cli/helpers/cluster_validator.rb +2 -2
  405. data/lib/language_operator/cli/helpers/health_checker.rb +263 -0
  406. data/lib/language_operator/cli/helpers/kubeconfig_validator.rb +3 -3
  407. data/lib/language_operator/cli/helpers/ux_helper.rb +4 -3
  408. data/lib/language_operator/cli/main.rb +30 -21
  409. data/lib/language_operator/cli/wizards/model_wizard.rb +7 -5
  410. data/lib/language_operator/config/cluster_config.rb +3 -3
  411. data/lib/language_operator/constants/kubernetes_labels.rb +1 -1
  412. data/lib/language_operator/kubernetes/client.rb +53 -109
  413. data/lib/language_operator/kubernetes/resource_builder.rb +46 -14
  414. data/lib/language_operator/templates/schema/agent_dsl_openapi.yaml +1 -1
  415. data/lib/language_operator/templates/schema/agent_dsl_schema.json +1 -1
  416. data/lib/language_operator/utils/org_context.rb +100 -0
  417. data/lib/language_operator/version.rb +1 -1
  418. data/synth/001/Makefile +1 -1
  419. data/synth/002/Makefile +1 -1
  420. data/synth/003/Makefile +1 -1
  421. data/synth/004/Makefile +1 -1
  422. metadata +384 -11
  423. data/completions/aictl.fish +0 -114
  424. data/lib/language_operator/agent/event_config.rb +0 -172
  425. data/lib/language_operator/cli/commands/quickstart.rb +0 -22
  426. data/lib/language_operator/cli/wizards/quickstart_wizard.rb +0 -561
  427. /data/bin/{aictl → langop} +0 -0
@@ -0,0 +1,1810 @@
1
+ /**
2
+ * `Buffer` objects are used to represent a fixed-length sequence of bytes. Many
3
+ * Node.js APIs support `Buffer`s.
4
+ *
5
+ * The `Buffer` class is a subclass of JavaScript's [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) class and
6
+ * extends it with methods that cover additional use cases. Node.js APIs accept
7
+ * plain [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) s wherever `Buffer`s are supported as well.
8
+ *
9
+ * While the `Buffer` class is available within the global scope, it is still
10
+ * recommended to explicitly reference it via an import or require statement.
11
+ *
12
+ * ```js
13
+ * import { Buffer } from 'node:buffer';
14
+ *
15
+ * // Creates a zero-filled Buffer of length 10.
16
+ * const buf1 = Buffer.alloc(10);
17
+ *
18
+ * // Creates a Buffer of length 10,
19
+ * // filled with bytes which all have the value `1`.
20
+ * const buf2 = Buffer.alloc(10, 1);
21
+ *
22
+ * // Creates an uninitialized buffer of length 10.
23
+ * // This is faster than calling Buffer.alloc() but the returned
24
+ * // Buffer instance might contain old data that needs to be
25
+ * // overwritten using fill(), write(), or other functions that fill the Buffer's
26
+ * // contents.
27
+ * const buf3 = Buffer.allocUnsafe(10);
28
+ *
29
+ * // Creates a Buffer containing the bytes [1, 2, 3].
30
+ * const buf4 = Buffer.from([1, 2, 3]);
31
+ *
32
+ * // Creates a Buffer containing the bytes [1, 1, 1, 1] – the entries
33
+ * // are all truncated using `(value & 255)` to fit into the range 0–255.
34
+ * const buf5 = Buffer.from([257, 257.5, -255, '1']);
35
+ *
36
+ * // Creates a Buffer containing the UTF-8-encoded bytes for the string 'tést':
37
+ * // [0x74, 0xc3, 0xa9, 0x73, 0x74] (in hexadecimal notation)
38
+ * // [116, 195, 169, 115, 116] (in decimal notation)
39
+ * const buf6 = Buffer.from('tést');
40
+ *
41
+ * // Creates a Buffer containing the Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
42
+ * const buf7 = Buffer.from('tést', 'latin1');
43
+ * ```
44
+ * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/buffer.js)
45
+ */
46
+ declare module "node:buffer" {
47
+ import { ReadableStream } from "node:stream/web";
48
+ /**
49
+ * This function returns `true` if `input` contains only valid UTF-8-encoded data,
50
+ * including the case in which `input` is empty.
51
+ *
52
+ * Throws if the `input` is a detached array buffer.
53
+ * @since v19.4.0, v18.14.0
54
+ * @param input The input to validate.
55
+ */
56
+ export function isUtf8(input: ArrayBuffer | NodeJS.TypedArray): boolean;
57
+ /**
58
+ * This function returns `true` if `input` contains only valid ASCII-encoded data,
59
+ * including the case in which `input` is empty.
60
+ *
61
+ * Throws if the `input` is a detached array buffer.
62
+ * @since v19.6.0, v18.15.0
63
+ * @param input The input to validate.
64
+ */
65
+ export function isAscii(input: ArrayBuffer | NodeJS.TypedArray): boolean;
66
+ export let INSPECT_MAX_BYTES: number;
67
+ export const kMaxLength: number;
68
+ export const kStringMaxLength: number;
69
+ export const constants: {
70
+ MAX_LENGTH: number;
71
+ MAX_STRING_LENGTH: number;
72
+ };
73
+ export type TranscodeEncoding =
74
+ | "ascii"
75
+ | "utf8"
76
+ | "utf-8"
77
+ | "utf16le"
78
+ | "utf-16le"
79
+ | "ucs2"
80
+ | "ucs-2"
81
+ | "latin1"
82
+ | "binary";
83
+ /**
84
+ * Re-encodes the given `Buffer` or `Uint8Array` instance from one character
85
+ * encoding to another. Returns a new `Buffer` instance.
86
+ *
87
+ * Throws if the `fromEnc` or `toEnc` specify invalid character encodings or if
88
+ * conversion from `fromEnc` to `toEnc` is not permitted.
89
+ *
90
+ * Encodings supported by `buffer.transcode()` are: `'ascii'`, `'utf8'`, `'utf16le'`, `'ucs2'`, `'latin1'`, and `'binary'`.
91
+ *
92
+ * The transcoding process will use substitution characters if a given byte
93
+ * sequence cannot be adequately represented in the target encoding. For instance:
94
+ *
95
+ * ```js
96
+ * import { Buffer, transcode } from 'node:buffer';
97
+ *
98
+ * const newBuf = transcode(Buffer.from('€'), 'utf8', 'ascii');
99
+ * console.log(newBuf.toString('ascii'));
100
+ * // Prints: '?'
101
+ * ```
102
+ *
103
+ * Because the Euro (`€`) sign is not representable in US-ASCII, it is replaced
104
+ * with `?` in the transcoded `Buffer`.
105
+ * @since v7.1.0
106
+ * @param source A `Buffer` or `Uint8Array` instance.
107
+ * @param fromEnc The current encoding.
108
+ * @param toEnc To target encoding.
109
+ */
110
+ export function transcode(
111
+ source: Uint8Array,
112
+ fromEnc: TranscodeEncoding,
113
+ toEnc: TranscodeEncoding,
114
+ ): NonSharedBuffer;
115
+ /**
116
+ * Resolves a `'blob:nodedata:...'` an associated `Blob` object registered using
117
+ * a prior call to `URL.createObjectURL()`.
118
+ * @since v16.7.0
119
+ * @param id A `'blob:nodedata:...` URL string returned by a prior call to `URL.createObjectURL()`.
120
+ */
121
+ export function resolveObjectURL(id: string): Blob | undefined;
122
+ export { type AllowSharedBuffer, Buffer, type NonSharedBuffer };
123
+ /** @deprecated This alias will be removed in a future version. Use the canonical `BlobPropertyBag` instead. */
124
+ // TODO: remove in future major
125
+ export interface BlobOptions extends BlobPropertyBag {}
126
+ /** @deprecated This alias will be removed in a future version. Use the canonical `FilePropertyBag` instead. */
127
+ export interface FileOptions extends FilePropertyBag {}
128
+ export type WithImplicitCoercion<T> =
129
+ | T
130
+ | { valueOf(): T }
131
+ | (T extends string ? { [Symbol.toPrimitive](hint: "string"): T } : never);
132
+ global {
133
+ namespace NodeJS {
134
+ export { BufferEncoding };
135
+ }
136
+ // Buffer class
137
+ type BufferEncoding =
138
+ | "ascii"
139
+ | "utf8"
140
+ | "utf-8"
141
+ | "utf16le"
142
+ | "utf-16le"
143
+ | "ucs2"
144
+ | "ucs-2"
145
+ | "base64"
146
+ | "base64url"
147
+ | "latin1"
148
+ | "binary"
149
+ | "hex";
150
+ /**
151
+ * Raw data is stored in instances of the Buffer class.
152
+ * A Buffer is similar to an array of integers but corresponds to a raw memory allocation outside the V8 heap. A Buffer cannot be resized.
153
+ * Valid string encodings: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'base64url'|'binary'(deprecated)|'hex'
154
+ */
155
+ interface BufferConstructor {
156
+ // see buffer.buffer.d.ts for implementation specific to TypeScript 5.7 and later
157
+ // see ts5.6/buffer.buffer.d.ts for implementation specific to TypeScript 5.6 and earlier
158
+
159
+ /**
160
+ * Returns `true` if `obj` is a `Buffer`, `false` otherwise.
161
+ *
162
+ * ```js
163
+ * import { Buffer } from 'node:buffer';
164
+ *
165
+ * Buffer.isBuffer(Buffer.alloc(10)); // true
166
+ * Buffer.isBuffer(Buffer.from('foo')); // true
167
+ * Buffer.isBuffer('a string'); // false
168
+ * Buffer.isBuffer([]); // false
169
+ * Buffer.isBuffer(new Uint8Array(1024)); // false
170
+ * ```
171
+ * @since v0.1.101
172
+ */
173
+ isBuffer(obj: any): obj is Buffer;
174
+ /**
175
+ * Returns `true` if `encoding` is the name of a supported character encoding,
176
+ * or `false` otherwise.
177
+ *
178
+ * ```js
179
+ * import { Buffer } from 'node:buffer';
180
+ *
181
+ * console.log(Buffer.isEncoding('utf8'));
182
+ * // Prints: true
183
+ *
184
+ * console.log(Buffer.isEncoding('hex'));
185
+ * // Prints: true
186
+ *
187
+ * console.log(Buffer.isEncoding('utf/8'));
188
+ * // Prints: false
189
+ *
190
+ * console.log(Buffer.isEncoding(''));
191
+ * // Prints: false
192
+ * ```
193
+ * @since v0.9.1
194
+ * @param encoding A character encoding name to check.
195
+ */
196
+ isEncoding(encoding: string): encoding is BufferEncoding;
197
+ /**
198
+ * Returns the byte length of a string when encoded using `encoding`.
199
+ * This is not the same as [`String.prototype.length`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length), which does not account
200
+ * for the encoding that is used to convert the string into bytes.
201
+ *
202
+ * For `'base64'`, `'base64url'`, and `'hex'`, this function assumes valid input.
203
+ * For strings that contain non-base64/hex-encoded data (e.g. whitespace), the
204
+ * return value might be greater than the length of a `Buffer` created from the
205
+ * string.
206
+ *
207
+ * ```js
208
+ * import { Buffer } from 'node:buffer';
209
+ *
210
+ * const str = '\u00bd + \u00bc = \u00be';
211
+ *
212
+ * console.log(`${str}: ${str.length} characters, ` +
213
+ * `${Buffer.byteLength(str, 'utf8')} bytes`);
214
+ * // Prints: ½ + ¼ = ¾: 9 characters, 12 bytes
215
+ * ```
216
+ *
217
+ * When `string` is a
218
+ * `Buffer`/[`DataView`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView)/[`TypedArray`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/-
219
+ * Reference/Global_Objects/TypedArray)/[`ArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer)/[`SharedArrayBuffer`](https://develop-
220
+ * er.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer), the byte length as reported by `.byteLength`is returned.
221
+ * @since v0.1.90
222
+ * @param string A value to calculate the length of.
223
+ * @param [encoding='utf8'] If `string` is a string, this is its encoding.
224
+ * @return The number of bytes contained within `string`.
225
+ */
226
+ byteLength(
227
+ string: string | NodeJS.ArrayBufferView | ArrayBufferLike,
228
+ encoding?: BufferEncoding,
229
+ ): number;
230
+ /**
231
+ * Compares `buf1` to `buf2`, typically for the purpose of sorting arrays of `Buffer` instances. This is equivalent to calling `buf1.compare(buf2)`.
232
+ *
233
+ * ```js
234
+ * import { Buffer } from 'node:buffer';
235
+ *
236
+ * const buf1 = Buffer.from('1234');
237
+ * const buf2 = Buffer.from('0123');
238
+ * const arr = [buf1, buf2];
239
+ *
240
+ * console.log(arr.sort(Buffer.compare));
241
+ * // Prints: [ <Buffer 30 31 32 33>, <Buffer 31 32 33 34> ]
242
+ * // (This result is equal to: [buf2, buf1].)
243
+ * ```
244
+ * @since v0.11.13
245
+ * @return Either `-1`, `0`, or `1`, depending on the result of the comparison. See `compare` for details.
246
+ */
247
+ compare(buf1: Uint8Array, buf2: Uint8Array): -1 | 0 | 1;
248
+ /**
249
+ * This is the size (in bytes) of pre-allocated internal `Buffer` instances used
250
+ * for pooling. This value may be modified.
251
+ * @since v0.11.3
252
+ */
253
+ poolSize: number;
254
+ }
255
+ interface Buffer {
256
+ // see buffer.buffer.d.ts for implementation specific to TypeScript 5.7 and later
257
+ // see ts5.6/buffer.buffer.d.ts for implementation specific to TypeScript 5.6 and earlier
258
+
259
+ /**
260
+ * Writes `string` to `buf` at `offset` according to the character encoding in`encoding`. The `length` parameter is the number of bytes to write. If `buf` did
261
+ * not contain enough space to fit the entire string, only part of `string` will be
262
+ * written. However, partially encoded characters will not be written.
263
+ *
264
+ * ```js
265
+ * import { Buffer } from 'node:buffer';
266
+ *
267
+ * const buf = Buffer.alloc(256);
268
+ *
269
+ * const len = buf.write('\u00bd + \u00bc = \u00be', 0);
270
+ *
271
+ * console.log(`${len} bytes: ${buf.toString('utf8', 0, len)}`);
272
+ * // Prints: 12 bytes: ½ + ¼ = ¾
273
+ *
274
+ * const buffer = Buffer.alloc(10);
275
+ *
276
+ * const length = buffer.write('abcd', 8);
277
+ *
278
+ * console.log(`${length} bytes: ${buffer.toString('utf8', 8, 10)}`);
279
+ * // Prints: 2 bytes : ab
280
+ * ```
281
+ * @since v0.1.90
282
+ * @param string String to write to `buf`.
283
+ * @param [offset=0] Number of bytes to skip before starting to write `string`.
284
+ * @param [length=buf.length - offset] Maximum number of bytes to write (written bytes will not exceed `buf.length - offset`).
285
+ * @param [encoding='utf8'] The character encoding of `string`.
286
+ * @return Number of bytes written.
287
+ */
288
+ write(string: string, encoding?: BufferEncoding): number;
289
+ write(string: string, offset: number, encoding?: BufferEncoding): number;
290
+ write(string: string, offset: number, length: number, encoding?: BufferEncoding): number;
291
+ /**
292
+ * Decodes `buf` to a string according to the specified character encoding in`encoding`. `start` and `end` may be passed to decode only a subset of `buf`.
293
+ *
294
+ * If `encoding` is `'utf8'` and a byte sequence in the input is not valid UTF-8,
295
+ * then each invalid byte is replaced with the replacement character `U+FFFD`.
296
+ *
297
+ * The maximum length of a string instance (in UTF-16 code units) is available
298
+ * as {@link constants.MAX_STRING_LENGTH}.
299
+ *
300
+ * ```js
301
+ * import { Buffer } from 'node:buffer';
302
+ *
303
+ * const buf1 = Buffer.allocUnsafe(26);
304
+ *
305
+ * for (let i = 0; i < 26; i++) {
306
+ * // 97 is the decimal ASCII value for 'a'.
307
+ * buf1[i] = i + 97;
308
+ * }
309
+ *
310
+ * console.log(buf1.toString('utf8'));
311
+ * // Prints: abcdefghijklmnopqrstuvwxyz
312
+ * console.log(buf1.toString('utf8', 0, 5));
313
+ * // Prints: abcde
314
+ *
315
+ * const buf2 = Buffer.from('tést');
316
+ *
317
+ * console.log(buf2.toString('hex'));
318
+ * // Prints: 74c3a97374
319
+ * console.log(buf2.toString('utf8', 0, 3));
320
+ * // Prints: té
321
+ * console.log(buf2.toString(undefined, 0, 3));
322
+ * // Prints: té
323
+ * ```
324
+ * @since v0.1.90
325
+ * @param [encoding='utf8'] The character encoding to use.
326
+ * @param [start=0] The byte offset to start decoding at.
327
+ * @param [end=buf.length] The byte offset to stop decoding at (not inclusive).
328
+ */
329
+ toString(encoding?: BufferEncoding, start?: number, end?: number): string;
330
+ /**
331
+ * Returns a JSON representation of `buf`. [`JSON.stringify()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) implicitly calls
332
+ * this function when stringifying a `Buffer` instance.
333
+ *
334
+ * `Buffer.from()` accepts objects in the format returned from this method.
335
+ * In particular, `Buffer.from(buf.toJSON())` works like `Buffer.from(buf)`.
336
+ *
337
+ * ```js
338
+ * import { Buffer } from 'node:buffer';
339
+ *
340
+ * const buf = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5]);
341
+ * const json = JSON.stringify(buf);
342
+ *
343
+ * console.log(json);
344
+ * // Prints: {"type":"Buffer","data":[1,2,3,4,5]}
345
+ *
346
+ * const copy = JSON.parse(json, (key, value) => {
347
+ * return value &#x26;&#x26; value.type === 'Buffer' ?
348
+ * Buffer.from(value) :
349
+ * value;
350
+ * });
351
+ *
352
+ * console.log(copy);
353
+ * // Prints: <Buffer 01 02 03 04 05>
354
+ * ```
355
+ * @since v0.9.2
356
+ */
357
+ toJSON(): {
358
+ type: "Buffer";
359
+ data: number[];
360
+ };
361
+ /**
362
+ * Returns `true` if both `buf` and `otherBuffer` have exactly the same bytes,`false` otherwise. Equivalent to `buf.compare(otherBuffer) === 0`.
363
+ *
364
+ * ```js
365
+ * import { Buffer } from 'node:buffer';
366
+ *
367
+ * const buf1 = Buffer.from('ABC');
368
+ * const buf2 = Buffer.from('414243', 'hex');
369
+ * const buf3 = Buffer.from('ABCD');
370
+ *
371
+ * console.log(buf1.equals(buf2));
372
+ * // Prints: true
373
+ * console.log(buf1.equals(buf3));
374
+ * // Prints: false
375
+ * ```
376
+ * @since v0.11.13
377
+ * @param otherBuffer A `Buffer` or {@link Uint8Array} with which to compare `buf`.
378
+ */
379
+ equals(otherBuffer: Uint8Array): boolean;
380
+ /**
381
+ * Compares `buf` with `target` and returns a number indicating whether `buf`comes before, after, or is the same as `target` in sort order.
382
+ * Comparison is based on the actual sequence of bytes in each `Buffer`.
383
+ *
384
+ * * `0` is returned if `target` is the same as `buf`
385
+ * * `1` is returned if `target` should come _before_`buf` when sorted.
386
+ * * `-1` is returned if `target` should come _after_`buf` when sorted.
387
+ *
388
+ * ```js
389
+ * import { Buffer } from 'node:buffer';
390
+ *
391
+ * const buf1 = Buffer.from('ABC');
392
+ * const buf2 = Buffer.from('BCD');
393
+ * const buf3 = Buffer.from('ABCD');
394
+ *
395
+ * console.log(buf1.compare(buf1));
396
+ * // Prints: 0
397
+ * console.log(buf1.compare(buf2));
398
+ * // Prints: -1
399
+ * console.log(buf1.compare(buf3));
400
+ * // Prints: -1
401
+ * console.log(buf2.compare(buf1));
402
+ * // Prints: 1
403
+ * console.log(buf2.compare(buf3));
404
+ * // Prints: 1
405
+ * console.log([buf1, buf2, buf3].sort(Buffer.compare));
406
+ * // Prints: [ <Buffer 41 42 43>, <Buffer 41 42 43 44>, <Buffer 42 43 44> ]
407
+ * // (This result is equal to: [buf1, buf3, buf2].)
408
+ * ```
409
+ *
410
+ * The optional `targetStart`, `targetEnd`, `sourceStart`, and `sourceEnd` arguments can be used to limit the comparison to specific ranges within `target` and `buf` respectively.
411
+ *
412
+ * ```js
413
+ * import { Buffer } from 'node:buffer';
414
+ *
415
+ * const buf1 = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8, 9]);
416
+ * const buf2 = Buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]);
417
+ *
418
+ * console.log(buf1.compare(buf2, 5, 9, 0, 4));
419
+ * // Prints: 0
420
+ * console.log(buf1.compare(buf2, 0, 6, 4));
421
+ * // Prints: -1
422
+ * console.log(buf1.compare(buf2, 5, 6, 5));
423
+ * // Prints: 1
424
+ * ```
425
+ *
426
+ * `ERR_OUT_OF_RANGE` is thrown if `targetStart < 0`, `sourceStart < 0`, `targetEnd > target.byteLength`, or `sourceEnd > source.byteLength`.
427
+ * @since v0.11.13
428
+ * @param target A `Buffer` or {@link Uint8Array} with which to compare `buf`.
429
+ * @param [targetStart=0] The offset within `target` at which to begin comparison.
430
+ * @param [targetEnd=target.length] The offset within `target` at which to end comparison (not inclusive).
431
+ * @param [sourceStart=0] The offset within `buf` at which to begin comparison.
432
+ * @param [sourceEnd=buf.length] The offset within `buf` at which to end comparison (not inclusive).
433
+ */
434
+ compare(
435
+ target: Uint8Array,
436
+ targetStart?: number,
437
+ targetEnd?: number,
438
+ sourceStart?: number,
439
+ sourceEnd?: number,
440
+ ): -1 | 0 | 1;
441
+ /**
442
+ * Copies data from a region of `buf` to a region in `target`, even if the `target`memory region overlaps with `buf`.
443
+ *
444
+ * [`TypedArray.prototype.set()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set) performs the same operation, and is available
445
+ * for all TypedArrays, including Node.js `Buffer`s, although it takes
446
+ * different function arguments.
447
+ *
448
+ * ```js
449
+ * import { Buffer } from 'node:buffer';
450
+ *
451
+ * // Create two `Buffer` instances.
452
+ * const buf1 = Buffer.allocUnsafe(26);
453
+ * const buf2 = Buffer.allocUnsafe(26).fill('!');
454
+ *
455
+ * for (let i = 0; i < 26; i++) {
456
+ * // 97 is the decimal ASCII value for 'a'.
457
+ * buf1[i] = i + 97;
458
+ * }
459
+ *
460
+ * // Copy `buf1` bytes 16 through 19 into `buf2` starting at byte 8 of `buf2`.
461
+ * buf1.copy(buf2, 8, 16, 20);
462
+ * // This is equivalent to:
463
+ * // buf2.set(buf1.subarray(16, 20), 8);
464
+ *
465
+ * console.log(buf2.toString('ascii', 0, 25));
466
+ * // Prints: !!!!!!!!qrst!!!!!!!!!!!!!
467
+ * ```
468
+ *
469
+ * ```js
470
+ * import { Buffer } from 'node:buffer';
471
+ *
472
+ * // Create a `Buffer` and copy data from one region to an overlapping region
473
+ * // within the same `Buffer`.
474
+ *
475
+ * const buf = Buffer.allocUnsafe(26);
476
+ *
477
+ * for (let i = 0; i < 26; i++) {
478
+ * // 97 is the decimal ASCII value for 'a'.
479
+ * buf[i] = i + 97;
480
+ * }
481
+ *
482
+ * buf.copy(buf, 0, 4, 10);
483
+ *
484
+ * console.log(buf.toString());
485
+ * // Prints: efghijghijklmnopqrstuvwxyz
486
+ * ```
487
+ * @since v0.1.90
488
+ * @param target A `Buffer` or {@link Uint8Array} to copy into.
489
+ * @param [targetStart=0] The offset within `target` at which to begin writing.
490
+ * @param [sourceStart=0] The offset within `buf` from which to begin copying.
491
+ * @param [sourceEnd=buf.length] The offset within `buf` at which to stop copying (not inclusive).
492
+ * @return The number of bytes copied.
493
+ */
494
+ copy(target: Uint8Array, targetStart?: number, sourceStart?: number, sourceEnd?: number): number;
495
+ /**
496
+ * Writes `value` to `buf` at the specified `offset` as big-endian.
497
+ *
498
+ * `value` is interpreted and written as a two's complement signed integer.
499
+ *
500
+ * ```js
501
+ * import { Buffer } from 'node:buffer';
502
+ *
503
+ * const buf = Buffer.allocUnsafe(8);
504
+ *
505
+ * buf.writeBigInt64BE(0x0102030405060708n, 0);
506
+ *
507
+ * console.log(buf);
508
+ * // Prints: <Buffer 01 02 03 04 05 06 07 08>
509
+ * ```
510
+ * @since v12.0.0, v10.20.0
511
+ * @param value Number to be written to `buf`.
512
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
513
+ * @return `offset` plus the number of bytes written.
514
+ */
515
+ writeBigInt64BE(value: bigint, offset?: number): number;
516
+ /**
517
+ * Writes `value` to `buf` at the specified `offset` as little-endian.
518
+ *
519
+ * `value` is interpreted and written as a two's complement signed integer.
520
+ *
521
+ * ```js
522
+ * import { Buffer } from 'node:buffer';
523
+ *
524
+ * const buf = Buffer.allocUnsafe(8);
525
+ *
526
+ * buf.writeBigInt64LE(0x0102030405060708n, 0);
527
+ *
528
+ * console.log(buf);
529
+ * // Prints: <Buffer 08 07 06 05 04 03 02 01>
530
+ * ```
531
+ * @since v12.0.0, v10.20.0
532
+ * @param value Number to be written to `buf`.
533
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
534
+ * @return `offset` plus the number of bytes written.
535
+ */
536
+ writeBigInt64LE(value: bigint, offset?: number): number;
537
+ /**
538
+ * Writes `value` to `buf` at the specified `offset` as big-endian.
539
+ *
540
+ * This function is also available under the `writeBigUint64BE` alias.
541
+ *
542
+ * ```js
543
+ * import { Buffer } from 'node:buffer';
544
+ *
545
+ * const buf = Buffer.allocUnsafe(8);
546
+ *
547
+ * buf.writeBigUInt64BE(0xdecafafecacefaden, 0);
548
+ *
549
+ * console.log(buf);
550
+ * // Prints: <Buffer de ca fa fe ca ce fa de>
551
+ * ```
552
+ * @since v12.0.0, v10.20.0
553
+ * @param value Number to be written to `buf`.
554
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
555
+ * @return `offset` plus the number of bytes written.
556
+ */
557
+ writeBigUInt64BE(value: bigint, offset?: number): number;
558
+ /**
559
+ * @alias Buffer.writeBigUInt64BE
560
+ * @since v14.10.0, v12.19.0
561
+ */
562
+ writeBigUint64BE(value: bigint, offset?: number): number;
563
+ /**
564
+ * Writes `value` to `buf` at the specified `offset` as little-endian
565
+ *
566
+ * ```js
567
+ * import { Buffer } from 'node:buffer';
568
+ *
569
+ * const buf = Buffer.allocUnsafe(8);
570
+ *
571
+ * buf.writeBigUInt64LE(0xdecafafecacefaden, 0);
572
+ *
573
+ * console.log(buf);
574
+ * // Prints: <Buffer de fa ce ca fe fa ca de>
575
+ * ```
576
+ *
577
+ * This function is also available under the `writeBigUint64LE` alias.
578
+ * @since v12.0.0, v10.20.0
579
+ * @param value Number to be written to `buf`.
580
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
581
+ * @return `offset` plus the number of bytes written.
582
+ */
583
+ writeBigUInt64LE(value: bigint, offset?: number): number;
584
+ /**
585
+ * @alias Buffer.writeBigUInt64LE
586
+ * @since v14.10.0, v12.19.0
587
+ */
588
+ writeBigUint64LE(value: bigint, offset?: number): number;
589
+ /**
590
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as little-endian. Supports up to 48 bits of accuracy. Behavior is undefined
591
+ * when `value` is anything other than an unsigned integer.
592
+ *
593
+ * This function is also available under the `writeUintLE` alias.
594
+ *
595
+ * ```js
596
+ * import { Buffer } from 'node:buffer';
597
+ *
598
+ * const buf = Buffer.allocUnsafe(6);
599
+ *
600
+ * buf.writeUIntLE(0x1234567890ab, 0, 6);
601
+ *
602
+ * console.log(buf);
603
+ * // Prints: <Buffer ab 90 78 56 34 12>
604
+ * ```
605
+ * @since v0.5.5
606
+ * @param value Number to be written to `buf`.
607
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
608
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
609
+ * @return `offset` plus the number of bytes written.
610
+ */
611
+ writeUIntLE(value: number, offset: number, byteLength: number): number;
612
+ /**
613
+ * @alias Buffer.writeUIntLE
614
+ * @since v14.9.0, v12.19.0
615
+ */
616
+ writeUintLE(value: number, offset: number, byteLength: number): number;
617
+ /**
618
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as big-endian. Supports up to 48 bits of accuracy. Behavior is undefined
619
+ * when `value` is anything other than an unsigned integer.
620
+ *
621
+ * This function is also available under the `writeUintBE` alias.
622
+ *
623
+ * ```js
624
+ * import { Buffer } from 'node:buffer';
625
+ *
626
+ * const buf = Buffer.allocUnsafe(6);
627
+ *
628
+ * buf.writeUIntBE(0x1234567890ab, 0, 6);
629
+ *
630
+ * console.log(buf);
631
+ * // Prints: <Buffer 12 34 56 78 90 ab>
632
+ * ```
633
+ * @since v0.5.5
634
+ * @param value Number to be written to `buf`.
635
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
636
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
637
+ * @return `offset` plus the number of bytes written.
638
+ */
639
+ writeUIntBE(value: number, offset: number, byteLength: number): number;
640
+ /**
641
+ * @alias Buffer.writeUIntBE
642
+ * @since v14.9.0, v12.19.0
643
+ */
644
+ writeUintBE(value: number, offset: number, byteLength: number): number;
645
+ /**
646
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as little-endian. Supports up to 48 bits of accuracy. Behavior is undefined
647
+ * when `value` is anything other than a signed integer.
648
+ *
649
+ * ```js
650
+ * import { Buffer } from 'node:buffer';
651
+ *
652
+ * const buf = Buffer.allocUnsafe(6);
653
+ *
654
+ * buf.writeIntLE(0x1234567890ab, 0, 6);
655
+ *
656
+ * console.log(buf);
657
+ * // Prints: <Buffer ab 90 78 56 34 12>
658
+ * ```
659
+ * @since v0.11.15
660
+ * @param value Number to be written to `buf`.
661
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
662
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
663
+ * @return `offset` plus the number of bytes written.
664
+ */
665
+ writeIntLE(value: number, offset: number, byteLength: number): number;
666
+ /**
667
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as big-endian. Supports up to 48 bits of accuracy. Behavior is undefined when`value` is anything other than a
668
+ * signed integer.
669
+ *
670
+ * ```js
671
+ * import { Buffer } from 'node:buffer';
672
+ *
673
+ * const buf = Buffer.allocUnsafe(6);
674
+ *
675
+ * buf.writeIntBE(0x1234567890ab, 0, 6);
676
+ *
677
+ * console.log(buf);
678
+ * // Prints: <Buffer 12 34 56 78 90 ab>
679
+ * ```
680
+ * @since v0.11.15
681
+ * @param value Number to be written to `buf`.
682
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
683
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
684
+ * @return `offset` plus the number of bytes written.
685
+ */
686
+ writeIntBE(value: number, offset: number, byteLength: number): number;
687
+ /**
688
+ * Reads an unsigned, big-endian 64-bit integer from `buf` at the specified`offset`.
689
+ *
690
+ * This function is also available under the `readBigUint64BE` alias.
691
+ *
692
+ * ```js
693
+ * import { Buffer } from 'node:buffer';
694
+ *
695
+ * const buf = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
696
+ *
697
+ * console.log(buf.readBigUInt64BE(0));
698
+ * // Prints: 4294967295n
699
+ * ```
700
+ * @since v12.0.0, v10.20.0
701
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
702
+ */
703
+ readBigUInt64BE(offset?: number): bigint;
704
+ /**
705
+ * @alias Buffer.readBigUInt64BE
706
+ * @since v14.10.0, v12.19.0
707
+ */
708
+ readBigUint64BE(offset?: number): bigint;
709
+ /**
710
+ * Reads an unsigned, little-endian 64-bit integer from `buf` at the specified`offset`.
711
+ *
712
+ * This function is also available under the `readBigUint64LE` alias.
713
+ *
714
+ * ```js
715
+ * import { Buffer } from 'node:buffer';
716
+ *
717
+ * const buf = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
718
+ *
719
+ * console.log(buf.readBigUInt64LE(0));
720
+ * // Prints: 18446744069414584320n
721
+ * ```
722
+ * @since v12.0.0, v10.20.0
723
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
724
+ */
725
+ readBigUInt64LE(offset?: number): bigint;
726
+ /**
727
+ * @alias Buffer.readBigUInt64LE
728
+ * @since v14.10.0, v12.19.0
729
+ */
730
+ readBigUint64LE(offset?: number): bigint;
731
+ /**
732
+ * Reads a signed, big-endian 64-bit integer from `buf` at the specified `offset`.
733
+ *
734
+ * Integers read from a `Buffer` are interpreted as two's complement signed
735
+ * values.
736
+ * @since v12.0.0, v10.20.0
737
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
738
+ */
739
+ readBigInt64BE(offset?: number): bigint;
740
+ /**
741
+ * Reads a signed, little-endian 64-bit integer from `buf` at the specified`offset`.
742
+ *
743
+ * Integers read from a `Buffer` are interpreted as two's complement signed
744
+ * values.
745
+ * @since v12.0.0, v10.20.0
746
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
747
+ */
748
+ readBigInt64LE(offset?: number): bigint;
749
+ /**
750
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset` and interprets the result as an unsigned, little-endian integer supporting
751
+ * up to 48 bits of accuracy.
752
+ *
753
+ * This function is also available under the `readUintLE` alias.
754
+ *
755
+ * ```js
756
+ * import { Buffer } from 'node:buffer';
757
+ *
758
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
759
+ *
760
+ * console.log(buf.readUIntLE(0, 6).toString(16));
761
+ * // Prints: ab9078563412
762
+ * ```
763
+ * @since v0.11.15
764
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
765
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
766
+ */
767
+ readUIntLE(offset: number, byteLength: number): number;
768
+ /**
769
+ * @alias Buffer.readUIntLE
770
+ * @since v14.9.0, v12.19.0
771
+ */
772
+ readUintLE(offset: number, byteLength: number): number;
773
+ /**
774
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset` and interprets the result as an unsigned big-endian integer supporting
775
+ * up to 48 bits of accuracy.
776
+ *
777
+ * This function is also available under the `readUintBE` alias.
778
+ *
779
+ * ```js
780
+ * import { Buffer } from 'node:buffer';
781
+ *
782
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
783
+ *
784
+ * console.log(buf.readUIntBE(0, 6).toString(16));
785
+ * // Prints: 1234567890ab
786
+ * console.log(buf.readUIntBE(1, 6).toString(16));
787
+ * // Throws ERR_OUT_OF_RANGE.
788
+ * ```
789
+ * @since v0.11.15
790
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
791
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
792
+ */
793
+ readUIntBE(offset: number, byteLength: number): number;
794
+ /**
795
+ * @alias Buffer.readUIntBE
796
+ * @since v14.9.0, v12.19.0
797
+ */
798
+ readUintBE(offset: number, byteLength: number): number;
799
+ /**
800
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset` and interprets the result as a little-endian, two's complement signed value
801
+ * supporting up to 48 bits of accuracy.
802
+ *
803
+ * ```js
804
+ * import { Buffer } from 'node:buffer';
805
+ *
806
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
807
+ *
808
+ * console.log(buf.readIntLE(0, 6).toString(16));
809
+ * // Prints: -546f87a9cbee
810
+ * ```
811
+ * @since v0.11.15
812
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
813
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
814
+ */
815
+ readIntLE(offset: number, byteLength: number): number;
816
+ /**
817
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset` and interprets the result as a big-endian, two's complement signed value
818
+ * supporting up to 48 bits of accuracy.
819
+ *
820
+ * ```js
821
+ * import { Buffer } from 'node:buffer';
822
+ *
823
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
824
+ *
825
+ * console.log(buf.readIntBE(0, 6).toString(16));
826
+ * // Prints: 1234567890ab
827
+ * console.log(buf.readIntBE(1, 6).toString(16));
828
+ * // Throws ERR_OUT_OF_RANGE.
829
+ * console.log(buf.readIntBE(1, 0).toString(16));
830
+ * // Throws ERR_OUT_OF_RANGE.
831
+ * ```
832
+ * @since v0.11.15
833
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
834
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
835
+ */
836
+ readIntBE(offset: number, byteLength: number): number;
837
+ /**
838
+ * Reads an unsigned 8-bit integer from `buf` at the specified `offset`.
839
+ *
840
+ * This function is also available under the `readUint8` alias.
841
+ *
842
+ * ```js
843
+ * import { Buffer } from 'node:buffer';
844
+ *
845
+ * const buf = Buffer.from([1, -2]);
846
+ *
847
+ * console.log(buf.readUInt8(0));
848
+ * // Prints: 1
849
+ * console.log(buf.readUInt8(1));
850
+ * // Prints: 254
851
+ * console.log(buf.readUInt8(2));
852
+ * // Throws ERR_OUT_OF_RANGE.
853
+ * ```
854
+ * @since v0.5.0
855
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
856
+ */
857
+ readUInt8(offset?: number): number;
858
+ /**
859
+ * @alias Buffer.readUInt8
860
+ * @since v14.9.0, v12.19.0
861
+ */
862
+ readUint8(offset?: number): number;
863
+ /**
864
+ * Reads an unsigned, little-endian 16-bit integer from `buf` at the specified `offset`.
865
+ *
866
+ * This function is also available under the `readUint16LE` alias.
867
+ *
868
+ * ```js
869
+ * import { Buffer } from 'node:buffer';
870
+ *
871
+ * const buf = Buffer.from([0x12, 0x34, 0x56]);
872
+ *
873
+ * console.log(buf.readUInt16LE(0).toString(16));
874
+ * // Prints: 3412
875
+ * console.log(buf.readUInt16LE(1).toString(16));
876
+ * // Prints: 5634
877
+ * console.log(buf.readUInt16LE(2).toString(16));
878
+ * // Throws ERR_OUT_OF_RANGE.
879
+ * ```
880
+ * @since v0.5.5
881
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
882
+ */
883
+ readUInt16LE(offset?: number): number;
884
+ /**
885
+ * @alias Buffer.readUInt16LE
886
+ * @since v14.9.0, v12.19.0
887
+ */
888
+ readUint16LE(offset?: number): number;
889
+ /**
890
+ * Reads an unsigned, big-endian 16-bit integer from `buf` at the specified`offset`.
891
+ *
892
+ * This function is also available under the `readUint16BE` alias.
893
+ *
894
+ * ```js
895
+ * import { Buffer } from 'node:buffer';
896
+ *
897
+ * const buf = Buffer.from([0x12, 0x34, 0x56]);
898
+ *
899
+ * console.log(buf.readUInt16BE(0).toString(16));
900
+ * // Prints: 1234
901
+ * console.log(buf.readUInt16BE(1).toString(16));
902
+ * // Prints: 3456
903
+ * ```
904
+ * @since v0.5.5
905
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
906
+ */
907
+ readUInt16BE(offset?: number): number;
908
+ /**
909
+ * @alias Buffer.readUInt16BE
910
+ * @since v14.9.0, v12.19.0
911
+ */
912
+ readUint16BE(offset?: number): number;
913
+ /**
914
+ * Reads an unsigned, little-endian 32-bit integer from `buf` at the specified`offset`.
915
+ *
916
+ * This function is also available under the `readUint32LE` alias.
917
+ *
918
+ * ```js
919
+ * import { Buffer } from 'node:buffer';
920
+ *
921
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78]);
922
+ *
923
+ * console.log(buf.readUInt32LE(0).toString(16));
924
+ * // Prints: 78563412
925
+ * console.log(buf.readUInt32LE(1).toString(16));
926
+ * // Throws ERR_OUT_OF_RANGE.
927
+ * ```
928
+ * @since v0.5.5
929
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
930
+ */
931
+ readUInt32LE(offset?: number): number;
932
+ /**
933
+ * @alias Buffer.readUInt32LE
934
+ * @since v14.9.0, v12.19.0
935
+ */
936
+ readUint32LE(offset?: number): number;
937
+ /**
938
+ * Reads an unsigned, big-endian 32-bit integer from `buf` at the specified`offset`.
939
+ *
940
+ * This function is also available under the `readUint32BE` alias.
941
+ *
942
+ * ```js
943
+ * import { Buffer } from 'node:buffer';
944
+ *
945
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78]);
946
+ *
947
+ * console.log(buf.readUInt32BE(0).toString(16));
948
+ * // Prints: 12345678
949
+ * ```
950
+ * @since v0.5.5
951
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
952
+ */
953
+ readUInt32BE(offset?: number): number;
954
+ /**
955
+ * @alias Buffer.readUInt32BE
956
+ * @since v14.9.0, v12.19.0
957
+ */
958
+ readUint32BE(offset?: number): number;
959
+ /**
960
+ * Reads a signed 8-bit integer from `buf` at the specified `offset`.
961
+ *
962
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
963
+ *
964
+ * ```js
965
+ * import { Buffer } from 'node:buffer';
966
+ *
967
+ * const buf = Buffer.from([-1, 5]);
968
+ *
969
+ * console.log(buf.readInt8(0));
970
+ * // Prints: -1
971
+ * console.log(buf.readInt8(1));
972
+ * // Prints: 5
973
+ * console.log(buf.readInt8(2));
974
+ * // Throws ERR_OUT_OF_RANGE.
975
+ * ```
976
+ * @since v0.5.0
977
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
978
+ */
979
+ readInt8(offset?: number): number;
980
+ /**
981
+ * Reads a signed, little-endian 16-bit integer from `buf` at the specified`offset`.
982
+ *
983
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
984
+ *
985
+ * ```js
986
+ * import { Buffer } from 'node:buffer';
987
+ *
988
+ * const buf = Buffer.from([0, 5]);
989
+ *
990
+ * console.log(buf.readInt16LE(0));
991
+ * // Prints: 1280
992
+ * console.log(buf.readInt16LE(1));
993
+ * // Throws ERR_OUT_OF_RANGE.
994
+ * ```
995
+ * @since v0.5.5
996
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
997
+ */
998
+ readInt16LE(offset?: number): number;
999
+ /**
1000
+ * Reads a signed, big-endian 16-bit integer from `buf` at the specified `offset`.
1001
+ *
1002
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
1003
+ *
1004
+ * ```js
1005
+ * import { Buffer } from 'node:buffer';
1006
+ *
1007
+ * const buf = Buffer.from([0, 5]);
1008
+ *
1009
+ * console.log(buf.readInt16BE(0));
1010
+ * // Prints: 5
1011
+ * ```
1012
+ * @since v0.5.5
1013
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
1014
+ */
1015
+ readInt16BE(offset?: number): number;
1016
+ /**
1017
+ * Reads a signed, little-endian 32-bit integer from `buf` at the specified`offset`.
1018
+ *
1019
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
1020
+ *
1021
+ * ```js
1022
+ * import { Buffer } from 'node:buffer';
1023
+ *
1024
+ * const buf = Buffer.from([0, 0, 0, 5]);
1025
+ *
1026
+ * console.log(buf.readInt32LE(0));
1027
+ * // Prints: 83886080
1028
+ * console.log(buf.readInt32LE(1));
1029
+ * // Throws ERR_OUT_OF_RANGE.
1030
+ * ```
1031
+ * @since v0.5.5
1032
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
1033
+ */
1034
+ readInt32LE(offset?: number): number;
1035
+ /**
1036
+ * Reads a signed, big-endian 32-bit integer from `buf` at the specified `offset`.
1037
+ *
1038
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
1039
+ *
1040
+ * ```js
1041
+ * import { Buffer } from 'node:buffer';
1042
+ *
1043
+ * const buf = Buffer.from([0, 0, 0, 5]);
1044
+ *
1045
+ * console.log(buf.readInt32BE(0));
1046
+ * // Prints: 5
1047
+ * ```
1048
+ * @since v0.5.5
1049
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
1050
+ */
1051
+ readInt32BE(offset?: number): number;
1052
+ /**
1053
+ * Reads a 32-bit, little-endian float from `buf` at the specified `offset`.
1054
+ *
1055
+ * ```js
1056
+ * import { Buffer } from 'node:buffer';
1057
+ *
1058
+ * const buf = Buffer.from([1, 2, 3, 4]);
1059
+ *
1060
+ * console.log(buf.readFloatLE(0));
1061
+ * // Prints: 1.539989614439558e-36
1062
+ * console.log(buf.readFloatLE(1));
1063
+ * // Throws ERR_OUT_OF_RANGE.
1064
+ * ```
1065
+ * @since v0.11.15
1066
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
1067
+ */
1068
+ readFloatLE(offset?: number): number;
1069
+ /**
1070
+ * Reads a 32-bit, big-endian float from `buf` at the specified `offset`.
1071
+ *
1072
+ * ```js
1073
+ * import { Buffer } from 'node:buffer';
1074
+ *
1075
+ * const buf = Buffer.from([1, 2, 3, 4]);
1076
+ *
1077
+ * console.log(buf.readFloatBE(0));
1078
+ * // Prints: 2.387939260590663e-38
1079
+ * ```
1080
+ * @since v0.11.15
1081
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
1082
+ */
1083
+ readFloatBE(offset?: number): number;
1084
+ /**
1085
+ * Reads a 64-bit, little-endian double from `buf` at the specified `offset`.
1086
+ *
1087
+ * ```js
1088
+ * import { Buffer } from 'node:buffer';
1089
+ *
1090
+ * const buf = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
1091
+ *
1092
+ * console.log(buf.readDoubleLE(0));
1093
+ * // Prints: 5.447603722011605e-270
1094
+ * console.log(buf.readDoubleLE(1));
1095
+ * // Throws ERR_OUT_OF_RANGE.
1096
+ * ```
1097
+ * @since v0.11.15
1098
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
1099
+ */
1100
+ readDoubleLE(offset?: number): number;
1101
+ /**
1102
+ * Reads a 64-bit, big-endian double from `buf` at the specified `offset`.
1103
+ *
1104
+ * ```js
1105
+ * import { Buffer } from 'node:buffer';
1106
+ *
1107
+ * const buf = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
1108
+ *
1109
+ * console.log(buf.readDoubleBE(0));
1110
+ * // Prints: 8.20788039913184e-304
1111
+ * ```
1112
+ * @since v0.11.15
1113
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
1114
+ */
1115
+ readDoubleBE(offset?: number): number;
1116
+ reverse(): this;
1117
+ /**
1118
+ * Interprets `buf` as an array of unsigned 16-bit integers and swaps the
1119
+ * byte order _in-place_. Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 2.
1120
+ *
1121
+ * ```js
1122
+ * import { Buffer } from 'node:buffer';
1123
+ *
1124
+ * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
1125
+ *
1126
+ * console.log(buf1);
1127
+ * // Prints: <Buffer 01 02 03 04 05 06 07 08>
1128
+ *
1129
+ * buf1.swap16();
1130
+ *
1131
+ * console.log(buf1);
1132
+ * // Prints: <Buffer 02 01 04 03 06 05 08 07>
1133
+ *
1134
+ * const buf2 = Buffer.from([0x1, 0x2, 0x3]);
1135
+ *
1136
+ * buf2.swap16();
1137
+ * // Throws ERR_INVALID_BUFFER_SIZE.
1138
+ * ```
1139
+ *
1140
+ * One convenient use of `buf.swap16()` is to perform a fast in-place conversion
1141
+ * between UTF-16 little-endian and UTF-16 big-endian:
1142
+ *
1143
+ * ```js
1144
+ * import { Buffer } from 'node:buffer';
1145
+ *
1146
+ * const buf = Buffer.from('This is little-endian UTF-16', 'utf16le');
1147
+ * buf.swap16(); // Convert to big-endian UTF-16 text.
1148
+ * ```
1149
+ * @since v5.10.0
1150
+ * @return A reference to `buf`.
1151
+ */
1152
+ swap16(): this;
1153
+ /**
1154
+ * Interprets `buf` as an array of unsigned 32-bit integers and swaps the
1155
+ * byte order _in-place_. Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 4.
1156
+ *
1157
+ * ```js
1158
+ * import { Buffer } from 'node:buffer';
1159
+ *
1160
+ * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
1161
+ *
1162
+ * console.log(buf1);
1163
+ * // Prints: <Buffer 01 02 03 04 05 06 07 08>
1164
+ *
1165
+ * buf1.swap32();
1166
+ *
1167
+ * console.log(buf1);
1168
+ * // Prints: <Buffer 04 03 02 01 08 07 06 05>
1169
+ *
1170
+ * const buf2 = Buffer.from([0x1, 0x2, 0x3]);
1171
+ *
1172
+ * buf2.swap32();
1173
+ * // Throws ERR_INVALID_BUFFER_SIZE.
1174
+ * ```
1175
+ * @since v5.10.0
1176
+ * @return A reference to `buf`.
1177
+ */
1178
+ swap32(): this;
1179
+ /**
1180
+ * Interprets `buf` as an array of 64-bit numbers and swaps byte order _in-place_.
1181
+ * Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 8.
1182
+ *
1183
+ * ```js
1184
+ * import { Buffer } from 'node:buffer';
1185
+ *
1186
+ * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
1187
+ *
1188
+ * console.log(buf1);
1189
+ * // Prints: <Buffer 01 02 03 04 05 06 07 08>
1190
+ *
1191
+ * buf1.swap64();
1192
+ *
1193
+ * console.log(buf1);
1194
+ * // Prints: <Buffer 08 07 06 05 04 03 02 01>
1195
+ *
1196
+ * const buf2 = Buffer.from([0x1, 0x2, 0x3]);
1197
+ *
1198
+ * buf2.swap64();
1199
+ * // Throws ERR_INVALID_BUFFER_SIZE.
1200
+ * ```
1201
+ * @since v6.3.0
1202
+ * @return A reference to `buf`.
1203
+ */
1204
+ swap64(): this;
1205
+ /**
1206
+ * Writes `value` to `buf` at the specified `offset`. `value` must be a
1207
+ * valid unsigned 8-bit integer. Behavior is undefined when `value` is anything
1208
+ * other than an unsigned 8-bit integer.
1209
+ *
1210
+ * This function is also available under the `writeUint8` alias.
1211
+ *
1212
+ * ```js
1213
+ * import { Buffer } from 'node:buffer';
1214
+ *
1215
+ * const buf = Buffer.allocUnsafe(4);
1216
+ *
1217
+ * buf.writeUInt8(0x3, 0);
1218
+ * buf.writeUInt8(0x4, 1);
1219
+ * buf.writeUInt8(0x23, 2);
1220
+ * buf.writeUInt8(0x42, 3);
1221
+ *
1222
+ * console.log(buf);
1223
+ * // Prints: <Buffer 03 04 23 42>
1224
+ * ```
1225
+ * @since v0.5.0
1226
+ * @param value Number to be written to `buf`.
1227
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
1228
+ * @return `offset` plus the number of bytes written.
1229
+ */
1230
+ writeUInt8(value: number, offset?: number): number;
1231
+ /**
1232
+ * @alias Buffer.writeUInt8
1233
+ * @since v14.9.0, v12.19.0
1234
+ */
1235
+ writeUint8(value: number, offset?: number): number;
1236
+ /**
1237
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value` must be a valid unsigned 16-bit integer. Behavior is undefined when `value` is
1238
+ * anything other than an unsigned 16-bit integer.
1239
+ *
1240
+ * This function is also available under the `writeUint16LE` alias.
1241
+ *
1242
+ * ```js
1243
+ * import { Buffer } from 'node:buffer';
1244
+ *
1245
+ * const buf = Buffer.allocUnsafe(4);
1246
+ *
1247
+ * buf.writeUInt16LE(0xdead, 0);
1248
+ * buf.writeUInt16LE(0xbeef, 2);
1249
+ *
1250
+ * console.log(buf);
1251
+ * // Prints: <Buffer ad de ef be>
1252
+ * ```
1253
+ * @since v0.5.5
1254
+ * @param value Number to be written to `buf`.
1255
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
1256
+ * @return `offset` plus the number of bytes written.
1257
+ */
1258
+ writeUInt16LE(value: number, offset?: number): number;
1259
+ /**
1260
+ * @alias Buffer.writeUInt16LE
1261
+ * @since v14.9.0, v12.19.0
1262
+ */
1263
+ writeUint16LE(value: number, offset?: number): number;
1264
+ /**
1265
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value` must be a valid unsigned 16-bit integer. Behavior is undefined when `value`is anything other than an
1266
+ * unsigned 16-bit integer.
1267
+ *
1268
+ * This function is also available under the `writeUint16BE` alias.
1269
+ *
1270
+ * ```js
1271
+ * import { Buffer } from 'node:buffer';
1272
+ *
1273
+ * const buf = Buffer.allocUnsafe(4);
1274
+ *
1275
+ * buf.writeUInt16BE(0xdead, 0);
1276
+ * buf.writeUInt16BE(0xbeef, 2);
1277
+ *
1278
+ * console.log(buf);
1279
+ * // Prints: <Buffer de ad be ef>
1280
+ * ```
1281
+ * @since v0.5.5
1282
+ * @param value Number to be written to `buf`.
1283
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
1284
+ * @return `offset` plus the number of bytes written.
1285
+ */
1286
+ writeUInt16BE(value: number, offset?: number): number;
1287
+ /**
1288
+ * @alias Buffer.writeUInt16BE
1289
+ * @since v14.9.0, v12.19.0
1290
+ */
1291
+ writeUint16BE(value: number, offset?: number): number;
1292
+ /**
1293
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value` must be a valid unsigned 32-bit integer. Behavior is undefined when `value` is
1294
+ * anything other than an unsigned 32-bit integer.
1295
+ *
1296
+ * This function is also available under the `writeUint32LE` alias.
1297
+ *
1298
+ * ```js
1299
+ * import { Buffer } from 'node:buffer';
1300
+ *
1301
+ * const buf = Buffer.allocUnsafe(4);
1302
+ *
1303
+ * buf.writeUInt32LE(0xfeedface, 0);
1304
+ *
1305
+ * console.log(buf);
1306
+ * // Prints: <Buffer ce fa ed fe>
1307
+ * ```
1308
+ * @since v0.5.5
1309
+ * @param value Number to be written to `buf`.
1310
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
1311
+ * @return `offset` plus the number of bytes written.
1312
+ */
1313
+ writeUInt32LE(value: number, offset?: number): number;
1314
+ /**
1315
+ * @alias Buffer.writeUInt32LE
1316
+ * @since v14.9.0, v12.19.0
1317
+ */
1318
+ writeUint32LE(value: number, offset?: number): number;
1319
+ /**
1320
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value` must be a valid unsigned 32-bit integer. Behavior is undefined when `value`is anything other than an
1321
+ * unsigned 32-bit integer.
1322
+ *
1323
+ * This function is also available under the `writeUint32BE` alias.
1324
+ *
1325
+ * ```js
1326
+ * import { Buffer } from 'node:buffer';
1327
+ *
1328
+ * const buf = Buffer.allocUnsafe(4);
1329
+ *
1330
+ * buf.writeUInt32BE(0xfeedface, 0);
1331
+ *
1332
+ * console.log(buf);
1333
+ * // Prints: <Buffer fe ed fa ce>
1334
+ * ```
1335
+ * @since v0.5.5
1336
+ * @param value Number to be written to `buf`.
1337
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
1338
+ * @return `offset` plus the number of bytes written.
1339
+ */
1340
+ writeUInt32BE(value: number, offset?: number): number;
1341
+ /**
1342
+ * @alias Buffer.writeUInt32BE
1343
+ * @since v14.9.0, v12.19.0
1344
+ */
1345
+ writeUint32BE(value: number, offset?: number): number;
1346
+ /**
1347
+ * Writes `value` to `buf` at the specified `offset`. `value` must be a valid
1348
+ * signed 8-bit integer. Behavior is undefined when `value` is anything other than
1349
+ * a signed 8-bit integer.
1350
+ *
1351
+ * `value` is interpreted and written as a two's complement signed integer.
1352
+ *
1353
+ * ```js
1354
+ * import { Buffer } from 'node:buffer';
1355
+ *
1356
+ * const buf = Buffer.allocUnsafe(2);
1357
+ *
1358
+ * buf.writeInt8(2, 0);
1359
+ * buf.writeInt8(-2, 1);
1360
+ *
1361
+ * console.log(buf);
1362
+ * // Prints: <Buffer 02 fe>
1363
+ * ```
1364
+ * @since v0.5.0
1365
+ * @param value Number to be written to `buf`.
1366
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
1367
+ * @return `offset` plus the number of bytes written.
1368
+ */
1369
+ writeInt8(value: number, offset?: number): number;
1370
+ /**
1371
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value` must be a valid signed 16-bit integer. Behavior is undefined when `value` is
1372
+ * anything other than a signed 16-bit integer.
1373
+ *
1374
+ * The `value` is interpreted and written as a two's complement signed integer.
1375
+ *
1376
+ * ```js
1377
+ * import { Buffer } from 'node:buffer';
1378
+ *
1379
+ * const buf = Buffer.allocUnsafe(2);
1380
+ *
1381
+ * buf.writeInt16LE(0x0304, 0);
1382
+ *
1383
+ * console.log(buf);
1384
+ * // Prints: <Buffer 04 03>
1385
+ * ```
1386
+ * @since v0.5.5
1387
+ * @param value Number to be written to `buf`.
1388
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
1389
+ * @return `offset` plus the number of bytes written.
1390
+ */
1391
+ writeInt16LE(value: number, offset?: number): number;
1392
+ /**
1393
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value` must be a valid signed 16-bit integer. Behavior is undefined when `value` is
1394
+ * anything other than a signed 16-bit integer.
1395
+ *
1396
+ * The `value` is interpreted and written as a two's complement signed integer.
1397
+ *
1398
+ * ```js
1399
+ * import { Buffer } from 'node:buffer';
1400
+ *
1401
+ * const buf = Buffer.allocUnsafe(2);
1402
+ *
1403
+ * buf.writeInt16BE(0x0102, 0);
1404
+ *
1405
+ * console.log(buf);
1406
+ * // Prints: <Buffer 01 02>
1407
+ * ```
1408
+ * @since v0.5.5
1409
+ * @param value Number to be written to `buf`.
1410
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
1411
+ * @return `offset` plus the number of bytes written.
1412
+ */
1413
+ writeInt16BE(value: number, offset?: number): number;
1414
+ /**
1415
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value` must be a valid signed 32-bit integer. Behavior is undefined when `value` is
1416
+ * anything other than a signed 32-bit integer.
1417
+ *
1418
+ * The `value` is interpreted and written as a two's complement signed integer.
1419
+ *
1420
+ * ```js
1421
+ * import { Buffer } from 'node:buffer';
1422
+ *
1423
+ * const buf = Buffer.allocUnsafe(4);
1424
+ *
1425
+ * buf.writeInt32LE(0x05060708, 0);
1426
+ *
1427
+ * console.log(buf);
1428
+ * // Prints: <Buffer 08 07 06 05>
1429
+ * ```
1430
+ * @since v0.5.5
1431
+ * @param value Number to be written to `buf`.
1432
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
1433
+ * @return `offset` plus the number of bytes written.
1434
+ */
1435
+ writeInt32LE(value: number, offset?: number): number;
1436
+ /**
1437
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value` must be a valid signed 32-bit integer. Behavior is undefined when `value` is
1438
+ * anything other than a signed 32-bit integer.
1439
+ *
1440
+ * The `value` is interpreted and written as a two's complement signed integer.
1441
+ *
1442
+ * ```js
1443
+ * import { Buffer } from 'node:buffer';
1444
+ *
1445
+ * const buf = Buffer.allocUnsafe(4);
1446
+ *
1447
+ * buf.writeInt32BE(0x01020304, 0);
1448
+ *
1449
+ * console.log(buf);
1450
+ * // Prints: <Buffer 01 02 03 04>
1451
+ * ```
1452
+ * @since v0.5.5
1453
+ * @param value Number to be written to `buf`.
1454
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
1455
+ * @return `offset` plus the number of bytes written.
1456
+ */
1457
+ writeInt32BE(value: number, offset?: number): number;
1458
+ /**
1459
+ * Writes `value` to `buf` at the specified `offset` as little-endian. Behavior is
1460
+ * undefined when `value` is anything other than a JavaScript number.
1461
+ *
1462
+ * ```js
1463
+ * import { Buffer } from 'node:buffer';
1464
+ *
1465
+ * const buf = Buffer.allocUnsafe(4);
1466
+ *
1467
+ * buf.writeFloatLE(0xcafebabe, 0);
1468
+ *
1469
+ * console.log(buf);
1470
+ * // Prints: <Buffer bb fe 4a 4f>
1471
+ * ```
1472
+ * @since v0.11.15
1473
+ * @param value Number to be written to `buf`.
1474
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
1475
+ * @return `offset` plus the number of bytes written.
1476
+ */
1477
+ writeFloatLE(value: number, offset?: number): number;
1478
+ /**
1479
+ * Writes `value` to `buf` at the specified `offset` as big-endian. Behavior is
1480
+ * undefined when `value` is anything other than a JavaScript number.
1481
+ *
1482
+ * ```js
1483
+ * import { Buffer } from 'node:buffer';
1484
+ *
1485
+ * const buf = Buffer.allocUnsafe(4);
1486
+ *
1487
+ * buf.writeFloatBE(0xcafebabe, 0);
1488
+ *
1489
+ * console.log(buf);
1490
+ * // Prints: <Buffer 4f 4a fe bb>
1491
+ * ```
1492
+ * @since v0.11.15
1493
+ * @param value Number to be written to `buf`.
1494
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
1495
+ * @return `offset` plus the number of bytes written.
1496
+ */
1497
+ writeFloatBE(value: number, offset?: number): number;
1498
+ /**
1499
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value` must be a JavaScript number. Behavior is undefined when `value` is anything
1500
+ * other than a JavaScript number.
1501
+ *
1502
+ * ```js
1503
+ * import { Buffer } from 'node:buffer';
1504
+ *
1505
+ * const buf = Buffer.allocUnsafe(8);
1506
+ *
1507
+ * buf.writeDoubleLE(123.456, 0);
1508
+ *
1509
+ * console.log(buf);
1510
+ * // Prints: <Buffer 77 be 9f 1a 2f dd 5e 40>
1511
+ * ```
1512
+ * @since v0.11.15
1513
+ * @param value Number to be written to `buf`.
1514
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
1515
+ * @return `offset` plus the number of bytes written.
1516
+ */
1517
+ writeDoubleLE(value: number, offset?: number): number;
1518
+ /**
1519
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value` must be a JavaScript number. Behavior is undefined when `value` is anything
1520
+ * other than a JavaScript number.
1521
+ *
1522
+ * ```js
1523
+ * import { Buffer } from 'node:buffer';
1524
+ *
1525
+ * const buf = Buffer.allocUnsafe(8);
1526
+ *
1527
+ * buf.writeDoubleBE(123.456, 0);
1528
+ *
1529
+ * console.log(buf);
1530
+ * // Prints: <Buffer 40 5e dd 2f 1a 9f be 77>
1531
+ * ```
1532
+ * @since v0.11.15
1533
+ * @param value Number to be written to `buf`.
1534
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
1535
+ * @return `offset` plus the number of bytes written.
1536
+ */
1537
+ writeDoubleBE(value: number, offset?: number): number;
1538
+ /**
1539
+ * Fills `buf` with the specified `value`. If the `offset` and `end` are not given,
1540
+ * the entire `buf` will be filled:
1541
+ *
1542
+ * ```js
1543
+ * import { Buffer } from 'node:buffer';
1544
+ *
1545
+ * // Fill a `Buffer` with the ASCII character 'h'.
1546
+ *
1547
+ * const b = Buffer.allocUnsafe(50).fill('h');
1548
+ *
1549
+ * console.log(b.toString());
1550
+ * // Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh
1551
+ *
1552
+ * // Fill a buffer with empty string
1553
+ * const c = Buffer.allocUnsafe(5).fill('');
1554
+ *
1555
+ * console.log(c.fill(''));
1556
+ * // Prints: <Buffer 00 00 00 00 00>
1557
+ * ```
1558
+ *
1559
+ * `value` is coerced to a `uint32` value if it is not a string, `Buffer`, or
1560
+ * integer. If the resulting integer is greater than `255` (decimal), `buf` will be
1561
+ * filled with `value &#x26; 255`.
1562
+ *
1563
+ * If the final write of a `fill()` operation falls on a multi-byte character,
1564
+ * then only the bytes of that character that fit into `buf` are written:
1565
+ *
1566
+ * ```js
1567
+ * import { Buffer } from 'node:buffer';
1568
+ *
1569
+ * // Fill a `Buffer` with character that takes up two bytes in UTF-8.
1570
+ *
1571
+ * console.log(Buffer.allocUnsafe(5).fill('\u0222'));
1572
+ * // Prints: <Buffer c8 a2 c8 a2 c8>
1573
+ * ```
1574
+ *
1575
+ * If `value` contains invalid characters, it is truncated; if no valid
1576
+ * fill data remains, an exception is thrown:
1577
+ *
1578
+ * ```js
1579
+ * import { Buffer } from 'node:buffer';
1580
+ *
1581
+ * const buf = Buffer.allocUnsafe(5);
1582
+ *
1583
+ * console.log(buf.fill('a'));
1584
+ * // Prints: <Buffer 61 61 61 61 61>
1585
+ * console.log(buf.fill('aazz', 'hex'));
1586
+ * // Prints: <Buffer aa aa aa aa aa>
1587
+ * console.log(buf.fill('zz', 'hex'));
1588
+ * // Throws an exception.
1589
+ * ```
1590
+ * @since v0.5.0
1591
+ * @param value The value with which to fill `buf`. Empty value (string, Uint8Array, Buffer) is coerced to `0`.
1592
+ * @param [offset=0] Number of bytes to skip before starting to fill `buf`.
1593
+ * @param [end=buf.length] Where to stop filling `buf` (not inclusive).
1594
+ * @param [encoding='utf8'] The encoding for `value` if `value` is a string.
1595
+ * @return A reference to `buf`.
1596
+ */
1597
+ fill(value: string | Uint8Array | number, offset?: number, end?: number, encoding?: BufferEncoding): this;
1598
+ fill(value: string | Uint8Array | number, offset: number, encoding: BufferEncoding): this;
1599
+ fill(value: string | Uint8Array | number, encoding: BufferEncoding): this;
1600
+ /**
1601
+ * If `value` is:
1602
+ *
1603
+ * * a string, `value` is interpreted according to the character encoding in `encoding`.
1604
+ * * a `Buffer` or [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array), `value` will be used in its entirety.
1605
+ * To compare a partial `Buffer`, use `buf.subarray`.
1606
+ * * a number, `value` will be interpreted as an unsigned 8-bit integer
1607
+ * value between `0` and `255`.
1608
+ *
1609
+ * ```js
1610
+ * import { Buffer } from 'node:buffer';
1611
+ *
1612
+ * const buf = Buffer.from('this is a buffer');
1613
+ *
1614
+ * console.log(buf.indexOf('this'));
1615
+ * // Prints: 0
1616
+ * console.log(buf.indexOf('is'));
1617
+ * // Prints: 2
1618
+ * console.log(buf.indexOf(Buffer.from('a buffer')));
1619
+ * // Prints: 8
1620
+ * console.log(buf.indexOf(97));
1621
+ * // Prints: 8 (97 is the decimal ASCII value for 'a')
1622
+ * console.log(buf.indexOf(Buffer.from('a buffer example')));
1623
+ * // Prints: -1
1624
+ * console.log(buf.indexOf(Buffer.from('a buffer example').slice(0, 8)));
1625
+ * // Prints: 8
1626
+ *
1627
+ * const utf16Buffer = Buffer.from('\u039a\u0391\u03a3\u03a3\u0395', 'utf16le');
1628
+ *
1629
+ * console.log(utf16Buffer.indexOf('\u03a3', 0, 'utf16le'));
1630
+ * // Prints: 4
1631
+ * console.log(utf16Buffer.indexOf('\u03a3', -4, 'utf16le'));
1632
+ * // Prints: 6
1633
+ * ```
1634
+ *
1635
+ * If `value` is not a string, number, or `Buffer`, this method will throw a `TypeError`. If `value` is a number, it will be coerced to a valid byte value,
1636
+ * an integer between 0 and 255.
1637
+ *
1638
+ * If `byteOffset` is not a number, it will be coerced to a number. If the result
1639
+ * of coercion is `NaN` or `0`, then the entire buffer will be searched. This
1640
+ * behavior matches [`String.prototype.indexOf()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf).
1641
+ *
1642
+ * ```js
1643
+ * import { Buffer } from 'node:buffer';
1644
+ *
1645
+ * const b = Buffer.from('abcdef');
1646
+ *
1647
+ * // Passing a value that's a number, but not a valid byte.
1648
+ * // Prints: 2, equivalent to searching for 99 or 'c'.
1649
+ * console.log(b.indexOf(99.9));
1650
+ * console.log(b.indexOf(256 + 99));
1651
+ *
1652
+ * // Passing a byteOffset that coerces to NaN or 0.
1653
+ * // Prints: 1, searching the whole buffer.
1654
+ * console.log(b.indexOf('b', undefined));
1655
+ * console.log(b.indexOf('b', {}));
1656
+ * console.log(b.indexOf('b', null));
1657
+ * console.log(b.indexOf('b', []));
1658
+ * ```
1659
+ *
1660
+ * If `value` is an empty string or empty `Buffer` and `byteOffset` is less
1661
+ * than `buf.length`, `byteOffset` will be returned. If `value` is empty and`byteOffset` is at least `buf.length`, `buf.length` will be returned.
1662
+ * @since v1.5.0
1663
+ * @param value What to search for.
1664
+ * @param [byteOffset=0] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
1665
+ * @param [encoding='utf8'] If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
1666
+ * @return The index of the first occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
1667
+ */
1668
+ indexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
1669
+ indexOf(value: string | number | Uint8Array, encoding: BufferEncoding): number;
1670
+ /**
1671
+ * Identical to `buf.indexOf()`, except the last occurrence of `value` is found
1672
+ * rather than the first occurrence.
1673
+ *
1674
+ * ```js
1675
+ * import { Buffer } from 'node:buffer';
1676
+ *
1677
+ * const buf = Buffer.from('this buffer is a buffer');
1678
+ *
1679
+ * console.log(buf.lastIndexOf('this'));
1680
+ * // Prints: 0
1681
+ * console.log(buf.lastIndexOf('buffer'));
1682
+ * // Prints: 17
1683
+ * console.log(buf.lastIndexOf(Buffer.from('buffer')));
1684
+ * // Prints: 17
1685
+ * console.log(buf.lastIndexOf(97));
1686
+ * // Prints: 15 (97 is the decimal ASCII value for 'a')
1687
+ * console.log(buf.lastIndexOf(Buffer.from('yolo')));
1688
+ * // Prints: -1
1689
+ * console.log(buf.lastIndexOf('buffer', 5));
1690
+ * // Prints: 5
1691
+ * console.log(buf.lastIndexOf('buffer', 4));
1692
+ * // Prints: -1
1693
+ *
1694
+ * const utf16Buffer = Buffer.from('\u039a\u0391\u03a3\u03a3\u0395', 'utf16le');
1695
+ *
1696
+ * console.log(utf16Buffer.lastIndexOf('\u03a3', undefined, 'utf16le'));
1697
+ * // Prints: 6
1698
+ * console.log(utf16Buffer.lastIndexOf('\u03a3', -5, 'utf16le'));
1699
+ * // Prints: 4
1700
+ * ```
1701
+ *
1702
+ * If `value` is not a string, number, or `Buffer`, this method will throw a `TypeError`. If `value` is a number, it will be coerced to a valid byte value,
1703
+ * an integer between 0 and 255.
1704
+ *
1705
+ * If `byteOffset` is not a number, it will be coerced to a number. Any arguments
1706
+ * that coerce to `NaN`, like `{}` or `undefined`, will search the whole buffer.
1707
+ * This behavior matches [`String.prototype.lastIndexOf()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/lastIndexOf).
1708
+ *
1709
+ * ```js
1710
+ * import { Buffer } from 'node:buffer';
1711
+ *
1712
+ * const b = Buffer.from('abcdef');
1713
+ *
1714
+ * // Passing a value that's a number, but not a valid byte.
1715
+ * // Prints: 2, equivalent to searching for 99 or 'c'.
1716
+ * console.log(b.lastIndexOf(99.9));
1717
+ * console.log(b.lastIndexOf(256 + 99));
1718
+ *
1719
+ * // Passing a byteOffset that coerces to NaN.
1720
+ * // Prints: 1, searching the whole buffer.
1721
+ * console.log(b.lastIndexOf('b', undefined));
1722
+ * console.log(b.lastIndexOf('b', {}));
1723
+ *
1724
+ * // Passing a byteOffset that coerces to 0.
1725
+ * // Prints: -1, equivalent to passing 0.
1726
+ * console.log(b.lastIndexOf('b', null));
1727
+ * console.log(b.lastIndexOf('b', []));
1728
+ * ```
1729
+ *
1730
+ * If `value` is an empty string or empty `Buffer`, `byteOffset` will be returned.
1731
+ * @since v6.0.0
1732
+ * @param value What to search for.
1733
+ * @param [byteOffset=buf.length - 1] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
1734
+ * @param [encoding='utf8'] If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
1735
+ * @return The index of the last occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
1736
+ */
1737
+ lastIndexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
1738
+ lastIndexOf(value: string | number | Uint8Array, encoding: BufferEncoding): number;
1739
+ /**
1740
+ * Equivalent to `buf.indexOf() !== -1`.
1741
+ *
1742
+ * ```js
1743
+ * import { Buffer } from 'node:buffer';
1744
+ *
1745
+ * const buf = Buffer.from('this is a buffer');
1746
+ *
1747
+ * console.log(buf.includes('this'));
1748
+ * // Prints: true
1749
+ * console.log(buf.includes('is'));
1750
+ * // Prints: true
1751
+ * console.log(buf.includes(Buffer.from('a buffer')));
1752
+ * // Prints: true
1753
+ * console.log(buf.includes(97));
1754
+ * // Prints: true (97 is the decimal ASCII value for 'a')
1755
+ * console.log(buf.includes(Buffer.from('a buffer example')));
1756
+ * // Prints: false
1757
+ * console.log(buf.includes(Buffer.from('a buffer example').slice(0, 8)));
1758
+ * // Prints: true
1759
+ * console.log(buf.includes('this', 4));
1760
+ * // Prints: false
1761
+ * ```
1762
+ * @since v5.3.0
1763
+ * @param value What to search for.
1764
+ * @param [byteOffset=0] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
1765
+ * @param [encoding='utf8'] If `value` is a string, this is its encoding.
1766
+ * @return `true` if `value` was found in `buf`, `false` otherwise.
1767
+ */
1768
+ includes(value: string | number | Buffer, byteOffset?: number, encoding?: BufferEncoding): boolean;
1769
+ includes(value: string | number | Buffer, encoding: BufferEncoding): boolean;
1770
+ }
1771
+ var Buffer: BufferConstructor;
1772
+ }
1773
+ // #region web types
1774
+ export type BlobPart = NodeJS.BufferSource | Blob | string;
1775
+ export interface BlobPropertyBag {
1776
+ endings?: "native" | "transparent";
1777
+ type?: string;
1778
+ }
1779
+ export interface FilePropertyBag extends BlobPropertyBag {
1780
+ lastModified?: number;
1781
+ }
1782
+ export interface Blob {
1783
+ readonly size: number;
1784
+ readonly type: string;
1785
+ arrayBuffer(): Promise<ArrayBuffer>;
1786
+ bytes(): Promise<NodeJS.NonSharedUint8Array>;
1787
+ slice(start?: number, end?: number, contentType?: string): Blob;
1788
+ stream(): ReadableStream<NodeJS.NonSharedUint8Array>;
1789
+ text(): Promise<string>;
1790
+ }
1791
+ export var Blob: {
1792
+ prototype: Blob;
1793
+ new(blobParts?: BlobPart[], options?: BlobPropertyBag): Blob;
1794
+ };
1795
+ export interface File extends Blob {
1796
+ readonly lastModified: number;
1797
+ readonly name: string;
1798
+ readonly webkitRelativePath: string;
1799
+ }
1800
+ export var File: {
1801
+ prototype: File;
1802
+ new(fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File;
1803
+ };
1804
+ export import atob = globalThis.atob;
1805
+ export import btoa = globalThis.btoa;
1806
+ // #endregion
1807
+ }
1808
+ declare module "buffer" {
1809
+ export * from "node:buffer";
1810
+ }