@assistant-ui/mcp-docs-server 0.1.17 → 0.1.18

package/dist/prepare-docs/prepare.js

@@ -1,199 +1,22 @@
-import { ROOT_DIR, logger, EXAMPLES_PATH } from '../chunk-M2RKUM66.js';
-import { rm, mkdir, readdir, readFile, writeFile, copyFile } from 'fs/promises';
-import { join, extname, relative } from 'path';
-
-var DOCS_SOURCE = join(ROOT_DIR, "apps/docs/content/docs");
-var BLOG_SOURCE = join(ROOT_DIR, "apps/docs/content/blog");
-var DOCS_DEST = join(ROOT_DIR, "packages/mcp-docs-server/.docs/raw");
-async function copyDir(src, dest) {
-  try {
-    await mkdir(dest, { recursive: true });
-    const entries = await readdir(src, { withFileTypes: true });
-    for (const entry of entries) {
-      const srcPath = join(src, entry.name);
-      const destPath = join(dest, entry.name);
-      if (entry.isDirectory()) {
-        await copyDir(srcPath, destPath);
-      } else if (entry.isFile()) {
-        const ext = extname(entry.name).toLowerCase();
-        if (ext === ".mdx" || ext === ".md") {
-          await copyFile(srcPath, destPath);
-          logger.debug(`Copied: ${srcPath} -> ${destPath}`);
-        }
-      }
-    }
-  } catch (error) {
-    logger.error(`Failed to copy directory: ${src}`, error);
-    throw error;
-  }
-}
-async function copyRaw() {
-  logger.info("Copying raw documentation files...");
-  try {
-    await rm(DOCS_DEST, { recursive: true, force: true });
-    await mkdir(DOCS_DEST, { recursive: true });
-    const docsPath = join(DOCS_DEST, "docs");
-    await copyDir(DOCS_SOURCE, docsPath);
-    logger.info(`Copied documentation to ${docsPath}`);
-    const blogPath = join(DOCS_DEST, "blog");
-    await copyDir(BLOG_SOURCE, blogPath);
-    logger.info(`Copied blog posts to ${blogPath}`);
-    logger.info("Raw documentation copy complete");
-  } catch (error) {
-    logger.error("Failed to copy raw documentation", error);
-    throw error;
-  }
-}
-var OUTPUT_DIR = join(
-  ROOT_DIR,
-  "packages/mcp-docs-server/.docs/organized/code-examples"
-);
-var MAX_LINES = 1e4;
-async function scanDirectory(dir, baseDir) {
-  const files = [];
-  try {
-    const entries = await readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const fullPath = join(dir, entry.name);
-      if (entry.isDirectory()) {
-        const skipDirs = [
-          "node_modules",
-          "dist",
-          "build",
-          ".next",
-          ".git",
-          ".turbo"
-        ];
-        if (!skipDirs.includes(entry.name)) {
-          const subFiles = await scanDirectory(fullPath, baseDir);
-          files.push(...subFiles);
-        }
-      } else if (entry.isFile()) {
-        const includeExts = [
-          ".ts",
-          ".tsx",
-          ".js",
-          ".jsx",
-          ".json",
-          ".css",
-          ".md",
-          ".mdx"
-        ];
-        const ext = extname(entry.name).toLowerCase();
-        if (includeExts.includes(ext) || entry.name === "package.json" || entry.name === "tsconfig.json") {
-          try {
-            const content = await readFile(fullPath, "utf-8");
-            const relativePath = relative(baseDir, fullPath);
-            files.push({ path: relativePath, content });
-          } catch (error) {
-            logger.warn(`Failed to read file: ${fullPath}`, error);
-          }
-        }
-      }
+import { logger } from "../utils/logger.js";
+import { copyRaw } from "./copy-raw.js";
+import { prepareCodeExamples } from "./code-examples.js";
+async function prepare() {
+    logger.info("Starting documentation preparation...");
+    try {
+        await copyRaw();
+        await prepareCodeExamples();
+        logger.info("Documentation preparation complete");
     }
-  } catch (error) {
-    logger.error(`Failed to scan directory: ${dir}`, error);
-  }
-  return files;
-}
-function getFileType(filename) {
-  const ext = extname(filename).toLowerCase();
-  const extMap = {
-    ".ts": "typescript",
-    ".tsx": "tsx",
-    ".js": "javascript",
-    ".jsx": "jsx",
-    ".json": "json",
-    ".css": "css",
-    ".md": "markdown",
-    ".mdx": "mdx"
-  };
-  return extMap[ext] || "text";
-}
-async function prepareCodeExamples() {
-  logger.info("Preparing code examples...");
-  try {
-    await rm(OUTPUT_DIR, { recursive: true, force: true });
-    await mkdir(OUTPUT_DIR, { recursive: true });
-    const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });
-    for (const dir of exampleDirs) {
-      if (dir.isDirectory() && !dir.name.startsWith(".")) {
-        const examplePath = join(EXAMPLES_PATH, dir.name);
-        logger.info(`Processing example: ${dir.name}`);
-        let description = "";
-        try {
-          const packageJsonPath = join(examplePath, "package.json");
-          const packageJson = JSON.parse(
-            await readFile(packageJsonPath, "utf-8")
-          );
-          description = packageJson.description || "";
-        } catch (error) {
-          if (error?.code !== "ENOENT") {
-            logger.warn(`Failed to read package.json for ${dir.name}:`, error);
-          } else {
-            logger.debug(`No package.json found for example: ${dir.name}`);
-          }
-        }
-        const files = await scanDirectory(examplePath, examplePath);
-        files.sort((a, b) => a.path.localeCompare(b.path));
-        let markdown = `# Example: ${dir.name}
-
-`;
-        if (description) {
-          markdown += `${description}
-
-`;
-        }
-        let totalLines = 0;
-        for (const file of files) {
-          const lines = file.content.split("\n").length;
-          if (totalLines + lines > MAX_LINES) {
-            markdown += `
-_Note: Additional files truncated due to size limits_
-`;
-            break;
-          }
-          markdown += `## ${file.path.replace(/\\/g, "/")}
-
-`;
-          markdown += `\`\`\`${getFileType(file.path)}
-`;
-          markdown += file.content;
-          markdown += `
-\`\`\`
-
-`;
-          totalLines += lines;
-        }
-        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);
-        await writeFile(outputPath, markdown, "utf-8");
-        logger.debug(`Created example: ${outputPath}`);
-      }
+    catch (error) {
+        logger.error("Documentation preparation failed", error);
+        throw error;
     }
-    logger.info("Code examples preparation complete");
-  } catch (error) {
-    logger.error("Failed to prepare code examples", error);
-    throw error;
-  }
-}
-
-// src/prepare-docs/prepare.ts
-async function prepare() {
-  logger.info("Starting documentation preparation...");
-  try {
-    await copyRaw();
-    await prepareCodeExamples();
-    logger.info("Documentation preparation complete");
-  } catch (error) {
-    logger.error("Documentation preparation failed", error);
-    throw error;
-  }
 }
