@intentius/chant-lexicon-terraform 0.124.52 → 0.124.55

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 (641) hide show
  1. package/README.md +14 -10
  2. package/dist/__fixtures__/pr-loop/estate.component.d.ts +7 -0
  3. package/dist/__fixtures__/pr-loop/estate.component.d.ts.map +1 -0
  4. package/dist/__fixtures__/pr-loop/estate.component.js +7 -0
  5. package/dist/__fixtures__/report/generate.d.ts +26 -0
  6. package/dist/__fixtures__/report/generate.d.ts.map +1 -0
  7. package/dist/__fixtures__/report/generate.js +58 -0
  8. package/dist/applied-state.d.ts +27 -0
  9. package/dist/applied-state.d.ts.map +1 -0
  10. package/dist/applied-state.js +44 -0
  11. package/dist/backend-config.d.ts +53 -0
  12. package/dist/backend-config.d.ts.map +1 -0
  13. package/dist/backend-config.js +136 -0
  14. package/dist/behaviour/kinds.d.ts.map +1 -1
  15. package/dist/behaviour/kinds.js +4 -0
  16. package/dist/behaviour/predict.d.ts.map +1 -1
  17. package/dist/behaviour/predict.js +6 -2
  18. package/dist/behaviour/reference-catalog.d.ts +16 -5
  19. package/dist/behaviour/reference-catalog.d.ts.map +1 -1
  20. package/dist/behaviour/reference-catalog.js +16 -5
  21. package/dist/behaviour/request.d.ts.map +1 -1
  22. package/dist/behaviour/request.js +3 -2
  23. package/dist/changed-roots.d.ts +6 -4
  24. package/dist/changed-roots.d.ts.map +1 -1
  25. package/dist/changed-roots.js +14 -18
  26. package/dist/ci-setup.d.ts +11 -0
  27. package/dist/ci-setup.d.ts.map +1 -0
  28. package/dist/ci-setup.js +41 -0
  29. package/dist/commands.d.ts.map +1 -1
  30. package/dist/commands.js +4 -3
  31. package/dist/components/capability-plugin.d.ts +105 -9
  32. package/dist/components/capability-plugin.d.ts.map +1 -1
  33. package/dist/components/capability-plugin.js +357 -36
  34. package/dist/components/compose-group.d.ts +145 -0
  35. package/dist/components/compose-group.d.ts.map +1 -0
  36. package/dist/components/compose-group.js +407 -0
  37. package/dist/components/placeholder-preview.d.ts +78 -0
  38. package/dist/components/placeholder-preview.d.ts.map +1 -0
  39. package/dist/components/placeholder-preview.js +254 -0
  40. package/dist/components/release-inputs.d.ts +29 -0
  41. package/dist/components/release-inputs.d.ts.map +1 -0
  42. package/dist/components/release-inputs.js +57 -0
  43. package/dist/components/trace-facts.d.ts +16 -0
  44. package/dist/components/trace-facts.d.ts.map +1 -0
  45. package/dist/components/trace-facts.js +19 -0
  46. package/dist/compose/apply-events.d.ts +46 -0
  47. package/dist/compose/apply-events.d.ts.map +1 -0
  48. package/dist/compose/apply-events.js +77 -0
  49. package/dist/compose/estate.d.ts +194 -0
  50. package/dist/compose/estate.d.ts.map +1 -0
  51. package/dist/compose/estate.js +363 -0
  52. package/dist/compose/hcl.d.ts +99 -0
  53. package/dist/compose/hcl.d.ts.map +1 -0
  54. package/dist/compose/hcl.js +302 -0
  55. package/dist/compose/module-address.d.ts +24 -0
  56. package/dist/compose/module-address.d.ts.map +1 -0
  57. package/dist/compose/module-address.js +43 -0
  58. package/dist/compose/root.d.ts +127 -0
  59. package/dist/compose/root.d.ts.map +1 -0
  60. package/dist/compose/root.js +586 -0
  61. package/dist/compose/run.d.ts +183 -0
  62. package/dist/compose/run.d.ts.map +1 -0
  63. package/dist/compose/run.js +447 -0
  64. package/dist/compose/slice.d.ts +102 -0
  65. package/dist/compose/slice.d.ts.map +1 -0
  66. package/dist/compose/slice.js +249 -0
  67. package/dist/compose/state-address.d.ts +28 -0
  68. package/dist/compose/state-address.d.ts.map +1 -0
  69. package/dist/compose/state-address.js +154 -0
  70. package/dist/compose/state-merge.d.ts +52 -0
  71. package/dist/compose/state-merge.d.ts.map +1 -0
  72. package/dist/compose/state-merge.js +135 -0
  73. package/dist/compose.d.ts +179 -0
  74. package/dist/compose.d.ts.map +1 -0
  75. package/dist/compose.js +482 -0
  76. package/dist/composites/terraform-apply-op.d.ts.map +1 -1
  77. package/dist/composites/terraform-apply-op.js +7 -3
  78. package/dist/cone.d.ts +53 -0
  79. package/dist/cone.d.ts.map +1 -0
  80. package/dist/cone.js +119 -0
  81. package/dist/config.d.ts +59 -13
  82. package/dist/config.d.ts.map +1 -1
  83. package/dist/config.js +43 -9
  84. package/dist/cost-hold.d.ts +27 -0
  85. package/dist/cost-hold.d.ts.map +1 -0
  86. package/dist/cost-hold.js +21 -0
  87. package/dist/describe-resources.d.ts +74 -12
  88. package/dist/describe-resources.d.ts.map +1 -1
  89. package/dist/describe-resources.js +374 -66
  90. package/dist/drift-read.d.ts +33 -0
  91. package/dist/drift-read.d.ts.map +1 -0
  92. package/dist/drift-read.js +243 -0
  93. package/dist/drift-record.d.ts +147 -0
  94. package/dist/drift-record.d.ts.map +1 -0
  95. package/dist/drift-record.js +383 -0
  96. package/dist/drift-rows.d.ts +61 -0
  97. package/dist/drift-rows.d.ts.map +1 -0
  98. package/dist/drift-rows.js +108 -0
  99. package/dist/exit-codes.d.ts +55 -0
  100. package/dist/exit-codes.d.ts.map +1 -0
  101. package/dist/exit-codes.js +48 -0
  102. package/dist/hcl/edges.d.ts.map +1 -1
  103. package/dist/hcl/edges.js +24 -1
  104. package/dist/hcl/files.d.ts +61 -0
  105. package/dist/hcl/files.d.ts.map +1 -0
  106. package/dist/hcl/files.js +221 -0
  107. package/dist/hcl/instances.d.ts +82 -0
  108. package/dist/hcl/instances.d.ts.map +1 -0
  109. package/dist/hcl/instances.js +390 -0
  110. package/dist/hcl/parse.d.ts +81 -9
  111. package/dist/hcl/parse.d.ts.map +1 -1
  112. package/dist/hcl/parse.js +114 -16
  113. package/dist/hcl/roots.d.ts.map +1 -1
  114. package/dist/hcl/roots.js +5 -0
  115. package/dist/hcl/suppressions.d.ts.map +1 -1
  116. package/dist/hcl/suppressions.js +8 -2
  117. package/dist/index.d.ts +13 -2
  118. package/dist/index.d.ts.map +1 -1
  119. package/dist/index.js +24 -2
  120. package/dist/integrity.json +8 -5
  121. package/dist/lint/audit-catalog.d.ts.map +1 -1
  122. package/dist/lint/audit-catalog.js +27 -3
  123. package/dist/lint/audit-lineage.d.ts +14 -2
  124. package/dist/lint/audit-lineage.d.ts.map +1 -1
  125. package/dist/lint/post-synth/index.d.ts.map +1 -1
  126. package/dist/lint/post-synth/index.js +4 -0
  127. package/dist/lint/post-synth/record-store.d.ts +54 -0
  128. package/dist/lint/post-synth/record-store.d.ts.map +1 -0
  129. package/dist/lint/post-synth/record-store.js +104 -0
  130. package/dist/lint/post-synth/tf001.d.ts +2 -2
  131. package/dist/lint/post-synth/tf001.js +2 -2
  132. package/dist/lint/post-synth/tf024.d.ts +35 -11
  133. package/dist/lint/post-synth/tf024.d.ts.map +1 -1
  134. package/dist/lint/post-synth/tf024.js +92 -20
  135. package/dist/lint/post-synth/tf046.d.ts +64 -0
  136. package/dist/lint/post-synth/tf046.d.ts.map +1 -0
  137. package/dist/lint/post-synth/tf046.js +175 -0
  138. package/dist/lint/post-synth/tf047.d.ts +36 -0
  139. package/dist/lint/post-synth/tf047.d.ts.map +1 -0
  140. package/dist/lint/post-synth/tf047.js +94 -0
  141. package/dist/live-plan-reasons.d.ts +21 -0
  142. package/dist/live-plan-reasons.d.ts.map +1 -0
  143. package/dist/live-plan-reasons.js +47 -0
  144. package/dist/lock-rows.d.ts +36 -0
  145. package/dist/lock-rows.d.ts.map +1 -0
  146. package/dist/lock-rows.js +60 -0
  147. package/dist/lock-timeout.d.ts +22 -0
  148. package/dist/lock-timeout.d.ts.map +1 -0
  149. package/dist/lock-timeout.js +32 -0
  150. package/dist/lsp/option-keys.d.ts.map +1 -1
  151. package/dist/lsp/option-keys.js +2 -0
  152. package/dist/manifest.json +1 -1
  153. package/dist/module-catalog/index.d.ts +69 -0
  154. package/dist/module-catalog/index.d.ts.map +1 -0
  155. package/dist/module-catalog/index.js +110 -0
  156. package/dist/module-catalog/refresh-cli.d.ts +4 -0
  157. package/dist/module-catalog/refresh-cli.d.ts.map +1 -0
  158. package/dist/module-catalog/refresh-cli.js +64 -0
  159. package/dist/module-catalog/static-tier.d.ts +6 -0
  160. package/dist/module-catalog/static-tier.d.ts.map +1 -0
  161. package/dist/module-catalog/static-tier.js +1650 -0
  162. package/dist/module-catalog/types.d.ts +65 -0
  163. package/dist/module-catalog/types.d.ts.map +1 -0
  164. package/dist/module-catalog/types.js +33 -0
  165. package/dist/okf/index.md +3 -1
  166. package/dist/okf/rules/TF024.md +2 -2
  167. package/dist/okf/rules/TF046.md +11 -0
  168. package/dist/okf/rules/TF047.md +11 -0
  169. package/dist/op/activities/index.d.ts +6 -2
  170. package/dist/op/activities/index.d.ts.map +1 -1
  171. package/dist/op/activities/index.js +5 -1
  172. package/dist/op/activities/live-detect.d.ts +4 -3
  173. package/dist/op/activities/live-detect.d.ts.map +1 -1
  174. package/dist/op/activities/live-detect.js +57 -32
  175. package/dist/op/activities/pin-rollout.d.ts +2 -0
  176. package/dist/op/activities/pin-rollout.d.ts.map +1 -1
  177. package/dist/op/activities/pin-rollout.js +1 -0
  178. package/dist/op/activities/terraform.d.ts +182 -5
  179. package/dist/op/activities/terraform.d.ts.map +1 -1
  180. package/dist/op/activities/terraform.js +224 -24
  181. package/dist/op/activity-contracts.d.ts +27 -0
  182. package/dist/op/activity-contracts.d.ts.map +1 -1
  183. package/dist/op/activity-contracts.js +19 -1
  184. package/dist/op/builders.d.ts +7 -1
  185. package/dist/op/builders.d.ts.map +1 -1
  186. package/dist/op/builders.js +9 -0
  187. package/dist/pin/consumers.d.ts +35 -0
  188. package/dist/pin/consumers.d.ts.map +1 -0
  189. package/dist/pin/consumers.js +70 -0
  190. package/dist/pin/edit.d.ts.map +1 -1
  191. package/dist/pin/edit.js +35 -0
  192. package/dist/pin/rollout.d.ts +2 -0
  193. package/dist/pin/rollout.d.ts.map +1 -1
  194. package/dist/pin/rollout.js +14 -11
  195. package/dist/plan-shape.d.ts +30 -0
  196. package/dist/plan-shape.d.ts.map +1 -0
  197. package/dist/plan-shape.js +125 -0
  198. package/dist/plugin.d.ts.map +1 -1
  199. package/dist/plugin.js +37 -18
  200. package/dist/registry/address.d.ts +63 -0
  201. package/dist/registry/address.d.ts.map +1 -0
  202. package/dist/registry/address.js +65 -0
  203. package/dist/registry/catalog-read.d.ts +14 -0
  204. package/dist/registry/catalog-read.d.ts.map +1 -0
  205. package/dist/registry/catalog-read.js +58 -0
  206. package/dist/registry/deprecated.d.ts +37 -0
  207. package/dist/registry/deprecated.d.ts.map +1 -0
  208. package/dist/registry/deprecated.js +43 -0
  209. package/dist/registry/docs.d.ts +96 -0
  210. package/dist/registry/docs.d.ts.map +1 -0
  211. package/dist/registry/docs.js +210 -0
  212. package/dist/registry/edge/edge.d.ts +46 -0
  213. package/dist/registry/edge/edge.d.ts.map +1 -0
  214. package/dist/registry/edge/edge.js +194 -0
  215. package/dist/registry/edge/index.d.ts +11 -0
  216. package/dist/registry/edge/index.d.ts.map +1 -0
  217. package/dist/registry/edge/index.js +10 -0
  218. package/dist/registry/edge/lambda-edge.d.ts +76 -0
  219. package/dist/registry/edge/lambda-edge.d.ts.map +1 -0
  220. package/dist/registry/edge/lambda-edge.js +95 -0
  221. package/dist/registry/edge/sigv4-web.d.ts +33 -0
  222. package/dist/registry/edge/sigv4-web.d.ts.map +1 -0
  223. package/dist/registry/edge/sigv4-web.js +56 -0
  224. package/dist/registry/edge/token-source.d.ts +73 -0
  225. package/dist/registry/edge/token-source.d.ts.map +1 -0
  226. package/dist/registry/edge/token-source.js +115 -0
  227. package/dist/registry/edge/worker.d.ts +45 -0
  228. package/dist/registry/edge/worker.d.ts.map +1 -0
  229. package/dist/registry/edge/worker.js +26 -0
  230. package/dist/registry/handler.d.ts +25 -0
  231. package/dist/registry/handler.d.ts.map +1 -0
  232. package/dist/registry/handler.js +75 -0
  233. package/dist/registry/headers-file.d.ts +21 -0
  234. package/dist/registry/headers-file.d.ts.map +1 -0
  235. package/dist/registry/headers-file.js +57 -0
  236. package/dist/registry/index.d.ts +31 -0
  237. package/dist/registry/index.d.ts.map +1 -0
  238. package/dist/registry/index.js +30 -0
  239. package/dist/registry/mirror-paths.d.ts +9 -0
  240. package/dist/registry/mirror-paths.d.ts.map +1 -0
  241. package/dist/registry/mirror-paths.js +8 -0
  242. package/dist/registry/mirror.d.ts +130 -0
  243. package/dist/registry/mirror.d.ts.map +1 -0
  244. package/dist/registry/mirror.js +319 -0
  245. package/dist/registry/proxies.d.ts +73 -0
  246. package/dist/registry/proxies.d.ts.map +1 -0
  247. package/dist/registry/proxies.js +111 -0
  248. package/dist/registry/reader.d.ts +57 -0
  249. package/dist/registry/reader.d.ts.map +1 -0
  250. package/dist/registry/reader.js +198 -0
  251. package/dist/registry/semver.d.ts +16 -0
  252. package/dist/registry/semver.d.ts.map +1 -0
  253. package/dist/registry/semver.js +24 -0
  254. package/dist/registry/serve.d.ts +24 -0
  255. package/dist/registry/serve.d.ts.map +1 -0
  256. package/dist/registry/serve.js +64 -0
  257. package/dist/registry/source-forms.d.ts +79 -0
  258. package/dist/registry/source-forms.d.ts.map +1 -0
  259. package/dist/registry/source-forms.js +202 -0
  260. package/dist/registry/targets/artifactory.d.ts +28 -0
  261. package/dist/registry/targets/artifactory.d.ts.map +1 -0
  262. package/dist/registry/targets/artifactory.js +206 -0
  263. package/dist/registry/targets/fake-artifactory.d.ts +30 -0
  264. package/dist/registry/targets/fake-artifactory.d.ts.map +1 -0
  265. package/dist/registry/targets/fake-artifactory.js +142 -0
  266. package/dist/registry/targets/fake-gitlab.d.ts +39 -0
  267. package/dist/registry/targets/fake-gitlab.d.ts.map +1 -0
  268. package/dist/registry/targets/fake-gitlab.js +136 -0
  269. package/dist/registry/targets/fake-hcp.d.ts +50 -0
  270. package/dist/registry/targets/fake-hcp.d.ts.map +1 -0
  271. package/dist/registry/targets/fake-hcp.js +202 -0
  272. package/dist/registry/targets/fake-http.d.ts +31 -0
  273. package/dist/registry/targets/fake-http.d.ts.map +1 -0
  274. package/dist/registry/targets/fake-http.js +87 -0
  275. package/dist/registry/targets/fake-nexus.d.ts +27 -0
  276. package/dist/registry/targets/fake-nexus.d.ts.map +1 -0
  277. package/dist/registry/targets/fake-nexus.js +137 -0
  278. package/dist/registry/targets/gitlab.d.ts +53 -0
  279. package/dist/registry/targets/gitlab.d.ts.map +1 -0
  280. package/dist/registry/targets/gitlab.js +187 -0
  281. package/dist/registry/targets/hcp.d.ts +29 -0
  282. package/dist/registry/targets/hcp.d.ts.map +1 -0
  283. package/dist/registry/targets/hcp.js +310 -0
  284. package/dist/registry/targets/hosted.d.ts +62 -0
  285. package/dist/registry/targets/hosted.d.ts.map +1 -0
  286. package/dist/registry/targets/hosted.js +74 -0
  287. package/dist/registry/targets/index.d.ts +18 -0
  288. package/dist/registry/targets/index.d.ts.map +1 -0
  289. package/dist/registry/targets/index.js +17 -0
  290. package/dist/registry/targets/module-target.d.ts +68 -0
  291. package/dist/registry/targets/module-target.d.ts.map +1 -0
  292. package/dist/registry/targets/module-target.js +63 -0
  293. package/dist/registry/targets/nexus.d.ts +43 -0
  294. package/dist/registry/targets/nexus.d.ts.map +1 -0
  295. package/dist/registry/targets/nexus.js +250 -0
  296. package/dist/registry/targets/zip.d.ts +55 -0
  297. package/dist/registry/targets/zip.d.ts.map +1 -0
  298. package/dist/registry/targets/zip.js +278 -0
  299. package/dist/registry/writer.d.ts +101 -0
  300. package/dist/registry/writer.d.ts.map +1 -0
  301. package/dist/registry/writer.js +109 -0
  302. package/dist/report.d.ts +15 -6
  303. package/dist/report.d.ts.map +1 -1
  304. package/dist/report.js +28 -55
  305. package/dist/rules/record-store.ts +122 -0
  306. package/dist/rules/tf001.ts +2 -2
  307. package/dist/rules/tf024.ts +105 -22
  308. package/dist/rules/tf046.ts +204 -0
  309. package/dist/rules/tf047.ts +114 -0
  310. package/dist/skills/chant-terraform.md +1 -1
  311. package/dist/state/azure-blob.d.ts +9 -0
  312. package/dist/state/azure-blob.d.ts.map +1 -0
  313. package/dist/state/azure-blob.js +8 -0
  314. package/dist/state/backend.d.ts +158 -0
  315. package/dist/state/backend.d.ts.map +1 -0
  316. package/dist/state/backend.js +406 -0
  317. package/dist/state/exec.d.ts +39 -0
  318. package/dist/state/exec.d.ts.map +1 -0
  319. package/dist/state/exec.js +80 -0
  320. package/dist/state/gcs.d.ts +8 -0
  321. package/dist/state/gcs.d.ts.map +1 -0
  322. package/dist/state/gcs.js +7 -0
  323. package/dist/state/index.d.ts +15 -0
  324. package/dist/state/index.d.ts.map +1 -0
  325. package/dist/state/index.js +14 -0
  326. package/dist/state/locks.d.ts +105 -0
  327. package/dist/state/locks.d.ts.map +1 -0
  328. package/dist/state/locks.js +130 -0
  329. package/dist/state/object-store.d.ts +8 -0
  330. package/dist/state/object-store.d.ts.map +1 -0
  331. package/dist/state/object-store.js +7 -0
  332. package/dist/state/root-states.d.ts +131 -0
  333. package/dist/state/root-states.d.ts.map +1 -0
  334. package/dist/state/root-states.js +241 -0
  335. package/dist/state/s3.d.ts +21 -0
  336. package/dist/state/s3.d.ts.map +1 -0
  337. package/dist/state/s3.js +19 -0
  338. package/dist/state/store.d.ts +51 -0
  339. package/dist/state/store.d.ts.map +1 -0
  340. package/dist/state/store.js +185 -0
  341. package/dist/state-ops.d.ts +255 -0
  342. package/dist/state-ops.d.ts.map +1 -0
  343. package/dist/state-ops.js +305 -0
  344. package/dist/state-reads.d.ts +57 -0
  345. package/dist/state-reads.d.ts.map +1 -0
  346. package/dist/state-reads.js +104 -0
  347. package/dist/terragrunt/affected.d.ts.map +1 -1
  348. package/dist/terragrunt/affected.js +2 -1
  349. package/dist/used-sources.d.ts +54 -0
  350. package/dist/used-sources.d.ts.map +1 -0
  351. package/dist/used-sources.js +157 -0
  352. package/package.json +24 -4
  353. package/src/__fixtures__/ACCEPTANCE.md +69 -7
  354. package/src/__fixtures__/compose/apply-failed-in-app.jsonl +12 -0
  355. package/src/__fixtures__/compose/state-app.json +66 -0
  356. package/src/__fixtures__/compose/state-edge.json +40 -0
  357. package/src/__fixtures__/compose/state-net.json +58 -0
  358. package/src/__fixtures__/compose/three-app.plan.json +184 -0
  359. package/src/__fixtures__/compose/three-composed.plan.json +509 -0
  360. package/src/__fixtures__/compose/three-edge.plan.json +144 -0
  361. package/src/__fixtures__/compose/three-net.plan.json +174 -0
  362. package/src/__fixtures__/compose/unknown-composed.plan.json +228 -0
  363. package/src/__fixtures__/compose/working-after-apply.json +145 -0
  364. package/src/__fixtures__/config-blocks/app/main.tf +61 -0
  365. package/src/__fixtures__/config-blocks/app/modules/network/main.tf +4 -0
  366. package/src/__fixtures__/config-blocks/app-json/main.tf.json +39 -0
  367. package/src/__fixtures__/config-files/shadow/main.tf +3 -0
  368. package/src/__fixtures__/config-files/shadow/main.tofu +3 -0
  369. package/src/__fixtures__/config-files/shadow/other.tf +3 -0
  370. package/src/__fixtures__/config-files/tf/main.tf +11 -0
  371. package/src/__fixtures__/config-files/tf-json/main.tf.json +18 -0
  372. package/src/__fixtures__/config-files/tofu/main.tofu +11 -0
  373. package/src/__fixtures__/config-files/tofu-json/main.tofu.json +18 -0
  374. package/src/__fixtures__/config-files/tofu-only/main.tofu +3 -0
  375. package/src/__fixtures__/drift-record/README.md +16 -0
  376. package/src/__fixtures__/drift-record/live-plan-sections.json +27 -0
  377. package/src/__fixtures__/drift-rows/live-root-plan.json +70 -0
  378. package/src/__fixtures__/drift-rows/refresh-plan.json +61 -0
  379. package/src/__fixtures__/instance-forms/app/main.tf +110 -0
  380. package/src/__fixtures__/instance-forms/app/modules/svc/main.tf +3 -0
  381. package/src/__fixtures__/instance-vars/app/main.tf +52 -0
  382. package/src/__fixtures__/instance-vars/app/modules/app/main.tf +12 -0
  383. package/src/__fixtures__/instance-vars/app/modules/edge/main.tf +3 -0
  384. package/src/__fixtures__/instance-vars/app/terraform.tfvars +1 -0
  385. package/src/__fixtures__/live-module-keyed/live-graph.json +259 -0
  386. package/src/__fixtures__/live-module-keyed/live-plan.json +87 -0
  387. package/src/__fixtures__/live-module-keyed/root/estate.chdf.hcl +1 -0
  388. package/src/__fixtures__/live-module-keyed/root/main.tf +21 -0
  389. package/src/__fixtures__/live-module-keyed/root/modules/app/main.tf +17 -0
  390. package/src/__fixtures__/live-module-keyed/root/modules/edge/main.tf +7 -0
  391. package/src/__fixtures__/live-module-keyed/root/versions.tf +30 -0
  392. package/src/__fixtures__/live-module-keyed/show-state.json +146 -0
  393. package/src/__fixtures__/pr-loop/README.md +50 -0
  394. package/src/__fixtures__/pr-loop/chant.config.json +13 -0
  395. package/src/__fixtures__/pr-loop/estate.component.ts +10 -0
  396. package/src/__fixtures__/pr-loop/roots/a/main.tf +11 -0
  397. package/src/__fixtures__/pr-loop/roots/app/main.tf +19 -0
  398. package/src/__fixtures__/pr-loop/roots/b/main.tf +7 -0
  399. package/src/__fixtures__/pr-loop/roots/dns/main.tf +3 -0
  400. package/src/__fixtures__/pr-loop/roots/net/main.tf +7 -0
  401. package/src/__fixtures__/report/applied.show.json +51 -0
  402. package/src/__fixtures__/report/generate.ts +63 -0
  403. package/src/__fixtures__/report/plan.show.json +200 -0
  404. package/src/__fixtures__/report/tf-apply/change-set.json +170 -0
  405. package/src/__fixtures__/report/tf-apply/report.json +338 -0
  406. package/src/__fixtures__/report/tf-plan/change-set.json +170 -0
  407. package/src/__fixtures__/report/tf-plan/report.json +320 -0
  408. package/src/__fixtures__/three-cloud-azure.graph.json +290 -0
  409. package/src/__fixtures__/used-sources/root/extra.tofu +1 -0
  410. package/src/__fixtures__/used-sources/root/main.tf +31 -0
  411. package/src/__fixtures__/used-sources/root/modules/net/main.tf +14 -0
  412. package/src/__fixtures__/used-sources/root/modules/net/versions.tf.json +7 -0
  413. package/src/__fixtures__/used-sources/unit/terragrunt.hcl +3 -0
  414. package/src/applied-state.ts +52 -0
  415. package/src/backend-config.test.ts +105 -0
  416. package/src/backend-config.ts +133 -0
  417. package/src/behaviour/kinds.ts +4 -0
  418. package/src/behaviour/predict.ts +5 -2
  419. package/src/behaviour/reference-catalog.plugin.test.ts +65 -0
  420. package/src/behaviour/reference-catalog.ts +16 -5
  421. package/src/behaviour/request.ts +3 -2
  422. package/src/change-set-instances.test.ts +98 -0
  423. package/src/changed-roots.ts +14 -16
  424. package/src/ci-setup.ts +42 -0
  425. package/src/commands.ts +4 -3
  426. package/src/components/capability-plugin.test.ts +198 -19
  427. package/src/components/capability-plugin.ts +383 -35
  428. package/src/components/change-set-graph.e2e.test.ts +11 -5
  429. package/src/components/compose-group.test.ts +486 -0
  430. package/src/components/compose-group.ts +489 -0
  431. package/src/components/demo-composed-roots.e2e.test.ts +440 -0
  432. package/src/components/member-outputs.test.ts +76 -0
  433. package/src/components/placeholder-preview.test.ts +147 -0
  434. package/src/components/placeholder-preview.ts +257 -0
  435. package/src/components/pr-loop-compose.tofu.e2e.test.ts +363 -0
  436. package/src/components/pr-loop.tofu.test.ts +113 -57
  437. package/src/components/release-inputs.ts +69 -0
  438. package/src/components/trace-facts.test.ts +21 -0
  439. package/src/components/trace-facts.ts +27 -0
  440. package/src/compose/apply-events.test.ts +62 -0
  441. package/src/compose/apply-events.ts +100 -0
  442. package/src/compose/estate.choudoufu.e2e.test.ts +112 -0
  443. package/src/compose/estate.test.ts +421 -0
  444. package/src/compose/estate.ts +443 -0
  445. package/src/compose/hcl.ts +311 -0
  446. package/src/compose/module-address.ts +49 -0
  447. package/src/compose/root.test.ts +416 -0
  448. package/src/compose/root.ts +592 -0
  449. package/src/compose/run.test.ts +440 -0
  450. package/src/compose/run.tofu.test.ts +176 -0
  451. package/src/compose/run.ts +527 -0
  452. package/src/compose/slice.test.ts +184 -0
  453. package/src/compose/slice.ts +290 -0
  454. package/src/compose/state-address.ts +157 -0
  455. package/src/compose/state-merge.test.ts +131 -0
  456. package/src/compose/state-merge.ts +148 -0
  457. package/src/compose.test.ts +248 -0
  458. package/src/compose.ts +627 -0
  459. package/src/composites/terraform-apply-op.test.ts +9 -0
  460. package/src/composites/terraform-apply-op.ts +7 -3
  461. package/src/cone.ts +138 -0
  462. package/src/config-file-listers.test.ts +265 -0
  463. package/src/config.ts +44 -9
  464. package/src/cost-hold.ts +29 -0
  465. package/src/describe-resources.engine-facts.test.ts +411 -0
  466. package/src/describe-resources.live-module-keyed.test.ts +290 -0
  467. package/src/describe-resources.ts +416 -70
  468. package/src/drift-read.ts +284 -0
  469. package/src/drift-record.test.ts +223 -0
  470. package/src/drift-record.ts +455 -0
  471. package/src/drift-rows.test.ts +135 -0
  472. package/src/drift-rows.ts +137 -0
  473. package/src/exit-codes.test.ts +23 -0
  474. package/src/exit-codes.ts +59 -0
  475. package/src/hcl/config-blocks.test.ts +174 -0
  476. package/src/hcl/edges.ts +21 -1
  477. package/src/hcl/files.ts +234 -0
  478. package/src/hcl/instance-forms.test.ts +94 -0
  479. package/src/hcl/instances.test.ts +137 -0
  480. package/src/hcl/instances.ts +422 -0
  481. package/src/hcl/parse.test.ts +139 -1
  482. package/src/hcl/parse.ts +149 -16
  483. package/src/hcl/roots.ts +6 -0
  484. package/src/hcl/suppressions.ts +8 -2
  485. package/src/index.ts +79 -0
  486. package/src/lint/audit-catalog.ts +29 -3
  487. package/src/lint/audit-lineage.ts +14 -2
  488. package/src/lint/post-synth/fixtures/TF024/live-with-record-store/main.tf +18 -0
  489. package/src/lint/post-synth/fixtures/TF024/sidecar-with-backend/estate.chdf.hcl +1 -0
  490. package/src/lint/post-synth/fixtures/TF024/sidecar-with-backend/main.tf +10 -0
  491. package/src/lint/post-synth/fixtures/TF046/azurerm-no-resource-group/main.tf +15 -0
  492. package/src/lint/post-synth/fixtures/TF046/backend-config-only/main.tf +14 -0
  493. package/src/lint/post-synth/fixtures/TF046/derived-s3/backend.tf +7 -0
  494. package/src/lint/post-synth/fixtures/TF046/derived-s3/main.tf +9 -0
  495. package/src/lint/post-synth/fixtures/TF046/explicit-local/main.tf +16 -0
  496. package/src/lint/post-synth/fixtures/TF046/explicit-s3-beside-local-backend/main.tf +15 -0
  497. package/src/lint/post-synth/fixtures/TF046/implied-local/main.tf +9 -0
  498. package/src/lint/post-synth/fixtures/TF046/sidecar-implied/estate.chdf.hcl +1 -0
  499. package/src/lint/post-synth/fixtures/TF046/sidecar-implied/main.tf +5 -0
  500. package/src/lint/post-synth/fixtures/TF047/clear/main.tf +12 -0
  501. package/src/lint/post-synth/fixtures/TF047/refused/main.tf +12 -0
  502. package/src/lint/post-synth/fixtures/TF047/unknown-module/main.tf +12 -0
  503. package/src/lint/post-synth/fixtures/TF047/unknown-version/main.tf +12 -0
  504. package/src/lint/post-synth/index.ts +4 -0
  505. package/src/lint/post-synth/record-store.ts +122 -0
  506. package/src/lint/post-synth/tf001.ts +2 -2
  507. package/src/lint/post-synth/tf024.test.ts +26 -5
  508. package/src/lint/post-synth/tf024.ts +105 -22
  509. package/src/lint/post-synth/tf046.test.ts +137 -0
  510. package/src/lint/post-synth/tf046.ts +204 -0
  511. package/src/lint/post-synth/tf047.test.ts +56 -0
  512. package/src/lint/post-synth/tf047.ts +114 -0
  513. package/src/live-plan-reasons.ts +54 -0
  514. package/src/lock-rows.test.ts +70 -0
  515. package/src/lock-rows.ts +82 -0
  516. package/src/lock-timeout.ts +34 -0
  517. package/src/lsp/completions.test.ts +1 -1
  518. package/src/lsp/option-keys.ts +2 -0
  519. package/src/module-catalog/index.test.ts +93 -0
  520. package/src/module-catalog/index.ts +159 -0
  521. package/src/module-catalog/refresh-cli.ts +68 -0
  522. package/src/module-catalog/static-tier.ts +1659 -0
  523. package/src/module-catalog/types.ts +88 -0
  524. package/src/op/activities/choudoufu-plan-set-op.test.ts +111 -0
  525. package/src/op/activities/index.ts +9 -0
  526. package/src/op/activities/live-detect.ts +55 -26
  527. package/src/op/activities/pin-rollout.ts +3 -0
  528. package/src/op/activities/registry.test.ts +2 -1
  529. package/src/op/activities/terraform.test.ts +55 -0
  530. package/src/op/activities/terraform.ts +312 -27
  531. package/src/op/activity-contracts.test.ts +1 -0
  532. package/src/op/activity-contracts.ts +24 -1
  533. package/src/op/builders.ts +14 -0
  534. package/src/op-wave-step.test.ts +109 -0
  535. package/src/pin/__fixtures__/consumers/live/dev/main.tf +4 -0
  536. package/src/pin/__fixtures__/consumers/live/prod/main.tf +21 -0
  537. package/src/pin/__fixtures__/consumers/units/vpc/terragrunt.hcl +7 -0
  538. package/src/pin/bundle.test.ts +2 -0
  539. package/src/pin/consumers.test.ts +57 -0
  540. package/src/pin/consumers.ts +95 -0
  541. package/src/pin/edit.ts +30 -0
  542. package/src/pin/rollout.ts +16 -11
  543. package/src/plan-shape.test.ts +148 -0
  544. package/src/plan-shape.ts +128 -0
  545. package/src/plugin.ts +39 -19
  546. package/src/registry/__fixtures__/docs/documented/.terraform-docs.yml +3 -0
  547. package/src/registry/__fixtures__/docs/documented/README.md +1 -0
  548. package/src/registry/__fixtures__/docs/documented/main.tf +8 -0
  549. package/src/registry/__fixtures__/docs/json/main.tf.json +14 -0
  550. package/src/registry/__fixtures__/docs/vpc/README.md +3 -0
  551. package/src/registry/__fixtures__/docs/vpc/examples/complete/main.tf +5 -0
  552. package/src/registry/__fixtures__/docs/vpc/examples/simple/README.md +1 -0
  553. package/src/registry/__fixtures__/docs/vpc/examples/simple/main.tf +4 -0
  554. package/src/registry/__fixtures__/docs/vpc/main.tf +14 -0
  555. package/src/registry/__fixtures__/docs/vpc/outputs.tf +9 -0
  556. package/src/registry/__fixtures__/docs/vpc/variables.tf +16 -0
  557. package/src/registry/__fixtures__/proxied-root/main.tf +12 -0
  558. package/src/registry/address.ts +100 -0
  559. package/src/registry/catalog-read.ts +56 -0
  560. package/src/registry/deprecated.test.ts +139 -0
  561. package/src/registry/deprecated.ts +76 -0
  562. package/src/registry/docs.test.ts +140 -0
  563. package/src/registry/docs.ts +299 -0
  564. package/src/registry/edge/bundle.test.ts +50 -0
  565. package/src/registry/edge/edge.test.ts +176 -0
  566. package/src/registry/edge/edge.ts +211 -0
  567. package/src/registry/edge/index.ts +10 -0
  568. package/src/registry/edge/lambda-edge.ts +127 -0
  569. package/src/registry/edge/sigv4-web.ts +79 -0
  570. package/src/registry/edge/token-source.test.ts +258 -0
  571. package/src/registry/edge/token-source.ts +169 -0
  572. package/src/registry/edge/worker.ts +61 -0
  573. package/src/registry/handler.ts +89 -0
  574. package/src/registry/headers-file.ts +61 -0
  575. package/src/registry/index.ts +31 -0
  576. package/src/registry/mirror-paths.ts +10 -0
  577. package/src/registry/mirror.test.ts +198 -0
  578. package/src/registry/mirror.ts +395 -0
  579. package/src/registry/proxies.test.ts +153 -0
  580. package/src/registry/proxies.ts +132 -0
  581. package/src/registry/reader.ts +225 -0
  582. package/src/registry/registry.test.ts +262 -0
  583. package/src/registry/semver.ts +34 -0
  584. package/src/registry/serve.ts +82 -0
  585. package/src/registry/source-forms.test.ts +87 -0
  586. package/src/registry/source-forms.ts +216 -0
  587. package/src/registry/targets/artifactory.test.ts +248 -0
  588. package/src/registry/targets/artifactory.ts +257 -0
  589. package/src/registry/targets/fake-artifactory.ts +158 -0
  590. package/src/registry/targets/fake-gitlab.ts +161 -0
  591. package/src/registry/targets/fake-hcp.ts +233 -0
  592. package/src/registry/targets/fake-http.ts +97 -0
  593. package/src/registry/targets/fake-nexus.ts +152 -0
  594. package/src/registry/targets/gitlab.test.ts +208 -0
  595. package/src/registry/targets/gitlab.ts +223 -0
  596. package/src/registry/targets/hcp.test.ts +230 -0
  597. package/src/registry/targets/hcp.ts +360 -0
  598. package/src/registry/targets/hosted.ts +117 -0
  599. package/src/registry/targets/index.ts +17 -0
  600. package/src/registry/targets/module-target.ts +131 -0
  601. package/src/registry/targets/nexus.test.ts +220 -0
  602. package/src/registry/targets/nexus.ts +314 -0
  603. package/src/registry/targets/zip.test.ts +65 -0
  604. package/src/registry/targets/zip.ts +287 -0
  605. package/src/registry/writer.ts +155 -0
  606. package/src/report.test.ts +82 -1
  607. package/src/report.ts +31 -54
  608. package/src/signal-only-root.test.ts +72 -0
  609. package/src/skills/chant-terraform.md +1 -1
  610. package/src/state/azure-blob.ts +8 -0
  611. package/src/state/backend-verdict.test.ts +187 -0
  612. package/src/state/backend.test.ts +127 -0
  613. package/src/state/backend.ts +488 -0
  614. package/src/state/exec.ts +111 -0
  615. package/src/state/gcs.ts +7 -0
  616. package/src/state/index.ts +15 -0
  617. package/src/state/locks.test.ts +84 -0
  618. package/src/state/locks.ts +201 -0
  619. package/src/state/object-store.ts +7 -0
  620. package/src/state/root-states-floci.e2e.test.ts +66 -0
  621. package/src/state/root-states.test.ts +462 -0
  622. package/src/state/root-states.ts +309 -0
  623. package/src/state/s3.ts +21 -0
  624. package/src/state/store.ts +225 -0
  625. package/src/state-ops.test.ts +182 -0
  626. package/src/state-ops.ts +462 -0
  627. package/src/state-reads.ts +116 -0
  628. package/src/terragrunt/affected.ts +2 -1
  629. package/src/used-sources.test.ts +75 -0
  630. package/src/used-sources.ts +204 -0
  631. package/src/workspace-kinds.test.ts +4 -17
  632. package/workspace-kinds.json +1 -24
  633. package/dist/workspace-member.d.ts +0 -30
  634. package/dist/workspace-member.d.ts.map +0 -1
  635. package/dist/workspace-member.js +0 -91
  636. package/schemas/pulumi.schema.json +0 -34
  637. package/src/testdata/pulumi-member/Pulumi.yaml +0 -2
  638. package/src/testdata/pulumi-member/stack-export.json +0 -53
  639. package/src/testdata/pulumi-unexported/Pulumi.yaml +0 -2
  640. package/src/workspace-member.test.ts +0 -89
  641. package/src/workspace-member.ts +0 -126
