storage/indexeddb/engines/
sqlite.rs

1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
4use std::path::{Path, PathBuf};
5use std::sync::Arc;
6
7use base::threadpool::ThreadPool;
8use log::{error, info, warn};
9use malloc_size_of::{MallocSizeOf, MallocSizeOfOps};
10use rusqlite::{Connection, Error, OptionalExtension, params};
11use sea_query::{Condition, Expr, ExprTrait, IntoCondition, SqliteQueryBuilder};
12use sea_query_rusqlite::RusqliteBinder;
13use storage_traits::indexeddb::{
14    AsyncOperation, AsyncReadOnlyOperation, AsyncReadWriteOperation, BackendError,
15    CreateObjectResult, IndexedDBIndex, IndexedDBKeyRange, IndexedDBKeyType, IndexedDBRecord,
16    IndexedDBTxnMode, KeyPath, PutItemResult,
17};
18
19use crate::indexeddb::IndexedDBDescription;
20use crate::indexeddb::engines::{KvsEngine, KvsTransaction};
21use crate::shared::{DB_INIT_PRAGMAS, DB_PRAGMAS};
22
23mod create;
24mod database_model;
25mod object_data_model;
26mod object_store_index_model;
27mod object_store_model;
28
29fn range_to_query(range: IndexedDBKeyRange) -> Condition {
30    // Special case for optimization
31    if let Some(singleton) = range.as_singleton() {
32        let encoded = postcard::to_stdvec(singleton).unwrap();
33        return Expr::column(object_data_model::Column::Key)
34            .eq(encoded)
35            .into_condition();
36    }
37    let mut parts = vec![];
38    if let Some(upper) = range.upper.as_ref() {
39        let upper_bytes = postcard::to_stdvec(upper).unwrap();
40        let query = if range.upper_open {
41            Expr::column(object_data_model::Column::Key).lt(upper_bytes)
42        } else {
43            Expr::column(object_data_model::Column::Key).lte(upper_bytes)
44        };
45        parts.push(query);
46    }
47    if let Some(lower) = range.lower.as_ref() {
48        let lower_bytes = postcard::to_stdvec(lower).unwrap();
49        let query = if range.lower_open {
50            Expr::column(object_data_model::Column::Key).gt(lower_bytes)
51        } else {
52            Expr::column(object_data_model::Column::Key).gte(lower_bytes)
53        };
54        parts.push(query);
55    }
56    let mut condition = Condition::all();
57    for part in parts {
58        condition = condition.add(part);
59    }
60    condition
61}
62
63pub struct SqliteEngine {
64    db_path: PathBuf,
65    connection: Connection,
66    read_pool: Arc<ThreadPool>,
67    write_pool: Arc<ThreadPool>,
68    created_db_path: bool,
69}
70
71impl SqliteEngine {
72    // TODO: intake dual pools
73    pub fn new(
74        base_dir: &Path,
75        db_info: &IndexedDBDescription,
76        pool: Arc<ThreadPool>,
77    ) -> Result<Self, Error> {
78        let mut db_path = PathBuf::new();
79        db_path.push(base_dir);
80        db_path.push(db_info.as_path());
81        let db_parent = db_path.clone();
82        db_path.push("db.sqlite");
83
84        let created_db_path = if !db_path.exists() {
85            std::fs::create_dir_all(db_parent).unwrap();
86            std::fs::File::create(&db_path).unwrap();
87            true
88        } else {
89            false
90        };
91
92        let connection = Self::init_db(&db_path, db_info)?;
93
94        for stmt in DB_PRAGMAS {
95            // TODO: Handle errors properly
96            let _ = connection.execute(stmt, ());
97        }
98
99        Ok(Self {
100            connection,
101            db_path,
102            read_pool: pool.clone(),
103            write_pool: pool,
104            created_db_path,
105        })
106    }
107
108    /// Returns whether the physical db was created as part of `new`.
109    pub(crate) fn created_db_path(&self) -> bool {
110        self.created_db_path
111    }
112
113    fn init_db(path: &Path, db_info: &IndexedDBDescription) -> Result<Connection, Error> {
114        let connection = Connection::open(path)?;
115        if connection.table_exists(None, "database")? {
116            // Database already exists, no need to initialize
117            return Ok(connection);
118        }
119        info!("Initializing indexeddb database at {:?}", path);
120        for stmt in DB_INIT_PRAGMAS {
121            // FIXME(arihant2math): this fails occasionally
122            let _ = connection.execute(stmt, ());
123        }
124        create::create_tables(&connection)?;
125        // From https://w3c.github.io/IndexedDB/#database-version:
126        // "When a database is first created, its version is 0 (zero)."
127        connection.execute(
128            "INSERT INTO database (name, origin, version) VALUES (?, ?, ?)",
129            params![
130                db_info.name.to_owned(),
131                db_info.origin.to_owned().ascii_serialization(),
132                i64::from_ne_bytes(0_u64.to_ne_bytes())
133            ],
134        )?;
135        Ok(connection)
136    }
137
138    fn get(
139        connection: &Connection,
140        store: object_store_model::Model,
141        key_range: IndexedDBKeyRange,
142    ) -> Result<Option<object_data_model::Model>, Error> {
143        let query = range_to_query(key_range);
144        let (sql, values) = sea_query::Query::select()
145            .from(object_data_model::Column::Table)
146            .columns(vec![
147                object_data_model::Column::ObjectStoreId,
148                object_data_model::Column::Key,
149                object_data_model::Column::Data,
150            ])
151            .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)))
152            .limit(1)
153            .build_rusqlite(SqliteQueryBuilder);
154        connection
155            .prepare(&sql)?
156            .query_one(&*values.as_params(), |row| {
157                object_data_model::Model::try_from(row)
158            })
159            .optional()
160    }
161
162    fn get_key(
163        connection: &Connection,
164        store: object_store_model::Model,
165        key_range: IndexedDBKeyRange,
166    ) -> Result<Option<Vec<u8>>, Error> {
167        Self::get(connection, store, key_range).map(|opt| opt.map(|model| model.key))
168    }
169
170    fn get_item(
171        connection: &Connection,
172        store: object_store_model::Model,
173        key_range: IndexedDBKeyRange,
174    ) -> Result<Option<Vec<u8>>, Error> {
175        Self::get(connection, store, key_range).map(|opt| opt.map(|model| model.data))
176    }
177
178    fn get_all(
179        connection: &Connection,
180        store: object_store_model::Model,
181        key_range: IndexedDBKeyRange,
182        count: Option<u32>,
183    ) -> Result<Vec<object_data_model::Model>, Error> {
184        let query = range_to_query(key_range);
185        let mut sql_query = sea_query::Query::select();
186        sql_query
187            .from(object_data_model::Column::Table)
188            .columns(vec![
189                object_data_model::Column::ObjectStoreId,
190                object_data_model::Column::Key,
191                object_data_model::Column::Data,
192            ])
193            .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)));
194        if let Some(count) = count {
195            sql_query.limit(count as u64);
196        }
197        let (sql, values) = sql_query.build_rusqlite(SqliteQueryBuilder);
198        let mut stmt = connection.prepare(&sql)?;
199        let models = stmt
200            .query_and_then(&*values.as_params(), |row| {
201                object_data_model::Model::try_from(row)
202            })?
203            .collect::<Result<Vec<_>, _>>()?;
204        Ok(models)
205    }
206
207    fn get_all_keys(
208        connection: &Connection,
209        store: object_store_model::Model,
210        key_range: IndexedDBKeyRange,
211        count: Option<u32>,
212    ) -> Result<Vec<Vec<u8>>, Error> {
213        Self::get_all(connection, store, key_range, count)
214            .map(|models| models.into_iter().map(|m| m.key).collect())
215    }
216
217    fn get_all_items(
218        connection: &Connection,
219        store: object_store_model::Model,
220        key_range: IndexedDBKeyRange,
221        count: Option<u32>,
222    ) -> Result<Vec<Vec<u8>>, Error> {
223        Self::get_all(connection, store, key_range, count)
224            .map(|models| models.into_iter().map(|m| m.data).collect())
225    }
226
227    #[expect(clippy::type_complexity)]
228    fn get_all_records(
229        connection: &Connection,
230        store: object_store_model::Model,
231        key_range: IndexedDBKeyRange,
232    ) -> Result<Vec<(Vec<u8>, Vec<u8>)>, Error> {
233        Self::get_all(connection, store, key_range, None)
234            .map(|models| models.into_iter().map(|m| (m.key, m.data)).collect())
235    }
236
237    fn put_item(
238        connection: &Connection,
239        store: object_store_model::Model,
240        key: IndexedDBKeyType,
241        value: Vec<u8>,
242        should_overwrite: bool,
243        key_generator_current_number: Option<i32>,
244    ) -> Result<PutItemResult, Error> {
245        let serialized_key: Vec<u8> = postcard::to_stdvec(&key).unwrap();
246        let existing_item = connection
247            .prepare("SELECT * FROM object_data WHERE key = ? AND object_store_id = ?")
248            .and_then(|mut stmt| {
249                stmt.query_row(params![serialized_key, store.id], |row| {
250                    object_data_model::Model::try_from(row)
251                })
252                .optional()
253            })?;
254        if should_overwrite || existing_item.is_none() {
255            connection.execute(
256                "INSERT INTO object_data (object_store_id, key, data) VALUES (?, ?, ?)",
257                params![store.id, serialized_key, value],
258            )?;
259            if let Some(next_key_generator_current_number) = key_generator_current_number {
260                connection.execute(
261                    "UPDATE object_store SET auto_increment = ? WHERE id = ?",
262                    params![next_key_generator_current_number, store.id],
263                )?;
264            }
265            Ok(PutItemResult::Key(key))
266        } else {
267            Ok(PutItemResult::CannotOverwrite)
268        }
269    }
270
271    fn delete_item(
272        connection: &Connection,
273        store: object_store_model::Model,
274        key_range: IndexedDBKeyRange,
275    ) -> Result<(), Error> {
276        let query = range_to_query(key_range);
277        let (sql, values) = sea_query::Query::delete()
278            .from_table(object_data_model::Column::Table)
279            .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)))
280            .build_rusqlite(SqliteQueryBuilder);
281        connection.prepare(&sql)?.execute(&*values.as_params())?;
282        Ok(())
283    }
284
285    fn clear(connection: &Connection, store: object_store_model::Model) -> Result<(), Error> {
286        connection.execute(
287            "DELETE FROM object_data WHERE object_store_id = ?",
288            params![store.id],
289        )?;
290        Ok(())
291    }
292
293    fn count(
294        connection: &Connection,
295        store: object_store_model::Model,
296        key_range: IndexedDBKeyRange,
297    ) -> Result<usize, Error> {
298        let query = range_to_query(key_range);
299        let (sql, values) = sea_query::Query::select()
300            .expr(Expr::col(object_data_model::Column::Key).count())
301            .from(object_data_model::Column::Table)
302            .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)))
303            .build_rusqlite(SqliteQueryBuilder);
304        connection
305            .prepare(&sql)?
306            .query_row(&*values.as_params(), |row| row.get(0))
307            .map(|count: i64| count as usize)
308    }
309}
310
311impl KvsEngine for SqliteEngine {
312    type Error = Error;
313
314    fn create_store(
315        &self,
316        store_name: &str,
317        key_path: Option<KeyPath>,
318        auto_increment: bool,
319    ) -> Result<CreateObjectResult, Self::Error> {
320        let mut stmt = self
321            .connection
322            .prepare("SELECT * FROM object_store WHERE name = ?")?;
323        if stmt.exists(params![store_name.to_string()])? {
324            // Store already exists
325            return Ok(CreateObjectResult::AlreadyExists);
326        }
327        self.connection.execute(
328            "INSERT INTO object_store (name, key_path, auto_increment) VALUES (?, ?, ?)",
329            params![
330                store_name.to_string(),
331                key_path.map(|v| postcard::to_stdvec(&v).unwrap()),
332                auto_increment as i32
333            ],
334        )?;
335
336        Ok(CreateObjectResult::Created)
337    }
338
339    fn delete_store(&self, store_name: &str) -> Result<(), Self::Error> {
340        let result = self.connection.execute(
341            "DELETE FROM object_store WHERE name = ?",
342            params![store_name.to_string()],
343        )?;
344        if result == 0 {
345            Err(Error::QueryReturnedNoRows)
346        } else if result > 1 {
347            Err(Error::QueryReturnedMoreThanOneRow)
348        } else {
349            Ok(())
350        }
351    }
352
353    fn close_store(&self, _store_name: &str) -> Result<(), Self::Error> {
354        // TODO: do something
355        Ok(())
356    }
357
358    fn delete_database(self) -> Result<(), Self::Error> {
359        // attempt to close the connection first
360        let _ = self.connection.close();
361        if self.db_path.exists() {
362            if let Err(e) = std::fs::remove_dir_all(self.db_path.parent().unwrap()) {
363                error!("Failed to delete database: {:?}", e);
364            }
365        }
366        Ok(())
367    }
368
369    fn process_transaction(
370        &self,
371        transaction: KvsTransaction,
372        on_complete: Box<dyn FnOnce() + Send + 'static>,
373    ) {
374        let spawning_pool = if transaction.mode == IndexedDBTxnMode::Readonly {
375            self.read_pool.clone()
376        } else {
377            self.write_pool.clone()
378        };
379        let path = self.db_path.clone();
380        spawning_pool.spawn(move || {
381            let connection = match Connection::open(path) {
382                Ok(connection) => connection,
383                Err(error) => {
384                    for request in transaction.requests {
385                        request
386                            .operation
387                            .notify_error(BackendError::DbErr(format!("{error:?}")));
388                    }
389                    on_complete();
390                    return;
391                },
392            };
393            for request in transaction.requests {
394                let object_store = connection
395                    .prepare("SELECT * FROM object_store WHERE name = ?")
396                    .and_then(|mut stmt| {
397                        stmt.query_row(params![request.store_name.to_string()], |row| {
398                            object_store_model::Model::try_from(row)
399                        })
400                        .optional()
401                    });
402                let object_store = match object_store {
403                    Ok(Some(store)) => store,
404                    Ok(None) => {
405                        request.operation.notify_error(BackendError::StoreNotFound);
406                        continue;
407                    },
408                    Err(error) => {
409                        request
410                            .operation
411                            .notify_error(BackendError::DbErr(format!("{error:?}")));
412                        continue;
413                    },
414                };
415
416                match request.operation {
417                    AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
418                        callback,
419                        key,
420                        value,
421                        should_overwrite,
422                        key_generator_current_number,
423                    }) => {
424                        let (key, key_generator_current_number) = match key {
425                            Some(key) => (key, key_generator_current_number),
426                            None => {
427                                if object_store.auto_increment == 0 {
428                                    if let Err(error) = callback.send(Err(BackendError::DbErr(
429                                        "Missing key for PutItem request".to_string(),
430                                    ))) {
431                                        warn!("Failed to send PutItem missing key error: {error:?}");
432                                    }
433                                    continue;
434                                }
435                                let Some(next_key_generator_current_number) =
436                                    object_store.auto_increment.checked_add(1)
437                                else {
438                                    if let Err(error) = callback.send(Err(BackendError::DbErr(
439                                        "Key generator overflow".to_string(),
440                                    ))) {
441                                        warn!(
442                                            "Failed to send PutItem key generator overflow error: {error:?}"
443                                        );
444                                    }
445                                    continue;
446                                };
447                                (
448                                    IndexedDBKeyType::Number(object_store.auto_increment as f64),
449                                    Some(next_key_generator_current_number),
450                                )
451                            },
452                        };
453                        let _ = callback.send(
454                            Self::put_item(
455                                &connection,
456                                object_store,
457                                key,
458                                value,
459                                should_overwrite,
460                                key_generator_current_number,
461                            )
462                            .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
463                        );
464                    },
465                    AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetItem {
466                        callback,
467                        key_range,
468                    }) => {
469                        let _ = callback.send(
470                            Self::get_item(&connection, object_store, key_range)
471                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
472                        );
473                    },
474                    AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetAllKeys {
475                        callback,
476                        key_range,
477                        count,
478                    }) => {
479                        let _ = callback.send(
480                            Self::get_all_keys(&connection, object_store, key_range, count)
481                                .map(|keys| {
482                                    keys.into_iter()
483                                        .map(|k| postcard::from_bytes(&k).unwrap())
484                                        .collect()
485                                })
486                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
487                        );
488                    },
489                    AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetAllItems {
490                        callback,
491                        key_range,
492                        count,
493                    }) => {
494                        let _ = callback.send(
495                            Self::get_all_items(&connection, object_store, key_range, count)
496                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
497                        );
498                    },
499                    AsyncOperation::ReadWrite(AsyncReadWriteOperation::RemoveItem {
500                        callback,
501                        key_range,
502                    }) => {
503                        let _ = callback.send(
504                            Self::delete_item(&connection, object_store, key_range)
505                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
506                        );
507                    },
508                    AsyncOperation::ReadOnly(AsyncReadOnlyOperation::Count {
509                        callback,
510                        key_range,
511                    }) => {
512                        let _ = callback.send(
513                            Self::count(&connection, object_store, key_range)
514                                .map(|r| r as u64)
515                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
516                        );
517                    },
518                    AsyncOperation::ReadOnly(AsyncReadOnlyOperation::Iterate {
519                        callback,
520                        key_range,
521                    }) => {
522                        let _ = callback.send(
523                            Self::get_all_records(&connection, object_store, key_range)
524                                .map(|records| {
525                                    records
526                                        .into_iter()
527                                        .map(|(key, data)| IndexedDBRecord {
528                                            key: postcard::from_bytes(&key).unwrap(),
529                                            primary_key: postcard::from_bytes(&key).unwrap(),
530                                            value: data,
531                                        })
532                                        .collect()
533                                })
534                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
535                        );
536                    },
537                    AsyncOperation::ReadWrite(AsyncReadWriteOperation::Clear(sender)) => {
538                        let _ = sender.send(
539                            Self::clear(&connection, object_store)
540                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
541                        );
542                    },
543                    AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetKey {
544                        callback,
545                        key_range,
546                    }) => {
547                        let _ = callback.send(
548                            Self::get_key(&connection, object_store, key_range)
549                                .map(|key| key.map(|k| postcard::from_bytes(&k).unwrap()))
550                                .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
551                        );
552                    },
553                }
554            }
555            on_complete();
556        });
557    }
558
559    fn key_generator_current_number(&self, store_name: &str) -> Option<i32> {
560        self.connection
561            .prepare("SELECT * FROM object_store WHERE name = ?")
562            .and_then(|mut stmt| {
563                stmt.query_row(params![store_name.to_string()], |r| {
564                    let object_store = object_store_model::Model::try_from(r).unwrap();
565                    Ok(object_store.auto_increment)
566                })
567            })
568            .optional()
569            .unwrap()
570            .and_then(|current_number| (current_number != 0).then_some(current_number))
571    }
572
573    fn key_path(&self, store_name: &str) -> Option<KeyPath> {
574        self.connection
575            .prepare("SELECT * FROM object_store WHERE name = ?")
576            .and_then(|mut stmt| {
577                stmt.query_row(params![store_name.to_string()], |r| {
578                    let object_store = object_store_model::Model::try_from(r).unwrap();
579                    Ok(object_store
580                        .key_path
581                        .map(|key_path| postcard::from_bytes(&key_path).unwrap()))
582                })
583            })
584            .optional()
585            .unwrap()
586            // TODO: Wrong, same issues as has_key_generator
587            .unwrap_or_default()
588    }
589
590    fn object_store_names(&self) -> Result<Vec<String>, Self::Error> {
591        let mut stmt = self.connection.prepare("SELECT name FROM object_store")?;
592        stmt.query_map([], |row| row.get(0))?
593            .collect::<Result<Vec<_>, _>>()
594    }
595
596    fn indexes(&self, store_name: &str) -> Result<Vec<IndexedDBIndex>, Self::Error> {
597        let object_store = self.connection.query_row(
598            "SELECT * FROM object_store WHERE name = ?",
599            params![store_name.to_string()],
600            |row| object_store_model::Model::try_from(row),
601        )?;
602
603        let mut stmt = self
604            .connection
605            .prepare("SELECT * FROM object_store_index WHERE object_store_id = ?")?;
606        let indexes = stmt
607            .query_map(params![object_store.id], |row| {
608                let model = object_store_index_model::Model::try_from(row)?;
609                Ok(IndexedDBIndex {
610                    name: model.name,
611                    key_path: postcard::from_bytes(&model.key_path).unwrap(),
612                    unique: model.unique_index,
613                    multi_entry: model.multi_entry_index,
614                })
615            })?
616            .collect::<Result<Vec<_>, _>>()?;
617        Ok(indexes)
618    }
619
620    fn create_index(
621        &self,
622        store_name: &str,
623        index_name: String,
624        key_path: KeyPath,
625        unique: bool,
626        multi_entry: bool,
627    ) -> Result<CreateObjectResult, Self::Error> {
628        let object_store = self.connection.query_row(
629            "SELECT * FROM object_store WHERE name = ?",
630            params![store_name.to_string()],
631            |row| object_store_model::Model::try_from(row),
632        )?;
633
634        let index_exists: bool = self.connection.query_row(
635            "SELECT EXISTS(SELECT * FROM object_store_index WHERE name = ? AND object_store_id = ?)",
636            params![index_name.to_string(), object_store.id],
637            |row| row.get(0),
638        )?;
639        if index_exists {
640            return Ok(CreateObjectResult::AlreadyExists);
641        }
642
643        self.connection.execute(
644            "INSERT INTO object_store_index (object_store_id, name, key_path, unique_index, multi_entry_index)\
645            VALUES (?, ?, ?, ?, ?)",
646            params![
647                object_store.id,
648                index_name.to_string(),
649                postcard::to_stdvec(&key_path).unwrap(),
650                unique,
651                multi_entry,
652            ],
653        )?;
654        Ok(CreateObjectResult::Created)
655    }
656
657    fn delete_index(&self, store_name: &str, index_name: String) -> Result<(), Self::Error> {
658        let object_store = self.connection.query_row(
659            "SELECT * FROM object_store WHERE name = ?",
660            params![store_name.to_string()],
661            |r| Ok(object_store_model::Model::try_from(r).unwrap()),
662        )?;
663
664        // Delete the index if it exists
665        let _ = self.connection.execute(
666            "DELETE FROM object_store_index WHERE name = ? AND object_store_id = ?",
667            params![index_name.to_string(), object_store.id],
668        )?;
669        Ok(())
670    }
671
672    fn version(&self) -> Result<u64, Self::Error> {
673        let version: i64 =
674            self.connection
675                .query_row("SELECT version FROM database LIMIT 1", [], |row| row.get(0))?;
676        Ok(u64::from_ne_bytes(version.to_ne_bytes()))
677    }
678
679    fn set_version(&self, version: u64) -> Result<(), Self::Error> {
680        let rows_affected = self.connection.execute(
681            "UPDATE database SET version = ?",
682            params![i64::from_ne_bytes(version.to_ne_bytes())],
683        )?;
684        if rows_affected == 0 {
685            return Err(Error::QueryReturnedNoRows);
686        }
687        Ok(())
688    }
689}
690
691fn get_db_status(connection: &Connection, op: i32) -> Result<i32, i32> {
692    let mut p_curr = 0;
693    let mut p_hiwater = 0;
694    let res = unsafe {
695        rusqlite::ffi::sqlite3_db_status(connection.handle(), op, &mut p_curr, &mut p_hiwater, 0)
696    };
697    if res != 0 { Err(res) } else { Ok(p_curr) }
698}
699
700impl MallocSizeOf for SqliteEngine {
701    fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize {
702        // 48 KB (3.3.1 at https://sqlite.org/malloc.html)
703        const DEFAULT_LOOKASIDE_SIZE: usize = 48 * 1024;
704        self.created_db_path.size_of(ops) +
705            DEFAULT_LOOKASIDE_SIZE +
706            get_db_status(
707                &self.connection,
708                rusqlite::ffi::SQLITE_DBSTATUS_CACHE_USED_SHARED,
709            )
710            .unwrap_or_default() as usize +
711            get_db_status(&self.connection, rusqlite::ffi::SQLITE_DBSTATUS_SCHEMA_USED)
712                .unwrap_or_default() as usize +
713            get_db_status(&self.connection, rusqlite::ffi::SQLITE_DBSTATUS_STMT_USED)
714                .unwrap_or_default() as usize
715    }
716}
717
718#[cfg(test)]
719mod tests {
720    use std::collections::VecDeque;
721    use std::sync::Arc;
722
723    use base::generic_channel::{self, GenericReceiver, GenericSender};
724    use base::threadpool::ThreadPool;
725    use profile_traits::generic_callback::GenericCallback;
726    use profile_traits::time::ProfilerChan;
727    use serde::{Deserialize, Serialize};
728    use servo_url::ImmutableOrigin;
729    use storage_traits::indexeddb::{
730        AsyncOperation, AsyncReadOnlyOperation, AsyncReadWriteOperation, CreateObjectResult,
731        IndexedDBKeyRange, IndexedDBKeyType, IndexedDBTxnMode, KeyPath, PutItemResult,
732    };
733    use url::Host;
734
735    use crate::indexeddb::IndexedDBDescription;
736    use crate::indexeddb::engines::{KvsEngine, KvsOperation, KvsTransaction, SqliteEngine};
737
738    fn test_origin() -> ImmutableOrigin {
739        ImmutableOrigin::Tuple(
740            "test_origin".to_string(),
741            Host::Domain("localhost".to_string()),
742            80,
743        )
744    }
745
746    fn get_pool() -> Arc<ThreadPool> {
747        Arc::new(ThreadPool::new(1, "test".to_string()))
748    }
749
750    #[test]
751    fn test_cycle() {
752        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
753        let thread_pool = get_pool();
754        // Test create
755        let _ = SqliteEngine::new(
756            base_dir.path(),
757            &IndexedDBDescription {
758                name: "test_db".to_string(),
759                origin: test_origin(),
760            },
761            thread_pool.clone(),
762        )
763        .unwrap();
764        // Test open
765        let db = SqliteEngine::new(
766            base_dir.path(),
767            &IndexedDBDescription {
768                name: "test_db".to_string(),
769                origin: test_origin(),
770            },
771            thread_pool.clone(),
772        )
773        .unwrap();
774        let version = db.version().expect("Failed to get version");
775        assert_eq!(version, 0);
776        db.set_version(5).unwrap();
777        let new_version = db.version().expect("Failed to get new version");
778        assert_eq!(new_version, 5);
779        db.delete_database().expect("Failed to delete database");
780    }
781
782    #[test]
783    fn test_create_store() {
784        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
785        let thread_pool = get_pool();
786        let db = SqliteEngine::new(
787            base_dir.path(),
788            &IndexedDBDescription {
789                name: "test_db".to_string(),
790                origin: test_origin(),
791            },
792            thread_pool,
793        )
794        .unwrap();
795        let store_name = "test_store";
796        let result = db.create_store(store_name, None, true);
797        assert!(result.is_ok());
798        let create_result = result.unwrap();
799        assert_eq!(create_result, CreateObjectResult::Created);
800        // Try to create the same store again
801        let result = db.create_store(store_name, None, false);
802        assert!(result.is_ok());
803        let create_result = result.unwrap();
804        assert_eq!(create_result, CreateObjectResult::AlreadyExists);
805        // Ensure store was not overwritten
806        assert!(db.key_generator_current_number(store_name).is_some());
807    }
808
809    #[test]
810    fn test_create_store_empty_name() {
811        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
812        let thread_pool = get_pool();
813        let db = SqliteEngine::new(
814            base_dir.path(),
815            &IndexedDBDescription {
816                name: "test_db".to_string(),
817                origin: test_origin(),
818            },
819            thread_pool,
820        )
821        .unwrap();
822        let store_name = "";
823        let result = db.create_store(store_name, None, true);
824        assert!(result.is_ok());
825        let create_result = result.unwrap();
826        assert_eq!(create_result, CreateObjectResult::Created);
827    }
828
829    #[test]
830    fn test_injection() {
831        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
832        let thread_pool = get_pool();
833        let db = SqliteEngine::new(
834            base_dir.path(),
835            &IndexedDBDescription {
836                name: "test_db".to_string(),
837                origin: test_origin(),
838            },
839            thread_pool,
840        )
841        .unwrap();
842        // Create a normal store
843        let store_name1 = "test_store";
844        let result = db.create_store(store_name1, None, true);
845        assert!(result.is_ok());
846        let create_result = result.unwrap();
847        assert_eq!(create_result, CreateObjectResult::Created);
848        // Injection
849        let store_name2 = "' OR 1=1 -- -";
850        let result = db.create_store(store_name2, None, false);
851        assert!(result.is_ok());
852        let create_result = result.unwrap();
853        assert_eq!(create_result, CreateObjectResult::Created);
854    }
855
856    #[test]
857    fn test_key_path() {
858        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
859        let thread_pool = get_pool();
860        let db = SqliteEngine::new(
861            base_dir.path(),
862            &IndexedDBDescription {
863                name: "test_db".to_string(),
864                origin: test_origin(),
865            },
866            thread_pool,
867        )
868        .unwrap();
869        let store_name = "test_store";
870        let result = db.create_store(store_name, Some(KeyPath::String("test".to_string())), true);
871        assert!(result.is_ok());
872        assert_eq!(
873            db.key_path(store_name),
874            Some(KeyPath::String("test".to_string()))
875        );
876    }
877
878    #[test]
879    fn test_delete_store() {
880        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
881        let thread_pool = get_pool();
882        let db = SqliteEngine::new(
883            base_dir.path(),
884            &IndexedDBDescription {
885                name: "test_db".to_string(),
886                origin: test_origin(),
887            },
888            thread_pool,
889        )
890        .unwrap();
891        db.create_store("test_store", None, false)
892            .expect("Failed to create store");
893        // Delete the store
894        db.delete_store("test_store")
895            .expect("Failed to delete store");
896        // Try to delete the same store again
897        let result = db.delete_store("test_store");
898        assert!(result.is_err());
899        // Try to delete a non-existing store
900        let result = db.delete_store("test_store");
901        // Should work as per spec
902        assert!(result.is_err());
903    }
904
905    #[test]
906    fn test_async_operations() {
907        fn get_channel<T>() -> (GenericSender<T>, GenericReceiver<T>)
908        where
909            T: for<'de> Deserialize<'de> + Serialize,
910        {
911            generic_channel::channel().unwrap()
912        }
913
914        fn get_callback<T>(chan: GenericSender<T>) -> GenericCallback<T>
915        where
916            T: for<'de> Deserialize<'de> + Serialize + Send + Sync,
917        {
918            GenericCallback::new(ProfilerChan(None), move |r| {
919                assert!(chan.send(r.unwrap()).is_ok());
920            })
921            .expect("Could not construct callback")
922        }
923
924        let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
925        let thread_pool = get_pool();
926        let db = SqliteEngine::new(
927            base_dir.path(),
928            &IndexedDBDescription {
929                name: "test_db".to_string(),
930                origin: test_origin(),
931            },
932            thread_pool,
933        )
934        .unwrap();
935        let store_name = "test_store";
936        db.create_store(store_name, None, false)
937            .expect("Failed to create store");
938        let put = get_channel();
939        let put2 = get_channel();
940        let put3 = get_channel();
941        let put_dup = get_channel();
942        let get_item_some = get_channel();
943        let get_item_none = get_channel();
944        let get_all_items = get_channel();
945        let count = get_channel();
946        let remove = get_channel();
947        let clear = get_channel();
948        let (done_tx, done_rx) = std::sync::mpsc::channel();
949        db.process_transaction(
950            KvsTransaction {
951                mode: IndexedDBTxnMode::Readwrite,
952                requests: VecDeque::from(vec![
953                    KvsOperation {
954                        store_name: store_name.to_owned(),
955                        operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
956                            callback: get_callback(put.0),
957                            key: Some(IndexedDBKeyType::Number(1.0)),
958                            value: vec![1, 2, 3],
959                            should_overwrite: false,
960                            key_generator_current_number: None,
961                        }),
962                    },
963                    KvsOperation {
964                        store_name: store_name.to_owned(),
965                        operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
966                            callback: get_callback(put2.0),
967                            key: Some(IndexedDBKeyType::String("2.0".to_string())),
968                            value: vec![4, 5, 6],
969                            should_overwrite: false,
970                            key_generator_current_number: None,
971                        }),
972                    },
973                    KvsOperation {
974                        store_name: store_name.to_owned(),
975                        operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
976                            callback: get_callback(put3.0),
977                            key: Some(IndexedDBKeyType::Array(vec![
978                                IndexedDBKeyType::String("3".to_string()),
979                                IndexedDBKeyType::Number(0.0),
980                            ])),
981                            value: vec![7, 8, 9],
982                            should_overwrite: false,
983                            key_generator_current_number: None,
984                        }),
985                    },
986                    // Try to put a duplicate key without overwrite
987                    KvsOperation {
988                        store_name: store_name.to_owned(),
989                        operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
990                            callback: get_callback(put_dup.0),
991                            key: Some(IndexedDBKeyType::Number(1.0)),
992                            value: vec![10, 11, 12],
993                            should_overwrite: false,
994                            key_generator_current_number: None,
995                        }),
996                    },
997                    KvsOperation {
998                        store_name: store_name.to_owned(),
999                        operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetItem {
1000                            callback: get_callback(get_item_some.0),
1001                            key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(1.0)),
1002                        }),
1003                    },
1004                    KvsOperation {
1005                        store_name: store_name.to_owned(),
1006                        operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetItem {
1007                            callback: get_callback(get_item_none.0),
1008                            key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(5.0)),
1009                        }),
1010                    },
1011                    KvsOperation {
1012                        store_name: store_name.to_owned(),
1013                        operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetAllItems {
1014                            callback: get_callback(get_all_items.0),
1015                            key_range: IndexedDBKeyRange::lower_bound(
1016                                IndexedDBKeyType::Number(0.0),
1017                                false,
1018                            ),
1019                            count: None,
1020                        }),
1021                    },
1022                    KvsOperation {
1023                        store_name: store_name.to_owned(),
1024                        operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::Count {
1025                            callback: get_callback(count.0),
1026                            key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(1.0)),
1027                        }),
1028                    },
1029                    KvsOperation {
1030                        store_name: store_name.to_owned(),
1031                        operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::RemoveItem {
1032                            callback: get_callback(remove.0),
1033                            key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(1.0)),
1034                        }),
1035                    },
1036                    KvsOperation {
1037                        store_name: store_name.to_owned(),
1038                        operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::Clear(
1039                            get_callback(clear.0),
1040                        )),
1041                    },
1042                ]),
1043            },
1044            Box::new(move || {
1045                let _ = done_tx.send(());
1046            }),
1047        );
1048        let _ = done_rx.recv().unwrap();
1049        put.1.recv().unwrap().unwrap();
1050        put2.1.recv().unwrap().unwrap();
1051        put3.1.recv().unwrap().unwrap();
1052        let err = put_dup.1.recv().unwrap().unwrap();
1053        assert_eq!(err, PutItemResult::CannotOverwrite);
1054        let get_result = get_item_some.1.recv().unwrap();
1055        let value = get_result.unwrap();
1056        assert_eq!(value, Some(vec![1, 2, 3]));
1057        let get_result = get_item_none.1.recv().unwrap();
1058        let value = get_result.unwrap();
1059        assert_eq!(value, None);
1060        let all_items = get_all_items.1.recv().unwrap().unwrap();
1061        assert_eq!(all_items.len(), 3);
1062        // Check that all three items are present
1063        assert!(all_items.contains(&vec![1, 2, 3]));
1064        assert!(all_items.contains(&vec![4, 5, 6]));
1065        assert!(all_items.contains(&vec![7, 8, 9]));
1066        let amount = count.1.recv().unwrap().unwrap();
1067        assert_eq!(amount, 1);
1068        remove.1.recv().unwrap().unwrap();
1069        clear.1.recv().unwrap().unwrap();
1070    }
1071}