Function cleanParams

client/src/utils/paramUtils.ts:11–44

(
  params: Record<string, unknown>,
  schema: JsonSchemaType,
)

 * @returns Cleaned parameters object with optional empty fields omitted
 */
export function cleanParams(
  params: Record<string, unknown>,
  schema: JsonSchemaType,
): Record<string, unknown> {
  const cleaned: Record<string, unknown> = {};
  const required = schema.required || [];
  const properties = schema.properties || {};

  for (const [key, value] of Object.entries(params)) {
    const isFieldRequired = required.includes(key);
    const fieldSchema = properties[key] as JsonSchemaType | undefined;

    // Check if the field has an explicit default value
    const hasDefault = fieldSchema && "default" in fieldSchema;
    const defaultValue = hasDefault ? fieldSchema.default : undefined;

    if (isFieldRequired) {
      // Required fields: always include, even if empty string or falsy
      cleaned[key] = value;
    } else if (hasDefault && value === defaultValue) {
      // Field has a default value and current value matches it - preserve it
      // This is important for cases like default: null
      cleaned[key] = value;
    } else {
      // Optional fields: only include if they have meaningful values
      if (value !== undefined && value !== "" && value !== null) {
        cleaned[key] = value;
      }
      // Empty strings, undefined, null for optional fields → omit completely
    }
  }

  return cleaned;
}