Initial Version

shared/lib/Resource/Provider/ResourceServiceLocationInterface.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Provider;
+
+use JsonSerializable;
+
+/**
+ * Resource Service Location Interface
+ * 
+ * Unified interface supporting both URI-based (API services) and socket-based
+ * (traditional IMAP/SMTP) connection configurations.
+ * 
+ * @since 2025.05.01
+ */
+interface ResourceServiceLocationInterface extends JsonSerializable {
+
+    public const TYPE_URI = 'URI';
+    public const TYPE_SOCKET_SOLE = 'SOCKET_SOLE';
+    public const TYPE_SOCKET_SPLIT = 'SOCKET_SPLIT';
+    public const TYPE_FILE = 'FILE';
+
+    /**
+     * Gets the service location type
+     * 
+     * @since 2025.05.01
+     * 
+     * @return string One of: TYPE_URI, TYPE_SOCKET_SOLE, TYPE_SOCKET_SPLIT, TYPE_FILE
+     */
+    public function type(): string;
+}