@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.
Files changed (62) hide show
  1. package/assets/templates/npm/.package.json +1 -1
  2. package/assets/templates/service/.package.json +1 -1
  3. package/assets/templates/wcc/.package.json +1 -1
  4. package/assets/templates/website/.package.json +1 -1
  5. package/dist_ts/00_commitinfo_data.js +1 -1
  6. package/dist_ts/helpers.tssea.d.ts +2 -7
  7. package/dist_ts/helpers.tssea.js +20 -10
  8. package/dist_ts/helpers.versionsource.d.ts +23 -5
  9. package/dist_ts/helpers.versionsource.js +115 -37
  10. package/dist_ts/helpers.workflow.d.ts +60 -17
  11. package/dist_ts/helpers.workflow.js +156 -51
  12. package/dist_ts/mod_config/index.js +98 -31
  13. package/dist_ts/mod_release/classes.releasejournal.d.ts +63 -8
  14. package/dist_ts/mod_release/classes.releasejournal.js +283 -124
  15. package/dist_ts/mod_release/helpers.cargorelease.d.ts +4 -3
  16. package/dist_ts/mod_release/helpers.cargorelease.js +5 -4
  17. package/dist_ts/mod_release/helpers.fossglobalassets.d.ts +61 -0
  18. package/dist_ts/mod_release/helpers.fossglobalassets.js +580 -0
  19. package/dist_ts/mod_release/helpers.giteaassets.d.ts +15 -51
  20. package/dist_ts/mod_release/helpers.giteaassets.js +40 -507
  21. package/dist_ts/mod_release/helpers.releaseassets.d.ts +40 -0
  22. package/dist_ts/mod_release/helpers.releaseassets.js +349 -0
  23. package/dist_ts/mod_release/helpers.releaseassettransfer.d.ts +67 -0
  24. package/dist_ts/mod_release/helpers.releaseassettransfer.js +239 -0
  25. package/dist_ts/mod_release/helpers.releasecheck.js +3 -2
  26. package/dist_ts/mod_release/helpers.releasepreparation.d.ts +7 -6
  27. package/dist_ts/mod_release/helpers.releasepreparation.js +34 -7
  28. package/dist_ts/mod_release/helpers.releasepublication.d.ts +8 -2
  29. package/dist_ts/mod_release/helpers.releasepublication.js +218 -54
  30. package/dist_ts/mod_release/helpers.releaseversionsource.d.ts +7 -5
  31. package/dist_ts/mod_release/helpers.releaseversionsource.js +9 -7
  32. package/dist_ts/mod_release/index.d.ts +1 -1
  33. package/dist_ts/mod_release/index.js +109 -68
  34. package/dist_ts/mod_release/interfaces.fossglobalassets.d.ts +108 -0
  35. package/dist_ts/mod_release/interfaces.fossglobalassets.js +2 -0
  36. package/dist_ts/mod_release/interfaces.giteaassets.d.ts +9 -43
  37. package/dist_ts/mod_release/interfaces.releaseassets.d.ts +68 -0
  38. package/dist_ts/mod_release/interfaces.releaseassets.js +2 -0
  39. package/dist_ts/plugins.d.ts +1 -0
  40. package/dist_ts/plugins.js +1 -1
  41. package/package.json +3 -2
  42. package/readme.md +339 -41
  43. package/ts/00_commitinfo_data.ts +1 -1
  44. package/ts/helpers.tssea.ts +31 -10
  45. package/ts/helpers.versionsource.ts +176 -45
  46. package/ts/helpers.workflow.ts +288 -78
  47. package/ts/mod_config/index.ts +130 -38
  48. package/ts/mod_release/classes.releasejournal.ts +499 -180
  49. package/ts/mod_release/helpers.cargorelease.ts +8 -3
  50. package/ts/mod_release/helpers.fossglobalassets.ts +886 -0
  51. package/ts/mod_release/helpers.giteaassets.ts +127 -694
  52. package/ts/mod_release/helpers.releaseassets.ts +516 -0
  53. package/ts/mod_release/helpers.releaseassettransfer.ts +339 -0
  54. package/ts/mod_release/helpers.releasecheck.ts +3 -1
  55. package/ts/mod_release/helpers.releasepreparation.ts +55 -12
  56. package/ts/mod_release/helpers.releasepublication.ts +351 -69
  57. package/ts/mod_release/helpers.releaseversionsource.ts +11 -7
  58. package/ts/mod_release/index.ts +151 -90
  59. package/ts/mod_release/interfaces.fossglobalassets.ts +127 -0
  60. package/ts/mod_release/interfaces.giteaassets.ts +14 -47
  61. package/ts/mod_release/interfaces.releaseassets.ts +96 -0
  62. package/ts/plugins.ts +3 -0
