@assistant-ui/mcp-docs-server 0.2.2 → 0.3.0

package/dist/utils/mdx.d.ts

@@ -1,12 +0,0 @@
-//#region src/utils/mdx.d.ts
-interface MDXContent {
-  content: string;
-  frontmatter: Record<string, any>;
-  excerpt?: string;
-}
-declare function readMDXFile(filePath: string): Promise<MDXContent | null>;
-declare function readMDXFileSafe(filePath: string): Promise<MDXContent | null>;
-declare function formatMDXContent(mdxContent: MDXContent): string;
-//#endregion
-export { formatMDXContent, readMDXFile, readMDXFileSafe };
-//# sourceMappingURL=mdx.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mdx.d.ts","names":[],"sources":["../../src/utils/mdx.ts"],"mappings":";UAKU;EACR;EACA,aAAa;EACb;;iBAGoB,YACpB,mBACC,QAAQ;iBAsBW,gBACpB,mBACC,QAAQ;iBAiBK,iBAAiB,YAAY"}

package/dist/utils/mdx.js

@@ -1,45 +0,0 @@
-import "../constants.js";
-import { logger } from "./logger.js";
-import { lstat, readFile } from "node:fs/promises";
-import matter from "gray-matter";
-//#region src/utils/mdx.ts
-async function readMDXFile(filePath) {
-	try {
-		const fileContent = await readFile(filePath, "utf-8");
-		const { content, data } = matter(fileContent);
-		const excerptMatch = content.match(/^(.+?)(?:\n\n|$)/);
-		const excerpt = excerptMatch?.[1] !== void 0 ? excerptMatch[1].replace(/^#+ /, "") : void 0;
-		return {
-			content,
-			frontmatter: data,
-			...excerpt !== void 0 && { excerpt }
-		};
-	} catch (error) {
-		logger.error(`Failed to read MDX file: ${filePath}`, error);
-		return null;
-	}
-}
-async function readMDXFileSafe(filePath) {
-	try {
-		const stats = await lstat(filePath);
-		if (stats.isSymbolicLink()) {
-			logger.warn(`Attempted to read symlink: ${filePath}`);
-			return null;
-		}
-		if (stats.size > 10485760) {
-			logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);
-			return null;
-		}
-	} catch {
-		return null;
-	}
-	return readMDXFile(filePath);
-}
-function formatMDXContent(mdxContent) {
-	const { content, frontmatter } = mdxContent;
-	return matter.stringify(content, frontmatter);
-}
-//#endregion
-export { formatMDXContent, readMDXFile, readMDXFileSafe };
-
-//# sourceMappingURL=mdx.js.map

package/dist/utils/mdx.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mdx.js","names":[],"sources":["../../src/utils/mdx.ts"],"sourcesContent":["import { readFile, lstat } from \"node:fs/promises\";\nimport matter from \"gray-matter\";\nimport { MAX_FILE_SIZE } from \"../constants.js\";\nimport { logger } from \"./logger.js\";\n\ninterface MDXContent {\n  content: string;\n  frontmatter: Record<string, any>;\n  excerpt?: string;\n}\n\nexport async function readMDXFile(\n  filePath: string,\n): Promise<MDXContent | null> {\n  try {\n    const fileContent = await readFile(filePath, \"utf-8\");\n    const { content, data } = matter(fileContent);\n\n    const excerptMatch = content.match(/^(.+?)(?:\\n\\n|$)/);\n    const excerpt =\n      excerptMatch?.[1] !== undefined\n        ? excerptMatch[1].replace(/^#+ /, \"\")\n        : undefined;\n\n    return {\n      content,\n      frontmatter: data,\n      ...(excerpt !== undefined && { excerpt }),\n    };\n  } catch (error) {\n    logger.error(`Failed to read MDX file: ${filePath}`, error);\n    return null;\n  }\n}\n\nexport async function readMDXFileSafe(\n  filePath: string,\n): Promise<MDXContent | null> {\n  try {\n    const stats = await lstat(filePath);\n    if (stats.isSymbolicLink()) {\n      logger.warn(`Attempted to read symlink: ${filePath}`);\n      return null;\n    }\n    if (stats.size > MAX_FILE_SIZE) {\n      logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);\n      return null;\n    }\n  } catch {\n    return null;\n  }\n  return readMDXFile(filePath);\n}\n\nexport function formatMDXContent(mdxContent: MDXContent): string {\n  const { content, frontmatter } = mdxContent;\n\n  return matter.stringify(content, frontmatter);\n}\n"],"mappings":";;;;;AAWA,eAAsB,YACpB,UAC4B;CAC5B,IAAI;EACF,MAAM,cAAc,MAAM,SAAS,UAAU,OAAO;EACpD,MAAM,EAAE,SAAS,SAAS,OAAO,WAAW;EAE5C,MAAM,eAAe,QAAQ,MAAM,kBAAkB;EACrD,MAAM,UACJ,eAAe,OAAO,KAAA,IAClB,aAAa,EAAE,CAAC,QAAQ,QAAQ,EAAE,IAClC,KAAA;EAEN,OAAO;GACL;GACA,aAAa;GACb,GAAI,YAAY,KAAA,KAAa,EAAE,QAAQ;EACzC;CACF,SAAS,OAAO;EACd,OAAO,MAAM,4BAA4B,YAAY,KAAK;EAC1D,OAAO;CACT;AACF;AAEA,eAAsB,gBACpB,UAC4B;CAC5B,IAAI;EACF,MAAM,QAAQ,MAAM,MAAM,QAAQ;EAClC,IAAI,MAAM,eAAe,GAAG;GAC1B,OAAO,KAAK,8BAA8B,UAAU;GACpD,OAAO;EACT;EACA,IAAI,MAAM,OAAA,UAAsB;GAC9B,OAAO,KAAK,4BAA4B,SAAS,IAAI,MAAM,KAAK,QAAQ;GACxE,OAAO;EACT;CACF,QAAQ;EACN,OAAO;CACT;CACA,OAAO,YAAY,QAAQ;AAC7B;AAEA,SAAgB,iBAAiB,YAAgC;CAC/D,MAAM,EAAE,SAAS,gBAAgB;CAEjC,OAAO,OAAO,UAAU,SAAS,WAAW;AAC9C"}

package/dist/utils/paths.d.ts

