meta {
  name: Create Media Item
  type: http
  seq: 1
}

post {
  url: {{base_url}}/api/media-items
  body: json
  auth: inherit
}

headers {
  Content-Type: application/json
}

body:json {
  "library_id": "{{library_id}}",
  "title": "New Media Item",
  "author": "Author Name",
  "isbn": "978-0123456789",
  "description": "Description of the media item",
  "cover_image_path": "/path/to/cover.jpg",
  "series": "Series Name",
  "series_number": 1,
  "tags": "fiction, adventure",
  "asin": "B08XYZ123",
  "date_published": "2023-01-15",
  "publisher": "Publisher Name",
  "contributors": "Contributor Name",
  "language": "en",
  "edition": "First Edition",
  "page_count": 350,
  "genre": "Science Fiction",
  "copyright_year": 2023,
  "goodreads_id": "123456",
  "openlibrary_id": "OL123456M",
  "google_books_id": "GB123456"
}

tests {
  test_create_media_item_success(status, headers, body) {
    if (status !== 201) {
      throw new Error("Expected status 201, got " + status);
    }

    let data;
    try {
      data = JSON.parse(body);
    } catch (e) {
      throw new Error("Response body is not valid JSON");
    }

    if (!data || typeof data !== "object") {
      throw new Error("Expected media item object in response");
    }

    // Verify required fields
    if (!data.id || !data.title || !data.library_id) {
      throw new Error("Media item missing required fields: id, title, library_id");
    }

    return true;
  }
}

vars:pre-request {
  libraryId: "cc23c3a7-f8fb-451a-a78d-2a16df1b725a"
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## Create Media Item
  
  Creates a new media item in a library with full metadata.
  
  **Method:** POST
  
  **Endpoint:** /api/media-items
  
  **Authentication:** Required (Bearer token, admin only)
  
  **Request Body:**
  - `library_id` (string, required): Library UUID
  - `title` (string, required): Media item title
  - `author` (string, optional): Author name
  - `isbn` (string, optional): ISBN number
  - `description` (string, optional): Description
  - `cover_image_path` (string, optional): Path to cover image
  - `series` (string, optional): Series name
  - `series_number` (integer, optional): Number in series
  - `tags` (string, optional): Tags or categories
  - `asin` (string, optional): Amazon ASIN
  - `date_published` (string, optional): Publication date
  - `publisher` (string, optional): Publisher name
  - `contributors` (string, optional): Contributors
  - `language` (string, optional): Language code (ISO 639-1)
  - `edition` (string, optional): Edition information
  - `page_count` (integer, optional): Total page count
  - `genre` (string, optional): Genre classification
  - `copyright_year` (integer, optional): Copyright year
  - `goodreads_id` (string, optional): Goodreads identifier
  - `openlibrary_id` (string, optional): Open Library identifier
  - `google_books_id` (string, optional): Google Books identifier
  
  **Response:** Created media item object
  - All fields above plus system-generated fields
  
  **Status Codes:**
  - 201: Media item created successfully
  - 400: Invalid request data
  - 401: Unauthorized
  - 403: Forbidden (admin access required)
  - 404: Library not found
  - 500: Internal server error
  
  **Examples:**
  - Create media item: `POST /api/media-items`
  
  **Note:** Admin access required - only users with admin role can create media items.
}