@djangocfg/nextjs 2.1.5 → 2.1.7

package/dist/ai/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/ai/cli.mjs

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+
+// src/ai/constants.ts
+var MCP_BASE_URL = "https://mcp.djangocfg.com";
+var MCP_SERVER_URL = `${MCP_BASE_URL}/mcp`;
+var MCP_API_URL = `${MCP_BASE_URL}/api/search`;
+var API_SEARCH_ENDPOINT = "/api/search";
+var API_INFO_ENDPOINT = "/api/info";
+var DEFAULT_TIMEOUT = 1e4;
+var AI_DOCS_HINT = `\u{1F916} AI Docs: ${MCP_SERVER_URL} | pnpm ai-docs search "query"`;
+var AI_HINT = `
+DjangoCFG Documentation is available via MCP server.
+
+To get help with DjangoCFG configuration:
+1. Use the MCP server: ${MCP_SERVER_URL}
+2. Or search directly: ${MCP_API_URL}?q=YOUR_QUERY&limit=5
+
+Example queries:
+- "How to configure PostgreSQL database?"
+- "What is DatabaseConfig?"
+- "How to setup Redis cache?"
+- "Email configuration with SMTP"
+`;
+
+// src/ai/client.ts
+var DjangoCfgDocsClient = class {
+  constructor(baseUrl = MCP_BASE_URL, timeout = DEFAULT_TIMEOUT) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.timeout = timeout;
+  }
+  async makeRequest(endpoint, params) {
+    let url = `${this.baseUrl}${endpoint}`;
+    if (params) {
+      const searchParams = new URLSearchParams();
+      for (const [key, value] of Object.entries(params)) {
+        searchParams.set(key, String(value));
+      }
+      url = `${url}?${searchParams.toString()}`;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          Accept: "application/json",
+          "User-Agent": "DjangoCFG-AI-Client/1.0"
+        },
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP Error ${response.status}: ${response.statusText}`);
+      }
+      return await response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Search documentation.
+   */
+  async search(query2, options = {}) {
+    const { limit = 5, category } = options;
+    const params = { q: query2, limit };
+    if (category) {
+      params.category = category;
+    }
+    const data = await this.makeRequest(API_SEARCH_ENDPOINT, params);
+    const results = data.results || (Array.isArray(data) ? data : []);
+    return results.map((item) => ({
+      title: item.title || "",
+      content: item.content || item.snippet || "",
+      url: item.url || "",
+      score: item.score || 0,
+      category: item.category || ""
+    }));
+  }
+  /**
+   * Get detailed info about a specific topic.
+   */
+  async getInfo(topic) {
+    return this.makeRequest(API_INFO_ENDPOINT, { topic });
+  }
+  /**
+   * Get MCP server configuration for AI assistants.
+   */
+  getMcpConfig() {
+    return {
+      mcpServers: {
+        "djangocfg-docs": {
+          url: `${this.baseUrl}/mcp`
+        }
+      }
+    };
+  }
+};
+var defaultClient = null;
+function getClient() {
+  if (!defaultClient) {
+    defaultClient = new DjangoCfgDocsClient();
+  }
+  return defaultClient;
+}
+async function search(query2, options = {}) {
+  return getClient().search(query2, options);
+}
+function getMcpConfig() {
+  return getClient().getMcpConfig();
+}
+
+// src/ai/cli.ts
+var args = process.argv.slice(2);
+var command = args[0];
+var query = args.slice(1).join(" ");
+async function main() {
+  switch (command) {
+    case "search":
+    case "s":
+      if (!query) {
+        console.error('Usage: ai-docs search "your query"');
+        process.exit(1);
+      }
+      console.log(`
+\u{1F50D} Searching: ${query}
+`);
+      try {
+        const results = await search(query, { limit: 5 });
+        if (results.length === 0) {
+          console.log("No results found.");
+        } else {
+          results.forEach((r, i) => {
+            console.log(`${i + 1}. ${r.title}`);
+            console.log(`   ${r.content.slice(0, 150)}...`);
+            if (r.url) console.log(`   \u{1F4D6} ${r.url}`);
+            console.log("");
+          });
+        }
+      } catch (err) {
+        console.error("Error:", err instanceof Error ? err.message : err);
+        process.exit(1);
+      }
+      break;
+    case "mcp":
+      console.log("\n\u{1F4E1} MCP Server Configuration:\n");
+      console.log(JSON.stringify(getMcpConfig(), null, 2));
+      console.log("\nAdd this to your AI assistant configuration.");
+      break;
+    case "info":
+    case "i":
+      console.log("\n\u{1F916} DjangoCFG AI Documentation\n");
+      console.log(`MCP Server: ${MCP_SERVER_URL}`);
+      console.log(`Search API: ${MCP_API_URL}`);
+      console.log("\nUsage:");
+      console.log('  pnpm exec ai-docs search "database configuration"');
+      console.log("  pnpm exec ai-docs mcp");
+      break;
+    default:
+      console.log("\u{1F916} DjangoCFG AI Documentation CLI\n");
+      console.log("Commands:");
+      console.log("  search <query>  Search documentation");
+      console.log("  mcp             Show MCP server config");
+      console.log("  info            Show help\n");
+      console.log("Examples:");
+      console.log('  pnpm exec ai-docs search "database configuration"');
+      console.log('  pnpm exec ai-docs search "redis cache"');
+      console.log("  pnpm exec ai-docs mcp");
+      break;
+  }
+}
+main();
+//# sourceMappingURL=cli.mjs.map

package/dist/ai/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/constants.ts","../../src/ai/client.ts","../../src/ai/cli.ts"],"sourcesContent":["/**\n * AI Documentation Constants\n */\n\n// MCP Server URLs\nexport const MCP_BASE_URL = 'https://mcp.djangocfg.com';\nexport const MCP_SERVER_URL = `${MCP_BASE_URL}/mcp`;\nexport const MCP_API_URL = `${MCP_BASE_URL}/api/search`;\n\n// API Endpoints\nexport const API_SEARCH_ENDPOINT = '/api/search';\nexport const API_INFO_ENDPOINT = '/api/info';\nexport const DEFAULT_TIMEOUT = 10000; // ms\n\n// AI Hint for console output\nexport const AI_DOCS_HINT = `🤖 AI Docs: ${MCP_SERVER_URL} | pnpm ai-docs search \"query\"`;\n\n// Full AI Hint description\nexport const AI_HINT = `\nDjangoCFG Documentation is available via MCP server.\n\nTo get help with DjangoCFG configuration:\n1. Use the MCP server: ${MCP_SERVER_URL}\n2. Or search directly: ${MCP_API_URL}?q=YOUR_QUERY&limit=5\n\nExample queries:\n- \"How to configure PostgreSQL database?\"\n- \"What is DatabaseConfig?\"\n- \"How to setup Redis cache?\"\n- \"Email configuration with SMTP\"\n`;\n","/**\n * DjangoCFG Documentation Client\n *\n * HTTP client for accessing DjangoCFG documentation via MCP server API.\n */\n\nimport {\n  MCP_BASE_URL,\n  API_SEARCH_ENDPOINT,\n  API_INFO_ENDPOINT,\n  DEFAULT_TIMEOUT,\n} from './constants';\nimport type { SearchResult, SearchOptions, McpConfig, ApiSearchResponse } from './types';\n\n/**\n * Client for DjangoCFG Documentation API.\n */\nexport class DjangoCfgDocsClient {\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(baseUrl: string = MCP_BASE_URL, timeout: number = DEFAULT_TIMEOUT) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n    this.timeout = timeout;\n  }\n\n  private async makeRequest<T>(endpoint: string, params?: Record<string, string | number>): Promise<T> {\n    let url = `${this.baseUrl}${endpoint}`;\n\n    if (params) {\n      const searchParams = new URLSearchParams();\n      for (const [key, value] of Object.entries(params)) {\n        searchParams.set(key, String(value));\n      }\n      url = `${url}?${searchParams.toString()}`;\n    }\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          Accept: 'application/json',\n          'User-Agent': 'DjangoCFG-AI-Client/1.0',\n        },\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(`HTTP Error ${response.status}: ${response.statusText}`);\n      }\n\n      return await response.json();\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /**\n   * Search documentation.\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResult[]> {\n    const { limit = 5, category } = options;\n\n    const params: Record<string, string | number> = { q: query, limit };\n    if (category) {\n      params.category = category;\n    }\n\n    const data = await this.makeRequest<ApiSearchResponse>(API_SEARCH_ENDPOINT, params);\n\n    const results = data.results || (Array.isArray(data) ? data : []);\n\n    return results.map((item) => ({\n      title: item.title || '',\n      content: item.content || item.snippet || '',\n      url: item.url || '',\n      score: item.score || 0,\n      category: item.category || '',\n    }));\n  }\n\n  /**\n   * Get detailed info about a specific topic.\n   */\n  async getInfo(topic: string): Promise<Record<string, unknown>> {\n    return this.makeRequest(API_INFO_ENDPOINT, { topic });\n  }\n\n  /**\n   * Get MCP server configuration for AI assistants.\n   */\n  getMcpConfig(): McpConfig {\n    return {\n      mcpServers: {\n        'djangocfg-docs': {\n          url: `${this.baseUrl}/mcp`,\n        },\n      },\n    };\n  }\n}\n\n// Default client instance\nlet defaultClient: DjangoCfgDocsClient | null = null;\n\nfunction getClient(): DjangoCfgDocsClient {\n  if (!defaultClient) {\n    defaultClient = new DjangoCfgDocsClient();\n  }\n  return defaultClient;\n}\n\n/**\n * Search DjangoCFG documentation.\n *\n * @example\n * ```ts\n * const results = await search('database configuration');\n * results.forEach(r => console.log(r.title, r.url));\n * ```\n */\nexport async function search(query: string, options: SearchOptions = {}): Promise<SearchResult[]> {\n  return getClient().search(query, options);\n}\n\n/**\n * Get documentation as formatted text.\n *\n * @example\n * ```ts\n * const docs = await getDocs('How to configure PostgreSQL?');\n * console.log(docs);\n * ```\n */\nexport async function getDocs(query: string, limit: number = 3): Promise<string> {\n  const results = await search(query, { limit });\n\n  if (results.length === 0) {\n    return `No documentation found for: ${query}`;\n  }\n\n  const output: string[] = [];\n\n  results.forEach((r, i) => {\n    output.push(`## ${i + 1}. ${r.title}`);\n    output.push(r.content);\n    if (r.url) {\n      output.push(`📖 Read more: ${r.url}`);\n    }\n    output.push('');\n  });\n\n  return output.join('\\n');\n}\n\n/**\n * Get detailed info about a topic.\n */\nexport async function getInfo(topic: string): Promise<Record<string, unknown>> {\n  return getClient().getInfo(topic);\n}\n\n/**\n * Get MCP server configuration.\n */\nexport function getMcpConfig(): McpConfig {\n  return getClient().getMcpConfig();\n}\n","#!/usr/bin/env node\n/**\n * DjangoCFG AI Docs CLI\n *\n * Usage:\n *   pnpm exec ai-docs search \"database configuration\"\n *   pnpm exec ai-docs mcp\n *   npx @djangocfg/nextjs ai-docs search \"query\"\n */\n\nimport { search, getMcpConfig, MCP_SERVER_URL, MCP_API_URL } from './index';\n\nconst args = process.argv.slice(2);\nconst command = args[0];\nconst query = args.slice(1).join(' ');\n\nasync function main() {\n  switch (command) {\n    case 'search':\n    case 's':\n      if (!query) {\n        console.error('Usage: ai-docs search \"your query\"');\n        process.exit(1);\n      }\n      console.log(`\\n🔍 Searching: ${query}\\n`);\n      try {\n        const results = await search(query, { limit: 5 });\n        if (results.length === 0) {\n          console.log('No results found.');\n        } else {\n          results.forEach((r, i) => {\n            console.log(`${i + 1}. ${r.title}`);\n            console.log(`   ${r.content.slice(0, 150)}...`);\n            if (r.url) console.log(`   📖 ${r.url}`);\n            console.log('');\n          });\n        }\n      } catch (err) {\n        console.error('Error:', err instanceof Error ? err.message : err);\n        process.exit(1);\n      }\n      break;\n\n    case 'mcp':\n      console.log('\\n📡 MCP Server Configuration:\\n');\n      console.log(JSON.stringify(getMcpConfig(), null, 2));\n      console.log('\\nAdd this to your AI assistant configuration.');\n      break;\n\n    case 'info':\n    case 'i':\n      console.log('\\n🤖 DjangoCFG AI Documentation\\n');\n      console.log(`MCP Server: ${MCP_SERVER_URL}`);\n      console.log(`Search API: ${MCP_API_URL}`);\n      console.log('\\nUsage:');\n      console.log('  pnpm exec ai-docs search \"database configuration\"');\n      console.log('  pnpm exec ai-docs mcp');\n      break;\n\n    default:\n      console.log('🤖 DjangoCFG AI Documentation CLI\\n');\n      console.log('Commands:');\n      console.log('  search <query>  Search documentation');\n      console.log('  mcp             Show MCP server config');\n      console.log('  info            Show help\\n');\n      console.log('Examples:');\n      console.log('  pnpm exec ai-docs search \"database configuration\"');\n      console.log('  pnpm exec ai-docs search \"redis cache\"');\n      console.log('  pnpm exec ai-docs mcp');\n      break;\n  }\n}\n\nmain();\n"],"mappings":"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","names":["query"]}

