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

package/build/models/index.js

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

package/build/models/index.js.map

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

package/build/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export declare function registerAllPrompts(server: any): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CA8BpD"}

package/build/prompts/index.js

@@ -0,0 +1,24 @@
+/**
+ * Prompts barrel export + combined registration
+ */
+import { getRestApiGuidePrompt, getRestApiTroubleshootPrompt } from './templates.js';
+export function registerAllPrompts(server) {
+    server.prompt("rest-api-guide", "Comprehensive guide for using the REST API testing tools", {}, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: getRestApiGuidePrompt() },
+            },
+        ],
+    }));
+    server.prompt("rest-api-troubleshoot", "Troubleshooting guide for common REST API testing issues", {}, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: getRestApiTroubleshootPrompt() },
+            },
+        ],
+    }));
+    console.error("rest-api prompts registered: 2 prompts");
+}
+//# sourceMappingURL=index.js.map

package/build/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAErF,MAAM,UAAU,kBAAkB,CAAC,MAAW;IAC5C,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,0DAA0D,EAC1D,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE;aACzD;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,uBAAuB,EACvB,0DAA0D,EAC1D,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,EAAE,EAAE;aAChE;SACF;KACF,CAAC,CACH,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC"}

package/build/prompts/templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * REST API prompt templates
+ */
+export declare function getRestApiGuidePrompt(): string;
+export declare function getRestApiTroubleshootPrompt(): string;
+//# sourceMappingURL=templates.d.ts.map

package/build/prompts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,qBAAqB,IAAI,MAAM,CA8E9C;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAqFrD"}

package/build/prompts/templates.js

@@ -0,0 +1,169 @@
+/**
+ * REST API prompt templates
+ */
+export function getRestApiGuidePrompt() {
+    return `# REST API Testing Guide
+
+## Overview
+
+This MCP server enables testing REST API endpoints with comprehensive authentication support, including automatic JWT token generation via OAuth2 client credentials flow.
+
+## Available Tools
+
+### 1. rest-request
+Execute a single HTTP request to any REST endpoint.
+
+**Parameters:**
+- \`method\`: HTTP method (GET, POST, PUT, DELETE, PATCH)
+- \`endpoint\`: API path (e.g., "/users", "/api/v1/orders")
+- \`body\`: Request body for POST/PUT/PATCH (optional)
+- \`headers\`: Additional headers (optional)
+- \`host\`: Override base URL (optional)
+
+**Example:**
+\`\`\`json
+{
+  "method": "POST",
+  "endpoint": "/api/users",
+  "body": { "name": "John", "email": "john@example.com" }
+}
+\`\`\`
+
+### 2. rest-config
+Get current service configuration summary.
+
+### 3. rest-refresh-token
+Force refresh OAuth2 token (clears cache).
+
+### 4. rest-batch-request
+Execute multiple requests sequentially.
+
+## Authentication Methods
+
+### OAuth2 Client Credentials (Recommended for APIs)
+Automatically acquires and caches JWT tokens. Tokens are refreshed when expired.
+
+Required environment variables:
+- \`OAUTH2_TOKEN_URL\`: Token endpoint URL
+- \`OAUTH2_CLIENT_ID\`: Client ID
+- \`OAUTH2_CLIENT_SECRET\`: Client secret
+- \`OAUTH2_SCOPE\`: OAuth2 scope
+
+### Static Bearer Token
+For pre-acquired tokens:
+- \`AUTH_BEARER\`: The bearer token value
+
+### Basic Authentication
+- \`AUTH_BASIC_USERNAME\`: Username
+- \`AUTH_BASIC_PASSWORD\`: Password
+
+### API Key
+- \`AUTH_APIKEY_HEADER_NAME\`: Header name
+- \`AUTH_APIKEY_VALUE\`: API key value
+
+## Configuration
+
+### Required
+- \`REST_BASE_URL\`: Base URL for all requests
+
+### Optional
+- \`REST_RESPONSE_SIZE_LIMIT\`: Max response size in bytes (default: 10000)
+- \`REST_ENABLE_SSL_VERIFY\`: SSL verification (default: true)
+- \`REST_TIMEOUT\`: Request timeout in ms (default: 30000)
+- \`HEADER_*\`: Custom headers (e.g., HEADER_Accept=application/json)
+
+## Best Practices
+
+1. **Use OAuth2 for production APIs** - Automatic token management
+2. **Set appropriate response limits** - Prevent memory issues
+3. **Use custom headers wisely** - Don't put secrets in headers
+4. **Enable SSL verification** - Only disable for development
+`;
+}
+export function getRestApiTroubleshootPrompt() {
+    return `# REST API Troubleshooting Guide
+
+## Common Issues and Solutions
+
+### 1. Authentication Failures
+
+**Symptom:** 401 Unauthorized or 403 Forbidden responses
+
+**Solutions:**
+- For OAuth2: Check token URL, client ID, client secret, and scope
+- Use \`rest-refresh-token\` to force a new token
+- Verify scope matches API requirements
+- Check if credentials have expired
+
+### 2. Connection Issues
+
+**Symptom:** ECONNREFUSED, ETIMEDOUT, or network errors
+
+**Solutions:**
+- Verify REST_BASE_URL is correct
+- Check if API is accessible from your network
+- For self-signed certs, set REST_ENABLE_SSL_VERIFY=false (dev only)
+- Increase REST_TIMEOUT for slow APIs
+
+### 3. Response Truncation
+
+**Symptom:** Response body appears cut off
+
+**Solution:** Increase REST_RESPONSE_SIZE_LIMIT environment variable
+
+### 4. Token Expiration
+
+**Symptom:** Requests work initially then fail with 401
+
+**Solution:**
+- OAuth2 tokens are auto-refreshed, but you can force with rest-refresh-token
+- For static bearer tokens, manually update AUTH_BEARER
+
+### 5. CORS Issues
+
+**Note:** MCP servers run server-side, so CORS doesn't apply.
+If you see CORS-related errors, the issue is elsewhere.
+
+## Debugging Steps
+
+1. Use \`rest-config\` to verify current configuration
+2. Try a simple GET request first
+3. Check response timing for network issues
+4. Examine response headers for error details
+5. Use \`rest-refresh-token\` if auth seems stale
+
+## Environment Variable Reference
+
+\`\`\`bash
+# Required
+REST_BASE_URL=https://api.example.com
+
+# OAuth2 (recommended)
+OAUTH2_TOKEN_URL=https://login.example.com/oauth2/token
+OAUTH2_CLIENT_ID=your-client-id
+OAUTH2_CLIENT_SECRET=your-secret
+OAUTH2_SCOPE=api://your-app/.default
+
+# Alternative: Static bearer
+AUTH_BEARER=your-token
+
+# Alternative: Basic auth
+AUTH_BASIC_USERNAME=user
+AUTH_BASIC_PASSWORD=pass
+
+# Alternative: API key
+AUTH_APIKEY_HEADER_NAME=X-Api-Key
+AUTH_APIKEY_VALUE=your-key
+
+# Optional settings
+REST_RESPONSE_SIZE_LIMIT=50000
+REST_ENABLE_SSL_VERIFY=true
+REST_TIMEOUT=60000
+
+# Custom headers
+HEADER_Accept=application/json
+HEADER_X-Custom=value
+\`\`\`
+`;
+}
+//# sourceMappingURL=templates.js.map

