🗃️ Make archiving tables/applications a personal option

appinfo/routes.php

@@ -127,6 +127,8 @@
 		['name' => 'ApiTables#update', 'url' => '/api/2/tables/{id}', 'verb' => 'PUT'],
 		['name' => 'ApiTables#destroy', 'url' => '/api/2/tables/{id}', 'verb' => 'DELETE'],
 		['name' => 'ApiTables#transfer', 'url' => '/api/2/tables/{id}/transfer', 'verb' => 'PUT'],
+		['name' => 'ApiTables#archiveTable', 'url' => '/api/2/tables/{id}/archive', 'verb' => 'POST'],
+		['name' => 'ApiTables#unarchiveTable', 'url' => '/api/2/tables/{id}/archive', 'verb' => 'DELETE'],
 
 		['name' => 'ApiColumns#index', 'url' => '/api/2/columns/{nodeType}/{nodeId}', 'verb' => 'GET'],
 		['name' => 'ApiColumns#show', 'url' => '/api/2/columns/{id}', 'verb' => 'GET'],
@@ -145,6 +147,8 @@
 		['name' => 'Context#update', 'url' => '/api/2/contexts/{contextId}', 'verb' => 'PUT'],
 		['name' => 'Context#destroy', 'url' => '/api/2/contexts/{contextId}', 'verb' => 'DELETE'],
 		['name' => 'Context#transfer', 'url' => '/api/2/contexts/{contextId}/transfer', 'verb' => 'PUT'],
+		['name' => 'Context#archiveContext', 'url' => '/api/2/contexts/{contextId}/archive', 'verb' => 'POST'],
+		['name' => 'Context#unarchiveContext', 'url' => '/api/2/contexts/{contextId}/archive', 'verb' => 'DELETE'],
 		['name' => 'Context#updateContentOrder', 'url' => '/api/2/contexts/{contextId}/pages/{pageId}', 'verb' => 'PUT'],
 
 		['name' => 'RowOCS#createRow',	'url' => '/api/2/{nodeCollection}/{nodeId}/rows', 'verb' => 'POST', 'requirements' => ['nodeCollection' => '(tables|views)', 'nodeId' => '(\d+)']],

lib/AppInfo/Application.php

@@ -47,6 +47,7 @@ class Application extends App implements IBootstrap {
 
 	public const NODE_TYPE_TABLE = 0;
 	public const NODE_TYPE_VIEW = 1;
+	public const NODE_TYPE_CONTEXT = 2;
 
 	public const OWNER_TYPE_USER = 0;
 

lib/Controller/ApiTablesController.php

@@ -22,6 +22,7 @@
 use OCP\App\IAppManager;
 use OCP\AppFramework\Http;
 use OCP\AppFramework\Http\Attribute\NoAdminRequired;
+use OCP\AppFramework\Http\Attribute\UserRateLimit;
 use OCP\AppFramework\Http\DataResponse;
 use OCP\IDBConnection;
 use OCP\IL10N;
@@ -306,6 +307,62 @@ public function destroy(int $id): DataResponse {
 		}
 	}
 
