refactor: documents

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

shared/lib/Resource/Documents/Collection/CollectionBaseAbstract.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodeBaseAbstract;
+
+/**
+ * Abstract Chrono Collection Base Class
+ * 
+ * Provides common implementation for chrono collections
+ * 
+ * @since 2025.05.01
+ */
+abstract class CollectionBase extends NodeBaseAbstract implements CollectionBaseInterface {
+
+    protected CollectionPropertiesBaseAbstract $properties;
+
+    /**
+     * @inheritDoc
+     */
+    public function getProperties(): CollectionPropertiesBaseInterface {
+        return $this->properties;
+    }
+}

shared/lib/Resource/Documents/Collection/CollectionBaseInterface.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodeBaseInterface;
+
+/**
+ * Collection Base Interface
+ * 
+ * Interface represents a collection in a service
+ * 
+ * @since 2025.05.01
+ */
+interface CollectionBaseInterface extends NodeBaseInterface {
+
+    /**
+     * Gets the collection properties
+     * 
+     * @since 2025.05.01
+     */
+    public function getProperties(): CollectionPropertiesBaseInterface|CollectionPropertiesMutableInterface;
+
+}

shared/lib/Resource/Documents/Collection/CollectionContent.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use JsonSerializable;
+
+enum CollectionContent: string implements JsonSerializable {
+
+    case File = 'file';
+    case Folder = 'folder';
+
+    public function jsonSerialize(): string {
+        return $this->value;
+    }
+
+}

