forked from coracle/caravel
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
# `pub struct Command`
|
|
|
|
Command writes to the database.
|
|
|
|
Members:
|
|
|
|
- `pool: SqlitePool` - a sqlite connection pool
|
|
|
|
Notes:
|
|
|
|
- All public write methods should be atomic
|
|
- All writes should be accompanied by an activity log entry of `(tenant, activity_type, resource_type, resource_id)`
|
|
|
|
## `pub fn new(&self, pool: SqlitePool) -> Self`
|
|
|
|
- Assigns pool to self
|
|
|
|
## `pub fn create_tenant(&self, tenant: &Tenant) -> Result<()>`
|
|
|
|
- Creates tenant, may throw sqlite uniqueness error on pubkey
|
|
- Logs activity as `(create_tenant, tenant_id)`
|
|
|
|
## `pub fn update_tenant(&self, tenant: &Tenant) -> Result<()>`
|
|
|
|
- Updates tenant
|
|
- Logs activity as `(update_tenant, tenant_id)`
|
|
|
|
## `pub fn create_relay(&self, relay: &Relay) -> Result<()>`
|
|
|
|
- Creates relay, may throw sqlite uniqueness error on subdomain
|
|
- Sets relay status to `new`
|
|
- Logs activity as `(create_relay, relay_id)`
|
|
|
|
## `pub fn update_relay(&self, relay: &Relay) -> Result<()>`
|
|
|
|
- Updates relay, may throw sqlite uniqueness error on subdomain
|
|
- Logs activity as `(update_relay, relay_id)`
|
|
|
|
## `pub fn deactivate_relay(&self, relay: &Relay) -> Result<()>`
|
|
|
|
- Sets relay status to `inactive`
|
|
- Logs activity as `(deactivate_relay, relay_id)`
|
|
|
|
## `pub fn activate_relay(&self, relay: &Relay) -> Result<()>`
|
|
|
|
- Sets relay status to `active`
|
|
- Logs activity as `(activate_relay, relay_id)`
|
|
|
|
## `pub fn fail_relay_sync(&self, relay: &Relay, sync_error: &str) -> Result<()>`
|
|
|
|
- Sets relay status to `inactive`, sets `sync_error`
|
|
- Logs activity as `(fail_relay_sync, relay_id)`
|
|
|
|
## `pub fn mark_relay_synced(&self, relay_id: &str) -> Result<()>`
|
|
|
|
- Sets `synced = 1`, `status = 'active'`, clears `sync_error`
|
|
- No activity log (called by infra after successful sync)
|