/** Datei: plugins/contacts/library/ARUNOX/Plugins/Contacts/Addresses/API/v1/Routes.php **/
<?php
	
	/**
	 * ARUNOX\Plugins\Contacts\Addresses\API\v1\Router
	 *
	 * Basisklasse für alle Controller in der API.
	 *
	 * @package         ARUNOX\API
	 *
	 * @author          Sparky <sparky@arunox.de>
	 * @copyright       2025 ARUNOX
	 * @version         1.1.0
	 *
	 * @since           1.0.0	File is created
	 */
	
	namespace ARUNOX\Plugins\Contacts\Addresses\API\v1;
	
	use ARUNOX\Core\Hooks;
	use ARUNOX\Core\Router;
	use ARUNOX\Plugins\REST;
	
	class Routes {
		public static function register() : void {
			/* ###  MAIN ROUTES  ##############################	# */
			Router::addAll( Controller::class );
			
			/* ###  MENU ROUTES  ##############################	# */
		}
	}


/** Datei: plugins/contacts/library/ARUNOX/Plugins/Contacts/Addresses/API/v1/Controller.php **/
<?php
	
	/**
	 * ARUNOX\Plugins\Contacts\Addresses\API\v1\Controller
	 *
	 * Basisklasse für alle Controller in der API.
	 *
	 * @package         ARUNOX\API
	 *
	 * @author          Sparky <sparky@arunox.de>
	 * @copyright       2025 ARUNOX
	 * @version         1.1.0
	 *
	 * @since           1.0.0	File is created
	 */
	
	namespace ARUNOX\Plugins\Contacts\Addresses\API\v1;
	
	use ARUNOX\HTTP;
	use ARUNOX\Plugins;
	use ARUNOX\API\PHP;
	use ARUNOX\Core\Hooks;
	use ARUNOX\Plugins\REST;
	use ARUNOX\Plugins\Contacts;
	use ARUNOX\API\BaseController;
	use ARUNOX\Database\Attribute;
	use ARUNOX\Database\BaseEntity;
	
	#[PHP\Attributes\Controller\Label( "Adresse", "Adressen" )]
	#[PHP\Attributes\Controller\Icon( REST\Generator\Config\Icon::GeoAlt )]
	#[PHP\Attributes\Controller\Route( "addresses" )]
	
	class Controller extends BaseController {
		/* ###  VARIABLES  ################################################	# */
		/* ###  PUBLIC GET FUNCTIONS  #####################################	# */
		
		/**
		 * @api
		 * @method				GET
		 *
		 * @route.path			/contacts/{hashid}/addresses
		 * @route.description	Listet alle Adresseen
		 */
		public static function getAllOwn( int|string $origin ) : array {
			return Contacts\Addresses\Model::getByContact( $origin );
		}
		
		/**
		 * @api
		 * @method				GET
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}
		 * @route.description	Gibt einen einzelnen Adresse anhand der ID zurück
		 */
		public static function get( int|string $origin, int|string $hashid ) : BaseEntity | HTTP\Response {
			$origin		= Contacts\Model::getValue( $origin );
			$current	= Contacts\Addresses\Model::getValue( $hashid );
			$where		= [ "id" => $current, "origin_id" => $origin ];
			
			if( $result = Contacts\Addresses\Model::get( $where ) ) return $result;
			
			return REST\Response::autoResponse( 404, static::getNotify("notfound") );
		}
		
		/* ###  PUBLIC SAVE FUNCTIONS  ####################################	# */
		
		/**
		 * @api
		 * @method				PUT
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}
		 * @route.description	Speichert Änderungen an einem bestehenden Adresse
		 */
		public static function save( int|string $origin, int|string $hashid, array $data ) : HTTP\Response {
			$origin		= Contacts\Model::getValue( $origin );
			$current	= Contacts\Addresses\Model::getValue( $hashid );
			$where		= [ "id" => $current, "origin_id" => $origin ];
			
			if( $result = Contacts\Addresses\Model::get( $where ) ) {
				if( $result->save( $data ) ) {
					return REST\Response::autoResponse( 200, static::getNotify("saved") );
				}
				return REST\Response::autoResponse( 500, static::getNotify("notsaved") );
			}
			
			return REST\Response::autoResponse( 404, static::getNotify("notfound") );
		}
		
		/**
		 * @api
		 * @method				POST
		 *
		 * @route.path			/contacts/{hashid}/addresses
		 * @route.description	Erstellt einen neue Adresse
		 */
		public static function create( int|string $origin, array $data ) : HTTP\Response {
			$data["origin_id"] = Contacts\Model::getValue( $origin );
			
			if( $hashid = Contacts\Addresses\Model::save( $data ) ) {
				$result = Contacts\Addresses\Model::get( $hashid );
				
				return REST\Response::autoResponse( 200, static::getNotify("created"), [ "data" => $result ] );
			}
			
			return REST\Response::autoResponse( 500, static::getNotify("notfound") );
		}
		
		/**
		 * @api
		 * @method				DELETE
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}
		 * @route.description	Löscht eine Adresse anhand der ID
		 */
		public static function delete( int|string $origin, int|string $hashid ) : HTTP\Response {
			$origin		= Contacts\Model::getValue( $origin );
			$current	= Contacts\Addresses\Model::getValue( $hashid );
			$where		= [ "id" => $current, "origin_id" => $origin ];
			
			if( Contacts\Addresses\Model::delete( $where ) ) {
				return REST\Response::autoResponse( 200, static::getNotify("deleted") );
			}
			
			return REST\Response::autoResponse( 500, static::getNotify("notfound") );
		}
		
		/**
		 * @api
		 * @method				PATCH
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}/status
		 * @route.description	Wechselt den Status (aktiv/inaktiv) eines Adresse
		 */
		public static function toggleStatus( int|string $origin, int|string $hashid ) : HTTP\Response {
			$origin		= Contacts\Model::getValue( $origin );
			$current	= Contacts\Addresses\Model::getValue( $hashid );
			$where		= [ "id" => $current, "origin_id" => $origin ];
			
			if( $result = Contacts\Addresses\Model::get( $where ) ) {
				$result->toggleStatus( TRUE );
				
				return REST\Response::autoResponse( 200,
					static::getNotify("statuschanged.{$result->status->getValue()}" ),
					[ "data" => $result ]
				);
			}
			
			return REST\Response::autoResponse( 404, static::getNotify("notfound") );
		}
		
		/**
		 * @api
		 * @method				PATCH
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}/primary
		 * @route.description	Wechselt den Status (aktiv/inaktiv) eines Adresse
		 */
		public static function togglePrimary( int|string $origin, int|string $hashid ) : HTTP\Response {
			$origin		= Contacts\Model::getValue( $origin );
			$current	= Contacts\Addresses\Model::getValue( $hashid );
			$where		= [ "id" => $current, "origin_id" => $origin ];
			
			if( $result = Contacts\Addresses\Model::get( $where ) ) {
				$result->togglePrimary( TRUE );
				
				return REST\Response::autoResponse( 200,
					static::getNotify("statuschanged.{$result->status->getValue()}" ),
					[ "data" => $result ]
				);
			}
			
			return REST\Response::autoResponse( 404, static::getNotify("notfound") );
		}
		
		/* ###  PUBLIC VALIDATE FUNCTIONS  ################################	# */
		
		/* ###  PUBLIC REST FUNCTIONS  ####################################	# */
		/* ###  PUBLIC REST RESPONSE FUNCTIONS  ###########################	# */
		/**
		 * @internal			rest
		 * @method				PUT
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}
		 * @route.description	REST-Antwort nach dem Speichern eines Adresse
		 */
		public static function restResponseSave( int|string $origin, int|string $hashid, array $data ) : HTTP\Response {
			$result	= static::save( $origin, $hashid, $data );
			
			if( $result->isStatus( 200 ) ) {
				$data = Contacts\Addresses\Model::get( $hashid );
				
				REST\Response::closeModals();
				REST\Response::addUpdater( [ "data/table/row", "/api/v1/contacts/{hashid}/addresses", $hashid ], $data );
			}
			
			return static::restResponse( $result );
		}
		
		/**
		 * @internal			rest
		 * @method				POST
		 *
		 * @route.path			/contacts/{hashid}/addresses
		 * @route.description	REST-Antwort nach dem Erstellen einer Adresse (inkl. Notifikation, Redirect etc.)
		 */
		public static function restResponseCreate( int|string $origin, array $data ) : HTTP\Response {
			$result	= static::create( $origin, $data );
			
			if( $result->isStatus( 200 ) ) {
				REST\Response::closeModals();
				REST\Response::redirect( "/contacts/{hashid}/addresses/{$result->getBody("data", "hashid")}" );
			}
			
			return static::restResponse( $result );
		}
		
		/**
		 * @internal			rest
		 * @method				DELETE
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}
		 * @route.description	REST-Antwort nach dem Löschen einer Adresse
		 */
		public static function restResponseDelete( int|string $origin, int|string $hashid ) : HTTP\Response {
			REST\Response::closeModals();
			
			$result	= static::delete( $origin, $hashid );
			
			if( $result->isStatus( 200 ) ) {
				REST\Response::redirect( "/contacts/{hashid}/addresses" );
			}
			
			return static::restResponse( $result );
		}
		
		/**
		 * @internal			rest
		 * @method				PATCH
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}/status
		 * @route.description	REST-Antwort zur Status-Umschaltung einer Adresse (z. B. für Notifications)
		 */
		public static function restResponseToggleStatus( int|string $origin, int|string $hashid ) : HTTP\Response {
			$result	= static::toggleStatus( $origin, $hashid );
			
			if( $result->isStatus( 200 ) ) {
				$data = $result->getBody("data");
				
				REST\Response::addUpdater( [ "data/table/row", "/api/v1/contacts/{$origin}/addresses", $hashid ], $data );
			}
			
			return static::restResponse( $result );
		}
		
		/**
		 * @internal			rest
		 * @method				PATCH
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}/primary
		 * @route.description	REST-Antwort zur Status-Umschaltung einer Adresse (z. B. für Notifications)
		 */
		public static function restResponseTogglePrimary( int|string $origin, int|string $hashid ) : HTTP\Response {
			$result	= static::togglePrimary( $origin, $hashid );
			
			if( $result->isStatus( 200 ) ) {
				$data = $result->getBody("data");
				
				REST\Response::addUpdater( [ "data/table/row", "/api/v1/contacts/{$origin}/addresses", $hashid ], $data );
			}
			
			return static::restResponse( $result );
		}
		
		/* ###  PUBLIC REST CONFIG FUNCTIONS  #############################	# */
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/contacts/{hashid}/addresses
		 * @route.description	REST-Konfiguration für Adressen-Tabelle
		 */
		public static function restConfigOverview() : REST\Generator\Base\BaseGenerator {
			return REST\Response::addWrapper( "overview", "Adressen" )
				->get()
					->setApi( "/contacts/{hashid}/addresses" )
					->setAction( "/contacts/{hashid}/addresses/{hashid}" )
					->setOrder( "name", "asc" )
					->setSearch( TRUE )
				
					->addButton(...Hooks::filter( "rest.generator::button.name->create", [], "contacts" ))
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->icon", [
						"label"			=> Contacts\Addresses\Type::label(),
						"icon"			=> Contacts\Addresses\Type::icon(),
						"options"		=> Contacts\Addresses\Type::getAll(),
					], "type", [], "contacts", "hashid" ))
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "custom_id", TRUE, TRUE, TRUE, "contacts" ))
					->addColumn(...Hooks::filter( "rest.generator::column.type->status", [], "status", [], "contacts", "hashid" ))
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->icon", [
						"label"			=> Contacts\Addresses\Category::label(),
						"icon"			=> Contacts\Addresses\Category::icon(),
						"options"		=> Contacts\Addresses\Category::getAll(),
					], "category", [], "contacts", "hashid" ))
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "company_name", TRUE, TRUE, TRUE, "contacts" ))
					->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "firstname", TRUE, TRUE, TRUE, "contacts" ))
					->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "lastname", TRUE, TRUE, TRUE, "contacts" ))
					->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "email", TRUE, TRUE, TRUE, "contacts" ))
					
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->status", [
						"label"			=> Contacts\Addresses\Invoice::label(),
						"icon"			=> Contacts\Addresses\Invoice::icon(),
						"options"		=> Contacts\Addresses\Invoice::getAll(),
					], "invoice", [], "contacts", "hashid" ))
				
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->icon", [
						"label"			=> Contacts\Addresses\Reachability::label(),
						"icon"			=> Contacts\Addresses\Reachability::icon(),
						"options"		=> Contacts\Addresses\Reachability::getAll(),
					], "reachability", [], "contacts", "hashid" ))
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->datetime", [], "date_edit", FALSE, FALSE, TRUE, "contacts" ))
				
					->addColumn(...Hooks::filter( "rest.generator::column.type->actions", [], [], FALSE, "contacts" ))->get()
						->addButton(...Hooks::filter( "rest.generator::action.name->edit", [], "contacts", "hashid" ))
						->addButton(...Hooks::filter( "rest.generator::action.name->delete", [], "contacts", "hashid" ));
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}
		 * @route.alternative.0	/contacts/{hashid}/addresses/{hashid}#kontext
		 * @route.alternative.1	/contacts/{hashid}/addresses/{hashid}#chat
		 * @route.alternative.2	/contacts/{hashid}/addresses/{hashid}#telefon
		 * @route.description	REST-Konfiguration für Detailansicht einer Addresses
		 */
		public static function restConfigDetails( int|string $origin, int|string $hashid ) : REST\Generator\Base\BaseGenerator {
			$origin		= Contacts\Model::getValue( $origin, "hashid" );
			$current	= Contacts\Addresses\Model::get( $hashid );
			
			return REST\Response::addModal( "details", "Adresse bearbeiten" )
				->setSize( "max" )
				->setWidth( "lg" )
				->get()
					->setApi( "/contacts/{$origin}/addresses/{$hashid}" )
					->setAction( "/contacts/{$origin}/addresses/{$hashid}", "PUT" )
				
					->addTab( "Kontaktdaten", "contactdata" )->get()
						->setIcon( "bi-person-vcard" )
						->addHeadline( "Kontakt", 2 )
					
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "name", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "street", TRUE, "contacts/{$origin}/addresses" ))
						
						->addField(...Hooks::filter( "rest.generator::control.type->select", [
							"label"			=> Contacts\Addresses\Primary::label(),
							"options"		=> Attribute\Status::getAll(),
						], "is_primary", TRUE, FALSE, "contacts/{$origin}/addresses" ))
						
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "line_1", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "line_2", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "zipcode", TRUE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "city", TRUE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "country", TRUE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
				
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
				
						->parent()
				
					->addCallable( [ Plugins\Logs\API\v1\Controller::class, "restConfigTab" ], $hashid )
					
					->addTab( "Speichern" )->get()
						->setColor( REST\Generator\Config\Color::Primary )
						->setIcon( "bi bi-save" )
						->setType( "submit" );
				;
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/contacts/{hashid}/addresses/create
		 * @route.description	REST-Konfiguration für das Erstellen einer Adresse (Formular)
		 */
		public static function restConfigCreate( int|string $origin ) : REST\Generator\Base\BaseGenerator {
			$origin		= Contacts\Model::getValue( $origin, "hashid" );
			
			return REST\Response::addModal( "details", "Adresse erstellen" )
				->get()
					->setAction( "/contacts/{$origin}/addresses", "POST" )
				
					->addButton(...Hooks::filter( "rest.generator::button.type->submit", [], "Erstellen", "contacts" ))
					
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "name", FALSE, "contacts/{$origin}/addresses" ))
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "street", TRUE, "contacts/{$origin}/addresses" ))
					
					->addField(...Hooks::filter( "rest.generator::control.type->select", [
						"label"			=> Contacts\Addresses\Primary::label(),
						"options"		=> Attribute\Status::getAll(),
					], "is_primary", TRUE, FALSE, "contacts/{$origin}/addresses" ))
					
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "line_1", FALSE, "contacts/{$origin}/addresses" ))
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "line_2", FALSE, "contacts/{$origin}/addresses" ))
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "zipcode", TRUE, "contacts/{$origin}/addresses" ))
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "city", TRUE, "contacts/{$origin}/addresses" ))
					->addField(...Hooks::filter( "rest.generator::control.type->text", [], "country", TRUE, "contacts/{$origin}/addresses" ))
					->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "notes ", FALSE, "contacts/{$origin}/addresses" ))
				;
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/contacts/{hashid}/addresses/{hashid}/delete
		 * @route.description	REST-Konfiguration für die Lösch-Bestätigung einer Adresse
		 */
		public static function restConfigDeleteOwn( int|string $origin, int|string $hashid ) : REST\Generator\Base\BaseGenerator {
			return REST\Response::addModal( "details", "Adresse Löschen" )
				->setSize( REST\Wrapper\Modal\Size::sm )
				->get()
					->setAction( "/contacts/{$origin}/addresses/{$hashid}", "DELETE" )
					->addText( "Möchtest du wirklich den Datensatz (#{$hashid}) löschen? " )
					->addButton(...Hooks::filter( "rest.generator::button.type->cancel", [], NULL, "contacts" ))
					->addButton(...Hooks::filter( "rest.generator::button.type->delete", [], NULL, "contacts" ));
		}
		
		/* ###  PUBLIC REST EXTENSION FUNCTIONS  ##########################	# */
		public static function restConfigTable( int|string $origin ) : REST\Generator\Base\BaseGenerator {
			
			$table = REST\Generator\Data\Table::create()
				->setApi( "/contacts/{$origin}/addresses" )
				->setAction( "/contacts/{$origin}/addresses/{hashid}" )
				
				->setOrder( "name", "asc" )
				->setSearch( TRUE )
				
				->addButton(...Hooks::filter( "rest.generator::button.name->create", [], "contacts/{$origin}/addresses" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->status", [], "status", [], "contacts/{$origin}/addresses", "hashid" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->status", [
					"label"			=> Contacts\Addresses\Primary::getSingular(),
					"icon"			=> Contacts\Addresses\Primary::getIcon(),
					"options"		=> Contacts\Addresses\Primary::getAll(),
					"action"		=> [
						"route"			=> "/contacts/{$origin}/addresses/{hashid}/primary",
					],
				], "is_primary", [], "contacts/{$origin}/addresses/{hashid}", "hashid" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "name", TRUE, TRUE, TRUE, "contacts/{origin_id}/addresses" ))
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "street", TRUE, TRUE, TRUE, "contacts/{origin_id}/addresses" ))
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "zipcode", TRUE, TRUE, TRUE, "contacts/{origin_id}/addresses" ))
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "city", TRUE, TRUE, TRUE, "contacts/{origin_id}/addresses" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->datetime", [], "date_edit", FALSE, FALSE, TRUE, "contacts/{id}/addresses" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->actions", [], [], FALSE, "contacts/{id}/addresses" ))->get()
					->addButton(...Hooks::filter( "rest.generator::action.name->edit", [], "contacts/{$origin}/addresses", "hashid" ))
					->addButton(...Hooks::filter( "rest.generator::action.name->delete", [], "contacts/{$origin}/addresses", "hashid" ))
				;
			
			return $table;
		}
	}