feat: adds auth files

Author: JasonTheAdams

src/Providers/Contracts/AuthenticationInterface.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient\Providers\Contracts;
+
+use WordPress\AiClient\Common\Contracts\WithJsonSchemaInterface;
+use WordPress\AiClient\Http\DTO\Request;
+
+/**
+ * Interface for authentication implementations.
+ *
+ * Provides a contract for different authentication mechanisms
+ * to modify HTTP requests with appropriate credentials.
+ *
+ * @since n.e.x.t
+ */
+interface AuthenticationInterface extends WithJsonSchemaInterface
+{
+    /**
+     * Authenticates a request.
+     *
+     * @since n.e.x.t
+     *
+     * @param Request $request The request to authenticate.
+     * @return Request The authenticated request.
+     */
+    public function authenticate(Request $request): Request;
+}

src/Providers/Models/Contracts/WithAuthenticationInterface.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient\Providers\Models\Contracts;
+
+use WordPress\AiClient\Providers\Contracts\AuthenticationInterface;
+
+/**
+ * Interface for models that support authentication.
+ *
+ * Models implementing this interface can have authentication
+ * mechanisms configured for API requests.
+ *
+ * @since n.e.x.t
+ */
+interface WithAuthenticationInterface
+{
+    /**
+     * Sets the authentication mechanism.
+     *
+     * @since n.e.x.t
+     *
+     * @param AuthenticationInterface $authentication The authentication implementation.
+     * @return void
+     */
+    public function setAuthentication(AuthenticationInterface $authentication): void;
+
+    /**
+     * Gets the authentication mechanism.
+     *
+     * @since n.e.x.t
+     *
+     * @return AuthenticationInterface The authentication implementation.
+     */
+    public function getAuthentication(): AuthenticationInterface;
+}