Method getBodyFields

packages/cli/src/util/openapi/openapi-cache.ts:160–212

* Extract body fields from a requestBody schema. * Throws if spec hasn't been loaded yet.

(endpoint: EndpointInfo)

   * Throws if spec hasn't been loaded yet.
   */
  getBodyFields(endpoint: EndpointInfo): BodyField[] {
    this.ensureLoaded();

    if (!endpoint.requestBody?.content) return [];

    // Get the JSON content schema
    const jsonContent = endpoint.requestBody.content['application/json'];
    if (!jsonContent?.schema) return [];

    const schema = this.resolveSchemaRef(jsonContent.schema);
    if (!schema?.properties) return [];

    const requiredFields = new Set(schema.required || []);
    const fields: BodyField[] = [];

    for (const [name, propSchema] of Object.entries(schema.properties) as [
      string,
      Schema,
    ][]) {
      const resolvedProp = this.resolveSchemaRef(propSchema);

      // Get enum values from the schema, handling array items
      let enumValues = resolvedProp?.enum || propSchema.enum;
      if (
        !enumValues &&
        (resolvedProp?.type === 'array' || propSchema.type === 'array')
      ) {
        const items = resolvedProp?.items || propSchema.items;
        if (items) {
          const resolvedItems = this.resolveSchemaRef(items);
          enumValues = resolvedItems?.enum || items.enum;
        }
      }

      fields.push({
        name,
        required: requiredFields.has(name),
        description: resolvedProp?.description || propSchema.description,
        type: resolvedProp?.type || propSchema.type,
        enumValues,
      });
    }

    // Sort by required first, then alphabetically
    fields.sort((a, b) => {
      if (a.required !== b.required) {
        return a.required ? -1 : 1;
      }
      return a.name.localeCompare(b.name);
    });

    return fields;
  }

  /**
   * Extract `x-vercel-cli.displayColumns` from the 200 response schema of an