@apexops/capabilities 0.10.0-next.0

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 (130) hide show
  1. package/dist/.tsbuildinfo +1 -0
  2. package/dist/bound-envelope-transport.d.ts +27 -0
  3. package/dist/bound-envelope-transport.d.ts.map +1 -0
  4. package/dist/bound-envelope-transport.js +96 -0
  5. package/dist/bound-envelope-transport.js.map +1 -0
  6. package/dist/capability.d.ts +36 -0
  7. package/dist/capability.d.ts.map +1 -0
  8. package/dist/capability.js +83 -0
  9. package/dist/capability.js.map +1 -0
  10. package/dist/command-plans.d.ts +49 -0
  11. package/dist/command-plans.d.ts.map +1 -0
  12. package/dist/command-plans.js +157 -0
  13. package/dist/command-plans.js.map +1 -0
  14. package/dist/design-capabilities.d.ts +23 -0
  15. package/dist/design-capabilities.d.ts.map +1 -0
  16. package/dist/design-capabilities.js +32 -0
  17. package/dist/design-capabilities.js.map +1 -0
  18. package/dist/encrypted-envelope-transport.d.ts +32 -0
  19. package/dist/encrypted-envelope-transport.d.ts.map +1 -0
  20. package/dist/encrypted-envelope-transport.js +138 -0
  21. package/dist/encrypted-envelope-transport.js.map +1 -0
  22. package/dist/iac-generation.d.ts +52 -0
  23. package/dist/iac-generation.d.ts.map +1 -0
  24. package/dist/iac-generation.js +645 -0
  25. package/dist/iac-generation.js.map +1 -0
  26. package/dist/iac-normalizers.d.ts +22 -0
  27. package/dist/iac-normalizers.d.ts.map +1 -0
  28. package/dist/iac-normalizers.js +198 -0
  29. package/dist/iac-normalizers.js.map +1 -0
  30. package/dist/iac.d.ts +83 -0
  31. package/dist/iac.d.ts.map +1 -0
  32. package/dist/iac.js +217 -0
  33. package/dist/iac.js.map +1 -0
  34. package/dist/index.d.ts +17 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +17 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/local-plan-transport.d.ts +29 -0
  39. package/dist/local-plan-transport.d.ts.map +1 -0
  40. package/dist/local-plan-transport.js +101 -0
  41. package/dist/local-plan-transport.js.map +1 -0
  42. package/dist/native-iac-providers.d.ts +96 -0
  43. package/dist/native-iac-providers.d.ts.map +1 -0
  44. package/dist/native-iac-providers.js +487 -0
  45. package/dist/native-iac-providers.js.map +1 -0
  46. package/dist/operations-placeholders.d.ts +5 -0
  47. package/dist/operations-placeholders.d.ts.map +1 -0
  48. package/dist/operations-placeholders.js +23 -0
  49. package/dist/operations-placeholders.js.map +1 -0
  50. package/dist/pack-manager.d.ts +95 -0
  51. package/dist/pack-manager.d.ts.map +1 -0
  52. package/dist/pack-manager.js +556 -0
  53. package/dist/pack-manager.js.map +1 -0
  54. package/dist/packs.d.ts +29 -0
  55. package/dist/packs.d.ts.map +1 -0
  56. package/dist/packs.js +51 -0
  57. package/dist/packs.js.map +1 -0
  58. package/dist/process-runner.d.ts +30 -0
  59. package/dist/process-runner.d.ts.map +1 -0
  60. package/dist/process-runner.js +97 -0
  61. package/dist/process-runner.js.map +1 -0
  62. package/dist/secret-redaction.d.ts +3 -0
  63. package/dist/secret-redaction.d.ts.map +1 -0
  64. package/dist/secret-redaction.js +48 -0
  65. package/dist/secret-redaction.js.map +1 -0
  66. package/dist/terraform-provider-schema.d.ts +75 -0
  67. package/dist/terraform-provider-schema.d.ts.map +1 -0
  68. package/dist/terraform-provider-schema.js +307 -0
  69. package/dist/terraform-provider-schema.js.map +1 -0
  70. package/dist/terraform-registry-client.d.ts +63 -0
  71. package/dist/terraform-registry-client.d.ts.map +1 -0
  72. package/dist/terraform-registry-client.js +388 -0
  73. package/dist/terraform-registry-client.js.map +1 -0
  74. package/dist/test/bound-envelope-transport.test.d.ts +2 -0
  75. package/dist/test/bound-envelope-transport.test.d.ts.map +1 -0
  76. package/dist/test/bound-envelope-transport.test.js +30 -0
  77. package/dist/test/bound-envelope-transport.test.js.map +1 -0
  78. package/dist/test/capabilities.test.d.ts +2 -0
  79. package/dist/test/capabilities.test.d.ts.map +1 -0
  80. package/dist/test/capabilities.test.js +86 -0
  81. package/dist/test/capabilities.test.js.map +1 -0
  82. package/dist/test/encrypted-envelope-transport.test.d.ts +2 -0
  83. package/dist/test/encrypted-envelope-transport.test.d.ts.map +1 -0
  84. package/dist/test/encrypted-envelope-transport.test.js +74 -0
  85. package/dist/test/encrypted-envelope-transport.test.js.map +1 -0
  86. package/dist/test/fixtures/terraform-provider-schema.d.ts +65 -0
  87. package/dist/test/fixtures/terraform-provider-schema.d.ts.map +1 -0
  88. package/dist/test/fixtures/terraform-provider-schema.js +29 -0
  89. package/dist/test/fixtures/terraform-provider-schema.js.map +1 -0
  90. package/dist/test/fixtures/terraform-registry.d.ts +54 -0
  91. package/dist/test/fixtures/terraform-registry.d.ts.map +1 -0
  92. package/dist/test/fixtures/terraform-registry.js +42 -0
  93. package/dist/test/fixtures/terraform-registry.js.map +1 -0
  94. package/dist/test/iac-generation.test.d.ts +2 -0
  95. package/dist/test/iac-generation.test.d.ts.map +1 -0
  96. package/dist/test/iac-generation.test.js +271 -0
  97. package/dist/test/iac-generation.test.js.map +1 -0
  98. package/dist/test/iac.test.d.ts +2 -0
  99. package/dist/test/iac.test.d.ts.map +1 -0
  100. package/dist/test/iac.test.js +161 -0
  101. package/dist/test/iac.test.js.map +1 -0
  102. package/dist/test/native-iac-providers.test.d.ts +2 -0
  103. package/dist/test/native-iac-providers.test.d.ts.map +1 -0
  104. package/dist/test/native-iac-providers.test.js +594 -0
  105. package/dist/test/native-iac-providers.test.js.map +1 -0
  106. package/dist/test/operations-placeholders.test.d.ts +2 -0
  107. package/dist/test/operations-placeholders.test.d.ts.map +1 -0
  108. package/dist/test/operations-placeholders.test.js +34 -0
  109. package/dist/test/operations-placeholders.test.js.map +1 -0
  110. package/dist/test/pack-manager.test.d.ts +2 -0
  111. package/dist/test/pack-manager.test.d.ts.map +1 -0
  112. package/dist/test/pack-manager.test.js +379 -0
  113. package/dist/test/pack-manager.test.js.map +1 -0
  114. package/dist/test/packs-and-commands.test.d.ts +2 -0
  115. package/dist/test/packs-and-commands.test.d.ts.map +1 -0
  116. package/dist/test/packs-and-commands.test.js +131 -0
  117. package/dist/test/packs-and-commands.test.js.map +1 -0
  118. package/dist/test/process-runner.test.d.ts +2 -0
  119. package/dist/test/process-runner.test.d.ts.map +1 -0
  120. package/dist/test/process-runner.test.js +42 -0
  121. package/dist/test/process-runner.test.js.map +1 -0
  122. package/dist/test/terraform-provider-schema.test.d.ts +2 -0
  123. package/dist/test/terraform-provider-schema.test.d.ts.map +1 -0
  124. package/dist/test/terraform-provider-schema.test.js +259 -0
  125. package/dist/test/terraform-provider-schema.test.js.map +1 -0
  126. package/dist/test/terraform-registry-client.test.d.ts +2 -0
  127. package/dist/test/terraform-registry-client.test.d.ts.map +1 -0
  128. package/dist/test/terraform-registry-client.test.js +321 -0
  129. package/dist/test/terraform-registry-client.test.js.map +1 -0
  130. package/package.json +41 -0
