Initial Version

2025-12-21 10:09:54 -05:00
commit 4ae6befc7b
422 changed files with 47225 additions and 0 deletions
--- a/shared/lib/Resource/Provider/ResourceServiceLocationSocketSole.php
+++ b/shared/lib/Resource/Provider/ResourceServiceLocationSocketSole.php
@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Provider;
+
+/**
+ * Resource Service Location Socket Sole
+ * 
+ * Single socket-based service location for services using a single host/port combination
+ * (e.g., JMAP, unified mail servers).
+ * 
+ * @since 2025.05.01
+ */
+interface ResourceServiceLocationSocketSole extends ResourceServiceLocationInterface {
+
+    /**
+     * Gets the complete location string
+     * 
+     * @since 2025.05.01
+     * 
+     * @return string Location (e.g., "mail.example.com:993")
+     */
+    public function location(): string;
+
+    /**
+     * Gets the host
+     * 
+     * @since 2025.05.01
+     * 
+     * @return string Host (e.g., "mail.example.com")
+     */
+    public function getHost(): string;
+
+    /**
+     * Sets the host
+     * 
+     * @since 2025.05.01
+     * 
+     * @param string $value
+     * 
+     * @return void
+     */
+    public function setHost(string $value): void;
+
+    /**
+     * Gets the port
+     * 
+     * @since 2025.05.01
+     * 
+     * @return int Port number
+     */
+    public function getPort(): int;
+
+    /**
+     * Sets the port
+     * 
+     * @since 2025.05.01
+     * 
+     * @param int $value
+     * 
+     * @return void
+     */
+    public function setPort(int $value): void;
+
+    /**
+     * Gets the encryption/security mode
+     * 
+     * @since 2025.12.01
+     * 
+     * @return string One of: 'none', 'ssl', 'tls', 'starttls'
+     */
+    public function getEncryption(): string;
+
+    /**
+     * Sets the encryption/security mode
+     * 
+     * @since 2025.12.01
+     * 
+     * @param string $value One of: 'none', 'ssl', 'tls', 'starttls'
+     * 
+     * @return void
+     */
+    public function setEncryption(string $value): void;
+
+    /**
+     * Gets whether to verify SSL/TLS peer certificate
+     * 
+     * @since 2025.12.01
+     * 
+     * @return bool
+     */
+    public function getVerifyPeer(): bool;
+
+    /**
+     * Sets whether to verify SSL/TLS peer certificate
+     * 
+     * @since 2025.12.01
+     * 
+     * @param bool $value
+     * 
+     * @return void
+     */
+    public function setVerifyPeer(bool $value): void;
+
+    /**
+     * Gets whether to verify SSL/TLS certificate host
+     * 
+     * @since 2025.12.01
+     * 
+     * @return bool
+     */
+    public function getVerifyHost(): bool;
+
+    /**
+     * Sets whether to verify SSL/TLS certificate host
+     * 
+     * @since 2025.12.01
+     * 
+     * @param bool $value
+     * 
+     * @return void
+     */
+    public function setVerifyHost(bool $value): void;
+
+}