[IDP-1765] Add client generation & Plugin system

[tjosepo]

Description of changes

Plugin System

This pull-request adds a new plugin system to @workleap/create-schemas. Plugin lets users opt-in to specific features and extend the code generation. The plugin system is also meant to simplify the internals of @workleap/create-schemas, as we can use plugins internally.

The plugin system currently has three hooks, startBuild, transform and buildEnd.

---
title: Generation hooks
---
flowchart TB

    
    classDef parallel fill:#FFB3B3,color:black
    classDef sequential fill:#FFD2B3,color:black

    parallel(parallel):::parallel 
    sequential(sequential):::sequential 

    subgraph generate
        direction TB
        gen_A(startBuild):::parallel 
        --> gen_B(transform):::sequential
        --> gen_C(buildEnd):::parallel
    end

    A[start] --> B(resolveConfig) --> generate  --> E[write files]

Loading

Client plugin

Adds a client plugin called openapiFetchPlugin. This plugin re-exports openapi-fetch.

Config:

import { defineConfig } from "@workleap/create-schemas";
import { openapiFetchPlugin } from "@workleap/create-schemas/plugins";

export default defineConfig({
    input: "v1.yaml",
    outdir: "src/codegen/v1",
    plugins: [openapiFetchPlugin()]
});

Usage

import { createClient } from "./codegen/v1/client.ts";

const client = createClient({ baseUrl: "https://api.example.com" });

const { data, error } = await client.GET("/good-vibes-points/{userId}", { params: { path: { userId: "123" } } });

if (error) {
    console.error(error.title);
    console.error(error.detail);
}

if (data?.point) {
    console.log(`You have ${data.point} good vibes points!`);
}

Breaking changes

• outfile is now outdir. This change is required to allow the tool to output more than one file.

Additional checks

• Updated the documentation of the project to reflect the changes
  • No, but soon. Next pull-request will include documentation.
• Added new tests that cover the code changes