@@ -1,6 +1,8 @@
1
- import type { IGiteaAssetDestination, IGiteaFrozenAsset, IPrepareGiteaAssetsOptions, IGiteaAssetsClientOptions, IGiteaAssetInspection, IGiteaAssetPreflight, IGiteaRelease, IGiteaAssetsClient, IGiteaAssetTransferLimits } from "./interfaces.giteaassets.js";
1
+ import type { IGiteaAssetsClientOptions, IGiteaAssetInspection, IGiteaAssetPreflight, IGiteaRelease, IGiteaAssetsClient } from "./interfaces.giteaassets.js";
2
2
  export type * from "./interfaces.giteaassets.js";
3
- export declare class GiteaAssetConflictError extends Error {
3
+ import { ReleaseAssetConflictError, type IPrepareReleaseAssetsOptions, type IReleaseAssetDestination, type IReleaseAssetTransferLimits, type IReleaseFrozenAsset } from "./helpers.releaseassets.js";
4
+ import { ReleaseAssetTransferWatchdog } from "./helpers.releaseassettransfer.js";
5
+ export declare class GiteaAssetConflictError extends ReleaseAssetConflictError {
4
6
  constructor(message: string);
5
7
  }
6
8
  /**
@@ -27,17 +29,6 @@ export declare class GiteaReleaseStateChangedError extends Error {
27
29
  export declare class GiteaTagProcessingTimeoutError extends Error {
28
30
  constructor(message: string);
29
31
  }
30
- /**
31
- * Names why a request ended: the HTTP status it reached, each error of the
32
- * cause chain by name and code, its message only when it is plain words
33
- * ("terminated", "fetch failed", "other side closed"), and how far the
34
- * transfer got.
35
- */
36
- export declare const describeGiteaRequestFailure: (error: unknown, evidence: {
37
- status?: number;
38
- progress: string;
39
- }) => string;
40
- export declare const defaultGiteaAssetTransferLimits: Readonly<IGiteaAssetTransferLimits>;
41
32
  /**
42
33
  * Attachments a release has in progress at the same time unless configured
43
34
  * otherwise: one, so every attachment uploads and verifies alone, as fast as
@@ -76,40 +67,16 @@ export declare class GiteaAssetUploadNotAcknowledgedError extends GiteaAssetTime
76
67
  export declare class GiteaAssetTransferTooSlowError extends GiteaAssetTimeoutError {
77
68
  constructor(operation: string, elapsedMs: number, bytes: number, expectedBytes: number, minimumBytesPerSecond: number);
78
69
  }
79
- /**
80
- * Bounds one request by progress instead of wall-clock time: the response
81
- * bound covers waiting for headers, the stall bound restarts on every byte,
82
- * an upload's acknowledgement wait scales with its size, and a ceiling of
83
- * expected bytes at the rate floor ends a trickle.
84
- */
85
- export declare class GiteaTransferWatchdog {
86
- #private;
87
- private readonly operation;
88
- private readonly limits;
89
- /** Bytes the request moves in total, including an upload body. */
90
- private readonly expectedBytes;
91
- private readonly uploadBytes;
92
- constructor(operation: string, limits: IGiteaAssetTransferLimits,
70
+ /** The transfer watchdog that ends a Gitea request with Gitea's timeout errors. */
71
+ export declare class GiteaTransferWatchdog extends ReleaseAssetTransferWatchdog<GiteaAssetTimeoutError> {
72
+ constructor(operation: string, limits: IReleaseAssetTransferLimits,
93
73
  /** Bytes the request moves in total, including an upload body. */
94
74
  expectedBytes: number, uploadBytes?: number);
95
- get signal(): AbortSignal;
96
- get failure(): GiteaAssetTimeoutError | undefined;
97
- /** Bytes sent and received so far. */
98
- get bytes(): number;
99
- /** Wait for response headers; every redirect hop starts a new wait. */
100
- awaitResponse(): void;
101
- /** The whole upload body is sent; wait for the server to store and answer it. */
102
- awaitAcknowledgement(): void;
103
- /** Record moved bytes; the stall bound restarts from this moment. */
104
- progress(direction: "sent" | "received", bytes: number): void;
105
- close(): void;
106
75
  }
107
- export declare const normalizeGiteaAssetDestination: (value: IGiteaAssetDestination) => IGiteaAssetDestination;
108
- export declare const giteaAssetFileName: (name: string) => string;
109
- export declare const giteaAssetPublicUrl: (destination: IGiteaAssetDestination, tag: string, name: string) => string;
110
- export declare function assertGiteaFrozenAssets(assets: unknown, destination?: IGiteaAssetDestination, tag?: string): asserts assets is IGiteaFrozenAsset[];
111
- export declare const validateGiteaAssets: (artifactDirectory: string, assets: IGiteaFrozenAsset[]) => Promise<void>;
112
- export declare const prepareGiteaAssets: (options: IPrepareGiteaAssetsOptions) => Promise<IGiteaFrozenAsset[]>;
76
+ export declare const normalizeGiteaAssetDestination: (value: IReleaseAssetDestination) => IReleaseAssetDestination;
77
+ export declare function assertGiteaFrozenAssets(assets: unknown, destination?: IReleaseAssetDestination, tag?: string): asserts assets is IReleaseFrozenAsset[];
78
+ export declare const validateGiteaAssets: (artifactDirectory: string, assets: IReleaseFrozenAsset[]) => Promise<void>;
79
+ export declare const prepareGiteaAssets: (options: IPrepareReleaseAssetsOptions) => Promise<IReleaseFrozenAsset[]>;
113
80
  /** No method retries a remote mutation. The release journal owns attempt admission. */
114
81
  export declare class GiteaAssetsClient implements IGiteaAssetsClient {
115
82
  #private;
@@ -123,9 +90,6 @@ export declare class GiteaAssetsClient implements IGiteaAssetsClient {
123
90
  private readonly repositoryApiPath;
124
91
  constructor(options: IGiteaAssetsClientOptions);
125
92
  private requestJson;
126
- /** Pull-driven: the next chunk is read only when fetch has taken the last one. */
127
- private uploadBody;
128
- private readResponse;
129
93
  private admitRepository;
130
94
  preflight(): Promise<IGiteaAssetPreflight>;
131
95
  private admitTag;
@@ -154,7 +118,7 @@ export declare class GiteaAssetsClient implements IGiteaAssetsClient {
154
118
  * `draft: false` is idempotent: a release that is already published is only
155
119
  * verified.
156
120
  */
157
- publishRelease(releaseId: number, expected: IGiteaFrozenAsset[], expectedDraft: boolean): Promise<void>;
121
+ publishRelease(releaseId: number, expected: IReleaseFrozenAsset[], expectedDraft: boolean): Promise<void>;
158
122
  /**
159
123
  * Requests an attachment's download URL and follows at most five HTTPS
160
124
  * redirects. An authenticated request, which a draft needs, sends the token
@@ -190,7 +154,7 @@ export declare class GiteaAssetsClient implements IGiteaAssetsClient {
190
154
  * Every listed attachment must match its frozen metadata; only the present
191
155
  * attachments named in `verify` (all by default) are downloaded and hashed.
192
156
  */
193
- inspectAssets(releaseId: number, expected: IGiteaFrozenAsset[], verify?: readonly IGiteaFrozenAsset[]): Promise<IGiteaAssetInspection>;
194
- uploadAsset(releaseId: number, asset: IGiteaFrozenAsset, artifactDirectory: string, expectedDraft: boolean): Promise<void>;
195
- verifyComplete(releaseId: number, expected: IGiteaFrozenAsset[]): Promise<void>;
157
+ inspectAssets(releaseId: number, expected: IReleaseFrozenAsset[], verify?: readonly IReleaseFrozenAsset[]): Promise<IGiteaAssetInspection>;
158
+ uploadAsset(releaseId: number, asset: IReleaseFrozenAsset, artifactDirectory: string, expectedDraft: boolean): Promise<void>;
159
+ verifyComplete(releaseId: number, expected: IReleaseFrozenAsset[]): Promise<void>;
196
160
  }