Function appendQuery

apps/sim/lib/api/client/request.ts:62–100

(path: string, query: unknown)

}

function appendQuery(path: string, query: unknown): string {
  if (!query || typeof query !== 'object') return path

  const searchParams = new URLSearchParams()
  for (const [key, value] of Object.entries(query as Record<string, unknown>)) {
    if (value === undefined || value === null || value === '') continue

    if (Array.isArray(value)) {
      for (const item of value) {
        if (item === undefined || item === null || item === '') continue
        // A non-scalar in a query array would stringify to "[object Object]" and
        // silently corrupt the request. Encode such values as a single JSON
        // string param and decode them server-side instead. Failing loudly here
        // keeps the boundary honest (this is how the knowledge tagFilters bug
        // shipped undetected).
        if (typeof item === 'object') {
          throw new Error(
            `Cannot serialize query param "${key}": arrays of objects are not URL-safe — ` +
              'encode the value as a JSON string param and decode it server-side.'
          )
        }
        searchParams.append(key, String(item))
      }
      continue
    }

    if (typeof value === 'object') {
      searchParams.set(key, JSON.stringify(value))
      continue
    }

    searchParams.set(key, String(value))
  }

  const queryString = searchParams.toString()
  if (!queryString) return path

  return `${path}${path.includes('?') ? '&' : '?'}${queryString}`
}

function buildHeaders(headers: unknown, hasBody: boolean): Record<string, string> {
  const output: Record<string, string> = {}