architect_sdk/config/
resolved.rs

1//! Resolved entity model: config validated and flattened for runtime use.
2
3use crate::config::types::{
4    AssetColumnConfig, EntityEventTrigger, McpEntityConfig, VersioningConfig,
5};
6use crate::config::ValidationRule;
7use std::collections::{HashMap, HashSet};
8
9/// Direction of a related-include: to_one (we have FK to them) or to_many (they have FK to us).
10#[derive(Clone, Debug)]
11pub enum IncludeDirection {
12    ToOne,
13    ToMany,
14}
15
16/// Spec for including a related entity in list/read responses. Name is the related entity's path_segment (e.g. "orders", "users").
17#[derive(Clone, Debug)]
18pub struct IncludeSpec {
19    /// API name for the include (path_segment of the related entity).
20    pub name: String,
21    pub direction: IncludeDirection,
22    /// Path segment of the related entity (for lookup in model).
23    pub related_path_segment: String,
24    /// Our column used in the join (our FK for to_one; our PK for to_many).
25    pub our_key_column: String,
26    /// Their column used in the join (their PK for to_one; their FK for to_many).
27    pub their_key_column: String,
28}
29
30/// Primary key type for parsing path/body ids.
31#[derive(Clone, Debug)]
32pub enum PkType {
33    Uuid,
34    BigInt,
35    Int,
36    Text,
37}
38
39#[derive(Clone, Debug)]
40pub struct ColumnInfo {
41    pub name: String,
42    pub pk_type: Option<PkType>,
43    pub nullable: bool,
44    /// Whether the column has a DB default (e.g. gen_random_uuid(), NOW()).
45    pub has_default: bool,
46    /// PostgreSQL type name for SQL casts (e.g. "timestamptz") when binding string values.
47    pub pg_type: Option<String>,
48    /// True when the column was declared with type "asset" or "asset[]".
49    pub is_asset: bool,
50    /// True when the column was declared with type "asset[]" (stores a JSONB array of paths).
51    pub asset_is_array: bool,
52    /// Storage config for asset columns (prefix template, compression).
53    pub asset_config: Option<AssetColumnConfig>,
54}
55
56#[derive(Clone, Debug)]
57pub struct ResolvedEntity {
58    pub table_id: String,
59    pub schema_name: String,
60    pub table_name: String,
61    pub path_segment: String,
62    pub pk_columns: Vec<String>,
63    pub pk_type: PkType,
64    pub columns: Vec<ColumnInfo>,
65    pub operations: Vec<String>,
66    /// Column names to strip from all API responses (sensitive data).
67    pub sensitive_columns: HashSet<String>,
68    /// Available includes (related entities) for ?include= name1,name2. Built from relationships.
69    pub includes: Vec<IncludeSpec>,
70    pub validation: HashMap<String, ValidationRule>,
71    /// Decision-hub event triggers. Empty when no events are configured.
72    pub events: Vec<EntityEventTrigger>,
73    /// Column whose null→non-null transition signals an archive (for on:"archive" triggers).
74    pub archive_field: Option<String>,
75    /// Package id this entity belongs to. Set via ResolvedModel::with_package_id().
76    pub package_id: String,
77    /// When true, a companion `{table}_audit` table exists and every write is journaled there.
78    pub audit_log: bool,
79    /// Natural-key column used to resolve `parentRef` in bulk create (e.g. `"location_id"`).
80    pub parent_ref_column: Option<String>,
81    /// Row-level versioning config, carried from TableConfig.
82    pub versioning: Option<VersioningConfig>,
83    /// MCP exposure config, carried from ApiEntityConfig. None when not set.
84    pub mcp: Option<McpEntityConfig>,
85    /// Names of JSON/JSONB columns flagged `extensible: true`. Each is a extensible-fields bag
86    /// whose per-tenant field definitions live in the KV registry and whose keys are
87    /// RSQL-filterable/sortable via the `<column>.<key>` syntax. Empty when none configured.
88    pub extensible_columns: Vec<String>,
89}
90
91#[derive(Clone, Debug)]
92pub struct ResolvedModel {
93    pub entities: Vec<ResolvedEntity>,
94    pub entity_by_path: HashMap<String, ResolvedEntity>,
95}
96
97impl ResolvedModel {
98    pub fn entity_by_path(&self, path: &str) -> Option<&ResolvedEntity> {
99        self.entity_by_path.get(path)
100    }
101
102    /// Backfill `package_id` on all contained entities. Call this after `resolve()` when the
103    /// package id is known (e.g. from manifest.id or the route parameter).
104    pub fn with_package_id(mut self, package_id: &str) -> Self {
105        for e in &mut self.entities {
106            e.package_id = package_id.to_string();
107        }
108        for e in self.entity_by_path.values_mut() {
109            e.package_id = package_id.to_string();
110        }
111        self
112    }
113}
architect_sdk/config/resolved.rs

architect_sdk/config/
resolved.rs
