open-index/open-npm huggingface dataset:
npm package: @js8path/annotated-error
Description: Javascript Error class with added data
Author: Jeff Kunce, N0JUH
Latest version: 1.0.0

# annotated-error
Javascript Error class with added data

## Usage

### annotated-error javascript module

Usage:

```javascript
import AnnotatedError from '@js8path/annotated-error'

// usage 
// new AnnotatedError([opts,] [msg[, ...addlParams]])
// opts is object containing these optional values
//   name: error name. Default 'Error'. Will be found in new err object as err.name
//   data: Any data. Default null. Will be found in new err object as err.data 
//   message: Any string message. Default ''. Will be found in new err object as err.message
// msg: if present, will override opts.message 

// typical usage example
try {
  throw new AnnotatedError({
    name: 'MyTestErrorType',
    data: { some: 'thing', any: 'where'},
    message: 'typical usage'
  })
} catch(err) {
  console.log(err.name) // MyTestErrorType
  console.log(String(err)) // MyTestErrorType: typical usage
  console.log(JSON.stringify(err.data)) // {"some":"thing","any":"where"}
}

// same behavior as Error of no opts object given
try {
  throw new AnnotatedError('mimics Error')
} catch(err) {
  console.log(err.name) // Error
  console.log(String(err)) // Error: mimics Error
}

// default name is Error, explicit message param overrides opts.message
try {
  throw new AnnotatedError(
    {
      data: { some: 'thing', any: 'where'},
      message: 'opt message'
    },
    'explicit message'
  )
} catch(err) {
  console.log(err.name) // Error
  console.log(String(err)) // Error: explicit message
  console.log(JSON.stringify(err.data)) // {"some":"thing","any":"where"}
}
```

## Development

### development process

Prepare package for development with
  `yarn install`

Run unit tests and coverage once 
  `yarn run test`

Build distribution files 
  `yarn run build`

Start continuous testing with: 
  `yarn run dev`

This will open a web-browser screen with unit test results. 
The tests are re-run every time that changed source code is saved. 

## License

MIT, ©2020, Correspondence Technologies, LLC
npm package: @js8path/js8path-data
Description: Shared structures, validators, and utilities for js8path data
Author: Jeff Kunce, N0JUH
Latest version: 1.0.0

# js8path-data
Shared structures, validators, and utilities for js8path data.

## Usage

### js8path-data javascript module

Usage:

`import js8pathData from '@js8path/js8path-data'`
- js8pathData.valdators.*: validates js8path data
- js8pathData.schema.*: JSON Schema definitions for js8path data
- js8pathData.exampleData.*: examples of js8path data

```javascript
// import js8pathData from '@js8path/js8path-data'
```

## Development

### development process

Prepare package for development with
  `yarn install`

Run unit tests and coverage once 
  `yarn run test`

Build distribution files 
  `yarn run build`

Start continuous testing with: 
  `yarn run dev`

This will open a web-browser screen with unit test results. 
The tests are re-run every time that changed source code is saved. 

## License

MIT, ©2020, Correspondence Technologies, LLC
npm package: @js8path/js8path-pskreporter
Description: PSK Reporter queries for JS8Path
Author: Jeff Kunce, N0JUH
Latest version: 1.0.0

# @js8path/js8path-pskreporter
PSK Reporter queries for JS8Path

## Usage

### @js8path/js8path-pskreporter javascript module

Usage:

`import js8pathPskreporter from '@js8path/js8path-pskreporter'`
- js8pathPskreporter.net.*: queries pskreporter web service and returns result
- js8pathPskreporter.transform.*: parses pskreporter web service response
- js8pathPskreporter.valdators.*: validates pskreporter request, response, and parsed responses
- js8pathPskreporter.schema.*: JSON Schema definitions for pskreporter request, response, and parsed responses
- js8pathPskreporter.exampleData.*: examples of pskreporter request, response, and parsed responses

