Fix #74: Add $total parameter to fastPaginate()

[aarondfrancis]

Summary

• Add $total parameter to fastPaginate() to allow skipping the COUNT query
• Useful for caching the total count on large tables (10M+ records) where COUNT(*) can take 300ms+
• Works the same as Laravel's built-in paginate() method

Test plan

• Added test total_can_be_passed_to_skip_count_query that verifies:
  • Custom total is used instead of running COUNT query
  • Only 2 queries are executed (inner select + outer select) instead of 3
  • The paginator returns the custom total value

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix-74

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}