Function queryParamEntries

packages/plugins/openapi/src/sdk/invoke.ts:70–110

(value: unknown, param: OperationParameter)

  typeof value === "object" && value !== null && !Array.isArray(value);

const queryParamEntries = (value: unknown, param: OperationParameter): QueryParamEntry[] => {
  if (value === undefined || value === null) return [];

  const style = Option.getOrUndefined(param.style) ?? "form";
  const explode = Option.getOrElse(param.explode, () => true);

  if (isRecord(value)) {
    const entries = Object.entries(value).filter(
      ([, nested]) => nested !== undefined && nested !== null,
    );

    if (style === "form") {
      if (explode) {
        // OAS form + explode=true serializes an object as top-level query
        // fields, e.g. `{ region: "west", tier: "standard" }` ->
        // `region=west&tier=standard`.
        return entries.map(([name, nested]) => [name, primitiveToString(nested)]);
      }

      return [
        [
          param.name,
          entries.flatMap(([name, nested]) => [name, primitiveToString(nested)]).join(","),
        ],
      ];
    }

    if (style === "deepObject") {
      return entries.map(([name, nested]) => [`${param.name}[${name}]`, primitiveToString(nested)]);
    }

    return [[param.name, primitiveToString(value)]];
  }

  if (!Array.isArray(value)) return [[param.name, primitiveToString(value)]];

  if (explode) return value.map((nested) => [param.name, primitiveToString(nested)]);

  const separator = style === "spaceDelimited" ? " " : style === "pipeDelimited" ? "|" : ",";
  return [[param.name, value.map(primitiveToString).join(separator)]];
};

// ---------------------------------------------------------------------------
// Path resolution