#!/usr/bin/env node
const { EnhancedDocumentationFetcher } = require('../dist/utils/enhanced-documentation-fetcher');
async function demoEnhancedDocumentation() {
console.log('=== Enhanced Documentation Parser Demo ===\n');
console.log('This demo shows how the enhanced DocumentationFetcher extracts rich content from n8n documentation.\n');
const fetcher = new EnhancedDocumentationFetcher();
try {
// Demo 1: Slack node (complex app node with many operations)
console.log('1. SLACK NODE DOCUMENTATION');
console.log('=' .repeat(50));
const slackDoc = await fetcher.getEnhancedNodeDocumentation('n8n-nodes-base.slack');
if (slackDoc) {
console.log('\nš Basic Information:');
console.log(` ā¢ Title: ${slackDoc.title}`);
console.log(` ā¢ Description: ${slackDoc.description}`);
console.log(` ā¢ URL: ${slackDoc.url}`);
console.log('\nš Content Statistics:');
console.log(` ā¢ Operations: ${slackDoc.operations?.length || 0} operations across multiple resources`);
console.log(` ā¢ API Methods: ${slackDoc.apiMethods?.length || 0} mapped to Slack API endpoints`);
console.log(` ā¢ Examples: ${slackDoc.examples?.length || 0} code examples`);
console.log(` ā¢ Resources: ${slackDoc.relatedResources?.length || 0} related documentation links`);
console.log(` ā¢ Scopes: ${slackDoc.requiredScopes?.length || 0} OAuth scopes`);
// Show operations breakdown
if (slackDoc.operations && slackDoc.operations.length > 0) {
console.log('\nš§ Operations by Resource:');
const resourceMap = new Map();
slackDoc.operations.forEach(op => {
if (!resourceMap.has(op.resource)) {
resourceMap.set(op.resource, []);
}
resourceMap.get(op.resource).push(op);
});
for (const [resource, ops] of resourceMap) {
console.log(`\n ${resource} (${ops.length} operations):`);
ops.slice(0, 5).forEach(op => {
console.log(` ā¢ ${op.operation}: ${op.description}`);
});
if (ops.length > 5) {
console.log(` ... and ${ops.length - 5} more`);
}
}
}
// Show API method mappings
if (slackDoc.apiMethods && slackDoc.apiMethods.length > 0) {
console.log('\nš API Method Mappings (sample):');
slackDoc.apiMethods.slice(0, 5).forEach(api => {
console.log(` ā¢ ${api.resource}.${api.operation} ā ${api.apiMethod}`);
console.log(` URL: ${api.apiUrl}`);
});
if (slackDoc.apiMethods.length > 5) {
console.log(` ... and ${slackDoc.apiMethods.length - 5} more mappings`);
}
}
}
// Demo 2: If node (core node with conditions)
console.log('\n\n2. IF NODE DOCUMENTATION');
console.log('=' .repeat(50));
const ifDoc = await fetcher.getEnhancedNodeDocumentation('n8n-nodes-base.if');
if (ifDoc) {
console.log('\nš Basic Information:');
console.log(` ā¢ Title: ${ifDoc.title}`);
console.log(` ā¢ Description: ${ifDoc.description}`);
console.log(` ā¢ URL: ${ifDoc.url}`);
if (ifDoc.relatedResources && ifDoc.relatedResources.length > 0) {
console.log('\nš Related Resources:');
ifDoc.relatedResources.forEach(res => {
console.log(` ā¢ ${res.title} (${res.type})`);
console.log(` ${res.url}`);
});
}
}
// Demo 3: Summary of enhanced parsing capabilities
console.log('\n\n3. ENHANCED PARSING CAPABILITIES');
console.log('=' .repeat(50));
console.log('\nThe enhanced DocumentationFetcher can extract:');
console.log(' ā Markdown frontmatter (metadata, tags, priority)');
console.log(' ā Operations with resource grouping and descriptions');
console.log(' ā API method mappings from markdown tables');
console.log(' ā Code examples (JSON, JavaScript, YAML)');
console.log(' ā Template references');
console.log(' ā Related resources and documentation links');
console.log(' ā Required OAuth scopes');
console.log('\nThis rich content enables AI agents to:');
console.log(' ā¢ Understand node capabilities in detail');
console.log(' ā¢ Map operations to actual API endpoints');
console.log(' ā¢ Provide accurate examples and usage patterns');
console.log(' ā¢ Navigate related documentation');
console.log(' ā¢ Understand authentication requirements');
} catch (error) {
console.error('\nError:', error);
} finally {
await fetcher.cleanup();
console.log('\n\nā Demo completed');
}
}
// Run the demo
demoEnhancedDocumentation().catch(console.error);
