Add core files.

Author: mattcollier

.eslintrc.js

@@ -0,0 +1,8 @@
+module.exports = {
+  root: true,
+  extends: ['digitalbazaar'],
+  env: {
+    browser: true,
+    node: true
+  }
+};

.github/workflows/main.yml

@@ -0,0 +1,73 @@
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  test-node:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [10.x, 12.x, 14.x]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - name: Run test with Node.js ${{ matrix.node-version }}
+      run: npm run test-node
+      env:
+        CI: true
+  test-karma:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [14.x]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - name: Run karma tests
+      run: npm run test-karma
+      env:
+        CI: true
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [14.x]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - name: Run eslint
+      run: npm run lint
+  coverage:
+    needs: [test-node, test-karma]
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [14.x]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - name: Generate coverage report
+      run: npm run coverage-ci
+      env:
+        CI: true
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v1
+      with:
+        file: ./coverage/lcov.info
+        fail_ci_if_error: true

.gitignore

@@ -0,0 +1,13 @@
+*.log
+*.sw[nop]
+*~
+.cache
+.nyc_output
+.project
+.settings
+.vscode
+TAGS
+coverage
+dist
+node_modules
+reports

CHANGELOG.md

@@ -0,0 +1,8 @@
+# @digitalbazaar/http-client ChangeLog
+
+## 1.0.0 - TBD
+
+### Added
+- Add core files.
+
+- See git history for changes previous to this release.

LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2020, Digital Bazaar, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -1,2 +1,68 @@
 # http-client
 An opinionated, isomorphic HTTP client.
+
+### Usage
+
+#### Import httpClient
+```js
+import {httpClient} from '@digitalbazaar/http-client';
+```
+
+#### GET a JSON response in the browser
+```js
+try {
+  result = await httpClient.get('http://httpbin.org/json');
+  return result.data;
+} catch(e) {
+  // status is HTTP status code
+  // data is JSON error from the server
+  const {data, status} = e;
+  throw e;
+}
+```
+
+#### GET a JSON response in Node with a HTTP Agent
+```js
+import https from 'https';
+// use an agent to avoid self-signed certificate errors
+const agent = new https.agent({rejectUnauthorized: false});
+try {
+  result = await httpClient.get('http://httpbin.org/json', {agent});
+  return result.data;
+} catch(e) {
+  // status is HTTP status code
+  // data is JSON error from the server if available
+  const {data, status} = e;
+  throw e;
+}
+```
+
+#### GET HTML by overriding default headers
+```js
+const headers = {Accept: 'text/html'};
+try {
+  result = await httpClient.get('http://httpbin.org/json', {headers});
+  // see: https://developer.mozilla.org/en-US/docs/Web/API/Body#Methods
+  return result.response.text();
+} catch(e) {
+  // status is HTTP status code
+  // any message from the server can be parsed from the response if present
+  const {response, status} = e;
+  throw e;
+}
+```
+
+#### POST a JSON payload
+```js
+try {
+  result = await httpClient.post('http://httpbin.org/json', {
+    json: {some: 'data'}
+  });
+  return result.data;
+} catch(e) {
+  // status is HTTP status code
+  // data is JSON error from the server
+  const {data, status} = e;
+  throw e;
+}
+```

index.js

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) 2020 Digital Bazaar, Inc. All rights reserved.
+ */
+'use strict';
+
+// translate `main.js` to CommonJS
+require = require('esm')(module);
+module.exports = require('./main.js');

karma.conf.js

@@ -0,0 +1,123 @@
+/*
+ * Copyright (c) 2020 Digital Bazaar, Inc. All rights reserved.
+ */
+module.exports = function(config) {
+
+  config.set({
+    // base path that will be used to resolve all patterns (eg. files, exclude)
+    basePath: '',
+
+    // frameworks to use
+    // available frameworks: https://npmjs.org/browse/keyword/karma-adapter
+    frameworks: ['mocha', 'chai'],
+
+    // list of files / patterns to load in the browser
+    files: [
+      'tests/test-karma.js',
+      'tests/*.spec.js'
+    ],
+
+    // list of files to exclude
+    exclude: [],
+
+    // preprocess matching files before serving them to the browser
+    // preprocessors: https://npmjs.org/browse/keyword/karma-preprocessor
+    preprocessors: {
+      //'tests/*.js': ['webpack', 'babel', 'sourcemap']
+      'tests/*.js': ['webpack', 'sourcemap']
+    },
+
+    webpack: {
+      //mode: 'production',
+      mode: 'development',
+      devtool: 'inline-source-map',
+      module: {
+        rules: [
+          /*
+          {
+            test: /\.js$/,
+            include: [{
+              // exclude node_modules by default
+              exclude: /(node_modules)/
+            }],
+            use: {
+              loader: 'babel-loader',
+              options: {
+                presets: ['@babel/preset-env'],
+                plugins: [
+                  '@babel/plugin-transform-modules-commonjs',
+                  '@babel/plugin-transform-runtime'
+                ]
+              }
+            }
+          }
+          */
+        ]
+      },
+      node: {
+        Buffer: false,
+        process: false,
+        crypto: false,
+        setImmediate: false
+      }
+    },
+
+    // test results reporter to use
+    // possible values: 'dots', 'progress'
+    // available reporters: https://npmjs.org/browse/keyword/karma-reporter
+    //reporters: ['progress'],
+    reporters: ['mocha'],
+
+    // web server port
+    port: 9876,
+
+    // enable / disable colors in the output (reporters and logs)
+    colors: true,
+
+    // level of logging
+    // possible values: config.LOG_DISABLE || config.LOG_ERROR ||
+    //   config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
+    logLevel: config.LOG_INFO,
+
+    // enable / disable watching file and executing tests whenever any
+    // file changes
+    autoWatch: false,
+
+    // start these browsers
+    // browser launchers: https://npmjs.org/browse/keyword/karma-launcher
+    //browsers: ['ChromeHeadless', 'Chrome', 'Firefox', 'Safari'],
+    browsers: ['ChromeHeadless'],
+
+    customLaunchers: {
+      IE9: {
+        base: 'IE',
+        'x-ua-compatible': 'IE=EmulateIE9'
+      },
+      IE8: {
+        base: 'IE',
+        'x-ua-compatible': 'IE=EmulateIE8'
+      }
+    },
+
+    // Continuous Integration mode
+    // if true, Karma captures browsers, runs the tests and exits
+    singleRun: true,
+
+    // Concurrency level
+    // how many browser should be started simultaneous
+    concurrency: Infinity,
+
+    // Mocha
+    client: {
+      mocha: {
+        // increase from default 2s
+        timeout: 10000,
+        reporter: 'html'
+        //delay: true
+      }
+    },
+
+    // Proxied paths
+    proxies: {}
+  });
+};