Add ApplicationSettings bounded context for issue #67

config/xml/Bitrix24.Lib.ApplicationSettings.Entity.ApplicationSetting.dcm.xml

@@ -0,0 +1,28 @@
+<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
+                  xmlns:xs="https://www.w3.org/2001/XMLSchema"
+                  xmlns:orm="https://www.doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
+    <entity name="Bitrix24\Lib\ApplicationSettings\Entity\ApplicationSetting"
+            table="application_setting">
+        <id name="id" type="uuid" column="id">
+
+        </id>
+
+        <field name="applicationInstallationId" type="uuid" column="application_installation_id" nullable="false"/>
+
+        <field name="key" type="string" column="key" length="255" nullable="false"/>
+
+        <field name="value" type="text" column="value" nullable="false"/>
+
+        <field name="createdAt" type="carbon_immutable" column="created_at_utc" precision="3" nullable="false"/>
+
+        <field name="updatedAt" type="carbon_immutable" column="updated_at_utc" precision="3" nullable="false"/>
+
+        <unique-constraints>
+            <unique-constraint columns="application_installation_id,key" name="unique_app_installation_key"/>
+        </unique-constraints>
+
+        <indexes>
+            <index name="idx_application_installation_id" columns="application_installation_id"/>
+        </indexes>
+    </entity>
+</doctrine-mapping>

src/ApplicationSettings/Entity/ApplicationSetting.php

@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bitrix24\Lib\ApplicationSettings\Entity;
+
+use Bitrix24\Lib\AggregateRoot;
+use Bitrix24\SDK\Core\Exceptions\InvalidArgumentException;
+use Carbon\CarbonImmutable;
+use Symfony\Component\Uid\Uuid;
+
+/**
+ * Application setting entity
+ *
+ * Stores key-value settings for application installations.
+ * Each ApplicationInstallation can have multiple settings identified by unique keys.
+ */
+class ApplicationSetting extends AggregateRoot
+{
+    private readonly CarbonImmutable $createdAt;
+    private CarbonImmutable $updatedAt;
+    private string $value;
+
+    public function __construct(
+        private readonly Uuid $id,
+        private readonly Uuid $applicationInstallationId,
+        private readonly string $key,
+        string $value
+    ) {
+        $this->validateKey($key);
+        $this->validateValue($value);
+
+        $this->value = $value;
+        $this->createdAt = new CarbonImmutable();
+        $this->updatedAt = new CarbonImmutable();
+    }
+
+    public function getId(): Uuid
+    {
+        return $this->id;
+    }
+
+    public function getApplicationInstallationId(): Uuid
+    {
+        return $this->applicationInstallationId;
+    }
+
+    public function getKey(): string
+    {
+        return $this->key;
+    }
+
+    public function getValue(): string
+    {
+        return $this->value;
+    }
+
+    public function getCreatedAt(): CarbonImmutable
+    {
+        return $this->createdAt;
+    }
+
+    public function getUpdatedAt(): CarbonImmutable
+    {
+        return $this->updatedAt;
+    }
+
+    /**
+     * Update setting value
+     */
+    public function updateValue(string $value): void
+    {
+        $this->validateValue($value);
+
+        if ($this->value !== $value) {
+            $this->value = $value;
+            $this->updatedAt = new CarbonImmutable();
+        }
+    }
+
+    /**
+     * Validate setting key
+     */
+    private function validateKey(string $key): void
+    {
+        if ('' === trim($key)) {
+            throw new InvalidArgumentException('Setting key cannot be empty');
+        }
+
+        if (strlen($key) > 255) {
+            throw new InvalidArgumentException('Setting key cannot exceed 255 characters');
+        }
+
+        // Key should contain only alphanumeric characters, underscores, dots, and hyphens
+        if (!preg_match('/^[a-zA-Z0-9_.-]+$/', $key)) {
+            throw new InvalidArgumentException(
+                'Setting key can only contain alphanumeric characters, underscores, dots, and hyphens'
+            );
+        }
+    }
+
+    /**
+     * Validate setting value
+     */
+    private function validateValue(string $value): void
+    {
+        // Value can be empty but not null (handled by type hint)
+        // We store value as string, could be JSON or plain text
+        // No specific validation needed here, can be extended if needed
+    }
+}

src/ApplicationSettings/Infrastructure/Doctrine/ApplicationSettingRepository.php

