🍳 Seasoned Recipe App

Introduction

Seasoned is a modern recipe management application built with a microservices architecture using Cloudflare Workers. The application provides recipe clipping, storage, search, and management capabilities through a collection of specialized workers.

npm run docs:generate

Architecture Overview

Recipe Search DB Worker

Graph Search, FTS, Node/Edge Management

Key Functions

// Recipe Search Database Worker
// Provides graph-based search capabilities for recipes

export default {
  async fetch(request, env, ctx) {
    const url = new URL(request.url);
    const path = url.pathname;
    const method = request.method;

    // CORS headers
    const corsHeaders = {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
      'Access-Control-Allow-Headers': 'Content-Type, Authorization',
    };

    try {

      // Handle preflight requests
      if (method === 'OPTIONS') {
        return new Response(null, { headers: corsHeaders });
      }

      // Route handling
      if (path === '/api/nodes' && method === 'POST') {
        return await createNode(request, env, corsHeaders);
      } else if (path === '/api/nodes' && method === 'GET') {
        return await getNodes(request, env, corsHeaders);
      } else if (path.startsWith('/api/nodes/') && method === 'GET') {
        const nodeId = path.split(...

Clipped Recipe DB Worker

Recipe CRUD, Image Uploads, Health Monitoring

API Endpoints

Key Functions

// Recipe API with SQLite (D1) and image upload support
export default {
  async fetch(request, env) {
    const url = new URL(request.url);
    const pathname = url.pathname;

    // CORS headers
    const corsHeaders = {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
      'Access-Control-Allow-Headers': 'Content-Type, Authorization',
    };

    // Handle preflight requests
    if (request.method === 'OPTIONS') {
      return new Response(null, { headers: corsHeaders });
    }

    try {
      // Health check endpoint
      if (pathname === '/health' && request.method === 'GET') {
        try {
          // Perform health checks
          const healthStatus = await checkSystemHealth(env);
          
          return new Response(JSON.stringify(healthStatus), {
            status: 200,
            headers: { ...corsHeaders, 'Content-Type': 'application/json' }
          });
        } catch (error) {
          console...

Recipe Scraper Worker

JSON-LD Extraction, Batch Processing, KV Storage

Key Functions

/**
 * Recipe Scraper
 * Scrapes recipe data from URLs using JSON-LD structured data
 * Stores recipes in KV database with hashed URL as key
 */

import { 
  generateRecipeId, 
  saveRecipeToKV, 
  getRecipeFromKV, 
  listRecipesFromKV, 
  deleteRecipeFromKV 
} from '../shared/kv-storage.js';

// Decode HTML entities
function decodeHtmlEntities(text) {
  if (typeof text !== 'string') return text;
  
  const entities = {
    '&': '&',
    '<': '<',
    '>': '>',
    '"': '"',
    ''': "'",
    ''': "'",
    ' ': ' ',
    '©': '©',
    '®': '®',
    '™': '™'
  };
  
  return text.replace(/&[#\w]+;/g, entity => {
    return entities[entity] || entity;
  });
}

// Normalize ingredients to ensure they're always arrays
function normalizeIngredients(ingredients) {
  if (!ingredients) return [];
  if (typeof ingredients === 'string') return [decodeHtmlEntities(ingredients)];
  if (Array.isArray(ingredients)) {
    return ingredients.map(ing => {
    ...

Recipe Clipper Worker

AI Extraction, GPT-4o-mini, Smart Caching

API Endpoints

Key Functions

// Recipe Clipper Worker using Cloudflare Workers AI with GPT-4o-mini model
import { 
  generateRecipeId, 
  saveRecipeToKV, 
  getRecipeFromKV, 
  deleteRecipeFromKV 
} from '../../shared/kv-storage.js';

export default {
  async fetch(request, env) {
    const url = new URL(request.url);
    const pathname = url.pathname;

    // CORS headers
    const corsHeaders = {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
      'Access-Control-Allow-Headers': 'Content-Type, Authorization',
    };

    // Handle preflight requests
    if (request.method === 'OPTIONS') {
      return new Response(null, { headers: corsHeaders });
    }

    try {
      // Clip recipe from URL using GPT-OSS-20B
      if (pathname === '/clip' && request.method === 'POST') {
        const body = await request.json();
        const pageUrl = body.url;
        
        if (!pageUrl) {
          return new Response('URL is required', { 
            s...

Recipe Crawler Worker

Batch Processing, Health Monitoring, Progress Tracking

#!/usr/bin/env python3
"""
Recipe Crawler
A Python script that can pass a list of URLs to the recipe scraper
"""

import requests
import json
import time
import argparse
import sys
from typing import List, Dict, Any
from urllib.parse import urlparse, urljoin
import logging
import re
from bs4 import BeautifulSoup

# Configure logging
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s',
    handlers=[
        logging.FileHandler('crawler.log'),
        logging.StreamHandler(sys.stdout)
    ]
)
logger = logging.getLogger(__name__)

class RecipeCrawler:
    def __init__(self, scraper_url: str = "https://recipe-scraper.nolanfoster.workers.dev"):
        """
        Initialize the recipe crawler
        
        Args:
            scraper_url: URL of the recipe scraper worker
        """
        self.scraper_url = scraper_url.rstrip('/')
        self.session = requests.Session()
        self.session.headers.update({
            'User-Agent': 'Re...

KV Storage Library

Compression, ID Generation, CRUD Operations

Key Functions

/**
 * Shared KV Storage Library
 * Common functions for recipe storage and retrieval using Cloudflare KV
 * Used by both recipe-clipper and recipe-scraper workers
 */

// Utility function to generate a unique ID from URL
export function generateRecipeId(url) {
  const encoder = new TextEncoder();
  const data = encoder.encode(url);
  return crypto.subtle.digest('SHA-256', data)
    .then(hash => {
      const hashArray = Array.from(new Uint8Array(hash));
      return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
    });
}

// Compress data using gzip and encode as base64
export async function compressData(data) {
  const encoder = new TextEncoder();
  const jsonString = JSON.stringify(data);
  const jsonBytes = encoder.encode(jsonString);
  
  // Use CompressionStream for gzip compression
  const cs = new CompressionStream('gzip');
  const writer = cs.writable.getWriter();
  const reader = cs.readable.getReader();
  
  writer.write(jsonBytes);
  writer.close();
  
  co...

Testing

Each worker includes comprehensive testing to ensure reliability and functionality.

Test Structure

Running Tests

cd recipe-search-db
npm test

cd clipped-recipe-db-worker
npm test

cd recipe-scraper
npm test

cd clipper
npm test

cd crawler
npm test

Deployment

All workers are designed for easy deployment to Cloudflare Workers with proper environment configuration.

Deployment Commands

npm run deploy

wrangler secret put MY_SECRET

wrangler d1 execute DB --file=./schema.sql

Environment Configuration

Each worker requires specific environment variables and bindings:

• D1 Databases: For SQLite storage
• KV Namespaces: For caching and temporary storage
• R2 Buckets: For image storage
• AI Bindings: For Workers AI functionality

Troubleshooting

Common issues and solutions for the Seasoned recipe app workers.

Debug Mode

Enable debug logging to troubleshoot issues:

# Enable worker logging
wrangler tail

# Check worker logs
wrangler logs tail

# Test endpoints locally
wrangler dev