@harperfast/harper 5.0.0-alpha.10

package/dist/upgrade/directivesManager.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Iterates through the directives files to find uninstalled updates and runs the files.
+ *
+ * @param upgradeObj
+ * @returns {Promise<*[]>}
+ */
+export function processDirectives(upgradeObj: any): Promise<any[]>;

package/dist/upgrade/directivesManager.js

@@ -0,0 +1,125 @@
+'use strict';
+const hdbUtil = require('../utility/common_utils.js');
+const log = require('../utility/logging/harper_logger.js');
+const directivesController = require('./directives/directivesController.js');
+module.exports = {
+    processDirectives,
+};
+/**
+ * Iterates through the directives files to find uninstalled updates and runs the files.
+ *
+ * @param upgradeObj
+ * @returns {Promise<*[]>}
+ */
+async function processDirectives(upgradeObj) {
+    console.log('Starting upgrade process...');
+    let loadedDirectives = directivesController.getVersionsForUpgrade(upgradeObj);
+    let upgradeDirectives = getUpgradeDirectivesToInstall(loadedDirectives);
+    let allResponses = [];
+    const dirLength = upgradeDirectives.length;
+    for (let i = 0; i < dirLength; i++) {
+        const vers = upgradeDirectives[i];
+        let notifyMsg = `Running upgrade for version ${vers.version}`;
+        log.notify(notifyMsg);
+        console.log(notifyMsg);
+        let syncFuncResponse = [];
+        let asyncFuncResponses = [];
+        // Run sync functions for upgrade
+        try {
+            syncFuncResponse = runSyncFunctions(vers.sync_functions);
+        }
+        catch (e) {
+            log.error(`Error while running an upgrade script for ${vers.version}`);
+            throw e;
+        }
+        // Run async functions for upgrade
+        try {
+            asyncFuncResponses = await runAsyncFunctions(vers.async_functions);
+        }
+        catch (e) {
+            log.error(`Error while running an upgrade script for ${vers.version}`);
+            throw e;
+        }
+        allResponses.push(...syncFuncResponse, ...asyncFuncResponses);
+    }
+    return allResponses;
+}
+/**
+ * Runs sync functions specified in a directive object.
+ *
+ * @param directiveFunctions - Array of sync functions to run
+ * @returns - Array of responses from function calls
+ */
+function runSyncFunctions(directiveFunctions) {
+    if (hdbUtil.isEmptyOrZeroLength(directiveFunctions)) {
+        log.info('No functions found to run for upgrade');
+        return [];
+    }
+    if (!Array.isArray(directiveFunctions)) {
+        log.info('Passed parameter is not an array');
+        return [];
+    }
+    let funcResponses = [];
+    for (let func of directiveFunctions) {
+        log.info(`Running function ${func.name}`);
+        if (!(func instanceof Function)) {
+            log.info('Variable being processed is not a function');
+            continue;
+        }
+        const response = func();
+        log.info(response);
+        funcResponses.push(response);
+    }
+    return funcResponses;
+}
+/**
+ * Runs async functions specified in a directive object.
+ *
+ * @param directiveFunctions - Array of async functions to run
+ * @returns - Array of responses from async function calls
+ */
+async function runAsyncFunctions(directiveFunctions) {
+    if (hdbUtil.isEmptyOrZeroLength(directiveFunctions)) {
+        log.info('No functions found to run for upgrade');
+        return [];
+    }
+    if (!Array.isArray(directiveFunctions)) {
+        log.info('Passed parameter is not an array');
+        return [];
+    }
+    let funcResponses = [];
+    const funcsLength = directiveFunctions.length;
+    for (let i = 0; i < funcsLength; i++) {
+        const func = directiveFunctions[i];
+        log.info(`Running function ${func.name}`);
+        if (!(func instanceof Function)) {
+            log.info('Variable being processed is not a function');
+            continue;
+        }
+        const response = await func();
+        log.info(response);
+        funcResponses.push(response);
+    }
+    return funcResponses;
+}
+/**
+ * Based on the current version, find all upgrade directives that need to be installed to make this installation current.
+ * Returns the install directives array sorted from lowest to highest version number.
+ *
+ * @param currVersionNum - The current version of HDB.
+ * @returns {Array}
+ */
+function getUpgradeDirectivesToInstall(loadedDirectives) {
+    if (hdbUtil.isEmptyOrZeroLength(loadedDirectives)) {
+        return [];
+    }
+    let versionModulesToRun = [];
+    for (let vers of loadedDirectives) {
+        let module = directivesController.getDirectiveByVersion(vers);
+        if (module) {
+            versionModulesToRun.push(module);
+        }
+    }
+    return versionModulesToRun;
+}
+//# sourceMappingURL=directivesManager.js.map