```javascript
import js8pathPskreporter from '@js8path/js8path-pskreporter'

// query latest data from PSKReporter
// request schema: js8pathPskreporter.schema.query.requestData
// response schema: js8pathPskreporter.schema.appData.queryResponse
js8pathPskreporter.net.queryAppData({
  flowStartSeconds: -600, // 10 minutes
  rptlimit: 1000, // max 1000 records
}).then(function(appData) {
  console.log(appData.receptionReports.length) // 2021
  console.log(JSON.stringify(appData.receptionReports[0]))
   /*
    {
      "receiverCallsign":"SP2GPU",
      "receiverLocator":"JO94fo",
      "senderCallsign":"W7DO",
      "senderLocator":"EM94nf",
      "frequencyHz":18102356,
      "flowStartSeconds":"1559476847",
      "mode":"FT8",
      "senderDXCC":"United States",
      "senderDXCCCode":"K",
      "senderDXCCLocator":"EM47",
      "senderLotwUpload":"2019-05-01",
      "senderEqslAuthGuar":"A",
      "sNRString":"-18",
      "sNR":-18
    }
  */
})

```

## Development

### development process

Prepare package for development with
  `yarn install`

Run unit tests and coverage once 
  `yarn run test`

Build distribution files 
  `yarn run build`

Start continuous testing with: 
  `yarn run dev`

This will open a web-browser screen with unit test results. 
The tests are re-run every time that changed source code is saved. 

## License

MIT, ©2020, Correspondence Technologies, LLC
npm package: @js8path/js8path-route
Description: Route calculations for JS8Path
Author: Jeff Kunce, N0JUH
Latest version: 1.0.1

# @js8path/js8path-route
Route calculations for JS8Path 

## Usage

### @js8path/jspath-route javascript module

Usage:
## FixMe: write this

## Development

### development process

Prepare package for development with
  `yarn install`

Run unit tests and coverage once 
  `yarn run test`

Build distribution files 
  `yarn run build`

Start continuous testing with: 
  `yarn run dev`

This will open a web-browser screen with unit test results. 
The tests are re-run every time that changed source code is saved. 

## License

MIT, ©2020, Correspondence Technologies, LLC
npm package: @js8path/js8path-test-data
Description: Test data matching schemas in @js8path/js8path-data
Author: Jeff Kunce, N0JUH
Latest version: 1.0.0

# js8path-test-data
Test data matching schemas in @js8path/js8path-data

## Usage

### @js8path/js8path-test-data javascript module

Usage:

`import js8pathTestData from '@js8path/js8path-test-data'`
- js8pathTestData.rawXml: raw XML data from pskreporter
- js8pathTestData.reporterAppData: js8path-pskreporter "appData" decoded from rawXml
- js8pathTestData.js8pathData: js8path-data reports

## Development

### development process

Prepare package for development with
  `yarn install`

Fetch and compile test data source with 
  `yarn run fetch`

Run unit tests and coverage once 
  `yarn run test`

Build distribution files 
  `yarn run build`

Start continuous testing with: 
  `yarn run dev`

This will open a web-browser screen with unit test results. 
The tests are re-run every time that changed source code is saved. 

## License

MIT, ©2019, Correspondence Technologies, LLC
npm package: @js8path/js8path-vue
Description: Vue.js web UI for JS8Path
Author: Jeff Kunce, N0JUH
Latest version: 1.0.0

# @js8path/js8path-vue
Vue.js web UI for JS8Path

JS8Path tracks JS8Call reports on pskreporter.
 - searches for reports for specific stations
 - shows time and strength of individual reports
 - maps reports
 - analyzes potential relay paths

## Project setup
```
yarn install
```

### Compiles and hot-reloads for development
```
yarn run serve
```

### Compiles and minifies for production
```
yarn run build
```

### Run your tests
```
yarn run test
```

### Lints and fixes files
```
yarn run lint
```

### workspace dependencies
- @js8path/js8path-vue
- @js8path/js8path-data
    - @js8path/annotated-error
- @js8path/js8path-pskreporter
    - @js8path/annotated-error
    - @js8path/js8path-data
- @js8path/js8path-route
    - @js8path/annotated-error
    - @js8path/js8path-data
    - @js8path/js8path-test-data
- js8path-test-data
    - @js8path/annotated-error
    - @js8path/js8path-data
    - @js8path/js8path-pskreporter
    
## Documentation Generation
Install JsDoc and Vuese Globally
```
yarn global add jsdoc @vuese/cli
```

To Generate Docs (in ./docs/jsdoc/ and ./docs/vuese/)
```
yarn run docgen
```

To launch documentation servers and open chrome to view them
```
yarn run docserve
```

### Customize configuration
See [Configuration Reference](https://cli.vuejs.org/config/).