openapi_iplocation 1.0.0

package/README.md

@@ -0,0 +1,141 @@
+# openapi_iplocation
+
+OpenapiIplocation - JavaScript client for openapi_iplocation
+OpenAPI v3 specification and a set of generated API clients for iplocation.net
+This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
+
+- API version: 1.0.0
+- Package version: 1.0.0
+- Generator version: 7.6.0
+- Build package: org.openapitools.codegen.languages.JavascriptClientCodegen
+For more information, please visit [https://github.com/oapicf/openapi-iplocation](https://github.com/oapicf/openapi-iplocation)
+
+## Installation
+
+### For [Node.js](https://nodejs.org/)
+
+#### npm
+
+To publish the library as a [npm](https://www.npmjs.com/), please follow the procedure in ["Publishing npm packages"](https://docs.npmjs.com/getting-started/publishing-npm-packages).
+
+Then install it via:
+
+```shell
+npm install openapi_iplocation --save
+```
+
+Finally, you need to build the module:
+
+```shell
+npm run build
+```
+
+##### Local development
+
+To use the library locally without publishing to a remote npm registry, first install the dependencies by changing into the directory containing `package.json` (and this README). Let's call this `JAVASCRIPT_CLIENT_DIR`. Then run:
+
+```shell
+npm install
+```
+
+Next, [link](https://docs.npmjs.com/cli/link) it globally in npm with the following, also from `JAVASCRIPT_CLIENT_DIR`:
+
+```shell
+npm link
+```
+
+To use the link you just defined in your project, switch to the directory you want to use your openapi_iplocation from, and run:
+
+```shell
+npm link /path/to/<JAVASCRIPT_CLIENT_DIR>
+```
+
+Finally, you need to build the module:
+
+```shell
+npm run build
+```
+
+#### git
+
+If the library is hosted at a git repository, e.g.https://github.com/oapicf/openapi-iplocation
+then install it via:
+
+```shell
+    npm install oapicf/openapi-iplocation --save
+```
+
+### For browser
+
+The library also works in the browser environment via npm and [browserify](http://browserify.org/). After following
+the above steps with Node.js and installing browserify with `npm install -g browserify`,
+perform the following (assuming *main.js* is your entry file):
+
+```shell
+browserify main.js > bundle.js
+```
+
+Then include *bundle.js* in the HTML pages.
+
+### Webpack Configuration
+
+Using Webpack you may encounter the following error: "Module not found: Error:
+Cannot resolve module", most certainly you should disable AMD loader. Add/merge
+the following section to your webpack config:
+
+```javascript
+module: {
+  rules: [
+    {
+      parser: {
+        amd: false
+      }
+    }
+  ]
+}
+```
+
+## Getting Started
+
+Please follow the [installation](#installation) instruction and execute the following JS code:
+
+```javascript
+var OpenapiIplocation = require('openapi_iplocation');
+
+
+var api = new OpenapiIplocation.DefaultApi()
+var ip = "ip_example"; // {String} An IPv4 or IPv6 address that you would like to lookup.
+var opts = {
+  'format': "format_example", // {String} Output format, the following formats are supported: plain xml json jsonp php csv serialized
+  'delimiter': "delimiter_example" // {String} Delimiter between proxies. Can be used only with format plain. The following types are supported: 1 for \"\\n\", 2 for \"<br>\".
+};
+var callback = function(error, data, response) {
+  if (error) {
+    console.error(error);
+  } else {
+    console.log('API called successfully. Returned data: ' + data);
+  }
+};
+api.rootGet(ip, opts, callback);
+
+```
+
+## Documentation for API Endpoints
+
+All URIs are relative to *https://api.iplocation.net*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*OpenapiIplocation.DefaultApi* | [**rootGet**](docs/DefaultApi.md#rootGet) | **GET** / | Get geolocation of an IP address
+
+
+## Documentation for Models
+
+ - [OpenapiIplocation.Get200Response](docs/Get200Response.md)
+ - [OpenapiIplocation.Get400Response](docs/Get400Response.md)
+
+
+## Documentation for Authorization
+
+Endpoints do not require authorization.
+

package/dist/ApiClient.js

@@ -0,0 +1,695 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _superagent = _interopRequireDefault(require("superagent"));
+var _querystring = _interopRequireDefault(require("querystring"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * iplocation.net API
+ * OpenAPI v3 specification and a set of generated API clients for iplocation.net
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: blah+oapicf@cliffano.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* @module ApiClient
+* @version 1.0.0
+*/
+/**
+* Manages low level client-server communications, parameter marshalling, etc. There should not be any need for an
+* application to use this class directly - the *Api and model classes provide the public API for the service. The
+* contents of this file should be regarded as internal but are documented for completeness.
+* @alias module:ApiClient
+* @class
+*/
+var ApiClient = /*#__PURE__*/function () {
+  /**
+   * The base URL against which to resolve every API call's (relative) path.
+   * Overrides the default value set in spec file if present
+   * @param {String} basePath
+   */
+  function ApiClient() {
+    var basePath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'https://api.iplocation.net';
+    _classCallCheck(this, ApiClient);
+    /**
+     * The base URL against which to resolve every API call's (relative) path.
+     * @type {String}
+     * @default https://api.iplocation.net
+     */
+    this.basePath = basePath.replace(/\/+$/, '');
+
+    /**
+     * The authentication methods to be included for all API calls.
+     * @type {Array.<String>}
+     */
+    this.authentications = {};
+
+    /**
+     * The default HTTP headers to be included for all API calls.
+     * @type {Array.<String>}
+     * @default {}
+     */
+    this.defaultHeaders = {
+      'User-Agent': 'OpenAPI-Generator/1.0.0/Javascript'
+    };
+
+    /**
+     * The default HTTP timeout for all API calls.
+     * @type {Number}
+     * @default 60000
+     */
+    this.timeout = 60000;
+
+    /**
+     * If set to false an additional timestamp parameter is added to all API GET calls to
+     * prevent browser caching
+     * @type {Boolean}
+     * @default true
+     */
+    this.cache = true;
+
+    /**
+     * If set to true, the client will save the cookies from each server
+     * response, and return them in the next request.
+     * @default false
+     */
+    this.enableCookies = false;
+
+    /*
+     * Used to save and return cookies in a node.js (non-browser) setting,
+     * if this.enableCookies is set to true.
+     */
+    if (typeof window === 'undefined') {
+      this.agent = new _superagent["default"].agent();
+    }
+
+    /*
+     * Allow user to override superagent agent
+     */
+    this.requestAgent = null;
+
+    /*
+     * Allow user to add superagent plugins
+     */
+    this.plugins = null;
+  }
+
+  /**
+  * Returns a string representation for an actual parameter.
+  * @param param The actual parameter.
+  * @returns {String} The string representation of <code>param</code>.
+  */
+  return _createClass(ApiClient, [{
+    key: "paramToString",
+    value: function paramToString(param) {
+      if (param == undefined || param == null) {
+        return '';
+      }
+      if (param instanceof Date) {
+        return param.toJSON();
+      }
+      if (ApiClient.canBeJsonified(param)) {
+        return JSON.stringify(param);
+      }
+      return param.toString();
+    }
+
+    /**
+    * Returns a boolean indicating if the parameter could be JSON.stringified
+    * @param param The actual parameter
+    * @returns {Boolean} Flag indicating if <code>param</code> can be JSON.stringified
+    */
+  }, {
+    key: "buildUrl",
+    value:
+    /**
+     * Builds full URL by appending the given path to the base URL and replacing path parameter place-holders with parameter values.
+     * NOTE: query parameters are not handled here.
+     * @param {String} path The path to append to the base URL.
+     * @param {Object} pathParams The parameter values to append.
+     * @param {String} apiBasePath Base path defined in the path, operation level to override the default one
+     * @returns {String} The encoded path with parameter values substituted.
+     */
+    function buildUrl(path, pathParams, apiBasePath) {
+      var _this = this;
+      if (!path.match(/^\//)) {
+        path = '/' + path;
+      }
+      var url = this.basePath + path;
+
+      // use API (operation, path) base path if defined
+      if (apiBasePath !== null && apiBasePath !== undefined) {
+        url = apiBasePath + path;
+      }
+      url = url.replace(/\{([\w-\.#]+)\}/g, function (fullMatch, key) {
+        var value;
+        if (pathParams.hasOwnProperty(key)) {
+          value = _this.paramToString(pathParams[key]);
+        } else {
+          value = fullMatch;
+        }
+        return encodeURIComponent(value);
+      });
+      return url;
+    }
+
+    /**
+    * Checks whether the given content type represents JSON.<br>
+    * JSON content type examples:<br>
+    * <ul>
+    * <li>application/json</li>
+    * <li>application/json; charset=UTF8</li>
+    * <li>APPLICATION/JSON</li>
+    * </ul>
+    * @param {String} contentType The MIME content type to check.
+    * @returns {Boolean} <code>true</code> if <code>contentType</code> represents JSON, otherwise <code>false</code>.
+    */
+  }, {
+    key: "isJsonMime",
+    value: function isJsonMime(contentType) {
+      return Boolean(contentType != null && contentType.match(/^application\/json(;.*)?$/i));
+    }
+
+    /**
+    * Chooses a content type from the given array, with JSON preferred; i.e. return JSON if included, otherwise return the first.
+    * @param {Array.<String>} contentTypes
+    * @returns {String} The chosen content type, preferring JSON.
+    */
+  }, {
+    key: "jsonPreferredMime",
+    value: function jsonPreferredMime(contentTypes) {
+      for (var i = 0; i < contentTypes.length; i++) {
+        if (this.isJsonMime(contentTypes[i])) {
+          return contentTypes[i];
+        }
+      }
+      return contentTypes[0];
+    }
+
+    /**
+    * Checks whether the given parameter value represents file-like content.
+    * @param param The parameter to check.
+    * @returns {Boolean} <code>true</code> if <code>param</code> represents a file.
+    */
+  }, {
+    key: "isFileParam",
+    value: function isFileParam(param) {
+      // fs.ReadStream in Node.js and Electron (but not in runtime like browserify)
+      if (typeof require === 'function') {
+        var fs;
+        try {
+          fs = require('fs');
+        } catch (err) {}
+        if (fs && fs.ReadStream && param instanceof fs.ReadStream) {
+          return true;
+        }
+      }
+
+      // Buffer in Node.js
+      if (typeof Buffer === 'function' && param instanceof Buffer) {
+        return true;
+      }
+
+      // Blob in browser
+      if (typeof Blob === 'function' && param instanceof Blob) {
+        return true;
+      }
+
+      // File in browser (it seems File object is also instance of Blob, but keep this for safe)
+      if (typeof File === 'function' && param instanceof File) {
+        return true;
+      }
+      return false;
+    }
+
+    /**
+    * Normalizes parameter values:
+    * <ul>
+    * <li>remove nils</li>
+    * <li>keep files and arrays</li>
+    * <li>format to string with `paramToString` for other cases</li>
+    * </ul>
+    * @param {Object.<String, Object>} params The parameters as object properties.
+    * @returns {Object.<String, Object>} normalized parameters.
+    */
+  }, {
+    key: "normalizeParams",
+    value: function normalizeParams(params) {
+      var newParams = {};
+      for (var key in params) {
+        if (params.hasOwnProperty(key) && params[key] != undefined && params[key] != null) {
+          var value = params[key];
+          if (this.isFileParam(value) || Array.isArray(value)) {
+            newParams[key] = value;
+          } else {
+            newParams[key] = this.paramToString(value);
+          }
+        }
+      }
+      return newParams;
+    }
+
+    /**
+    * Builds a string representation of an array-type actual parameter, according to the given collection format.
+    * @param {Array} param An array parameter.
+    * @param {module:ApiClient.CollectionFormatEnum} collectionFormat The array element separator strategy.
+    * @returns {String|Array} A string representation of the supplied collection, using the specified delimiter. Returns
+    * <code>param</code> as is if <code>collectionFormat</code> is <code>multi</code>.
+    */
+  }, {
+    key: "buildCollectionParam",
+    value: function buildCollectionParam(param, collectionFormat) {
+      if (param == null) {
+        return null;
+      }
+      switch (collectionFormat) {
+        case 'csv':
+          return param.map(this.paramToString, this).join(',');
+        case 'ssv':
+          return param.map(this.paramToString, this).join(' ');
+        case 'tsv':
+          return param.map(this.paramToString, this).join('\t');
+        case 'pipes':
+          return param.map(this.paramToString, this).join('|');
+        case 'multi':
+          //return the array directly as SuperAgent will handle it as expected
+          return param.map(this.paramToString, this);
+        case 'passthrough':
+          return param;
+        default:
+          throw new Error('Unknown collection format: ' + collectionFormat);
+      }
+    }
+
+    /**
+    * Applies authentication headers to the request.
+    * @param {Object} request The request object created by a <code>superagent()</code> call.
+    * @param {Array.<String>} authNames An array of authentication method names.
+    */
+  }, {
+    key: "applyAuthToRequest",
+    value: function applyAuthToRequest(request, authNames) {
+      var _this2 = this;
+      authNames.forEach(function (authName) {
+        var auth = _this2.authentications[authName];
+        switch (auth.type) {
+          case 'basic':
+            if (auth.username || auth.password) {
+              request.auth(auth.username || '', auth.password || '');
+            }
+            break;
+          case 'bearer':
+            if (auth.accessToken) {
+              var localVarBearerToken = typeof auth.accessToken === 'function' ? auth.accessToken() : auth.accessToken;
+              request.set({
+                'Authorization': 'Bearer ' + localVarBearerToken
+              });
+            }
+            break;
+          case 'apiKey':
+            if (auth.apiKey) {
+              var data = {};
+              if (auth.apiKeyPrefix) {
+                data[auth.name] = auth.apiKeyPrefix + ' ' + auth.apiKey;
+              } else {
+                data[auth.name] = auth.apiKey;
+              }
+              if (auth['in'] === 'header') {
+                request.set(data);
+              } else {
+                request.query(data);
+              }
+            }
+            break;
+          case 'oauth2':
+            if (auth.accessToken) {
+              request.set({
+                'Authorization': 'Bearer ' + auth.accessToken
+              });
+            }
+            break;
+          default:
+            throw new Error('Unknown authentication type: ' + auth.type);
+        }
+      });
+    }
+
+    /**
+     * Deserializes an HTTP response body into a value of the specified type.
+     * @param {Object} response A SuperAgent response object.
+     * @param {(String|Array.<String>|Object.<String, Object>|Function)} returnType The type to return. Pass a string for simple types
+     * or the constructor function for a complex type. Pass an array containing the type name to return an array of that type. To
+     * return an object, pass an object with one property whose name is the key type and whose value is the corresponding value type:
+     * all properties on <code>data<code> will be converted to this type.
+     * @returns A value of the specified type.
+     */
+  }, {
+    key: "deserialize",
+    value: function deserialize(response, returnType) {
+      if (response == null || returnType == null || response.status == 204) {
+        return null;
+      }
+
+      // Rely on SuperAgent for parsing response body.
+      // See http://visionmedia.github.io/superagent/#parsing-response-bodies
+      var data = response.body;
+      if (data == null || _typeof(data) === 'object' && typeof data.length === 'undefined' && !Object.keys(data).length) {
+        // SuperAgent does not always produce a body; use the unparsed response as a fallback
+        data = response.text;
+      }
+      return ApiClient.convertToType(data, returnType);
+    }
+
+    /**
+     * Callback function to receive the result of the operation.
+     * @callback module:ApiClient~callApiCallback
+     * @param {String} error Error message, if any.
+     * @param data The data returned by the service call.
+     * @param {String} response The complete HTTP response.
+     */
+
+    /**
+     * Invokes the REST service using the supplied settings and parameters.
+     * @param {String} path The base URL to invoke.
+     * @param {String} httpMethod The HTTP method to use.
+     * @param {Object.<String, String>} pathParams A map of path parameters and their values.
+     * @param {Object.<String, Object>} queryParams A map of query parameters and their values.
+     * @param {Object.<String, Object>} headerParams A map of header parameters and their values.
+     * @param {Object.<String, Object>} formParams A map of form parameters and their values.
+     * @param {Object} bodyParam The value to pass as the request body.
+     * @param {Array.<String>} authNames An array of authentication type names.
+     * @param {Array.<String>} contentTypes An array of request MIME types.
+     * @param {Array.<String>} accepts An array of acceptable response MIME types.
+     * @param {(String|Array|ObjectFunction)} returnType The required type to return; can be a string for simple types or the
+     * constructor for a complex type.
+     * @param {String} apiBasePath base path defined in the operation/path level to override the default one
+     * @param {module:ApiClient~callApiCallback} callback The callback function.
+     * @returns {Object} The SuperAgent request object.
+     */
+  }, {
+    key: "callApi",
+    value: function callApi(path, httpMethod, pathParams, queryParams, headerParams, formParams, bodyParam, authNames, contentTypes, accepts, returnType, apiBasePath, callback) {
+      var _this3 = this;
+      var url = this.buildUrl(path, pathParams, apiBasePath);
+      var request = (0, _superagent["default"])(httpMethod, url);
+      if (this.plugins !== null) {
+        for (var index in this.plugins) {
+          if (this.plugins.hasOwnProperty(index)) {
+            request.use(this.plugins[index]);
+          }
+        }
+      }
+
+      // apply authentications
+      this.applyAuthToRequest(request, authNames);
+
+      // set query parameters
+      if (httpMethod.toUpperCase() === 'GET' && this.cache === false) {
+        queryParams['_'] = new Date().getTime();
+      }
+      request.query(this.normalizeParams(queryParams));
+
+      // set header parameters
+      request.set(this.defaultHeaders).set(this.normalizeParams(headerParams));
+
+      // set requestAgent if it is set by user
+      if (this.requestAgent) {
+        request.agent(this.requestAgent);
+      }
+
+      // set request timeout
+      request.timeout(this.timeout);
+      var contentType = this.jsonPreferredMime(contentTypes);
+      if (contentType) {
+        // Issue with superagent and multipart/form-data (https://github.com/visionmedia/superagent/issues/746)
+        if (contentType != 'multipart/form-data') {
+          request.type(contentType);
+        }
+      }
+      if (contentType === 'application/x-www-form-urlencoded') {
+        request.send(_querystring["default"].stringify(this.normalizeParams(formParams)));
+      } else if (contentType == 'multipart/form-data') {
+        var _formParams = this.normalizeParams(formParams);
+        for (var key in _formParams) {
+          if (_formParams.hasOwnProperty(key)) {
+            var _formParamsValue = _formParams[key];
+            if (this.isFileParam(_formParamsValue)) {
+              // file field
+              request.attach(key, _formParamsValue);
+            } else if (Array.isArray(_formParamsValue) && _formParamsValue.length && this.isFileParam(_formParamsValue[0])) {
+              // multiple files
+              _formParamsValue.forEach(function (file) {
+                return request.attach(key, file);
+              });
+            } else {
+              request.field(key, _formParamsValue);
+            }
+          }
+        }
+      } else if (bodyParam !== null && bodyParam !== undefined) {
+        if (!request.header['Content-Type']) {
+          request.type('application/json');
+        }
+        request.send(bodyParam);
+      }
+      var accept = this.jsonPreferredMime(accepts);
+      if (accept) {
+        request.accept(accept);
+      }
+      if (returnType === 'Blob') {
+        request.responseType('blob');
+      } else if (returnType === 'String') {
+        request.responseType('text');
+      }
+
+      // Attach previously saved cookies, if enabled
+      if (this.enableCookies) {
+        if (typeof window === 'undefined') {
+          this.agent._attachCookies(request);
+        } else {
+          request.withCredentials();
+        }
+      }
+      request.end(function (error, response) {
+        if (callback) {
+          var data = null;
+          if (!error) {
+            try {
+              data = _this3.deserialize(response, returnType);
+              if (_this3.enableCookies && typeof window === 'undefined') {
+                _this3.agent._saveCookies(response);
+              }
+            } catch (err) {
+              error = err;
+            }
+          }
+          callback(error, data, response);
+        }
+      });
+      return request;
+    }
+
+    /**
+    * Parses an ISO-8601 string representation or epoch representation of a date value.
+    * @param {String} str The date value as a string.
+    * @returns {Date} The parsed date object.
+    */
+  }, {
+    key: "hostSettings",
+    value:
+    /**
+      * Gets an array of host settings
+      * @returns An array of host settings
+      */
+    function hostSettings() {
+      return [{
+        'url': "https://api.iplocation.net",
+        'description': "No description provided"
+      }];
+    }
+  }, {
+    key: "getBasePathFromSettings",
+    value: function getBasePathFromSettings(index) {
+      var variables = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      var servers = this.hostSettings();
+
+      // check array index out of bound
+      if (index < 0 || index >= servers.length) {
+        throw new Error("Invalid index " + index + " when selecting the host settings. Must be less than " + servers.length);
+      }
+      var server = servers[index];
+      var url = server['url'];
+
+      // go through variable and assign a value
+      for (var variable_name in server['variables']) {
+        if (variable_name in variables) {
+          var variable = server['variables'][variable_name];
+          if (!('enum_values' in variable) || variable['enum_values'].includes(variables[variable_name])) {
+            url = url.replace("{" + variable_name + "}", variables[variable_name]);
+          } else {
+            throw new Error("The variable `" + variable_name + "` in the host URL has invalid value " + variables[variable_name] + ". Must be " + server['variables'][variable_name]['enum_values'] + ".");
+          }
+        } else {
+          // use default value
+          url = url.replace("{" + variable_name + "}", server['variables'][variable_name]['default_value']);
+        }
+      }
+      return url;
+    }
+
+    /**
+    * Constructs a new map or array model from REST data.
+    * @param data {Object|Array} The REST data.
+    * @param obj {Object|Array} The target object or array.
+    */
+  }], [{
+    key: "canBeJsonified",
+    value: function canBeJsonified(str) {
+      if (typeof str !== 'string' && _typeof(str) !== 'object') return false;
+      try {
+        var type = str.toString();
+        return type === '[object Object]' || type === '[object Array]';
+      } catch (err) {
+        return false;
+      }
+    }
+  }, {
+    key: "parseDate",
+    value: function parseDate(str) {
+      if (isNaN(str)) {
+        return new Date(str.replace(/(\d)(T)(\d)/i, '$1 $3'));
+      }
+      return new Date(+str);
+    }
+
+    /**
+    * Converts a value to the specified type.
+    * @param {(String|Object)} data The data to convert, as a string or object.
+    * @param {(String|Array.<String>|Object.<String, Object>|Function)} type The type to return. Pass a string for simple types
+    * or the constructor function for a complex type. Pass an array containing the type name to return an array of that type. To
+    * return an object, pass an object with one property whose name is the key type and whose value is the corresponding value type:
+    * all properties on <code>data<code> will be converted to this type.
+    * @returns An instance of the specified type or null or undefined if data is null or undefined.
+    */
+  }, {
+    key: "convertToType",
+    value: function convertToType(data, type) {
+      if (data === null || data === undefined) return data;
+      switch (type) {
+        case 'Boolean':
+          return Boolean(data);
+        case 'Integer':
+          return parseInt(data, 10);
+        case 'Number':
+          return parseFloat(data);
+        case 'String':
+          return String(data);
+        case 'Date':
+          return ApiClient.parseDate(String(data));
+        case 'Blob':
+          return data;
+        default:
+          if (type === Object) {
+            // generic object, return directly
+            return data;
+          } else if (typeof type.constructFromObject === 'function') {
+            // for model type like User and enum class
+            return type.constructFromObject(data);
+          } else if (Array.isArray(type)) {
+            // for array type like: ['String']
+            var itemType = type[0];
+            return data.map(function (item) {
+              return ApiClient.convertToType(item, itemType);
+            });
+          } else if (_typeof(type) === 'object') {
+            // for plain object type like: {'String': 'Integer'}
+            var keyType, valueType;
+            for (var k in type) {
+              if (type.hasOwnProperty(k)) {
+                keyType = k;
+                valueType = type[k];
+                break;
+              }
+            }
+            var result = {};
+            for (var k in data) {
+              if (data.hasOwnProperty(k)) {
+                var key = ApiClient.convertToType(k, keyType);
+                var value = ApiClient.convertToType(data[k], valueType);
+                result[key] = value;
+              }
+            }
+            return result;
+          } else {
+            // for unknown type, return the data directly
+            return data;
+          }
+      }
+    }
+  }, {
+    key: "constructFromObject",
+    value: function constructFromObject(data, obj, itemType) {
+      if (Array.isArray(data)) {
+        for (var i = 0; i < data.length; i++) {
+          if (data.hasOwnProperty(i)) obj[i] = ApiClient.convertToType(data[i], itemType);
+        }
+      } else {
+        for (var k in data) {
+          if (data.hasOwnProperty(k)) obj[k] = ApiClient.convertToType(data[k], itemType);
+        }
+      }
+    }
+  }]);
+}();
+/**
+ * Enumeration of collection format separator strategies.
+ * @enum {String}
+ * @readonly
+ */
+ApiClient.CollectionFormatEnum = {
+  /**
+   * Comma-separated values. Value: <code>csv</code>
+   * @const
+   */
+  CSV: ',',
+  /**
+   * Space-separated values. Value: <code>ssv</code>
+   * @const
+   */
+  SSV: ' ',
+  /**
+   * Tab-separated values. Value: <code>tsv</code>
+   * @const
+   */
+  TSV: '\t',
+  /**
+   * Pipe(|)-separated values. Value: <code>pipes</code>
+   * @const
+   */
+  PIPES: '|',
+  /**
+   * Native array. Value: <code>multi</code>
+   * @const
+   */
+  MULTI: 'multi'
+};
+
+/**
+* The default API client implementation.
+* @type {module:ApiClient}
+*/
+ApiClient.instance = new ApiClient();
+var _default = exports["default"] = ApiClient;

package/dist/api/DefaultApi.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _Get200Response = _interopRequireDefault(require("../model/Get200Response"));
+var _Get400Response = _interopRequireDefault(require("../model/Get400Response"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * iplocation.net API
+ * OpenAPI v3 specification and a set of generated API clients for iplocation.net
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: blah+oapicf@cliffano.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* Default service.
+* @module api/DefaultApi
+* @version 1.0.0
+*/
+var DefaultApi = exports["default"] = /*#__PURE__*/function () {
+  /**
+  * Constructs a new DefaultApi. 
+  * @alias module:api/DefaultApi
+  * @class
+  * @param {module:ApiClient} [apiClient] Optional API client implementation to use,
+  * default to {@link module:ApiClient#instance} if unspecified.
+  */
+  function DefaultApi(apiClient) {
+    _classCallCheck(this, DefaultApi);
+    this.apiClient = apiClient || _ApiClient["default"].instance;
+  }
+
+  /**
+   * Callback function to receive the result of the rootGet operation.
+   * @callback module:api/DefaultApi~rootGetCallback
+   * @param {String} error Error message, if any.
+   * @param {module:model/Get200Response} data The data returned by the service call.
+   * @param {String} response The complete HTTP response.
+   */
+
+  /**
+   * Get geolocation of an IP address
+   * Retrieve geolocation of an IP address. 
+   * @param {String} ip An IPv4 or IPv6 address that you would like to lookup.
+   * @param {Object} opts Optional parameters
+   * @param {String} [format] Output format, the following formats are supported: plain xml json jsonp php csv serialized
+   * @param {String} [delimiter] Delimiter between proxies. Can be used only with format plain. The following types are supported: 1 for \"\\n\", 2 for \"<br>\".
+   * @param {module:api/DefaultApi~rootGetCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/Get200Response}
+   */
+  return _createClass(DefaultApi, [{
+    key: "rootGet",
+    value: function rootGet(ip, opts, callback) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'ip' is set
+      if (ip === undefined || ip === null) {
+        throw new Error("Missing the required parameter 'ip' when calling rootGet");
+      }
+      var pathParams = {};
+      var queryParams = {
+        'ip': ip,
+        'format': opts['format'],
+        'delimiter': opts['delimiter']
+      };
+      var headerParams = {};
+      var formParams = {};
+      var authNames = [];
+      var contentTypes = [];
+      var accepts = ['application/json'];
+      var returnType = _Get200Response["default"];
+      return this.apiClient.callApi('/', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+  }]);
+}();

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ApiClient", {
+  enumerable: true,
+  get: function get() {
+    return _ApiClient["default"];
+  }
+});
+Object.defineProperty(exports, "DefaultApi", {
+  enumerable: true,
+  get: function get() {
+    return _DefaultApi["default"];
+  }
+});
+Object.defineProperty(exports, "Get200Response", {
+  enumerable: true,
+  get: function get() {
+    return _Get200Response["default"];
+  }
+});
+Object.defineProperty(exports, "Get400Response", {
+  enumerable: true,
+  get: function get() {
+    return _Get400Response["default"];
+  }
+});
+var _ApiClient = _interopRequireDefault(require("./ApiClient"));
+var _Get200Response = _interopRequireDefault(require("./model/Get200Response"));
+var _Get400Response = _interopRequireDefault(require("./model/Get400Response"));
+var _DefaultApi = _interopRequireDefault(require("./api/DefaultApi"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }

package/dist/model/Get200Response.js

@@ -0,0 +1,177 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * iplocation.net API
+ * OpenAPI v3 specification and a set of generated API clients for iplocation.net
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: blah+oapicf@cliffano.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+ * The Get200Response model module.
+ * @module model/Get200Response
+ * @version 1.0.0
+ */
+var Get200Response = /*#__PURE__*/function () {
+  /**
+   * Constructs a new <code>Get200Response</code>.
+   * @alias module:model/Get200Response
+   */
+  function Get200Response() {
+    _classCallCheck(this, Get200Response);
+    Get200Response.initialize(this);
+  }
+
+  /**
+   * Initializes the fields of this object.
+   * This method is used by the constructors of any subclasses, in order to implement multiple inheritance (mix-ins).
+   * Only for internal use.
+   */
+  return _createClass(Get200Response, null, [{
+    key: "initialize",
+    value: function initialize(obj) {}
+
+    /**
+     * Constructs a <code>Get200Response</code> from a plain JavaScript object, optionally creating a new instance.
+     * Copies all relevant properties from <code>data</code> to <code>obj</code> if supplied or a new instance if not.
+     * @param {Object} data The plain JavaScript object bearing properties of interest.
+     * @param {module:model/Get200Response} obj Optional instance to populate.
+     * @return {module:model/Get200Response} The populated <code>Get200Response</code> instance.
+     */
+  }, {
+    key: "constructFromObject",
+    value: function constructFromObject(data, obj) {
+      if (data) {
+        obj = obj || new Get200Response();
+        if (data.hasOwnProperty('ip')) {
+          obj['ip'] = _ApiClient["default"].convertToType(data['ip'], 'String');
+        }
+        if (data.hasOwnProperty('ip_number')) {
+          obj['ip_number'] = _ApiClient["default"].convertToType(data['ip_number'], 'String');
+        }
+        if (data.hasOwnProperty('ip_version')) {
+          obj['ip_version'] = _ApiClient["default"].convertToType(data['ip_version'], 'Number');
+        }
+        if (data.hasOwnProperty('country_name')) {
+          obj['country_name'] = _ApiClient["default"].convertToType(data['country_name'], 'String');
+        }
+        if (data.hasOwnProperty('country_code2')) {
+          obj['country_code2'] = _ApiClient["default"].convertToType(data['country_code2'], 'String');
+        }
+        if (data.hasOwnProperty('isp')) {
+          obj['isp'] = _ApiClient["default"].convertToType(data['isp'], 'String');
+        }
+        if (data.hasOwnProperty('response_code')) {
+          obj['response_code'] = _ApiClient["default"].convertToType(data['response_code'], 'String');
+        }
+        if (data.hasOwnProperty('response_message')) {
+          obj['response_message'] = _ApiClient["default"].convertToType(data['response_message'], 'String');
+        }
+      }
+      return obj;
+    }
+
+    /**
+     * Validates the JSON data with respect to <code>Get200Response</code>.
+     * @param {Object} data The plain JavaScript object bearing properties of interest.
+     * @return {boolean} to indicate whether the JSON data is valid with respect to <code>Get200Response</code>.
+     */
+  }, {
+    key: "validateJSON",
+    value: function validateJSON(data) {
+      // ensure the json data is a string
+      if (data['ip'] && !(typeof data['ip'] === 'string' || data['ip'] instanceof String)) {
+        throw new Error("Expected the field `ip` to be a primitive type in the JSON string but got " + data['ip']);
+      }
+      // ensure the json data is a string
+      if (data['ip_number'] && !(typeof data['ip_number'] === 'string' || data['ip_number'] instanceof String)) {
+        throw new Error("Expected the field `ip_number` to be a primitive type in the JSON string but got " + data['ip_number']);
+      }
+      // ensure the json data is a string
+      if (data['country_name'] && !(typeof data['country_name'] === 'string' || data['country_name'] instanceof String)) {
+        throw new Error("Expected the field `country_name` to be a primitive type in the JSON string but got " + data['country_name']);
+      }
+      // ensure the json data is a string
+      if (data['country_code2'] && !(typeof data['country_code2'] === 'string' || data['country_code2'] instanceof String)) {
+        throw new Error("Expected the field `country_code2` to be a primitive type in the JSON string but got " + data['country_code2']);
+      }
+      // ensure the json data is a string
+      if (data['isp'] && !(typeof data['isp'] === 'string' || data['isp'] instanceof String)) {
+        throw new Error("Expected the field `isp` to be a primitive type in the JSON string but got " + data['isp']);
+      }
+      // ensure the json data is a string
+      if (data['response_code'] && !(typeof data['response_code'] === 'string' || data['response_code'] instanceof String)) {
+        throw new Error("Expected the field `response_code` to be a primitive type in the JSON string but got " + data['response_code']);
+      }
+      // ensure the json data is a string
+      if (data['response_message'] && !(typeof data['response_message'] === 'string' || data['response_message'] instanceof String)) {
+        throw new Error("Expected the field `response_message` to be a primitive type in the JSON string but got " + data['response_message']);
+      }
+      return true;
+    }
+  }]);
+}();
+/**
+ * IPv4 or IPv6 address used to lookup geolocation.
+ * @member {String} ip
+ */
+Get200Response.prototype['ip'] = undefined;
+
+/**
+ * IP number in long integer (represented as string).
+ * @member {String} ip_number
+ */
+Get200Response.prototype['ip_number'] = undefined;
+
+/**
+ * IP version either 4 or 6.
+ * @member {Number} ip_version
+ */
+Get200Response.prototype['ip_version'] = undefined;
+
+/**
+ * Full name of the IP country.
+ * @member {String} country_name
+ */
+Get200Response.prototype['country_name'] = undefined;
+
+/**
+ * ISO ALPHA-2 Country Code.
+ * @member {String} country_code2
+ */
+Get200Response.prototype['country_code2'] = undefined;
+
+/**
+ * Internet Service Provider (ISP) who owns the IP address.
+ * @member {String} isp
+ */
+Get200Response.prototype['isp'] = undefined;
+
+/**
+ * Response status code to indicate success or failed completion of the API call.
+ * @member {String} response_code
+ */
+Get200Response.prototype['response_code'] = undefined;
+
+/**
+ * Response message to indicate success or failed completion of the API call.
+ * @member {String} response_message
+ */
+Get200Response.prototype['response_message'] = undefined;
+var _default = exports["default"] = Get200Response;

package/dist/model/Get400Response.js

@@ -0,0 +1,103 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * iplocation.net API
+ * OpenAPI v3 specification and a set of generated API clients for iplocation.net
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: blah+oapicf@cliffano.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+ * The Get400Response model module.
+ * @module model/Get400Response
+ * @version 1.0.0
+ */
+var Get400Response = /*#__PURE__*/function () {
+  /**
+   * Constructs a new <code>Get400Response</code>.
+   * @alias module:model/Get400Response
+   */
+  function Get400Response() {
+    _classCallCheck(this, Get400Response);
+    Get400Response.initialize(this);
+  }
+
+  /**
+   * Initializes the fields of this object.
+   * This method is used by the constructors of any subclasses, in order to implement multiple inheritance (mix-ins).
+   * Only for internal use.
+   */
+  return _createClass(Get400Response, null, [{
+    key: "initialize",
+    value: function initialize(obj) {}
+
+    /**
+     * Constructs a <code>Get400Response</code> from a plain JavaScript object, optionally creating a new instance.
+     * Copies all relevant properties from <code>data</code> to <code>obj</code> if supplied or a new instance if not.
+     * @param {Object} data The plain JavaScript object bearing properties of interest.
+     * @param {module:model/Get400Response} obj Optional instance to populate.
+     * @return {module:model/Get400Response} The populated <code>Get400Response</code> instance.
+     */
+  }, {
+    key: "constructFromObject",
+    value: function constructFromObject(data, obj) {
+      if (data) {
+        obj = obj || new Get400Response();
+        if (data.hasOwnProperty('response_code')) {
+          obj['response_code'] = _ApiClient["default"].convertToType(data['response_code'], 'String');
+        }
+        if (data.hasOwnProperty('response_message')) {
+          obj['response_message'] = _ApiClient["default"].convertToType(data['response_message'], 'String');
+        }
+      }
+      return obj;
+    }
+
+    /**
+     * Validates the JSON data with respect to <code>Get400Response</code>.
+     * @param {Object} data The plain JavaScript object bearing properties of interest.
+     * @return {boolean} to indicate whether the JSON data is valid with respect to <code>Get400Response</code>.
+     */
+  }, {
+    key: "validateJSON",
+    value: function validateJSON(data) {
+      // ensure the json data is a string
+      if (data['response_code'] && !(typeof data['response_code'] === 'string' || data['response_code'] instanceof String)) {
+        throw new Error("Expected the field `response_code` to be a primitive type in the JSON string but got " + data['response_code']);
+      }
+      // ensure the json data is a string
+      if (data['response_message'] && !(typeof data['response_message'] === 'string' || data['response_message'] instanceof String)) {
+        throw new Error("Expected the field `response_message` to be a primitive type in the JSON string but got " + data['response_message']);
+      }
+      return true;
+    }
+  }]);
+}();
+/**
+ * Response status code to indicate success or failed completion of the API call.
+ * @member {String} response_code
+ */
+Get400Response.prototype['response_code'] = undefined;
+
+/**
+ * Response message to indicate success or failed completion of the API call.
+ * @member {String} response_message
+ */
+Get400Response.prototype['response_message'] = undefined;
+var _default = exports["default"] = Get400Response;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "openapi_iplocation",
+  "version": "1.0.0",
+  "description": "OpenAPI v3 specification and a set of generated API clients for iplocation.net",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "babel src -d dist",
+    "prepare": "npm run build",
+    "test": "mocha --require @babel/register --recursive"
+  },
+  "browser": {
+    "fs": false
+  },
+  "dependencies": {
+    "@babel/cli": "^7.0.0",
+    "superagent": "^5.3.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.0.0",
+    "@babel/plugin-proposal-class-properties": "^7.0.0",
+    "@babel/plugin-proposal-decorators": "^7.0.0",
+    "@babel/plugin-proposal-do-expressions": "^7.0.0",
+    "@babel/plugin-proposal-export-default-from": "^7.0.0",
+    "@babel/plugin-proposal-export-namespace-from": "^7.0.0",
+    "@babel/plugin-proposal-function-bind": "^7.0.0",
+    "@babel/plugin-proposal-function-sent": "^7.0.0",
+    "@babel/plugin-proposal-json-strings": "^7.0.0",
+    "@babel/plugin-proposal-logical-assignment-operators": "^7.0.0",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.0.0",
+    "@babel/plugin-proposal-numeric-separator": "^7.0.0",
+    "@babel/plugin-proposal-optional-chaining": "^7.0.0",
+    "@babel/plugin-proposal-pipeline-operator": "^7.0.0",
+    "@babel/plugin-proposal-throw-expressions": "^7.0.0",
+    "@babel/plugin-syntax-dynamic-import": "^7.0.0",
+    "@babel/plugin-syntax-import-meta": "^7.0.0",
+    "@babel/preset-env": "^7.0.0",
+    "@babel/register": "^7.0.0",
+    "expect.js": "^0.3.1",
+    "mocha": "^8.0.1",
+    "sinon": "^7.2.0"
+  },
+  "files": [
+    "dist"
+  ]
+}