chore: bump deps, tsconfig updates, openapi updates (#1323)

## 🧰 Changes

- bumps openapi file
- updates `tsconfig.json` as a result of typescript 5.9 updates
- various lint fixes
- bumps deps (see below for before/after)

**before**

```
Package                                 Current  Wanted  Latest  Location                                             Depended by
@biomejs/biome                            2.1.2   2.1.3   2.1.3  node_modules/@biomejs/biome                          rdme
@oclif/core                               4.5.1   4.5.2   4.5.2  node_modules/@oclif/core                             rdme
@oclif/plugin-autocomplete               3.2.33  3.2.34  3.2.34  node_modules/@oclif/plugin-autocomplete              rdme
@oclif/plugin-help                       6.2.31  6.2.32  6.2.32  node_modules/@oclif/plugin-help                      rdme
@oclif/plugin-plugins                    5.4.44  5.4.46  5.4.46  node_modules/@oclif/plugin-plugins                   rdme
@oclif/plugin-warn-if-update-available   3.1.44  3.1.46  3.1.46  node_modules/@oclif/plugin-warn-if-update-available  rdme
@readme/oas-examples                      6.1.2   6.1.4   6.1.4  node_modules/@readme/oas-examples                    rdme
@readme/standards                         1.0.0   1.2.0   1.2.0  node_modules/@readme/standards                       rdme
knip                                     5.61.3  5.62.0  5.62.0  node_modules/knip                                    rdme
nock                                     14.0.5  14.0.8  14.0.8  node_modules/nock                                    rdme
oas                                      27.2.1  27.2.1  28.0.0  node_modules/oas                                     rdme
oas-normalize                            14.1.2  14.1.2  15.0.0  node_modules/oas-normalize                           rdme
oclif                                    4.20.6  4.22.5  4.22.5  node_modules/oclif                                   rdme
rollup                                   4.45.0  4.46.2  4.46.2  node_modules/rollup                                  rdme
typescript                                5.8.3   5.9.2   5.9.2  node_modules/typescript                              rdme
undici                                   5.29.0  5.29.0  7.13.0  node_modules/undici                                  rdme
```

**after**

```
Package  Current  Wanted  Latest  Location             Depended by
undici    5.29.0  5.29.0  7.13.0  node_modules/undici  rdme
```

## 🧬 QA & Testing

Provide as much information as you can on how to test what you've done.

Author: kanadgupta

package-lock.json

@@ -63,8 +63,8 @@
     "js-yaml": "^4.1.0",
     "json-schema-to-ts": "^3.1.1",
     "mime-types": "^3.0.1",
-    "oas": "^27.2.1",
-    "oas-normalize": "^14.1.2",
+    "oas": "^28.0.0",
+    "oas-normalize": "^15.0.0",
     "ora": "^8.1.1",
     "prompts": "^2.4.2",
     "semver": "^7.5.3",

package.json

@@ -305,6 +305,7 @@ export default class OpenAPIResolveCommand extends BaseCommand<typeof OpenAPIRes
       );
       this.replaceCircularRefs(schemas, remainingCircularRefs);
 
+      // biome-ignore lint/nursery/noAwaitInLoop: Awaiting here is necessary to ensure we get all of the remaining circular references
       remainingCircularRefs = await this.getCircularRefs(spec);
       iterationCount += 1;
     }
@@ -324,6 +325,7 @@ export default class OpenAPIResolveCommand extends BaseCommand<typeof OpenAPIRes
         );
         this.replaceAllRefsWithObject(schemas, remainingCircularRefs);
 
+        // biome-ignore lint/nursery/noAwaitInLoop: Awaiting here is necessary to ensure we get all of the remaining circular references
         remainingCircularRefs = await this.getCircularRefs(spec);
         this.debug(
           `After iteration ${objectReplacementIterationCount + 1}, remaining circular references: ${remainingCircularRefs.length}`,

src/commands/openapi/resolve.ts

@@ -100,6 +100,7 @@ export default class OpenAPIUploadCommand extends BaseCommand<typeof OpenAPIUplo
     let status: APIUploadStatus = 'pending';
 
     while (this.isStatusPending(status) && count < 10) {
+      // biome-ignore lint/nursery/noAwaitInLoop: We need to wait between requests to avoid hitting rate limits.
       await new Promise(resolve => {
         // exponential backoff — wait 1s, 2s, 4s, 8s, 16s, 32s, 30s, 30s, 30s, 30s, etc.
         setTimeout(resolve, Math.min(isTest() ? 1 : 1000 * 2 ** count, 30000));

src/commands/openapi/upload.ts

@@ -1,3 +1,5 @@
+/** biome-ignore-all lint/performance/noBarrelFile: this barrel file is being exported for use in oclif + plugins */
+
 import type { ValueOf } from 'type-fest';
 
 import ChangelogUploadCommand from './commands/changelog/upload.js';

src/index.ts

@@ -215,8 +215,8 @@ export default async function createGHA(
 
   let output = yamlBase;
 
-  Object.keys(data).forEach(key => {
-    output = output.replace(new RegExp(`{{${key}}}`, 'g'), data[key as keyof typeof data]);
+  Object.keys(data).forEach(attr => {
+    output = output.replace(new RegExp(`{{${attr}}}`, 'g'), data[attr as keyof typeof data]);
   });
 
   if (!fs.existsSync(GITHUB_WORKFLOW_DIR)) {

src/lib/createGHA/index.ts

@@ -10,7 +10,7 @@ const registryUrl = 'https://registry.npmjs.com/rdme';
 /**
  * @see {@link https://docs.npmjs.com/adding-dist-tags-to-packages}
  */
-type npmDistTag = 'latest';
+type NPMDistTag = 'latest';
 
 /**
  * Return the major Node.js version specified in our `package.json` config.
@@ -54,7 +54,7 @@ export async function getPkgVersionFromNPM(
    * The `npm` dist tag to retrieve. If this value is omitted,
    * the version from the `package.json` is returned.
    */
-  npmDistTag?: npmDistTag,
+  npmDistTag?: NPMDistTag,
 ): Promise<string> {
   if (npmDistTag) {
     return fetch(registryUrl)
@@ -74,6 +74,6 @@ export async function getPkgVersionFromNPM(
  * @example 8
  */
 // biome-ignore lint/suspicious/noConfusingVoidType: This function can be invoked with `.call()`.
-export async function getMajorPkgVersion(this: Hook.Context | void, npmDistTag?: npmDistTag): Promise<number> {
+export async function getMajorPkgVersion(this: Hook.Context | void, npmDistTag?: NPMDistTag): Promise<number> {
   return semver.major(await getPkgVersionFromNPM.call(this, npmDistTag));
 }

src/lib/getPkg.ts

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/performance/noBarrelFile: this barrel file is being exported for use in plugins */
 import BaseCommand from './lib/baseCommand.js';
 import readdirRecursive from './lib/readdirRecursive.js';
 

src/lib/types/openapiDoc.ts

@@ -3,10 +3,8 @@
     "allowJs": true,
     "declaration": true,
     "erasableSyntaxOnly": true,
-    "lib": ["ES2022"],
-    "module": "Node18",
+    "module": "node20",
     "outDir": "dist/",
-    "resolveJsonModule": true,
     "rootDir": "src",
     "skipLibCheck": true,
     "strict": true,