create-specra 0.1.7 → 0.2.0

package/templates/minimal/proxy_.ts

@@ -1,22 +0,0 @@
-import { createSecurityProxy } from "specra/middleware/security"
-
-// Note: Redirects from frontmatter are handled at build time via next.config.js
-// This proxy handles runtime security headers, path validation, and dynamic logic
-
-export const proxy = createSecurityProxy({
-  production: process.env.NODE_ENV === "production",
-  strictPathValidation: true,
-})
-
-export const config = {
-  matcher: [
-    /*
-     * Match all request paths except for the ones starting with:
-     * - api (API routes)
-     * - _next/static (static files)
-     * - _next/image (image optimization files)
-     * - favicon.ico (favicon file)
-     */
-    "/((?!api|_next/static|_next/image|favicon.ico).*)",
-  ],
-}

package/templates/minimal/scripts/generate-redirects.mjs

@@ -1,128 +0,0 @@
-import fs from "fs"
-import path from "path"
-import matter from "gray-matter"
-import { fileURLToPath } from "url"
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
-
-const DOCS_DIR = path.join(__dirname, "..", "docs")
-
-/**
- * Recursively find all MDX files
- */
-function findMdxFiles(dir, baseDir = dir) {
-  const files = []
-
-  try {
-    const entries = fs.readdirSync(dir, { withFileTypes: true })
-
-    for (const entry of entries) {
-      const fullPath = path.join(dir, entry.name)
-
-      if (entry.isDirectory()) {
-        files.push(...findMdxFiles(fullPath, baseDir))
-      } else if (entry.isFile() && entry.name.endsWith(".mdx")) {
-        const relativePath = path.relative(baseDir, fullPath)
-        files.push(relativePath)
-      }
-    }
-  } catch (error) {
-    console.error(`Error reading directory ${dir}:`, error)
-  }
-
-  return files
-}
-
-/**
- * Get all folders (categories) that need redirect pages
- */
-function getFolderRedirects(mdxFiles, version) {
-  const folders = new Map() // folder path -> first doc in folder
-
-  for (const file of mdxFiles) {
-    const normalized = file.replace(/\\/g, '/')
-    const parts = normalized.split('/')
-
-    // For each level of nesting, track the folder
-    for (let i = 0; i < parts.length - 1; i++) {
-      const folderPath = parts.slice(0, i + 1).join('/')
-
-      if (!folders.has(folderPath)) {
-        // This is the first doc we've seen in this folder
-        const docSlug = normalized.replace(/\.mdx$/, '').replace(/\/index$/, '')
-        folders.set(folderPath, `/docs/${version}/${docSlug}`)
-      }
-    }
-  }
-
-  return folders
-}
-
-/**
- * Build redirect mappings from frontmatter
- */
-async function buildRedirects() {
-  const versions = fs.readdirSync(DOCS_DIR).filter((v) => {
-    const stat = fs.statSync(path.join(DOCS_DIR, v))
-    return stat.isDirectory()
-  })
-
-  const redirects = []
-  const folderRedirects = []
-
-  for (const version of versions) {
-    const versionDir = path.join(DOCS_DIR, version)
-    const mdxFiles = findMdxFiles(versionDir)
-
-    // Build folder redirects for static export
-    const folders = getFolderRedirects(mdxFiles, version)
-    for (const [folderPath, destination] of folders.entries()) {
-      const source = `/docs/${version}/${folderPath}`
-      folderRedirects.push({
-        source,
-        destination,
-        permanent: false, // Temporary redirect for folder access
-      })
-    }
-
-    for (const file of mdxFiles) {
-      const filePath = path.join(versionDir, file)
-      const fileContents = fs.readFileSync(filePath, "utf8")
-      const { data } = matter(fileContents)
-
-      if (data.redirect_from && Array.isArray(data.redirect_from)) {
-        const slug = file.replace(/\.mdx$/, "").replace(/\\/g, '/')
-        const destination = `/docs/${version}/${slug}`
-
-        for (const source of data.redirect_from) {
-          redirects.push({
-            source,
-            destination,
-            permanent: true,
-          })
-        }
-      }
-    }
-  }
-
-  return { redirects, folderRedirects }
-}
-
-/**
- * Generate redirects and write to a JSON file
- */
-async function main() {
-  const { redirects, folderRedirects } = await buildRedirects()
-
-  const allRedirects = [...redirects, ...folderRedirects]
-
-  const outputPath = path.join(__dirname, "..", "redirects.json")
-  fs.writeFileSync(outputPath, JSON.stringify(allRedirects, null, 2))
-
-  console.log(`✅ Generated ${redirects.length} frontmatter redirects`)
-  console.log(`✅ Generated ${folderRedirects.length} folder redirects`)
-  console.log(`📝 Saved to: ${outputPath}`)
-}
-
-main().catch(console.error)