package/dist/upgrade/directivesManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directivesManager.js","sourceRoot":"","sources":["../../upgrade/directivesManager.js"],"names":[],"mappings":"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"}

package/dist/upgrade/upgradePrompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prompt the user that they need to run the upgrade scripts, typically after upgrading via a package manager.
+ * @param _upgradeObj - {UpgradeObject} Object includes the versions the data and current install are on
+ * @returns {Promise<boolean>}
+ */
+export function forceUpdatePrompt(_upgradeObj: any): Promise<boolean>;
+/**
+ * Prompt the user before proceeding with a minor version downgrade
+ * @param _upgradeObj - {UpgradeObject} Object includes the versions the data and current install are on
+ * @returns {Promise<boolean>}
+ */
+export function forceDowngradePrompt(_upgradeObj: any): Promise<boolean>;
+export function upgradeCertsPrompt(): Promise<boolean>;

package/dist/upgrade/upgradePrompt.js

@@ -0,0 +1,102 @@
+'use strict';
+const prompt = require('prompt');
+const chalk = require('chalk');
+const log = require('../utility/logging/harper_logger.js');
+const os = require('os');
+const assignCMDENVVariables = require('../utility/assignCmdEnvVariables.js');
+const UPGRADE_PROCEED = ['yes', 'y'];
+/**
+ * Prompt the user that they need to run the upgrade scripts, typically after upgrading via a package manager.
+ * @param _upgradeObj - {UpgradeObject} Object includes the versions the data and current install are on
+ * @returns {Promise<boolean>}
+ */
+async function forceUpdatePrompt(_upgradeObj) {
+    let upgradeMessage = `${os.EOL}` +
+        chalk.bold.green('Your current Harper version requires that we complete an update process.') +
+        `${os.EOL}` +
+        'If a backup of your data has not been created, we recommend you cancel this process and backup before proceeding.' +
+        `${os.EOL}${os.EOL}` +
+        'You can read more about the changes in this upgrade at https://harperdb.io/developers/release-notes/' +
+        `${os.EOL}`;
+    prompt.override = assignCMDENVVariables(['CONFIRM_UPGRADE']);
+    prompt.start();
+    prompt.message = upgradeMessage;
+    let upgradeConfirmation = {
+        properties: {
+            CONFIRM_UPGRADE: {
+                description: chalk.magenta(`${os.EOL}[CONFIRM_UPGRADE] Do you want to upgrade your HDB instance now? (yes/no)`),
+                pattern: /y(es)?$|n(o)?$/,
+                message: "Must respond 'yes' or 'no'",
+                default: 'no',
+                required: true,
+            },
+        },
+    };
+    let response;
+    try {
+        response = await prompt.get([upgradeConfirmation]);
+    }
+    catch (err) {
+        log.error('There was an error when prompting user about an upgrade.');
+        log.error(err);
+        return false;
+    }
+    return UPGRADE_PROCEED.includes(response.CONFIRM_UPGRADE);
+}
+/**
+ * Prompt the user before proceeding with a minor version downgrade
+ * @param _upgradeObj - {UpgradeObject} Object includes the versions the data and current install are on
+ * @returns {Promise<boolean>}
+ */
+async function forceDowngradePrompt(_upgradeObj) {
+    let downgradeMessage = `${os.EOL}` +
+        chalk.bold.green('Your installed Harper version is older than the version used to create your data.' +
+            ' Downgrading is not recommended as it is not tested and guaranteed to work. However, if you need to' +
+            ' downgrade, and a backup of your data has not been created, we recommend you cancel this process and' +
+            ' backup before proceeding.' +
+            `${os.EOL}`);
+    prompt.override = assignCMDENVVariables(['CONFIRM_DOWNGRADE']);
+    prompt.start();
+    prompt.message = downgradeMessage;
+    let downgradeConfirmation = {
+        properties: {
+            CONFIRM_DOWNGRADE: {
+                description: chalk.magenta(`${os.EOL}[CONFIRM_DOWNGRADE] Do you want to proceed with using your downgraded HDB instance now? (yes/no)`),
+                pattern: /y(es)?$|n(o)?$/,
+                message: "Must respond 'yes' or 'no'",
+                default: 'no',
+                required: true,
+            },
+        },
+    };
+    let response = await prompt.get([downgradeConfirmation]);
+    return UPGRADE_PROCEED.includes(response.CONFIRM_DOWNGRADE);
+}
+async function upgradeCertsPrompt() {
+    const upgradeCertMessage = `${os.EOL}` +
+        chalk.bold.green('We now require a Certifacte Authority certificate. Harper can generate all new certificates for you (your existing certificates will be backed up) ' +
+            'or you can keep any existing certificates and add your own CA certificate. To add your own CA certificate set the <certificateAuthority> ' +
+            'parameter in harperdb-config.yaml');
+    prompt.override = assignCMDENVVariables(['GENERATE_CERTS']);
+    prompt.start();
+    prompt.message = upgradeCertMessage;
+    let upgradeConfirmation = {
+        properties: {
+            GENERATE_CERTS: {
+                description: chalk.magenta(`${os.EOL}[GENERATE_CERTS] Do you want Harper to generate all new certificates? (yes/no)`),
+                pattern: /y(es)?$|n(o)?$/,
+                message: "Must respond 'yes' or 'no'",
+                default: 'yes',
+                required: true,
+            },
+        },
+    };
+    const response = await prompt.get([upgradeConfirmation]);
+    return UPGRADE_PROCEED.includes(response.GENERATE_CERTS);
+}
+module.exports = {
+    forceUpdatePrompt,
+    forceDowngradePrompt,
+    upgradeCertsPrompt,
+};
+//# sourceMappingURL=upgradePrompt.js.map

