matrix-sdk-indexeddb 0.16.1

// Copyright 2025 The Matrix.org Foundation C.I.C.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License

use std::{rc::Rc, sync::Arc};

use matrix_sdk_base::media::store::MediaService;
use matrix_sdk_store_encryption::StoreCipher;

use crate::{
    media_store::{
        error::IndexeddbMediaStoreError, migrations::open_and_upgrade_db, IndexeddbMediaStore,
    },
    serializer::{IndexedTypeSerializer, SafeEncodeSerializer},
};

/// A type for conveniently building an [`IndexeddbMediaStore`]
pub struct IndexeddbMediaStoreBuilder {
    // The name of the IndexedDB database which will be opened
    database_name: String,
    // The store cipher, if any, to use when encrypting data
    // before it is persisted to the IndexedDB database
    store_cipher: Option<Arc<StoreCipher>>,
}

impl Default for IndexeddbMediaStoreBuilder {
    fn default() -> Self {
        Self { database_name: Self::DEFAULT_DATABASE_NAME.to_owned(), store_cipher: None }
    }
}

impl IndexeddbMediaStoreBuilder {
    /// The default name of the IndexedDB database used to back the
    /// [`IndexeddbMediaStore`]
    pub const DEFAULT_DATABASE_NAME: &'static str = "media";

    /// Sets the name of the IndexedDB database which will be opened. This
    /// defaults to [`Self::DEFAULT_DATABASE_NAME`].
    pub fn database_name(mut self, name: String) -> Self {
        self.database_name = name;
        self
    }

    /// Sets the store cipher to use when encrypting data before it is persisted
    /// to the IndexedDB database. By default, no store cipher is used -
    /// i.e., data is not encrypted before it is persisted.
    pub fn store_cipher(mut self, store_cipher: Arc<StoreCipher>) -> Self {
        self.store_cipher = Some(store_cipher);
        self
    }

    /// Opens the IndexedDB database with the provided name. If successfully
    /// opened, builds the [`IndexeddbMediaStore`] with that database
    /// and the provided store cipher.
    pub async fn build(self) -> Result<IndexeddbMediaStore, IndexeddbMediaStoreError> {
        Ok(IndexeddbMediaStore {
            inner: Rc::new(open_and_upgrade_db(&self.database_name).await?),
            serializer: IndexedTypeSerializer::new(SafeEncodeSerializer::new(self.store_cipher)),
            media_service: MediaService::new(),
        })
    }
}