@beauraines/node-helpers 5.0.0 → 5.2.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [5.2.0](https://github.com/beauraines/node-helpers/compare/v5.1.0...v5.2.0) (2024-10-19)
+
+
+### Features
+
+* **helper:** convert unix timestamp to date ([d885b45](https://github.com/beauraines/node-helpers/commit/d885b45abf182ae9bb8e210f129735d672ee766a))
+
+## [5.1.0](https://github.com/beauraines/node-helpers/compare/v5.0.0...v5.1.0) (2024-10-16)
+
+
+### Features
+
+* adds cli argument module ([#155](https://github.com/beauraines/node-helpers/issues/155)) ([b7943b6](https://github.com/beauraines/node-helpers/commit/b7943b6cf55a221ecc1a55afec2ab9505ed88347))
+
 ## [5.0.0](https://github.com/beauraines/node-helpers/compare/v4.3.0...v5.0.0) (2024-10-14)
 
 

package/eslint.config.mjs

@@ -22,6 +22,7 @@ export default [...compat.extends("eslint:recommended"), {
         globals: {
             ...globals.browser,
             ...globals.commonjs,
+            ...globals.node,
             ...jest.environments.globals.globals,
         },
 

package/index.js

@@ -1,6 +1,7 @@
 
 const ado = require("./src/ado");
 const AzureStorage = require("./src/azure")
+const cliArguments = require('./src/cli-arguments.js');
 const config = require('./src/config.js')
 const credentials = require("./src/credentials.js");
 const database = require("./src/database");
@@ -8,12 +9,13 @@ const helpers = require("./src/helpers");
 const jira = require("./src/jira");
 
 module.exports = {
+    ado,
     AzureStorage,
+    cliArguments,
     config,
     credentials,
     database,
     helpers,
-    jira,
-    ado
+    jira
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beauraines/node-helpers",
-  "version": "5.0.0",
+  "version": "5.2.0",
   "description": "Collection of node helpers",
   "main": "index.js",
   "repository": {

package/src/ado.js

@@ -82,7 +82,7 @@ async function getDistinctParentWorkItems(workItemAPI, ids) {
 async function callRestApi(url, username, token) {
     // console.log(url) // Only display this in verbose mode
     // Bearer token format for ADO
-    // eslint-disable-next-line no-undef
+     
     let bearerToken = Buffer.from(`${username}:${token}`).toString('base64');
 
     let response;

package/src/cli-arguments.js

@@ -0,0 +1,78 @@
+/**
+ * Parses command-line parameters and returns an array of the parameters. This is really getting the 
+ * "arguments" passed from the command-line, but there is no additional parsing or formatting, so 
+ * this is best suited to just parameters. You could handle each element in the array yourself for 
+ * involved processing
+ * 
+ * `node script.js beau 42`
+ * 
+ * returns
+ * `[ 'beau', '42' ]`
+ * 
+ *  * 
+ * @returns Array 
+ */
+const getParameters = () => {
+    // process.argv is an array where:
+    // - The first element is the path to the Node.js executable (e.g., '/usr/local/bin/node')
+    // - The second element is the path to the script file (e.g., '/path/to/script.js')
+    // - The subsequent elements are the command-line arguments
+
+    // Get the arguments starting from the third element
+    const args = process.argv.slice(2).length > 0 ? process.argv.slice(2) : []
+    return args
+}
+
+/**
+ * Parses named command-line arguments. This only supports long-named arguments prefixed with a `--`.
+ * Short arguments .e.g. `-d` are not supported. The value can either be space separated or with an
+ * equals sign
+ * 
+ * `node name-arguments.js  --age=42 --name=Beau`
+ * 
+ * Using this function this will return
+ * 
+ * { age: '42', name: 'Beau' }
+ * 
+ * 
+ * @returns Object
+ */
+const getNamedArguments = () => {
+    const args = {};
+  
+    const argv =process.argv;
+    // Start from index 2 to skip the node executable and script file paths
+    for (let i = 2; i < argv.length; i++) {
+      let arg = argv[i];
+  
+      if (arg.startsWith('--')) {
+        // Remove the leading --
+        arg = arg.slice(2);
+  
+        // Handle --key=value
+        if (arg.includes('=')) {
+          const [key, value] = arg.split('=');
+          args[key] = value;
+        } else {
+          // Handle --key value
+          const key = arg;
+          const value = argv[i + 1];
+  
+          if (!value || value.startsWith('--')) {
+            args[key] = true; // For flags without values
+          } else {
+            args[key] = value;
+            i++; // Skip the next item as it's the value for this key
+          }
+        }
+      }
+    }
+  
+    return args;
+  }
+
+
+module.exports = {
+    getNamedArguments,
+    getParameters
+}

package/src/credentials.js

@@ -1,6 +1,5 @@
 const fs = require('fs');
 const {fileExists} = require('./helpers');
-const process = require('node:process')
 
 /**
  * Reads a file for credentials and validates that the file has the required attributes. 

package/src/database.js

@@ -1,5 +1,4 @@
 const {homedir} = require('os');
-const process = require('node:process')
 const sqlite = require('sqlite');
 const sqlite3 = require('sqlite3');
 const {fileExists} = require('./helpers');

package/src/database.test.js

@@ -4,7 +4,6 @@ const sqlite3 = require('sqlite3');
 const helpers = require('./helpers');
 const { getDBConnection } = require('./database');
 const path = require('path');
-const process = require('node:process')
 
 jest.mock('sqlite');
 jest.mock('os');

package/src/helpers.js

@@ -114,6 +114,16 @@ function getEpochMillis() {
   return Date.now()
 }
 
+/**
+ * Coverts a unix timestamp to an ISO-8601 date string.
+ * 
+ * @param {number} timestamp A unix timestamp
+ * @returns String ISO-8601 formatted date
+ */
+function unixTimestampToDate(timestamp) {
+  return (new Date(timestamp * 1000)).toISOString()
+}
+
 
 
 /**
@@ -192,11 +202,11 @@ async function streamToBuffer(readableStream) {
   return new Promise((resolve, reject) => {
     const chunks = [];
     readableStream.on("data", (data) => {
-      // eslint-disable-next-line no-undef
+       
       chunks.push(data instanceof Buffer ? data : Buffer.from(data));
     });
     readableStream.on("end", () => {
-      // eslint-disable-next-line no-undef
+       
       resolve(Buffer.concat(chunks));
     });
     readableStream.on("error", reject);
@@ -223,5 +233,6 @@ module.exports = {
   toTitleCase,
   toUpperSnakeCase,
   unixTimestamp,
+  unixTimestampToDate,
   writeFile
 }

package/src/helpers.test.js

@@ -38,5 +38,12 @@ describe('helpers',()=> {
         })
     })
 
+    it('should return the correct date-time for a timestamp',() =>{
+        const timestamp = 1729396788;
+        const expectedOutput = '2024-10-20T03:59:48.000Z';
+        const convertedDate = helper.unixTimestampToDate(timestamp);
+        expect(convertedDate).toBe(expectedOutput);
+    })
+
 })
 

package/src/jira.js

@@ -9,7 +9,7 @@ const fetch = require('node-fetch');
  * @returns String
  */
 function credentialsToToken(email,token) {
-    // eslint-disable-next-line no-undef
+     
     let bearerToken = Buffer.from(`${email}:${token}`).toString('base64');
     return bearerToken
 }