feat: add customizable pagination and ordering parameter names

[G4brym]

Summary

Adds 4 new class properties to ListEndpoint that allow overriding the default query parameter names for pagination and ordering:

Property	Default	Description
pageFieldName	"page"	Query param name for page number
perPageFieldName	"per_page"	Query param name for items per page
orderByFieldName	"order_by"	Query param name for sort column
orderByDirectionFieldName	"order_by_direction"	Query param name for sort direction

This follows the existing pattern of searchFieldName which was already customizable.

Breaking change note

ListFilters.options type changed from a specific shape ({ page?: number; per_page?: number; ... }) to Record<string, unknown>. This is technically a breaking change for TypeScript consumers who relied on the specific property types, but the runtime behavior is identical and existing code accessing options.page etc. will still work (just typed as unknown now).

Example

class MyListEndpoint extends ListEndpoint {
  _meta = { model: { schema: MySchema, tableName: "items", primaryKeys: ["id"] } };

  // Custom parameter names
  pageFieldName = "p";
  perPageFieldName = "limit";
  orderByFieldName = "sort";
  orderByDirectionFieldName = "dir";
  orderByFields = ["name", "created_at"];
}
// GET /items?p=2&limit=10&sort=name&dir=desc

Changes

• src/endpoints/list.ts: Added 4 field name properties, converted optionFields from static array to a getter, updated getSchema() to use dynamic field names
• src/endpoints/d1/list.ts: Updated list() to read options using the custom field names
• src/endpoints/types.ts: Changed ListFilters.options to Record<string, unknown> to support arbitrary option keys
• 4 integration tests covering custom pagination, ordering, OpenAPI schema output, and option field routing

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/cloudflare/chanfana@316

commit: 04f775a

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	94.38%	740 / 784
🔵	Statements	94.32%	764 / 810
🔵	Functions	91.76%	156 / 170
🔵	Branches	86.71%	444 / 512

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
src/endpoints/list.ts	95.55%	82.6%	83.33%	95.55%	48, 157-159
src/endpoints/types.ts	100%	100%	100%	100%
src/endpoints/d1/list.ts	95%	64%	100%	94.73%	86, 117

Generated in workflow #670 for commit 04f775a by the Vitest Coverage Report Action