refactor: docs

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

shared/lib/Mail/Provider/ProviderBaseInterface.php

@@ -13,15 +13,15 @@ use KTXF\Mail\Service\ServiceBaseInterface;
 use KTXF\Resource\Provider\ResourceProviderBaseInterface;
 
 /**
- * Mail Provider Base Interface
+ * Provider Base Interface
  * 
- * Core interface for mail providers with context-aware service discovery.
+ * Core interface for providers with context-aware service discovery.
  * 
  * @since 2025.05.01
  */
 interface ProviderBaseInterface extends ResourceProviderBaseInterface{
 
-    public const JSON_TYPE = 'mail.provider';
+    public const JSON_TYPE = 'mail:provider';
     
     /**
      * Finds a service that handles a specific email address

shared/lib/Mail/Provider/ProviderServiceDiscoverInterface.php

@@ -12,11 +12,11 @@ namespace KTXF\Mail\Provider;
 use KTXF\Resource\Provider\ResourceServiceLocationInterface;
 
 /**
- * Mail Provider Autodiscovery Interface
+ * Provider Autodiscovery Interface
  * 
- * Optional interface for mail providers that support automatic service discovery
+ * Optional interface for providers that support automatic service discovery
  * from email addresses or domains. Providers implementing this interface can
- * discover mail service configurations using various methods specific to their
+ * discover service configurations using various methods specific to their
  * protocol or provider type.
  * 
  * Examples:

shared/lib/Mail/Provider/ProviderServiceMutateInterface.php

@@ -12,11 +12,9 @@ namespace KTXF\Mail\Provider;
 use KTXF\Resource\Provider\ResourceProviderServiceMutateInterface;
 
 /**
- * Mail Provider Service Mutate Interface
+ * Provider Service Mutate Interface
  * 
- * Optional interface for providers that support service CRUD operations.
- * 
- * Implementations return ServiceMutableInterface instances (which extend ResourceServiceMutateInterface).
+ * Optional interface for providers that support service CRUD operations
  * 
  * @since 2025.05.01
  * 
@@ -28,6 +26,5 @@ use KTXF\Resource\Provider\ResourceProviderServiceMutateInterface;
 interface ProviderServiceMutateInterface extends ResourceProviderServiceMutateInterface {
 
 	// Methods inherited from ResourceProviderServiceMutateInterface
-	// Implementations should return/accept ServiceMutableInterface instances
 
 }

shared/lib/Mail/Provider/ProviderServiceTestInterface.php

@@ -13,16 +13,9 @@ use KTXF\Mail\Service\ServiceBaseInterface;
 use KTXF\Mail\Service\ServiceMutableInterface;
 
 /**
- * Mail Provider Service Test Interface
+ * Provider Service Test Interface
  * 
- * Optional interface for mail providers that support testing service connections.
- * Providers implementing this interface can validate connection parameters,
- * test authentication, and verify service availability before creating a
- * persistent service configuration.
- * 
- * Supports two testing modes:
- * 1. Testing an existing service (validate current configuration)
- * 2. Testing a fresh configuration (validate before saving)
+ * Optional interface for providers that support testing service connections
  * 
  * @since 2025.05.01
  */
@@ -33,12 +26,7 @@ interface ProviderServiceTestInterface {
     /**
      * Test a service connection
      * 
-     * Tests connectivity, authentication, and capabilities of a service.
-     * 
-     * For new services: use serviceFresh() to create a service, configure it with
-     * setters, then pass it to this method for testing before persisting.
-     * 
-     * For existing services: fetch the service and pass it directly.
+     * Tests connectivity, authentication, and capabilities of a service
      * 
      * @since 2025.05.01
      * 
@@ -51,28 +39,8 @@ interface ProviderServiceTestInterface {
      * 
      * @return array Test results in the format:
      * [
-     *   'success' => bool,
+     *   'disposition' => 'Success' | 'Failure' | 'Warning',
      *   'message' => 'Connection successful' | 'Error message',
-     *   'details' => [
-     *     'connected' => bool,               // Socket/HTTP connection succeeded
-     *     'authenticated' => bool,            // Authentication succeeded
-     *     'capabilities' => ['IMAP4rev1', ...],  // Server capabilities (if applicable)
-     *     'serverInfo' => 'Server version/banner',
-     *     'latency' => 123,                   // Connection time in milliseconds
-     *     'protocols' => [
-     *       'inbound' => [
-     *         'connected' => bool,
-     *         'authenticated' => bool,
-     *         'error' => 'error message if failed'
-     *       ],
-     *       'outbound' => [                   // For split-socket (IMAP+SMTP)
-     *         'connected' => bool,
-     *         'authenticated' => bool,
-     *         'error' => 'error message if failed'
-     *       ]
-     *     ],
-     *     'errors' => ['Error 1', 'Error 2'],  // List of errors encountered
-     *   ]
      * ]
      */
     public function serviceTest(ServiceBaseInterface|ServiceMutableInterface $service, array $options = []): array;