@mcp-layer/graphql 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-layer/graphql",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Fastify GraphQL plugin and schema builder for MCP catalogs with shared gateway runtime primitives.",
   "repository": {
     "type": "git",
@@ -18,8 +18,10 @@
     "gateway"
   ],
   "main": "src/index.js",
+  "types": "./types/index.d.ts",
   "exports": {
     ".": {
+      "types": "./types/index.d.ts",
       "import": "./src/index.js",
       "default": "./src/index.js"
     },
@@ -27,6 +29,7 @@
   },
   "files": [
     "src",
+    "types",
     "LICENSE"
   ],
   "publishConfig": {
@@ -39,19 +42,20 @@
     "graphql-type-json": "^0.3.2",
     "mercurius": "^16.7.0",
     "uri-template": "^2.0.0",
-    "@mcp-layer/error": "0.2.0",
-    "@mcp-layer/gateway": "0.2.0"
+    "@mcp-layer/error": "0.2.1",
+    "@mcp-layer/gateway": "0.2.1"
   },
   "peerDependencies": {
     "fastify": "^5.0.0"
   },
   "devDependencies": {
     "fastify": "^5.7.4",
-    "@mcp-layer/attach": "1.1.1",
-    "@mcp-layer/manager": "0.2.0",
-    "@mcp-layer/test-server": "1.0.1"
+    "@mcp-layer/attach": "1.1.2",
+    "@mcp-layer/manager": "0.2.1",
+    "@mcp-layer/test-server": "1.0.4"
   },
   "scripts": {
-    "test": "node --test --experimental-test-coverage ./test/**/*.test.js"
+    "build:types": "tsc -p tsconfig.json",
+    "test": "node --test --experimental-test-coverage \"./test/**/*.test.js\""
   }
 }

package/types/config/defaults.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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: {
+    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?: any;
+    };
+    errors: {
+        exposeDetails: boolean;
+    };
+    endpoint: string;
+    ide: {
+        enabled: boolean;
+        path: string;
+    };
+    operations: {
+        generated: boolean;
+        generic: boolean;
+    };
+};

package/types/config/validate.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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: Record<string, unknown>): {
+    session: unknown;
+    manager?: {
+        get: (request: import("fastify").FastifyRequest) => Promise<any>;
+        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?: any;
+    };
+    errors: {
+        exposeDetails: boolean;
+    };
+    endpoint: string;
+    ide: {
+        enabled: boolean;
+        path: string;
+    };
+    operations: {
+        generated: boolean;
+        generic: boolean;
+    };
+};

package/types/index.d.ts

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

package/types/mapping.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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: {
+    items?: Array<Record<string, unknown>>;
+}, options?: Record<string, unknown>): ReturnType<typeof createMap>;
+import { createMap } from '@mcp-layer/gateway';

package/types/plugin.d.ts

@@ -0,0 +1,8 @@
+export default plugin;
+/**
+ * Fastify plugin that exposes MCP sessions as GraphQL endpoints.
+ * @param {import('fastify').FastifyInstance} fastify - Fastify instance.
+ * @param {Record<string, unknown>} opts - Plugin options.
+ * @returns {Promise<void>}
+ */
+export function plugin(fastify: import("fastify").FastifyInstance, opts: Record<string, unknown>): Promise<void>;

package/types/schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Build an executable GraphQL schema from an MCP catalog.
+ * @param {{ items?: Array<Record<string, unknown>> }} catalog - Extracted catalog.
+ * @param {{ operations?: { generated?: boolean, generic?: boolean } }} [options] - Build options.
+ * @returns {{ schema: import('graphql').GraphQLSchema, typeDefs: string, resolvers: Record<string, unknown>, mapping: ReturnType<typeof map> }}
+ */
+export function schema(catalog?: {
+    items?: Array<Record<string, unknown>>;
+}, options?: {
+    operations?: {
+        generated?: boolean;
+        generic?: boolean;
+    };
+}): {
+    schema: import("graphql").GraphQLSchema;
+    typeDefs: string;
+    resolvers: Record<string, unknown>;
+    mapping: ReturnType<typeof map>;
+};
+import { map } from './mapping.js';