@mcp-layer/test-server 1.0.3 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-layer/test-server",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Feature-rich MCP server for integration testing and local development.",
   "repository": {
     "type": "git",
@@ -19,12 +19,15 @@
     "mcp-test-server-http": "src/http.js"
   },
   "main": "src/index.js",
+  "types": "./types/index.d.ts",
   "exports": {
     ".": {
+      "types": "./types/index.d.ts",
       "import": "./src/index.js",
       "default": "./src/index.js"
     },
     "./http": {
+      "types": "./types/transport/http.d.ts",
       "import": "./src/transport/http.js",
       "default": "./src/transport/http.js"
     },
@@ -32,6 +35,7 @@
   },
   "files": [
     "src",
+    "types",
     "LICENSE"
   ],
   "publishConfig": {
@@ -42,9 +46,10 @@
     "argh": "^1.0.0",
     "express": "^5.0.1",
     "zod": "^3.25.76",
-    "@mcp-layer/error": "0.2.0"
+    "@mcp-layer/error": "0.2.1"
   },
   "scripts": {
-    "test": "node --test --experimental-test-coverage ./test/**/*.js"
+    "build:types": "tsc -p tsconfig.json",
+    "test": "node --test --experimental-test-coverage \"./test/**/*.js\""
   }
 }

package/types/bin.d.ts

@@ -0,0 +1 @@
+export {};

package/types/config.d.ts

@@ -0,0 +1,6 @@
+export namespace info {
+    let name: string;
+    let version: string;
+}
+export const instructions: string;
+export const debouncedNotifications: string[];

package/types/data/manual.d.ts

@@ -0,0 +1 @@
+export const manual: string;

package/types/data/notes.d.ts

@@ -0,0 +1,4 @@
+export const notes: Map<string, {
+    summary: string;
+    usage: string;
+}>;

package/types/data/references.d.ts

@@ -0,0 +1,6 @@
+export const references: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];

package/types/http.d.ts

@@ -0,0 +1 @@
+export {};

package/types/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Build an MCP server instance pre-configured with tools, resources, and prompts.
+ *
+ * targeted metadata overrides (name/version) without custom servers.
+ *
+ * @param {{ info?: { name?: string, version?: string } }} [opts] - Optional metadata overrides.
+ * @returns {McpServer}
+ */
+export function build(opts?: {
+    info?: {
+        name?: string;
+        version?: string;
+    };
+}): McpServer;
+/**
+ * Start the test server using stdio transport for integration scenarios.
+ *
+ * exercising the standard test-server surface.
+ *
+ * @param {{ server?: McpServer, transport?: StdioServerTransport, info?: { name?: string, version?: string } }} [opts] - Optional overrides for the server instance, transport, or metadata.
+ * @returns {Promise<{ server: McpServer, transport: StdioServerTransport }>}
+ */
+export function start(opts?: {
+    server?: McpServer;
+    transport?: StdioServerTransport;
+    info?: {
+        name?: string;
+        version?: string;
+    };
+}): Promise<{
+    server: McpServer;
+    transport: StdioServerTransport;
+}>;
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

package/types/prompts/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register all prompts exposed by the server.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register prompts on.
+ */
+export function registerPrompts(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): void;

package/types/prompts/welcome.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register the welcome prompt with completable arguments.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the prompt on.
+ */
+export function registerWelcomePrompt(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): void;

package/types/resources/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Register all resources exposed by the server.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register resources on.
+ * @param {{ manual: string, notes: Map<string, Record<string, string>> }} context - Shared data backing the resources.
+ */
+export function registerResources(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, context: {
+    manual: string;
+    notes: Map<string, Record<string, string>>;
+}): void;

package/types/resources/manual.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register the markdown manual resource.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the resource on.
+ * @param {{ manual: string }} context - Manual content backing the resource.
+ */
+export function registerManualResource(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, context: {
+    manual: string;
+}): void;

package/types/resources/notes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register the dynamic notes resource template with completions.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the resource on.
+ * @param {{ notes: Map<string, Record<string, string>> }} context - Notes data keyed by topic/detail.
+ */
+export function registerNotesResource(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, context: {
+    notes: Map<string, Record<string, string>>;
+}): void;

package/types/resources/templates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register a templated resource that expands a name into a note URI.
+ *
+ * surface to exercise dynamic routes.
+ *
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register resources on.
+ */
+export function registerTemplateResource(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): void;

package/types/resources/ui.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register the MCP App UI resource.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the resource on.
+ */
+export function registerUi(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): void;

package/types/shared/capabilities.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build a capability checker bound to the current server connection.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server instance to read client capabilities from.
+ * @returns {(capability: 'sampling' | 'elicitation' | 'roots') => boolean}
+ */
+export function createCapabilityChecker(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): (capability: "sampling" | "elicitation" | "roots") => boolean;

