Apply suggestions from code review

Co-authored-by: Zgroza (Luke) Klimek <zgroza@google.com>

Author: rferens

js/sign/src/signers/integrity-block-signer.ts

@@ -27,18 +27,21 @@ export class IntegrityBlockSigner {
   private readonly signingStrategies: Array<ISigningStrategy>;
 
   /**
-   * @internal This class is only internal, use SignedWebBundle.from* instead
-   * First argument can be only a pure web bundle (without integrity block)
+   * @internal This constructor is only internal, use `SignedWebBundle` for adding new
+   * signatures instead.
+   * 
+   * First argument can be only a pure web bundle (without integrity block).
    */
   constructor(
     webBundle: Uint8Array,
     integrityBlock: IntegrityBlock,
     signingStrategies: Array<ISigningStrategy>
   );
   /**
-   * @deprecated This class is only internal, use SignedWebBundle.from* instead
-   * Marked as deprecated, not internal for backward compatibility
-   * First argument can be only a pure web bundle (without integrity block)
+   * @deprecated External access to `IntegrityBlockSigner` will be removed in
+   * a future version, use `SignedWebBundle.from*` instead.
+   *
+   * First argument can be only a pure web bundle (without integrity block).
    */
   constructor(
     webBundle: Uint8Array,
@@ -125,7 +128,7 @@ export class IntegrityBlockSigner {
     return this.integrityBlock;
   }
 
-  /** @deprecated This class is only internal, use SignedWebBundle instead*/
+  /** @deprecated This class will become only internal in a future release, use `SignedWebBundle` instead*/
   readWebBundleLength(): number {
     // The length of the web bundle is contained in the last 8 bytes of the web
     // bundle, represented as BigEndian.

js/sign/src/utils/utils.ts

@@ -40,7 +40,7 @@ export function isAsymmetricKeyTypeSupported(key: crypto.KeyObject): boolean {
   return maybeGetSignatureType(key) !== null;
 }
 
-// 'Pure' = not signed web bundles
+// 'Pure' = not signed web bundles (without integrity block)
 export function isPureWebBundle(bundle: Uint8Array): boolean {
   let parsedBundle: Uint8Array[];
   try {