CWMSjs

CWMS Data API (CDA) client library created with OpenAPI generator in TypeScript for use with web browsers.

Getting Started

• Install CWMSjs to your react project with:
  npm install cwmsjs
  (This will grab the latest)

• Import the API endpoint you wish to use:

  • Avaiable endpoints are here (Classes ending in API): Endpoints
  • At the top of your js/jsx/file type:

    import { TimeSeriesAPI } from "cwmsjs";
    Copy

  • Then initialize the TimeSeriesAPI with:

    const ts_api = new TimeSeriesAPI();
    Copy

  • Fetch time series data with:

    await ts_api
      .getTimeSeries({
        office: "SWT",
        name: "KEYS.Elev.Inst.1Hour.0.Ccp-Rev",
      })
      .then((data) => {
        console.log(data);
      })
      .catch((e) => {
        console.log("My Error", e);
      });
    Copy

Documentation is available for both developers and new users:

• New Users : Examples
• Advanced users : Type Documentation / Developer Docs

Developers

Versioning

In order to accommodate changes both to the generator and to CDA itself, cwmsjs is versioned in the following format: [generator SemVer]-[generation date]

CDA is expected to at some point expose a CalVer for the latest update. When this is available, the generation date will be replaced with the current CDA CalVer.

Publishing

Contributors with authorization can publish a new version of cwmsjs by manually running the "Build, Test, and Publish" GitHub Action.

The workflow will build an updated cwmsjs library using the current generator and national CDA instance OpenAPI spec. If all tests pass, the library will be published to npm and updated documentation will be deployed to GitHub Pages.

Building CWMSjs from source

• Clone this repository
• Install dependencies with: npm install
• Run the generator with: npm run build

All generated files (source, library, and docs) will be in [repo]/cwmsjs