@tscircuit/fake-snippets 0.0.105 → 0.0.107

package/CLAUDE.md

@@ -0,0 +1,92 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+tscircuit.com is a React-based web application for creating, sharing, and managing electronic circuit designs using TypeScript and React. It features a circuit editor, package management system, AI-assisted design tools, and visualization of PCB layouts and 3D models.
+
+## Development Commands
+
+- `bun run dev` - Start development server (builds fake API and runs on localhost:5173)
+- `bun run build` - Full production build (generates images, sitemap, builds fake API, compiles TypeScript, and builds with Vite)
+- `bun run typecheck` - Run TypeScript type checking without emitting files
+- `bun run format` - Format code using Biome
+- `bun run lint` - Check code formatting with Biome
+- `bun run playwright` - Run Playwright end-to-end tests
+- `bun run playwright:update` - Update Playwright test snapshots
+- `bun run snapshot` - Interactive snapshot updating tool (prompts for specific test file)
+
+### Fake API Development
+- `bun run build:fake-api` - Build the complete fake API (TypeScript compilation, bundle generation, schema building)
+- `bun run dev:registry` - Run dev server using registry API at localhost:3100
+
+## Architecture
+
+### Frontend Structure
+- **React SPA** with Vite bundler, using Wouter for routing and lazy-loaded pages
+- **State Management**: Zustand for global state, React Query for server state
+- **UI Framework**: Tailwind CSS with Radix UI components and custom shadcn/ui components
+- **Code Editor**: CodeMirror 6 with TypeScript support and AI completion
+
+### API Architecture
+- **Fake API**: Development API built with Winterspec, providing full backend simulation
+- **Database Schema**: Zod-validated schemas for packages, builds, releases, snippets, accounts, orders
+- **Authentication**: Session-based auth with GitHub integration
+
+### Key Domains
+- **Packages**: Reusable circuit components with versioning and releases
+- **Package Builds**: Compilation artifacts with build status and logs  
+- **Package Releases**: Published versions with metadata and assets
+- **Snippets**: Legacy circuit designs (being migrated to packages)
+- **Circuit JSON**: Standard format for circuit data interchange
+
+### File Organization
+- `src/components/` - Reusable UI components
+- `src/pages/` - Route-based page components  
+- `src/hooks/` - Custom React hooks for data fetching and state
+- `src/lib/` - Utilities, constants, and helper functions
+- `fake-snippets-api/` - Mock API implementation with Winterspec
+- `playwright-tests/` - End-to-end tests with visual regression snapshots
+
+## Testing Strategy
+
+Uses Playwright for end-to-end testing with visual regression snapshots. Tests cover critical user flows including editor functionality, package management, authentication, and responsive design across viewport sizes.
+
+## Key Technical Patterns
+
+### Data Fetching
+- React Query for server state with custom hooks (use-package-*, use-snippet-*, etc.)
+- Fake API provides development backend with realistic data simulation
+- SSR support via Vercel for SEO and performance
+
+### Circuit Visualization  
+- Multiple viewers: PCB viewer, schematic viewer, 3D viewer, assembly viewer
+- SVG-based rendering with interactive controls
+- Real-time preview updates during code editing
+
+### Code Compilation
+- TypeScript compilation in browser using Monaco/TypeScript compiler API
+- Circuit JSON generation from TypeScript code
+- Error handling and display for compilation issues
+
+### Package Management
+- Package files with hierarchical structure
+- Build artifacts and release management
+- GitHub integration for repository linking
+
+## Environment Variables
+
+Development AI testing requires:
+```bash
+VITE_USE_DIRECT_AI_REQUESTS=true
+VITE_ANTHROPIC_API_KEY=<your-key-here>
+```
+
+## Build Tools
+
+- **Bundler**: Vite with React plugin and image optimization
+- **TypeScript**: Strict mode with path aliases (@/* → src/*)
+- **Styling**: Tailwind CSS with custom design tokens
+- **Code Quality**: Biome for formatting and linting
+- **Package Manager**: Bun for fast installs and script execution

package/api/generated-index.js

@@ -31,7 +31,7 @@ const PREFETCHABLE_PAGES = new Set([
   "latest",
   "settings",
   "quickstart",
-  "view-connected-repo",
+  "releases",
 ])
 
 const pageDescriptions = {
@@ -51,8 +51,7 @@ const pageDescriptions = {
     "Get started quickly with tscircuit. Create new circuit packages, import components from JLCPCB, or start from templates to begin your electronic design journey.",
   settings:
     "Manage your tscircuit account settings, shipping information, and preferences for electronic design and PCB ordering.",
-  "view-connected-repo":
-    "View and manage your connected repositories. Monitor repository status, access build information, and configure build options.",
+  releases: "View all package releases, access build information.",
 }
 
 function getPageDescription(pageName) {
@@ -185,7 +184,7 @@ async function handleCustomPackageHtml(req, res) {
     throw new Error("Datasheet route")
   }
   if (author === "build" || unscopedPackageName === "view-connected-repo") {
-    throw new Error("Deployment route - not a package")
+    throw new Error("Build  route - not a package")
   }
 
   const packageNotFoundHtml = getHtmlWithModifiedSeoTags({

package/bun-tests/fake-snippets-api/routes/package_builds/get.test.ts

@@ -0,0 +1,294 @@
+import { getTestServer } from "bun-tests/fake-snippets-api/fixtures/get-test-server"
+import { test, expect } from "bun:test"
+import defaultAxios from "redaxios"
+
+export const createTestPackage = async (axios: typeof defaultAxios) => {
+  const packageRes = await axios.post("/api/packages/create", {
+    json: {
+      name: "test-package",
+      description: "Test package for builds",
+    },
+  })
+  return packageRes.data
+}
+
+export const createTestPackageRelease = async (
+  axios: typeof defaultAxios,
+  packageId: string,
+) => {
+  const releaseRes = await axios.post("/api/package_releases/create", {
+    package_id: packageId,
+    version: "1.0.0",
+    is_latest: true,
+  })
+  return releaseRes.data
+}
+
+test("GET /api/package_builds/get - requires package_build_id 69", async () => {
+  const { jane_axios } = await getTestServer()
+  const res = await jane_axios.get("/api/package_builds/get", {
+    validateStatus: () => true,
+  })
+  expect(res.status).toBe(400)
+})
+
+test("GET /api/package_builds/get - returns 404 for non-existent package build", async () => {
+  const { jane_axios } = await getTestServer()
+  const res = await jane_axios.get(
+    "/api/package_builds/get?package_build_id=non-existent-build",
+    { validateStatus: () => true },
+  )
+  expect(res.status).toBe(404)
+  expect(res.data.error.error_code).toBe("package_build_not_found")
+  expect(res.data.error.message).toBe("Package build not found")
+})
+
+test("GET /api/package_builds/get - returns 403 for unauthorized package build access", async () => {
+  const { jane_axios, axios, db } = await getTestServer()
+  const packageData = await createTestPackage(jane_axios)
+  const { package_release } = await createTestPackageRelease(
+    jane_axios,
+    packageData.package.package_id,
+  )
+
+  const packageBuild = db.addPackageBuild({
+    package_release_id: package_release.package_release_id,
+    created_at: new Date().toISOString(),
+    transpilation_in_progress: false,
+    transpilation_started_at: new Date().toISOString(),
+    transpilation_completed_at: new Date().toISOString(),
+    transpilation_logs: [],
+    transpilation_error: null,
+    circuit_json_build_in_progress: false,
+    circuit_json_build_started_at: new Date().toISOString(),
+    circuit_json_build_completed_at: new Date().toISOString(),
+    circuit_json_build_logs: [],
+    circuit_json_build_error: null,
+    build_in_progress: false,
+    build_started_at: new Date().toISOString(),
+    build_completed_at: new Date().toISOString(),
+    build_error: null,
+    build_error_last_updated_at: new Date().toISOString(),
+    build_logs: null,
+    preview_url: "https://preview.tscircuit.com/pb_test",
+    branch_name: "main",
+    commit_message: "Test build",
+    commit_author: "jane.doe",
+  })
+
+  const res = await axios.get(
+    `/api/package_builds/get?package_build_id=${packageBuild.package_build_id}`,
+    { validateStatus: () => true },
+  )
+  expect(res.status).toBe(403)
+  expect(res.data.error.error_code).toBe("unauthorized")
+})
+
+test("GET /api/package_builds/get - successfully returns package build with logs", async () => {
+  const { axios, db } = await getTestServer()
+  const { package: pkg } = await createTestPackage(axios)
+  const { package_release } = await createTestPackageRelease(
+    axios,
+    pkg.package_id,
+  )
+
+  const buildLogs = ["Started build", "Building components", "Build completed"]
+  const transpilationLogs = ["Transpiling files", "Transpilation done"]
+  const circuitJsonBuildLogs = ["Generating circuit JSON", "Circuit JSON ready"]
+
+  const packageBuild = db.addPackageBuild({
+    package_release_id: package_release.package_release_id,
+    created_at: new Date(Date.now() - 1000 * 60 * 30).toISOString(),
+    transpilation_in_progress: false,
+    transpilation_started_at: new Date(
+      Date.now() - 1000 * 60 * 35,
+    ).toISOString(),
+    transpilation_completed_at: new Date(
+      Date.now() - 1000 * 60 * 32,
+    ).toISOString(),
+    transpilation_logs: transpilationLogs,
+    transpilation_error: null,
+    circuit_json_build_in_progress: false,
+    circuit_json_build_started_at: new Date(
+      Date.now() - 1000 * 60 * 32,
+    ).toISOString(),
+    circuit_json_build_completed_at: new Date(
+      Date.now() - 1000 * 60 * 30,
+    ).toISOString(),
+    circuit_json_build_logs: circuitJsonBuildLogs,
+    circuit_json_build_error: null,
+    build_in_progress: false,
+    build_started_at: new Date(Date.now() - 1000 * 60 * 30).toISOString(),
+    build_completed_at: new Date(Date.now() - 1000 * 60 * 25).toISOString(),
+    build_error: null,
+    build_error_last_updated_at: new Date(
+      Date.now() - 1000 * 60 * 25,
+    ).toISOString(),
+    build_logs: buildLogs.join(" "),
+    preview_url: "https://preview.tscircuit.com/pb_1a2b3c4d",
+    branch_name: "main",
+    commit_message: "Add new LED component with improved brightness control",
+    commit_author: "john.doe",
+  })
+
+  const res = await axios.get(
+    `/api/package_builds/get?package_build_id=${packageBuild.package_build_id}`,
+  )
+  expect(res.status).toBe(200)
+  expect(res.data.package_build).toBeDefined()
+  expect(res.data.package_build.package_build_id).toBe(
+    packageBuild.package_build_id,
+  )
+  expect(res.data.package_build.transpilation_logs).toEqual(transpilationLogs)
+  expect(res.data.package_build.circuit_json_build_logs).toEqual(
+    circuitJsonBuildLogs,
+  )
+  expect(res.data.package_build.build_logs).toBe(buildLogs.join(" "))
+})
+
+test("GET /api/package_builds/get - returns package build without logs when include_logs is false", async () => {
+  const { axios, db } = await getTestServer()
+  const { package: pkg } = await createTestPackage(axios)
+  const { package_release } = await createTestPackageRelease(
+    axios,
+    pkg.package_id,
+  )
+
+  const packageBuild = db.addPackageBuild({
+    package_release_id: package_release.package_release_id,
+    created_at: new Date().toISOString(),
+    transpilation_in_progress: false,
+    transpilation_started_at: new Date().toISOString(),
+    transpilation_completed_at: new Date().toISOString(),
+    transpilation_logs: ["Some logs"],
+    transpilation_error: null,
+    circuit_json_build_in_progress: false,
+    circuit_json_build_started_at: new Date().toISOString(),
+    circuit_json_build_completed_at: new Date().toISOString(),
+    circuit_json_build_logs: ["Some circuit logs"],
+    circuit_json_build_error: null,
+    build_in_progress: false,
+    build_started_at: new Date().toISOString(),
+    build_completed_at: new Date().toISOString(),
+    build_error: null,
+    build_error_last_updated_at: new Date().toISOString(),
+    build_logs: "Some build logs",
+    preview_url: "https://preview.tscircuit.com/pb_test",
+    branch_name: "main",
+    commit_message: "Test build",
+    commit_author: "john.doe",
+  })
+
+  const res = await axios.get(
+    `/api/package_builds/get?package_build_id=${packageBuild.package_build_id}`,
+  )
+  expect(res.status).toBe(200)
+  expect(res.data.package_build).toBeDefined()
+  expect(res.data.package_build.package_build_id).toBe(
+    packageBuild.package_build_id,
+  )
+  expect(res.data.package_build.transpilation_logs).toEqual(["Some logs"])
+  expect(res.data.package_build.circuit_json_build_logs).toEqual([
+    "Some circuit logs",
+  ])
+  expect(res.data.package_build.build_logs).toBe("Some build logs")
+})
+
+test("GET /api/package_builds/get - handles build with errors", async () => {
+  const { axios, db } = await getTestServer()
+  const { package: pkg } = await createTestPackage(axios)
+  const { package_release } = await createTestPackageRelease(
+    axios,
+    pkg.package_id,
+  )
+
+  const packageBuild = db.addPackageBuild({
+    package_release_id: package_release.package_release_id,
+    created_at: new Date().toISOString(),
+    transpilation_in_progress: false,
+    transpilation_started_at: new Date().toISOString(),
+    transpilation_completed_at: null,
+    transpilation_logs: [],
+    transpilation_error: "Transpilation failed: syntax error",
+    circuit_json_build_in_progress: false,
+    circuit_json_build_started_at: null,
+    circuit_json_build_completed_at: null,
+    circuit_json_build_logs: [],
+    circuit_json_build_error: "Circuit JSON build failed",
+    build_in_progress: false,
+    build_started_at: new Date().toISOString(),
+    build_completed_at: null,
+    build_error: "Build failed: compilation error",
+    build_error_last_updated_at: new Date().toISOString(),
+    build_logs: null,
+    preview_url: null,
+    branch_name: "feature/new-component",
+    commit_message: "Add broken component",
+    commit_author: "john.doe",
+  })
+
+  const res = await axios.get(
+    `/api/package_builds/get?package_build_id=${packageBuild.package_build_id}`,
+  )
+  expect(res.status).toBe(200)
+  expect(res.data.package_build).toBeDefined()
+  expect(res.data.package_build.package_build_id).toBe(
+    packageBuild.package_build_id,
+  )
+  expect(res.data.package_build.transpilation_error).toBe(
+    "Transpilation failed: syntax error",
+  )
+  expect(res.data.package_build.circuit_json_build_error).toBe(
+    "Circuit JSON build failed",
+  )
+  expect(res.data.package_build.build_error).toBe(
+    "Build failed: compilation error",
+  )
+})
+
+test("GET /api/package_builds/get - handles build in progress", async () => {
+  const { axios, db } = await getTestServer()
+  const { package: pkg } = await createTestPackage(axios)
+  const { package_release } = await createTestPackageRelease(
+    axios,
+    pkg.package_id,
+  )
+
+  const packageBuild = db.addPackageBuild({
+    package_release_id: package_release.package_release_id,
+    created_at: new Date().toISOString(),
+    transpilation_in_progress: true,
+    transpilation_started_at: new Date().toISOString(),
+    transpilation_completed_at: null,
+    transpilation_logs: ["Starting transpilation"],
+    transpilation_error: null,
+    circuit_json_build_in_progress: false,
+    circuit_json_build_started_at: null,
+    circuit_json_build_completed_at: null,
+    circuit_json_build_logs: [],
+    circuit_json_build_error: null,
+    build_in_progress: false,
+    build_started_at: null,
+    build_completed_at: null,
+    build_error: null,
+    build_error_last_updated_at: new Date().toISOString(),
+    build_logs: null,
+    preview_url: null,
+    branch_name: "main",
+    commit_message: "Building in progress",
+    commit_author: "john.doe",
+  })
+
+  const res = await axios.get(
+    `/api/package_builds/get?package_build_id=${packageBuild.package_build_id}`,
+  )
+  expect(res.status).toBe(200)
+  expect(res.data.package_build).toBeDefined()
+  expect(res.data.package_build.package_build_id).toBe(
+    packageBuild.package_build_id,
+  )
+  expect(res.data.package_build.transpilation_in_progress).toBe(true)
+  expect(res.data.package_build.transpilation_logs).toEqual([
+    "Starting transpilation",
+  ])
+})