feat: adding openapi upload

[kanadgupta]

🚥 Resolves RM-11384

🧰 Changes

rdme openapi has now been replaced by rdme openapi upload 🚀

highlights:

• much simpler flag structure
• more intuitive slug-based identifying system, thanks to API v2
• better error messages, thanks to API v2

code review notes

• a lot of the diff is related to setting up boilerplate for interacting with API v2
• feedback appreciated on the docs — feel free to review documentation/commands/openapi.md or src/commands/openapi/upload.ts
• feedback appreciated on whether the optional flag should be called --slug or --identifier or something else. went with --slug since it's short and it was easy to write clear explainer docs around

outstanding tasks (archived)

• command
• tests
• optional --action arg? edit: might be a good enhancement further down the line, but going to pass on this for now!
• tests for useSpecVersion
• test for pending timeout (there's a nock API for duplicating an interceptor, use that!)
• finalize command docs
• set up test project for syncing in CI (i.e., adding back what i removed in d69d1aa)

follow-up enhancements

• tests for readmeAPIv2Fetch
• optional --action arg for use in CI to prevent accidental overwrites
• optional --timeout arg to allow user to configure timeout
• GHA onboarding support

🧬 QA & Testing

this can only be tested locally for now:

1. in your local dev server, load up a project that uses readme refactored
2. set up an API key for said project
3. change the value on this line to be http://api.readme.local:3000/v2
4. check out this branch and run the following:

# setup
npm ci && npm run build

# try running any or all of the following:
bin/dev.js openapi upload # try logging in
bin/dev.js openapi upload --key <key> # try selecting a file
bin/dev.js openapi upload --key <key> __tests__/__fixtures__/petstore-simple-weird-version.json # without a version arg
bin/dev.js openapi upload --key <key> __tests__/__fixtures__/petstore-simple-weird-version.json --version=1.0 # with a version arg
bin/dev.js openapi upload --key <key> __tests__/__fixtures__/petstore-simple-weird-version.json --useSpecVersion # use the version defined in the spec

[erunion]

This may get run twice if isGHA() is true and we have a file there.

[kanadgupta]

ah yikes yeah this would overwrite that. we don't do anything with this header at the moment but i'll look into why i wrote it this way, this is just holdover from the API v1 code