@@ -1,12 +0,0 @@
-//#region src/utils/paths.d.ts
-declare function listDirContents(dirPath: string): Promise<{
-  directories: string[];
-  files: string[];
-}>;
-declare function getAvailablePaths(): Promise<string[]>;
-declare const getAvailableDocFiles: () => Promise<string[]>;
-declare function findNearestPaths(requestedPath: string, availablePaths: string[]): string[];
-declare function pathExists(path: string): Promise<boolean>;
-//#endregion
-export { findNearestPaths, getAvailableDocFiles, getAvailablePaths, listDirContents, pathExists };
-//# sourceMappingURL=paths.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","names":[],"sources":["../../src/utils/paths.ts"],"mappings":";iBAasB,gBAAgB,kBAAkB;EACtD;EACA;;iBA4BoB,qBAAqB;cA0B9B,4BAAoB;iBAwBjB,iBACd,uBACA;iBAoCoB,WAAW,eAAe"}

package/dist/utils/paths.js

@@ -1,93 +0,0 @@
-import { DOCS_PATH, MDX_EXTENSION } from "../constants.js";
-import { logger } from "./logger.js";
-import { cacheListing } from "./cache.js";
-import { extname, join } from "node:path";
-import { readdir, stat } from "node:fs/promises";
-//#region src/utils/paths.ts
-const SIMILARITY_THRESHOLDS = {
-	EXACT_MATCH: 1,
-	CONTAINS_MATCH: .8,
-	PARTIAL_MATCH: .5,
-	MIN_SUGGESTION: .3
-};
-async function listDirContents(dirPath) {
-	try {
-		const items = await readdir(dirPath, { withFileTypes: true });
-		return {
-			directories: items.filter((item) => item.isDirectory()).map((item) => item.name).filter((name) => !name.startsWith(".")).sort(),
-			files: items.filter((item) => item.isFile() && (extname(item.name) === ".mdx" || extname(item.name) === ".md")).map((item) => item.name).sort()
-		};
-	} catch (error) {
-		logger.error(`Failed to list directory contents: ${dirPath}`, error);
-		return {
-			directories: [],
-			files: []
-		};
-	}
-}
-async function getAvailablePaths() {
-	const paths = [];
-	async function scanDirectory(dir, prefix = "") {
-		const { directories, files } = await listDirContents(dir);
-		for (const file of files) {
-			const name = file.replace(MDX_EXTENSION, "").replace(".md", "");
-			paths.push(prefix ? `${prefix}/${name}` : name);
-		}
-		for (const subdir of directories) {
-			const subdirPath = join(dir, subdir);
-			const newPrefix = prefix ? `${prefix}/${subdir}` : subdir;
-			paths.push(newPrefix);
-			await scanDirectory(subdirPath, newPrefix);
-		}
-	}
-	await scanDirectory(DOCS_PATH);
-	return paths.sort();
-}
-const getAvailableDocFiles = cacheListing(scanDocFiles);
-async function scanDocFiles() {
-	const files = [];
-	async function scanDirectory(dir, prefix = "") {
-		const { directories, files: dirFiles } = await listDirContents(dir);
-		for (const file of dirFiles) {
-			if (extname(file) !== ".mdx") continue;
-			const name = file.replace(MDX_EXTENSION, "");
-			files.push(prefix ? `${prefix}/${name}` : name);
-		}
-		for (const subdir of directories) {
-			const newPrefix = prefix ? `${prefix}/${subdir}` : subdir;
-			await scanDirectory(join(dir, subdir), newPrefix);
-		}
-	}
-	await scanDirectory(DOCS_PATH);
-	return files.sort();
-}
-function findNearestPaths(requestedPath, availablePaths) {
-	const normalizedRequest = requestedPath.toLowerCase().replace(/[^a-z0-9]/g, "");
-	return availablePaths.map((path) => {
-		const normalizedPath = path.toLowerCase().replace(/[^a-z0-9]/g, "");
-		if (normalizedPath.includes(normalizedRequest)) return {
-			path,
-			score: SIMILARITY_THRESHOLDS.EXACT_MATCH
-		};
-		if (normalizedRequest.includes(normalizedPath)) return {
-			path,
-			score: SIMILARITY_THRESHOLDS.CONTAINS_MATCH
-		};
-		return {
-			path,
-			score: [...normalizedRequest].filter((char) => normalizedPath.includes(char)).length / normalizedRequest.length * SIMILARITY_THRESHOLDS.PARTIAL_MATCH
-		};
-	}).filter((item) => item.score > SIMILARITY_THRESHOLDS.MIN_SUGGESTION).sort((a, b) => b.score - a.score).slice(0, 3).map((item) => item.path);
-}
-async function pathExists(path) {
-	try {
-		await stat(path);
-		return true;
-	} catch {
-		return false;
-	}
-}
-//#endregion
-export { findNearestPaths, getAvailableDocFiles, getAvailablePaths, listDirContents, pathExists };
-
-//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","names":[],"sources":["../../src/utils/paths.ts"],"sourcesContent":["import { readdir, stat } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { DOCS_PATH, MDX_EXTENSION, MD_EXTENSION } from \"../constants.js\";\nimport { cacheListing } from \"./cache.js\";\nimport { logger } from \"./logger.js\";\n\nconst SIMILARITY_THRESHOLDS = {\n  EXACT_MATCH: 1,\n  CONTAINS_MATCH: 0.8,\n  PARTIAL_MATCH: 0.5,\n  MIN_SUGGESTION: 0.3,\n} as const;\n\nexport async function listDirContents(dirPath: string): Promise<{\n  directories: string[];\n  files: string[];\n}> {\n  try {\n    const items = await readdir(dirPath, { withFileTypes: true });\n\n    const directories = items\n      .filter((item) => item.isDirectory())\n      .map((item) => item.name)\n      .filter((name) => !name.startsWith(\".\"))\n      .sort();\n\n    const files = items\n      .filter(\n        (item) =>\n          item.isFile() &&\n          (extname(item.name) === MDX_EXTENSION ||\n            extname(item.name) === MD_EXTENSION),\n      )\n      .map((item) => item.name)\n      .sort();\n\n    return { directories, files };\n  } catch (error) {\n    logger.error(`Failed to list directory contents: ${dirPath}`, error);\n    return { directories: [], files: [] };\n  }\n}\n\nexport async function getAvailablePaths(): Promise<string[]> {\n  const paths: string[] = [];\n\n  async function scanDirectory(\n    dir: string,\n    prefix: string = \"\",\n  ): Promise<void> {\n    const { directories, files } = await listDirContents(dir);\n\n    for (const file of files) {\n      const name = file.replace(MDX_EXTENSION, \"\").replace(MD_EXTENSION, \"\");\n      paths.push(prefix ? `${prefix}/${name}` : name);\n    }\n\n    for (const subdir of directories) {\n      const subdirPath = join(dir, subdir);\n      const newPrefix = prefix ? `${prefix}/${subdir}` : subdir;\n      paths.push(newPrefix);\n      await scanDirectory(subdirPath, newPrefix);\n    }\n  }\n\n  await scanDirectory(DOCS_PATH);\n  return paths.sort();\n}\n\nexport const getAvailableDocFiles = cacheListing(scanDocFiles);\n\nasync function scanDocFiles(): Promise<string[]> {\n  const files: string[] = [];\n\n  async function scanDirectory(dir: string, prefix = \"\"): Promise<void> {\n    const { directories, files: dirFiles } = await listDirContents(dir);\n\n    for (const file of dirFiles) {\n      if (extname(file) !== MDX_EXTENSION) continue;\n      const name = file.replace(MDX_EXTENSION, \"\");\n      files.push(prefix ? `${prefix}/${name}` : name);\n    }\n\n    for (const subdir of directories) {\n      const newPrefix = prefix ? `${prefix}/${subdir}` : subdir;\n      await scanDirectory(join(dir, subdir), newPrefix);\n    }\n  }\n\n  await scanDirectory(DOCS_PATH);\n  return files.sort();\n}\n\nexport function findNearestPaths(\n  requestedPath: string,\n  availablePaths: string[],\n): string[] {\n  const normalizedRequest = requestedPath\n    .toLowerCase()\n    .replace(/[^a-z0-9]/g, \"\");\n\n  const scored = availablePaths.map((path) => {\n    const normalizedPath = path.toLowerCase().replace(/[^a-z0-9]/g, \"\");\n\n    if (normalizedPath.includes(normalizedRequest)) {\n      return { path, score: SIMILARITY_THRESHOLDS.EXACT_MATCH };\n    }\n\n    if (normalizedRequest.includes(normalizedPath)) {\n      return { path, score: SIMILARITY_THRESHOLDS.CONTAINS_MATCH };\n    }\n\n    const overlap = [...normalizedRequest].filter((char) =>\n      normalizedPath.includes(char),\n    ).length;\n\n    return {\n      path,\n      score:\n        (overlap / normalizedRequest.length) *\n        SIMILARITY_THRESHOLDS.PARTIAL_MATCH,\n    };\n  });\n\n  return scored\n    .filter((item) => item.score > SIMILARITY_THRESHOLDS.MIN_SUGGESTION)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, 3)\n    .map((item) => item.path);\n}\n\nexport async function pathExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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"}

