@mcp-consultant-tools/rest-api 27.0.0 → 28.0.0-beta.5

package/build/services/rest-api-service.js

@@ -0,0 +1,403 @@
+/**
+ * REST API Service
+ *
+ * Provides HTTP request functionality with multiple authentication methods:
+ * - Static Bearer Token
+ * - Basic Authentication
+ * - API Key (custom header)
+ * - OAuth2 Client Credentials Flow (JWT generation)
+ */
+import https from "https";
+import { parseOpenApiSpec } from './openapi-parser.js';
+export class RestApiService {
+    config;
+    cachedToken = null;
+    httpsAgent;
+    cachedOpenApi = null;
+    openApiFetchPromise = null;
+    /** OpenAPI cache TTL in milliseconds (default: 5 minutes) */
+    static OPENAPI_CACHE_TTL = 5 * 60 * 1000;
+    constructor(config) {
+        this.config = {
+            responseSizeLimit: 10000,
+            enableSslVerify: true,
+            timeout: 30000,
+            ...config,
+        };
+        // Normalize base URL (remove trailing slashes)
+        this.config.baseUrl = this.config.baseUrl.replace(/\/+$/, "");
+        // Create HTTPS agent if SSL verification is disabled
+        if (!this.config.enableSslVerify) {
+            this.httpsAgent = new https.Agent({ rejectUnauthorized: false });
+        }
+        // Validate mutually exclusive auth methods
+        const authMethods = [
+            this.config.bearerToken ? "bearer" : null,
+            this.config.basicAuth ? "basic" : null,
+            this.config.oauth2 ? "oauth2" : null,
+            this.config.apiKey ? "apikey" : null,
+        ].filter(Boolean);
+        if (authMethods.length > 1) {
+            console.error(`Warning: Multiple auth methods configured (${authMethods.join(", ")}). Only one should be used.`);
+        }
+    }
+    /**
+     * Get the current authentication method name
+     */
+    getAuthMethod() {
+        if (this.config.oauth2)
+            return "oauth2";
+        if (this.config.bearerToken)
+            return "bearer";
+        if (this.config.basicAuth)
+            return "basic";
+        if (this.config.apiKey)
+            return "apikey";
+        return "none";
+    }
+    /**
+     * Get OAuth2 access token using client credentials flow
+     * Caches token and refreshes when expired
+     */
+    async getOAuth2Token() {
+        const oauth2 = this.config.oauth2;
+        if (!oauth2) {
+            throw new Error("OAuth2 configuration not provided");
+        }
+        // Check if we have a valid cached token (with 5 minute buffer)
+        const now = Date.now();
+        if (this.cachedToken && this.cachedToken.expiresAt > now + 5 * 60 * 1000) {
+            return this.cachedToken.accessToken;
+        }
+        console.error("Acquiring new OAuth2 token...");
+        const params = new URLSearchParams();
+        params.append("grant_type", oauth2.grantType || "client_credentials");
+        params.append("client_id", oauth2.clientId);
+        params.append("client_secret", oauth2.clientSecret);
+        params.append("scope", oauth2.scope);
+        if (oauth2.additionalParams) {
+            for (const [key, value] of Object.entries(oauth2.additionalParams)) {
+                params.append(key, value);
+            }
+        }
+        const response = await fetch(oauth2.tokenUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body: params.toString(),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`OAuth2 token request failed: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const tokenResponse = await response.json();
+        if (!tokenResponse.access_token) {
+            throw new Error("OAuth2 response missing access_token");
+        }
+        const expiresIn = tokenResponse.expires_in || 3600;
+        this.cachedToken = {
+            accessToken: tokenResponse.access_token,
+            expiresAt: now + expiresIn * 1000,
+        };
+        console.error(`OAuth2 token acquired, expires in ${Math.round(expiresIn / 60)} minutes`);
+        return this.cachedToken.accessToken;
+    }
+    /**
+     * Get the Authorization header value based on configured auth method
+     */
+    async getAuthHeader() {
+        if (this.config.oauth2) {
+            const token = await this.getOAuth2Token();
+            return { name: "Authorization", value: `Bearer ${token}` };
+        }
+        if (this.config.bearerToken) {
+            return { name: "Authorization", value: `Bearer ${this.config.bearerToken}` };
+        }
+        if (this.config.basicAuth) {
+            const { username, password } = this.config.basicAuth;
+            const base64Credentials = Buffer.from(`${username}:${password}`).toString("base64");
+            return { name: "Authorization", value: `Basic ${base64Credentials}` };
+        }
+        if (this.config.apiKey) {
+            return { name: this.config.apiKey.headerName, value: this.config.apiKey.value };
+        }
+        return null;
+    }
+    /**
+     * Sanitize headers for display (redact sensitive values)
+     */
+    sanitizeHeaders(headers, isFromRequest = false) {
+        const sanitized = {};
+        const safeHeaders = new Set([
+            "accept",
+            "accept-language",
+            "content-type",
+            "user-agent",
+            "cache-control",
+            "if-match",
+            "if-none-match",
+            "if-modified-since",
+            "if-unmodified-since",
+        ]);
+        for (const [key, value] of Object.entries(headers)) {
+            const lowerKey = key.toLowerCase();
+            if (isFromRequest) {
+                sanitized[key] = value;
+                continue;
+            }
+            if (lowerKey === "authorization") {
+                sanitized[key] = "[REDACTED]";
+                continue;
+            }
+            if (this.config.apiKey &&
+                lowerKey === this.config.apiKey.headerName.toLowerCase()) {
+                sanitized[key] = "[REDACTED]";
+                continue;
+            }
+            if (safeHeaders.has(lowerKey)) {
+                sanitized[key] = value;
+            }
+            else {
+                sanitized[key] = "[REDACTED]";
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Execute an HTTP request
+     */
+    async request(options) {
+        const { method, endpoint, body, headers: requestHeaders, host } = options;
+        const normalizedEndpoint = `/${endpoint.replace(/^\/+|\/+$/g, "")}`;
+        const baseUrl = host ? host.replace(/\/+$/, "") : this.config.baseUrl;
+        const fullUrl = `${baseUrl}${normalizedEndpoint}`;
+        const headers = {
+            ...this.config.customHeaders,
+            ...requestHeaders,
+        };
+        if (body && !headers["Content-Type"] && !headers["content-type"]) {
+            headers["Content-Type"] = "application/json";
+        }
+        const authHeader = await this.getAuthHeader();
+        if (authHeader) {
+            headers[authHeader.name] = authHeader.value;
+        }
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        if (["POST", "PUT", "PATCH"].includes(method) && body) {
+            fetchOptions.body =
+                typeof body === "string" ? body : JSON.stringify(body);
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout || 30000);
+        fetchOptions.signal = controller.signal;
+        const startTime = Date.now();
+        try {
+            const response = await fetch(fullUrl, fetchOptions);
+            clearTimeout(timeoutId);
+            const endTime = Date.now();
+            const responseText = await response.text();
+            let responseBody;
+            try {
+                responseBody = JSON.parse(responseText);
+            }
+            catch {
+                responseBody = responseText;
+            }
+            const responseHeaders = {};
+            response.headers.forEach((value, key) => {
+                responseHeaders[key] = value;
+            });
+            const bodySize = Buffer.from(responseText).length;
+            const sizeLimit = this.config.responseSizeLimit || 10000;
+            const validation = {
+                isError: response.status >= 400,
+                messages: response.status >= 400
+                    ? [`Request failed with status ${response.status}`]
+                    : ["Request completed successfully"],
+            };
+            if (bodySize > sizeLimit) {
+                responseBody =
+                    typeof responseBody === "string"
+                        ? responseBody.slice(0, sizeLimit)
+                        : JSON.stringify(responseBody).slice(0, sizeLimit);
+                validation.messages.push(`Response truncated: ${sizeLimit} of ${bodySize} bytes returned due to size limit`);
+                validation.truncated = {
+                    originalSize: bodySize,
+                    returnedSize: sizeLimit,
+                    truncationPoint: sizeLimit,
+                    sizeLimit,
+                };
+            }
+            return {
+                request: {
+                    url: fullUrl,
+                    method,
+                    headers: {
+                        ...this.sanitizeHeaders(headers, false),
+                        ...this.sanitizeHeaders(requestHeaders || {}, true),
+                    },
+                    body,
+                    authMethod: this.getAuthMethod(),
+                },
+                response: {
+                    statusCode: response.status,
+                    statusText: response.statusText,
+                    timing: `${endTime - startTime}ms`,
+                    headers: this.sanitizeHeaders(responseHeaders, false),
+                    body: responseBody,
+                },
+                validation,
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`Request timeout after ${this.config.timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Force refresh the OAuth2 token (clears cache)
+     */
+    clearTokenCache() {
+        this.cachedToken = null;
+        console.error("OAuth2 token cache cleared");
+    }
+    /**
+     * Get configuration summary (safe to display)
+     */
+    getConfigSummary() {
+        return {
+            baseUrl: this.config.baseUrl,
+            authMethod: this.getAuthMethod(),
+            sslVerification: this.config.enableSslVerify !== false,
+            responseSizeLimit: this.config.responseSizeLimit || 10000,
+            customHeaderCount: Object.keys(this.config.customHeaders || {}).length,
+            ...(this.config.oauth2 && { oauth2TokenUrl: this.config.oauth2.tokenUrl }),
+            ...(this.config.openApiUrl && { openApiUrl: this.config.openApiUrl }),
+        };
+    }
+    /**
+     * Check if OpenAPI URL is configured
+     */
+    hasOpenApiConfig() {
+        return !!this.config.openApiUrl;
+    }
+    /**
+     * Fetch and parse OpenAPI spec from configured URL
+     * Results are cached for OPENAPI_CACHE_TTL
+     */
+    async fetchOpenApiSpec() {
+        if (!this.config.openApiUrl) {
+            throw new Error("OpenAPI URL not configured");
+        }
+        const now = Date.now();
+        if (this.cachedOpenApi &&
+            now - this.cachedOpenApi.fetchedAt < RestApiService.OPENAPI_CACHE_TTL) {
+            return this.cachedOpenApi;
+        }
+        if (this.openApiFetchPromise) {
+            return this.openApiFetchPromise;
+        }
+        this.openApiFetchPromise = this.doFetchOpenApiSpec();
+        try {
+            const result = await this.openApiFetchPromise;
+            return result;
+        }
+        finally {
+            this.openApiFetchPromise = null;
+        }
+    }
+    /**
+     * Actually fetch and parse the OpenAPI spec
+     */
+    async doFetchOpenApiSpec() {
+        const url = this.config.openApiUrl;
+        console.error(`Fetching OpenAPI spec from ${url}...`);
+        const fetchOptions = {};
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 30000);
+        fetchOptions.signal = controller.signal;
+        try {
+            const response = await fetch(url, fetchOptions);
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch OpenAPI spec: ${response.status} ${response.statusText}`);
+            }
+            const spec = (await response.json());
+            const parsed = parseOpenApiSpec(spec);
+            this.cachedOpenApi = {
+                ...parsed,
+                fetchedAt: Date.now(),
+                source: `OpenAPI spec from ${url}`,
+            };
+            console.error(`OpenAPI spec loaded: ${parsed.endpoints.length} endpoints, ${Object.keys(parsed.schemas).length} schemas`);
+            return this.cachedOpenApi;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error("OpenAPI fetch timeout after 30 seconds");
+            }
+            throw error;
+        }
+    }
+    /**
+     * Clear OpenAPI cache (forces re-fetch on next call)
+     */
+    clearOpenApiCache() {
+        this.cachedOpenApi = null;
+        console.error("OpenAPI cache cleared");
+    }
+    /**
+     * List all available API endpoints from OpenAPI spec
+     * @param filter Optional filter to match endpoint paths (case-insensitive contains match)
+     */
+    async listEndpointsAsync(filter) {
+        if (!this.config.openApiUrl) {
+            return {
+                baseUrl: this.config.baseUrl,
+                endpointCount: 0,
+                endpoints: [],
+                source: "No OpenAPI URL configured. Set REST_OPENAPI_URL environment variable.",
+            };
+        }
+        const openApiData = await this.fetchOpenApiSpec();
+        const endpoints = filter
+            ? openApiData.endpoints.filter((ep) => ep.path.toLowerCase().includes(filter.toLowerCase()) ||
+                ep.entityName?.toLowerCase().includes(filter.toLowerCase()) ||
+                ep.description?.toLowerCase().includes(filter.toLowerCase()))
+            : openApiData.endpoints;
+        return {
+            baseUrl: this.config.baseUrl,
+            endpointCount: endpoints.length,
+            endpoints,
+            source: openApiData.source,
+        };
+    }
+    /**
+     * Get schema for a specific entity from OpenAPI spec
+     * @param entity Entity name (singular or plural)
+     */
+    async getSchemaAsync(entity) {
+        if (!this.config.openApiUrl) {
+            return null;
+        }
+        const openApiData = await this.fetchOpenApiSpec();
+        const normalizedEntity = entity.toLowerCase();
+        for (const [key, schema] of Object.entries(openApiData.schemas)) {
+            if (key.toLowerCase() === normalizedEntity ||
+                schema.entityName.toLowerCase() === normalizedEntity ||
+                schema.pluralName.toLowerCase() === normalizedEntity) {
+                return schema;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=rest-api-service.js.map

package/build/services/rest-api-service.js.map

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

package/build/tools/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tools barrel export + combined registration
+ */
+import type { ServiceContext } from '../types.js';
+export declare function registerAllTools(server: any, ctx: ServiceContext): void;
+export { registerRestTools } from './rest-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/build/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAEvE;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/build/tools/index.js

@@ -0,0 +1,6 @@
+import { registerRestTools } from './rest-tools.js';
+export function registerAllTools(server, ctx) {
+    registerRestTools(server, ctx);
+}
+export { registerRestTools } from './rest-tools.js';
+//# sourceMappingURL=index.js.map

package/build/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,UAAU,gBAAgB,CAAC,MAAW,EAAE,GAAmB;IAC/D,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/build/tools/rest-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceContext } from "../types.js";
+export declare function registerRestTools(server: any, ctx: ServiceContext): void;
+//# sourceMappingURL=rest-tools.d.ts.map

package/build/tools/rest-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-tools.d.ts","sourceRoot":"","sources":["../../src/tools/rest-tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAgQxE"}

package/build/tools/rest-tools.js

@@ -0,0 +1,165 @@
+/**
+ * REST API tool registrations
+ */
+import { z } from "zod";
+import { createErrorResponse, createSuccessResponse, } from "@mcp-consultant-tools/core";
+export function registerRestTools(server, ctx) {
+    // Tool: rest-request
+    server.tool("rest-request", `Test a REST API endpoint with automatic authentication. Supports GET, POST, PUT, DELETE, PATCH methods. Authentication is handled automatically based on server configuration (OAuth2 client credentials, bearer token, basic auth, or API key). Returns detailed request/response information including timing, headers, and body.`, {
+        method: z
+            .enum(["GET", "POST", "PUT", "DELETE", "PATCH"])
+            .describe("HTTP method to use"),
+        endpoint: z
+            .string()
+            .describe('Endpoint path (e.g., "/users", "/api/v1/orders"). Do not include the full URL - only the path.'),
+        body: z
+            .any()
+            .optional()
+            .describe("Request body for POST/PUT/PATCH requests (object or string)"),
+        headers: z
+            .record(z.string())
+            .optional()
+            .describe("Additional headers for this request. Do not use for auth - configure auth via environment variables."),
+        host: z
+            .string()
+            .optional()
+            .describe("Override base URL for this request only (e.g., 'https://other-api.com')"),
+    }, async ({ method, endpoint, body, headers, host, }) => {
+        try {
+            // Validate endpoint doesn't contain full URL
+            const urlPattern = /^(https?:\/\/|www\.)/i;
+            if (urlPattern.test(endpoint)) {
+                return createErrorResponse(new Error(`Invalid endpoint format. Do not include full URLs. Use just the path (e.g., "/api/users") and optionally specify 'host' to override the base URL.`), "rest-request");
+            }
+            const options = {
+                method,
+                endpoint,
+                body,
+                headers,
+                host,
+            };
+            const result = await ctx.restApi.request(options);
+            return createSuccessResponse(result);
+        }
+        catch (error) {
+            return createErrorResponse(error, "rest-request");
+        }
+    });
+    // Tool: rest-config
+    server.tool("rest-config", "Get the current REST API service configuration summary, including base URL, authentication method, SSL settings, and custom headers count.", {}, async () => {
+        try {
+            const summary = ctx.restApi.getConfigSummary();
+            return createSuccessResponse(summary);
+        }
+        catch (error) {
+            return createErrorResponse(error, "rest-config");
+        }
+    });
+    // Tool: rest-refresh-token
+    server.tool("rest-refresh-token", "Force refresh the OAuth2 access token. Clears the token cache and acquires a new token on the next request. Only relevant when using OAuth2 authentication.", {}, async () => {
+        try {
+            const authMethod = ctx.restApi.getAuthMethod();
+            if (authMethod !== "oauth2") {
+                return createErrorResponse(new Error(`Token refresh only available for OAuth2 authentication. Current auth method: ${authMethod}`), "rest-refresh-token");
+            }
+            ctx.restApi.clearTokenCache();
+            return createSuccessResponse({
+                message: "OAuth2 token cache cleared. A new token will be acquired on the next request.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error, "rest-refresh-token");
+        }
+    });
+    // Tool: rest-batch-request
+    server.tool("rest-batch-request", "Execute multiple REST API requests sequentially. Useful for testing a series of related endpoints or performing a workflow. Returns results for all requests.", {
+        requests: z.array(z.object({
+            method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]),
+            endpoint: z.string(),
+            body: z.any().optional(),
+            headers: z.record(z.string()).optional(),
+            host: z.string().optional(),
+        })).describe("Array of request configurations to execute sequentially"),
+        stopOnError: z
+            .boolean()
+            .optional()
+            .describe("Stop executing remaining requests if one fails (default: false)"),
+    }, async ({ requests, stopOnError = false, }) => {
+        try {
+            const results = [];
+            for (let i = 0; i < requests.length; i++) {
+                const req = requests[i];
+                try {
+                    const result = await ctx.restApi.request(req);
+                    results.push({
+                        index: i,
+                        endpoint: req.endpoint,
+                        success: !result.validation.isError,
+                        result,
+                    });
+                    if (stopOnError && result.validation.isError) {
+                        break;
+                    }
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    results.push({
+                        index: i,
+                        endpoint: req.endpoint,
+                        success: false,
+                        error: errorMessage,
+                    });
+                    if (stopOnError) {
+                        break;
+                    }
+                }
+            }
+            return createSuccessResponse({
+                totalRequests: requests.length,
+                executedRequests: results.length,
+                successfulRequests: results.filter((r) => r.success).length,
+                results,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error, "rest-batch-request");
+        }
+    });
+    // Tool: rest-list-endpoints
+    server.tool("rest-list-endpoints", "List all available REST API endpoints with their supported HTTP methods. Use this to discover what entities/resources are available in the API. Requires REST_OPENAPI_URL configuration pointing to your API's OpenAPI/Swagger spec.", {
+        filter: z
+            .string()
+            .optional()
+            .describe("Optional filter to match endpoint paths (case-insensitive contains match). Example: 'exam' returns all exam-related endpoints."),
+    }, async ({ filter }) => {
+        try {
+            const result = await ctx.restApi.listEndpointsAsync(filter);
+            return createSuccessResponse(result);
+        }
+        catch (error) {
+            return createErrorResponse(error, "rest-list-endpoints");
+        }
+    });
+    // Tool: rest-get-schema
+    server.tool("rest-get-schema", "Get the schema/field definitions for a specific entity. Returns field names, types, whether they're required, and any validation rules. Use this before creating or updating records to understand the data structure. Requires REST_OPENAPI_URL configuration pointing to your API's OpenAPI/Swagger spec.", {
+        entity: z
+            .string()
+            .describe("Entity name (singular or plural). Examples: 'sic_exam', 'sic_exams', 'contact', 'contacts'"),
+    }, async ({ entity }) => {
+        try {
+            if (!ctx.restApi.hasOpenApiConfig()) {
+                return createErrorResponse(new Error("No schema configuration available. Configure REST_OPENAPI_URL pointing to your API's OpenAPI/Swagger spec."), "rest-get-schema");
+            }
+            const schema = await ctx.restApi.getSchemaAsync(entity);
+            if (!schema) {
+                return createErrorResponse(new Error(`Entity '${entity}' not found. Use rest-list-endpoints to see available entities.`), "rest-get-schema");
+            }
+            return createSuccessResponse(schema);
+        }
+        catch (error) {
+            return createErrorResponse(error, "rest-get-schema");
+        }
+    });
+    console.error("rest-api tools registered: 6 tools");
+}
+//# sourceMappingURL=rest-tools.js.map

package/build/tools/rest-tools.js.map

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

package/build/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Service context shared between MCP server entry points.
+ * Uses lazy getters to initialize services on-demand.
+ */
+import type { RestApiService } from './services/rest-api-service.js';
+export interface ServiceContext {
+    readonly restApi: RestApiService;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}