@mappable-world/mappable-cli

Mappable JS Package utils

The project is used for inheritance in packages https://mappable.world/docs/js-api/ref/packages/index.html

Requires a key to work https://mappable.world/docs/js-api/quickstart.html#get-api-key

In your project, you can include this package in order to simplify the development of packages for mappable JS API. It won't completely get rid of the boilerplate, but it will at least allow you to inherit all the main configs.

Create mappable package by template

npx @mappable-world/mappable-cli --name="mappable-my-super-pkg"

You can see the full list of options here:

npx @mappable-world/mappable-cli --help

Or you can set up all elements of the package yourself, such as autotests, linting and building.

Manual

Install package @mappable-world/mappable-cli

npm i -D mappable-world/mappable-package-utils#main

For development, you may also need types for the libraries you use:

npm i -D @types/got @types/jest @types/jsdom @types/react @mappable-world/mappable-types

Linting

Install eslint

npm i eslint prettier @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint-config-prettier eslint-plugin-prettier -D

Create .eslintrc.js file:

module.exports = {
  extends: ['./node_modules/@mappable-world/mappable-cli/.eslintrc.js']
};

Create .prettierrc.js file:

const config = require("@mappable-world/mappable-cli/.prettierrc.json");

module.exports = {
  ...config
}

Build

Install webpack and typescript

npm i webpack webpack-cli webpack-dev-server css-loader style-loader terser-webpack-plugin ts-loader typescript -D

Create files webpack.config.js:

module.exports = (args, env, dir = process.cwd()) => {
  return require('@mappable-world/mappable-cli/webpack.config')(args, env, dir);
}

and tsconfig.json

{
  "extends": ["@mappable-world/mappable-cli"],
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./node_modules/@mappable-world"]
  }
}

Test

We use jest + jsdom:

npm i -D jest jsdom ts-jest got@11.8.6 dotenv cross-fetch identity-obj-proxy

And create jest.config.json file:

module.exports = {
  ...require('@mappable-world/mappable-cli/jest.config.js')
};

Contributing

make ci
make lint
APIKEY=%YOUR_API_KEY% make test
APIKEY=%YOUR_API_KEY% make start

But it's better to create a .env file with the contents:

APIKEY="%YOUR_API_KEY%"

After that, you will be able to run autotests and start the server without specifying an environment variable:

make test
make start