feat: Add pagination max page size configuration

[wschurman]

Why

Currently, the Entity pagination system allows clients to request arbitrarily large page sizes using the first or last parameters in pagination queries. This can lead to:

• Performance degradation when clients request excessively large pages
• Potential memory issues on the server
• Unpredictable query response times
• Difficulty in capacity planning and resource allocation

By adding configurable max page size limits, we can:

• Protect backend services from resource exhaustion
• Ensure predictable performance characteristics
• Provide better control over API usage patterns
• Maintain backward compatibility (no limit by default)

How

The implementation adds a paginationMaxPageSize configuration option to the PostgresEntityDatabaseAdapterProvider that flows through the adapter hierarchy:

1. Configuration Interface: Added PostgresEntityDatabaseAdapterConfiguration with an optional paginationMaxPageSize field
2. Provider Level: PostgresEntityDatabaseAdapterProvider constructor now accepts the configuration object
3. Adapter Level:
   • BasePostgresEntityDatabaseAdapter defines a paginationMaxPageSize getter (defaults to undefined)
   • PostgresEntityDatabaseAdapter overrides it to return the configured value
4. Validation: EntityKnexDataManager.loadPageAsync validates first/last parameters against the max page size before executing queries

The validation throws descriptive errors when limits are exceeded:

• "first must not exceed maximum page size of {limit}"
• "last must not exceed maximum page size of {limit}"

Usage example:

const provider = new PostgresEntityDatabaseAdapterProvider({
  paginationMaxPageSize: 100
});

Test Plan

Added comprehensive unit tests in EntityKnexDataManager-test.ts.

[wschurman]

• fix: update integration test to use BlahEntity.knexLoader syntax #444 : 2 dependent PRs (#446 , #448 )
• fix: revert change to codemod now that Entity.knexLoader is supported again via subclass #443
• feat: add PostgresEntity/ReadonlyPostgresEntity classes that expose knexLoader methods #442
• fix: refactor install method to instead be free functions #441
• fix: Add default for TSelectedFields for application-instantiated types #438
• fix: pass in augmentable classes to installation #437
• feat: Add pagination max page size configuration #436 👈 (View in Graphite)
• feat: Add ilike and trigram similarity search to pagination #431
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (f72cbca) to head (b4c15d5).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #436   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          109       109           
  Lines        16045     16086   +41     
  Branches      1410      1419    +9     
=========================================
+ Hits         16045     16086   +41     

Flag	Coverage Δ
integration	27.13% <72.09%> (+0.11%)	⬆️
unittest	95.05% <60.46%> (+0.72%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[wschurman]

Merge activity

• Feb 16, 8:58 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Feb 16, 8:59 PM UTC: Graphite rebased this pull request as part of a merge.
• Feb 16, 9:02 PM UTC: @wschurman merged this pull request with Graphite.