Discourage the use of our marshaling types.

Deprecate our Marshal* and Unmarshal* functions to discourage
third-party callers from relying on them. This is a temporary solution;
we should refactor to make these not exported, if we can.

Author: Paddy Carver

tfprotov5/dynamic_value.go

@@ -26,7 +26,9 @@ var ErrUnknownDynamicValueType = errors.New("DynamicValue had no JSON or msgpack
 // that is compatible with the Type of the Value. Usually it should just be the
 // Type of the Value, but it can also be the DynamicPseudoType.
 func NewDynamicValue(t tftypes.Type, v tftypes.Value) (DynamicValue, error) {
-	b, err := v.MarshalMsgPack(t)
+	b, err := v.MarshalMsgPack(t) //nolint:staticcheck
+	//
+	// Deprecated: this is not meant to be called by third-party code.
 	if err != nil {
 		return DynamicValue{}, err
 	}

tfprotov5/dynamic_value_json.go

@@ -126,7 +126,7 @@ func jsonUnmarshalDynamicPseudoType(buf []byte, typ tftypes.Type, p tftypes.Attr
 		}
 		switch key {
 		case "type":
-			t, err = tftypes.ParseJSONType(rawVal)
+			t, err = tftypes.ParseJSONType(rawVal) //nolint:staticcheck
 			if err != nil {
 				return tftypes.Value{}, p.NewErrorf("error decoding type information: %w", err)
 			}

tfprotov5/dynamic_value_msgpack.go

@@ -306,7 +306,7 @@ func msgpackUnmarshalDynamic(dec *msgpack.Decoder, path tftypes.AttributePath) (
 	if err != nil {
 		return tftypes.Value{}, path.NewErrorf("error decoding bytes: %w", err)
 	}
-	typ, err := tftypes.ParseJSONType(typeJSON)
+	typ, err := tftypes.ParseJSONType(typeJSON) //nolint:staticcheck
 	if err != nil {
 		return tftypes.Value{}, path.NewErrorf("error parsing type information: %w", err)
 	}

tfprotov5/internal/fromproto/schema.go

@@ -52,7 +52,7 @@ func SchemaAttribute(in *tfplugin5.Schema_Attribute) (*tfprotov5.SchemaAttribute
 		DescriptionKind: StringKind(in.DescriptionKind),
 		Deprecated:      in.Deprecated,
 	}
-	typ, err := tftypes.ParseJSONType(in.Type)
+	typ, err := tftypes.ParseJSONType(in.Type) //nolint:staticcheck
 	if err != nil {
 		return resp, err
 	}

tfprotov5/internal/toproto/dynamic_value.go

@@ -31,6 +31,8 @@ func (l List) private() {}
 
 // MarshalJSON returns a JSON representation of the full type signature of `l`,
 // including its ElementType.
+//
+// Deprecated: this is not meant to be called by third-party code.
 func (l List) MarshalJSON() ([]byte, error) {
 	elementType, err := l.ElementType.MarshalJSON()
 	if err != nil {

tfprotov5/tftypes/list.go

@@ -30,6 +30,8 @@ func (m Map) private() {}
 
 // MarshalJSON returns a JSON representation of the full type signature of `m`,
 // including its AttributeType.
+//
+// Deprecated: this is not meant to be called by third-party code.
 func (m Map) MarshalJSON() ([]byte, error) {
 	attributeType, err := m.AttributeType.MarshalJSON()
 	if err != nil {

tfprotov5/tftypes/map.go

@@ -45,6 +45,8 @@ func (o Object) private() {}
 
 // MarshalJSON returns a JSON representation of the full type signature of `o`,
 // including the AttributeTypes.
+//
+// Deprecated: this is not meant to be called by third-party code.
 func (o Object) MarshalJSON() ([]byte, error) {
 	attrs, err := json.Marshal(o.AttributeTypes)
 	if err != nil {

tfprotov5/tftypes/object.go

@@ -31,6 +31,8 @@ func (s Set) private() {}
 
 // MarshalJSON returns a JSON representation of the full type signature of `s`,
 // including its ElementType.
+//
+// Deprecated: this is not meant to be called by third-party code.
 func (s Set) MarshalJSON() ([]byte, error) {
 	elementType, err := s.ElementType.MarshalJSON()
 	if err != nil {

tfprotov5/tftypes/set.go

@@ -42,6 +42,8 @@ func (tu Tuple) private() {}
 
 // MarshalJSON returns a JSON representation of the full type signature of
 // `tu`, including the ElementTypes.
+//
+// Deprecated: this is not meant to be called by third-party code.
 func (tu Tuple) MarshalJSON() ([]byte, error) {
 	elements, err := json.Marshal(tu.ElementTypes)
 	if err != nil {