@git.zone/cli 8.3.1 → 8.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/dist_ts/00_commitinfo_data.js +1 -1
  2. package/dist_ts/helpers.workflow.d.ts +14 -0
  3. package/dist_ts/helpers.workflow.js +29 -1
  4. package/dist_ts/mod_config/index.js +42 -1
  5. package/dist_ts/mod_release/classes.releasejournal.d.ts +19 -3
  6. package/dist_ts/mod_release/classes.releasejournal.js +95 -9
  7. package/dist_ts/mod_release/helpers.npmartifact.d.ts +80 -7
  8. package/dist_ts/mod_release/helpers.npmartifact.js +276 -41
  9. package/dist_ts/mod_release/helpers.releasebranch.d.ts +11 -0
  10. package/dist_ts/mod_release/helpers.releasebranch.js +88 -61
  11. package/dist_ts/mod_release/helpers.releaseline.d.ts +60 -0
  12. package/dist_ts/mod_release/helpers.releaseline.js +129 -0
  13. package/dist_ts/mod_release/helpers.releasepublication.d.ts +2 -0
  14. package/dist_ts/mod_release/helpers.releasepublication.js +86 -19
  15. package/dist_ts/mod_release/helpers.releaseversion.d.ts +2 -0
  16. package/dist_ts/mod_release/helpers.releaseversion.js +4 -2
  17. package/dist_ts/mod_release/index.js +130 -40
  18. package/package.json +3 -3
  19. package/readme.md +123 -7
  20. package/ts/00_commitinfo_data.ts +1 -1
  21. package/ts/helpers.workflow.ts +54 -0
  22. package/ts/mod_config/index.ts +47 -0
  23. package/ts/mod_release/classes.releasejournal.ts +149 -10
  24. package/ts/mod_release/helpers.npmartifact.ts +450 -37
  25. package/ts/mod_release/helpers.releasebranch.ts +120 -45
  26. package/ts/mod_release/helpers.releaseline.ts +214 -0
  27. package/ts/mod_release/helpers.releasepublication.ts +168 -16
  28. package/ts/mod_release/helpers.releaseversion.ts +5 -1
  29. package/ts/mod_release/index.ts +177 -26