package/dist/utils/search.d.ts

@@ -1,10 +0,0 @@
-//#region src/utils/search.d.ts
-interface SearchResult {
-  path: string;
-  title: string;
-  snippet: string;
-}
-declare function searchDocs(query: string, limit?: number): Promise<SearchResult[]>;
-//#endregion
-export { SearchResult, searchDocs };
-//# sourceMappingURL=search.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"search.d.ts","names":[],"sources":["../../src/utils/search.ts"],"mappings":";UAkBiB;EACf;EACA;EACA;;iBA0FoB,WACpB,eACA,iBACC,QAAQ"}

package/dist/utils/search.js

@@ -1,97 +0,0 @@
-import { DOCS_PATH, MDX_EXTENSION } from "../constants.js";
-import { getAvailablePaths, pathExists } from "./paths.js";
-import { readMDXFile } from "./mdx.js";
-import { join } from "node:path";
-//#region src/utils/search.ts
-const SCORE_WEIGHTS = {
-	FULL_QUERY: {
-		title: 10,
-		path: 8,
-		description: 5
-	},
-	TOKEN: {
-		title: 3,
-		path: 2,
-		description: 1,
-		content: .5
-	}
-};
-let indexPromise = null;
-function deriveTitle(path, frontmatter) {
-	const fmTitle = frontmatter["title"];
-	if (typeof fmTitle === "string" && fmTitle.trim()) return fmTitle;
-	return path.split("/").pop() ?? path;
-}
-async function buildIndex() {
-	const paths = await getAvailablePaths();
-	return (await Promise.all(paths.map(async (path) => {
-		const filePath = join(DOCS_PATH, `${path}${MDX_EXTENSION}`);
-		if (!await pathExists(filePath)) return null;
-		const mdx = await readMDXFile(filePath);
-		if (!mdx) return null;
-		const description = mdx.frontmatter["description"];
-		return {
-			path,
-			title: deriveTitle(path, mdx.frontmatter),
-			description: typeof description === "string" ? description : "",
-			content: mdx.content,
-			excerpt: mdx.excerpt ?? ""
-		};
-	}))).filter((entry) => entry !== null);
-}
-function getIndex() {
-	if (!indexPromise) indexPromise = buildIndex().catch((error) => {
-		indexPromise = null;
-		throw error;
-	});
-	return indexPromise;
-}
-function makeSnippet(content, tokens, excerpt) {
-	const lower = content.toLowerCase();
-	for (const token of tokens) {
-		const idx = lower.indexOf(token);
-		if (idx >= 0) {
-			const start = Math.max(0, idx - 60);
-			const end = Math.min(content.length, idx + token.length + 100);
-			const slice = content.slice(start, end).replace(/\s+/g, " ").trim();
-			return `${start > 0 ? "…" : ""}${slice}${end < content.length ? "…" : ""}`;
-		}
-	}
-	if (excerpt) return excerpt.slice(0, 160);
-	const firstLine = content.split("\n").find((line) => line.trim());
-	return firstLine ? firstLine.replace(/^#+\s*/, "").slice(0, 160) : "";
-}
-function scoreEntry(entry, query, tokens) {
-	const title = entry.title.toLowerCase();
-	const path = entry.path.toLowerCase();
-	const description = entry.description.toLowerCase();
-	const content = entry.content.toLowerCase();
-	let score = 0;
-	if (title.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.title;
-	if (path.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.path;
-	if (description.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.description;
-	for (const token of tokens) {
-		if (title.includes(token)) score += SCORE_WEIGHTS.TOKEN.title;
-		if (path.includes(token)) score += SCORE_WEIGHTS.TOKEN.path;
-		if (description.includes(token)) score += SCORE_WEIGHTS.TOKEN.description;
-		if (content.includes(token)) score += SCORE_WEIGHTS.TOKEN.content;
-	}
-	return score;
-}
-async function searchDocs(query, limit = 10) {
-	const normalized = query.trim().toLowerCase();
-	if (!normalized) return [];
-	const tokens = normalized.split(/\s+/).filter(Boolean);
-	return (await getIndex()).map((entry) => ({
-		entry,
-		score: scoreEntry(entry, normalized, tokens)
-	})).filter((scored) => scored.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map(({ entry }) => ({
-		path: entry.path,
-		title: entry.title,
-		snippet: makeSnippet(entry.content, tokens, entry.excerpt)
-	}));
-}
-//#endregion
-export { searchDocs };
-
-//# sourceMappingURL=search.js.map

package/dist/utils/search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search.js","names":[],"sources":["../../src/utils/search.ts"],"sourcesContent":["import { join } from \"node:path\";\nimport { DOCS_PATH, MDX_EXTENSION } from \"../constants.js\";\nimport { getAvailablePaths, pathExists } from \"./paths.js\";\nimport { readMDXFile } from \"./mdx.js\";\n\nconst SCORE_WEIGHTS = {\n  FULL_QUERY: { title: 10, path: 8, description: 5 },\n  TOKEN: { title: 3, path: 2, description: 1, content: 0.5 },\n} as const;\n\ninterface IndexEntry {\n  path: string;\n  title: string;\n  description: string;\n  content: string;\n  excerpt: string;\n}\n\nexport interface SearchResult {\n  path: string;\n  title: string;\n  snippet: string;\n}\n\nlet indexPromise: Promise<IndexEntry[]> | null = null;\n\nfunction deriveTitle(\n  path: string,\n  frontmatter: Record<string, unknown>,\n): string {\n  const fmTitle = frontmatter[\"title\"];\n  if (typeof fmTitle === \"string\" && fmTitle.trim()) return fmTitle;\n  return path.split(\"/\").pop() ?? path;\n}\n\nasync function buildIndex(): Promise<IndexEntry[]> {\n  const paths = await getAvailablePaths();\n  const entries = await Promise.all(\n    paths.map(async (path): Promise<IndexEntry | null> => {\n      const filePath = join(DOCS_PATH, `${path}${MDX_EXTENSION}`);\n      if (!(await pathExists(filePath))) return null;\n      const mdx = await readMDXFile(filePath);\n      if (!mdx) return null;\n      const description = mdx.frontmatter[\"description\"];\n      return {\n        path,\n        title: deriveTitle(path, mdx.frontmatter),\n        description: typeof description === \"string\" ? description : \"\",\n        content: mdx.content,\n        excerpt: mdx.excerpt ?? \"\",\n      };\n    }),\n  );\n  return entries.filter((entry): entry is IndexEntry => entry !== null);\n}\n\nfunction getIndex(): Promise<IndexEntry[]> {\n  if (!indexPromise) {\n    indexPromise = buildIndex().catch((error) => {\n      indexPromise = null;\n      throw error;\n    });\n  }\n  return indexPromise;\n}\n\nfunction makeSnippet(\n  content: string,\n  tokens: string[],\n  excerpt: string,\n): string {\n  const lower = content.toLowerCase();\n  for (const token of tokens) {\n    const idx = lower.indexOf(token);\n    if (idx >= 0) {\n      const start = Math.max(0, idx - 60);\n      const end = Math.min(content.length, idx + token.length + 100);\n      const slice = content.slice(start, end).replace(/\\s+/g, \" \").trim();\n      return `${start > 0 ? \"…\" : \"\"}${slice}${end < content.length ? \"…\" : \"\"}`;\n    }\n  }\n  if (excerpt) return excerpt.slice(0, 160);\n  const firstLine = content.split(\"\\n\").find((line) => line.trim());\n  return firstLine ? firstLine.replace(/^#+\\s*/, \"\").slice(0, 160) : \"\";\n}\n\nfunction scoreEntry(\n  entry: IndexEntry,\n  query: string,\n  tokens: string[],\n): number {\n  const title = entry.title.toLowerCase();\n  const path = entry.path.toLowerCase();\n  const description = entry.description.toLowerCase();\n  const content = entry.content.toLowerCase();\n\n  let score = 0;\n  if (title.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.title;\n  if (path.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.path;\n  if (description.includes(query))\n    score += SCORE_WEIGHTS.FULL_QUERY.description;\n\n  for (const token of tokens) {\n    if (title.includes(token)) score += SCORE_WEIGHTS.TOKEN.title;\n    if (path.includes(token)) score += SCORE_WEIGHTS.TOKEN.path;\n    if (description.includes(token)) score += SCORE_WEIGHTS.TOKEN.description;\n    if (content.includes(token)) score += SCORE_WEIGHTS.TOKEN.content;\n  }\n  return score;\n}\n\nexport async function searchDocs(\n  query: string,\n  limit = 10,\n): Promise<SearchResult[]> {\n  const normalized = query.trim().toLowerCase();\n  if (!normalized) return [];\n  const tokens = normalized.split(/\\s+/).filter(Boolean);\n\n  const index = await getIndex();\n  return index\n    .map((entry) => ({ entry, score: scoreEntry(entry, normalized, tokens) }))\n    .filter((scored) => scored.score > 0)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, limit)\n    .map(({ entry }) => ({\n      path: entry.path,\n      title: entry.title,\n      snippet: makeSnippet(entry.content, tokens, entry.excerpt),\n    }));\n}\n"],"mappings":"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"}

package/dist/utils/security.d.ts

@@ -1,5 +0,0 @@
-//#region src/utils/security.d.ts
-declare function sanitizePath(userPath: string): string;
-//#endregion
-export { sanitizePath };
-//# sourceMappingURL=security.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"security.d.ts","names":[],"sources":["../../src/utils/security.ts"],"mappings":";iBAEgB,aAAa"}

package/dist/utils/security.js

@@ -1,22 +0,0 @@
-import path from "node:path";
-//#region src/utils/security.ts
-function sanitizePath(userPath) {
-	if (!userPath || typeof userPath !== "string") throw new Error("Invalid path: Path must be a non-empty string");
-	if (userPath.includes("../") || userPath.includes("..\\")) throw new Error("Invalid path: Directory traversal attempt detected");
-	const normalized = path.normalize(userPath);
-	if (path.isAbsolute(normalized)) throw new Error("Invalid path: Absolute paths are not allowed");
-	const relativePath = path.relative("", normalized);
-	if (relativePath.startsWith("..")) throw new Error("Invalid path: Directory traversal attempt detected");
-	if (relativePath.includes("..")) throw new Error("Invalid path: Path contains invalid traversal sequences");
-	if (relativePath.includes("\0")) throw new Error("Invalid path: Path contains null bytes");
-	if (process.platform !== "win32") {
-		if (normalized.includes("\\")) throw new Error("Invalid path: Backslashes not allowed");
-	} else if (normalized.includes(":") || normalized.startsWith("\\\\")) throw new Error("Invalid path: Path contains invalid Windows characters");
-	const segments = relativePath.split(path.sep);
-	for (const segment of segments) if (segment.startsWith(".") && segment !== ".") throw new Error("Invalid path: Hidden files are not allowed");
-	return relativePath.replace(/\\/g, "/");
-}
-//#endregion
-export { sanitizePath };
-
-//# sourceMappingURL=security.js.map

package/dist/utils/security.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"security.js","names":[],"sources":["../../src/utils/security.ts"],"sourcesContent":["import path from \"node:path\";\n\nexport function sanitizePath(userPath: string): string {\n  if (!userPath || typeof userPath !== \"string\") {\n    throw new Error(\"Invalid path: Path must be a non-empty string\");\n  }\n\n  // Check for traversal patterns before normalization - defense in depth\n  if (userPath.includes(\"../\") || userPath.includes(\"..\\\\\")) {\n    throw new Error(\"Invalid path: Directory traversal attempt detected\");\n  }\n\n  const normalized = path.normalize(userPath);\n\n  if (path.isAbsolute(normalized)) {\n    throw new Error(\"Invalid path: Absolute paths are not allowed\");\n  }\n\n  const relativePath = path.relative(\"\", normalized);\n\n  if (relativePath.startsWith(\"..\")) {\n    throw new Error(\"Invalid path: Directory traversal attempt detected\");\n  }\n\n  if (relativePath.includes(\"..\")) {\n    throw new Error(\"Invalid path: Path contains invalid traversal sequences\");\n  }\n\n  if (relativePath.includes(\"\\0\")) {\n    throw new Error(\"Invalid path: Path contains null bytes\");\n  }\n\n  if (process.platform !== \"win32\") {\n    if (normalized.includes(\"\\\\\")) {\n      throw new Error(\"Invalid path: Backslashes not allowed\");\n    }\n  } else {\n    if (normalized.includes(\":\") || normalized.startsWith(\"\\\\\\\\\")) {\n      throw new Error(\"Invalid path: Path contains invalid Windows characters\");\n    }\n  }\n\n  const segments = relativePath.split(path.sep);\n  for (const segment of segments) {\n    if (segment.startsWith(\".\") && segment !== \".\") {\n      throw new Error(\"Invalid path: Hidden files are not allowed\");\n    }\n  }\n\n  // Always return Unix-style paths for consistency across platforms\n  return relativePath.replace(/\\\\/g, \"/\");\n}\n"],"mappings":";;AAEA,SAAgB,aAAa,UAA0B;CACrD,IAAI,CAAC,YAAY,OAAO,aAAa,UACnC,MAAM,IAAI,MAAM,+CAA+C;CAIjE,IAAI,SAAS,SAAS,KAAK,KAAK,SAAS,SAAS,MAAM,GACtD,MAAM,IAAI,MAAM,oDAAoD;CAGtE,MAAM,aAAa,KAAK,UAAU,QAAQ;CAE1C,IAAI,KAAK,WAAW,UAAU,GAC5B,MAAM,IAAI,MAAM,8CAA8C;CAGhE,MAAM,eAAe,KAAK,SAAS,IAAI,UAAU;CAEjD,IAAI,aAAa,WAAW,IAAI,GAC9B,MAAM,IAAI,MAAM,oDAAoD;CAGtE,IAAI,aAAa,SAAS,IAAI,GAC5B,MAAM,IAAI,MAAM,yDAAyD;CAG3E,IAAI,aAAa,SAAS,IAAI,GAC5B,MAAM,IAAI,MAAM,wCAAwC;CAG1D,IAAI,QAAQ,aAAa,SACnB;MAAA,WAAW,SAAS,IAAI,GAC1B,MAAM,IAAI,MAAM,uCAAuC;CAAA,OAGzD,IAAI,WAAW,SAAS,GAAG,KAAK,WAAW,WAAW,MAAM,GAC1D,MAAM,IAAI,MAAM,wDAAwD;CAI5E,MAAM,WAAW,aAAa,MAAM,KAAK,GAAG;CAC5C,KAAK,MAAM,WAAW,UACpB,IAAI,QAAQ,WAAW,GAAG,KAAK,YAAY,KACzC,MAAM,IAAI,MAAM,4CAA4C;CAKhE,OAAO,aAAa,QAAQ,OAAO,GAAG;AACxC"}

package/dist/xulux/catalog-client.d.ts

@@ -1,14 +0,0 @@
-import { XuluxCatalogResult } from "./types.js";
-//#region src/xulux/catalog-client.d.ts
-declare const DEFAULT_CATALOG_URL = "https://www.assistant-ui.com/api/xulux/mcp-catalog";
-declare function getCatalogUrl(): string;
-declare function clearCatalogCache(): void;
-/**
- * Returns the assistant-ui template catalog. Uses an in-memory five-minute cache, and falls
- * back to a minimal bundled catalog (marked degraded) when the live fetch
- * fails and no cached copy exists.
- */
-declare function getXuluxCatalog(): Promise<XuluxCatalogResult>;
-//#endregion
-export { DEFAULT_CATALOG_URL, clearCatalogCache, getCatalogUrl, getXuluxCatalog };
-//# sourceMappingURL=catalog-client.d.ts.map

package/dist/xulux/catalog-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog-client.d.ts","names":[],"sources":["../../src/xulux/catalog-client.ts"],"mappings":";;cAIa;iBAKG;iBA0CA;;;;;;iBAoBM,mBAAmB,QAAQ"}

package/dist/xulux/catalog-client.js

@@ -1,67 +0,0 @@
-import { logger } from "../utils/logger.js";
-import { FALLBACK_CATALOG, FALLBACK_NOTE } from "./fallback-catalog.js";
-//#region src/xulux/catalog-client.ts
-const DEFAULT_CATALOG_URL = "https://www.assistant-ui.com/api/xulux/mcp-catalog";
-const CATALOG_TTL_MS = 3e5;
-function getCatalogUrl() {
-	return process.env.XULUX_CATALOG_URL?.trim() || "https://www.assistant-ui.com/api/xulux/mcp-catalog";
-}
-function validateCatalog(data) {
-	if (!data || typeof data !== "object" || Array.isArray(data)) throw new Error("Catalog response is not a JSON object.");
-	const catalog = data;
-	if (catalog.version !== 1) throw new Error(`Unsupported catalog version: ${String(catalog.version)}. Expected 1.`);
-	if (!Array.isArray(catalog.templates)) throw new Error("Catalog response has no templates array.");
-	for (const template of catalog.templates) if (!template || typeof template !== "object" || typeof template.id !== "string" || typeof template.templateId !== "string" || template.kind !== "template" && template.kind !== "example") throw new Error("Catalog response contains a malformed template entry (missing id/templateId/kind).");
-	return catalog;
-}
-let cache = null;
-function clearCatalogCache() {
-	cache = null;
-}
-async function fetchCatalog(url) {
-	const res = await fetch(url, { headers: { Accept: "application/json" } });
-	if (!res.ok) throw new Error(`Catalog fetch failed: HTTP ${res.status}`);
-	return validateCatalog(await res.json());
-}
-/**
-* Returns the assistant-ui template catalog. Uses an in-memory five-minute cache, and falls
-* back to a minimal bundled catalog (marked degraded) when the live fetch
-* fails and no cached copy exists.
-*/
-async function getXuluxCatalog() {
-	const url = getCatalogUrl();
-	const now = Date.now();
-	if (cache && cache.url === url && now - cache.fetchedAt < CATALOG_TTL_MS) return {
-		catalog: cache.catalog,
-		degraded: false
-	};
-	try {
-		const catalog = await fetchCatalog(url);
-		cache = {
-			catalog,
-			fetchedAt: now,
-			url
-		};
-		return {
-			catalog,
-			degraded: false
-		};
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		logger.warn(`assistant-ui template catalog fetch failed (${url}): ${message}`);
-		if (cache && cache.url === url) return {
-			catalog: cache.catalog,
-			degraded: true,
-			degradedReason: `Live catalog refresh failed (${message}); using previously fetched catalog.`
-		};
-		return {
-			catalog: FALLBACK_CATALOG,
-			degraded: true,
-			degradedReason: `${message} ${FALLBACK_NOTE}`
-		};
-	}
-}
-//#endregion
-export { DEFAULT_CATALOG_URL, clearCatalogCache, getCatalogUrl, getXuluxCatalog };
-
-//# sourceMappingURL=catalog-client.js.map

package/dist/xulux/catalog-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog-client.js","names":[],"sources":["../../src/xulux/catalog-client.ts"],"sourcesContent":["import { logger } from \"../utils/logger.js\";\nimport { FALLBACK_CATALOG, FALLBACK_NOTE } from \"./fallback-catalog.js\";\nimport type { XuluxCatalog, XuluxCatalogResult } from \"./types.js\";\n\nexport const DEFAULT_CATALOG_URL =\n  \"https://www.assistant-ui.com/api/xulux/mcp-catalog\";\n\nconst CATALOG_TTL_MS = 5 * 60 * 1000;\n\nexport function getCatalogUrl(): string {\n  const override = process.env.XULUX_CATALOG_URL?.trim();\n  return override || DEFAULT_CATALOG_URL;\n}\n\nfunction validateCatalog(data: unknown): XuluxCatalog {\n  if (!data || typeof data !== \"object\" || Array.isArray(data)) {\n    throw new Error(\"Catalog response is not a JSON object.\");\n  }\n  const catalog = data as XuluxCatalog;\n  if (catalog.version !== 1) {\n    throw new Error(\n      `Unsupported catalog version: ${String(catalog.version)}. Expected 1.`,\n    );\n  }\n  if (!Array.isArray(catalog.templates)) {\n    throw new Error(\"Catalog response has no templates array.\");\n  }\n  for (const template of catalog.templates) {\n    if (\n      !template ||\n      typeof template !== \"object\" ||\n      typeof template.id !== \"string\" ||\n      typeof template.templateId !== \"string\" ||\n      (template.kind !== \"template\" && template.kind !== \"example\")\n    ) {\n      throw new Error(\n        \"Catalog response contains a malformed template entry (missing id/templateId/kind).\",\n      );\n    }\n  }\n  return catalog;\n}\n\ninterface CacheEntry {\n  catalog: XuluxCatalog;\n  fetchedAt: number;\n  url: string;\n}\n\nlet cache: CacheEntry | null = null;\n\nexport function clearCatalogCache(): void {\n  cache = null;\n}\n\nasync function fetchCatalog(url: string): Promise<XuluxCatalog> {\n  const res = await fetch(url, {\n    headers: { Accept: \"application/json\" },\n  });\n  if (!res.ok) {\n    throw new Error(`Catalog fetch failed: HTTP ${res.status}`);\n  }\n  const data: unknown = await res.json();\n  return validateCatalog(data);\n}\n\n/**\n * Returns the assistant-ui template catalog. Uses an in-memory five-minute cache, and falls\n * back to a minimal bundled catalog (marked degraded) when the live fetch\n * fails and no cached copy exists.\n */\nexport async function getXuluxCatalog(): Promise<XuluxCatalogResult> {\n  const url = getCatalogUrl();\n  const now = Date.now();\n\n  if (cache && cache.url === url && now - cache.fetchedAt < CATALOG_TTL_MS) {\n    return { catalog: cache.catalog, degraded: false };\n  }\n\n  try {\n    const catalog = await fetchCatalog(url);\n    cache = { catalog, fetchedAt: now, url };\n    return { catalog, degraded: false };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.warn(\n      `assistant-ui template catalog fetch failed (${url}): ${message}`,\n    );\n\n    // Prefer a stale cached copy over the minimal fallback.\n    if (cache && cache.url === url) {\n      return {\n        catalog: cache.catalog,\n        degraded: true,\n        degradedReason: `Live catalog refresh failed (${message}); using previously fetched catalog.`,\n      };\n    }\n\n    return {\n      catalog: FALLBACK_CATALOG,\n      degraded: true,\n      degradedReason: `${message} ${FALLBACK_NOTE}`,\n    };\n  }\n}\n"],"mappings":";;;AAIA,MAAa,sBACX;AAEF,MAAM,iBAAiB;AAEvB,SAAgB,gBAAwB;CAEtC,OADiB,QAAQ,IAAI,mBAAmB,KAAK,KAAA;AAEvD;AAEA,SAAS,gBAAgB,MAA6B;CACpD,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,GACzD,MAAM,IAAI,MAAM,wCAAwC;CAE1D,MAAM,UAAU;CAChB,IAAI,QAAQ,YAAY,GACtB,MAAM,IAAI,MACR,gCAAgC,OAAO,QAAQ,OAAO,EAAE,cAC1D;CAEF,IAAI,CAAC,MAAM,QAAQ,QAAQ,SAAS,GAClC,MAAM,IAAI,MAAM,0CAA0C;CAE5D,KAAK,MAAM,YAAY,QAAQ,WAC7B,IACE,CAAC,YACD,OAAO,aAAa,YACpB,OAAO,SAAS,OAAO,YACvB,OAAO,SAAS,eAAe,YAC9B,SAAS,SAAS,cAAc,SAAS,SAAS,WAEnD,MAAM,IAAI,MACR,oFACF;CAGJ,OAAO;AACT;AAQA,IAAI,QAA2B;AAE/B,SAAgB,oBAA0B;CACxC,QAAQ;AACV;AAEA,eAAe,aAAa,KAAoC;CAC9D,MAAM,MAAM,MAAM,MAAM,KAAK,EAC3B,SAAS,EAAE,QAAQ,mBAAmB,EACxC,CAAC;CACD,IAAI,CAAC,IAAI,IACP,MAAM,IAAI,MAAM,8BAA8B,IAAI,QAAQ;CAG5D,OAAO,gBAAgB,MADK,IAAI,KAAK,CACV;AAC7B;;;;;;AAOA,eAAsB,kBAA+C;CACnE,MAAM,MAAM,cAAc;CAC1B,MAAM,MAAM,KAAK,IAAI;CAErB,IAAI,SAAS,MAAM,QAAQ,OAAO,MAAM,MAAM,YAAY,gBACxD,OAAO;EAAE,SAAS,MAAM;EAAS,UAAU;CAAM;CAGnD,IAAI;EACF,MAAM,UAAU,MAAM,aAAa,GAAG;EACtC,QAAQ;GAAE;GAAS,WAAW;GAAK;EAAI;EACvC,OAAO;GAAE;GAAS,UAAU;EAAM;CACpC,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACrE,OAAO,KACL,+CAA+C,IAAI,KAAK,SAC1D;EAGA,IAAI,SAAS,MAAM,QAAQ,KACzB,OAAO;GACL,SAAS,MAAM;GACf,UAAU;GACV,gBAAgB,gCAAgC,QAAQ;EAC1D;EAGF,OAAO;GACL,SAAS;GACT,UAAU;GACV,gBAAgB,GAAG,QAAQ,GAAG;EAChC;CACF;AACF"}

