v4 Programming model?

[diberry]

Does this work on the new v4 Programming model @aaronpowell?

[aaronpowell]

Possibly. Given that all it does is create an internal object structure that has metadata you provide and then an endpoint you register that will give you the swagger output, it should work but it might be a bit clunky.

But Functions v4 will actually simplify the implementation, or at least it should in theory. I tried with one of the early builds and found some hurdles that I raised to the Functions team, but I haven't reviewed it since then.

[rafaelgrilli92]

@aaronpowell any luck with the v4? Is it possible to use it with the v4 or not yet? I'm trying to implement it but the structure of the folders and the files are quite different from the v3, so I can't really follow the examples from this repo :/

[aaronpowell]

@aaronpowell any luck with the v4? Is it possible to use it with the v4 or not yet? I'm trying to implement it but the structure of the folders and the files are quite different from the v3, so I can't really follow the examples from this repo :/

There are some structurally different types used in v4 compared to v3 which means it's not directly compatible, so at the moment it doesn't support v4. I'm also no longer in a role where I'm doing any JS development so I don't have a whole lot of bandwidth to tackle this at present.

[rafaelgrilli92]

Sad news!! But thanks for the quick response. Appreciate it! Do you know any other way to work with OpenAPI and Azure Functions to make things simpler?

[fabiofranzini]

Hi, if you still interested in OpenAPI in Azure Functions V4, look at this repo: https://github.com/apvee/azure-functions-nodejs-monorepo. We are just published the repo as public and same for the npm package. ❤️ Feel free to submit ideas and contribution! At this moment is supported just the version 3.0 of the OpenAPI Spec, but soon will open to the 3.1 and 2.0 😄

[fabiofranzini]

I've just updated the @apvee/azure-functions-openapi package with version 1.0.0 to support all major OpenAPI formats: 2.0, 3.0.3, and 3.1.0. This makes it suitable for a variety of use cases, such as building custom connectors for Power Platform or generating API clients using Microsoft's Kiota.

For further details, you can check out the following repo, which also includes a sample project: azure-functions-nodejs-monorepo.

@diberry, @rafaelgrilli92 and of course @aaronpowell, let me know if this helps and feel free to comment and/or help us on this library! 😃

[aaronpowell]

TBH I'm probably better off archiving this repo and directing people to your package @fabiofranzini as I'm not working in this space anymore so my ability to do any level of maintenance here is virtually zero.

[fabiofranzini]

I think it makes sense, but only for developers using version 4. For version 3, this project remains valid as our package handles only the latest version 4.