Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
//! Bounded, retry-safe table imports. CSV syntax is decoded by the client library.
use super::models::{DatabaseError, DatabaseId, PropertyDefinitionId, Table, Viewer};
use entity_access::domain::models::{EditAccessLevel, EntityAccessReceipt};
use models_properties::service::property_value::PropertyValue;
use serde::{Deserialize, Serialize};
use uuid::Uuid;
/// An import is identified once, before sending, so retries cannot duplicate rows.
#[derive(Debug, Clone, Deserialize, Serialize, utoipa::ToSchema)]
#[serde(rename_all = "camelCase")]
pub struct ImportTable {
/// Stable key for this import, retained through retries.
pub request_id: Uuid,
/// New table's display name.
pub name: String,
/// Header names, in order. All imported values remain text.
pub columns: Vec<String>,
/// Rectangular text rows. Empty fields are preserved.
pub rows: Vec<Vec<String>>,
}
/// The digest of an import's normalized contents, so a retry can be told
/// from a reused request key.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ImportFingerprint(pub String);
/// Atomic persistence outcome; only a created result has consumed the definitions.
#[derive(Debug)]
pub enum ImportOutcome {
/// Created the table, its columns, its rows and their cells in one
/// transaction.
Created(Table),
/// The same request already committed.
Replayed(Table),
/// A different request already used this table name.
NameConflict,
/// The request key was reused with different contents.
KeyConflict,
/// The database was removed while importing.
NotFound,
}
/// Persistence mechanics for atomic imports.
pub trait DatabaseTransferRepo: Send + Sync + 'static {
/// Persistence error.
type Error: std::error::Error + Send + Sync + 'static;
/// Find an earlier committed request, even after its table was renamed.
fn imported_table(
&self,
database_id: DatabaseId,
request_id: Uuid,
) -> impl Future<Output = Result<Option<(Table, ImportFingerprint)>, Self::Error>> + Send;
/// Create the table, its placements, its rows and their cells together,
/// serializing on the database. `cells` holds one entry per row of
/// [`ImportTable::rows`], in order.
fn import_table(
&self,
database_id: DatabaseId,
viewer: &Viewer,
request: &ImportTable,
fingerprint: &ImportFingerprint,
definitions: &[PropertyDefinitionId],
cells: &[Vec<(PropertyDefinitionId, PropertyValue)>],
) -> impl Future<Output = Result<ImportOutcome, Self::Error>> + Send;
}
/// Import use case, with edit capability checked at the boundary.
pub trait DatabaseTransferService: Send + Sync + 'static {
/// Import into a new table without rounding numbers or overwriting existing data.
fn import_table(
&self,
receipt: EntityAccessReceipt<EditAccessLevel>,
viewer: Viewer,
request: ImportTable,
) -> impl Future<Output = Result<Table, DatabaseError>> + Send;
}