package/build/prompts/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ER,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFR,CAAC;AACF,CAAC"}

package/build/services/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Services barrel export
+ */
+export { RestApiService } from './rest-api-service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/build/services/index.js

@@ -0,0 +1,5 @@
+/**
+ * Services barrel export
+ */
+export { RestApiService } from './rest-api-service.js';
+//# sourceMappingURL=index.js.map

package/build/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/build/services/openapi-parser.d.ts

@@ -0,0 +1,69 @@
+/**
+ * OpenAPI/Swagger spec parsing utilities
+ */
+import type { EndpointDefinition, EntitySchema } from '../models/index.js';
+/**
+ * Cached OpenAPI spec with parsed endpoints and schemas
+ */
+export interface CachedOpenApiSpec {
+    endpoints: EndpointDefinition[];
+    schemas: Record<string, EntitySchema>;
+    fetchedAt: number;
+    source: string;
+}
+/**
+ * OpenAPI 3.x types (simplified for our needs)
+ */
+export interface OpenApiSpec {
+    openapi?: string;
+    info?: {
+        title?: string;
+        version?: string;
+    };
+    paths?: Record<string, OpenApiPathItem | undefined>;
+    components?: {
+        schemas?: Record<string, OpenApiSchema | undefined>;
+    };
+}
+export interface OpenApiPathItem {
+    get?: OpenApiOperation;
+    post?: OpenApiOperation;
+    put?: OpenApiOperation;
+    delete?: OpenApiOperation;
+    patch?: OpenApiOperation;
+}
+export interface OpenApiOperation {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    requestBody?: any;
+    responses?: any;
+}
+export interface OpenApiSchema {
+    type?: string;
+    properties?: Record<string, OpenApiProperty>;
+    required?: string[];
+    description?: string;
+}
+export interface OpenApiProperty {
+    type?: string;
+    format?: string;
+    description?: string;
+    nullable?: boolean;
+    maxLength?: number;
+    enum?: string[];
+    $ref?: string;
+}
+/**
+ * Map OpenAPI type to simplified type string
+ */
+export declare function mapOpenApiType(propObj: OpenApiProperty): string;
+/**
+ * Parse OpenAPI 3.x spec into our internal format
+ */
+export declare function parseOpenApiSpec(spec: OpenApiSpec): {
+    endpoints: EndpointDefinition[];
+    schemas: Record<string, EntitySchema>;
+};
+//# sourceMappingURL=openapi-parser.d.ts.map

