.env.example

# ApexStore Configuration
# High-Performance LSM-Tree Key-Value Store

# ===================================
# Server Configuration
# ===================================
HOST=0.0.0.0
PORT=8080

# Payload size limits (in bytes)
MAX_JSON_PAYLOAD_SIZE=52428800  # 50MB
MAX_RAW_PAYLOAD_SIZE=52428800   # 50MB

# Feature flag cache TTL (in seconds)
FEATURE_CACHE_TTL=10

# Connection and concurrency settings
MAX_CONNECTIONS=10000            # Max concurrent connections
BACKLOG=1024                     # TCP listen backlog size
WORKERS=                         # Worker threads (empty = auto-detect CPU cores)

# Rate limiting (per IP address)
RATE_LIMIT_ENABLED=true          # Enable/disable IP-based rate limiting
RATE_LIMIT_REQUESTS_PER_MINUTE=100  # Max requests per minute per IP

# ===================================
# Authentication Configuration
# ===================================
# Enable/disable Bearer Token authentication
# Set to 'true' to require authentication for API endpoints
# Default: false (backward compatible)
API_AUTH_ENABLED=false

# Token expiry in days (optional)
# If not set, tokens will never expire
API_TOKEN_EXPIRY_DAYS=30

# ===================================
# Storage Configuration
# ===================================
DIR_PATH=./data
MEMTABLE_MAX_SIZE=16777216      # 16MB

# Block and cache configuration
BLOCK_SIZE=4096                 # 4KB
BLOCK_CACHE_SIZE_MB=64

# Bloom filter configuration
BLOOM_FALSE_POSITIVE_RATE=0.01  # 1%

# Index configuration
INDEX_INTERVAL=16

# Prefix compression (block-level key prefix encoding)
# When enabled, consecutive keys within a block share their common prefix,
# reducing SSTable size by ~10-30% for keys with common prefixes.
PREFIX_COMPRESSION_ENABLED=false

# ===================================
# Request Timeout Configuration
# ===================================
# Global timeout for API requests (in seconds)
# Default: 30
REQUEST_TIMEOUT_SECONDS=30

# ===================================
# WAL Archiving Configuration
# ===================================
# Maximum WAL file size before automatic archiving (in bytes)
# Default: 67108864 (64MB)
WAL_MAX_SIZE=67108864
# Enable automatic WAL archiving
WAL_ARCHIVE_ENABLED=false
# WAL size check interval (in seconds)
WAL_CHECK_INTERVAL_SECS=60

# ===================================
# Change Data Capture (CDC) Configuration
# ===================================
# CDC endpoint URL for streaming data changes to external systems.
# When set, CDC is enabled and all data mutations (set/delete) are posted
# as JSON events to the specified HTTP endpoint.
CDC_ENDPOINT=                    # e.g. http://localhost:9000/webhook