🐛 Fix issue in production with polar response schema mismatch

.env.example

@@ -0,0 +1,8 @@
+# Polar.sh Integration
+POLAR_ACCESS_TOKEN=your_polar_access_token_here
+POLAR_30SEC_PRODUCT_ID=your_30sec_product_id_here
+POLAR_60SEC_PRODUCT_ID=your_60sec_product_id_here
+POLAR_SUCCESS_URL=https://whiskey.fm/sponsor/success
+
+# Optional: Set to "sandbox" for testing, "production" for live (defaults to production)
+PUBLIC_POLAR_SERVER=production

.gitignore

@@ -27,3 +27,6 @@ test-results/
 
 # macOS-specific files
 .DS_Store
+
+# AI settings
+AGENTS.md

README.md

@@ -110,3 +110,38 @@ see fit.
 
 We use Turso and Astro DB to setup guests per episode. If you would also like to
 do this, you will need a Turso account.
+
+## Polar.sh Checkout Integration
+
+This site uses Polar.sh for sponsor checkout. To set it up:
+
+1. **Get your Polar credentials:**
+   - Log in to your [Polar dashboard](https://polar.sh)
+   - Go to Settings → API to get your access token
+   - Create two products for your sponsorship packages (30-second and 60-second ads)
+   - Note the product IDs from each product's page
+
+2. **Configure environment variables:**
+   Create a `.env` file in the root directory with:
+   ```env
+   POLAR_ACCESS_TOKEN=your_polar_access_token_here
+   POLAR_30SEC_PRODUCT_ID=your_30sec_product_id_here
+   POLAR_60SEC_PRODUCT_ID=your_60sec_product_id_here
+   POLAR_SUCCESS_URL=https://whiskey.fm/sponsor/success
+   ```
+
+3. **Test the integration:**
+   - For testing, you can set `PUBLIC_POLAR_SERVER=sandbox` in your `.env`
+   - Visit `/sponsor` and click on either sponsorship option
+   - You'll be redirected to Polar's checkout page
+   - After successful payment, users return to `/sponsor/success`
+
+4. **Go live:**
+   - Remove `PUBLIC_POLAR_SERVER` or set it to `production`
+   - Ensure your product IDs are for production products
+   - Test with a real payment to confirm everything works
+
+The integration uses the `@polar-sh/astro` package which provides:
+- Server-side checkout session creation at `/api/checkout`
+- Automatic tax compliance through Polar's Merchant of Record service
+- Support for multiple products and dynamic pricing

package.json

@@ -21,8 +21,11 @@
     "test:unit": "vitest"
   },
   "dependencies": {
+    "@astrojs/db": "^0.18.1",
     "@astrojs/preact": "^4.1.1",
+    "@astrojs/sitemap": "^3.6.0",
     "@astrojs/vercel": "^8.2.11",
+    "@polar-sh/astro": "^0.5.0",
     "@preact/signals": "^2.3.2",
     "@vercel/analytics": "^1.5.0",
     "@vercel/speed-insights": "^1.2.0",
@@ -32,12 +35,11 @@
     "preact": "^10.27.2",
     "rss-to-json": "^2.1.1",
     "schema-dts": "^1.1.5",
-    "valibot": "^1.1.0"
+    "valibot": "^1.1.0",
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.5",
-    "@astrojs/db": "^0.18.1",
-    "@astrojs/sitemap": "^3.6.0",
     "@eslint/js": "^9.38.0",
     "@playwright/test": "^1.56.1",
     "@tailwindcss/forms": "^0.5.10",