.env.example

# rssamplifier.com — copy to .env and fill in.
# Team copy lives in logicsrc: `logicsrc teams pull profullstack rssamplifier-com prod`

# Turso / libSQL. A file: URL needs no auth token, which is how the tests and
# local development run without a Turso account:
#   TURSO_DATABASE_URL=file:./local.db
TURSO_DATABASE_URL=libsql://YOUR-DB.turso.io
TURSO_AUTH_TOKEN=

# Maximum statements from queued callers folded into one remote transaction.
# Disabled by default: production's throttled primary timed out when five
# otherwise-valid first crawls shared a transaction. Raise only after measuring
# the provider path with representative first-crawl statements.
TURSO_WRITE_GROUP_STATEMENTS=1

# Recovery mode for a large first-crawl backlog. Turso's explicit transaction
# path can be much slower than autocommit writes on a saturated database. The
# first switch uses two serialized autocommits per feed; the second reserves
# writes for feeds/posts until the backlog is under control.
TURSO_CRAWL_AUTOCOMMIT=0
CRAWL_AUXILIARY_WRITES=1
CRAWL_CATCHUP=0

# Public origin, used for canonical URLs, OPML, llms.txt and JSON-LD.
SITE_URL=https://rssamplifier.com

# Salt for HMAC-hashing submitter IPs in the audit log. Generate with:
#   node -e "console.log(crypto.randomUUID())"
# Leave unset to disable IP hashing entirely rather than fall back to a
# predictable digest.
IP_HASH_SALT=

# Poller daemon
POLL_INTERVAL_SECONDS=60
POLL_BATCH_SIZE=25

# Looking up what each feed offers as its picture: its site's og:image, fetched
# and measured. Feeds per pass and how often a pass runs. Small and unhurried on
# purpose — it is speculative work against other people's servers, every feed is
# answered exactly once, and nothing on the site is waiting for it. Set the
# switch to 0 to pause the work without changing its tuning.
CARD_BACKFILL=1
CARD_BACKFILL_BATCH=8
CARD_BACKFILL_SECONDS=20

# Nonessential maintenance can be paused while a large first-crawl backlog owns
# the database write path. The work is resumable when these are switched on.
CLUSTER_BACKFILL=1