feat: properly display file size feature in openapi inspect command (#1257)

| 🚥 Resolves ISSUE_ID |
| :------------------- |

## 🧰 Changes

This PR introduces handling for the new analyzer features — specifically
`rawFileSize` and `dereferencedFileSize` — as introduced in
[readmeio/oas#982](readmeio/oas#982).

---------

Co-authored-by: Jon Ursenbach <[email protected]>

Author: olehshh

__tests__/commands/openapi/__snapshots__/inspect.test.ts.snap

@@ -168,8 +168,10 @@ See more help with --help],
 exports[`rdme openapi inspect > full reports > should generate a report for @readme/oas-examples/3.0/json/petstore.json 1`] = `
 "Here are some interesting things we found in your API definition. 🕵️
 
+ · Your dereferenced file size is 0.03 MB.
  · You are using 4 media types throughout your API: application/json, application/x-www-form-urlencoded, application/xml, and multipart/form-data
  · You have a total of 20 operations in your API.
+ · Your raw file size is 0.01 MB.
  · You are using 2 security types throughout your API: apiKey and oauth2
 
 🌲 OpenAPI Features
@@ -283,8 +285,10 @@ exports[`rdme openapi inspect > full reports > should generate a report for @rea
 exports[`rdme openapi inspect > full reports > should generate a report for @readme/oas-examples/3.0/json/readme.json 1`] = `
 "Here are some interesting things we found in your API definition. 🕵️
 
+ · Your dereferenced file size is 0.32 MB.
  · You are using 3 media types throughout your API: application/json, multipart/form-data, and text/event-stream
  · You have a total of 39 operations in your API.
+ · Your raw file size is 0.05 MB.
  · You are using a single security type throughout your API: http
 
 🌲 OpenAPI Features
@@ -398,8 +402,10 @@ exports[`rdme openapi inspect > full reports > should generate a report for @rea
 exports[`rdme openapi inspect > full reports > should generate a report for @readme/oas-examples/3.0/json/readme-extensions.json 1`] = `
 "Here are some interesting things we found in your API definition. 🕵️
 
+ · Your dereferenced file size is 0.01 MB.
  · You are using a single media type throughout your API: application/json
  · You have a total of 12 operations in your API.
+ · Your raw file size is 0.01 MB.
  · You are using a single security type throughout your API: oauth2
 
 🌲 OpenAPI Features
@@ -513,8 +519,10 @@ exports[`rdme openapi inspect > full reports > should generate a report for @rea
 exports[`rdme openapi inspect > full reports > should generate a report for @readme/oas-examples/3.1/json/train-travel.json 1`] = `
 "Here are some interesting things we found in your API definition. 🕵️
 
+ · Your dereferenced file size is 0.15 MB.
  · You are using 2 media types throughout your API: application/json and application/xml
  · You have a total of 9 operations in your API.
+ · Your raw file size is 0.03 MB.
  · You are using a single security type throughout your API: oauth2
 
 🌲 OpenAPI Features

__tests__/lib/__snapshots__/analyzeOas.test.ts.snap

@@ -3,6 +3,10 @@
 exports[`#analyzeOas > should analyze an OpenAPI definition 1`] = `
 {
   "general": {
+    "dereferencedFileSize": {
+      "found": 0.03,
+      "name": "Dereferenced File Size",
+    },
     "mediaTypes": {
       "found": [
         "application/json",
@@ -16,6 +20,10 @@ exports[`#analyzeOas > should analyze an OpenAPI definition 1`] = `
       "found": 20,
       "name": "Operation",
     },
+    "rawFileSize": {
+      "found": 0.01,
+      "name": "Raw File Size",
+    },
     "securityTypes": {
       "found": [
         "apiKey",

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.0.0",
-    "oas-normalize": "^14.0.0",
+    "oas": "^27.1.0",
+    "oas-normalize": "^14.1.0",
     "ora": "^8.1.1",
     "prompts": "^2.4.2",
     "semver": "^7.5.3",
@@ -84,7 +84,7 @@
     "@oclif/test": "^4.1.0",
     "@readme/better-ajv-errors": "^2.3.2",
     "@readme/eslint-config": "^14.3.0",
-    "@readme/oas-examples": "^6.0.0",
+    "@readme/oas-examples": "^6.1.1",
     "@rollup/plugin-commonjs": "^28.0.0",
     "@rollup/plugin-json": "^6.0.0",
     "@rollup/plugin-node-resolve": "^16.0.0",

package.json

@@ -106,11 +106,12 @@ function buildFeaturesReport(analysis: Analysis, features: string[]) {
 
 function buildFullReport(analysis: Analysis, definitionVersion: string, tableBorder: Record<string, string>) {
   const report: string[] = ['Here are some interesting things we found in your API definition. 🕵️', ''];
+  const sizeKeys = ['rawFileSize', 'dereferencedFileSize'];
 
   // General API definition statistics
   report.push(
     ...(Object.entries(analysis.general || {})
-      .map(([, info]) => {
+      .map(([key, info]) => {
         if (Array.isArray(info.found)) {
           if (!info.found.length) return false;
 
@@ -121,17 +122,25 @@ function buildFullReport(analysis: Analysis, definitionVersion: string, tableBor
           }
 
           return `You are using a single ${info.name.toLowerCase()} throughout your API: ${highlightedData[0]}`;
-        } else if (info.found > 1) {
-          let msg: string;
-          msg = `You have a total of ${chalk.bold(info.found)} ${pluralize(info.name.toLowerCase(), info.found)} in your API.`;
-          if (info.found > 200) {
-            msg += ` ${chalk.cyanBright('Wow! 🤯')}`;
-          }
+        }
+
+        if (info.found === 0) return false;
+
+        const isSizeKey = sizeKeys.includes(key);
+        const isPlural = info.found > 1;
+
+        let baseMessage = isSizeKey
+          ? `Your ${info.name.toLowerCase()} is ${chalk.bold(info.found)} MB.`
+          : isPlural
+            ? `You have a total of ${chalk.bold(info.found)} ${pluralize(info.name.toLowerCase(), info.found)} in your API.`
+            : `You have a single ${info.name.toLowerCase()} in your API.`;
 
-          return msg;
+        const wowThreshold = isSizeKey ? 10 : 200;
+        if (info.found > wowThreshold) {
+          baseMessage += ` ${chalk.cyanBright('Wow! 🤯')}`;
         }
 
-        return `You have a single ${info.name.toLowerCase()} in your API.`;
+        return baseMessage;
       })
       .filter(Boolean)
       .map(msg => ` · ${msg}`) as string[]),