Feature: Video upload
  Getting a video into the catalogue is a two-step exchange. The client asks
  the CMS for an upload slot, PUTs the file straight to storage with the
  short-lived URL it is handed, and then registers the video — which queues
  the transcoding job and writes the catalogue record. The file itself never
  passes through the API.

  Background:
    Given the CMS API is available

  Scenario: Discovering the categories a video can be filed under
    When I ask the CMS for the list of categories
    Then the request succeeds with status 200
    And the category list is not empty
    And every category has an id and a name

  Scenario: Asking for an upload slot for an MP4
    When I request an upload slot for "interview-cut.mp4" of type "video/mp4"
    Then the request succeeds with status 200
    And I am given an upload URL
    And the storage key is under "videos/" and ends with ".mp4"

  Scenario: Asking for an upload slot for a QuickTime movie
    When I request an upload slot for "interview-cut.mov" of type "video/quicktime"
    Then the request succeeds with status 200
    And I am given an upload URL
    And the storage key is under "videos/" and ends with ".mov"

  Scenario Outline: Refusing to hand out a slot for anything that is not an MP4 or MOV
    When I request an upload slot for "<file>" of type "<type>"
    Then the request is rejected with status 422
    And the problem title is "Unsupported file type. Please upload an MP4 or MOV video."

    Examples:
      | file       | type                     |
      | clip.avi   | video/avi                |
      | reel.mkv   | video/x-matroska         |
      | poster.png | image/png                |
      | notes.txt  | text/plain               |
      | blob.bin   | application/octet-stream |
      | clip.mp4   |                          |

  Scenario: Refusing a request body that is not JSON
    When I send malformed JSON to the upload slot endpoint
    Then the request is rejected with status 400
    And the problem title is "Invalid request."

  Scenario: Registering a video that has been uploaded
    Given I have requested an upload slot for "interview-cut.mp4" of type "video/mp4"
    And I have uploaded the file to the upload URL
    When I register the uploaded video titled "Inside the Newsroom" under categories "documentary, news"
    Then the request succeeds with status 201
    And the video is registered with status "processing"
    And the video has an id
    And the video is stored under the key from the upload slot
    And the video has a transcoding job id
    And the video is filed under categories "documentary, news"
    And the video keeps the metadata I sent

  Scenario: Registering a video under a single category
    Given I have requested an upload slot for "short.mov" of type "video/quicktime"
    And I have uploaded the file to the upload URL
    When I register the uploaded video titled "A Short Film" under categories "documentary"
    Then the request succeeds with status 201
    And the video is filed under categories "documentary"

  Scenario: Refusing to register a video whose file was never uploaded
    Given I have requested an upload slot for "ghost.mp4" of type "video/mp4"
    When I register the uploaded video titled "The One That Got Away" under categories "other"
    Then the request is rejected with status 422
    And the problem title is "Failed to find video in storage"

  Scenario: Refusing to register a video without a title
    Given I have requested an upload slot for "untitled.mp4" of type "video/mp4"
    And I have uploaded the file to the upload URL
    When I register the uploaded video titled "   " under categories "other"
    Then the request is rejected with status 422
    And the problem title is "Title is required."

  Scenario: Refusing to register a video with no category
    Given I have requested an upload slot for "uncategorised.mp4" of type "video/mp4"
    And I have uploaded the file to the upload URL
    When I register the uploaded video titled "Uncategorised" under categories ""
    Then the request is rejected with status 422
    And the problem title is "At least one category is required."

  Scenario Outline: Refusing to register a storage key this API never issued
    When I register a video titled "Smuggled In" with the key "<key>" under categories "other"
    Then the request is rejected with status 422
    And the problem title is "A video file is required."

    Examples:
      | key                             |
      |                                 |
      | not-mine.mp4                    |
      | uploads/not-mine.mp4            |
      | ../videos/escape.mp4            |
      | videos-of-someone-else/clip.mp4 |

  Scenario: Registering a video under a category id that does not exist
    Given I have requested an upload slot for "mystery.mp4" of type "video/mp4"
    And I have uploaded the file to the upload URL
    When I register the uploaded video titled "Mystery Genre" under category id 32767
    Then the request is rejected with status 404
    And the problem title is "Catagory Does Not Exist"

  # A key is registered once. The second attempt is turned away before the
  # transcoding job is queued, so it cannot leave a duplicate job behind.
  Scenario: Registering the same upload twice
    Given I have requested an upload slot for "twice.mp4" of type "video/mp4"
    And I have uploaded the file to the upload URL
    And I have registered the uploaded video titled "Filed Once" under categories "other"
    When I register the uploaded video titled "Filed Twice" under categories "other"
    Then the request is rejected with status 409
    And the problem title is "Video Already Registered"