package/dist/ai/index.d.mts

@@ -0,0 +1,81 @@
+export { A as AI_DOCS_HINT, c as AI_HINT, b as MCP_API_URL, M as MCP_BASE_URL, a as MCP_SERVER_URL } from '../constants-HezbftFb.mjs';
+
+/**
+ * AI Documentation Types
+ */
+interface SearchResult {
+    title: string;
+    content: string;
+    url: string;
+    score: number;
+    category: string;
+}
+interface SearchOptions {
+    limit?: number;
+    category?: string;
+}
+interface McpConfig {
+    mcpServers: {
+        'djangocfg-docs': {
+            url: string;
+        };
+    };
+}
+
+/**
+ * DjangoCFG Documentation Client
+ *
+ * HTTP client for accessing DjangoCFG documentation via MCP server API.
+ */
+
+/**
+ * Client for DjangoCFG Documentation API.
+ */
+declare class DjangoCfgDocsClient {
+    private baseUrl;
+    private timeout;
+    constructor(baseUrl?: string, timeout?: number);
+    private makeRequest;
+    /**
+     * Search documentation.
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Get detailed info about a specific topic.
+     */
+    getInfo(topic: string): Promise<Record<string, unknown>>;
+    /**
+     * Get MCP server configuration for AI assistants.
+     */
+    getMcpConfig(): McpConfig;
+}
+/**
+ * Search DjangoCFG documentation.
+ *
+ * @example
+ * ```ts
+ * const results = await search('database configuration');
+ * results.forEach(r => console.log(r.title, r.url));
+ * ```
+ */
+declare function search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+/**
+ * Get documentation as formatted text.
+ *
+ * @example
+ * ```ts
+ * const docs = await getDocs('How to configure PostgreSQL?');
+ * console.log(docs);
+ * ```
+ */
+declare function getDocs(query: string, limit?: number): Promise<string>;
+/**
+ * Get detailed info about a topic.
+ */
+declare function getInfo(topic: string): Promise<Record<string, unknown>>;
+/**
+ * Get MCP server configuration.
+ */
+declare function getMcpConfig(): McpConfig;
+
+export { DjangoCfgDocsClient, type McpConfig, type SearchOptions, type SearchResult, getDocs, getInfo, getMcpConfig, search };

