@mintlify/common 1.0.630 → 1.0.632

package/dist/mdx/snippets/index.d.ts

@@ -3,6 +3,7 @@ export * from './hasImports.js';
 export * from './nodeIncludesExport.js';
 export * from './resolveImport/index.js';
 export * from './resolveAllImports.js';
+export * from './resolveSnippetImportPath.js';
 export * from './removeExports.js';
 export * from './getExportMap.js';
 export * from './findAndRemoveExports.js';

package/dist/mdx/snippets/index.js

@@ -3,6 +3,7 @@ export * from './hasImports.js';
 export * from './nodeIncludesExport.js';
 export * from './resolveImport/index.js';
 export * from './resolveAllImports.js';
+export * from './resolveSnippetImportPath.js';
 export * from './removeExports.js';
 export * from './getExportMap.js';
 export * from './findAndRemoveExports.js';

package/dist/mdx/snippets/resolveAllImports.js

@@ -9,18 +9,20 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { getExportMapFromTree } from './getExportMap.js';
 import { resolveImport } from './resolveImport/index.js';
+import { resolveSnippetImportPath } from './resolveSnippetImportPath.js';
 export const resolveAllImports = (params) => __awaiter(void 0, void 0, void 0, function* () {
     const { snippets, fileWithImports } = params;
     let ast = fileWithImports.tree;
     const exportMap = getExportMapFromTree(ast);
     for (const source of Object.keys(fileWithImports.importMap)) {
-        if (!source.startsWith('/snippets/')) {
-            console.log(`Invalid import path ${source} in ${fileWithImports.filename}. Import source must start with "/snippets/".`);
+        const resolvedPath = resolveSnippetImportPath(source, fileWithImports.filename);
+        if (resolvedPath == null) {
+            console.log(`Invalid import path ${source} in ${fileWithImports.filename}. Import must resolve to a file in /snippets/.`);
             continue;
         }
-        const importedSnippet = snippets.find((snippet) => snippet.filename === source);
+        const importedSnippet = snippets.find((snippet) => snippet.filename === resolvedPath);
         if (importedSnippet == undefined) {
-            console.log(`Could not find file ${source} - imported from ${fileWithImports.filename}`);
+            console.log(`Could not find file ${resolvedPath} - imported from ${fileWithImports.filename}`);
             continue;
         }
         const specifiers = fileWithImports.importMap[source];

package/dist/mdx/snippets/resolveSnippetImportPath.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolves an import path to an absolute path with leading slash.
+ * Only allows imports that resolve to files in /snippets/.
+ *
+ * @param source The import source path (e.g., '/snippets/foo.mdx' or '../snippets/bar.mdx')
+ * @param importingFilePath The path of the file containing the import
+ * @returns The resolved absolute path with leading slash, or null if invalid or not in snippets folder
+ */
+export declare const resolveSnippetImportPath: (source: string, importingFilePath: string) => string | null;

package/dist/mdx/snippets/resolveSnippetImportPath.js

@@ -0,0 +1,32 @@
+import { posix } from 'path';
+const isRelativeImport = (source) => {
+    return source.startsWith('./') || source.startsWith('../');
+};
+const isInSnippetsFolder = (resolvedPath) => {
+    return resolvedPath.startsWith('/snippets/');
+};
+/**
+ * Resolves an import path to an absolute path with leading slash.
+ * Only allows imports that resolve to files in /snippets/.
+ *
+ * @param source The import source path (e.g., '/snippets/foo.mdx' or '../snippets/bar.mdx')
+ * @param importingFilePath The path of the file containing the import
+ * @returns The resolved absolute path with leading slash, or null if invalid or not in snippets folder
+ */
+export const resolveSnippetImportPath = (source, importingFilePath) => {
+    let resolvedPath;
+    if (source.startsWith('/')) {
+        resolvedPath = posix.normalize(source);
+    }
+    else if (isRelativeImport(source)) {
+        const importingDir = posix.dirname(importingFilePath.startsWith('/') ? importingFilePath : '/' + importingFilePath);
+        resolvedPath = posix.resolve(importingDir, source);
+    }
+    else {
+        return null;
+    }
+    if (!isInSnippetsFolder(resolvedPath)) {
+        return null;
+    }
+    return resolvedPath;
+};