@git.zone/cli 8.6.0 → 8.7.1

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 (32) hide show
  1. package/assets/templates/asset_tspack_release_gitea/scripts/gitzone-release-api.mjs +9 -3
  2. package/assets/templates/asset_tspack_release_gitea/scripts/gitzone-sealed-release.mjs +10 -3
  3. package/assets/templates/vscode/.vscode/settings.json +57 -0
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/classes.gitzoneconfig.d.ts +3 -0
  6. package/dist_ts/classes.gitzoneconfig.js +1 -1
  7. package/dist_ts/helpers.objects.d.ts +2 -0
  8. package/dist_ts/helpers.objects.js +3 -0
  9. package/dist_ts/helpers.packagefiles.d.ts +74 -0
  10. package/dist_ts/helpers.packagefiles.js +177 -0
  11. package/dist_ts/helpers.workflow.d.ts +18 -0
  12. package/dist_ts/helpers.workflow.js +45 -2
  13. package/dist_ts/mod_config/index.js +69 -2
  14. package/dist_ts/mod_format/formatters/packagejson.formatter.js +8 -27
  15. package/dist_ts/mod_release/helpers.npmartifactcheck.d.ts +93 -0
  16. package/dist_ts/mod_release/helpers.npmartifactcheck.js +279 -0
  17. package/dist_ts/mod_release/index.d.ts +15 -0
  18. package/dist_ts/mod_release/index.js +82 -17
  19. package/dist_ts/plugins.d.ts +2 -1
  20. package/dist_ts/plugins.js +3 -2
  21. package/package.json +4 -3
  22. package/readme.md +107 -15
  23. package/ts/00_commitinfo_data.ts +1 -1
  24. package/ts/classes.gitzoneconfig.ts +3 -0
  25. package/ts/helpers.objects.ts +5 -0
  26. package/ts/helpers.packagefiles.ts +273 -0
  27. package/ts/helpers.workflow.ts +70 -1
  28. package/ts/mod_config/index.ts +78 -0
  29. package/ts/mod_format/formatters/packagejson.formatter.ts +7 -27
  30. package/ts/mod_release/helpers.npmartifactcheck.ts +397 -0
  31. package/ts/mod_release/index.ts +115 -26
  32. package/ts/plugins.ts +2 -0
@@ -2,6 +2,7 @@ import { BaseFormatter } from '../classes.baseformatter.js';
2
2
  import * as plugins from '../mod.plugins.js';
3
3
  import * as paths from '../../paths.js';
4
4
  import { logger, logVerbose } from '../../gitzone.logging.js';
