@git.zone/cli 8.3.2 → 8.5.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 (39) hide show
  1. package/dist_ts/00_commitinfo_data.js +1 -1
  2. package/dist_ts/helpers.workflow.d.ts +29 -0
  3. package/dist_ts/helpers.workflow.js +37 -2
  4. package/dist_ts/mod_config/index.js +45 -3
  5. package/dist_ts/mod_release/classes.releasejournal.d.ts +19 -3
  6. package/dist_ts/mod_release/classes.releasejournal.js +108 -13
  7. package/dist_ts/mod_release/helpers.giteaassets.d.ts +47 -1
  8. package/dist_ts/mod_release/helpers.giteaassets.js +236 -56
  9. package/dist_ts/mod_release/helpers.npmartifact.d.ts +68 -7
  10. package/dist_ts/mod_release/helpers.npmartifact.js +192 -26
  11. package/dist_ts/mod_release/helpers.releasebranch.d.ts +11 -0
  12. package/dist_ts/mod_release/helpers.releasebranch.js +88 -61
  13. package/dist_ts/mod_release/helpers.releaseline.d.ts +60 -0
  14. package/dist_ts/mod_release/helpers.releaseline.js +129 -0
  15. package/dist_ts/mod_release/helpers.releasephase.d.ts +9 -0
  16. package/dist_ts/mod_release/helpers.releasephase.js +25 -0
  17. package/dist_ts/mod_release/helpers.releasepreparation.js +6 -3
  18. package/dist_ts/mod_release/helpers.releasepublication.d.ts +12 -1
  19. package/dist_ts/mod_release/helpers.releasepublication.js +235 -52
  20. package/dist_ts/mod_release/helpers.releaseversion.d.ts +2 -0
  21. package/dist_ts/mod_release/helpers.releaseversion.js +4 -2
  22. package/dist_ts/mod_release/index.js +149 -44
  23. package/dist_ts/mod_release/interfaces.giteaassets.d.ts +16 -0
  24. package/package.json +5 -5
  25. package/readme.md +224 -17
  26. package/ts/00_commitinfo_data.ts +1 -1
  27. package/ts/helpers.workflow.ts +87 -0
  28. package/ts/mod_config/index.ts +50 -1
  29. package/ts/mod_release/classes.releasejournal.ts +165 -14
  30. package/ts/mod_release/helpers.giteaassets.ts +319 -64
  31. package/ts/mod_release/helpers.npmartifact.ts +302 -22
  32. package/ts/mod_release/helpers.releasebranch.ts +120 -45
  33. package/ts/mod_release/helpers.releaseline.ts +214 -0
  34. package/ts/mod_release/helpers.releasephase.ts +26 -0
  35. package/ts/mod_release/helpers.releasepreparation.ts +12 -3
  36. package/ts/mod_release/helpers.releasepublication.ts +425 -78
  37. package/ts/mod_release/helpers.releaseversion.ts +5 -1
  38. package/ts/mod_release/index.ts +213 -32
  39. package/ts/mod_release/interfaces.giteaassets.ts +19 -0
@@ -21,6 +21,14 @@ export declare const describeGiteaRequestFailure: (error: unknown, evidence: {
21
21
  progress: string;
22
22
  }) => string;
23
23
  export declare const defaultGiteaAssetTransferLimits: Readonly<IGiteaAssetTransferLimits>;
24
+ /** Attachments a release publishes at the same time unless configured otherwise. */
25
+ export declare const defaultGiteaAssetConcurrency = 2;
26
+ /**
27
+ * Upper bound of `release.targets.giteaAssets.concurrency`. Every transfer has
28
+ * to hold the rate floor on its own, so N concurrent transfers need N times the
29
+ * floor of the link.
30
+ */
31
+ export declare const maximumGiteaAssetConcurrency = 6;
24
32
  /** A Gitea request ended by a transfer bound; messages carry no URL or credential. */
25
33
  export declare class GiteaAssetTimeoutError extends Error {
26
34
  constructor(message: string);
@@ -95,8 +103,46 @@ export declare class GiteaAssetsClient implements IGiteaAssetsClient {
95
103
  private release;
96
104
  inspectRelease(): Promise<IGiteaRelease | null>;
97
105
  createRelease(): Promise<IGiteaRelease>;
98
- private verifyPublicBytes;
106
+ /**
107
+ * Publishes a draft whose complete attachment set verified, then proves the
108
+ * published release, its attachment set and every attachment's anonymous
109
+ * download. Every listed attachment must be the one this client hashed, so
110
+ * call verifyComplete first; anything else stays a draft. Gitea serves a draft's attachments to nobody without write
111
+ * access, so no attachment was public before this moment. Setting
112
+ * `draft: false` is idempotent: a release that is already published is only
113
+ * verified.
114
+ */
115
+ publishRelease(releaseId: number, expected: IGiteaFrozenAsset[]): Promise<void>;
116
+ /**
117
+ * Requests an attachment's download URL and follows at most five HTTPS
118
+ * redirects. An authenticated request, which a draft needs, sends the token
119
+ * only to the configured Gitea origin and never along a redirect elsewhere.
120
+ */
121
+ private openAttachment;
122
+ /**
123
+ * Downloads and hashes one attachment. A published release's attachment is
124
+ * downloaded anonymously; a draft's attachment is not public yet, so it is
125
+ * downloaded with the token. Both serve the same stored object.
126
+ */
127
+ private verifyAttachmentBytes;
128
+ /**
129
+ * Proves an attachment of a published release is served anonymously with
130
+ * its frozen size, without downloading its bytes again: the bytes were
131
+ * hashed from the same stored object while the release was a draft.
132
+ */
133
+ private verifyAnonymousAvailability;
134
+ /**
135
+ * The attachment's identity once its metadata matches the frozen asset.
136
+ * Gitea stores an attachment's bytes under its UUID and its API can only
137
+ * rename an attachment, so an unchanged id and UUID mean unchanged bytes.
138
+ */
99
139
  private attachment;
140
+ /**
141
+ * Whether this client downloaded and hashed exactly this attachment, proven
142
+ * by an unchanged id and UUID. Without a UUID, bytes are never taken as
143
+ * verified: the download is repeated.
144
+ */
145
+ private bytesVerified;
100
146
  private inspectAssetsWithIds;
101
147
  /**
102
148
  * Every listed attachment must match its frozen metadata; only the present