package/dist/ai/index.mjs

@@ -0,0 +1,139 @@
+// src/ai/constants.ts
+var MCP_BASE_URL = "https://mcp.djangocfg.com";
+var MCP_SERVER_URL = `${MCP_BASE_URL}/mcp`;
+var MCP_API_URL = `${MCP_BASE_URL}/api/search`;
+var API_SEARCH_ENDPOINT = "/api/search";
+var API_INFO_ENDPOINT = "/api/info";
+var DEFAULT_TIMEOUT = 1e4;
+var AI_DOCS_HINT = `\u{1F916} AI Docs: ${MCP_SERVER_URL} | pnpm ai-docs search "query"`;
+var AI_HINT = `
+DjangoCFG Documentation is available via MCP server.
+
+To get help with DjangoCFG configuration:
+1. Use the MCP server: ${MCP_SERVER_URL}
+2. Or search directly: ${MCP_API_URL}?q=YOUR_QUERY&limit=5
+
+Example queries:
+- "How to configure PostgreSQL database?"
+- "What is DatabaseConfig?"
+- "How to setup Redis cache?"
+- "Email configuration with SMTP"
+`;
+
+// src/ai/client.ts
+var DjangoCfgDocsClient = class {
+  constructor(baseUrl = MCP_BASE_URL, timeout = DEFAULT_TIMEOUT) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.timeout = timeout;
+  }
+  async makeRequest(endpoint, params) {
+    let url = `${this.baseUrl}${endpoint}`;
+    if (params) {
+      const searchParams = new URLSearchParams();
+      for (const [key, value] of Object.entries(params)) {
+        searchParams.set(key, String(value));
+      }
+      url = `${url}?${searchParams.toString()}`;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          Accept: "application/json",
+          "User-Agent": "DjangoCFG-AI-Client/1.0"
+        },
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP Error ${response.status}: ${response.statusText}`);
+      }
+      return await response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Search documentation.
+   */
+  async search(query, options = {}) {
+    const { limit = 5, category } = options;
+    const params = { q: query, limit };
+    if (category) {
+      params.category = category;
+    }
+    const data = await this.makeRequest(API_SEARCH_ENDPOINT, params);
+    const results = data.results || (Array.isArray(data) ? data : []);
+    return results.map((item) => ({
+      title: item.title || "",
+      content: item.content || item.snippet || "",
+      url: item.url || "",
+      score: item.score || 0,
+      category: item.category || ""
+    }));
+  }
+  /**
+   * Get detailed info about a specific topic.
+   */
+  async getInfo(topic) {
+    return this.makeRequest(API_INFO_ENDPOINT, { topic });
+  }
+  /**
+   * Get MCP server configuration for AI assistants.
+   */
+  getMcpConfig() {
+    return {
+      mcpServers: {
+        "djangocfg-docs": {
+          url: `${this.baseUrl}/mcp`
+        }
+      }
+    };
+  }
+};
+var defaultClient = null;
+function getClient() {
+  if (!defaultClient) {
+    defaultClient = new DjangoCfgDocsClient();
+  }
+  return defaultClient;
+}
+async function search(query, options = {}) {
+  return getClient().search(query, options);
+}
+async function getDocs(query, limit = 3) {
+  const results = await search(query, { limit });
+  if (results.length === 0) {
+    return `No documentation found for: ${query}`;
+  }
+  const output = [];
+  results.forEach((r, i) => {
+    output.push(`## ${i + 1}. ${r.title}`);
+    output.push(r.content);
+    if (r.url) {
+      output.push(`\u{1F4D6} Read more: ${r.url}`);
+    }
+    output.push("");
+  });
+  return output.join("\n");
+}
+async function getInfo(topic) {
+  return getClient().getInfo(topic);
+}
+function getMcpConfig() {
+  return getClient().getMcpConfig();
+}
+export {
+  AI_DOCS_HINT,
+  AI_HINT,
+  DjangoCfgDocsClient,
+  MCP_API_URL,
+  MCP_BASE_URL,
+  MCP_SERVER_URL,
+  getDocs,
+  getInfo,
+  getMcpConfig,
+  search
+};
+//# sourceMappingURL=index.mjs.map

