@veecode-platform/backstage-plugin-about-backend-dynamic 1.0.1

package/README.md

@@ -0,0 +1,5 @@
+# @veecode-platform/backstage-plugin-about-backend
+
+Backend plugin for the VeeCode DevPortal "About" page. Exposes a `/info` endpoint that returns system details (OS, memory, Node.js version, Backstage and DevPortal versions).
+
+Supports dynamic plugin export via `rhdh-cli`.

package/dist/.config-schema.json

@@ -0,0 +1 @@
+{}

package/dist/api/AboutApi.cjs.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var cliCommon = require('@backstage/cli-common');
+var os = require('os');
+var fs = require('fs-extra');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var os__default = /*#__PURE__*/_interopDefaultCompat(os);
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+class AboutBackendApi {
+  constructor() {
+  }
+  async listInfo() {
+    const operatingSystem = `${os__default.default.hostname()}: ${os__default.default.type} ${os__default.default.release} - ${os__default.default.platform}/${os__default.default.arch}`;
+    const usedMem = Math.floor((os__default.default.totalmem() - os__default.default.freemem()) / (1024 * 1024));
+    const resources = `Memory: ${usedMem}/${Math.floor(
+      os__default.default.totalmem() / (1024 * 1024)
+    )}MB - Load: ${os__default.default.loadavg().map((v) => v.toFixed(2)).join("/")}`;
+    const nodeJsVersion = process.version;
+    const paths = cliCommon.findPaths(__dirname);
+    const backstageFile = paths.resolveTargetRoot("backstage.json");
+    const devportalFile = paths.resolveTargetRoot("devportal.json");
+    let backstageJson = void 0;
+    let devportalJson = void 0;
+    if (fs__default.default.existsSync(backstageFile)) {
+      const buffer = await fs__default.default.readFile(backstageFile);
+      backstageJson = JSON.parse(buffer.toString());
+    }
+    if (fs__default.default.existsSync(devportalFile)) {
+      const buffer = await fs__default.default.readFile(devportalFile);
+      devportalJson = JSON.parse(buffer.toString());
+    }
+    const info = {
+      operatingSystem: operatingSystem ?? "N/A",
+      resourceUtilization: resources ?? "N/A",
+      nodeJsVersion: nodeJsVersion ?? "N/A",
+      backstageVersion: backstageJson && backstageJson.version ? backstageJson.version : "N/A",
+      devportalVersion: devportalJson && devportalJson.version ? devportalJson.version : "N/A"
+    };
+    return info;
+  }
+}
+
+exports.AboutBackendApi = AboutBackendApi;
+//# sourceMappingURL=AboutApi.cjs.js.map

