gitx.do 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (356) hide show
  1. package/README.md +40 -353
  2. package/dist/do/logger.d.ts +50 -0
  3. package/dist/do/logger.d.ts.map +1 -0
  4. package/dist/do/logger.js +122 -0
  5. package/dist/do/logger.js.map +1 -0
  6. package/dist/{durable-object → do}/schema.d.ts +3 -3
  7. package/dist/do/schema.d.ts.map +1 -0
  8. package/dist/{durable-object → do}/schema.js +4 -3
  9. package/dist/do/schema.js.map +1 -0
  10. package/dist/do/types.d.ts +267 -0
  11. package/dist/do/types.d.ts.map +1 -0
  12. package/dist/do/types.js +62 -0
  13. package/dist/do/types.js.map +1 -0
  14. package/dist/index.d.ts +14 -469
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +31 -483
  17. package/dist/index.js.map +1 -1
  18. package/package.json +13 -21
  19. package/dist/cli/commands/add.d.ts +0 -176
  20. package/dist/cli/commands/add.d.ts.map +0 -1
  21. package/dist/cli/commands/add.js +0 -979
  22. package/dist/cli/commands/add.js.map +0 -1
  23. package/dist/cli/commands/blame.d.ts +0 -259
  24. package/dist/cli/commands/blame.d.ts.map +0 -1
  25. package/dist/cli/commands/blame.js +0 -609
  26. package/dist/cli/commands/blame.js.map +0 -1
  27. package/dist/cli/commands/branch.d.ts +0 -249
  28. package/dist/cli/commands/branch.d.ts.map +0 -1
  29. package/dist/cli/commands/branch.js +0 -693
  30. package/dist/cli/commands/branch.js.map +0 -1
  31. package/dist/cli/commands/checkout.d.ts +0 -73
  32. package/dist/cli/commands/checkout.d.ts.map +0 -1
  33. package/dist/cli/commands/checkout.js +0 -725
  34. package/dist/cli/commands/checkout.js.map +0 -1
  35. package/dist/cli/commands/commit.d.ts +0 -182
  36. package/dist/cli/commands/commit.d.ts.map +0 -1
  37. package/dist/cli/commands/commit.js +0 -457
  38. package/dist/cli/commands/commit.js.map +0 -1
  39. package/dist/cli/commands/diff.d.ts +0 -464
  40. package/dist/cli/commands/diff.d.ts.map +0 -1
  41. package/dist/cli/commands/diff.js +0 -959
  42. package/dist/cli/commands/diff.js.map +0 -1
  43. package/dist/cli/commands/log.d.ts +0 -239
  44. package/dist/cli/commands/log.d.ts.map +0 -1
  45. package/dist/cli/commands/log.js +0 -535
  46. package/dist/cli/commands/log.js.map +0 -1
  47. package/dist/cli/commands/merge.d.ts +0 -106
  48. package/dist/cli/commands/merge.d.ts.map +0 -1
  49. package/dist/cli/commands/merge.js +0 -852
  50. package/dist/cli/commands/merge.js.map +0 -1
  51. package/dist/cli/commands/review.d.ts +0 -457
  52. package/dist/cli/commands/review.d.ts.map +0 -1
  53. package/dist/cli/commands/review.js +0 -558
  54. package/dist/cli/commands/review.js.map +0 -1
  55. package/dist/cli/commands/stash.d.ts +0 -157
  56. package/dist/cli/commands/stash.d.ts.map +0 -1
  57. package/dist/cli/commands/stash.js +0 -655
  58. package/dist/cli/commands/stash.js.map +0 -1
  59. package/dist/cli/commands/status.d.ts +0 -269
  60. package/dist/cli/commands/status.d.ts.map +0 -1
  61. package/dist/cli/commands/status.js +0 -492
  62. package/dist/cli/commands/status.js.map +0 -1
  63. package/dist/cli/commands/web.d.ts +0 -199
  64. package/dist/cli/commands/web.d.ts.map +0 -1
  65. package/dist/cli/commands/web.js +0 -697
  66. package/dist/cli/commands/web.js.map +0 -1
  67. package/dist/cli/fs-adapter.d.ts +0 -656
  68. package/dist/cli/fs-adapter.d.ts.map +0 -1
  69. package/dist/cli/fs-adapter.js +0 -1177
  70. package/dist/cli/fs-adapter.js.map +0 -1
  71. package/dist/cli/fsx-cli-adapter.d.ts +0 -359
  72. package/dist/cli/fsx-cli-adapter.d.ts.map +0 -1
  73. package/dist/cli/fsx-cli-adapter.js +0 -619
  74. package/dist/cli/fsx-cli-adapter.js.map +0 -1
  75. package/dist/cli/index.d.ts +0 -387
  76. package/dist/cli/index.d.ts.map +0 -1
  77. package/dist/cli/index.js +0 -579
  78. package/dist/cli/index.js.map +0 -1
  79. package/dist/cli/ui/components/DiffView.d.ts +0 -12
  80. package/dist/cli/ui/components/DiffView.d.ts.map +0 -1
  81. package/dist/cli/ui/components/DiffView.js +0 -11
  82. package/dist/cli/ui/components/DiffView.js.map +0 -1
  83. package/dist/cli/ui/components/ErrorDisplay.d.ts +0 -10
  84. package/dist/cli/ui/components/ErrorDisplay.d.ts.map +0 -1
  85. package/dist/cli/ui/components/ErrorDisplay.js +0 -11
  86. package/dist/cli/ui/components/ErrorDisplay.js.map +0 -1
  87. package/dist/cli/ui/components/FuzzySearch.d.ts +0 -15
  88. package/dist/cli/ui/components/FuzzySearch.d.ts.map +0 -1
  89. package/dist/cli/ui/components/FuzzySearch.js +0 -12
  90. package/dist/cli/ui/components/FuzzySearch.js.map +0 -1
  91. package/dist/cli/ui/components/LoadingSpinner.d.ts +0 -10
  92. package/dist/cli/ui/components/LoadingSpinner.d.ts.map +0 -1
  93. package/dist/cli/ui/components/LoadingSpinner.js +0 -10
  94. package/dist/cli/ui/components/LoadingSpinner.js.map +0 -1
  95. package/dist/cli/ui/components/NavigationList.d.ts +0 -14
  96. package/dist/cli/ui/components/NavigationList.d.ts.map +0 -1
  97. package/dist/cli/ui/components/NavigationList.js +0 -11
  98. package/dist/cli/ui/components/NavigationList.js.map +0 -1
  99. package/dist/cli/ui/components/ScrollableContent.d.ts +0 -13
  100. package/dist/cli/ui/components/ScrollableContent.d.ts.map +0 -1
  101. package/dist/cli/ui/components/ScrollableContent.js +0 -11
  102. package/dist/cli/ui/components/ScrollableContent.js.map +0 -1
  103. package/dist/cli/ui/components/index.d.ts +0 -7
  104. package/dist/cli/ui/components/index.d.ts.map +0 -1
  105. package/dist/cli/ui/components/index.js +0 -9
  106. package/dist/cli/ui/components/index.js.map +0 -1
  107. package/dist/cli/ui/terminal-ui.d.ts +0 -85
  108. package/dist/cli/ui/terminal-ui.d.ts.map +0 -1
  109. package/dist/cli/ui/terminal-ui.js +0 -121
  110. package/dist/cli/ui/terminal-ui.js.map +0 -1
  111. package/dist/do/BashModule.d.ts +0 -871
  112. package/dist/do/BashModule.d.ts.map +0 -1
  113. package/dist/do/BashModule.js +0 -1143
  114. package/dist/do/BashModule.js.map +0 -1
  115. package/dist/do/FsModule.d.ts +0 -612
  116. package/dist/do/FsModule.d.ts.map +0 -1
  117. package/dist/do/FsModule.js +0 -1120
  118. package/dist/do/FsModule.js.map +0 -1
  119. package/dist/do/GitModule.d.ts +0 -635
  120. package/dist/do/GitModule.d.ts.map +0 -1
  121. package/dist/do/GitModule.js +0 -784
  122. package/dist/do/GitModule.js.map +0 -1
  123. package/dist/do/GitRepoDO.d.ts +0 -281
  124. package/dist/do/GitRepoDO.d.ts.map +0 -1
  125. package/dist/do/GitRepoDO.js +0 -479
  126. package/dist/do/GitRepoDO.js.map +0 -1
  127. package/dist/do/bash-ast.d.ts +0 -246
  128. package/dist/do/bash-ast.d.ts.map +0 -1
  129. package/dist/do/bash-ast.js +0 -888
  130. package/dist/do/bash-ast.js.map +0 -1
  131. package/dist/do/container-executor.d.ts +0 -491
  132. package/dist/do/container-executor.d.ts.map +0 -1
  133. package/dist/do/container-executor.js +0 -731
  134. package/dist/do/container-executor.js.map +0 -1
  135. package/dist/do/index.d.ts +0 -53
  136. package/dist/do/index.d.ts.map +0 -1
  137. package/dist/do/index.js +0 -91
  138. package/dist/do/index.js.map +0 -1
  139. package/dist/do/tiered-storage.d.ts +0 -403
  140. package/dist/do/tiered-storage.d.ts.map +0 -1
  141. package/dist/do/tiered-storage.js +0 -689
  142. package/dist/do/tiered-storage.js.map +0 -1
  143. package/dist/do/withBash.d.ts +0 -231
  144. package/dist/do/withBash.d.ts.map +0 -1
  145. package/dist/do/withBash.js +0 -244
  146. package/dist/do/withBash.js.map +0 -1
  147. package/dist/do/withFs.d.ts +0 -237
  148. package/dist/do/withFs.d.ts.map +0 -1
  149. package/dist/do/withFs.js +0 -387
  150. package/dist/do/withFs.js.map +0 -1
  151. package/dist/do/withGit.d.ts +0 -180
  152. package/dist/do/withGit.d.ts.map +0 -1
  153. package/dist/do/withGit.js +0 -271
  154. package/dist/do/withGit.js.map +0 -1
  155. package/dist/durable-object/object-store.d.ts +0 -633
  156. package/dist/durable-object/object-store.d.ts.map +0 -1
  157. package/dist/durable-object/object-store.js +0 -1164
  158. package/dist/durable-object/object-store.js.map +0 -1
  159. package/dist/durable-object/schema.d.ts.map +0 -1
  160. package/dist/durable-object/schema.js.map +0 -1
  161. package/dist/durable-object/wal.d.ts +0 -416
  162. package/dist/durable-object/wal.d.ts.map +0 -1
  163. package/dist/durable-object/wal.js +0 -445
  164. package/dist/durable-object/wal.js.map +0 -1
  165. package/dist/mcp/adapter.d.ts +0 -772
  166. package/dist/mcp/adapter.d.ts.map +0 -1
  167. package/dist/mcp/adapter.js +0 -895
  168. package/dist/mcp/adapter.js.map +0 -1
  169. package/dist/mcp/sandbox/miniflare-evaluator.d.ts +0 -22
  170. package/dist/mcp/sandbox/miniflare-evaluator.d.ts.map +0 -1
  171. package/dist/mcp/sandbox/miniflare-evaluator.js +0 -140
  172. package/dist/mcp/sandbox/miniflare-evaluator.js.map +0 -1
  173. package/dist/mcp/sandbox/object-store-proxy.d.ts +0 -32
  174. package/dist/mcp/sandbox/object-store-proxy.d.ts.map +0 -1
  175. package/dist/mcp/sandbox/object-store-proxy.js +0 -30
  176. package/dist/mcp/sandbox/object-store-proxy.js.map +0 -1
  177. package/dist/mcp/sandbox/template.d.ts +0 -17
  178. package/dist/mcp/sandbox/template.d.ts.map +0 -1
  179. package/dist/mcp/sandbox/template.js +0 -71
  180. package/dist/mcp/sandbox/template.js.map +0 -1
  181. package/dist/mcp/sandbox.d.ts +0 -764
  182. package/dist/mcp/sandbox.d.ts.map +0 -1
  183. package/dist/mcp/sandbox.js +0 -1362
  184. package/dist/mcp/sandbox.js.map +0 -1
  185. package/dist/mcp/sdk-adapter.d.ts +0 -835
  186. package/dist/mcp/sdk-adapter.d.ts.map +0 -1
  187. package/dist/mcp/sdk-adapter.js +0 -974
  188. package/dist/mcp/sdk-adapter.js.map +0 -1
  189. package/dist/mcp/tools/do.d.ts +0 -32
  190. package/dist/mcp/tools/do.d.ts.map +0 -1
  191. package/dist/mcp/tools/do.js +0 -117
  192. package/dist/mcp/tools/do.js.map +0 -1
  193. package/dist/mcp/tools.d.ts +0 -548
  194. package/dist/mcp/tools.d.ts.map +0 -1
  195. package/dist/mcp/tools.js +0 -3170
  196. package/dist/mcp/tools.js.map +0 -1
  197. package/dist/ops/blame.d.ts +0 -551
  198. package/dist/ops/blame.d.ts.map +0 -1
  199. package/dist/ops/blame.js +0 -1037
  200. package/dist/ops/blame.js.map +0 -1
  201. package/dist/ops/branch.d.ts +0 -766
  202. package/dist/ops/branch.d.ts.map +0 -1
  203. package/dist/ops/branch.js +0 -950
  204. package/dist/ops/branch.js.map +0 -1
  205. package/dist/ops/commit-traversal.d.ts +0 -349
  206. package/dist/ops/commit-traversal.d.ts.map +0 -1
  207. package/dist/ops/commit-traversal.js +0 -821
  208. package/dist/ops/commit-traversal.js.map +0 -1
  209. package/dist/ops/commit.d.ts +0 -555
  210. package/dist/ops/commit.d.ts.map +0 -1
  211. package/dist/ops/commit.js +0 -826
  212. package/dist/ops/commit.js.map +0 -1
  213. package/dist/ops/merge-base.d.ts +0 -397
  214. package/dist/ops/merge-base.d.ts.map +0 -1
  215. package/dist/ops/merge-base.js +0 -691
  216. package/dist/ops/merge-base.js.map +0 -1
  217. package/dist/ops/merge.d.ts +0 -855
  218. package/dist/ops/merge.d.ts.map +0 -1
  219. package/dist/ops/merge.js +0 -1551
  220. package/dist/ops/merge.js.map +0 -1
  221. package/dist/ops/tag.d.ts +0 -247
  222. package/dist/ops/tag.d.ts.map +0 -1
  223. package/dist/ops/tag.js +0 -649
  224. package/dist/ops/tag.js.map +0 -1
  225. package/dist/ops/tree-builder.d.ts +0 -178
  226. package/dist/ops/tree-builder.d.ts.map +0 -1
  227. package/dist/ops/tree-builder.js +0 -271
  228. package/dist/ops/tree-builder.js.map +0 -1
  229. package/dist/ops/tree-diff.d.ts +0 -291
  230. package/dist/ops/tree-diff.d.ts.map +0 -1
  231. package/dist/ops/tree-diff.js +0 -705
  232. package/dist/ops/tree-diff.js.map +0 -1
  233. package/dist/pack/delta.d.ts +0 -248
  234. package/dist/pack/delta.d.ts.map +0 -1
  235. package/dist/pack/delta.js +0 -740
  236. package/dist/pack/delta.js.map +0 -1
  237. package/dist/pack/format.d.ts +0 -446
  238. package/dist/pack/format.d.ts.map +0 -1
  239. package/dist/pack/format.js +0 -572
  240. package/dist/pack/format.js.map +0 -1
  241. package/dist/pack/full-generation.d.ts +0 -612
  242. package/dist/pack/full-generation.d.ts.map +0 -1
  243. package/dist/pack/full-generation.js +0 -1378
  244. package/dist/pack/full-generation.js.map +0 -1
  245. package/dist/pack/generation.d.ts +0 -441
  246. package/dist/pack/generation.d.ts.map +0 -1
  247. package/dist/pack/generation.js +0 -707
  248. package/dist/pack/generation.js.map +0 -1
  249. package/dist/pack/index.d.ts +0 -502
  250. package/dist/pack/index.d.ts.map +0 -1
  251. package/dist/pack/index.js +0 -833
  252. package/dist/pack/index.js.map +0 -1
  253. package/dist/refs/branch.d.ts +0 -683
  254. package/dist/refs/branch.d.ts.map +0 -1
  255. package/dist/refs/branch.js +0 -881
  256. package/dist/refs/branch.js.map +0 -1
  257. package/dist/refs/storage.d.ts +0 -833
  258. package/dist/refs/storage.d.ts.map +0 -1
  259. package/dist/refs/storage.js +0 -1023
  260. package/dist/refs/storage.js.map +0 -1
  261. package/dist/refs/tag.d.ts +0 -860
  262. package/dist/refs/tag.d.ts.map +0 -1
  263. package/dist/refs/tag.js +0 -996
  264. package/dist/refs/tag.js.map +0 -1
  265. package/dist/storage/backend.d.ts +0 -425
  266. package/dist/storage/backend.d.ts.map +0 -1
  267. package/dist/storage/backend.js +0 -41
  268. package/dist/storage/backend.js.map +0 -1
  269. package/dist/storage/fsx-adapter.d.ts +0 -204
  270. package/dist/storage/fsx-adapter.d.ts.map +0 -1
  271. package/dist/storage/fsx-adapter.js +0 -518
  272. package/dist/storage/fsx-adapter.js.map +0 -1
  273. package/dist/storage/lru-cache.d.ts +0 -691
  274. package/dist/storage/lru-cache.d.ts.map +0 -1
  275. package/dist/storage/lru-cache.js +0 -813
  276. package/dist/storage/lru-cache.js.map +0 -1
  277. package/dist/storage/object-index.d.ts +0 -585
  278. package/dist/storage/object-index.d.ts.map +0 -1
  279. package/dist/storage/object-index.js +0 -532
  280. package/dist/storage/object-index.js.map +0 -1
  281. package/dist/storage/r2-pack.d.ts +0 -1257
  282. package/dist/storage/r2-pack.d.ts.map +0 -1
  283. package/dist/storage/r2-pack.js +0 -1773
  284. package/dist/storage/r2-pack.js.map +0 -1
  285. package/dist/tiered/cdc-pipeline.d.ts +0 -1888
  286. package/dist/tiered/cdc-pipeline.d.ts.map +0 -1
  287. package/dist/tiered/cdc-pipeline.js +0 -1880
  288. package/dist/tiered/cdc-pipeline.js.map +0 -1
  289. package/dist/tiered/migration.d.ts +0 -1104
  290. package/dist/tiered/migration.d.ts.map +0 -1
  291. package/dist/tiered/migration.js +0 -1217
  292. package/dist/tiered/migration.js.map +0 -1
  293. package/dist/tiered/parquet-writer.d.ts +0 -1145
  294. package/dist/tiered/parquet-writer.d.ts.map +0 -1
  295. package/dist/tiered/parquet-writer.js +0 -1183
  296. package/dist/tiered/parquet-writer.js.map +0 -1
  297. package/dist/tiered/read-path.d.ts +0 -835
  298. package/dist/tiered/read-path.d.ts.map +0 -1
  299. package/dist/tiered/read-path.js +0 -487
  300. package/dist/tiered/read-path.js.map +0 -1
  301. package/dist/types/capability.d.ts +0 -1385
  302. package/dist/types/capability.d.ts.map +0 -1
  303. package/dist/types/capability.js +0 -36
  304. package/dist/types/capability.js.map +0 -1
  305. package/dist/types/index.d.ts +0 -13
  306. package/dist/types/index.d.ts.map +0 -1
  307. package/dist/types/index.js +0 -18
  308. package/dist/types/index.js.map +0 -1
  309. package/dist/types/interfaces.d.ts +0 -673
  310. package/dist/types/interfaces.d.ts.map +0 -1
  311. package/dist/types/interfaces.js +0 -26
  312. package/dist/types/interfaces.js.map +0 -1
  313. package/dist/types/objects.d.ts +0 -692
  314. package/dist/types/objects.d.ts.map +0 -1
  315. package/dist/types/objects.js +0 -837
  316. package/dist/types/objects.js.map +0 -1
  317. package/dist/types/storage.d.ts +0 -603
  318. package/dist/types/storage.d.ts.map +0 -1
  319. package/dist/types/storage.js +0 -191
  320. package/dist/types/storage.js.map +0 -1
  321. package/dist/types/worker-loader.d.ts +0 -60
  322. package/dist/types/worker-loader.d.ts.map +0 -1
  323. package/dist/types/worker-loader.js +0 -62
  324. package/dist/types/worker-loader.js.map +0 -1
  325. package/dist/utils/hash.d.ts +0 -198
  326. package/dist/utils/hash.d.ts.map +0 -1
  327. package/dist/utils/hash.js +0 -272
  328. package/dist/utils/hash.js.map +0 -1
  329. package/dist/utils/sha1.d.ts +0 -325
  330. package/dist/utils/sha1.d.ts.map +0 -1
  331. package/dist/utils/sha1.js +0 -635
  332. package/dist/utils/sha1.js.map +0 -1
  333. package/dist/wire/capabilities.d.ts +0 -1044
  334. package/dist/wire/capabilities.d.ts.map +0 -1
  335. package/dist/wire/capabilities.js +0 -941
  336. package/dist/wire/capabilities.js.map +0 -1
  337. package/dist/wire/path-security.d.ts +0 -157
  338. package/dist/wire/path-security.d.ts.map +0 -1
  339. package/dist/wire/path-security.js +0 -307
  340. package/dist/wire/path-security.js.map +0 -1
  341. package/dist/wire/pkt-line.d.ts +0 -345
  342. package/dist/wire/pkt-line.d.ts.map +0 -1
  343. package/dist/wire/pkt-line.js +0 -381
  344. package/dist/wire/pkt-line.js.map +0 -1
  345. package/dist/wire/receive-pack.d.ts +0 -1059
  346. package/dist/wire/receive-pack.d.ts.map +0 -1
  347. package/dist/wire/receive-pack.js +0 -1414
  348. package/dist/wire/receive-pack.js.map +0 -1
  349. package/dist/wire/smart-http.d.ts +0 -799
  350. package/dist/wire/smart-http.d.ts.map +0 -1
  351. package/dist/wire/smart-http.js +0 -945
  352. package/dist/wire/smart-http.js.map +0 -1
  353. package/dist/wire/upload-pack.d.ts +0 -727
  354. package/dist/wire/upload-pack.d.ts.map +0 -1
  355. package/dist/wire/upload-pack.js +0 -1141
  356. package/dist/wire/upload-pack.js.map +0 -1
