apidoc-plugin-ts-enum

1.0.3 • Public • Published

apidoc-plugin-ts

Build Status npm Greenkeeper badge

A plugin for apidoc that injects @apiSuccess params from TypeScript interfaces. Supports extended and nested interfaces.

Getting started

npm install --save-dev apidoc apidoc-plugin-ts-enum
yarn add -D apidoc apidoc-plugin-ts-enum

A custom api-doc param @apiInterface is exposed:

@apiInterface (optional path to definitions file) {INTERFACE_NAME}

Example

Given the following interface:

// filename: ./employers.ts

export interface Employer {
  /**
   * Employer job title
   */
  jobTitle: string;
  /**
   * Employer personal details
   */
  personalDetails: {
    name: string;
    age: number;
  }
}

and the following custom param:

@apiInterface (./employers.ts) {Person}

under the hood this would transpile to:

@apiSuccess {String} jobTitle Job title
@apiSuccess {Object} personalDetails Empoyer personal details
@apiSuccess {String} personalDetails.name
@apiSuccess {Number} personalDetails.age

Note if the Person interface is defined in the same file then you can drop the path:

@apiInterface {Person}

/apidoc-plugin-ts-enum/

    Package Sidebar

    Install

    npm i apidoc-plugin-ts-enum

    Weekly Downloads

    4

    Version

    1.0.3

    License

    MIT

    Unpacked Size

    16.1 kB

    Total Files

    4

    Last publish

    Collaborators

    • tiant167