.env.example

# Notion API Configuration
NOTION_API_KEY=your_notion_api_key_here

# DATA_SOURCE_ID is the primary variable for Notion API v5 (version 2025-09-03)
# This is the ID of the "data source" in Notion's new API architecture
# Run the discovery script to find the correct value for your database:
#   bun scripts/migration/discoverDataSource.ts
DATA_SOURCE_ID=your_data_source_id_here

# DATABASE_ID is kept for backward compatibility during migration
# In Notion API v5, DATABASE_ID and DATA_SOURCE_ID may be DIFFERENT values
# The DATABASE_ID fallback will be deprecated in a future release
DATABASE_ID=your_database_id_here

# Docusaurus Configuration
# Default landing page for docs redirect (e.g., 'introduction', 'introduction-remove', 'getting-started')
DEFAULT_DOCS_PAGE=introduction-remove

# Image Processing Configuration (PR #102)
# Enable/disable intelligent retry logic for handling Notion's 1-hour URL expiration
# When enabled: Automatically retries image downloads with progress validation
# When disabled: Falls back to single-pass processing (pre-PR #102 behavior)
# Valid values: "true" or "false" (case-insensitive)
# Default: "true"
ENABLE_RETRY_IMAGE_PROCESSING=true

# Maximum number of retry attempts per page when S3 URLs are detected in markdown
# Each retry re-processes the page to attempt image downloads again
# Valid values: 1-10 (integer as string)
# Default: "3"
# Recommendation: 3 attempts is optimal balance between recovery and performance
MAX_IMAGE_RETRIES=3

# Test Environment Configuration
# For translation workflow testing, you can use a dedicated test database
# When TEST_DATABASE_ID or TEST_DATA_SOURCE_ID is set, translation scripts
# will use the test database instead of the production database
#
# To enable test mode:
# 1. Set TEST_DATABASE_ID or TEST_DATA_SOURCE_ID to your test database ID
# 2. Optionally set TEST_MODE=true to explicitly enable test mode
#
# In test mode:
# - All translation operations use the test database
# - GitHub workflow dispatch validates target_branch against safe patterns
# - Safe branches: "test/*", "fix/*", "feat/*", or branches with "test" in name
# - Production branches ("main", "master", "content") are rejected in test mode
#
# Example:
# TEST_DATA_SOURCE_ID=test-database-id-here
# TEST_MODE=true

# OpenAI API Configuration
# Required for translation features (notion-translate scripts)
OPENAI_API_KEY=your_openai_api_key_here

# OpenAI model to use for translations
# Default: gpt-5-mini
# Valid values: any OpenAI-compatible model name
OPENAI_MODEL=gpt-5-mini

# Optional: Use alternative OpenAI-compatible APIs (like Deepseek)
# OPENAI_BASE_URL=https://api.deepseek.com
# OPENAI_MODEL=deepseek-chat

# API Server Configuration
# Host and port for the Notion Jobs API server
# Default: API_HOST=localhost, API_PORT=3001
API_HOST=localhost
API_PORT=3001

# API Key Authentication
# Set one or more API_KEY_* variables to enable authentication on protected endpoints.
# When no API_KEY_* variables are set, the API server is fully open (no auth required).
# Format: API_KEY_<name>=<value>  (minimum 16 characters)
# Example: API_KEY_GITHUB_ACTIONS=your-secret-key-min-16-chars
# API_KEY_GITHUB_ACTIONS=your-secret-key-min-16-chars