package/dist/upgrade/upgradePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradePrompt.js","sourceRoot":"","sources":["../../upgrade/upgradePrompt.js"],"names":[],"mappings":"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"}

package/dist/upgrade/upgradeUtilities.d.ts

@@ -0,0 +1,10 @@
+/**
+ * We need to make sure we are setting empty string for values that are null/undefined/empty string - PropertiesReader
+ * castes values in some awkward ways and this covers those scenarios AND ensures we have default values set for new
+ * config values that may have been added in a previous version (between when user installed HDB and is now upgrading)
+ * @param propName
+ * @param oldHdbProps
+ * @param valueRequired
+ * @returns {string|*}
+ */
+export function getOldPropsValue(propName: any, oldHdbProps: any, valueRequired?: boolean): string | any;

package/dist/upgrade/upgradeUtilities.js

@@ -0,0 +1,26 @@
+'use strict';
+const hdbUtil = require('../utility/common_utils.js');
+const configUtils = require('../config/configUtils.js');
+module.exports = {
+    getOldPropsValue,
+};
+/**
+ * We need to make sure we are setting empty string for values that are null/undefined/empty string - PropertiesReader
+ * castes values in some awkward ways and this covers those scenarios AND ensures we have default values set for new
+ * config values that may have been added in a previous version (between when user installed HDB and is now upgrading)
+ * @param propName
+ * @param oldHdbProps
+ * @param valueRequired
+ * @returns {string|*}
+ */
+function getOldPropsValue(propName, oldHdbProps, valueRequired = false) {
+    const oldVal = oldHdbProps.getRaw(propName);
+    if (hdbUtil.isNotEmptyAndHasValue(oldVal)) {
+        return oldVal;
+    }
+    if (valueRequired) {
+        return configUtils.getDefaultConfig(propName);
+    }
+    return '';
+}
+//# sourceMappingURL=upgradeUtilities.js.map