+	/**
+	 * [api v2] Archive a table for the requesting user
+	 *
+	 * Owners archive the table for all users (clears per-user overrides).
+	 * Non-owners archive only for themselves.
+	 *
+	 * @param int $id Table ID
+	 * @return DataResponse<Http::STATUS_OK, TablesTable, array{}>|DataResponse<Http::STATUS_FORBIDDEN|Http::STATUS_INTERNAL_SERVER_ERROR|Http::STATUS_NOT_FOUND, array{message: string}, array{}>
+	 *
+	 * 200: Table returned with updated archived state
+	 * 403: No permissions
+	 * 404: Not found
+	 */
+	#[NoAdminRequired]
+	#[UserRateLimit(limit: 20, period: 60)]
+	#[RequirePermission(permission: Application::PERMISSION_READ, type: Application::NODE_TYPE_TABLE, idParam: 'id')]
+	public function archiveTable(int $id): DataResponse {
+		try {
+			return new DataResponse($this->service->archiveTable($id, $this->userId)->jsonSerialize());
+		} catch (PermissionError $e) {
+			return $this->handlePermissionError($e);
+		} catch (InternalError $e) {
+			return $this->handleError($e);
+		} catch (NotFoundError $e) {
+			return $this->handleNotFoundError($e);
+		}
+	}
+
+	/**
+	 * [api v2] Unarchive a table for the requesting user
+	 *
+	 * Owners unarchive the table for all users (clears per-user overrides).
+	 * Non-owners remove only their personal archive override.
+	 *
+	 * @param int $id Table ID
+	 * @return DataResponse<Http::STATUS_OK, TablesTable, array{}>|DataResponse<Http::STATUS_FORBIDDEN|Http::STATUS_INTERNAL_SERVER_ERROR|Http::STATUS_NOT_FOUND, array{message: string}, array{}>
+	 *
+	 * 200: Table returned with updated archived state
+	 * 403: No permissions
+	 * 404: Not found
+	 */
+	#[NoAdminRequired]
+	#[UserRateLimit(limit: 20, period: 60)]
+	#[RequirePermission(permission: Application::PERMISSION_READ, type: Application::NODE_TYPE_TABLE, idParam: 'id')]
+	public function unarchiveTable(int $id): DataResponse {
+		try {
+			return new DataResponse($this->service->unarchiveTable($id, $this->userId)->jsonSerialize());
+		} catch (PermissionError $e) {
+			return $this->handlePermissionError($e);
+		} catch (InternalError $e) {
+			return $this->handleError($e);
+		} catch (NotFoundError $e) {
+			return $this->handleNotFoundError($e);
+		}
+	}
+
 	/**
 	 * [api v2] Transfer table
 	 *

lib/Controller/ContextController.php

@@ -19,6 +19,7 @@
 use OCP\AppFramework\Db\MultipleObjectsReturnedException;
 use OCP\AppFramework\Http;
 use OCP\AppFramework\Http\Attribute\NoAdminRequired;
+use OCP\AppFramework\Http\Attribute\UserRateLimit;
 use OCP\AppFramework\Http\DataResponse;
 use OCP\DB\Exception;
 use OCP\IL10N;
@@ -246,6 +247,54 @@ public function transfer(int $contextId, string $newOwnerId, int $newOwnerType =
 		}
 	}
 
+	/**
+	 * [api v2] Archive a context for the requesting user
+	 *
+	 * Owners archive the context for all users (clears per-user overrides).
+	 * Non-owners archive only for themselves.
+	 *
+	 * @param int $contextId ID of the context
+	 * @return DataResponse<Http::STATUS_OK, TablesContext, array{}>|DataResponse<Http::STATUS_INTERNAL_SERVER_ERROR|Http::STATUS_NOT_FOUND, array{message: string}, array{}>
+	 *
+	 * 200: Context returned with updated archived state
+	 * 404: Context not found or not available
+	 */
+	#[NoAdminRequired]
+	#[UserRateLimit(limit: 20, period: 60)]
+	public function archiveContext(int $contextId): DataResponse {
+		try {
+			return new DataResponse($this->contextService->archiveContext($contextId, $this->userId)->jsonSerialize());
+		} catch (NotFoundError $e) {
+			return $this->handleNotFoundError($e);
+		} catch (InternalError|Exception $e) {
+			return $this->handleError($e);
+		}
+	}
+
+	/**
+	 * [api v2] Unarchive a context for the requesting user
+	 *
+	 * Owners unarchive the context for all users (clears per-user overrides).
+	 * Non-owners remove only their personal archive override.
+	 *
+	 * @param int $contextId ID of the context
+	 * @return DataResponse<Http::STATUS_OK, TablesContext, array{}>|DataResponse<Http::STATUS_INTERNAL_SERVER_ERROR|Http::STATUS_NOT_FOUND, array{message: string}, array{}>
+	 *
+	 * 200: Context returned with updated archived state
+	 * 404: Context not found or not available
+	 */
+	#[NoAdminRequired]
+	#[UserRateLimit(limit: 20, period: 60)]
+	public function unarchiveContext(int $contextId): DataResponse {
+		try {
+			return new DataResponse($this->contextService->unarchiveContext($contextId, $this->userId)->jsonSerialize());
+		} catch (NotFoundError $e) {
+			return $this->handleNotFoundError($e);
+		} catch (InternalError|Exception $e) {
+			return $this->handleError($e);
+		}
+	}
+
 	/**
 	 * [api v2] Update the order on a page of a context
 	 *

lib/Db/Context.php

@@ -20,6 +20,7 @@
  * @method setOwnerId(string $value): void
  * @method getOwnerType(): int
  * @method setOwnerType(int $value): void
+ * @method setArchived(bool $value): void
  *
  * @method getSharing(): array
  * @method setSharing(array $value): void
@@ -34,6 +35,7 @@ class Context extends EntitySuper implements JsonSerializable {
 	protected ?string $description = null;
 	protected ?string $ownerId = null;
 	protected ?int $ownerType = null;
+	protected bool $archived = false;
 
 	// virtual properties
 	protected ?array $sharing = null;
@@ -45,6 +47,11 @@ class Context extends EntitySuper implements JsonSerializable {
 	public function __construct() {
 		$this->addType('id', 'integer');
 		$this->addType('owner_type', 'integer');
+		$this->addType('archived', 'boolean');
+	}
+
+	public function isArchived(): bool {
+		return $this->archived;
 	}
 
 	public function jsonSerialize(): array {
@@ -55,7 +62,8 @@ public function jsonSerialize(): array {
 			'iconName' => $this->getIcon(),
 			'description' => $this->getDescription(),
 			'owner' => $this->getOwnerId(),
-			'ownerType' => $this->getOwnerType()
+			'ownerType' => $this->getOwnerType(),
+			'archived' => $this->isArchived(),
 		];
 
 		// extended data

lib/Db/ContextMapper.php

@@ -81,6 +81,7 @@ protected function formatResultRows(array $rows, ?string $userId) {
 			'description' => $rows[0]['description'],
 			'owner_id' => $rows[0]['owner_id'],
 			'owner_type' => $rows[0]['owner_type'],
+			'archived' => (bool)($rows[0]['archived'] ?? false),
 		];
 
 		$formatted['sharing'] = array_reduce($rows, function (array $carry, array $item) use ($userId) {

lib/Db/Table.php

@@ -84,6 +84,10 @@ public function __construct() {
 		$this->addType('archived', 'boolean');
 	}
 
+	public function isArchived(): bool {
+		return $this->archived;
+	}
+
 	/**
 	 * @psalm-return TablesTable
 	 */

