@basaldev/default-adapter-api

API wrapper for default adapters.

🔰 Setup

Get a npmjs access token

You can ask @basal-luke or @basal-gen for this part.

export NODEBLOCKS_DEV_TOKEN=__INSERT_YOUR_TOKEN_HERE__

Install NVM

• OSX / Linux
• Windows

Install Yarn (Global)

Yarn must be installed globally for the project's NodeJS version. This should be done so using the command below.

nvm use && npm install -g yarn

⚠️ IMPORTANT: Only use the yarn command install or run scripts. Do not use npm run xxx

🪄 Usage

Run typescript compiler

yarn start

Run debug server on default port: 9339.

• Requires yarn start to be running in a separate session
• Port should be updated to avoid conflicts with other projects package.json > scripts > debug

yarn debug

Run unit tests

yarn test

Installing packages

yarn add <package> | yarn add <package> -D

⚡️ Special Notes for VSCode Users

📐 Required Extensions

Please ensure the following extensions are installed:

• arcanis.vscode-zipfs
• dbaeumer.vscode-eslint
• seatonjiang.gitmoji-vscode
• henrynguyen5-vsc.vsc-nvm (optional)

🛠 Workspaces

The kit uses vscode workspaces for vscode project settings:

• All common vscode project settings should be specified in the .vscode/${project_name}-workspace file.
• Personal user settings should be added to .vscode/settings.json (gitignored)
• ⚠️ You must open this project as a workspace in vscode This can be done by clicking the workspace file while in vscode, or by using File > Open workspace from file.

🪛 TypeScript

When prompted asking which typescript VSCode should use, it's very important that you choose the local project version located at .yarn/sdks/typescript/...

💅 Prettier

If you have the prettier extension installed, please disable it for this project. blocks-default-adapter-api uses eslint to execute prettier, so having prettier enabled in vscode will cause conflicts and strange behavior.

🤖 Format on Save (optional)

Add the following code to your .vscode/settings.json will automatically fix all eslint errors whenever you save a file.

  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  }

🚀 Package Deployment

This library uses github registry to publish private npm package. For detailed instructions see here

💡 Note: that npm is used for version & publish commands

1. Bump version

npm version ${VERSION}

2. Build Package

yarn build

3. Publish Package

npm publish

🏗 Project Structure

Please Refer: https://github.com/basaldev/ts-kit