kaddidlehopper 0.5.0 → 0.6.0

package/scripts/check-outdated-packages.js

@@ -1,421 +0,0 @@
-#!/usr/bin/env node
-
-import { readFileSync, readdirSync, statSync, writeFileSync } from 'fs'
-import { join, dirname, relative } from 'path'
-import { fileURLToPath } from 'url'
-import semver from 'semver'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-
-// Parse command line arguments
-const args = process.argv.slice(2)
-const shouldUpdate = args.includes('--update')
-
-// Colors for console output
-const colors = {
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-}
-
-/**
- * Recursively find all package.json files in a directory
- */
-function findPackageJsonFiles(dir, files = []) {
-  const items = readdirSync(dir)
-
-  for (const item of items) {
-    const fullPath = join(dir, item)
-    const stat = statSync(fullPath)
-
-    if (stat.isDirectory() && item !== 'node_modules' && item !== 'dist') {
-      findPackageJsonFiles(fullPath, files)
-    } else if (item === 'package.json') {
-      files.push(fullPath)
-    }
-  }
-
-  return files
-}
-
-// Cache for package versions to avoid duplicate API calls
-const versionCache = new Map()
-
-/**
- * Get the latest version of a package from npm with caching and timeout
- */
-async function getLatestVersion(packageName) {
-  // Check cache first
-  if (versionCache.has(packageName)) {
-    return versionCache.get(packageName)
-  }
-
-  try {
-    // Add timeout to prevent hanging
-    const controller = new AbortController()
-    const timeoutId = setTimeout(() => controller.abort(), 10000) // 10 second timeout
-
-    const response = await fetch(
-      `https://registry.npmjs.org/${packageName}/latest`,
-      {
-        signal: controller.signal,
-        headers: {
-          'User-Agent': 'netlify-cta-outdated-checker',
-        },
-      },
-    )
-
-    clearTimeout(timeoutId)
-
-    if (!response.ok) {
-      throw new Error(`HTTP ${response.status}`)
-    }
-
-    const data = await response.json()
-    const version = data.version
-
-    // Cache the result
-    versionCache.set(packageName, version)
-    return version
-  } catch (error) {
-    if (error.name === 'AbortError') {
-      console.warn(
-        `${colors.yellow}Warning: Timeout fetching latest version for ${packageName}${colors.reset}`,
-      )
-    } else {
-      console.warn(
-        `${colors.yellow}Warning: Could not fetch latest version for ${packageName}: ${error.message}${colors.reset}`,
-      )
-    }
-
-    // Cache null result to avoid retrying
-    versionCache.set(packageName, null)
-    return null
-  }
-}
-
-/**
- * Check if a version range satisfies the latest version
- */
-function isVersionRangeOutdated(versionRange, latestVersion) {
-  try {
-    // Clean the version range (remove any npm-specific prefixes)
-    const cleanRange = versionRange.replace(/^npm:/, '').split('@').pop()
-
-    // Check if the range satisfies the latest version
-    return !semver.satisfies(latestVersion, cleanRange)
-  } catch (error) {
-    console.warn(
-      `${colors.yellow}Warning: Could not parse version range "${versionRange}": ${error.message}${colors.reset}`,
-    )
-    return false
-  }
-}
-
-/**
- * Update package.json file with new versions
- */
-function updatePackageJson(filePath, outdatedPackages) {
-  try {
-    const content = readFileSync(filePath, 'utf8')
-    const packageJson = JSON.parse(content)
-
-    let updated = false
-
-    for (const pkg of outdatedPackages) {
-      // Check and update in dependencies
-      if (packageJson.dependencies && packageJson.dependencies[pkg.name]) {
-        const currentRange = packageJson.dependencies[pkg.name]
-        const newRange = updateVersionRange(currentRange, pkg.latest)
-        packageJson.dependencies[pkg.name] = newRange
-        updated = true
-      }
-
-      // Check and update in devDependencies
-      if (
-        packageJson.devDependencies &&
-        packageJson.devDependencies[pkg.name]
-      ) {
-        const currentRange = packageJson.devDependencies[pkg.name]
-        const newRange = updateVersionRange(currentRange, pkg.latest)
-        packageJson.devDependencies[pkg.name] = newRange
-        updated = true
-      }
-
-      // Check and update in peerDependencies
-      if (
-        packageJson.peerDependencies &&
-        packageJson.peerDependencies[pkg.name]
-      ) {
-        const currentRange = packageJson.peerDependencies[pkg.name]
-        const newRange = updateVersionRange(currentRange, pkg.latest)
-        packageJson.peerDependencies[pkg.name] = newRange
-        updated = true
-      }
-    }
-
-    if (updated) {
-      // Write back with proper formatting
-      writeFileSync(filePath, JSON.stringify(packageJson, null, 2) + '\n')
-      return true
-    }
-
-    return false
-  } catch (error) {
-    console.error(
-      `${colors.red}Error updating ${filePath}: ${error.message}${colors.reset}`,
-    )
-    return false
-  }
-}
-
-/**
- * Update version range while preserving the range type (^, ~, etc.)
- */
-function updateVersionRange(currentRange, latestVersion) {
-  // Preserve the prefix (^, ~, >=, etc.)
-  if (currentRange.startsWith('^')) {
-    return `^${latestVersion}`
-  } else if (currentRange.startsWith('~')) {
-    return `~${latestVersion}`
-  } else if (currentRange.startsWith('>=')) {
-    return `>=${latestVersion}`
-  } else if (currentRange.startsWith('>')) {
-    return `>${latestVersion}`
-  } else if (currentRange.startsWith('<=')) {
-    return `<=${latestVersion}`
-  } else if (currentRange.startsWith('<')) {
-    return `<${latestVersion}`
-  } else {
-    // Exact version or other format, just use the latest version
-    return latestVersion
-  }
-}
-
-/**
- * Get relative path for display
- */
-function getDisplayPath(filePath, rootDir) {
-  const relativePath = relative(rootDir, filePath)
-  // Remove the package.json part
-  return relativePath.replace('/package.json', '')
-}
-
-/**
- * Check dependencies in a package.json file
- */
-async function checkPackageJson(filePath) {
-  try {
-    const content = readFileSync(filePath, 'utf8')
-    const packageJson = JSON.parse(content)
-
-    const outdatedPackages = []
-    const allDependencies = {
-      ...packageJson.dependencies,
-      ...packageJson.devDependencies,
-      ...packageJson.peerDependencies,
-    }
-
-    if (Object.keys(allDependencies).length === 0) {
-      return { filePath, outdatedPackages: [], totalDependencies: 0 }
-    }
-
-    const packageNames = Object.keys(allDependencies).filter((name) => {
-      const versionRange = allDependencies[name]
-      // Skip workspace dependencies and local packages
-      return !(
-        versionRange.startsWith('workspace:') ||
-        versionRange.startsWith('file:') ||
-        versionRange.startsWith('link:')
-      )
-    })
-
-    // Process packages in batches to avoid overwhelming the API
-    const batchSize = 5
-    for (let i = 0; i < packageNames.length; i += batchSize) {
-      const batch = packageNames.slice(i, i + batchSize)
-
-      // Process batch in parallel
-      const promises = batch.map(async (packageName) => {
-        const versionRange = allDependencies[packageName]
-        const latestVersion = await getLatestVersion(packageName)
-
-        if (!latestVersion) {
-          return null
-        }
-
-        if (isVersionRangeOutdated(versionRange, latestVersion)) {
-          return {
-            name: packageName,
-            current: versionRange,
-            latest: latestVersion,
-          }
-        }
-
-        return null
-      })
-
-      const results = await Promise.all(promises)
-      outdatedPackages.push(...results.filter(Boolean))
-
-      // Small delay between batches
-      if (i + batchSize < packageNames.length) {
-        await new Promise((resolve) => setTimeout(resolve, 50))
-      }
-    }
-
-    return {
-      filePath,
-      outdatedPackages,
-      totalDependencies: Object.keys(allDependencies).length,
-    }
-  } catch (error) {
-    console.error(
-      `${colors.red}Error processing ${filePath}: ${error.message}${colors.reset}`,
-    )
-    return {
-      filePath,
-      outdatedPackages: [],
-      totalDependencies: 0,
-      error: error.message,
-    }
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  const actionText = shouldUpdate ? 'Updating' : 'Checking for'
-  console.log(
-    `${colors.bold}${colors.blue}${actionText} outdated packages in netlify-cta...${colors.reset}\n`,
-  )
-
-  const rootDir = join(__dirname, '..')
-
-  // Directories to scan for package.json files
-  const dirsToScan = [
-    join(rootDir, 'add-ons'),
-    join(rootDir, 'examples'),
-    join(rootDir, 'project'),
-  ]
-
-  // Collect all package.json files from all directories
-  const packageJsonFiles = []
-  for (const dir of dirsToScan) {
-    try {
-      const files = findPackageJsonFiles(dir)
-      packageJsonFiles.push(...files)
-      console.log(
-        `${colors.blue}Found ${files.length} package.json files in ${relative(rootDir, dir)}${colors.reset}`,
-      )
-    } catch (error) {
-      console.warn(
-        `${colors.yellow}Warning: Could not scan ${dir}: ${error.message}${colors.reset}`,
-      )
-    }
-  }
-
-  console.log(`\nTotal: ${packageJsonFiles.length} package.json files\n`)
-
-  let totalOutdated = 0
-  let totalChecked = 0
-  let totalUpdated = 0
-  const results = []
-
-  for (let i = 0; i < packageJsonFiles.length; i++) {
-    const filePath = packageJsonFiles[i]
-    const displayPath = getDisplayPath(filePath, rootDir)
-
-    // Show progress
-    process.stdout.write(
-      `\r${colors.blue}Processing ${i + 1}/${packageJsonFiles.length}: ${displayPath}...${colors.reset}`,
-    )
-
-    const result = await checkPackageJson(filePath)
-    results.push(result)
-
-    if (result.error) {
-      console.log(`\n${colors.red}Error: ${result.error}${colors.reset}`)
-      continue
-    }
-
-    totalChecked += result.totalDependencies
-    totalOutdated += result.outdatedPackages.length
-
-    if (result.outdatedPackages.length > 0) {
-      console.log(
-        `\n${colors.red}${colors.bold}Found ${result.outdatedPackages.length} outdated packages in ${displayPath}:${colors.reset}`,
-      )
-      for (const pkg of result.outdatedPackages) {
-        console.log(
-          `  ${colors.red}${pkg.name}${colors.reset}: ${pkg.current} → ${colors.green}${pkg.latest}${colors.reset}`,
-        )
-      }
-
-      if (shouldUpdate) {
-        const updated = updatePackageJson(filePath, result.outdatedPackages)
-        if (updated) {
-          totalUpdated++
-          console.log(
-            `  ${colors.green}✓ Updated ${displayPath}${colors.reset}`,
-          )
-        } else {
-          console.log(
-            `  ${colors.yellow}⚠ Failed to update ${displayPath}${colors.reset}`,
-          )
-        }
-      }
-
-      console.log()
-    }
-  }
-
-  // Clear progress line and add spacing
-  console.log('\n')
-
-  // Summary
-  console.log(`${colors.bold}${colors.blue}Summary:${colors.reset}`)
-  console.log(`Total dependencies checked: ${totalChecked}`)
-  console.log(
-    `Total outdated packages: ${colors.red}${totalOutdated}${colors.reset}`,
-  )
-
-  if (shouldUpdate) {
-    console.log(
-      `Total files updated: ${colors.green}${totalUpdated}${colors.reset}`,
-    )
-  }
-
-  if (totalOutdated === 0) {
-    console.log(
-      `${colors.green}${colors.bold}🎉 All packages are up to date!${colors.reset}`,
-    )
-  } else if (shouldUpdate && totalUpdated > 0) {
-    console.log(
-      `${colors.green}${colors.bold}✅ Successfully updated ${totalUpdated} files with outdated packages!${colors.reset}`,
-    )
-  } else if (shouldUpdate && totalUpdated === 0) {
-    console.log(
-      `${colors.yellow}${colors.bold}⚠️  No files were updated. Check for errors above.${colors.reset}`,
-    )
-  } else {
-    console.log(
-      `${colors.yellow}${colors.bold}⚠️  Found outdated packages that need attention. Use --update to update them.${colors.reset}`,
-    )
-  }
-
-  // Exit with error code if outdated packages found and not updating
-  process.exit(totalOutdated > 0 && !shouldUpdate ? 1 : 0)
-}
-
-main().catch((error) => {
-  console.error(
-    `${colors.red}${colors.bold}Fatal error: ${error.message}${colors.reset}`,
-  )
-  process.exit(1)
-})

package/src/agents-md.ts

@@ -1,139 +0,0 @@
-import { dirname, join, relative } from 'node:path'
-import { readdir, readFile, writeFile } from 'node:fs/promises'
-import { fileURLToPath } from 'node:url'
-
-const PLACEHOLDER = '[[[DIRECTORY STRUCTURE]]]'
-
-const IGNORED_DIRS = new Set([
-  'node_modules',
-  '.git',
-  'dist',
-  'dist-ssr',
-  '.netlify',
-  '.tanstack',
-  '.DS_Store',
-])
-
-type FileDescriptions = Record<string, string>
-
-function buildDescriptionLookup(descriptions: FileDescriptions): Map<string, string> {
-  const lookup = new Map<string, string>()
-  for (const [key, desc] of Object.entries(descriptions)) {
-    const normalizedKey = key.replace(/\\/g, '/')
-    lookup.set(normalizedKey, desc)
-    if (normalizedKey.endsWith('.ejs')) {
-      lookup.set(normalizedKey.slice(0, -4), desc)
-    }
-    if (normalizedKey.startsWith('_dot_')) {
-      lookup.set('.' + normalizedKey.slice(5), desc)
-    }
-  }
-  return lookup
-}
-
-async function loadFileDescriptions(
-  addOnDescriptions?: Array<{ packageFileDescriptions?: FileDescriptions }>,
-): Promise<Map<string, string>> {
-  const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
-  const infoPath = join(packageRoot, 'project', 'info.json')
-  const lookup = new Map<string, string>()
-
-  try {
-    const info = await readFile(infoPath, 'utf-8')
-    const { packageFileDescriptions } = JSON.parse(info) as {
-      packageFileDescriptions?: FileDescriptions
-    }
-    if (packageFileDescriptions) {
-      for (const [key, desc] of buildDescriptionLookup(
-        packageFileDescriptions,
-      )) {
-        lookup.set(key, desc)
-      }
-    }
-  } catch {
-    // No info.json or invalid, continue
-  }
-
-  if (addOnDescriptions) {
-    for (const addOn of addOnDescriptions) {
-      if (addOn.packageFileDescriptions) {
-        for (const [key, desc] of buildDescriptionLookup(
-          addOn.packageFileDescriptions,
-        )) {
-          lookup.set(key, desc)
-        }
-      }
-    }
-  }
-
-  return lookup
-}
-
-async function buildFileTree(
-  dirPath: string,
-  rootPath: string,
-  descriptions: Map<string, string>,
-  prefix = '',
-): Promise<string[]> {
-  const entries = await readdir(dirPath, { withFileTypes: true })
-  const filtered = entries
-    .filter((e) => !e.name.startsWith('.') || e.name === '.gitignore')
-    .filter((e) => !IGNORED_DIRS.has(e.name))
-    .sort((a, b) => {
-      // Directories first, then files; alphabetically within each
-      if (a.isDirectory() !== b.isDirectory()) {
-        return a.isDirectory() ? -1 : 1
-      }
-      return a.name.localeCompare(b.name, undefined, { sensitivity: 'base' })
-    })
-
-  const lines: string[] = []
-  for (let i = 0; i < filtered.length; i++) {
-    const entry = filtered[i]
-    const isLastEntry = i === filtered.length - 1
-    const connector = isLastEntry ? '└── ' : '├── '
-    const fullPath = join(dirPath, entry.name)
-    const relPath = relative(rootPath, fullPath).replace(/\\/g, '/')
-    const description = descriptions.get(relPath)
-    const suffix = description ? `  # ${description}` : ''
-    lines.push(`${prefix}${connector}${entry.name}${suffix}`)
-
-    if (entry.isDirectory()) {
-      const childPrefix = prefix + (isLastEntry ? '    ' : '│   ')
-      const childLines = await buildFileTree(
-        join(dirPath, entry.name),
-        rootPath,
-        descriptions,
-        childPrefix,
-      )
-      lines.push(...childLines)
-    }
-  }
-  return lines
-}
-
-export async function generateAgentsMd(
-  targetDir: string,
-  _projectName: string,
-  chosenAddOns?: Array<{ packageFileDescriptions?: FileDescriptions }>,
-): Promise<void> {
-  const agentsMdPath = join(targetDir, 'AGENTS.md')
-  let content: string
-  try {
-    content = await readFile(agentsMdPath, 'utf-8')
-  } catch {
-    // No AGENTS.md template, skip
-    return
-  }
-
-  if (!content.includes(PLACEHOLDER)) {
-    return
-  }
-
-  const descriptions = await loadFileDescriptions(chosenAddOns)
-  const treeLines = await buildFileTree(targetDir, targetDir, descriptions)
-  const tree = treeLines.length > 0 ? treeLines.join('\n') : '(empty)'
-
-  const updatedContent = content.replace(PLACEHOLDER, tree)
-  await writeFile(agentsMdPath, updatedContent, 'utf-8')
-}