package/build/services/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../src/services/openapi-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAmB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC;KACrD,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAiC/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG;IACnD,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CA2HA"}

package/build/services/openapi-parser.js

@@ -0,0 +1,151 @@
+/**
+ * Map OpenAPI type to simplified type string
+ */
+export function mapOpenApiType(propObj) {
+    if (propObj.$ref) {
+        const refParts = propObj.$ref.split("/");
+        return refParts[refParts.length - 1];
+    }
+    const type = propObj.type || "any";
+    const format = propObj.format;
+    if (type === "string") {
+        if (format === "uuid")
+            return "Guid";
+        if (format === "date-time")
+            return "datetime";
+        if (format === "date")
+            return "date";
+        return "string";
+    }
+    if (type === "integer") {
+        if (format === "int64")
+            return "long";
+        return "int";
+    }
+    if (type === "number") {
+        if (format === "decimal")
+            return "decimal";
+        if (format === "double")
+            return "double";
+        if (format === "float")
+            return "float";
+        return "number";
+    }
+    if (type === "boolean")
+        return "boolean";
+    if (type === "array")
+        return "array";
+    if (type === "object")
+        return "object";
+    return type;
+}
+/**
+ * Parse OpenAPI 3.x spec into our internal format
+ */
+export function parseOpenApiSpec(spec) {
+    const endpoints = [];
+    const schemas = {};
+    // Parse paths into endpoints
+    if (spec.paths) {
+        const pathMethods = {};
+        for (const [path, pathItem] of Object.entries(spec.paths)) {
+            if (!pathItem)
+                continue;
+            const methods = [];
+            if (pathItem.get)
+                methods.push("GET");
+            if (pathItem.post)
+                methods.push("POST");
+            if (pathItem.put)
+                methods.push("PUT");
+            if (pathItem.delete)
+                methods.push("DELETE");
+            if (pathItem.patch)
+                methods.push("PATCH");
+            if (methods.length > 0) {
+                const basePath = path.replace(/\/\{[^}]+\}$/, "");
+                if (!pathMethods[basePath]) {
+                    pathMethods[basePath] = [];
+                }
+                for (const method of methods) {
+                    if (!pathMethods[basePath].includes(method)) {
+                        pathMethods[basePath].push(method);
+                    }
+                }
+            }
+        }
+        for (const [path, methods] of Object.entries(pathMethods)) {
+            const pathSegments = path.split("/").filter(Boolean);
+            const lastSegment = pathSegments[pathSegments.length - 1] || "";
+            const entityName = lastSegment.endsWith("s")
+                ? lastSegment.slice(0, -1)
+                : lastSegment;
+            let description;
+            const fullPath = spec.paths[path];
+            if (fullPath) {
+                description =
+                    fullPath.get?.summary ||
+                        fullPath.post?.summary ||
+                        fullPath.get?.description ||
+                        fullPath.post?.description;
+            }
+            endpoints.push({
+                path,
+                methods: methods.sort(),
+                entityName: entityName || undefined,
+                description,
+            });
+        }
+    }
+    // Parse schemas
+    if (spec.components?.schemas) {
+        for (const [schemaName, schemaObj] of Object.entries(spec.components.schemas)) {
+            if (!schemaObj || typeof schemaObj !== "object")
+                continue;
+            if (schemaName.endsWith("_input") || schemaName.endsWith("_output")) {
+                continue;
+            }
+            const fields = [];
+            let primaryKey = "id";
+            if (schemaObj.properties) {
+                const required = new Set(schemaObj.required || []);
+                for (const [propName, propObj] of Object.entries(schemaObj.properties)) {
+                    if (!propObj || typeof propObj !== "object")
+                        continue;
+                    if (propName === "id" ||
+                        propName.endsWith("id") ||
+                        propName.endsWith("Id")) {
+                        primaryKey = propName;
+                    }
+                    const field = {
+                        name: propName,
+                        type: mapOpenApiType(propObj),
+                        required: required.has(propName),
+                        nullable: propObj.nullable === true,
+                    };
+                    if (propObj.maxLength) {
+                        field.maxLength = propObj.maxLength;
+                    }
+                    if (propObj.description) {
+                        field.description = propObj.description;
+                    }
+                    if (propObj.enum) {
+                        field.enumValues = propObj.enum;
+                    }
+                    fields.push(field);
+                }
+            }
+            const pluralName = schemaName.endsWith("s") ? schemaName : `${schemaName}s`;
+            const endpoint = `/${pluralName.toLowerCase()}`;
+            schemas[schemaName.toLowerCase()] = {
+                entityName: schemaName,
+                pluralName,
+                endpoint,
+                primaryKey,
+                fields,
+            };
+        }
+    }
+    return { endpoints, schemas };
+}
+//# sourceMappingURL=openapi-parser.js.map

