Add out-of-stock detection and display

- Add stock_status column to products table (in_stock/out_of_stock/unknown)
- Detect out-of-stock status on Amazon by checking:
  - #availability text for "currently unavailable"
  - #outOfStock element presence
  - Missing "Add to Cart" button
- Add generic stock status detection for other sites
- Allow adding out-of-stock products (they just won't have a price)
- Update background scheduler to track stock status changes
- Display stock status badge in product list and detail pages
- Dim out-of-stock products in the dashboard
- Show "Currently Unavailable" badge instead of price when out of stock

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

backend/src/routes/prices.ts

@@ -1,7 +1,7 @@
 import { Router, Response } from 'express';
 import { AuthRequest, authMiddleware } from '../middleware/auth';
 import { productQueries, priceHistoryQueries } from '../models';
-import { scrapePrice } from '../services/scraper';
+import { scrapeProduct } from '../services/scraper';
 
 const router = Router();
 
@@ -62,27 +62,31 @@ router.post('/:productId/refresh', async (req: AuthRequest, res: Response) => {
       return;
     }
 
-    // Scrape new price
-    const priceData = await scrapePrice(product.url);
+    // Scrape product data including price and stock status
+    const scrapedData = await scrapeProduct(product.url);
 
-    if (!priceData) {
-      res.status(400).json({ error: 'Could not extract price from URL' });
-      return;
+    // Update stock status
+    await productQueries.updateStockStatus(productId, scrapedData.stockStatus);
+
+    // Record new price if available
+    let newPrice = null;
+    if (scrapedData.price) {
+      newPrice = await priceHistoryQueries.create(
+        productId,
+        scrapedData.price.price,
+        scrapedData.price.currency
+      );
     }
 
-    // Record new price
-    const newPrice = await priceHistoryQueries.create(
-      productId,
-      priceData.price,
-      priceData.currency
-    );
-
     // Update last_checked timestamp
     await productQueries.updateLastChecked(productId);
 
     res.json({
-      message: 'Price refreshed successfully',
+      message: scrapedData.stockStatus === 'out_of_stock'
+        ? 'Product is currently out of stock'
+        : 'Price refreshed successfully',
       price: newPrice,
+      stockStatus: scrapedData.stockStatus,
     });
   } catch (error) {
     console.error('Error refreshing price:', error);

backend/src/routes/products.ts

@@ -42,28 +42,32 @@ router.post('/', async (req: AuthRequest, res: Response) => {
     // Scrape product info
     const scrapedData = await scrapeProduct(url);
 
-    if (!scrapedData.price) {
+    // Allow adding out-of-stock products, but require a price for in-stock ones
+    if (!scrapedData.price && scrapedData.stockStatus !== 'out_of_stock') {
       res.status(400).json({
         error: 'Could not extract price from the provided URL',
       });
       return;
     }
 
-    // Create product
+    // Create product with stock status
     const product = await productQueries.create(
       userId,
       url,
       scrapedData.name,
       scrapedData.imageUrl,
-      refresh_interval || 3600
+      refresh_interval || 3600,
+      scrapedData.stockStatus
     );
 
-    // Record initial price
-    await priceHistoryQueries.create(
-      product.id,
-      scrapedData.price.price,
-      scrapedData.price.currency
-    );
+    // Record initial price if available
+    if (scrapedData.price) {
+      await priceHistoryQueries.create(
+        product.id,
+        scrapedData.price.price,
+        scrapedData.price.currency
+      );
+    }
 
     // Update last_checked timestamp
     await productQueries.updateLastChecked(product.id);