ENG-1497 Feat: Codegen implementation in api package

[rahulr8]

Affected Packages

• portal
• 1ui
• protocol
• api

Overview

This PR setups a library under packages/api/api-client that contains the Typescript client to interface with the backend. There are two generated files that are of particular importance

1. services.gen.ts - All API calls to the backend wrapped in functions and using axios
2. types.gen.ts - TypeScript interfaces to model data from the backend

These can be imported into any app or package in the mono-repo in order to better facilitate seamless interfacing with the backend.

Testing

Run pnpm install to install latest dependencies.

For testing, I created a test route which you can hit. It has the following loader. You can go to localhost:3000/test to access it and check your server logs.

  OpenAPI.BASE = 'https://dev.api.intuition.systems'
  const { accessToken } = await requireAuthedUser(request)
  const headers = getAuthHeaders(accessToken !== null ? accessToken : '')
  OpenAPI.HEADERS = headers as Record<string, string>

  const test = await IdentitiesService.getIdentities({
    paging: {
      page: 1,
      limit: 10,
      offset: 0,
    },
    sort: {
      sortBy: 'IdentityId',
      direction: 'asc',
    },
  })

  console.log('test api call response', test)

  return json({
    hello: 'world',
  })
}

You should see the following logs

Declaration

• I hereby declare that I have abided by the rules and regulations as outlined in the CONTRIBUTING.md

[linear]

ENG-1497 [Spike] Setup codegen with OpenAPI

TLDR:

Use the openapi.json to generate models, types, and API calls on the front-end

Context

https://intuition-systems.slack.com/archives/C070UVDVB5X/p1715355180943489

[simonas-notcat]

@rahulr8 is the plan to eventually move this to packages/api as described in #15 ?