package/dist/xulux/fallback-catalog.d.ts

@@ -1,7 +0,0 @@
-import { XuluxCatalog } from "./types.js";
-//#region src/xulux/fallback-catalog.d.ts
-declare const FALLBACK_NOTE: string;
-declare const FALLBACK_CATALOG: XuluxCatalog;
-//#endregion
-export { FALLBACK_CATALOG, FALLBACK_NOTE };
-//# sourceMappingURL=fallback-catalog.d.ts.map

package/dist/xulux/fallback-catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fallback-catalog.d.ts","names":[],"sources":["../../src/xulux/fallback-catalog.ts"],"mappings":";;cAWa;cAiBA,kBAAkB"}

package/dist/xulux/fallback-catalog.js

@@ -1,47 +0,0 @@
-import "./types.js";
-//#region src/xulux/fallback-catalog.ts
-const FALLBACK_NOTE = "The live assistant-ui template catalog could not be fetched, so this is minimal bundled fallback data. Template details, previews, and downloads require live catalog access. Check network access to the docs site or set XULUX_CATALOG_URL to a reachable catalog endpoint.";
-const fallbackTemplate = (overrides) => ({
-	templateId: overrides.id,
-	versionId: null,
-	assistantPlacement: "unavailable in fallback mode",
-	features: [],
-	customizable: [],
-	versions: [],
-	...overrides
-});
-const FALLBACK_CATALOG = {
-	version: 1,
-	generatedAt: "fallback",
-	docsOrigin: "https://www.assistant-ui.com",
-	templates: [
-		fallbackTemplate({
-			id: "base-assistant-ui",
-			kind: "template",
-			name: "Configurable Base Assistant UI",
-			summary: "Hosted configurable assistant-ui Base chat template with threads, composer, suggestions, and no-key demo flows."
-		}),
-		fallbackTemplate({
-			id: "webpage-assistant",
-			kind: "template",
-			name: "Webpage with Assistant",
-			summary: "Docs/website layout with a sidebar or modal assistant grounded in configurable pages."
-		}),
-		fallbackTemplate({
-			id: "product-page-assistant",
-			kind: "template",
-			name: "Product Page with Floating Assistant",
-			summary: "Mock product dashboard with a floating modal support assistant and analyze-then-handoff flow."
-		}),
-		fallbackTemplate({
-			id: "expo-react-native",
-			kind: "example",
-			name: "Expo React Native Assistant",
-			summary: "Mobile AI chat app built with Expo and assistant-ui React Native primitives."
-		})
-	]
-};
-//#endregion
-export { FALLBACK_CATALOG, FALLBACK_NOTE };
-
-//# sourceMappingURL=fallback-catalog.js.map