5
+ import { resolvePackageFiles } from '../../helpers.packagefiles.js';
5
6
  export class PackageJsonFormatter extends BaseFormatter {
6
7
  get name() {
7
8
  return 'packagejson';
@@ -86,32 +87,12 @@ export class PackageJsonFormatter extends BaseFormatter {
86
87
  delete packageJson.scripts.postinstall;
87
88
  }
88
89
  }
89
- // Set files array
90
- const sourceFolders = ['ts', 'ts_web'];
91
- const files = [
92
- ...sourceFolders.map((folderArg) => `${folderArg}/**/*`),
93
- 'dist/**/*',
94
- 'dist_*/**/*',
95
- 'dist_ts/**/*',
96
- 'dist_ts_web/**/*',
97
- 'assets/**/*',
98
- 'cli.js',
99
- '.smartconfig.json',
100
- 'readme.md',
101
- ];
102
- if (assetsConfig?.kind === 'denoBinaryCli' && assetsConfig.installer?.enabled !== false) {
103
- files.push(assetsConfig.installer?.file || 'install.sh');
104
- }
105
- if (assetsConfig?.kind === 'denoBinaryCli' && assetsConfig.npmWrapper?.enabled) {
106
- files.push('bin/');
107
- files.push(assetsConfig.npmWrapper.postinstallFile || 'scripts/install-binary.js');
108
- }
109
- // @git.zone/tsbuild reads a folder's compiler options from <folder>/tsconfig.json,
110
- // which extends the root tsconfig.json. The package does not ship the root file,
111
- // so a shipped folder file would extend a file that is not there. pnpm 10 and 12
112
- // apply an exclusion only after the entries that include the file, so it comes last.
113
- files.push(...sourceFolders.map((folderArg) => `!${folderArg}/tsconfig.json`));
114
- packageJson.files = [...new Set(files)];
90
+ // gitzone format is the one writer of `files`; see helpers.packagefiles.ts.
91
+ packageJson.files = resolvePackageFiles({
92
+ packageFiles: gitzoneData.packageFiles,
93
+ assets: rawAssetsConfig,
94
+ manifest: packageJson,
95
+ });
115
96
  // Set pnpm overrides from assets
116
97
  try {
117
98
  const overridesContent = (await plugins.smartfs
@@ -146,4 +127,4 @@ export class PackageJsonFormatter extends BaseFormatter {
146
127
  logger.log('info', 'Updated package.json');
147
128
  }
148
129
  }
149
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFja2FnZWpzb24uZm9ybWF0dGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvbW9kX2Zvcm1hdC9mb3JtYXR0ZXJzL3BhY2thZ2Vqc29uLmZvcm1hdHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFNUQsT0FBTyxLQUFLLE9BQU8sTUFBTSxtQkFBbUIsQ0FBQztBQUM3QyxPQUFPLEtBQUssS0FBSyxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxNQUFNLEVBQUUsVUFBVSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFOUQsTUFBTSxPQUFPLG9CQUFxQixTQUFRLGFBQWE7SUFDckQsSUFBSSxJQUFJO1FBQ04sT0FBTyxhQUFhLENBQUM7SUFDdkIsQ0FBQztJQUVELEtBQUssQ0FBQyxPQUFPO1FBQ1gsTUFBTSxPQUFPLEdBQXFCLEVBQUUsQ0FBQztRQUNyQyxNQUFNLGVBQWUsR0FBRyxjQUFjLENBQUM7UUFFdkMsdUJBQXVCO1FBQ3ZCLE1BQU0sTUFBTSxHQUFHLE1BQU0sT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDcEUsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ1osVUFBVSxDQUFDLHVDQUF1QyxDQUFDLENBQUM7WUFDcEQsT0FBTyxPQUFPLENBQUM7UUFDakIsQ0FBQztRQUVELHVCQUF1QjtRQUN2QixNQUFNLGNBQWMsR0FBRyxDQUFDLE1BQU0sT0FBTyxDQUFDLE9BQU87YUFDMUMsSUFBSSxDQUFDLGVBQWUsQ0FBQzthQUNyQixRQUFRLENBQUMsTUFBTSxDQUFDO2FBQ2hCLElBQUksRUFBRSxDQUFXLENBQUM7UUFFckIsZ0NBQWdDO1FBQ2hDLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLENBQUM7UUFFL0Ms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
130
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFja2FnZWpzb24uZm9ybWF0dGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvbW9kX2Zvcm1hdC9mb3JtYXR0ZXJzL3BhY2thZ2Vqc29uLmZvcm1hdHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFNUQsT0FBTyxLQUFLLE9BQU8sTUFBTSxtQkFBbUIsQ0FBQztBQUM3QyxPQUFPLEtBQUssS0FBSyxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxNQUFNLEVBQUUsVUFBVSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFcEUsTUFBTSxPQUFPLG9CQUFxQixTQUFRLGFBQWE7SUFDckQsSUFBSSxJQUFJO1FBQ04sT0FBTyxhQUFhLENBQUM7SUFDdkIsQ0FBQztJQUVELEtBQUssQ0FBQyxPQUFPO1FBQ1gsTUFBTSxPQUFPLEdBQXFCLEVBQUUsQ0FBQztRQUNyQyxNQUFNLGVBQWUsR0FBRyxjQUFjLENBQUM7UUFFdkMsdUJBQXVCO1FBQ3ZCLE1BQU0sTUFBTSxHQUFHLE1BQU0sT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDcEUsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ1osVUFBVSxDQUFDLHVDQUF1QyxDQUFDLENBQUM7WUFDcEQsT0FBTyxPQUFPLENBQUM7UUFDakIsQ0FBQztRQUVELHVCQUF1QjtRQUN2QixNQUFNLGNBQWMsR0FBRyxDQUFDLE1BQU0sT0FBTyxDQUFDLE9BQU87YUFDMUMsSUFBSSxDQUFDLGVBQWUsQ0FBQzthQUNyQixRQUFRLENBQUMsTUFBTSxDQUFDO2FBQ2hCLElBQUksRUFBRSxDQUFXLENBQUM7UUFFckIsZ0NBQWdDO1FBQ2hDLE1BQU0sV0FBVyxH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
@@ -0,0 +1,93 @@
1
+ import type { IReleaseArtifact, TReleaseNpmAccess } from "./classes.releasejournal.js";
2
+ import type { IResolvedReleaseWorkflow } from "../helpers.workflow.js";
3
+ /** The packed-artifact check that refused a release. */
4
+ export type TNpmArtifactCheck = "contents" | "entryPoints" | "publishSize";
5
+ /**
6
+ * A packed tarball failed `core.packNpmArtifact.entryPoints` or
7
+ * `core.packNpmArtifact.publishSize`. The release commit itself causes the
8
+ * failure, so preparing the same commit again fails the same way.
9
+ */
10
+ export declare class NpmArtifactCheckError extends Error {
11
+ readonly check: TNpmArtifactCheck;
12
+ constructor(checkArg: TNpmArtifactCheck, messageArg: string);
13
+ }
14
+ /** The artifact check error in an error's cause chain, if there is one. */
15
+ export declare const findNpmArtifactCheckError: (errorArg: unknown) => NpmArtifactCheckError | undefined;
16
+ /** What a packed npm tarball holds, read from the tarball itself. */
17
+ export interface INpmArtifactContents {
18
+ /** Every regular file, relative to the package root. */
19
+ files: string[];
20
+ /** The packed package.json, as pnpm wrote it into the tarball. */
21
+ manifest: Record<string, unknown>;
22
+ /** The root readme.md the publish document carries, when there is one. */
23
+ readme?: string;
24
+ }
25
+ /** How much of a packed tarball the checks read before they refuse it. */
26
+ export interface INpmArtifactReadLimits {
27
+ maxUncompressedArchiveBytes: number;
28
+ maxEntries: number;
29
+ /** For the selected package.json and readme, each. */
30
+ maxUncompressedEntryBytes: number;
31
+ }
32
+ export declare const defaultNpmArtifactReadLimits: INpmArtifactReadLimits;
33
+ /**
34
+ * Reads the packed file list, manifest and readme from the tarball. pnpm 12
35
+ * puts a root `readme.md` (any case) into the publish document and prefers
36
+ * `README.md` when there are several. A tarball beyond the read limits comes
37
+ * from the release commit, so it fails as an `NpmArtifactCheckError`.
38
+ */
39
+ export declare const readNpmArtifactContents: (artifactPathArg: string, limitsArg?: INpmArtifactReadLimits) => Promise<INpmArtifactContents>;
40
+ /**
41
+ * Every `main`, `module`, `types`/`typings`, `bin` and `exports` target the
42
+ * packed manifest names, with the reason each missing one is missing. An
43
+ * `exports` target with `*` must match at least one packed file, and a
44
+ * folder target (trailing `/`) must contain one.
45
+ */
46
+ export declare const findMissingNpmEntryPoints: (contentsArg: Pick<INpmArtifactContents, "files" | "manifest">) => string[];
47
+ export declare const assertNpmEntryPointsPacked: (contentsArg: Pick<INpmArtifactContents, "files" | "manifest">, packageNameArg: string) => void;
48
+ export interface INpmPublishBodyOptions {
49
+ contents: Pick<INpmArtifactContents, "manifest" | "readme">;
50
+ artifact: Pick<IReleaseArtifact, "packageName" | "version" | "size" | "sha1" | "integrity">;
51
+ registry: string;
52
+ distTag: string;
53
+ access: TReleaseNpmAccess;
54
+ }
55
+ /**
56
+ * The byte length of the document `pnpm publish <tarball>` PUTs to a
57
+ * registry: the packed manifest with its readme and `dist` record, the
58
+ * dist-tag, the access level, and the tarball as base64. Measured against
59
+ * pnpm 12's actual upload; it is an estimate for other publishers.
60
+ */
61
+ export declare const estimateNpmPublishBodyBytes: (optionsArg: INpmPublishBodyOptions) => number;
62
+ export interface INpmPublishSizeCheck {
63
+ registry: string;
64
+ bodyBytes: number;
65
+ limit?: number;
66
+ }
67
+ /**
68
+ * The packed size and the estimated publish body per registry, checked
69
+ * against the registry's configured `maxPublishBytes`. Prints both and fails
70
+ * when a body exceeds its registry's limit. Without limits it only reports.
71
+ */
72
+ export declare const assertNpmPublishSize: (optionsArg: {
73
+ contents: Pick<INpmArtifactContents, "manifest" | "readme">;
74
+ artifact: Pick<IReleaseArtifact, "packageName" | "version" | "size" | "sha1" | "integrity">;
75
+ registries: string[];
76
+ distTag: string;
77
+ access: TReleaseNpmAccess;
78
+ maxPublishBytes: Record<string, number>;
79
+ log?: (lineArg: string) => void;
80
+ }) => INpmPublishSizeCheck[];
81
+ /**
82
+ * The checks between packing and the journal: every packed tarball must
83
+ * carry its entry points (`core.packNpmArtifact.entryPoints`), and its
84
+ * publish body must fit every registry limit (`core.packNpmArtifact.publishSize`).
85
+ * The size of each tarball and body is printed either way. A failure here
86
+ * leaves the release where a failed pack leaves it.
87
+ */
88
+ export declare const verifyPackedNpmArtifacts: (optionsArg: {
89
+ workflow: Pick<IResolvedReleaseWorkflow, "npmRegistries" | "npmDistTag" | "npmAccessLevel" | "npmMaxPublishBytes">;
90
+ artifactDirectory: string;
91
+ artifacts: IReleaseArtifact[];
92
+ log?: (lineArg: string) => void;
93
+ }) => Promise<void>;
@@ -0,0 +1,279 @@
1
+ import * as plugins from "./mod.plugins.js";
2
+ import { normalizeNpmRegistryUrl } from "./helpers.npmartifact.js";
3
+ import { isPlainObject } from "../helpers.objects.js";
4
+ /**
5
+ * A packed tarball failed `core.packNpmArtifact.entryPoints` or
6
+ * `core.packNpmArtifact.publishSize`. The release commit itself causes the
7
+ * failure, so preparing the same commit again fails the same way.
8
+ */
9
+ export class NpmArtifactCheckError extends Error {
10
+ check;
11
+ constructor(checkArg, messageArg) {
12
+ super(messageArg);
13
+ this.name = "NpmArtifactCheckError";
14
+ this.check = checkArg;
15
+ }
16
+ }
17
+ /** The artifact check error in an error's cause chain, if there is one. */
18
+ export const findNpmArtifactCheckError = (errorArg) => {
19
+ let current = errorArg;
20
+ for (let depth = 0; depth < 16 && current instanceof Error; depth++) {
21
+ if (current instanceof NpmArtifactCheckError)
22
+ return current;
23
+ current = current.cause;
24
+ }
25
+ return undefined;
26
+ };
27
+ const packagePrefix = "package/";
28
+ export const defaultNpmArtifactReadLimits = {
29
+ maxUncompressedArchiveBytes: 2 * 1024 ** 3,
30
+ maxEntries: 1_000_000,
31
+ maxUncompressedEntryBytes: 64 * 1024 ** 2,
32
+ };
33
+ /** The limits a tarball itself can exceed; they refuse it like a failed check. */
34
+ const artifactLimitCodes = new Set([
35
+ plugins.smartarchive.GZIP_ERROR_CODES.UNCOMPRESSED_SIZE_LIMIT,
36
+ plugins.smartarchive.TAR_ERROR_CODES.ENTRY_COUNT_LIMIT,
37
+ plugins.smartarchive.TAR_ERROR_CODES.UNCOMPRESSED_SIZE_LIMIT,
38
+ plugins.smartarchive.TAR_ERROR_CODES.TOTAL_UNCOMPRESSED_SIZE_LIMIT,
39
+ ]);
40
+ /**
41
+ * Reads the packed file list, manifest and readme from the tarball. pnpm 12
42
+ * puts a root `readme.md` (any case) into the publish document and prefers
43
+ * `README.md` when there are several. A tarball beyond the read limits comes
44
+ * from the release commit, so it fails as an `NpmArtifactCheckError`.
45
+ */
46
+ export const readNpmArtifactContents = async (artifactPathArg, limitsArg = defaultNpmArtifactReadLimits) => {
47
+ const bytes = await plugins.fs.readFile(artifactPathArg);
48
+ const files = [];
49
+ let entries;
50
+ try {
51
+ entries = await new plugins.smartarchive.TarTools().extractSelectedTarGzEntries(bytes, {
52
+ filter: (entryArg) => {
53
+ if (entryArg.entryType !== "file" || !entryArg.path.startsWith(packagePrefix))
54
+ return false;
55
+ const path = entryArg.path.slice(packagePrefix.length);
56
+ files.push(path);
57
+ return path === "package.json" || path.toLowerCase() === "readme.md";
58
+ },
59
+ maxArchiveBytes: bytes.byteLength,
60
+ maxUncompressedArchiveBytes: limitsArg.maxUncompressedArchiveBytes,
61
+ maxEntries: limitsArg.maxEntries,
62
+ maxSelectedEntries: 64,
63
+ maxUncompressedEntryBytes: limitsArg.maxUncompressedEntryBytes,
64
+ maxTotalUncompressedBytes: 4 * limitsArg.maxUncompressedEntryBytes,
65
+ });
66
+ }
67
+ catch (error) {
68
+ if (error instanceof plugins.smartarchive.SmartArchiveError &&
69
+ artifactLimitCodes.has(error.code)) {
70
+ throw new NpmArtifactCheckError("contents", `The packed tarball ${plugins.path.basename(artifactPathArg)} exceeds what the release reads to check it (${error.code}: ${error.message}; at most ${limitsArg.maxUncompressedArchiveBytes} bytes unpacked, ${limitsArg.maxEntries} entries). Leave files out through @git.zone/cli.packageFiles, then \`gitzone format\`.`);
71
+ }
72
+ throw error;
73
+ }
74
+ const decoder = new TextDecoder();
75
+ const manifestEntry = entries.find((entryArg) => entryArg.path === `${packagePrefix}package.json`);
76
+ if (!manifestEntry)
77
+ throw new Error("The packed npm artifact carries no package/package.json.");
78
+ const manifest = JSON.parse(decoder.decode(manifestEntry.content));
79
+ if (!isPlainObject(manifest))
80
+ throw new Error("The packed package.json is not a JSON object.");
81
+ const readmes = entries.filter((entryArg) => entryArg.path !== `${packagePrefix}package.json`);
82
+ const readme = readmes.find((entryArg) => entryArg.path === `${packagePrefix}README.md`) ??
83
+ readmes[0];
84
+ return {
85
+ files,
86
+ manifest,
87
+ ...(readme ? { readme: decoder.decode(readme.content) } : {}),
88
+ };
89
+ };
90
+ const normalizeTarget = (targetArg) => targetArg.replace(/^(\.\/)+/, "");
91
+ /** Node's resolution of a `main` without its extension or as a folder. */
92
+ const mainCandidates = (mainArg) => {
93
+ const main = normalizeTarget(mainArg).replace(/\/+$/, "");
94
+ return [
95
+ main,
96
+ `${main}.js`,
97
+ `${main}.json`,
98
+ `${main}.node`,
99
+ `${main}/index.js`,
100
+ `${main}/index.json`,
101
+ `${main}/index.node`,
102
+ ];
103
+ };
104
+ const collectExportTargets = (valueArg, fieldArg, targetsArg) => {
105
+ if (typeof valueArg === "string") {
106
+ targetsArg.push({ field: fieldArg, target: valueArg });
107
+ }
108
+ else if (Array.isArray(valueArg)) {
109
+ valueArg.forEach((itemArg, indexArg) => collectExportTargets(itemArg, `${fieldArg}[${indexArg}]`, targetsArg));
110
+ }
111
+ else if (isPlainObject(valueArg)) {
112
+ for (const [keyArg, itemArg] of Object.entries(valueArg))
113
+ collectExportTargets(itemArg, `${fieldArg}[${JSON.stringify(keyArg)}]`, targetsArg);
114
+ }
115
+ };
116
+ const escapeRegExp = (valueArg) => valueArg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
117
+ /**
118
+ * Every `main`, `module`, `types`/`typings`, `bin` and `exports` target the
119
+ * packed manifest names, with the reason each missing one is missing. An
120
+ * `exports` target with `*` must match at least one packed file, and a
121
+ * folder target (trailing `/`) must contain one.
122
+ */
123
+ export const findMissingNpmEntryPoints = (contentsArg) => {
124
+ const files = new Set(contentsArg.files);
125
+ const manifest = contentsArg.manifest;
126
+ const missing = [];
127
+ if (typeof manifest.main === "string") {
128
+ if (!mainCandidates(manifest.main).some((candidateArg) => files.has(candidateArg)))
129
+ missing.push(`main -> ${manifest.main}`);
130
+ }
131
+ const plain = [];
132
+ for (const field of ["module", "types", "typings"]) {
133
+ const value = manifest[field];
134
+ if (typeof value === "string")
135
+ plain.push({ field, target: value });
136
+ }
137
+ if (typeof manifest.bin === "string") {
138
+ plain.push({ field: "bin", target: manifest.bin });
139
+ }
140
+ else if (isPlainObject(manifest.bin)) {
141
+ for (const [name, target] of Object.entries(manifest.bin))
142
+ if (typeof target === "string")
143
+ plain.push({ field: `bin[${JSON.stringify(name)}]`, target });
144
+ }
145
+ for (const entry of plain)
146
+ if (!files.has(normalizeTarget(entry.target)))
147
+ missing.push(`${entry.field} -> ${entry.target}`);
148
+ const exportTargets = [];
149
+ collectExportTargets(manifest.exports, "exports", exportTargets);
150
+ for (const entry of exportTargets) {
151
+ // Only package-relative targets name files; anything else is not ours to check.
152
+ if (!entry.target.startsWith("./"))
153
+ continue;
154
+ const target = normalizeTarget(entry.target);
155
+ let present;
156
+ if (target.includes("*")) {
157
+ const pattern = new RegExp(`^${target.split("*").map(escapeRegExp).join(".+")}$`);
158
+ present = contentsArg.files.some((fileArg) => pattern.test(fileArg));
159
+ }
160
+ else if (target.endsWith("/")) {
161
+ present = contentsArg.files.some((fileArg) => fileArg.startsWith(target));
162
+ }
163
+ else {
164
+ present = files.has(target);
165
+ }
166
+ if (!present)
167
+ missing.push(`${entry.field} -> ${entry.target}`);
168
+ }
169
+ return missing;
170
+ };
171
+ export const assertNpmEntryPointsPacked = (contentsArg, packageNameArg) => {
172
+ const missing = findMissingNpmEntryPoints(contentsArg);
173
+ if (missing.length === 0)
174
+ return;
175
+ throw new NpmArtifactCheckError("entryPoints", `The packed ${packageNameArg} tarball lacks entry points its package.json names: ${missing.join("; ")}. ` +
176
+ "Ship them through package.json files (@git.zone/cli.packageFiles, then `gitzone format`) or fix the build.");
177
+ };
178
+ /**
179
+ * The byte length of the document `pnpm publish <tarball>` PUTs to a
180
+ * registry: the packed manifest with its readme and `dist` record, the
181
+ * dist-tag, the access level, and the tarball as base64. Measured against
182
+ * pnpm 12's actual upload; it is an estimate for other publishers.
183
+ */
184
+ export const estimateNpmPublishBodyBytes = (optionsArg) => {
185
+ const { artifact, contents } = optionsArg;
186
+ const name = artifact.packageName;
187
+ const registry = normalizeNpmRegistryUrl(optionsArg.registry);
188
+ const description = contents.manifest.description;
189
+ const placeholder = "\u0000";
190
+ const document = {
191
+ _id: name,
192
+ name,
193
+ ...(description !== undefined ? { description } : {}),
194
+ "dist-tags": { [optionsArg.distTag]: artifact.version },
195
+ versions: {
196
+ [artifact.version]: {
197
+ ...contents.manifest,
198
+ ...(contents.readme !== undefined ? { readme: contents.readme } : {}),
199
+ _id: `${name}@${artifact.version}`,
200
+ dist: {
201
+ integrity: artifact.integrity,
202
+ shasum: artifact.sha1,
203
+ tarball: `${registry}/${name}/-/${name}-${artifact.version}.tgz`,
204
+ },
205
+ },
206
+ },
207
+ access: optionsArg.access === "private" ? "restricted" : "public",
208
+ _attachments: {
209
+ [`${name}-${artifact.version}.tgz`]: {
210
+ content_type: "application/octet-stream",
211
+ data: placeholder,
212
+ length: artifact.size,
213
+ },
214
+ },
215
+ };
216
+ const metadataBytes = Buffer.byteLength(JSON.stringify(document), "utf8") -
217
+ Buffer.byteLength(JSON.stringify(placeholder), "utf8") +
218
+ 2;
219
+ return metadataBytes + 4 * Math.ceil(artifact.size / 3);
220
+ };
221
+ const formatBytes = (bytesArg) => `${bytesArg.toLocaleString("en-US")} bytes (${(bytesArg / 1024 ** 2).toFixed(1)} MiB)`;
222
+ /**
223
+ * The packed size and the estimated publish body per registry, checked
224
+ * against the registry's configured `maxPublishBytes`. Prints both and fails
225
+ * when a body exceeds its registry's limit. Without limits it only reports.
226
+ */
227
+ export const assertNpmPublishSize = (optionsArg) => {
228
+ const log = optionsArg.log ?? ((lineArg) => console.log(lineArg));
229
+ log(`${optionsArg.artifact.packageName}: packed ${formatBytes(optionsArg.artifact.size)}`);
230
+ // Registries and limit keys are both in the resolved release form.
231
+ const checks = optionsArg.registries.map((registry) => {
232
+ const limit = optionsArg.maxPublishBytes[registry];
233
+ return {
234
+ registry,
235
+ bodyBytes: estimateNpmPublishBodyBytes({
236
+ contents: optionsArg.contents,
237
+ artifact: optionsArg.artifact,
238
+ registry,
239
+ distTag: optionsArg.distTag,
240
+ access: optionsArg.access,
241
+ }),
242
+ ...(limit !== undefined ? { limit } : {}),
243
+ };
244
+ });
245
+ for (const check of checks)
246
+ log(` publish body to ${check.registry}: ${formatBytes(check.bodyBytes)}${check.limit !== undefined ? `, limit ${formatBytes(check.limit)}` : ", no limit configured"}`);
247
+ const exceeded = checks.filter((checkArg) => checkArg.limit !== undefined && checkArg.bodyBytes > checkArg.limit);
248
+ if (exceeded.length > 0)
249
+ throw new NpmArtifactCheckError("publishSize", `The ${optionsArg.artifact.packageName} publish body exceeds release.targets.npm.maxPublishBytes: ${exceeded
250
+ .map((checkArg) => `${checkArg.registry} ${checkArg.bodyBytes} > ${checkArg.limit} bytes`)
251
+ .join("; ")}. Leave large files out through @git.zone/cli.packageFiles, then \`gitzone format\`.`);
252
+ return checks;
253
+ };
254
+ /**
255
+ * The checks between packing and the journal: every packed tarball must
256
+ * carry its entry points (`core.packNpmArtifact.entryPoints`), and its
257
+ * publish body must fit every registry limit (`core.packNpmArtifact.publishSize`).
258
+ * The size of each tarball and body is printed either way. A failure here
259
+ * leaves the release where a failed pack leaves it.
260
+ */
261
+ export const verifyPackedNpmArtifacts = async (optionsArg) => {
262
+ const packed = [];
263
+ for (const artifact of optionsArg.artifacts) {
264
+ const contents = await readNpmArtifactContents(plugins.path.join(optionsArg.artifactDirectory, artifact.file));
265
+ assertNpmEntryPointsPacked(contents, artifact.packageName);
266
+ packed.push({ artifact, contents });
267
+ }
268
+ for (const { artifact, contents } of packed)
269
+ assertNpmPublishSize({
270
+ contents,
271
+ artifact,
272
+ registries: optionsArg.workflow.npmRegistries,
273
+ distTag: optionsArg.workflow.npmDistTag,
274
+ access: optionsArg.workflow.npmAccessLevel,
275
+ maxPublishBytes: optionsArg.workflow.npmMaxPublishBytes,
276
+ ...(optionsArg.log ? { log: optionsArg.log } : {}),
277
+ });
278
+ };
279
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5ucG1hcnRpZmFjdGNoZWNrLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvbW9kX3JlbGVhc2UvaGVscGVycy5ucG1hcnRpZmFjdGNoZWNrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFLNUMsT0FBTyxFQUFFLHVCQUF1QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFbkUsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBS3REOzs7O0dBSUc7QUFDSCxNQUFNLE9BQU8scUJBQXNCLFNBQVEsS0FBSztJQUM5QixLQUFLLENBQW9CO0lBRXpDLFlBQVksUUFBMkIsRUFBRSxVQUFrQjtRQUN6RCxLQUFLLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDbEIsSUFBSSxDQUFDLElBQUksR0FBRyx1QkFBdUIsQ0FBQztRQUNwQyxJQUFJLENBQUMsS0FBSyxHQUFHLFFBQVEsQ0FBQztJQUN4QixDQUFDO0NBQ0Y7QUFFRCwyRUFBMkU7QUFDM0UsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQUcsQ0FDdkMsUUFBaUIsRUFDa0IsRUFBRTtJQUNyQyxJQUFJLE9BQU8sR0FBWSxRQUFRLENBQUM7SUFDaEMsS0FBSyxJQUFJLEtBQUssR0FBRyxDQUFDLEVBQUUsS0FBSyxHQUFHLEVBQUUsSUFBSSxPQUFPLFlBQVksS0FBSyxFQUFFLEtBQUssRUFBRSxFQUFFLENBQUM7UUFDcEUsSUFBSSxPQUFPLFlBQVkscUJBQXFCO1lBQUUsT0FBTyxPQUFPLENBQUM7UUFDN0QsT0FBTyxHQUFHLE9BQU8sQ0FBQyxLQUFLLENBQUM7SUFDMUIsQ0FBQztJQUNELE9BQU8sU0FBUyxDQUFDO0FBQ25CLENBQUMsQ0FBQztBQVlGLE1BQU0sYUFBYSxHQUFHLFVBQVUsQ0FBQztBQVVqQyxNQUFNLENBQUMsTUFBTSw0QkFBNEIsR0FBMkI7SUFDbEUsMkJBQTJCLEVBQUUs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
@@ -8,6 +8,21 @@ import { type ITsdockerReleaseClient, type IReleaseQualificationRequest } from "
8
8
  import { type IReleaseVersionFloorRecord } from "./helpers.releaseversion.js";
9
9
  export { buildReleaseGitPushArgs } from "./helpers.releasepublication.js";
10
10
  export declare const run: (argvArg: any) => Promise<void>;
11
+ /**
12
+ * What an operator does after the release failed between its tag and its
13
+ * journal. Most such failures are environmental, and resuming the recorded
14
+ * release prepares it again. A failed packed-artifact check comes from the
15
+ * release commit itself and would fail again, so its way out is to abandon the
16
+ * local release, fix the package and release again; gitzone has no command
17
+ * for that, so the steps are spelled out.
18
+ */
19
+ export declare const describeTaggedReleaseFailure: (errorArg: unknown, optionsArg: {
20
+ version: string;
21
+ releaseBranch: string;
22
+ /** The checkout that holds the release commit and tag. */
23
+ releaseCwd: string;
24
+ intentPath: string;
25
+ }) => string;
11
26
  /**
12
27
  * Test logs are release diagnostics, so only a journal that reached completion
13
28
  * may drop them. A failure keeps them for the investigation, and a journal left