JavaScript Code Generator (Free AI Tool)

Plain English:
"Create an async function that searches GitHub repositories by keyword,
fetches results from the API, handles rate limiting,
and returns formatted data or throws descriptive errors."

/**
 * Search GitHub repositories by keyword with error handling.
 * 
 * @param {string} keyword - Search query for repositories
 * @param {number} [perPage=30] - Results per page (max 100)
 * @returns {Promise<Array<{name: string, stars: number, url: string}>>}
 * @throws {Error} For network errors or invalid responses
 */
const searchGitHubRepos = async (keyword, perPage = 30) => {
  // Input validation
  if (!keyword || typeof keyword !== "string") {
    throw new Error("Keyword must be a non-empty string");
  }
  
  if (perPage < 1 || perPage > 100) {
    throw new Error("perPage must be between 1 and 100");
  }
  
  const url = `https://api.github.com/search/repositories?q=${encodeURIComponent(keyword)}&per_page=${perPage}`;
  
  try {
    const response = await fetch(url, {
      headers: {
        "Accept": "application/vnd.github.v3+json",
        "User-Agent": "SwapCode-App"
      }
    });
    
    // Handle rate limiting
    if (response.status === 403) {
      const resetTime = response.headers.get("X-RateLimit-Reset");
      const resetDate = new Date(resetTime * 1000);
      throw new Error(`GitHub API rate limit exceeded. Try again at ${resetDate.toLocaleTimeString()}`);
    }
    
    if (!response.ok) {
      throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
    }
    
    const data = await response.json();
    
    // Format results
    return data.items.map(repo => ({
      name: repo.full_name,
      stars: repo.stargazers_count,
      url: repo.html_url,
      description: repo.description || "No description"
    }));
    
  } catch (error) {
    if (error.message.includes("rate limit")) {
      throw error; // Re-throw rate limit errors as-is
    }
    throw new Error(`Failed to search repositories: ${error.message}`);
  }
};

Plain English:
"Create a React component that displays a todo list,
fetches data from localStorage on mount, allows adding/removing todos,
and persists changes automatically."

import React, { useState, useEffect } from "react";

/**
 * TodoList component with localStorage persistence.
 * 
 * @component
 * @returns {JSX.Element} Todo list with add/remove functionality
 */
const TodoList = () => {
  const [todos, setTodos] = useState([]);
  const [inputValue, setInputValue] = useState("");
  const [error, setError] = useState(null);
  
  const STORAGE_KEY = "todos";
  
  // Load todos from localStorage on mount
  useEffect(() => {
    try {
      const saved = localStorage.getItem(STORAGE_KEY);
      if (saved) {
        const parsed = JSON.parse(saved);
        if (Array.isArray(parsed)) {
          setTodos(parsed);
        }
      }
    } catch (err) {
      setError("Failed to load todos from storage");
      console.error("localStorage error:", err);
    }
  }, []);
  
  // Persist todos to localStorage whenever they change
  useEffect(() => {
    if (todos.length > 0) {
      try {
        localStorage.setItem(STORAGE_KEY, JSON.stringify(todos));
      } catch (err) {
        setError("Failed to save todos");
        console.error("localStorage error:", err);
      }
    }
  }, [todos]);
  
  const addTodo = (e) => {
    e.preventDefault();
    
    const trimmed = inputValue.trim();
    if (!trimmed) {
      setError("Todo cannot be empty");
      return;
    }
    
    const newTodo = {
      id: Date.now(),
      text: trimmed,
      completed: false
    };
    
    setTodos(prev => [...prev, newTodo]);
    setInputValue("");
    setError(null);
  };
  
  const removeTodo = (id) => {
    setTodos(prev => prev.filter(todo => todo.id !== id));
  };
  
  return (
    <div className="todo-container">
      <h2>Todo List</h2>
      
      {error && <div className="error">{error}</div>}
      
      <form onSubmit={addTodo}>
        <input
          type="text"
          value={inputValue}
          onChange={(e) => setInputValue(e.target.value)}
          placeholder="Add a new todo..."
          maxLength={100}
        />
        <button type="submit">Add</button>
      </form>
      
      <ul>
        {todos.map(todo => (
          <li key={todo.id}>
            <span>{todo.text}</span>
            <button onClick={() => removeTodo(todo.id)}>Remove</button>
          </li>
        ))}
      </ul>
      
      {todos.length === 0 && <p>No todos yet. Add one above!</p>}
    </div>
  );
};

export default TodoList;