Initial Version

shared/lib/Mail/Service/ServiceIdentityApiKey.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Mail\Service;
+
+/**
+ * Mail Service API Key Identity Implementation
+ * 
+ * API key authentication for transactional mail services.
+ * 
+ * @since 2025.05.01
+ */
+class ServiceIdentityApiKey implements IServiceIdentityApiKey {
+
+    /**
+     * @param string $apiKey API key
+     * @param string|null $apiKeyId Optional API key identifier
+     */
+    public function __construct(
+        private string $apiKey,
+        private ?string $apiKeyId = null,
+    ) {}
+
+    /**
+     * Creates from array data
+     * 
+     * @since 2025.05.01
+     * 
+     * @param array $data
+     * 
+     * @return self
+     */
+    public static function fromArray(array $data): self {
+        return new self(
+            $data['apiKey'] ?? '',
+            $data['apiKeyId'] ?? null,
+        );
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getType(): string {
+        return self::TYPE_APIKEY;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getApiKey(): string {
+        return $this->apiKey;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getApiKeyId(): ?string {
+        return $this->apiKeyId;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function jsonSerialize(): array {
+        return array_filter([
+            'type' => self::TYPE_APIKEY,
+            'apiKeyId' => $this->apiKeyId,
+            // API key intentionally omitted from serialization for security
+        ], fn($v) => $v !== null);
+    }
+
+}