@naturalcycles/js-lib

@naturalcycles/js-lib

Standard library for universal (browser + Node.js) javascript

Features

• Decorators

  • @memo, @memoCache
  • @Debounce, @Throttle
  • @Retry, @TryCatch
  • ...

• Error

  • AppError

• Utils

  • objectSharedUtil
  • randomSharedUtil
  • scriptSharedUtil
  • stringSharedUtil

• Services

  • sentryService

• Testing

  • testSharedUtil

• types

  • StringMap
  • PromiseMap

• ... there's more...

What should go in this lib

• Only universal code that works equally good in the browser and on the server. Otherwise - there are other libs specifically for browser and node.
• Only battle-tested code with solid proven APIs that are not supposed to change.
• Only fully unit-tested code with coverage very close to 100%. All the branches should absolutely be tested.
• Only generic and broad purpose functions, no domain or project-specific code.
• Library- and framework-agnostic, only based on standard JS or TypeScript apis. There are few exceptions for extremely popular dependencies, that will go as peerDependencies in this project, in order for the consuming project to have control over the version of each dependency (in their yarn.lock).

Packaging

• engines.node >= Node.js LTS
• main: dist/index.js: commonjs, es2017 - targeting Node.js
• module: dist-esm/index.js: esm, es2015 - targeting Browsers
• types: dist/index.d.ts: typescript types
• /src folder with source *.ts files included