@companieshouse/ch-node-utils NPM

ch-node-utils

set of node utils which can be used across repos/projects. Available as a normal npm dependency(here on npmjs)

Areas for the different utilities stored in this repo:

i18n (Internationalisation)

Internationalisation has been added to CHS, after already being available (at least for Welsh) on legacy systems (EWF/SCRS/CHD/...)

The implementation is described in Confluence for both Java and Node.js services.

Some common utilities for Node.js are here provided. The chosen Node.js i18n library is i18next, which, at the time of writing, can be considered the standard:

Node.js i18n libs

Node.js i18n libs trend

i18nCh.ts: wrapper to i18next
languageNames.ts: to manage Language names and their associated ISO codes (iso-639). It mainly provides:
- a function to get, from an array of submitted iso-codes, a structured array of iso-codes & native names.
Ex:
```
[... "en", "cy", ...]   ==> [ ... {"IsoCode": "en", "Name": "English" },  {"IsoCode": "cy", "Name": "Cymraeg" } ...]
```
- a custom function to sort the supported locales (apart from leaving 'en' always at 1st position, it sorts alphabetically)

subDirs.ts: to manage files and dirs, so that i18n locales' folders can be sourced automatically. This allows for example to have an array of iso-codes if the ./locales dir follows the normal convention. Ex, this array of iso-codes [ "ar", "bn", "cy", "de", "en", "gd", "ja", "uk"] is retrieved from the following tree:

   │   ├── locales
   │   │   ├── ar
   │   │   │   ├── errors.json
   │   │   │   ├── global.json
   │   │   │   ├── landing.json
   │   │   │   ├── layout.json
   │   │   │   ├── search-company.json
   │   │   │   ├── view-company-information.json
   │   │   │   └── who-to-tell.json
   │   │   ├── bn
   │   │   │   └── *.json
   │   │   ├── cy
   │   │   │   └── *.json
   │   │   ├── de
   │   │   │   └── *.json
   │   │   ├── en
   │   │   │   └── *.json
   │   │   ├── gd
   │   │   │   └── *.json
   │   │   ├── ja
   │   │   │   └── *.json
   │   │   ├── uk
   │   │   │   └── *.json

manageLocales.middleware.ts: middleware that can be reused to manage locales while dealing with http requests.
add-lang-to-url.njk: to add the lang=xx query param to urls:
```
https://.....<self>....../?lang=cy
```
locales-banner.njk: to add the locales banner
ENV VARS: the following ENV vars are used:

ENV VAR	Description
`CH_NODE_UTILS_DROP_LANG_QUERY_PARAM`	It could be set to drop the lang="xx" query param from the current URL (see Example)
`CH_NODE_UTILS_LOG_LVL`	It could be set to "TRACE" or "DEBUG" (case insensitive) to dump internal info while inside ch-node-utils (see Example)