@git.zone/cli 8.10.1 → 9.0.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 (69) hide show
  1. package/assets/templates/{asset_deno_binary_installer → asset_binary_installer}/install.sh +2 -2
  2. package/assets/templates/{asset_deno_binary_postinstall → asset_binary_postinstall}/bin/wrapper.js +2 -2
  3. package/assets/templates/{asset_deno_binary_postinstall → asset_binary_postinstall}/scripts/install-binary.js +2 -2
  4. package/assets/templates/asset_binary_release_gitea/.gitea/workflows/release.yml +180 -0
  5. package/assets/templates/asset_tspack_release_gitea/.gitea/workflows/release.yml +7 -4
  6. package/assets/templates/asset_tspack_release_gitea/scripts/gitzone-gitea-tag.d.mts +9 -3
  7. package/assets/templates/asset_tspack_release_gitea/scripts/gitzone-gitea-tag.mjs +50 -6
  8. package/assets/templates/asset_tspack_release_gitea/scripts/gitzone-release-api.mjs +7 -6
  9. package/dist_ts/00_commitinfo_data.js +2 -2
  10. package/dist_ts/helpers.managedassets.d.ts +44 -0
  11. package/dist_ts/helpers.managedassets.js +166 -0
  12. package/dist_ts/helpers.ownerscopes.d.ts +4 -16
  13. package/dist_ts/helpers.ownerscopes.js +5 -16
  14. package/dist_ts/helpers.packagefiles.d.ts +2 -1
  15. package/dist_ts/helpers.packagefiles.js +7 -4
  16. package/dist_ts/helpers.sealedrelease.js +3 -3
  17. package/dist_ts/helpers.tssea.d.ts +11 -0
  18. package/dist_ts/helpers.tssea.js +81 -0
  19. package/dist_ts/helpers.workflow.d.ts +2 -3
  20. package/dist_ts/helpers.workflow.js +9 -19
  21. package/dist_ts/index.d.ts +1 -1
  22. package/dist_ts/index.js +2 -2
  23. package/dist_ts/mod_commit/mod.helpers.d.ts +8 -21
  24. package/dist_ts/mod_commit/mod.helpers.js +32 -83
  25. package/dist_ts/mod_commit/mod.ui.js +1 -5
  26. package/dist_ts/mod_config/index.js +41 -33
  27. package/dist_ts/mod_format/formatters/assets.formatter.js +42 -92
  28. package/dist_ts/mod_format/formatters/packagejson.formatter.js +3 -3
  29. package/dist_ts/mod_format/index.js +30 -11
  30. package/dist_ts/mod_format/interfaces.format.js +1 -2
  31. package/dist_ts/mod_release/classes.releasejournal.d.ts +63 -2
  32. package/dist_ts/mod_release/classes.releasejournal.js +247 -48
  33. package/dist_ts/mod_release/helpers.giteaassets.js +18 -9
  34. package/dist_ts/mod_release/helpers.releasepreparation.d.ts +6 -14
  35. package/dist_ts/mod_release/helpers.releasepreparation.js +27 -53
  36. package/dist_ts/mod_release/index.js +108 -13
  37. package/dist_ts/mod_services/classes.serviceconfiguration.d.ts +2 -2
  38. package/dist_ts/mod_services/classes.serviceoptions.d.ts +2 -2
  39. package/dist_ts/plugins.d.ts +3 -1
  40. package/dist_ts/plugins.js +4 -2
  41. package/package.json +3 -2
  42. package/readme.md +153 -74
  43. package/ts/00_commitinfo_data.ts +1 -1
  44. package/ts/helpers.managedassets.ts +215 -0
  45. package/ts/helpers.ownerscopes.ts +4 -15
  46. package/ts/helpers.packagefiles.ts +6 -3
  47. package/ts/helpers.sealedrelease.ts +2 -2
  48. package/ts/helpers.tssea.ts +102 -0
  49. package/ts/helpers.workflow.ts +12 -28
  50. package/ts/index.ts +1 -1
  51. package/ts/mod_commit/mod.helpers.ts +33 -94
  52. package/ts/mod_commit/mod.ui.ts +0 -4
  53. package/ts/mod_config/index.ts +47 -35
  54. package/ts/mod_format/formatters/assets.formatter.ts +47 -108
  55. package/ts/mod_format/formatters/packagejson.formatter.ts +2 -2
  56. package/ts/mod_format/index.ts +36 -10
  57. package/ts/mod_format/interfaces.format.ts +0 -1
  58. package/ts/mod_release/classes.releasejournal.ts +323 -52
  59. package/ts/mod_release/helpers.giteaassets.ts +19 -10
  60. package/ts/mod_release/helpers.releasepreparation.ts +36 -69
  61. package/ts/mod_release/index.ts +138 -18
  62. package/ts/mod_services/classes.serviceconfiguration.ts +2 -2
  63. package/ts/mod_services/classes.serviceoptions.ts +2 -2
  64. package/ts/plugins.ts +4 -0
  65. package/assets/templates/asset_deno_binary_release_gitea/.gitea/workflows/release.yml +0 -154
  66. package/assets/templates/multienv/deno.json +0 -8
  67. package/dist_ts/mod_format/formatters/deno.formatter.d.ts +0 -18
  68. package/dist_ts/mod_format/formatters/deno.formatter.js +0 -175
  69. package/ts/mod_format/formatters/deno.formatter.ts +0 -219
