.env.example

# ─────────────────────────────────────────────────────────────────────────────
# ProstDev — local environment variables
#
# HOW TO USE:
#   1. Copy this file to `.env` in the repo root:   cp .env.example .env
#   2. Paste your real key(s) below (in `.env`, NOT here).
#   3. Run `npm run youtube-analytics` — the scripts load `.env` automatically
#      (Node ≥20.6 native, no dotenv dependency).
#
# `.env` is gitignored (never committed). This `.env.example` is the tracked
# template and must stay free of real secrets. An already-exported shell var
# (or a GitHub Actions secret in CI) takes precedence over `.env`.
# ─────────────────────────────────────────────────────────────────────────────

# YouTube Data API v3 key — used by `npm run sync-youtube` and `npm run youtube-analytics`.
# Both scripts are READ-ONLY and only read PUBLIC data (metadata + view/like/comment counts);
# they never touch the Analytics API, so a plain API key is all you need — no OAuth.
#
# Get one at: https://console.cloud.google.com/apis/credentials
#   • Create (or pick) a project → "Create credentials" → "API key".
#   • Enable "YouTube Data API v3" for that project (APIs & Services → Library).
#   • Optional but recommended: restrict the key to the "YouTube Data API v3".
YOUTUBE_API_KEY=

# Gemini API key — used by `npm run analyze-video`, which WATCHES a video (frames + audio, not
# just the transcript) and returns a timestamped MuleSoft-tutorial critique (hook, pacing, code
# legibility, filler, CTA). Gemini natively ingests video: it reads a published YouTube URL
# directly (no download), or uploads a local pre-publish recording via its File API.
#
# Get one FREE at: https://aistudio.google.com  → "Get API key" (no billing required to start). OR https://aistudio.google.com/api-keys
#   • Free tier has per-minute/day rate limits and MAY use uploads to improve Google's models —
#     fine for already-public videos. For UNPUBLISHED recordings you don't want used for training,
#     turn on billing (still pay-per-use, cents/video — NOT the $20/mo "Gemini Advanced" chatbot).
#   • NOT the same as YOUTUBE_API_KEY above — this is the Generative Language API, a separate key.
#   • MODEL: use `gemini-2.5-flash` (the script default). `gemini-2.5-pro` is NOT on the free tier
#     (returns limit: 0 / 429) — do NOT pass --model=gemini-2.5-pro without billing enabled.
GEMINI_API_KEY=

# Optional fallback key(s) — from a DIFFERENT Google account/project. If GEMINI_API_KEY is rate-
# limited, out of daily quota, or invalid, `npm run analyze-video` automatically advances to
# GEMINI_API_KEY_2 (then _3) and retries. Handy for long videos on the free tier. Leave blank if
# you don't have a second key.
GEMINI_API_KEY_2=
GEMINI_API_KEY_3=