@git.zone/cli 12.2.0 → 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 (59) 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.versionsource.d.ts +23 -5
  7. package/dist_ts/helpers.versionsource.js +115 -37
  8. package/dist_ts/helpers.workflow.d.ts +60 -17
  9. package/dist_ts/helpers.workflow.js +156 -51
  10. package/dist_ts/mod_config/index.js +98 -31
  11. package/dist_ts/mod_release/classes.releasejournal.d.ts +63 -8
  12. package/dist_ts/mod_release/classes.releasejournal.js +283 -124
  13. package/dist_ts/mod_release/helpers.cargorelease.d.ts +4 -3
  14. package/dist_ts/mod_release/helpers.cargorelease.js +5 -4
  15. package/dist_ts/mod_release/helpers.fossglobalassets.d.ts +61 -0
  16. package/dist_ts/mod_release/helpers.fossglobalassets.js +580 -0
  17. package/dist_ts/mod_release/helpers.giteaassets.d.ts +15 -51
  18. package/dist_ts/mod_release/helpers.giteaassets.js +40 -507
  19. package/dist_ts/mod_release/helpers.releaseassets.d.ts +40 -0
  20. package/dist_ts/mod_release/helpers.releaseassets.js +349 -0
  21. package/dist_ts/mod_release/helpers.releaseassettransfer.d.ts +67 -0
  22. package/dist_ts/mod_release/helpers.releaseassettransfer.js +239 -0
  23. package/dist_ts/mod_release/helpers.releasecheck.js +3 -2
  24. package/dist_ts/mod_release/helpers.releasepreparation.d.ts +7 -6
  25. package/dist_ts/mod_release/helpers.releasepreparation.js +34 -7
  26. package/dist_ts/mod_release/helpers.releasepublication.d.ts +8 -2
  27. package/dist_ts/mod_release/helpers.releasepublication.js +218 -54
  28. package/dist_ts/mod_release/helpers.releaseversionsource.d.ts +7 -5
  29. package/dist_ts/mod_release/helpers.releaseversionsource.js +9 -7
  30. package/dist_ts/mod_release/index.d.ts +1 -1
  31. package/dist_ts/mod_release/index.js +109 -68
  32. package/dist_ts/mod_release/interfaces.fossglobalassets.d.ts +108 -0
  33. package/dist_ts/mod_release/interfaces.fossglobalassets.js +2 -0
  34. package/dist_ts/mod_release/interfaces.giteaassets.d.ts +9 -43
  35. package/dist_ts/mod_release/interfaces.releaseassets.d.ts +68 -0
  36. package/dist_ts/mod_release/interfaces.releaseassets.js +2 -0
  37. package/dist_ts/plugins.d.ts +1 -0
  38. package/dist_ts/plugins.js +1 -1
  39. package/package.json +3 -2
  40. package/readme.md +338 -40
  41. package/ts/00_commitinfo_data.ts +1 -1
  42. package/ts/helpers.versionsource.ts +176 -45
  43. package/ts/helpers.workflow.ts +288 -78
  44. package/ts/mod_config/index.ts +130 -38
  45. package/ts/mod_release/classes.releasejournal.ts +499 -180
  46. package/ts/mod_release/helpers.cargorelease.ts +8 -3
  47. package/ts/mod_release/helpers.fossglobalassets.ts +886 -0
  48. package/ts/mod_release/helpers.giteaassets.ts +127 -694
  49. package/ts/mod_release/helpers.releaseassets.ts +516 -0
  50. package/ts/mod_release/helpers.releaseassettransfer.ts +339 -0
  51. package/ts/mod_release/helpers.releasecheck.ts +3 -1
  52. package/ts/mod_release/helpers.releasepreparation.ts +55 -12
  53. package/ts/mod_release/helpers.releasepublication.ts +351 -69
  54. package/ts/mod_release/helpers.releaseversionsource.ts +11 -7
  55. package/ts/mod_release/index.ts +151 -90
  56. package/ts/mod_release/interfaces.fossglobalassets.ts +127 -0
  57. package/ts/mod_release/interfaces.giteaassets.ts +14 -47
  58. package/ts/mod_release/interfaces.releaseassets.ts +96 -0
  59. package/ts/plugins.ts +3 -0
@@ -1,6 +1,6 @@
1
1
  import * as plugins from "./mod.plugins.js";
2
- import { type TReleaseRecordedPlan } from "../helpers.workflow.js";
3
- import { type IGiteaAssetDestination, type IGiteaFrozenAsset } from "./helpers.giteaassets.js";
2
+ import { type IResolvedReleaseResumeConfiguration, type TReleaseRecordedPlan } from "../helpers.workflow.js";
3
+ import { type IReleaseAssetDestination, type IReleaseFrozenAsset, type TReleaseAssetTargetName } from "./helpers.releaseassets.js";
4
4
  import { type IReleaseCleanupResult, type IReleasePromotionContext, type IReleaseQualificationRequest, type IReleaseQualificationResult, type TReleasePromotionEvidence } from "./helpers.tsdockerprotocol.js";
5
5
  import { type IReleasePrereleaseRecord, type IReleaseVersionFloorRecord } from "./helpers.releaseversion.js";
6
6
  import { type IReleaseLine } from "./helpers.releaseline.js";
@@ -192,6 +192,13 @@ export interface IReleaseJournalV2 {
192
192
  alreadyPublished: "success" | "error";
193
193
  registries: IReleaseNpmRegistryJournal[];
194
194
  };
