@git.zone/cli 12.1.1 → 12.3.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/assets/templates/npm/.package.json +1 -1
- package/assets/templates/service/.package.json +1 -1
- package/assets/templates/wcc/.package.json +1 -1
- package/assets/templates/website/.package.json +1 -1
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/helpers.tssea.d.ts +2 -7
- package/dist_ts/helpers.tssea.js +20 -10
- package/dist_ts/helpers.versionsource.d.ts +23 -5
- package/dist_ts/helpers.versionsource.js +115 -37
- package/dist_ts/helpers.workflow.d.ts +60 -17
- package/dist_ts/helpers.workflow.js +156 -51
- package/dist_ts/mod_config/index.js +98 -31
- package/dist_ts/mod_release/classes.releasejournal.d.ts +63 -8
- package/dist_ts/mod_release/classes.releasejournal.js +283 -124
- package/dist_ts/mod_release/helpers.cargorelease.d.ts +4 -3
- package/dist_ts/mod_release/helpers.cargorelease.js +5 -4
- package/dist_ts/mod_release/helpers.fossglobalassets.d.ts +61 -0
- package/dist_ts/mod_release/helpers.fossglobalassets.js +580 -0
- package/dist_ts/mod_release/helpers.giteaassets.d.ts +15 -51
- package/dist_ts/mod_release/helpers.giteaassets.js +40 -507
- package/dist_ts/mod_release/helpers.releaseassets.d.ts +40 -0
- package/dist_ts/mod_release/helpers.releaseassets.js +349 -0
- package/dist_ts/mod_release/helpers.releaseassettransfer.d.ts +67 -0
- package/dist_ts/mod_release/helpers.releaseassettransfer.js +239 -0
- package/dist_ts/mod_release/helpers.releasecheck.js +3 -2
- package/dist_ts/mod_release/helpers.releasepreparation.d.ts +7 -6
- package/dist_ts/mod_release/helpers.releasepreparation.js +34 -7
- package/dist_ts/mod_release/helpers.releasepublication.d.ts +8 -2
- package/dist_ts/mod_release/helpers.releasepublication.js +218 -54
- package/dist_ts/mod_release/helpers.releaseversionsource.d.ts +7 -5
- package/dist_ts/mod_release/helpers.releaseversionsource.js +9 -7
- package/dist_ts/mod_release/index.d.ts +1 -1
- package/dist_ts/mod_release/index.js +109 -68
- package/dist_ts/mod_release/interfaces.fossglobalassets.d.ts +108 -0
- package/dist_ts/mod_release/interfaces.fossglobalassets.js +2 -0
- package/dist_ts/mod_release/interfaces.giteaassets.d.ts +9 -43
- package/dist_ts/mod_release/interfaces.releaseassets.d.ts +68 -0
- package/dist_ts/mod_release/interfaces.releaseassets.js +2 -0
- package/dist_ts/plugins.d.ts +1 -0
- package/dist_ts/plugins.js +1 -1
- package/package.json +3 -2
- package/readme.md +339 -41
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/helpers.tssea.ts +31 -10
- package/ts/helpers.versionsource.ts +176 -45
- package/ts/helpers.workflow.ts +288 -78
- package/ts/mod_config/index.ts +130 -38
- package/ts/mod_release/classes.releasejournal.ts +499 -180
- package/ts/mod_release/helpers.cargorelease.ts +8 -3
- package/ts/mod_release/helpers.fossglobalassets.ts +886 -0
- package/ts/mod_release/helpers.giteaassets.ts +127 -694
- package/ts/mod_release/helpers.releaseassets.ts +516 -0
- package/ts/mod_release/helpers.releaseassettransfer.ts +339 -0
- package/ts/mod_release/helpers.releasecheck.ts +3 -1
- package/ts/mod_release/helpers.releasepreparation.ts +55 -12
- package/ts/mod_release/helpers.releasepublication.ts +351 -69
- package/ts/mod_release/helpers.releaseversionsource.ts +11 -7
- package/ts/mod_release/index.ts +151 -90
- package/ts/mod_release/interfaces.fossglobalassets.ts +127 -0
- package/ts/mod_release/interfaces.giteaassets.ts +14 -47
- package/ts/mod_release/interfaces.releaseassets.ts +96 -0
- package/ts/plugins.ts +3 -0
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import * as plugins from "./mod.plugins.js";
|
|
2
|
+
import type { IPrepareReleaseAssetsOptions, IReleaseAssetDestination, IReleaseAssetTarget, IReleaseFrozenAsset, TReleaseAssetTargetName } from "./interfaces.releaseassets.js";
|
|
3
|
+
export type * from "./interfaces.releaseassets.js";
|
|
4
|
+
/**
|
|
5
|
+
* Every release asset target with what it fixes for the shared machinery: the
|
|
6
|
+
* code host its messages name and the bounds of one release's asset set.
|
|
7
|
+
*/
|
|
8
|
+
export declare const releaseAssetTargets: Readonly<Record<TReleaseAssetTargetName, Readonly<IReleaseAssetTarget>>>;
|
|
9
|
+
/**
|
|
10
|
+
* The destination holds something other than the frozen release or asset.
|
|
11
|
+
* Terminal: the claim/inspect executor records it as a destination conflict.
|
|
12
|
+
*/
|
|
13
|
+
export declare class ReleaseAssetConflictError extends Error {
|
|
14
|
+
constructor(message: string);
|
|
15
|
+
}
|
|
16
|
+
export declare const assertReleaseAssetRecord: (target: TReleaseAssetTargetName, value: unknown) => Record<string, unknown>;
|
|
17
|
+
export declare const assertReleaseAssetTag: (target: TReleaseAssetTargetName, value: string) => void;
|
|
18
|
+
export declare const normalizeReleaseAssetDestination: (target: TReleaseAssetTargetName, value: IReleaseAssetDestination) => IReleaseAssetDestination;
|
|
19
|
+
/**
|
|
20
|
+
* The credential of a release asset target from its configured environment
|
|
21
|
+
* variable. Only the variable's name ever appears in a message.
|
|
22
|
+
*/
|
|
23
|
+
export declare const readReleaseAssetCredential: (target: TReleaseAssetTargetName, tokenEnv: string) => string;
|
|
24
|
+
/** The frozen copy's name in the release record directory, covered by its retention. */
|
|
25
|
+
export declare const releaseAssetFileName: (target: TReleaseAssetTargetName, name: string) => string;
|
|
26
|
+
/** The anonymous download URL by tag and asset name. */
|
|
27
|
+
export declare const releaseAssetPublicUrl: (target: TReleaseAssetTargetName, destination: IReleaseAssetDestination, tag: string, name: string) => string;
|
|
28
|
+
/** Opens a regular file reached without any symlink, read-only. */
|
|
29
|
+
export declare const openReleaseAssetFile: (target: TReleaseAssetTargetName, path: string) => Promise<plugins.fs.FileHandle>;
|
|
30
|
+
export type TReleaseAssetFileHandle = Awaited<ReturnType<typeof openReleaseAssetFile>>;
|
|
31
|
+
/** Hashes the whole open file; its size, hash and timestamps must match the frozen asset. */
|
|
32
|
+
export declare const verifyReleaseAssetFile: (target: TReleaseAssetTargetName, handle: TReleaseAssetFileHandle, asset: IReleaseFrozenAsset) => Promise<void>;
|
|
33
|
+
export declare function assertReleaseFrozenAssets(target: TReleaseAssetTargetName, assets: unknown, destination?: IReleaseAssetDestination, tag?: string): asserts assets is IReleaseFrozenAsset[];
|
|
34
|
+
export declare const validateReleaseAssets: (target: TReleaseAssetTargetName, artifactDirectory: string, assets: IReleaseFrozenAsset[]) => Promise<void>;
|
|
35
|
+
/**
|
|
36
|
+
* Reads the manifest `{schemaVersion: 1, version, assets: [{name, path, size,
|
|
37
|
+
* sha256}]}` and freezes each listed file into the release record directory,
|
|
38
|
+
* proving its bytes before and after the copy.
|
|
39
|
+
*/
|
|
40
|
+
export declare const prepareReleaseAssets: (target: TReleaseAssetTargetName, options: IPrepareReleaseAssetsOptions) => Promise<IReleaseFrozenAsset[]>;
|
|
@@ -0,0 +1,349 @@
|
|
|
1
|
+
import * as plugins from "./mod.plugins.js";
|
|
2
|
+
/**
|
|
3
|
+
* Every release asset target with what it fixes for the shared machinery: the
|
|
4
|
+
* code host its messages name and the bounds of one release's asset set.
|
|
5
|
+
*/
|
|
6
|
+
export const releaseAssetTargets = Object.freeze({
|
|
7
|
+
giteaAssets: Object.freeze({
|
|
8
|
+
label: "Gitea",
|
|
9
|
+
hostAssetNoun: "attachment",
|
|
10
|
+
maximumAssets: 1024,
|
|
11
|
+
maximumAssetBytes: 32 * 1024 * 1024 * 1024,
|
|
12
|
+
}),
|
|
13
|
+
// The code host's bounds: 100 assets per release, each of at most
|
|
14
|
+
// GIT_STORAGE_MAX_RELEASE_ASSET_BYTES (2 GiB by default).
|
|
15
|
+
fossglobalAssets: Object.freeze({
|
|
16
|
+
label: "foss.global",
|
|
17
|
+
hostAssetNoun: "asset",
|
|
18
|
+
maximumAssets: 100,
|
|
19
|
+
maximumAssetBytes: 2 * 1024 * 1024 * 1024,
|
|
20
|
+
}),
|
|
21
|
+
});
|
|
22
|
+
const maximumManifestBytes = 4 * 1024 * 1024;
|
|
23
|
+
const canonicalName = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
|
|
24
|
+
const sha256Pattern = /^[a-f0-9]{64}$/;
|
|
25
|
+
/**
|
|
26
|
+
* The destination holds something other than the frozen release or asset.
|
|
27
|
+
* Terminal: the claim/inspect executor records it as a destination conflict.
|
|
28
|
+
*/
|
|
29
|
+
export class ReleaseAssetConflictError extends Error {
|
|
30
|
+
constructor(message) {
|
|
31
|
+
super(message);
|
|
32
|
+
this.name = "ReleaseAssetConflictError";
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
const labelOf = (target) => releaseAssetTargets[target].label;
|
|
36
|
+
export const assertReleaseAssetRecord = (target, value) => {
|
|
37
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) {
|
|
38
|
+
throw new Error(`Invalid ${labelOf(target)} asset object.`);
|
|
39
|
+
}
|
|
40
|
+
return value;
|
|
41
|
+
};
|
|
42
|
+
const exactKeys = (target, value, keys) => {
|
|
43
|
+
if (Object.keys(value).sort().join("\0") !== [...keys].sort().join("\0")) {
|
|
44
|
+
throw new Error(`Unexpected ${labelOf(target)} asset manifest fields.`);
|
|
45
|
+
}
|
|
46
|
+
};
|
|
47
|
+
const assertName = (target, value) => {
|
|
48
|
+
if (typeof value !== "string" || !canonicalName.test(value)) {
|
|
49
|
+
throw new Error(`${labelOf(target)} asset names must be canonical single path components.`);
|
|
50
|
+
}
|
|
51
|
+
return value;
|
|
52
|
+
};
|
|
53
|
+
export const assertReleaseAssetTag = (target, value) => {
|
|
54
|
+
if (!canonicalName.test(value) ||
|
|
55
|
+
value.endsWith(".") ||
|
|
56
|
+
value.endsWith(".lock") ||
|
|
57
|
+
value.includes("..")) {
|
|
58
|
+
throw new Error(`${labelOf(target)} asset publication requires a canonical release tag.`);
|
|
59
|
+
}
|
|
60
|
+
};
|
|
61
|
+
const assertSizeAndHash = (target, value) => {
|
|
62
|
+
if (!Number.isSafeInteger(value.size) ||
|
|
63
|
+
value.size < 0 ||
|
|
64
|
+
value.size > releaseAssetTargets[target].maximumAssetBytes ||
|
|
65
|
+
typeof value.sha256 !== "string" ||
|
|
66
|
+
!sha256Pattern.test(value.sha256)) {
|
|
67
|
+
throw new Error(`Invalid ${labelOf(target)} asset size or SHA256.`);
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
export const normalizeReleaseAssetDestination = (target, value) => {
|
|
71
|
+
const candidate = assertReleaseAssetRecord(target, value);
|
|
72
|
+
exactKeys(target, candidate, ["apiOrigin", "owner", "repository"]);
|
|
73
|
+
let url;
|
|
74
|
+
try {
|
|
75
|
+
url = new URL(candidate.apiOrigin);
|
|
76
|
+
}
|
|
77
|
+
catch {
|
|
78
|
+
throw new Error(`Invalid ${labelOf(target)} API origin.`);
|
|
79
|
+
}
|
|
80
|
+
if (url.protocol !== "https:" ||
|
|
81
|
+
url.username ||
|
|
82
|
+
url.password ||
|
|
83
|
+
url.search ||
|
|
84
|
+
url.hash ||
|
|
85
|
+
url.pathname !== "/" ||
|
|
86
|
+
![url.origin, `${url.origin}/`].includes(candidate.apiOrigin)) {
|
|
87
|
+
throw new Error(`${labelOf(target)} API origin must be credential-free canonical HTTPS.`);
|
|
88
|
+
}
|
|
89
|
+
return {
|
|
90
|
+
apiOrigin: url.origin,
|
|
91
|
+
owner: assertName(target, candidate.owner),
|
|
92
|
+
repository: assertName(target, candidate.repository),
|
|
93
|
+
};
|
|
94
|
+
};
|
|
95
|
+
/**
|
|
96
|
+
* The credential of a release asset target from its configured environment
|
|
97
|
+
* variable. Only the variable's name ever appears in a message.
|
|
98
|
+
*/
|
|
99
|
+
export const readReleaseAssetCredential = (target, tokenEnv) => {
|
|
100
|
+
const token = process.env[tokenEnv];
|
|
101
|
+
if (!token)
|
|
102
|
+
throw new Error(`${labelOf(target)} assets require the configured credential in ${tokenEnv}.`);
|
|
103
|
+
return token;
|
|
104
|
+
};
|
|
105
|
+
/** The frozen copy's name in the release record directory, covered by its retention. */
|
|
106
|
+
export const releaseAssetFileName = (target, name) => `asset.${plugins.crypto.createHash("sha256").update(assertName(target, name)).digest("hex")}.bin`;
|
|
107
|
+
/** The anonymous download URL by tag and asset name. */
|
|
108
|
+
export const releaseAssetPublicUrl = (target, destination, tag, name) => {
|
|
109
|
+
const normalized = normalizeReleaseAssetDestination(target, destination);
|
|
110
|
+
assertReleaseAssetTag(target, tag);
|
|
111
|
+
return `${normalized.apiOrigin}/${normalized.owner}/${normalized.repository}/releases/download/${encodeURIComponent(tag)}/${assertName(target, name)}`;
|
|
112
|
+
};
|
|
113
|
+
const assertRelativeAssetPath = (value) => {
|
|
114
|
+
if (typeof value !== "string" ||
|
|
115
|
+
value.length > 4096 ||
|
|
116
|
+
value
|
|
117
|
+
.split("/")
|
|
118
|
+
.some((part) => !canonicalName.test(part) ||
|
|
119
|
+
/^(?:node_modules|coverage|secrets?|credentials?|runtime|data|tmp|temp|id_rsa|id_ed25519)(?:\..*)?$/i.test(part) ||
|
|
120
|
+
/\.(?:pem|key|p12|pfx)$/i.test(part))) {
|
|
121
|
+
throw new Error("Asset inputs require canonical repository paths outside credential/runtime directories.");
|
|
122
|
+
}
|
|
123
|
+
return value;
|
|
124
|
+
};
|
|
125
|
+
/** Reject symlinks in every component, including the caller-provided root. */
|
|
126
|
+
const assertRegularPath = async (target, absolutePath, directory = false) => {
|
|
127
|
+
const resolved = plugins.path.resolve(absolutePath);
|
|
128
|
+
const parsed = plugins.path.parse(resolved);
|
|
129
|
+
let current = parsed.root;
|
|
130
|
+
const parts = resolved
|
|
131
|
+
.slice(parsed.root.length)
|
|
132
|
+
.split(plugins.path.sep)
|
|
133
|
+
.filter(Boolean);
|
|
134
|
+
for (let index = 0; index < parts.length; index++) {
|
|
135
|
+
current = plugins.path.join(current, parts[index]);
|
|
136
|
+
const stat = await plugins.fs.lstat(current);
|
|
137
|
+
const expectDirectory = index < parts.length - 1 || directory;
|
|
138
|
+
if (stat.isSymbolicLink() ||
|
|
139
|
+
(expectDirectory ? !stat.isDirectory() : !stat.isFile())) {
|
|
140
|
+
throw new Error(`${labelOf(target)} asset paths must use regular files and directories without symlinks.`);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
};
|
|
144
|
+
/** Opens a regular file reached without any symlink, read-only. */
|
|
145
|
+
export const openReleaseAssetFile = async (target, path) => {
|
|
146
|
+
await assertRegularPath(target, path);
|
|
147
|
+
const handle = await plugins.fs.open(path, plugins.fsConstants.O_RDONLY | plugins.fsConstants.O_NOFOLLOW);
|
|
148
|
+
try {
|
|
149
|
+
if (!(await handle.stat()).isFile())
|
|
150
|
+
throw new Error(`${labelOf(target)} asset input is not a regular file.`);
|
|
151
|
+
return handle;
|
|
152
|
+
}
|
|
153
|
+
catch (error) {
|
|
154
|
+
await handle.close();
|
|
155
|
+
throw error;
|
|
156
|
+
}
|
|
157
|
+
};
|
|
158
|
+
const readBoundedFile = async (target, path, maximum) => {
|
|
159
|
+
const handle = await openReleaseAssetFile(target, path);
|
|
160
|
+
try {
|
|
161
|
+
if ((await handle.stat()).size > maximum)
|
|
162
|
+
throw new Error(`${labelOf(target)} asset metadata exceeds its size limit.`);
|
|
163
|
+
const chunks = [];
|
|
164
|
+
let size = 0;
|
|
165
|
+
for await (const chunk of handle.createReadStream({
|
|
166
|
+
autoClose: false,
|
|
167
|
+
highWaterMark: 64 * 1024,
|
|
168
|
+
})) {
|
|
169
|
+
size += chunk.length;
|
|
170
|
+
if (size > maximum)
|
|
171
|
+
throw new Error(`${labelOf(target)} asset metadata exceeds its size limit.`);
|
|
172
|
+
chunks.push(chunk);
|
|
173
|
+
}
|
|
174
|
+
return Buffer.concat(chunks, size);
|
|
175
|
+
}
|
|
176
|
+
finally {
|
|
177
|
+
await handle.close();
|
|
178
|
+
}
|
|
179
|
+
};
|
|
180
|
+
/** Hashes the whole open file; its size, hash and timestamps must match the frozen asset. */
|
|
181
|
+
export const verifyReleaseAssetFile = async (target, handle, asset) => {
|
|
182
|
+
const label = labelOf(target);
|
|
183
|
+
const before = await handle.stat();
|
|
184
|
+
if (before.size !== asset.size)
|
|
185
|
+
throw new Error(`Stored ${label} asset size conflicts with its frozen identity.`);
|
|
186
|
+
const hash = plugins.crypto.createHash("sha256");
|
|
187
|
+
let size = 0;
|
|
188
|
+
for await (const chunk of handle.createReadStream({
|
|
189
|
+
autoClose: false,
|
|
190
|
+
start: 0,
|
|
191
|
+
highWaterMark: 64 * 1024,
|
|
192
|
+
})) {
|
|
193
|
+
size += chunk.length;
|
|
194
|
+
if (size > asset.size)
|
|
195
|
+
throw new Error(`Stored ${label} asset exceeds its frozen size.`);
|
|
196
|
+
hash.update(chunk);
|
|
197
|
+
}
|
|
198
|
+
const after = await handle.stat();
|
|
199
|
+
if (size !== asset.size ||
|
|
200
|
+
hash.digest("hex") !== asset.sha256 ||
|
|
201
|
+
before.mtimeMs !== after.mtimeMs ||
|
|
202
|
+
before.ctimeMs !== after.ctimeMs) {
|
|
203
|
+
throw new Error(`Stored ${label} asset bytes conflict with their frozen identity.`);
|
|
204
|
+
}
|
|
205
|
+
};
|
|
206
|
+
export function assertReleaseFrozenAssets(target, assets, destination, tag) {
|
|
207
|
+
const label = labelOf(target);
|
|
208
|
+
if (!Array.isArray(assets) ||
|
|
209
|
+
assets.length === 0 ||
|
|
210
|
+
assets.length > releaseAssetTargets[target].maximumAssets)
|
|
211
|
+
throw new Error(`Invalid ${label} asset set.`);
|
|
212
|
+
const names = new Set();
|
|
213
|
+
for (const entry of assets) {
|
|
214
|
+
const asset = assertReleaseAssetRecord(target, entry);
|
|
215
|
+
exactKeys(target, asset, [
|
|
216
|
+
"name",
|
|
217
|
+
"size",
|
|
218
|
+
"sha256",
|
|
219
|
+
"fileName",
|
|
220
|
+
"publicUrl",
|
|
221
|
+
]);
|
|
222
|
+
const name = assertName(target, asset.name);
|
|
223
|
+
assertSizeAndHash(target, asset);
|
|
224
|
+
if (names.has(name) || asset.fileName !== releaseAssetFileName(target, name))
|
|
225
|
+
throw new Error(`Duplicate or invalid stored ${label} asset identity.`);
|
|
226
|
+
names.add(name);
|
|
227
|
+
let url;
|
|
228
|
+
try {
|
|
229
|
+
url = new URL(asset.publicUrl);
|
|
230
|
+
}
|
|
231
|
+
catch {
|
|
232
|
+
throw new Error(`Invalid frozen ${label} asset URL.`);
|
|
233
|
+
}
|
|
234
|
+
if (url.protocol !== "https:" ||
|
|
235
|
+
url.username ||
|
|
236
|
+
url.password ||
|
|
237
|
+
url.search ||
|
|
238
|
+
url.hash ||
|
|
239
|
+
url.href !== asset.publicUrl ||
|
|
240
|
+
(destination &&
|
|
241
|
+
tag &&
|
|
242
|
+
asset.publicUrl !==
|
|
243
|
+
releaseAssetPublicUrl(target, destination, tag, name))) {
|
|
244
|
+
throw new Error(`Frozen ${label} asset URL conflicts with its destination.`);
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
export const validateReleaseAssets = async (target, artifactDirectory, assets) => {
|
|
249
|
+
assertReleaseFrozenAssets(target, assets);
|
|
250
|
+
await assertRegularPath(target, artifactDirectory, true);
|
|
251
|
+
for (const asset of assets) {
|
|
252
|
+
const handle = await openReleaseAssetFile(target, plugins.path.join(artifactDirectory, asset.fileName));
|
|
253
|
+
try {
|
|
254
|
+
await verifyReleaseAssetFile(target, handle, asset);
|
|
255
|
+
}
|
|
256
|
+
finally {
|
|
257
|
+
await handle.close();
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
};
|
|
261
|
+
/**
|
|
262
|
+
* Reads the manifest `{schemaVersion: 1, version, assets: [{name, path, size,
|
|
263
|
+
* sha256}]}` and freezes each listed file into the release record directory,
|
|
264
|
+
* proving its bytes before and after the copy.
|
|
265
|
+
*/
|
|
266
|
+
export const prepareReleaseAssets = async (target, options) => {
|
|
267
|
+
const label = labelOf(target);
|
|
268
|
+
const destination = normalizeReleaseAssetDestination(target, options.destination);
|
|
269
|
+
assertReleaseAssetTag(target, options.tag);
|
|
270
|
+
if (!/^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/.test(options.version))
|
|
271
|
+
throw new Error(`Invalid ${label} asset manifest release version.`);
|
|
272
|
+
await assertRegularPath(target, options.repositoryRoot, true);
|
|
273
|
+
const manifestPath = plugins.path.join(options.repositoryRoot, assertRelativeAssetPath(options.manifestPath));
|
|
274
|
+
let manifest;
|
|
275
|
+
try {
|
|
276
|
+
manifest = assertReleaseAssetRecord(target, JSON.parse((await readBoundedFile(target, manifestPath, maximumManifestBytes)).toString("utf8")));
|
|
277
|
+
}
|
|
278
|
+
catch {
|
|
279
|
+
throw new Error(`Unable to read a bounded regular ${label} asset manifest.`);
|
|
280
|
+
}
|
|
281
|
+
exactKeys(target, manifest, ["schemaVersion", "version", "assets"]);
|
|
282
|
+
if (manifest.schemaVersion !== 1 ||
|
|
283
|
+
manifest.version !== options.version ||
|
|
284
|
+
!Array.isArray(manifest.assets) ||
|
|
285
|
+
manifest.assets.length === 0 ||
|
|
286
|
+
manifest.assets.length > releaseAssetTargets[target].maximumAssets)
|
|
287
|
+
throw new Error(`${label} asset manifest must match the exact release version and schema.`);
|
|
288
|
+
const paths = new Set();
|
|
289
|
+
const assets = manifest.assets.map((entry) => {
|
|
290
|
+
const input = assertReleaseAssetRecord(target, entry);
|
|
291
|
+
exactKeys(target, input, ["name", "path", "size", "sha256"]);
|
|
292
|
+
const path = assertRelativeAssetPath(input.path);
|
|
293
|
+
if (paths.has(path))
|
|
294
|
+
throw new Error(`${label} asset input paths must be unique.`);
|
|
295
|
+
paths.add(path);
|
|
296
|
+
const name = assertName(target, input.name);
|
|
297
|
+
assertSizeAndHash(target, input);
|
|
298
|
+
return {
|
|
299
|
+
name,
|
|
300
|
+
size: input.size,
|
|
301
|
+
sha256: input.sha256,
|
|
302
|
+
fileName: releaseAssetFileName(target, name),
|
|
303
|
+
publicUrl: releaseAssetPublicUrl(target, destination, options.tag, name),
|
|
304
|
+
};
|
|
305
|
+
});
|
|
306
|
+
assertReleaseFrozenAssets(target, assets, destination, options.tag);
|
|
307
|
+
// The journal owner creates this directory; never follow/create an unexpected root here.
|
|
308
|
+
await assertRegularPath(target, options.artifactDirectory, true);
|
|
309
|
+
for (let index = 0; index < assets.length; index++) {
|
|
310
|
+
const asset = assets[index];
|
|
311
|
+
const inputPath = plugins.path.join(options.repositoryRoot, [...paths][index]);
|
|
312
|
+
const input = await openReleaseAssetFile(target, inputPath);
|
|
313
|
+
try {
|
|
314
|
+
await verifyReleaseAssetFile(target, input, asset);
|
|
315
|
+
const outputPath = plugins.path.join(options.artifactDirectory, asset.fileName);
|
|
316
|
+
const output = await plugins.fs.open(outputPath, "wx", 0o600);
|
|
317
|
+
try {
|
|
318
|
+
let position = 0;
|
|
319
|
+
for await (const chunk of input.createReadStream({
|
|
320
|
+
autoClose: false,
|
|
321
|
+
start: 0,
|
|
322
|
+
highWaterMark: 64 * 1024,
|
|
323
|
+
})) {
|
|
324
|
+
if (position + chunk.length > asset.size)
|
|
325
|
+
throw new Error(`${label} asset changed during freezing.`);
|
|
326
|
+
let written = 0;
|
|
327
|
+
while (written < chunk.length) {
|
|
328
|
+
const result = await output.write(chunk, written, chunk.length - written, position + written);
|
|
329
|
+
if (!result.bytesWritten)
|
|
330
|
+
throw new Error(`Unable to freeze complete ${label} asset bytes.`);
|
|
331
|
+
written += result.bytesWritten;
|
|
332
|
+
}
|
|
333
|
+
position += chunk.length;
|
|
334
|
+
}
|
|
335
|
+
await output.sync();
|
|
336
|
+
}
|
|
337
|
+
finally {
|
|
338
|
+
await output.close();
|
|
339
|
+
}
|
|
340
|
+
// Includes detecting same-size mutation between the validation and copy passes.
|
|
341
|
+
await validateReleaseAssets(target, options.artifactDirectory, [asset]);
|
|
342
|
+
}
|
|
343
|
+
finally {
|
|
344
|
+
await input.close();
|
|
345
|
+
}
|
|
346
|
+
}
|
|
347
|
+
return assets;
|
|
348
|
+
};
|
|
349
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5yZWxlYXNlYXNzZXRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvbW9kX3JlbGVhc2UvaGVscGVycy5yZWxlYXNlYXNzZXRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFVNUM7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBRTVCLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDaEIsV0FBVyxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUM7UUFDekIsS0FBSyxFQUFFLE9BQU87UUFDZCxhQUFhLEVBQUUsWUFBWTtRQUMzQixhQUFhLEVBQUUsSUFBSTtRQUNuQixpQkFBaUIsRUFBRSxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksR0FBRyxJQUFJO0tBQzNDLENBQUM7SUFDRixrRUFBa0U7SUFDbEUsMERBQTBEO0lBQzFELGdCQUFnQixFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUM7UUFDOUIsS0FBSyxFQUFFLGFBQWE7UUFDcEIsYUFBYSxFQUFFLE9BQU87UUFDdEIsYUFBYSxFQUFFLEdBQUc7UUFDbEIsaUJBQWlCLEVBQUUsQ0FBQyxHQUFHLElBQUksR0FBRyxJQUFJLEdBQUcsSUFBSTtLQUMxQyxDQUFDO0NBQ0gsQ0FBQyxDQUFDO0FBRUgsTUFBTSxvQkFBb0IsR0FBRyxDQUFDLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUM3QyxNQUFNLGFBQWEsR0FBRyxvQ0FBb0MsQ0FBQztBQUMzRCxNQUFNLGFBQWEsR0FBRyxnQkFBZ0IsQ0FBQztBQUV2Qzs7O0dBR0c7QUFDSCxNQUFNLE9BQU8seUJBQTBCLFNBQVEsS0FBSztJQUNsRCxZQUFZLE9BQWU7UUFDekIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ2YsSUFBSSxDQUFDLElBQUksR0FBRywyQkFBMkIsQ0FBQztJQUMxQyxDQUFDO0NBQ0Y7QUFFRCxNQUFNLE9BQU8sR0FB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
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { type TReleaseAssetFileHandle } from "./helpers.releaseassets.js";
|
|
2
|
+
import type { IReleaseAssetTransferFailures, IReleaseAssetTransferLimits, TReleaseAssetRequestFailureReason, TReleaseAssetTargetName, TReleaseAssetTransferDirection } from "./interfaces.releaseassets.js";
|
|
3
|
+
/** A duration as transfer messages print it: seconds with one decimal. */
|
|
4
|
+
export declare const formatReleaseAssetSeconds: (milliseconds: number) => string;
|
|
5
|
+
/**
|
|
6
|
+
* A request failure gitzone detected itself. Its message is the target's
|
|
7
|
+
* label in the fixed phrase of its reason and nothing else, so it carries no
|
|
8
|
+
* URL, header, body or token, and a request failure description prints it in
|
|
9
|
+
* full. The name stays `Error`; the message says what failed.
|
|
10
|
+
*/
|
|
11
|
+
export declare class ReleaseAssetRequestError extends Error {
|
|
12
|
+
readonly reason: TReleaseAssetRequestFailureReason;
|
|
13
|
+
constructor(target: TReleaseAssetTargetName, reason: TReleaseAssetRequestFailureReason);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Names why a request ended: the HTTP status it reached, each error of the
|
|
17
|
+
* cause chain by name and code, and how far the transfer got. A message is
|
|
18
|
+
* printed in full when gitzone raised it (a ReleaseAssetRequestError);
|
|
19
|
+
* any other error's message only when it is plain words ("terminated",
|
|
20
|
+
* "fetch failed", "other side closed"), since its text may carry a URL.
|
|
21
|
+
*/
|
|
22
|
+
export declare const describeReleaseAssetRequestFailure: (error: unknown, evidence: {
|
|
23
|
+
status?: number;
|
|
24
|
+
progress: string;
|
|
25
|
+
}) => string;
|
|
26
|
+
export declare const defaultReleaseAssetTransferLimits: Readonly<IReleaseAssetTransferLimits>;
|
|
27
|
+
export declare const assertReleaseAssetTransferLimits: (target: TReleaseAssetTargetName, limits: IReleaseAssetTransferLimits) => IReleaseAssetTransferLimits;
|
|
28
|
+
/**
|
|
29
|
+
* Bounds one request by progress instead of wall-clock time: the response
|
|
30
|
+
* bound covers waiting for headers, the stall bound restarts on every byte,
|
|
31
|
+
* an upload's acknowledgement wait scales with its size, and a ceiling of
|
|
32
|
+
* expected bytes at the rate floor ends a trickle. The target's failures
|
|
33
|
+
* name the bound that ended it.
|
|
34
|
+
*/
|
|
35
|
+
export declare class ReleaseAssetTransferWatchdog<TFailure extends Error> {
|
|
36
|
+
#private;
|
|
37
|
+
private readonly failures;
|
|
38
|
+
private readonly operation;
|
|
39
|
+
private readonly limits;
|
|
40
|
+
/** Bytes the request moves in total, including an upload body. */
|
|
41
|
+
private readonly expectedBytes;
|
|
42
|
+
private readonly uploadBytes;
|
|
43
|
+
constructor(failures: IReleaseAssetTransferFailures<TFailure>, operation: string, limits: IReleaseAssetTransferLimits,
|
|
44
|
+
/** Bytes the request moves in total, including an upload body. */
|
|
45
|
+
expectedBytes: number, uploadBytes?: number);
|
|
46
|
+
get signal(): AbortSignal;
|
|
47
|
+
get failure(): TFailure | undefined;
|
|
48
|
+
/** Bytes sent and received so far. */
|
|
49
|
+
get bytes(): number;
|
|
50
|
+
/** Wait for response headers; every redirect hop starts a new wait. */
|
|
51
|
+
awaitResponse(): void;
|
|
52
|
+
/** The whole upload body is sent; wait for the server to store and answer it. */
|
|
53
|
+
awaitAcknowledgement(): void;
|
|
54
|
+
/** Record moved bytes; the stall bound restarts from this moment. */
|
|
55
|
+
progress(direction: TReleaseAssetTransferDirection, bytes: number): void;
|
|
56
|
+
close(): void;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Streams exactly `size` bytes of the open file as a request body, pulled: the
|
|
60
|
+
* next chunk is read only when fetch has taken the last one, so progress means
|
|
61
|
+
* bytes the transport accepted. Sent with a `Content-Length` header, fetch
|
|
62
|
+
* (undici) writes that fixed length, never chunked transfer encoding, and
|
|
63
|
+
* fails the request when the body yields more or fewer bytes.
|
|
64
|
+
*/
|
|
65
|
+
export declare const createReleaseAssetUploadBody: <TFailure extends Error>(target: TReleaseAssetTargetName, handle: TReleaseAssetFileHandle, size: number, watchdog: ReleaseAssetTransferWatchdog<TFailure>) => ReadableStream<Uint8Array>;
|
|
66
|
+
/** Reads a whole response body of at most `maximum` bytes; every chunk is progress. */
|
|
67
|
+
export declare const readReleaseAssetResponse: <TFailure extends Error>(target: TReleaseAssetTargetName, response: Response, maximum: number, watchdog: ReleaseAssetTransferWatchdog<TFailure>) => Promise<Buffer>;
|