{"_id":"@apigrade/core","_rev":"3-ef48ee5d4c55587cfa9314793155528a","name":"@apigrade/core","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@apigrade/core","version":"1.0.0","author":{"name":"Pushpendra Bansal"},"_id":"@apigrade/core@1.0.0","maintainers":[{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"}],"dist":{"shasum":"18a50ed403eb4931a04b4ac937e809534a320500","tarball":"https://registry.npmjs.org/@apigrade/core/-/core-1.0.0.tgz","fileCount":21,"integrity":"sha512-BrGYOJoQiHEkSQuHcais55CbdQmQ0U1eidXlD/ZKqXlhUkwg55+d0yf0YtcLE+RBaPK+SCRsmWDqRD8YdTNEsg==","signatures":[{"sig":"MEYCIQDBEhONEDBVmdezRLwJt/UY5uJ2UOC9OiYtseNuL2euyQIhAMWNFbX/3QckKdv0LzJYnk/zrU7G9klwh905jNe6xtyd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67159},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"0bc0992762c01fa5629a6f5c995643958bc75712","scripts":{"test":"vitest run","build":"tsc"},"_npmUser":{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"},"_npmVersion":"11.13.0","description":"Core auditing, repairing, and diffing library for OpenAPI specs.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.2.2","typescript":"^5.3.3"},"_npmOperationalInternal":{"tmp":"tmp/core_1.0.0_1781792459470_0.3276236349854438","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@apigrade/core","version":"1.0.1","author":{"name":"Pushpendra Bansal"},"_id":"@apigrade/core@1.0.1","maintainers":[{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"}],"dist":{"shasum":"7d73197076338a5dd29a294ff2a2f1e16488e1cf","tarball":"https://registry.npmjs.org/@apigrade/core/-/core-1.0.1.tgz","fileCount":10,"integrity":"sha512-eaFrJdp/NQ+VHq6c2kt55cm+jHAlMM2KAai62Tx5ba/FOhy/KPJRpuxlwTJIUMInWQK5/6QaTvmg+Eh2WFNXlw==","signatures":[{"sig":"MEYCIQDOItFw+0Ry1x+duBwNM9o4E1glWc99Fveq9yAmzJJCFAIhAJ/98igl166eqZJhSTuqYd1VkV/kgU9SUIERNSLyTDnE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24697},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"0bc0992762c01fa5629a6f5c995643958bc75712","scripts":{"test":"vitest run","build":"tsc"},"_npmUser":{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"},"_npmVersion":"11.13.0","description":"Core auditing, repairing, and diffing library for OpenAPI specs.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.2.2","typescript":"^5.3.3"},"_npmOperationalInternal":{"tmp":"tmp/core_1.0.1_1781793004136_0.7367601354540605","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@apigrade/core","version":"1.0.2","description":"Core auditing, repairing, and diffing library for OpenAPI specs.","main":"dist/index.cjs","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"require":"./dist/index.cjs","import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"rm -rf dist && tsc --emitDeclarationOnly && ../../node_modules/.bin/esbuild src/index.ts --bundle --platform=node --format=cjs --outfile=dist/index.cjs && ../../node_modules/.bin/esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js","test":"vitest run"},"devDependencies":{"esbuild":"^0.19.12","typescript":"^5.3.3","vitest":"^1.2.2"},"gitHead":"f40a0e474bb33d03a15abf4d9c2318b1bd286ea8","_id":"@apigrade/core@1.0.2","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-t7ICqvCWCqz4sXIeTnJ5V9LEwIrFoxn03U3vjluSDkkV1U0y22dEYDP0FNCjZNsFkixrNr4OCdnTI4UAuY9nOg==","shasum":"8e985aa0430bf2e46f451fccc0b968ae6311730d","tarball":"https://registry.npmjs.org/@apigrade/core/-/core-1.0.2.tgz","fileCount":8,"unpackedSize":36255,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCJNZfBemMkXFG4VLzhNeCn6V2NLMoamQM0ZBm70x5tkgIgfsdTj0wWqo/o7bvr5ZwiUTlwB38kKWB6TFbTTCuj4Cs="}]},"_npmUser":{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"},"directories":{},"maintainers":[{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/core_1.0.2_1781793567188_0.2557925902516205"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-18T14:20:59.230Z","modified":"2026-06-18T14:39:27.684Z","1.0.0":"2026-06-18T14:20:59.608Z","1.0.1":"2026-06-18T14:30:04.280Z","1.0.2":"2026-06-18T14:39:27.541Z"},"description":"Core auditing, repairing, and diffing library for OpenAPI specs.","maintainers":[{"name":"pushpendra2506","email":"pushpendra.b2506@gmail.com"}],"readme":"# `@apigrade/core`\n\n> Core auditing, repairing, and diffing library for OpenAPI specifications.\n\n`@apigrade/core` is the core engine behind APIGrade (\"Lighthouse for OpenAPI\"). It helps developers audit API contract quality, calculate score reports, repair missing specifications automatically, and diff changes to prevent breaking updates in CI/CD pipelines.\n\n---\n\n## 📦 Installation\n\n```bash\nnpm install @apigrade/core\n```\n\n---\n\n## ⚡ Quick Start\n\n```typescript\nimport { audit, repair, diff } from \"@apigrade/core\";\n\n// 1. Define your specification payload\nconst specPayload = {\n  title: \"User Management API\",\n  version: \"1.0.0\",\n  description: \"\", // Missing details\n  endpointCount: 1,\n  source: \"openapi-json\",\n  paths: {\n    \"/users\": {\n      get: {\n        summary: \"\", // Missing summary\n        responses: {\n          \"200\": {\n            description: \"Successful response\"\n          }\n        }\n      }\n    }\n  }\n};\n\n// 2. Audit quality metrics\nconst auditReport = audit(specPayload);\nconsole.log(`API Quality Score: ${auditReport.score}/100`);\nconsole.log(`Missing Descriptions Count: ${auditReport.stats.missingDescriptions}`);\n\n// 3. Automatically repair gaps\nconst repairedSpec = repair(specPayload);\nconsole.log(repairedSpec.paths[\"/users\"].get.summary); // Output: \"GET endpoint\"\n\n// 4. Diff changes between specs\nconst oldSpec = { ... };\nconst newSpec = { ... };\nconst diffResult = diff(oldSpec, newSpec);\n\nif (diffResult.hasBreakingChanges) {\n  console.error(\"❌ Warning: Breaking changes detected!\");\n}\n```\n\n---\n\n## ⚙️ Features Under the Hood\n\n*   **API Quality Scoring**: Scan Info Blocks, parameters, request bodies, schemas, and security mappings to generate a score from `0` to `100`.\n*   **Dummy/Mock Repair Engine**: Fills missing summaries, descriptions, tags, and generates schema examples on the fly.\n*   **Semantic Spec Diffing**: Deciphers added vs. breaking API contract adjustments.\n","readmeFilename":"README.md"}