package/dist/ai/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/constants.ts","../../src/ai/client.ts"],"sourcesContent":["/**\n * AI Documentation Constants\n */\n\n// MCP Server URLs\nexport const MCP_BASE_URL = 'https://mcp.djangocfg.com';\nexport const MCP_SERVER_URL = `${MCP_BASE_URL}/mcp`;\nexport const MCP_API_URL = `${MCP_BASE_URL}/api/search`;\n\n// API Endpoints\nexport const API_SEARCH_ENDPOINT = '/api/search';\nexport const API_INFO_ENDPOINT = '/api/info';\nexport const DEFAULT_TIMEOUT = 10000; // ms\n\n// AI Hint for console output\nexport const AI_DOCS_HINT = `🤖 AI Docs: ${MCP_SERVER_URL} | pnpm ai-docs search \"query\"`;\n\n// Full AI Hint description\nexport const AI_HINT = `\nDjangoCFG Documentation is available via MCP server.\n\nTo get help with DjangoCFG configuration:\n1. Use the MCP server: ${MCP_SERVER_URL}\n2. Or search directly: ${MCP_API_URL}?q=YOUR_QUERY&limit=5\n\nExample queries:\n- \"How to configure PostgreSQL database?\"\n- \"What is DatabaseConfig?\"\n- \"How to setup Redis cache?\"\n- \"Email configuration with SMTP\"\n`;\n","/**\n * DjangoCFG Documentation Client\n *\n * HTTP client for accessing DjangoCFG documentation via MCP server API.\n */\n\nimport {\n  MCP_BASE_URL,\n  API_SEARCH_ENDPOINT,\n  API_INFO_ENDPOINT,\n  DEFAULT_TIMEOUT,\n} from './constants';\nimport type { SearchResult, SearchOptions, McpConfig, ApiSearchResponse } from './types';\n\n/**\n * Client for DjangoCFG Documentation API.\n */\nexport class DjangoCfgDocsClient {\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(baseUrl: string = MCP_BASE_URL, timeout: number = DEFAULT_TIMEOUT) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n    this.timeout = timeout;\n  }\n\n  private async makeRequest<T>(endpoint: string, params?: Record<string, string | number>): Promise<T> {\n    let url = `${this.baseUrl}${endpoint}`;\n\n    if (params) {\n      const searchParams = new URLSearchParams();\n      for (const [key, value] of Object.entries(params)) {\n        searchParams.set(key, String(value));\n      }\n      url = `${url}?${searchParams.toString()}`;\n    }\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          Accept: 'application/json',\n          'User-Agent': 'DjangoCFG-AI-Client/1.0',\n        },\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(`HTTP Error ${response.status}: ${response.statusText}`);\n      }\n\n      return await response.json();\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /**\n   * Search documentation.\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResult[]> {\n    const { limit = 5, category } = options;\n\n    const params: Record<string, string | number> = { q: query, limit };\n    if (category) {\n      params.category = category;\n    }\n\n    const data = await this.makeRequest<ApiSearchResponse>(API_SEARCH_ENDPOINT, params);\n\n    const results = data.results || (Array.isArray(data) ? data : []);\n\n    return results.map((item) => ({\n      title: item.title || '',\n      content: item.content || item.snippet || '',\n      url: item.url || '',\n      score: item.score || 0,\n      category: item.category || '',\n    }));\n  }\n\n  /**\n   * Get detailed info about a specific topic.\n   */\n  async getInfo(topic: string): Promise<Record<string, unknown>> {\n    return this.makeRequest(API_INFO_ENDPOINT, { topic });\n  }\n\n  /**\n   * Get MCP server configuration for AI assistants.\n   */\n  getMcpConfig(): McpConfig {\n    return {\n      mcpServers: {\n        'djangocfg-docs': {\n          url: `${this.baseUrl}/mcp`,\n        },\n      },\n    };\n  }\n}\n\n// Default client instance\nlet defaultClient: DjangoCfgDocsClient | null = null;\n\nfunction getClient(): DjangoCfgDocsClient {\n  if (!defaultClient) {\n    defaultClient = new DjangoCfgDocsClient();\n  }\n  return defaultClient;\n}\n\n/**\n * Search DjangoCFG documentation.\n *\n * @example\n * ```ts\n * const results = await search('database configuration');\n * results.forEach(r => console.log(r.title, r.url));\n * ```\n */\nexport async function search(query: string, options: SearchOptions = {}): Promise<SearchResult[]> {\n  return getClient().search(query, options);\n}\n\n/**\n * Get documentation as formatted text.\n *\n * @example\n * ```ts\n * const docs = await getDocs('How to configure PostgreSQL?');\n * console.log(docs);\n * ```\n */\nexport async function getDocs(query: string, limit: number = 3): Promise<string> {\n  const results = await search(query, { limit });\n\n  if (results.length === 0) {\n    return `No documentation found for: ${query}`;\n  }\n\n  const output: string[] = [];\n\n  results.forEach((r, i) => {\n    output.push(`## ${i + 1}. ${r.title}`);\n    output.push(r.content);\n    if (r.url) {\n      output.push(`📖 Read more: ${r.url}`);\n    }\n    output.push('');\n  });\n\n  return output.join('\\n');\n}\n\n/**\n * Get detailed info about a topic.\n */\nexport async function getInfo(topic: string): Promise<Record<string, unknown>> {\n  return getClient().getInfo(topic);\n}\n\n/**\n * Get MCP server configuration.\n */\nexport function getMcpConfig(): McpConfig {\n  return getClient().getMcpConfig();\n}\n"],"mappings":"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","names":[]}