Add minimal DTOs

Author: valzargaming

src/MLS/Credentials/BasicCredential.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Credentials;
+
+class BasicCredential implements CredentialInterface
+{
+    protected string $type;
+    protected string $identity;
+    protected string $publicKey;
+
+    public function __construct(string $type, string $identity, string $publicKey)
+    {
+        $this->type = $type;
+        $this->identity = $identity;
+        $this->publicKey = $publicKey;
+    }
+
+    public function getCredentialType(): string
+    {
+        return $this->type;
+    }
+
+    public function getIdentity(): string
+    {
+        return $this->identity;
+    }
+
+    public function getPublicKey(): string
+    {
+        return $this->publicKey;
+    }
+
+    public function verifySignature(string $message, string $signature): bool
+    {
+        // Minimal stub: concrete implementations should verify with the proper algorithm.
+        return false;
+    }
+
+    public function __toString(): string
+    {
+        return $this->identity;
+    }
+}

src/MLS/Crypto/BasicCipherSuite.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Crypto;
+
+class BasicCipherSuite implements CipherSuiteInterface
+{
+    protected int $id;
+
+    public function __construct(int $id = 1)
+    {
+        $this->id = $id;
+    }
+
+    public function getId(): int
+    {
+        return $this->id;
+    }
+
+    public function getHpkeKemId(): int
+    {
+        return 32;
+    }
+
+    public function getHpkeKdfId(): int
+    {
+        return 1;
+    }
+
+    public function getHpkeAeadId(): int
+    {
+        return 1;
+    }
+
+    public function getHashLength(): int
+    {
+        return 32;
+    }
+}

src/MLS/Handshake/BasicKeyPackage.php

@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Handshake;
+
+use MLS\Credentials\CredentialInterface;
+use MLS\Crypto\CipherSuiteInterface;
+
+class BasicKeyPackage implements KeyPackageInterface
+{
+    protected int $version;
+    protected CipherSuiteInterface $suite;
+    protected string $initKey;
+    protected CredentialInterface $credential;
+    protected array $extensions;
+
+    public function __construct(int $version, CipherSuiteInterface $suite, string $initKey, CredentialInterface $credential, array $extensions = [])
+    {
+        $this->version = $version;
+        $this->suite = $suite;
+        $this->initKey = $initKey;
+        $this->credential = $credential;
+        $this->extensions = $extensions;
+    }
+
+    public function getProtocolVersion(): int
+    {
+        return $this->version;
+    }
+
+    public function getCipherSuite(): CipherSuiteInterface
+    {
+        return $this->suite;
+    }
+
+    public function getInitKey(): string
+    {
+        return $this->initKey;
+    }
+
+    public function getCredential(): CredentialInterface
+    {
+        return $this->credential;
+    }
+
+    public function getExtensions(): array
+    {
+        return $this->extensions;
+    }
+
+    public function verify(): bool
+    {
+        // Minimal stub: assume credential verifies signature of KeyPackage
+        return true;
+    }
+}

src/MLS/Handshake/KeyPackageBundle.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Handshake;
+
+class KeyPackageBundle implements KeyPackageBundleInterface
+{
+    /** @var KeyPackageInterface[] */
+    protected array $keyPackages = [];
+    /** @var array<string,mixed> */
+    protected array $associatedSecrets = [];
+    /** @var array */
+    protected array $extensions = [];
+
+    /** @param KeyPackageInterface[] $keyPackages */
+    public function __construct(array $keyPackages = [], array $associatedSecrets = [], array $extensions = [])
+    {
+        $this->keyPackages = $keyPackages;
+        $this->associatedSecrets = $associatedSecrets;
+        $this->extensions = $extensions;
+    }
+
+    /** @return KeyPackageInterface[] */
+    public function getKeyPackages(): array
+    {
+        return $this->keyPackages;
+    }
+
+    /** @return array<string,mixed> */
+    public function getAssociatedSecrets(): array
+    {
+        return $this->associatedSecrets ?? [];
+    }
+
+    /** @return array */
+    public function getExtensions(): array
+    {
+        return $this->extensions ?? [];
+    }
+
+    public function verifyAll(): bool
+    {
+        foreach ($this->getKeyPackages() as $kp) {
+            if (! $kp->verify()) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    public function serialize(): string
+    {
+        // Minimal stable serialization for testing; concrete implementations should use real encodings
+        return json_encode([
+            'count' => count($this->keyPackages),
+        ]);
+    }
+}

src/MLS/Message/BasicSender.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Message;
+
+class BasicSender implements SenderInterface
+{
+    protected int $type;
+    protected ?int $leafIndex;
+    protected ?int $senderIndex;
+
+    public function __construct(int $type = self::TYPE_MEMBER, ?int $leafIndex = null, ?int $senderIndex = null)
+    {
+        $this->type = $type;
+        $this->leafIndex = $leafIndex;
+        $this->senderIndex = $senderIndex;
+    }
+
+    public function getType(): int
+    {
+        return $this->type;
+    }
+
+    public function getLeafIndex(): ?int
+    {
+        return $this->leafIndex;
+    }
+
+    public function getSenderIndex(): ?int
+    {
+        return $this->senderIndex;
+    }
+}

src/MLS/Proposal/BasicProposal.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Proposal;
+
+use MLS\Message\SenderInterface;
+
+class BasicProposal implements ProposalInterface
+{
+    protected string $type;
+    protected SenderInterface $sender;
+    protected array $proposal;
+
+    public function __construct(string $type, SenderInterface $sender, array $proposal = [])
+    {
+        $this->type = $type;
+        $this->sender = $sender;
+        $this->proposal = $proposal;
+    }
+
+    public function getType(): string
+    {
+        return $this->type;
+    }
+
+    public function getSender(): SenderInterface
+    {
+        return $this->sender;
+    }
+
+    public function getProposal(): array
+    {
+        return $this->proposal;
+    }
+}

src/MLS/Proposal/ProposalList.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Proposal;
+
+class ProposalList implements ProposalListInterface
+{
+    /** @var ProposalInterface[] */
+    protected array $proposals = [];
+
+    /** @param ProposalInterface[] $proposals */
+    public function __construct(array $proposals = [])
+    {
+        foreach ($proposals as $p) {
+            $this->addProposal($p);
+        }
+    }
+
+    /** @return ProposalInterface[] */
+    public function getProposals(): array
+    {
+        return $this->proposals;
+    }
+
+    public function addProposal(ProposalInterface $proposal): void
+    {
+        $this->proposals[] = $proposal;
+    }
+
+    public function count(): int
+    {
+        return count($this->proposals);
+    }
+}

src/MLS/Tree/TreeInterface.php

@@ -30,7 +30,7 @@ public function getParent(int $index): ?ParentNodeInterface;
     /**
      * Compute the path for a leaf index.
      *
-     * @param int $leafIndex
+     * @param  int                             $leafIndex
      * @return \MLS\Commit\UpdatePathInterface
      */
     public function computePath(int $leafIndex): UpdatePathInterface;