auth0
Version:
Auth0 Node.js SDK for the Management API v2.
48 lines (47 loc) • 1.67 kB
text/typescript
/**
* Creates a fluent builder for constructing URL query strings.
*
* Each `.add()` call serializes its value immediately (like C#'s builder),
* so no format tracking is needed — the style is applied at add-time.
*
* Usage (generated code):
*
* const qs = core.url.queryBuilder()
* .add("limit", limit)
* .add("tags", tags, { style: "comma" }) // explode: false
* .mergeAdditional(requestOptions?.queryParams)
* .build();
*/
export declare function queryBuilder(): QueryStringBuilder;
declare class QueryStringBuilder {
private parts;
/**
* Adds a query parameter, serializing it immediately.
*
* By default arrays use "repeat" format (`key=a&key=b`).
* Pass `{ style: "comma" }` for OpenAPI `explode: false` parameters
* to get comma-separated values (`key=a,b,c`).
*
* Null / undefined values are silently skipped.
*/
add(key: string, value: unknown, options?: {
style?: "comma";
}): this;
/**
* Adds multiple query parameters at once from a record.
* All parameters use the default "repeat" array format.
* Null / undefined values are silently skipped.
*/
addMany(params: Record<string, unknown>): this;
/**
* Merges additional query parameters supplied at call-time via
* `requestOptions.queryParams`. Overrides existing keys (last-write-wins).
*/
mergeAdditional(additionalParams?: Record<string, unknown>): this;
/**
* Returns the assembled query string (without the leading `?`).
* Returns an empty string when no parameters were added.
*/
build(): string;
}
export {};