@mnaoumov/typescript-dev-toolkit 6.0.2 → 6.1.0

package/dist/lib/cjs/version.d.cts

@@ -53,6 +53,13 @@ export interface PublishGitHubReleaseOptions {
      * @default `true`
      */
     readonly shouldCloseReleasedIssues?: boolean;
+    /**
+     * Whether to require every asset to exist, require an existing remote tag, and verify the published
+     * non-draft release and its uploaded assets before closing issues.
+     *
+     * @default `false`
+     */
+    readonly shouldVerifyRelease?: boolean;
 }
 /**
  * Options for {@link updateChangelog}.
@@ -133,6 +140,16 @@ export interface UpdateVersionOptions {
      * @default `true`
      */
     readonly shouldEditChangelog?: boolean;
+    /**
+     * Whether to publish and verify the GitHub release before pushing the version commit to the branch.
+     * Preparation and asset validation happen before any push. Only the release tag is pushed first;
+     * a failed preparation, publication or verification leaves the remote branch unchanged.
+     * Uses the `origin` remote and pushes the verified commit to the original branch without force.
+     * Ignored when {@link shouldRelease} is `false`.
+     *
+     * @default `false`
+     */
+    readonly shouldPublishBeforePush?: boolean;
     /**
      * Whether to publish the release. When `false`, all local steps are executed (version bump,
      * changelog, commit, tag), but the changes are not pushed and no GitHub release is published.
@@ -431,6 +448,9 @@ export declare function updateChangelog(newVersion: string, options?: UpdateChan
  * 11. Prepares and publishes a GitHub release.
  * 12. Closes the issues the release carries, with a link to it.
  *
+ * With {@link UpdateVersionOptions.shouldPublishBeforePush}, preparation and asset validation precede
+ * the tag push. Publication and verification then precede the branch push, and issue closing remains last.
+ *
  * @param versionUpdateType - The type of version update to perform (major, minor, patch, premajor, preminor, prepatch, prerelease, or x.y.z[-suffix]).
  * @param options - The {@link UpdateVersionOptions} controlling the release behavior.
  * @returns A {@link Promise} that resolves when the version update is complete.

package/dist/lib/esm/version.d.mts

@@ -53,6 +53,13 @@ export interface PublishGitHubReleaseOptions {
      * @default `true`
      */
     readonly shouldCloseReleasedIssues?: boolean;
+    /**
+     * Whether to require every asset to exist, require an existing remote tag, and verify the published
+     * non-draft release and its uploaded assets before closing issues.
+     *
+     * @default `false`
+     */
+    readonly shouldVerifyRelease?: boolean;
 }
 /**
  * Options for {@link updateChangelog}.
@@ -133,6 +140,16 @@ export interface UpdateVersionOptions {
      * @default `true`
      */
     readonly shouldEditChangelog?: boolean;
+    /**
+     * Whether to publish and verify the GitHub release before pushing the version commit to the branch.
+     * Preparation and asset validation happen before any push. Only the release tag is pushed first;
+     * a failed preparation, publication or verification leaves the remote branch unchanged.
+     * Uses the `origin` remote and pushes the verified commit to the original branch without force.
+     * Ignored when {@link shouldRelease} is `false`.
+     *
+     * @default `false`
+     */
+    readonly shouldPublishBeforePush?: boolean;
     /**
      * Whether to publish the release. When `false`, all local steps are executed (version bump,
      * changelog, commit, tag), but the changes are not pushed and no GitHub release is published.
@@ -431,6 +448,9 @@ export declare function updateChangelog(newVersion: string, options?: UpdateChan
  * 11. Prepares and publishes a GitHub release.
  * 12. Closes the issues the release carries, with a link to it.
  *
+ * With {@link UpdateVersionOptions.shouldPublishBeforePush}, preparation and asset validation precede
+ * the tag push. Publication and verification then precede the branch push, and issue closing remains last.
+ *
  * @param versionUpdateType - The type of version update to perform (major, minor, patch, premajor, preminor, prepatch, prerelease, or x.y.z[-suffix]).
  * @param options - The {@link UpdateVersionOptions} controlling the release behavior.
  * @returns A {@link Promise} that resolves when the version update is complete.