package/templates/minimal/scripts/generate-static-redirects.mjs

@@ -1,115 +0,0 @@
-import fs from "fs"
-import path from "path"
-import { fileURLToPath } from "url"
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
-
-/**
- * Generate an HTML redirect page
- */
-function generateRedirectHTML(destination, basePath = "") {
-  const fullDestination = basePath + destination
-
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <meta http-equiv="refresh" content="0;url=${fullDestination}">
-  <link rel="canonical" href="${fullDestination}">
-  <title>Redirecting...</title>
-  <script>
-    window.location.href = "${fullDestination}";
-  </script>
-</head>
-<body>
-  <p>Redirecting to <a href="${fullDestination}">${fullDestination}</a>...</p>
-</body>
-</html>`
-}
-
-/**
- * Create redirect HTML files in the out directory
- */
-async function createStaticRedirects() {
-  const outDir = path.join(__dirname, "..", "out")
-  const redirectsPath = path.join(__dirname, "..", "redirects.json")
-
-  // Load basePath from specra.config.json
-  let basePath = ""
-  try {
-    const configPath = path.join(__dirname, "..", "specra.config.json")
-    if (fs.existsSync(configPath)) {
-      const config = JSON.parse(fs.readFileSync(configPath, "utf8"))
-      const deployment = config.deployment || {}
-
-      // Only apply basePath for GitHub Pages without custom domain
-      if (deployment.target === "github-pages" && !deployment.customDomain && deployment.basePath) {
-        basePath = deployment.basePath.startsWith("/")
-          ? deployment.basePath
-          : `/${deployment.basePath}`
-      }
-    }
-  } catch (error) {
-    console.warn("Could not load deployment config:", error.message)
-  }
-
-  // Check if out directory exists
-  if (!fs.existsSync(outDir)) {
-    console.warn("⚠️  Output directory 'out' not found. Run 'npm run build:export' first.")
-    return
-  }
-
-  // Load redirects
-  let redirects = []
-  try {
-    if (fs.existsSync(redirectsPath)) {
-      redirects = JSON.parse(fs.readFileSync(redirectsPath, "utf8"))
-    }
-  } catch (error) {
-    console.error("Could not load redirects.json:", error.message)
-    return
-  }
-
-  let created = 0
-
-  for (const redirect of redirects) {
-    const { source, destination } = redirect
-
-    // Remove basePath from source if present (for file system path)
-    let sourcePath = source
-    if (basePath && sourcePath.startsWith(basePath)) {
-      sourcePath = sourcePath.substring(basePath.length)
-    }
-
-    // Ensure source starts with /
-    if (!sourcePath.startsWith('/')) {
-      sourcePath = '/' + sourcePath
-    }
-
-    // Convert URL path to file system path
-    const targetDir = path.join(outDir, sourcePath.substring(1))
-    const indexPath = path.join(targetDir, "index.html")
-
-    // Create directory if it doesn't exist
-    if (!fs.existsSync(targetDir)) {
-      fs.mkdirSync(targetDir, { recursive: true })
-    }
-
-    // Don't overwrite if index.html already exists (real content page)
-    if (!fs.existsSync(indexPath)) {
-      // Generate and write redirect HTML
-      const html = generateRedirectHTML(destination, basePath)
-      fs.writeFileSync(indexPath, html)
-      created++
-    }
-  }
-
-  console.log(`✅ Created ${created} static redirect HTML files`)
-  if (basePath) {
-    console.log(`🔗 Using basePath: ${basePath}`)
-  }
-}
-
-createStaticRedirects().catch(console.error)

package/templates/minimal/scripts/index-search.ts

@@ -1,182 +0,0 @@
-import { MeiliSearch } from "meilisearch"
-import fs from "fs"
-import path from "path"
-import matter from "gray-matter"
-import { extractSearchText, getConfig, initConfig } from "specra"
-import specraConfig from "../specra.config.json"
-// import { extractSearchText } from "specra/components"
-// import { extractSearchText } from "@/components/docs/componentTextProps"
-
-interface SearchDocument {
-    id: string
-    title: string
-    content: string
-    slug: string
-    version: string
-    category?: string
-    tags?: string[]
-    tab_group?: string
-}
-
-
-async function indexDocuments() {
-    initConfig(specraConfig as any)
-    const config = getConfig()
-    console.log(config)
-    const searchConfig = config.search
-
-    if (!searchConfig?.enabled || searchConfig.provider !== "meilisearch") {
-        console.error("Meilisearch is not enabled in config")
-        process.exit(1)
-    }
-
-    const meilisearchConfig = searchConfig.meilisearch
-    if (!meilisearchConfig) {
-        console.error("Meilisearch configuration is missing")
-        process.exit(1)
-    }
-
-    console.log("Connecting to Meilisearch at:", meilisearchConfig.host)
-
-    const client = new MeiliSearch({
-        host: meilisearchConfig.host,
-        apiKey: meilisearchConfig.apiKey || "",
-    })
-
-    const index = client.index(meilisearchConfig.indexName)
-
-    // Get all MDX files
-    const docsDir = path.join(process.cwd(), "docs")
-    const documents: SearchDocument[] = []
-
-    function processDirectory(dir: string, version: string) {
-        const files = fs.readdirSync(dir)
-
-        for (const file of files) {
-            const filePath = path.join(dir, file)
-            const stat = fs.statSync(filePath)
-
-            if (stat.isDirectory()) {
-                processDirectory(filePath, version)
-            } else if (file.endsWith(".mdx") || file.endsWith(".md")) {
-                const content = fs.readFileSync(filePath, "utf-8")
-                const { data, content: mdxContent } = matter(content)
-
-                // Generate slug from file path
-                const relativePath = path.relative(path.join(docsDir, version), filePath)
-                const slug = relativePath
-                    .replace(/\.(mdx|md)$/, "")
-                    .replace(/\\/g, "/")
-
-                // Extract category from path
-                const pathParts = slug.split("/")
-                const category = pathParts.length > 1 ? pathParts[0] : undefined
-
-                // Get tab_group from frontmatter or from parent _category_.json
-                let tabGroup = data.tab_group
-
-                // If not in frontmatter, check parent directory's _category_.json
-                if (!tabGroup && pathParts.length > 1) {
-                    const folderPath = pathParts.slice(0, -1).join("/")
-                    const categoryPath = path.join(docsDir, version, folderPath, "_category_.json")
-
-                    if (fs.existsSync(categoryPath)) {
-                        try {
-                            const categoryData = JSON.parse(fs.readFileSync(categoryPath, "utf-8"))
-                            tabGroup = categoryData.tab_group
-                        } catch (e) {
-                            // Ignore JSON parse errors
-                        }
-                    }
-                }
-
-                // Clean content (remove code blocks and special chars for better search)
-                // const cleanContent = mdxContent
-                //     .replace(/```[\s\S]*?```/g, "") // Remove code blocks
-                //     .replace(/`[^`]+`/g, "") // Remove inline code
-                //     .replace(/[#*_~]/g, "") // Remove markdown symbols
-                //     .replace(/\n+/g, " ") // Replace newlines with spaces
-                //     .trim()
-                //     .slice(0, 1000) // Limit content length
-
-                const cleanContent = extractSearchText(mdxContent);
-
-                // console.log("------");
-                // console.log("Cleaned content: ");
-                // console.log(cleanContent);
-                // console.log("------");
-                // Create a valid document ID (replace periods with underscores)
-                // const docId = `${version.replace(/\./g, "_")}-${slug.replace(/\//g, "-")}`
-                const docId = slug.replace(/\//g, "-")
-
-                documents.push({
-                    id: docId,
-                    title: data.title || slug,
-                    content: cleanContent,
-                    slug: slug,
-                    version: version,
-                    category: category,
-                    tags: data.tags || [],
-                    tab_group: tabGroup,
-                })
-            }
-        }
-    }
-
-    // Process all version directories
-    const versions = fs.readdirSync(docsDir).filter((item) => {
-        const itemPath = path.join(docsDir, item)
-        return fs.statSync(itemPath).isDirectory()
-    })
-
-    console.log(`Found ${versions.length} version(s):`, versions.join(", "))
-
-    for (const version of versions) {
-        const versionPath = path.join(docsDir, version)
-        processDirectory(versionPath, version)
-    }
-
-    console.log(`Indexing ${documents.length} documents...`)
-
-    try {
-        // Configure searchable attributes first
-        console.log("Configuring search settings...")
-        await index.updateSearchableAttributes(["title", "content", "tags"])
-        await index.updateFilterableAttributes(["version", "category", "tags"])
-        await index.updateSortableAttributes(["title"])
-        await index.updateDistinctAttribute("id")
-        await index.updateSettings({
-            rankingRules: [
-                "words",
-                "typo",
-                "proximity",
-                "attribute",
-                "sort",
-                "exactness"
-            ]
-        })
-        console.log("✅ Search configuration updated!")
-
-        // Delete existing documents
-        console.log("Clearing old documents...")
-        const deleteTask = await index.deleteAllDocuments()
-        console.log("Delete task created:", deleteTask.taskUid)
-
-        // Add new documents
-        console.log("Adding documents...")
-        const addTask = await index.addDocuments(documents, { primaryKey: "id" })
-        console.log("Add task created:", addTask.taskUid)
-        console.log("✅ Documents sent for indexing!")
-
-        console.log("\n⏳ Indexing is processing in the background...")
-        console.log("Wait a few seconds, then run 'npm run test:search' to verify!")
-    } catch (error) {
-        console.error("Error indexing documents:", error)
-        if (error instanceof Error) {
-            console.error("Error message:", error.message)
-        }
-        process.exit(1)
-    }
-}
-
-indexDocuments()

