bling-docs-mcp 1.0.0

package/dist/lib/embeddings.js

@@ -0,0 +1,52 @@
+/**
+ * Google Embeddings Module
+ * Uses Google's text-embedding-004 model to generate embeddings
+ * for semantic search over API endpoints and schemas
+ */
+import { GoogleGenerativeAI } from '@google/generative-ai';
+const MODEL_NAME = 'text-embedding-004';
+const BATCH_SIZE = 100; // Google allows up to 100 texts per batch request
+let genAI = null;
+function getClient() {
+    if (!genAI) {
+        const apiKey = process.env.GOOGLE_API_KEY;
+        if (!apiKey) {
+            throw new Error('GOOGLE_API_KEY environment variable is required for semantic search');
+        }
+        genAI = new GoogleGenerativeAI(apiKey);
+    }
+    return genAI;
+}
+/**
+ * Generate an embedding for a single text
+ */
+export async function embedText(text) {
+    const client = getClient();
+    const model = client.getGenerativeModel({ model: MODEL_NAME });
+    const result = await model.embedContent(text);
+    return result.embedding.values;
+}
+/**
+ * Generate embeddings for multiple texts in batches
+ */
+export async function embedTexts(texts) {
+    const client = getClient();
+    const model = client.getGenerativeModel({ model: MODEL_NAME });
+    const embeddings = [];
+    for (let i = 0; i < texts.length; i += BATCH_SIZE) {
+        const batch = texts.slice(i, i + BATCH_SIZE);
+        const requests = batch.map(text => ({ content: { parts: [{ text }], role: 'user' } }));
+        const result = await model.batchEmbedContents({ requests });
+        for (const e of result.embeddings) {
+            embeddings.push(e.values);
+        }
+    }
+    return embeddings;
+}
+/**
+ * Check if the Google API key is configured
+ */
+export function isEmbeddingEnabled() {
+    return !!process.env.GOOGLE_API_KEY;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/lib/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/lib/embeddings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AACxC,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,kDAAkD;AAE1E,IAAI,KAAK,GAA8B,IAAI,CAAC;AAE5C,SAAS,SAAS;IAChB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,KAAK,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAe,EAAE,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AACtC,CAAC"}

package/dist/lib/indexer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Indexer Module
+ * Processes OpenAPI specification and creates indexed data structures
+ * for fast lookup and search operations
+ */
+import type { OpenAPISpec } from './loader.js';
+import type { IndexedData } from './types.js';
+/**
+ * Index an OpenAPI specification
+ * Extracts and organizes endpoints, schemas, tags, and security schemes
+ */
+export declare function indexOpenAPISpec(spec: OpenAPISpec): IndexedData;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/lib/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/lib/indexer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EACV,WAAW,EAQZ,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAoG/D"}

package/dist/lib/indexer.js

@@ -0,0 +1,305 @@
+/**
+ * Indexer Module
+ * Processes OpenAPI specification and creates indexed data structures
+ * for fast lookup and search operations
+ */
+/**
+ * Index an OpenAPI specification
+ * Extracts and organizes endpoints, schemas, tags, and security schemes
+ */
+export function indexOpenAPISpec(spec) {
+    const endpoints = [];
+    const endpointsByTag = new Map();
+    const endpointsByPath = new Map();
+    const tagCounts = new Map();
+    // Extract base URL
+    const baseUrl = spec.servers?.[0]?.url || '';
+    // Process all paths and methods
+    for (const [path, pathItem] of Object.entries(spec.paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        const methods = ['get', 'post', 'put', 'delete', 'patch', 'options', 'head', 'trace'];
+        for (const method of methods) {
+            const operation = pathItem[method];
+            if (!operation || typeof operation !== 'object')
+                continue;
+            // Extract endpoint info
+            const endpointInfo = {
+                path,
+                method: method.toUpperCase(),
+                operationId: operation.operationId,
+                summary: operation.summary || '',
+                description: operation.description || '',
+                tags: Array.isArray(operation.tags) ? operation.tags : [],
+                parameters: extractParameters(operation.parameters, pathItem.parameters, spec),
+                requestBody: extractRequestBody(operation.requestBody),
+                responses: extractResponses(operation.responses),
+                security: extractSecurity(operation.security),
+                deprecated: operation.deprecated === true,
+                servers: extractServers(operation.servers || pathItem.servers),
+                externalDocs: extractExternalDocs(operation.externalDocs),
+                callbacks: operation.callbacks,
+                extensions: extractExtensions(operation),
+                raw: operation,
+            };
+            // Add to flat list
+            endpoints.push(endpointInfo);
+            // Index by path+method
+            const key = `${method.toUpperCase()} ${path}`;
+            endpointsByPath.set(key, endpointInfo);
+            // Index by tags
+            for (const tag of endpointInfo.tags) {
+                if (!endpointsByTag.has(tag)) {
+                    endpointsByTag.set(tag, []);
+                }
+                endpointsByTag.get(tag).push(endpointInfo);
+                // Count tags
+                tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
+            }
+        }
+    }
+    // Build tag info list
+    const tags = Array.from(tagCounts.entries())
+        .map(([name, endpointCount]) => {
+        // Try to find tag description from spec (if tags array exists)
+        const specTags = spec.tags;
+        const tagDef = Array.isArray(specTags)
+            ? specTags.find((t) => t.name === name)
+            : undefined;
+        return {
+            name,
+            description: tagDef?.description,
+            endpointCount,
+        };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+    // Extract security schemes
+    const securitySchemes = extractSecuritySchemes(spec);
+    // Extract schemas (will be resolved by schema-resolver)
+    const schemas = new Map();
+    if (spec.components?.schemas) {
+        for (const [name, schema] of Object.entries(spec.components.schemas)) {
+            if (schema && typeof schema === 'object') {
+                // Store raw schema for now - will be resolved later
+                const rawSchema = schema;
+                rawSchema.raw = schema;
+                schemas.set(name, rawSchema);
+            }
+        }
+    }
+    return {
+        endpoints,
+        endpointsByTag,
+        endpointsByPath,
+        schemas,
+        tags,
+        securitySchemes,
+        baseUrl,
+    };
+}
+/**
+ * Extract parameters from operation and path item
+ * Note: $ref are already resolved by @scalar/openapi-parser
+ */
+function extractParameters(operationParams, pathParams, spec) {
+    const params = [];
+    const allParams = [...(pathParams || []), ...(operationParams || [])];
+    for (const param of allParams) {
+        if (!param || typeof param !== 'object')
+            continue;
+        // Parameters are already dereferenced by @scalar/openapi-parser
+        const resolvedParam = param;
+        const paramInfo = {
+            name: resolvedParam.name || '',
+            in: resolvedParam.in || 'query',
+            required: resolvedParam.required === true,
+            description: resolvedParam.description,
+            type: extractType(resolvedParam.schema || resolvedParam),
+            example: resolvedParam.example,
+            schema: resolvedParam.schema,
+            deprecated: resolvedParam.deprecated === true,
+            style: resolvedParam.style,
+            explode: resolvedParam.explode,
+            allowEmptyValue: resolvedParam.allowEmptyValue,
+            examples: resolvedParam.examples,
+            content: resolvedParam.content,
+            raw: resolvedParam,
+        };
+        params.push(paramInfo);
+    }
+    return params;
+}
+/**
+ * Extract request body information
+ * Note: $ref are already resolved by @scalar/openapi-parser
+ */
+function extractRequestBody(requestBody) {
+    if (!requestBody || typeof requestBody !== 'object')
+        return undefined;
+    const content = requestBody.content;
+    if (!content || typeof content !== 'object')
+        return undefined;
+    // Get first content type (usually application/json)
+    const contentTypes = Object.keys(content);
+    const contentType = contentTypes[0];
+    if (!contentType)
+        return undefined;
+    const mediaType = content[contentType];
+    if (!mediaType || !mediaType.schema)
+        return undefined;
+    return {
+        required: requestBody.required === true,
+        contentType,
+        schema: mediaType.schema,
+        description: requestBody.description,
+        allContentTypes: contentTypes,
+    };
+}
+/**
+ * Extract responses information
+ * Note: $ref are already resolved by @scalar/openapi-parser
+ */
+function extractResponses(responses) {
+    if (!responses || typeof responses !== 'object')
+        return [];
+    const responseList = [];
+    for (const [statusCode, response] of Object.entries(responses)) {
+        if (!response || typeof response !== 'object')
+            continue;
+        const responseInfo = {
+            statusCode,
+            description: response.description || '',
+            allContentTypes: undefined,
+            links: response.links,
+        };
+        // Extract schema if present
+        const content = response.content;
+        if (content && typeof content === 'object') {
+            const contentTypes = Object.keys(content);
+            responseInfo.allContentTypes = contentTypes;
+            const contentType = contentTypes[0];
+            if (contentType) {
+                const mediaType = content[contentType];
+                if (mediaType?.schema) {
+                    responseInfo.schema = mediaType.schema;
+                }
+            }
+        }
+        // Extract headers if present
+        const headers = response.headers;
+        if (headers && typeof headers === 'object') {
+            responseInfo.headers = {};
+            for (const [headerName, headerDef] of Object.entries(headers)) {
+                if (headerDef && typeof headerDef === 'object') {
+                    responseInfo.headers[headerName] = {
+                        description: headerDef.description,
+                        required: headerDef.required === true,
+                        schema: headerDef.schema,
+                        deprecated: headerDef.deprecated === true,
+                        example: headerDef.example,
+                        examples: headerDef.examples,
+                    };
+                }
+            }
+        }
+        responseList.push(responseInfo);
+    }
+    return responseList;
+}
+/**
+ * Extract security requirements
+ */
+function extractSecurity(security) {
+    if (!Array.isArray(security) || security.length === 0)
+        return undefined;
+    const schemes = [];
+    for (const secReq of security) {
+        if (secReq && typeof secReq === 'object') {
+            schemes.push(...Object.keys(secReq));
+        }
+    }
+    return schemes.length > 0 ? schemes : undefined;
+}
+/**
+ * Extract security schemes from spec
+ */
+function extractSecuritySchemes(spec) {
+    const schemes = [];
+    if (!spec.components?.securitySchemes)
+        return schemes;
+    for (const [name, scheme] of Object.entries(spec.components.securitySchemes)) {
+        if (!scheme || typeof scheme !== 'object')
+            continue;
+        const securityScheme = {
+            name,
+            type: scheme.type || '',
+            description: scheme.description,
+            scheme: scheme.scheme,
+            bearerFormat: scheme.bearerFormat,
+            in: scheme.in,
+            flows: scheme.flows,
+        };
+        schemes.push(securityScheme);
+    }
+    return schemes;
+}
+/**
+ * Extract type from schema object
+ */
+function extractType(schema) {
+    if (!schema || typeof schema !== 'object')
+        return 'string';
+    if (schema.type) {
+        if (schema.type === 'array' && schema.items) {
+            const itemType = extractType(schema.items);
+            return `${itemType}[]`;
+        }
+        return schema.type;
+    }
+    if (schema.$ref) {
+        // Extract type name from $ref
+        const parts = schema.$ref.split('/');
+        return parts[parts.length - 1] || 'object';
+    }
+    return 'object';
+}
+/**
+ * Extract servers information
+ */
+function extractServers(servers) {
+    if (!Array.isArray(servers) || servers.length === 0)
+        return undefined;
+    return servers.map((server) => ({
+        url: server.url || '',
+        description: server.description,
+        variables: server.variables,
+    }));
+}
+/**
+ * Extract external documentation
+ */
+function extractExternalDocs(externalDocs) {
+    if (!externalDocs || typeof externalDocs !== 'object')
+        return undefined;
+    return {
+        url: externalDocs.url || '',
+        description: externalDocs.description,
+    };
+}
+/**
+ * Extract custom vendor extensions (x-* fields)
+ */
+function extractExtensions(obj) {
+    if (!obj || typeof obj !== 'object')
+        return undefined;
+    const extensions = {};
+    let hasExtensions = false;
+    for (const [key, value] of Object.entries(obj)) {
+        if (key.startsWith('x-')) {
+            extensions[key] = value;
+            hasExtensions = true;
+        }
+    }
+    return hasExtensions ? extensions : undefined;
+}
+//# sourceMappingURL=indexer.js.map

package/dist/lib/indexer.js.map

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

package/dist/lib/loader.d.ts

@@ -0,0 +1,34 @@
+/**
+ * OpenAPI Loader Module
+ * Uses @scalar/openapi-parser for robust OpenAPI loading and validation
+ */
+import { OpenAPIV3 } from 'openapi-types';
+export type OpenAPISpec = OpenAPIV3.Document;
+export declare class LoaderError extends Error {
+    code: 'NETWORK_ERROR' | 'PARSE_ERROR' | 'VALIDATION_ERROR';
+    cause?: Error | undefined;
+    constructor(message: string, code: 'NETWORK_ERROR' | 'PARSE_ERROR' | 'VALIDATION_ERROR', cause?: Error | undefined);
+}
+interface LoadOptions {
+    maxRetries?: number;
+    timeoutMs?: number;
+    retryDelayMs?: number;
+    dereference?: boolean;
+}
+/**
+ * Discover the current Bling OpenAPI spec URL automatically.
+ *
+ * Strategy (handles SPA where URL is embedded in JS bundles, not HTML):
+ *   1. Fetch the /referencia page HTML
+ *   2. Extract the reference JS bundle URL from <link rel="modulepreload"> tags
+ *   3. Fetch that JS bundle
+ *   4. Extract the openapi-XXXX.json path from the bundle
+ */
+export declare function discoverOpenAPIUrl(): Promise<string>;
+/**
+ * Load OpenAPI specification from URL with validation and dereferencing.
+ * Uses a disk cache (TTL 15 days) to avoid downloading on every startup.
+ */
+export declare function loadOpenAPISpec(url: string, options?: LoadOptions): Promise<OpenAPISpec>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/lib/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE7C,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,kBAAkB;IAC1D,KAAK,CAAC,EAAE,KAAK;gBAFpB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,kBAAkB,EAC1D,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAED,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA+HD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAsD1D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,CA8GtB"}