Skip to main content

uqa_storage_sqlite/mvcc/
resources.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Resource owners use their own native admission, separate from receipt allocation and SSI.
8
9use uqa_storage::{
10    mvcc::{
11        ResourceLease, ResourceLeaseId, ResourceLeaseProvider, ResourceLeaseRequest, VersionError,
12        VersionResult,
13    },
14    read_control::StorageReadControl,
15};
16
17use super::SQLiteRecordStore;
18
19#[cfg(any(windows, all(unix, not(target_os = "emscripten"))))]
20pub(super) fn lease_file(
21    path: &std::path::Path,
22    database: uqa_storage::mvcc::DatabaseId,
23) -> VersionResult<super::leases::NativeLeaseFile> {
24    let uqa_storage::PersistentStorageIdentity::File(path) =
25        uqa_storage::PersistentStorageIdentity::for_database_path(path)?
26    else {
27        unreachable!("file resource identity")
28    };
29    let mut sidecar = path.into_os_string();
30    sidecar.push(".uqa-resource-leases");
31    super::leases::NativeLeaseFile::open(
32        std::path::Path::new(&sidecar),
33        super::leases::LeaseNamespace {
34            magic: *b"UQARSL01",
35            database,
36            incarnation: None,
37        },
38    )
39}
40
41impl ResourceLeaseProvider for SQLiteRecordStore {
42    fn try_acquire_resource(
43        &self,
44        id: ResourceLeaseId,
45        request: ResourceLeaseRequest,
46        control: &StorageReadControl,
47    ) -> VersionResult<Option<ResourceLease>> {
48        control.check()?;
49        if id.database() != self.identity {
50            return Err(VersionError::WrongDatabase);
51        }
52        #[cfg(any(windows, all(unix, not(target_os = "emscripten"))))]
53        if let Some(path) = self.connection.database_path() {
54            let file = lease_file(path, self.identity)?;
55            let _admission = file.admit(control)?;
56            self.with(|connection| {
57                super::codec::header(connection, self.identity)?;
58                Ok(())
59            })?;
60            let mut live = false;
61            file.visit(control, &mut |tag| {
62                live |= tag == id.tag(ResourceLeaseRequest::Recover)
63                    || (request != ResourceLeaseRequest::Share
64                        && tag == id.tag(ResourceLeaseRequest::Share));
65                Ok(())
66            })?;
67            if live {
68                return Ok(None);
69            }
70            let retained = file.retain_with(id.tag(request), self.connection.clone(), control)?;
71            return ResourceLease::retain(id, retained, control).map(Some);
72        }
73        self.with(|connection| {
74            super::codec::header(connection, self.identity)?;
75            Ok(())
76        })?;
77        #[cfg(not(any(windows, all(unix, not(target_os = "emscripten")))))]
78        if let Some(path) = self.connection.database_path() {
79            let state = super::receipts::local_file_registry(path)?;
80            return self
81                .connection
82                .with_local_receipt_admission(Some(&state), control, |leases| {
83                    uqa_storage::mvcc::retain_local_resource(leases, id, request, control)
84                });
85        }
86        self.connection
87            .with_local_receipt_admission(None, control, |leases| {
88                uqa_storage::mvcc::retain_local_resource(leases, id, request, control)
89            })
90    }
91}