-if (process.env.PREPARE === "true") {
-  prepare().catch((error) => {
-    logger.error("Preparation failed", error);
-    process.exit(1);
-  });
+if (import.meta.url === `file://${process.argv[1]}`) {
+    prepare().catch((error) => {
+        logger.error("Preparation failed", error);
+        process.exit(1);
+    });
 }
-
-export { prepare };
+//# sourceMappingURL=prepare.js.map

package/dist/prepare-docs/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/prepare-docs/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,UAAU,OAAO;IACpB,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,mBAAmB,EAAE,CAAC;QAE5B,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/stdio.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

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

package/dist/stdio.js

@@ -1,8 +1,7 @@
 #!/usr/bin/env node
-import { runServer } from './chunk-NVNFQ5ZO.js';
-
-// src/stdio.ts
+import { runServer } from "./index.js";
 void runServer().catch((error) => {
-  console.error("Failed to start server:", error);
-  process.exit(1);
+    console.error("Failed to start server:", error);
+    process.exit(1);
 });
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,KAAK,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/docs.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v3";
+declare const docsInputSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    paths: string[];
+}, {
+    paths: string[];
+}>;
+export declare const docsTools: {
+    name: string;
+    description: string;
+    parameters: {
+        paths: z.ZodArray<z.ZodString, "many">;
+    };
+    execute: ({ paths }: z.infer<typeof docsInputSchema>) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }>;
+};
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/dist/tools/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAe3B,QAAA,MAAM,eAAe;;;;;;EAOnB,CAAC;AA6IH,eAAO,MAAM,SAAS;;;;;;yBAKO,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;;;CAsC3D,CAAC"}