package/dist/upgrade/upgradeUtilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradeUtilities.js","sourceRoot":"","sources":["../../upgrade/upgradeUtilities.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,OAAO,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;AACtD,MAAM,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAExD,MAAM,CAAC,OAAO,GAAG;IAChB,gBAAgB;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,GAAG,KAAK;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/utility/AWS/AWSConnector.d.ts

@@ -0,0 +1,2 @@
+export function getFileStreamFromS3(jsonMessage: any): Promise<any>;
+export function getS3AuthObj(accessKeyId: any, secretKey: any, region: any): any;

package/dist/utility/AWS/AWSConnector.js

@@ -0,0 +1,26 @@
+'use strict';
+const { S3, GetObjectCommand } = require('@aws-sdk/client-s3');
+module.exports = {
+    getFileStreamFromS3,
+    getS3AuthObj,
+};
+async function getFileStreamFromS3(jsonMessage) {
+    const { s3 } = jsonMessage;
+    const params = {
+        Bucket: s3.bucket,
+        Key: s3.key,
+    };
+    const authenticatedS3 = getS3AuthObj(s3.aws_access_key_id, s3.aws_secret_access_key, s3.region);
+    const item = await authenticatedS3.send(new GetObjectCommand(params));
+    return item.Body;
+}
+function getS3AuthObj(accessKeyId, secretKey, region) {
+    return new S3({
+        credentials: {
+            accessKeyId,
+            secretAccessKey: secretKey,
+        },
+        region,
+    });
+}
+//# sourceMappingURL=AWSConnector.js.map

package/dist/utility/AWS/AWSConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AWSConnector.js","sourceRoot":"","sources":["../../../utility/AWS/AWSConnector.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,EAAE,EAAE,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE/D,MAAM,CAAC,OAAO,GAAG;IAChB,mBAAmB;IACnB,YAAY;CACZ,CAAC;AAEF,KAAK,UAAU,mBAAmB,CAAC,WAAW;IAC7C,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,CAAC;IAC3B,MAAM,MAAM,GAAG;QACd,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,GAAG,EAAE,EAAE,CAAC,GAAG;KACX,CAAC;IACF,MAAM,eAAe,GAAG,YAAY,CAAC,EAAE,CAAC,iBAAiB,EAAE,EAAE,CAAC,qBAAqB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM;IACnD,OAAO,IAAI,EAAE,CAAC;QACb,WAAW,EAAE;YACZ,WAAW;YACX,eAAe,EAAE,SAAS;SAC1B;QACD,MAAM;KACN,CAAC,CAAC;AACJ,CAAC"}

package/dist/utility/OperationFunctionCaller.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Calls the operation function specified in the parameter with the input specified in the parameter.  Once complete,
+ * calls the response function in the parameter with  the operation result as the first parameter.
+ * @param promisifiedFunction - The operation which is in async/await format
+ * @param functionInput - The input needed for the operationFunctionAsCallback function.
+ * @param followupAsyncFunc - The response function that will be called with the operation function response as an input.  The function is expected to be promisifed, callbacks not supported.
+ * @returns {Promise<{}>}
+ */
+export function callOperationFunctionAsAwait(promisifiedFunction: any, functionInput: any, followupAsyncFunc: any): Promise<{}>;

package/dist/utility/OperationFunctionCaller.js

