Registry / devops / graphql-config-extension-openapi

graphql-config-extension-openapi

JSON →
library1.0.6jsnpmunverified

Injects endpoints into a GraphQL Config instance based on an OpenAPI definition to retrieve the schema. Version 1.0.6 is the latest stable release. Integrates with graphql-config to extend its functionality for OpenAPI-based schemas. Differentiates by enabling GraphQL tools (like graphql-cli) to fetch schemas from OpenAPI endpoints directly via config.

npm install graphql-config-extension-openapi
INSTALL
IMPORT
SIG · GRAPHQL-CONFIG-EXT
G
graphql-config-extension-openapi
devopsjavascriptv1.0.6
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

patchEndpointsToConfig
import { patchEndpointsToConfig } from 'graphql-config-extension-openapi'
const patchEndpointsToConfig = require('graphql-config-extension-openapi').patchEndpointsToConfig
CommonJS require still works, but recommended import is ESM.
GraphQLConfigData (type)
import { GraphQLConfigData } from 'graphql-config'
import { GraphQLConfigData } from 'graphql-config-extension-openapi'
Type is re-exported from graphql-config, not this package.
default export
import patchEndpointsToConfig from 'graphql-config-extension-openapi'
import * as gqlConfigExt from 'graphql-config-extension-openapi'
Only named export available; default import may be undefined. Check version compatibility.
TypeScript usage
import { patchEndpointsToConfig } from 'graphql-config-extension-openapi'
Package ships TypeScript declarations; use named import for type safety.

Load GraphQL config, patch it with OpenAPI endpoints from the project root, then use the patched config for schema fetching.

import { getGraphQLConfig } from 'graphql-config'; import { patchEndpointsToConfig } from 'graphql-config-extension-openapi'; import { resolve } from 'path'; // Load existing GraphQL config const config = getGraphQLConfig().config; // Patch with OpenAPI endpoint const patchedConfig = patchEndpointsToConfig(config, process.cwd()); console.log('Patched config:', JSON.stringify(patchedConfig, null, 2)); // Now use patchedConfig with graphql-cli or other tools to fetch schema
Debug
Known issues
breakingRequires graphql-config v3 or later; incompatible with v2.
fix
Upgrade graphql-config to v3+.
affects: >=1.0.0
deprecatedThe package may be replaced by native support in graphql-config v4; check future releases.
fix
Monitor graphql-config changelog for built-in OpenAPI support.
affects: >=1.0.0
gotchaThe OpenAPI definition file path is relative to the config file location, not process.cwd().
fix
Use relative paths from .graphqlconfig.yml directory, or pass absolute paths.
affects: >=1.0.0
gotchaSupports only OpenAPI 3.x specifications; Swagger 2.0 may not work correctly.
fix
Convert Swagger 2.0 to OpenAPI 3.x using a tool like swagger2openapi.
affects: >=1.0.0
Errors
Common errors & fixes
TypeError: patchEndpointsToConfig is not a function
Default import used but package exports named export only.
fix
Use `import { patchEndpointsToConfig } from 'graphql-config-extension-openapi'`
Error: Cannot find module 'graphql-config'
graphql-config is a peer dependency but not installed.
fix
Run `npm install graphql-config`
ENOENT: no such file or directory, open 'petstore.json'
OpenAPI definition path is relative to the config file location, but current working directory is different.
fix
Use absolute path or ensure the config file is in the project root.
Invalid OpenAPI version: Must be 3.x
OpenAPI definition is Swagger 2.0 or older.
fix
Convert to OpenAPI 3.x using swagger2openapi or a similar tool.
Upgrade
Version history
1.0.6latest on npm
Audit
Dependencies
graphql-configrequiredpeer dependency required to provide GraphQLConfigData and getGraphQLConfig
openapi-to-graphqlrequiredruntime dependency to convert OpenAPI schema to GraphQL schema (documented, but not explicit in npm)
Agent activity
6 hits · last 30 days
node
6
Resources
graphql-config-extension-openapi — npm install graphql-config-extension-openapi · libregistry