@@ -10,6 +10,39 @@ export declare const releaseJournalSchemaVersion: 2;
10
10
  export declare const releaseArtifactFileName: "package.tgz";
11
11
  export declare const releaseJournalFileName: "journal.json";
12
12
  export declare const releaseIntentKind: "gitzone-release-intent";
13
+ /** npm tarballs and frozen Gitea assets: the bytes retention may remove. */
14
+ export declare const isReleasePayloadFileName: (nameArg: string) => boolean;
15
+ export type TReleaseRecordPruneAction = "kept" | "pruned" | "blocked";
16
+ export type TReleaseRecordPruneReason = "newest-completed" | "current-release" | "incomplete" | "older-completed" | "payload-absent" | "intent-present" | "record-in-use" | "invalid-journal";
17
+ export interface IReleaseRecordPruneEntry {
18
+ version: string;
19
+ state: "completed" | "incomplete" | "invalid";
20
+ createdAt: string | null;
21
+ completedAt: string | null;
22
+ /** Every regular file of the record directory. */
23
+ bytes: number;
24
+ /** The npm tarballs and Gitea assets among them. */
25
+ payloadBytes: number;
26
+ payloadFiles: number;
27
+ action: TReleaseRecordPruneAction;
28
+ reason: TReleaseRecordPruneReason;
29
+ detail?: string;
30
+ }
31
+ export interface IReleaseRecordPruneReport {
32
+ dryRun: boolean;
33
+ keep: number;
34
+ root: string;
35
+ records: IReleaseRecordPruneEntry[];
36
+ totals: {
37
+ records: number;
38
+ kept: number;
39
+ pruned: number;
40
+ blocked: number;
41
+ bytes: number;
42
+ wouldFreeBytes: number;
43
+ freedBytes: number;
44
+ };
45
+ }
13
46
  /**
14
47
  * `accepted` records a destination that took the upload without rejecting it
15
48
  * while its read-back is still missing. It is neither a success nor a failure:
@@ -230,10 +263,38 @@ export declare class ReleaseJournalStore {
230
263
  private getRecordLock;
231
264
  /**
232
265
  * Only a completed run trims completed records. The current record, intents,
233
- * and records pinned by another publisher/resume remain available. Invalid
234
- * journals stop retention before deletion rather than guessing their state.
266
+ * and records pinned by another publisher/resume keep their payloads.
267
+ * Invalid journals stop retention before deletion rather than guessing
268
+ * their state.
235
269
  */
236
270
  pruneCompleted(keepArg: number, currentVersionArg: string): Promise<string[]>;
271
+ /**
272
+ * Retention for every caller: the newest `keep` completed records and every
273
+ * incomplete record keep their payloads; older completed records lose their
274
+ * npm tarballs and Gitea assets. Journals and all other files stay. A dry run
275
+ * only reports; `apply` deletes under the same locks a release takes.
276
+ */
277
+ pruneRecords(optionsArg: {
278
+ keep: number;
279
+ apply: boolean;
280
+ currentVersion?: string;
281
+ }): Promise<IReleaseRecordPruneReport>;
282
+ /**
283
+ * Paths that show a release of this repository at work: journal, record,
284
+ * creation and recovery-preparation locks, the detached-run lock, and
285
+ * temporary preparation directories. Stale entries need the same manual
286
+ * owner check as every release lock.
287
+ */
288
+ findActiveReleaseState(): Promise<string[]>;
289
+ /** True when a journal's npm tarballs or Gitea assets are not stored. */
290
+ isPayloadMissing(journalArg: TReleaseJournal): Promise<boolean>;
291
+ private planPrune;
292
+ private summarizePrune;
293
+ private measureRecord;
294
+ /** Even a malformed intent protects the record; it is not interpreted. */
295
+ private hasIntent;
296
+ /** Deletes one record's payload, or names what still protects it. */
297
+ private prunePayload;
237
298
  installPrepared(temporaryDirectoryArg: string, journalArg: TReleaseJournal): Promise<TReleaseJournal>;
238
299
  transact(versionArg: string, expectedRevisionArg: number, operationArg: (journalArg: TReleaseJournal) => TReleaseJournal): Promise<TReleaseJournal>;
239
300
  private writeAtomic;