package/dist/tools/docs.js

@@ -0,0 +1,168 @@
+import { z } from "zod/v3";
+import { stat, lstat } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { DOCS_PATH, MDX_EXTENSION, MAX_FILE_SIZE } from "../constants.js";
+import { logger } from "../utils/logger.js";
+import { listDirContents, getAvailablePaths, findNearestPaths, pathExists, } from "../utils/paths.js";
+import { readMDXFile, formatMDXContent } from "../utils/mdx.js";
+import { formatMCPResponse } from "../utils/mcp-format.js";
+import { sanitizePath } from "../utils/security.js";
+const docsInputSchema = z.object({
+    paths: z
+        .array(z.string())
+        .min(1)
+        .describe('Documentation paths to retrieve (e.g., ["getting-started", "api-reference/primitives/Thread"])'),
+});
+async function readDocumentation(docPath) {
+    logger.debug(`Reading documentation for path: ${docPath}`);
+    if (docPath === "/" || docPath === "") {
+        const { directories, files } = await listDirContents(DOCS_PATH);
+        return {
+            path: "/",
+            found: true,
+            type: "directory",
+            directories,
+            files: files.map((f) => f.replace(MDX_EXTENSION, "")),
+        };
+    }
+    try {
+        const sanitized = sanitizePath(docPath);
+        const fullPath = join(DOCS_PATH, sanitized);
+        try {
+            const lstats = await lstat(fullPath);
+            if (lstats.isSymbolicLink()) {
+                logger.warn(`Symlink detected at path: ${fullPath}`);
+                return {
+                    path: docPath,
+                    found: false,
+                    error: "Symlinks are not allowed for security reasons",
+                };
+            }
+        }
+        catch { }
+        if (await pathExists(fullPath)) {
+            const stats = await stat(fullPath);
+            if (stats.isFile() && stats.size > MAX_FILE_SIZE) {
+                logger.warn(`File too large: ${fullPath} (${stats.size} bytes)`);
+                return {
+                    path: docPath,
+                    found: false,
+                    error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`,
+                };
+            }
+            if (stats.isDirectory()) {
+                const { directories, files } = await listDirContents(fullPath);
+                const contents = {};
+                for (const file of files) {
+                    const mdxContent = await readMDXFile(join(fullPath, file));
+                    if (mdxContent) {
+                        const fileName = file.replace(MDX_EXTENSION, "");
+                        contents[fileName] = formatMDXContent(mdxContent);
+                    }
+                }
+                const content = Object.keys(contents).length > 0
+                    ? JSON.stringify(contents, null, 2)
+                    : undefined;
+                return {
+                    path: docPath,
+                    found: true,
+                    type: "directory",
+                    directories,
+                    files: files.map((f) => f.replace(MDX_EXTENSION, "")),
+                    ...(content !== undefined && { content }),
+                };
+            }
+        }
+        const mdxPath = extname(fullPath) === MDX_EXTENSION
+            ? fullPath
+            : `${fullPath}${MDX_EXTENSION}`;
+        try {
+            const mdxLstats = await lstat(mdxPath);
+            if (mdxLstats.isSymbolicLink()) {
+                logger.warn(`Symlink detected at MDX path: ${mdxPath}`);
+                return {
+                    path: docPath,
+                    found: false,
+                    error: "Symlinks are not allowed for security reasons",
+                };
+            }
+            if (mdxLstats.size > MAX_FILE_SIZE) {
+                logger.warn(`MDX file too large: ${mdxPath} (${mdxLstats.size} bytes)`);
+                return {
+                    path: docPath,
+                    found: false,
+                    error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`,
+                };
+            }
+        }
+        catch { }
+        if (await pathExists(mdxPath)) {
+            const mdxContent = await readMDXFile(mdxPath);
+            if (mdxContent) {
+                return {
+                    path: docPath,
+                    found: true,
+                    type: "file",
+                    content: formatMDXContent(mdxContent),
+                };
+            }
+        }
+        const availablePaths = await getAvailablePaths();
+        const suggestions = findNearestPaths(docPath, availablePaths);
+        return {
+            path: docPath,
+            found: false,
+            suggestions,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes("Invalid path")) {
+            return {
+                path: docPath,
+                found: false,
+                error: error.message,
+            };
+        }
+        throw error;
+    }
+}
+export const docsTools = {
+    name: "assistantUIDocs",
+    description: 'Retrieve assistant-ui documentation by path. Use "/" to list all sections. Supports multiple paths in a single request.',
+    parameters: docsInputSchema.shape,
+    execute: async ({ paths }) => {
+        logger.info(`Retrieving documentation for paths: ${paths.join(", ")}`);
+        try {
+            const results = await Promise.all(paths.map((path) => readDocumentation(path)));
+            if (results.length === 1) {
+                const result = results[0];
+                if (result.error) {
+                    return formatMCPResponse({
+                        error: result.error,
+                        path: result.path,
+                    });
+                }
+                if (!result.found) {
+                    return formatMCPResponse({
+                        error: `Documentation not found for path: ${result.path}`,
+                        suggestions: result.suggestions,
+                        hint: 'Use "/" to list all available documentation sections',
+                    });
+                }
+                return formatMCPResponse(result);
+            }
+            return formatMCPResponse({
+                results,
+                summary: `Retrieved ${results.filter((r) => r.found).length} of ${results.length} requested paths`,
+            });
+        }
+        catch (error) {
+            logger.error("Failed to retrieve documentation", error);
+            return formatMCPResponse({
+                error: "Failed to retrieve documentation",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    },
+};
+//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

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

package/dist/tools/examples.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v3";
+declare const examplesInputSchema: z.ZodObject<{
+    example: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    example?: string | undefined;
+}, {
+    example?: string | undefined;
+}>;
+export declare const examplesTools: {
+    name: string;
+    description: string;
+    parameters: {
+        example: z.ZodOptional<z.ZodString>;
+    };
+    execute: ({ example }: z.infer<typeof examplesInputSchema>) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }>;
+};
+export {};
+//# sourceMappingURL=examples.d.ts.map

package/dist/tools/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/tools/examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B,QAAA,MAAM,mBAAmB;;;;;;EAOvB,CAAC;AAuCH,eAAO,MAAM,aAAa;;;;;;2BAKK,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;;;CA+CjE,CAAC"}

package/dist/tools/examples.js

@@ -0,0 +1,95 @@
+import { z } from "zod/v3";
+import { readFile, readdir, lstat } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { CODE_EXAMPLES_PATH, MAX_FILE_SIZE } from "../constants.js";
+import { logger } from "../utils/logger.js";
+import { formatMCPResponse } from "../utils/mcp-format.js";
+import { sanitizePath } from "../utils/security.js";
+const examplesInputSchema = z.object({
+    example: z
+        .string()
+        .optional()
+        .describe('Example name (e.g., "with-ai-sdk"). Leave empty to list all examples.'),
+});
+async function listCodeExamples() {
+    try {
+        const files = await readdir(CODE_EXAMPLES_PATH);
+        return files
+            .filter((file) => extname(file) === ".md")
+            .map((file) => file.replace(".md", ""))
+            .sort();
+    }
+    catch (error) {
+        logger.error("Failed to list code examples", error);
+        return [];
+    }
+}
+async function readCodeExample(exampleName) {
+    try {
+        const sanitized = sanitizePath(exampleName);
+        const filePath = join(CODE_EXAMPLES_PATH, `${sanitized}.md`);
+        const stats = await lstat(filePath);
+        if (stats.isSymbolicLink()) {
+            logger.warn(`Attempted to read symlink: ${filePath}`);
+            return null;
+        }
+        if (stats.size > MAX_FILE_SIZE) {
+            logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);
+            return null;
+        }
+        const content = await readFile(filePath, "utf-8");
+        return content;
+    }
+    catch (error) {
+        logger.error(`Failed to read example: ${exampleName}`, error);
+        return null;
+    }
+}
+export const examplesTools = {
+    name: "assistantUIExamples",
+    description: "List available examples or retrieve complete code for a specific example",
+    parameters: examplesInputSchema.shape,
+    execute: async ({ example }) => {
+        try {
+            if (!example) {
+                logger.info("Listing all available examples");
+                const examples = await listCodeExamples();
+                if (examples.length === 0) {
+                    return formatMCPResponse({
+                        error: "No examples found. Please run documentation preparation first.",
+                        hint: "Run: pnpm prepare-docs",
+                    });
+                }
+                return formatMCPResponse({
+                    type: "list",
+                    examples,
+                    total: examples.length,
+                    hint: "Use example parameter to get complete code for any example",
+                });
+            }
+            logger.info(`Retrieving example: ${example}`);
+            const content = await readCodeExample(example);
+            if (!content) {
+                const availableExamples = await listCodeExamples();
+                return formatMCPResponse({
+                    error: `Example not found: ${example}`,
+                    availableExamples,
+                    hint: "Use without example parameter to list all available examples",
+                });
+            }
+            return formatMCPResponse({
+                type: "example",
+                name: example,
+                content,
+            });
+        }
+        catch (error) {
+            logger.error("Failed to retrieve examples", error);
+            return formatMCPResponse({
+                error: "Failed to retrieve examples",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    },
+};
+//# sourceMappingURL=examples.js.map

package/dist/tools/examples.js.map

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

package/dist/tools/tests/test-setup.d.ts

@@ -0,0 +1,4 @@
+export declare const testContext: {
+    callTool: (name: string, args: any) => Promise<any>;
+};
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/tools/tests/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../../src/tools/tests/test-setup.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW;qBACC,MAAM,QAAQ,GAAG;CAmBzC,CAAC"}

package/dist/tools/tests/test-setup.js

@@ -0,0 +1,36 @@
+import { beforeAll } from "vitest";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { PACKAGE_DIR } from "../../constants.js";
+import { docsTools } from "../docs.js";
+import { examplesTools } from "../examples.js";
+const tools = {
+    assistantUIDocs: docsTools,
+    assistantUIExamples: examplesTools,
+};
+export const testContext = {
+    callTool: async (name, args) => {
+        const tool = tools[name];
+        if (!tool) {
+            throw new Error(`Tool ${name} not found`);
+        }
+        const result = await tool.execute(args);
+        const text = result.content?.[0]?.text;
+        if (text === undefined) {
+            throw new Error(`Tool ${name} returned no content`);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            throw new Error(`Tool ${name} returned invalid JSON. Output: ${text}\nParse error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    },
+};
+beforeAll(() => {
+    const docsPath = join(PACKAGE_DIR, ".docs");
+    if (!existsSync(docsPath)) {
+        throw new Error("Documentation not prepared. Run: pnpm build");
+    }
+});
+//# sourceMappingURL=test-setup.js.map

package/dist/tools/tests/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../../../src/tools/tests/test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,KAAK,GAAG;IACZ,eAAe,EAAE,SAAS;IAC1B,mBAAmB,EAAE,aAAa;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,KAAK,EAAE,IAAY,EAAE,IAAS,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,IAA0B,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QACvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,sBAAsB,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,QAAQ,IAAI,mCAAmC,IAAI,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9H,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;qBACA,MAAM,WAAW,GAAG,EAAE;oBAKvB,MAAM,WAAW,GAAG,EAAE;qBAKrB,MAAM,WAAW,GAAG,EAAE;oBAGvB,MAAM,WAAW,GAAG,EAAE;CAGvC,CAAC"}