mcp-osp-prompt 1.0.0

package/platform-utils.js

@@ -0,0 +1,206 @@
+/**
+ * Platform utilities for detecting and handling different Git platforms
+ * Shared between config.js and fetcher.js to avoid code duplication
+ */
+
+// Platform detection from RESOURCE_PATH (or legacy PROMPT_PATH)
+export function detectPlatformFromPath(promptPath) {
+  if (!promptPath) {
+    return null;
+  }
+  
+  // Check for GitHub patterns
+  if (promptPath.includes('github.com') || promptPath.match(/^[\w-]+\/[\w-]+$/)) {
+    return 'github';
+  }
+  
+  // Check for GitLab patterns  
+  if (promptPath.includes('gitlab.com')) {
+    return 'gitlab';
+  }
+  
+  // Check if it's a local path
+  if (promptPath.startsWith('/') || promptPath.startsWith('./') || promptPath.startsWith('~')) {
+    return 'local';
+  }
+  
+  // Default to local for relative paths
+  return 'local';
+}
+
+// Parse remote path information with universal support for complex URLs
+// 🟢 GREEN: Task 1.1 - 支持子目录参数，用于多目录资源拉取
+export function parseRemotePath(promptPath, subDirectory = '') {
+  // 🟢 GREEN: Task 1.1 - 添加null/undefined检查和详细错误信息
+  if (!promptPath) {
+    throw new Error('RESOURCE_PATH cannot be null or empty. Please set a valid remote URL or local path.');
+  }
+  
+  if (typeof promptPath !== 'string') {
+    throw new Error(`RESOURCE_PATH must be a string, received: ${typeof promptPath}`); // Note: parameter name 'promptPath' kept for compatibility
+  }
+  
+  const cleanPath = promptPath.replace(/^https?:\/\//, '');
+  
+  // GitHub URL parsing: github.com/owner/repo/tree/branch/path
+  if (cleanPath.includes('github.com')) {
+    // Match GitHub tree browsing URLs - handle branches with slashes
+    const treeMatch = cleanPath.match(/github\.com\/([^\/]+\/[^\/]+)\/tree\/(.*)/);
+    if (treeMatch) {
+      const [, project, remainingPath] = treeMatch;
+      
+      // Split remaining path and try to identify branch vs file path
+      // Common strategy: assume first 1-2 segments are branch, rest is path
+      const segments = remainingPath.split('/');
+      let branch, path;
+      
+      if (segments.length === 1) {
+        // Only branch, no path
+        branch = segments[0];
+        path = '';
+      } else if (segments.length >= 2) {
+        // Try to handle common branch patterns
+        if (segments[0].match(/^(main|master|develop|dev)$/) || 
+            segments[0].match(/^v?\d+/) || // version tags
+            !segments[1].match(/^[a-zA-Z]/) // if second segment starts with non-letter, likely part of branch
+           ) {
+          // Single segment branch
+          branch = segments[0];
+          path = segments.slice(1).join('/');
+        } else {
+          // Multi-segment branch (like feature/new-ui)
+          branch = segments.slice(0, 2).join('/');
+          path = segments.slice(2).join('/');
+        }
+      }
+      
+      return appendSubDirectory({
+        platform: 'github',
+        project,
+        repo: project, // Alias for backward compatibility
+        branch: branch || 'main',
+        path: path || '', // File/directory path
+        apiUrl: `https://api.github.com/repos/${project}/contents/${path || ''}`
+      }, subDirectory);
+    }
+    
+    // Match simple GitHub project URLs
+    const simpleMatch = cleanPath.match(/github\.com\/([^\/]+\/[^\/]+)/);
+    if (simpleMatch) {
+      return appendSubDirectory({
+        platform: 'github',
+        project: simpleMatch[1],
+        repo: simpleMatch[1],
+        branch: 'main',
+        path: '',
+        apiUrl: `https://api.github.com/repos/${simpleMatch[1]}/contents`
+      }, subDirectory);
+    }
+  }
+  
+  // GitLab URL parsing: gitlab.com/group/project/-/tree/branch/path
+  if (cleanPath.includes('gitlab.com')) {
+    // Match GitLab tree browsing URLs with /-/tree/ pattern
+    const treeMatch = cleanPath.match(/gitlab\.com\/(.*?)\/-\/tree\/([^\/]+)\/?(.*)/);
+    if (treeMatch) {
+      const [, project, branch, path] = treeMatch;
+      return appendSubDirectory({
+        platform: 'gitlab',
+        project,
+        group: project, // Alias for backward compatibility
+        branch,
+        path: path || '', // File/directory path
+        apiUrl: `https://gitlab.com/api/v4/projects/${encodeURIComponent(project)}/repository/tree?path=${path || ''}&ref=${branch}&recursive=true&per_page=100`
+      }, subDirectory);
+    }
+    
+    // Match simple GitLab project URLs
+    const simpleMatch = cleanPath.match(/gitlab\.com\/(.+?)(?:\/|$)/);
+    if (simpleMatch) {
+      const project = simpleMatch[1];
+      return appendSubDirectory({
+        platform: 'gitlab',
+        project,
+        group: project,
+        branch: 'master',
+        path: '',
+        apiUrl: `https://gitlab.com/api/v4/projects/${encodeURIComponent(project)}/repository/tree?ref=master&recursive=true&per_page=100`
+      }, subDirectory);
+    }
+  }
+  
+  // Handle simple format like "user/repo" (defaults to GitHub)
+  if (promptPath.match(/^[\w-]+\/[\w-]+$/)) {
+    return appendSubDirectory({
+      platform: 'github',
+      project: promptPath,
+      repo: promptPath,
+      branch: 'main',
+      path: '',
+      apiUrl: `https://api.github.com/repos/${promptPath}/contents`
+    }, subDirectory);
+  }
+  
+  return null;
+}
+
+// 🟢 GREEN: Task 1.1 - 辅助函数：追加子目录到路径信息
+function appendSubDirectory(pathInfo, subDirectory) {
+  if (!subDirectory || !pathInfo) {
+    return pathInfo;
+  }
+  
+  // 追加子目录到path
+  const newPath = pathInfo.path ? `${pathInfo.path}/${subDirectory}` : subDirectory;
+  
+  // 根据平台更新apiUrl
+  let newApiUrl = pathInfo.apiUrl;
+  if (pathInfo.platform === 'github') {
+    // GitHub: https://api.github.com/repos/{project}/contents/{path}
+    newApiUrl = `https://api.github.com/repos/${pathInfo.project}/contents/${newPath}`;
+  } else if (pathInfo.platform === 'gitlab') {
+    // GitLab: https://gitlab.com/api/v4/projects/{project}/repository/tree?path={path}&ref={branch}&recursive=true&per_page=100
+    newApiUrl = `https://gitlab.com/api/v4/projects/${encodeURIComponent(pathInfo.project)}/repository/tree?path=${newPath}&ref=${pathInfo.branch}&recursive=true&per_page=100`;
+  }
+  
+  return {
+    ...pathInfo,
+    path: newPath,
+    apiUrl: newApiUrl
+  };
+}
+
+// Create authentication headers based on platform
+export function createAuthHeaders(platform, token) {
+  if (!token) {
+    return {};
+  }
+  
+  const headers = {};
+  
+  if (platform === 'github') {
+    headers['Authorization'] = `token ${token}`;
+    headers['Accept'] = 'application/vnd.github.v3+json';
+  } else if (platform === 'gitlab') {
+    headers['PRIVATE-TOKEN'] = token;
+    headers['User-Agent'] = 'curl/7.68.0';
+    headers['Accept'] = '*/*';
+  }
+  
+  return headers;
+}
+
+// Validate configuration for given platform
+export function validatePlatformConfiguration(resourcePath, token) {
+  if (!resourcePath) {
+    throw new Error('RESOURCE_PATH is required. Set it to a local directory path, GitHub repo (user/repo), or full URL.');
+  }
+  
+  const platform = detectPlatformFromPath(resourcePath);
+  
+  if ((platform === 'github' || platform === 'gitlab') && !token) {
+    throw new Error('GIT_TOKEN is required for remote repositories. Please set your GitHub or GitLab access token.');
+  }
+  
+  return platform;
+}