feat: add optional draft flag to openPullRequest()

[SurferJeffAtGoogle]

First step towards Owl Bot opening pull requests. Owl bot invokes this library to open pull requests.

[codecov]

Codecov Report

Merging #207 (b644983) into master (3d4aa4b) will increase coverage by 0.03%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #207      +/-   ##
==========================================
+ Coverage   88.04%   88.07%   +0.03%     
==========================================
  Files          24       24              
  Lines        2301     2307       +6     
  Branches      168      152      -16     
==========================================
+ Hits         2026     2032       +6     
  Misses        275      275              

Impacted Files	Coverage Δ
src/github-handler/pull-request-handler.ts	100.00% <100.00%> (ø)
src/index.ts	98.73% <100.00%> (+<0.01%)	⬆️
src/types.ts	98.32% <100.00%> (+0.01%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b2f440c...b644983. Read the comment docs.

[chingor13]

In docs/tests, can you mention what the default value is

[SurferJeffAtGoogle]

In docs/tests, can you mention what the default value is

My goal is to preserve the behavior of all existing calls to this function. All existing calls passed undefined for draft, so that's what the code continues to do. What does that mean? Octokit doesn't make it clear.

The default value undefined gets passed into octokit, so it's up to octokit to interpret what the default value means. Sadly, octokit's docs do not define what the default value is.