typescript definitions - howto

[simllll]

typescript definitions - howto

[apiology]

For what it's worth, I also took a crack at improving the official definitions, at least for the issues that were impacting me. The process to improve those is well defined and documented in the DefinitelyTyped repo, if a bit slow on the approval side due to lack of types/asana maintainers: DefinitelyTyped/DefinitelyTyped#57226

[alexnitta]

@simllll - This was super helpful, thank you.

As a note to anyone else coming across this, steps I took to solve the problem:

1. Run npm install -d @openapitools/openapi-generator-cli
2. Add a package.json script called generate-asana-apis containing: openapi-generator-cli generate -p apiPackage=apipkg -p modelPackage=modelPkg -p withSeparateModelsAndApi=true -p modelPropertyNaming=original -p supportsES6=true -i https://raw.githubusercontent.com/Asana/developer-docs/master/defs/asana_oas.yaml -g typescript-axios -o src/AsanaClient --skip-validate-spec
3. Run node run generate-asana-apis

If you run into this error when trying to run node run generate-asana-apis:

Error: The operation couldn’t be completed. Unable to locate a Java Runtime.

you can install a Java Runtime with brew install java. Note the output from brew install java may include something like:

For the system Java wrappers to find this JDK, symlink it with
  sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

Go ahead and run that sudo ln ... command, and then run node run generate-asana-apis again.

[apiology]

Another round of improvements is going in soon: DefinitelyTyped/DefinitelyTyped#60589