package/dist/xulux/fallback-catalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fallback-catalog.js","names":[],"sources":["../../src/xulux/fallback-catalog.ts"],"sourcesContent":["import {\n  XULUX_MCP_CATALOG_VERSION,\n  type XuluxCatalog,\n  type XuluxCatalogTemplate,\n} from \"./types.js\";\n\n// Minimal bundled fallback catalog for degraded mode. It supports discovery\n// (ids + names) only. Full authoring details and preview/download URLs\n// require the live catalog endpoint. Do NOT grow this into a copy of the\n// full template knowledge base — the docs endpoint owns freshness.\n\nexport const FALLBACK_NOTE =\n  \"The live assistant-ui template catalog could not be fetched, so this is minimal bundled fallback data. \" +\n  \"Template details, previews, and downloads require live catalog access. \" +\n  \"Check network access to the docs site or set XULUX_CATALOG_URL to a reachable catalog endpoint.\";\n\nconst fallbackTemplate = (\n  overrides: Pick<XuluxCatalogTemplate, \"id\" | \"kind\" | \"name\" | \"summary\">,\n): XuluxCatalogTemplate => ({\n  templateId: overrides.id,\n  versionId: null,\n  assistantPlacement: \"unavailable in fallback mode\",\n  features: [],\n  customizable: [],\n  versions: [],\n  ...overrides,\n});\n\nexport const FALLBACK_CATALOG: XuluxCatalog = {\n  version: XULUX_MCP_CATALOG_VERSION,\n  generatedAt: \"fallback\",\n  docsOrigin: \"https://www.assistant-ui.com\",\n  templates: [\n    fallbackTemplate({\n      id: \"base-assistant-ui\",\n      kind: \"template\",\n      name: \"Configurable Base Assistant UI\",\n      summary:\n        \"Hosted configurable assistant-ui Base chat template with threads, composer, suggestions, and no-key demo flows.\",\n    }),\n    fallbackTemplate({\n      id: \"webpage-assistant\",\n      kind: \"template\",\n      name: \"Webpage with Assistant\",\n      summary:\n        \"Docs/website layout with a sidebar or modal assistant grounded in configurable pages.\",\n    }),\n    fallbackTemplate({\n      id: \"product-page-assistant\",\n      kind: \"template\",\n      name: \"Product Page with Floating Assistant\",\n      summary:\n        \"Mock product dashboard with a floating modal support assistant and analyze-then-handoff flow.\",\n    }),\n    fallbackTemplate({\n      id: \"expo-react-native\",\n      kind: \"example\",\n      name: \"Expo React Native Assistant\",\n      summary:\n        \"Mobile AI chat app built with Expo and assistant-ui React Native primitives.\",\n    }),\n  ],\n};\n"],"mappings":";;AAWA,MAAa,gBACX;AAIF,MAAM,oBACJ,eAC0B;CAC1B,YAAY,UAAU;CACtB,WAAW;CACX,oBAAoB;CACpB,UAAU,CAAC;CACX,cAAc,CAAC;CACf,UAAU,CAAC;CACX,GAAG;AACL;AAEA,MAAa,mBAAiC;CAC5C,SAAA;CACA,aAAa;CACb,YAAY;CACZ,WAAW;EACT,iBAAiB;GACf,IAAI;GACJ,MAAM;GACN,MAAM;GACN,SACE;EACJ,CAAC;EACD,iBAAiB;GACf,IAAI;GACJ,MAAM;GACN,MAAM;GACN,SACE;EACJ,CAAC;EACD,iBAAiB;GACf,IAAI;GACJ,MAAM;GACN,MAAM;GACN,SACE;EACJ,CAAC;EACD,iBAAiB;GACf,IAAI;GACJ,MAAM;GACN,MAAM;GACN,SACE;EACJ,CAAC;CACH;AACF"}

