- Add boolean query parser documentation with accepted values and ex…

[harystyleseze]

Summary

• Add boolean query parser documentation with accepted values and examples (Add boolean query parser docs with accepted values #250)
• Add route-level structured diagnostics log for oversized request payload rejections (Add route-level request size diagnostics log #249)
• Add configurable indexer cursor stale-age warning threshold with warning emission (Add indexer cursor stale-age warning threshold config #248)
• Add creator feed filter combinator helper to eliminate duplicate where-clause logic (Add creator feed filter combinator helper #251)

---

Changes

#250 — Boolean query parser docs

• Created docs/boolean-query-parser.md documenting accepted true/false variants (true, 1, yes, on /
  false, 0, no, off), case-insensitivity rules, absent-param behaviour, error response shape, and
  implementation reference.

#249 — Route-level request size diagnostics log

• Added 413 handler in src/middlewares/error.middleware.ts that emits a structured logger.warn with
  route, contentLength, and limitBytes when a request payload exceeds the configured limit. Full payload
  content is never logged.

#248 — Indexer cursor stale-age warning threshold config

• Added INDEXER_CURSOR_STALE_AGE_WARNING_MS env variable (default 300000 ms / 5 min) to src/config.ts and
  .env.example
• Created src/utils/indexer-cursor-staleness.utils.ts —
  warnIfIndexerCursorStale(lastUpdatedAt, thresholdMs?) emits a structured pino warning when the cursor age
  exceeds the threshold
• Added full Jest test suite in
  src/utils/test/indexer-cursor-staleness.utils.test.ts

#251 — Creator feed filter combinator helper

• Created src/modules/creators/creator-feed-filter-combinator.utils.ts —
  buildCreatorFeedWhere(filters) composes the Prisma where clause from CreatorFilterInput, replacing
  duplicate inline combinator branches in feed handlers
• Updated src/modules/creators/creators.utils.ts to call buildCreatorFeedWhere instead of repeating the
  logic
• Added full Jest test suite in
  src/modules/creators/creator-feed-filter-combinator.utils.test.ts

---

Testing

• pnpm lint
• pnpm build
• pnpm exec prisma generate when schema or generated types changed

---

Checklist

• Linked issue or backlog item
• No secrets or live credentials added
• Docs updated if setup or env changed
• Change is scoped to one problem

---

Closes

Closes #248
Closes #249
Closes #250
Closes #251

[drips-wave]

@harystyleseze Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits