Method validateSpec

packages/cli/src/util/openapi/openapi-cache.ts:319–345

(spec: OpenApiSpec | null, url: string)

  }

  private validateSpec(spec: OpenApiSpec | null, url: string): void {
    if (!spec || typeof spec !== 'object') {
      throw new Error(
        `Invalid OpenAPI spec from ${url}: expected a JSON object.`
      );
    }

    if (typeof spec.openapi !== 'string' || !spec.openapi.startsWith('3.')) {
      throw new Error(
        `Invalid OpenAPI spec from ${url}: expected an OpenAPI 3.x document with an "openapi" field.`
      );
    }

    if (!spec.paths || typeof spec.paths !== 'object') {
      throw new Error(
        `Invalid OpenAPI spec from ${url}: expected a "paths" object.`
      );
    }

    for (const path of Object.keys(spec.paths)) {
      if (!path.startsWith('/') || path.startsWith('//')) {
        throw new Error(
          `Invalid OpenAPI spec from ${url}: path "${path}" must be a relative API path.`
        );
      }
    }
  }

  /**
   * Check if cached spec is expired