package/dist/xulux/fetch-sandbox.d.ts

@@ -1,5 +0,0 @@
-//#region src/xulux/fetch-sandbox.d.ts
-declare function fetchSandboxResource(url: string | URL, init?: RequestInit): Promise<Response>;
-//#endregion
-export { fetchSandboxResource };
-//# sourceMappingURL=fetch-sandbox.d.ts.map

package/dist/xulux/fetch-sandbox.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch-sandbox.d.ts","names":[],"sources":["../../src/xulux/fetch-sandbox.ts"],"mappings":";iBAgCsB,qBACpB,cAAc,KACd,OAAO,cACN,QAAQ"}

package/dist/xulux/fetch-sandbox.js

@@ -1,40 +0,0 @@
-//#region src/xulux/fetch-sandbox.ts
-const SANDBOX_FETCH_HEADERS = {
-	Accept: "application/json, application/zip, application/octet-stream, */*",
-	"User-Agent": "curl/8.7.1"
-};
-const MAX_ATTEMPTS = 3;
-const RETRY_DELAY_MS = 300;
-function isRetryableFetchError(error) {
-	if (!(error instanceof Error)) return false;
-	const code = error.cause?.code ?? error.message;
-	return code === "ECONNRESET" || code === "ETIMEDOUT" || code === "ECONNREFUSED" || code === "fetch failed";
-}
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function mergeHeaders(headers) {
-	const merged = new Headers(SANDBOX_FETCH_HEADERS);
-	if (!headers) return merged;
-	new Headers(headers).forEach((value, key) => merged.set(key, value));
-	return merged;
-}
-async function fetchSandboxResource(url, init) {
-	let lastError;
-	for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt += 1) try {
-		return await fetch(url, {
-			...init,
-			cache: "no-store",
-			headers: mergeHeaders(init?.headers)
-		});
-	} catch (error) {
-		lastError = error;
-		if (!isRetryableFetchError(error) || attempt === MAX_ATTEMPTS) throw error;
-		await sleep(RETRY_DELAY_MS * attempt);
-	}
-	throw lastError;
-}
-//#endregion
-export { fetchSandboxResource };
-
-//# sourceMappingURL=fetch-sandbox.js.map

