sessions = $sessions; $this->service = $service; $this->queue = $queue; } /** * {@inheritdoc} */ public function register_routes(): void { $permission = Permissions::manage(); $id = array( 'id' => $this->id_arg() ); register_rest_route( $this->namespace, '/admin/sessions', array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'index' ), 'permission_callback' => $permission, 'args' => array_merge( $this->list_params( array( 'session_date', 'id' ), 'session_date' ), array( 'status' => array( 'type' => 'string', 'enum' => Rules::session_statuses(), 'validate_callback' => 'rest_validate_request_arg', ), ) ), ), array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'create' ), 'permission_callback' => $permission, 'args' => $this->session_args(), ), ) ); register_rest_route( $this->namespace, '/admin/session-options', array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'options' ), 'permission_callback' => $permission, ) ); register_rest_route( $this->namespace, '/admin/sessions/(?P\d+)', array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'show' ), 'permission_callback' => $permission, 'args' => $id, ), array( 'methods' => WP_REST_Server::EDITABLE, 'callback' => array( $this, 'update' ), 'permission_callback' => $permission, 'args' => array_merge( $id, $this->session_args() ), ), array( 'methods' => WP_REST_Server::DELETABLE, 'callback' => array( $this, 'delete' ), 'permission_callback' => $permission, 'args' => $id, ), ) ); register_rest_route( $this->namespace, '/admin/sessions/(?P\d+)/control', array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'control' ), 'permission_callback' => $permission, 'args' => array_merge( $id, array( 'action' => array( 'type' => 'string', 'required' => true, 'enum' => Rules::session_actions(), 'validate_callback' => 'rest_validate_request_arg', ), 'duration' => array( 'type' => 'integer', 'minimum' => 1, 'maximum' => Rules::MAX_PAUSE_MINUTES, 'default' => 10, 'validate_callback' => 'rest_validate_request_arg', ), 'reason' => array( 'type' => 'string', 'maxLength' => 120, 'default' => '', 'validate_callback' => 'rest_validate_request_arg', ), ) ), ) ); register_rest_route( $this->namespace, '/admin/sessions/(?P\d+)/live', array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'live' ), 'permission_callback' => $permission, 'args' => $id, ) ); foreach ( array( 'next' => 'next', 'complete' => 'complete', ) as $path => $callback ) { register_rest_route( $this->namespace, '/admin/sessions/(?P\d+)/' . $path, array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, $callback ), 'permission_callback' => $permission, 'args' => $id, ) ); } } /** * Request arguments of a session body. * * @return array> */ private function session_args(): array { $string = static function ( int $max ): array { return array( 'type' => 'string', 'maxLength' => $max, 'validate_callback' => 'rest_validate_request_arg', ); }; return array( 'title' => $string( 190 ), 'session_date' => $string( 10 ), 'start_time' => $string( 5 ), 'end_time' => $string( 5 ), 'meet_url' => $string( 255 ), 'checkin_before_minutes' => array( 'type' => array( 'integer', 'string' ), 'validate_callback' => 'rest_validate_request_arg', ), ); } /** * GET /admin/sessions * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response */ public function index( WP_REST_Request $request ) { $page = $this->sessions->query( array( 'page' => $request->get_param( 'page' ), 'per_page' => $request->get_param( 'per_page' ), 'search' => $request->get_param( 'search' ), 'status' => $request->get_param( 'status' ), ) ); return $this->collection_response( array_map( array( $this->service, 'present' ), $page['items'] ), $page['total'], $request ); } /** * GET /admin/session-options * * @since 0.1.0 * * @return \WP_REST_Response */ public function options() { return rest_ensure_response( array_map( array( $this->service, 'present' ), $this->sessions->recent() ) ); } /** * GET /admin/sessions/{id} * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function show( WP_REST_Request $request ) { $session = $this->sessions->find( $this->path_id( $request ) ); return $session ? rest_ensure_response( $this->service->present( $session ) ) : $this->error( 'session_missing', __( 'Session not found.', 'interviewnea' ), 404 ); } /** * POST /admin/sessions * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function create( WP_REST_Request $request ) { $result = $this->service->save( $this->request_body( $request ) ); return is_wp_error( $result ) ? $result : new \WP_REST_Response( $result, 201 ); } /** * POST|PUT|PATCH /admin/sessions/{id} * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function update( WP_REST_Request $request ) { return $this->respond( $this->service->save( $this->request_body( $request ), $this->path_id( $request ) ) ); } /** * DELETE /admin/sessions/{id} * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function delete( WP_REST_Request $request ) { return $this->respond( $this->service->delete( $this->path_id( $request ) ) ); } /** * POST /admin/sessions/{id}/control * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function control( WP_REST_Request $request ) { return $this->respond( $this->queue->session_action( $this->path_id( $request ), (string) $request->get_param( 'action' ), (int) $request->get_param( 'duration' ), sanitize_text_field( (string) $request->get_param( 'reason' ) ) ) ); } /** * GET /admin/sessions/{id}/live * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function live( WP_REST_Request $request ) { return $this->respond( $this->queue->live_state( $this->path_id( $request ) ) ); } /** * POST /admin/sessions/{id}/next * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function next( WP_REST_Request $request ) { return $this->respond( $this->queue->call_next( $this->path_id( $request ) ) ); } /** * POST /admin/sessions/{id}/complete * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function complete( WP_REST_Request $request ) { return $this->respond( $this->queue->complete_and_next( $this->path_id( $request ) ) ); } }