@@ -0,0 +1,388 @@
1
+ const REGISTRY_ORIGIN = "https://registry.terraform.io";
2
+ const IDENTIFIER = /^(?=.*[A-Za-z0-9])[A-Za-z0-9._-]+$/u;
3
+ const MAX_IDENTIFIER_LENGTH = 100;
4
+ const MAX_VERSION_LENGTH = 200;
5
+ const MAX_TIMEOUT_MS = 60_000;
6
+ const MAX_RESPONSE_BYTES = 5_000_000;
7
+ const MAX_CACHE_TTL_MS = 3_600_000;
8
+ const MAX_RETRY_DELAY_MS = 10_000;
9
+ const SEMVER = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-((?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/u;
10
+ function invalid(note) {
11
+ return { status: "invalid", note };
12
+ }
13
+ function identifier(value, label) {
14
+ return value.length <= MAX_IDENTIFIER_LENGTH && value !== "." && value !== ".." && IDENTIFIER.test(value)
15
+ ? value
16
+ : invalid(`${label} must be a Terraform Registry identifier`);
17
+ }
18
+ function parseSemver(value) {
19
+ if (value.length > MAX_VERSION_LENGTH)
20
+ return null;
21
+ const match = SEMVER.exec(value);
22
+ if (match === null)
23
+ return null;
24
+ return {
25
+ value,
26
+ major: BigInt(match[1]),
27
+ minor: BigInt(match[2]),
28
+ patch: BigInt(match[3]),
29
+ prerelease: match[4] ?? null,
30
+ };
31
+ }
32
+ function compareStableVersions(left, right) {
33
+ for (const key of ["major", "minor", "patch"]) {
34
+ if (left[key] < right[key])
35
+ return 1;
36
+ if (left[key] > right[key])
37
+ return -1;
38
+ }
39
+ if (left.value < right.value)
40
+ return 1;
41
+ if (left.value > right.value)
42
+ return -1;
43
+ return 0;
44
+ }
45
+ function stableVersions(values) {
46
+ const parsed = values.map(parseSemver);
47
+ if (parsed.some((value) => value === null))
48
+ return null;
49
+ return [
50
+ ...new Map(parsed.filter(({ prerelease }) => prerelease === null).map((value) => [value.value, value])).values(),
51
+ ]
52
+ .sort(compareStableVersions)
53
+ .map(({ value }) => value);
54
+ }
55
+ function plainObject(value) {
56
+ return value !== null && typeof value === "object" && !Array.isArray(value)
57
+ ? value
58
+ : null;
59
+ }
60
+ function stringValue(value) {
61
+ return typeof value === "string" ? value : null;
62
+ }
63
+ function nonNegativeInteger(value) {
64
+ return Number.isSafeInteger(value) && Number(value) >= 0 ? Number(value) : null;
65
+ }
66
+ async function boundedText(response, maxBytes, signal) {
67
+ if (response.body === null) {
68
+ const text = await response.text();
69
+ if (Buffer.byteLength(text, "utf8") > maxBytes)
70
+ throw new RangeError("response-too-large");
71
+ return text;
72
+ }
73
+ const reader = response.body.getReader();
74
+ const cancel = () => void reader.cancel().catch(() => undefined);
75
+ signal.addEventListener("abort", cancel, { once: true });
76
+ const chunks = [];
77
+ let bytes = 0;
78
+ try {
79
+ while (true) {
80
+ const part = await reader.read();
81
+ if (part.done)
82
+ break;
83
+ bytes += part.value.byteLength;
84
+ if (bytes > maxBytes) {
85
+ void reader.cancel().catch(() => undefined);
86
+ throw new RangeError("response-too-large");
87
+ }
88
+ chunks.push(part.value);
89
+ }
90
+ return Buffer.concat(chunks).toString("utf8");
91
+ }
92
+ finally {
93
+ signal.removeEventListener("abort", cancel);
94
+ }
95
+ }
96
+ async function cancelBody(response) {
97
+ try {
98
+ void response.body?.cancel().catch(() => undefined);
99
+ }
100
+ catch {
101
+ // Error responses are already unavailable; cleanup failures do not replace that result.
102
+ }
103
+ }
104
+ function moduleSummary(value) {
105
+ const row = plainObject(value);
106
+ if (row === null)
107
+ return null;
108
+ const id = stringValue(row.id);
109
+ const namespace = stringValue(row.namespace);
110
+ const name = stringValue(row.name);
111
+ const provider = stringValue(row.provider);
112
+ const version = stringValue(row.version);
113
+ const description = stringValue(row.description);
114
+ const downloads = nonNegativeInteger(row.downloads);
115
+ if (id === null ||
116
+ namespace === null ||
117
+ name === null ||
118
+ provider === null ||
119
+ version === null ||
120
+ description === null ||
121
+ downloads === null ||
122
+ typeof row.verified !== "boolean") {
123
+ return null;
124
+ }
125
+ if (typeof identifier(namespace, "namespace") !== "string" ||
126
+ typeof identifier(name, "name") !== "string" ||
127
+ typeof identifier(provider, "provider") !== "string" ||
128
+ parseSemver(version) === null ||
129
+ id !== `${namespace}/${name}/${provider}/${version}`) {
130
+ return null;
131
+ }
132
+ return { id, namespace, name, provider, version, description, downloads, verified: row.verified };
133
+ }
134
+ export class TerraformRegistryClient {
135
+ #fetch;
136
+ #now;
137
+ #sleep;
138
+ #timeoutMs;
139
+ #maxResponseBytes;
140
+ #cacheTtlMs;
141
+ #maxCacheEntries;
142
+ #retries;
143
+ #retryDelayMs;
144
+ #cache = new Map();
145
+ constructor(options = {}) {
146
+ this.#fetch = options.fetch ?? fetch;
147
+ this.#now = options.now ?? Date.now;
148
+ this.#sleep = options.sleep ?? ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
149
+ this.#timeoutMs = options.timeoutMs ?? 8_000;
150
+ this.#maxResponseBytes = options.maxResponseBytes ?? 1_000_000;
151
+ this.#cacheTtlMs = options.cacheTtlMs ?? 300_000;
152
+ this.#maxCacheEntries = options.maxCacheEntries ?? 128;
153
+ this.#retries = options.retries ?? 1;
154
+ this.#retryDelayMs = options.retryDelayMs ?? 250;
155
+ if (!Number.isSafeInteger(this.#timeoutMs) ||
156
+ this.#timeoutMs <= 0 ||
157
+ this.#timeoutMs > MAX_TIMEOUT_MS ||
158
+ !Number.isSafeInteger(this.#maxResponseBytes) ||
159
+ this.#maxResponseBytes <= 0 ||
160
+ this.#maxResponseBytes > MAX_RESPONSE_BYTES ||
161
+ !Number.isSafeInteger(this.#cacheTtlMs) ||
162
+ this.#cacheTtlMs < 0 ||
163
+ this.#cacheTtlMs > MAX_CACHE_TTL_MS ||
164
+ !Number.isSafeInteger(this.#maxCacheEntries) ||
165
+ this.#maxCacheEntries < 1 ||
166
+ this.#maxCacheEntries > 1_024 ||
167
+ !Number.isSafeInteger(this.#retries) ||
168
+ this.#retries < 0 ||
169
+ this.#retries > 3 ||
170
+ !Number.isSafeInteger(this.#retryDelayMs) ||
171
+ this.#retryDelayMs < 0 ||
172
+ this.#retryDelayMs > MAX_RETRY_DELAY_MS) {
173
+ throw new TypeError("Terraform Registry client bounds are invalid");
174
+ }
175
+ }
176
+ async searchModules(query, options = {}) {
177
+ const normalizedQuery = query.trim();
178
+ const offset = options.offset ?? 0;
179
+ const limit = options.limit ?? 20;
180
+ if (normalizedQuery.length === 0 || normalizedQuery.length > 100)
181
+ return invalid("query must contain 1-100 characters");
182
+ if (!Number.isSafeInteger(offset) || offset < 0 || offset > 1_000)
183
+ return invalid("offset must be between 0 and 1000");
184
+ if (!Number.isSafeInteger(limit) || limit < 1 || limit > 50)
185
+ return invalid("limit must be between 1 and 50");
186
+ const params = new URLSearchParams({ q: normalizedQuery, offset: String(offset), limit: String(limit) });
187
+ return await this.#request(`/v1/modules/search?${params}`, (body) => {
188
+ const root = plainObject(body);
189
+ const metadata = plainObject(root?.meta);
190
+ if (root === null || metadata === null || !Array.isArray(root.modules))
191
+ return null;
192
+ const modules = root.modules.map(moduleSummary);
193
+ const currentOffset = nonNegativeInteger(metadata.current_offset);
194
+ const responseLimit = nonNegativeInteger(metadata.limit);
195
+ const rawNextOffset = metadata.next_offset;
196
+ const nextOffset = rawNextOffset === null || rawNextOffset === undefined ? null : nonNegativeInteger(rawNextOffset);
197
+ if (modules.some((module) => module === null) ||
198
+ currentOffset === null ||
199
+ responseLimit === null ||
200
+ currentOffset !== offset ||
201
+ responseLimit < 1 ||
202
+ responseLimit > limit ||
203
+ modules.length > responseLimit ||
204
+ (nextOffset === null && rawNextOffset !== null && rawNextOffset !== undefined) ||
205
+ (nextOffset !== null && (nextOffset <= currentOffset || nextOffset > 1_000))) {
206
+ return null;
207
+ }
208
+ return { modules: modules, offset: currentOffset, nextOffset, limit: responseLimit };
209
+ });
210
+ }
211
+ async getModuleDetails(namespace, name, provider, version) {
212
+ const parts = [identifier(namespace, "namespace"), identifier(name, "name"), identifier(provider, "provider")];
213
+ if (parts.some((part) => typeof part !== "string"))
214
+ return parts.find((part) => typeof part !== "string");
215
+ if (version.length > MAX_VERSION_LENGTH || parseSemver(version) === null) {
216
+ return invalid("version must be a bounded exact semantic version");
217
+ }
218
+ return await this.#request(`/v1/modules/${parts.join("/")}/${version}`, (body) => {
219
+ const summary = moduleSummary(body);
220
+ const source = stringValue(plainObject(body)?.source);
221
+ const expectedId = `${namespace}/${name}/${provider}/${version}`;
222
+ return summary === null ||
223
+ source === null ||
224
+ summary.namespace.toLowerCase() !== namespace.toLowerCase() ||
225
+ summary.name.toLowerCase() !== name.toLowerCase() ||
226
+ summary.provider.toLowerCase() !== provider.toLowerCase() ||
227
+ summary.version !== version ||
228
+ summary.id.toLowerCase() !== expectedId.toLowerCase()
229
+ ? null
230
+ : { ...summary, source };
231
+ });
232
+ }
233
+ async getModuleVersions(namespace, name, provider) {
234
+ return await this.#versions(`/v1/modules/${namespace}/${name}/${provider}/versions`, [namespace, name, provider], {
235
+ shape: "modules",
236
+ expectedSource: `${namespace}/${name}/${provider}`,
237
+ });
238
+ }
239
+ async getProviderVersions(namespace, name) {
240
+ return await this.#versions(`/v1/providers/${namespace}/${name}/versions`, [namespace, name], {
241
+ shape: "versions",
242
+ expectedSource: `${namespace}/${name}`,
243
+ });
244
+ }
245
+ async #versions(path, segments, options) {
246
+ for (const [index, segment] of segments.entries()) {
247
+ const checked = identifier(segment, `segment ${index + 1}`);
248
+ if (typeof checked !== "string")
249
+ return checked;
250
+ }
251
+ return await this.#request(path, (body) => {
252
+ const root = plainObject(body);
253
+ let rawVersions;
254
+ if (options.shape === "versions" &&
255
+ typeof root?.id === "string" &&
256
+ root.id.toLowerCase() === options.expectedSource?.toLowerCase()) {
257
+ rawVersions = root.versions;
258
+ }
259
+ else if (Array.isArray(root?.modules) && root.modules.length === 1) {
260
+ const module = plainObject(root.modules[0]);
261
+ rawVersions =
262
+ module !== null &&
263
+ typeof module.source === "string" &&
264
+ module.source.toLowerCase() === options.expectedSource?.toLowerCase()
265
+ ? module.versions
266
+ : undefined;
267
+ }
268
+ if (!Array.isArray(rawVersions))
269
+ return null;
270
+ const versionValues = rawVersions.map((entry) => stringValue(plainObject(entry)?.version));
271
+ if (versionValues.some((value) => value === null))
272
+ return null;
273
+ const versions = stableVersions(versionValues);
274
+ if (versions === null)
275
+ return null;
276
+ return { versions, latestStable: versions[0] ?? null };
277
+ });
278
+ }
279
+ async #request(path, parse) {
280
+ const url = new URL(path, REGISTRY_ORIGIN);
281
+ if (url.origin !== REGISTRY_ORIGIN)
282
+ return invalid("Registry request origin is not allowed");
283
+ const cached = this.#cache.get(url.href);
284
+ if (cached !== undefined && cached.expiresAt > this.#now()) {
285
+ return { ...structuredClone(cached.result), cached: true };
286
+ }
287
+ this.#cache.delete(url.href);
288
+ for (let attempt = 0; attempt <= this.#retries; attempt += 1) {
289
+ const controller = new AbortController();
290
+ let response;
291
+ let timer;
292
+ const deadline = new Promise((_resolve, reject) => {
293
+ timer = setTimeout(() => {
294
+ controller.abort();
295
+ reject(new DOMException("Registry request timed out", "AbortError"));
296
+ }, this.#timeoutMs);
297
+ });
298
+ try {
299
+ response = await Promise.race([
300
+ this.#fetch(url, {
301
+ method: "GET",
302
+ headers: { accept: "application/json" },
303
+ redirect: "error",
304
+ signal: controller.signal,
305
+ }),
306
+ deadline,
307
+ ]);
308
+ if (response.status === 404) {
309
+ await cancelBody(response);
310
+ return this.#cacheResult(url.href, {
311
+ status: "missing",
312
+ note: "Registry resource was not found",
313
+ cached: false,
314
+ });
315
+ }
316
+ if (response.status === 429) {
317
+ await cancelBody(response);
318
+ if (attempt < this.#retries) {
319
+ await this.#sleep(this.#retryDelayMs * 2 ** attempt);
320
+ continue;
321
+ }
322
+ return { status: "unavailable", reason: "rate-limited", note: "Registry request was rate-limited" };
323
+ }
324
+ if (!response.ok) {
325
+ await cancelBody(response);
326
+ if (response.status >= 500 && attempt < this.#retries) {
327
+ await this.#sleep(this.#retryDelayMs * 2 ** attempt);
328
+ continue;
329
+ }
330
+ return { status: "unavailable", reason: "http", note: `Registry returned HTTP ${response.status}` };
331
+ }
332
+ const text = await Promise.race([boundedText(response, this.#maxResponseBytes, controller.signal), deadline]);
333
+ let body;
334
+ try {
335
+ body = JSON.parse(text);
336
+ }
337
+ catch {
338
+ return { status: "unavailable", reason: "malformed-response", note: "Registry response was not valid JSON" };
339
+ }
340
+ const value = parse(body);
341
+ if (value === null)
342
+ return {
343
+ status: "unavailable",
344
+ reason: "malformed-response",
345
+ note: "Registry response did not match the expected schema",
346
+ };
347
+ return this.#cacheResult(url.href, { status: "ok", value, cached: false });
348
+ }
349
+ catch (error) {
350
+ if (error instanceof RangeError && error.message === "response-too-large") {
351
+ return {
352
+ status: "unavailable",
353
+ reason: "response-too-large",
354
+ note: "Registry response exceeded the byte limit",
355
+ };
356
+ }
357
+ const timeout = controller.signal.aborted || (error instanceof Error && error.name === "AbortError");
358
+ if (attempt < this.#retries) {
359
+ await this.#sleep(this.#retryDelayMs * 2 ** attempt);
360
+ continue;
361
+ }
362
+ return {
363
+ status: "unavailable",
364
+ reason: timeout ? "timeout" : "transport",
365
+ note: timeout ? "Registry request timed out" : "Registry transport was unavailable",
366
+ };
367
+ }
368
+ finally {
369
+ if (timer !== undefined)
370
+ clearTimeout(timer);
371
+ }
372
+ }
373
+ return { status: "unavailable", reason: "transport", note: "Registry transport was unavailable" };
374
+ }
375
+ #cacheResult(key, result) {
376
+ if (this.#cacheTtlMs > 0 && (result.status === "ok" || result.status === "missing")) {
377
+ while (this.#cache.size >= this.#maxCacheEntries) {
378
+ const oldest = this.#cache.keys().next().value;
379
+ if (oldest === undefined)
380
+ break;
381
+ this.#cache.delete(oldest);
382
+ }
383
+ this.#cache.set(key, { expiresAt: this.#now() + this.#cacheTtlMs, result: structuredClone(result) });
384
+ }
385
+ return result;
386
+ }
387
+ }
388
+ //# sourceMappingURL=terraform-registry-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"terraform-registry-client.js","sourceRoot":"","sources":["../src/terraform-registry-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=bound-envelope-transport.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bound-envelope-transport.test.d.ts","sourceRoot":"","sources":["../../src/test/bound-envelope-transport.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,30 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import { BoundEnvelopeTransport } from "../index.js";
4
+ const instant = new Date("2026-07-17T08:00:00.000Z");
5
+ const payload = Buffer.from("authority", "utf8");
6
+ function transport(now = instant) {
7
+ return new BoundEnvelopeTransport(() => now);
8
+ }
9
+ test("bound envelopes preserve payload integrity and canonical bindings", () => {
10
+ const envelope = transport().create(payload, {
11
+ kind: "authority",
12
+ recipient: "ci",
13
+ ttlMs: 60_000,
14
+ bindings: { zeta: 2, alpha: "one" },
15
+ });
16
+ assert.deepEqual(envelope.metadata.bindings, { alpha: "one", zeta: 2 });
17
+ assert.deepEqual(transport().open(envelope, "ci"), payload);
18
+ });
19
+ test("bound envelopes reject wrong recipients, expiry, and tampering", () => {
20
+ const envelope = transport().create(payload, {
21
+ kind: "authority",
22
+ recipient: "ci",
23
+ ttlMs: 60_000,
24
+ bindings: { previewHash: "a".repeat(64) },
25
+ });
26
+ assert.throws(() => transport().open(envelope, "other"), /recipient/);
27
+ assert.throws(() => transport(new Date("2026-07-17T08:01:00.000Z")).open(envelope, "ci"), /expired/);
28
+ assert.throws(() => transport().open({ ...envelope, payload: Buffer.from("changed").toString("base64") }, "ci"), /digest/);
29
+ });
30
+ //# sourceMappingURL=bound-envelope-transport.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bound-envelope-transport.test.js","sourceRoot":"","sources":["../../src/test/bound-envelope-transport.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAEjD,SAAS,SAAS,CAAC,GAAG,GAAG,OAAO;IAC9B,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;QAC3C,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;KACpC,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;QAC3C,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;KAC1C,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IACtE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IACrG,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,EACjG,QAAQ,CACT,CAAC;AACJ,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=capabilities.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.test.d.ts","sourceRoot":"","sources":["../../src/test/capabilities.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,86 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import { CapabilityError, CapabilityRegistry } from "../capability.js";
4
+ import { designCapabilityIds, registerUnavailableDesignCapabilities } from "../design-capabilities.js";
5
+ const hash = "a".repeat(64);
6
+ function envelope(overrides = {}) {
7
+ return {
8
+ schemaVersion: "1.0.0",
9
+ projectId: "project",
10
+ runId: "run",
11
+ taskId: "task",
12
+ role: "deployer",
13
+ taskType: "test",
14
+ expectedHead: hash,
15
+ ownerEpoch: 1,
16
+ createdAt: "2026-07-13T00:00:00.000Z",
17
+ expiresAt: "2026-07-13T02:00:00.000Z",
18
+ inputRefs: [],
19
+ allowedOutputKinds: [],
20
+ capabilityGrants: [{ capability: "test.run", sideEffect: "remote", expiresAt: "2026-07-13T02:00:00.000Z" }],
21
+ maxOutputBytes: 100,
22
+ ...overrides,
23
+ };
24
+ }
25
+ const capability = {
26
+ id: "test.run",
27
+ sideEffect: "remote",
28
+ requiredRole: "deployer",
29
+ timeoutMs: 20,
30
+ retries: 0,
31
+ idempotency: "required",
32
+ async execute(_context, input) {
33
+ return { value: input };
34
+ },
35
+ };
36
+ test("registry denies missing grants, wrong roles, expiry, and unknown capabilities", async () => {
37
+ const registry = new CapabilityRegistry({ now: () => new Date("2026-07-13T01:00:00.000Z") });
38
+ registry.register(capability);
39
+ await assert.rejects(registry.execute("missing", envelope(), "x"), errorCode("CAPABILITY_UNKNOWN"));
40
+ await assert.rejects(registry.execute("test.run", envelope({ capabilityGrants: [] }), "x"), errorCode("CAPABILITY_GRANT_DENIED"));
41
+ await assert.rejects(registry.execute("test.run", envelope({ role: "reader" }), "x"), errorCode("CAPABILITY_ROLE_DENIED"));
42
+ await assert.rejects(registry.execute("test.run", envelope({ expiresAt: "2026-07-13T00:30:00.000Z" }), "x"), errorCode("CAPABILITY_EXPIRED"));
43
+ });
44
+ test("registry rejects duplicate capabilities, timeouts, and oversized output", async () => {
45
+ const registry = new CapabilityRegistry({ now: () => new Date("2026-07-13T01:00:00.000Z") });
46
+ registry.register(capability);
47
+ assert.throws(() => registry.register(capability), errorCode("CAPABILITY_DUPLICATE"));
48
+ const slow = {
49
+ ...capability,
50
+ id: "test.slow",
51
+ sideEffect: "none",
52
+ timeoutMs: 1,
53
+ async execute() {
54
+ return await new Promise(() => undefined);
55
+ },
56
+ };
57
+ registry.register(slow);
58
+ await assert.rejects(registry.execute("test.slow", envelope({
59
+ capabilityGrants: [{ capability: "test.slow", sideEffect: "none", expiresAt: "2026-07-13T02:00:00.000Z" }],
60
+ }), undefined), errorCode("CAPABILITY_TIMEOUT"));
61
+ await assert.rejects(registry.execute("test.run", envelope({ maxOutputBytes: 5 }), "too-large"), errorCode("CAPABILITY_OUTPUT_LIMIT"));
62
+ });
63
+ test("registry rejects implemented capabilities until they are qualified", async () => {
64
+ const registry = new CapabilityRegistry({ now: () => new Date("2026-07-13T01:00:00.000Z") });
65
+ registry.register({ ...capability, lifecycle: "implemented-unqualified" });
66
+ await assert.rejects(registry.execute("test.run", envelope(), "x"), errorCode("CAPABILITY_UNQUALIFIED"));
67
+ });
68
+ test("registry permits trusted external capabilities through their envelope controls", async () => {
69
+ const registry = new CapabilityRegistry({ now: () => new Date("2026-07-13T01:00:00.000Z") });
70
+ registry.register({ ...capability, lifecycle: "external-trusted" });
71
+ assert.deepEqual(await registry.execute("test.run", envelope(), "x"), { value: "x" });
72
+ });
73
+ test("unqualified design capabilities return only the stable unavailable error", async () => {
74
+ const registry = new CapabilityRegistry({ now: () => new Date("2026-07-13T01:00:00.000Z") });
75
+ registerUnavailableDesignCapabilities(registry);
76
+ for (const id of Object.values(designCapabilityIds)) {
77
+ await assert.rejects(registry.execute(id, envelope({
78
+ role: "architect",
79
+ capabilityGrants: [{ capability: id, sideEffect: "none", expiresAt: "2026-07-13T02:00:00.000Z" }],
80
+ }), { request: "test" }), errorCode("CAPABILITY_UNAVAILABLE"));
81
+ }
82
+ });
83
+ function errorCode(code) {
84
+ return (error) => error instanceof CapabilityError && error.code === code;
85
+ }
86
+ //# sourceMappingURL=capabilities.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.test.js","sourceRoot":"","sources":["../../src/test/capabilities.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=encrypted-envelope-transport.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"encrypted-envelope-transport.test.d.ts","sourceRoot":"","sources":["../../src/test/encrypted-envelope-transport.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,74 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import { EncryptedEnvelopeTransport } from "../index.js";
4
+ const key = Buffer.alloc(32, 7);
5
+ const now = new Date("2026-07-15T10:00:00.000Z");
6
+ const transport = () => new EncryptedEnvelopeTransport(() => now, () => Buffer.alloc(12, 3));
7
+ function encrypted() {
8
+ return transport().encrypt(Buffer.from("repository state"), key, {
9
+ kind: "apex-repository-state",
10
+ recipient: "ci-workflow",
11
+ ttlMs: 60_000,
12
+ bindings: { runId: "run-1", ownerEpoch: 1, projectId: "demo" },
13
+ });
14
+ }
15
+ test("encrypted envelopes are deterministic with fixed time and nonce and canonicalize bindings", () => {
16
+ const first = encrypted();
17
+ const second = transport().encrypt(Buffer.from("repository state"), key, {
18
+ kind: "apex-repository-state",
19
+ recipient: "ci-workflow",
20
+ ttlMs: 60_000,
21
+ bindings: { projectId: "demo", ownerEpoch: 1, runId: "run-1" },
22
+ });
23
+ assert.deepEqual(first, second);
24
+ assert.deepEqual(first.metadata.bindings, { ownerEpoch: 1, projectId: "demo", runId: "run-1" });
25
+ assert.equal(transport().decrypt(first, key, "ci-workflow").toString(), "repository state");
26
+ });
27
+ test("encrypted envelopes enforce key, kind, recipient, and positive TTL", () => {
28
+ assert.throws(() => transport().decrypt(encrypted(), Buffer.alloc(31), "ci-workflow"), /32-byte key/);
29
+ assert.throws(() => transport().decrypt(encrypted(), key, "other"), /recipient/);
30
+ assert.throws(() => transport().encrypt(Buffer.from("state"), key, {
31
+ kind: "",
32
+ recipient: "ci",
33
+ ttlMs: 1,
34
+ bindings: {},
35
+ }), /kind, recipient, and positive TTL/);
36
+ assert.throws(() => transport().encrypt(Buffer.from("state"), key, {
37
+ kind: "state",
38
+ recipient: "ci",
39
+ ttlMs: 0,
40
+ bindings: {},
41
+ }), /positive TTL/);
42
+ assert.throws(() => transport().encrypt(Buffer.from("state"), key, {
43
+ kind: "state",
44
+ recipient: "ci",
45
+ ttlMs: 1,
46
+ bindings: { ["bad-key"]: "invalid" },
47
+ }), /identifier-shaped/);
48
+ });
49
+ test("encrypted envelopes reject expiry and authenticated tampering", () => {
50
+ const envelope = encrypted();
51
+ const expired = new EncryptedEnvelopeTransport(() => new Date("2026-07-15T10:01:00.000Z"));
52
+ assert.throws(() => expired.decrypt(envelope, key, "ci-workflow"), /expired/);
53
+ for (const tampered of [
54
+ { ...envelope, metadata: { ...envelope.metadata, kind: "other" } },
55
+ { ...envelope, metadata: { ...envelope.metadata, unexpected: "value" } },
56
+ { ...envelope, authTag: `${envelope.authTag.slice(0, -2)}AA` },
57
+ { ...envelope, ciphertext: `${envelope.ciphertext.slice(0, -2)}AA` },
58
+ ]) {
59
+ assert.throws(() => transport().decrypt(tampered, key, "ci-workflow"));
60
+ }
61
+ });
62
+ test("encrypted envelopes detect plaintext digest mismatch", () => {
63
+ const envelope = encrypted();
64
+ const digest = "0".repeat(64);
65
+ const forged = transport().encrypt(Buffer.from("repository state"), key, {
66
+ kind: "apex-repository-state",
67
+ recipient: "ci-workflow",
68
+ ttlMs: 60_000,
69
+ bindings: {},
70
+ });
71
+ assert.throws(() => transport().decrypt({ ...forged, metadata: { ...forged.metadata, digest } }, key, "ci-workflow"));
72
+ assert.notEqual(envelope.metadata.digest, digest);
73
+ });
74
+ //# sourceMappingURL=encrypted-envelope-transport.test.js.map