package/dist/api/AboutApi.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AboutApi.cjs.js","sources":["../../src/api/AboutApi.ts"],"sourcesContent":["/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// import { Config } from '@backstage/config';\n// import { Logger } from 'winston';\nimport { findPaths } from '@backstage/cli-common';\nimport os from 'os';\nimport fs from 'fs-extra';\nimport { DevPortalInfo } from '../utils/types';\n// import { PermissionEvaluator } from '@backstage/plugin-permission-common';\n\n/** @public */\nexport class AboutBackendApi {\n  public constructor(\n //   private readonly logger: Logger,\n //   private readonly config: Config,\n //   private readonly permissions: PermissionEvaluator\n  ) {}\n\n\n  public async listInfo(): Promise<DevPortalInfo> {\n    const operatingSystem = `${os.hostname()}: ${os.type} ${os.release} - ${\n      os.platform\n    }/${os.arch}`;\n    const usedMem = Math.floor((os.totalmem() - os.freemem()) / (1024 * 1024));\n    const resources = `Memory: ${usedMem}/${Math.floor(\n      os.totalmem() / (1024 * 1024),\n    )}MB - Load: ${os\n      .loadavg()\n      .map(v => v.toFixed(2))\n      .join('/')}`;\n    const nodeJsVersion = process.version;\n\n    /* eslint-disable-next-line no-restricted-syntax */\n    const paths = findPaths(__dirname);\n    const backstageFile = paths.resolveTargetRoot('backstage.json');\n    const devportalFile = paths.resolveTargetRoot('devportal.json');\n    let backstageJson = undefined;\n    let devportalJson = undefined;\n\n    if (fs.existsSync(backstageFile)) {\n      const buffer = await fs.readFile(backstageFile);\n      backstageJson = JSON.parse(buffer.toString());\n    }\n\n    if (fs.existsSync(devportalFile)) {\n        const buffer = await fs.readFile(devportalFile);\n        devportalJson = JSON.parse(buffer.toString());\n      }\n\n    const info: DevPortalInfo = {\n      operatingSystem: operatingSystem ?? 'N/A',\n      resourceUtilization: resources ?? 'N/A',\n      nodeJsVersion: nodeJsVersion ?? 'N/A',\n      backstageVersion: backstageJson && backstageJson.version ? backstageJson.version : 'N/A',\n      devportalVersion: devportalJson && devportalJson.version ? devportalJson.version : 'N/A',\n    };\n\n    return info;\n  }\n}"],"names":["os","findPaths","fs"],"mappings":";;;;;;;;;;;AAyBO,MAAM,eAAA,CAAgB;AAAA,EACpB,WAAA,GAIL;AAAA,EAAC;AAAA,EAGH,MAAa,QAAA,GAAmC;AAC9C,IAAA,MAAM,kBAAkB,CAAA,EAAGA,mBAAA,CAAG,QAAA,EAAU,KAAKA,mBAAA,CAAG,IAAI,CAAA,CAAA,EAAIA,mBAAA,CAAG,OAAO,CAAA,GAAA,EAChEA,mBAAA,CAAG,QACL,CAAA,CAAA,EAAIA,oBAAG,IAAI,CAAA,CAAA;AACX,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAA,CAAOA,mBAAA,CAAG,QAAA,KAAaA,mBAAA,CAAG,OAAA,EAAQ,KAAM,IAAA,GAAO,IAAA,CAAK,CAAA;AACzE,IAAA,MAAM,SAAA,GAAY,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,CAAK,KAAA;AAAA,MAC3CA,mBAAA,CAAG,QAAA,EAAS,IAAK,IAAA,GAAO,IAAA;AAAA,KACzB,CAAA,WAAA,EAAcA,mBAAA,CACZ,OAAA,GACA,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,CAAA,CACrB,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA;AACZ,IAAA,MAAM,gBAAgB,OAAA,CAAQ,OAAA;AAG9B,IAAA,MAAM,KAAA,GAAQC,oBAAU,SAAS,CAAA;AACjC,IAAA,MAAM,aAAA,GAAgB,KAAA,CAAM,iBAAA,CAAkB,gBAAgB,CAAA;AAC9D,IAAA,MAAM,aAAA,GAAgB,KAAA,CAAM,iBAAA,CAAkB,gBAAgB,CAAA;AAC9D,IAAA,IAAI,aAAA,GAAgB,MAAA;AACpB,IAAA,IAAI,aAAA,GAAgB,MAAA;AAEpB,IAAA,IAAIC,mBAAA,CAAG,UAAA,CAAW,aAAa,CAAA,EAAG;AAChC,MAAA,MAAM,MAAA,GAAS,MAAMA,mBAAA,CAAG,QAAA,CAAS,aAAa,CAAA;AAC9C,MAAA,aAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,QAAA,EAAU,CAAA;AAAA,IAC9C;AAEA,IAAA,IAAIA,mBAAA,CAAG,UAAA,CAAW,aAAa,CAAA,EAAG;AAC9B,MAAA,MAAM,MAAA,GAAS,MAAMA,mBAAA,CAAG,QAAA,CAAS,aAAa,CAAA;AAC9C,MAAA,aAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,QAAA,EAAU,CAAA;AAAA,IAC9C;AAEF,IAAA,MAAM,IAAA,GAAsB;AAAA,MAC1B,iBAAiB,eAAA,IAAmB,KAAA;AAAA,MACpC,qBAAqB,SAAA,IAAa,KAAA;AAAA,MAClC,eAAe,aAAA,IAAiB,KAAA;AAAA,MAChC,gBAAA,EAAkB,aAAA,IAAiB,aAAA,CAAc,OAAA,GAAU,cAAc,OAAA,GAAU,KAAA;AAAA,MACnF,gBAAA,EAAkB,aAAA,IAAiB,aAAA,CAAc,OAAA,GAAU,cAAc,OAAA,GAAU;AAAA,KACrF;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AACF;;;;"}

