@djangocfg/nextjs 2.1.48 → 2.1.50

package/src/scripts/check-links.ts

@@ -1,477 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Smart Link Checker using linkinator
- * 
- * Checks all links on a website with proper error handling,
- * timeout management, and filtering of problematic URLs.
- * 
- * @example
- * ```bash
- * node check-links.ts https://example.com
- * ```
- */
-
-import { mkdir, writeFile } from 'fs/promises';
-import * as linkinator from 'linkinator';
-import { dirname } from 'path';
-import pc from 'picocolors';
-import prompts from 'prompts';
-
-import type { CheckOptions } from 'linkinator';
-export interface CheckLinksOptions {
-  /** Base URL to check */
-  url: string;
-  /** Timeout in milliseconds (default: 60000) */
-  timeout?: number;
-  /** URLs to skip (regex pattern) */
-  skipPattern?: string;
-  /** Show only broken links (default: true) */
-  showOnlyBroken?: boolean;
-  /** Maximum number of concurrent requests (default: 50) */
-  concurrency?: number;
-  /** Output file path for report (optional) */
-  outputFile?: string;
-  /** Report format: 'json', 'markdown', 'text' (default: 'text') */
-  reportFormat?: 'json' | 'markdown' | 'text';
-  /** Verbose logging (default: true) */
-  verbose?: boolean;
-}
-
-const DEFAULT_SKIP_PATTERN = [
-  'github.com',
-  'twitter.com',
-  'linkedin.com',
-  'x.com',
-  '127.0.0.1',
-  'uneralon.com',
-  'localhost:[0-9]+',
-  'api\\.localhost',
-  'demo\\.localhost',
-  'cdn-cgi', // Cloudflare email protection
-  'mailto:', // Email links
-  'tel:', // Phone links
-  'javascript:', // JavaScript links
-].join('|');
-
-export interface CheckLinksResult {
-  success: boolean;
-  broken: number;
-  total: number;
-  errors: Array<{ url: string; status: number | string; reason?: string }>;
-  url: string;
-  timestamp: string;
-  duration?: number;
-}
-
-export async function checkLinks(options: CheckLinksOptions): Promise<CheckLinksResult> {
-  const {
-    url,
-    timeout = 60000, // Increased to 60 seconds
-    skipPattern = DEFAULT_SKIP_PATTERN,
-    showOnlyBroken = true,
-    concurrency = 50, // Increased to 50 concurrent requests
-    outputFile,
-    reportFormat = 'text',
-    verbose = true,
-  } = options;
-
-  const startTime = Date.now();
-  
-  if (verbose) {
-    console.log(pc.cyan(`\n🔍 Starting link check for: ${pc.bold(url)}`));
-    console.log(pc.dim(`   Timeout: ${timeout}ms | Concurrency: ${concurrency}`));
-    console.log('');
-  }
-
-  // Build linksToSkip array from regex pattern
-  const skipRegex = new RegExp(skipPattern);
-  const linksToSkip: string[] = [];
-  
-  const checkOptions: CheckOptions = {
-    path: url,
-    recurse: true,
-    timeout,
-    concurrency,
-    linksToSkip: (link: string) => {
-      return Promise.resolve(skipRegex.test(link));
-    },
-  };
-  const broken: Array<{ url: string; status: number | string; reason?: string }> = [];
-  let total = 0;
-
-  try {
-    const results = await linkinator.check(checkOptions);
-
-    // linkinator.check() returns { links: LinkResult[], passed: boolean }
-    for (const result of results.links) {
-      total++;
-      const status = result.status || 0;
-      
-      // Consider broken: non-2xx status codes, timeouts, errors
-      if (status < 200 || status >= 400 || result.state === 'BROKEN') {
-        broken.push({
-          url: result.url,
-          status: status || 'TIMEOUT',
-          reason: result.state === 'BROKEN' ? 'BROKEN' : undefined,
-        });
-      }
-    }
-
-    const success = broken.length === 0;
-
-    if (!showOnlyBroken || broken.length > 0) {
-      if (success) {
-        console.log(`✅ All links are valid!`);
-        console.log(`   Checked ${total} links.`);
-      } else {
-        console.log(`❌ Found ${broken.length} broken links out of ${total} total:`);
-        console.log('');
-        for (const { url, status, reason } of broken) {
-          console.log(`   [${status}] ${url}${reason ? ` (${reason})` : ''}`);
-        }
-      }
-    }
-
-    const duration = Date.now() - startTime;
-    const result: CheckLinksResult = {
-      success,
-      broken: broken.length,
-      total,
-      errors: broken,
-      url,
-      timestamp: new Date().toISOString(),
-      duration,
-    };
-
-    // Save report if output file is specified
-    if (outputFile) {
-      await saveReport(result, outputFile, reportFormat);
-      console.log(pc.green(`\n📄 Report saved to: ${pc.cyan(outputFile)}`));
-    }
-
-    return result;
-  } catch (error) {
-    // Handle timeout and other errors gracefully
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    const errorName = error instanceof Error ? error.name : 'UnknownError';
-    
-    if (
-      errorMessage.includes('timeout') || 
-      errorMessage.includes('TimeoutError') ||
-      errorName === 'TimeoutError' ||
-      errorMessage.includes('aborted')
-    ) {
-      console.warn(pc.yellow(`⚠️  Some links timed out after ${timeout}ms`));
-      console.warn(pc.dim(`   This is normal for slow or protected URLs.`));
-      if (total > 0) {
-        console.warn(pc.dim(`   Checked ${total} links before timeout.`));
-      }
-      
-      // If we have some broken links, show them
-      if (broken.length > 0) {
-        console.log(pc.red(`\n❌ Found ${broken.length} broken links:`));
-        for (const { url, status, reason } of broken) {
-          const statusColor = typeof status === 'number' && status >= 500 ? pc.red : pc.yellow;
-          console.log(`   ${statusColor(`[${status}]`)} ${pc.cyan(url)}${reason ? pc.dim(` (${reason})`) : ''}`);
-        }
-      }
-    } else {
-      console.error(pc.red(`❌ Error checking links: ${errorMessage}`));
-      if (error instanceof Error && error.stack) {
-        console.error(pc.dim(error.stack));
-      }
-    }
-
-    const duration = Date.now() - startTime;
-    // Return partial results even on error
-    const result: CheckLinksResult = {
-      success: broken.length === 0 && total > 0, // Success only if no broken links and we checked something
-      broken: broken.length,
-      total,
-      errors: broken,
-      url,
-      timestamp: new Date().toISOString(),
-      duration,
-    };
-
-    // Save report if output file is specified
-    if (outputFile) {
-      try {
-        await saveReport(result, outputFile, reportFormat);
-        console.log(pc.green(`\n📄 Report saved to: ${pc.cyan(outputFile)}`));
-      } catch (saveError) {
-        console.warn(pc.yellow(`\n⚠️  Failed to save report: ${saveError instanceof Error ? saveError.message : String(saveError)}`));
-      }
-    }
-
-    return result;
-  }
-}
-
-/**
- * Save report to file in specified format
- */
-async function saveReport(
-  result: CheckLinksResult,
-  filePath: string,
-  format: 'json' | 'markdown' | 'text'
-): Promise<void> {
-  // Ensure directory exists
-  const dir = dirname(filePath);
-  if (dir !== '.') {
-    await mkdir(dir, { recursive: true });
-  }
-
-  let content: string;
-
-  switch (format) {
-    case 'json':
-      content = JSON.stringify(result, null, 2);
-      break;
-
-    case 'markdown':
-      content = generateMarkdownReport(result);
-      break;
-
-    case 'text':
-    default:
-      content = generateTextReport(result);
-      break;
-  }
-
-  await writeFile(filePath, content, 'utf-8');
-}
-
-/**
- * Generate markdown report
- */
-function generateMarkdownReport(result: CheckLinksResult): string {
-  const lines: string[] = [];
-  
-  lines.push('# Link Check Report');
-  lines.push('');
-  lines.push(`**URL:** ${result.url}`);
-  lines.push(`**Timestamp:** ${result.timestamp}`);
-  if (result.duration) {
-    lines.push(`**Duration:** ${(result.duration / 1000).toFixed(2)}s`);
-  }
-  lines.push('');
-  lines.push(`**Status:** ${result.success ? '✅ All links valid' : '❌ Broken links found'}`);
-  lines.push(`**Total links:** ${result.total}`);
-  lines.push(`**Broken links:** ${result.broken}`);
-  lines.push('');
-
-  if (result.errors.length > 0) {
-    lines.push('## Broken Links');
-    lines.push('');
-    lines.push('| Status | URL | Reason |');
-    lines.push('|--------|-----|--------|');
-    for (const { url, status, reason } of result.errors) {
-      lines.push(`| ${status} | ${url} | ${reason || '-'} |`);
-    }
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Generate text report
- */
-function generateTextReport(result: CheckLinksResult): string {
-  const lines: string[] = [];
-  
-  lines.push('Link Check Report');
-  lines.push('='.repeat(50));
-  lines.push(`URL: ${result.url}`);
-  lines.push(`Timestamp: ${result.timestamp}`);
-  if (result.duration) {
-    lines.push(`Duration: ${(result.duration / 1000).toFixed(2)}s`);
-  }
-  lines.push('');
-  lines.push(`Status: ${result.success ? '✅ All links valid' : '❌ Broken links found'}`);
-  lines.push(`Total links: ${result.total}`);
-  lines.push(`Broken links: ${result.broken}`);
-  lines.push('');
-
-  if (result.errors.length > 0) {
-    lines.push('Broken Links:');
-    lines.push('-'.repeat(50));
-    for (const { url, status, reason } of result.errors) {
-      lines.push(`[${status}] ${url}${reason ? ` (${reason})` : ''}`);
-    }
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-// CLI interface
-if (import.meta.url === `file://${process.argv[1]}`) {
-  // Handle unhandled promise rejections and errors
-  process.on('unhandledRejection', (error) => {
-    if (error instanceof Error) {
-      if (error.message.includes('timeout') || error.message.includes('TimeoutError') || error.name === 'TimeoutError') {
-        console.warn(pc.yellow(`\n⚠️  Operation timed out. This is normal for slow or protected URLs.`));
-        process.exit(0); // Exit gracefully
-      } else {
-        console.error(pc.red(`\n❌ Unhandled error: ${error.message}`));
-        process.exit(1);
-      }
-    } else {
-      console.error(pc.red(`\n❌ Unhandled error:`), error);
-      process.exit(1);
-    }
-  });
-
-  process.on('uncaughtException', (error) => {
-    if (error.message.includes('timeout') || error.message.includes('TimeoutError') || error.name === 'TimeoutError') {
-      console.warn(pc.yellow(`\n⚠️  Operation timed out. This is normal for slow or protected URLs.`));
-      process.exit(0); // Exit gracefully
-    } else {
-      console.error(pc.red(`\n❌ Uncaught exception: ${error.message}`));
-      process.exit(1);
-    }
-  });
-
-  const args = process.argv.slice(2);
-  
-  // Interactive mode if no arguments
-  if (args.length === 0) {
-    (async () => {
-      console.log(pc.bold(pc.cyan('\n🔗 Link Checker\n')));
-      
-      const response = await prompts([
-        {
-          type: 'text',
-          name: 'url',
-          message: 'Enter URL to check:',
-          validate: (value) => value.length > 0 || 'URL is required',
-        },
-        {
-          type: 'number',
-          name: 'timeout',
-          message: 'Timeout (ms):',
-          initial: 60000,
-          min: 1000,
-        },
-        {
-          type: 'number',
-          name: 'concurrency',
-          message: 'Concurrency:',
-          initial: 50,
-          min: 1,
-          max: 200,
-        },
-        {
-          type: 'confirm',
-          name: 'verbose',
-          message: 'Verbose logging (show progress)?',
-          initial: true,
-        },
-        {
-          type: 'confirm',
-          name: 'showAll',
-          message: 'Show all links (not just broken)?',
-          initial: false,
-        },
-        {
-          type: 'text',
-          name: 'outputFile',
-          message: 'Save report to file (optional, leave empty to skip):',
-          initial: '',
-        },
-        {
-          type: (prev) => prev ? 'select' : null,
-          name: 'reportFormat',
-          message: 'Report format:',
-          choices: [
-            { title: 'Text', value: 'text' },
-            { title: 'Markdown', value: 'markdown' },
-            { title: 'JSON', value: 'json' },
-          ],
-          initial: 0,
-        },
-      ]);
-
-      if (!response.url) {
-        console.log(pc.yellow('Cancelled.'));
-        process.exit(0);
-      }
-
-      const options: CheckLinksOptions = {
-        url: response.url,
-        timeout: response.timeout,
-        concurrency: response.concurrency,
-        showOnlyBroken: !response.showAll,
-        outputFile: response.outputFile || undefined,
-        reportFormat: response.reportFormat || 'text',
-        verbose: response.verbose !== undefined ? response.verbose : true,
-      };
-
-      await checkLinks(options);
-      process.exit(0);
-    })().catch((error) => {
-      console.error(pc.red('Fatal error:'), error);
-      process.exit(1);
-    });
-  } else {
-    // Non-interactive mode with arguments
-  if (args[0] === '--help' || args[0] === '-h') {
-    console.log(pc.bold('Usage: check-links.ts <url> [options]'));
-    console.log('');
-    console.log(pc.bold('Options:'));
-    console.log(`  ${pc.cyan('--timeout <ms>')}        Timeout in milliseconds (default: 60000)`);
-    console.log(`  ${pc.cyan('--skip <pattern>')}      Regex pattern for URLs to skip`);
-    console.log(`  ${pc.cyan('--show-all')}            Show all links, not just broken ones`);
-    console.log(`  ${pc.cyan('--concurrency <num>')}   Max concurrent requests (default: 50)`);
-    console.log(`  ${pc.cyan('--output <file>')}       Save report to file`);
-    console.log(`  ${pc.cyan('--format <format>')}      Report format: json, markdown, text (default: text)`);
-    console.log(`  ${pc.cyan('--quiet, -q')}           Disable verbose logging`);
-    console.log(`  ${pc.cyan('--help, -h')}           Show this help message`);
-    console.log('');
-    console.log(pc.dim('If no arguments provided, interactive mode will start.'));
-    process.exit(0);
-  }
-
-  const url = args[0];
-  const options: CheckLinksOptions = { url };
-
-  // Parse options
-  for (let i = 1; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '--timeout' && args[i + 1]) {
-      options.timeout = parseInt(args[++i], 10);
-    } else if (arg === '--skip' && args[i + 1]) {
-      options.skipPattern = args[++i];
-    } else if (arg === '--show-all') {
-      options.showOnlyBroken = false;
-    } else if (arg === '--concurrency' && args[i + 1]) {
-      options.concurrency = parseInt(args[++i], 10);
-    } else if ((arg === '--output' || arg === '-o') && args[i + 1]) {
-      options.outputFile = args[++i];
-    } else if (arg === '--format' && args[i + 1]) {
-      const format = args[++i] as 'json' | 'markdown' | 'text';
-      if (['json', 'markdown', 'text'].includes(format)) {
-        options.reportFormat = format;
-      } else {
-        console.error(pc.red(`Invalid format: ${format}. Use: json, markdown, or text`));
-        process.exit(1);
-      }
-    } else if (arg === '--quiet' || arg === '-q') {
-      options.verbose = false;
-    }
-  }
-
-    checkLinks(options)
-      .then((result) => {
-        process.exit(result.success ? 0 : 1);
-      })
-      .catch((error) => {
-        console.error(pc.red('Fatal error:'), error);
-        process.exit(1);
-      });
-  }
-}
-

package/src/scripts/index.ts

@@ -1,6 +0,0 @@
-/**
- * Scripts and utilities for Next.js projects
- */
-
-export { checkLinks, type CheckLinksOptions } from './check-links';
-