@@ -0,0 +1,102 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bitrix24\Lib\ApplicationSettings\Infrastructure\Doctrine;
+
+use Bitrix24\Lib\ApplicationSettings\Entity\ApplicationSetting;
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\ORM\EntityRepository;
+use Symfony\Component\Uid\Uuid;
+
+/**
+ * Repository for ApplicationSetting entity
+ *
+ * @extends EntityRepository<ApplicationSetting>
+ */
+class ApplicationSettingRepository extends EntityRepository
+{
+    public function __construct(EntityManagerInterface $entityManager)
+    {
+        parent::__construct($entityManager, $entityManager->getClassMetadata(ApplicationSetting::class));
+    }
+
+    /**
+     * Save application setting
+     */
+    public function save(ApplicationSetting $applicationSetting): void
+    {
+        $this->getEntityManager()->persist($applicationSetting);
+    }
+
+    /**
+     * Delete application setting
+     */
+    public function delete(ApplicationSetting $applicationSetting): void
+    {
+        $this->getEntityManager()->remove($applicationSetting);
+    }
+
+    /**
+     * Find setting by ID
+     */
+    public function findById(Uuid $id): ?ApplicationSetting
+    {
+        return $this->getEntityManager()
+            ->getRepository(ApplicationSetting::class)
+            ->createQueryBuilder('s')
+            ->where('s.id = :id')
+            ->setParameter('id', $id)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+
+    /**
+     * Find setting by application installation ID and key
+     */
+    public function findByApplicationInstallationIdAndKey(
+        Uuid $applicationInstallationId,
+        string $key
+    ): ?ApplicationSetting {
+        return $this->getEntityManager()
+            ->getRepository(ApplicationSetting::class)
+            ->createQueryBuilder('s')
+            ->where('s.applicationInstallationId = :applicationInstallationId')
+            ->andWhere('s.key = :key')
+            ->setParameter('applicationInstallationId', $applicationInstallationId)
+            ->setParameter('key', $key)
+            ->getQuery()
+            ->getOneOrNullResult();
+    }
+
+    /**
+     * Find all settings for application installation
+     *
+     * @return ApplicationSetting[]
+     */
+    public function findByApplicationInstallationId(Uuid $applicationInstallationId): array
+    {
+        return $this->getEntityManager()
+            ->getRepository(ApplicationSetting::class)
+            ->createQueryBuilder('s')
+            ->where('s.applicationInstallationId = :applicationInstallationId')
+            ->setParameter('applicationInstallationId', $applicationInstallationId)
+            ->orderBy('s.key', 'ASC')
+            ->getQuery()
+            ->getResult();
+    }
+
+    /**
+     * Delete all settings for application installation
+     */
+    public function deleteByApplicationInstallationId(Uuid $applicationInstallationId): void
+    {
+        $this->getEntityManager()
+            ->createQueryBuilder()
+            ->delete(ApplicationSetting::class, 's')
+            ->where('s.applicationInstallationId = :applicationInstallationId')
+            ->setParameter('applicationInstallationId', $applicationInstallationId)
+            ->getQuery()
+            ->execute();
+    }
+}

src/ApplicationSettings/UseCase/Delete/Command.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bitrix24\Lib\ApplicationSettings\UseCase\Delete;
+
+use Bitrix24\SDK\Core\Exceptions\InvalidArgumentException;
+use Symfony\Component\Uid\Uuid;
+
+/**
+ * Command to delete application setting
+ */
+readonly class Command
+{
+    public function __construct(
+        public Uuid $applicationInstallationId,
+        public string $key
+    ) {
+        $this->validate();
+    }
+
+    private function validate(): void
+    {
+        if ('' === trim($this->key)) {
+            throw new InvalidArgumentException('Setting key cannot be empty');
+        }
+    }
+}

src/ApplicationSettings/UseCase/Delete/Handler.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bitrix24\Lib\ApplicationSettings\UseCase\Delete;
+
+use Bitrix24\Lib\ApplicationSettings\Infrastructure\Doctrine\ApplicationSettingRepository;
+use Bitrix24\Lib\Services\Flusher;
+use Bitrix24\SDK\Core\Exceptions\InvalidArgumentException;
+use Psr\Log\LoggerInterface;
+
+/**
+ * Handler for Delete command
+ */
+readonly class Handler
+{
+    public function __construct(
+        private ApplicationSettingRepository $applicationSettingRepository,
+        private Flusher $flusher,
+        private LoggerInterface $logger
+    ) {
+    }
+
+    public function handle(Command $command): void
+    {
+        $this->logger->info('ApplicationSettings.Delete.start', [
+            'applicationInstallationId' => $command->applicationInstallationId->toRfc4122(),
+            'key' => $command->key,
+        ]);
+
+        $setting = $this->applicationSettingRepository->findByApplicationInstallationIdAndKey(
+            $command->applicationInstallationId,
+            $command->key
+        );
+
+        if (null === $setting) {
+            throw new InvalidArgumentException(
+                sprintf(
+                    'Setting with key "%s" not found for application installation "%s"',
+                    $command->key,
+                    $command->applicationInstallationId->toRfc4122()
+                )
+            );
+        }
+
+        $settingId = $setting->getId()->toRfc4122();
+        $this->applicationSettingRepository->delete($setting);
+        $this->flusher->flush();
+
+        $this->logger->info('ApplicationSettings.Delete.finish', [
+            'settingId' => $settingId,
+        ]);
+    }
+}

src/ApplicationSettings/UseCase/Get/Command.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bitrix24\Lib\ApplicationSettings\UseCase\Get;
+
+use Bitrix24\SDK\Core\Exceptions\InvalidArgumentException;
+use Symfony\Component\Uid\Uuid;
+
+/**
+ * Command to get application setting
+ */
+readonly class Command
+{
+    public function __construct(
+        public Uuid $applicationInstallationId,
+        public string $key
+    ) {
+        $this->validate();
+    }
+
+    private function validate(): void
+    {
+        if ('' === trim($this->key)) {
+            throw new InvalidArgumentException('Setting key cannot be empty');
+        }
+    }
+}