package/dist/configSchema.json

@@ -0,0 +1 @@
+{}

package/dist/index.cjs.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var AboutApi = require('./api/AboutApi.cjs.js');
+var router = require('./service/router.cjs.js');
+var plugin = require('./plugin.cjs.js');
+
+
+
+exports.AboutBackendApi = AboutApi.AboutBackendApi;
+exports.createRouter = router.createRouter;
+exports.default = plugin.aboutPlugin;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { PermissionEvaluator } from '@backstage/plugin-permission-common';
+import express from 'express';
+import { Logger } from 'winston';
+import { Config } from '@backstage/config';
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+
+type DevPortalInfo = {
+    operatingSystem: string;
+    resourceUtilization: string;
+    nodeJsVersion: string;
+    backstageVersion: string;
+    devportalVersion: string;
+};
+
+/** @public */
+declare class AboutBackendApi {
+    constructor();
+    listInfo(): Promise<DevPortalInfo>;
+}
+
+/** @public */
+interface RouterOptions {
+    aboutBackendApi?: AboutBackendApi;
+    logger?: Logger;
+    config?: Config;
+    permissions?: PermissionEvaluator;
+}
+declare function createRouter(): Promise<express.Router>;
+
+/**
+ * About backend plugin
+ *
+ * @public
+ */
+declare const aboutPlugin: _backstage_backend_plugin_api.BackendFeature;
+
+export { AboutBackendApi, createRouter, aboutPlugin as default };
+export type { DevPortalInfo, RouterOptions };

package/dist/plugin.cjs.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var router = require('./service/router.cjs.js');
+
+const aboutPlugin = backendPluginApi.createBackendPlugin({
+  pluginId: "about",
+  register(env) {
+    env.registerInit({
+      deps: {
+        httpRouter: backendPluginApi.coreServices.httpRouter
+      },
+      async init({ httpRouter }) {
+        httpRouter.use(
+          await router.createRouter()
+        );
+      }
+    });
+  }
+});
+
+exports.aboutPlugin = aboutPlugin;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\n\n/**\n * About backend plugin\n *\n * @public\n */\nexport const aboutPlugin = createBackendPlugin({\n  pluginId: 'about',\n  register(env) {\n    env.registerInit({\n      deps: {\n        httpRouter: coreServices.httpRouter,\n      },\n      async init({ httpRouter }) {\n        httpRouter.use(\n          await createRouter(),\n        );\n      },\n    });\n  },\n});"],"names":["createBackendPlugin","coreServices","createRouter"],"mappings":";;;;;AA2BO,MAAM,cAAcA,oCAAA,CAAoB;AAAA,EAC7C,QAAA,EAAU,OAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,YAAYC,6BAAA,CAAa;AAAA,OAC3B;AAAA,MACA,MAAM,IAAA,CAAK,EAAE,UAAA,EAAW,EAAG;AACzB,QAAA,UAAA,CAAW,GAAA;AAAA,UACT,MAAMC,mBAAA;AAAa,SACrB;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}

package/dist/service/router.cjs.js