@@ -1,272 +0,0 @@
1
- /**
2
- * @fileoverview SHA Hashing Utilities for Git Objects
3
- *
4
- * This module provides cryptographic hashing functions used for Git object
5
- * identification and verification. Git uses SHA-1 as its primary hash algorithm,
6
- * with SHA-256 available as an optional newer algorithm (Git v2.29+).
7
- *
8
- * Core hash primitives are imported from fsx.do which uses the Web Crypto API.
9
- * Sync primitives are kept local for pack operations that need streaming SHA1.
10
- *
11
- * @module utils/hash
12
- *
13
- * @example
14
- * ```typescript
15
- * import { sha1, hashObject, hexToBytes, bytesToHex } from './utils/hash'
16
- *
17
- * // Hash raw data
18
- * const hash = await sha1('Hello, World!')
19
- *
20
- * // Hash as a Git object (includes type header)
21
- * const content = new TextEncoder().encode('file content')
22
- * const blobSha = await hashObject('blob', content)
23
- * console.log(`blob ${blobSha}`)
24
- * ```
25
- */
26
- // Re-export hash functions from fsx.do - now works in Workers environment
27
- export { sha1, sha256, bytesToHex, hexToBytes } from 'fsx.do';
28
- // Keep local sync implementations for pack operations that need streaming SHA1
29
- export { sha1Hex } from './sha1';
30
- // Import local bytesToHex for cache key generation (synchronous)
31
- import { bytesToHex as localBytesToHex } from './sha1';
32
- // Import sha1 from fsx.do for the hashObject function
33
- import { sha1 } from 'fsx.do';
34
- /**
35
- * Hash a Git object with its type header.
36
- *
37
- * @description
38
- * Computes the SHA-1 hash of a Git object including its header.
39
- * The header format is: "{type} {size}\0" followed by the content.
40
- *
41
- * This matches the output of `git hash-object` command and is the
42
- * standard way Git computes object identifiers.
43
- *
44
- * @param type - Object type ('blob', 'tree', 'commit', 'tag')
45
- * @param data - Object content as binary data (without header)
46
- * @returns 40-character lowercase hexadecimal SHA-1 hash
47
- *
48
- * @example
49
- * ```typescript
50
- * // Hash a blob (equivalent to `echo -n "hello" | git hash-object --stdin`)
51
- * const content = new TextEncoder().encode('hello')
52
- * const sha = await hashObject('blob', content)
53
- * console.log(sha) // 'b6fc4c620b67d95f953a5c1c1230aaab5db5a1b0'
54
- *
55
- * // Verify with git:
56
- * // $ echo -n "hello" | git hash-object --stdin
57
- * // b6fc4c620b67d95f953a5c1c1230aaab5db5a1b0
58
- * ```
59
- */
60
- export async function hashObject(type, data) {
61
- const header = `${type} ${data.length}\0`;
62
- const headerBytes = new TextEncoder().encode(header);
63
- const combined = new Uint8Array(headerBytes.length + data.length);
64
- combined.set(headerBytes, 0);
65
- combined.set(data, headerBytes.length);
66
- return sha1(combined);
67
- }
68
- // ============================================================================
69
- // Hash Caching
70
- // ============================================================================
71
- /**
72
- * LRU cache for storing computed hashes.
73
- *
74
- * @description
75
- * A Least Recently Used (LRU) cache implementation for caching SHA-1 hashes.
76
- * This is useful when the same data is hashed multiple times, such as during
77
- * pack file operations or object store lookups.
78
- *
79
- * **Key Strategy**: The cache key is derived from the first few bytes of the
80
- * data combined with its length, which provides a fast key generation while
81
- * avoiding collisions for different data.
82
- *
83
- * **Thread Safety**: This implementation is NOT thread-safe. In multi-threaded
84
- * environments, external synchronization is required.
85
- *
86
- * @class HashCache
87
- *
88
- * @example
89
- * ```typescript
90
- * const cache = new HashCache(1000) // Cache up to 1000 hashes
91
- *
92
- * // Use with getOrCompute for automatic caching
93
- * const hash1 = await cache.getOrCompute(data, async () => sha1(data))
94
- * const hash2 = await cache.getOrCompute(data, async () => sha1(data)) // Returns cached
95
- *
96
- * // Check stats
97
- * console.log(`Hit rate: ${cache.hitRate}%`)
98
- * ```
99
- */
100
- export class HashCache {
101
- cache;
102
- maxSize;
103
- hits = 0;
104
- misses = 0;
105
- /**
106
- * Creates a new HashCache with the specified maximum size.
107
- *
108
- * @param {number} maxSize - Maximum number of hashes to cache (default: 10000)
109
- */
110
- constructor(maxSize = 10000) {
111
- this.cache = new Map();
112
- this.maxSize = maxSize;
113
- }
114
- /**
115
- * Generates a cache key for the given data.
116
- *
117
- * @description Uses length + first 32 bytes (if available) to create a unique key.
118
- * This is fast while providing good collision resistance.
119
- *
120
- * @param {Uint8Array} data - Data to generate key for
121
- * @returns {string} Cache key
122
- * @internal
123
- */
124
- generateKey(data) {
125
- // Use length + first 32 bytes as key (fast and reasonably unique)
126
- const prefix = data.length <= 32
127
- ? localBytesToHex(data)
128
- : localBytesToHex(data.subarray(0, 32));
129
- return `${data.length}:${prefix}`;
130
- }
131
- /**
132
- * Gets a cached hash if available.
133
- *
134
- * @param {Uint8Array} data - Data to look up
135
- * @returns {string | undefined} Cached hash or undefined if not cached
136
- */
137
- get(data) {
138
- const key = this.generateKey(data);
139
- const value = this.cache.get(key);
140
- if (value !== undefined) {
141
- this.hits++;
142
- // Move to end (most recently used)
143
- this.cache.delete(key);
144
- this.cache.set(key, value);
145
- return value;
146
- }
147
- this.misses++;
148
- return undefined;
149
- }
150
- /**
151
- * Stores a hash in the cache.
152
- *
153
- * @param {Uint8Array} data - Original data
154
- * @param {string} hash - Computed hash to cache
155
- */
156
- set(data, hash) {
157
- const key = this.generateKey(data);
158
- // Remove oldest entry if at capacity
159
- if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
160
- const firstKey = this.cache.keys().next().value;
161
- if (firstKey !== undefined) {
162
- this.cache.delete(firstKey);
163
- }
164
- }
165
- this.cache.set(key, hash);
166
- }
167
- /**
168
- * Gets a hash from cache or computes and caches it.
169
- *
170
- * @description This is the recommended way to use the cache. It automatically
171
- * handles cache lookup, computation, and storage.
172
- *
173
- * @param {Uint8Array} data - Data to hash
174
- * @param {() => Promise<string> | string} compute - Function to compute hash if not cached
175
- * @returns {Promise<string>} The hash (from cache or newly computed)
176
- *
177
- * @example
178
- * ```typescript
179
- * const hash = await cache.getOrCompute(data, () => sha1(data))
180
- * ```
181
- */
182
- async getOrCompute(data, compute) {
183
- const cached = this.get(data);
184
- if (cached !== undefined) {
185
- return cached;
186
- }
187
- const hash = await compute();
188
- this.set(data, hash);
189
- return hash;
190
- }
191
- /**
192
- * Synchronous version of getOrCompute for use with synchronous hash functions.
193
- *
194
- * @param {Uint8Array} data - Data to hash
195
- * @param {() => string} compute - Function to compute hash if not cached
196
- * @returns {string} The hash (from cache or newly computed)
197
- *
198
- * @example
199
- * ```typescript
200
- * import { sha1Hex } from './sha1'
201
- * const hash = cache.getOrComputeSync(data, () => sha1Hex(data))
202
- * ```
203
- */
204
- getOrComputeSync(data, compute) {
205
- const cached = this.get(data);
206
- if (cached !== undefined) {
207
- return cached;
208
- }
209
- const hash = compute();
210
- this.set(data, hash);
211
- return hash;
212
- }
213
- /**
214
- * Clears all entries from the cache.
215
- */
216
- clear() {
217
- this.cache.clear();
218
- this.hits = 0;
219
- this.misses = 0;
220
- }
221
- /**
222
- * Gets the current number of cached entries.
223
- */
224
- get size() {
225
- return this.cache.size;
226
- }
227
- /**
228
- * Gets the cache hit rate as a percentage.
229
- */
230
- get hitRate() {
231
- const total = this.hits + this.misses;
232
- return total === 0 ? 0 : (this.hits / total) * 100;
233
- }
234
- /**
235
- * Gets cache statistics.
236
- *
237
- * @returns {{ hits: number; misses: number; size: number; hitRate: number }}
238
- */
239
- getStats() {
240
- return {
241
- hits: this.hits,
242
- misses: this.misses,
243
- size: this.cache.size,
244
- hitRate: this.hitRate
245
- };
246
- }
247
- }
248
- /**
249
- * Global hash cache instance for common use cases.
250
- *
251
- * @description
252
- * A shared cache instance that can be used across the application for
253
- * caching object hashes. This is particularly useful for pack file
254
- * operations where the same objects are hashed multiple times.
255
- *
256
- * **Memory Management**: The cache has a default limit of 10,000 entries.
257
- * For applications with different requirements, create a custom HashCache
258
- * instance with appropriate size.
259
- *
260
- * @example
261
- * ```typescript
262
- * import { globalHashCache, sha1 } from './utils/hash'
263
- *
264
- * // Use the global cache
265
- * const hash = await globalHashCache.getOrCompute(data, () => sha1(data))
266
- *
267
- * // Check cache stats
268
- * console.log(globalHashCache.getStats())
269
- * ```
270
- */
271
- export const globalHashCache = new HashCache();
272
- //# sourceMappingURL=hash.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"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"}
@@ -1,325 +0,0 @@
1
- /**
2
- * @fileoverview Synchronous SHA-1 Utilities for Git Pack Operations
3
- *
4
- * This module provides synchronous (non-async) SHA-1 hashing needed for pack file
5
- * generation, verification, and streaming operations where async is impractical.
6
- *
7
- * The implementation follows the SHA-1 specification (FIPS 180-4) and processes
8
- * data in 512-bit (64-byte) chunks using the standard compression function.
9
- *
10
- * **When to use this vs hash.ts**:
11
- * - Use `utils/hash.ts` for general async hashing (uses Web Crypto API)
12
- * - Use this module for pack operations that need synchronous hashing
13
- *
14
- * @module utils/sha1
15
- *
16
- * @example
17
- * ```typescript
18
- * import { sha1, sha1Hex, sha1Verify } from './utils/sha1'
19
- *
20
- * // Compute SHA-1 as bytes
21
- * const data = new TextEncoder().encode('Hello, World!')
22
- * const hashBytes = sha1(data) // 20-byte Uint8Array
23
- *
24
- * // Compute SHA-1 as hex string
25
- * const hashHex = sha1Hex(data) // 40-char string
26
- *
27
- * // Verify data against expected hash
28
- * const isValid = sha1Verify(data, expectedHash)
29
- * ```
30
- */
31
- /**
32
- * Compute SHA-1 hash of data synchronously.
33
- *
34
- * @description
35
- * Implements the SHA-1 algorithm per FIPS 180-4. This pure JavaScript
36
- * implementation is used when synchronous hashing is needed, such as
37
- * in pack file generation or streaming operations.
38
- *
39
- * **Algorithm Details**:
40
- * 1. Pad message to 512-bit boundary (with 1-bit, zeros, and 64-bit length)
41
- * 2. Process in 64-byte chunks using 80-round compression function
42
- * 3. Return final 160-bit (20-byte) hash
43
- *
44
- * **Performance Note**: This is slower than Web Crypto API. Use `hash.ts`
45
- * for async operations where performance is critical.
46
- *
47
- * @param data - Input data to hash
48
- * @returns 20-byte hash as Uint8Array
49
- *
50
- * @example
51
- * ```typescript
52
- * const data = new TextEncoder().encode('test')
53
- * const hash = sha1(data)
54
- * console.log(hash.length) // 20
55
- *
56
- * // Use with pack file verification
57
- * const packData = readPackFile()
58
- * const computedHash = sha1(packData.slice(0, -20))
59
- * ```
60
- */
61
- export declare function sha1(data: Uint8Array): Uint8Array;
62
- /**
63
- * Compute SHA-1 hash and return as hexadecimal string.
64
- *
65
- * @description
66
- * Convenience wrapper that computes SHA-1 and converts the result
67
- * to a lowercase hexadecimal string. Equivalent to calling `sha1()`
68
- * followed by hex conversion.
69
- *
70
- * @param data - Input data to hash
71
- * @returns 40-character lowercase hexadecimal hash string
72
- *
73
- * @example
74
- * ```typescript
75
- * const data = new TextEncoder().encode('hello')
76
- * const hex = sha1Hex(data)
77
- * console.log(hex) // 'aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d'
78
- *
79
- * // Compare with git:
80
- * // $ echo -n "hello" | sha1sum
81
- * // aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d
82
- * ```
83
- */
84
- export declare function sha1Hex(data: Uint8Array): string;
85
- /**
86
- * Verify data against an expected SHA-1 hash.
87
- *
88
- * @description
89
- * Computes the SHA-1 hash of the data and compares it byte-by-byte
90
- * with the expected hash. Returns true only if all 20 bytes match.
91
- *
92
- * This uses constant-time comparison to avoid timing attacks,
93
- * though SHA-1 is not used for security purposes in Git.
94
- *
95
- * @param data - Data to verify
96
- * @param expected - Expected 20-byte SHA-1 hash
97
- * @returns True if the computed hash matches the expected hash
98
- * @throws Never throws - returns false for invalid inputs
99
- *
100
- * @example
101
- * ```typescript
102
- * // Verify pack file integrity
103
- * const packContent = readPackFile()
104
- * const contentWithoutChecksum = packContent.slice(0, -20)
105
- * const expectedChecksum = packContent.slice(-20)
106
- *
107
- * if (sha1Verify(contentWithoutChecksum, expectedChecksum)) {
108
- * console.log('Pack file integrity verified')
109
- * } else {
110
- * console.log('Pack file corrupted!')
111
- * }
112
- *
113
- * // Invalid expected hash length
114
- * const badHash = new Uint8Array(10)
115
- * sha1Verify(data, badHash) // false (wrong length)
116
- * ```
117
- */
118
- export declare function sha1Verify(data: Uint8Array, expected: Uint8Array): boolean;
119
- /**
120
- * Convert bytes to hexadecimal string.
121
- *
122
- * @description Efficiently converts a Uint8Array to its hexadecimal
123
- * representation. Each byte becomes two hex characters (00-ff).
124
- *
125
- * @param bytes - Input bytes to convert
126
- * @returns Lowercase hexadecimal string (2 chars per byte)
127
- *
128
- * @example
129
- * ```typescript
130
- * const bytes = new Uint8Array([0x48, 0x65, 0x6c, 0x6c, 0x6f])
131
- * const hex = bytesToHex(bytes)
132
- * console.log(hex) // '48656c6c6f'
133
- * ```
134
- */
135
- export declare function bytesToHex(bytes: Uint8Array): string;
136
- /**
137
- * Convert hexadecimal string to bytes.
138
- *
139
- * @description Converts a hexadecimal string back to its binary representation.
140
- * Each pair of hex characters becomes one byte.
141
- *
142
- * @param hex - Hexadecimal string (case-insensitive)
143
- * @returns Uint8Array of bytes
144
- * @throws {Error} If hex string has odd length
145
- *
146
- * @example
147
- * ```typescript
148
- * const hex = '48656c6c6f'
149
- * const bytes = hexToBytes(hex)
150
- * console.log(new TextDecoder().decode(bytes)) // 'Hello'
151
- * ```
152
- */
153
- export declare function hexToBytes(hex: string): Uint8Array;
154
- /**
155
- * Streaming SHA-1 hasher for processing large data incrementally.
156
- *
157
- * @description
158
- * This class allows hashing data in chunks, which is essential for:
159
- * - Processing large files without loading everything into memory
160
- * - Computing hashes of data streams
161
- * - Pack file generation and verification
162
- *
163
- * The hasher maintains internal state and can accept data through the
164
- * `update()` method before finalizing with `digest()` or `digestHex()`.
165
- *
166
- * **Performance Note**: For small data (< 64 bytes), the non-streaming
167
- * `sha1()` function may be slightly faster due to lower overhead.
168
- *
169
- * @class StreamingSHA1
170
- *
171
- * @example
172
- * ```typescript
173
- * // Hash a large file in chunks
174
- * const hasher = new StreamingSHA1()
175
- *
176
- * for await (const chunk of fileStream) {
177
- * hasher.update(chunk)
178
- * }
179
- *
180
- * const hash = hasher.digestHex()
181
- * console.log(`File hash: ${hash}`)
182
- * ```
183
- *
184
- * @example
185
- * ```typescript
186
- * // Hash Git object with header
187
- * const hasher = new StreamingSHA1()
188
- * hasher.update(new TextEncoder().encode(`blob ${size}\0`))
189
- * hasher.update(content)
190
- * const objectId = hasher.digestHex()
191
- * ```
192
- */
193
- export declare class StreamingSHA1 {
194
- /** Hash state */
195
- private h;
196
- /** Working array for chunk processing */
197
- private w;
198
- /** Buffer for incomplete chunks */
199
- private buffer;
200
- /** Current position in buffer */
201
- private bufferLength;
202
- /** Total bytes processed */
203
- private totalLength;
204
- /** Whether digest has been called */
205
- private finalized;
206
- /**
207
- * Creates a new StreamingSHA1 hasher instance.
208
- */
209
- constructor();
210
- /**
211
- * Resets the hasher to its initial state.
212
- *
213
- * @description Allows reusing the same hasher instance for a new hash
214
- * computation without creating a new object.
215
- *
216
- * @example
217
- * ```typescript
218
- * const hasher = new StreamingSHA1()
219
- * hasher.update(data1)
220
- * const hash1 = hasher.digestHex()
221
- *
222
- * hasher.reset()
223
- * hasher.update(data2)
224
- * const hash2 = hasher.digestHex()
225
- * ```
226
- */
227
- reset(): void;
228
- /**
229
- * Updates the hash with additional data.
230
- *
231
- * @description Processes the input data, updating the internal hash state.
232
- * Data is buffered internally until a complete 64-byte chunk is available,
233
- * then processed immediately.
234
- *
235
- * This method can be called multiple times before finalizing with `digest()`.
236
- *
237
- * @param {Uint8Array} data - Data to add to the hash computation
238
- * @returns {this} The hasher instance for method chaining
239
- * @throws {Error} If called after digest() without reset()
240
- *
241
- * @example
242
- * ```typescript
243
- * const hasher = new StreamingSHA1()
244
- * .update(header)
245
- * .update(content)
246
- * .update(footer)
247
- * const hash = hasher.digestHex()
248
- * ```
249
- */
250
- update(data: Uint8Array): this;
251
- /**
252
- * Finalizes the hash computation and returns the 20-byte digest.
253
- *
254
- * @description Applies SHA-1 padding to the remaining data and computes
255
- * the final hash. After calling this method, the hasher cannot be updated
256
- * unless `reset()` is called.
257
- *
258
- * @returns {Uint8Array} 20-byte SHA-1 hash
259
- *
260
- * @example
261
- * ```typescript
262
- * const hasher = new StreamingSHA1()
263
- * hasher.update(data)
264
- * const hashBytes = hasher.digest()
265
- * console.log(hashBytes.length) // 20
266
- * ```
267
- */
268
- digest(): Uint8Array;
269
- /**
270
- * Finalizes the hash computation and returns the hex string digest.
271
- *
272
- * @description Convenience method that calls `digest()` and converts
273
- * the result to a 40-character lowercase hexadecimal string.
274
- *
275
- * @returns {string} 40-character lowercase hexadecimal hash string
276
- *
277
- * @example
278
- * ```typescript
279
- * const hasher = new StreamingSHA1()
280
- * hasher.update(data)
281
- * const hash = hasher.digestHex()
282
- * console.log(hash) // 'aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d'
283
- * ```
284
- */
285
- digestHex(): string;
286
- }
287
- /**
288
- * Hash a Git object with streaming support for large objects.
289
- *
290
- * @description
291
- * Uses the streaming hasher to compute the SHA-1 of a Git object with its header.
292
- * This is more memory-efficient than `hashObject` in `hash.ts` for large objects
293
- * as it doesn't require concatenating header and data.
294
- *
295
- * @param type - Object type ('blob', 'tree', 'commit', 'tag')
296
- * @param data - Object content as binary data
297
- * @returns 20-byte SHA-1 hash as Uint8Array
298
- *
299
- * @example
300
- * ```typescript
301
- * const content = new TextEncoder().encode('hello')
302
- * const hashBytes = hashObjectStreaming('blob', content)
303
- * ```
304
- */
305
- export declare function hashObjectStreaming(type: string, data: Uint8Array): Uint8Array;
306
- /**
307
- * Hash a Git object with streaming support, returning hex string.
308
- *
309
- * @description
310
- * Convenience wrapper that returns the hash as a 40-character hex string
311
- * instead of raw bytes.
312
- *
313
- * @param type - Object type ('blob', 'tree', 'commit', 'tag')
314
- * @param data - Object content as binary data
315
- * @returns 40-character lowercase hexadecimal SHA-1 hash
316
- *
317
- * @example
318
- * ```typescript
319
- * const content = new TextEncoder().encode('hello')
320
- * const sha = hashObjectStreamingHex('blob', content)
321
- * console.log(sha) // 'b6fc4c620b67d95f953a5c1c1230aaab5db5a1b0'
322
- * ```
323
- */
324
- export declare function hashObjectStreamingHex(type: string, data: Uint8Array): string;
325
- //# sourceMappingURL=sha1.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sha1.d.ts","sourceRoot":"","sources":["../../src/utils/sha1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAwGjD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAOhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAgB1E;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CASlD;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,aAAa;IACxB,iBAAiB;IACjB,OAAO,CAAC,CAAC,CAAa;IACtB,yCAAyC;IACzC,OAAO,CAAC,CAAC,CAAa;IACtB,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAY;IAC1B,iCAAiC;IACjC,OAAO,CAAC,YAAY,CAAQ;IAC5B,4BAA4B;IAC5B,OAAO,CAAC,WAAW,CAAQ;IAC3B,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;;IAUH;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,IAAI,IAAI;IAWb;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAsC9B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,IAAI,UAAU;IAmDpB;;;;;;;;;;;;;;;OAeG;IACH,SAAS,IAAI,MAAM;CAQpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAM9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAM7E"}