package/build/services/openapi-parser.js.map

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

package/build/services/rest-api-service.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 type { RestApiConfig, RequestOptions, RequestResult, EndpointDefinition, EntitySchema } from '../models/index.js';
+export declare class RestApiService {
+    private config;
+    private cachedToken;
+    private httpsAgent;
+    private cachedOpenApi;
+    private openApiFetchPromise;
+    /** OpenAPI cache TTL in milliseconds (default: 5 minutes) */
+    private static readonly OPENAPI_CACHE_TTL;
+    constructor(config: RestApiConfig);
+    /**
+     * Get the current authentication method name
+     */
+    getAuthMethod(): string;
+    /**
+     * Get OAuth2 access token using client credentials flow
+     * Caches token and refreshes when expired
+     */
+    private getOAuth2Token;
+    /**
+     * Get the Authorization header value based on configured auth method
+     */
+    private getAuthHeader;
+    /**
+     * Sanitize headers for display (redact sensitive values)
+     */
+    private sanitizeHeaders;
+    /**
+     * Execute an HTTP request
+     */
+    request(options: RequestOptions): Promise<RequestResult>;
+    /**
+     * Force refresh the OAuth2 token (clears cache)
+     */
+    clearTokenCache(): void;
+    /**
+     * Get configuration summary (safe to display)
+     */
+    getConfigSummary(): {
+        baseUrl: string;
+        authMethod: string;
+        sslVerification: boolean;
+        responseSizeLimit: number;
+        customHeaderCount: number;
+        oauth2TokenUrl?: string;
+        openApiUrl?: string;
+    };
+    /**
+     * Check if OpenAPI URL is configured
+     */
+    hasOpenApiConfig(): boolean;
+    /**
+     * Fetch and parse OpenAPI spec from configured URL
+     * Results are cached for OPENAPI_CACHE_TTL
+     */
+    private fetchOpenApiSpec;
+    /**
+     * Actually fetch and parse the OpenAPI spec
+     */
+    private doFetchOpenApiSpec;
+    /**
+     * Clear OpenAPI cache (forces re-fetch on next call)
+     */
+    clearOpenApiCache(): void;
+    /**
+     * List all available API endpoints from OpenAPI spec
+     * @param filter Optional filter to match endpoint paths (case-insensitive contains match)
+     */
+    listEndpointsAsync(filter?: string): Promise<{
+        baseUrl: string;
+        endpointCount: number;
+        endpoints: EndpointDefinition[];
+        source: string;
+    }>;
+    /**
+     * Get schema for a specific entity from OpenAPI spec
+     * @param entity Entity name (singular or plural)
+     */
+    getSchemaAsync(entity: string): Promise<EntitySchema | null>;
+}
+//# sourceMappingURL=rest-api-service.d.ts.map

package/build/services/rest-api-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-api-service.d.ts","sourceRoot":"","sources":["../../src/services/rest-api-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAS5B,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,mBAAmB,CAA2C;IAEtE,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;gBAE9C,MAAM,EAAE,aAAa;IA+BjC;;OAEG;IACH,aAAa,IAAI,MAAM;IAQvB;;;OAGG;YACW,cAAc;IAgE5B;;OAEG;YACW,aAAa;IAuB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgDvB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAmH9D;;OAEG;IACH,eAAe,IAAI,IAAI;IAKvB;;OAEG;IACH,gBAAgB,IAAI;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,OAAO,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAYD;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;;OAGG;YACW,gBAAgB;IA2B9B;;OAEG;YACW,kBAAkB;IA2ChC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;;OAGG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IA6BF;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAoBnE"}