package/templates/minimal/scripts/test-search.ts

@@ -1,83 +0,0 @@
-import { MeiliSearch } from "meilisearch"
-import { getConfig } from "specra"
-
-async function testSearch() {
-    const config = getConfig()
-    const searchConfig = config.search
-
-    if (!searchConfig?.enabled || searchConfig.provider !== "meilisearch") {
-        console.error("Meilisearch is not enabled in config")
-        process.exit(1)
-    }
-
-    const meilisearchConfig = searchConfig.meilisearch
-    if (!meilisearchConfig) {
-        console.error("Meilisearch configuration is missing")
-        process.exit(1)
-    }
-
-    console.log("Connecting to Meilisearch at:", meilisearchConfig.host)
-    console.log("Using API Key:", meilisearchConfig.apiKey ? "Yes" : "No")
-
-    const client = new MeiliSearch({
-        host: meilisearchConfig.host,
-        apiKey: meilisearchConfig.apiKey || "",
-    })
-
-    const index = client.index(meilisearchConfig.indexName)
-
-    try {
-        // Get index stats
-        console.log("\n📊 Index Stats:")
-        const stats = await index.getStats()
-        console.log("- Number of documents:", stats.numberOfDocuments)
-        console.log("- Is indexing:", stats.isIndexing)
-        console.log("- Field distribution:", JSON.stringify(stats.fieldDistribution, null, 2))
-
-        // Get some documents
-        console.log("\n📄 Sample Documents:")
-        const documents = await index.getDocuments({ limit: 3 })
-        console.log("Total documents:", documents.results.length)
-        documents.results.forEach((doc: any, i: number) => {
-            console.log(`\nDocument ${i + 1}:`)
-            console.log("- ID:", doc.id)
-            console.log("- Title:", doc.title)
-            console.log("- Version:", doc.version)
-            console.log("- Slug:", doc.slug)
-            console.log("- Category:", doc.category)
-            console.log("- Content preview:", doc.content?.substring(0, 100) + "...")
-        })
-
-        // Test search
-        console.log("\n🔍 Testing Search:")
-        const searchQueries = ["documentation", "getting", "guide", "intro"]
-        
-        for (const query of searchQueries) {
-            const results = await index.search(query, {
-                limit: 5,
-            })
-            console.log(`\nQuery: "${query}"`)
-            console.log(`- Results found: ${results.hits.length}`)
-            console.log(`- Processing time: ${results.processingTimeMs}ms`)
-            if (results.hits.length > 0) {
-                console.log("- First result:", (results.hits[0] as any).title)
-            }
-        }
-
-        // Get searchable attributes
-        console.log("\n⚙️  Index Settings:")
-        const searchableAttrs = await index.getSearchableAttributes()
-        console.log("- Searchable attributes:", searchableAttrs)
-        
-        const filterableAttrs = await index.getFilterableAttributes()
-        console.log("- Filterable attributes:", filterableAttrs)
-
-    } catch (error) {
-        console.error("\n❌ Error:", error)
-        if (error instanceof Error) {
-            console.error("Message:", error.message)
-        }
-    }
-}
-
-testSearch()