docs(dart): add additional metadata for pub.dev

[IchordeDionysos]

Related Issue or Design Document

Adds the repository to the pubspec.yaml so that on pub.dev a link to the repository will be shown to users. https://dart.dev/tools/pub/pubspec#repository

Also adds a longer, more descriptive description to the SDKs to better explain what the individual packages are about and to please pub.dev. Feel free to adjust the description (should be longer than 60 and less than 180 chars) :) I've mostly taken it from the repo descriptions.

Checklist

• [ ] I have read the contributing guidelines and signed the CLA.
• [ ] I have referenced an issue containing the design document if my change introduces a new feature.
• [ ] I have read the security policy.
• [ ] I confirm that this pull request does not address a security vulnerability. If this pull request addresses a security vulnerability, I confirm that I got approval (please contact security@ory.sh) from the maintainers to push the changes.
• [ ] I have added tests that prove my fix is effective or that my feature works.
• [ ] I have added the necessary documentation within the code base (if appropriate).

Further comments

[CLAassistant]

All committers have signed the CLA.

[IchordeDionysos]

Setting the repository may be blocked by this issue: https://github.com/OpenAPITools/openapi-generator/issues/15214

Seems not to be possible with the generator ...

[IchordeDionysos]

@jonas-jonas do you think it would be possible to update to the next major version once https://github.com/OpenAPITools/openapi-generator/pull/15232 lands? https://github.com/ory/sdk/blob/master/Dockerfile#L74

[IchordeDionysos]

@jonas-jonas I've moved the descriptions to config/descriptions/ if you have a better idea where to put them let me know :)

The idea essentially is when building to read the description from config/description/{project}.txt and put it in the DART_PUB_DESCRIPTION variable, this will then as I understand replace the value in the config/client/dart.yml file.

The openapi-generator will then put the description there instead of the default description.

For setting the repository (which is the more annoying part not being set) we'd need to

• ~wait for this PR~
• wait until openapi-generator version 6.6.0 (Release date 28.04.2023)
• update the openapi-generator version
• and then do something similar as with the description

---

Also, should I revert the changes to the pubspec.yaml files or are there some commands that I need to run before merging the changes?

[jonas-jonas]

@IchordeDionysos there are some merge conflicts now, probably due to the changes to the pubspec.yaml. Probably best to revert all those changes here.

[IchordeDionysos]

Reverted the changes :) The repository will not be set now anymore but hopefully the changes to open-api-generator will soon be released in the next release (next week it should be there)

[IchordeDionysos]

Looking better and better 😍

[jonas-jonas]

Not sure where the escaped ' is coming from, but small issue :) Looks great, thanks for your help 🙌🏼

[IchordeDionysos]

Yeah tried to debug it but could get the generator to run locally in the half hour I tried it 🤔

[IchordeDionysos]

@jonas-jonas in the file config/client/dart.yml.proc.yml file it looks correct 🤔

[IchordeDionysos]

@jonas-jonas Actually I think I found the root cause of the encoding issue https://github.com/OpenAPITools/openapi-generator/pull/15570