feat: add simplified channel parameter

[jonaslagoni]

Description
This PR adds the support for the simplified channel parameters by utilizing a custom implementation of Schema that just looks in the parent parameter object for the values instead of under a .schema property that no longer exist for v3.

Related issue(s)
Fixes #815

[smoya]

Would you consider throwing warning log lines for those methods that users are unexpected to use?

[jonaslagoni]

@smoya I considered it, but I could not justify it with any reason. Cause it's not like the functions are deprecated or anything 🤷 They just wont return anything if paired with v3 documents, but will with v2.

So not sure who the logging is for? Owners of tools that use it? No cause it's not until the users provide a document those things are caught.
For the users of the tool? What exactly do they need that information for? 🤔

[magicmatatjahu]

@jonaslagoni I don't know if it was discussed but you can reuse v3.SchemaModel but passing as json object the serialized schema object from new parameter shape, I mean map fields like type etc:

{
  type: "string"
  description: parameter.description
}

etc. - all data will be handled in ChannelParameter model, inside schema() method.

Creating new model for this is not a good idea.

[jonaslagoni]

@magicmatatjahu you right, thats way cleaner, let me refactor it.

[magicmatatjahu]

Something like:

  schema(): SchemaInterface | undefined {
    if (!this.hasSchema()) return undefined;
    return this.createModel(Schema, {
      type: 'string',
      description: this._json.description,
      examples: this._json.examples,
      // etc...
    }, { pointer: `${this._meta.pointer}` });
  }

[jonaslagoni]

Done 👍

[magicmatatjahu]

Only one comment, rest is good :)

[jonaslagoni]

@magicmatatjahu do you have a bit of OCD by any chance? 😄

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[jonaslagoni]

/rtm

[asyncapi-bot]

🎉 This PR is included in version 2.1.0-next-major-spec.2 🎉

The release is available on:

• npm package (@next-major-spec dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[asyncapi-bot]

🎉 This PR is included in version 2.2.0-next-major-spec.1 🎉

The release is available on:

• npm package (@next-major-spec dist-tag)
• GitHub release

Your semantic-release bot 📦🚀