Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

feat(forms): brand public forms with a logo, cover image and accent color (#9340)

Wolf Mermelstein58df387dd6b1
diff --git a/.sqlx/query-81dfafeeefe28e247f0b06921d536bf20d646365bb6dbd68a80a21c5d6e1cdf5.json b/.sqlx/query-6b904d2c71124ca1553d2179f55196c0d2a8da2f193aa569845004f333982513.json
similarity index 76%
rename from .sqlx/query-81dfafeeefe28e247f0b06921d536bf20d646365bb6dbd68a80a21c5d6e1cdf5.json
rename to .sqlx/query-6b904d2c71124ca1553d2179f55196c0d2a8da2f193aa569845004f333982513.json
index e854e0eff8..1f6ed07e99 100644
--- a/.sqlx/query-81dfafeeefe28e247f0b06921d536bf20d646365bb6dbd68a80a21c5d6e1cdf5.json
+++ b/.sqlx/query-6b904d2c71124ca1553d2179f55196c0d2a8da2f193aa569845004f333982513.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n SELECT id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n FROM forms WHERE id = ANY($1) AND trashed_at IS NULL\n ORDER BY id\n ",
+ "query": "\n SELECT id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,\n created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n FROM forms WHERE id = ANY($1) AND trashed_at IS NULL\n ORDER BY id\n ",
"describe": {
"columns": [
{
@@ -70,26 +70,41 @@
},
{
"ordinal": 13,
+ "name": "logo_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 14,
+ "name": "cover_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 15,
+ "name": "accent_color",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 16,
"name": "created_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 14,
+ "ordinal": 17,
"name": "updated_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 15,
+ "ordinal": 18,
"name": "trashed_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 16,
+ "ordinal": 19,
"name": "name_follows_database",
"type_info": "Bool"
},
{
- "ordinal": 17,
+ "ordinal": 20,
"name": "is_hidden_in_drive",
"type_info": "Bool"
}
@@ -113,6 +128,9 @@
false,
true,
false,
+ true,
+ true,
+ true,
false,
false,
true,
@@ -120,5 +138,5 @@
false
]
},
- "hash": "81dfafeeefe28e247f0b06921d536bf20d646365bb6dbd68a80a21c5d6e1cdf5"
+ "hash": "6b904d2c71124ca1553d2179f55196c0d2a8da2f193aa569845004f333982513"
}
diff --git a/.sqlx/query-1021df133a51edb89e15fb3c8933a8514598fd449882f44c0a8ad386fa7676aa.json b/.sqlx/query-6bb62869ece5d2438ea8431080ecd647d496b1500dabfdb8921575cb4843c980.json
similarity index 78%
rename from .sqlx/query-1021df133a51edb89e15fb3c8933a8514598fd449882f44c0a8ad386fa7676aa.json
rename to .sqlx/query-6bb62869ece5d2438ea8431080ecd647d496b1500dabfdb8921575cb4843c980.json
index 02e402e305..519d3c54bc 100644
--- a/.sqlx/query-1021df133a51edb89e15fb3c8933a8514598fd449882f44c0a8ad386fa7676aa.json
+++ b/.sqlx/query-6bb62869ece5d2438ea8431080ecd647d496b1500dabfdb8921575cb4843c980.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n SELECT id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n FROM forms WHERE id = $1\n ",
+ "query": "\n SELECT id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,\n created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n FROM forms WHERE id = $1\n ",
"describe": {
"columns": [
{
@@ -70,26 +70,41 @@
},
{
"ordinal": 13,
+ "name": "logo_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 14,
+ "name": "cover_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 15,
+ "name": "accent_color",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 16,
"name": "created_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 14,
+ "ordinal": 17,
"name": "updated_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 15,
+ "ordinal": 18,
"name": "trashed_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 16,
+ "ordinal": 19,
"name": "name_follows_database",
"type_info": "Bool"
},
{
- "ordinal": 17,
+ "ordinal": 20,
"name": "is_hidden_in_drive",
"type_info": "Bool"
}
@@ -113,6 +128,9 @@
false,
true,
false,
+ true,
+ true,
+ true,
false,
false,
true,
@@ -120,5 +138,5 @@
false
]
},
- "hash": "1021df133a51edb89e15fb3c8933a8514598fd449882f44c0a8ad386fa7676aa"
+ "hash": "6bb62869ece5d2438ea8431080ecd647d496b1500dabfdb8921575cb4843c980"
}
diff --git a/.sqlx/query-424f081fb325d1e019cc021925c1e85b7765ada0d0c962e08f5062eb29e5845a.json b/.sqlx/query-7299880543d00414f154d2b35943d15a763e6360cb21dd0e0197f80298a754b9.json
similarity index 75%
rename from .sqlx/query-424f081fb325d1e019cc021925c1e85b7765ada0d0c962e08f5062eb29e5845a.json
rename to .sqlx/query-7299880543d00414f154d2b35943d15a763e6360cb21dd0e0197f80298a754b9.json
index 47ad845fa9..ae4fe51815 100644
--- a/.sqlx/query-424f081fb325d1e019cc021925c1e85b7765ada0d0c962e08f5062eb29e5845a.json
+++ b/.sqlx/query-7299880543d00414f154d2b35943d15a763e6360cb21dd0e0197f80298a754b9.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n SELECT id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n FROM forms WHERE database_id = $1 AND trashed_at IS NULL\n ORDER BY created_at, id\n ",
+ "query": "\n SELECT id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,\n created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n FROM forms WHERE database_id = $1 AND trashed_at IS NULL\n ORDER BY created_at, id\n ",
"describe": {
"columns": [
{
@@ -70,26 +70,41 @@
},
{
"ordinal": 13,
+ "name": "logo_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 14,
+ "name": "cover_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 15,
+ "name": "accent_color",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 16,
"name": "created_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 14,
+ "ordinal": 17,
"name": "updated_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 15,
+ "ordinal": 18,
"name": "trashed_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 16,
+ "ordinal": 19,
"name": "name_follows_database",
"type_info": "Bool"
},
{
- "ordinal": 17,
+ "ordinal": 20,
"name": "is_hidden_in_drive",
"type_info": "Bool"
}
@@ -113,6 +128,9 @@
false,
true,
false,
+ true,
+ true,
+ true,
false,
false,
true,
@@ -120,5 +138,5 @@
false
]
},
- "hash": "424f081fb325d1e019cc021925c1e85b7765ada0d0c962e08f5062eb29e5845a"
+ "hash": "7299880543d00414f154d2b35943d15a763e6360cb21dd0e0197f80298a754b9"
}
diff --git a/.sqlx/query-f18615e2804605069e9d39fa0b75d112cb029bb915138e3fdbc997b8c57d7544.json b/.sqlx/query-e30105d1ce1d17aa6b38c609ff2cc579ed426936d0f6c54708e39f8a7da80067.json
similarity index 58%
rename from .sqlx/query-f18615e2804605069e9d39fa0b75d112cb029bb915138e3fdbc997b8c57d7544.json
rename to .sqlx/query-e30105d1ce1d17aa6b38c609ff2cc579ed426936d0f6c54708e39f8a7da80067.json
index 55d996240d..240866a897 100644
--- a/.sqlx/query-f18615e2804605069e9d39fa0b75d112cb029bb915138e3fdbc997b8c57d7544.json
+++ b/.sqlx/query-e30105d1ce1d17aa6b38c609ff2cc579ed426936d0f6c54708e39f8a7da80067.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n INSERT INTO forms (\n id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at,\n name_follows_database, is_hidden_in_drive\n )\n VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17)\n ON CONFLICT (table_id) DO NOTHING\n ",
+ "query": "\n INSERT INTO forms (\n id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id,\n accent_color, created_at, updated_at, name_follows_database, is_hidden_in_drive\n )\n VALUES (\n $1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18,\n $19, $20\n )\n ON CONFLICT (table_id) DO NOTHING\n ",
"describe": {
"columns": [],
"parameters": {
@@ -18,6 +18,9 @@
"Text",
"Timestamptz",
"Text",
+ "Uuid",
+ "Uuid",
+ "Text",
"Timestamptz",
"Timestamptz",
"Bool",
@@ -26,5 +29,5 @@
},
"nullable": []
},
- "hash": "f18615e2804605069e9d39fa0b75d112cb029bb915138e3fdbc997b8c57d7544"
+ "hash": "e30105d1ce1d17aa6b38c609ff2cc579ed426936d0f6c54708e39f8a7da80067"
}
diff --git a/.sqlx/query-18ddf9a81f359955646ee0737a87c9d3d730934d2fa917cbd72c930e64fe9a5f.json b/.sqlx/query-ea44656ddebaee025a59c283b3d87f4f962a0954efbe1765757f48dc01381039.json
similarity index 68%
rename from .sqlx/query-18ddf9a81f359955646ee0737a87c9d3d730934d2fa917cbd72c930e64fe9a5f.json
rename to .sqlx/query-ea44656ddebaee025a59c283b3d87f4f962a0954efbe1765757f48dc01381039.json
index 201408617a..4d4f172749 100644
--- a/.sqlx/query-18ddf9a81f359955646ee0737a87c9d3d730934d2fa917cbd72c930e64fe9a5f.json
+++ b/.sqlx/query-ea44656ddebaee025a59c283b3d87f4f962a0954efbe1765757f48dc01381039.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n UPDATE forms SET\n description = COALESCE($2, description),\n confirmation_message = COALESCE($3, confirmation_message),\n audience = COALESCE($4, audience),\n status = COALESCE($5, status),\n closes_at = CASE WHEN $6 THEN $7 ELSE closes_at END,\n tally_visible = COALESCE($8, tally_visible),\n updated_at = $9\n WHERE id = $1\n RETURNING id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n ",
+ "query": "\n UPDATE forms SET\n description = COALESCE($2, description),\n confirmation_message = COALESCE($3, confirmation_message),\n audience = COALESCE($4, audience),\n status = COALESCE($5, status),\n closes_at = CASE WHEN $6 THEN $7 ELSE closes_at END,\n tally_visible = COALESCE($8, tally_visible),\n logo_file_id = CASE WHEN $10 THEN $11 ELSE logo_file_id END,\n cover_file_id = CASE WHEN $12 THEN $13 ELSE cover_file_id END,\n accent_color = CASE WHEN $14 THEN $15 ELSE accent_color END,\n updated_at = $9\n WHERE id = $1\n RETURNING id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,\n created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n ",
"describe": {
"columns": [
{
@@ -70,26 +70,41 @@
},
{
"ordinal": 13,
+ "name": "logo_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 14,
+ "name": "cover_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 15,
+ "name": "accent_color",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 16,
"name": "created_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 14,
+ "ordinal": 17,
"name": "updated_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 15,
+ "ordinal": 18,
"name": "trashed_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 16,
+ "ordinal": 19,
"name": "name_follows_database",
"type_info": "Bool"
},
{
- "ordinal": 17,
+ "ordinal": 20,
"name": "is_hidden_in_drive",
"type_info": "Bool"
}
@@ -104,7 +119,13 @@
"Bool",
"Timestamptz",
"Bool",
- "Timestamptz"
+ "Timestamptz",
+ "Bool",
+ "Uuid",
+ "Bool",
+ "Uuid",
+ "Bool",
+ "Text"
]
},
"nullable": [
@@ -121,6 +142,9 @@
false,
true,
false,
+ true,
+ true,
+ true,
false,
false,
true,
@@ -128,5 +152,5 @@
false
]
},
- "hash": "18ddf9a81f359955646ee0737a87c9d3d730934d2fa917cbd72c930e64fe9a5f"
+ "hash": "ea44656ddebaee025a59c283b3d87f4f962a0954efbe1765757f48dc01381039"
}
diff --git a/.sqlx/query-13166bb9d8d4ec58f119df4b2fd3a88ba49358fbb0f8e6a41257616eabc756ce.json b/.sqlx/query-eb692208e1273bce856a1ccb7178b6c9fde96993bff24aed441f5119e5079f93.json
similarity index 80%
rename from .sqlx/query-13166bb9d8d4ec58f119df4b2fd3a88ba49358fbb0f8e6a41257616eabc756ce.json
rename to .sqlx/query-eb692208e1273bce856a1ccb7178b6c9fde96993bff24aed441f5119e5079f93.json
index 1da4e3612e..203c75c53a 100644
--- a/.sqlx/query-13166bb9d8d4ec58f119df4b2fd3a88ba49358fbb0f8e6a41257616eabc756ce.json
+++ b/.sqlx/query-eb692208e1273bce856a1ccb7178b6c9fde96993bff24aed441f5119e5079f93.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n UPDATE forms SET updated_at = $2\n WHERE id = $1 AND trashed_at IS NULL\n RETURNING id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n ",
+ "query": "\n UPDATE forms SET updated_at = $2\n WHERE id = $1 AND trashed_at IS NULL\n RETURNING id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,\n created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n ",
"describe": {
"columns": [
{
@@ -70,26 +70,41 @@
},
{
"ordinal": 13,
+ "name": "logo_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 14,
+ "name": "cover_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 15,
+ "name": "accent_color",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 16,
"name": "created_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 14,
+ "ordinal": 17,
"name": "updated_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 15,
+ "ordinal": 18,
"name": "trashed_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 16,
+ "ordinal": 19,
"name": "name_follows_database",
"type_info": "Bool"
},
{
- "ordinal": 17,
+ "ordinal": 20,
"name": "is_hidden_in_drive",
"type_info": "Bool"
}
@@ -114,6 +129,9 @@
false,
true,
false,
+ true,
+ true,
+ true,
false,
false,
true,
@@ -121,5 +139,5 @@
false
]
},
- "hash": "13166bb9d8d4ec58f119df4b2fd3a88ba49358fbb0f8e6a41257616eabc756ce"
+ "hash": "eb692208e1273bce856a1ccb7178b6c9fde96993bff24aed441f5119e5079f93"
}
diff --git a/.sqlx/query-0324782b3a73b0449ea096091d52edf33cf128bb77eee4bf09032e7b4785fe9b.json b/.sqlx/query-ef9fd96657a6b0d5e101362ea2b6551efb6368d1add53d977df6f0b48f6ef178.json
similarity index 80%
rename from .sqlx/query-0324782b3a73b0449ea096091d52edf33cf128bb77eee4bf09032e7b4785fe9b.json
rename to .sqlx/query-ef9fd96657a6b0d5e101362ea2b6551efb6368d1add53d977df6f0b48f6ef178.json
index 880dcdc0cd..84e5fcd079 100644
--- a/.sqlx/query-0324782b3a73b0449ea096091d52edf33cf128bb77eee4bf09032e7b4785fe9b.json
+++ b/.sqlx/query-ef9fd96657a6b0d5e101362ea2b6551efb6368d1add53d977df6f0b48f6ef178.json
@@ -1,6 +1,6 @@
{
"db_name": "PostgreSQL",
- "query": "\n UPDATE forms SET name = $2, updated_at = $3\n WHERE id = $1 AND trashed_at IS NULL\n RETURNING id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n ",
+ "query": "\n UPDATE forms SET name = $2, updated_at = $3\n WHERE id = $1 AND trashed_at IS NULL\n RETURNING id, name, description, owner_id, database_id, table_id,\n submitted_column_id, respondent_column_id, audience, tally_visible,\n status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,\n created_at, updated_at, trashed_at,\n name_follows_database, is_hidden_in_drive\n ",
"describe": {
"columns": [
{
@@ -70,26 +70,41 @@
},
{
"ordinal": 13,
+ "name": "logo_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 14,
+ "name": "cover_file_id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 15,
+ "name": "accent_color",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 16,
"name": "created_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 14,
+ "ordinal": 17,
"name": "updated_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 15,
+ "ordinal": 18,
"name": "trashed_at",
"type_info": "Timestamptz"
},
{
- "ordinal": 16,
+ "ordinal": 19,
"name": "name_follows_database",
"type_info": "Bool"
},
{
- "ordinal": 17,
+ "ordinal": 20,
"name": "is_hidden_in_drive",
"type_info": "Bool"
}
@@ -115,6 +130,9 @@
false,
true,
false,
+ true,
+ true,
+ true,
false,
false,
true,
@@ -122,5 +140,5 @@
false
]
},
- "hash": "0324782b3a73b0449ea096091d52edf33cf128bb77eee4bf09032e7b4785fe9b"
+ "hash": "ef9fd96657a6b0d5e101362ea2b6551efb6368d1add53d977df6f0b48f6ef178"
}
diff --git a/Cargo.lock b/Cargo.lock
index 7b665d3497..b5dd35fdcb 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -8369,6 +8369,7 @@ dependencies = [
"serde",
"serde_json",
"sqlx",
+ "static_file_service_client",
"strum 0.27.2",
"thiserror 2.0.18",
"tokio",
@@ -13301,6 +13302,7 @@ name = "models_forms"
version = "0.1.0"
dependencies = [
"chrono",
+ "lazy-regex",
"macro_uuid",
"models_databases",
"schemars 1.2.1",
diff --git a/apps/web/src/features/block-form/components/respond/branding.css b/apps/web/src/features/block-form/components/respond/branding.css
new file mode 100644
index 0000000000..3dd1400321
--- /dev/null
+++ b/apps/web/src/features/block-form/components/respond/branding.css
@@ -0,0 +1,20 @@
+/* A form's accent color on its respond page. `brandingStyle` sets the
+ inputs; every accent-derived fill is declared again here because a custom
+ property resolves its var() references where it is declared. Focus rings,
+ links and accent text keep the theme's colors: an owner's accent need not
+ contrast with the page, only with the ink chosen for it. */
+.form-branded {
+ --color-accent: var(--form-accent);
+ --color-accent-contrast: var(--form-accent-contrast);
+ --color-accent-bg: color-mix(in oklch, var(--form-accent) 8%, transparent);
+ --color-accent-hover: color-mix(in oklch, var(--form-accent) 20%, transparent);
+ --color-selected: color-mix(in oklch, var(--form-accent) 8%, transparent);
+ --button-primary-bg: var(--form-accent);
+ --button-primary-ink: var(--form-accent-contrast);
+ --button-primary-hover: color-mix(in srgb, var(--form-accent) 82%, var(--form-accent-shade));
+ --button-primary-pressed: color-mix(in srgb, var(--form-accent) 72%, var(--form-accent-shade));
+ --button-accent-bg: var(--form-accent);
+ --button-accent-ink: var(--form-accent-contrast);
+ --button-accent-hover: color-mix(in srgb, var(--form-accent) 82%, var(--form-accent-shade));
+ --button-accent-pressed: color-mix(in srgb, var(--form-accent) 72%, var(--form-accent-shade));
+}
diff --git a/apps/web/src/features/block-form/components/respond/respond-screens.tsx b/apps/web/src/features/block-form/components/respond/respond-screens.tsx
index e5e33f811e..3154da5123 100644
--- a/apps/web/src/features/block-form/components/respond/respond-screens.tsx
+++ b/apps/web/src/features/block-form/components/respond/respond-screens.tsx
@@ -46,6 +46,8 @@ export function ProgressStrip(props: { position: number; total: number }) {
export function RespondTitleCard(props: {
name: string;
description: string;
+ /** The form's logo, shown above its name. */
+ logoUrl?: string;
compact: boolean;
}) {
return (
@@ -57,6 +59,15 @@ export function RespondTitleCard(props: {
}
>
<div class={cn('flex flex-col', props.compact ? 'gap-1.5 p-3' : 'gap-6')}>
+ <Show when={props.logoUrl}>
+ {(logoUrl) => (
+ <img
+ src={logoUrl()}
+ alt=""
+ class="h-12 max-w-48 self-start object-contain"
+ />
+ )}
+ </Show>
<h1
class={cn(
'font-semibold text-ink wrap-anywhere',
diff --git a/apps/web/src/features/block-form/components/share/branding-panel.tsx b/apps/web/src/features/block-form/components/share/branding-panel.tsx
new file mode 100644
index 0000000000..a1e9a4bb28
--- /dev/null
+++ b/apps/web/src/features/block-form/components/share/branding-panel.tsx
@@ -0,0 +1,242 @@
+import { fireAndForget } from '@core/util/fireAndForget';
+import { openFilePicker } from '@core/util/upload';
+import { Button, Input } from '@ui';
+import { createSignal, type JSX, Show } from 'solid-js';
+import { useFormContext } from '../../context/form-context';
+import type { FormBranding } from '../../core/form-model';
+
+const IMAGE_TYPES = ['image/png', 'image/jpeg', 'image/webp', 'image/gif'];
+const HEX_COLOR = /^#[0-9a-f]{6}$/i;
+
+type BrandingPatch = Partial<FormBranding>;
+
+/**
+ * The logo, cover image and accent color the respond page shows, so a form
+ * looks like part of its owner's business. Unset parts keep Macro's look.
+ */
+export function BrandingPanel(props: {
+ branding: FormBranding;
+ canEdit: boolean;
+ pending: boolean;
+ onChange: (patch: BrandingPatch, what: string) => Promise<void>;
+}) {
+ const context = useFormContext();
+ const [uploading, setUploading] = createSignal<'logo' | 'cover'>();
+ const disabled = () => !props.canEdit || props.pending || !!uploading();
+
+ function upload(part: 'logo' | 'cover') {
+ openFilePicker(
+ { acceptedMimeTypes: IMAGE_TYPES, multiple: false },
+ async ([file]) => {
+ if (!file) return;
+ setUploading(part);
+ const uploaded = await context.branding.uploadImage(file);
+ if (uploaded.isErr()) {
+ setUploading(undefined);
+ context.notify.failure(
+ `The image couldn’t be uploaded: ${uploaded.error.message}`
+ );
+ return;
+ }
+ await props.onChange(
+ part === 'logo'
+ ? { logoFileId: uploaded.value }
+ : { coverFileId: uploaded.value },
+ part === 'logo' ? 'The logo' : 'The cover image'
+ );
+ setUploading(undefined);
+ }
+ );
+ }
+
+ function changeAccent(value: string) {
+ const accentColor = value.trim().toLowerCase();
+ if (!accentColor) {
+ if (props.branding.accentColor)
+ fireAndForget(
+ props.onChange({ accentColor: null }, 'The accent color'),
+ 'form-branding'
+ );
+ return;
+ }
+ if (!HEX_COLOR.test(accentColor)) {
+ context.notify.failure('Enter a color like #1f6feb.');
+ return;
+ }
+ if (accentColor !== props.branding.accentColor)
+ fireAndForget(
+ props.onChange({ accentColor }, 'The accent color'),
+ 'form-branding'
+ );
+ }
+
+ return (
+ <div class="flex flex-col gap-4 rounded-xl border border-edge bg-surface p-4">
+ <div class="flex flex-col gap-0.5">
+ <h3 class="text-sm font-semibold text-ink">Branding</h3>
+ <p class="text-xs text-ink-muted">
+ Shown to everyone who opens the form.
+ </p>
+ </div>
+ <BrandingRow
+ label="Logo"
+ hint="Above the form’s title."
+ preview={
+ <Show when={props.branding.logoFileId}>
+ {(logo) => (
+ <img
+ src={context.branding.imageUrl(logo(), 'small')}
+ alt="Logo"
+ class="size-full object-contain"
+ />
+ )}
+ </Show>
+ }
+ >
+ <ImageActions
+ name="logo"
+ set={!!props.branding.logoFileId}
+ uploading={uploading() === 'logo'}
+ disabled={disabled()}
+ onUpload={() => upload('logo')}
+ onRemove={() =>
+ fireAndForget(
+ props.onChange({ logoFileId: null }, 'The logo'),
+ 'form-branding'
+ )
+ }
+ />
+ </BrandingRow>
+ <BrandingRow
+ label="Cover image"
+ hint="A banner across the top of the page."
+ preview={
+ <Show when={props.branding.coverFileId}>
+ {(cover) => (
+ <img
+ src={context.branding.imageUrl(cover(), 'small')}
+ alt="Cover"
+ class="size-full object-cover"
+ />
+ )}
+ </Show>
+ }
+ >
+ <ImageActions
+ name="cover image"
+ set={!!props.branding.coverFileId}
+ uploading={uploading() === 'cover'}
+ disabled={disabled()}
+ onUpload={() => upload('cover')}
+ onRemove={() =>
+ fireAndForget(
+ props.onChange({ coverFileId: null }, 'The cover image'),
+ 'form-branding'
+ )
+ }
+ />
+ </BrandingRow>
+ <BrandingRow
+ label="Accent color"
+ hint="Buttons and selected answers."
+ preview={
+ <input
+ type="color"
+ aria-label="Pick an accent color"
+ value={props.branding.accentColor ?? '#000000'}
+ disabled={disabled()}
+ class="size-full border-0 bg-transparent p-0"
+ onChange={(event) => changeAccent(event.currentTarget.value)}
+ />
+ }
+ >
+ <Input
+ aria-label="Accent color"
+ class="w-28"
+ value={props.branding.accentColor ?? ''}
+ placeholder="Default"
+ maxlength={7}
+ disabled={disabled()}
+ onChange={(event) => changeAccent(event.currentTarget.value)}
+ />
+ <Show when={props.branding.accentColor}>
+ <Button
+ variant="ghost"
+ size="sm"
+ disabled={disabled()}
+ onClick={() =>
+ fireAndForget(
+ props.onChange({ accentColor: null }, 'The accent color'),
+ 'form-branding'
+ )
+ }
+ >
+ Reset
+ </Button>
+ </Show>
+ </BrandingRow>
+ <Show when={!props.canEdit}>
+ <p class="text-xs text-ink-muted">Only editors can change branding.</p>
+ </Show>
+ </div>
+ );
+}
+
+function BrandingRow(props: {
+ label: string;
+ hint: string;
+ preview: JSX.Element;
+ children: JSX.Element;
+}) {
+ return (
+ <div class="flex flex-wrap items-center gap-3">
+ <div class="flex size-10 shrink-0 items-center justify-center overflow-hidden rounded-md border border-edge-muted bg-input">
+ {props.preview}
+ </div>
+ <div class="flex min-w-0 flex-1 flex-col">
+ <span class="text-sm font-medium text-ink">{props.label}</span>
+ <span class="text-xs text-ink-muted">{props.hint}</span>
+ </div>
+ <div class="flex items-center gap-2">{props.children}</div>
+ </div>
+ );
+}
+
+function ImageActions(props: {
+ /** What the image is, for the actions' accessible names. */
+ name: string;
+ set: boolean;
+ uploading: boolean;
+ disabled: boolean;
+ onUpload: () => void;
+ onRemove: () => void;
+}) {
+ const action = () => (props.set ? 'Replace' : 'Upload');
+ return (
+ <>
+ <Button
+ variant="secondary"
+ size="sm"
+ disabled={props.disabled}
+ aria-busy={props.uploading}
+ aria-label={`${action()} ${props.name}`}
+ onClick={props.onUpload}
+ >
+ <Show when={props.uploading} fallback={action()}>
+ Uploading…
+ </Show>
+ </Button>
+ <Show when={props.set}>
+ <Button
+ variant="ghost"
+ size="sm"
+ disabled={props.disabled}
+ aria-label={`Remove ${props.name}`}
+ onClick={props.onRemove}
+ >
+ Remove
+ </Button>
+ </Show>
+ </>
+ );
+}
diff --git a/apps/web/src/features/block-form/context/form-context.tsx b/apps/web/src/features/block-form/context/form-context.tsx
index 4016c1a44e..9a9148acf6 100644
--- a/apps/web/src/features/block-form/context/form-context.tsx
+++ b/apps/web/src/features/block-form/context/form-context.tsx
@@ -52,6 +52,7 @@ export type FormRefusal =
| 'invalid-name'
| 'invalid-sharing'
| 'tally-hidden'
+ | 'invalid-branding'
| 'conflict'
| 'internal';
@@ -180,6 +181,12 @@ export type FormMetadataPatch = {
status?: FormStatus;
closesAt?: string | null;
tallyVisible?: boolean;
+ /** A static file id, or `null` to remove it. */
+ logoFileId?: string | null;
+ /** A static file id, or `null` to remove it. */
+ coverFileId?: string | null;
+ /** `#rrggbb`, or `null` for Macro's accent. */
+ accentColor?: string | null;
};
export type SubmitOutcome =
@@ -359,6 +366,13 @@ export type FormContext = {
};
/** Upload a file for a file question; answers the link the cell stores. */
uploadFile: (file: File) => ResultAsync<string, FormWriteFailure>;
+ /** The logo and cover image a form's branding shows. */
+ branding: {
+ /** Upload an image; answers its static file id. */
+ uploadImage: (file: File) => ResultAsync<string, FormWriteFailure>;
+ /** Where a branding image is read, sized for where it shows. */
+ imageUrl: (fileId: string, size: 'small' | 'medium') => string;
+ };
booking: FormBooking;
/** Open a direct conversation with the form's owner (stop screen, RFC 02 §4). */
messageOwner: (ownerId: string) => ResultAsync<void, FormWriteFailure>;
diff --git a/apps/web/src/features/block-form/core/branding.test.ts b/apps/web/src/features/block-form/core/branding.test.ts
new file mode 100644
index 0000000000..14b6e4a213
--- /dev/null
+++ b/apps/web/src/features/block-form/core/branding.test.ts
@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'vitest';
+import { accentContrast, brandingStyle } from './branding';
+
+describe('accentContrast', () => {
+ it('writes white on dark accents and black on light ones', () => {
+ expect(accentContrast('#1f6feb')).toBe('#ffffff');
+ expect(accentContrast('#000000')).toBe('#ffffff');
+ expect(accentContrast('#7a1fa2')).toBe('#ffffff');
+ expect(accentContrast('#ffd400')).toBe('#000000');
+ expect(accentContrast('#ffffff')).toBe('#000000');
+ expect(accentContrast('#7fdbca')).toBe('#000000');
+ });
+});
+
+describe('brandingStyle', () => {
+ it('sets nothing without an accent, so the page keeps Macro’s colors', () => {
+ expect(brandingStyle(null)).toBeUndefined();
+ });
+
+ it('hands the page its accent, the ink that reads on it, and a shade away from that ink', () => {
+ expect(brandingStyle('#ffd400')).toEqual({
+ '--form-accent': '#ffd400',
+ '--form-accent-contrast': '#000000',
+ '--form-accent-shade': '#ffffff',
+ });
+ expect(brandingStyle('#1f6feb')).toEqual({
+ '--form-accent': '#1f6feb',
+ '--form-accent-contrast': '#ffffff',
+ '--form-accent-shade': '#000000',
+ });
+ });
+});
diff --git a/apps/web/src/features/block-form/core/branding.ts b/apps/web/src/features/block-form/core/branding.ts
new file mode 100644
index 0000000000..74cc1f0ca7
--- /dev/null
+++ b/apps/web/src/features/block-form/core/branding.ts
@@ -0,0 +1,42 @@
+/** A form's accent color, applied to the respond page it brands. */
+
+/** WCAG relative luminance of one sRGB channel, 0–255. */
+function linear(channel: number): number {
+ const value = channel / 255;
+ return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+}
+
+/** Black or white, whichever contrasts more with the `#rrggbb` accent. */
+export function accentContrast(accent: string): '#000000' | '#ffffff' {
+ const [red, green, blue] = [1, 3, 5].map((start) =>
+ Number.parseInt(accent.slice(start, start + 2), 16)
+ );
+ const luminance =
+ 0.2126 * linear(red) + 0.7152 * linear(green) + 0.0722 * linear(blue);
+ // Contrast with white is 1.05 / (L + 0.05); with black, (L + 0.05) / 0.05.
+ return 1.05 / (luminance + 0.05) >= (luminance + 0.05) / 0.05
+ ? '#ffffff'
+ : '#000000';
+}
+
+/**
+ * The variables `.form-branded` derives the page's accent tokens from, or
+ * nothing for Macro's own accent. Hover and press shade the accent away from
+ * its ink, so they never lose contrast with it.
+ */
+export function brandingStyle(
+ accent: string | null
+):
+ | Record<
+ '--form-accent' | '--form-accent-contrast' | '--form-accent-shade',
+ string
+ >
+ | undefined {
+ if (!accent) return undefined;
+ const contrast = accentContrast(accent);
+ return {
+ '--form-accent': accent,
+ '--form-accent-contrast': contrast,
+ '--form-accent-shade': contrast === '#ffffff' ? '#000000' : '#ffffff',
+ };
+}
diff --git a/apps/web/src/features/block-form/core/form-model.ts b/apps/web/src/features/block-form/core/form-model.ts
index cde7cfb997..156dad0e2a 100644
--- a/apps/web/src/features/block-form/core/form-model.ts
+++ b/apps/web/src/features/block-form/core/form-model.ts
@@ -194,6 +194,14 @@ export type FormSection = {
/** Everything the form owns about presentation, in order. */
export type FormLayout = { sections: FormSection[] };
+/** A form's logo, cover image and accent color; `null` where unset. */
+export type FormBranding = {
+ logoFileId: string | null;
+ coverFileId: string | null;
+ /** `#rrggbb`. */
+ accentColor: string | null;
+};
+
export type FormMetadata = {
id: string;
name: string;
@@ -206,6 +214,7 @@ export type FormMetadata = {
closesAt: string | null;
tallyVisible: boolean;
confirmationMessage: string;
+ branding: FormBranding;
submittedColumnId: string | null;
respondentColumnId: string | null;
};
diff --git a/apps/web/src/features/block-form/core/sentences.test.ts b/apps/web/src/features/block-form/core/sentences.test.ts
index 79ce4ca3c6..ec61ccfd93 100644
--- a/apps/web/src/features/block-form/core/sentences.test.ts
+++ b/apps/web/src/features/block-form/core/sentences.test.ts
@@ -78,6 +78,7 @@ describe('availability', () => {
closesAt: '2026-10-03T17:00:00Z',
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
};
diff --git a/apps/web/src/features/block-form/core/tally.test.ts b/apps/web/src/features/block-form/core/tally.test.ts
index f54234bd54..3b820d1dc5 100644
--- a/apps/web/src/features/block-form/core/tally.test.ts
+++ b/apps/web/src/features/block-form/core/tally.test.ts
@@ -15,6 +15,7 @@ const lunch: FormDetail = {
closesAt: null,
tallyVisible: true,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/form-block.test.tsx b/apps/web/src/features/block-form/form-block.test.tsx
index 990562aafd..736a17597d 100644
--- a/apps/web/src/features/block-form/form-block.test.tsx
+++ b/apps/web/src/features/block-form/form-block.test.tsx
@@ -102,6 +102,7 @@ beforeEach(() => {
closesAt: null,
tallyVisible: false,
confirmationMessage: 'Thank you',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/form-context-production.tsx b/apps/web/src/features/block-form/form-context-production.tsx
index 06a0758049..733de79802 100644
--- a/apps/web/src/features/block-form/form-context-production.tsx
+++ b/apps/web/src/features/block-form/form-context-production.tsx
@@ -10,7 +10,10 @@ import { DatabaseMentionValue } from '@block-database/database-mentions';
import { exportDatabaseTableCsv } from '@block-database/queries/transfer';
import { toast } from '@core/component/Toast/Toast';
import { enableCalendarScheduling } from '@core/constant/featureFlags';
-import { staticFileIdEndpoint } from '@core/constant/servers';
+import {
+ staticFileIdEndpoint,
+ staticFileSizedEndpoint,
+} from '@core/constant/servers';
import { useUserId } from '@core/context/user';
import { uploadFile } from '@core/util/upload';
import { downloadFile } from '@filesystem/download';
@@ -81,10 +84,14 @@ function exportTableCsv(
}
function uploadStaticFile(file: File): ResultAsync<string, FormWriteFailure> {
+ return uploadStaticFileId(file).map(staticFileIdEndpoint);
+}
+
+function uploadStaticFileId(file: File): ResultAsync<string, FormWriteFailure> {
const uploaded = async () => {
const result = await uploadFile(file, 'static');
if (result.failed) throw result.error;
- return staticFileIdEndpoint(result.id);
+ return result.id;
};
return ResultAsync.fromPromise(uploaded(), (error) => ({
message: error instanceof Error ? error.message : 'The upload failed.',
@@ -136,6 +143,10 @@ export function createAppFormContext(host: FormHostActions): FormContext {
exportCsv: exportTableCsv,
},
uploadFile: uploadStaticFile,
+ branding: {
+ uploadImage: uploadStaticFileId,
+ imageUrl: staticFileSizedEndpoint,
+ },
booking: {
available: () => scheduling().enabled,
createLinks: (enabled) =>
diff --git a/apps/web/src/features/block-form/form-global-sharing.test.tsx b/apps/web/src/features/block-form/form-global-sharing.test.tsx
index 2b42fd4ec1..d8e9dc20fc 100644
--- a/apps/web/src/features/block-form/form-global-sharing.test.tsx
+++ b/apps/web/src/features/block-form/form-global-sharing.test.tsx
@@ -74,6 +74,7 @@ function rsvp(access: FormDetail['access']): FormDetail {
closesAt: null,
tallyVisible: true,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
@@ -201,6 +202,7 @@ describe('openFormShareModal', () => {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
createdAt: '2026-10-05T12:00:00Z',
diff --git a/apps/web/src/features/block-form/primitives/create-builder-concurrency.test.ts b/apps/web/src/features/block-form/primitives/create-builder-concurrency.test.ts
index 57c6e905c4..8a1ab2ba3e 100644
--- a/apps/web/src/features/block-form/primitives/create-builder-concurrency.test.ts
+++ b/apps/web/src/features/block-form/primitives/create-builder-concurrency.test.ts
@@ -49,6 +49,7 @@ function detail(layout: FormLayout): FormDetail {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/primitives/create-builder.test.ts b/apps/web/src/features/block-form/primitives/create-builder.test.ts
index ad4dd23a14..1bd5c37b61 100644
--- a/apps/web/src/features/block-form/primitives/create-builder.test.ts
+++ b/apps/web/src/features/block-form/primitives/create-builder.test.ts
@@ -39,6 +39,7 @@ function detail(layout: FormLayout): FormDetail {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: 'column-submitted',
respondentColumnId: 'column-respondent',
},
diff --git a/apps/web/src/features/block-form/primitives/create-respond.test.ts b/apps/web/src/features/block-form/primitives/create-respond.test.ts
index 85cb6071f6..ebb98603d7 100644
--- a/apps/web/src/features/block-form/primitives/create-respond.test.ts
+++ b/apps/web/src/features/block-form/primitives/create-respond.test.ts
@@ -24,6 +24,7 @@ function offsite(): FormDetail {
closesAt: '2026-10-03T17:00:00Z',
tallyVisible: false,
confirmationMessage: 'See you there.',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
@@ -132,6 +133,7 @@ describe('createRespond', () => {
closesAt: null,
tallyVisible: false,
confirmationMessage: 'See you there.',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/queries/form-detail.test.ts b/apps/web/src/features/block-form/queries/form-detail.test.ts
index 1c8cfd0f50..6c8b655bb1 100644
--- a/apps/web/src/features/block-form/queries/form-detail.test.ts
+++ b/apps/web/src/features/block-form/queries/form-detail.test.ts
@@ -114,6 +114,7 @@ describe('the booking step', () => {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
createdAt: '2026-10-01T12:00:00Z',
diff --git a/apps/web/src/features/block-form/queries/form-detail.ts b/apps/web/src/features/block-form/queries/form-detail.ts
index f476ba22d8..61fd2ed524 100644
--- a/apps/web/src/features/block-form/queries/form-detail.ts
+++ b/apps/web/src/features/block-form/queries/form-detail.ts
@@ -33,6 +33,11 @@ export function toFormMetadata(form: Form): FormMetadata {
closesAt: form.closesAt ?? null,
tallyVisible: form.tallyVisible,
confirmationMessage: form.confirmationMessage,
+ branding: {
+ logoFileId: form.branding.logoFileId ?? null,
+ coverFileId: form.branding.coverFileId ?? null,
+ accentColor: form.branding.accentColor ?? null,
+ },
submittedColumnId: form.submittedColumnId ?? null,
respondentColumnId: form.respondentColumnId ?? null,
};
diff --git a/apps/web/src/features/block-form/queries/form-publication.test.ts b/apps/web/src/features/block-form/queries/form-publication.test.ts
index 86f8c87f40..3bc4ba289e 100644
--- a/apps/web/src/features/block-form/queries/form-publication.test.ts
+++ b/apps/web/src/features/block-form/queries/form-publication.test.ts
@@ -17,6 +17,7 @@ const detail: FormCollaboration['detail'] = {
status: 'open',
closesAt: null,
confirmationMessage: 'Thank you',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T09:00:00Z',
updatedAt: '2026-10-05T09:00:00Z',
isHiddenInDrive: false,
diff --git a/apps/web/src/features/block-form/queries/form-sources.test.ts b/apps/web/src/features/block-form/queries/form-sources.test.ts
index d7cdb21329..e233818b87 100644
--- a/apps/web/src/features/block-form/queries/form-sources.test.ts
+++ b/apps/web/src/features/block-form/queries/form-sources.test.ts
@@ -40,6 +40,7 @@ vi.mock('@queries/storage/forms', () => ({
closesAt: null,
tallyVisible: true,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/queries/form-sources.ts b/apps/web/src/features/block-form/queries/form-sources.ts
index 3f363aa8a1..590ead78bc 100644
--- a/apps/web/src/features/block-form/queries/form-sources.ts
+++ b/apps/web/src/features/block-form/queries/form-sources.ts
@@ -99,6 +99,7 @@ function refusalOf(code: FormErrorCode): FormRefusal {
.with('invalidName', () => 'invalid-name')
.with('invalidSharing', () => 'invalid-sharing')
.with('tallyHidden', () => 'tally-hidden')
+ .with('invalidBranding', () => 'invalid-branding')
.with('conflict', () => 'conflict')
.with('internal', () => 'internal')
.exhaustive(() => 'internal');
diff --git a/apps/web/src/features/block-form/tests/mock-context.ts b/apps/web/src/features/block-form/tests/mock-context.ts
index d1abc28c53..08caa14bc1 100644
--- a/apps/web/src/features/block-form/tests/mock-context.ts
+++ b/apps/web/src/features/block-form/tests/mock-context.ts
@@ -160,6 +160,11 @@ export function createMockFormContext(options: {
exportCsv: () => okAsync(undefined),
},
uploadFile: () => okAsync('https://static.example.com/file/1'),
+ branding: {
+ uploadImage: () => okAsync('00000000-0000-0000-0000-00000000f11e'),
+ imageUrl: (fileId, size) =>
+ `https://static.example.com/file/${fileId}?size=${size}`,
+ },
booking: {
available: () => booking.available ?? true,
createLinks: () => ({
diff --git a/apps/web/src/features/block-form/views/builder-view.test.tsx b/apps/web/src/features/block-form/views/builder-view.test.tsx
index f7583a45e0..9982091535 100644
--- a/apps/web/src/features/block-form/views/builder-view.test.tsx
+++ b/apps/web/src/features/block-form/views/builder-view.test.tsx
@@ -101,6 +101,7 @@ function rsvp(): FormDetail {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/views/form-card-view.test.tsx b/apps/web/src/features/block-form/views/form-card-view.test.tsx
index abe30da730..34ca7de90a 100644
--- a/apps/web/src/features/block-form/views/form-card-view.test.tsx
+++ b/apps/web/src/features/block-form/views/form-card-view.test.tsx
@@ -22,6 +22,7 @@ function lunchPoll(access: FormDetail['access']): FormDetail {
closesAt: null,
tallyVisible: true,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/views/form-page-view.test.tsx b/apps/web/src/features/block-form/views/form-page-view.test.tsx
index e83ec4d9bc..112d665c96 100644
--- a/apps/web/src/features/block-form/views/form-page-view.test.tsx
+++ b/apps/web/src/features/block-form/views/form-page-view.test.tsx
@@ -54,6 +54,7 @@ const detail: FormDetail = {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
diff --git a/apps/web/src/features/block-form/views/respond-view.test.tsx b/apps/web/src/features/block-form/views/respond-view.test.tsx
index 3fbc786655..f1b22c22aa 100644
--- a/apps/web/src/features/block-form/views/respond-view.test.tsx
+++ b/apps/web/src/features/block-form/views/respond-view.test.tsx
@@ -34,6 +34,7 @@ function offsite(): FormDetail {
closesAt: null,
tallyVisible: false,
confirmationMessage: 'See you there!',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
},
@@ -131,6 +132,51 @@ function offsite(): FormDetail {
}
describe('RespondView', () => {
+ it('shows the owner’s logo, cover and accent, and Macro’s look when none is set', () => {
+ const plain = offsite();
+ const branded = offsite();
+ branded.form.branding = {
+ logoFileId: 'logo-1',
+ coverFileId: 'cover-1',
+ accentColor: '#ffd400',
+ };
+ const { context } = createMockFormContext({ detail: branded });
+ render(() => (
+ <FormProvider value={context}>
+ <RespondView
+ detail={plain}
+ compact={false}
+ refetch={async () => true}
+ />
+ <RespondView
+ detail={branded}
+ compact={false}
+ refetch={async () => true}
+ />
+ </FormProvider>
+ ));
+ const [plainPage, brandedPage] = screen
+ .getAllByRole('heading', { name: 'Q4 offsite RSVP' })
+ .map((heading) => heading.closest<HTMLElement>('[data-form-respond]'));
+ expect(plainPage!.querySelectorAll('img')).toHaveLength(0);
+ expect(plainPage!.classList.contains('form-branded')).toBe(false);
+ expect(
+ [...brandedPage!.querySelectorAll('img')].map((image) =>
+ image.getAttribute('src')
+ )
+ ).toEqual([
+ 'https://static.example.com/file/cover-1?size=medium',
+ 'https://static.example.com/file/logo-1?size=small',
+ ]);
+ expect(brandedPage!.classList.contains('form-branded')).toBe(true);
+ expect(brandedPage!.style.getPropertyValue('--form-accent')).toBe(
+ '#ffd400'
+ );
+ expect(brandedPage!.style.getPropertyValue('--form-accent-contrast')).toBe(
+ '#000000'
+ );
+ });
+
it('answers section by section, submits once, and shows the confirmation with the receipt', async () => {
const { context, calls } = createMockFormContext({ detail: offsite() });
render(() => (
diff --git a/apps/web/src/features/block-form/views/respond-view.tsx b/apps/web/src/features/block-form/views/respond-view.tsx
index 14ef073b66..0fa29e0975 100644
--- a/apps/web/src/features/block-form/views/respond-view.tsx
+++ b/apps/web/src/features/block-form/views/respond-view.tsx
@@ -26,12 +26,14 @@ import {
StopScreen,
} from '../components/respond/respond-screens';
import { useFormContext } from '../context/form-context';
+import { brandingStyle } from '../core/branding';
import { questionNumbers } from '../core/form-layout';
import type { FormCellValue, FormDetail } from '../core/form-model';
import { formAvailability, shortDate } from '../core/form-status';
import { resolvedWidget } from '../core/question-types';
import { createRespond } from '../primitives/create-respond';
import { BookingStepView } from './booking-step-view';
+import '../components/respond/branding.css';
/**
* The respond page (RFC 02 §4), shared by the app split, the public route
@@ -76,6 +78,12 @@ export function RespondView(props: {
let root: HTMLDivElement | undefined;
const form = () => props.detail.form;
+ // An inline card stays in Macro's look; the page wears the owner's.
+ const branding = () => (props.compact ? undefined : form().branding);
+ const brandingImage = (
+ fileId: string | null | undefined,
+ size: 'small' | 'medium'
+ ) => (fileId ? context.branding.imageUrl(fileId, size) : undefined);
const isPublic = () => form().audience === 'public';
const numbers = createMemo(() => questionNumbers(props.detail.layout));
@@ -175,15 +183,27 @@ export function RespondView(props: {
ref={root}
class={cn(
'mx-auto flex w-full flex-col',
- props.compact ? 'gap-3' : 'max-w-3xl gap-6 pt-12 pb-24'
+ props.compact ? 'gap-3' : 'max-w-3xl gap-6 pt-12 pb-24',
+ branding()?.accentColor && 'form-branded'
)}
+ style={brandingStyle(branding()?.accentColor ?? null)}
data-form-respond={form().id}
>
<Show when={props.header}>{props.header}</Show>
+ <Show when={brandingImage(branding()?.coverFileId, 'medium')}>
+ {(cover) => (
+ <img
+ src={cover()}
+ alt=""
+ class="aspect-[4/1] w-full rounded-xl object-cover"
+ />
+ )}
+ </Show>
<Show when={!props.compact}>
<RespondTitleCard
name={form().name}
description={form().description}
+ logoUrl={brandingImage(branding()?.logoFileId, 'small')}
compact={false}
/>
</Show>
diff --git a/apps/web/src/features/block-form/views/share-tab-view.tsx b/apps/web/src/features/block-form/views/share-tab-view.tsx
index 4e2132ead2..cad95c5013 100644
--- a/apps/web/src/features/block-form/views/share-tab-view.tsx
+++ b/apps/web/src/features/block-form/views/share-tab-view.tsx
@@ -4,6 +4,7 @@ import { Button, Input, ToggleSwitch } from '@ui';
import { ResultAsync } from 'neverthrow';
import { createSignal, Show } from 'solid-js';
import { AudiencePanel } from '../components/share/audience-panel';
+import { BrandingPanel } from '../components/share/branding-panel';
import {
type FormMetadataPatch,
type FormWriteFailure,
@@ -19,8 +20,8 @@ import type { Preview } from '../primitives/create-preview';
/**
* The Share tab (RFC 02 §2, §6): who can respond, the respond link, whether
- * the form takes responses and until when, and the people it is shared with
- * through the share dialog.
+ * the form takes responses and until when, how the respond page is branded,
+ * and the people it is shared with through the share dialog.
*/
export function ShareTabView(props: {
detail: FormDetail;
@@ -198,6 +199,12 @@ export function ShareTabView(props: {
</p>
</Show>
</div>
+ <BrandingPanel
+ branding={form().branding}
+ canEdit={canEdit()}
+ pending={pending()}
+ onChange={update}
+ />
<div class="flex items-center gap-3 rounded-xl border border-edge bg-surface p-4">
<UsersThree
class="size-5 shrink-0 text-ink-muted"
diff --git a/apps/web/src/features/drive-view/queries/drive-forms.test.ts b/apps/web/src/features/drive-view/queries/drive-forms.test.ts
index 48e3ead386..fbd2017a07 100644
--- a/apps/web/src/features/drive-view/queries/drive-forms.test.ts
+++ b/apps/web/src/features/drive-view/queries/drive-forms.test.ts
@@ -26,6 +26,7 @@ const listed: ListedForm[] = [
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-01T00:00:00Z',
updatedAt: '2026-10-01T00:00:00Z',
isHiddenInDrive: false,
@@ -47,6 +48,7 @@ const listed: ListedForm[] = [
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-02T00:00:00Z',
updatedAt: '2026-10-02T00:00:00Z',
isHiddenInDrive: true,
diff --git a/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.test.tsx b/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.test.tsx
index e56509901f..88e6adad9c 100644
--- a/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.test.tsx
+++ b/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.test.tsx
@@ -32,6 +32,7 @@ const result: FormMutation = {
closesAt: null,
tallyVisible: false,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
submittedColumnId: null,
respondentColumnId: null,
createdAt: '2026-10-06T12:00:00Z',
diff --git a/apps/web/src/lib/queries/storage/forms-preview.test.ts b/apps/web/src/lib/queries/storage/forms-preview.test.ts
index ebd557b7a4..0eed292f21 100644
--- a/apps/web/src/lib/queries/storage/forms-preview.test.ts
+++ b/apps/web/src/lib/queries/storage/forms-preview.test.ts
@@ -67,6 +67,7 @@ it('updates an already cached card title after renaming a form', async () => {
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T00:00:00Z',
updatedAt: '2026-10-05T00:00:00Z',
isHiddenInDrive: false,
@@ -158,6 +159,7 @@ it('refreshes the linked database’s card after renaming a form, without guessi
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T00:00:00Z',
updatedAt: '2026-10-05T00:00:00Z',
isHiddenInDrive: false,
@@ -227,6 +229,7 @@ it('refreshes the cards of the forms over a renamed database, and only theirs',
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T00:00:00Z',
updatedAt: '2026-10-05T00:00:00Z',
isHiddenInDrive: false,
@@ -250,6 +253,7 @@ it('refreshes the cards of the forms over a renamed database, and only theirs',
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T00:00:00Z',
updatedAt: '2026-10-05T00:00:00Z',
isHiddenInDrive: false,
@@ -271,6 +275,7 @@ it('refreshes the cards of the forms over a renamed database, and only theirs',
status: 'open',
closesAt: null,
confirmationMessage: '',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T00:00:00Z',
updatedAt: '2026-10-05T00:00:00Z',
isHiddenInDrive: false,
diff --git a/apps/web/src/lib/service-clients/service-cognition/generated/tools/schemas.ts b/apps/web/src/lib/service-clients/service-cognition/generated/tools/schemas.ts
index 6152fd7d0c..7b0b2cf204 100644
--- a/apps/web/src/lib/service-clients/service-cognition/generated/tools/schemas.ts
+++ b/apps/web/src/lib/service-clients/service-cognition/generated/tools/schemas.ts
@@ -3551,6 +3551,11 @@ export const MutationResult = z.object({
.union([z.string().datetime({ offset: true }), z.null()])
.optional(),
confirmationMessage: z.string(),
+ branding: z.object({
+ logoFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ coverFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ accentColor: z.union([z.string(), z.null()]).optional(),
+ }),
createdAt: z.string().datetime({ offset: true }),
updatedAt: z.string().datetime({ offset: true }),
isHiddenInDrive: z.boolean(),
@@ -11032,6 +11037,11 @@ export const ListResult = z.object({
.union([z.string().datetime({ offset: true }), z.null()])
.optional(),
confirmationMessage: z.string(),
+ branding: z.object({
+ logoFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ coverFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ accentColor: z.union([z.string(), z.null()]).optional(),
+ }),
createdAt: z.string().datetime({ offset: true }),
updatedAt: z.string().datetime({ offset: true }),
isHiddenInDrive: z.boolean(),
@@ -13777,6 +13787,11 @@ export const ReadResult = z.any().superRefine((x, ctx) => {
.union([z.string().datetime({ offset: true }), z.null()])
.optional(),
confirmationMessage: z.string(),
+ branding: z.object({
+ logoFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ coverFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ accentColor: z.union([z.string(), z.null()]).optional(),
+ }),
createdAt: z.string().datetime({ offset: true }),
updatedAt: z.string().datetime({ offset: true }),
isHiddenInDrive: z.boolean(),
@@ -14390,6 +14405,11 @@ export const ReadResult = z.any().superRefine((x, ctx) => {
.union([z.string().datetime({ offset: true }), z.null()])
.optional(),
confirmationMessage: z.string(),
+ branding: z.object({
+ logoFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ coverFileId: z.union([z.string().uuid(), z.null()]).optional(),
+ accentColor: z.union([z.string(), z.null()]).optional(),
+ }),
createdAt: z.string().datetime({ offset: true }),
updatedAt: z.string().datetime({ offset: true }),
isHiddenInDrive: z.boolean(),
diff --git a/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts b/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts
index 2b49b49616..21b9f2fa04 100644
--- a/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts
+++ b/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts
@@ -7864,6 +7864,7 @@ export interface Form {
* default.
*/
confirmationMessage: string;
+ branding: FormBranding;
/**
* When it was created.
*/
@@ -7878,6 +7879,23 @@ export interface Form {
*/
isHiddenInDrive: boolean;
}
+/**
+ * A form's logo, cover image and accent color, each unset by default.
+ */
+export interface FormBranding {
+ /**
+ * The static file shown as the logo above the title.
+ */
+ logoFileId?: string | null;
+ /**
+ * The static file shown as a banner across the top of the page.
+ */
+ coverFileId?: string | null;
+ /**
+ * The color of the page's buttons and selected answers.
+ */
+ accentColor?: string | null;
+}
/**
* Every section of a form, in order.
*/
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accentColor.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accentColor.ts
new file mode 100644
index 0000000000..4a60839a76
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accentColor.ts
@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * A color as `#rrggbb`, kept in lowercase.
+ * @pattern ^#[0-9a-fA-F]{6}$
+ */
+export type AccentColor = string;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/form.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/form.ts
index eeed0af07f..a2dc25042b 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/form.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/form.ts
@@ -5,6 +5,7 @@
* OpenAPI spec version: 0.1.0
*/
import type { Audience } from './audience';
+import type { FormBranding } from './formBranding';
import type { FormClosesAt } from './formClosesAt';
import type { FormRespondentColumnId } from './formRespondentColumnId';
import type { FormStatus } from './formStatus';
@@ -16,6 +17,8 @@ import type { FormSubmittedColumnId } from './formSubmittedColumnId';
export interface Form {
/** Who may respond. */
audience: Audience;
+ /** Its logo, cover image and accent color. */
+ branding: FormBranding;
/** When it stops taking responses, if it does. */
closesAt: FormClosesAt;
/** What a respondent reads once their response is saved; empty for the
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBranding.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBranding.ts
new file mode 100644
index 0000000000..e116df57eb
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBranding.ts
@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { FormBrandingAccentColor } from './formBrandingAccentColor';
+import type { FormBrandingCoverFileId } from './formBrandingCoverFileId';
+import type { FormBrandingLogoFileId } from './formBrandingLogoFileId';
+
+/**
+ * A form's logo, cover image and accent color, each unset by default.
+ */
+export interface FormBranding {
+ accentColor: FormBrandingAccentColor;
+ /** The static file shown as a banner across the top of the page. */
+ coverFileId: FormBrandingCoverFileId;
+ /** The static file shown as the logo above the title. */
+ logoFileId: FormBrandingLogoFileId;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingAccentColor.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingAccentColor.ts
new file mode 100644
index 0000000000..3bc8f4506e
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingAccentColor.ts
@@ -0,0 +1,9 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { AccentColor } from './accentColor';
+
+export type FormBrandingAccentColor = null | AccentColor;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingCoverFileId.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingCoverFileId.ts
new file mode 100644
index 0000000000..5e6dbccf5f
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingCoverFileId.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * The static file shown as a banner across the top of the page.
+ */
+export type FormBrandingCoverFileId = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingLogoFileId.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingLogoFileId.ts
new file mode 100644
index 0000000000..c935e34140
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formBrandingLogoFileId.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * The static file shown as the logo above the title.
+ */
+export type FormBrandingLogoFileId = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formErrorCode.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formErrorCode.ts
index 9cbc31cd6c..168642254a 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formErrorCode.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formErrorCode.ts
@@ -31,6 +31,7 @@ export const FormErrorCode = {
invalidName: 'invalidName',
invalidSharing: 'invalidSharing',
tallyHidden: 'tallyHidden',
+ invalidBranding: 'invalidBranding',
conflict: 'conflict',
internal: 'internal',
} as const;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
index 0cca90a54a..6121648fc9 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
@@ -5,6 +5,7 @@
* OpenAPI spec version: 0.1.0
*/
+export * from './accentColor';
export * from './accessiblePipeline';
export * from './accessiblePipelineAllOf';
export * from './accessLevel';
@@ -1043,6 +1044,10 @@ export * from './foreignEntity';
export * from './foreignEntityFilters';
export * from './form';
export * from './formAccess';
+export * from './formBranding';
+export * from './formBrandingAccentColor';
+export * from './formBrandingCoverFileId';
+export * from './formBrandingLogoFileId';
export * from './formClosesAt';
export * from './formCollaboration';
export * from './formDetail';
@@ -2245,7 +2250,10 @@ export * from './updateCrmTeamSettingsRequestDeleteRecordsRole';
export * from './updateCrmTeamSettingsRequestEditStagesRole';
export * from './updateCrmTeamSettingsRequestMoveClosedDealsRole';
export * from './updateForm';
+export * from './updateFormAccentColor';
export * from './updateFormClosesAt';
+export * from './updateFormCoverFileId';
+export * from './updateFormLogoFileId';
export * from './updateInitiativeRequest';
export * from './updateInitiativeRequestMemberIds';
export * from './updateInitiativeRequestName';
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateForm.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateForm.ts
index 4feb798271..4a490f2cff 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateForm.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateForm.ts
@@ -4,24 +4,37 @@
* document_storage_service
* OpenAPI spec version: 0.1.0
*/
+
import type { Audience } from './audience';
import type { FormStatus } from './formStatus';
+import type { UpdateFormAccentColor } from './updateFormAccentColor';
import type { UpdateFormClosesAt } from './updateFormClosesAt';
+import type { UpdateFormCoverFileId } from './updateFormCoverFileId';
+import type { UpdateFormLogoFileId } from './updateFormLogoFileId';
/**
- * A change to a form's facts; what is left out stays. The description and
-confirmation message take edit, the rest owner. A form is renamed
+ * A change to a form's facts; what is left out stays. The description,
+confirmation message and branding take edit, the rest owner. A form is renamed
through the entity mutation router.
*/
export interface UpdateForm {
+ /**
+ * A new accent color, or `null` for the default.
+ * @pattern ^#[0-9a-fA-F]{6}$
+ */
+ accentColor?: UpdateFormAccentColor;
/** Who may respond from now on. */
audience?: Audience;
/** When it stops taking responses, or `null` for never. */
closesAt?: UpdateFormClosesAt;
/** Its new confirmation message. */
confirmationMessage?: string;
+ /** A new cover image, or `null` to remove it. */
+ coverFileId?: UpdateFormCoverFileId;
/** Its new description. */
description?: string;
+ /** A new logo, or `null` to remove it. */
+ logoFileId?: UpdateFormLogoFileId;
/** Open or close it. */
status?: FormStatus;
/** Whether respondents may read option tallies. */
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormAccentColor.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormAccentColor.ts
new file mode 100644
index 0000000000..d8e8218f0f
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormAccentColor.ts
@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * A new accent color, or `null` for the default.
+ * @pattern ^#[0-9a-fA-F]{6}$
+ */
+export type UpdateFormAccentColor = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormCoverFileId.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormCoverFileId.ts
new file mode 100644
index 0000000000..86b57c2af9
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormCoverFileId.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * A new cover image, or `null` to remove it.
+ */
+export type UpdateFormCoverFileId = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormLogoFileId.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormLogoFileId.ts
new file mode 100644
index 0000000000..88ab80adb4
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/updateFormLogoFileId.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * A new logo, or `null` to remove it.
+ */
+export type UpdateFormLogoFileId = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
index 9e3123adf7..a66477b18e 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
@@ -22610,11 +22610,38 @@ export const listFormsQueryParams = zod.object({
databaseId: zod.uuid().describe('The database.'),
});
+export const listFormsResponseBrandingAccentColorRegExpTwo = new RegExp(
+ '^#[0-9a-fA-F]{6}$'
+);
+
export const listFormsResponseItem = zod
.object({
audience: zod
.enum(['members', 'public'])
.describe('Who may respond to a form.'),
+ branding: zod
+ .object({
+ accentColor: zod.union([
+ zod.null(),
+ zod
+ .string()
+ .regex(listFormsResponseBrandingAccentColorRegExpTwo)
+ .describe('A color as `#rrggbb`, kept in lowercase.'),
+ ]),
+ coverFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as a banner across the top of the page.'
+ ),
+ logoFileId: zod
+ .uuid()
+ .nullable()
+ .describe('The static file shown as the logo above the title.'),
+ })
+ .describe(
+ "A form's logo, cover image and accent color, each unset by default."
+ ),
closesAt: zod.iso
.datetime({})
.nullable()
@@ -22710,6 +22737,9 @@ export const createFormBody = zod
level: what Drive and Quick Access list. Public forms reached only by
their link are not listed.
*/
+export const listAccessibleFormsResponseFormBrandingAccentColorRegExpTwo =
+ new RegExp('^#[0-9a-fA-F]{6}$');
+
export const listAccessibleFormsResponseItem = zod
.object({
access: zod
@@ -22722,6 +22752,31 @@ export const listAccessibleFormsResponseItem = zod
audience: zod
.enum(['members', 'public'])
.describe('Who may respond to a form.'),
+ branding: zod
+ .object({
+ accentColor: zod.union([
+ zod.null(),
+ zod
+ .string()
+ .regex(
+ listAccessibleFormsResponseFormBrandingAccentColorRegExpTwo
+ )
+ .describe('A color as `#rrggbb`, kept in lowercase.'),
+ ]),
+ coverFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as a banner across the top of the page.'
+ ),
+ logoFileId: zod
+ .uuid()
+ .nullable()
+ .describe('The static file shown as the logo above the title.'),
+ })
+ .describe(
+ "A form's logo, cover image and accent color, each unset by default."
+ ),
closesAt: zod.iso
.datetime({})
.nullable()
@@ -22792,6 +22847,10 @@ export const getFormParams = zod.object({
id: zod.uuid().describe('Form id'),
});
+export const getFormResponseFormBrandingAccentColorRegExpTwo = new RegExp(
+ '^#[0-9a-fA-F]{6}$'
+);
+
export const getFormResponse = zod
.object({
access: zod
@@ -22804,6 +22863,29 @@ export const getFormResponse = zod
audience: zod
.enum(['members', 'public'])
.describe('Who may respond to a form.'),
+ branding: zod
+ .object({
+ accentColor: zod.union([
+ zod.null(),
+ zod
+ .string()
+ .regex(getFormResponseFormBrandingAccentColorRegExpTwo)
+ .describe('A color as `#rrggbb`, kept in lowercase.'),
+ ]),
+ coverFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as a banner across the top of the page.'
+ ),
+ logoFileId: zod
+ .uuid()
+ .nullable()
+ .describe('The static file shown as the logo above the title.'),
+ })
+ .describe(
+ "A form's logo, cover image and accent color, each unset by default."
+ ),
closesAt: zod.iso
.datetime({})
.nullable()
@@ -23280,8 +23362,15 @@ export const updateFormParams = zod.object({
id: zod.uuid().describe('Form id'),
});
+export const updateFormBodyAccentColorRegExp = new RegExp('^#[0-9a-fA-F]{6}$');
+
export const updateFormBody = zod
.object({
+ accentColor: zod
+ .string()
+ .regex(updateFormBodyAccentColorRegExp)
+ .nullish()
+ .describe('A new accent color, or `null` for the default.'),
audience: zod
.enum(['members', 'public'])
.optional()
@@ -23294,7 +23383,15 @@ export const updateFormBody = zod
.string()
.optional()
.describe('Its new confirmation message.'),
+ coverFileId: zod
+ .uuid()
+ .nullish()
+ .describe('A new cover image, or `null` to remove it.'),
description: zod.string().optional().describe('Its new description.'),
+ logoFileId: zod
+ .uuid()
+ .nullish()
+ .describe('A new logo, or `null` to remove it.'),
status: zod
.enum(['open', 'closed'])
.optional()
@@ -23307,14 +23404,41 @@ export const updateFormBody = zod
.describe('Whether respondents may read option tallies.'),
})
.describe(
- "A change to a form's facts; what is left out stays. The description and\nconfirmation message take edit, the rest owner. A form is renamed\nthrough the entity mutation router."
+ "A change to a form's facts; what is left out stays. The description,\nconfirmation message and branding take edit, the rest owner. A form is renamed\nthrough the entity mutation router."
);
+export const updateFormResponseBrandingAccentColorRegExpTwo = new RegExp(
+ '^#[0-9a-fA-F]{6}$'
+);
+
export const updateFormResponse = zod
.object({
audience: zod
.enum(['members', 'public'])
.describe('Who may respond to a form.'),
+ branding: zod
+ .object({
+ accentColor: zod.union([
+ zod.null(),
+ zod
+ .string()
+ .regex(updateFormResponseBrandingAccentColorRegExpTwo)
+ .describe('A color as `#rrggbb`, kept in lowercase.'),
+ ]),
+ coverFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as a banner across the top of the page.'
+ ),
+ logoFileId: zod
+ .uuid()
+ .nullable()
+ .describe('The static file shown as the logo above the title.'),
+ })
+ .describe(
+ "A form's logo, cover image and accent color, each unset by default."
+ ),
closesAt: zod.iso
.datetime({})
.nullable()
@@ -23374,6 +23498,8 @@ export const collaborateFormParams = zod.object({
id: zod.uuid().describe('Form id'),
});
+export const collaborateFormResponseDetailFormBrandingAccentColorRegExpTwo =
+ new RegExp('^#[0-9a-fA-F]{6}$');
export const collaborateFormResponsePublicationErrorProblemMaxMin = 0;
export const collaborateFormResponse = zod
@@ -23390,6 +23516,33 @@ export const collaborateFormResponse = zod
audience: zod
.enum(['members', 'public'])
.describe('Who may respond to a form.'),
+ branding: zod
+ .object({
+ accentColor: zod.union([
+ zod.null(),
+ zod
+ .string()
+ .regex(
+ collaborateFormResponseDetailFormBrandingAccentColorRegExpTwo
+ )
+ .describe('A color as `#rrggbb`, kept in lowercase.'),
+ ]),
+ coverFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as a banner across the top of the page.'
+ ),
+ logoFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as the logo above the title.'
+ ),
+ })
+ .describe(
+ "A form's logo, cover image and accent color, each unset by default."
+ ),
closesAt: zod.iso
.datetime({})
.nullable()
@@ -24291,6 +24444,8 @@ export const putFormLayoutBody = zod
})
.describe('Every section of a form, in order.');
+export const putFormLayoutResponseDetailFormBrandingAccentColorRegExpTwo =
+ new RegExp('^#[0-9a-fA-F]{6}$');
export const putFormLayoutResponsePublicationErrorProblemMaxMin = 0;
export const putFormLayoutResponse = zod
@@ -24307,6 +24462,33 @@ export const putFormLayoutResponse = zod
audience: zod
.enum(['members', 'public'])
.describe('Who may respond to a form.'),
+ branding: zod
+ .object({
+ accentColor: zod.union([
+ zod.null(),
+ zod
+ .string()
+ .regex(
+ putFormLayoutResponseDetailFormBrandingAccentColorRegExpTwo
+ )
+ .describe('A color as `#rrggbb`, kept in lowercase.'),
+ ]),
+ coverFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as a banner across the top of the page.'
+ ),
+ logoFileId: zod
+ .uuid()
+ .nullable()
+ .describe(
+ 'The static file shown as the logo above the title.'
+ ),
+ })
+ .describe(
+ "A form's logo, cover image and accent color, each unset by default."
+ ),
closesAt: zod.iso
.datetime({})
.nullable()
diff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.json
index f717973739..528039a7ae 100644
--- a/apps/web/src/lib/service-clients/service-storage/openapi.json
+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json
@@ -19699,6 +19699,11 @@
},
"components": {
"schemas": {
+ "AccentColor": {
+ "type": "string",
+ "description": "A color as `#rrggbb`, kept in lowercase.",
+ "pattern": "^#[0-9a-fA-F]{6}$"
+ },
"AccessLevel": {
"type": "string",
"description": "Ordered from least to most access top -> bottom",
@@ -31729,6 +31734,7 @@
"status",
"closesAt",
"confirmationMessage",
+ "branding",
"createdAt",
"updatedAt",
"isHiddenInDrive"
@@ -31738,6 +31744,10 @@
"$ref": "#/components/schemas/Audience",
"description": "Who may respond."
},
+ "branding": {
+ "$ref": "#/components/schemas/FormBranding",
+ "description": "Its logo, cover image and accent color."
+ },
"closesAt": {
"type": ["string", "null"],
"format": "date-time",
@@ -31813,6 +31823,34 @@
"description": "The caller's level on a form: view responds, edit changes questions and\nreads responses, owner also sets the audience, closes and trashes it.",
"enum": ["view", "edit", "owner"]
},
+ "FormBranding": {
+ "type": "object",
+ "description": "A form's logo, cover image and accent color, each unset by default.",
+ "required": ["logoFileId", "coverFileId", "accentColor"],
+ "properties": {
+ "accentColor": {
+ "oneOf": [
+ {
+ "type": "null"
+ },
+ {
+ "$ref": "#/components/schemas/AccentColor",
+ "description": "The color of the page's buttons and selected answers."
+ }
+ ]
+ },
+ "coverFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "The static file shown as a banner across the top of the page."
+ },
+ "logoFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "The static file shown as the logo above the title."
+ }
+ }
+ },
"FormCollaboration": {
"type": "object",
"description": "A ready collaborative form and the result of publishing its latest draft.",
@@ -31877,6 +31915,7 @@
"invalidName",
"invalidSharing",
"tallyHidden",
+ "invalidBranding",
"conflict",
"internal"
]
@@ -44566,8 +44605,13 @@
},
"UpdateForm": {
"type": "object",
- "description": "A change to a form's facts; what is left out stays. The description and\nconfirmation message take edit, the rest owner. A form is renamed\nthrough the entity mutation router.",
+ "description": "A change to a form's facts; what is left out stays. The description,\nconfirmation message and branding take edit, the rest owner. A form is renamed\nthrough the entity mutation router.",
"properties": {
+ "accentColor": {
+ "type": ["string", "null"],
+ "description": "A new accent color, or `null` for the default.",
+ "pattern": "^#[0-9a-fA-F]{6}$"
+ },
"audience": {
"$ref": "#/components/schemas/Audience",
"description": "Who may respond from now on."
@@ -44581,10 +44625,20 @@
"type": "string",
"description": "Its new confirmation message."
},
+ "coverFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "A new cover image, or `null` to remove it."
+ },
"description": {
"type": "string",
"description": "Its new description."
},
+ "logoFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "A new logo, or `null` to remove it."
+ },
"status": {
"$ref": "#/components/schemas/FormStatus",
"description": "Open or close it."
diff --git a/crates/agent_code_mode/src/domain/documentation.json b/crates/agent_code_mode/src/domain/documentation.json
index afb5277f28..bac5ef9c8e 100644
--- a/crates/agent_code_mode/src/domain/documentation.json
+++ b/crates/agent_code_mode/src/domain/documentation.json
@@ -475,6 +475,7 @@
"SharedEmailFilter": "# Type Alias: SharedEmailFilter\n\n> **SharedEmailFilter** = `\"exclude\"` \\| `\"include\"` \\| `\"only\"`\n\nControls whether shared email threads are included in results.",
"TagFilterMode": "# Type Alias: TagFilterMode\n\n> **TagFilterMode** = `\"any\"` \\| `\"all\"`\n\nHow multiple `tag_option_ids` combine when filtering.",
"TaskFilters": "# Type Alias: TaskFilters\n\n> **TaskFilters** = \\{ `include_cbm_atm_nc?`: `boolean` \\| `null`; \\}\n\nTask-only filters nested under document filters.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-include_cbm_atm_nc\"></a> `include_cbm_atm_nc?` | `boolean` \\| `null` | Include tasks that are created by me, assigned to me, and not completed, even when they do not match other document filters. |",
+ "AccentColor": "# Type Alias: AccentColor\n\n> **AccentColor** = `string`\n\nA color as `#rrggbb`, kept in lowercase.",
"storage.AccessLevel": "# Type Alias: AccessLevel\n\n> **AccessLevel** = `\"view\"` \\| `\"comment\"` \\| `\"edit\"` \\| `\"owner\"`\n\nOrdered from least to most access top -> bottom",
"storage.AccessRequest": "# Type Alias: AccessRequest\n\n> **AccessRequest** = \\{ `createdAt`: `string`; `grantedLevel?`: `null` \\| `storage.AccessLevel`; `id`: `string`; `requestedLevel`: `storage.AccessLevel`; `requesterId`: `string`; `resolvedAt?`: `string` \\| `null`; `retryAfter?`: `string` \\| `null`; `revision`: `number`; `status`: `RequestStatus`; `updatedAt`: `string`; \\}\n\nLatest request for one person and one entity.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-createdat\"></a> `createdAt` | `string` | Start of this request attempt. |\n| <a id=\"property-grantedlevel\"></a> `grantedLevel?` | `null` \\| `storage.AccessLevel` | - |\n| <a id=\"property-id\"></a> `id` | `string` | Stable request identity across revisions. |\n| <a id=\"property-requestedlevel\"></a> `requestedLevel` | `storage.AccessLevel` | Requested upgrade. |\n| <a id=\"property-requesterid\"></a> `requesterId` | `string` | Person requesting access. |\n| <a id=\"property-resolvedat\"></a> `resolvedAt?` | `string` \\| `null` | When the request stopped being pending. |\n| <a id=\"property-retryafter\"></a> `retryAfter?` | `string` \\| `null` | Earliest next submission or level change; cancellation preserves this deadline. Submissions wait one minute, denials wait 24 hours, and approval clears it. |\n| <a id=\"property-revision\"></a> `revision` | `number` | Optimistic concurrency token. |\n| <a id=\"property-status\"></a> `status` | `RequestStatus` | Current outcome. |\n| <a id=\"property-updatedat\"></a> `updatedAt` | `string` | Most recent change. |",
"AccessiblePipeline": "# Type Alias: AccessiblePipeline\n\n> **AccessiblePipeline** = `Pipeline` & \\{ `grant`: `storage.AccessLevel`; \\}\n\nMetadata together with the caller's effective grant.\n\n## Type Declaration\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `grant` | `storage.AccessLevel` | Highest effective access. |",
@@ -632,8 +633,9 @@
"FilterTest": "# Type Alias: FilterTest\n\n> **FilterTest** = \\{ `kind`: `\"presence\"`; `operator`: `PresenceOperator`; \\} \\| \\{ `kind`: `\"text\"`; `operator`: `TextOperator`; `value`: `string`; \\} \\| \\{ `kind`: `\"number\"`; `operator`: `NumberOperator`; `value`: `number`; \\} \\| \\{ `kind`: `\"date\"`; `operator`: `DateOperator`; `value`: `string`; \\} \\| \\{ `kind`: `\"dateRange\"`; `operator`: `DateRangeOperator`; `value`: `string`; \\} \\| \\{ `checked`: `boolean`; `kind`: `\"checkbox\"`; \\} \\| \\{ `kind`: `\"options\"`; `operator`: `SetOperator`; `options`: `string`[]; \\} \\| \\{ `entities`: `string`[]; `kind`: `\"entities\"`; `operator`: `SetOperator`; \\}\n\nWhat a column's cell must be, by the kind of value the column holds.\n\n## Union Members\n\n### Type Literal\n\n\\{ `kind`: `\"presence\"`; `operator`: `PresenceOperator`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"presence\"` | - |\n| `operator` | `PresenceOperator` | Empty, or not. |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"text\"`; `operator`: `TextOperator`; `value`: `string`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"text\"` | - |\n| `operator` | `TextOperator` | How the cell compares. |\n| `value` | `string` | The text compared against, ignoring case for the containment tests. |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"number\"`; `operator`: `NumberOperator`; `value`: `number`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"number\"` | - |\n| `operator` | `NumberOperator` | How the cell compares. |\n| `value` | `number` | The number compared against; finite. |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"date\"`; `operator`: `DateOperator`; `value`: `string`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"date\"` | - |\n| `operator` | `DateOperator` | How the cell compares. |\n| `value` | `string` | The date-time compared against. |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"dateRange\"`; `operator`: `DateRangeOperator`; `value`: `string`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"dateRange\"` | - |\n| `operator` | `DateRangeOperator` | How the cell's range stands to the day. |\n| `value` | `string` | The start of the day compared against. |\n\n***\n\n### Type Literal\n\n\\{ `checked`: `boolean`; `kind`: `\"checkbox\"`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `checked` | `boolean` | Whether the box is checked. |\n| `kind` | `\"checkbox\"` | - |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"options\"`; `operator`: `SetOperator`; `options`: `string`[]; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"options\"` | - |\n| `operator` | `SetOperator` | How the cell's options relate to these. |\n| `options` | `string`[] | Options of the column; at least one. |\n\n***\n\n### Type Literal\n\n\\{ `entities`: `string`[]; `kind`: `\"entities\"`; `operator`: `SetOperator`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `entities` | `string`[] | Entity ids, or for a relation the related rows' ids; at least one. |\n| `kind` | `\"entities\"` | - |\n| `operator` | `SetOperator` | How the cell's references relate to these. |",
"FollowupState": "# Type Alias: FollowupState\n\n> **FollowupState** = `\"archiving\"` \\| `\"pending\"` \\| `\"returning\"` \\| `\"returned\"` \\| `\"cancelled\"` \\| `\"removed\"`\n\nDurable progress of an email operation.",
"storage.ForeignEntity": "# Type Alias: ForeignEntity\n\n> **ForeignEntity** = \\{ `createdAt`: `string`; `foreignEntityId`: `string`; `foreignEntitySource`: `string`; `id`: `string`; `metadata`: `unknown`; `storedForAuthEntity`: `string`; `storedForId`: `string`; `updatedAt`: `string`; \\}\n\nA persisted mapping to an entity owned by an external system.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-createdat\"></a> `createdAt` | `string` | Timestamp when the record was created. |\n| <a id=\"property-foreignentityid\"></a> `foreignEntityId` | `string` | Identifier assigned by the external system. |\n| <a id=\"property-foreignentitysource\"></a> `foreignEntitySource` | `string` | Source system that owns the external identifier. |\n| <a id=\"property-id\"></a> `id` | `string` | Internal primary key for this foreign entity record. |\n| <a id=\"property-metadata\"></a> `metadata` | `unknown` | Arbitrary metadata stored with the mapping. |\n| <a id=\"property-storedforauthentity\"></a> `storedForAuthEntity` | `string` | Internal auth entity namespace this foreign entity is stored for. |\n| <a id=\"property-storedforid\"></a> `storedForId` | `string` | Internal entity identifier this foreign entity is stored for. |\n| <a id=\"property-updatedat\"></a> `updatedAt` | `string` | Timestamp when the record was last updated. |",
- "storage.Form": "# Type Alias: Form\n\n> **Form** = \\{ `audience`: `Audience`; `closesAt`: `string` \\| `null`; `confirmationMessage`: `string`; `createdAt`: `string`; `databaseId`: `string`; `description`: `string`; `id`: `string`; `isHiddenInDrive`: `boolean`; `name`: `string`; `ownerId`: `string`; `respondentColumnId`: `string` \\| `null`; `status`: `FormStatus`; `submittedColumnId`: `string` \\| `null`; `tableId`: `string`; `tallyVisible`: `boolean`; `updatedAt`: `string`; \\}\n\nA form: a view of one database table whose rows are its responses.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-audience\"></a> `audience` | `Audience` | Who may respond. |\n| <a id=\"property-closesat\"></a> `closesAt` | `string` \\| `null` | When it stops taking responses, if it does. |\n| <a id=\"property-confirmationmessage\"></a> `confirmationMessage` | `string` | What a respondent reads once their response is saved; empty for the default. |\n| <a id=\"property-createdat\"></a> `createdAt` | `string` | When it was created. |\n| <a id=\"property-databaseid\"></a> `databaseId` | `string` | The database holding its responses. |\n| <a id=\"property-description\"></a> `description` | `string` | What respondents read under the name. |\n| <a id=\"property-id\"></a> `id` | `string` | The form. |\n| <a id=\"property-ishiddenindrive\"></a> `isHiddenInDrive` | `boolean` | Whether Drive leaves it, and the database behind it, out of its listings, as for a channel poll. |\n| <a id=\"property-name\"></a> `name` | `string` | Its display name. A standalone form follows the database it created; a form attached to an existing table has its own name. |\n| <a id=\"property-ownerid\"></a> `ownerId` | `string` | Its owner. |\n| <a id=\"property-respondentcolumnid\"></a> `respondentColumnId` | `string` \\| `null` | The person column each signed-in submission names its respondent in; `null` once deleted. |\n| <a id=\"property-status\"></a> `status` | `FormStatus` | Whether its owner closed it. |\n| <a id=\"property-submittedcolumnid\"></a> `submittedColumnId` | `string` \\| `null` | The date column each submission stamps; `null` once deleted. |\n| <a id=\"property-tableid\"></a> `tableId` | `string` | The table whose rows are its responses. |\n| <a id=\"property-tallyvisible\"></a> `tallyVisible` | `boolean` | Whether respondents may read option tallies. |\n| <a id=\"property-updatedat\"></a> `updatedAt` | `string` | When its facts or layout last changed. |",
+ "storage.Form": "# Type Alias: Form\n\n> **Form** = \\{ `audience`: `Audience`; `branding`: `FormBranding`; `closesAt`: `string` \\| `null`; `confirmationMessage`: `string`; `createdAt`: `string`; `databaseId`: `string`; `description`: `string`; `id`: `string`; `isHiddenInDrive`: `boolean`; `name`: `string`; `ownerId`: `string`; `respondentColumnId`: `string` \\| `null`; `status`: `FormStatus`; `submittedColumnId`: `string` \\| `null`; `tableId`: `string`; `tallyVisible`: `boolean`; `updatedAt`: `string`; \\}\n\nA form: a view of one database table whose rows are its responses.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-audience\"></a> `audience` | `Audience` | Who may respond. |\n| <a id=\"property-branding\"></a> `branding` | `FormBranding` | Its logo, cover image and accent color. |\n| <a id=\"property-closesat\"></a> `closesAt` | `string` \\| `null` | When it stops taking responses, if it does. |\n| <a id=\"property-confirmationmessage\"></a> `confirmationMessage` | `string` | What a respondent reads once their response is saved; empty for the default. |\n| <a id=\"property-createdat\"></a> `createdAt` | `string` | When it was created. |\n| <a id=\"property-databaseid\"></a> `databaseId` | `string` | The database holding its responses. |\n| <a id=\"property-description\"></a> `description` | `string` | What respondents read under the name. |\n| <a id=\"property-id\"></a> `id` | `string` | The form. |\n| <a id=\"property-ishiddenindrive\"></a> `isHiddenInDrive` | `boolean` | Whether Drive leaves it, and the database behind it, out of its listings, as for a channel poll. |\n| <a id=\"property-name\"></a> `name` | `string` | Its display name. A standalone form follows the database it created; a form attached to an existing table has its own name. |\n| <a id=\"property-ownerid\"></a> `ownerId` | `string` | Its owner. |\n| <a id=\"property-respondentcolumnid\"></a> `respondentColumnId` | `string` \\| `null` | The person column each signed-in submission names its respondent in; `null` once deleted. |\n| <a id=\"property-status\"></a> `status` | `FormStatus` | Whether its owner closed it. |\n| <a id=\"property-submittedcolumnid\"></a> `submittedColumnId` | `string` \\| `null` | The date column each submission stamps; `null` once deleted. |\n| <a id=\"property-tableid\"></a> `tableId` | `string` | The table whose rows are its responses. |\n| <a id=\"property-tallyvisible\"></a> `tallyVisible` | `boolean` | Whether respondents may read option tallies. |\n| <a id=\"property-updatedat\"></a> `updatedAt` | `string` | When its facts or layout last changed. |",
"FormAccess": "# Type Alias: FormAccess\n\n> **FormAccess** = `\"view\"` \\| `\"edit\"` \\| `\"owner\"`\n\nThe caller's level on a form: view responds, edit changes questions and\nreads responses, owner also sets the audience, closes and trashes it.",
+ "FormBranding": "# Type Alias: FormBranding\n\n> **FormBranding** = \\{ `accentColor`: `null` \\| `AccentColor`; `coverFileId`: `string` \\| `null`; `logoFileId`: `string` \\| `null`; \\}\n\nA form's logo, cover image and accent color, each unset by default.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-accentcolor\"></a> `accentColor` | `null` \\| `AccentColor` | - |\n| <a id=\"property-coverfileid\"></a> `coverFileId` | `string` \\| `null` | The static file shown as a banner across the top of the page. |\n| <a id=\"property-logofileid\"></a> `logoFileId` | `string` \\| `null` | The static file shown as the logo above the title. |",
"FormDetail": "# Type Alias: FormDetail\n\n> **FormDetail** = \\{ `access`: `FormAccess`; `form`: `storage.Form`; `sections`: `FormSectionDetail`[]; `tableGone`: `boolean`; \\}\n\nA form with its layout, as the caller may see it.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-access\"></a> `access` | `FormAccess` | The caller's level on it. |\n| <a id=\"property-form\"></a> `form` | `storage.Form` | The form's facts. |\n| <a id=\"property-sections\"></a> `sections` | `FormSectionDetail`[] | Its sections, in order. |\n| <a id=\"property-tablegone\"></a> `tableGone` | `boolean` | Whether its database is in the trash, so it has no table to show or write: its sections keep no questions and it takes no responses. |",
"FormPublicationProblem": "# Type Alias: FormPublicationProblem\n\n> **FormPublicationProblem** = \\{ `kind`: `\"invalidDraft\"`; \\} \\| \\{ `kind`: `\"layout\"`; `problem`: `LayoutProblem`; \\} \\| \\{ `kind`: `\"widgetMismatch\"`; `question`: `string`; \\} \\| \\{ `kind`: `\"fileUploadNeedsSignIn\"`; \\} \\| \\{ `kind`: `\"pending\"`; \\}\n\nAn editor's saved draft is not yet the version respondents can use.\n\n## Union Members\n\n### Type Literal\n\n\\{ `kind`: `\"invalidDraft\"`; \\}\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"layout\"`; `problem`: `LayoutProblem`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"layout\"` | - |\n| `problem` | `LayoutProblem` | The invariant the editor needs to repair. |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"widgetMismatch\"`; `question`: `string`; \\}\n\n| Name | Type | Description |\n| ------ | ------ | ------ |\n| `kind` | `\"widgetMismatch\"` | - |\n| `question` | `string` | The question to repair. |\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"fileUploadNeedsSignIn\"`; \\}\n\n***\n\n### Type Literal\n\n\\{ `kind`: `\"pending\"`; \\}",
"FormQuestionDetail": "# Type Alias: FormQuestionDetail\n\n> **FormQuestionDetail** = \\{ `column`: `string`; `helpText`: `string`; `id`: `string`; `kind`: `ColumnKind`; `options`: `QuestionOption`[]; `required`: `boolean`; `title`: `string`; `widget`: `null` \\| `Widget`; \\}\n\nA question with its column's facts.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-column\"></a> `column` | `string` | The column it writes. |\n| <a id=\"property-helptext\"></a> `helpText` | `string` | What respondents read under the title. |\n| <a id=\"property-id\"></a> `id` | `string` | The question. |\n| <a id=\"property-kind\"></a> `kind` | `ColumnKind` | The column's type. |\n| <a id=\"property-options\"></a> `options` | `QuestionOption`[] | The column's options, in order, for a select or tag column. |\n| <a id=\"property-required\"></a> `required` | `boolean` | Whether a response must answer it. |\n| <a id=\"property-title\"></a> `title` | `string` | The column's name. |\n| <a id=\"property-widget\"></a> `widget` | `null` \\| `Widget` | - |",
@@ -768,7 +770,7 @@
"UnlockedBooking": "# Type Alias: UnlockedBooking\n\n> **UnlockedBooking** = \\{ `description`: `string`; `section`: `string`; `target`: `BookingTarget`; `title`: `string`; \\}\n\nA booking step a passing response has unlocked, with its destination.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-description\"></a> `description` | `string` | What respondents read before choosing a time. |\n| <a id=\"property-section\"></a> `section` | `string` | The booking section. |\n| <a id=\"property-target\"></a> `target` | `BookingTarget` | The native booking event to open. |\n| <a id=\"property-title\"></a> `title` | `string` | Its title. |",
"UpdateChannelSharePermission": "# Type Alias: UpdateChannelSharePermission\n\n> **UpdateChannelSharePermission** = \\{ `accessLevel?`: `null` \\| `storage.AccessLevel`; `channelId`: `string`; `operation`: `UpdateOperation`; \\}\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-accesslevel\"></a> `accessLevel?` | `null` \\| `storage.AccessLevel` | - |\n| <a id=\"property-channelid\"></a> `channelId` | `string` | The channel id |\n| <a id=\"property-operation\"></a> `operation` | `UpdateOperation` | The type of operation to be performed on the chanel share permission You can add, remove or replace and existing permission |",
"UpdateCrmTeamSettingsRequest": "# Type Alias: UpdateCrmTeamSettingsRequest\n\n> **UpdateCrmTeamSettingsRequest** = \\{ `closed_stage_ids?`: `string`[] \\| `null`; `default_team_view_id?`: `string` \\| `null`; `delete_records_role?`: `null` \\| `CrmPermissionRole`; `edit_stages_role?`: `null` \\| `CrmPermissionRole`; `move_closed_deals_role?`: `null` \\| `CrmPermissionRole`; `team_views?`: `unknown`; \\}\n\nRequest body for `PUT /crm/settings`. Every field is optional:\nomitted fields keep their current values.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-closed_stage_ids\"></a> `closed_stage_ids?` | `string`[] \\| `null` | New closed-stage set. Omit to keep the current value; pass `null` to clear it (falling back to the client label heuristic). |\n| <a id=\"property-default_team_view_id\"></a> `default_team_view_id?` | `string` \\| `null` | New default team view id. Omit to keep the current value; pass `null` to clear it. |\n| <a id=\"property-delete_records_role\"></a> `delete_records_role?` | `null` \\| `CrmPermissionRole` | - |\n| <a id=\"property-edit_stages_role\"></a> `edit_stages_role?` | `null` \\| `CrmPermissionRole` | - |\n| <a id=\"property-move_closed_deals_role\"></a> `move_closed_deals_role?` | `null` \\| `CrmPermissionRole` | - |\n| <a id=\"property-team_views\"></a> `team_views?` | `unknown` | Replacement team-views array (whole-blob, last write wins). |",
- "UpdateForm": "# Type Alias: UpdateForm\n\n> **UpdateForm** = \\{ `audience?`: `Audience`; `closesAt?`: `string` \\| `null`; `confirmationMessage?`: `string`; `description?`: `string`; `status?`: `FormStatus`; `tallyVisible?`: `boolean`; \\}\n\nA change to a form's facts; what is left out stays. The description and\nconfirmation message take edit, the rest owner. A form is renamed\nthrough the entity mutation router.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-audience\"></a> `audience?` | `Audience` | Who may respond from now on. |\n| <a id=\"property-closesat\"></a> `closesAt?` | `string` \\| `null` | When it stops taking responses, or `null` for never. |\n| <a id=\"property-confirmationmessage\"></a> `confirmationMessage?` | `string` | Its new confirmation message. |\n| <a id=\"property-description\"></a> `description?` | `string` | Its new description. |\n| <a id=\"property-status\"></a> `status?` | `FormStatus` | Open or close it. |\n| <a id=\"property-tallyvisible\"></a> `tallyVisible?` | `boolean` | Whether respondents may read option tallies. |",
+ "UpdateForm": "# Type Alias: UpdateForm\n\n> **UpdateForm** = \\{ `accentColor?`: `string` \\| `null`; `audience?`: `Audience`; `closesAt?`: `string` \\| `null`; `confirmationMessage?`: `string`; `coverFileId?`: `string` \\| `null`; `description?`: `string`; `logoFileId?`: `string` \\| `null`; `status?`: `FormStatus`; `tallyVisible?`: `boolean`; \\}\n\nA change to a form's facts; what is left out stays. The description,\nconfirmation message and branding take edit, the rest owner. A form is renamed\nthrough the entity mutation router.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-accentcolor\"></a> `accentColor?` | `string` \\| `null` | A new accent color, or `null` for the default. |\n| <a id=\"property-audience\"></a> `audience?` | `Audience` | Who may respond from now on. |\n| <a id=\"property-closesat\"></a> `closesAt?` | `string` \\| `null` | When it stops taking responses, or `null` for never. |\n| <a id=\"property-confirmationmessage\"></a> `confirmationMessage?` | `string` | Its new confirmation message. |\n| <a id=\"property-coverfileid\"></a> `coverFileId?` | `string` \\| `null` | A new cover image, or `null` to remove it. |\n| <a id=\"property-description\"></a> `description?` | `string` | Its new description. |\n| <a id=\"property-logofileid\"></a> `logoFileId?` | `string` \\| `null` | A new logo, or `null` to remove it. |\n| <a id=\"property-status\"></a> `status?` | `FormStatus` | Open or close it. |\n| <a id=\"property-tallyvisible\"></a> `tallyVisible?` | `boolean` | Whether respondents may read option tallies. |",
"UpdateMeetingRequest": "# Type Alias: UpdateMeetingRequest\n\n> **UpdateMeetingRequest** = \\{ `clearSchedule?`: `boolean`; `scheduledEnd?`: `string` \\| `null`; `scheduledStart?`: `string` \\| `null`; `title?`: `string` \\| `null`; \\}\n\nChanges to a meeting's title or scheduled time; omitted values stay unchanged.\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-clearschedule\"></a> `clearSchedule?` | `boolean` | Remove timed scheduling, for example when the calendar event becomes all-day. |\n| <a id=\"property-scheduledend\"></a> `scheduledEnd?` | `string` \\| `null` | Replacement scheduled end; requires a matching start. |\n| <a id=\"property-scheduledstart\"></a> `scheduledStart?` | `string` \\| `null` | Replacement scheduled start; requires a matching end. |\n| <a id=\"property-title\"></a> `title?` | `string` \\| `null` | Replacement title, when supplied. |",
"UpdateOperation": "# Type Alias: UpdateOperation\n\n> **UpdateOperation** = `\"add\"` \\| `\"remove\"` \\| `\"replace\"`",
"UpdateSharePermissionRequestV2": "# Type Alias: UpdateSharePermissionRequestV2\n\n> **UpdateSharePermissionRequestV2** = \\{ `channelSharePermissions?`: `UpdateChannelSharePermission`[] \\| `null`; `linkShare?`: `null` \\| `storage.LinkShare`; `linkShareAccessLevel?`: `null` \\| `storage.AccessLevel`; `teamShareAccessLevel?`: `null` \\| `storage.AccessLevel`; \\}\n\n## Properties\n\n| Property | Type | Description |\n| ------ | ------ | ------ |\n| <a id=\"property-channelsharepermissions\"></a> `channelSharePermissions?` | `UpdateChannelSharePermission`[] \\| `null` | Any channel share permissions to be created/updated/removed |\n| <a id=\"property-linkshare\"></a> `linkShare?` | `null` \\| `storage.LinkShare` | - |\n| <a id=\"property-linkshareaccesslevel\"></a> `linkShareAccessLevel?` | `null` \\| `storage.AccessLevel` | - |\n| <a id=\"property-teamshareaccesslevel\"></a> `teamShareAccessLevel?` | `null` \\| `storage.AccessLevel` | - |",
diff --git a/crates/ai_tools/Cargo.toml b/crates/ai_tools/Cargo.toml
index 84a00dd359..e3be6d402a 100644
--- a/crates/ai_tools/Cargo.toml
+++ b/crates/ai_tools/Cargo.toml
@@ -12,7 +12,7 @@ import_linear = { path = "../import_linear" }
import_jira = { path = "../import_jira" }
clap = { workspace = true, features = ["derive"] }
favorites = { path = "../favorites", features = ["ai_tools", "postgres"] }
-forms = { path = "../forms", features = ["ai_tools", "gateway", "postgres", "scheduling"] }
+forms = { path = "../forms", features = ["ai_tools", "gateway", "postgres", "scheduling", "static_files"] }
routines = { path = "../routines" }
macro_auth = { path = "../macro_auth" }
agent_code_mode = { path = "../agent_code_mode" }
diff --git a/crates/ai_tools/src/build_context.rs b/crates/ai_tools/src/build_context.rs
index ec9236c68a..82e642921b 100644
--- a/crates/ai_tools/src/build_context.rs
+++ b/crates/ai_tools/src/build_context.rs
@@ -555,6 +555,10 @@ pub async fn build_tool_service_context_from_env(
crate::tool_context::FormsToolConfig {
app_origin: macro_service_urls::AppServiceUrl::new()?.to_string(),
editing_worker_url: ai_editing_worker_url,
+ static_files: static_file_service_client::StaticFileServiceClient::new(
+ macro_auth::InternalApiKey::new()?.to_string(),
+ macro_service_urls::StaticFileServiceUrl::new()?.to_string(),
+ ),
},
);
diff --git a/crates/ai_tools/src/tool_context/forms.rs b/crates/ai_tools/src/tool_context/forms.rs
index d63310b5d7..e83d2e5bfb 100644
--- a/crates/ai_tools/src/tool_context/forms.rs
+++ b/crates/ai_tools/src/tool_context/forms.rs
@@ -54,6 +54,8 @@ pub struct FormsToolConfig {
pub app_origin: String,
/// Existing Cloudflare AI editing worker origin.
pub editing_worker_url: String,
+ /// Internal client for the images a form's branding shows.
+ pub static_files: static_file_service_client::StaticFileServiceClient,
}
/// Reuse host clients and the same Forms and Scheduling domain services as HTTP.
@@ -69,6 +71,7 @@ pub fn build_forms_tool_context(
let FormsToolConfig {
app_origin,
editing_worker_url,
+ static_files,
} = config;
let surfaces = Arc::new(pg_collab_surface_service(
pool.clone(),
@@ -83,6 +86,7 @@ pub fn build_forms_tool_context(
ToolFormEvents(gateway.map(GatewayFormEventPublisher::new)),
broker,
surfaces,
+ static_files,
));
let scheduling = Arc::new(SchedulingService::new(
PostgresRepository::new(pool.clone()),
diff --git a/crates/forms/AGENTS.md b/crates/forms/AGENTS.md
index 5e46cbd9dd..b288141f03 100644
--- a/crates/forms/AGENTS.md
+++ b/crates/forms/AGENTS.md
@@ -29,7 +29,9 @@ service.
## Boundaries
- Depends on: `databases` (ports), `collab_surface` (outbound, ports),
- `entity_access`, `models_forms`, `models_databases`, `macro_event_broker`.
+ `entity_access`, `models_forms`, `models_databases`, `macro_event_broker`,
+ `static_file_service_client` (feature `static_files`: branding images must
+ be the setter's own image uploads; `src/outbound/static_file_images.rs`).
- Used by: `document_storage_service`, `ai_tools`.
## Recipes
diff --git a/crates/forms/Cargo.toml b/crates/forms/Cargo.toml
index 69be75760f..9f3548f584 100644
--- a/crates/forms/Cargo.toml
+++ b/crates/forms/Cargo.toml
@@ -26,6 +26,8 @@ gateway = ["dep:anyhow", "dep:connection_gateway_client", "dep:serde_json", "out
# Driven adapters share the port contracts.
outbound = ["dep:collab_surface", "dep:reqwest", "dep:base64", "dep:macro_tower_layers", "ports"]
ports = ["dep:schemars", "models_forms/schema", "models_databases/schema", "databases/ports", "dep:entity_access", "dep:tracing", "dep:loro", "dep:serde_json"]
+# Branding images read through the static-file service.
+static_files = ["dep:anyhow", "dep:static_file_service_client", "outbound"]
# Postgres persistence for forms, layouts and the submission ledger.
postgres = ["dep:entity_access_db_utils", "dep:serde_json", "dep:sqlx", "outbound"]
@@ -64,6 +66,7 @@ rootcause = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true, optional = true }
sqlx = { workspace = true, optional = true }
+static_file_service_client = { path = "../static_file_service_client", optional = true }
thiserror = { workspace = true }
tracing = { workspace = true, optional = true }
utoipa = { workspace = true, optional = true }
diff --git a/crates/forms/src/domain/entity_mutation.rs b/crates/forms/src/domain/entity_mutation.rs
index 06842c0805..e5635ad890 100644
--- a/crates/forms/src/domain/entity_mutation.rs
+++ b/crates/forms/src/domain/entity_mutation.rs
@@ -13,7 +13,9 @@ use macro_event_broker::MacroEventBroker;
use model_entity::Entity;
use super::models::FormError;
-use super::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo, FormsService};
+use super::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo, FormsService,
+};
use super::service::FormsServiceImpl;
impl From<FormError> for EntityMutationErrorCode {
@@ -37,6 +39,7 @@ impl From<FormError> for EntityMutationErrorCode {
| FormError::InvalidLayout(_)
| FormError::InvalidName(_)
| FormError::InvalidSharing(_)
+ | FormError::InvalidBranding(_)
| FormError::TallyHidden) => Self::invalid(rootcause::report!(error)),
error @ (FormError::Database(_)
| FormError::Repository(_)
@@ -48,8 +51,8 @@ impl From<FormError> for EntityMutationErrorCode {
}
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> RenameEntity
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> RenameEntity
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -58,6 +61,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
type Receipt = EditAccessLevel;
@@ -72,8 +76,8 @@ where
}
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> TrashEntity
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> TrashEntity
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -82,6 +86,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
type Receipt = OwnerAccessLevel;
@@ -95,8 +100,8 @@ where
}
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> RestoreEntity
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> RestoreEntity
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -105,6 +110,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
type Receipt = OwnerAccessLevel;
@@ -118,8 +124,8 @@ where
}
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> DeleteEntityPermanently
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> DeleteEntityPermanently
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -128,6 +134,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
type Receipt = OwnerAccessLevel;
diff --git a/crates/forms/src/domain/models.rs b/crates/forms/src/domain/models.rs
index fc85b08af6..6d041ef978 100644
--- a/crates/forms/src/domain/models.rs
+++ b/crates/forms/src/domain/models.rs
@@ -7,8 +7,8 @@ use macro_user_id::user_id::MacroUserIdStr;
pub use models_databases::{CellValue, ColumnId, DatabaseId, OptionId, RowId, TableId};
pub use models_forms::{
- Answer, Audience, CreateForm, Form, FormAccess, FormDetail, FormId, FormLayout,
- FormQuestionDetail, FormQuestionId, FormResponse, FormResponseId, FormSection,
+ AccentColor, Answer, Audience, CreateForm, Form, FormAccess, FormBranding, FormDetail, FormId,
+ FormLayout, FormQuestionDetail, FormQuestionId, FormResponse, FormResponseId, FormSection,
FormSectionDetail, FormSectionId, FormSource, FormStatus, FormTally, LayoutProblem, ListedForm,
MyResponse, QuestionLayout, QuestionOption, QuestionTally, ResponseStatus, ResponseSummary,
SectionCount, Submission, SubmissionOutcome, TallyBucket, TallyValue, UpdateForm, Widget,
@@ -26,6 +26,15 @@ pub struct StoredForm {
pub name_follows_database: bool,
}
+/// A file a form's branding may show, as static-file storage records it.
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct StoredImageFile {
+ /// Who uploaded it.
+ pub owner_id: String,
+ /// Its media type.
+ pub content_type: String,
+}
+
/// Who is responding.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Respondent {
@@ -200,6 +209,9 @@ pub enum FormError {
/// A sharing change was refused.
#[error("invalid sharing change: {0}")]
InvalidSharing(SharingRefusal),
+ /// A logo or cover image is not an image the caller uploaded.
+ #[error("{0}")]
+ InvalidBranding(&'static str),
/// The owner keeps the form's tallies from respondents.
#[error("this form's results are hidden")]
TallyHidden,
diff --git a/crates/forms/src/domain/ports.rs b/crates/forms/src/domain/ports.rs
index 966d51ad01..525cf03281 100644
--- a/crates/forms/src/domain/ports.rs
+++ b/crates/forms/src/domain/ports.rs
@@ -8,12 +8,13 @@ use entity_access::domain::models::{
AccessLevel, EditAccessLevel, EntityAccessReceipt, OwnerAccessLevel, ViewAccessLevel,
};
use macro_user_id::user_id::MacroUserIdStr;
+use uuid::Uuid;
use crate::domain::models::{
Audience, DatabaseId, ForbiddenWidget, Form, FormDetail, FormError, FormId, FormLayout,
FormResponse, FormResponseId, FormSectionId, FormTally, FormUpdate, LayoutReplacement,
ListedForm, MyResponse, RecordedResponse, ResponseCounts, ResponseSummary, RowId, StoredForm,
- Submission, SubmissionOutcome, TableId, UpdateForm,
+ StoredImageFile, Submission, SubmissionOutcome, TableId, UpdateForm,
};
/// Where a new form's responses go, with the access the caller proved.
@@ -65,6 +66,19 @@ pub trait FormAccessDirectory: Send + Sync + 'static {
) -> impl Future<Output = Result<Vec<(FormId, AccessLevel)>, Self::Error>> + Send;
}
+/// Uploaded files, so a form's branding shows only images their uploader
+/// chose.
+pub trait FormImageFiles: Send + Sync + 'static {
+ /// The error type returned by lookups.
+ type Error: std::error::Error + Send + Sync + 'static;
+
+ /// The file, or `None` when there is no such file.
+ fn image_file(
+ &self,
+ file: Uuid,
+ ) -> impl Future<Output = Result<Option<StoredImageFile>, Self::Error>> + Send;
+}
+
/// Liveness: tell the form's open pages it changed, so each re-reads what it
/// shows under its own access. The ping names the form and nothing else.
pub trait FormEventPublisher: Send + Sync + 'static {
diff --git a/crates/forms/src/domain/service.rs b/crates/forms/src/domain/service.rs
index c8c61d459f..9791e0b496 100644
--- a/crates/forms/src/domain/service.rs
+++ b/crates/forms/src/domain/service.rs
@@ -35,15 +35,16 @@ use crate::domain::models::{
MyResponse, Respondent, ResponseSummary, StoredForm, Submission, SubmissionOutcome, UpdateForm,
};
use crate::domain::ports::{
- Clock, CreateFormCommand, FormAccessDirectory, FormEventPublisher, FormsRepo, FormsService,
+ Clock, CreateFormCommand, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+ FormsService,
};
/// Concrete forms service backed by its ports. `Databases` is the databases
/// domain service, the only way a form reads or writes its table; `Access`
/// lists the forms a user holds grants on; `Events` pings a form's open
-/// pages after it changes.
+/// pages after it changes; `Images` reads the files its branding shows.
#[derive(Debug, Clone)]
-pub struct FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts> {
+pub struct FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> {
repository: Repository,
databases: Arc<Databases>,
access: Access,
@@ -51,6 +52,7 @@ pub struct FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker,
clock: Now,
broker: Broker,
drafts: Drafts,
+ images: Images,
}
fn repository_error<Error: std::error::Error + Send + Sync + 'static>(error: Error) -> FormError {
@@ -151,8 +153,8 @@ fn internal_receipt<Level: RequiredPermission>(
)
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -161,8 +163,10 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
/// Create a forms service from its ports.
+ #[expect(clippy::too_many_arguments, reason = "one adapter per port")]
pub fn new(
repository: Repository,
databases: Arc<Databases>,
@@ -171,6 +175,7 @@ where
clock: Now,
broker: Broker,
drafts: Drafts,
+ images: Images,
) -> Self {
Self {
repository,
@@ -180,6 +185,7 @@ where
clock,
broker,
drafts,
+ images,
}
}
@@ -279,8 +285,8 @@ fn within(text: &str, max: usize) -> Result<(), FormError> {
Ok(())
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> FormsService
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> FormsService
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -289,6 +295,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
async fn collaborate_form(
&self,
diff --git a/crates/forms/src/domain/service/authoring.rs b/crates/forms/src/domain/service/authoring.rs
index 758b750090..db503ffab5 100644
--- a/crates/forms/src/domain/service/authoring.rs
+++ b/crates/forms/src/domain/service/authoring.rs
@@ -4,10 +4,10 @@ use crate::domain::authoring::ports::AuthoringCore;
use crate::domain::authoring::{Column, Snapshot};
use crate::domain::collaboration;
use crate::domain::drafts::FormDraftError;
-use crate::domain::ports::CreateSource;
+use crate::domain::ports::{CreateSource, FormImageFiles};
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> AuthoringCore
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> AuthoringCore
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository + crate::domain::sharing::FormSharingRepo,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -16,6 +16,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
async fn authoring_source(
&self,
diff --git a/crates/forms/src/domain/service/create.rs b/crates/forms/src/domain/service/create.rs
index 43415976e4..b18fa26de5 100644
--- a/crates/forms/src/domain/service/create.rs
+++ b/crates/forms/src/domain/service/create.rs
@@ -19,11 +19,13 @@ use super::{
};
use crate::domain::events::{Attribution, FormCreatedMetadata, FormTopicEvent};
use crate::domain::models::{
- Audience, ColumnId, DatabaseId, Form, FormAccess, FormCreation, FormDetail, FormError, FormId,
- FormLayout, FormQuestionId, FormSection, FormSectionId, FormStatus, QuestionLayout, TableId,
+ Audience, ColumnId, DatabaseId, Form, FormAccess, FormBranding, FormCreation, FormDetail,
+ FormError, FormId, FormLayout, FormQuestionId, FormSection, FormSectionId, FormStatus,
+ QuestionLayout, TableId,
};
use crate::domain::ports::{
- Clock, CreateFormCommand, CreateSource, FormAccessDirectory, FormEventPublisher, FormsRepo,
+ Clock, CreateFormCommand, CreateSource, FormAccessDirectory, FormEventPublisher,
+ FormImageFiles, FormsRepo,
};
/// The name a new database's table takes.
@@ -123,8 +125,8 @@ pub(super) enum CreationPolicy {
Authoring,
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -133,6 +135,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
pub(super) async fn create(
&self,
@@ -462,6 +465,7 @@ where
status,
closes_at: None,
confirmation_message: String::new(),
+ branding: FormBranding::default(),
created_at: now,
updated_at: now,
is_hidden_in_drive: matches!(
diff --git a/crates/forms/src/domain/service/drafts.rs b/crates/forms/src/domain/service/drafts.rs
index 9cb479343f..bb277438c8 100644
--- a/crates/forms/src/domain/service/drafts.rs
+++ b/crates/forms/src/domain/service/drafts.rs
@@ -16,7 +16,9 @@ use crate::domain::drafts::{
use crate::domain::models::{
Audience, Form, FormError, FormLayout, LayoutProblem, LayoutReplacement,
};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
/// The layout respondents can use and any current draft validation failure.
pub(super) struct RefreshedLayout {
@@ -49,8 +51,8 @@ fn publication_problem(error: FormError) -> FormPublicationProblem {
}
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -59,6 +61,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
pub(super) async fn ensure_draft(&self, form: &Form) -> Result<(), FormError> {
let state = self
diff --git a/crates/forms/src/domain/service/layout.rs b/crates/forms/src/domain/service/layout.rs
index f256b1a967..0439240985 100644
--- a/crates/forms/src/domain/service/layout.rs
+++ b/crates/forms/src/domain/service/layout.rs
@@ -20,7 +20,9 @@ use crate::domain::models::{
Audience, ColumnId, Form, FormAccess, FormDetail, FormError, FormLayout, FormQuestionDetail,
FormSection, FormSectionDetail, LayoutProblem, QuestionOption, Widget,
};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
/// What a question shows and checks of its column.
#[derive(Debug, Clone)]
@@ -340,8 +342,8 @@ pub(super) fn asks_for_a_file(layout: &FormLayout) -> bool {
})
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -350,6 +352,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
pub(super) async fn read_detail(
&self,
diff --git a/crates/forms/src/domain/service/lifecycle.rs b/crates/forms/src/domain/service/lifecycle.rs
index 4d57da9fad..0cea407742 100644
--- a/crates/forms/src/domain/service/lifecycle.rs
+++ b/crates/forms/src/domain/service/lifecycle.rs
@@ -12,7 +12,9 @@ use entity_access::domain::models::{
AccessLevel, EditAccessLevel, EntityAccessReceipt, OwnerAccessLevel,
};
use macro_event_broker::MacroEventBroker;
+use macro_user_id::user_id::MacroUserIdStr;
use models_forms::MAX_TEXT_LENGTH;
+use uuid::Uuid;
use super::layout::file_columns;
use super::{
@@ -26,10 +28,12 @@ use crate::domain::models::{
Audience, ForbiddenWidget, Form, FormAccess, FormError, FormId, FormUpdate, ListedForm,
UpdateForm, Widget,
};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -38,6 +42,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
/// The live forms the viewer holds a grant on, newest first, each with
/// the viewer's level as the grants answer it.
@@ -84,6 +89,17 @@ where
{
within(text, MAX_TEXT_LENGTH)?;
}
+ let actor = receipt.acting_user_id();
+ for (chosen, current) in [
+ (update.logo_file_id, form.branding.logo_file_id),
+ (update.cover_file_id, form.branding.cover_file_id),
+ ] {
+ if let Some(Some(file)) = chosen
+ && Some(file) != current
+ {
+ self.check_branding_image(file, actor).await?;
+ }
+ }
// A public form asks for no file: going public holds only if no
// question asks for one when the change commits. A file widget left
// on a column the grid retyped asks for nothing, so only the
@@ -116,6 +132,37 @@ where
}
}
+ /// A logo or cover must be an image the caller uploaded, so a form never
+ /// shows a file someone else chose to keep to themselves. Keeping the
+ /// image a form already shows needs no check. Whether its bytes landed is
+ /// not asked: storage marks that only after the upload is used here.
+ async fn check_branding_image(
+ &self,
+ file: Uuid,
+ actor: Option<&MacroUserIdStr<'static>>,
+ ) -> Result<(), FormError> {
+ let stored = self
+ .images
+ .image_file(file)
+ .await
+ .map_err(repository_error)?
+ .ok_or(FormError::InvalidBranding("the image is not available"))?;
+ if actor.is_none_or(|actor| stored.owner_id != actor.as_ref()) {
+ return Err(FormError::InvalidBranding(
+ "the image must be one you uploaded",
+ ));
+ }
+ if !matches!(
+ stored.content_type.as_str(),
+ "image/jpeg" | "image/png" | "image/webp" | "image/gif"
+ ) {
+ return Err(FormError::InvalidBranding(
+ "the image must be a JPEG, PNG, WebP or GIF",
+ ));
+ }
+ Ok(())
+ }
+
/// Rename a form: the database it goes by, when it follows one, then a
/// stamp of the form itself; otherwise the form's own name.
pub(super) async fn rename(
diff --git a/crates/forms/src/domain/service/names.rs b/crates/forms/src/domain/service/names.rs
index 39393f0d59..0f1791562a 100644
--- a/crates/forms/src/domain/service/names.rs
+++ b/crates/forms/src/domain/service/names.rs
@@ -17,7 +17,9 @@ use macro_event_broker::MacroEventBroker;
use super::{FormsServiceImpl, database_error, internal_receipt, repository_error};
use crate::domain::models::{DatabaseId, Form, FormError, FormId};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
/// The receipt a form's editor renames its database with: Edit on a live
/// form grants Edit on its database, so the caller's own auth acts there
@@ -39,8 +41,8 @@ fn database_edit_receipt(
.map_err(|_| FormError::NotFound)
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -49,6 +51,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
/// The name of the database a form goes by, in the trash or not. A
/// database's forms are removed with it, so a missing one breaks the
diff --git a/crates/forms/src/domain/service/responses.rs b/crates/forms/src/domain/service/responses.rs
index f979df6ed6..758b0b1576 100644
--- a/crates/forms/src/domain/service/responses.rs
+++ b/crates/forms/src/domain/service/responses.rs
@@ -20,7 +20,9 @@ use crate::domain::models::{
FormAccess, FormError, FormSection, FormSectionId, FormTally, QuestionOption, QuestionTally,
ResponseSummary, SectionCount, TallyBucket, TallyValue,
};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
/// One column's tally from its cells.
fn tally_of(
@@ -76,8 +78,8 @@ fn tallied(kind: ColumnKind) -> bool {
}
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -86,6 +88,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
pub(super) async fn summary(
&self,
diff --git a/crates/forms/src/domain/service/sharing.rs b/crates/forms/src/domain/service/sharing.rs
index ff1448ffde..68304cb339 100644
--- a/crates/forms/src/domain/service/sharing.rs
+++ b/crates/forms/src/domain/service/sharing.rs
@@ -16,14 +16,16 @@ use uuid::Uuid;
use super::{FormsServiceImpl, receipt_attribution, receipt_form_id, repository_error};
use crate::domain::events::{FormChangedMetadata, FormTopicEvent};
use crate::domain::models::{FormError, SharingRefusal};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
use crate::domain::sharing::{FormSharingRepo, FormSharingService};
/// Most channel grants one request may change.
const MAX_CHANNEL_GRANTS_PER_UPDATE: usize = 100;
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts> FormSharingService
- for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images> FormSharingService
+ for FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormSharingRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -32,6 +34,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
#[tracing::instrument(skip(self, receipt), err)]
async fn share_permissions(
diff --git a/crates/forms/src/domain/service/submit.rs b/crates/forms/src/domain/service/submit.rs
index 09842c10a8..aa605001f8 100644
--- a/crates/forms/src/domain/service/submit.rs
+++ b/crates/forms/src/domain/service/submit.rs
@@ -30,7 +30,9 @@ use crate::domain::models::{
Answer, Audience, ColumnId, Form, FormError, FormLayout, FormResponse, FormSection, MyResponse,
RecordedResponse, Respondent, ResponseStatus, RowId, Submission, SubmissionOutcome,
};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
+};
/// The cells of a new row: every answer, then the managed columns the table
/// still has.
@@ -163,8 +165,8 @@ fn still_passes(
)
}
-impl<Repository, Databases, Access, Events, Now, Broker, Drafts>
- FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts>
+impl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
+ FormsServiceImpl<Repository, Databases, Access, Events, Now, Broker, Drafts, Images>
where
Repository: FormsRepo + FormDraftRepository,
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -173,6 +175,7 @@ where
Now: Clock,
Broker: MacroEventBroker,
Drafts: FormDraftStore,
+ Images: FormImageFiles,
{
/// The form, its table and layout for a respondent about to write:
/// refused when it is closed, its table is gone, or it takes signed-in
diff --git a/crates/forms/src/domain/service/test.rs b/crates/forms/src/domain/service/test.rs
index d05bcb63f3..f4f6a4107a 100644
--- a/crates/forms/src/domain/service/test.rs
+++ b/crates/forms/src/domain/service/test.rs
@@ -20,8 +20,8 @@ use models_databases::{ColumnId, ColumnKind, EntityKind, OptionId, TableId};
use uuid::Uuid;
use crate::domain::models::{
- Audience, DatabaseId, Form, FormId, FormLayout, FormQuestionId, FormSection, FormSectionId,
- FormStatus, QuestionLayout, StoredForm, Widget,
+ Audience, DatabaseId, Form, FormBranding, FormId, FormLayout, FormQuestionId, FormSection,
+ FormSectionId, FormStatus, QuestionLayout, StoredForm, Widget,
};
mod authoring_workflow;
@@ -56,6 +56,7 @@ type Service = FormsServiceImpl<
FixedClock,
RecordingBroker,
FakeDrafts,
+ FakeImageFiles,
>;
fn user(id: &'static str) -> MacroUserIdStr<'static> {
@@ -87,6 +88,7 @@ fn service(world: &Shared) -> Service {
FixedClock(world.clone()),
RecordingBroker(world.clone()),
FakeDrafts(world.clone()),
+ FakeImageFiles(world.clone()),
)
}
@@ -293,6 +295,7 @@ fn seed_rsvp(world: &Shared, audience: Audience) {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: now,
updated_at: now,
is_hidden_in_drive: false,
diff --git a/crates/forms/src/domain/service/test/create.rs b/crates/forms/src/domain/service/test/create.rs
index 652d71b9cf..3a03e4067a 100644
--- a/crates/forms/src/domain/service/test/create.rs
+++ b/crates/forms/src/domain/service/test/create.rs
@@ -96,6 +96,7 @@ async fn a_form_over_a_table_asks_every_column_and_adds_the_managed_ones() {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: start_of_tests(),
updated_at: start_of_tests(),
is_hidden_in_drive: false,
diff --git a/crates/forms/src/domain/service/test/end_to_end.rs b/crates/forms/src/domain/service/test/end_to_end.rs
index 4353ca33ee..e7e597a475 100644
--- a/crates/forms/src/domain/service/test/end_to_end.rs
+++ b/crates/forms/src/domain/service/test/end_to_end.rs
@@ -79,6 +79,7 @@ async fn a_form_over_a_new_database_writes_a_passing_response_as_a_row_and_stops
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: Utc.with_ymd_and_hms(2026, 9, 1, 9, 0, 0).unwrap(),
updated_at: Utc.with_ymd_and_hms(2026, 9, 1, 9, 0, 0).unwrap(),
is_hidden_in_drive: false,
diff --git a/crates/forms/src/domain/service/test/fakes.rs b/crates/forms/src/domain/service/test/fakes.rs
index 7f5cfe3f33..6d6ede268b 100644
--- a/crates/forms/src/domain/service/test/fakes.rs
+++ b/crates/forms/src/domain/service/test/fakes.rs
@@ -19,9 +19,11 @@ use models_permissions::share_permission::channel_share_permission::{
use crate::domain::models::{
Audience, ColumnId, DatabaseId, ForbiddenWidget, Form, FormId, FormLayout, FormResponse,
FormResponseId, FormSection, FormSectionId, FormUpdate, LayoutReplacement, RecordedResponse,
- ResponseCounts, ResponseStatus, RowId, StoredForm, UpdateForm, Widget,
+ ResponseCounts, ResponseStatus, RowId, StoredForm, StoredImageFile, UpdateForm, Widget,
+};
+use crate::domain::ports::{
+ Clock, FormAccessDirectory, FormEventPublisher, FormImageFiles, FormsRepo,
};
-use crate::domain::ports::{Clock, FormAccessDirectory, FormEventPublisher, FormsRepo};
use crate::domain::sharing::FormSharingRepo;
pub(crate) use self::databases::{
@@ -96,6 +98,8 @@ pub(crate) struct World {
pub(crate) database_metadata_reads: usize,
/// Every `macro.forms` envelope the service handed the broker.
pub(crate) events: Vec<serde_json::Value>,
+ /// Uploaded files, by id, as static-file storage records them.
+ pub(crate) image_files: HashMap<uuid::Uuid, StoredImageFile>,
}
impl World {
@@ -132,6 +136,7 @@ impl World {
fail_database_metadata_reads: false,
database_metadata_reads: 0,
events: vec![],
+ image_files: HashMap::new(),
}
}
@@ -187,6 +192,18 @@ impl FormAccessDirectory for FakeAccess {
}
}
+/// The uploaded files the world holds.
+#[derive(Clone)]
+pub(crate) struct FakeImageFiles(pub(crate) Shared);
+
+impl FormImageFiles for FakeImageFiles {
+ type Error = FakeError;
+
+ async fn image_file(&self, file: uuid::Uuid) -> Result<Option<StoredImageFile>, FakeError> {
+ Ok(self.0.lock().unwrap().image_files.get(&file).cloned())
+ }
+}
+
/// Records each form a liveness ping named, and fails when told to.
#[derive(Clone)]
pub(crate) struct RecordingFormEvents(pub(crate) Shared);
@@ -459,6 +476,15 @@ impl FormsRepo for FakeRepo {
if let Some(tally_visible) = changes.tally_visible {
form.tally_visible = tally_visible;
}
+ if let Some(logo_file_id) = changes.logo_file_id {
+ form.branding.logo_file_id = logo_file_id;
+ }
+ if let Some(cover_file_id) = changes.cover_file_id {
+ form.branding.cover_file_id = cover_file_id;
+ }
+ if let Some(accent_color) = &changes.accent_color {
+ form.branding.accent_color = accent_color.clone();
+ }
form.updated_at = updated_at;
Ok(FormUpdate::Updated(Box::new(form.clone())))
}
diff --git a/crates/forms/src/domain/service/test/layout.rs b/crates/forms/src/domain/service/test/layout.rs
index d2e41d0e6f..e560feac2e 100644
--- a/crates/forms/src/domain/service/test/layout.rs
+++ b/crates/forms/src/domain/service/test/layout.rs
@@ -24,6 +24,7 @@ fn respondent_details_withhold_the_booking_destination() {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "Thank you".into(),
+ branding: FormBranding::default(),
created_at: start_of_tests(),
updated_at: start_of_tests(),
is_hidden_in_drive: false,
diff --git a/crates/forms/src/domain/service/test/lifecycle.rs b/crates/forms/src/domain/service/test/lifecycle.rs
index 5b54c0bc01..e9bd7454ea 100644
--- a/crates/forms/src/domain/service/test/lifecycle.rs
+++ b/crates/forms/src/domain/service/test/lifecycle.rs
@@ -4,7 +4,7 @@
use entity_access::domain::models::{EditAccessLevel, OwnerAccessLevel, ViewAccessLevel};
use super::*;
-use crate::domain::models::{FormError, UpdateForm};
+use crate::domain::models::{AccentColor, FormBranding, FormError, StoredImageFile, UpdateForm};
use crate::domain::ports::FormsService;
#[tokio::test]
@@ -274,3 +274,87 @@ async fn a_database_receipt_is_not_a_form_receipt() {
.await;
assert!(matches!(refused, Err(FormError::NotFound)));
}
+
+#[tokio::test]
+async fn an_editor_brands_the_form_with_images_they_uploaded() {
+ let logo = Uuid::from_u128(0x1060);
+ let cover = Uuid::from_u128(0xc0e2);
+ let theirs = Uuid::from_u128(0x7e125);
+ let document = Uuid::from_u128(0xd0c);
+ let world = world();
+ seed_rsvp(&world, Audience::Public);
+ {
+ let mut world = world.lock().unwrap();
+ for (id, owner, content_type) in [
+ (logo, EDITOR, "image/png"),
+ (cover, EDITOR, "image/jpeg"),
+ (theirs, STRANGER, "image/png"),
+ (document, EDITOR, "application/pdf"),
+ ] {
+ world.image_files.insert(
+ id,
+ StoredImageFile {
+ owner_id: owner.into(),
+ content_type: content_type.into(),
+ },
+ );
+ }
+ }
+ let forms = service(&world);
+
+ let branded = forms
+ .update_form(
+ form_receipt::<EditAccessLevel>(RSVP_FORM, EDITOR, AccessLevel::Edit),
+ UpdateForm {
+ logo_file_id: Some(Some(logo)),
+ cover_file_id: Some(Some(cover)),
+ accent_color: Some(Some(AccentColor::try_from("#1F6FEB".to_string()).unwrap())),
+ ..UpdateForm::default()
+ },
+ )
+ .await
+ .unwrap();
+ assert_eq!(
+ branded.branding,
+ FormBranding {
+ logo_file_id: Some(logo),
+ cover_file_id: Some(cover),
+ accent_color: Some(AccentColor::try_from("#1f6feb".to_string()).unwrap()),
+ }
+ );
+
+ for refused in [Uuid::from_u128(0x404), theirs, document] {
+ let result = forms
+ .update_form(
+ form_receipt::<EditAccessLevel>(RSVP_FORM, EDITOR, AccessLevel::Edit),
+ UpdateForm {
+ logo_file_id: Some(Some(refused)),
+ ..UpdateForm::default()
+ },
+ )
+ .await;
+ assert!(
+ matches!(result, Err(FormError::InvalidBranding(_))),
+ "{refused} was accepted: {result:?}"
+ );
+ }
+
+ // The owner keeps the editor's logo while removing the cover.
+ let kept = forms
+ .update_form(
+ form_receipt::<EditAccessLevel>(RSVP_FORM, OWNER, AccessLevel::Owner),
+ UpdateForm {
+ logo_file_id: Some(Some(logo)),
+ cover_file_id: Some(None),
+ ..UpdateForm::default()
+ },
+ )
+ .await
+ .unwrap();
+ assert_eq!(kept.branding.logo_file_id, Some(logo));
+ assert_eq!(kept.branding.cover_file_id, None);
+ assert_eq!(
+ kept.branding.accent_color,
+ Some(AccentColor::try_from("#1f6feb".to_string()).unwrap())
+ );
+}
diff --git a/crates/forms/src/domain/service/test/names.rs b/crates/forms/src/domain/service/test/names.rs
index d513d879a9..de4b1751fe 100644
--- a/crates/forms/src/domain/service/test/names.rs
+++ b/crates/forms/src/domain/service/test/names.rs
@@ -128,6 +128,7 @@ async fn which_name_a_new_form_goes_by_is_recorded_from_where_it_was_created() {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: start_of_tests(),
updated_at: start_of_tests(),
is_hidden_in_drive: false,
diff --git a/crates/forms/src/domain/service/test/surface_retirement.rs b/crates/forms/src/domain/service/test/surface_retirement.rs
index 0475eb8ac6..ed20fa23e1 100644
--- a/crates/forms/src/domain/service/test/surface_retirement.rs
+++ b/crates/forms/src/domain/service/test/surface_retirement.rs
@@ -74,6 +74,7 @@ async fn a_purge_retires_the_surface_only_once_the_form_is_gone() {
FixedClock(world.clone()),
RecordingBroker(world.clone()),
witness.clone(),
+ FakeImageFiles(world.clone()),
);
forms.trash_form(owner()).await.unwrap();
diff --git a/crates/forms/src/inbound/axum_router/error.rs b/crates/forms/src/inbound/axum_router/error.rs
index 4039c7c530..6d8fbb9cc5 100644
--- a/crates/forms/src/inbound/axum_router/error.rs
+++ b/crates/forms/src/inbound/axum_router/error.rs
@@ -182,6 +182,10 @@ impl IntoResponse for FormsApiError {
StatusCode::BAD_REQUEST,
body(FormErrorCode::InvalidSharing, message),
),
+ FormError::InvalidBranding(_) => (
+ StatusCode::BAD_REQUEST,
+ body(FormErrorCode::InvalidBranding, message),
+ ),
FormError::TallyHidden => (
StatusCode::FORBIDDEN,
body(FormErrorCode::TallyHidden, message),
diff --git a/crates/forms/src/inbound/axum_router/test.rs b/crates/forms/src/inbound/axum_router/test.rs
index dbdc694e4f..77625482aa 100644
--- a/crates/forms/src/inbound/axum_router/test.rs
+++ b/crates/forms/src/inbound/axum_router/test.rs
@@ -450,6 +450,11 @@ async fn refusals_read_as_a_code_status_and_the_question_at_fault() {
),
(FormError::OwnerOnly, StatusCode::FORBIDDEN, "ownerOnly"),
(FormError::TallyHidden, StatusCode::FORBIDDEN, "tallyHidden"),
+ (
+ FormError::InvalidBranding("the image must be one you uploaded"),
+ StatusCode::BAD_REQUEST,
+ "invalidBranding",
+ ),
(
FormError::Repository(rootcause::report!("down").into_dynamic()),
StatusCode::INTERNAL_SERVER_ERROR,
diff --git a/crates/forms/src/inbound/axum_router/test/fakes.rs b/crates/forms/src/inbound/axum_router/test/fakes.rs
index 33d4e46c66..dddd82c11f 100644
--- a/crates/forms/src/inbound/axum_router/test/fakes.rs
+++ b/crates/forms/src/inbound/axum_router/test/fakes.rs
@@ -23,8 +23,9 @@ use rootcause::Report;
use uuid::Uuid;
use crate::domain::models::{
- Audience, Form, FormAccess, FormDetail, FormError, FormId, FormLayout, FormStatus, FormTally,
- ListedForm, MyResponse, ResponseSummary, RowId, Submission, SubmissionOutcome, UpdateForm,
+ Audience, Form, FormAccess, FormBranding, FormDetail, FormError, FormId, FormLayout,
+ FormStatus, FormTally, ListedForm, MyResponse, ResponseSummary, RowId, Submission,
+ SubmissionOutcome, UpdateForm,
};
use crate::domain::ports::{CreateFormCommand, FormsService};
use crate::domain::sharing::FormSharingService;
@@ -249,6 +250,7 @@ pub(super) fn form() -> Form {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: at,
updated_at: at,
is_hidden_in_drive: false,
diff --git a/crates/forms/src/lib.rs b/crates/forms/src/lib.rs
index d6949296ac..8dfbaf0762 100644
--- a/crates/forms/src/lib.rs
+++ b/crates/forms/src/lib.rs
@@ -12,5 +12,5 @@ pub mod inbound;
#[cfg(feature = "outbound")]
pub mod outbound;
-#[cfg(feature = "postgres")]
+#[cfg(all(feature = "postgres", feature = "static_files"))]
pub mod wiring;
diff --git a/crates/forms/src/outbound.rs b/crates/forms/src/outbound.rs
index 499345ce95..0d6eb58df4 100644
--- a/crates/forms/src/outbound.rs
+++ b/crates/forms/src/outbound.rs
@@ -1,5 +1,6 @@
//! Driven adapters: the Postgres repository, the system clock, the forms
-//! catalog asked of `entity_access`, and liveness through the gateway.
+//! catalog asked of `entity_access`, liveness through the gateway, and the
+//! static files branding shows.
pub mod collaborative_layout;
pub mod entity_access_directory;
@@ -7,6 +8,8 @@ pub mod entity_access_directory;
pub mod gateway_event_publisher;
#[cfg(feature = "postgres")]
pub mod pg_forms_repo;
+#[cfg(feature = "static_files")]
+pub mod static_file_images;
pub mod system_clock;
/// Authoring permission adapter.
diff --git a/crates/forms/src/outbound/pg_forms_repo.rs b/crates/forms/src/outbound/pg_forms_repo.rs
index b1b4bb8060..31a9af169b 100644
--- a/crates/forms/src/outbound/pg_forms_repo.rs
+++ b/crates/forms/src/outbound/pg_forms_repo.rs
@@ -18,9 +18,9 @@ use sqlx::PgPool;
use uuid::Uuid;
use crate::domain::models::{
- Audience, ColumnId, DatabaseId, ForbiddenWidget, Form, FormCreation, FormId, FormLayout,
- FormResponse, FormResponseId, FormSectionId, FormStatus, FormUpdate, LayoutReplacement,
- RecordedResponse, ResponseCounts, RowId, StoredForm, TableId, UpdateForm,
+ AccentColor, Audience, ColumnId, DatabaseId, ForbiddenWidget, Form, FormBranding, FormCreation,
+ FormId, FormLayout, FormResponse, FormResponseId, FormSectionId, FormStatus, FormUpdate,
+ LayoutReplacement, RecordedResponse, ResponseCounts, RowId, StoredForm, TableId, UpdateForm,
};
/// Errors from the Postgres repository.
@@ -90,6 +90,9 @@ struct FormRow {
status: String,
closes_at: Option<DateTime<Utc>>,
confirmation_message: String,
+ logo_file_id: Option<Uuid>,
+ cover_file_id: Option<Uuid>,
+ accent_color: Option<String>,
created_at: DateTime<Utc>,
updated_at: DateTime<Utc>,
trashed_at: Option<DateTime<Utc>>,
@@ -116,6 +119,21 @@ impl TryFrom<FormRow> for StoredForm {
status: parsed::<FormStatus>("status", &row.status)?,
closes_at: row.closes_at,
confirmation_message: row.confirmation_message,
+ branding: FormBranding {
+ logo_file_id: row.logo_file_id,
+ cover_file_id: row.cover_file_id,
+ accent_color: row
+ .accent_color
+ .map(|color| {
+ AccentColor::try_from(color.clone()).map_err(|_| {
+ PgFormsRepoError::Corrupt {
+ kind: "accent color",
+ value: color,
+ }
+ })
+ })
+ .transpose()?,
+ },
created_at: row.created_at,
updated_at: row.updated_at,
is_hidden_in_drive: row.is_hidden_in_drive,
@@ -164,10 +182,13 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
INSERT INTO forms (
id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at,
- name_follows_database, is_hidden_in_drive
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id,
+ accent_color, created_at, updated_at, name_follows_database, is_hidden_in_drive
+ )
+ VALUES (
+ $1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18,
+ $19, $20
)
- VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17)
ON CONFLICT (table_id) DO NOTHING
"#,
form.id.into_uuid(),
@@ -183,6 +204,9 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
<&str>::from(form.status),
form.closes_at,
form.confirmation_message,
+ form.branding.logo_file_id,
+ form.branding.cover_file_id,
+ form.branding.accent_color.as_ref().map(AccentColor::as_str),
form.created_at,
form.updated_at,
name_follows_database,
@@ -232,7 +256,8 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
r#"
SELECT id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at, trashed_at,
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,
+ created_at, updated_at, trashed_at,
name_follows_database, is_hidden_in_drive
FROM forms WHERE id = $1
"#,
@@ -252,7 +277,8 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
r#"
SELECT id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at, trashed_at,
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,
+ created_at, updated_at, trashed_at,
name_follows_database, is_hidden_in_drive
FROM forms WHERE id = ANY($1) AND trashed_at IS NULL
ORDER BY id
@@ -285,7 +311,8 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
r#"
SELECT id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at, trashed_at,
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,
+ created_at, updated_at, trashed_at,
name_follows_database, is_hidden_in_drive
FROM forms WHERE database_id = $1 AND trashed_at IS NULL
ORDER BY created_at, id
@@ -368,11 +395,15 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
status = COALESCE($5, status),
closes_at = CASE WHEN $6 THEN $7 ELSE closes_at END,
tally_visible = COALESCE($8, tally_visible),
+ logo_file_id = CASE WHEN $10 THEN $11 ELSE logo_file_id END,
+ cover_file_id = CASE WHEN $12 THEN $13 ELSE cover_file_id END,
+ accent_color = CASE WHEN $14 THEN $15 ELSE accent_color END,
updated_at = $9
WHERE id = $1
RETURNING id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at, trashed_at,
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,
+ created_at, updated_at, trashed_at,
name_follows_database, is_hidden_in_drive
"#,
id.into_uuid(),
@@ -384,6 +415,15 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
changes.closes_at.flatten(),
changes.tally_visible,
updated_at,
+ changes.logo_file_id.is_some(),
+ changes.logo_file_id.flatten(),
+ changes.cover_file_id.is_some(),
+ changes.cover_file_id.flatten(),
+ changes.accent_color.is_some(),
+ changes
+ .accent_color
+ .as_ref()
+ .and_then(|color| color.as_ref().map(AccentColor::as_str)),
)
.fetch_one(&mut *transaction)
.await?;
@@ -406,7 +446,8 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
WHERE id = $1 AND trashed_at IS NULL
RETURNING id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at, trashed_at,
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,
+ created_at, updated_at, trashed_at,
name_follows_database, is_hidden_in_drive
"#,
id.into_uuid(),
@@ -432,7 +473,8 @@ impl crate::domain::ports::FormsRepo for PgFormsRepo {
WHERE id = $1 AND trashed_at IS NULL
RETURNING id, name, description, owner_id, database_id, table_id,
submitted_column_id, respondent_column_id, audience, tally_visible,
- status, closes_at, confirmation_message, created_at, updated_at, trashed_at,
+ status, closes_at, confirmation_message, logo_file_id, cover_file_id, accent_color,
+ created_at, updated_at, trashed_at,
name_follows_database, is_hidden_in_drive
"#,
id.into_uuid(),
diff --git a/crates/forms/src/outbound/pg_forms_repo/test.rs b/crates/forms/src/outbound/pg_forms_repo/test.rs
index 22ac7f1d85..1990255466 100644
--- a/crates/forms/src/outbound/pg_forms_repo/test.rs
+++ b/crates/forms/src/outbound/pg_forms_repo/test.rs
@@ -170,6 +170,7 @@ fn form_over(table: &Table) -> Form {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: at(9),
updated_at: at(9),
is_hidden_in_drive: false,
@@ -356,6 +357,9 @@ async fn facts_change_only_where_given_and_a_closing_time_can_be_cleared(pool: P
status: Some(FormStatus::Closed),
closes_at: Some(Some(at(17))),
tally_visible: Some(true),
+ logo_file_id: Some(Some(Uuid::from_u128(0x1060))),
+ cover_file_id: None,
+ accent_color: Some(Some(AccentColor::try_from("#1f6feb".to_string()).unwrap())),
},
at(10),
None,
@@ -369,6 +373,11 @@ async fn facts_change_only_where_given_and_a_closing_time_can_be_cleared(pool: P
*changed,
Form {
confirmation_message: "Thanks!".into(),
+ branding: FormBranding {
+ logo_file_id: Some(Uuid::from_u128(0x1060)),
+ cover_file_id: None,
+ accent_color: Some(AccentColor::try_from("#1f6feb".to_string()).unwrap()),
+ },
audience: Audience::Public,
status: FormStatus::Closed,
closes_at: Some(at(17)),
@@ -382,6 +391,7 @@ async fn facts_change_only_where_given_and_a_closing_time_can_be_cleared(pool: P
form.id,
&crate::domain::models::UpdateForm {
closes_at: Some(None),
+ accent_color: Some(None),
..crate::domain::models::UpdateForm::default()
},
at(11),
@@ -394,6 +404,14 @@ async fn facts_change_only_where_given_and_a_closing_time_can_be_cleared(pool: P
};
assert_eq!(cleared.closes_at, None);
assert_eq!(cleared.audience, Audience::Public);
+ assert_eq!(
+ cleared.branding,
+ FormBranding {
+ logo_file_id: Some(Uuid::from_u128(0x1060)),
+ cover_file_id: None,
+ accent_color: None,
+ }
+ );
let renamed = repo
.rename_form(form.id, "Offsite", at(12))
.await
diff --git a/crates/forms/src/outbound/pg_forms_repo/test/drafts.rs b/crates/forms/src/outbound/pg_forms_repo/test/drafts.rs
index 3d9c5ee4a9..8ff7a5ddd4 100644
--- a/crates/forms/src/outbound/pg_forms_repo/test/drafts.rs
+++ b/crates/forms/src/outbound/pg_forms_repo/test/drafts.rs
@@ -19,6 +19,7 @@ async fn a_projection_commits_its_layout_and_revision_together(pool: PgPool) {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "Thanks".into(),
+ branding: FormBranding::default(),
created_at: at(9),
updated_at: at(9),
is_hidden_in_drive: false,
diff --git a/crates/forms/src/outbound/static_file_images.rs b/crates/forms/src/outbound/static_file_images.rs
new file mode 100644
index 0000000000..37d9a8195b
--- /dev/null
+++ b/crates/forms/src/outbound/static_file_images.rs
@@ -0,0 +1,42 @@
+//! The files a form's branding shows, as the static-file service records
+//! them.
+
+use static_file_service_client::StaticFileServiceClient;
+use uuid::Uuid;
+
+use crate::domain::models::StoredImageFile;
+use crate::domain::ports::FormImageFiles;
+
+/// Reads file metadata through the static-file service's internal API.
+#[derive(Clone)]
+pub struct StaticFileFormImages {
+ client: StaticFileServiceClient,
+}
+
+impl StaticFileFormImages {
+ /// Read through `client`, authenticated with the internal key.
+ pub fn new(client: StaticFileServiceClient) -> Self {
+ Self { client }
+ }
+}
+
+/// The static-file service could not be read.
+#[derive(Debug, thiserror::Error)]
+#[error(transparent)]
+pub struct StaticFileImagesError(#[from] anyhow::Error);
+
+impl FormImageFiles for StaticFileFormImages {
+ type Error = StaticFileImagesError;
+
+ #[tracing::instrument(err, skip(self))]
+ async fn image_file(&self, file: Uuid) -> Result<Option<StoredImageFile>, Self::Error> {
+ Ok(self
+ .client
+ .get_file_metadata(&file.to_string())
+ .await?
+ .map(|metadata| StoredImageFile {
+ owner_id: metadata.owner_id,
+ content_type: metadata.content_type,
+ }))
+ }
+}
diff --git a/crates/forms/src/wiring.rs b/crates/forms/src/wiring.rs
index b912ff0704..3164d5ebcc 100644
--- a/crates/forms/src/wiring.rs
+++ b/crates/forms/src/wiring.rs
@@ -1,6 +1,6 @@
//! The one assembly of the forms service from its Postgres adapters, so
//! every host runs the same SQL; hosts supply the databases service, entity
-//! access, the liveness publisher and the broker.
+//! access, the liveness publisher, the broker and the static-file client.
use std::sync::Arc;
@@ -9,12 +9,14 @@ use databases::domain::ports::{DatabaseMetadataReads, DatabaseRowReads, Database
use entity_access::domain::ports::AccessibleForms;
use macro_event_broker::MacroEventBroker;
use sqlx::PgPool;
+use static_file_service_client::StaticFileServiceClient;
use crate::domain::ports::FormEventPublisher;
use crate::domain::service::FormsServiceImpl;
use crate::outbound::collaborative_layout::SurfaceFormDrafts;
use crate::outbound::entity_access_directory::EntityAccessFormDirectory;
use crate::outbound::pg_forms_repo::PgFormsRepo;
+use crate::outbound::static_file_images::StaticFileFormImages;
use crate::outbound::system_clock::SystemClock;
/// The service as every host builds it, over the host's already-built
@@ -27,11 +29,13 @@ pub type PgFormsService<Databases, EntityAccess, Events, Broker, Surfaces> = For
SystemClock,
Broker,
SurfaceFormDrafts<Surfaces>,
+ StaticFileFormImages,
>;
/// Build the forms service over `pool`, the host's databases service, its
/// entity access (for the forms catalog), the liveness publisher for open
-/// form pages, and the broker for `macro.forms`.
+/// form pages, the broker for `macro.forms`, and the static-file service
+/// for the images its branding shows.
pub fn build_service<Databases, EntityAccess, Events, Broker, Surfaces>(
pool: PgPool,
databases: Arc<Databases>,
@@ -39,6 +43,7 @@ pub fn build_service<Databases, EntityAccess, Events, Broker, Surfaces>(
events: Events,
broker: Broker,
surfaces: Arc<Surfaces>,
+ static_files: StaticFileServiceClient,
) -> PgFormsService<Databases, EntityAccess, Events, Broker, Surfaces>
where
Databases: DatabasesService + DatabaseRowReads + DatabaseMetadataReads,
@@ -55,5 +60,6 @@ where
SystemClock,
broker,
SurfaceFormDrafts::new(surfaces),
+ StaticFileFormImages::new(static_files),
)
}
diff --git a/crates/macro_db_client/migrations/20261102030000_add_form_branding.sql b/crates/macro_db_client/migrations/20261102030000_add_form_branding.sql
new file mode 100644
index 0000000000..88b3986a60
--- /dev/null
+++ b/crates/macro_db_client/migrations/20261102030000_add_form_branding.sql
@@ -0,0 +1,6 @@
+-- A form's branding: the static files shown as its logo and cover image,
+-- and the color of its buttons and selections. Unset means Macro's default.
+ALTER TABLE forms
+ ADD COLUMN logo_file_id UUID,
+ ADD COLUMN cover_file_id UUID,
+ ADD COLUMN accent_color TEXT CHECK (accent_color ~ '^#[0-9a-f]{6}$');
diff --git a/crates/models_forms/AGENTS.md b/crates/models_forms/AGENTS.md
index a214e6cfd8..f785e4ce3d 100644
--- a/crates/models_forms/AGENTS.md
+++ b/crates/models_forms/AGENTS.md
@@ -9,6 +9,8 @@ reuse `models_databases` cells, gate rules reuse its filters, unchanged.
## Start here
- `src/form.rs`: `Form`, `CreateForm`, `UpdateForm`, `Audience`, `FormStatus`.
+- `src/branding.rs`: `FormBranding` (logo, cover image, `AccentColor`), one
+ struct so it can be gated as a unit.
- `src/layout.rs`: `FormLayout`/`FormSection` — how a table's columns map to
form questions, including booking sections (`BookingTarget`).
- `src/response.rs`: `FormResponse`, `Answer`, tallying (`FormTally`,
diff --git a/crates/models_forms/Cargo.toml b/crates/models_forms/Cargo.toml
index 81bf0687a9..d16d986f39 100644
--- a/crates/models_forms/Cargo.toml
+++ b/crates/models_forms/Cargo.toml
@@ -12,6 +12,7 @@ schema = ["dep:schemars", "models_databases/schema"]
[dependencies]
schemars = { workspace = true, optional = true }
chrono = { workspace = true, features = ["serde"] }
+lazy-regex = { workspace = true }
macro_uuid = { path = "../macro_uuid" }
models_databases = { path = "../models_databases" }
serde = { workspace = true }
diff --git a/crates/models_forms/src/branding.rs b/crates/models_forms/src/branding.rs
new file mode 100644
index 0000000000..7428267912
--- /dev/null
+++ b/crates/models_forms/src/branding.rs
@@ -0,0 +1,83 @@
+//! How a form looks to respondents beyond its words: a logo, a cover image
+//! and an accent color. Every part is optional; a form with none looks like
+//! any other Macro page.
+
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+/// A form's logo, cover image and accent color, each unset by default.
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(
+ Debug, Clone, PartialEq, Eq, Default, Serialize, Deserialize, utoipa::ToSchema, specta::Type,
+)]
+#[serde(rename_all = "camelCase")]
+pub struct FormBranding {
+ /// The static file shown as the logo above the title.
+ #[schema(required = true)]
+ pub logo_file_id: Option<Uuid>,
+ /// The static file shown as a banner across the top of the page.
+ #[schema(required = true)]
+ pub cover_file_id: Option<Uuid>,
+ /// The color of the page's buttons and selected answers.
+ #[schema(required = true)]
+ pub accent_color: Option<AccentColor>,
+}
+
+/// A color as `#rrggbb`, kept in lowercase.
+#[derive(
+ Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize, utoipa::ToSchema, specta::Type,
+)]
+#[serde(try_from = "String", into = "String")]
+#[schema(value_type = String, pattern = "^#[0-9a-fA-F]{6}$")]
+#[specta(transparent)]
+pub struct AccentColor(String);
+
+/// A color that is not `#` and six hex digits.
+#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
+#[error("an accent color is # and six hex digits, like #1f6feb")]
+pub struct InvalidAccentColor;
+
+// The string's own schema, inlined, as a color is a string to its readers.
+#[cfg(feature = "schema")]
+impl schemars::JsonSchema for AccentColor {
+ fn inline_schema() -> bool {
+ <String as schemars::JsonSchema>::inline_schema()
+ }
+
+ fn schema_name() -> std::borrow::Cow<'static, str> {
+ <String as schemars::JsonSchema>::schema_name()
+ }
+
+ fn schema_id() -> std::borrow::Cow<'static, str> {
+ <String as schemars::JsonSchema>::schema_id()
+ }
+
+ fn json_schema(generator: &mut schemars::SchemaGenerator) -> schemars::Schema {
+ <String as schemars::JsonSchema>::json_schema(generator)
+ }
+}
+
+impl AccentColor {
+ /// The color as `#rrggbb`.
+ pub fn as_str(&self) -> &str {
+ &self.0
+ }
+}
+
+impl TryFrom<String> for AccentColor {
+ type Error = InvalidAccentColor;
+
+ fn try_from(color: String) -> Result<Self, Self::Error> {
+ if lazy_regex::regex_is_match!("^#[0-9a-fA-F]{6}$", &color) {
+ Ok(Self(color.to_ascii_lowercase()))
+ } else {
+ Err(InvalidAccentColor)
+ }
+ }
+}
+
+impl From<AccentColor> for String {
+ fn from(color: AccentColor) -> Self {
+ color.0
+ }
+}
diff --git a/crates/models_forms/src/error.rs b/crates/models_forms/src/error.rs
index c28c63d147..f25a90d307 100644
--- a/crates/models_forms/src/error.rs
+++ b/crates/models_forms/src/error.rs
@@ -70,6 +70,8 @@ pub enum FormErrorCode {
InvalidSharing,
/// The form's owner keeps its tallies from respondents.
TallyHidden,
+ /// A logo or cover image is not an image the caller uploaded.
+ InvalidBranding,
/// The table changed under the request; try again.
Conflict,
/// Something failed on the server.
diff --git a/crates/models_forms/src/form.rs b/crates/models_forms/src/form.rs
index 39b0c34da7..d3f87b6fd0 100644
--- a/crates/models_forms/src/form.rs
+++ b/crates/models_forms/src/form.rs
@@ -4,6 +4,7 @@ use chrono::{DateTime, Utc};
use models_databases::{ColumnId, DatabaseId, TableId};
use serde::{Deserialize, Deserializer, Serialize};
+use crate::branding::{AccentColor, FormBranding};
use crate::ids::FormId;
/// Who may respond to a form.
@@ -125,6 +126,8 @@ pub struct Form {
/// What a respondent reads once their response is saved; empty for the
/// default.
pub confirmation_message: String,
+ /// Its logo, cover image and accent color.
+ pub branding: FormBranding,
/// When it was created.
pub created_at: DateTime<Utc>,
/// When its facts or layout last changed.
@@ -184,8 +187,8 @@ pub enum FormSource {
},
}
-/// A change to a form's facts; what is left out stays. The description and
-/// confirmation message take edit, the rest owner. A form is renamed
+/// A change to a form's facts; what is left out stays. The description,
+/// confirmation message and branding take edit, the rest owner. A form is renamed
/// through the entity mutation router.
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
#[derive(
@@ -227,9 +230,41 @@ pub struct UpdateForm {
#[schema(nullable = false)]
#[specta(optional)]
pub tally_visible: Option<bool>,
+ /// A new logo, or `null` to remove it.
+ #[serde(
+ default,
+ deserialize_with = "present",
+ skip_serializing_if = "Option::is_none"
+ )]
+ #[schema(value_type = Option<Uuid>)]
+ #[specta(type = Option<uuid::Uuid>, optional)]
+ pub logo_file_id: Option<Option<uuid::Uuid>>,
+ /// A new cover image, or `null` to remove it.
+ #[serde(
+ default,
+ deserialize_with = "present",
+ skip_serializing_if = "Option::is_none"
+ )]
+ #[schema(value_type = Option<Uuid>)]
+ #[specta(type = Option<uuid::Uuid>, optional)]
+ pub cover_file_id: Option<Option<uuid::Uuid>>,
+ /// A new accent color, or `null` for the default.
+ #[serde(
+ default,
+ deserialize_with = "present",
+ skip_serializing_if = "Option::is_none"
+ )]
+ #[schema(value_type = Option<String>, pattern = "^#[0-9a-fA-F]{6}$")]
+ #[specta(type = Option<AccentColor>, optional)]
+ pub accent_color: Option<Option<AccentColor>>,
}
impl UpdateForm {
+ /// Whether the change touches the form's branding.
+ pub fn changes_branding(&self) -> bool {
+ self.logo_file_id.is_some() || self.cover_file_id.is_some() || self.accent_color.is_some()
+ }
+
/// Whether the change touches a fact only the owner may change.
pub fn needs_owner(&self) -> bool {
self.audience.is_some()
diff --git a/crates/models_forms/src/lib.rs b/crates/models_forms/src/lib.rs
index 5976f9ed21..c061d65641 100644
--- a/crates/models_forms/src/lib.rs
+++ b/crates/models_forms/src/lib.rs
@@ -4,6 +4,7 @@
//! a view of one database table, so answers are `models_databases` cells and
//! gate rules are `models_databases` filters.
+mod branding;
mod collaboration;
mod detail;
mod error;
@@ -15,6 +16,7 @@ mod response;
mod test;
mod widget;
+pub use branding::{AccentColor, FormBranding, InvalidAccentColor};
pub use collaboration::{FormCollaboration, FormPublicationProblem};
pub use detail::{FormDetail, FormQuestionDetail, FormSectionDetail, QuestionOption};
pub use error::{FormErrorCode, FormErrorResponse, LayoutProblem};
diff --git a/crates/models_forms/src/test.rs b/crates/models_forms/src/test.rs
index ff10ba7715..6c8909bf14 100644
--- a/crates/models_forms/src/test.rs
+++ b/crates/models_forms/src/test.rs
@@ -57,6 +57,7 @@ fn a_form_detail_reads_as_the_web_client_expects() {
status: FormStatus::Open,
closes_at: Some(Utc.with_ymd_and_hms(2026, 10, 3, 17, 0, 0).unwrap()),
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: Utc.with_ymd_and_hms(2026, 9, 1, 9, 0, 0).unwrap(),
updated_at: Utc.with_ymd_and_hms(2026, 9, 2, 9, 0, 0).unwrap(),
is_hidden_in_drive: false,
@@ -119,6 +120,7 @@ fn a_form_detail_reads_as_the_web_client_expects() {
"status": "open",
"closesAt": "2026-10-03T17:00:00Z",
"confirmationMessage": "",
+ "branding": { "logoFileId": null, "coverFileId": null, "accentColor": null },
"createdAt": "2026-09-01T09:00:00Z",
"updatedAt": "2026-09-02T09:00:00Z",
"isHiddenInDrive": false,
@@ -409,6 +411,7 @@ fn a_form_takes_responses_while_open_and_before_it_closes() {
status,
closes_at,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: now,
updated_at: now,
is_hidden_in_drive: false,
@@ -439,6 +442,7 @@ fn a_listed_form_names_the_callers_access_beside_the_form() {
status: FormStatus::Closed,
closes_at: None,
confirmation_message: "Thanks".into(),
+ branding: FormBranding::default(),
created_at: now,
updated_at: now,
is_hidden_in_drive: false,
@@ -462,6 +466,7 @@ fn a_listed_form_names_the_callers_access_beside_the_form() {
"status": "closed",
"closesAt": null,
"confirmationMessage": "Thanks",
+ "branding": { "logoFileId": null, "coverFileId": null, "accentColor": null },
"createdAt": "2026-09-01T09:00:00Z",
"updatedAt": "2026-09-01T09:00:00Z",
"isHiddenInDrive": false,
@@ -528,6 +533,7 @@ fn form_and_response_schemas_require_every_field_they_always_serialize() {
status: FormStatus::Open,
closes_at: None,
confirmation_message: "".into(),
+ branding: FormBranding::default(),
created_at: now,
updated_at: now,
is_hidden_in_drive: false,
@@ -562,3 +568,96 @@ fn form_and_response_schemas_require_every_field_they_always_serialize() {
}
}
}
+
+#[test]
+fn a_form_sends_its_branding_with_its_facts() {
+ let now = Utc.with_ymd_and_hms(2026, 9, 1, 9, 0, 0).unwrap();
+ let form = Form {
+ id: FORM,
+ name: "Site intake".into(),
+ description: "".into(),
+ owner_id: "macro|[email protected]".into(),
+ database_id: DATABASE,
+ table_id: TABLE,
+ submitted_column_id: None,
+ respondent_column_id: None,
+ audience: Audience::Public,
+ tally_visible: false,
+ status: FormStatus::Open,
+ closes_at: None,
+ confirmation_message: "".into(),
+ branding: FormBranding {
+ logo_file_id: Some(Uuid::from_u128(0x10)),
+ cover_file_id: None,
+ accent_color: Some(AccentColor::try_from("#1F6FEB".to_string()).unwrap()),
+ },
+ created_at: now,
+ updated_at: now,
+ is_hidden_in_drive: false,
+ };
+ assert_eq!(
+ serde_json::to_value(&form).unwrap()["branding"],
+ json!({
+ "logoFileId": "00000000-0000-0000-0000-000000000010",
+ "coverFileId": null,
+ "accentColor": "#1f6feb",
+ })
+ );
+ let schema = serde_json::to_value(<FormBranding as utoipa::PartialSchema>::schema()).unwrap();
+ let required = schema["required"].as_array().unwrap();
+ for field in ["logoFileId", "coverFileId", "accentColor"] {
+ assert!(
+ required.contains(&json!(field)),
+ "missing required field {field}"
+ );
+ }
+}
+
+#[test]
+fn an_accent_color_is_six_hex_digits_after_a_hash() {
+ for accepted in ["#000000", "#ffffff", "#1F6FEB"] {
+ assert!(
+ AccentColor::try_from(accepted.to_string()).is_ok(),
+ "{accepted}"
+ );
+ }
+ for refused in [
+ "",
+ "#fff",
+ "1f6feb",
+ "#1f6feb00",
+ "#1g6feb",
+ "red",
+ " #1f6feb",
+ ] {
+ assert!(
+ AccentColor::try_from(refused.to_string()).is_err(),
+ "{refused}"
+ );
+ }
+}
+
+#[test]
+fn a_branding_change_sets_clears_or_keeps_each_part() {
+ let update: UpdateForm = serde_json::from_value(json!({
+ "logoFileId": "00000000-0000-0000-0000-000000000010",
+ "coverFileId": null,
+ "accentColor": "#ABCDEF",
+ }))
+ .unwrap();
+ assert_eq!(update.logo_file_id, Some(Some(Uuid::from_u128(0x10))));
+ assert_eq!(update.cover_file_id, Some(None));
+ assert_eq!(
+ update.accent_color,
+ Some(Some(AccentColor::try_from("#abcdef".to_string()).unwrap()))
+ );
+ assert!(update.changes_branding());
+ assert!(!update.needs_owner());
+
+ let untouched: UpdateForm = serde_json::from_value(json!({ "description": "Hi" })).unwrap();
+ assert_eq!(untouched.logo_file_id, None);
+ assert_eq!(untouched.accent_color, None);
+ assert!(!untouched.changes_branding());
+
+ assert!(serde_json::from_value::<UpdateForm>(json!({ "accentColor": "blue" })).is_err());
+}
diff --git a/docs/agent-guide/forms.md b/docs/agent-guide/forms.md
index 4506015920..7f028edec0 100644
--- a/docs/agent-guide/forms.md
+++ b/docs/agent-guide/forms.md
@@ -135,8 +135,14 @@ submitting are not recorded; answers stay in the browser until Submit.
**Who can respond**: Invited people (sign in, one response each, editable
while open) or Anyone with the link (anonymous; no file questions). The
respond link with Copy, Accepting responses, Close automatically, Show results
-to respondents, Confirmation message, and **Manage access** (the share dialog,
-which also shows the audience panel). Anyone with the link: visitors who aren't signed in respond anonymously;
+to respondents, Confirmation message, **Branding**, and **Manage access** (the
+share dialog, which also shows the audience panel). Branding (editors) sets a
+logo (**Upload**/**Replace**/**Remove**, shown above the title), a cover image
+(a banner across the top of the respond page) and an accent color (color
+swatch or `#rrggbb` field, **Reset** for Macro's accent) that colors the
+respond page's buttons and selected answers. Images must be PNG, JPEG,
+WebP or GIF uploaded by the person setting them; nothing set keeps Macro's
+look, and inline form cards in channels never show branding. Anyone with the link: visitors who aren't signed in respond anonymously;
people signed in to Macro respond as themselves. Roles: View can respond; Edit can change
questions and also edits the linked database (its response rows and columns)
through derived access; Owner can also change the audience, close and trash.
@@ -162,7 +168,8 @@ it inside the app shell (sidebar, command menu); anonymous visitors get a
focused page, so a public form never hits login. Signed in, a respondent
keeps their identity on either audience and can edit their response while the
form is open; anonymous visitors cannot. The response page has no top bar:
-it uses the builder’s centered 768px content column, plain title and description,
+it uses the builder’s centered 768px content column, the form's cover image and
+logo when set, plain title and description,
and questions grouped within a single section card. Public sign-in guidance
sits below the form. One section per screen with
**Back / Next**, **Submit** on the last. Required fields keep their asterisks;
diff --git a/packages/sdk-docs/reference/generated/storage/types.gen/README.md b/packages/sdk-docs/reference/generated/storage/types.gen/README.md
index 3a6ec38b25..ded6d4c723 100644
--- a/packages/sdk-docs/reference/generated/storage/types.gen/README.md
+++ b/packages/sdk-docs/reference/generated/storage/types.gen/README.md
@@ -2,6 +2,7 @@
## Type Aliases
+- [AccentColor](type-aliases/AccentColor.md)
- [AccessiblePipeline](type-aliases/AccessiblePipeline.md)
- [AccessLevel](type-aliases/AccessLevel.md)
- [AccessRequest](type-aliases/AccessRequest.md)
@@ -840,6 +841,7 @@
- [ForeignEntityFilters](type-aliases/ForeignEntityFilters.md)
- [Form](type-aliases/Form.md)
- [FormAccess](type-aliases/FormAccess.md)
+- [FormBranding](type-aliases/FormBranding.md)
- [FormCollaboration](type-aliases/FormCollaboration.md)
- [FormDetail](type-aliases/FormDetail.md)
- [FormErrorCode](type-aliases/FormErrorCode.md)
diff --git a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/AccentColor.md b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/AccentColor.md
new file mode 100644
index 0000000000..ff73f32a23
--- /dev/null
+++ b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/AccentColor.md
@@ -0,0 +1,5 @@
+# Type Alias: AccentColor
+
+> **AccentColor** = `string`
+
+A color as `#rrggbb`, kept in lowercase.
diff --git a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/Form.md b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/Form.md
index 4b7ba403c9..1be6b77c99 100644
--- a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/Form.md
+++ b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/Form.md
@@ -1,6 +1,6 @@
# Type Alias: Form
-> **Form** = \{ `audience`: [`Audience`](Audience.md); `closesAt`: `string` \| `null`; `confirmationMessage`: `string`; `createdAt`: `string`; `databaseId`: `string`; `description`: `string`; `id`: `string`; `isHiddenInDrive`: `boolean`; `name`: `string`; `ownerId`: `string`; `respondentColumnId`: `string` \| `null`; `status`: [`FormStatus`](FormStatus.md); `submittedColumnId`: `string` \| `null`; `tableId`: `string`; `tallyVisible`: `boolean`; `updatedAt`: `string`; \}
+> **Form** = \{ `audience`: [`Audience`](Audience.md); `branding`: [`FormBranding`](FormBranding.md); `closesAt`: `string` \| `null`; `confirmationMessage`: `string`; `createdAt`: `string`; `databaseId`: `string`; `description`: `string`; `id`: `string`; `isHiddenInDrive`: `boolean`; `name`: `string`; `ownerId`: `string`; `respondentColumnId`: `string` \| `null`; `status`: [`FormStatus`](FormStatus.md); `submittedColumnId`: `string` \| `null`; `tableId`: `string`; `tallyVisible`: `boolean`; `updatedAt`: `string`; \}
A form: a view of one database table whose rows are its responses.
@@ -9,6 +9,7 @@ A form: a view of one database table whose rows are its responses.
| Property | Type | Description |
| ------ | ------ | ------ |
| <a id="property-audience"></a> `audience` | [`Audience`](Audience.md) | Who may respond. |
+| <a id="property-branding"></a> `branding` | [`FormBranding`](FormBranding.md) | Its logo, cover image and accent color. |
| <a id="property-closesat"></a> `closesAt` | `string` \| `null` | When it stops taking responses, if it does. |
| <a id="property-confirmationmessage"></a> `confirmationMessage` | `string` | What a respondent reads once their response is saved; empty for the default. |
| <a id="property-createdat"></a> `createdAt` | `string` | When it was created. |
diff --git a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormBranding.md b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormBranding.md
new file mode 100644
index 0000000000..886e08f1af
--- /dev/null
+++ b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormBranding.md
@@ -0,0 +1,13 @@
+# Type Alias: FormBranding
+
+> **FormBranding** = \{ `accentColor`: `null` \| [`AccentColor`](AccentColor.md); `coverFileId`: `string` \| `null`; `logoFileId`: `string` \| `null`; \}
+
+A form's logo, cover image and accent color, each unset by default.
+
+## Properties
+
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="property-accentcolor"></a> `accentColor` | `null` \| [`AccentColor`](AccentColor.md) | - |
+| <a id="property-coverfileid"></a> `coverFileId` | `string` \| `null` | The static file shown as a banner across the top of the page. |
+| <a id="property-logofileid"></a> `logoFileId` | `string` \| `null` | The static file shown as the logo above the title. |
diff --git a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormErrorCode.md b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormErrorCode.md
index 2f9a57c5cc..11c0055412 100644
--- a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormErrorCode.md
+++ b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/FormErrorCode.md
@@ -1,5 +1,5 @@
# Type Alias: FormErrorCode
-> **FormErrorCode** = `"tableAlreadyHasForm"` \| `"notFound"` \| `"forbidden"` \| `"ownerOnly"` \| `"signInRequired"` \| `"closed"` \| `"tableGone"` \| `"alreadyResponded"` \| `"noResponse"` \| `"unknownQuestion"` \| `"repeatedAnswer"` \| `"missingAnswer"` \| `"invalidAnswer"` \| `"widgetMismatch"` \| `"fileUploadNeedsSignIn"` \| `"invalidLayout"` \| `"invalidName"` \| `"invalidSharing"` \| `"tallyHidden"` \| `"conflict"` \| `"internal"`
+> **FormErrorCode** = `"tableAlreadyHasForm"` \| `"notFound"` \| `"forbidden"` \| `"ownerOnly"` \| `"signInRequired"` \| `"closed"` \| `"tableGone"` \| `"alreadyResponded"` \| `"noResponse"` \| `"unknownQuestion"` \| `"repeatedAnswer"` \| `"missingAnswer"` \| `"invalidAnswer"` \| `"widgetMismatch"` \| `"fileUploadNeedsSignIn"` \| `"invalidLayout"` \| `"invalidName"` \| `"invalidSharing"` \| `"tallyHidden"` \| `"invalidBranding"` \| `"conflict"` \| `"internal"`
What went wrong with a forms request.
diff --git a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/UpdateForm.md b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/UpdateForm.md
index d7413524ca..d403392d9a 100644
--- a/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/UpdateForm.md
+++ b/packages/sdk-docs/reference/generated/storage/types.gen/type-aliases/UpdateForm.md
@@ -1,18 +1,21 @@
# Type Alias: UpdateForm
-> **UpdateForm** = \{ `audience?`: [`Audience`](Audience.md); `closesAt?`: `string` \| `null`; `confirmationMessage?`: `string`; `description?`: `string`; `status?`: [`FormStatus`](FormStatus.md); `tallyVisible?`: `boolean`; \}
+> **UpdateForm** = \{ `accentColor?`: `string` \| `null`; `audience?`: [`Audience`](Audience.md); `closesAt?`: `string` \| `null`; `confirmationMessage?`: `string`; `coverFileId?`: `string` \| `null`; `description?`: `string`; `logoFileId?`: `string` \| `null`; `status?`: [`FormStatus`](FormStatus.md); `tallyVisible?`: `boolean`; \}
-A change to a form's facts; what is left out stays. The description and
-confirmation message take edit, the rest owner. A form is renamed
+A change to a form's facts; what is left out stays. The description,
+confirmation message and branding take edit, the rest owner. A form is renamed
through the entity mutation router.
## Properties
| Property | Type | Description |
| ------ | ------ | ------ |
+| <a id="property-accentcolor"></a> `accentColor?` | `string` \| `null` | A new accent color, or `null` for the default. |
| <a id="property-audience"></a> `audience?` | [`Audience`](Audience.md) | Who may respond from now on. |
| <a id="property-closesat"></a> `closesAt?` | `string` \| `null` | When it stops taking responses, or `null` for never. |
| <a id="property-confirmationmessage"></a> `confirmationMessage?` | `string` | Its new confirmation message. |
+| <a id="property-coverfileid"></a> `coverFileId?` | `string` \| `null` | A new cover image, or `null` to remove it. |
| <a id="property-description"></a> `description?` | `string` | Its new description. |
+| <a id="property-logofileid"></a> `logoFileId?` | `string` \| `null` | A new logo, or `null` to remove it. |
| <a id="property-status"></a> `status?` | [`FormStatus`](FormStatus.md) | Open or close it. |
| <a id="property-tallyvisible"></a> `tallyVisible?` | `boolean` | Whether respondents may read option tallies. |
diff --git a/packages/sdk/generated/storage/index.ts b/packages/sdk/generated/storage/index.ts
index 37f21f0554..c9f72a104e 100644
--- a/packages/sdk/generated/storage/index.ts
+++ b/packages/sdk/generated/storage/index.ts
@@ -1,4 +1,4 @@
// This file is auto-generated by @hey-api/openapi-ts
export { type Options, Sdk } from './sdk.gen';
-export type { AccessiblePipeline, AccessLevel, AccessRequest, AccessRequestsCancelData, AccessRequestsCancelErrors, AccessRequestsCancelResponses, AccessRequestsDirectData, AccessRequestsDirectErrors, AccessRequestsDirectResponse, AccessRequestsDirectResponses, AccessRequestsRemoveDirectData, AccessRequestsRemoveDirectErrors, AccessRequestsRemoveDirectResponses, AccessRequestsResolveData, AccessRequestsResolveErrors, AccessRequestsResolveResponse, AccessRequestsResolveResponses, AccessRequestsSetDirectData, AccessRequestsSetDirectErrors, AccessRequestsSetDirectResponses, AccessRequestsStateData, AccessRequestsStateErrors, AccessRequestsStateResponse, AccessRequestsStateResponses, AccessRequestsSubmitData, AccessRequestsSubmitErrors, AccessRequestsSubmitResponse, AccessRequestsSubmitResponses, AccessRequestState, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentDmProfile, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionFilters, AgentSessionLifecycleEvent, AgentSessionSource, AgentSessionVisibility, AgentTyping, AgentTypingPhase, Anchor, AnchorId, AnchorResponse, AnnotationIncrementalUpdate, Answer, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentCommentReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, AppliedOps, ApplyCrmPipelineOpsData, ApplyCrmPipelineOpsResponse, ApplyCrmPipelineOpsResponses, ApplyDatabaseOpsData, ApplyDatabaseOpsError, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponse, ApplyDatabaseOpsResponses, ApplyOpsRequest, ApplyOpsResponse, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AttachmentChange, AttendeeResponseStatus, Audience, Awareness, AwarenessRelay, BasicDocument, BasicDocumentSubType, BomPart, BookingTarget, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarJoinRequest, CalendarJoinRequestApiError, CalendarJoinRequestErrorCode, CalendarJoinRequestsResponse, CalendarJoinRequestStatus, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarMentionViewerCopy, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallFilters, CallProvider, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordSource, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponse, CancelSlackImportResponses, CardPosition, CastVerdict, CellValue, CellWrite, ChangedFileDto, ChangesetDto, ChangesetSourceDto, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelScopeSelection, ChannelLabelsList, ChannelMessage, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPictureChangedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollaborateFormData, CollaborateFormError, CollaborateFormErrors, CollaborateFormResponse, CollaborateFormResponses, CollabSurfaceResponse, CollabSurfaceTokenResponse, Column, ColumnCast, ColumnChange, ColumnChangeKind, ColumnConfig, ColumnConversion, ColumnConversionRequest, ColumnDetail, ColumnId, ColumnKind, ColumnProtection, ColumnResult, CommandFailure, CommandRejectedMetadata, CommittedChange, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponse, CompleteSlackImportUploadsResponses, CompleteUploads, ConferenceProvider, Conjunction, ConversationId, ConversationKind, ConversationMetadata, ConversationProgress, ConversationSeal, ConversationStatus, ConvertDatabaseColumnData, ConvertDatabaseColumnError, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponse, ConvertDatabaseColumnResponses, ConvertedCell, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateCanvasDocumentRequest, CreateCanvasDocumentResponse, CreateCanvasHandlerData, CreateCanvasHandlerError, CreateCanvasHandlerErrors, CreateCanvasHandlerResponse, CreateCanvasHandlerResponses, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateCrmPipelineData, CreateCrmPipelineResponse, CreateCrmPipelineResponses, CreateDatabaseData, CreateDatabaseError, CreateDatabaseErrors, CreateDatabaseRequest, CreateDatabaseResponse, CreateDatabaseResponses, CreateDatabaseWebhookData, CreateDatabaseWebhookError, CreateDatabaseWebhookErrors, CreateDatabaseWebhookRequest, CreateDatabaseWebhookResponse, CreateDatabaseWebhookResponses, CreatedDatabaseWebhookResponse, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateForm, CreateFormData, CreateFormError, CreateFormErrors, CreateFormResponse, CreateFormResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateImport, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreatePipeline, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponse, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateToken, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmAssociation, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, Database, DatabaseDetail, DatabaseId, DatabaseOp, DatabaseQueryRequest, DatabaseView, DatabaseWebhookDeliveryResponse, DatabaseWebhookPayloadProblem, DatabaseWebhookResponse, DataType, DateOperator, DateRange, DateRangeOperator, DeclineCallData, DeclineCallError, DeclineCallErrors, DeclineCallResponse, DeclineCallResponses, DeclineRingData, DeclineRingError, DeclineRingErrors, DeclineRingResponse, DeclineRingResponses, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteDatabaseWebhookData, DeleteDatabaseWebhookError, DeleteDatabaseWebhookErrors, DeleteDatabaseWebhookResponse, DeleteDatabaseWebhookResponses, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DeliverDatabaseWebhookData, DeliverDatabaseWebhookError, DeliverDatabaseWebhookErrors, DeliverDatabaseWebhookResponse, DeliverDatabaseWebhookResponses, DirectAccess, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTextContent, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditMyFormResponseData, EditMyFormResponseError, EditMyFormResponseErrors, EditMyFormResponseResponse, EditMyFormResponseResponses, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmailReminderPage, EmailReminderSummary, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponse, EnsureStarterHandlerResponses, EntityFilters, EntityKind, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityRef, EntityReference, EntityType, ErrorResponse, EventIcsData, EventIcsErrors, EventIcsResponse, EventIcsResponses, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, ExternalChatAdd, ExternalChatAddData, ExternalChatAdded, ExternalChatAddResponse, ExternalChatAddResponses, ExternalChatAttachment, ExternalChatAttachmentState, ExternalChatBackfill, ExternalChatBackfillState, ExternalChatCall, ExternalChatCallOutcome, ExternalChatCapabilities, ExternalChatCommunity, ExternalChatContactCard, ExternalChatContacts, ExternalChatData, ExternalChatDeliveryData, ExternalChatDeliveryResponse, ExternalChatDeliveryResponses, ExternalChatDeliveryState, ExternalChatDetail, ExternalChatEvent, ExternalChatKind, ExternalChatLocation, ExternalChatMediaKind, ExternalChatMediaPresentation, ExternalChatMembers, ExternalChatMention, ExternalChatMessage, ExternalChatMessageAttachments, ExternalChatMessageAttachmentsData, ExternalChatMessageAttachmentsResponse, ExternalChatMessageAttachmentsResponses, ExternalChatMessageData, ExternalChatMessageKind, ExternalChatMessageResponse, ExternalChatMessageResponses, ExternalChatMessages, ExternalChatMessagesData, ExternalChatMessagesResponse, ExternalChatMessagesResponses, ExternalChatMutation, ExternalChatParticipant, ExternalChatPermissionsData, ExternalChatPermissionsResponse, ExternalChatPermissionsResponses, ExternalChatPersonRef, ExternalChatPoll, ExternalChatPollOption, ExternalChatProvider, ExternalChatReaction, ExternalChatReadData, ExternalChatReadResponse, ExternalChatReadResponses, ExternalChatReference, ExternalChatRemoveData, ExternalChatRemoveResponse, ExternalChatRemoveResponses, ExternalChatReplyBlock, ExternalChatReplyContent, ExternalChatResponse, ExternalChatResponses, ExternalChatRichContent, ExternalChatsData, ExternalChatSendData, ExternalChatSender, ExternalChatSendErrors, ExternalChatSendProgress, ExternalChatSendReply, ExternalChatSendResponse, ExternalChatSendResponses, ExternalChatSendsData, ExternalChatSendsResponse, ExternalChatSendsResponses, ExternalChatsResponse, ExternalChatsResponses, ExternalChatSummary, ExternalChatSystemAction, ExternalChatSystemLine, ExternalChatUpdatePermissionsData, ExternalChatUpdatePermissionsResponse, ExternalChatUpdatePermissionsResponses, ExternalChatUploadData, ExternalChatUploadedAttachment, ExternalChatUploadRequest, ExternalChatUploadResponse, ExternalChatUploadResponses, Favorite, FavoriteEntityRef, FavoritesList, FileChangeKindDto, FileSystemNodeWithIds, FileType, FileTypeUpdate, FilterCondition, FilterGroup, FilterNode, FilterTest, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponse, FinalizeSlackImportResponses, FolderItem, FollowupState, ForeignEntity, ForeignEntityFilters, Form, FormAccess, FormCollaboration, FormDetail, FormErrorCode, FormErrorResponse, FormLayout, FormPublicationProblem, FormQuestionDetail, FormResponse, FormSection, FormSectionDetail, FormSource, FormStatus, FormTally, Formula, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmPipelineData, GetCrmPipelinePermissionsData, GetCrmPipelinePermissionsResponse, GetCrmPipelinePermissionsResponses, GetCrmPipelineResponse, GetCrmPipelineResponses, GetCrmPipelineRowsData, GetCrmPipelineRowsResponse, GetCrmPipelineRowsResponses, GetCrmPipelineTableData, GetCrmPipelineTableResponse, GetCrmPipelineTableResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseError, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsError, GetDatabasePermissionsErrors, GetDatabasePermissionsResponse, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryError, GetDatabaseQueryErrors, GetDatabaseQueryResponse, GetDatabaseQueryResponses, GetDatabaseResponse, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryError, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponse, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesError, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponse, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsError, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponse, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentTextContentData, GetDocumentTextContentErrors, GetDocumentTextContentResponse, GetDocumentTextContentResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetFormData, GetFormError, GetFormErrors, GetFormPermissionsData, GetFormPermissionsError, GetFormPermissionsErrors, GetFormPermissionsResponse, GetFormPermissionsResponses, GetFormResponse, GetFormResponses, GetFormResponseSummaryData, GetFormResponseSummaryError, GetFormResponseSummaryErrors, GetFormResponseSummaryResponse, GetFormResponseSummaryResponses, GetFormTallyData, GetFormTallyError, GetFormTallyErrors, GetFormTallyResponse, GetFormTallyResponses, GetGithubPullRequestChangesData, GetGithubPullRequestChangesError, GetGithubPullRequestChangesErrors, GetGithubPullRequestChangesPatchData, GetGithubPullRequestChangesPatchError, GetGithubPullRequestChangesPatchErrors, GetGithubPullRequestChangesPatchResponse, GetGithubPullRequestChangesPatchResponses, GetGithubPullRequestChangesResponse, GetGithubPullRequestChangesResponses, GetGithubPullRequestData, GetGithubPullRequestError, GetGithubPullRequestErrors, GetGithubPullRequestFacetsData, GetGithubPullRequestFacetsError, GetGithubPullRequestFacetsErrors, GetGithubPullRequestFacetsResponse, GetGithubPullRequestFacetsResponses, GetGithubPullRequestResponse, GetGithubPullRequestResponses, GetGithubPullRequestTasksData, GetGithubPullRequestTasksError, GetGithubPullRequestTasksErrors, GetGithubPullRequestTasksResponse, GetGithubPullRequestTasksResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMyFormResponseData, GetMyFormResponseError, GetMyFormResponseErrors, GetMyFormResponseResponse, GetMyFormResponseResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponse, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubLabelFacet, GithubPullRequest, GithubPullRequestChangesPatchResponse, GithubPullRequestChangesResponse, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestFacets, GithubPullRequestLabel, GithubPullRequestReview, GithubPullRequestReviewDecision, GithubPullRequestReviewState, GithubPullRequestsResponse, GithubPullRequestTasks, GithubPullRequestTasksRequest, GithubPullRequestTasksResponse, GithubPullRequestUser, GithubRepositoryFacet, GithubUserFacet, GitRefDto, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestCallChatPostData, GuestCallChatPostErrors, GuestCallChatPostResponse, GuestCallChatPostResponses, GuestCallChatReadData, GuestCallChatReadErrors, GuestCallChatReadResponse, GuestCallChatReadResponses, GuestChatMessage, GuestChatPage, GuestChatPost, GuestId, GuestJoinRequest, GuestPolicy, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportCounters, ImportDatabaseTableData, ImportDatabaseTableError, ImportDatabaseTableErrors, ImportDatabaseTableResponse, ImportDatabaseTableResponses, ImportedAuthor, ImportError, ImportLimits, ImportPage, ImportProgress, ImportTable, ImportWarning, InferColumnTypeOutcome, InferColumnTypeRequest, InferDatabaseColumnTypeData, InferDatabaseColumnTypeError, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponse, InferDatabaseColumnTypeResponses, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InvalidDatabaseWebhookPayloadResponse, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobId, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JobStatus, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, KeySegment, Lane, LaneKey, LatestMessage, LayoutProblem, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAccessibleFormsData, ListAccessibleFormsError, ListAccessibleFormsErrors, ListAccessibleFormsResponse, ListAccessibleFormsResponses, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmPipelinesData, ListCrmPipelinesResponse, ListCrmPipelinesResponses, ListDatabaseColumnCastsData, ListDatabaseColumnCastsError, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponse, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesError, ListDatabasesErrors, ListDatabasesResponse, ListDatabasesResponses, ListDatabaseWebhooksData, ListDatabaseWebhooksError, ListDatabaseWebhooksErrors, ListDatabaseWebhooksResponse, ListDatabaseWebhooksResponse2, ListDatabaseWebhooksResponses, ListedDatabase, ListedForm, ListEmailRemindersData, ListEmailRemindersError, ListEmailRemindersErrors, ListEmailRemindersResponse, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListFormsData, ListFormsError, ListFormsErrors, ListFormsResponse, ListFormsResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListJoinRequestsData, ListJoinRequestsError, ListJoinRequestsErrors, ListJoinRequestsResponse, ListJoinRequestsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListSlackImportsData, ListSlackImportsResponse, ListSlackImportsResponses, ListTeamCalendarData, ListTeamCalendarResponse, ListTeamCalendarResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, MarkRead, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineEntriesData, MessageTimelineEntriesResponse, MessageTimelineEntriesResponses, MessageTimelineEntry, MessageTimelinePage, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, MyResponse, NewAttachment, NewColumn, NewOption, NewThreadAnchor, NewView, NotificationFilters, NotificationState, NumberOperator, OpBatch, Operator, OpRefusalResponse, OpResult, OptionId, OptionRef, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, Pipeline, PipelineRecordType, PipelineSharing, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresenceOperator, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyBucketing, PropertyDateFilterRange, PropertyDateRange, PropertyDateRanges, PropertyDefinition, PropertyDefinitionWithOptions, PropertyFilter, PropertyInput, PropertyOption, PropertyOptionValue, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, PutFormLayoutData, PutFormLayoutError, PutFormLayoutErrors, PutFormLayoutResponse, PutFormLayoutResponses, QueryCrmPipelineRowsData, QueryCrmPipelineRowsResponse, QueryCrmPipelineRowsResponses, QueryDatabasesData, QueryDatabasesError, QueryDatabasesErrors, QueryDatabasesResponse, QueryDatabasesResponses, QueryDefinition, QuestionLayout, QuestionOption, QuestionTally, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponse, RegisterSlackImportUploadsResponses, RegisterUploads, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, RenameCrmPipelineData, RenameCrmPipelineResponse, RenameCrmPipelineResponses, RenamePipeline, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestAccess, RequestedHarnessScope, RequestedLayout, RequestStatus, RequestToJoinData, RequestToJoinError, RequestToJoinErrors, RequestToJoinResponse, RequestToJoinResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveRequest, ResponseStatus, ResponseSummary, ResultColumn, ResultSet, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, RowChange, RowChangeKind, RowChanges, RowHistoryEntry, RowHistoryResponse, RowId, RowsChange, RowsResult, S3ObjectInfo, SaveBomPart, SaveDatabaseQueryData, SaveDatabaseQueryError, SaveDatabaseQueryErrors, SaveDatabaseQueryResponse, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SavedQuery, SaveQueryRequest, SearchContactsData, SearchContactsError, SearchContactsErrors, SearchContactsResponse, SearchContactsResponse2, SearchContactsResponses, SearchState, SectionCount, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionSource, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDirectAccess, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetOperator, SetPropertyValue, Sha256Digest, ShareCrmPipelineData, ShareCrmPipelineResponse, ShareCrmPipelineResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessError, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponse, ShareDatabaseAwarenessResponses, SharedEmailFilter, SharedExternalChatReference, ShareEntity, ShareEntityType, SharePermissionV2, SharePipeline, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SkippedCell, SlackCompleteRequest, SlackCreateRequest, SlackRegisterRequest, SlackTimestamp, SlackUserId, SmartTagChannelMatch, SmartTagPreview, SortDirection, SortKey, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmContactSoupPropertiesField, SoupCrmDomain, SoupDatabaseRowSoupPropertiesField, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupThreadInfo, SoupThreadReply, SourceBinding, SourceId, SourceIdentity, SqlCell, SqlEntityKind, SqlOutcome, SqlOutcomeKind, SqlSelectOption, SqlStatement, StarterDatabase, StarterDocumentsResponse, StorageRow, StorageRows, StorageRowsQuery, StoredGithubPullRequest, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, Submission, SubmissionOutcome, SubmitFormResponseData, SubmitFormResponseError, SubmitFormResponseErrors, SubmitFormResponseResponse, SubmitFormResponseResponses, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, Table, TableChange, TableChanged, TableChanges, TableDetail, TableId, TableResult, TableVersion, TagFilterMode, TakenId, TallyBucket, TallyValue, TaskFilters, TaskSimilarityResult, TaskSimilaritySearchHandlerData, TaskSimilaritySearchHandlerError, TaskSimilaritySearchHandlerErrors, TaskSimilaritySearchHandlerResponse, TaskSimilaritySearchHandlerResponses, TaskSimilaritySearchRequest, TaskSimilaritySearchResponse, TeamCalendarContent, TeamCalendarCoverage, TeamCalendarDetails, TeamCalendarItem, TeamCalendarMember, TeamCalendarPage, TeamCalendarSharing, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, TextOperator, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, TimelineActivity, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TouchedColumn, TouchedRow, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TrashCrmPipelineData, TrashCrmPipelineResponse, TrashCrmPipelineResponses, TrashPipeline, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UndoChangeResponse, UndoDatabaseChangeData, UndoDatabaseChangeError, UndoDatabaseChangeErrors, UndoDatabaseChangeResponse, UndoDatabaseChangeResponses, UndoOutcome, UndoRefusal, UnlockedBooking, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmPipelinePermissionsData, UpdateCrmPipelinePermissionsResponse, UpdateCrmPipelinePermissionsResponses, UpdateCrmTeamSettingsRequest, UpdateDatabasePermissionsData, UpdateDatabasePermissionsError, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponse, UpdateDatabasePermissionsResponses, UpdateForm, UpdateFormData, UpdateFormError, UpdateFormErrors, UpdateFormPermissionsData, UpdateFormPermissionsError, UpdateFormPermissionsErrors, UpdateFormPermissionsResponse, UpdateFormPermissionsResponses, UpdateFormResponse, UpdateFormResponses, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateSharePermissionRequestV2, UploadDescriptor, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UploadGrant, UploadId, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, VersionedTable, View, ViewChange, ViewColumn, ViewerCapabilities, ViewLayout, ViewPatch, ViewPosition, ViewPositionsResponse, ViewQuery, ViewResult, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WhatsAppAccount, WhatsappAccountData, WhatsappAccountResponse, WhatsappAccountResponses, WhatsAppAccountState, WhatsAppAccountView, WhatsappCancelPairingData, WhatsappCancelPairingResponse, WhatsappCancelPairingResponses, WhatsAppCannotAdd, WhatsAppChat, WhatsAppChats, WhatsappChatsData, WhatsappChatsResponse, WhatsappChatsResponses, WhatsAppConnect, WhatsappConnectData, WhatsappConnectResponse, WhatsappConnectResponses, WhatsAppDisconnect, WhatsappDisconnectData, WhatsAppDisconnectRequest, WhatsappDisconnectResponse, WhatsappDisconnectResponses, WhatsAppHistoryImport, WhatsappImportHistoryData, WhatsappImportHistoryResponse, WhatsappImportHistoryResponses, WhatsAppLookup, WhatsappLookupData, WhatsAppLookupRequest, WhatsappLookupResponse, WhatsappLookupResponses, WhatsAppLookupState, WhatsAppPairing, WhatsappPairingData, WhatsappPairingResponse, WhatsappPairingResponses, WhatsAppPairingState, WhatsAppPairState, WhatsappPasskeyData, WhatsappPasskeyResponse, WhatsappPasskeyResponses, WhatsappStartLookupData, WhatsappStartLookupResponse, WhatsappStartLookupResponses, Widget, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
+export type { AccentColor, AccessiblePipeline, AccessLevel, AccessRequest, AccessRequestsCancelData, AccessRequestsCancelErrors, AccessRequestsCancelResponses, AccessRequestsDirectData, AccessRequestsDirectErrors, AccessRequestsDirectResponse, AccessRequestsDirectResponses, AccessRequestsRemoveDirectData, AccessRequestsRemoveDirectErrors, AccessRequestsRemoveDirectResponses, AccessRequestsResolveData, AccessRequestsResolveErrors, AccessRequestsResolveResponse, AccessRequestsResolveResponses, AccessRequestsSetDirectData, AccessRequestsSetDirectErrors, AccessRequestsSetDirectResponses, AccessRequestsStateData, AccessRequestsStateErrors, AccessRequestsStateResponse, AccessRequestsStateResponses, AccessRequestsSubmitData, AccessRequestsSubmitErrors, AccessRequestsSubmitResponse, AccessRequestsSubmitResponses, AccessRequestState, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentDmProfile, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionFilters, AgentSessionLifecycleEvent, AgentSessionSource, AgentSessionVisibility, AgentTyping, AgentTypingPhase, Anchor, AnchorId, AnchorResponse, AnnotationIncrementalUpdate, Answer, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentCommentReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, AppliedOps, ApplyCrmPipelineOpsData, ApplyCrmPipelineOpsResponse, ApplyCrmPipelineOpsResponses, ApplyDatabaseOpsData, ApplyDatabaseOpsError, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponse, ApplyDatabaseOpsResponses, ApplyOpsRequest, ApplyOpsResponse, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AttachmentChange, AttendeeResponseStatus, Audience, Awareness, AwarenessRelay, BasicDocument, BasicDocumentSubType, BomPart, BookingTarget, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarJoinRequest, CalendarJoinRequestApiError, CalendarJoinRequestErrorCode, CalendarJoinRequestsResponse, CalendarJoinRequestStatus, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarMentionViewerCopy, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallFilters, CallProvider, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordSource, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponse, CancelSlackImportResponses, CardPosition, CastVerdict, CellValue, CellWrite, ChangedFileDto, ChangesetDto, ChangesetSourceDto, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelScopeSelection, ChannelLabelsList, ChannelMessage, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPictureChangedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollaborateFormData, CollaborateFormError, CollaborateFormErrors, CollaborateFormResponse, CollaborateFormResponses, CollabSurfaceResponse, CollabSurfaceTokenResponse, Column, ColumnCast, ColumnChange, ColumnChangeKind, ColumnConfig, ColumnConversion, ColumnConversionRequest, ColumnDetail, ColumnId, ColumnKind, ColumnProtection, ColumnResult, CommandFailure, CommandRejectedMetadata, CommittedChange, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponse, CompleteSlackImportUploadsResponses, CompleteUploads, ConferenceProvider, Conjunction, ConversationId, ConversationKind, ConversationMetadata, ConversationProgress, ConversationSeal, ConversationStatus, ConvertDatabaseColumnData, ConvertDatabaseColumnError, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponse, ConvertDatabaseColumnResponses, ConvertedCell, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateCanvasDocumentRequest, CreateCanvasDocumentResponse, CreateCanvasHandlerData, CreateCanvasHandlerError, CreateCanvasHandlerErrors, CreateCanvasHandlerResponse, CreateCanvasHandlerResponses, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateCrmPipelineData, CreateCrmPipelineResponse, CreateCrmPipelineResponses, CreateDatabaseData, CreateDatabaseError, CreateDatabaseErrors, CreateDatabaseRequest, CreateDatabaseResponse, CreateDatabaseResponses, CreateDatabaseWebhookData, CreateDatabaseWebhookError, CreateDatabaseWebhookErrors, CreateDatabaseWebhookRequest, CreateDatabaseWebhookResponse, CreateDatabaseWebhookResponses, CreatedDatabaseWebhookResponse, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateForm, CreateFormData, CreateFormError, CreateFormErrors, CreateFormResponse, CreateFormResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateImport, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreatePipeline, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponse, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateToken, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmAssociation, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, Database, DatabaseDetail, DatabaseId, DatabaseOp, DatabaseQueryRequest, DatabaseView, DatabaseWebhookDeliveryResponse, DatabaseWebhookPayloadProblem, DatabaseWebhookResponse, DataType, DateOperator, DateRange, DateRangeOperator, DeclineCallData, DeclineCallError, DeclineCallErrors, DeclineCallResponse, DeclineCallResponses, DeclineRingData, DeclineRingError, DeclineRingErrors, DeclineRingResponse, DeclineRingResponses, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteDatabaseWebhookData, DeleteDatabaseWebhookError, DeleteDatabaseWebhookErrors, DeleteDatabaseWebhookResponse, DeleteDatabaseWebhookResponses, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DeliverDatabaseWebhookData, DeliverDatabaseWebhookError, DeliverDatabaseWebhookErrors, DeliverDatabaseWebhookResponse, DeliverDatabaseWebhookResponses, DirectAccess, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTextContent, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditMyFormResponseData, EditMyFormResponseError, EditMyFormResponseErrors, EditMyFormResponseResponse, EditMyFormResponseResponses, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmailReminderPage, EmailReminderSummary, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponse, EnsureStarterHandlerResponses, EntityFilters, EntityKind, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityRef, EntityReference, EntityType, ErrorResponse, EventIcsData, EventIcsErrors, EventIcsResponse, EventIcsResponses, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, ExternalChatAdd, ExternalChatAddData, ExternalChatAdded, ExternalChatAddResponse, ExternalChatAddResponses, ExternalChatAttachment, ExternalChatAttachmentState, ExternalChatBackfill, ExternalChatBackfillState, ExternalChatCall, ExternalChatCallOutcome, ExternalChatCapabilities, ExternalChatCommunity, ExternalChatContactCard, ExternalChatContacts, ExternalChatData, ExternalChatDeliveryData, ExternalChatDeliveryResponse, ExternalChatDeliveryResponses, ExternalChatDeliveryState, ExternalChatDetail, ExternalChatEvent, ExternalChatKind, ExternalChatLocation, ExternalChatMediaKind, ExternalChatMediaPresentation, ExternalChatMembers, ExternalChatMention, ExternalChatMessage, ExternalChatMessageAttachments, ExternalChatMessageAttachmentsData, ExternalChatMessageAttachmentsResponse, ExternalChatMessageAttachmentsResponses, ExternalChatMessageData, ExternalChatMessageKind, ExternalChatMessageResponse, ExternalChatMessageResponses, ExternalChatMessages, ExternalChatMessagesData, ExternalChatMessagesResponse, ExternalChatMessagesResponses, ExternalChatMutation, ExternalChatParticipant, ExternalChatPermissionsData, ExternalChatPermissionsResponse, ExternalChatPermissionsResponses, ExternalChatPersonRef, ExternalChatPoll, ExternalChatPollOption, ExternalChatProvider, ExternalChatReaction, ExternalChatReadData, ExternalChatReadResponse, ExternalChatReadResponses, ExternalChatReference, ExternalChatRemoveData, ExternalChatRemoveResponse, ExternalChatRemoveResponses, ExternalChatReplyBlock, ExternalChatReplyContent, ExternalChatResponse, ExternalChatResponses, ExternalChatRichContent, ExternalChatsData, ExternalChatSendData, ExternalChatSender, ExternalChatSendErrors, ExternalChatSendProgress, ExternalChatSendReply, ExternalChatSendResponse, ExternalChatSendResponses, ExternalChatSendsData, ExternalChatSendsResponse, ExternalChatSendsResponses, ExternalChatsResponse, ExternalChatsResponses, ExternalChatSummary, ExternalChatSystemAction, ExternalChatSystemLine, ExternalChatUpdatePermissionsData, ExternalChatUpdatePermissionsResponse, ExternalChatUpdatePermissionsResponses, ExternalChatUploadData, ExternalChatUploadedAttachment, ExternalChatUploadRequest, ExternalChatUploadResponse, ExternalChatUploadResponses, Favorite, FavoriteEntityRef, FavoritesList, FileChangeKindDto, FileSystemNodeWithIds, FileType, FileTypeUpdate, FilterCondition, FilterGroup, FilterNode, FilterTest, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponse, FinalizeSlackImportResponses, FolderItem, FollowupState, ForeignEntity, ForeignEntityFilters, Form, FormAccess, FormBranding, FormCollaboration, FormDetail, FormErrorCode, FormErrorResponse, FormLayout, FormPublicationProblem, FormQuestionDetail, FormResponse, FormSection, FormSectionDetail, FormSource, FormStatus, FormTally, Formula, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmPipelineData, GetCrmPipelinePermissionsData, GetCrmPipelinePermissionsResponse, GetCrmPipelinePermissionsResponses, GetCrmPipelineResponse, GetCrmPipelineResponses, GetCrmPipelineRowsData, GetCrmPipelineRowsResponse, GetCrmPipelineRowsResponses, GetCrmPipelineTableData, GetCrmPipelineTableResponse, GetCrmPipelineTableResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseError, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsError, GetDatabasePermissionsErrors, GetDatabasePermissionsResponse, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryError, GetDatabaseQueryErrors, GetDatabaseQueryResponse, GetDatabaseQueryResponses, GetDatabaseResponse, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryError, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponse, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesError, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponse, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsError, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponse, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentTextContentData, GetDocumentTextContentErrors, GetDocumentTextContentResponse, GetDocumentTextContentResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetFormData, GetFormError, GetFormErrors, GetFormPermissionsData, GetFormPermissionsError, GetFormPermissionsErrors, GetFormPermissionsResponse, GetFormPermissionsResponses, GetFormResponse, GetFormResponses, GetFormResponseSummaryData, GetFormResponseSummaryError, GetFormResponseSummaryErrors, GetFormResponseSummaryResponse, GetFormResponseSummaryResponses, GetFormTallyData, GetFormTallyError, GetFormTallyErrors, GetFormTallyResponse, GetFormTallyResponses, GetGithubPullRequestChangesData, GetGithubPullRequestChangesError, GetGithubPullRequestChangesErrors, GetGithubPullRequestChangesPatchData, GetGithubPullRequestChangesPatchError, GetGithubPullRequestChangesPatchErrors, GetGithubPullRequestChangesPatchResponse, GetGithubPullRequestChangesPatchResponses, GetGithubPullRequestChangesResponse, GetGithubPullRequestChangesResponses, GetGithubPullRequestData, GetGithubPullRequestError, GetGithubPullRequestErrors, GetGithubPullRequestFacetsData, GetGithubPullRequestFacetsError, GetGithubPullRequestFacetsErrors, GetGithubPullRequestFacetsResponse, GetGithubPullRequestFacetsResponses, GetGithubPullRequestResponse, GetGithubPullRequestResponses, GetGithubPullRequestTasksData, GetGithubPullRequestTasksError, GetGithubPullRequestTasksErrors, GetGithubPullRequestTasksResponse, GetGithubPullRequestTasksResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMyFormResponseData, GetMyFormResponseError, GetMyFormResponseErrors, GetMyFormResponseResponse, GetMyFormResponseResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponse, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubLabelFacet, GithubPullRequest, GithubPullRequestChangesPatchResponse, GithubPullRequestChangesResponse, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestFacets, GithubPullRequestLabel, GithubPullRequestReview, GithubPullRequestReviewDecision, GithubPullRequestReviewState, GithubPullRequestsResponse, GithubPullRequestTasks, GithubPullRequestTasksRequest, GithubPullRequestTasksResponse, GithubPullRequestUser, GithubRepositoryFacet, GithubUserFacet, GitRefDto, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestCallChatPostData, GuestCallChatPostErrors, GuestCallChatPostResponse, GuestCallChatPostResponses, GuestCallChatReadData, GuestCallChatReadErrors, GuestCallChatReadResponse, GuestCallChatReadResponses, GuestChatMessage, GuestChatPage, GuestChatPost, GuestId, GuestJoinRequest, GuestPolicy, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportCounters, ImportDatabaseTableData, ImportDatabaseTableError, ImportDatabaseTableErrors, ImportDatabaseTableResponse, ImportDatabaseTableResponses, ImportedAuthor, ImportError, ImportLimits, ImportPage, ImportProgress, ImportTable, ImportWarning, InferColumnTypeOutcome, InferColumnTypeRequest, InferDatabaseColumnTypeData, InferDatabaseColumnTypeError, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponse, InferDatabaseColumnTypeResponses, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InvalidDatabaseWebhookPayloadResponse, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobId, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JobStatus, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, KeySegment, Lane, LaneKey, LatestMessage, LayoutProblem, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAccessibleFormsData, ListAccessibleFormsError, ListAccessibleFormsErrors, ListAccessibleFormsResponse, ListAccessibleFormsResponses, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmPipelinesData, ListCrmPipelinesResponse, ListCrmPipelinesResponses, ListDatabaseColumnCastsData, ListDatabaseColumnCastsError, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponse, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesError, ListDatabasesErrors, ListDatabasesResponse, ListDatabasesResponses, ListDatabaseWebhooksData, ListDatabaseWebhooksError, ListDatabaseWebhooksErrors, ListDatabaseWebhooksResponse, ListDatabaseWebhooksResponse2, ListDatabaseWebhooksResponses, ListedDatabase, ListedForm, ListEmailRemindersData, ListEmailRemindersError, ListEmailRemindersErrors, ListEmailRemindersResponse, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListFormsData, ListFormsError, ListFormsErrors, ListFormsResponse, ListFormsResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListJoinRequestsData, ListJoinRequestsError, ListJoinRequestsErrors, ListJoinRequestsResponse, ListJoinRequestsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListSlackImportsData, ListSlackImportsResponse, ListSlackImportsResponses, ListTeamCalendarData, ListTeamCalendarResponse, ListTeamCalendarResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, MarkRead, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineEntriesData, MessageTimelineEntriesResponse, MessageTimelineEntriesResponses, MessageTimelineEntry, MessageTimelinePage, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, MyResponse, NewAttachment, NewColumn, NewOption, NewThreadAnchor, NewView, NotificationFilters, NotificationState, NumberOperator, OpBatch, Operator, OpRefusalResponse, OpResult, OptionId, OptionRef, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, Pipeline, PipelineRecordType, PipelineSharing, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresenceOperator, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyBucketing, PropertyDateFilterRange, PropertyDateRange, PropertyDateRanges, PropertyDefinition, PropertyDefinitionWithOptions, PropertyFilter, PropertyInput, PropertyOption, PropertyOptionValue, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, PutFormLayoutData, PutFormLayoutError, PutFormLayoutErrors, PutFormLayoutResponse, PutFormLayoutResponses, QueryCrmPipelineRowsData, QueryCrmPipelineRowsResponse, QueryCrmPipelineRowsResponses, QueryDatabasesData, QueryDatabasesError, QueryDatabasesErrors, QueryDatabasesResponse, QueryDatabasesResponses, QueryDefinition, QuestionLayout, QuestionOption, QuestionTally, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponse, RegisterSlackImportUploadsResponses, RegisterUploads, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, RenameCrmPipelineData, RenameCrmPipelineResponse, RenameCrmPipelineResponses, RenamePipeline, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestAccess, RequestedHarnessScope, RequestedLayout, RequestStatus, RequestToJoinData, RequestToJoinError, RequestToJoinErrors, RequestToJoinResponse, RequestToJoinResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveRequest, ResponseStatus, ResponseSummary, ResultColumn, ResultSet, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, RowChange, RowChangeKind, RowChanges, RowHistoryEntry, RowHistoryResponse, RowId, RowsChange, RowsResult, S3ObjectInfo, SaveBomPart, SaveDatabaseQueryData, SaveDatabaseQueryError, SaveDatabaseQueryErrors, SaveDatabaseQueryResponse, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SavedQuery, SaveQueryRequest, SearchContactsData, SearchContactsError, SearchContactsErrors, SearchContactsResponse, SearchContactsResponse2, SearchContactsResponses, SearchState, SectionCount, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionSource, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDirectAccess, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetOperator, SetPropertyValue, Sha256Digest, ShareCrmPipelineData, ShareCrmPipelineResponse, ShareCrmPipelineResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessError, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponse, ShareDatabaseAwarenessResponses, SharedEmailFilter, SharedExternalChatReference, ShareEntity, ShareEntityType, SharePermissionV2, SharePipeline, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SkippedCell, SlackCompleteRequest, SlackCreateRequest, SlackRegisterRequest, SlackTimestamp, SlackUserId, SmartTagChannelMatch, SmartTagPreview, SortDirection, SortKey, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmContactSoupPropertiesField, SoupCrmDomain, SoupDatabaseRowSoupPropertiesField, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupThreadInfo, SoupThreadReply, SourceBinding, SourceId, SourceIdentity, SqlCell, SqlEntityKind, SqlOutcome, SqlOutcomeKind, SqlSelectOption, SqlStatement, StarterDatabase, StarterDocumentsResponse, StorageRow, StorageRows, StorageRowsQuery, StoredGithubPullRequest, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, Submission, SubmissionOutcome, SubmitFormResponseData, SubmitFormResponseError, SubmitFormResponseErrors, SubmitFormResponseResponse, SubmitFormResponseResponses, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, Table, TableChange, TableChanged, TableChanges, TableDetail, TableId, TableResult, TableVersion, TagFilterMode, TakenId, TallyBucket, TallyValue, TaskFilters, TaskSimilarityResult, TaskSimilaritySearchHandlerData, TaskSimilaritySearchHandlerError, TaskSimilaritySearchHandlerErrors, TaskSimilaritySearchHandlerResponse, TaskSimilaritySearchHandlerResponses, TaskSimilaritySearchRequest, TaskSimilaritySearchResponse, TeamCalendarContent, TeamCalendarCoverage, TeamCalendarDetails, TeamCalendarItem, TeamCalendarMember, TeamCalendarPage, TeamCalendarSharing, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, TextOperator, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, TimelineActivity, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TouchedColumn, TouchedRow, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TrashCrmPipelineData, TrashCrmPipelineResponse, TrashCrmPipelineResponses, TrashPipeline, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UndoChangeResponse, UndoDatabaseChangeData, UndoDatabaseChangeError, UndoDatabaseChangeErrors, UndoDatabaseChangeResponse, UndoDatabaseChangeResponses, UndoOutcome, UndoRefusal, UnlockedBooking, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmPipelinePermissionsData, UpdateCrmPipelinePermissionsResponse, UpdateCrmPipelinePermissionsResponses, UpdateCrmTeamSettingsRequest, UpdateDatabasePermissionsData, UpdateDatabasePermissionsError, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponse, UpdateDatabasePermissionsResponses, UpdateForm, UpdateFormData, UpdateFormError, UpdateFormErrors, UpdateFormPermissionsData, UpdateFormPermissionsError, UpdateFormPermissionsErrors, UpdateFormPermissionsResponse, UpdateFormPermissionsResponses, UpdateFormResponse, UpdateFormResponses, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateSharePermissionRequestV2, UploadDescriptor, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UploadGrant, UploadId, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, VersionedTable, View, ViewChange, ViewColumn, ViewerCapabilities, ViewLayout, ViewPatch, ViewPosition, ViewPositionsResponse, ViewQuery, ViewResult, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WhatsAppAccount, WhatsappAccountData, WhatsappAccountResponse, WhatsappAccountResponses, WhatsAppAccountState, WhatsAppAccountView, WhatsappCancelPairingData, WhatsappCancelPairingResponse, WhatsappCancelPairingResponses, WhatsAppCannotAdd, WhatsAppChat, WhatsAppChats, WhatsappChatsData, WhatsappChatsResponse, WhatsappChatsResponses, WhatsAppConnect, WhatsappConnectData, WhatsappConnectResponse, WhatsappConnectResponses, WhatsAppDisconnect, WhatsappDisconnectData, WhatsAppDisconnectRequest, WhatsappDisconnectResponse, WhatsappDisconnectResponses, WhatsAppHistoryImport, WhatsappImportHistoryData, WhatsappImportHistoryResponse, WhatsappImportHistoryResponses, WhatsAppLookup, WhatsappLookupData, WhatsAppLookupRequest, WhatsappLookupResponse, WhatsappLookupResponses, WhatsAppLookupState, WhatsAppPairing, WhatsappPairingData, WhatsappPairingResponse, WhatsappPairingResponses, WhatsAppPairingState, WhatsAppPairState, WhatsappPasskeyData, WhatsappPasskeyResponse, WhatsappPasskeyResponses, WhatsappStartLookupData, WhatsappStartLookupResponse, WhatsappStartLookupResponses, Widget, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
diff --git a/packages/sdk/generated/storage/types.gen.ts b/packages/sdk/generated/storage/types.gen.ts
index daae71759f..25146e5147 100644
--- a/packages/sdk/generated/storage/types.gen.ts
+++ b/packages/sdk/generated/storage/types.gen.ts
@@ -4,6 +4,11 @@ export type ClientOptions = {
baseUrl: `${string}://${string}` | (string & {});
};
+/**
+ * A color as `#rrggbb`, kept in lowercase.
+ */
+export type AccentColor = string;
+
/**
* Ordered from least to most access top -> bottom
*/
@@ -7745,6 +7750,10 @@ export type Form = {
* Who may respond.
*/
audience: Audience;
+ /**
+ * Its logo, cover image and accent color.
+ */
+ branding: FormBranding;
/**
* When it stops taking responses, if it does.
*/
@@ -7817,6 +7826,21 @@ export type Form = {
*/
export type FormAccess = 'view' | 'edit' | 'owner';
+/**
+ * A form's logo, cover image and accent color, each unset by default.
+ */
+export type FormBranding = {
+ accentColor: null | AccentColor;
+ /**
+ * The static file shown as a banner across the top of the page.
+ */
+ coverFileId: string | null;
+ /**
+ * The static file shown as the logo above the title.
+ */
+ logoFileId: string | null;
+};
+
/**
* A ready collaborative form and the result of publishing its latest draft.
*/
@@ -7858,7 +7882,7 @@ export type FormDetail = {
/**
* What went wrong with a forms request.
*/
-export type FormErrorCode = 'tableAlreadyHasForm' | 'notFound' | 'forbidden' | 'ownerOnly' | 'signInRequired' | 'closed' | 'tableGone' | 'alreadyResponded' | 'noResponse' | 'unknownQuestion' | 'repeatedAnswer' | 'missingAnswer' | 'invalidAnswer' | 'widgetMismatch' | 'fileUploadNeedsSignIn' | 'invalidLayout' | 'invalidName' | 'invalidSharing' | 'tallyHidden' | 'conflict' | 'internal';
+export type FormErrorCode = 'tableAlreadyHasForm' | 'notFound' | 'forbidden' | 'ownerOnly' | 'signInRequired' | 'closed' | 'tableGone' | 'alreadyResponded' | 'noResponse' | 'unknownQuestion' | 'repeatedAnswer' | 'missingAnswer' | 'invalidAnswer' | 'widgetMismatch' | 'fileUploadNeedsSignIn' | 'invalidLayout' | 'invalidName' | 'invalidSharing' | 'tallyHidden' | 'invalidBranding' | 'conflict' | 'internal';
/**
* Why a forms request was refused or failed.
@@ -15867,11 +15891,15 @@ export type UpdateCrmTeamSettingsRequest = {
};
/**
- * A change to a form's facts; what is left out stays. The description and
- * confirmation message take edit, the rest owner. A form is renamed
+ * A change to a form's facts; what is left out stays. The description,
+ * confirmation message and branding take edit, the rest owner. A form is renamed
* through the entity mutation router.
*/
export type UpdateForm = {
+ /**
+ * A new accent color, or `null` for the default.
+ */
+ accentColor?: string | null;
/**
* Who may respond from now on.
*/
@@ -15884,10 +15912,18 @@ export type UpdateForm = {
* Its new confirmation message.
*/
confirmationMessage?: string;
+ /**
+ * A new cover image, or `null` to remove it.
+ */
+ coverFileId?: string | null;
/**
* Its new description.
*/
description?: string;
+ /**
+ * A new logo, or `null` to remove it.
+ */
+ logoFileId?: string | null;
/**
* Open or close it.
*/
diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.json
index f717973739..528039a7ae 100644
--- a/packages/sdk/specs/storage.json
+++ b/packages/sdk/specs/storage.json
@@ -19699,6 +19699,11 @@
},
"components": {
"schemas": {
+ "AccentColor": {
+ "type": "string",
+ "description": "A color as `#rrggbb`, kept in lowercase.",
+ "pattern": "^#[0-9a-fA-F]{6}$"
+ },
"AccessLevel": {
"type": "string",
"description": "Ordered from least to most access top -> bottom",
@@ -31729,6 +31734,7 @@
"status",
"closesAt",
"confirmationMessage",
+ "branding",
"createdAt",
"updatedAt",
"isHiddenInDrive"
@@ -31738,6 +31744,10 @@
"$ref": "#/components/schemas/Audience",
"description": "Who may respond."
},
+ "branding": {
+ "$ref": "#/components/schemas/FormBranding",
+ "description": "Its logo, cover image and accent color."
+ },
"closesAt": {
"type": ["string", "null"],
"format": "date-time",
@@ -31813,6 +31823,34 @@
"description": "The caller's level on a form: view responds, edit changes questions and\nreads responses, owner also sets the audience, closes and trashes it.",
"enum": ["view", "edit", "owner"]
},
+ "FormBranding": {
+ "type": "object",
+ "description": "A form's logo, cover image and accent color, each unset by default.",
+ "required": ["logoFileId", "coverFileId", "accentColor"],
+ "properties": {
+ "accentColor": {
+ "oneOf": [
+ {
+ "type": "null"
+ },
+ {
+ "$ref": "#/components/schemas/AccentColor",
+ "description": "The color of the page's buttons and selected answers."
+ }
+ ]
+ },
+ "coverFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "The static file shown as a banner across the top of the page."
+ },
+ "logoFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "The static file shown as the logo above the title."
+ }
+ }
+ },
"FormCollaboration": {
"type": "object",
"description": "A ready collaborative form and the result of publishing its latest draft.",
@@ -31877,6 +31915,7 @@
"invalidName",
"invalidSharing",
"tallyHidden",
+ "invalidBranding",
"conflict",
"internal"
]
@@ -44566,8 +44605,13 @@
},
"UpdateForm": {
"type": "object",
- "description": "A change to a form's facts; what is left out stays. The description and\nconfirmation message take edit, the rest owner. A form is renamed\nthrough the entity mutation router.",
+ "description": "A change to a form's facts; what is left out stays. The description,\nconfirmation message and branding take edit, the rest owner. A form is renamed\nthrough the entity mutation router.",
"properties": {
+ "accentColor": {
+ "type": ["string", "null"],
+ "description": "A new accent color, or `null` for the default.",
+ "pattern": "^#[0-9a-fA-F]{6}$"
+ },
"audience": {
"$ref": "#/components/schemas/Audience",
"description": "Who may respond from now on."
@@ -44581,10 +44625,20 @@
"type": "string",
"description": "Its new confirmation message."
},
+ "coverFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "A new cover image, or `null` to remove it."
+ },
"description": {
"type": "string",
"description": "Its new description."
},
+ "logoFileId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "A new logo, or `null` to remove it."
+ },
"status": {
"$ref": "#/components/schemas/FormStatus",
"description": "Open or close it."
diff --git a/packages/sdk/tests/forms.test.ts b/packages/sdk/tests/forms.test.ts
index f9d35c543b..29763a4323 100644
--- a/packages/sdk/tests/forms.test.ts
+++ b/packages/sdk/tests/forms.test.ts
@@ -28,6 +28,7 @@ const registration = {
status: 'open',
closesAt: null,
confirmationMessage: 'See you there!',
+ branding: { logoFileId: null, coverFileId: null, accentColor: null },
createdAt: '2026-10-05T00:00:00Z',
updatedAt: '2026-10-05T00:00:00Z',
},
diff --git a/services/agent_harness_service/src/cognition/api/context/test.rs b/services/agent_harness_service/src/cognition/api/context/test.rs
index b84aaddf43..896bd896b6 100644
--- a/services/agent_harness_service/src/cognition/api/context/test.rs
+++ b/services/agent_harness_service/src/cognition/api/context/test.rs
@@ -495,6 +495,10 @@ pub async fn test_api_context(pool: sqlx::Pool<sqlx::Postgres>) -> std::sync::Ar
ai_tools::FormsToolConfig {
app_origin: "https://macro.test".into(),
editing_worker_url: "http://localhost:8933".into(),
+ static_files: static_file_service_client::StaticFileServiceClient::new(
+ "test-internal-api-key".to_string(),
+ "http://localhost:0".to_string(),
+ ),
},
);
diff --git a/services/agent_harness_service/src/cognition/server.rs b/services/agent_harness_service/src/cognition/server.rs
index d04215ad0c..8cf58ddb59 100644
--- a/services/agent_harness_service/src/cognition/server.rs
+++ b/services/agent_harness_service/src/cognition/server.rs
@@ -825,6 +825,10 @@ pub async fn build(
ai_tools::FormsToolConfig {
app_origin: macro_service_urls::AppServiceUrl::new()?.to_string(),
editing_worker_url: config.ai_editing_worker_url.clone(),
+ static_files: static_file_service_client::StaticFileServiceClient::new(
+ internal_api_key.clone(),
+ macro_service_urls::StaticFileServiceUrl::new()?.to_string(),
+ ),
},
);
diff --git a/services/document_storage_service/Cargo.toml b/services/document_storage_service/Cargo.toml
index f116770534..07c8ceb16c 100644
--- a/services/document_storage_service/Cargo.toml
+++ b/services/document_storage_service/Cargo.toml
@@ -115,6 +115,7 @@ forms = { path = "../../crates/forms", features = [
"gateway",
"inbound",
"postgres",
+ "static_files",
] }
document_sub_type = { path = "../../crates/document_sub_type" }
documents_hex = { path = "../../crates/documents", package = "documents", features = ["purge"] }
diff --git a/services/document_storage_service/src/server.rs b/services/document_storage_service/src/server.rs
index 1c6145afb5..8a9f5865cd 100644
--- a/services/document_storage_service/src/server.rs
+++ b/services/document_storage_service/src/server.rs
@@ -1603,6 +1603,10 @@ pub async fn run() -> anyhow::Result<()> {
),
macro_event_broker.clone(),
collab_surface_service.clone(),
+ static_file_service_client::StaticFileServiceClient::new(
+ config.internal_api_key.to_string(),
+ StaticFileServiceUrl::new()?.to_string(),
+ ),
));
// Individual initiative and agent-session reads preserve read-after-write