lib/Db/UserArchive.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OCA\Tables\Db;
+
+/**
+ * @method getUserId(): string
+ * @method setUserId(string $value): void
+ * @method getNodeType(): int
+ * @method setNodeType(int $value): void
+ * @method getNodeId(): int
+ * @method setNodeId(int $value): void
+ * @method setArchived(bool $value): void
+ */
+class UserArchive extends EntitySuper {
+	protected ?string $userId = null;
+	protected ?int $nodeType = null;
+	protected ?int $nodeId = null;
+	protected bool $archived = true;
+
+	public function __construct() {
+		$this->addType('id', 'integer');
+		$this->addType('node_type', 'integer');
+		$this->addType('node_id', 'integer');
+		$this->addType('archived', 'boolean');
+	}
+
+	public function isArchived(): bool {
+		return $this->archived;
+	}
+}

lib/Db/UserArchiveMapper.php

@@ -0,0 +1,141 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OCA\Tables\Db;
+
+use OCP\AppFramework\Db\QBMapper;
+use OCP\DB\Exception;
+use OCP\DB\QueryBuilder\IQueryBuilder;
+use OCP\IDBConnection;
+
+/** @template-extends QBMapper<UserArchive> */
+class UserArchiveMapper extends QBMapper {
+	protected string $table = 'tables_archive_user';
+
+	public function __construct(IDBConnection $db) {
+		parent::__construct($db, $this->table, UserArchive::class);
+	}
+
+	/**
+	 * Look up a single per-user archive override.
+	 *
+	 * @throws Exception
+	 */
+	public function findForUser(string $userId, int $nodeType, int $nodeId): ?UserArchive {
+		$qb = $this->db->getQueryBuilder();
+		$qb->select('*')
+			->from($this->table)
+			->where($qb->expr()->eq('user_id', $qb->createNamedParameter($userId, IQueryBuilder::PARAM_STR)))
+			->andWhere($qb->expr()->eq('node_type', $qb->createNamedParameter($nodeType, IQueryBuilder::PARAM_INT)))
+			->andWhere($qb->expr()->eq('node_id', $qb->createNamedParameter($nodeId, IQueryBuilder::PARAM_INT)));
+
+		$entities = $this->findEntities($qb);
+		return $entities[0] ?? null;
+	}
+
+	/**
+	 * Fetch all per-user archive overrides for a given node.
+	 *
+	 * @return UserArchive[]
+	 * @throws Exception
+	 */
+	public function findAllForNode(int $nodeType, int $nodeId): array {
+		$qb = $this->db->getQueryBuilder();
+		$qb->select('*')
+			->from($this->table)
+			->where($qb->expr()->eq('node_type', $qb->createNamedParameter($nodeType, IQueryBuilder::PARAM_INT)))
+			->andWhere($qb->expr()->eq('node_id', $qb->createNamedParameter($nodeId, IQueryBuilder::PARAM_INT)));
+
+		return $this->findEntities($qb);
+	}
+
+	/**
+	 * Fetch all per-user archive overrides for a given user and node type,
+	 * filtered to a specific set of node IDs.
+	 *
+	 * Oracle enforces a hard limit of 1000 items per IN clause. The method
+	 * chunks $nodeIds into batches of 997 (matching the existing
+	 * ShareMapper::findAllSharesFor() pattern) and merges results in PHP to
+	 * stay within this limit transparently.
+	 *
+	 * @param int[] $nodeIds IDs to restrict the lookup to
+	 * @return array<int, UserArchive> Keyed by node_id for O(1) map lookup
+	 * @throws Exception
+	 */
+	public function findAllOverridesForUser(string $userId, int $nodeType, array $nodeIds): array {
+		if (empty($nodeIds)) {
+			return [];
+		}
+
+		$results = [];
+		foreach (array_chunk($nodeIds, 997) as $chunk) {
+			$qb = $this->db->getQueryBuilder();
+			$qb->select('*')
+				->from($this->table)
+				->where($qb->expr()->eq('user_id', $qb->createNamedParameter($userId, IQueryBuilder::PARAM_STR)))
+				->andWhere($qb->expr()->eq('node_type', $qb->createNamedParameter($nodeType, IQueryBuilder::PARAM_INT)))
+				->andWhere($qb->expr()->in('node_id', $qb->createNamedParameter($chunk, IQueryBuilder::PARAM_INT_ARRAY)));
+
+			foreach ($this->findEntities($qb) as $entity) {
+				$results[$entity->getNodeId()] = $entity;
+			}
+		}
+
+		return $results;
+	}
+
+	/**
+	 * Insert or update a per-user archive override.
+	 *
+	 * @throws Exception
+	 */
+	public function upsert(string $userId, int $nodeType, int $nodeId, bool $archived): void {
+		$existing = $this->findForUser($userId, $nodeType, $nodeId);
+
+		if ($existing !== null) {
+			$existing->setArchived($archived);
+			$this->update($existing);
+		} else {
+			$entity = new UserArchive();
+			$entity->setUserId($userId);
+			$entity->setNodeType($nodeType);
+			$entity->setNodeId($nodeId);
+			$entity->setArchived($archived);
+			$this->insert($entity);
+		}
+	}
+
+	/**
+	 * Remove the per-user archive override for a single user.
+	 *
+	 * @throws Exception
+	 */
+	public function deleteForUser(string $userId, int $nodeType, int $nodeId): void {
+		$qb = $this->db->getQueryBuilder();
+		$qb->delete($this->table)
+			->where($qb->expr()->eq('user_id', $qb->createNamedParameter($userId, IQueryBuilder::PARAM_STR)))
+			->andWhere($qb->expr()->eq('node_type', $qb->createNamedParameter($nodeType, IQueryBuilder::PARAM_INT)))
+			->andWhere($qb->expr()->eq('node_id', $qb->createNamedParameter($nodeId, IQueryBuilder::PARAM_INT)));
+
+		$qb->executeStatement();
+	}
+
+	/**
+	 * Remove all per-user archive overrides for a node (used when an owner
+	 * archives/unarchives or when the node is permanently deleted).
+	 *
+	 * @throws Exception
+	 */
+	public function deleteAllForNode(int $nodeType, int $nodeId): void {
+		$qb = $this->db->getQueryBuilder();
+		$qb->delete($this->table)
+			->where($qb->expr()->eq('node_type', $qb->createNamedParameter($nodeType, IQueryBuilder::PARAM_INT)))
+			->andWhere($qb->expr()->eq('node_id', $qb->createNamedParameter($nodeId, IQueryBuilder::PARAM_INT)));
+
+		$qb->executeStatement();
+	}
+}