refactor: moves authentication interfaces to HTTP domain

Author: JasonTheAdams

src/Providers/Contracts/AuthenticationInterface.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient\Providers\Http\Contracts;
+
+use WordPress\AiClient\Providers\Http\DTO\Request;
+
+/**
+ * Interface for HTTP request authentication.
+ *
+ * @since 1.0.0
+ */
+interface RequestAuthenticationInterface
+{
+    /**
+     * Authenticates an HTTP request.
+     *
+     * @since 1.0.0
+     *
+     * @param Request $request The request to authenticate.
+     * @return void
+     */
+    public function authenticate(Request $request): void;
+
+    /**
+     * Returns the JSON schema for this authentication.
+     *
+     * @since 1.0.0
+     *
+     * @return array<string, mixed> The JSON schema.
+     */
+    public static function getJsonSchema(): array;
+}

src/Providers/Http/Contracts/RequestAuthenticationInterface.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient\Providers\Http\Contracts;
+
+/**
+ * Interface for models that require HTTP transport capabilities.
+ *
+ * @since 1.0.0
+ */
+interface WithHttpTransporterInterface
+{
+    /**
+     * Sets the HTTP transporter.
+     *
+     * @since 1.0.0
+     *
+     * @param HttpTransporterInterface $transporter The HTTP transporter instance.
+     * @return void
+     */
+    public function setHttpTransporter(HttpTransporterInterface $transporter): void;
+
+    /**
+     * Returns the HTTP transporter.
+     *
+     * @since 1.0.0
+     *
+     * @return HttpTransporterInterface The HTTP transporter instance.
+     */
+    public function getHttpTransporter(): HttpTransporterInterface;
+}

src/Providers/Http/Contracts/WithHttpTransporterInterface.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient\Providers\Http\Contracts;
+
+/**
+ * Interface for models that support request authentication.
+ *
+ * @since 1.0.0
+ */
+interface WithRequestAuthenticationInterface
+{
+    /**
+     * Sets the request authentication.
+     *
+     * @since 1.0.0
+     *
+     * @param RequestAuthenticationInterface $authentication The authentication instance.
+     * @return void
+     */
+    public function setRequestAuthentication(RequestAuthenticationInterface $authentication): void;
+
+    /**
+     * Returns the request authentication.
+     *
+     * @since 1.0.0
+     *
+     * @return RequestAuthenticationInterface The authentication instance.
+     */
+    public function getRequestAuthentication(): RequestAuthenticationInterface;
+}