shared/lib/Resource/Documents/Collection/CollectionMutableAbstract.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodeMutableAbstract;
+use KTXF\Resource\Provider\Node\NodePropertiesMutableInterface;
+
+/**
+ * Abstract Chrono Collection Mutable Class
+ * 
+ * Provides common implementation for mutable chrono collections
+ * 
+ * @since 2025.05.01
+ */
+abstract class CollectionMutableAbstract extends NodeMutableAbstract implements CollectionMutableInterface {
+
+    protected CollectionPropertiesMutableAbstract $properties;
+
+    /**
+     * @inheritDoc
+     */
+    public function getProperties(): CollectionPropertiesMutableInterface {
+        return $this->properties;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setProperties(NodePropertiesMutableInterface $value): static {
+        if (!$value instanceof CollectionPropertiesMutableInterface) {
+            throw new \InvalidArgumentException('Properties must implement CollectionPropertiesMutableInterface');
+        }
+
+        // Copy all property values
+        $this->properties->setLabel($value->getLabel());
+
+        return $this;
+    }
+}

shared/lib/Resource/Documents/Collection/CollectionMutableInterface.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodeMutableInterface;
+
+/**
+ * Chrono Collection Mutable Interface
+ * 
+ * Interface for altering collection properties in a chrono service
+ * 
+ * @since 2025.05.01
+ * 
+ * @method static setProperties(CollectionPropertiesMutableInterface $value)
+ */
+interface CollectionMutableInterface extends CollectionBaseInterface, NodeMutableInterface {
+
+    /**
+     * Gets the collection properties (mutable)
+     * 
+     * @since 2025.05.01
+     */
+    public function getProperties(): CollectionPropertiesMutableInterface;
+
+}

shared/lib/Resource/Documents/Collection/CollectionPropertiesBaseAbstract.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodePropertiesBaseAbstract;
+
+/**
+ * Abstract Collection Properties Base Class
+ * 
+ * Provides common implementation for collection properties
+ * 
+ * @since 2025.05.01
+ */
+abstract class CollectionPropertiesBaseAbstract extends NodePropertiesBaseAbstract implements CollectionPropertiesBaseInterface {
+
+    public const JSON_TYPE = CollectionPropertiesBaseInterface::JSON_TYPE;
+
+    public function content(): CollectionContent {
+        $content = $this->data[self::JSON_PROPERTY_CONTENTS] ?? null;
+        if ($content instanceof CollectionContent) {
+            return $content;
+        }
+
+        if (is_string($content)) {
+            return CollectionContent::tryFrom($content) ?? CollectionContent::File;
+        }
+
+        return CollectionContent::File;
+    }
+
+    public function getLabel(): string {
+        return $this->data[self::JSON_PROPERTY_LABEL] ?? '';
+    }
+
+}

shared/lib/Resource/Documents/Collection/CollectionPropertiesBaseInterface.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodePropertiesBaseInterface;
+
+interface CollectionPropertiesBaseInterface extends NodePropertiesBaseInterface {
+
+	public const JSON_TYPE = 'document:collection';
+	public const JSON_PROPERTY_CONTENTS = 'content';
+	public const JSON_PROPERTY_LABEL = 'label';
+
+	public function content(): CollectionContent;
+
+	/**
+	 * Gets the human friendly name of this collection (e.g. Personal Calendar)
+	 *
+	 * @since 2025.05.01
+	 */
+	public function getLabel(): string;
+
+}

shared/lib/Resource/Documents/Collection/CollectionPropertiesMutableAbstract.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+/**
+ * Abstract Chrono Collection Properties Mutable Class
+ */
+abstract class CollectionPropertiesMutableAbstract extends CollectionPropertiesBaseAbstract implements CollectionPropertiesMutableInterface {
+
+    public const JSON_TYPE = CollectionPropertiesBaseInterface::JSON_TYPE;
+    
+    public function jsonDeserialize(array|string $data): static {
+        if (is_string($data)) {
+            $data = json_decode($data, true);
+        }
+
+        $this->data = $data;
+
+        return $this;
+    }
+    
+    public function setLabel(string $value): static {
+        $this->data[self::JSON_PROPERTY_LABEL] = $value;
+        return $this;
+    }
+
+}

shared/lib/Resource/Documents/Collection/CollectionPropertiesMutableInterface.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Collection;
+
+use KTXF\Resource\Provider\Node\NodePropertiesMutableInterface;
+
+interface CollectionPropertiesMutableInterface extends CollectionPropertiesBaseInterface, NodePropertiesMutableInterface {
+
+	public const JSON_TYPE = CollectionPropertiesBaseInterface::JSON_TYPE;
+
+	/**
+	 * Sets the human friendly name of this collection (e.g. Personal Calendar)
+	 *
+	 * @since 2025.05.01
+	 */
+	public function setLabel(string $value): static;
+
+}

shared/lib/Resource/Documents/Entity/EntityBaseAbstract.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodeBaseAbstract;
+
+/**
+ * Abstract Chrono Entity Base Class
+ * 
+ * Provides common implementation for chrono entities
+ * 
+ * @since 2025.05.01
+ */
+abstract class EntityBaseAbstract extends NodeBaseAbstract implements EntityBaseInterface {
+
+    protected EntityPropertiesBaseAbstract $properties;
+
+    /**
+     * @inheritDoc
+     */
+    public function getProperties(): EntityPropertiesBaseInterface {
+        return $this->properties;
+    }
+}

shared/lib/Resource/Documents/Entity/EntityBaseInterface.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodeBaseInterface;
+
+interface EntityBaseInterface extends NodeBaseInterface {
+
+    public const JSON_TYPE = 'document:entity';
+
+    /**
+     * Gets the entity properties
+     * 
+     * @since 2025.05.01
+     */
+    public function getProperties(): EntityPropertiesBaseInterface|EntityPropertiesMutableInterface;
+
+}

shared/lib/Resource/Documents/Entity/EntityMutableAbstract.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodeMutableAbstract;
+use KTXF\Resource\Provider\Node\NodePropertiesMutableInterface;
+
+/**
+ * Abstract Chrono Entity Mutable Class
+ * 
+ * Provides common implementation for mutable chrono entities
+ * 
+ * @since 2025.05.01
+ */
+abstract class EntityMutableAbstract extends NodeMutableAbstract implements EntityMutableInterface {
+
+    public const JSON_TYPE = EntityMutableInterface::JSON_TYPE;
+
+    protected EntityPropertiesMutableAbstract $properties;
+
+    /**
+     * @inheritDoc
+     */
+    public function getProperties(): EntityPropertiesMutableInterface {
+        return $this->properties;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setProperties(NodePropertiesMutableInterface $value): static {
+        if (!$value instanceof EntityPropertiesMutableInterface) {
+            throw new \InvalidArgumentException('Properties must implement EntityPropertiesMutableInterface');
+        }
+
+        $this->properties->setDataRaw($value->getDataRaw());
+
+        return $this;
+    }
+}

shared/lib/Resource/Documents/Entity/EntityMutableInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodeMutableInterface;
+
+/**
+ * @method static setProperties(EntityPropertiesMutableInterface $value)
+ */
+interface EntityMutableInterface extends EntityBaseInterface, NodeMutableInterface {
+
+    public const JSON_TYPE = EntityBaseInterface::JSON_TYPE;
+
+    /**
+     * Gets the entity properties (mutable)
+     * 
+     * @since 2025.05.01
+     */
+    public function getProperties(): EntityPropertiesMutableInterface;
+
+}

shared/lib/Resource/Documents/Entity/EntityPropertiesBaseAbstract.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodePropertiesBaseAbstract;
+
+abstract class EntityPropertiesBaseAbstract extends NodePropertiesBaseAbstract implements EntityPropertiesBaseInterface {
+
+    public const JSON_TYPE = EntityPropertiesBaseInterface::JSON_TYPE;
+
+    public function size(): int {
+        return $this->data[self::JSON_PROPERTY_SIZE] ?? 0;
+    }
+
+    public function getLabel(): string {
+        return $this->data[self::JSON_PROPERTY_LABEL] ?? '';
+    }
+
+    public function getMime(): string {
+        return $this->data[self::JSON_PROPERTY_MIME] ?? '';
+    }
+
+    public function getFormat(): string {
+        return $this->data[self::JSON_PROPERTY_FORMAT] ?? '';
+    }
+
+    public function getEncoding(): string {
+        return $this->data[self::JSON_PROPERTY_ENCODING] ?? '';
+    }
+
+}

shared/lib/Resource/Documents/Entity/EntityPropertiesBaseInterface.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodePropertiesBaseInterface;
+
+interface EntityPropertiesBaseInterface extends NodePropertiesBaseInterface {
+
+	public const JSON_TYPE = 'document:file';
+	public const JSON_PROPERTY_LABEL = 'label';
+	public const JSON_PROPERTY_SIZE = 'size';
+	public const JSON_PROPERTY_MIME = 'mime';
+	public const JSON_PROPERTY_FORMAT = 'format';
+	public const JSON_PROPERTY_ENCODING = 'encoding';
+	
+	public function size(): int;
+
+	public function getLabel(): string;
+
+	public function getMime(): string;
+
+	public function getFormat(): string;
+
+	public function getEncoding(): string;
+
+}

shared/lib/Resource/Documents/Entity/EntityPropertiesMutableAbstract.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+abstract class EntityPropertiesMutableAbstract extends EntityPropertiesBaseAbstract implements EntityPropertiesMutableInterface {
+
+    public const JSON_TYPE = EntityPropertiesBaseInterface::JSON_TYPE;
+
+    public function jsonDeserialize(array|string $data): static {
+        if (is_string($data)) {
+            $data = json_decode($data, true);
+        }
+
+        $this->data = $data;
+
+        return $this;
+    }
+
+    public function setLabel(string $value): static {
+        $this->data[self::JSON_PROPERTY_LABEL] = $value;
+        return $this;
+    }
+
+    public function setMime(string $value): static {
+        $this->data[self::JSON_PROPERTY_MIME] = $value;
+        return $this;
+    }
+
+    public function setFormat(string $value): static {
+        $this->data[self::JSON_PROPERTY_FORMAT] = $value;
+        return $this;
+    }
+
+    public function setEncoding(string $value): static {
+        $this->data[self::JSON_PROPERTY_ENCODING] = $value;
+        return $this;
+    }
+    
+}

shared/lib/Resource/Documents/Entity/EntityPropertiesMutableInterface.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Entity;
+
+use KTXF\Resource\Provider\Node\NodePropertiesMutableInterface;
+
+interface EntityPropertiesMutableInterface extends EntityPropertiesBaseInterface, NodePropertiesMutableInterface {
+
+	public const JSON_TYPE = EntityPropertiesBaseInterface::JSON_TYPE;
+
+	public function setLabel(string $value): static;
+
+	public function setMime(string $value): static;
+
+	public function setFormat(string $value): static;
+
+	public function setEncoding(string $value): static;
+
+}

shared/lib/Resource/Documents/Provider/ProviderBaseInterface.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Provider;
+
+use KTXF\Resource\Provider\ResourceProviderBaseInterface;
+
+/**
+ * Chrono Provider Base Interface
+ * 
+ * @since 2025.05.01
+ */
+interface ProviderBaseInterface extends ResourceProviderBaseInterface{
+
+    public const JSON_TYPE = 'document:provider';
+    
+}

shared/lib/Resource/Documents/Provider/ProviderServiceMutateInterface.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Provider;
+
+use KTXF\Resource\Provider\ResourceProviderServiceMutateInterface;
+
+/**
+ * Chrono Provider Service Mutate Interface
+ * 
+ * Optional interface for providers that support service CRUD operations.
+ * 
+ * Implementations return ServiceMutableInterface instances (which extend ResourceServiceMutateInterface).
+ * 
+ * @since 2025.05.01
+ * 
+ * @method ServiceMutableInterface serviceFresh() Construct a new blank chrono service instance
+ * @method string serviceCreate(string $tenantId, ?string $userId, ServiceMutableInterface $service) Create a chrono service configuration
+ * @method string serviceModify(string $tenantId, ?string $userId, ServiceMutableInterface $service) Modify a chrono service configuration
+ * @method bool serviceDestroy(string $tenantId, ?string $userId, ServiceMutableInterface $service) Delete a chrono service configuration
+ */
+interface ProviderServiceMutateInterface extends ProviderBaseInterface, ResourceProviderServiceMutateInterface {
+
+    public const JSON_TYPE = ProviderBaseInterface::JSON_TYPE;
+
+	// Methods inherited from ResourceProviderServiceMutateInterface
+	// Implementations should return/accept ServiceMutableInterface instances
+
+}

shared/lib/Resource/Documents/Provider/ProviderServiceTestInterface.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Provider;
+
+use KTXF\Resource\Documents\Service\ServiceBaseInterface;
+
+/**
+ * Chrono Provider Service Test Interface
+ * 
+ * Optional interface for chrono providers that support testing service connections.
+ * Providers implementing this interface can validate connection parameters,
+ * test authentication, and verify service availability before creating a
+ * persistent service configuration.
+ * 
+ * Supports two testing modes:
+ * 1. Testing an existing service (validate current configuration)
+ * 2. Testing a fresh configuration (validate before saving)
+ * 
+ * @since 2025.05.01
+ */
+interface ProviderServiceTestInterface extends ProviderBaseInterface {
+
+    /**
+     * Test a service connection
+     * 
+     * Tests connectivity, authentication, and capabilities of a service.
+     * 
+     * For new services: use serviceFresh() to create a service, configure it with
+     * setters, then pass it to this method for testing before persisting.
+     * 
+     * For existing services: fetch the service and pass it directly.
+     * 
+     * @since 2025.05.01
+     * 
+     * @param ServiceBaseInterface $service Service to test (can be fresh/unsaved or existing)
+     * @param array $options Provider-specific test options:
+     *   - 'timeout' => int (seconds, default: 10)
+     *   - 'verify_ssl' => bool (default: true)
+     *   - 'test_send' => bool (attempt test send if capable, default: false)
+     *   - 'test_receive' => bool (attempt mailbox access if capable, default: true)
+     * 
+     * @return array Test results in the format:
+     * [
+     *   'success' => bool,
+     *   'message' => 'Connection successful' | 'Error message'
+     * ]
+     */
+    public function serviceTest(ServiceBaseInterface $service, array $options = []): array;
+
+}

shared/lib/Resource/Documents/Service/ServiceBaseInterface.php

@@ -0,0 +1,199 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Service;
+
+use KTXF\Resource\Documents\Collection\CollectionBaseInterface;
+use KTXF\Resource\Delta\Delta;
+use KTXF\Resource\Filter\IFilter;
+use KTXF\Resource\Provider\ResourceServiceBaseInterface;
+use KTXF\Resource\Range\IRange;
+use KTXF\Resource\Range\RangeType;
+use KTXF\Resource\Sort\ISort;
+
+/**
+ * Chrono Service Base Interface
+ * 
+ * @since 2025.05.01
+ */
+interface ServiceBaseInterface extends ResourceServiceBaseInterface {
+
+    // Collection capabilities
+    public const CAPABILITY_COLLECTION_LIST = 'CollectionList';
+    public const CAPABILITY_COLLECTION_LIST_FILTER = 'CollectionListFilter';
+    public const CAPABILITY_COLLECTION_LIST_SORT = 'CollectionListSort';
+    public const CAPABILITY_COLLECTION_EXTANT = 'CollectionExtant';
+    public const CAPABILITY_COLLECTION_FETCH = 'CollectionFetch';
+    // Collection Filter
+    public const CAPABILITY_COLLECTION_FILTER_LABEL = 'label';
+    public const CAPABILITY_COLLECTION_FILTER_CONTENTS = 'contents';
+    // Collection Sort
+    public const CAPABILITY_COLLECTION_SORT_LABEL = 'label';
+    public const CAPABILITY_COLLECTION_SORT_RANK = 'rank';
+    // Entity capabilities
+    public const CAPABILITY_ENTITY_LIST = 'EntityList';
+    public const CAPABILITY_ENTITY_LIST_FILTER = 'EntityListFilter';
+    public const CAPABILITY_ENTITY_LIST_SORT = 'EntityListSort';
+    public const CAPABILITY_ENTITY_LIST_RANGE = 'EntityListRange';
+    public const CAPABILITY_ENTITY_DELTA = 'EntityDelta';
+    public const CAPABILITY_ENTITY_EXTANT = 'EntityExtant';
+    public const CAPABILITY_ENTITY_FETCH = 'EntityFetch';
+    public const CAPABILITY_ENTITY_READ = 'EntityRead';
+    // Filter capabilities
+    public const CAPABILITY_ENTITY_FILTER_ALL = '*';
+    public const CAPABILITY_ENTITY_FILTER_ID = 'id';
+    public const CAPABILITY_ENTITY_FILTER_URID = 'urid';
+    public const CAPABILITY_ENTITY_FILTER_LABEL = 'label';
+    // Sort capabilities
+    public const CAPABILITY_ENTITY_SORT_ID = 'id';
+    public const CAPABILITY_ENTITY_SORT_URID = 'urid';
+    public const CAPABILITY_ENTITY_SORT_LABEL = 'label';
+    public const CAPABILITY_ENTITY_SORT_PRIORITY = 'priority';
+    // Range capabilities
+    public const CAPABILITY_ENTITY_RANGE_TALLY = 'tally';
+    public const CAPABILITY_ENTITY_RANGE_TALLY_ABSOLUTE = 'absolute';
+    public const CAPABILITY_ENTITY_RANGE_TALLY_RELATIVE = 'relative';
+    public const CAPABILITY_ENTITY_RANGE_DATE = 'date';
+
+    public const JSON_TYPE = 'document:service';
+
+    /**
+     * Lists all collections in this service
+     *
+     * @since 2025.05.01
+     *
+     * @param IFilter|null $filter Optional filter criteria
+     * @param ISort|null $sort Optional sort order
+     *
+     * @return array<string|int,CollectionBaseInterface> Collections indexed by ID
+     */
+    public function collectionList(string|int $location, ?IFilter $filter = null, ?ISort $sort = null): array;
+
+    /**
+     * Creates a filter builder for collections
+     *
+     * @since 2025.05.01
+     *
+     * @return IFilter
+     */
+    public function collectionListFilter(): IFilter;
+
+    /**
+     * Creates a sort builder for collections
+     *
+     * @since 2025.05.01
+     *
+     * @return ISort
+     */
+    public function collectionListSort(): ISort;
+
+    /**
+     * Checks if collections exist
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int ...$identifiers Collection IDs to check
+     *
+     * @return array<string|int,bool> Map of ID => exists
+     */
+    public function collectionExtant(string|int $location, string|int ...$identifiers): array;
+
+    /**
+     * Fetches a single collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $identifier Collection ID
+     *
+     * @return CollectionBaseInterface|null Collection or null if not found
+     */
+    public function collectionFetch(string|int $identifier): ?CollectionBaseInterface;
+
+    /**
+     * Lists messages in a collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection Collection ID
+     * @param IFilter|null $filter Optional filter criteria
+     * @param ISort|null $sort Optional sort order
+     * @param IRange|null $range Optional pagination
+     * @param array|null $properties Optional message properties to fetch
+     *
+     * @return array<string|int,EntityBaseInterface> Messages indexed by ID
+     */
+    public function entityList(string|int $collection, ?IFilter $filter = null, ?ISort $sort = null, ?IRange $range = null, ?array $properties = null): array;
+
+    /**
+     * Creates a filter builder for messages
+     *
+     * @since 2025.05.01
+     *
+     * @return IFilter
+     */
+    public function entityListFilter(): IFilter;
+
+    /**
+     * Creates a sort builder for messages
+     *
+     * @since 2025.05.01
+     *
+     * @return ISort
+     */
+    public function entityListSort(): ISort;
+
+    /**
+     * Creates a range builder for messages
+     *
+     * @since 2025.05.01
+     *
+     * @param RangeType $type Range type (offset, cursor, etc.)
+     *
+     * @return IRange
+     */
+    public function entityListRange(RangeType $type): IRange;
+
+    /**
+     * Gets incremental changes since last sync
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection Collection ID
+     * @param string $signature Sync token from previous sync
+     * @param string $detail Detail level: 'ids', 'minimal', 'full'
+     *
+     * @return array ['signature' => string, 'added' => array, 'modified' => array, 'removed' => array]
+     */
+    public function entityDelta(string|int $collection, string $signature, string $detail = 'ids'): Delta;
+
+    /**
+     * Checks if messages exist
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection Collection ID
+     * @param string|int ...$identifiers Message IDs to check
+     *
+     * @return array<string|int,bool> Map of ID => exists
+     */
+    public function entityExtant(string|int $collection, string|int ...$identifiers): array;
+
+    /**
+     * Fetches one or more entities
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection Collection ID
+     * @param string|int ...$identifiers Message IDs to fetch
+     *
+     * @return array<string|int,EntityBaseInterface> Messages indexed by ID
+     */
+    public function entityFetch(string|int $collection, string|int ...$identifiers): array;
+
+}

shared/lib/Resource/Documents/Service/ServiceCollectionMutableInterface.php

@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Service;
+
+use KTXF\Resource\Documents\Collection\CollectionBaseInterface;
+use KTXF\Resource\Documents\Collection\CollectionMutableInterface;
+
+/**
+ * Chrono Service Collection Mutable Interface
+ * 
+ * @since 2025.05.01
+ */
+interface ServiceCollectionMutableInterface extends ServiceBaseInterface {
+
+    public const CAPABILITY_COLLECTION_CREATE = 'CollectionCreate';
+    public const CAPABILITY_COLLECTION_UPDATE = 'CollectionUpdate';
+    public const CAPABILITY_COLLECTION_DELETE = 'CollectionDelete';
+
+    /**
+     * Creates a fresh collection instance for configuration
+     *
+     * @since 2025.05.01
+     *
+     * @return CollectionMutableInterface Fresh collection object
+     */
+    public function collectionFresh(): CollectionMutableInterface;
+
+    /**
+     * Creates a new collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int|null $location Parent collection ID (null for root)
+     * @param CollectionMutableInterface $collection Collection to create
+     * @param array $options Protocol-specific options
+     *
+     * @return CollectionBaseInterface Created collection with assigned ID
+     */
+    public function collectionCreate(string|int|null $location, CollectionMutableInterface $collection, array $options = []): CollectionBaseInterface;
+
+    /**
+     * Updates an existing collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $identifier Collection ID
+     * @param CollectionMutableInterface $collection Updated collection data
+     *
+     * @return CollectionBaseInterface Updated collection
+     */
+    public function collectionUpdate(string|int $identifier, CollectionMutableInterface $collection): CollectionBaseInterface;
+
+    /**
+     * Deletes a collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $identifier Collection ID
+     * @param bool $force Force deletion even if not empty
+     * @param bool $recursive Recursively delete contents
+     *
+     * @return bool True if deleted
+     */
+    public function collectionDelete(string|int $identifier, bool $force = false, bool $recursive = false): bool;
+
+}

shared/lib/Resource/Documents/Service/ServiceConfigurableInterface.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Service;
+
+use KTXF\Resource\Provider\ResourceServiceConfigureInterface;
+
+/**
+ * Chrono Service Configurable Interface
+ * 
+ * Extends base service interface with setter methods for mutable properties.
+ * Used for service configuration and updates.
+ * 
+ * @since 2025.05.01
+ */
+interface ServiceConfigurableInterface extends ServiceMutableInterface, ResourceServiceConfigureInterface {
+
+	public const JSON_TYPE = ServiceBaseInterface::JSON_TYPE;
+
+}

shared/lib/Resource/Documents/Service/ServiceEntityMutableInterface.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\Resource\Documents\Service;
+
+use KTXF\Resource\Documents\Entity\EntityBaseInterface;
+use KTXF\Resource\Documents\Entity\EntityMutableInterface;
+
+/**
+ * Chrono Service Entity Mutable Interface
+ * 
+ * Optional interface for services that support entity CRUD operations.
+ * Provides entity creation, modification, deletion, copying, moving, and flag management.
+ * 
+ * @since 2025.05.01
+ */
+interface ServiceEntityMutableInterface extends ServiceBaseInterface {
+
+    public const CAPABILITY_ENTITY_CREATE = 'EntityCreate';
+    public const CAPABILITY_ENTITY_UPDATE = 'EntityUpdate';
+    public const CAPABILITY_ENTITY_DELETE = 'EntityDelete';
+    public const CAPABILITY_ENTITY_COPY = 'EntityCopy';
+    public const CAPABILITY_ENTITY_MOVE = 'EntityMove';
+    public const CAPABILITY_ENTITY_WRITE = 'EntityWrite';
+
+    /**
+     * Creates a fresh entity instance for composition
+     *
+     * @since 2025.05.01
+     *
+     * @return EntityMutableInterface Fresh entity object
+     */
+    public function entityFresh(): EntityMutableInterface;
+
+    /**
+     * Creates/imports an entity into a collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection collection identifier
+     * @param EntityMutableInterface $entity Entity data
+     * @param array $options additional options
+     *
+     * @return EntityBaseInterface Created entity
+     */
+    public function entityCreate(string|int $collection, EntityMutableInterface $entity, array $options = []): EntityBaseInterface;
+
+    /**
+     * Modifies an existing entity
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection Collection identifier
+     * @param string|int $identifier Entity identifier
+     * @param EntityMutableInterface $entity Entity data
+     *
+     * @return EntityBaseInterface Modified entity
+     */
+    public function entityUpdate(string|int $collection, string|int $identifier, EntityMutableInterface $entity): EntityBaseInterface;
+    /**
+     * Deletes an existing entity in the specified collection
+     *
+     * @since 2025.05.01
+     *
+     * @param string|int $collection Collection identifier
+     * @param string|int $identifier Entity identifier to delete
+     *
+     * @return EntityBaseInterface Deleted entity
+     */
+    public function entityDelete(string|int $collection, string|int $identifier): EntityBaseInterface;
+
+}

shared/lib/Resource/Documents/Service/ServiceMutableInterface.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXF\Resource\Documents\Service;
+
+/**
+ * Chrono Service Mutable Interface
+ * 
+ * Extends base service interface with setter methods for mutable properties.
+ * Used for service configuration and updates.
+ * 
+ * @since 2025.05.01
+ */
+interface ServiceMutableInterface extends ServiceBaseInterface {
+
+}

shared/lib/Resource/Provider/Node/NodePropertiesBaseAbstract.php

@@ -26,8 +26,8 @@ abstract class NodePropertiesBaseAbstract implements NodePropertiesBaseInterface
             $data[static::JSON_PROPERTY_TYPE] = static::JSON_TYPE;
         }
 
-        if (!isset($data[static::JSON_PROPERTY_VERSION])) {
-            $data[static::JSON_PROPERTY_VERSION] = 1;
+        if (!isset($data[static::JSON_PROPERTY_SCHEMA])) {
+            $data[static::JSON_PROPERTY_SCHEMA] = 1;
         }
 
         $this->data = $data;
@@ -50,8 +50,8 @@ abstract class NodePropertiesBaseAbstract implements NodePropertiesBaseInterface
      /**
       * @inheritDoc
       */
-    public function version(): int {
-        return $this->data[static::JSON_PROPERTY_VERSION];
+    public function schema(): int {
+        return $this->data[static::JSON_PROPERTY_SCHEMA];
     }
     
 }

shared/lib/Resource/Provider/Node/NodePropertiesBaseInterface.php

@@ -22,7 +22,7 @@ interface NodePropertiesBaseInterface extends JsonSerializable {
 
     public const JSON_TYPE = 'resource.data';
     public const JSON_PROPERTY_TYPE = '@type';
-    public const JSON_PROPERTY_VERSION = 'version';
+    public const JSON_PROPERTY_SCHEMA = 'schema';
     
     /**
      * Get resource node properties type
@@ -30,8 +30,8 @@ interface NodePropertiesBaseInterface extends JsonSerializable {
     public function type(): string;
     
     /**
-     * Get resource node properties version
+     * Get resource node properties schema
      */
-    public function version(): int;
+    public function schema(): int;
     
 }

shared/lib/Resource/Provider/ProviderInterface.php

@@ -11,13 +11,13 @@ interface ProviderInterface
 {
 
     public const TYPE_AUTHENTICATION = 'authentication';
+    public const TYPE_DOCUMENT = 'document';
     public const TYPE_PEOPLE = 'people';
     public const TYPE_CHRONO = 'chrono';
-    public const TYPE_FILES = 'files';
     public const TYPE_MAIL = 'mail';
 
     /**
-     * Provider type (e.g., 'authentication', 'storage', 'notification')
+     * Provider type (e.g., 'authentication', 'document', 'people', 'chrono', 'mail')
      */
     public function type(): string;