@@ -0,0 +1,24 @@
+'use strict';
+
+var express = require('express');
+var Router = require('express-promise-router');
+var AboutApi = require('../api/AboutApi.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var express__default = /*#__PURE__*/_interopDefaultCompat(express);
+var Router__default = /*#__PURE__*/_interopDefaultCompat(Router);
+
+async function createRouter() {
+  const aboutBackendApi = new AboutApi.AboutBackendApi();
+  const router = Router__default.default();
+  router.use(express__default.default.json());
+  router.get("/info", async (_res, response) => {
+    const info = await aboutBackendApi.listInfo();
+    response.status(200).json(info);
+  });
+  return router;
+}
+
+exports.createRouter = createRouter;
+//# sourceMappingURL=router.cjs.js.map

package/dist/service/router.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.cjs.js","sources":["../../src/service/router.ts"],"sourcesContent":["import {\n  PermissionEvaluator,\n} from '@backstage/plugin-permission-common';\nimport express from 'express';\nimport Router from 'express-promise-router';\nimport { Logger } from 'winston';\nimport { AboutBackendApi } from '../api';\nimport { Config } from '@backstage/config';\n\n\n/** @public */\nexport interface RouterOptions {\n  aboutBackendApi?: AboutBackendApi;\n  logger?: Logger;\n  config?: Config;\n  permissions?: PermissionEvaluator;\n}\n\nexport async function createRouter(\n): Promise<express.Router> {\n  const aboutBackendApi = new AboutBackendApi();\n\n  const router = Router();\n  router.use(express.json());\n\n  router.get('/info', async (_res, response) => {\n    const info = await aboutBackendApi.listInfo();\n\n    response.status(200).json(info);\n  });\n\n  return router;\n}\n"],"names":["AboutBackendApi","Router","express"],"mappings":";;;;;;;;;;;AAkBA,eAAsB,YAAA,GACK;AACzB,EAAA,MAAM,eAAA,GAAkB,IAAIA,wBAAA,EAAgB;AAE5C,EAAA,MAAM,SAASC,uBAAA,EAAO;AACtB,EAAA,MAAA,CAAO,GAAA,CAAIC,wBAAA,CAAQ,IAAA,EAAM,CAAA;AAEzB,EAAA,MAAA,CAAO,GAAA,CAAI,OAAA,EAAS,OAAO,IAAA,EAAM,QAAA,KAAa;AAC5C,IAAA,MAAM,IAAA,GAAO,MAAM,eAAA,CAAgB,QAAA,EAAS;AAE5C,IAAA,QAAA,CAAS,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AAAA,EAChC,CAAC,CAAA;AAED,EAAA,OAAO,MAAA;AACT;;;;"}

package/node_modules/@colors/colors/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Original Library
+  - Copyright (c) Marak Squires
+
+Additional Functionality
+ - Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+ - Copyright (c) DABH (https://github.com/DABH)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/node_modules/@colors/colors/README.md

@@ -0,0 +1,219 @@
+# @colors/colors ("colors.js")
+[![Build Status](https://github.com/DABH/colors.js/actions/workflows/ci.yml/badge.svg)](https://github.com/DABH/colors.js/actions/workflows/ci.yml)
+[![version](https://img.shields.io/npm/v/@colors/colors.svg)](https://www.npmjs.org/package/@colors/colors)
+
+Please check out the [roadmap](ROADMAP.md) for upcoming features and releases.  Please open Issues to provide feedback.
+
+## get color and style in your node.js console
+
+![Demo](https://raw.githubusercontent.com/DABH/colors.js/master/screenshots/colors.png)
+
+## Installation
+
+    npm install @colors/colors
+
+## colors and styles!
+
+### text colors
+
+  - black
+  - red
+  - green
+  - yellow
+  - blue
+  - magenta
+  - cyan
+  - white
+  - gray
+  - grey
+
+### bright text colors
+
+  - brightRed
+  - brightGreen
+  - brightYellow
+  - brightBlue
+  - brightMagenta
+  - brightCyan
+  - brightWhite
+
+### background colors
+
+  - bgBlack
+  - bgRed
+  - bgGreen
+  - bgYellow
+  - bgBlue
+  - bgMagenta
+  - bgCyan
+  - bgWhite
+  - bgGray
+  - bgGrey
+
+### bright background colors
+
+  - bgBrightRed
+  - bgBrightGreen
+  - bgBrightYellow
+  - bgBrightBlue
+  - bgBrightMagenta
+  - bgBrightCyan
+  - bgBrightWhite
+
+### styles
+
+  - reset
+  - bold
+  - dim
+  - italic
+  - underline
+  - inverse
+  - hidden
+  - strikethrough
+
+### extras
+
+  - rainbow
+  - zebra
+  - america
+  - trap
+  - random
+
+
+## Usage
+
+By popular demand, `@colors/colors` now ships with two types of usages!
+
+The super nifty way
+
+```js
+var colors = require('@colors/colors');
+
+console.log('hello'.green); // outputs green text
+console.log('i like cake and pies'.underline.red); // outputs red underlined text
+console.log('inverse the color'.inverse); // inverses the color
+console.log('OMG Rainbows!'.rainbow); // rainbow
+console.log('Run the trap'.trap); // Drops the bass
+
+```
+
+or a slightly less nifty way which doesn't extend `String.prototype`
+
+```js
+var colors = require('@colors/colors/safe');
+
+console.log(colors.green('hello')); // outputs green text
+console.log(colors.red.underline('i like cake and pies')); // outputs red underlined text
+console.log(colors.inverse('inverse the color')); // inverses the color
+console.log(colors.rainbow('OMG Rainbows!')); // rainbow
+console.log(colors.trap('Run the trap')); // Drops the bass
+
+```
+
+I prefer the first way. Some people seem to be afraid of extending `String.prototype` and prefer the second way. 
+
+If you are writing good code you will never have an issue with the first approach. If you really don't want to touch `String.prototype`, the second usage will not touch `String` native object.
+
+## Enabling/Disabling Colors
+
+The package will auto-detect whether your terminal can use colors and enable/disable accordingly. When colors are disabled, the color functions do nothing. You can override this with a command-line flag:
+
+```bash
+node myapp.js --no-color
+node myapp.js --color=false
+
+node myapp.js --color
+node myapp.js --color=true
+node myapp.js --color=always
+
+FORCE_COLOR=1 node myapp.js
+```
+
+Or in code:
+
+```javascript
+var colors = require('@colors/colors');
+colors.enable();
+colors.disable();
+```
+
+## Console.log [string substitution](http://nodejs.org/docs/latest/api/console.html#console_console_log_data)
+
+```js
+var name = 'Beowulf';
+console.log(colors.green('Hello %s'), name);
+// outputs -> 'Hello Beowulf'
+```
+
+## Custom themes
+
+### Using standard API
+
+```js
+
+var colors = require('@colors/colors');
+
+colors.setTheme({
+  silly: 'rainbow',
+  input: 'grey',
+  verbose: 'cyan',
+  prompt: 'grey',
+  info: 'green',
+  data: 'grey',
+  help: 'cyan',
+  warn: 'yellow',
+  debug: 'blue',
+  error: 'red'
+});
+
+// outputs red text
+console.log("this is an error".error);
+
+// outputs yellow text
+console.log("this is a warning".warn);
+```
+
+### Using string safe API
+
+```js
+var colors = require('@colors/colors/safe');
+
+// set single property
+var error = colors.red;
+error('this is red');
+
+// set theme
+colors.setTheme({
+  silly: 'rainbow',
+  input: 'grey',
+  verbose: 'cyan',
+  prompt: 'grey',
+  info: 'green',
+  data: 'grey',
+  help: 'cyan',
+  warn: 'yellow',
+  debug: 'blue',
+  error: 'red'
+});
+
+// outputs red text
+console.log(colors.error("this is an error"));
+
+// outputs yellow text
+console.log(colors.warn("this is a warning"));
+
+```
+
+### Combining Colors
+
+```javascript
+var colors = require('@colors/colors');
+
+colors.setTheme({
+  custom: ['red', 'underline']
+});
+
+console.log('test'.custom);
+```
+
+*Protip: There is a secret undocumented style in `colors`. If you find the style you can summon him.*

package/node_modules/@colors/colors/examples/normal-usage.js

@@ -0,0 +1,83 @@
+var colors = require('../lib/index');
+
+console.log('First some yellow text'.yellow);
+
+console.log('Underline that text'.yellow.underline);
+
+console.log('Make it bold and red'.red.bold);
+
+console.log(('Double Raindows All Day Long').rainbow);
+
+console.log('Drop the bass'.trap);
+
+console.log('DROP THE RAINBOW BASS'.trap.rainbow);
+
+// styles not widely supported
+console.log('Chains are also cool.'.bold.italic.underline.red);
+
+// styles not widely supported
+console.log('So '.green + 'are'.underline + ' ' + 'inverse'.inverse
+  + ' styles! '.yellow.bold);
+console.log('Zebras are so fun!'.zebra);
+
+//
+// Remark: .strikethrough may not work with Mac OS Terminal App
+//
+console.log('This is ' + 'not'.strikethrough + ' fun.');
+
+console.log('Background color attack!'.black.bgWhite);
+console.log('Use random styles on everything!'.random);
+console.log('America, Heck Yeah!'.america);
+
+// eslint-disable-next-line max-len
+console.log('Blindingly '.brightCyan + 'bright? '.brightRed + 'Why '.brightYellow + 'not?!'.brightGreen);
+
+console.log('Setting themes is useful');
+
+//
+// Custom themes
+//
+console.log('Generic logging theme as JSON'.green.bold.underline);
+// Load theme with JSON literal
+colors.setTheme({
+  silly: 'rainbow',
+  input: 'grey',
+  verbose: 'cyan',
+  prompt: 'grey',
+  info: 'green',
+  data: 'grey',
+  help: 'cyan',
+  warn: 'yellow',
+  debug: 'blue',
+  error: 'red',
+});
+
+// outputs red text
+console.log('this is an error'.error);
+
+// outputs yellow text
+console.log('this is a warning'.warn);
+
+// outputs grey text
+console.log('this is an input'.input);
+
+console.log('Generic logging theme as file'.green.bold.underline);
+
+// Load a theme from file
+try {
+  colors.setTheme(require(__dirname + '/../themes/generic-logging.js'));
+} catch (err) {
+  console.log(err);
+}
+
+// outputs red text
+console.log('this is an error'.error);
+
+// outputs yellow text
+console.log('this is a warning'.warn);
+
+// outputs grey text
+console.log('this is an input'.input);
+
+// console.log("Don't summon".zalgo)
+

package/node_modules/@colors/colors/examples/safe-string.js

@@ -0,0 +1,80 @@
+var colors = require('../safe');
+
+console.log(colors.yellow('First some yellow text'));
+
+console.log(colors.yellow.underline('Underline that text'));
+
+console.log(colors.red.bold('Make it bold and red'));
+
+console.log(colors.rainbow('Double Raindows All Day Long'));
+
+console.log(colors.trap('Drop the bass'));
+
+console.log(colors.rainbow(colors.trap('DROP THE RAINBOW BASS')));
+
+// styles not widely supported
+console.log(colors.bold.italic.underline.red('Chains are also cool.'));
+
+// styles not widely supported
+console.log(colors.green('So ') + colors.underline('are') + ' '
+  + colors.inverse('inverse') + colors.yellow.bold(' styles! '));
+
+console.log(colors.zebra('Zebras are so fun!'));
+
+console.log('This is ' + colors.strikethrough('not') + ' fun.');
+
+
+console.log(colors.black.bgWhite('Background color attack!'));
+console.log(colors.random('Use random styles on everything!'));
+console.log(colors.america('America, Heck Yeah!'));
+
+// eslint-disable-next-line max-len
+console.log(colors.brightCyan('Blindingly ') + colors.brightRed('bright? ') + colors.brightYellow('Why ') + colors.brightGreen('not?!'));
+
+console.log('Setting themes is useful');
+
+//
+// Custom themes
+//
+// console.log('Generic logging theme as JSON'.green.bold.underline);
+// Load theme with JSON literal
+colors.setTheme({
+  silly: 'rainbow',
+  input: 'blue',
+  verbose: 'cyan',
+  prompt: 'grey',
+  info: 'green',
+  data: 'grey',
+  help: 'cyan',
+  warn: 'yellow',
+  debug: 'blue',
+  error: 'red',
+});
+
+// outputs red text
+console.log(colors.error('this is an error'));
+
+// outputs yellow text
+console.log(colors.warn('this is a warning'));
+
+// outputs blue text
+console.log(colors.input('this is an input'));
+
+
+// console.log('Generic logging theme as file'.green.bold.underline);
+
+// Load a theme from file
+colors.setTheme(require(__dirname + '/../themes/generic-logging.js'));
+
+// outputs red text
+console.log(colors.error('this is an error'));
+
+// outputs yellow text
+console.log(colors.warn('this is a warning'));
+
+// outputs grey text
+console.log(colors.input('this is an input'));
+
+// console.log(colors.zalgo("Don't summon him"))
+
+