195
+ /**
196
+ * At most one release asset section, the same as schema 4's: present only
197
+ * when the release also publishes release assets. They publish after Git,
198
+ * before npm and before any Docker promotion.
199
+ */
200
+ giteaAssets?: IReleaseGiteaAssetsJournal;
201
+ fossglobalAssets?: IReleaseFossglobalAssetsJournal;
195
202
  docker: IReleaseDockerJournal;
196
203
  createdAt: string;
197
204
  updatedAt: string;
@@ -208,10 +215,10 @@ export interface IReleaseJournalV3 extends Omit<IReleaseJournalV1, "schemaVersio
208
215
  packages: IReleasePackage[];
209
216
  }
210
217
  export interface IReleaseGiteaAssetJournal extends IReleaseTargetStatus {
211
- asset: IGiteaFrozenAsset;
218
+ asset: IReleaseFrozenAsset;
212
219
  }
213
220
  export interface IReleaseGiteaAssetsJournal {
214
- destination: IGiteaAssetDestination;
221
+ destination: IReleaseAssetDestination;
215
222
  tokenEnv: string;
216
223
  manifestPath: string;
217
224
  release: IReleaseTargetStatus & {
@@ -219,13 +226,61 @@ export interface IReleaseGiteaAssetsJournal {
219
226
  };
220
227
  assets: IReleaseGiteaAssetJournal[];
221
228
  }
222
- export interface IReleaseJournalV4 extends Omit<IReleaseJournalV1, "schemaVersion" | "cargo"> {
229
+ export interface IReleaseFossglobalAssetJournal extends IReleaseTargetStatus {
230
+ asset: IReleaseFrozenAsset;
231
+ /** The code host's id of the asset, recorded once an inspection verified it. */
232
+ assetId: string | null;
233
+ }
234
+ /** One release of foss.global's code host, addressed by its tag. */
235
+ export interface IReleaseFossglobalAssetsJournal {
236
+ destination: IReleaseAssetDestination;
237
+ tokenEnv: string;
238
+ manifestPath: string;
239
+ /** The code host's id of the release, recorded once an inspection verified it. */
240
+ release: IReleaseTargetStatus & {
241
+ releaseId: string | null;
242
+ };
243
+ assets: IReleaseFossglobalAssetJournal[];
244
+ }
245
+ /** What every schema 4 journal carries besides its one release asset section. */
246
+ export interface IReleaseAssetsJournalBase extends Omit<IReleaseJournalV1, "schemaVersion" | "cargo"> {
223
247
  schemaVersion: 4;
224
248
  packages: IReleasePackage[];
249
+ }
250
+ export interface IReleaseJournalWithGiteaAssets extends IReleaseAssetsJournalBase {
225
251
  giteaAssets: IReleaseGiteaAssetsJournal;
252
+ fossglobalAssets?: never;
253
+ }
254
+ export interface IReleaseJournalWithFossglobalAssets extends IReleaseAssetsJournalBase {
255
+ fossglobalAssets: IReleaseFossglobalAssetsJournal;
256
+ giteaAssets?: never;
226
257
  }
227
- export type TReleaseJournal = IReleaseJournalV1 | IReleaseJournalV2 | IReleaseJournalV3 | IReleaseJournalV4;
228
- export type TReleaseJournalWithPackages = IReleaseJournalV3 | IReleaseJournalV4 | (IReleaseJournalV2 & {
258
+ /**
259
+ * Schema 4: Git, npm and exactly one release asset section. A gitzone that
260
+ * knows only `giteaAssets` refuses a journal with `fossglobalAssets`.
261
+ */
262
+ export type TReleaseAssetsJournal = IReleaseJournalWithGiteaAssets | IReleaseJournalWithFossglobalAssets;
263
+ export type TReleaseJournal = IReleaseJournalV1 | IReleaseJournalV2 | IReleaseJournalV3 | TReleaseAssetsJournal;
264
+ /** A journal's release asset section with the target it publishes to. */
265
+ export type TReleaseAssetsSection = {
266
+ target: "giteaAssets";
267
+ section: IReleaseGiteaAssetsJournal;
268
+ } | {
269
+ target: "fossglobalAssets";
270
+ section: IReleaseFossglobalAssetsJournal;
271
+ };
272
+ /**
273
+ * The release asset section of a journal that publishes one: schema 4 always
274
+ * carries one, schema 2 (Docker) at most one.
275
+ */
276
+ export declare const getReleaseAssets: (journalArg: TReleaseJournal) => TReleaseAssetsSection | undefined;
277
+ /**
278
+ * A resume publishes a journal's release assets only with the configuration
279
+ * its section recorded: the destination, the credential's variable and the
280
+ * manifest. Transfer bounds are tuning and may change.
281
+ */
282
+ export declare const assertReleaseAssetsResumeConfiguration: (configurationArg: Pick<IResolvedReleaseResumeConfiguration, TReleaseAssetTargetName>, journalArg: TReleaseJournal) => void;
283
+ export type TReleaseJournalWithPackages = IReleaseJournalV3 | TReleaseAssetsJournal | (IReleaseJournalV2 & {
229
284
  packages: IReleasePackage[];
230
285
  });
231
286
  export declare const hasReleasePackages: (journalArg: TReleaseJournal) => journalArg is TReleaseJournalWithPackages;
@@ -322,7 +377,7 @@ export declare class ReleaseJournalStore {
322
377
  * owner check as every release lock.
323
378
  */
324
379
  findActiveReleaseState(): Promise<string[]>;
325
- /** True when a journal's npm tarballs or Gitea assets are not stored. */
380
+ /** True when a journal's npm tarballs, crates or release assets are not stored. */
326
381
  isPayloadMissing(journalArg: TReleaseJournal): Promise<boolean>;
327
382
  private planPrune;
328
383
  private summarizePrune;