@@ -0,0 +1,60 @@
1
+ /** The branch every release publishes from unless a release line names another. */
2
+ export declare const mainReleaseBranch = "main";
3
+ /** The npm dist-tag a `main` release carries. */
4
+ export declare const latestDistTag = "latest";
5
+ /**
6
+ * A maintenance line: an older major released from its own branch under its
7
+ * own npm dist-tag, so that `latest` never moves. The block is committed on
8
+ * the maintenance branch itself, which makes that branch, and only that
9
+ * branch, a release source.
10
+ */
11
+ export interface IReleaseLine {
12
+ branch: string;
13
+ distTag: string;
14
+ }
15
+ /**
16
+ * A branch name `git check-ref-format --branch` accepts, restricted to a
17
+ * portable character set. `main` and `HEAD` are never maintenance lines.
18
+ */
19
+ export declare const isReleaseLineBranchName: (valueArg: unknown) => boolean;
20
+ /**
21
+ * A dist-tag of lowercase letters and digits joined by single hyphens, which
22
+ * starts with a letter. npm refuses a tag that is a valid semver range; within
23
+ * this alphabet only a bare partial version such as `v4` or `x` is one, so
24
+ * those are refused as well. `latest` belongs to `main`.
25
+ */
26
+ export declare const isReleaseLineDistTag: (valueArg: unknown) => boolean;
27
+ /** Validates `release.line`; absent means the release runs from `main`. */
28
+ export declare const parseReleaseLine: (valueArg: unknown, contextArg?: string) => IReleaseLine | undefined;
29
+ export declare const getReleaseBranch: (lineArg: IReleaseLine | undefined) => string;
30
+ export declare const getReleaseDistTag: (lineArg: IReleaseLine | undefined) => string;
31
+ export declare const isSameReleaseLine: (leftArg: IReleaseLine | undefined, rightArg: IReleaseLine | undefined) => boolean;
32
+ /**
33
+ * A maintenance line keeps its major: a breaking change belongs to `main`,
34
+ * and a version of another major would leave the line it is tagged with.
35
+ */
36
+ export declare const assertReleaseLineVersion: (lineArg: IReleaseLine | undefined, currentVersionArg: string, versionArg: string) => void;
37
+ /** Where one package's dist-tags were read. */
38
+ export interface IDistTagSubject {
39
+ packageName: string;
40
+ registry: string;
41
+ version: string;
42
+ distTag: string;
43
+ }
44
+ /**
45
+ * Decides whether publishing `version` under `distTag` is allowed by the
46
+ * registry's current dist-tags; `undefined` means the package does not exist
47
+ * there. Returns why not, or `undefined` when publication may proceed.
48
+ *
49
+ * - `main` (`latest`): a canonical `latest` above the version would move
50
+ * `latest` downwards, so it refuses.
51
+ * - A line: `latest` must already carry a higher major, so the line can never
52
+ * take `latest`, and the line's own tag must not be ahead of the version.
53
+ */
54
+ export declare const findDistTagPublicationRefusal: (distTagsArg: Record<string, unknown> | undefined, subjectArg: IDistTagSubject) => string | undefined;
55
+ /**
56
+ * gitzone never writes dist-tags. When a line release finds `latest` on its
57
+ * own version, it names the command that restores the version `latest`
58
+ * carried when the publication was claimed.
59
+ */
60
+ export declare const describeLatestMovedConflict: (subjectArg: IDistTagSubject, observedLatestArg: unknown, previousLatestArg: string | undefined) => string;
@@ -0,0 +1,129 @@
1
+ import { compareReleaseVersions, isCanonicalReleaseVersion, releaseVersionMajor, } from "./helpers.releaseversion.js";
2
+ /** The branch every release publishes from unless a release line names another. */
3
+ export const mainReleaseBranch = "main";
4
+ /** The npm dist-tag a `main` release carries. */
5
+ export const latestDistTag = "latest";
6
+ const isPlainObject = (valueArg) => typeof valueArg === "object" && valueArg !== null && !Array.isArray(valueArg);
7
+ /**
8
+ * A branch name `git check-ref-format --branch` accepts, restricted to a
9
+ * portable character set. `main` and `HEAD` are never maintenance lines.
10
+ */
11
+ export const isReleaseLineBranchName = (valueArg) => typeof valueArg === "string" &&
12
+ valueArg.length <= 200 &&
13
+ /^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(valueArg) &&
14
+ !valueArg.includes("..") &&
15
+ !valueArg.includes("//") &&
16
+ !valueArg.includes("/.") &&
17
+ !valueArg.endsWith("/") &&
18
+ !valueArg.endsWith(".") &&
19
+ !valueArg.endsWith(".lock") &&
20
+ !valueArg.split("/").some((segmentArg) => segmentArg.endsWith(".lock")) &&
21
+ valueArg !== mainReleaseBranch &&
22
+ valueArg !== "HEAD";
23
+ /**
24
+ * A dist-tag of lowercase letters and digits joined by single hyphens, which
25
+ * starts with a letter. npm refuses a tag that is a valid semver range; within
26
+ * this alphabet only a bare partial version such as `v4` or `x` is one, so
27
+ * those are refused as well. `latest` belongs to `main`.
28
+ */
29
+ export const isReleaseLineDistTag = (valueArg) => typeof valueArg === "string" &&
30
+ valueArg.length <= 64 &&
31
+ /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(valueArg) &&
32
+ !/^v*(?:\d+|x)$/.test(valueArg) &&
33
+ valueArg !== latestDistTag;
34
+ /** Validates `release.line`; absent means the release runs from `main`. */
35
+ export const parseReleaseLine = (valueArg, contextArg = "release.line") => {
36
+ if (valueArg === undefined)
37
+ return undefined;
38
+ if (!isPlainObject(valueArg)) {
39
+ throw new Error(`${contextArg} must be an object with "branch" and "distTag".`);
40
+ }
41
+ const keys = Object.keys(valueArg);
42
+ if (keys.length !== 2 ||
43
+ !keys.includes("branch") ||
44
+ !keys.includes("distTag")) {
45
+ throw new Error(`${contextArg} must contain exactly "branch" and "distTag".`);
46
+ }
47
+ if (!isReleaseLineBranchName(valueArg.branch)) {
48
+ throw new Error(`${contextArg}.branch must be a canonical Git branch name other than main, found ${JSON.stringify(valueArg.branch)}.`);
49
+ }
50
+ if (!isReleaseLineDistTag(valueArg.distTag)) {
51
+ throw new Error(`${contextArg}.distTag must be lowercase letters and digits joined by hyphens, start with a letter, and be neither "latest" nor a semver range such as "v4", found ${JSON.stringify(valueArg.distTag)}.`);
52
+ }
53
+ return {
54
+ branch: valueArg.branch,
55
+ distTag: valueArg.distTag,
56
+ };
57
+ };
58
+ export const getReleaseBranch = (lineArg) => lineArg ? lineArg.branch : mainReleaseBranch;
59
+ export const getReleaseDistTag = (lineArg) => lineArg ? lineArg.distTag : latestDistTag;
60
+ export const isSameReleaseLine = (leftArg, rightArg) => leftArg?.branch === rightArg?.branch && leftArg?.distTag === rightArg?.distTag;
61
+ /**
62
+ * A maintenance line keeps its major: a breaking change belongs to `main`,
63
+ * and a version of another major would leave the line it is tagged with.
64
+ */
65
+ export const assertReleaseLineVersion = (lineArg, currentVersionArg, versionArg) => {
66
+ if (!lineArg)
67
+ return;
68
+ if (!isCanonicalReleaseVersion(currentVersionArg)) {
69
+ throw new Error(`Release line ${lineArg.distTag} needs a canonical x.y.z current version, found ${JSON.stringify(currentVersionArg)}.`);
70
+ }
71
+ if (releaseVersionMajor(versionArg) !== releaseVersionMajor(currentVersionArg)) {
72
+ throw new Error(`Release line ${lineArg.distTag} keeps major ${releaseVersionMajor(currentVersionArg)}, but the release resolved ${currentVersionArg} -> ${versionArg}. ` +
73
+ "A maintenance line never changes its major: remove the Breaking Changes section, --major or release.versionFloor that raised it.");
74
+ }
75
+ };
76
+ const describeDistTagValue = (valueArg) => valueArg === undefined ? "absent" : JSON.stringify(valueArg);
77
+ /**
78
+ * Decides whether publishing `version` under `distTag` is allowed by the
79
+ * registry's current dist-tags; `undefined` means the package does not exist
80
+ * there. Returns why not, or `undefined` when publication may proceed.
81
+ *
82
+ * - `main` (`latest`): a canonical `latest` above the version would move
83
+ * `latest` downwards, so it refuses.
84
+ * - A line: `latest` must already carry a higher major, so the line can never
85
+ * take `latest`, and the line's own tag must not be ahead of the version.
86
+ */
87
+ export const findDistTagPublicationRefusal = (distTagsArg, subjectArg) => {
88
+ const { packageName, registry, version, distTag } = subjectArg;
89
+ const latest = distTagsArg?.[latestDistTag];
90
+ if (distTag === latestDistTag) {
91
+ if (typeof latest === "string" &&
92
+ isCanonicalReleaseVersion(latest) &&
93
+ compareReleaseVersions(latest, version) > 0) {
94
+ return (`${packageName} at ${registry}: the latest dist-tag points at ${latest}, above ${version}. ` +
95
+ `A main release never moves latest downwards. Release an older major from its maintenance branch with release.line (see "Maintenance lines" in the gitzone readme).`);
96
+ }
97
+ return undefined;
98
+ }
99
+ if (typeof latest !== "string" ||
100
+ !isCanonicalReleaseVersion(latest) ||
101
+ releaseVersionMajor(latest) <= releaseVersionMajor(version)) {
102
+ return (`${packageName} at ${registry}: release line ${distTag} requires the latest dist-tag to carry a higher major than ${version}, but latest is ${describeDistTagValue(latest)}. ` +
103
+ `Publishing could make ${version} the latest version.`);
104
+ }
105
+ const lineVersion = distTagsArg?.[distTag];
106
+ if (lineVersion === undefined)
107
+ return undefined;
108
+ if (typeof lineVersion === "string" &&
109
+ isCanonicalReleaseVersion(lineVersion) &&
110
+ compareReleaseVersions(lineVersion, version) <= 0) {
111
+ return undefined;
112
+ }
113
+ return (`${packageName} at ${registry}: the ${distTag} dist-tag points at ${describeDistTagValue(lineVersion)}, which is not below ${version}. ` +
114
+ "Publishing would move the release line backwards.");
115
+ };
116
+ /**
117
+ * gitzone never writes dist-tags. When a line release finds `latest` on its
118
+ * own version, it names the command that restores the version `latest`
119
+ * carried when the publication was claimed.
120
+ */
121
+ export const describeLatestMovedConflict = (subjectArg, observedLatestArg, previousLatestArg) => {
122
+ const { packageName, registry, version, distTag } = subjectArg;
123
+ const restore = previousLatestArg
124
+ ? `Restore it with \`pnpm dist-tag add ${packageName}@${previousLatestArg} latest --registry=${registry}\`.`
125
+ : `Restore it with \`pnpm dist-tag add ${packageName}@<the version latest carried before> latest --registry=${registry}\`; this release did not claim the publication, so it recorded no earlier value.`;
126
+ return (`${packageName} at ${registry}: release line ${distTag} published ${version}, but the latest dist-tag is ${describeDistTagValue(observedLatestArg)}, no longer a higher major. ` +
127
+ `gitzone does not repair dist-tags. ${restore}`);
128
+ };
129
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5yZWxlYXNlbGluZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL21vZF9yZWxlYXNlL2hlbHBlcnMucmVsZWFzZWxpbmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLHNCQUFzQixFQUN0Qix5QkFBeUIsRUFDekIsbUJBQW1CLEdBQ3BCLE1BQU0sNkJBQTZCLENBQUM7QUFFckMsbUZBQW1GO0FBQ25GLE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLE1BQU0sQ0FBQztBQUN4QyxpREFBaUQ7QUFDakQsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLFFBQVEsQ0FBQztBQWF0QyxNQUFNLGFBQWEsR0FBRyxDQUNwQixRQUFpQixFQUNvQixFQUFFLENBQ3ZDLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLEtBQUssSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUVoRjs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyxDQUFDLFFBQWlCLEVBQVcsRUFBRSxDQUNwRSxPQUFPLFFBQVEsS0FBSyxRQUFRO0lBQzVCLFFBQVEsQ0FBQyxNQUFNLElBQUksR0FBRztJQUN0QiwrQkFBK0IsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDO0lBQzlDLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUM7SUFDeEIsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQztJQUN4QixDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDO0lBQ3hCLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUM7SUFDdkIsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQztJQUN2QixDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDO0lBQzNCLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxH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
@@ -6,6 +6,8 @@ import { type IReleaseGitRemotePolicy } from "./helpers.gitremote.js";
6
6
  import { type ITsdockerReleaseClient } from "./helpers.tsdockerprotocol.js";
7
7
  export interface IBuildReleaseGitPushArgsOptions {
8
8
  destination: string;
9
+ /** `main`, or the branch of the journaled release line. */
10
+ releaseBranch: string;
9
11
  newVersion: string;
10
12
  pushBranch: boolean;
11
13
  pushTags: boolean;