Support all array query serializations about nextlove

[razor-x]

We need to support a the "common" array serialization formats.

Current support as of this comment

export type QueryArrayFormat = "brackets" | "comma" | "repeat"

Defaults must be updated when adding a new one:

nextlove/packages/nextlove/src/with-route-spec/index.ts

Line 49 in 59eeadf

export const DEFAULT_ARRAY_FORMATS: QueryArrayFormats = [

I think the main one we are missing is indexed which is like brackets but includes the index like ?foo[0]=a&foo[1]=b. This is the default used by axios (and possibly Ruby's HTTP gem and others).

Note that the "standard" format is generally agreed to be repeat since this is what URLSearchParams does (and does not mangle the name or value in the query string), but all formats are "non-standard".

All formats have drawbacks, but client libs are recommended to implement repeat. Critically, repeat has an ambiguity since a single element array containing the empty string foo= could be interpreted as either foo=[''] or foo=[]. This library will interpret this as [] which is often the intended behavior and more useful than ['']. Client libraries should disallow passing [''] to array params to prevent silently changing the intention of the caller.

A reference implementation for a compatible serializer may be found at https://github.com/seamapi/javascript-http/blob/main/src/lib/params-serializer.ts

[razor-x]

This library will interpret this as []

There may be a bug where this lib is actually parsing foo= as [undefined] or ['']. We need some tests around these edge cases. It should parse foo= as [].