Repository navigation
v1.18.0 adds startup index management and fixes ratings backfills, book updates, and history writes.
Features
- API and worker startup wait for required MongoDB indexes and accept equivalent indexes with different names. (#957, #959)
- DB_INDEX_MODE=auto is the default and creates missing indexes. DB_INDEX_MODE=verify skips index creation but still needs createCollection and collMod privileges for schema preparation.
- Index changes are additive. Resolve conflicting definitions with an explicit migration.
- DB_INDEX_BUILD_WAIT_MS defaults to 1800000 per index. Allow for sequential builds in STARTUP_GRACE_PERIOD (Compose default: 30m), or pre-apply the catalog before rollout.
- Book history still requires a transaction-capable replica set.
- New DB-only indexes check and indexes apply commands inspect and prepare the catalog without the API, Redis, or jobs. (#959)
- indexes check is read-only. indexes apply and history prepare still prepare schemas and the full catalog with DB_INDEX_MODE=verify.
Fixes
- Ratings backfill applies JITTER_MS before the adaptive cooldown after every item, including rejections. (#957)
- Audible product-page requests omit Accept-Encoding to avoid upstream 503 responses. (#957)
- Scheduler walks and ratings backfill skip product-page scraping. On-demand requests retain it for genre data. (#957)
- The ratings backfill can repair validated fresh ratings when a full book update does not persist. (#957)
- Ratings backfill skips typed non-book rejections when the content type is known and reports terminalSkipped in job results. (#957)
- Other failures remain retryable. Accepted book writes clear the skip marker.
- Book updates accept absent genres only when no genres are stored. (#957)
- History updates supply missing createdAt values for legacy rows. (#957)
- Accepted history writes no longer fail on a conflicting updatedAt update. (#959)
- The MongoDB client omits undefined optional fields instead of writing null. (#957)
- BullMQ workers allow five stalled-job recoveries instead of one. (#957)