@@ -0,0 +1,58 @@
+'use strict';
+const log = require('./logging/harper_logger.js');
+const terms = require("./hdbTerms.js");
+/**
+ * Calls the operation function specified in the parameter with the input specified in the parameter.  Once complete,
+ * calls the response function in the parameter with  the operation result as the first parameter.
+ * @param promisifiedFunction - The operation which is in async/await format
+ * @param functionInput - The input needed for the operationFunctionAsCallback function.
+ * @param followupAsyncFunc - The response function that will be called with the operation function response as an input.  The function is expected to be promisifed, callbacks not supported.
+ * @returns {Promise<{}>}
+ */
+async function callOperationFunctionAsAwait(promisifiedFunction, functionInput, followupAsyncFunc) {
+    if (!promisifiedFunction || typeof promisifiedFunction !== 'function') {
+        throw new Error('Invalid function parameter');
+    }
+    let result = undefined;
+    try {
+        result = await promisifiedFunction(functionInput);
+        if (followupAsyncFunc) {
+            //TODO: Passing result twice seems silly, why is this a thing?
+            await followupAsyncFunc(functionInput, result);
+        }
+        // The result from insert, update, or upsert contains a properties new_attributes/txnTime. It is used by postOperationHandler to propagate
+        // attribute metadata. After the property has been used we no longer need it and do not want the API returning it,
+        // therefore we delete it from the result.
+        if (functionInput.operation === terms.OPERATIONS_ENUM.INSERT ||
+            functionInput.operation === terms.OPERATIONS_ENUM.UPDATE ||
+            functionInput.operation === terms.OPERATIONS_ENUM.UPSERT) {
+            delete result.new_attributes;
+            delete result.txn_time;
+        }
+        else if (functionInput.operation === terms.OPERATIONS_ENUM.DELETE) {
+            delete result.txn_time;
+        }
+        return result;
+    }
+    catch (err) {
+        // This specific check was added to avoid an error message in the log which could make the error look worse than it
+        // seems when scanning a log.  In reality a schema already existing isn't really an error, just a failure.
+        if (err.message && typeof err.message === 'string' && err.message.includes('already exists')) {
+            log.info(err.message);
+            throw err;
+        }
+        // This check is here to make sure a new HdbError is logged correctly
+        if (err.http_resp_msg) {
+            log.error(`Error calling operation: ${promisifiedFunction.name}`);
+            log.error(err.http_resp_msg);
+            throw err;
+        }
+        log.error(`Error calling operation: ${promisifiedFunction.name}`);
+        log.error(err);
+        throw err;
+    }
+}
+module.exports = {
+    callOperationFunctionAsAwait,
+};
+//# sourceMappingURL=OperationFunctionCaller.js.map

package/dist/utility/OperationFunctionCaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationFunctionCaller.js","sourceRoot":"","sources":["../../utility/OperationFunctionCaller.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,GAAG,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;AAClD,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEvC;;;;;;;GAOG;AACH,KAAK,UAAU,4BAA4B,CAAC,mBAAmB,EAAE,aAAa,EAAE,iBAAiB;IAChG,IAAI,CAAC,mBAAmB,IAAI,OAAO,mBAAmB,KAAK,UAAU,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAElD,IAAI,iBAAiB,EAAE,CAAC;YACvB,8DAA8D;YAC9D,MAAM,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QAED,0IAA0I;QAC1I,kHAAkH;QAClH,0CAA0C;QAC1C,IACC,aAAa,CAAC,SAAS,KAAK,KAAK,CAAC,eAAe,CAAC,MAAM;YACxD,aAAa,CAAC,SAAS,KAAK,KAAK,CAAC,eAAe,CAAC,MAAM;YACxD,aAAa,CAAC,SAAS,KAAK,KAAK,CAAC,eAAe,CAAC,MAAM,EACvD,CAAC;YACF,OAAO,MAAM,CAAC,cAAc,CAAC;YAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC;QACxB,CAAC;aAAM,IAAI,aAAa,CAAC,SAAS,KAAK,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;YACrE,OAAO,MAAM,CAAC,QAAQ,CAAC;QACxB,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,mHAAmH;QACnH,0GAA0G;QAC1G,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC9F,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,GAAG,CAAC;QACX,CAAC;QACD,qEAAqE;QACrE,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,4BAA4B,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC7B,MAAM,GAAG,CAAC;QACX,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,4BAA4B,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACf,MAAM,GAAG,CAAC;IACX,CAAC;AACF,CAAC;AAED,MAAM,CAAC,OAAO,GAAG;IAChB,4BAA4B;CAC5B,CAAC"}

