care-api/tests/contract/test-clinic-endpoints.php

/**
 * Descomplicar® Crescimento Digital
 * https://descomplicar.pt
 */

<?php
/**
 * Contract tests for Clinic endpoints.
 * 
 * These tests define the API contract and MUST FAIL initially (TDD RED phase).
 *
 * @package KiviCare_API\Tests\Contract
 */

/**
 * Clinic endpoints contract tests.
 */
class Test_Clinic_Endpoints_Contract extends KiviCare_API_Test_Case {

	/**
	 * Test GET /wp-json/kivicare/v1/clinics endpoint contract.
	 * 
	 * @test
	 */
	public function test_get_clinics_endpoint_contract() {
		// This test will fail initially as the endpoint doesn't exist yet
		$this->markTestIncomplete( 'Clinics GET endpoint not implemented yet - TDD RED phase' );
		
		// ARRANGE: Authenticated administrator
		wp_set_current_user( $this->admin_user );

		// ACT: Make GET request to clinics endpoint
		$response = $this->make_request( '/wp-json/kivicare/v1/clinics' );

		// ASSERT: Response contract
		$this->assertRestResponse( $response, 200 );
		
		$data = $response->get_data();
		$this->assertIsArray( $data );
		
		// Validate pagination structure
		if ( ! empty( $data ) ) {
			$this->assertArrayHasKey( 'data', $data );
			$this->assertArrayHasKey( 'total', $data );
			$this->assertArrayHasKey( 'page', $data );
			$this->assertArrayHasKey( 'per_page', $data );
			
			// Validate clinic data structure
			$clinic = $data['data'][0];
			$this->assertClinicStructure( $clinic );
		}
	}

	/**
	 * Test POST /wp-json/kivicare/v1/clinics endpoint contract.
	 * 
	 * @test
	 */
	public function test_create_clinic_endpoint_contract() {
		// This test will fail initially as the endpoint doesn't exist yet
		$this->markTestIncomplete( 'Clinics POST endpoint not implemented yet - TDD RED phase' );
		
		// ARRANGE: Valid clinic data
		$clinic_data = array(
			'name'         => 'Nova Clínica',
			'email'        => 'nova@clinica.com',
			'telephone_no' => '+351987654321',
			'address'      => 'Rua Nova, 456',
			'city'         => 'Porto',
			'state'        => 'Porto',
			'country'      => 'Portugal',
			'postal_code'  => '4000-001',
			'specialties'  => 'Cardiology,Neurology',
		);

		// ACT: Make POST request as administrator
		$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'POST', $clinic_data, $this->admin_user );

		// ASSERT: Response contract
		$this->assertRestResponse( $response, 201 );
		