package/dist/xulux/fetch-sandbox.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch-sandbox.js","names":[],"sources":["../../src/xulux/fetch-sandbox.ts"],"sourcesContent":["const SANDBOX_FETCH_HEADERS = {\n  Accept: \"application/json, application/zip, application/octet-stream, */*\",\n  // Blaxel preview hosts intermittently reset Node's default fetch path.\n  \"User-Agent\": \"curl/8.7.1\",\n};\n\nconst MAX_ATTEMPTS = 3;\nconst RETRY_DELAY_MS = 300;\n\nfunction isRetryableFetchError(error: unknown) {\n  if (!(error instanceof Error)) return false;\n  const cause = error.cause as { code?: string } | undefined;\n  const code = cause?.code ?? error.message;\n  return (\n    code === \"ECONNRESET\" ||\n    code === \"ETIMEDOUT\" ||\n    code === \"ECONNREFUSED\" ||\n    code === \"fetch failed\"\n  );\n}\n\nfunction sleep(ms: number) {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction mergeHeaders(headers?: HeadersInit): Headers {\n  const merged = new Headers(SANDBOX_FETCH_HEADERS);\n  if (!headers) return merged;\n  new Headers(headers).forEach((value, key) => merged.set(key, value));\n  return merged;\n}\n\nexport async function fetchSandboxResource(\n  url: string | URL,\n  init?: RequestInit,\n): Promise<Response> {\n  let lastError: unknown;\n\n  for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt += 1) {\n    try {\n      return await fetch(url, {\n        ...init,\n        cache: \"no-store\",\n        headers: mergeHeaders(init?.headers),\n      });\n    } catch (error) {\n      lastError = error;\n      if (!isRetryableFetchError(error) || attempt === MAX_ATTEMPTS) {\n        throw error;\n      }\n      await sleep(RETRY_DELAY_MS * attempt);\n    }\n  }\n\n  throw lastError;\n}\n"],"mappings":";AAAA,MAAM,wBAAwB;CAC5B,QAAQ;CAER,cAAc;AAChB;AAEA,MAAM,eAAe;AACrB,MAAM,iBAAiB;AAEvB,SAAS,sBAAsB,OAAgB;CAC7C,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CAEtC,MAAM,OADQ,MAAM,OACA,QAAQ,MAAM;CAClC,OACE,SAAS,gBACT,SAAS,eACT,SAAS,kBACT,SAAS;AAEb;AAEA,SAAS,MAAM,IAAY;CACzB,OAAO,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;AAEA,SAAS,aAAa,SAAgC;CACpD,MAAM,SAAS,IAAI,QAAQ,qBAAqB;CAChD,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,OAAO,CAAC,CAAC,SAAS,OAAO,QAAQ,OAAO,IAAI,KAAK,KAAK,CAAC;CACnE,OAAO;AACT;AAEA,eAAsB,qBACpB,KACA,MACmB;CACnB,IAAI;CAEJ,KAAK,IAAI,UAAU,GAAG,WAAW,cAAc,WAAW,GACxD,IAAI;EACF,OAAO,MAAM,MAAM,KAAK;GACtB,GAAG;GACH,OAAO;GACP,SAAS,aAAa,MAAM,OAAO;EACrC,CAAC;CACH,SAAS,OAAO;EACd,YAAY;EACZ,IAAI,CAAC,sBAAsB,KAAK,KAAK,YAAY,cAC/C,MAAM;EAER,MAAM,MAAM,iBAAiB,OAAO;CACtC;CAGF,MAAM;AACR"}