Implement SCUM direct data plane

platform/domain/game_client_bridge.go

@@ -69,8 +69,18 @@ type GameClientBridgeQueryTemplateDeclaration struct {
 	TargetKey          string
 	ParameterSchemaRef string
 	ResultSchemaRef    string
+	SQLRef             string
 	MaxRows            int
 	TimeoutSeconds     int
+	RowTarget          *SCUMRowTargetDeclaration
+}
+
+// SCUMRowTargetDeclaration is plugin-owned data-shaping metadata. The platform
+// only applies this declaration; it does not infer a destination from a query key.
+type SCUMRowTargetDeclaration struct {
+	TargetTable    string
+	UpsertKeys     []string
+	ColumnMappings map[string]string
 }
 
 type GameClientBridgeOperationKind string
@@ -453,6 +463,12 @@ func CopyGameClientBridgeManifest(value GameClientBridgeManifest) GameClientBrid
 	}
 	value.Snapshots = append([]GameClientBridgeSnapshotDeclaration(nil), value.Snapshots...)
 	value.QueryTemplates = append([]GameClientBridgeQueryTemplateDeclaration(nil), value.QueryTemplates...)
+	for index := range value.QueryTemplates {
+		if value.QueryTemplates[index].RowTarget != nil {
+			copy := CopySCUMRowTargetDeclaration(*value.QueryTemplates[index].RowTarget)
+			value.QueryTemplates[index].RowTarget = &copy
+		}
+	}
 	value.OperationTemplates = append([]GameClientBridgeOperationTemplateDeclaration(nil), value.OperationTemplates...)
 	value.Pages = append([]GameClientBridgePageContract(nil), value.Pages...)
 	value.Features = append([]GameClientBridgeFeatureDeclaration(nil), value.Features...)