@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.
- package/dist/.tsbuildinfo +1 -0
- package/dist/bound-envelope-transport.d.ts +27 -0
- package/dist/bound-envelope-transport.d.ts.map +1 -0
- package/dist/bound-envelope-transport.js +96 -0
- package/dist/bound-envelope-transport.js.map +1 -0
- package/dist/capability.d.ts +36 -0
- package/dist/capability.d.ts.map +1 -0
- package/dist/capability.js +83 -0
- package/dist/capability.js.map +1 -0
- package/dist/command-plans.d.ts +49 -0
- package/dist/command-plans.d.ts.map +1 -0
- package/dist/command-plans.js +157 -0
- package/dist/command-plans.js.map +1 -0
- package/dist/design-capabilities.d.ts +23 -0
- package/dist/design-capabilities.d.ts.map +1 -0
- package/dist/design-capabilities.js +32 -0
- package/dist/design-capabilities.js.map +1 -0
- package/dist/encrypted-envelope-transport.d.ts +32 -0
- package/dist/encrypted-envelope-transport.d.ts.map +1 -0
- package/dist/encrypted-envelope-transport.js +138 -0
- package/dist/encrypted-envelope-transport.js.map +1 -0
- package/dist/iac-generation.d.ts +52 -0
- package/dist/iac-generation.d.ts.map +1 -0
- package/dist/iac-generation.js +645 -0
- package/dist/iac-generation.js.map +1 -0
- package/dist/iac-normalizers.d.ts +22 -0
- package/dist/iac-normalizers.d.ts.map +1 -0
- package/dist/iac-normalizers.js +198 -0
- package/dist/iac-normalizers.js.map +1 -0
- package/dist/iac.d.ts +83 -0
- package/dist/iac.d.ts.map +1 -0
- package/dist/iac.js +217 -0
- package/dist/iac.js.map +1 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +17 -0
- package/dist/index.js.map +1 -0
- package/dist/local-plan-transport.d.ts +29 -0
- package/dist/local-plan-transport.d.ts.map +1 -0
- package/dist/local-plan-transport.js +101 -0
- package/dist/local-plan-transport.js.map +1 -0
- package/dist/native-iac-providers.d.ts +96 -0
- package/dist/native-iac-providers.d.ts.map +1 -0
- package/dist/native-iac-providers.js +487 -0
- package/dist/native-iac-providers.js.map +1 -0
- package/dist/operations-placeholders.d.ts +5 -0
- package/dist/operations-placeholders.d.ts.map +1 -0
- package/dist/operations-placeholders.js +23 -0
- package/dist/operations-placeholders.js.map +1 -0
- package/dist/pack-manager.d.ts +95 -0
- package/dist/pack-manager.d.ts.map +1 -0
- package/dist/pack-manager.js +556 -0
- package/dist/pack-manager.js.map +1 -0
- package/dist/packs.d.ts +29 -0
- package/dist/packs.d.ts.map +1 -0
- package/dist/packs.js +51 -0
- package/dist/packs.js.map +1 -0
- package/dist/process-runner.d.ts +30 -0
- package/dist/process-runner.d.ts.map +1 -0
- package/dist/process-runner.js +97 -0
- package/dist/process-runner.js.map +1 -0
- package/dist/secret-redaction.d.ts +3 -0
- package/dist/secret-redaction.d.ts.map +1 -0
- package/dist/secret-redaction.js +48 -0
- package/dist/secret-redaction.js.map +1 -0
- package/dist/terraform-provider-schema.d.ts +75 -0
- package/dist/terraform-provider-schema.d.ts.map +1 -0
- package/dist/terraform-provider-schema.js +307 -0
- package/dist/terraform-provider-schema.js.map +1 -0
- package/dist/terraform-registry-client.d.ts +63 -0
- package/dist/terraform-registry-client.d.ts.map +1 -0
- package/dist/terraform-registry-client.js +388 -0
- package/dist/terraform-registry-client.js.map +1 -0
- package/dist/test/bound-envelope-transport.test.d.ts +2 -0
- package/dist/test/bound-envelope-transport.test.d.ts.map +1 -0
- package/dist/test/bound-envelope-transport.test.js +30 -0
- package/dist/test/bound-envelope-transport.test.js.map +1 -0
- package/dist/test/capabilities.test.d.ts +2 -0
- package/dist/test/capabilities.test.d.ts.map +1 -0
- package/dist/test/capabilities.test.js +86 -0
- package/dist/test/capabilities.test.js.map +1 -0
- package/dist/test/encrypted-envelope-transport.test.d.ts +2 -0
- package/dist/test/encrypted-envelope-transport.test.d.ts.map +1 -0
- package/dist/test/encrypted-envelope-transport.test.js +74 -0
- package/dist/test/encrypted-envelope-transport.test.js.map +1 -0
- package/dist/test/fixtures/terraform-provider-schema.d.ts +65 -0
- package/dist/test/fixtures/terraform-provider-schema.d.ts.map +1 -0
- package/dist/test/fixtures/terraform-provider-schema.js +29 -0
- package/dist/test/fixtures/terraform-provider-schema.js.map +1 -0
- package/dist/test/fixtures/terraform-registry.d.ts +54 -0
- package/dist/test/fixtures/terraform-registry.d.ts.map +1 -0
- package/dist/test/fixtures/terraform-registry.js +42 -0
- package/dist/test/fixtures/terraform-registry.js.map +1 -0
- package/dist/test/iac-generation.test.d.ts +2 -0
- package/dist/test/iac-generation.test.d.ts.map +1 -0
- package/dist/test/iac-generation.test.js +271 -0
- package/dist/test/iac-generation.test.js.map +1 -0
- package/dist/test/iac.test.d.ts +2 -0
- package/dist/test/iac.test.d.ts.map +1 -0
- package/dist/test/iac.test.js +161 -0
- package/dist/test/iac.test.js.map +1 -0
- package/dist/test/native-iac-providers.test.d.ts +2 -0
- package/dist/test/native-iac-providers.test.d.ts.map +1 -0
- package/dist/test/native-iac-providers.test.js +594 -0
- package/dist/test/native-iac-providers.test.js.map +1 -0
- package/dist/test/operations-placeholders.test.d.ts +2 -0
- package/dist/test/operations-placeholders.test.d.ts.map +1 -0
- package/dist/test/operations-placeholders.test.js +34 -0
- package/dist/test/operations-placeholders.test.js.map +1 -0
- package/dist/test/pack-manager.test.d.ts +2 -0
- package/dist/test/pack-manager.test.d.ts.map +1 -0
- package/dist/test/pack-manager.test.js +379 -0
- package/dist/test/pack-manager.test.js.map +1 -0
- package/dist/test/packs-and-commands.test.d.ts +2 -0
- package/dist/test/packs-and-commands.test.d.ts.map +1 -0
- package/dist/test/packs-and-commands.test.js +131 -0
- package/dist/test/packs-and-commands.test.js.map +1 -0
- package/dist/test/process-runner.test.d.ts +2 -0
- package/dist/test/process-runner.test.d.ts.map +1 -0
- package/dist/test/process-runner.test.js +42 -0
- package/dist/test/process-runner.test.js.map +1 -0
- package/dist/test/terraform-provider-schema.test.d.ts +2 -0
- package/dist/test/terraform-provider-schema.test.d.ts.map +1 -0
- package/dist/test/terraform-provider-schema.test.js +259 -0
- package/dist/test/terraform-provider-schema.test.js.map +1 -0
- package/dist/test/terraform-registry-client.test.d.ts +2 -0
- package/dist/test/terraform-registry-client.test.d.ts.map +1 -0
- package/dist/test/terraform-registry-client.test.js +321 -0
- package/dist/test/terraform-registry-client.test.js.map +1 -0
- 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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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
|