docs/scripts/typedoc.js

#!/usr/bin/env node

/* eslint-disable no-console */

const fs = require('fs')
const typedoc = require('typedoc')
const typescript = require('typescript')
const squidJsPackage = require('../external/squid-js/package.json')
const { exec } = require('child_process')

const { description, version } = squidJsPackage

// Setup our paths, relative to project root
const outPath = './data/squid-js.json'
const files = ['./external/squid-js/src/squid.ts']

// specifically point to tsconfig, otherwise TypeDoc fails
const config = typescript.findConfigFile(
    './external/squid-js',
    typescript.sys.fileExists
)

// npm install for squid-js
console.log('Installing submodule dependencies...')
const install = exec(
    'cd ./external/squid-js && npm i && git checkout package-lock.json'
)

install.on('exit', () => {
    generateJson()
})

const generateJson = () => {
    console.log('Generating TypeDoc json...')

    // Setup our TypeDoc app
    const app = new typedoc.Application({
        tsconfig: config
    })

    const src = app.expandInputFiles(files)
    const project = app.convert(src)

    // Generate the JSON file
    app.generateJson(project, outPath)

    // Parse and modify json output
    const jsonOrig = JSON.parse(fs.readFileSync(outPath, 'utf8')) // eslint-disable-line

    const jsonFinal = {
        info: {
            title: 'Squid-js',
            description,
            version,
            sourceUrl:
                'https://github.com/oceanprotocol/squid-js/tree/develop/src/'
        },
        ...jsonOrig
    }

    fs.writeFileSync(outPath, JSON.stringify(jsonFinal, null, 4)) // eslint-disable-line
}