chore: move SDK naming to v1

[hperl]

This adapts the https://intranet.ory.sh/docs/dev/api-guidelines/ to Keto to bring the SDK to v1.

BREAKING CHANGES: This changes the naming in the OpenAPI-generated SDKs. The REST and gRPC APIs are unchanged, so old OpenAPI clients still work (and gRPC clients are completely unaffected).

Related issue(s)

Fixes https://github.com/ory-corp/cloud/issues/3404

Checklist

• Rename models, params
• Check all comments

[aeneasr]

A few more to dos:

• Please rename genericError to errorGeneric
• Please rename "#/components/schemas/patchDelta" to "#/components/schemas/relationshipPatch"
• In createRelationships rename the request body parameter from "#/components/schemas/relationQuery" to "#/components/schemas/createRelationshipsBody"
• createRelationships returns a type called "#/components/schemas/relationQuery". Shouldn't this return a relationship?
• getRelationshipNamespaces returns a model called "#/components/schemas/getRelationshipNamespacesResponse" but it should be named something along the lines of relationshipNamespaces, see examples for naming: https://intranet.ory.sh/docs/dev/api-guidelines/#exemplary-definitions . We generally want to prevent using response or request in swagger names, because openapi generators add those automatically, and we end up with getRelationshipNamespacesResponseResponse

Personal tip: check the resulting openapi.json file for inconsistencies :) And compare it with one from e.g. kratos or hydra.

[aeneasr]

#1138 (comment)

[aeneasr]

@hperl can you PTAL into the failing tests and what's required to get this merged? TY

[aeneasr]

@hperl please add an upgrade guide to: https://www.ory.sh/docs/guides/upgrade/sdk-v1

[hperl]

@hperl please add an upgrade guide to: https://www.ory.sh/docs/guides/upgrade/sdk-v1

see ory/docs#1101