@mcp-layer/graphql 0.1.0

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@mcp-layer/graphql",
+  "version": "0.1.0",
+  "description": "Fastify GraphQL plugin and schema builder for MCP catalogs with shared gateway runtime primitives.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/3rd-Eden/mcp-layer"
+  },
+  "type": "module",
+  "keywords": [
+    "mcp",
+    "mcp-layer",
+    "graphql",
+    "fastify",
+    "mercurius",
+    "schema",
+    "adapter",
+    "gateway"
+  ],
+  "main": "src/index.js",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@graphql-tools/schema": "^10.0.31",
+    "fastify-plugin": "^5.0.0",
+    "graphql": "^16.12.0",
+    "graphql-type-json": "^0.3.2",
+    "mercurius": "^16.7.0",
+    "uri-template": "^2.0.0",
+    "@mcp-layer/gateway": "0.1.0",
+    "@mcp-layer/error": "0.2.0"
+  },
+  "peerDependencies": {
+    "fastify": "^5.0.0"
+  },
+  "devDependencies": {
+    "fastify": "^5.7.4",
+    "@mcp-layer/manager": "0.2.0",
+    "@mcp-layer/test-server": "1.0.1",
+    "@mcp-layer/attach": "1.1.1"
+  },
+  "scripts": {
+    "test": "node --test --experimental-test-coverage ./test/**/*.test.js"
+  }
+}

package/src/config/defaults.js

@@ -0,0 +1,24 @@
+import { defaults as runtimeDefaults } from '@mcp-layer/gateway';
+
+const base = runtimeDefaults('mcp-layer-graphql');
+
+/**
+ * Default configuration values for the GraphQL plugin.
+ * @type {{ prefix: string | undefined, validation: { trustSchemas: 'auto' | true | false, maxSchemaDepth: number, maxSchemaSize: number, maxPatternLength: number, maxToolNameLength: number, maxTemplateParamLength: number }, resilience: { enabled: boolean, timeout: number, errorThresholdPercentage: number, resetTimeout: number, volumeThreshold: number }, telemetry: { enabled: boolean, serviceName: string, metricPrefix: string, api?: import('@opentelemetry/api') }, errors: { exposeDetails: boolean }, endpoint: string, ide: { enabled: boolean, path: string }, operations: { generated: boolean, generic: boolean } }}
+ */
+export const DEFAULTS = {
+  ...base,
+  telemetry: {
+    ...base.telemetry,
+    metricPrefix: 'graphql'
+  },
+  endpoint: '/graphql',
+  ide: {
+    enabled: false,
+    path: '/graphiql'
+  },
+  operations: {
+    generated: true,
+    generic: true
+  }
+};

package/src/config/validate.js

@@ -0,0 +1,76 @@
+import { validateRuntimeOptions } from '@mcp-layer/gateway';
+import { LayerError } from '@mcp-layer/error';
+import { DEFAULTS } from './defaults.js';
+
+/**
+ * Test whether a value is a plain object.
+ * @param {unknown} value - Candidate value.
+ * @returns {value is Record<string, unknown>}
+ */
+function isRecord(value) {
+  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+
+/**
+ * Validate GraphQL adapter options.
+ * @param {Record<string, unknown>} opts - User options.
+ * @returns {{ session: unknown, manager?: { get: (request: import('fastify').FastifyRequest) => Promise<import('@mcp-layer/session').Session>, close?: () => Promise<void> }, prefix?: string | ((version: string, info: Record<string, unknown> | undefined, name: string) => string), validation: { trustSchemas: 'auto' | true | false, maxSchemaDepth: number, maxSchemaSize: number, maxPatternLength: number, maxToolNameLength: number, maxTemplateParamLength: number }, resilience: { enabled: boolean, timeout: number, errorThresholdPercentage: number, resetTimeout: number, volumeThreshold: number }, telemetry: { enabled: boolean, serviceName: string, metricPrefix: string, api?: import('@opentelemetry/api') }, errors: { exposeDetails: boolean }, endpoint: string, ide: { enabled: boolean, path: string }, operations: { generated: boolean, generic: boolean } }}
+ */
+export function validateOptions(opts) {
+  const base = validateRuntimeOptions(opts, {
+    name: 'graphql',
+    serviceName: DEFAULTS.telemetry.serviceName
+  });
+
+  const input = isRecord(opts) ? opts : {};
+  const endpoint = typeof input.endpoint === 'string' && input.endpoint.length > 0
+    ? input.endpoint
+    : DEFAULTS.endpoint;
+
+  if (!endpoint.startsWith('/')) {
+    throw new LayerError({
+      name: 'graphql',
+      method: 'validateOptions',
+      message: 'endpoint must start with "/".'
+    });
+  }
+
+  const ideInput = isRecord(input.ide) ? input.ide : {};
+  const ide = {
+    enabled: ideInput.enabled === undefined ? DEFAULTS.ide.enabled : Boolean(ideInput.enabled),
+    path: typeof ideInput.path === 'string' && ideInput.path.length > 0 ? ideInput.path : DEFAULTS.ide.path
+  };
+
+  if (!ide.path.startsWith('/')) {
+    throw new LayerError({
+      name: 'graphql',
+      method: 'validateOptions',
+      message: 'ide.path must start with "/".'
+    });
+  }
+
+  const operationsInput = isRecord(input.operations) ? input.operations : {};
+  const operations = {
+    generated: operationsInput.generated === undefined ? DEFAULTS.operations.generated : Boolean(operationsInput.generated),
+    generic: operationsInput.generic === undefined ? DEFAULTS.operations.generic : Boolean(operationsInput.generic)
+  };
+
+  if (!operations.generated && !operations.generic) {
+    throw new LayerError({
+      name: 'graphql',
+      method: 'validateOptions',
+      message: 'operations.generated and operations.generic cannot both be false.'
+    });
+  }
+
+  return {
+    ...base,
+    telemetry: {
+      ...base.telemetry,
+      metricPrefix: 'graphql'
+    },
+    endpoint,
+    ide,
+    operations
+  };
+}

package/src/index.js

@@ -0,0 +1,3 @@
+export { default, plugin } from './plugin.js';
+export { schema } from './schema.js';
+export { map } from './mapping.js';

package/src/mapping.js

@@ -0,0 +1,12 @@
+import { createMap } from '@mcp-layer/gateway';
+
+/**
+ * Build deterministic GraphQL mapping metadata from a catalog.
+ * @param {{ items?: Array<Record<string, unknown>> }} catalog - Extracted catalog.
+ * @param {Record<string, unknown>} [options] - Reserved for future mapping customization.
+ * @returns {ReturnType<typeof createMap>}
+ */
+export function map(catalog, options = {}) {
+  void options;
+  return createMap(catalog);
+}