package/types/subscriptions/resources.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Configure basic resource subscriptions on the underlying server transport.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register subscription handlers on.
+ * @param {{ isSubscribable: (uri: string) => boolean }} options - Subscription filters for allowed URIs.
+ * @returns {{ notifyResourceUpdated: (uri: string) => Promise<void> }}
+ */
+export function registerResourceSubscriptions(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, options: {
+    isSubscribable: (uri: string) => boolean;
+}): {
+    notifyResourceUpdated: (uri: string) => Promise<void>;
+};

package/types/tools/add.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register the add tool returning structured totals.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerAdd(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/tools/annotated.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register a tool that exercises annotations and _meta without output schema.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerAnnotated(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/tools/batch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register a tool that accepts array/object inputs.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerBatch(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/tools/booking.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register the booking tool that triggers elicitation workflows.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @param {{ hasCapability: (capability: 'elicitation') => boolean }} capabilities - Capability checker for elicitation support.
+ */
+export function registerBooking(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, capabilities: {
+    hasCapability: (capability: "elicitation") => boolean;
+}): void;

package/types/tools/dashboard.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register a tool that declares an MCP App UI resource.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerDashboard(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/tools/echo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register the echo tool that optionally uppercases responses.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerEcho(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/tools/files.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Register the files tool that emits ResourceLinks referencing shared assets.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @param {{ references: Array<{ uri: string, name: string, description: string, mimeType: string }> }} context - Reference data backing the responses.
+ */
+export function registerFiles(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, context: {
+    references: Array<{
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+    }>;
+}): void;

package/types/tools/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Register all server tools.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register tools on.
+ * @param {{ references: Array<{ uri: string, name: string, description: string, mimeType: string }> }} context - Shared reference data for tools.
+ * @param {{ hasCapability: (capability: 'sampling' | 'elicitation' | 'roots') => boolean }} capabilities - Capability checker for tool behavior.
+ * @param {{ notifyResourceUpdated: (uri: string) => Promise<void> }} notifier - Notifier for resource update events.
+ */
+export function registerTools(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, context: {
+    references: Array<{
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+    }>;
+}, capabilities: {
+    hasCapability: (capability: "sampling" | "elicitation" | "roots") => boolean;
+}, notifier: {
+    notifyResourceUpdated: (uri: string) => Promise<void>;
+}): void;

package/types/tools/logs.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register the logs tool that emits notifications/message entries.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ */
+export function registerLogs(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): void;

package/types/tools/note-update.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Register a tool that mutates note resources and emits update notifications.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @param {{ notes: Map<string, Record<string, string>> }} context - Notes data store to mutate.
+ * @param {{ notifyResourceUpdated: (uri: string) => Promise<void> }} notifier - Resource update notifier.
+ */
+export function registerNoteUpdate(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, context: {
+    notes: Map<string, Record<string, string>>;
+}, notifier: {
+    notifyResourceUpdated: (uri: string) => Promise<void>;
+}): void;

package/types/tools/present.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register the present tool to emit mixed content types.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerPresent(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/tools/progress.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register the progress tool that emits notifications/progress updates.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ */
+export function registerProgress(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): void;

package/types/tools/rebalance.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Register the rebalance tool that toggles core tool registrations to exercise debounced notifications.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @param {{ echo: ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>, add: ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']> }} handles - Tool handles to enable/disable.
+ */
+export function registerRebalance(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, handles: {
+    echo: ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;
+    add: ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;
+}): void;

package/types/tools/roots.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register the roots tool that calls roots/list on capable clients.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @param {{ hasCapability: (capability: 'roots') => boolean }} capabilities - Capability checker for roots support.
+ */
+export function registerRoots(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, capabilities: {
+    hasCapability: (capability: "roots") => boolean;
+}): void;

package/types/tools/summaries.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register the summaries tool that delegates to sampling/createMessage.
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @param {{ hasCapability: (capability: 'sampling') => boolean }} capabilities - Capability checker for sampling support.
+ */
+export function registerSummaries(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer, capabilities: {
+    hasCapability: (capability: "sampling") => boolean;
+}): void;

package/types/tools/testing.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Register a tool that always returns isError true.
+ *
+ * relying on custom servers.
+ *
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerFailGracefully(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;
+/**
+ * Register a tool that throws.
+ *
+ * exercises JSON-RPC error mapping.
+ *
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerCrash(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;
+/**
+ * Register a tool that intentionally exceeds short timeouts.
+ *
+ *
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerSlow(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;
+/**
+ * Register a tool that fails once then succeeds.
+ *
+ * transition from failure to success.
+ *
+ * @param {import('@modelcontextprotocol/sdk/server/mcp.js').McpServer} server - MCP server to register the tool on.
+ * @returns {ReturnType<import('@modelcontextprotocol/sdk/server/mcp.js').McpServer['registerTool']>}
+ */
+export function registerFlap(server: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer): ReturnType<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer["registerTool"]>;

package/types/transport/http.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Start an HTTP server that exposes Streamable HTTP and SSE transports.
+ * @param {{ port?: number }} [opts] - Optional port override for the HTTP server.
+ * @returns {Promise<{ port: number, close: () => Promise<void> }>}
+ */
+export function startHttpServer(opts?: {
+    port?: number;
+}): Promise<{
+    port: number;
+    close: () => Promise<void>;
+}>;