What is Snappy Idioms Dot Com?

An interactive, language-learning experience. Snappy Idioms Dot Com uses imagination, context, and active practice to build fluency, not just memorisation.

Vercel Crossword Deploy | Snappy Idioms Dot Com

Ver·cel De·ploy·ment Files - Crossword API /ˈvɜː.səl dɪˈplɔɪ.mənt faɪlz/

NEW: Serverless API! This deployment includes edge-optimized serverless functions for faster crossword generation. Deploy to Vercel for production use.

api/generate-crossword.js

NEW - Serverless API

/**
 * Vercel Serverless API - Generate Crossword
 * Path: /api/generate-crossword
 */

import { createClient } from '@supabase/supabase-js';

const supabase = createClient(
  process.env.SUPABASE_URL,
  process.env.SUPABASE_SERVICE_KEY
);

export const config = {
  runtime: 'edge',
  maxDuration: 60,
};

export default async function handler(req) {
  try {
    const { targetDate, difficulty, thinkingStyle, apiKey } = await req.json();
    
    // Auth check
    if (apiKey !== process.env.ADMIN_API_KEY) {
      return new Response(JSON.stringify({ error: 'Unauthorized' }), {
        status: 401,
        headers: { 'Content-Type': 'application/json' }
      });
    }
    
    // Fetch idioms
    const { data: idioms } = await supabase
      .from('Idiom')
      .select('*')
      .eq('is_approved', true)
      .limit(50);
    
    // Generate puzzle logic here...
    // (Copy the core algorithm from vercelGenerateCrossword.js)
    
    return new Response(JSON.stringify({
      success: true,
      message: 'Crossword generated successfully'
    }), {
      status: 200,
      headers: { 'Content-Type': 'application/json' }
    });
    
  } catch (error) {
    return new Response(JSON.stringify({ error: error.message }), {
      status: 500,
      headers: { 'Content-Type': 'application/json' }
    });
  }
}

vercel.json

UPDATED

{
  "version": 2,
  "functions": {
    "api/generate-crossword.js": {
      "runtime": "edge",
      "maxDuration": 60
    }
  },
  "env": {
    "SUPABASE_URL": "@supabase_url",
    "SUPABASE_SERVICE_KEY": "@supabase_service_key",
    "ADMIN_API_KEY": "@admin_api_key",
    "OPENAI_API_KEY": "@openai_api_key"
  }
}

package.json

UPDATED

{
  "name": "snappy-crossword-api",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "dependencies": {
    "@supabase/supabase-js": "^2.39.0"
  },
  "devDependencies": {
    "@vercel/node": "^3.0.0"
  }
}

README.md

# Snappy English - Vercel Crossword API

Edge-optimized serverless functions for crossword puzzle generation.

## Setup

1. **Create Vercel Project**
   ```bash
   npm i -g vercel
   vercel login
   vercel
   ```

2. **Set Environment Variables**
   Go to Vercel Dashboard → Settings → Environment Variables:
   - `SUPABASE_URL`
   - `SUPABASE_SERVICE_KEY`
   - `ADMIN_API_KEY` (create a random secure key)
   - `OPENAI_API_KEY` (for cryptic clues)

3. **Deploy**
   ```bash
   vercel --prod
   ```

## API Usage

**Endpoint:** `https://your-project.vercel.app/api/generate-crossword`

**Method:** POST

**Body:**
```json
{
  "targetDate": "2025-01-15",
  "difficulty": "standard",
  "thinkingStyle": "universal",
  "apiKey": "YOUR_ADMIN_API_KEY"
}
```

**Response:**
```json
{
  "success": true,
  "crossword": { ... },
  "trace_id": "uuid",
  "duration_ms": 1234
}
```

## Features

✅ Edge runtime (faster cold starts)
✅ 60s max execution time
✅ Supabase integration
✅ OpenAI cryptic clues (optional)
✅ Thinking style support
✅ Automatic retries
✅ Detailed logging

## File Structure

```
/
├── api/
│   └── generate-crossword.js
├── package.json
├── vercel.json
└── README.md
```

## Local Testing

```bash
npm install
vercel dev
curl -X POST http://localhost:3000/api/generate-crossword \
  -H "Content-Type: application/json" \
  -d '{"apiKey":"test","difficulty":"mini"}'
```

Deployment Steps:

Install Vercel CLI: npm i -g vercel
Create project folder and add the 4 files above
Run vercel and follow prompts
Set environment variables in Vercel Dashboard
Deploy: vercel --prod
Test: curl -X POST https://your-project.vercel.app/api/generate-crossword