@@ -0,0 +1,262 @@
1
+ // The module registry protocol moved from terragucci (chant#4565), with the download answer Terraform
2
+ // installs from (terragucci#1287): the JSON body stays, X-Terraform-Get carries the same location.
3
+ import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
4
+ import { tmpdir } from "node:os";
5
+ import { dirname, join } from "node:path";
6
+ import { gzipSync } from "node:zlib";
7
+ import { describe, expect, it } from "vitest";
8
+ import {
9
+ DOWNLOAD_HEADER,
10
+ RegistryError,
11
+ RegistryNameError,
12
+ dirFiles,
13
+ downloadAnswer,
14
+ downloadDoc,
15
+ fetchTarball,
16
+ handlerFetch,
17
+ isDownloadPath,
18
+ keyFor,
19
+ newest,
20
+ parseRegistrySource,
21
+ parseSemver,
22
+ readVersions,
23
+ registryAddress,
24
+ registryHandler,
25
+ registryLocation,
26
+ registryVersions,
27
+ serveRegistry,
28
+ storeFiles,
29
+ tarballName,
30
+ versionsDoc,
31
+ writeVersion,
32
+ type RegistryFetch,
33
+ type RegistryWriteStore,
34
+ } from "./index";
35
+
36
+ const REG = { url: "https://modules.test", namespace: "acme" };
37
+
38
+ function memoryStore(): RegistryWriteStore & { objects: Map<string, { body: string | Buffer; etag: string }>; puts: string[] } {
39
+ const objects = new Map<string, { body: string | Buffer; etag: string }>();
40
+ const puts: string[] = [];
41
+ let n = 0;
42
+ return {
43
+ objects,
44
+ puts,
45
+ async put(key, body) {
46
+ puts.push(key);
47
+ objects.set(key, { body, etag: `"${++n}"` });
48
+ return {};
49
+ },
50
+ async read(key) {
51
+ const o = objects.get(key);
52
+ return o ? { body: typeof o.body === "string" ? o.body : o.body.toString("utf-8"), etag: o.etag } : {};
53
+ },
54
+ };
55
+ }
56
+
57
+ /** Serves a store's files as a bucket would: no headers per object. */
58
+ const staticFetch = (objects: Map<string, { body: string | Buffer }>): RegistryFetch => async (url) => {
59
+ const key = new URL(url).pathname.replace(/^\//, "");
60
+ const o = objects.get(key);
61
+ return o ? new Response(typeof o.body === "string" ? o.body : new Uint8Array(o.body), { status: 200 }) : new Response(null, { status: 404 });
62
+ };
63
+
64
+ async function publishOne(store: RegistryWriteStore, version = "0.1.0", prefix?: string) {
65
+ const addr = registryAddress(REG, "modules/net");
66
+ const v = parseSemver(version)!;
67
+ const location = `${REG.url}/${addr.path}/${version}/${tarballName(addr, version)}`;
68
+ await writeVersion(
69
+ store,
70
+ addr,
71
+ v,
72
+ {
73
+ tarball: { key: keyFor(prefix, `${addr.path}/${version}/${tarballName(addr, version)}`), body: gzipSync(Buffer.from("module bytes")) },
74
+ download: { key: keyFor(prefix, `${addr.path}/${version}/download`), body: downloadDoc(location) },
75
+ meta: { key: keyFor(prefix, `${addr.path}/${version}/release.json`), body: JSON.stringify({ module: "modules/net", version, revision: "abc", content: "sha256:x", location }) },
76
+ },
77
+ { prefix },
78
+ );
79
+ return { addr, location };
80
+ }
81
+
82
+ describe("addresses", () => {
83
+ it("places a module by its path, the longest namespace prefix winning", () => {
84
+ const reg = { ...REG, namespaces: { "platform/": "plat", "platform/net": "netw" } };
85
+ expect(registryAddress(reg, "modules/net")).toEqual({ namespace: "acme", name: "net", system: "generic", source: "modules.test/acme/net/generic", path: "v1/modules/acme/net/generic" });
86
+ expect(registryAddress(reg, "platform/db").namespace).toBe("plat");
87
+ expect(registryAddress(reg, "platform/net").namespace).toBe("netw");
88
+ expect(() => registryAddress(REG, "modules/net.v2")).toThrow(RegistryNameError);
89
+ });
90
+
91
+ it("parses registry sources and leaves other sources alone", () => {
92
+ expect(parseRegistrySource("127.0.0.1:8443/acme/network/generic")).toEqual({ host: "127.0.0.1:8443", namespace: "acme", name: "network", system: "generic" });
93
+ expect(parseRegistrySource("Modules.Test/acme/net/aws//sub?ref=x")?.host).toBe("modules.test");
94
+ expect(parseRegistrySource("hashicorp/consul/aws")).toBeUndefined();
95
+ expect(parseRegistrySource("git::https://example.com/x.git")).toBeUndefined();
96
+ });
97
+
98
+ it("keys files under a prefix", () => {
99
+ expect(keyFor("/registry/", "v1/x")).toBe("registry/v1/x");
100
+ expect(keyFor(undefined, "v1/x")).toBe("v1/x");
101
+ });
102
+ });
103
+
104
+ describe("writer", () => {
105
+ it("writes discovery, the tarball, download, release.json, then the version list", async () => {
106
+ const mem = memoryStore();
107
+ await publishOne(mem);
108
+ expect(mem.puts).toEqual([
109
+ ".well-known/terraform.json",
110
+ "v1/modules/acme/net/generic/0.1.0/net-0.1.0.tar.gz",
111
+ "v1/modules/acme/net/generic/0.1.0/download",
112
+ "v1/modules/acme/net/generic/0.1.0/release.json",
113
+ "v1/modules/acme/net/generic/versions",
114
+ ]);
115
+ await publishOne(mem, "0.2.0");
116
+ expect(readVersions((await mem.read("v1/modules/acme/net/generic/versions")).body)).toEqual(["0.1.0", "0.2.0"]);
117
+ expect(mem.puts.filter((k) => k === ".well-known/terraform.json")).toHaveLength(1);
118
+ });
119
+
120
+ it("retries the version list on a conflict from a store with its own conflict class", async () => {
121
+ class StoreConflict extends Error {}
122
+ const mem = memoryStore();
123
+ let fail = 1;
124
+ const store: RegistryWriteStore = {
125
+ read: mem.read,
126
+ async put(key, body, type, when) {
127
+ if (key.endsWith("/versions") && fail-- > 0) throw new StoreConflict("412");
128
+ return mem.put(key, body, type, when);
129
+ },
130
+ };
131
+ await publishOne(store);
132
+ expect(readVersions((await mem.read("v1/modules/acme/net/generic/versions")).body)).toEqual(["0.1.0"]);
133
+ });
134
+
135
+ it("sorts and dedupes versions, and picks the newest", () => {
136
+ expect(readVersions(versionsDoc(["1.0.0", "0.2.0", "v1.0.0", "nope"]))).toEqual(["0.2.0", "1.0.0"]);
137
+ expect(readVersions("not json")).toEqual([]);
138
+ expect(newest(["0.9.0", "0.10.0", "x"])).toEqual({ major: 0, minor: 10, patch: 0 });
139
+ });
140
+
141
+ it("answers a download with the JSON body and X-Terraform-Get, status 200", () => {
142
+ const a = downloadAnswer("https://modules.test/x.tar.gz");
143
+ expect(a.status).toBe(200);
144
+ expect(a.headers[DOWNLOAD_HEADER]).toBe("https://modules.test/x.tar.gz");
145
+ expect(JSON.parse(a.body)).toEqual({ location: "https://modules.test/x.tar.gz" });
146
+ expect(isDownloadPath("v1/modules/acme/net/generic/0.1.0/download")).toBe(true);
147
+ expect(isDownloadPath("registry/v1/modules/acme/net/generic/0.1.0/download")).toBe(true);
148
+ expect(isDownloadPath("v1/modules/acme/net/generic/versions")).toBe(false);
149
+ });
150
+ });
151
+
152
+ describe("reader", () => {
153
+ it("reads static files the way OpenTofu does, and refuses them the way Terraform does", async () => {
154
+ const mem = memoryStore();
155
+ const { location } = await publishOne(mem);
156
+ const fetch = staticFetch(mem.objects);
157
+ expect(await registryVersions("modules.test/acme/net/generic", fetch)).toEqual(["0.1.0"]);
158
+ expect(await registryLocation("modules.test/acme/net/generic", "0.1.0", { fetch, reads: "tofu" })).toBe(location);
159
+ await expect(registryLocation("modules.test/acme/net/generic", "0.1.0", { fetch, reads: "terraform" })).rejects.toThrow("sends no X-Terraform-Get header");
160
+ await expect(registryLocation("modules.test/acme/net/generic", "9.0.0", fetch)).rejects.toThrow("has no version 9.0.0");
161
+ await expect(registryVersions("hashicorp/consul/aws", fetch)).rejects.toThrow(RegistryError);
162
+ });
163
+
164
+ it("reads the handler's answers under both CLIs, and fetches the tarball", async () => {
165
+ const mem = memoryStore();
166
+ const { location } = await publishOne(mem);
167
+ const log: string[] = [];
168
+ const fetch = handlerFetch(registryHandler(storeFiles({ read: async (k) => ({ body: mem.objects.get(k)?.body }) }), { log: (l) => log.push(l) }));
169
+ expect(await registryLocation("modules.test/acme/net/generic", "0.1.0", { fetch, reads: "terraform" })).toBe(location);
170
+ expect(await registryLocation("modules.test/acme/net/generic", "0.1.0", { fetch, reads: "tofu" })).toBe(location);
171
+ expect((await fetchTarball(location, fetch)).toString()).toBe("module bytes");
172
+ expect(log).toContain("GET /v1/modules/acme/net/generic/0.1.0/download -> 200");
173
+ });
174
+
175
+ it("reads a registry written under a prefix through the handler's prefix", async () => {
176
+ const mem = memoryStore();
177
+ await publishOne(mem, "0.1.0", "registry");
178
+ const fetch = handlerFetch(registryHandler(storeFiles({ read: async (k) => ({ body: mem.objects.get(k)?.body }) }), { prefix: "registry" }));
179
+ expect(await registryVersions("modules.test/acme/net/generic", fetch)).toEqual(["0.1.0"]);
180
+ });
181
+ });
182
+
183
+ describe("loopback server", () => {
184
+ it("serves a directory on 127.0.0.1 with the download header", async () => {
185
+ const root = mkdtempSync(join(tmpdir(), "chant-registry-"));
186
+ const mem = memoryStore();
187
+ await publishOne(mem);
188
+ for (const [key, o] of mem.objects) {
189
+ mkdirSync(dirname(join(root, key)), { recursive: true });
190
+ writeFileSync(join(root, key), o.body);
191
+ }
192
+ const served = await serveRegistry(registryHandler(dirFiles(root)));
193
+ try {
194
+ const res = await fetch(`${served.url}/v1/modules/acme/net/generic/0.1.0/download`);
195
+ expect(res.status).toBe(200);
196
+ expect(res.headers.get(DOWNLOAD_HEADER)).toBe("https://modules.test/v1/modules/acme/net/generic/0.1.0/net-0.1.0.tar.gz");
197
+ expect(await res.json()).toEqual({ location: "https://modules.test/v1/modules/acme/net/generic/0.1.0/net-0.1.0.tar.gz" });
198
+ expect((await fetch(`${served.url}/../etc/passwd`)).status).toBe(404);
199
+ expect(await registryVersions(`${served.host}/acme/net/generic`, { scheme: "http" })).toEqual(["0.1.0"]);
200
+ } finally {
201
+ await served.close();
202
+ }
203
+ });
204
+ });
205
+
206
+ describe("credentials (chant#4563)", () => {
207
+ /** A registry that refuses any request without the bearer token, as a private registry or the edge function with auth on does. */
208
+ const guarded = (mem: ReturnType<typeof memoryStore>, token: string, seen: (string | null)[]): RegistryFetch => {
209
+ const inner = handlerFetch(registryHandler(storeFiles({ read: async (k) => ({ body: mem.objects.get(k)?.body }) })));
210
+ return async (url, init) => {
211
+ const auth = new Headers(init?.headers).get("authorization");
212
+ seen.push(auth);
213
+ return auth === `Bearer ${token}` ? inner(url, init) : new Response(null, { status: 401 });
214
+ };
215
+ };
216
+
217
+ it("sends TF_TOKEN_<host> on discovery, versions and download", async () => {
218
+ const mem = memoryStore();
219
+ const { location } = await publishOne(mem);
220
+ const seen: (string | null)[] = [];
221
+ const fetch = guarded(mem, "s3cret", seen);
222
+ const credentials = { env: { TF_TOKEN_modules_test: "s3cret" }, readFile: () => undefined };
223
+ expect(await registryVersions("modules.test/acme/net/generic", { fetch, credentials })).toEqual(["0.1.0"]);
224
+ expect(await registryLocation("modules.test/acme/net/generic", "0.1.0", { fetch, credentials, reads: "terraform" })).toBe(location);
225
+ expect(seen).toHaveLength(4);
226
+ expect(seen.every((a) => a === "Bearer s3cret")).toBe(true);
227
+ });
228
+
229
+ it("reads the token from credentials.tfrc.json when no variable is set", async () => {
230
+ const mem = memoryStore();
231
+ await publishOne(mem);
232
+ const tfrc = join("/home/u", ".terraform.d", "credentials.tfrc.json");
233
+ const credentials = { env: { HOME: "/home/u" }, platform: "linux", readFile: (p: string) => (p === tfrc ? JSON.stringify({ credentials: { "modules.test": { token: "f1" } } }) : undefined) };
234
+ expect(await registryVersions("modules.test/acme/net/generic", { fetch: guarded(mem, "f1", []), credentials })).toEqual(["0.1.0"]);
235
+ });
236
+
237
+ it("names the variable to set when the registry wants a token, and never prints one", async () => {
238
+ const mem = memoryStore();
239
+ await publishOne(mem);
240
+ const none = { env: {}, readFile: () => undefined };
241
+ await expect(registryVersions("modules.test/acme/net/generic", { fetch: guarded(mem, "s3cret", []), credentials: none })).rejects.toThrow("set TF_TOKEN_modules_test");
242
+ const wrong = registryVersions("modules.test/acme/net/generic", { fetch: guarded(mem, "s3cret", []), token: "nope" });
243
+ await expect(wrong).rejects.toThrow("refused the token");
244
+ await expect(wrong).rejects.not.toThrow("nope");
245
+ });
246
+
247
+ it("sends no token when told not to, and none with a signed tarball URL", async () => {
248
+ const mem = memoryStore();
249
+ await publishOne(mem);
250
+ const seen: (string | null)[] = [];
251
+ await expect(registryVersions("modules.test/acme/net/generic", { fetch: guarded(mem, "s3cret", seen), token: false })).rejects.toThrow(RegistryError);
252
+ expect(seen).toEqual([null]);
253
+ const tarballSeen: (string | null)[] = [];
254
+ const probe: RegistryFetch = async (_url, init) => {
255
+ tarballSeen.push(new Headers(init?.headers).get("authorization"));
256
+ return new Response(new Uint8Array(gzipSync(Buffer.from("x"))), { status: 200 });
257
+ };
258
+ await fetchTarball("https://modules.test/x.tar.gz?expires=1&sig=abc", { fetch: probe, token: "s3cret" });
259
+ await fetchTarball("https://modules.test/x.tar.gz", { fetch: probe, token: "s3cret" });
260
+ expect(tarballSeen).toEqual([null, "Bearer s3cret"]);
261
+ });
262
+ });
@@ -0,0 +1,34 @@
1
+ /**
2
+ * The versions a module registry lists: plain `major.minor.patch`, with an
3
+ * optional leading `v` on input. Lifted from terragucci's `publish/semver.ts`
4
+ * (18f6431595), cut to what the registry protocol needs (chant#4565).
5
+ */
6
+
7
+ export interface Semver {
8
+ major: number;
9
+ minor: number;
10
+ patch: number;
11
+ }
12
+
13
+ const RE = /^v?(\d+)\.(\d+)\.(\d+)$/;
14
+
15
+ export function parseSemver(text: string): Semver | undefined {
16
+ const m = RE.exec(text.trim());
17
+ return m ? { major: +m[1]!, minor: +m[2]!, patch: +m[3]! } : undefined;
18
+ }
19
+
20
+ export const formatSemver = (v: Semver): string => `${v.major}.${v.minor}.${v.patch}`;
21
+
22
+ export function compareSemver(a: Semver, b: Semver): number {
23
+ return a.major - b.major || a.minor - b.minor || a.patch - b.patch;
24
+ }
25
+
26
+ /** The newest of a list of versions; entries that are not versions are skipped. */
27
+ export function newest(versions: string[]): Semver | undefined {
28
+ let best: Semver | undefined;
29
+ for (const v of versions) {
30
+ const p = parseSemver(v);
31
+ if (p && (!best || compareSemver(p, best) > 0)) best = p;
32
+ }
33
+ return best;
34
+ }
@@ -0,0 +1,82 @@
1
+ /**
2
+ * A registry's files on a loopback socket, for tests that run real
3
+ * `terraform init` and `tofu init` (terragucci#1287) and for a local preview.
4
+ * The answers come from `registryHandler` in ./handler; this file adds the
5
+ * directory reader and the Node server around it.
6
+ */
7
+ import { existsSync, readFileSync, statSync } from "node:fs";
8
+ import { createServer as createHttpServer, type IncomingMessage, type Server, type ServerResponse } from "node:http";
9
+ import { createServer as createHttpsServer } from "node:https";
10
+ import type { AddressInfo } from "node:net";
11
+ import { join, normalize, sep } from "node:path";
12
+ import type { RegistryFiles, RegistryHandler } from "./handler";
13
+
14
+ /** A registry written into a directory, read back as bytes. Keys that climb out of the directory read as missing. */
15
+ export function dirFiles(root: string): RegistryFiles {
16
+ const base = normalize(root);
17
+ return async (key) => {
18
+ const file = normalize(join(base, key));
19
+ if (file !== base && !file.startsWith(base.endsWith(sep) ? base : `${base}${sep}`)) return {};
20
+ if (!existsSync(file) || !statSync(file).isFile()) return {};
21
+ return { body: readFileSync(file) };
22
+ };
23
+ }
24
+
25
+ export interface ServeOptions {
26
+ /** Default 127.0.0.1. A loopback address keeps the registry off the network. */
27
+ hostname?: string;
28
+ /** Default 0, a free port. */
29
+ port?: number;
30
+ /** PEM key and certificate: the server speaks HTTPS, as both CLIs require for discovery. */
31
+ tls?: { key: string | Buffer; cert: string | Buffer };
32
+ }
33
+
34
+ export interface ServedRegistry {
35
+ /** `<scheme>://<hostname>:<port>`, no trailing slash. */
36
+ url: string;
37
+ /** `<hostname>:<port>`, the host a registry source names. */
38
+ host: string;
39
+ close(): Promise<void>;
40
+ }
41
+
42
+ const readBody = (req: IncomingMessage): Promise<Buffer> =>
43
+ new Promise((resolve, reject) => {
44
+ const chunks: Buffer[] = [];
45
+ req.on("data", (c: Buffer) => chunks.push(c));
46
+ req.on("end", () => resolve(Buffer.concat(chunks)));
47
+ req.on("error", reject);
48
+ });
49
+
50
+ /** Serves a handler on a local socket until `close`. */
51
+ export async function serveRegistry(handler: RegistryHandler, options: ServeOptions = {}): Promise<ServedRegistry> {
52
+ const hostname = options.hostname ?? "127.0.0.1";
53
+ const scheme = options.tls ? "https" : "http";
54
+ const listener = async (req: IncomingMessage, res: ServerResponse): Promise<void> => {
55
+ try {
56
+ const method = req.method ?? "GET";
57
+ const body = method === "GET" || method === "HEAD" ? undefined : await readBody(req);
58
+ const headers = new Headers();
59
+ for (const [k, v] of Object.entries(req.headers)) if (typeof v === "string") headers.set(k, v);
60
+ const answer = await handler(new Request(`${scheme}://${req.headers.host ?? hostname}${req.url ?? "/"}`, { method, headers, ...(body ? { body: new Uint8Array(body) } : {}) }));
61
+ const out: Record<string, string> = {};
62
+ answer.headers.forEach((v, k) => (out[k] = v));
63
+ res.writeHead(answer.status, out);
64
+ res.end(answer.body ? Buffer.from(await answer.arrayBuffer()) : undefined);
65
+ } catch (e) {
66
+ res.writeHead(500, { "content-type": "text/plain" });
67
+ res.end(String((e as Error).message));
68
+ }
69
+ };
70
+ const server: Server = options.tls ? createHttpsServer({ key: options.tls.key, cert: options.tls.cert }, (q, r) => void listener(q, r)) : createHttpServer((q, r) => void listener(q, r));
71
+ await new Promise<void>((resolve, reject) => {
72
+ server.once("error", reject);
73
+ server.listen(options.port ?? 0, hostname, () => resolve());
74
+ });
75
+ const { port } = server.address() as AddressInfo;
76
+ const host = `${hostname.includes(":") ? `[${hostname}]` : hostname}:${port}`;
77
+ return {
78
+ url: `${scheme}://${host}`,
79
+ host,
80
+ close: () => new Promise<void>((resolve, reject) => server.close((e) => (e ? reject(e) : resolve()))),
81
+ };
82
+ }
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Module sources and provider addresses in one normal form (chant#3924):
3
+ * the forms a source matches as, a provider's full address, the implied
4
+ * provider, and the lock file's addresses.
5
+ */
6
+ import { describe, expect, test } from "vitest";
7
+ import { impliedProvider, lockedProviders, moduleSourceForms, normalizeModuleSource, parseProviderAddress, providerAddress, providerAddressForms } from "./source-forms";
8
+
9
+ describe("moduleSourceForms", () => {
10
+ test("drops the query and adds a hostless source at both default registries", () => {
11
+ expect(moduleSourceForms("terraform-aws-modules/vpc/aws?ref=v1")).toEqual([
12
+ "terraform-aws-modules/vpc/aws",
13
+ "registry.terraform.io/terraform-aws-modules/vpc/aws",
14
+ "registry.opentofu.org/terraform-aws-modules/vpc/aws",
15
+ ]);
16
+ });
17
+
18
+ test("adds the hostless and other-registry forms of a source at a default registry", () => {
19
+ expect(moduleSourceForms("registry.opentofu.org/acme/vpc/aws")).toEqual(["registry.opentofu.org/acme/vpc/aws", "acme/vpc/aws", "registry.terraform.io/acme/vpc/aws"]);
20
+ });
21
+
22
+ test("reads Terragrunt's tfr forms", () => {
23
+ expect(moduleSourceForms("tfr:///acme/vpc/aws?version=1.0.0")).toEqual(["tfr:///acme/vpc/aws", "registry.terraform.io/acme/vpc/aws", "registry.opentofu.org/acme/vpc/aws", "acme/vpc/aws"]);
24
+ expect(moduleSourceForms("tfr://Registry.Acme.dev/acme/vpc/aws")).toEqual(["tfr://Registry.Acme.dev/acme/vpc/aws", "registry.acme.dev/acme/vpc/aws"]);
25
+ });
26
+
27
+ test("keeps a private registry, git, OCI and local source to its one form", () => {
28
+ expect(moduleSourceForms("registry.acme.dev/acme/vpc/aws")).toEqual(["registry.acme.dev/acme/vpc/aws"]);
29
+ expect(moduleSourceForms("git::https://git.acme.dev/net.git?ref=v1")).toEqual(["git::https://git.acme.dev/net.git"]);
30
+ expect(moduleSourceForms("oci://registry.acme.dev/modules/vpc?tag=1")).toEqual(["oci://registry.acme.dev/modules/vpc"]);
31
+ expect(moduleSourceForms("./modules/vpc")).toEqual(["./modules/vpc"]);
32
+ expect(moduleSourceForms("github.com/acme/vpc")).toEqual(["github.com/acme/vpc"]);
33
+ });
34
+ });
35
+
36
+ describe("normalizeModuleSource", () => {
37
+ test("gives the binary's registry to a hostless source and lower-cases a host", () => {
38
+ expect(normalizeModuleSource("acme/vpc/aws")).toBe("registry.terraform.io/acme/vpc/aws");
39
+ expect(normalizeModuleSource("acme/vpc/aws", "tofu")).toBe("registry.opentofu.org/acme/vpc/aws");
40
+ expect(normalizeModuleSource("Registry.Acme.dev/acme/vpc/aws//sub")).toBe("registry.acme.dev/acme/vpc/aws//sub");
41
+ expect(normalizeModuleSource("tfr:///acme/vpc/aws")).toBe("registry.terraform.io/acme/vpc/aws");
42
+ });
43
+ });
44
+
45
+ describe("providerAddress", () => {
46
+ test("gives the full lower-case form with the binary's default host", () => {
47
+ expect(providerAddress("hashicorp/AWS")).toBe("registry.terraform.io/hashicorp/aws");
48
+ expect(providerAddress("hashicorp/aws", "tofu")).toBe("registry.opentofu.org/hashicorp/aws");
49
+ expect(providerAddress("aws")).toBe("registry.terraform.io/hashicorp/aws");
50
+ expect(providerAddress("Registry.Acme.dev/acme/thing")).toBe("registry.acme.dev/acme/thing");
51
+ expect(parseProviderAddress("localhost:8080/acme/thing")).toEqual({ host: "localhost:8080", namespace: "acme", type: "thing", address: "localhost:8080/acme/thing" });
52
+ });
53
+
54
+ test("refuses what is not an address", () => {
55
+ expect(providerAddress("a/b/c/d")).toBeUndefined();
56
+ expect(providerAddress("hashicorp/")).toBeUndefined();
57
+ expect(providerAddress("bad host/acme/x")).toBeUndefined();
58
+ });
59
+
60
+ test("implies hashicorp/<name>, never for the binary's own provider", () => {
61
+ expect(impliedProvider("aws")).toBe("hashicorp/aws");
62
+ expect(impliedProvider("terraform")).toBeUndefined();
63
+ });
64
+
65
+ test("matches as written, hostless and at each default registry", () => {
66
+ expect(providerAddressForms("hashicorp/aws")).toEqual(["hashicorp/aws", "registry.terraform.io/hashicorp/aws", "registry.opentofu.org/hashicorp/aws"]);
67
+ expect(providerAddressForms("registry.terraform.io/hashicorp/aws")).toEqual(["registry.terraform.io/hashicorp/aws", "hashicorp/aws", "registry.opentofu.org/hashicorp/aws"]);
68
+ expect(providerAddressForms("registry.acme.dev/acme/x")).toEqual(["registry.acme.dev/acme/x"]);
69
+ });
70
+ });
71
+
72
+ describe("lockedProviders", () => {
73
+ test("lists each provider the lock file names, once", () => {
74
+ const lock = `# This file is maintained automatically by "terraform init".
75
+ provider "registry.terraform.io/hashicorp/aws" {
76
+ version = "5.0.0"
77
+ hashes = ["h1:x"]
78
+ }
79
+
80
+ provider "registry.opentofu.org/hashicorp/random" {
81
+ version = "3.6.0"
82
+ }
83
+ `;
84
+ expect(lockedProviders(lock)).toEqual(["registry.terraform.io/hashicorp/aws", "registry.opentofu.org/hashicorp/random"]);
85
+ expect(lockedProviders("")).toEqual([]);
86
+ });
87
+ });