@yirifi-org/mcp-server 1.2.0

package/dist/client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * HTTP client for making authenticated requests to Yirifi APIs.
+ */
+/**
+ * Structured API error with status code and response details.
+ * Enables the executor to provide actionable error messages to the LLM.
+ */
+export declare class YirifiApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly responseBody: unknown;
+    readonly method: string;
+    readonly url: string;
+    constructor(status: number, statusText: string, responseBody: unknown, method: string, url: string);
+}
+export interface YirifiClientOptions {
+    /** Base URL for all API requests (e.g., https://dev-api.yirifi.ai) */
+    baseUrl: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * HTTP client wrapper for making authenticated API requests to Yirifi services.
+ *
+ * This client handles:
+ * - API key authentication
+ * - Request/response formatting
+ * - Error handling and logging
+ * - Timeout management
+ */
+export declare class YirifiClient {
+    private readonly client;
+    private readonly baseUrl;
+    constructor(options: YirifiClientOptions);
+    /**
+     * Make an authenticated API request.
+     *
+     * @param method - HTTP method (GET, POST, etc.)
+     * @param endpoint - API endpoint path (e.g., /regdb/v1/regulations/country/list)
+     * @param params - Query parameters
+     * @param data - JSON request body
+     * @returns JSON response from the API
+     * @throws Error if the request fails
+     */
+    request<T = unknown>(method: string, endpoint: string, params?: Record<string, unknown>, data?: Record<string, unknown>): Promise<T>;
+    /**
+     * Make a GET request.
+     *
+     * @param endpoint - API endpoint path
+     * @param params - Query parameters
+     * @returns JSON response from the API
+     */
+    get<T = unknown>(endpoint: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Make a POST request.
+     *
+     * @param endpoint - API endpoint path
+     * @param data - JSON request body
+     * @param params - Query parameters
+     * @returns JSON response from the API
+     */
+    post<T = unknown>(endpoint: string, data?: Record<string, unknown>, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Format API response data as pretty-printed JSON.
+     *
+     * @param data - Response data to format
+     * @returns Formatted JSON string
+     */
+    static formatResponse(data: unknown): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAErB,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,OAAO;aACrB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,MAAM;gBAJX,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;CAS9B;AAED,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,mBAAmB;IAaxC;;;;;;;;;OASG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC;IA4Bb;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAItF;;;;;;;OAOG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;CAG7C"}

package/dist/client.js

@@ -0,0 +1,116 @@
+/**
+ * HTTP client for making authenticated requests to Yirifi APIs.
+ */
+import axios from "axios";
+/**
+ * Structured API error with status code and response details.
+ * Enables the executor to provide actionable error messages to the LLM.
+ */
+export class YirifiApiError extends Error {
+    status;
+    statusText;
+    responseBody;
+    method;
+    url;
+    constructor(status, statusText, responseBody, method, url) {
+        const bodyMsg = typeof responseBody === "object" && responseBody !== null
+            ? (responseBody.message ?? JSON.stringify(responseBody))
+            : String(responseBody ?? "Unknown error");
+        super(`${status} ${statusText}: ${bodyMsg}`);
+        this.status = status;
+        this.statusText = statusText;
+        this.responseBody = responseBody;
+        this.method = method;
+        this.url = url;
+        this.name = "YirifiApiError";
+    }
+}
+/**
+ * HTTP client wrapper for making authenticated API requests to Yirifi services.
+ *
+ * This client handles:
+ * - API key authentication
+ * - Request/response formatting
+ * - Error handling and logging
+ * - Timeout management
+ */
+export class YirifiClient {
+    client;
+    baseUrl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, "");
+        this.client = axios.create({
+            baseURL: this.baseUrl,
+            timeout: options.timeout ?? 30000,
+            headers: {
+                "api-key": options.apiKey,
+                "Content-Type": "application/json",
+            },
+        });
+    }
+    /**
+     * Make an authenticated API request.
+     *
+     * @param method - HTTP method (GET, POST, etc.)
+     * @param endpoint - API endpoint path (e.g., /regdb/v1/regulations/country/list)
+     * @param params - Query parameters
+     * @param data - JSON request body
+     * @returns JSON response from the API
+     * @throws Error if the request fails
+     */
+    async request(method, endpoint, params, data) {
+        const url = `${this.baseUrl}${endpoint}`;
+        try {
+            const config = {
+                method,
+                url: endpoint,
+                params,
+                data,
+            };
+            const response = await this.client.request(config);
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const status = error.response?.status ?? 0;
+                const statusText = error.response?.statusText ?? "Unknown";
+                const responseBody = error.response?.data;
+                console.error(`API request failed: ${method} ${url} - Status: ${status}, Message: ${responseBody?.message || error.message}`);
+                throw new YirifiApiError(status, statusText, responseBody, method, url);
+            }
+            console.error(`API request failed: ${method} ${url} - ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Make a GET request.
+     *
+     * @param endpoint - API endpoint path
+     * @param params - Query parameters
+     * @returns JSON response from the API
+     */
+    async get(endpoint, params) {
+        return this.request("GET", endpoint, params);
+    }
+    /**
+     * Make a POST request.
+     *
+     * @param endpoint - API endpoint path
+     * @param data - JSON request body
+     * @param params - Query parameters
+     * @returns JSON response from the API
+     */
+    async post(endpoint, data, params) {
+        return this.request("POST", endpoint, params, data);
+    }
+    /**
+     * Format API response data as pretty-printed JSON.
+     *
+     * @param data - Response data to format
+     * @returns Formatted JSON string
+     */
+    static formatResponse(data) {
+        return JSON.stringify(data, null, 2);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Configuration management for Yirifi MCP server.
+ * Loads and validates settings from environment variables and .env file.
+ */
+import { z } from "zod";
+/**
+ * STDIO mode settings (requires API key from environment)
+ */
+declare const StdioSettingsSchema: z.ZodObject<{
+    /** Base URL for all Yirifi services (RegDB and Web3GRC) */
+    yirifiBaseUrl: z.ZodDefault<z.ZodString>;
+    /** Comma-separated list of tool patterns to expose (e.g., "regdb:*,web3grc:knowledge:*") */
+    yirifiTools: z.ZodOptional<z.ZodString>;
+    /**
+     * Comma-separated list of tool patterns to defer load (e.g., "web3grc:marketplace:*").
+     * Deferred tools are marked with defer_loading: true and excluded from initial context.
+     * They can still be discovered on-demand by Claude's Tool Search Tool.
+     * This reduces token usage while maintaining access to the full tool library.
+     */
+    yirifiDeferTools: z.ZodOptional<z.ZodString>;
+    /** Maximum response length in characters before truncation (default: 50000) */
+    yirifiResponseMaxChars: z.ZodOptional<z.ZodNumber>;
+    /** Maximum pagination limit to prevent huge payloads (default: 50) */
+    yirifiMaxPaginationLimit: z.ZodOptional<z.ZodNumber>;
+} & {
+    /** API key for authenticating with Yirifi external APIs */
+    yirifiApiKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    yirifiBaseUrl: string;
+    yirifiApiKey: string;
+    yirifiTools?: string | undefined;
+    yirifiDeferTools?: string | undefined;
+    yirifiResponseMaxChars?: number | undefined;
+    yirifiMaxPaginationLimit?: number | undefined;
+}, {
+    yirifiApiKey: string;
+    yirifiBaseUrl?: string | undefined;
+    yirifiTools?: string | undefined;
+    yirifiDeferTools?: string | undefined;
+    yirifiResponseMaxChars?: number | undefined;
+    yirifiMaxPaginationLimit?: number | undefined;
+}>;
+/**
+ * HTTP mode settings (API key from request headers, not environment)
+ */
+declare const HttpSettingsSchema: z.ZodObject<{
+    /** Base URL for all Yirifi services (RegDB and Web3GRC) */
+    yirifiBaseUrl: z.ZodDefault<z.ZodString>;
+    /** Comma-separated list of tool patterns to expose (e.g., "regdb:*,web3grc:knowledge:*") */
+    yirifiTools: z.ZodOptional<z.ZodString>;
+    /**
+     * Comma-separated list of tool patterns to defer load (e.g., "web3grc:marketplace:*").
+     * Deferred tools are marked with defer_loading: true and excluded from initial context.
+     * They can still be discovered on-demand by Claude's Tool Search Tool.
+     * This reduces token usage while maintaining access to the full tool library.
+     */
+    yirifiDeferTools: z.ZodOptional<z.ZodString>;
+    /** Maximum response length in characters before truncation (default: 50000) */
+    yirifiResponseMaxChars: z.ZodOptional<z.ZodNumber>;
+    /** Maximum pagination limit to prevent huge payloads (default: 50) */
+    yirifiMaxPaginationLimit: z.ZodOptional<z.ZodNumber>;
+} & {
+    /** HTTP server port */
+    port: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    yirifiBaseUrl: string;
+    port: number;
+    yirifiTools?: string | undefined;
+    yirifiDeferTools?: string | undefined;
+    yirifiResponseMaxChars?: number | undefined;
+    yirifiMaxPaginationLimit?: number | undefined;
+}, {
+    yirifiBaseUrl?: string | undefined;
+    yirifiTools?: string | undefined;
+    yirifiDeferTools?: string | undefined;
+    yirifiResponseMaxChars?: number | undefined;
+    yirifiMaxPaginationLimit?: number | undefined;
+    port?: number | undefined;
+}>;
+export type Settings = z.infer<typeof StdioSettingsSchema>;
+export type HttpSettings = z.infer<typeof HttpSettingsSchema>;
+/**
+ * Load and validate settings for STDIO mode.
+ * Requires YIRIFI_API_KEY environment variable.
+ *
+ * @returns Validated settings instance
+ * @throws Error if required settings are missing or invalid
+ */
+export declare function loadSettings(): Settings;
+/**
+ * Load and validate settings for HTTP mode.
+ * API key is extracted from request headers, not environment.
+ *
+ * @returns Validated settings instance
+ * @throws Error if settings are invalid
+ */
+export declare function loadHttpSettings(): HttpSettings;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB;;GAEG;AACH,QAAA,MAAM,mBAAmB;IAxBvB,2DAA2D;;IAG3D,4FAA4F;;IAG5F;;;;;OAKG;;IAGH,+EAA+E;;IAG/E,sEAAsE;;;IAQtE,2DAA2D;;;;;;;;;;;;;;;;EAE3D,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,kBAAkB;IAhCtB,2DAA2D;;IAG3D,4FAA4F;;IAG5F;;;;;OAKG;;IAGH,+EAA+E;;IAG/E,sEAAsE;;;IAgBtE,uBAAuB;;;;;;;;;;;;;;;;EAEvB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAuBvC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAuB/C"}

package/dist/config.js

@@ -0,0 +1,105 @@
+/**
+ * Configuration management for Yirifi MCP server.
+ * Loads and validates settings from environment variables and .env file.
+ */
+import { config } from "dotenv";
+import { z } from "zod";
+// Load .env file
+config();
+/**
+ * Base settings schema (shared between STDIO and HTTP modes)
+ */
+const BaseSettingsSchema = z.object({
+    /** Base URL for all Yirifi services (RegDB and Web3GRC) */
+    yirifiBaseUrl: z.string().url("Invalid base URL format").default("https://dev-api.yirifi.ai"),
+    /** Comma-separated list of tool patterns to expose (e.g., "regdb:*,web3grc:knowledge:*") */
+    yirifiTools: z.string().optional(),
+    /**
+     * Comma-separated list of tool patterns to defer load (e.g., "web3grc:marketplace:*").
+     * Deferred tools are marked with defer_loading: true and excluded from initial context.
+     * They can still be discovered on-demand by Claude's Tool Search Tool.
+     * This reduces token usage while maintaining access to the full tool library.
+     */
+    yirifiDeferTools: z.string().optional(),
+    /** Maximum response length in characters before truncation (default: 50000) */
+    yirifiResponseMaxChars: z.number().int().positive().optional(),
+    /** Maximum pagination limit to prevent huge payloads (default: 50) */
+    yirifiMaxPaginationLimit: z.number().int().positive().optional(),
+});
+/**
+ * STDIO mode settings (requires API key from environment)
+ */
+const StdioSettingsSchema = BaseSettingsSchema.extend({
+    /** API key for authenticating with Yirifi external APIs */
+    yirifiApiKey: z.string().min(1, "API key is required"),
+});
+/**
+ * HTTP mode settings (API key from request headers, not environment)
+ */
+const HttpSettingsSchema = BaseSettingsSchema.extend({
+    /** HTTP server port */
+    port: z.number().int().positive().default(8002),
+});
+/**
+ * Load and validate settings for STDIO mode.
+ * Requires YIRIFI_API_KEY environment variable.
+ *
+ * @returns Validated settings instance
+ * @throws Error if required settings are missing or invalid
+ */
+export function loadSettings() {
+    try {
+        const rawSettings = {
+            yirifiApiKey: process.env.YIRIFI_API_KEY,
+            yirifiBaseUrl: process.env.YIRIFI_BASE_URL,
+            yirifiTools: process.env.YIRIFI_TOOLS,
+            yirifiDeferTools: process.env.YIRIFI_DEFER_TOOLS,
+            yirifiResponseMaxChars: process.env.YIRIFI_RESPONSE_MAX_CHARS
+                ? Number.parseInt(process.env.YIRIFI_RESPONSE_MAX_CHARS, 10)
+                : undefined,
+            yirifiMaxPaginationLimit: process.env.YIRIFI_MAX_PAGINATION_LIMIT
+                ? Number.parseInt(process.env.YIRIFI_MAX_PAGINATION_LIMIT, 10)
+                : undefined,
+        };
+        return StdioSettingsSchema.parse(rawSettings);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const messages = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+            throw new Error(`Failed to load settings: ${messages}`);
+        }
+        throw new Error(`Failed to load settings: ${error}`);
+    }
+}
+/**
+ * Load and validate settings for HTTP mode.
+ * API key is extracted from request headers, not environment.
+ *
+ * @returns Validated settings instance
+ * @throws Error if settings are invalid
+ */
+export function loadHttpSettings() {
+    try {
+        const rawSettings = {
+            yirifiBaseUrl: process.env.YIRIFI_BASE_URL,
+            yirifiTools: process.env.YIRIFI_TOOLS,
+            yirifiDeferTools: process.env.YIRIFI_DEFER_TOOLS,
+            port: process.env.PORT ? Number.parseInt(process.env.PORT, 10) : undefined,
+            yirifiResponseMaxChars: process.env.YIRIFI_RESPONSE_MAX_CHARS
+                ? Number.parseInt(process.env.YIRIFI_RESPONSE_MAX_CHARS, 10)
+                : undefined,
+            yirifiMaxPaginationLimit: process.env.YIRIFI_MAX_PAGINATION_LIMIT
+                ? Number.parseInt(process.env.YIRIFI_MAX_PAGINATION_LIMIT, 10)
+                : undefined,
+        };
+        return HttpSettingsSchema.parse(rawSettings);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const messages = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+            throw new Error(`Failed to load settings: ${messages}`);
+        }
+        throw new Error(`Failed to load settings: ${error}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for Yirifi MCP Server (STDIO transport).
+ * This file imports and runs the STDIO server for Claude Desktop integration.
+ *
+ * For HTTP transport, use: node dist/server-http.js
+ */
+import "./server-stdio.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for Yirifi MCP Server (STDIO transport).
+ * This file imports and runs the STDIO server for Claude Desktop integration.
+ *
+ * For HTTP transport, use: node dist/server-http.js
+ */
+import "./server-stdio.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,mBAAmB,CAAC"}

package/dist/server-core.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Shared MCP server core logic.
+ * Provides context creation and server setup for both STDIO and HTTP transports.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { YirifiClient } from "./client.js";
+import { type HttpSettings, type Settings } from "./config.js";
+import { type ExecuteToolOptions } from "./tools/executor.js";
+import { type DeferredTool } from "./tools/filter.js";
+import { type GeneratedTool } from "./tools/generator.js";
+/**
+ * Base MCP context containing all pre-computed tool data.
+ * Shared across requests for efficiency.
+ */
+export interface McpContextBase {
+    /** Base URL for Yirifi APIs */
+    yirifiBaseUrl: string;
+    /** All generated tools before filtering */
+    allTools: GeneratedTool[];
+    /** Tools after whitelist and defer-loading applied */
+    filteredTools: DeferredTool[];
+    /** Quick lookup map by tool name */
+    toolMap: Map<string, GeneratedTool>;
+    /** Category metadata for each tool */
+    toolCategories: Record<string, {
+        service: string;
+        category: string;
+    }>;
+}
+/**
+ * STDIO mode context (includes full settings with API key)
+ */
+export interface McpContext extends McpContextBase {
+    /** Validated settings from environment */
+    settings: Settings;
+}
+/**
+ * HTTP mode context (settings without API key requirement)
+ */
+export interface HttpMcpContext extends McpContextBase {
+    /** Validated HTTP settings */
+    settings: HttpSettings;
+}
+/**
+ * Create MCP context with tools generated from swagger specs.
+ * This should be called once at startup and reused.
+ *
+ * @returns MCP context with generated tools
+ */
+export declare function createMcpContext(): Promise<McpContext>;
+/**
+ * Create HTTP MCP context with tools generated from swagger specs.
+ * This should be called once at startup and reused.
+ *
+ * @returns HTTP MCP context with generated tools
+ */
+export declare function createHttpMcpContext(): Promise<HttpMcpContext>;
+/**
+ * Create an MCP server with tool handlers.
+ *
+ * @param ctx - MCP context with tool data (either STDIO or HTTP context)
+ * @param client - YirifiClient for making API calls
+ * @returns Configured McpServer instance
+ */
+export declare function createMcpServer(ctx: McpContextBase, client: YirifiClient, executeOptions?: ExecuteToolOptions, requestToolFilter?: string): McpServer;
+/**
+ * Log server startup information.
+ *
+ * @param ctx - MCP context (either STDIO or HTTP context)
+ * @param transport - Transport type label
+ */
+export declare function logServerStartup(ctx: McpContextBase, transport: string): void;
+//# sourceMappingURL=server-core.d.ts.map

package/dist/server-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-core.d.ts","sourceRoot":"","sources":["../src/server-core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAkC,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,sDAAsD;IACtD,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,oCAAoC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,0CAA0C;IAC1C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CA8C5D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CA8CpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,YAAY,EACpB,cAAc,CAAC,EAAE,kBAAkB,EACnC,iBAAiB,CAAC,EAAE,MAAM,GACzB,SAAS,CA6EX;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAiB7E"}