package/dist/utility/assignCmdEnvVariables.d.ts

@@ -0,0 +1,10 @@
+export = assignCMDENVVariables;
+/**
+ * This function receives a list of keys used to find if they exist in command line args &/or environment variables (command line always supercedes env vars).
+ * if found they key/value is assigned to the return object
+ * This is here and not common utils to avoid circular dependencies.
+ * @param keys - arrays of keys to search for and assign to the return object
+ * @param isConfigParam
+ * @returns {{}}
+ */
+declare function assignCMDENVVariables(keys?: any[], isConfigParam?: boolean): {};

package/dist/utility/assignCmdEnvVariables.js

@@ -0,0 +1,55 @@
+'use strict';
+const minimist = require('minimist');
+module.exports = assignCMDENVVariables;
+/**
+ * This function receives a list of keys used to find if they exist in command line args &/or environment variables (command line always supercedes env vars).
+ * if found they key/value is assigned to the return object
+ * This is here and not common utils to avoid circular dependencies.
+ * @param keys - arrays of keys to search for and assign to the return object
+ * @param isConfigParam
+ * @returns {{}}
+ */
+function assignCMDENVVariables(keys = [], isConfigParam = false) {
+    if (!Array.isArray(keys)) {
+        return {};
+    }
+    let envArgs;
+    let cmdArgs;
+    if (isConfigParam) {
+        // Lowercase keys to make mapping to config params work
+        envArgs = objKeysToLowerCase(process.env);
+        cmdArgs = objKeysToLowerCase(minimist(process.argv));
+    }
+    else {
+        envArgs = process.env;
+        cmdArgs = minimist(process.argv);
+    }
+    let hdbSettings = {};
+    for (let x = 0, length = keys.length; x < length; x++) {
+        let setting = keys[x];
+        //we set the env variable first which gets overridden by a command line arg (if present)
+        if (cmdArgs[setting] !== undefined) {
+            hdbSettings[setting] = cmdArgs[setting].toString().trim();
+        }
+        else if (envArgs[setting] !== undefined) {
+            hdbSettings[setting] = envArgs[setting].toString().trim();
+        }
+    }
+    return hdbSettings;
+}
+/**
+ * Creates a new object where all its keys are lowercase
+ * @param obj
+ * @returns {{}}
+ */
+function objKeysToLowerCase(obj) {
+    let key, keys = Object.keys(obj);
+    let i = keys.length;
+    const result = {};
+    while (i--) {
+        key = keys[i];
+        result[key.toLowerCase()] = obj[key];
+    }
+    return result;
+}
+//# sourceMappingURL=assignCmdEnvVariables.js.map

package/dist/utility/assignCmdEnvVariables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignCmdEnvVariables.js","sourceRoot":"","sources":["../../utility/assignCmdEnvVariables.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAErC,MAAM,CAAC,OAAO,GAAG,qBAAqB,CAAC;AAEvC;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,IAAI,GAAG,EAAE,EAAE,aAAa,GAAG,KAAK;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,OAAO,CAAC;IACZ,IAAI,OAAO,CAAC;IACZ,IAAI,aAAa,EAAE,CAAC;QACnB,uDAAuD;QACvD,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACP,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;QACtB,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,wFAAwF;QACxF,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3D,CAAC;aAAM,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3D,CAAC;IACF,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,GAAG;IAC9B,IAAI,GAAG,EACN,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,OAAO,CAAC,EAAE,EAAE,CAAC;QACZ,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}