multiFK2

common/src/proto/komp_ac.table_definition.rs

@@ -6,16 +6,18 @@ pub struct PostTableDefinitionRequest {
     /// Table name to create inside the target profile.
     /// Must be lowercase, alphanumeric with underscores,
     /// start with a letter, and be \<= 63 chars.
-    /// Forbidden names: "id", "deleted", "created_at", "row_revision", or ending in "\_id".
+    /// Forbidden names: "id", "deleted", "created_at", "row_revision" -- the
+    /// system columns, which share one namespace with table names wherever the
+    /// two are named side by side. The "\_id" suffix is allowed.
     #[prost(string, tag = "1")]
     pub table_name: ::prost::alloc::string::String,
-    /// List of user-defined columns (adds to system/id/fk columns).
+    /// The table's columns, including its links. System columns are added on top.
     #[prost(message, repeated, tag = "3")]
     pub columns: ::prost::alloc::vec::Vec<ColumnDefinition>,
-    /// List of column names to be indexed (must match existing user-defined columns).
-    /// Indexes can target only user-defined columns; system columns ("id", "deleted",
-    /// "created_at", "row_revision") and automatically generated foreign key ("\*\_id") columns already
-    /// have indexes. Requests trying to index those columns are rejected.
+    /// Column names to index, matching names declared above. System columns
+    /// ("id", "deleted", "created_at", "row_revision") already have indexes, and
+    /// a LINK column is indexed when it is created. Requests naming either are
+    /// rejected.
     #[prost(string, repeated, tag = "4")]
     pub indexes: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
     /// Name of profile (Postgres schema) where the table will be created.
@@ -106,9 +108,13 @@ pub struct AddTableColumnsRequest {
 #[derive(serde::Serialize, serde::Deserialize)]
 #[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]
 pub struct ColumnDefinition {
-    /// Column name that follows the same validation rules as table_name.
-    /// Must be lowercase, start with a letter, no uppercase characters,
-    /// and cannot be "id", "deleted", "created_at", "row_revision", or end with "\_id".
+    /// Must be lowercase, start with a letter, and use only lowercase letters,
+    /// digits and underscores.
+    ///
+    /// Cannot be "id", "deleted", "created_at" or "row_revision": those are
+    /// system columns, and a data request names system and user columns in one
+    /// namespace. Any other name is free, including one ending in "\_id" -- no
+    /// column name is derived from a table name, so nothing collides.
     #[prost(string, tag = "1")]
     pub name: ::prost::alloc::string::String,
     /// Logical column type. Supported values (case-insensitive):

common/src/proto/komp_ac.table_script.rs

@@ -127,6 +127,18 @@ pub struct ScriptDependency {
     /// Relationship table used to match the owner row to the related collection.
     #[prost(string, tag = "5")]
     pub via_table: ::prost::alloc::string::String,
+    /// Column of the current row holding the referenced row's id: the link this
+    /// dependency travels, resolved when the script was saved. Empty when no link
+    /// is travelled -- a self-reference, or an aggregate, which follows a path
+    /// instead. A table may link to one target several times, so this is the only
+    /// thing that says which link was meant; never derive it from target_table.
+    #[prost(string, tag = "6")]
+    pub link_column: ::prost::alloc::string::String,
+    /// The first argument exactly as the script wrote it: a link alias, or the
+    /// target table's name where one link makes that unambiguous. The Steel
+    /// runtime looks its inputs up by this text.
+    #[prost(string, tag = "7")]
+    pub name_in_script: ::prost::alloc::string::String,
 }
 /// Identifies the active form row whose external Steel inputs must be hydrated.
 #[derive(Clone, PartialEq, ::prost::Message)]

common/src/proto/komp_ac.table_structure.rs

@@ -26,7 +26,7 @@ pub struct GetTableStructureResponse {
 pub struct TableStructureResponse {
     /// Columns of the physical table, including system columns (id, deleted,
     /// created_at, row_revision), user-defined columns, and any foreign-key columns such as
-    /// "\<linked_table>\_id", plus the dedicated "account_id" column on
+    /// named by whoever declared each link, plus the dedicated "account_id" on
     /// ACCOUNTING-enabled tables. May be empty if the physical table is missing.
     #[prost(message, repeated, tag = "1")]
     pub columns: ::prost::alloc::vec::Vec<TableColumn>,

common/src/proto/komp_ac.tables_data.rs

@@ -17,7 +17,7 @@ pub struct PostTableDataRequest {
     /// * User-defined columns from the table definition
     /// * System/FK columns:
     ///   • "deleted" (BOOLEAN), optional; default FALSE if not provided
-    ///   • "\<linked_table>\_id" (BIGINT) for each table link
+    ///   • one BIGINT per link, named by whoever declared it
     ///   • "account_id" (BIGINT) on ACCOUNTING-enabled tables
     ///
     /// Type expectations by SQL type:
@@ -190,7 +190,7 @@ pub struct GetTableDataResponse {
     ///
     /// * id, deleted
     /// * all user-defined columns from the table definition
-    /// * FK columns named "\<linked_table>\_id" for each table link
+    /// * one column per link, named by whoever declared it
     /// * account_id for ACCOUNTING-enabled tables
     ///
     /// All values are returned as TEXT via col::TEXT and COALESCEed to empty string
@@ -482,7 +482,7 @@ pub mod tables_data_client {
         /// * Validates profile and table definition
         /// * Returns all columns as strings (COALESCE(col::TEXT, '') AS col)
         ///  including: id, deleted, row_revision, all user-defined columns, and FK columns
-        ///  named "\<linked_table>\_id" for each table link, plus "account_id" on
+        ///  named by whoever declared each link, plus "account_id" on
         ///  ACCOUNTING-enabled tables
         /// * Fails with NOT_FOUND if record does not exist or is soft-deleted
         /// * If the physical table is missing but the definition exists, returns INTERNAL
@@ -675,7 +675,7 @@ pub mod tables_data_server {
         /// * Validates profile and table definition
         /// * Returns all columns as strings (COALESCE(col::TEXT, '') AS col)
         ///  including: id, deleted, row_revision, all user-defined columns, and FK columns
-        ///  named "\<linked_table>\_id" for each table link, plus "account_id" on
+        ///  named by whoever declared each link, plus "account_id" on
         ///  ACCOUNTING-enabled tables
         /// * Fails with NOT_FOUND if record does not exist or is soft-deleted
         /// * If the physical table is missing but the definition exists, returns INTERNAL