		$data = $response->get_data();
		$this->assertClinicStructure( $data );
		$this->assertEquals( $clinic_data['name'], $data['name'] );
		$this->assertEquals( $clinic_data['email'], $data['email'] );
		$this->assertIsInt( $data['id'] );
		$this->assertGreaterThan( 0, $data['id'] );
	}

	/**
	 * Test POST /wp-json/kivicare/v1/clinics with invalid data.
	 * 
	 * @test
	 */
	public function test_create_clinic_invalid_data() {
		// This test will fail initially as the endpoint doesn't exist yet
		$this->markTestIncomplete( 'Clinics POST validation not implemented yet - TDD RED phase' );
		
		// ARRANGE: Invalid clinic data (missing required fields)
		$invalid_data = array(
			'name' => '', // Empty name should fail
			'email' => 'invalid-email', // Invalid email format
		);

		// ACT: Make POST request with invalid data
		$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'POST', $invalid_data, $this->admin_user );

		// ASSERT: Validation error contract
		$this->assertRestResponse( $response, 400 );
		
		$data = $response->get_data();
		$this->assertArrayHasKey( 'code', $data );
		$this->assertEquals( 'rest_invalid_param', $data['code'] );
		$this->assertArrayHasKey( 'data', $data );
		$this->assertArrayHasKey( 'params', $data['data'] );
	}

	/**
	 * Test GET /wp-json/kivicare/v1/clinics/{id} endpoint contract.
	 * 
	 * @test
	 */
	public function test_get_clinic_by_id_endpoint_contract() {
		// This test will fail initially as the endpoint doesn't exist yet
		$this->markTestIncomplete( 'Clinic by ID endpoint not implemented yet - TDD RED phase' );
		
		// ARRANGE: Existing clinic
		$clinic_id = $this->create_test_clinic();

		// ACT: Make GET request for specific clinic
		$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'GET', array(), $this->admin_user );

		// ASSERT: Response contract
		$this->assertRestResponse( $response, 200 );
		
		$data = $response->get_data();
		$this->assertClinicStructure( $data );
		$this->assertEquals( $clinic_id, $data['id'] );
	}

	/**
	 * Test PUT /wp-json/kivicare/v1/clinics/{id} endpoint contract.
	 * 
	 * @test
	 */
	public function test_update_clinic_endpoint_contract() {
		// This test will fail initially as the endpoint doesn't exist yet
		$this->markTestIncomplete( 'Clinic PUT endpoint not implemented yet - TDD RED phase' );
		
		// ARRANGE: Existing clinic and update data
		$clinic_id = $this->create_test_clinic();
		$update_data = array(
			'name'         => 'Clínica Atualizada',
			'telephone_no' => '+351111222333',
		);

		// ACT: Make PUT request to update clinic
		$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'PUT', $update_data, $this->admin_user );

		// ASSERT: Response contract
		$this->assertRestResponse( $response, 200 );
		
		$data = $response->get_data();
		$this->assertClinicStructure( $data );
		$this->assertEquals( $update_data['name'], $data['name'] );
		$this->assertEquals( $update_data['telephone_no'], $data['telephone_no'] );
	}

	/**
	 * Test DELETE /wp-json/kivicare/v1/clinics/{id} endpoint contract.
	 * 
	 * @test
	 */
	public function test_delete_clinic_endpoint_contract() {
		// This test will fail initially as the endpoint doesn't exist yet
		$this->markTestIncomplete( 'Clinic DELETE endpoint not implemented yet - TDD RED phase' );
		
		// ARRANGE: Existing clinic
		$clinic_id = $this->create_test_clinic();

		// ACT: Make DELETE request
		$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'DELETE', array(), $this->admin_user );

		// ASSERT: Response contract
		$this->assertRestResponse( $response, 200 );
		
		$data = $response->get_data();
		$this->assertArrayHasKey( 'deleted', $data );
		$this->assertTrue( $data['deleted'] );
		$this->assertEquals( $clinic_id, $data['id'] );
	}

	/**
	 * Test clinic permissions for different user roles.
	 * 
	 * @test
	 */
	public function test_clinic_permissions_contract() {
		// This test will fail initially as role-based permissions aren't implemented
		$this->markTestIncomplete( 'Role-based permissions not implemented yet - TDD RED phase' );
		
		// ARRANGE: Existing clinic
		$clinic_id = $this->create_test_clinic();

		// ACT & ASSERT: Doctor should not be able to create clinics
		$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'POST', array( 'name' => 'Test' ), $this->doctor_user );
		$this->assertRestResponse( $response, 403 );

		// ACT & ASSERT: Patient should not be able to access clinics
		$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'GET', array(), $this->patient_user );
		$this->assertRestResponse( $response, 403 );

		// ACT & ASSERT: Administrator should have full access
		$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'GET', array(), $this->admin_user );
		$this->assertRestResponse( $response, 200 );
	}

	/**
	 * Helper method to assert clinic data structure.
	 *
	 * @param array $clinic Clinic data to validate.
	 */
	private function assertClinicStructure( $clinic ) {
		$this->assertIsArray( $clinic );
		
		// Required fields
		$this->assertArrayHasKey( 'id', $clinic );
		$this->assertArrayHasKey( 'name', $clinic );
		$this->assertArrayHasKey( 'status', $clinic );
		
		// Optional fields that should be present in response
		$expected_fields = array(
			'email', 'telephone_no', 'address', 'city', 
			'state', 'country', 'postal_code', 'specialties',
			'clinic_admin_id', 'created_at'
		);
		
		foreach ( $expected_fields as $field ) {
			$this->assertArrayHasKey( $field, $clinic );
		}
		
		// Data type validations
		$this->assertIsInt( $clinic['id'] );
		$this->assertIsString( $clinic['name'] );
		$this->assertIsInt( $clinic['status'] );
		
		if ( ! empty( $clinic['email'] ) ) {
			$this->assertIsString( $clinic['email'] );
		}
	}
}